dsh-group-status 0.5.0 → 0.5.1

package/CHANGELOG.md

@@ -6,6 +6,77 @@
 
 ## 未发布
 
+## 0.5.1 — 2026-10-27
+
+- **refactor** 会话列表面板拆成四个组件文件：`rows/WorkspaceBrowser.tsx` 从 1562 行降到 685 行，
+  树体、扁平列表、搜索结果、视图选项菜单、空态占位各自独立（`SessionTree.tsx` / `ListView.tsx` /
+  `ViewOptionsMenu.tsx` / `EmptySessions.tsx`），三类共享件（搜索 wire 常量、拖拽状态机、树体的 prop
+  契约）收进 `browser-shared.ts`。三个列表体本来就是**互斥渲染**的分支，拆开后仍互不 import；成环由
+  `browser-shared.ts` 单向下指挡掉。行为不变：切分是逐段搬移，没有改写判定、排序或动画时序。
+
+- **perf** 空闲分组不再产生新的状态对象：`summarizeGroupStatus` 对「六项全零且没有来源贡献」的组
+  交回冻结的 `EMPTY_LIVE_STATUS`，`mergeLiveStatus` 把「加一份零」实现为**原样返回入参**。多层折叠
+  里每层都会把子树重滚一遍，此前每滚一次都为每个空闲组造一份等值新对象；下游按引用判等的选择器于是
+  每轮重渲染，而它读到的数字一个没变。合并仍不修改任何入参。
+
+- **perf** `watermarkRows` 在第一个被截断的行处提前退出（空行必然排在组首，由 `tree.ts` 的
+  `sectionMembers` 保证，这条例外前提写进了它的 JSDoc）；`raiseWatermarks` 整趟只拷贝一次对象，
+  不再为每个抬升的分组各展开一次；`WorkspaceBrowser` 与三个列表体共用的「主视图保留了哪个会话」
+  扫描改为按 list 身份记忆，不再每轮渲染各 `Object.values()` 一次（`browser-shared.ts` 的
+  `mainViewSessionId`）。
+
+- **fix** `derive()` 用模块私有 Symbol 代替 `undefined` 表示「尚未投影」：投影**合法地**可能返回
+  `undefined`（"此刻没有待处理请求"就是一次正常的空结果），旧写法让每次 `getSnapshot()` 都重跑投影；
+  投影若新建 `Set`/数组，消费者每次读都拿到新引用，选择器永不收敛 —— 正是这个投影器要避免的事。
+
+- **a11y** 徽标设置卡片的数字增减按钮不再硬编码中文 `aria-label`（`settings.count.decrease` /
+  `settings.count.increase` 进 zh/en 两份字典）；搜索结果区补 `aria-busy`，并给「无匹配」与
+  「仅显示前 N 条」加上 `role="status"`，屏幕阅读器能从"正在搜索"读到终止结果。徽标自身的
+  `aria-label` 与 `title` 经复核同源、且逐项覆盖可见状态点与数字，无需改动。
+
+- **test** 补上此前**从未在本仓库跑过**的契约：`tests/apply-smoke.client.spec.ts`（宿主半边
+  `apply()` 不读 `ctx`、banner 仍报得出产物与进程）、`tests/facet-lifecycle.client.spec.tsx`
+  （登记面 → 消费存储 → React 的迟到登记 / 快照推送 / 同 id 热替换 / 注销 / dispose）、
+  `tests/derive.client.spec.ts`（投影身份稳定，含"返回 `undefined` 也只算一次"）与
+  `tests/locale-keys.client.spec.ts`（中英字典键必须同集合）。`group-status` 那条「空闲组是全零」
+  改为同时断言**引用**就是哨兵；`cross-plugin-summary` 补了「store 迟到注册后 hook 自愈」。
+  每条新用例都做过反向验证：改坏被保护的行为即失败，改回即通过。
+
+- **fix** 把客户端运行时依赖**逐条写进 `peerDependencies`**（12 个 `@deepseek-ai/dsh-*`，
+  范围 `^0.2.1-rc.2` = `engines.dsh` 下界），闭合"声明说不支持、内核照样装"的洞。
+  **为什么必须这么做**：≤0.2.0 的内核**不读 `engines.dsh`**，只按 `dsh-*` peer 的范围判兼容
+  （0.2.1 起反过来——`engines.dsh` 单独决定，peer 不参与判定）。此前 peer 里只有
+  `@deepseek-ai/cordis`，于是 0.2.0 把本插件判成"兼容"并装载；而那一代没发布
+  `@deepseek-ai/dsh-api-remote-access`，客户端 `inject` 的 `remoteAccess` 永远拿不到 →
+  fiber 永久 pending → `uiWorkspace` 不再被提供 → **`ui-sidebar` / `ui-conversation` /
+  `ui-chat` 等 12 条一起不激活，整页 "Failed to load plugins"，用户失去整个侧栏**。
+  现在 0.2.0-rc.2 实测：内核打印 `skipping profile bundle "dsh-group-status": … peerDependencies {...}`，
+  插件不装载，**控制台 0 错误、宿主自带侧栏照常工作**；而 0.2.1-rc.2 / rc.3 / rc.4 三代
+  `engines.dsh` 命中即返回，peer 不参与判定，仍全部判过、真 GUI 里分区正常渲染。
+  新增用例 `tests/artifacts.node.test.mjs`「每个客户端注入包都声明为 peer，且范围等于
+  `engines.dsh` 的下界」把这条不变量钉住（反向验证：把任一 peer 改成 `*` 即红）。
+
+- **docs** 跨代次验证记录（2026-10-27，`devkit/results/dsh-group-status-cross-kernel-2026-10-27.json`
+  与 `devkit/results/screens/`）：0.2.1-rc.2 上 gate / peer / tsc / test / 冷启动装配全绿，
+  真 GUI 里分组行、会话行、View options 菜单、扁平列表、搜索命中与无匹配态均正常，
+  搜索区的 `aria-busy` 与 `role="status"` 在真机可见。**0.2.0-rc.2 实测会把整个侧栏拖下去**：
+  该代次没发布 `@deepseek-ai/dsh-api-remote-access`，客户端 `inject` 的 `remoteAccess` 拿不到
+  → fiber 永久 pending → `uiWorkspace` 不再被提供 → 侧栏 / 对话 / chat 共 12 条一起不激活，
+  页面直接 "Failed to load plugins"。所以 `engines.dsh >=0.2.1-rc.2` 是**硬下界**，不是保守估计；
+  0.1.7/0.2.0 的内核也不读 `engines.dsh`（只卡 `dsh-*` peer，而本包的 `dsh-*` peer 只有
+  `@deepseek-ai/cordis`），因此这两代上它**能被装进去**——装进去就会坏，别手工降级。
+  折叠分组的活状态徽标这一轮**未判定**：隔离实例里宿主没有上报会话活状态，新/旧构建 A/B 均为空，
+  故不能算通过（对照记录见 `devkit/results/screens/README.md`）。
+
+- **chore** 构建与守卫：CI 新增 `lib/client.js` 的 gzip 体积预算（当前 77,312 字节 / 上限 84,000，
+  `release-invariants` job，纯 shell）；`parseHostPendingKinds` 解析不到时改为抛出**点名是哪一条正则
+  破了**的错误，不再静默返回空集合 —— 空集合会让"集合相等"永远成立，或退化成一条误导性的
+  "我们多认了 kind"漂移；`build/tools/experimental-package-policy.ts` 删掉本仓库结构上不可能走到的
+  分支（没有 `packages/experimental/` 树，十个保留名在 264 个已装包里一个都不出现）；产物可复现性
+  检查排除被 `.gitignore` 的增量缓存 `tsconfig.tsbuildinfo`（它记的是上次构建动过哪些文件，与被比较的
+  编译输出无关）。
+
+
 ## 0.5.0 — 2026-10-22
 
 - **fix** 宿主契约漂移**从此有人看着了**：`pendingInteraction.kind` 是开放集合

package/README.en.md

@@ -180,12 +180,14 @@ dsh plugin --profile web remove dsh-group-status
 
 | Item | Value |
 |---|---|
-| DSH core | `0.2.1-rc.2` |
-| peer dependency | `@deepseek-ai/cordis ~4.0.5` |
+| DSH core | declares `>=0.2.1-rc.2 <0.3.0-0`; verified on `0.2.1-rc.2` / `rc.3` / `rc.4` |
+| peer dependencies | `@deepseek-ai/cordis ~4.0.5` plus 12 `@deepseek-ai/dsh-*` at `^0.2.1-rc.2` |
 | Upstream base | `@deepseek-ai/dsh-client-ui-workspace 0.2.1-rc.2` (source vendored into `src/`) |
 | Install shape | fork override: same slots registered, stock row disabled via `cordis.patch.yml` |
 | Optional partners | dsh-later (schedule summary), dsh-gitea-dispatch (waiting-review summary) |
 
+Those 12 peers are not metadata. Cores at or below 0.2.0 **do not read `engines.dsh`** — they judge compatibility purely from `@deepseek-ai/dsh*` peer ranges. Without the enumeration, 0.2.0 considers this package compatible and installs it; that generation never published `@deepseek-ai/dsh-api-remote-access`, so the client `inject` for `remoteAccess` never resolves, the fiber stays pending, `uiWorkspace` is never provided, and `ui-sidebar` / `ui-conversation` / `ui-chat` — 12 entries in all — fail to activate. The page becomes "Failed to load plugins" and the user loses the entire sidebar. With the peers declared, 0.2.0-rc.2 measured as `skipping profile bundle`, and the host is unharmed; from 0.2.1 on, `engines.dsh` decides alone and peers are ignored, so in-window generations are unaffected.
+
 Every upstream generation requires a manual rebase — see the [upgrade runbook](./docs/upgrading.md). If upstream renames a slot, changes a component signature or the context contract, this package will not follow on its own.
 
 ---

package/README.md

@@ -182,12 +182,14 @@ dsh plugin --profile web remove dsh-group-status
 
 | 项 | 值 |
 |---|---|
-| DSH 内核 | `0.2.1-rc.2` |
-| peer 依赖 | `@deepseek-ai/cordis ~4.0.5` |
+| DSH 内核 | 声明 `>=0.2.1-rc.2 <0.3.0-0`；实测 `0.2.1-rc.2` / `rc.3` / `rc.4` 全绿 |
+| peer 依赖 | `@deepseek-ai/cordis ~4.0.5` + 12 个 `@deepseek-ai/dsh-*`，范围 `^0.2.1-rc.2` |
 | 上游基线 | `@deepseek-ai/dsh-client-ui-workspace 0.2.1-rc.2`（源码已 vendored 进本仓库 `src/`）|
 | 安装形态 | fork 覆盖包：同槽位注册 + `cordis.patch.yml` 禁用官方行 |
 | 可选搭档 | dsh-later（定时任务摘要）、dsh-gitea-dispatch（等待评审摘要）|
 
+peer 里那 12 条**不是元数据**：≤0.2.0 的内核不读 `engines.dsh`，只按 `@deepseek-ai/dsh*` peer 的范围判兼容。不逐条声明时，0.2.0 会把本包判成「兼容」并装进去 —— 而那一代没有 `@deepseek-ai/dsh-api-remote-access`，客户端 `inject` 的 `remoteAccess` 永远拿不到，fiber 永久 pending，`uiWorkspace` 不再被提供，`ui-sidebar` / `ui-conversation` / `ui-chat` 等 12 条一起不激活，**整页 "Failed to load plugins"，用户失去整个侧栏**。声明之后，0.2.0-rc.2 实测是内核直接 `skipping profile bundle`，宿主不受损；而 0.2.1 起 `engines.dsh` 命中即返回、peer 不参与判定，窗口内代次不受影响。
+
 上游一换代就得按[升级手册](./docs/upgrading.md) rebase 一次；上游改槽位名、组件签名或上下文契约时，本包不会自动跟上。
 
 其中**会静默失效**的那部分（我们认的待处理 kind 集合、我们从宿主读的两个状态事实）有守卫兜着：`tests/host-pending-kinds.node.test.mjs` 直接读锁定版宿主的实现来比对，宿主一改就红；人看的版本是 `pnpm check-upstream`（加 `--latest` 还能查 npm 上已发布的最高版）。