DeepSeek Harness 插件：WorkBuddy 网关集成

前言¶

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。如果你需要使用 WorkBuddy（国际版或国内版）的订阅额度，但 DSH 原生不支持该服务，这个插件可以帮你解决。它通过在本地运行一个网关，将 WorkBuddy 的订阅接口转换为 OpenAI 兼容接口，供 DSH 调用。

插件简介¶

名称：dsh-plugin-workbuddy-gateway
维护者：Acoder416
类别：模型推理
许可证：MIT
核心功能：在 DSH 设置页管理 WorkBuddy 账号、本地网关和模型路由。网关将 WorkBuddy 国际版或国内版的订阅接口转换为 OpenAI 兼容接口。

核心功能¶

网关控制：在「设置 → WorkBuddy」中启动、停止、重启网关，查看端口、进程和日志。
账号管理：支持从桌面端导入账号，或通过浏览器 OAuth 授权登录。显示账号积分余额、最近确认的签到领取状态。
账号操作：启用、停用或移除账号；网关在同一区域内选择可用账号。
模型路由：将网关模型写入 DSH 的 llm-pi-ai 提供方配置。
平台支持：支持 Windows/macOS/Linux 的网关运行与进程管理、桌面凭证扫描。

安装与启用¶

安装前请确保已安装并初始化 web profile，具备 Web 设置、凭据与 llm-pi-ai 服务。

安装插件：

    dsh plugin --profile web add "github:Acoder416/dsh-plugin-workbuddy-gateway#v0.2.6"

启用插件：
安装后需要手动启用。编辑 ~/.dsh/profiles/web/package.json（或自定义 profile 对应的目录），在 dsh.profile.bundles 数组末尾添加插件名：

    {
      "dsh": {
        "profile": {
          "bundles": [
            "@deepseek-ai/dsh-base",
            "@deepseek-ai/dsh-web-app",
            "dsh-plugin-workbuddy-gateway"
          ]
        }
      }
    }

保存后停止并重新启动 DSH，刷新浏览器。

使用步骤¶

打开「设置 → WorkBuddy」，确认网关已启动。默认监听 127.0.0.1:18088。
选择国际版或国内版区域，导入账号（点击「扫描桌面端账号」或「浏览器授权登录」）。
检查账号积分，可手动刷新积分或国内版签到。
点击「写入模型路由」，刷新页面后，在 DSH 的模型选择器中即可选择对应的模型。

注意事项¶

非官方集成：本插件不是 WorkBuddy / 腾讯官方集成，依赖订阅端内部接口和 DSH 内部扩展接口。接口变化可能导致功能失效，使用也可能触发服务条款限制或账号风控。
环境依赖：需要安装并初始化 web profile，具备 Web 设置、凭据与 llm-pi-ai 服务。
数据安全：账号访问令牌、刷新令牌等敏感信息保存在 $DSH_HOME/workbuddy/accounts/。不要上传到公共代码仓库或反馈截图。保持本地监听和接口鉴权。
版本锁定：建议安装固定版本 v0.2.6。

总结¶

该插件通过本地网桥的方式，将 WorkBuddy 的订阅能力接入 DSH 生态。对于需要使用该服务但缺乏原生集成的用户，这是一个可行的替代方案。