dsh-workbuddy-xdpool 1.7.7 → 1.7.8

package/CHANGELOG.md

@@ -4,6 +4,63 @@
 
 版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## 1.7.8 — 说清楚卡片在哪儿、以及我们支持到哪个版本
+
+> 这次没有功能问题，全在「声明」上：一处把你引到不存在的路径，一处让你以为装错了版本。
+
+### README 的入口路径是 0.1.x 时代的，0.2.0 上按它找不到
+
+README 一直写着「设置 → 插件 → DSH WorkBuddy XD Pool」。**0.2.0 起没有这条二层路径了。**
+
+实际位置是：**打开设置面板 → 顶部平级标签里的「XD Pool」**（排在 `通用设置 / 模型 / 内置插件 / Agent 预设` 后面）。开设置面板的方式是**侧边栏左下角的齿轮**，或快捷键 `Ctrl+Alt+,`。
+
+已把 README 三处改掉，并且**补上了开面板的方法**——只写「切到 XD Pool」而不说怎么开设置，等于没写。老路径保留一句「0.1.x 时代叫这个」，方便升级上来的人理解自己的习惯为什么突然不灵了。
+
+### `engines.dsh` 写着 `<0.2.0`，可它在 0.2.0 上跑得好好的
+
+这个声明的问题不在于"保守"，而在于**它会把人带偏**：任何人按 `engines` 做兼容判断，第一反应都是"这插件不支持 0.2.0"，然后往错误的方向排查。反馈里就有一位因此走了一大圈。
+
+现在放宽到 `<0.3.0`，并且**把三个 host peer 依赖（`dsh-llm` / `dsh-llm-pi-ai` / `dsh-settings`）一起对齐**——它们约束的是同一批宿主包，只改一个反而制造新的不一致。
+
+放宽不等于"什么都接受"：上界仍然卡在 `<0.3.0`，**没测过的大版本不该被默认声称支持**。
+
+### 导航图标匹配不上时，现在会说话
+
+`installNavIcon()` 靠选择器找设置面板里那一行。**找不到时它完全静默** —— 表现就是"图标没出来"，没有任何线索。这次排查里它不是故障点，但它是最贵的一环：**看起来什么都没发生**。
+
+现在连续匹配失败会 `console.warn` 一次，带上选择器、期望的标签、以及**当前导航里实际有什么**：
+
+```
+[dsh-workbuddy-xdpool] the settings nav row could not be found, so the icon was not applied.
+selector="[role=\"dialog\"] nav button" expectedLabel="XD Pool" rowsPresent=["通用设置","模型",...]
+This is cosmetic only — the card itself still works. Please report this line…
+```
+
+**不是每次都喊**：设置面板没打开时找不到是**正常的**（那一行压根不在 DOM 里），每次都喊只会让人学会忽略它。所以只在"面板开着、却连续 N 次找不到"时才报一次，且每轮只报一次。
+
+### 关于那份"0.2.0 删了 slots 服务"的报告
+
+反馈者**自己撤回了**那个结论，我更正一下：**不成立**。
+
+他后来实测到：`__DSH_BOOT__.entries` 含本插件、`importErrors` 为空、客户端 fiber 状态是 ACTIVE、卡片 DOM 完整渲染、`installNavIcon` 正常生效。而且**把 `dsh.client.inject` 改掉再测，行为完全一致** —— 所以那两个包的声明**不会阻断加载，不需要改**。
+
+他复盘出的两个方法论坑，我认为值得原样记下来，因为它们非常容易重犯：
+- 只用正则扫「谁 `provide("name")` 了服务」，漏掉别的声明写法，就宣布服务被删了 —— **典型的假阴性**；
+- 在**会话页**（设置面板没开）dump DOM 搜插件节点，0 命中当成故障证据 —— 而 `settings.section` **只在面板打开时才进 DOM**，0 命中是必然的。
+
+`slots` 和 `settings.section` 在 0.2.0 里都健在，渲染方是 `dsh-client-ui-settings-general` 的 `renderSlot("settings.section", …)`。
+
+### 验证
+
+- 类型检查全绿，测试 **332 项全绿**（+7）。
+- 新增 `tests/compatibility-declaration.test.ts`：`engines.dsh` 必须容纳 0.2.x、**上界仍要卡住没测过的大版本**、三个 host peer 与 `engines.dsh` 保持一致、README **不得再把老路径当指引**（但允许作为历史说明出现）、必须写出开设置面板的方法。
+- **反向验证**：把 `engines` 退回 `<0.2.0` → 2 项变红；把 README 退回老路径 → 1 项变红。
+- 本机核对宿主代码：`renderSlot("settings.section", { close }, { only: active })` 确为**平级渲染**，插件注册 `order: 440`（排最后），与反馈的实测描述一致。
+
+### 一点说明
+
+我本机是 DSH Desktop 2.0.15（内核 0.1.7-rc.2），**不是 0.2.0-rc.2**，所以我**没法在本地复现 0.2.0 的渲染行为**。本次改动依据的是反馈者提供的实测数据，外加我对本机宿主代码里 `renderSlot` 调用的核对。放宽 `engines` 这个结论我是采信的，但没有在 0.2.0 上亲手验过。
+
 ## 1.7.7 — 别再让你为了一个「等一会儿」去重新登录
 
 > 报错说「API 密钥无效」，于是你跑去重新登录 —— 但密钥根本没问题，只是那个模型暂时限流了。

package/README.md

@@ -19,7 +19,7 @@
 
 ## 先看几张图
 
-**插件配置卡片（设置 → 插件 → DSH WorkBuddy XD Pool）**
+**插件配置卡片（设置 → 「XD Pool」一节）**
 
 ![WorkBuddy 池设置卡片：国内版 / 国际版切换栏、池健康状态、账号面板、积分包与合计、每账号每日签到、积分自动化面板、模型管理](assets/settings-card.png)
 
@@ -83,9 +83,13 @@
 
 ## 安装
 
-前置条件：装好 WorkBuddy 桌面 App 并登录（插件复用它存在本机的登录状态）。多账号 = 在桌面 App 里换着登几次，每次登录都会被自动吸进池里。已针对 DSH Desktop host `0.1.2` 适配。
+前置条件：装好 WorkBuddy 桌面 App 并登录（插件复用它存在本机的登录状态）。多账号 = 在桌面 App 里换着登几次，每次登录都会被自动吸进池里。
 
-> 兼容 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.x 系列，以及 `0.2.0-rc.2`。安装设置节时会按 host 能力自动选择 `settings.installSection`（0.1.2-rc.1+）或更早的自由函数写法；卡片在 0.2.0 上作为设置面板里一个**平级标签页**渲染。
+
+> **卡片在哪儿打开**：DSH 设置面板本身。开法是**侧边栏左下角的齿轮**，或者快捷键 `Ctrl+Alt+,`。
+> 面板顶部是平级标签：`通用设置 / 模型 / 内置插件 / Agent 预设 / XD Pool` —— 本插件就是最后那个 **XD Pool**。
+> （0.1.x 时代它叫「设置 → 插件 → DSH WorkBuddy XD Pool」，0.2.0 起改成了平级标签，按老路径找不到。）
 
 **方式一：从 npm 安装（推荐）**
 
@@ -129,7 +133,7 @@ pnpm typecheck:client   # 客户端类型检查
 
 > 注意：`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** 分组；打开设置面板（左下角齿轮或 `Ctrl+Alt+,`）切到 **XD Pool** 一栏，能看池健康、各账号的令牌 / 积分 / 签到 / 冷却状态，还有「重新检测账号」「清除所有冷却」按钮和每个账号的签到按钮。
 
 Web / TUI profile 也能用（`--profile web` / `--profile dsh-tui`）。
 

package/lib/client.js

@@ -2536,6 +2536,15 @@ window.__ModuleLoader__.load({
 		*/
 		const NAV_ROW_SELECTOR = "[role=\"dialog\"] nav button";
 		/**
+		* How many consecutive in-dialog passes may miss the nav row before the
+		* diagnostic fires.
+		*
+		* Above 1 because a single miss is routine — the shell can re-render between
+		* our mutation callback and the query. Small enough that a genuinely broken
+		* selector is reported within a frame or two of opening the settings panel.
+		*/
+		const NAV_ICON_MISS_THRESHOLD = 3;
+		/**
 		* Draw this page's own glyph in its Settings nav row.
 		*
 		* The `settings.section` contract carries no icon: the shell decides the glyph
@@ -2576,13 +2585,46 @@ window.__ModuleLoader__.load({
 				document.head.appendChild(tag);
 				let disposed = false;
 				let scheduled = false;
+				/**
+				* Consecutive passes that found no matching row.
+				*
+				* A miss is NORMAL most of the time: the settings dialog is closed, so its
+				* nav is not in the DOM at all, and the icon stays unapplied by design.
+				* Warning on the first miss would fire constantly and train everyone to
+				* ignore it.
+				*
+				* What is worth reporting is a PERSISTENT miss while the dialog IS open —
+				* that means the shell's nav markup changed and the selector no longer
+				* matches, which is exactly the failure that looks like "nothing happened"
+				* and cost hours to find. So the threshold is a burst of misses, and the
+				* warning is emitted once per burst rather than once per mutation.
+				*/
+				let missStreak = 0;
+				let warned = false;
 				const sync = () => {
 					scheduled = false;
 					if (disposed) return;
 					const wanted = String(resolveLabel() ?? "").trim();
 					if (wanted === "") return;
-					for (const row of document.querySelectorAll(NAV_ROW_SELECTOR)) if (String(row.textContent ?? "").trim() === wanted) row.setAttribute(NAV_ICON_MARKER, "");
-					else row.removeAttribute(NAV_ICON_MARKER);
+					let matched = 0;
+					for (const row of document.querySelectorAll(NAV_ROW_SELECTOR)) if (String(row.textContent ?? "").trim() === wanted) {
+						row.setAttribute(NAV_ICON_MARKER, "");
+						matched += 1;
+					} else row.removeAttribute(NAV_ICON_MARKER);
+					if (matched > 0) {
+						missStreak = 0;
+						warned = false;
+						return;
+					}
+					if (document.querySelector(NAV_ROW_SELECTOR) === null) {
+						missStreak = 0;
+						return;
+					}
+					missStreak += 1;
+					if (missStreak < NAV_ICON_MISS_THRESHOLD || warned) return;
+					warned = true;
+					const present = [...document.querySelectorAll(NAV_ROW_SELECTOR)].map((row) => String(row.textContent ?? "").trim()).filter((text) => text !== "");
+					console.warn(`[dsh-workbuddy-xdpool] the settings nav row could not be found, so the icon was not applied. selector=${JSON.stringify(NAV_ROW_SELECTOR)} expectedLabel=${JSON.stringify(wanted)} rowsPresent=${JSON.stringify(present)}. This is cosmetic only — the card itself still works. Please report this line so the selector can be updated.`);
 				};
 				const schedule = () => {
 					if (scheduled || disposed) return;

package/package.json

@@ -2,7 +2,7 @@
   "name": "dsh-workbuddy-xdpool",
   "displayName": "DSH WorkBuddy XD Pool",
   "description": "Merge every locally signed-in WorkBuddy account into DeepSeek Harness as one auto-failing-over model pool (multi-account rotation, live credits, daily check-in and model catalog).",
-  "version": "1.7.7",
+  "version": "1.7.8",
   "license": "MIT",
   "author": "XDTrees",
   "homepage": "https://github.com/XDTrees/dsh-workbuddy-xdpool#readme",
@@ -25,7 +25,7 @@
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0",
-    "dsh": ">=0.1.5-rc.1 <0.2.0"
+    "dsh": ">=0.1.5-rc.1 <0.3.0"
   },
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -99,9 +99,9 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1-rc.1",
-    "@deepseek-ai/dsh-llm": ">=0.1.1-rc.1 <0.2.0",
-    "@deepseek-ai/dsh-llm-pi-ai": ">=0.1.1-rc.1 <0.2.0",
-    "@deepseek-ai/dsh-settings": ">=0.1.1-rc.1 <0.2.0",
+    "@deepseek-ai/dsh-llm": ">=0.1.1-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-llm-pi-ai": ">=0.1.1-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-settings": ">=0.1.1-rc.1 <0.3.0",
     "@deepseek-ai/schemastery": "^3.18.1",
     "@earendil-works/pi-ai": ">=0.82.1"
   },