前言¶

在 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 使用条款，账号存在封禁风险，消耗的是你自己账号的额度；不接受上述风险则不要安装。

核心功能¶

1. DSH 内原生使用：安装并重启对应 profile 后，模型选择器会出现 Trae CN 分组。
2. 凭据来源三档（credentialSource）：默认 oauth（DSH 内浏览器登录一次，包内无解密本机客户端凭据的代码路径）；可选 local（读本机已登录 Trae 的 storage.json，含 tc 解密路径，需显式开启）；auto（优先已保存 OAuth，否则读本机客户端）。
3. OpenAI 兼容面（默认开启）：挂在宿主已有 web server 的 openAIPath（默认 /trae-cn）下，提供 /trae-cn/v1/models、/trae-cn/v1/chat/completions、/trae-cn/health，不单独占端口。
4. 独立 CLI：可脱离 DSH 做本地登录、列模型、起服务或单次对话。
5. 与同类差异（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 兼容工具复用同一登录态的开发者。

务必注意：

1. 插件以当前 DSH 进程权限运行；安装前请阅读 GitHub 仓库 源码与 MIT 许可证，并阅读 README 风险声明。
2. 选择 local / auto 会启用读本机 Trae storage.json 的路径；local 可能随客户端改写存储而失效，长期更稳的是默认 oauth 或 auto 中 OAuth 优先。
3. 不要把凭据与插件配置一并分发给他人。
4. 社区目录 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