作为 dsh 插件使用（推荐）

本仓库同时提供 DeepSeek Harness 原生插件（dsh-plugin/）。 两者是一套，不是二选一：

插件当引擎，控制台的全部功能搬进 dsh 设置页 —— 两个前端、一个后端。 插件在 dsh 里注册原生模型路由、把桥和控制台都管起来（已在跑就复用，没跑就拉起）； 设置 → WorkBuddy 里有 9 个标签页：概览 / 账号 / 用量 / 请求 / 签到 / 诊断 / 模型 / 对话测试 / 日志，功能与控制台网页完全等价：读同一个桥、写同一份 .state.json（账号切换等写操作由插件透传给控制台执行，保证只有它写），在任意一边改，另一边同步变化。原控制台照常可用。

	装插件后	不装插件
模型注册	运行时注册 provider `workbuddy`，不写任何配置文件	控制台写 `settings.yaml` + profile patch
模型增删	动态跟随上游目录，改完即生效	需要重新勾选并保存
桥的启停	插件自动复用/拉起	控制台按钮，或 `启动.cmd`
数据界面	dsh 设置页（9 个标签页） + 控制台网页，两边同步	只有控制台网页
agent 侧	5 个工具 + `/workbuddy` 命令	无

dsh plugin --profile desktop add /dsh-plugin

装完重启一次 dsh（插件模块与客户端引导行只在启动时组装）。两种方式可以共存：控制台照旧能开，桥是同一个进程；但不要同时保留旧的手写 llm-pi-ai.providers.workbuddy 路由——插件首次加载会自动把它清掉（先备份）。

细节、配置项与验证记录见 dsh-plugin/README.md。

配置

统一配置真源是 config.mjs，优先级： 进程环境变量 > .env > 内置默认值。

copy .env.example .env

常用项：

变量	默认值	说明
`WORKBUDDY_PORT`	`8790`	桥监听端口
`WORKBUDDY_LOCAL_TOKEN`	`wb-local-bridge`	本地回环令牌，仅防同机误用，不是上游凭据
`DASHBOARD_PORT`	`8792`	控制台端口
`WORKBUDDY_APP_EXECUTABLE`	自动探测	WorkBuddy 客户端路径
`WORKBUDDY_AUTH_FILE`	自动定位	登录文件；多账号时务必显式指定

完整列表见 .env.example 与 docs/CONFIGURATION.md。

改端口后需同步：控制台会按新配置启动桥，无需手工对齐。

workbuddy-to-dsh

安装

说明文档

作为 dsh 插件使用（推荐）

配置