前言¶

DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在接入 workbuddy2api 本地网关时，通常涉及手工配置模型元数据、手动管理进程生命周期、下载二进制文件以及处理登录流程。本插件旨在接管这些重复性工作，实现网关进程的托管与模型目录的自动同步。

插件定位¶

dsh-workbuddy2api 是一个 DeepSeek Harness (DSH) 插件，用于监管 workbuddy2api 网关进程并自动注册其模型。它不包含逻辑实现，仅负责两件事：进程生命周期管理，和模型目录自动化。

核心功能¶

1. 进程托管：dsh 启动时自动拉起网关，退出时自动回收。若端口已有健康网关在跑，直接复用，不重复拉起，也不会去杀别人的进程。
2. 模型同步：模型目录自动同步，实时读取网关 /v1/models 接口，自动映射模型列表、上下文窗口、输出上限及思考档位。
3. 一键安装：通过 /wb2api-setup 命令自动下载网关二进制（含 SHA256 校验）、准备运行目录、引导登录并启动。
4. 管理命令：提供 6 条管理命令，涵盖初始化、状态查询、启停控制。
5. 认证与策略：内置 OAuth 登录流程，支持协议适配、账号池、加权选号、分级熔断与定时任务。

安装与启用¶

使用以下命令完成安装（版本 v0.3.2）：

dsh plugin --profile web add https://github.com/tearslee/dsh-workbuddy2api/releases/download/v0.3.2/dsh-workbuddy2api-0.3.2.tgz

安装后必须重启 dsh 才能使新插件生效。

使用与配置¶

在对话中执行 /wb2api-setup 完成初始化。该命令会依次定位或下载网关可执行文件、准备运行目录、引导登录并启动网关。

常用命令还包括：
* /wb2api-status：查看网关状态。
* /wb2api-start：启动网关。
* /wb2api-restart：重启网关。

在 cordis.patch.yml 中配置相关参数以启用 provider：

- insert:
    - id: workbuddy2api
      name: 'dsh-workbuddy2api'
      config:
        baseURL: http://127.0.0.1:7863/v1
        autoStart: true

注意事项¶

1. 安装后必须重启：新安装的插件代码不会在运行时热加载，需重启 dsh。
2. 包名冲突：npm 上的同名包已被占用，请勿使用 dsh plugin add dsh-workbuddy2api，请认准 GitHub Release 产物。
3. 上游仓库状态：上游原仓库已删库，需使用延续仓库。
4. 产物校验：产物来自 Releases，下载后需校验 SHA256。
5. 不支持热挂载：不支持在运行中热挂载新插件。