前言¶
DeepSeek Harness (DSH) 遵循“一切皆插件”的理念，将本地模型接入工作流是常见需求。上游插件 dsh-connect-trae 在处理 Trae 本地环境（如未安装、未登录或端口不可用）时，回环 shim 绑定失败会导致 Harness 启动失败，表现为 fatal load failure，这会阻塞整个工作流。
dsh-connect-trae-plus 是上游 v2.0.4 的加固分支（fork），由 HaydenSmith1121 维护。它保留了 Trae 侧的协议、凭据处理和区域拆分逻辑，仅修复了启动稳定性问题。本插件将本地已登录的 Trae 模型（支持国内版与国际版）接入 DSH，并提供只读的用量概览与模型管理界面。
核心功能¶
本插件在 DSH 中提供了双供应商并行接入能力，并针对区域隔离做了优化：
- 双供应商并行接入：国内版注册为
trae，国际版注册为trae-global。两个供应商独立运行，互不干扰，可在不同会话中同时使用。 - 插件卡片 Tab 切换：设置卡片支持国内版/国际版独立管理。每个 Tab 拥有独立的账号选择、目录、勾选状态与上下文预算，切换不会影响另一侧的运行时状态。
- 倍率内嵌模型名：模型名称按 Trae 菜单格式显示积分倍率（如
GLM-5.2 · x0.79），刷新目录后自动更新。 - DSH 本地工具循环：通过 Trae 的
llm_utils_chat获取结构化的tool_calls，由 DSH 本地执行bash、read、write等工具，再将结果回传模型。 - 安全 loopback shim：每个区域使用独立的随机端口和进程内 secret，真实 Trae Token 不会直接交给 pi-ai。
- 只读用量与模型管理：国内版可查看 Work 积分与通用积分，国际版可查看订阅状态。这些查询是只读的，不会消耗额度。
模型覆盖范围¶
插件目前提供的是 Trae SOLO 通道的模型，如 DeepSeek-V4-Flash-Official、GLM-5.3、Qwen3.8-Max 等。
以下 4 个模型目前来自 TraeCode（Trae IDE）通道，尚未开放到 SOLO 通道，本插件暂不支持：
deepseek-v4.1-flashglm-5.3-flashkimi-k2.8-previewqwen3.8-flash
安装与启用¶
推荐使用 DSH 插件命令进行安装。安装、更新或卸载 bundle 后，需重启对应的 DSH 进程。
dsh plugin --profile desktop add dsh-connect-trae
适用场景与注意事项¶
- 场景：需要在 DSH 中使用本地 Trae 模型进行工具调用，或需要监控 Trae 账号的积分/订阅状态。
- 权限与隔离：插件以当前 DSH 进程权限运行，Token 不会写入 DSH 设置，而是存储在本地加密目录中。
- Windows 限制：Windows 默认未安装
sqlite3，Raw Chat 能力探测会失败并安全回退。Raw Chat 默认关闭，不影响主流程。 - 分支维护：这是加固分支。如果你不需要容错加固，可使用上游包；若上游采纳了等效修复，本分支应退役。
结语¶
dsh-connect-trae-plus 解决了上游插件在环境异常时导致 Harness 无法启动的问题，同时保持了 Trae 官方协议的兼容性。通过双区域并行管理与安全隔离机制，它为本地模型接入提供了一个稳定的基础设施。
