finch-workbuddy-bridge

把 WorkBuddy 桌面 App 的模型以本地 OpenAI 兼容接口（默认 http://127.0.0.1:8787/v1）暴露给 Finch 的自定义 provider。

Finch 小程序形态：随 Finch 启停，桥只在 Finch 运行时存在——正好匹配"只有 Finch 要用时桥才需要在"的语义。

安装

npx @finchtoys/minitools add finch-workbuddy-bridge

然后在 Finch 工具箱里启用。启动后终端/日志里会看到桥在 127.0.0.1:8787 上服务。

接入 Finch

1. 启用本小程序，桥自动启动。
2. 打开小程序的设置菜单（工具箱卡片或会话头部）→ 一键写入 Finch 设置：Finch 会打开预填好的「添加自定义模型提供商」表单，确认保存即可。
   • 或者选 查看接入配置，手动填：API 协议 OpenAI Chat、Base URL、API Key。
3. 点「探测」拉到模型列表，勾选启用。

设置

| 字段 | 默认 | 说明 | |---|---|---| | 回环端口 | 8787 | 被占时自动顺延，菜单显示实际地址 | | WorkBuddy 产品 | 国内版 | 可切国际版 workbuddy-ai |

设置保存后小程序会重载，桥随之用新配置重启。

工作原理

• 协议层、凭证处理、目录解析全部来自 dsh-workbuddy-connect（MIT）：构建期由 build/vendor.mjs 从本地 clone 拷入 vendored/，并把两个 @deepseek-ai/* 工具包 import 改写到 src/shims/，产物自包含、无运行时全局钩子（PluginHost 是多小程序共享进程，不能改模块解析）。
• 复用 WorkBuddy 桌面 App 的登录态（只读其凭证文件），令牌到期由桥自己续期，App 不必一直开着。
• 首次启动若发现 CLI 版遗留的密钥文件（~/.workbuddy-bridge/api-key）会自动收编，端口也同为 8787。
• 上游 429 限流时桥进入 15 秒冷却门（快速失败 + Retry-After），避免客户端重试风暴延长限流窗口。

从源码构建 / 发布

需要一份 dsh-workbuddy-connect 的 clone 放在本项目旁（或设 WORKBUDDY_CONNECT_DIR）：

npm install
npm run check   # typecheck + esbuild bundle + doctor
npx @finchtoys/minitools add .

限制

• Finch 不运行就没有桥；需要给 Finch 之外的客户端用，请跑同源的 CLI 版。
• 依赖 WorkBuddy 客户端私有接口，上游更新后需重跑 npm run vendor 同步。

免责声明

仅供个人学习与研究，仅驱动使用者自己的 WorkBuddy 账号在本机调用；请遵守 WorkBuddy 服务条款，风险自负。与腾讯、WorkBuddy、DeepSeek 均无关联。