dsh-tap：DeepSeek Harness 的 CodeBuddy Provider Bundle

前言¶

DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。在本地开发智能体时，若要接入 CodeBuddy (copilot.tencent.com) 的模型能力或使用其订阅配额，通常需要自行处理认证、协议转换和流量转发。dsh-tap 插件通过本地 Loopback Tap Bridge，将这些操作封装在本地进程内，作为 DeepSeek Harness 的统一 Provider Bundle。

这是什么¶

dsh-tap 是一个由 taikaikaikai-pixel 维护的非官方插件包。它将 CodeBuddy 网关集成到 DSH 中，提供模型调用、工具调用（网络搜索、生图）以及订阅配额接入（TraeWork CN）的统一入口。

核心功能¶

模型清单与能力¶

插件启动时会从网关的 /v3/config 端点动态同步模型目录。默认模型为 deepseek-v3。支持 18+ 模型，涵盖 DeepSeek、智谱 GLM、Moonshot Kimi、MiniMax、腾讯混元以及自动路由。

多模态支持：12 个模型支持图片输入。
思考强度：多数模型支持可调的 reasoningEfforts（思考强度），可在设置卡中调节。

TraeWork CN 订阅接入¶

v0.8.3 版本起，插件内置 TraeWork CN（订阅额度）通道。
- 认证方式：使用自持的 ECDSA P-256 设备密钥进行 OAuth 设备流授权，不依赖官方 IDE 凭据。
- 本地网关：在本地（127.0.0.1）运行翻译网关，将 OpenAI 协议转换为 Trae 云端协议。
- 模型提取：从本机 TRAE SOLO CN 的缓存数据库中提取模型列表，自动同步进 DSH 选择器。

工具集成¶

插件将 CodeBuddy 的工具注册到 DSH 的 ctx.web 和 ctx.tools 中。
- 网络搜索与抓取：集成 web_search 和 web_fetch 工具，用于联网查询。
- 图片生成：集成 image_generate 工具，基于混元模型生图。

OpenAI 兼容上游¶

支持通过 API Key 连接火山引擎 Ark、阿里云百炼等 OpenAI 兼容注册表。

典型用法¶

1. 启用 TraeWork CN 订阅¶

进入 DSH 设置卡 → 插件配置 → CodeBuddy → TraeWork CN（订阅额度）分区。
- 启用通道。
- 点击“登录”进行浏览器授权。
- 模型将自动出现在对话模型选择器中。

2. 配置图片输入桥¶

在 ~/.dsh/settings.yaml 中配置 describe-image 流式桥：

describe-image:
  baseURL: http://127.0.0.1:3901/v2
  model: glm-5v-turbo
  apiKeyEnv: CODEBUDDY_API_KEY
  apiStyle: chat-completions

3. 使用 API Key¶

通过环境变量 CODEBUDDY_API_KEY 提供凭据，或在设置卡中手动管理 Key。

注意事项¶

非官方与 BYOC：插件为社区维护的非官方项目，BYOC（自带密钥）。
安全与隐私：插件文件本身不含密钥，Token 仅存储在 ~/.dsh/ 本地目录。OAuth 模式下的剩余额度为估算值。
权限要求：插件需以当前 DSH 进程的权限运行，安装前建议检查源码。

总结¶

dsh-tap 解决了在 DSH 中直接使用 CodeBuddy 模型和工具的集成问题，特别是通过本地网关透明地接入 TraeWork CN 订阅额度。对于需要丰富模型列表和多模态能力的开发者，这是一个实用的补充方案。