前言¶

DeepSeek Harness（DSH）的模型能力来自插件注册的 provider。若你已经在 macOS 上安装并登录了 TeleAgent（天翼 AI 星辰超级智能体桌面版），账号和额度都在桌面端里，却希望在 DSH 里用同一套登录态选模型、走 OpenAI 兼容调用，就需要一条「复用本机凭据、由 DSH 掌控 messages 与工具」的桥接路径。

官方 TeleAgent 没有类似 WorkBuddy 的浏览器 OAuth 插件端点；常见做法是手动抄 token 或绕开 DSH 的工具链。dsh-connect-teleagent 由社区维护者 anbulang 发布，分类为模型推理，把桌面端登录态接到 DSH：直连 TeleAgent 上游 OpenAI 兼容网关，不经过 TeleAgent 的 agent 运行时，因此多轮、tools/tool_calls、role 结构由 DSH 原样保留。

这是什么¶

一句话：dsh-connect-teleagent 是 DSH 插件，把本机已登录 TeleAgent 的模型注册进 Harness 模型选择器，并提供本地 OpenAI 兼容 shim 与上游签名（或默认 kernel 传输）。

• 维护者：anbulang
• 目录页：https://www.skillhub.cn/plugins/anbulang/dsh-connect-teleagent
• 源码：https://github.com/anbulang/dsh-connect-teleagent（MIT，当前 package 版本 0.11.2）
• 插件以当前 DSH 进程权限运行；安装前请自行阅读仓库源码与许可证，确认可接受逆向协议与账号风险（见 README 免责声明）。

核心功能¶

下列能力在 README「能力矩阵」中标注为已实测。

插件不注入 TeleAgent 客户端固定的 5045 字符人格 system 串，以免污染 DSH 指令；与官方客户端在明文 body 等维度可区分，README 有对照表。

可用模型¶

在 DSH 中显示为「名称 · 积分倍率」形式，倍率来自 TeleAgent 目录。

前置条件¶

1. macOS 已安装并登录 TeleAgent 桌面版（路径 /Applications/TeleAgent.app）。
2. DSH 版本与 dsh-connect-workbuddy 同代际（peer 依赖满足）；engines.dsh 要求 >=0.2.1-rc.1 <0.3.0-0，Node ^22.19.0 || >=24.0.0。

未登录时日志会报「TeleAgent 尚未登录」，卡片提供「去登录」。登录完成后无需重启 DSH，插件会自动重建上游客户端。

安装与启用¶

任选一种方式安装；上游网关 apiKey 均需在本机单独配置（下一节）。

方式一：仓库脚本¶

在克隆或解压后的仓库根目录执行：

bash scripts/install.sh

然后完全退出并重启 DeepSeek Harness。重启后在「设置 → 模型」中应能看到 TeleAgent 的 5 个模型。

卸载：

bash scripts/uninstall.sh

方式二：DSH 包管理器¶

dsh plugin --profile web add github:anbulang/dsh-connect-teleagent

上游 apiKey 仍须按下一节配置。

方式三：自定义插件市场（format-1 索引）¶

1. 打开 插件 → 实验性插件 旁的 更多 → 开启 自定义插件市场。
2. 发现 → 添加索引源，填写：

https://raw.githubusercontent.com/anbulang/dsh-connect-teleagent/main/market/index.json

3. 在市场下拉中选择 dsh-connect-teleagent 查看并安装。

上游 apiKey¶

请求上游需要 TeleAgent 桌面端内置的网关 apiKey（仓库不提交真实值）。任选其一：

1. 环境变量：

export TELEAGENT_API_KEY=sk-...

2. 仓库根目录 local.secrets.json（已 gitignore）：

{ "apiKey": "sk-..." }

两者都未配置时，日志与卡片会提示「未配置上游 apiKey」。

典型用法与配置¶

在 DSH 里选模型¶

安装、配置 apiKey、登录 TeleAgent 后，在模型选择器里挑选上述 modelID（可在插件卡片里用 enabledModelIds 限制启用列表）。

设置文件默认路径：~/.dsh/teleagent-plugin.json（即 $DSH_HOME/teleagent-plugin.json）：

{
  "enabledModelIds": ["chat-pro", "chat-flash"]   // 空数组 = 全部启用
}

传输模式¶

默认 kernel：驱动 TeleAgent Go 内核发请求，流量为原生流量；可回退为插件自签名的 direct：

{ "transport": "kernel" }

相关项：kernelAllowedTools（默认空）、kernelReadyTimeoutMs（默认 60000）、环境变量 TELEAGENT_KERNEL_PORT（默认 47823）。

积分与防护¶

关闭自动每日领取可在卡片关开关，或写配置：

{ "welfare": { "autoClaimDaily": false } }

并发与熔断可在插件配置覆盖：

{ "guard": { "maxConcurrent": 2, "failureThreshold": 3, "cooldownMs": 600000 } }

诊断整条链路¶

node lib/doctor.js
node lib/doctor.js --json

「签名自检」会发 max_tokens: 1 的真实请求；TeleAgent 升级导致签名变更时会明确报错。

换账号：在桌面端重新登录即可；插件凭 token.json 指纹重建客户端，一般不需要重启 DSH。账号异常时卡片可「清除登录态」（仅删 token.json，执行前会先退出桌面端）。

工作原理（简述）¶

DSH (pi-ai) ──OpenAI──► loopback shim (127.0.0.1:随机端口)
                              │  透明转发
                              ▼
                    TeleAgent 上游 /superCowork/sapi/api/v1

凭据来自 ~/.local/share/TeleAgent/ 下的 token.json（钥匙串解密）与 device-meta.json；用户 token 不上写入 DSH 配置或状态接口。默认 kernel 模式下独立内核目录为 ~/.dsh-teleagent-kernel/，不修改桌面端数据目录。

适用场景与注意¶

适合谁：已在 macOS 使用 TeleAgent 桌面版、希望在 DSH 里统一编排 agent、工具与多轮对话，并愿意自行配置上游 apiKey 与接受协议逆向维护成本的开发者。

务必知晓：

• 仅 macOS + 已登录桌面端；签名算法依赖逆向，TeleAgent 变更协议需更新插件（doctor 可先行发现）。
• 部分模型会把思考过程写入正文（reasoning: 0），属模型行为。
• 插件不伪装官方客户端；突发并发可能触发上游限流，README 建议配合内置熔断。
• 社区目录站点 skillhub.cn 与 DeepSeek / 幻方无官方从属关系；安装插件等于在本机 DSH 进程中加载第三方代码，请先审阅仓库再启用。

结尾¶

dsh-connect-teleagent 把 TeleAgent 的五档模型以 OpenAI 兼容方式接进 DSH，复用桌面登录态与积分展示，并把会话与工具执行留在 Harness 一侧。详情与变更见仓库 README 与 CHANGELOG。

• 目录页：https://www.skillhub.cn/plugins/anbulang/dsh-connect-teleagent
• GitHub：https://github.com/anbulang/dsh-connect-teleagent