# dsh-workbuddy-console

**WorkBuddy 多账号控制台** —— 一个跑在 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 里的网页，
用来管理多个 WorkBuddy 账号、一键领取所有账号的积分，并查看还剩什么没做完。

页面挂在 **DSH 自己的 webServer** 上，所以只要 DSH 在跑，页面就在 ——
不需要额外启动进程，也不会有「拒绝连接」。

[English](README.en.md)

[![npm](https://img.shields.io/npm/v/dsh-workbuddy-console.svg)](https://www.npmjs.com/package/dsh-workbuddy-console)

```bash
pnpm add dsh-workbuddy-console
```

---

## 🙏 致谢与代码来源（请先读这一段）

本插件**包含了 [XDTrees](https://github.com/XDTrees) 的作品**，
不是从零写的。原作者与其仓库：

> ### [dsh-workbuddy-xdpool](https://github.com/XDTrees/dsh-workbuddy-xdpool) —— 作者 **XDTrees**
>
> 账号池、模型池（多账号自动轮换 / 容错）、签到、积分自动化 —— 这些能力的
> 运行时代码由 **XDTrees** 编写，MIT 许可，**原样保留**在
> [`vendor/xdpool/`](vendor/xdpool/)。
>
> 本插件只是把它们与控制台/技能市场合并成一个插件。
> **模型池那部分的功能与设计功劳属于 XDTrees。**

- 许可与归属：[THIRD-PARTY.md](THIRD-PARTY.md)
- 原始许可全文：[vendor/xdpool/LICENSE-ORIGINAL](vendor/xdpool/LICENSE-ORIGINAL)
  （`Copyright (c) 2026 XDTrees`，**请勿删除**）
- 想要单独的账号池插件、或想给原作者反馈：
  <https://github.com/XDTrees/dsh-workbuddy-xdpool>

如果你只想要原汁原味的账号池插件，请直接安装原作者那一份；
本仓库的价值在于**把两者合成一个**。

---

![界面](assets/console.png)

## 功能

| 功能 | 说明 |
|---|---|
| **一键全部签到** | 批量遍历所有启用账号（串行 + 间隔防风控），逐账号汇报结果 |
| **未完成任务** | 列出还没做完的成长任务：进度条、还差多少、能拿多少积分；达标的可一键领取 |
| **账号检查** | 逐个账号**实时调上游**验证登录态，区分「有效 / 已失效 / 无法确认」 |
| **登录新账号** | 打开官网登录页 / 拉起桌面版两个入口，不存储、不代填密码 |
| **签到历史** | 每次签到与打开页面自动记一笔，按 7/30/90 天绘制积分趋势图 |
| **积分消耗** | 按余额差值统计消耗与入账（24h/7/30 天） |
| **技能市场** | 浏览 WorkBuddy 技能市场（10000+ 技能），一键安装到 DSH 技能目录 |
| **输入框技能选择器** | 对话输入框左侧的 WorkBuddy 按钮，点选已装技能即调用 |
| **DSH 设置页** | 设置 → WorkBuddy 技能市场，搜索/安装/卸载（不用开控制台页） |
| 账号池 | 昵称、连签天数、今日状态、各积分包余额、冷却与保底状态 |
| 自动化任务 | 5 个任务的今日收益与计划时间，可手动触发 |
| 模型池 | 模型列表与积分倍率 |
| 账号操作 | 签到、启用/禁用、设置保底积分 |
| **中英双语** | 界面可切换，右上角「中 / EN」 |

## 快速开始

### 前置条件

1. **DSH 已安装并能正常运行**
2. **本机已登录过 WorkBuddy 桌面端**（或已有 auth 文件）

> 不再需要单独安装 `dsh-workbuddy-xdpool` —— 账号池/模型池/签到
> 已经并入本插件（见 [THIRD-PARTY.md](THIRD-PARTY.md)）。

### 安装

**方式一：从 npm 安装（推荐）**

```bash
cd <你的 DSH profile 目录>        # 例如 ~/.dsh/profiles/desktop
pnpm add dsh-workbuddy-console
```

然后在 profile 的 `cordis.patch.yml` 里注册：

```yaml
- id: llm-workbuddy-xdpool
  name: dsh-workbuddy-console
- id: workbuddy-console
  name: dsh-workbuddy-console
```

> `llm-workbuddy-xdpool` 这个 id 要保留：账号池卡片靠它找到自己的
> 设置作用域，改名会导致模型选择/自动化收益读写不到。

**方式二：从源码安装（开发用）**

```bash
git clone https://github.com/dhdbvcg/dsh-workbuddy-console.git
cd dsh-workbuddy-console
node scripts/install.mjs
```

安装脚本会自动定位 DSH profile、注册插件、以正确的 `link:` 形式写入依赖，
并给合并进来的 vendor 代码建好依赖链接。然后**重启 DSH**。

可选参数：

```bash
node scripts/install.mjs --dry-run          # 只看会做什么，不改文件
node scripts/install.mjs --profile <目录>   # 指定 profile
node scripts/install.mjs --uninstall        # 卸载注册
```

<details>
<summary>手动安装（不想跑脚本时）</summary>

在 profile 的 `package.json` 的 `dependencies` 里加：

```jsonc
"dsh-workbuddy-console": "link:/绝对路径/dsh-workbuddy-console"
```

在 `cordis.patch.yml` 末尾加：

```yaml
- insert:
    - id: workbuddy-console
      name: dsh-workbuddy-console
```

然后 `pnpm install`。

</details>

### 访问

```
http://127.0.0.1:<DSH端口>/wb-console
```

DSH 端口就是你平时打开 GUI 的端口。

> ⚠️ **必须用 `link:` 而不是 `file:`**
>
> `file:` 在 pnpm 下是**拷贝**语义：装完之后你对源码的任何修改都不会生效，
> DSH 永远读到旧代码 —— 而且这个坑极难发现，因为目录看起来完全正常。
>
> ```powershell
> # 验证当前是哪种
> (Get-Item "<profile>/node_modules/dsh-workbuddy-console" -Force).LinkType
> # 期望 Junction；输出为空 = 是拷贝，必须改成 link: 重装
> ```

## 为什么需要这个

`dsh-workbuddy-xdpool` 是模型池插件，它把事情做得很好，但**有些东西看不见**：

- **未完成任务**：插件只在自动化日志里报一个 `claimableCount`（达标未领的数量），
  「还差一点点就达标」的任务完全不可见。实测 18 个任务里 15 个已领、3 个未完成，
  插件显示 `claimableCount: 0`，而这个控制台会列出那 3 个。
- **没有批量签到**：插件的签到路由一次只接受一个 `accountId`。
- **登录态真假难辨**：本地 auth 文件里的 `expiresAt` 会被上游撤销而**不更新**，
  所以「显示未过期」不等于「还能用」。唯一可信的检查是真的发一次请求。
- **没有一个总览页面**：这些信息散在设置卡片、日志和 CLI 里。
- **没有历史**：所有信息都是「当前状态」，昨天的数字就没有了。

## 和 xdpool 的关系

本插件是 xdpool 的**前端**，不重复实现账号发现与上游调用：

```
浏览器  →  DSH(:port)/wb-console  →  本插件  →  /plugins/dsh-workbuddy-xdpool  →  WorkBuddy 上游
```

| 能力 | 来源 |
|---|---|
| 账号发现、签到、积分、任务、模型目录、自动化 | xdpool |
| 一键全部签到（批量） | **本插件补齐** |
| 未完成任务视图、账号体检、登录入口、历史趋势 | **本插件新增** |
| 网页界面、中英双语 | **本插件提供** |

账号凭证始终由 xdpool 管理，本插件只读本机 auth 文件，**不落盘、不外发**。

## 账号检查：为什么不看 `expiresAt`

上游撤销 token 时**不会**改写本地文件的过期时间。
所以一个「显示未过期」的历史快照 token，完全可能已经被上游拒绝。

本功能真的发一次 `POST /v2/billing/meter/checkin-activity-status`：

| 结果 | 判据 | 含义 |
|---|---|---|
| **有效** | HTTP 200 + `code:0` | 上游接受，顺带带出签到状态 |
| **已失效** | HTTP 401 / 403 | 需要重新登录 |
| **无法确认** | 网络错误 / 其它响应 | 不能据此断言失效 |

同时标出凭证来源：**桌面端当前登录**（`workbuddy-desktop.info`）
还是**历史快照**（`workbuddy-desktop.<时间戳>.<pid>.<uuid>.info`）。
快照可能在桌面端登出后依然可用，但不代表以后还能用。

## 未完成任务怎么算

数据来自 `GET {chat}/v2/activity/growth/tasks`，分类口径与 xdpool 的 `parseTask`
**完全一致**（直接复用插件导出的 client），所以这里显示的数量与插件自动化日志对得上。

| 状态 | 判据 |
|---|---|
| **未完成** | `current < target` 且未领取、未锁定 |
| **可领取** | `current >= target` 且未领取 |
| 已领取 | `accept_status === "claimed"`（默认不显示） |
| 锁定 | `locked === true`（默认不显示） |

领取复用插件的 `claimTaskReward`，它已处理两个易错点：
taskCode 走 **PATH** 而非 body，且必须带 growth-center 的 `Origin`/`Referer`
和 `x-client-platform: web`。

## 签到历史

每次签到与每次打开页面，都会把当时的快照追加到本地 JSONL
（`<DSH 根目录>/plugin-data/dsh-workbuddy-console/history.jsonl`）。

两个刻意的设计：

- **用 JSONL 而不是 JSON 数组** —— 追加写入不必读全量再重写整个文件；
  写入被中断最多丢最后一行，不会把已有历史全毁掉。
- **同一天同一账号只取最后一次快照** —— 反复刷新页面不能把总数刷大。
  如果直接求和会严重重复计数。

保留 90 天 / 5000 条，每次签到后自动裁剪。数据不出本机。

## 积分消耗是怎么算的

**关键区别**，先讲清楚避免误解：

| 口径 | 需要什么 | 精度 |
|---|---|---|
| **本页显示的消耗** | 只采样余额，无需改任何链路 | 账号级 / 时间段级 |
| **单次对话消耗** | 需让模型流量经过计费代理 | 精确到每次请求 |

### 为什么「消耗」不等于「余额下降」

余额会因为**签到、任务奖励**上升，也会因为**对话**下降。
如果只算净值，签到 +100 后又花了 30，会被记成「增加 70」——完全错。

所以本插件把两者**分开累计**：下降部分记为消耗，上升部分记为入账，净值单独展示。

### 单次对话的精确值：上游其实直接给了

实测发现（不是推测）：WorkBuddy 的 SSE 流最后一个 usage 帧带 **`credit` 字段**，
就是这次请求的真实计费值：

| 模型 | 倍率 | token | `credit` |
|---|---|---|---|
| glm-5.3-flash | x0.06 | 33 | 0 |
| glm-5.3 | x0.79 | 33 | 0.01 |
| kimi-k3-1 | x1.62 | 106 | 0.08 |

所以**不需要用 token × 倍率估算** —— 估算会有缓存命中、推理 token、倍率单位三个
不确定项，而上游给的是账单真值。

`lib/credit-meter.mjs` 与 `lib/billing-proxy.mjs` 已经实现完整采集（19 + 13 项测试），
但默认**不启用**：它要求模型流量经过代理，而那会动到模型链路。
需要时可在配置里开启 `creditMeter`。当前页面上显示的是余额差值口径。

## 技能市场

控制台里可以直接浏览 **WorkBuddy 技能市场**（实测 10000+ 技能），一键装进 DSH。

### 装到哪里、怎么生效

```
<DSH 根目录>/skills/<技能名>/SKILL.md
```

`dsh-skill-filesystem` 会扫描并 **watch** 这个目录，所以装完 DSH 下次读目录就能看到，
**不需要重启**（若没出现，重启一次即可）。

### 为什么能直接兼容

实测下载一个技能包，内容是标准结构 —— 与 DSH 的要求完全一致：

```
SKILL.md          YAML frontmatter（name / description / allowed-tools…）+ 正文
reference.md      可选参考资料
scripts/*         可选脚本
workbuddy.json    WorkBuddy 自己的元数据
```

上游的 `SKILL.md` frontmatter 已带 `name` 与 `description`，正是 DSH 的必需字段，
所以**不需要做任何格式转换**。

### 安全处理

安装会往磁盘写文件，所以做了这些校验：

| 检查 | 原因 |
|---|---|
| 技能名必须 kebab-case | 不符合 DSH 命名规则的目录不会被发现，装了也白装 |
| 解压路径必须在目标目录内 | zip 里的 `../` 或绝对路径会导致**任意文件写入** |
| 下载 ≤30MB、解压 ≤50MB | 防 zip 炸弹 |
| 先解压到临时目录，再原子改名 | 失败不会留下半个技能 |
| 卸载只允许删 `skills/` 的直接子目录 | 防路径穿越删错东西 |

### 上游接口

| 用途 | 接口 |
|---|---|
| 列表 | `POST /v2/operation-platform/market/skill/list` |
| 详情 | `POST /v2/operation-platform/market/skill/get-by-ids` |
| 下载地址 | `POST /v2/operation-platform/market/skill/download-url` |

## 在 DSH 里使用技能

装好的技能有两个入口：

### 1. 输入框的技能选择器

对话输入框左侧有一个 **⚡ WorkBuddy** 按钮：

1. 点开 → 列出所有**已安装**的技能（可筛选）
2. 点某个技能的「使用」→ 在本对话中调用它

调用方式走的是 DSH 自己暴露给输入框的 `command(line)` 接口，
等价于你手打 `/<技能名>`，所以行为和 DSH 原生命令一致。

> 若某个宿主的输入框没有暴露 `command`，按钮会**如实提示**
> 「无法自动调用」，而不是静默失败。

### 2. 设置页

**设置 → WorkBuddy 技能市场**：搜索、安装、卸载，不用切到控制台页面。

### 为什么需要自己写选择器

DSH 内置的技能 UI（`dsh-client-ui-skill`）**只注册了 `tool.call.toolview`**
—— 它只负责把技能工具的调用结果渲染成一行摘要，**没有选择器**。
所以「选一个技能去用」这个能力是本插件新增的。

## 关于「自动登录」

**做不到全自动，这是上游设计使然。**
WorkBuddy 使用交互式浏览器 OAuth（Keycloak，域 `www.codebuddy.cn`），
拿新 token 必须有人在浏览器里真的完成登录。

本插件因此只提供两个入口，**绝不存储或代填账号密码**：

1. **打开官网登录页** —— 登录后回来点「重扫账号」
2. **拉起 WorkBuddy 桌面版** —— 桌面版重新登录会写出新的 live 文件

两个入口都有域名白名单（只允许 `codebuddy.cn` / `workbuddy.cn` / `codebuddy.ai`），
不会被当成任意 URL 跳板。

## 环境变量

| 变量 | 默认 | 说明 |
|---|---|---|
| `DSH_PROFILE_DIR` | 自动探测 | 指定 DSH profile 目录（用于定位 xdpool） |
| `DSH_HOME` | `~/.dsh` | DSH 根目录 |
| `WORKBUDDY_XDPOOL_ENTRY` | — | 直接指定 xdpool 的 `lib/index.js` 绝对路径 |
| `WORKBUDDY_AUTH_FILE` | 自动探测 | 指定 WorkBuddy auth 文件或目录 |
| `WB_CONSOLE_DATA_DIR` | `<DSH>/plugin-data/...` | 历史与余额样本的存放目录 |
| `WB_CONSOLE_HISTORY_DAYS` | `90` | 历史保留天数 |
| `WB_CONSOLE_CREDIT_DAYS` | `90` | 余额样本保留天数 |

## API

页面同源，浏览器可直接调用。所有写操作只接受 POST。

| 方法 | 路径 | 说明 |
|---|---|---|
| GET | `/wb-console` | 页面 |
| GET | `/wb-console/api/mode` | 探测 xdpool 是否在线 |
| GET | `/wb-console/api/overview` | 账号 + 签到 + 积分 + 自动化 + 模型 |
| POST | `/wb-console/api/claim` | 一键全部签到（可传 `ids` 过滤） |
| GET | `/wb-console/api/tasks` | 未完成任务（`?all=1` 含已完成） |
| POST | `/wb-console/api/tasks/claim` | 领取单个任务奖励 |
| GET | `/wb-console/api/accounts/check` | 账号体检 |
| GET | `/wb-console/api/history` | 签到历史（`?days=7\|30\|90`） |
| POST | `/wb-console/api/history/prune` | 裁剪历史 |
| POST | `/wb-console/api/history/clear` | 清空历史 |
| GET | `/wb-console/api/credit` | 会话级积分（需计费代理） |
| GET | `/wb-console/api/credit/summary` | 消耗/入账汇总（`?days=1\|7\|30`） |
| POST | `/wb-console/api/credit/sample` | 立即采一次余额样本 |
| POST | `/wb-console/api/credit/clear` | 清空余额样本 |
| GET | `/wb-console/api/skills/list` | 技能市场列表（`?page&pageSize&keyword`） |
| GET | `/wb-console/api/skills/installed` | 本地已安装技能 |
| POST | `/wb-console/api/skills/install` | 安装技能到 DSH 技能目录 |
| POST | `/wb-console/api/skills/uninstall` | 卸载技能 |
| POST | `/wb-console/api/accounts/disabled` | 启用/禁用账号 |
| POST | `/wb-console/api/accounts/credit-reserve` | 保底积分 |
| POST | `/wb-console/api/accounts/rescan` | 重扫账号 |
| POST | `/wb-console/api/login/open` | 打开官网登录页 |
| POST | `/wb-console/api/login/desktop` | 拉起桌面版 |
| POST | `/wb-console/api/automation/run` | 手动触发任务 |
| GET | `/wb-console/api/diag` | 诊断信息 |

## 开发

```bash
node test/run-all.mjs     # 全部单测（会切到 DSH profile 以解析 xdpool）
node test/run-ci.mjs      # CI 跑的那套（不需要 profile 与真实凭证）
node scripts/build-dict.mjs   # 由 web/i18n.js 生成 web/i18n-dict.js
```

| 文件 | 项数 | 覆盖 |
|---|---|---|
| `selftest.mjs` | 19 | 插件形状、路由、静态资源、代理、批量签到、通用转发 |
| `check-test.mjs` | 19 | JWT、凭证扫描、探活判定、体检汇总、登录域名白名单 |
| `routes-test.mjs` | 12 | 路由注册、页面元素、前端 URL 拼接 |
| `tasks-test.mjs` | 7 | 任务读取、状态归类、批量汇总、失败隔离 |
| `tasks-route-test.mjs` | 9 | 任务路由、领取参数校验、uid 白名单 |
| `i18n-test.mjs` | 3 | 中英字典 key 对齐、占位符一致、无空值 |
| `installer-test.mjs` | 13 | 安装 / 卸载 / 幂等 / 保留其它插件配置 |
| `history-test.mjs` | 16 | 记录、容错、同日去重、裁剪 |
| `credit-test.mjs` | 19 | SSE 解析、跨 chunk 拼接、流旁听字节透传、累加 |
| `credit-samples-test.mjs` | 15 | 余额差值、消耗与入账分离、抖动去重、窗口过滤 |
| `proxy-test.mjs` | 13 | 计费代理字节透传、白名单、错误透传、上游不可达 |
| `manifest-test.mjs` | 9 | package.json 与 DSH 加载协议一致性 |
| `skill-market-test.mjs` | 22 | 路径穿越防护、frontmatter 解析、卸载、上游错误 |
| `client-bundle-test.mjs` | 15 | 客户端 bundle 加载、插槽注册、inject 覆盖 |

共 **196 项**。

浏览器端到端（需要 Chrome；`e2e-i18n.mjs` 不依赖 DSH）：

```bash
node test/e2e-i18n.mjs    # 中英渲染，断言零 JS 异常 + 折线图 + 消耗面板
node test/screenshot.mjs  # 重新生成 assets/ 里的截图
```

### 为什么测试由 `run-all.mjs` 驱动

`tasks.mjs` 需要 `import dsh-workbuddy-xdpool`，而那个包只装在 DSH profile 的
`node_modules` 里。`run-all.mjs` 会自动把插件复制到 profile 下的临时目录再跑，
让「解析 xdpool」和「相对 import」两个需求同时满足。

## 排障

### 页面打不开 / 显示「响应不是 JSON」

先看诊断接口：

```
http://127.0.0.1:<端口>/wb-console/api/diag
```

再看浏览器 Network：如果请求 URL 出现 **`/api/api/`**，说明前端把前缀拼了两次。
正确形式是 `/wb-console/api/mode`。

### 重启后行为没变

八成是装成了拷贝而不是链接，见上文「必须用 link:」。

### 任务面板显示「找不到 dsh-workbuddy-xdpool」

插件不在默认探测路径。设置 `DSH_PROFILE_DIR` 指向装了 xdpool 的 profile，或
`WORKBUDDY_XDPOOL_ENTRY` 直接给出 `lib/index.js` 的绝对路径。

## 免责声明

- 本项目仅用于管理**你自己**的账号。
- 请遵守 [WorkBuddy 服务条款](https://www.codebuddy.cn/) 与相关法律法规。
- 自动化操作可能触发上游风控，本项目已做限流（串行 + 间隔），但不对账号状态作任何保证。
- 与腾讯 / WorkBuddy / CodeBuddy 官方无任何关联。

## 致谢

- [dsh-workbuddy-xdpool](https://github.com/XDTrees/dsh-workbuddy-xdpool) —— 账号发现与上游调用
- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) —— 插件宿主

## License

[MIT](LICENSE)