dsh-codebuddy-plugin
taikaikaikai-pixel/dsh-codebuddy-plugin
Bundle non officiel en amont pour DeepSeek Harness. Passerelle CodeBuddy avec catalogue de modèles synchronisé à l'exécution, efforts de raisonnement par modèle, recherche/lecture web, génération d'images et pont d'identifiants en streaming, plus les canaux d'abonnement TraeWork CN et Qoder CN via des passerelles de traduction locales et un registre de fournisseurs compatibles OpenAI par type de clé, le tout géré depuis une carte de paramètres en accordéon.
Installer
dsh plugin --profile web add github:taikaikaikai-pixel/dsh-codebuddy-pluginREADME
dsh-tap
DeepSeek Harness（dsh）的非官方上游插件包：把三个模型上游接入 dsh 的对话模型选择器与工具链，并自带 Web UI 设置卡。纯 ESM、无构建步骤，Node ≥ 22。
| 上游 | 版本 | 凭据方式 | 本地网关 | 模型目录来源 |
|---|---|---|---|---|
CodeBuddy（腾讯 copilot.tencent.com，默认通道） | v0.1.0 起 | OAuth（推荐）或 API Key（多把 Key 逐请求轮询 + 失败冷却） | 流式桥 127.0.0.1:3901 | 网关 /v3/config 动态同步 + 静态兜底清单 |
| TraeWork CN（字节 TRAE SOLO CN 订阅额度） | v0.8.x 起 | 自持 ECDSA P-256 设备密钥的 OAuth 设备流 | OpenAI↔Trae 翻译网关 127.0.0.1:3902 | 本机 state.vscdb 只读提取 |
| Qoder CN（阿里 qoder.cn 订阅额度） | v0.9.7/0.9.8 起 | PKCE S256 设备流 OAuth | OpenAI↔COSY 加密信封翻译网关 127.0.0.1:3903 | 签名 GET /algo/api/v2/model/list |
另含 key 型 OpenAI 兼容上游注册表：预设火山引擎 Ark、阿里云百炼、DeepSeek、智谱 BigModel、Moonshot AI、OpenRouter、Qwen Code 7 家，或自定义（id + baseURL）+ API Key，模型统一进对话选择器、免重启。
快速开始
安装
# 本地路径安装（把本插件装进 web profile）
dsh plugin --profile web add /path/to/dsh-tap
# 或从 GitHub 安装
dsh plugin --profile web add github:taikaikaikai-pixel/dsh-codebuddy-plugin
安装后重启 dsh 进程生效。dsh ≥ 0.1.6 在侧栏「插件」→ Plugin Manager → dsh-tap 打开设置卡；更旧宿主在 Settings → 插件配置 → dsh-tap。
凭据
- CodeBuddy：设置卡 CodeBuddy 区块「凭据」组切换登录方式。OAuth 登录（推荐）= 浏览器完成官方登录页授权，无需任何环境变量，令牌自动续期；API Key = 卡内添加一把或多把 Key（多把自动轮询 + 失败冷却），或写
~/.dsh/.credentials.yaml的CODEBUDDY_API_KEY/ 同名环境变量兜底。 - TraeWork CN：启用通道（区块头开关）→「凭据」组登录（浏览器授权一次）→ 模型自动出现。
- Qoder CN：「凭据」组登录（浏览器授权）→ 区块头启用通道 → 模型自动出现。
三家凭据分别存 ~/.dsh/codebuddy-plugin-auth.json、~/.dsh/trae-plugin-auth.json、~/.dsh/qoder-plugin-auth.json，永不回传浏览器；API Key 只回脱敏显示（ck_a…5678）。
默认行为
装好即生效：静态补丁把 CodeBuddy provider 路由指向本地流式桥（默认模型 deepseek-v3）、web_search/web_fetch 钉选 CodeBuddy 后端、注册 image_generate 生图工具；三家目录在启用/登录后自动同步进选择器。所有主聊天与工具请求经本地网关统一收口凭据，调用方不自带密钥。
模型
清单默认动态化：CodeBuddy 通道启动时自动从网关 GET /v3/config 同步目录（目录新模型自动出现），网关不可达时无感回落下表静态清单，选择器绝不变空；设置卡各通道「模型」组可手动「同步目录」、逐模型启停、行内调节上下文/输出上限。
静态兜底清单 23 个模型（2026-09-22 按网关目录对齐尺寸；下表为该快照，运行时以目录同步结果为准）：
| 模型 | 厂商 | contextWindow | maxTokens | 图片 |
|---|---|---|---|---|
| deepseek-v3 | DeepSeek | 131072 | 32768 | — |
| deepseek-v3.2 | DeepSeek | 131072 | 32768 | — |
| deepseek-r1 | DeepSeek | 131072 | 32768 | — |
| deepseek-v4-pro | DeepSeek | 1000000 | 128000 | ✔ |
| deepseek-v4-flash | DeepSeek | 1000000 | 50000 | ✔ |
| deepseek-v4.1-flash | DeepSeek | 1000000 | 128000 | ✔ |
| deepseek-v3-2-volc | DeepSeek | 96000 | 32000 | — |
| glm-5.1 | 智谱 | 200000 | 48000 | ✔ |
| glm-5.2 | 智谱 | 1000000 | 64000 | ✔ |
| glm-5.3 | 智谱 | 1000000 | 64000 | ✔ |
| glm-5.0-turbo | 智谱 | 200000 | 48000 | — |
| glm-5v-turbo | 智谱 | 200000 | 64000 | ✔ |
| kimi-k2.5 | Moonshot | 164000 | 32000 | ✔ |
| kimi-k2.6 | Moonshot | 256000 | 32000 | ✔ |
| kimi-k2.7 | Moonshot | 256000 | 32000 | ✔ |
| kimi-k3 | Moonshot | 262144 | 32768 | — |
| kimi-k3-1 | Moonshot | 1000000 | 32000 | ✔ |
| minimax-m2.7 | MiniMax | 200000 | 48000 | ✔ |
| minimax-m3 | MiniMax | 512000 | 64000 | ✔ |
| hy3 | 腾讯混元 | 192000 | 64000 | ✔ |
| hy3-x | 腾讯混元 | 192000 | 64000 | ✔ |
| hy3-preview | 腾讯混元 | 262144 | 32768 | — |
| auto | 自动路由 | 262144 | 32768 | — |
思考强度：逐模型行内下拉（存 effortByModel，出站注入 reasoning_effort，请求方显式携带时不覆盖）。档位来源 = 网关目录新形态能力清单（supportedEfforts/canDisableThinking）∪ 静态实测表（2026-09-22 162 臂复测，证据 docs/probes/codebuddy-efforts-matrix-2026-09-22.json）。off 档只在"省略参数即不思考"的真开关模型上出现——canDisableThinking:true 不等于存在可靠的关思考拼写，插件不臆造线值。
注意：dsh 内置的"获取可用模型"对本网关永远无效——CodeBuddy 网关没有 OpenAI 风格的 GET /models（404）。目录里存在 ≠ /v2 可路由（glm-4.6v/kimi-k2-thinking/minimax-m2.5/hy4-preview-x 恒报 11102，刻意不进静态清单）。
工具
网络搜索与网页抓取
dsh 原生 web_search / web_fetch 被接到 CodeBuddy 网关的 /agenttool 端点（与官方 CLI 同源，索引较新），凭据复用 CodeBuddy 登录态。补丁已钉选 codebuddy 后端，无需配置；临时切回其他后端可设 DSH_WEB_SEARCH_PROVIDER / DSH_WEB_FETCH_PROVIDER。
| 设置 | 默认 | 说明 |
|---|---|---|
一键开关 searchEnabled | 开 | 禁用即注销 codebuddy 后端，开启即时恢复 |
搜索默认条数 searchMaxResults | 5 | web_search 未指定时（1–20） |
抓取正文上限 fetchBodyCap | 200000 | web_fetch 返回正文字符上限 |
图像生成
image_generate 按提示词出图（约 20 秒/张，模型 hunyuan-image-v3.0-art，走 /v2/images/generations），PNG 落盘会话工作区（无工作区时 ~/.dsh/generated-images/）。开关 imageGenEnabled（默认开）。
识图（describe-image）
标注"图片 ✔"的模型接受 image_url 输入。装了 @linxin666/dsh-web-ui-all 时，Web UI 贴图会经 describe-image 工具走视觉端点——该工具发非流式请求，而 CodeBuddy 网关只支持流式（非流式报 11101），流式桥为此把非流式请求转流式再聚合成标准 JSON。在 dsh 侧配置（dsh ≤ 0.1.6 写 ~/.dsh/settings.yaml；0.1.7+ 写 profile 的 cordis patch）：
describe-image:
baseURL: http://127.0.0.1:3901/v2
model: glm-5v-turbo
apiKeyEnv: CODEBUDDY_API_KEY
apiStyle: chat-completions
设置卡
v0.10.0 起是四区块通道手风琴：CodeBuddy → TraeWork CN → Qoder CN → 通用，默认全部收起，首屏即四条状态行（登录态 / 模型数 / 网关端口 / 额度与服务商数；warn/err 就地出现在所属区块头，不展开也读得到）。展开后按 凭据 → 模型 → [工具] → 网关 → 高级 分组（只有 CodeBuddy 有「工具」组），修改即保存、立即生效。展开才挂载、收起不卸载——草稿与已拉目录跨收起保留。
设置持久化在 ~/.dsh/codebuddy-plugin.json（优先级：该文件 > 插件组合配置 > 默认值）。模型启停/上限等宿主侧写入经 host-config.js 按宿主版本选路：dsh 0.1.7+ 写 profile 的 cordis patch（Settings forms seam），≤0.1.6 写 ~/.dsh/settings.yaml。
登录与凭据（CodeBuddy）
- API Key 模式：多把 Key 逐请求轮询，遇 401/403/429/5xx/网络错误自动在同一请求内换下一把，失败 Key 冷却
keyCooldownMs（默认 60000ms）后自动回到轮换；单选仅决定目录拉取用的 Key，全不选时回落环境变量引用。 - OAuth 模式：浏览器完成
copilot.tencent.com/login授权，插件轮询握手（约 10 分钟超时），完成后显示账号昵称与令牌到期时间，到期前自动续期。流程与官方 CLI 一致。
服务商注册表（通用区块）
- 添加时先实测
GET /models验证 key 并拉目录；无/models的上游自动改用最小 chat 探针 + 内置清单兜底；公开目录型（OpenRouter）走 chat 探针验 key + 静态精选目录。 - provider 块落宿主配置层（同上选路），key 落
~/.dsh/.credentials.yaml（权限 0600，只回脱敏显示）；每行可"刷新模型"与"删除"（连同凭据一起清）。 - 本机凭据扫描：只读扫描本机已装 agent 工具的登录态文件，检测到即提示"一键导入"——逐个确认的显式动作，扫描绝不回传任何 secret 值。
额度与用量（通用区块）
展开时 10s 轮询、收起即停：
- 消耗量（精确）：桥对每个请求的网关
usage.credit恒开计量（搜索/抓取/生图同样入账），持久化在~/.dsh/codebuddy-plugin-usage.json；展示今日/累计 credit 与请求数、最近轮次（含缓存命中率）。 - 账户额度信号：套餐类型与企业名（
GET /v2/accounts）、额度不足告警文案（get-dosage-notify）。 - 数字剩余额度（OAuth 模式）：
/billing/meter/get-user-resource（每分钟缓存）；api-key 模式不开放，改显"手填总额 − 本插件计量累计"的估算值并标注。 - 网关状态：运行中 / 端口占用（EADDRINUSE）/ 已禁用。
流式桥（CodeBuddy 网关）
| 设置 | 默认 | 说明 |
|---|---|---|
启用 bridgeEnabled | 开 | 禁用即停本地监听，主聊天随之中断 |
端口 bridgePort | 3901 | 须与 cordis.patch.yml 的 baseURL 端口一致，否则主聊天断 |
会话归因注入 sessionHeadersEnabled | 开 | 按入站会话 id 补全会话头；调用方已设置的头保留原值 |
会话头格式 sessionHeaderFormat | openai | openai 或 openrouter |
每会话并发上限 maxConcurrentPerSession | 4 | 同会话超额 FIFO 排队；无会话 id 不限流 |
桥在 127.0.0.1 是统一出口与唯一凭据入口：流式入站透传 SSE、非流式入站聚合为标准 JSON，其余路径（如 /agenttool/*）原样透传。端口被占用时只告警不崩溃。Trae/Qoder 翻译网关同理：启用通道即起在 3902/3903（traeBridgePort/qoderBridgePort 可调），禁用/退出即停。
开发与验证
校验套件（全部离线，mock 上游；断言数为 2026-09-23 复跑口径）
| 命令 | 覆盖 |
|---|---|
node scripts/verify-models.mjs --list | 离线自检模型解析（当前 23 条） |
node scripts/verify-models.mjs --sync / --efforts [id…] | 在线目录漂移对比 / 档位探测（消耗额度） |
npm run verify | 在线逐模型真实探测（消耗额度） |
npm run verify:bridge | 流式桥端到端（mock 网关，断言响应完成） |
npm run verify:rotation | 多 Key 轮询 / 冷却 / failover |
npm run verify:core | core/ provider 无关性证伪（静态纯净扫描 + 第二上游全链路） |
npm run verify:providers | 多服务商骨架（/models 404 兜底 + 认证方言） |
npm run verify:trae-provider | Trae 通道全链路（89 断言） |
npm run verify:qoder | Qoder 通道全链路（154 断言） |
npm run verify:host-config | 宿主配置层选路 / 冲突重试 / 降级（36 断言） |
联调探针：换机器或上游协议变动后，node scripts/probe-trae-live.mjs --login 再 --chat "你好"、node scripts/probe-qoder-live.mjs --login 再 --chat "你好" 校准（证据落 docs/probes/）。Qoder 专项差分探针见 scripts/probe-qoder-*.mjs。
诊断入口：GET /dsh-tap/settings?probe=host-config 报宿主配置层选路 / 可写性 / revision / 有效 provider 清单——升级后排查不必猜。
架构与文档地图
三层（静态补丁 → 组合根 → 凭据边缘层 + 各上游适配器 + 浏览器半）的职责边界与改动生效方式见 AGENTS.md；深入叙述：
| 要什么 | 去哪 |
|---|---|
| 网关事实全表（headers/错误码/目录/额度/缓存） | docs/rules/gateway-facts.md（+ 同目录各专题） |
| 踩坑全本（#1–#49，每条含代价与修复） | docs/pitfalls.md |
| Trae / Qoder 协议逆向与设计依据 | docs/reverse/、docs/goals/ |
| 原始实测证据 | docs/probes/ |
| 架构与各上游模块叙述 | wiki/01-architecture.md ~ 10-provider-qoder.md |
| 版本史 | CHANGELOG.md |
卸载
dsh plugin --profile web rm dsh-tap
免责声明
- 本项目是非官方的第三方开源插件，与腾讯（CodeBuddy / WorkBuddy）、字节（Trae / TRAE SOLO）、阿里（Qoder）、DeepSeek 及各模型厂商无任何隶属、赞助或背书关系；相关名称与商标归其各自权利人所有。
- 本项目按 MIT 协议**"原样"提供，不附带任何明示或默示担保**（包括但不限于适销性、特定用途适用性与不侵权担保）。使用者须自行承担使用风险。
- 使用者应确保其使用方式符合各上游平台（CodeBuddy、TraeWork、Qoder）的服务条款及相关规则；因使用本插件导致的账号限制、额度扣减、服务中断或任何直接或间接损失，作者不承担任何责任。
- 各网关接口均为未公开的内部形态，可能随时变更或失效，本项目不承诺持续可用。
- 凭据（API Key / OAuth 令牌）仅存储于使用者本机
~/.dsh/目录，请妥善保管，切勿提交到任何公开仓库。
许可
MIT
Plugins associés
dsh-routing-suite
yjh051108/dsh-routing-suite
dsh-plugin-subscriptions
v1ki/dsh-plugin-subscriptions
dsh-commandcode-provider
mars-sea/dsh-commandcode-provider
dsh-our-free-model
zouyuxuan122/dsh-our-free-model