DeepSeek HarnessHub
提交插件

ethanweave/workbuddy-gateway-dsh ↗★ 1

workbuddy-gateway-dsh

将腾讯CodeBuddy额度转为本地OpenAI兼容网关 适合希望在DSH中免费使用自己腾讯CodeBuddy账号模型额度的Windows用户。

其他擴充
套件
workbuddy-gateway-dsh
相容性
待驗證
版本
1.0.0
授權
NOASSERTION
最近更新
2026年10月8日

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:ethanweave/workbuddy-gateway-dsh

說明文件

閱讀完整 README ↗

腾讯CodeBuddy网关管家-Windows版

一句话：让你在 DSH 里免费白嫖腾讯 CodeBuddy（WorkBuddy）的模型额度。

DSH（DeepSeek Harness） 本身是一个 AI 编程前端， 它需要你配置一个模型提供商；而本项目的思路是：用你自己的腾讯 CodeBuddy（WorkBuddy）账号额度 作为这个提供商 —— 账号里自带的每月额度 + 免费模型，从此在 DSH 里随便用，不花一分钱 API 费。

它是怎么工作的（3 步看懂）

┌─────────┐      ┌──────────────────────┐      ┌─────────────────────┐
│   DSH   │ ───► │  本项目（本机网关）   │ ───► │ 腾讯 CodeBuddy 额度  │
│ 写代码   │      │  127.0.0.1:8317      │      │ （你自己的账号）     │
└─────────┘      └──────────────────────┘      └─────────────────────┘
  1. DSH 发起请求 → 发到本机 127.0.0.1:8317（OpenAI 兼容格式）
  2. 本机网关中转 → 把请求翻译成 CodeBuddy 协议，用你已登录的账号调用上游
  3. 额度扣在 CodeBuddy → DSH 那边不需要任何 API Key / 充值 / 订阅

所以整个链路是：DSH → 本项目网关 → CodeBuddy 额度 → 上游模型， 你的 API 费用 = 0，消耗的是 CodeBuddy 账号本身的额度（含免费模型）。

[!NOTE] 网关本体来自上游 CangShui/workbuddy-gateway （Go 编写，单二进制）。本项目是它的 Windows 增强套件：一键安装、开机自启、统一管理， 让上面这条链路在 Windows 上开机即用、全程无感。

为什么需要本项目（而不是只装上游）

上游网关是个命令行程序，装完还要手动启动。本项目补齐 Windows 场景：

能力说明
一键安装自动下载官方二进制 + SHA256 校验，写入 %USERPROFILE%\workbuddy-gateway
登录自启注册计划任务 WorkBuddy Gateway，开机后自动拉起网关，防重复启动
统一管理manage.ps1：status / start / stop / restart / logs / update / uninstall
健康检查任务 / 进程 / 端口 / HTTP 四层状态一目了然
安全默认凭据永不入库；默认仅监听 127.0.0.1；可选 API Key

快速开始

方式一：作为 DSH 插件安装（推荐）

dsh plugin add github:ethanweave/workbuddy-gateway-dsh

安装后直接对 Agent 说「帮我接入 WorkBuddy 网关」，它会按内置技能完成 安装、启动、排障，并指导你配置 DSH 提供商。

方式二：直接使用脚本

# 1. 安装（自动下载官方二进制并校验）
.\scripts\install.ps1

# 2. 登录你的腾讯 CodeBuddy / WorkBuddy 账号（扫码或浏览器验证）
& "$env:USERPROFILE\workbuddy-gateway\workbuddy-gateway.exe" login

# 3. 启动网关（之后开机自启，无需再管）
.\scripts\manage.ps1 start

然后在 DSH → 设置 → 提供商 里填：

设置值
协议OpenAI 兼容
Base URLhttp://127.0.0.1:8317/v1
API Key随意填（网关默认不校验）
模型打开 复制任意 ID

完成。在 DSH 里发起对话，模型响应来自你的 CodeBuddy 额度。

Cherry Studio / Chatbox 等其他 OpenAI 兼容客户端同样适用， 详见 docs/clients.zh-CN.md。

管理命令

.\scripts\manage.ps1 status     # 任务 / 进程 / 端口 / HTTP 四层状态
.\scripts\manage.ps1 start      # 启动计划任务（等效开机自启路径）
.\scripts\manage.ps1 stop       # 停止任务并结束进程
.\scripts\manage.ps1 restart    # 先 stop 再 start
.\scripts\manage.ps1 logs       # 查看网关日志（-Lines 200）
.\scripts\manage.ps1 update     # 升级二进制并自动重启
.\scripts\manage.ps1 uninstall  # 停止 + 删除任务 + 删除安装目录（-Force 跳过确认）

目录结构

scripts/install.ps1            一键安装（下载 + 校验 + 计划任务）
scripts/manage.ps1             日常管理入口
scripts/gateway-task.ps1       计划任务实际执行的自启脚本
scripts/common.ps1             共享函数库（路径 / 日志 / 健康检查）
docs/clients.zh-CN.md          客户端接入指南（DSH / Cherry Studio / Chatbox）
docs/troubleshooting.zh-CN.md  常见问题排查

常见疑问

Q：真的免费吗？ A：消耗的是你腾讯 CodeBuddy / WorkBuddy 账号自带的额度（部分模型完全免费）， 不产生任何新的 API 费用。额度用完或账号受限时，以账号实际状态为准。

Q：需要管理员权限吗？ A：不需要。计划任务以当前用户身份注册和运行。

Q：要做网络配置吗？换个电脑还能用吗？ A：不需要任何网络配置。网关和 DSH 都装在用户自己的电脑上，127.0.0.1 永远指向本机——不管你用的是哪台 Windows 设备，安装脚本跑一遍就开箱即用。 只有当你想让别的设备（手机 / 另一台电脑）也调用这台机器的网关时， 才涉及网络改造（见下方安全须知）。

Q：聊天报认证错误？ A：先跑 workbuddy-gateway.exe status 看账号状态，失效就重新 login，其余见 docs/troubleshooting.zh-CN.md。

安全须知

  • workbuddy.json 是真实登录凭据，切勿提交仓库、粘贴聊天或上传网盘。
  • 不要为远程访问直接把监听改成 0.0.0.0，需要时用防火墙 + API Key 另行设计。
  • 请遵守上游服务条款；本项目不提供任何绕过额度限制的能力。

相关链接

License

MIT