DSH（DeepSeek Harness）是一个 AI 编程前端，使用前需配置模型提供商。如果你持有腾讯 CodeBuddy（WorkBuddy）账号，希望在不产生 API 费用的情况下使用其额度，需要一个本地的 OpenAI 兼容网关。ethanweave/dsh-connect-workbuddy 插件为上游网关提供了 Windows 环境下的安装、自启与运维套件，将其转化为可直接在 DSH 中调用的本地服务。
核心功能¶
插件主要解决 Windows 下本地网关的部署与维护问题：
- 一键安装：自动下载官方二进制文件，进行 SHA256 校验，并写入
%USERPROFILE%\workbuddy-gateway目录。 - 登录自启：注册系统计划任务
WorkBuddy Gateway，实现开机自动拉起网关。 - 统一管理：提供
manage.ps1脚本，支持对网关进行启动、停止、重启、查看日志和卸载操作。 - 健康检查：通过脚本监控任务状态、进程运行情况、端口占用以及 HTTP 服务的可用性。
- 安全默认：凭据不入库；默认仅监听
127.0.0.1；支持配置 API Key 以增加访问控制。
安装与启用¶
在 DSH 终端中执行以下命令安装插件：
dsh plugin add github:ethanweave/dsh-connect-workbuddy
安装完成后，在 DSH 的设置中添加模型提供商。配置如下：
- 协议：OpenAI 兼容
- Base URL：
http://127.0.0.1:8317/v1 - API Key：随意填写（网关默认不校验 Key）
- 模型：可访问
http://127.0.0.1:8317/v1/models获取可用模型 ID
网关管理¶
插件提供 scripts\manage.ps1 脚本用于管理网关运行状态：
.\scripts\manage.ps1 status # 查看任务/进程/端口/HTTP 四层状态
.\scripts\manage.ps1 start # 启动计划任务
.\scripts\manage.ps1 stop # 停止任务并结束进程
.\scripts\manage.ps1 restart # 重启服务
.\scripts\manage.ps1 logs # 查看网关日志（默认读取最近 200 行）
.\scripts\manage.ps1 update # 升级二进制并自动重启
.\scripts\manage.ps1 uninstall # 卸载服务与文件（-Force 参数跳过确认）
账号登录¶
首次使用前，需在本地执行登录命令以获取访问令牌：
& "$env:USERPROFILE\workbuddy-gateway\workbuddy-gateway.exe" login
注意事项¶
- 凭据安全：
workbuddy.json文件包含真实登录凭据，切勿提交至代码仓库、粘贴分享或上传网盘。 - 网络限制：默认仅监听
127.0.0.1。若需远程访问，需修改监听地址并配合防火墙策略及 API Key。 - 权限要求：不需要管理员权限，计划任务以当前用户身份注册和运行。
- 服务条款：插件仅做本地转发，不提供绕过额度限制的能力，需遵守上游服务条款。
通过该插件，可以在 DSH 中直接调用腾讯 CodeBuddy 的额度，无需手动处理网关的部署与自启流程。
