DSH WorkBuddy
English | 简体中文
在 DeepSeek Harness 里连接 WorkBuddy 账号，查看额度、比较可用模型，并直接用于 DSH 对话。
面向 DSH web profile 的独立社区插件。当前为 自托管 Alpha，适合已有 DSH、能够维护 Python 服务与鉴权网关的用户。本项目不提供托管服务，也不主张获得 WorkBuddy 或 DeepSeek 的官方背书。
开始使用 · 部署指南 · 安全与数据处理 · 问题反馈
能帮你做什么
- 在 DSH 里看清账号与额度：通过浏览器登录，在「设置 → WorkBuddy」查看连接状态、Credits 余额和各额度包到期时间。
- 更容易选对模型：按名称或 ID 搜索，区分同名入口，比较 Credits 倍率与能力，筛选上游计费或有效活动明确标为免费的模型。目录仅纳入账号可用且支持工具调用的模型。
- 沿用 DSH 的工作流：在 WorkBuddy provider 下选择模型，使用流式响应与工具调用。浏览器授权完成后，无需持续运行 WorkBuddy 桌面客户端。
本插件独立于 A2D2 和 DimAgent 插件。界面截图展示当前体验，验收和恢复步骤见运行手册。
连接前请确认
- 第三方集成的许可：WorkBuddy 可接受使用政策第 3.5、4 节限制自动化访问，并要求互操作插件及外部组件事先取得书面许可。请结合适用的服务协议确认该接入方式获准后再使用。浏览器登录成功，不等于平台批准了第三方客户端。
- 一个服务共享一个账号：每个 Python 服务管理一个 WorkBuddy 账号，同一 DSH 实例的已认证用户共享其额度和账号控制。当前没有租户隔离；不同信任边界应独立部署，并遵守上游账号规则。
- 免费状态有条件：模型、活动、有效期及用量限制以上游账号规则为准，插件不会增加额度或提供无限使用。当前 provider 的数值成本字段对所有模型均填零，不能据此判断免费。详见费用与限制。
快速上手
前置条件
| 需要准备 | 检查要点 |
|---|---|
| 已运行的 DSH web 环境 | 本地评估使用 DSH 包 0.2.0-rc.2；更宽的 peer-dependency 范围不等于已验证兼容范围 |
| Node.js 与 pnpm | Node.js ^22.19.0 || >=24.0.0；按 packageManager 使用 pnpm 10.4.1 与仓库锁文件 |
| Python 服务主机 | Python >=3.10、uv、固定版本的 workbuddy2api 源码与常驻服务管理器；依赖由本插件锁定 |
| 鉴权网关 | 每个转发路由都需鉴权，转发时剥离网关 Bearer 凭据，跨主机使用 HTTPS；Python 仅监听回环地址 |
| 符合条件的 WorkBuddy 账号 | 确认第三方接入获准，且账号提供适用模型 |
当前需要从源码部署多个组件。仓库已提供 Caddy 鉴权网关配置、环境变量示例与 Supervisor 示例；连接账号前，请按自己的环境配置并验证。
从源码到第一条对话
- 构建插件：执行下方安装中的源码构建命令。
- 准备后端：检出固定版本的上游项目，设置私有凭据与日志路径。按照服务部署及首次部署步骤配置。
- 验证并连接网关：先确认缺失和错误凭据都会被拒绝，再将插件安装到 DSH profile，配置
gatewayBaseURL和gatewayKeyFile。 - 在 DSH 中授权：进入「设置 → WorkBuddy」，点击「登录 WorkBuddy」和「打开登录页」，完成浏览器授权后回到原设置页。确认显示「已连接」、模型清单和额度信息，必要时点击「刷新」。
- 测试一条简短对话：在 WorkBuddy provider 下选择可用模型。如果要用 DeepSeek，先在目录搜索
DeepSeek，核对具体模型 ID、计费信息和活动截止时间。先发一条简短提示，再验证一次只读工具调用与结果回传。测试可能消耗额度。
成功标准是设置页显示账号、选中的模型能流式回复、工具结果能回到同一对话。仅显示「已连接」不足以证明推理可用。遇到问题请查看常见检查项，不要通过关闭网关鉴权排障。
工作方式
DSH 网页 → DSH 主机插件 → 鉴权网关 → 回环地址上的 Python 服务 → WorkBuddy
模型请求复用 DSH 的 PiAiAdapter。独立运行的 Python 服务引用固定版本的 workbuddy2api，处理流式响应和工具调用协议转换。WorkBuddy Token 保存在服务端，浏览器只接收授权链接和账号信息；提示词、对话历史及工具数据会发送给上游进行推理。完整数据流与保留边界见 SECURITY.md。
界面截图
截图中的账号、实际额度和额度到期时间均已脱敏。模型可用性、倍率和免费活动以账号实时返回的数据为准，截图不代表长期定价承诺。
账号与 Credits 额度
查看连接状态、可用模型数、免费模型数，以及各额度包的余额和到期时间。
搜索模型
支持按名称或 ID 搜索。同名模型保留不同的 ID，并分别展示 Credits 倍率、上下文、最大输出和能力。
免费模型筛选
勾选「仅看免费」筛选当前明确免费的模型。免费状态来自上游计费字段和有效期内的活动；未知价格不会被当作免费。
费用与限制
能免费使用 DeepSeek 吗？ 账号资格、计费与允许的接入方式由上游决定。部分模型 ID 可能有临时活动，请核对账号当前返回的模型 ID、Credits 倍率、截止时间及用量限制。截图、其他渠道的十月活动或 DSH 中的零成本估算，都不能保证通过本插件发出的请求免费。
「仅看免费」代表什么？ 它筛选上游明确的零 Credits 计费，或将该模型 Credits 费用明确降为零的有效活动，未知价格不会被当作免费。筛选结果不验证剩余活动次数，也不会覆盖每日上限、速率限制或服务条款。权威计费及权益请以 WorkBuddy 账号为准；额度「未提供」不等于余额为零。
安装
先核对前置条件，再克隆并构建源码：
git clone https://github.com/a2d2-dev/dsh-workbuddy.git
cd dsh-workbuddy
pnpm install --frozen-lockfile
pnpm build
服务与鉴权网关准备就绪后，安装到已有 DSH web profile：
dsh plugin --profile web add /absolute/path/to/dsh-workbuddy
在该 profile 的 cordis.patch.yml 中配置：
- id: workbuddy
config:
gatewayBaseURL: https://workbuddy-gateway.example.com
gatewayKeyFile: /absolute/path/to/workbuddy-gateway-key
requestTimeoutMs: 30000
catalogTtlMs: 60000
streamIdleTimeoutMs: 300000
以上域名和路径是示例，需替换为自己的部署配置。密钥文件只包含网关的 Bearer 凭据，不要写成环境变量赋值语句。不要把 WorkBuddy 授权 Token 写入 DSH 配置或提交到仓库。网关必须启用鉴权，Python 服务应只监听回环地址，并由网关转发。
服务部署
需要 Python 3.10+ 和 uv。单独检出上游项目并切换到版本 1cc32c9a98abb53796d8d4e8d477736fe1f0c4cc。在本插件目录执行 uv sync --frozen --no-dev 安装锁定的服务依赖，再通过本插件的虚拟环境启动：
/absolute/path/to/dsh-workbuddy/.venv/bin/uvicorn \
--app-dir /absolute/path/to/dsh-workbuddy/server \
workbuddy_service:create_app --factory \
--host 127.0.0.1 --port 18788
通过 Supervisor 等服务管理器配置以下环境变量：
| 变量 | 用途 |
|---|---|
WORKBUDDY_PROXY_SOURCE |
固定版本的上游项目目录 |
WORKBUDDY_ENDPOINT |
WorkBuddy 后端地址，通常为 https://www.workbuddy.ai |
WORKBUDDY_SESSION_FILE |
私有、可写的凭据文件路径，也可读取已有代理会话 |
WORKBUDDY_LOGIN_TTL_SECONDS |
授权流程有效时间，单位秒，通常为 300 |
WORKBUDDY_LOG_FILE |
协议摘要日志路径 |
使用单个服务 worker 管理账号及待完成的登录流程。Token 刷新采用串行处理，凭据通过原子替换写入。退出登录会移除本服务保存的授权，不会撤销其他设备。授权链接过期后，可在设置中重新发起登录。网关访问密钥与 WorkBuddy 账号授权是两套独立凭据。
更多部署示例见 部署指南 和 Supervisor 配置示例。部署更新后，应重新加载已有浏览器标签页，确认插件前端已更新。
验证
pnpm test
pnpm typecheck
pnpm check:package
Python 测试使用本插件的锁定依赖，并将上游的 server 目录加入 PYTHONPATH。安装 Caddy 后会同时运行真实网关的鉴权及凭据剥离测试：
uv sync --frozen
PYTHONPATH=/absolute/path/to/workbuddy2api/server uv run --frozen pytest
CI 覆盖 Node.js 22/24 和 Python 3.10/3.14。pnpm check:package 会构建并检查实际发布包；真实账号验收还需检查 DSH 设置页、账号授权、流式文本，以及完整的工具调用与结果回传。
兼容性与社区
- 设置页支持英文和简体中文，上游提供的模型描述与活动文案会按界面语言显示并支持回退。模型选择器的免费标记使用英文，当前截图为中文。
- 文档中的 DSH 基线为
0.2.0-rc.2。更宽的 peer-dependency 范围不等于每个后续版本都已兼容；宿主或上游更新后，应重新进行真实验收。 - 贡献与本地验证 · 问题反馈 · 服务运行与恢复
卸载
通过 DSH 插件管理器移除此插件，并停止对应的独立服务。现有 DSH provider 和会话不受影响。如果卸载前未退出登录，磁盘上的 WorkBuddy 凭据会保留。
许可证
本项目采用 Apache License 2.0。单独安装的上游项目保留其自身许可证。
