前言¶
在 DeepSeek Harness（DSH）裏做智能體或對話開發時，模型來源通常來自官方或自建的 OpenAI 兼容網關。若你已有 Trae CN 賬號，並希望 Trae 側目錄裏的模型直接出現在 DSH 模型選擇器裏，而不是再單獨起一個 HTTP 代理、手工填 base URL，就需要一個以 DSH 原生 LlmAdapter 註冊的 provider。下面介紹社區插件 trae-cn-provider（維護者 JsonLing，npm 包名 trae-cn-provider，當前版本 0.1.6，MIT 許可證）：它把 Trae CN 接進 DSH，默認走瀏覽器 OAuth 登錄，憑據留在本機；也可選讀本機 Trae 客戶端登錄態，並可在宿主 web server 上掛載 OpenAI 兼容路徑供 Cline、Claude Code 等客戶端使用。
這是什麼¶
trae-cn-provider 是 DSH 的「模型推理」類插件：註冊 provider 路由 trae-cn，模型列表從 Trae 上游實時拉取；支持流式輸出、思考鏈（reasoning）、原生 function calling、上下文窗口與思考檔位，以及多模態圖片輸入。它不代理憑據到第三方，README 寫明出網域名僅限 Trae 官方相關主機；不修改 Trae 客戶端、不 hook 其進程。
插件與 Trae、字節跳動無官方關係。README 明確聲明：項目將 Trae 客戶端內部接口當作通用 LLM API 使用，可能違反 Trae 使用條款，賬號存在封禁風險，消耗的是你自己賬號的額度；不接受上述風險則不要安裝。
核心功能¶
- DSH 內原生使用：安裝並重啓對應 profile 後，模型選擇器會出現 Trae CN 分組。
- 憑據來源三檔（
credentialSource）：默認oauth（DSH 內瀏覽器登錄一次，包內無解密本機客戶端憑據的代碼路徑）；可選local（讀本機已登錄 Trae 的storage.json，含tc解密路徑，需顯式開啓）；auto（優先已保存 OAuth，否則讀本機客戶端）。 - OpenAI 兼容面（默認開啓）：掛在宿主已有 web server 的
openAIPath（默認/trae-cn）下，提供/trae-cn/v1/models、/trae-cn/v1/chat/completions、/trae-cn/health，不單獨佔端口。 - 獨立 CLI：可脫離 DSH 做本地登錄、列模型、起服務或單次對話。
- 與同類差異（README 表格）：相對部分
dsh-trae-api系 fork，本項目強調 DSH 原生 adapter、macOS 路徑與憑據存放方式，以及瀏覽器 Origin 默認 403 等安全默認。
安裝與啓用¶
Web 與桌面 profile 使用 npm 包安裝（安裝即寫入 dsh.profile.bundles）：
# Web profile
dsh plugin --profile web add trae-cn-provider
# 桌面版：須先完全退出 DeepSeek Harness 桌面應用再執行
dsh plugin --profile desktop add trae-cn-provider
桌面 profile 若未完全退出應用，可能報錯：Open DeepSeek Harness Desktop once to initialize its profile, then fully quit it。卸載示例：
dsh plugin --profile <p> remove trae-cn-provider
安裝後重啓對應 profile。Node 引擎要求見 package.json：^22.19.0 || >=24.0.0。DSH 兼容性在包內聲明對 0.1.2-rc.1、0.2.0-rc.2、0.2.1-alpha.2 爲 compatible。
登錄與典型用法¶
DSH 內 OAuth（默認）¶
在 DSH 執行登錄命令（默認 /trae-login），瀏覽器打開 Trae 官方授權頁；回調在 127.0.0.1 臨時監聽，憑據默認寫入 ~/.trae-proxy/credentials.json（權限 0600），可用環境變量 TRAE_PROXY_CRED_DIR 改目錄；若 DSH credentials 服務可用會優先寫入該服務。
配置覆蓋¶
通過 profile 的 cordis.patch.yml 調整行爲，例如：
- id: trae-cn
config:
credentialSource: oauth # oauth | local | auto
edition: cn # local/auto 時讀哪個 edition
requestStyle: chat_v3 # chat_v3（實測可用）| inline_chat（實驗）
appVersionCode: 20260901 # 須爲純整數，默認已滿足完整模型目錄
mountOpenAIEndpoint: true
openAIPath: /trae-cn
allowBrowserOrigins: [] # 帶 Origin 的瀏覽器請求默認 403
appVersionCode 過小會導致上游返回的可用聊天模型變少；默認 20260901 無需手工改。allowBrowserOrigins 爲空時，瀏覽器頁面無法直接打本地 OpenAI 面；Hermes、openai-python、curl 等不發 Origin 的客戶端不受影響。
OpenAI 兼容客戶端¶
宿主 web 開啓後，對外路徑形如 /trae-cn/v1/chat/completions。獨立 CLI 示例（路徑無前綴，直接 /v1/...）：
node src/cli.js login
node src/cli.js models
node src/cli.js serve --port 8317 [--api-key <key>]
node src/cli.js chat "你好"
npm 腳本亦提供 trae-cn 二進制：login、models、serve、chat。
模型目錄¶
模型不由插件硬編碼；過濾後 README 在 2026-10 本機實測列出 20 個用戶可選聊天模型（如 Doubao-Seed 系列、DeepSeek-V4、Kimi、GLM、Qwen 等），完整表見 GitHub README。目錄規模受 appVersionCode 與登錄設備 DeviceName 等因素影響；默認設備名取本機短主機名，可用 TRAE_PROXY_DEVICE_NAME 覆蓋。
適用場景與注意¶
適合：已在 DSH web 或 desktop profile 開發，希望 Trae CN 賬號額度在本機直連上游、並可選給 OpenAI 兼容工具複用同一登錄態的開發者。
務必注意：
- 插件以當前 DSH 進程權限運行；安裝前請閱讀 GitHub 倉庫 源碼與 MIT 許可證，並閱讀 README 風險聲明。
- 選擇
local/auto會啓用讀本機 Traestorage.json的路徑；local可能隨客戶端改寫存儲而失效，長期更穩的是默認oauth或auto中 OAuth 優先。 - 不要把憑據與插件配置一併分發給他人。
- 社區目錄 SkillHub 插件頁 與 GitHub 爲獨立信息源，與 DeepSeek / 幻方無官方從屬關係；星標等以各站點當時展示爲準。
結尾¶
trae-cn-provider 把 Trae CN 作爲 DSH 原生 LLM provider 接入：默認瀏覽器 OAuth、憑據不出本機，可選 OpenAI 兼容掛載與獨立 CLI。使用前請自行評估 Trae 條款與賬號風險。
- 目錄頁：https://www.skillhub.cn/plugins/JsonLing/trae-cn-provider
- 源碼與文檔：https://github.com/JsonLing/trae-cn-provider
