前言¶

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