dsh-workbuddy-xdpool 1.2.0 → 1.4.0

package/README.md

@@ -9,15 +9,25 @@
 
 [English](./README.en.md) | 中文
 
-将 WorkBuddy 桌面 App 里登录过的**所有账号**自动并入一个 **DeepSeek Harness 模型池**：无需任何手动配置，你在 WorkBuddy 桌面登录的每个账号都会成为一个池成员；某个账号被限流（429）时，请求会自动切换到下一个可用账号，实现多账号自动容错轮换。
+把 WorkBuddy 桌面 App 里登录过的**所有账号**，合成一个 DSH 模型池。你在 WorkBuddy 里登过几个号，池里就有几个号——不用手动填表，不用一个个录入。
 
-> 与单账号连接插件（如 dsh-workbuddy-connect）的区别：**XD Pool 把多账号当成常态**——它不挑账号、不做手动导入，而是把本机 WorkBuddy 桌面 App 的所有历史登录快照全部纳入一个共享池，用一个 `workbuddy-xdpool` provider 分组对外暴露，模型请求在池内自动 failover。
+哪个号被限流了、积分用光了，请求自动换到下一个能用的号上去。你只管问，剩下的它自己处理。
+
+**另外附送一整套「积分自动化」**：签到、领任务奖励、连登兑换、开猫猫旅行……这些每天都要手动点一遍的活儿，插件在后台替你干完了。
+
+> **和单账号连接插件的区别**：`dsh-workbuddy-connect` 那类插件是「一次一个账号」。XD Pool 把**多账号当默认情况**——不挑号、不手动导入，本机 WorkBuddy 所有历史登录快照全部收进一个共享池，对外用一个 `workbuddy-xdpool` provider 分组，池内自动容错。
+
+## 先看几张图
 
 **插件配置卡片（设置 → 插件 → DSH WorkBuddy XD Pool）**
 
-![WorkBuddy 池设置卡片：国内版 / 国际版切换栏、池健康状态、账号面板、积分包与合计、每账号每日签到、模型管理（启用勾选 / 图片输入 / 上下文窗口）](assets/settings-card.png)
+![WorkBuddy 池设置卡片：国内版 / 国际版切换栏、池健康状态、账号面板、积分包与合计、每账号每日签到、积分自动化面板、模型管理](assets/settings-card.png)
 
-**模型选择器（国内版 / 国际版 两个独立供应商分组；倍率直接拼进 model.name：DSH 0.1.2 composer 只读 name）**
+**积分自动化面板**
+
+![积分自动化：总开关、立即运行按钮、每个任务的上次执行时间与当轮具体领取到的任务清单、连登解锁倒计时](assets/automation-panel.png)
+
+**模型选择器（国内版 / 国际版 两个独立分组）**
 
 ![模型选择器：国内版与国际版各占一个分组，每个模型名后显示积分倍率与促销标签](assets/model-picker.png)
 
@@ -27,27 +37,55 @@
 
 ## 功能
 
-- **零配置开箱即用**：安装并启用后，WorkBuddy 桌面 App 里每个已登录账号都会在第一次被请求时自动发现、进入池中轮换。无需在插件里手动录入账号。
+### 一、多账号池
+
+- **零配置**：装上、打开，就完事了。WorkBuddy 桌面 App 里每个登过的账号都会被自动发现并入池，不需要在插件里录任何东西。
 
-- **自动容错轮换**：池维护每个账号的 `429` 冷却状态。当某个账号触发限流进入冷却，后续请求会跳过它、落到下一个健康账号；冷却结束自动恢复。所有账号同时冷却时请求才暂停。
+- **自动容错换号**：池子记着每个账号的限流状态。某个号触发 429 就冷却它，后面的请求自动落到下一个健康的号上；冷却结束自动恢复。所有号都在冷却时，请求才排队等待。
 
-- **账号健康一目了然**：插件设置卡片显示池健康状态（N 账号 / X 冷却、当前会轮到哪个账号）、每个账号的令牌有效期与冷却倒计时。
+- **池健康一眼看清**：卡片显示「几个账号 / 几个在冷却」「下一个会轮到谁」，以及每个账号的令牌有效期和冷却倒计时。
 
-- **剩余积分实时可见**：卡片按账号展示积分包（`套餐名 · 剩余 / 总量`）与合计剩余（大字绿色高亮），跟随上游实时刷新。
+- **剩余积分实时可见**：按账号列出积分包（`套餐名 · 剩余 / 总量`）和大字合计，跟着上游实时刷新。
 
-- **模型目录直接标注**：卡片列出当前在池内可用的模型，并标注积分倍率（如 `GLM-5.2 · x0.79`）、免费 / 限时免费 / 夜间折扣标签、图片输入能力与上下文窗口，倍率与标签跟随上游 `credits` / `tags` 实时更新。
+- **模型目录带标注**：列出池里能用的模型，附带积分倍率（如 `GLM-5.2 · x0.79`）、免费 / 限时免费 / 夜间折扣标签、能否收图和上下文窗口大小，全部跟随上游实时更新。
 
-- **每日签到**：卡片在每个账号的积分区下方提供签到按钮，并显示连签天数、每日积分与里程碑额外奖励；一键领取该账号当日签到奖励。多账号可逐个领取，无需先切换账号。领取前会重新查询状态，**今日已领取的账号不会被重复领取**。CLI 亦提供 `checkin` 命令。
+- **国内版 / 国际版自动适配**：按账号凭据里的登录域名自动选上游——国际版登录（`workbuddy.ai`）走 `www.workbuddy.ai`，国内版（默认）走 `copilot.tencent.com`。两种账号可以混在同一个池里。
 
-- **国内版 / 国际版自动适配**：按账号凭据里的登录域名自动选择上游域名——国际版登录（`workbuddy.ai`）走 `www.workbuddy.ai`；国内版（默认）走 `copilot.tencent.com` 与 `www.codebuddy.cn`。同一池内可混用两种区域的账号，各自请求各自区域的上游。
+- **想手动做点啥也行**：卡片和命令行都提供「重新检测账号」「清除所有冷却」「每日签到」三个操作。
+
+### 二、积分自动化
+
+卡片上一个开关，插件在后台把你成长中心的日常动作全做掉。**默认全自动，也可以随时点「立即运行」手动跑一轮。**
+
+它管这五件事：
+
+| 任务 | 默认时间 | 干什么 |
+| --- | --- | --- |
+| 每日签到 | 09:00 | 领取当天签到奖励 |
+| 活跃上报 | 10:00 | 报个到，让成长中心知道你还在用 |
+| 任务奖励 | 11:00 | 把任务中心的奖励该报名的报名、该领的领掉 |
+| 连登奖励 | 12:00 | 连登档位兑换 + 抽奖 |
+| 猫猫旅行 | 09:00 · 21:00 | 把猫派出去、回来领奖励 |
 
-- **三种人工动作**：卡片与 CLI 都提供「重新检测账号」（重新扫描桌面登录快照，把新登录的账号并入池）、「清除所有冷却」（立即解除全部 429 冷却）与「每日签到」三个操作。
+**「任务奖励」这一项覆盖了 13 个任务**，包括那些看起来非得本人坐在电脑前点鼠标才能完成的：
+
+> 探索优秀灵感 · 使用 5 个模板 · 尝鲜热门技能 · 换「和平精英」主题 · 逛资料库 · 召唤 5 次专家 · 召唤 3 次专家团 · 体验腾讯轻量云专家 · 进入任一小助手应用 · 进入企鹅教师助手 · 设计创意模式建画布 · 创建定时任务 · 猫猫对话
+
+实测一轮跑下来，四个账号合计领到 **3300 积分 + 135 能量**。
+
+**卡片上会告诉你这一轮具体领到了什么**——不是只写「领了 8 个任务」，而是把任务名字列出来。连登还差几天解锁也会写清楚（比如「还差 4 天解锁 7 天档」），免得你以为是坏了。
+
+**关于「今日收益」**：卡片按来源分四行显示——任务奖励、签到、连登、旅行。今天赚了多少一眼看到，跨天自动清零。
+
+**关于保留积分**：可以给每个账号设一个积分下限，余额低于这个数的账号就不派活了，省着点用。
+
+> **国际版不显示这个面板**——那边的网关压根没有积分系统。
 
 ## 安装
 
-前置：已安装并登录 WorkBuddy 桌面 App（插件复用 App 的登录状态；多账号 = 在桌面 App 里逐个登录/切换账号即可，每次登录都会被自动吸收进池）。已针对 DSH Desktop host `0.1.2` 兼容。
+前置条件：装好 WorkBuddy 桌面 App 并登录（插件复用它存在本机的登录状态）。多账号 = 在桌面 App 里换着登几次，每次登录都会被自动吸进池里。已针对 DSH Desktop host `0.1.2` 适配。
 
-> 与 host 兼容 `0.1.1-rc.2` / `0.1.2` 系：设置节安装会按 host 能力自动选择 `settings.installSection`（0.1.2-rc.1+）或自由函数（更早）。
+> 兼容 host `0.1.1-rc.2` / `0.1.2` 系列：安装设置节时会按 host 能力自动选择 `settings.installSection`（0.1.2-rc.1+）或更早的自由函数写法。
 
 **方式一：从 npm 安装（推荐）**
 
@@ -56,8 +94,8 @@
 dsh plugin --profile desktop add dsh-workbuddy-xdpool
 ```
 
-> 推荐 npm 安装：pnpm / npm 需要拉取的依赖只有插件自身（**约 1 个包，数秒完成**）。
-> 从 GitHub 源码安装会连带安装开发依赖（构建器、测试框架等数百个包），明显更慢。
+> 推荐 npm：需要拉取的依赖只有插件自己（**约 1 个包，几秒搞定**）。
+> 从 GitHub 源码装会连带装开发依赖（构建器、测试框架等几百个包），慢得多。
 
 **方式二：从 GitHub 源码安装**
 
@@ -68,74 +106,74 @@ dsh plugin --profile desktop add github:XDTrees/dsh-workbuddy-xdpool
 **方式三：手动注册 bundle**
 
 ```sh
-# 1) 安装包（npm 或 GitHub 任选其一）
+# 1) 先装包（npm 或 GitHub 任选）
 dsh plugin --profile desktop add dsh-workbuddy-xdpool
 
 # 2) 注册 bundle：编辑 ~/.dsh/profiles/desktop/package.json，
-#    在 "dsh" → "profile" → "bundles" 数组末尾追加 "dsh-workbuddy-xdpool"
+#    在 "dsh" → "profile" → "bundles" 数组末尾加上 "dsh-workbuddy-xdpool"
 
 # 3) 重启 DSH Desktop
 ```
 
-**本地构建**（开发者）：
+**本地构建（开发者）**
 
 ```sh
 pnpm install
-pnpm build        # 产出 lib/index.js + lib/index.d.ts + lib/bin.js + lib/client.js
-pnpm test         # 26 项测试（自动容错轮换、按(账号,模型)冷却、签到守卫）
-pnpm typecheck    # 宿主侧
-pnpm typecheck:client   # 客户端
+pnpm build              # 产出 lib/index.js + lib/index.d.ts + lib/bin.js + lib/client.js
+pnpm test               # 138 项测试
+pnpm typecheck          # 宿主侧类型检查
+pnpm typecheck:client   # 客户端类型检查
 ```
 
-> **构建产物已随仓库提交**（`lib/` 不再 gitignore）。因此从 GitHub 安装时不需要任何安装期脚本，不会触发 pnpm 的「构建脚本被拦截，请放行」提示。**改动 `src/` 后请重新 `pnpm build` 并把 `lib/` 一并提交**，否则用户拿到的是旧产物。
+> **构建产物已随仓库提交**（`lib/` 不在 gitignore 里），所以从 GitHub 装不需要任何安装期脚本，也不会弹 pnpm 那句「构建脚本被拦截，请放行」。**改了 `src/` 记得重新 `pnpm build` 并把 `lib/` 一起提交**，否则用户拿到的是旧产物。
 
-> 注意：`pnpm install` 需用 pnpm 11（`npx pnpm@11`），必要时加 `--config.confirmModulesPurge=false --config.minimumReleaseAge=0`（pnpm 11 默认的 `minimumReleaseAge` 供应链年龄策略会拦截刚发布的 rc 包）。
+> 注意：`pnpm install` 要用 pnpm 11（`npx pnpm@11`），必要时加 `--config.confirmModulesPurge=false --config.minimumReleaseAge=0`——pnpm 11 默认的 `minimumReleaseAge` 供应链年龄策略会拦下刚发布的 rc 包。
 
-装好后：模型选择器里会出现 **WorkBuddy XD Pool** 分组；设置 → 插件 → **DSH WorkBuddy XD Pool** 卡片可查看池健康、各账号令牌/积分/签到/冷却，以及「重新检测账号」「清除所有冷却」按钮与每个账号的签到按钮。
+装完以后：模型选择器里会出现 **WorkBuddy XD Pool** 分组；设置 → 插件 → **DSH WorkBuddy XD Pool** 能看池健康、各账号的令牌 / 积分 / 签到 / 冷却状态，还有「重新检测账号」「清除所有冷却」按钮和每个账号的签到按钮。
 
-插件在 Web / TUI profile 下同样可用（`--profile web` / `--profile dsh-tui`）。
+Web / TUI profile 也能用（`--profile web` / `--profile dsh-tui`）。
 
 ## 命令行
 
 统一用 `dsh plugin --profile desktop exec dsh-workbuddy-xdpool <子命令>` 调用：
 
 ```sh
-dsh plugin --profile desktop exec dsh-workbuddy-xdpool status    # 池账号数/冷却 + shim 状态（--credits 查积分、--json 机器可读、--rates 看倍率）
-dsh plugin --profile desktop exec dsh-workbuddy-xdpool accounts  # 已发现账号（--json）
-dsh plugin --profile desktop exec dsh-workbuddy-xdpool doctor    # 诊断发现/冷却/上游连通性
-dsh plugin --profile desktop exec dsh-workbuddy-xdpool reset     # 立即清除所有 429 冷却
-dsh plugin --profile desktop exec dsh-workbuddy-xdpool checkin   # 查询每个账号今日签到状态（--json 机器可读）
+dsh plugin --profile desktop exec dsh-workbuddy-xdpool status    # 池里几个号 / 几个冷却 + shim 状态（--credits 查积分、--json 机器可读、--rates 看倍率）
+dsh plugin --profile desktop exec dsh-workbuddy-xdpool accounts  # 已发现的账号（--json）
+dsh plugin --profile desktop exec dsh-workbuddy-xdpool doctor    # 诊断发现 / 冷却 / 上游连通性
+dsh plugin --profile desktop exec dsh-workbuddy-xdpool reset     # 立刻清掉所有 429 冷却
+dsh plugin --profile desktop exec dsh-workbuddy-xdpool checkin   # 查每个账号今天签到了没（--json 机器可读）
 dsh plugin --profile desktop exec dsh-workbuddy-xdpool checkin all
-                                                                 # 领取所有账号今日签到奖励；也可传账号标签只领一个
-dsh plugin --profile desktop exec dsh-workbuddy-xdpool login     # 引导如何在桌面再加一个账号入池
+                                                                 # 领掉所有账号今天的签到奖励；也可以只传一个账号标签领单个
+dsh plugin --profile desktop exec dsh-workbuddy-xdpool login     # 教你怎么在桌面再加一个号进池
 ```
 
 ## 池里怎么多账号？
 
-池走**自动发现**：WorkBuddy 桌面 App 每次登录都会在本机留下一个带令牌的历史快照，XD Pool 扫描这些快照，把每个账号都吸收入池。因此多账号 = 在 WorkBuddy 桌面 App 里逐个登录 / 切换账号即可，之后点卡片「重新检测账号」或重启 DSH，新账号自动成为池成员。
+池子走**自动发现**：WorkBuddy 桌面 App 每次登录都会在本机留一个带令牌的历史快照，XD Pool 扫描这些快照，把每个账号都收进池。所以多账号 = 在桌面 App 里换着登几次，之后点卡片上的「重新检测账号」或者重启 DSH，新号就自动进池了。
 
-若你想对桌面 App 之外的某个登录做**显式快照**（例如临时固定某个账号再验证），也可手动导入：
+如果你想给桌面 App 之外的一次登录做个**显式快照**（比如临时固定某个号做验证），也可以手动导入：
 
 ```sh
 # 在 WorkBuddy 桌面 App 登录账号后（key 自己起名）：
 dsh plugin --profile desktop exec dsh-workbuddy-xdpool import myKey
-# 查看/删除已导入快照：
+# 查看 / 删除已导入的快照：
 dsh plugin --profile desktop exec dsh-workbuddy-xdpool accounts
 dsh plugin --profile desktop exec dsh-workbuddy-xdpool remove myKey
 ```
 
-导入快照以 key 的 **MD5 前 8 位**命名落在 `~/.dsh/.workbuddy-xdpool/`（key 本身记在文件里），中文、带 `/`、带空格的 key 都安全；长期使用靠 refresh token 自动续期，失效则回到桌面重新登录后 `import <key> --force` 覆盖。
+导入的快照以 key 的 **MD5 前 8 位**命名，放在 `~/.dsh/.workbuddy-xdpool/`（key 本身记在文件里），中文、带 `/`、带空格的 key 都安全。长期使用靠 refresh token 自动续期；失效了就回桌面重新登录，再 `import <key> --force` 覆盖。
 
 ## 配置
 
-池的有效配置经插件设置节（`settings.workbuddy-xdpool`）读取，模型设置页可改，改动即时生效：
+池的配置走插件设置节（`settings.workbuddy-xdpool`），模型设置页里能改，改完立即生效：
 
 | 字段 | 说明 | 默认 |
 | --- | --- | --- |
-| `authFile` | 覆盖 WorkBuddy 桌面 auth 文件路径（跨平台探测异常时用，等价于 `WORKBUDDY_AUTH_FILE`） | 自动探测 |
+| `authFile` | 覆盖 WorkBuddy 桌面 auth 文件路径（跨平台自动探测出问题时用，等同于 `WORKBUDDY_AUTH_FILE`） | 自动探测 |
 | `cooldownMs` | 单账号 429 冷却时长（毫秒） | `60000` |
 
-也可直接写在 `~/.dsh/settings.yaml`：
+也可以直接写进 `~/.dsh/settings.yaml`：
 
 ```yaml
 workbuddy-xdpool:
@@ -144,20 +182,33 @@ workbuddy-xdpool:
 
 ## 架构
 
-- **宿主侧**（`src/`，DSH 主进程内）：
-  - `index.ts` —— 注册 `workbuddy-xdpool` provider、`workbuddy-xdpool` 设置节（`settings.installSection`）、4 条同源路由（状态 / 重新检测 / 清除冷却 / 签到）、账号发现与模型目录播种。
-  - `accounts.ts` —— `WorkBuddyAccountPool`：读本机 WorkBuddy 桌面 auth 快照、429 冷却、round-robin failover 与 token 刷新。
-  - `catalog.ts` / `upstream.ts` —— 上游模型目录（含每模型积分倍率、免费/图片能力标签）、积分查询与每日签到的上游客户端（按凭据域名自动切换国内 / 国际版域名）。
-  - `web-status.ts` / `status-paths.ts` —— 卡片消费的同源状态文档与路由；签到是本插件唯一的写操作，按「POST + 回环来源 + 显式 accountId + 领取前二次确认」四重守卫。
-  - `bin.ts` —— 上述 CLI。
-- **客户端**（`src/client/`，浏览器卡片，经 `dsh.client` 由宿主加载）：折叠卡片外壳沿用宿主内置卡的 `dsm-plugin-card*` 样式语言（`--dsw-alias-*` 主题变量），内容用 `dsm-workbuddy-xdpool-*` 前缀，绝不污染宿主其它卡片；命名空间 `settings.workbuddy-xdpool`。
-- **构建**：`tsdown` 产出 `lib/index.js`（宿主入口）+ `lib/index.d.ts`（类型）+ `lib/bin.js`（CLI）+ `lib/client.js`（CJS，`window.__ModuleLoader__.load` 包裹的浏览器 bundle）。四个产物均随仓库提交，因此安装时不需要任何构建脚本。
+- **宿主侧**（`src/`，跑在 DSH 主进程里）
+  - `index.ts` —— 注册 `workbuddy-xdpool` provider、`workbuddy-xdpool` 设置节、各条同源路由（状态 / 重新检测 / 清除冷却 / 签到 / 自动化运行 / 保留积分），以及账号发现与模型目录播种。
+  - `accounts.ts` —— `WorkBuddyAccountPool`：读本机 WorkBuddy 桌面 auth 快照、429 冷却、轮换与 token 刷新；账号停用与积分保留也在这里。
+  - `scheduler.ts` —— 积分自动化的调度器：按本地时点跑五个任务（签到 / 上报 / 任务 / 连登 / 旅行），每日收益账本落盘，手动「立即运行」走的是同一套逻辑。
+  - `task-events.ts` —— 13 条任务事件链的构造。每条链都是纯数据，外加它该走哪个指纹通道（桌面 / 网页）；需要真实会话的任务（技能、专家）在这里先开一次真对话，拿到服务端 id。
+  - `catalog.ts` / `upstream.ts` —— 上游模型目录（含每模型积分倍率、免费 / 图片能力标签）、积分查询、签到、自动化各接口的上游客户端（按凭据域名自动切国内外）。
+  - `web-status.ts` / `status-paths.ts` —— 卡片读的同源状态文档与路由。写操作按「POST + 回环来源 + 显式 accountId」把关。
+  - `bin.ts` —— 上面那套 CLI。
+- **客户端**（`src/client/`，浏览器卡片，经 `dsh.client` 由宿主加载）
+  折叠卡片外壳沿用宿主内置卡的 `dsm-plugin-card*` 样式语言（`--dsw-alias-*` 主题变量），内容类名统一 `dsm-workbuddy-xdpool-*` 前缀，不污染宿主其它卡片；文案命名空间 `settings.workbuddy-xdpool`。
+- **构建**
+  `tsdown` 产出 `lib/index.js`（宿主入口）+ `lib/index.d.ts`（类型）+ `lib/bin.js`（CLI）+ `lib/client.js`（CJS，用 `window.__ModuleLoader__.load` 包起来的浏览器 bundle）。四个产物都随仓库提交，所以安装时不需要任何构建脚本。
 
 ## 已知限制
 
-- **仅使用本机桌面 App 的账号**：池不会、也无法替你发起 WorkBuddy 的登录/扫码（token 由 WorkBuddy 桌面 App 自己的腾讯 SSO 登录铸造并设备绑定）。加池账号 = 在 WorkBuddy 桌面 App 里登录/切换，XD Pool 自动吸收。
-- 依赖 WorkBuddy 客户端接口（非官方开放 API），WorkBuddy 更新后插件可能需要随之调整；若某账号 refresh token 失效，回到桌面重新登录即可。
-- 若 Windows 与 Linux 用户名不同且 Windows 环境变量未传入 WSL，请用 `WORKBUDDY_AUTH_FILE` 或配置节的 `authFile` 指定实际位置。
+- **只能用本机桌面 App 里的账号**：池不会、也没法替你发起 WorkBuddy 的登录或扫码（token 由 WorkBuddy 桌面 App 自己的腾讯 SSO 铸造并和设备绑定）。加号 = 在桌面 App 里登录 / 切换，XD Pool 自动吸收。
+
+- **自动化里有几个任务刻意没做**
+  - `Expert_Philanthropy`（公益专家）：需要真捐钱，绕不过去。
+  - `black_cat`（夜猫子）：只在 23:00–08:00 计分，而且**没有积分奖励**——熬夜白熬。
+  - `Model_chat_GLM5.2`（指定模型对话）与 `wb_wechat_oa_subscribe_task`（关注公众号）：路径已经摸清，留到下个版本。
+
+- **`Expert_team_use_3` 偶发卡在 2/3**：有个号当天用掉两次专家团后，第三次怎么发都不涨（换个没用过的专家团也不涨）。怀疑该任务对单账号有当日额度、跨天恢复，但没验证。**新号不受影响**（实测 0/3 → 3/3）。
+
+- **依赖 WorkBuddy 客户端接口**（不是官方开放 API），WorkBuddy 更新后插件可能得跟着调。某个账号的 refresh token 失效时，回桌面重新登录即可。
+
+- 如果 Windows 和 Linux 用户名不同、且 Windows 环境变量没传进 WSL，请用 `WORKBUDDY_AUTH_FILE` 或配置里的 `authFile` 指定实际位置。
 
 ## 免责声明
 
@@ -172,7 +223,7 @@ workbuddy-xdpool:
 
 - [corrinehu/dsh-workbuddy-connect](https://github.com/corrinehu/dsh-workbuddy-connect)（MIT）—— 设置节注册（`settings.installSection`）与 DSH 插件结构、客户端卡片加载机制、桌面端凭据刷新与 loopback shim 加固的核心参照；本项目沿用其「宿主通过 installSection 挂卡片」的打通路径。
 - [dingminhua/dsh-connect-workbuddy](https://github.com/dingminhua/dsh-connect-workbuddy)（MIT，Copyright (c) 2026 LaoDing）—— `dsm-plugin-card*` 卡片样式语言与 `--dsw-alias-*` 主题变量的参照实现；**每日签到**（`/v2/billing/meter/checkin-activity-status` 与 `/v2/billing/meter/daily-checkin`）、积分包聚合口径（月度周期套餐 / 一次性礼包区分）与国内 / 国际版按 `domain` 选择上游域名的做法，参考了该项目已验证的接口形态。
-- [Sliverkiss/workbuddy2api](https://github.com/Sliverkiss/workbuddy2api)（MIT）—— WorkBuddy 上游协议（`copilot.tencent.com` 的 wire behavior）与积分接口的参照实现。
+- [Sliverkiss/workbuddy2api](https://github.com/Sliverkiss/workbuddy2api)（MIT）—— WorkBuddy 上游协议（`copilot.tencent.com` 的 wire behavior）与积分接口的参照实现；**积分自动化**（成长中心签到 / 活跃上报 / 连登兑换 / 猫猫旅行状态机 / 13 条任务事件链 / 专家召唤链）整体照该项目的 Go 版逆向实现移植，每条事件链的判据与实测结论都来自它。
 
 以上项目的版权归各自作者所有。本项目采用**参考设计思路 + 独立实现**的方式，未整体复制任何参考项目的源码。若标注有遗漏或不当之处，欢迎提交 issue 指正。
 

package/lib/bin.js

@@ -29,6 +29,8 @@ const MODELS_CATALOG_PATH = "/v2/enterprises/personal/models";
 const GLOBAL_CONFIG_PATH = "/v3/config";
 const JSON_TIMEOUT_MS = 3e4;
 const ERROR_BODY_LIMIT = 4096;
+/** Cap on the reassembled compaction reply, guarding against a runaway stream. */
+const COMPLETION_TEXT_LIMIT = 65536;
 /** Insufficient-credit markers, ASCII lowercase plus the original Chinese. */
 const HARD_CREDIT_MARKERS = [
 	"insufficient credit",
@@ -47,8 +49,31 @@ const HARD_CREDIT_MARKERS = [
 	"额度用尽",
 	"没有积分"
 ];
-/** Session-invalidation markers that mean "sign in again in the WorkBuddy app". */
-const SESSION_DEAD_MARKERS = ["Offline user session not found", "12153"];
+/** Session-invalidation markers that mean "this credential is dead; use another".
+*  Kept alongside the HTTP-status rule in `classifyUpstreamError`: the status is
+*  enough for a direct 401/403, but some failures arrive wrapped in a 200
+*  envelope or a 4xx the gateway words differently. Adding the English and
+*  Chinese phrasings the upstream actually uses keeps those recoverable too —
+*  an unmatched one fell through to `client`, which is terminal in the shim
+*  and pinned the pool to the first account (the "API 密钥无效" bug). */
+const SESSION_DEAD_MARKERS = [
+	"Offline user session not found",
+	"12153",
+	"api key is invalid",
+	"invalid api key",
+	"invalid_api_key",
+	"api密钥无效",
+	"密钥无效",
+	"无效的密钥",
+	"unauthorized",
+	"token expired",
+	"token is invalid",
+	"login expired",
+	"please login",
+	"未登录",
+	"登录已失效",
+	"重新登录"
+];
 /**
 * Markers for "already checked in today".
 *
@@ -221,12 +246,82 @@ function envelopeError(status, envelope) {
 	return /* @__PURE__ */ new Error(`workbuddy upstream ${kind} (http ${status}): ${envelope.msg.slice(0, 160)}`);
 }
 /**
+* Read an OpenAI-style SSE chat stream and concatenate the assistant text.
+*
+* The upstream always streams (`stream: true` is forced on every chat body),
+* so a non-streaming internal call has to reassemble the deltas itself. Only
+* `choices[0].delta.content` is collected; reasoning deltas are dropped
+* because a compaction summary needs the final answer, not the scratchpad.
+*/
+async function readCompletionText(body) {
+	const decoder = new TextDecoder();
+	const reader = body.getReader();
+	let buffer = "";
+	let text = "";
+	try {
+		for (;;) {
+			const { done, value } = await reader.read();
+			if (done) break;
+			buffer += decoder.decode(value, { stream: true });
+			let split = buffer.indexOf("\n\n");
+			while (split !== -1) {
+				const frame = buffer.slice(0, split);
+				buffer = buffer.slice(split + 2);
+				text += contentOfFrame(frame);
+				if (text.length > COMPLETION_TEXT_LIMIT) return text.slice(0, COMPLETION_TEXT_LIMIT);
+				split = buffer.indexOf("\n\n");
+			}
+		}
+		if (buffer.trim() !== "") text += contentOfFrame(buffer);
+	} finally {
+		reader.releaseLock?.();
+	}
+	return text;
+}
+/** Pull `choices[0].delta.content` (or a non-streaming `message.content`) out of one SSE frame. */
+function contentOfFrame(frame) {
+	let out = "";
+	for (const rawLine of frame.split(/\r?\n/u)) {
+		const line = rawLine.trim();
+		if (!line.startsWith("data:")) continue;
+		const payload = line.slice(5).trim();
+		if (payload === "" || payload === "[DONE]") continue;
+		let parsed;
+		try {
+			parsed = JSON.parse(payload);
+		} catch {
+			continue;
+		}
+		if (typeof parsed !== "object" || parsed === null) continue;
+		const choices = parsed["choices"];
+		if (!Array.isArray(choices) || choices.length === 0) continue;
+		const choice = choices[0];
+		const delta = choice["delta"];
+		if (typeof delta === "object" && delta !== null) {
+			const content = delta["content"];
+			if (typeof content === "string") out += content;
+		}
+		const message = choice["message"];
+		if (typeof message === "object" && message !== null) {
+			const content = message["content"];
+			if (typeof content === "string") out += content;
+		}
+		const data = parsed["data"];
+		if (typeof data === "object" && data !== null) {
+			const inner = data["content"];
+			if (typeof inner === "string") out += inner;
+		}
+	}
+	return out;
+}
+/**
 * Classify an upstream failure from its HTTP status and body excerpt.
 * Body markers win over status, because the upstream reuses 400/200 for
 * several distinct conditions.
 */
 function classifyUpstreamError(status, body) {
 	if (status === 402) return "hard_credit";
+	if (status === 401 || status === 403) return "session_dead";
 	const lower = body.toLowerCase();
 	for (const marker of HARD_CREDIT_MARKERS) if (lower.includes(marker.toLowerCase()) || body.includes(marker)) return "hard_credit";
 	for (const marker of SESSION_DEAD_MARKERS) if (body.includes(marker)) return "session_dead";
@@ -589,6 +684,51 @@ var WorkBuddyUpstreamClient = class {
 		}
 		return JSON.stringify(obj);
 	}
+	/**
+	* Parse a raw OpenAI chat body without normalising it.
+	*
+	* The compactor needs the message array as objects, while `chatStream` only
+	* accepts the serialised string form.
+	*/
+	parseChatBody(raw) {
+		let body;
+		try {
+			body = JSON.parse(raw);
+		} catch {
+			return;
+		}
+		if (typeof body !== "object" || body === null || Array.isArray(body)) return void 0;
+		return body;
+	}
+	/** Re-serialise `base` with a rewritten `messages` array, still normalised. */
+	buildChatBody(base, messages) {
+		return this.prepareChatBody(JSON.stringify({
+			...base,
+			messages
+		}));
+	}
+	/**
+	* Run one NON-streaming completion and return the assistant text.
+	*
+	* Used only for internal compaction (summarising dropped turns). The chat
+	* endpoint itself always streams, so this reassembles the SSE frames into a
+	* single string. Throws on any failure: the compactor then falls back to
+	* plain truncation rather than failing the user's turn.
+	*/
+	async completeChat(credential, prepared, signal) {
+		const response = await this.fetchImpl(`${chatBase(credential)}/v2/chat/completions`, {
+			method: "POST",
+			headers: chatHeaders(credential),
+			body: prepared,
+			...signal === void 0 ? {} : { signal }
+		});
+		if (!response.ok) {
+			const text = (await response.text().catch(() => "")).slice(0, ERROR_BODY_LIMIT);
+			throw new Error(`compaction upstream http ${response.status}: ${text}`);
+		}
+		if (response.body === null) throw new Error("compaction upstream returned no body");
+		return await readCompletionText(response.body);
+	}
 	/** Forward one chat completion. Never throws for upstream failures. */
 	async chatStream(credential, prepared, signal) {
 		let response;
@@ -2714,6 +2854,16 @@ function dayKey(date) {
 	return `${date.getFullYear()}-${month}-${day}`;
 }
 /**
+* The scheduled SLOT `date` falls in, as `YYYY-MM-DDTHH`.
+*
+* The per-job run guard keys on this instead of the date, so a job configured
+* for several hours runs in each of them while a second tick inside the same
+* hour is still refused.
+*/
+function slotKey(date) {
+	return `${dayKey(date)}T${String(date.getHours()).padStart(2, "0")}`;
+}
+/**
 * Whether `now`'s local hour is one of `hours`.
 *
 * The reference panel computes a `nextFire` instant and sleeps until it; this
@@ -2818,7 +2968,7 @@ var WorkBuddyScheduler = class {
 		this.reportHours = options.reportHours ?? [10];
 		this.taskHours = options.taskHours ?? [11];
 		this.streakHours = options.streakHours ?? [12];
-		this.travelHours = options.travelHours ?? [12];
+		this.travelHours = options.travelHours ?? [9, 21];
 	}
 	/** Apply a new configuration; safe to call while running. */
 	/**
@@ -2896,7 +3046,7 @@ var WorkBuddyScheduler = class {
 	async runNow(kind, force = false) {
 		const today = dayKey(this.now());
 		const state = this.states[kind];
-		if (!force && state.lastRunDate === today) return { ...state };
+		if (!force && state.lastRunSlot === slotKey(this.now())) return { ...state };
 		this.busy = true;
 		try {
 			await this.runJob(kind, today);
@@ -2991,10 +3141,11 @@ var WorkBuddyScheduler = class {
 		this.busy = true;
 		try {
 			const now = this.now();
+			const slot = slotKey(now);
 			const today = dayKey(now);
 			for (const kind of JOB_KINDS) {
 				if (this.stopped) return;
-				if (this.states[kind].lastRunDate === today) continue;
+				if (this.states[kind].lastRunSlot === slot) continue;
 				if (!isFireHour(now, this.hoursOf(kind))) continue;
 				await this.runJob(kind, today);
 			}
@@ -3092,6 +3243,8 @@ var WorkBuddyScheduler = class {
 		let credit = 0;
 		let energy = 0;
 		let claimed = 0;
+		const detail = [];
+		let progressNote;
 		const accounts = this.accountsInOrder();
 		if (kind === "tasks") await this.sendEventChains(accounts);
 		for (let index = 0; index < accounts.length; index++) {
@@ -3104,7 +3257,10 @@ var WorkBuddyScheduler = class {
 						try {
 							const claim = await this.client.claimDailyCheckin(account.credential);
 							this.recordEarnings(account.id, today, { checkinCredit: claim.credit });
-							if (claim.credit > 0) this.logger.info?.(`automation checkin ${account.label}: +${claim.credit} credit`);
+							if (claim.credit > 0) {
+								if (claim.credit > 0) detail.push(`签到 +${claim.credit}`);
+								this.logger.info?.(`automation checkin ${account.label}: +${claim.credit} credit`);
+							}
 						} catch (error) {
 							if (!isAlreadyCheckin(error)) throw error;
 							this.logger.info?.(`automation checkin ${account.label}: already done today`);
@@ -3120,6 +3276,7 @@ var WorkBuddyScheduler = class {
 						credit += result.credit;
 						energy += result.energy;
 						claimed += result.claimed;
+						detail.push(...result.titles);
 						this.claimableSeen += result.claimableCount;
 						this.recordEarnings(account.id, today, {
 							credit: result.credit,
@@ -3129,9 +3286,11 @@ var WorkBuddyScheduler = class {
 						this.logger.info?.(`automation tasks ${account.label}: ${result.claimed} claimed (+${result.credit} credit, +${result.energy} energy, ${result.claimableCount} claimable seen)`);
 						break;
 					}
-					case "streak":
-						await this.redeemStreak(account);
+					case "streak": {
+						const progress = await this.redeemStreak(account);
+						if (progress !== void 0) progressNote = progress;
 						break;
+					}
 					case "travel": await this.runTravel(account);
 				}
 				ok++;
@@ -3142,6 +3301,7 @@ var WorkBuddyScheduler = class {
 			if (index < accounts.length - 1 && this.delayMs > 0 && !this.stopped) await sleep(this.delayMs);
 		}
 		const state = this.states[kind];
+		state.lastRunSlot = slotKey(this.now());
 		state.lastRunDate = today;
 		state.lastRunAtMs = this.now().getTime();
 		state.ok = ok;
@@ -3150,6 +3310,8 @@ var WorkBuddyScheduler = class {
 		state.energy = energy;
 		state.claimed = claimed;
 		state.message = this.summarise(kind, ok, failed, claimed, credit, energy);
+		state.detail = detail;
+		state.progress = progressNote;
 		this.logger.info?.(`automation ${accountWord}: ${state.message}`);
 	}
 	/** Compose the one-line summary shown on the card. */
@@ -3352,6 +3514,7 @@ var WorkBuddyScheduler = class {
 		let credit = 0;
 		let energy = 0;
 		let claimed = 0;
+		const titles = [];
 		for (const task of claimable) {
 			if (this.stopped) break;
 			const reward = await this.client.claimTaskReward(credential, task.taskCode);
@@ -3359,6 +3522,7 @@ var WorkBuddyScheduler = class {
 			energy += reward.energy;
 			if (reward.credit > 0 || reward.energy > 0) {
 				claimed++;
+				titles.push(task.title);
 				this.logger.info?.(`automation claim ${account.label}: ${task.title} +${reward.credit}c +${reward.energy}e`);
 			} else this.logger.info?.(`automation claim ${account.label}: ${task.taskCode} already claimed`);
 			if (this.delayMs > 0 && !this.stopped) await sleep(this.delayMs);
@@ -3367,7 +3531,8 @@ var WorkBuddyScheduler = class {
 			claimed,
 			credit,
 			energy,
-			claimableCount: claimable.length
+			claimableCount: claimable.length,
+			titles
 		};
 	}
 	/**
@@ -3407,6 +3572,11 @@ var WorkBuddyScheduler = class {
 			}
 			if (this.delayMs > 0 && !this.stopped) await sleep(this.delayMs);
 		}
+		const pendingTier = status.tiers.find((tier) => tier.status === "locked");
+		if (pendingTier !== void 0) {
+			const remaining = Math.max(0, pendingTier.days - status.days);
+			return remaining > 0 ? `${pendingTier.tier} in ${remaining}d` : `${pendingTier.tier} ready`;
+		}
 	}
 	/**
 	* One trip through the buddy travel loop for an account.
@@ -3450,6 +3620,17 @@ var WorkBuddyScheduler = class {
 		this.logger.info?.(`automation travel ${account.label}: nothing to do (state=${travel.state})`);
 	}
 };
+[
+	"You are compacting an ongoing conversation so it can continue without the original history.",
+	"Summarise the transcript below into a dense briefing for the next assistant turn.",
+	"Preserve, in this order of priority:",
+	"1. explicit user requirements, constraints and corrections;",
+	"2. decisions already made, and the reasoning behind them;",
+	"3. concrete facts: file paths, identifiers, commands, numbers, error messages;",
+	"4. unfinished work and the current blocker.",
+	"Drop pleasantries, repetition and superseded attempts.",
+	"Write the briefing only — no preamble, no markdown fence."
+].join("\n");
 //#endregion
 //#region src/status.ts
 /** Format the per-model credit multipliers. */