aybrt/workbuddy-dsh-plugin

workbuddy-dsh-plugin — WorkBuddy 模型接入 DeepSeek Harness

WorkBuddy 即腾讯 CodeBuddy Code 桌面版（Electron，C:\Program Files\WorkBuddy，
配置 %USERPROFILE%\.workbuddy\）。它的云端模型（glm-5.2 / kimi-k3-1 / deepseek-v4-flash /
minimax-m3 / hunyuan 系列等 40+ 个）走腾讯网关 https://copilot.tencent.com + SSO 鉴权，
无法用 API Key 直连——本插件通过 WorkBuddy 自己的 agent 引擎（codebuddy CLI）来调用它们，
并注册为 DSH 可用模型。不涉及手机、不涉及 API Key。

原理

DSH (pi-ai provider "workbuddy")
│  OpenAI 兼容  POST /v1/chat/completions（流式/非流式）
▼
bridge/server.js（127.0.0.1:8096）
│  生成参数并 spawn
▼
node …\cli\dist\codebuddy.js -p --model  --output-format stream-json --tools "Read,Grep,Glob"
▼
WorkBuddy agent 引擎（复用已登录的腾讯 SSO 会话；模型在引擎内部解析执行）

文件

| 文件 | 作用 |
|---|---|
| install.mjs | 读 product.json + ~/.workbuddy/models.json，生成模型表并注册到 pi-ai 与 DSH settings.yaml |
| bridge/server.js | 桥接：OpenAI 兼容 ↔ codebuddy CLI（SSE 流式翻译） |
| bridge/workbuddy-models.json | 生成的模型表（install.mjs 产出） |
| manager.mjs | 常驻管理器（推荐）：自动杀旧进程 → 选空闲端口 → 同步 settings → 起桥接 → 看门狗自动重启 |
| start.cmd | 双击启动管理器（隐藏窗口） |
| setup.ps1 | 旧版一键脚本（保留备用） |

使用（全自动，推荐）

双击 workbuddy-plugin\start.cmd

管理器会自动完成一切：清理旧桥接进程、自动挑选空闲端口（8096 起顺延，被占不报错）、
把端口同步进 DSH settings.yaml（llm-pi-ai.providers.workbuddy 独立路由）、启动桥接并验证、
崩溃自动重启。已注册开机自启（...\Startup\workbuddy-bridge.cmd），以后开机自动运行，无需手工操作。

查看当前端口：bridge\port.txt。

完成后：
- DSH 模型选择器出现独立分组 WorkBuddy（18 个账号可用模型：auto、hy3、glm-5.2、glm-5.1、
glm-5v-turbo、minimax-m3、kimi-k3-1、kimi-k2.7、kimi-k2.6、deepseek-v4-flash、deepseek-v4-pro、
glm-5.0-turbo、kimi-k2.5、minimax-m2.7、deepseek-v3-2-volc 及 3 个 custom-local:），
与 deepseek-official 分开；模型清单以 codebuddy CLI 400 报错中的账号支持列表为准
- Provider 路由：workbuddy，baseURL=http://127.0.0.1:/v1（已写入 settings.yaml）
- 凭据：WORKBUDDY_API_KEY 占位已写入 ~/.dsh/.credentials.yaml（桥接不校验 key）

手工/排障

node workbuddy-plugin\manager.mjs --once   # 单轮运行（排障用）
node workbuddy-plugin\manager.mjs          # 常驻看门狗
node workbuddy-plugin\install.mjs
node workbuddy-plugin\bridge\server.js

环境变量

| 变量 | 默认 | 说明 |
|---|---|---|
| WORKBUDDY_PORT | 8096 | 起始端口（被占自动顺延到 8190） |
| WORKBUDDY_CLI | 自动探测 | codebuddy.js 路径 |
| WORKBUDDY_TOOLS | 全量工具 | 白名单（Bash,Read,Write,Edit,MultiEdit,Glob,Grep,WebFetch,WebSearch,Task,TodoWrite,AskUserQuestion,KillShell,BashOutput,PowerShell）；只读安全模式可设 Read,Grep,Glob |
| WORKBUDDY_MAX_TURNS | 10 | codebuddy agent 内部最大轮次（调小更省点数，调大更智能） |
| WORKBUDDY_INSTALL_DIR | %LOCALAPPDATA%\Programs\WorkBuddy | 安装目录（install.mjs 用） |
| DSH_ROOT | npm 全局 dsh 路径 | DeepSeek Harness 安装位置（install.mjs 用） |

省点数建议

WorkBuddy 每日免费点数按模型调用 token 计费，桥接是 agent 模式，烧点比普通聊天快，主要开销：

1. codebuddy 系统提示词（Claude Code 系，每轮数千 token，每次调用都算）
2. agent 自动多轮：思考→调工具→看结果→再思考，一次对话可能内部跑多次模型调用
3. 无上下文缓存：每次请求全新会话、历史全量重发
4. 思考 token 计费：glm-5.2 / kimi- / deepseek-v4-* 的 thinking 照常烧点

省点姿势：
- 模型选便宜的：deepseek-v4-flash / glm-5.0-turbo，别用 auto（可能路由到最贵的）
- 别开 agent 任务：纯问答直接用聊天，不触发多轮工具循环
- 调小 WORKBUDDY_MAX_TURNS（如 3~5）
- 工具模式（DSH 执行工具）历史只保留最近 8 条，长会话建议新建对话

验证

curl http://127.0.0.1:/health      # port 见 bridge\port.txt
curl http://127.0.0.1:/v1/models
curl -X POST http://127.0.0.1:8096/v1/chat/completions -H "Content-Type: application/json" ^
-d "]}"

提示：首次调用需要 WorkBuddy 桌面端已登录（CLI 与 GUI 共用登录态）。模型用量按
WorkBuddy 账号计费（腾讯网关侧），与 DSH 无关。