[Bug] 停用→启用一行带 Client 模块的插件后，浏览器半侧不会重新挂载（loaded without registering），只有重启 App 才能恢复

[Jedeiah]

Summary

dsh 桌面端（Electron）的界面本身就是一张网页（由本机 web 服务提供的 Web UI），插件因此分两半：宿主半侧跑在 Node 主进程，浏览器半侧（Client 模块）跑在窗口里的这张网页上。本报告说的是后者，与外部浏览器无关。

在这台机器（Desktop 0.2.0-rc.2 / macOS）上：把一行带 Client 模块（dsh.client.platform = "web"）的插件，在 Plugins 页面里「停用 → 启用」之后，那一行的 Client 模块不会被重新挂载。宿主半侧与 entry 状态都正常，但它的所有客户端槽位注册全部消失；内置插件面板给出：

client-modules: could not load "<pkg>": plugins/??<pkg>/client.js&rev=<rev>:
loaded without registering "<pkg>" via __ModuleLoader__.load

面板自身的措辞也印证了这个分界：「本页面的插件未能完成同步；服务端的启用状态保持不变」。

只有重启 App（= 这张网页全新引导一次）才能恢复。面板上的「重试」无效。

Reproduction

1. 装一个带 Client 模块的组合包（dsh.client.platform = "web" + exports["./client"]），其客户端 bundle 在页面里注册进某个槽位（例如 plugins.bundle.config）。
2. 重启 DSH → 注册正常出现，一切正常。
3. Plugins 页 → 展开卡片 → 在「组件」列表点这一行的停用 → 注册消失（符合预期）。
4. 再点启用 → 注册永远不回来。
5. 面板出现上述 loaded without registering；点「重试」无效。

（推测任何"启用状态可切换 + 带 Client 模块"的行都一样；未用内置行验证，因为可切换的内置行不便改动。）

Current behavior

• 宿主侧：Config.listConfigs（name = <pkg>）→ status: "schema"（fiber 存活）
  → 行确实是启用状态

• 客户端侧：Slots.listSubTree → 该插件注册的槽位没有 occupant
  （plugins.bundle.config 为空；另一处 conversation.composer.dock 也只剩内置的 stats）

• 内置插件面板原文（示意）：

  <pkg>: Error: client-modules: could not load "<pkg>":
  plugins/??<pkg>/client.js&rev=<rev>:
  loaded without registering "<pkg>" via __ModuleLoader__.load
  

• 点「重试」→ 无变化

• 手动改客户端 bundle 的 mtime（触发 HMR 产物 revision 变化）→ 无变化

• 重启 App → 恢复

Expected behavior

packages/client/modules/README.zh.md 明确承诺：

已打开的 Web 页面通过 HMR 传输跟随 Host 的完整模块图。启用普通插件会添加其 Loader 条目；停用会移除条目，并在其异步 effect 完成清理后回收未使用的模块与样式。再次启用会加载一个带样式的实例。

即：再次启用应当重新挂载，不需要刷新页面。

已排除的可能

• 不是注册 id 写错：客户端 bundle 注册的 id 与包名完全一致（本地测试台加载真实 bundle，断言 __ModuleLoader__.load 收到的 id === 包名；48 项断言全过）
• 不是 bootstrap 行：该行未声明 dsh.client.immediately，不属于文档所述"移除或替换 bootstrap 需要刷新页面"那一类
• 不是 whileServed 造成的：该页面直接注册，未使用 configForms.whileServed
• 不是 【插件作者必读】2026-09-29 Desktop 升级：带设置 UI 的插件会静默失效（迁移指南） #8438（旧设置 API 迁移）：本插件已用新契约（导出 Config + 全部字段 .volatile() + ctx.configForms.get() + dsh.client.inject 声明依赖）
• 不是 Fail soft on client-module registration mismatch: validate at dsh plugin add + isolate single-module combo failures #6202（注册 id 不一致）：错误文本相同，但那一类的根因是注册 id ≠ 包名，这里 id 是对的

源码层面的线索（供定位）

packages/client/modules/src/client/entries.ts 里两条处理"条目缺失"的路径不一致：

// retry() → reconcile()：条目缺失时
if (entry === undefined) {
  await this.modules.prefetch(row.id)
  await this.modules.import(row.id, '', {})   // ← 没有让模块表作废旧注册
  await this.create(loader, row.id)
  this.revisions.set(row.id, row.rev)
}

// reload(id, rev)：条目缺失时
if (entry === undefined) {
  this.modules.invalidate(id, desired.rev)    // ← 关键的一步
  removeOwnedStyles(id)
  await this.reconcile(this.generation)
  return
}

推测：条目被移除后，模块表里该包的 factory 注册没有被丢掉；重新加载时单资源脚本再次执行 __ModuleLoader__.load({id})，这次注册被当作重复而未生效，于是 arrive() 判定 "loaded without registering"，条目永远建不起来。reconcile() 缺 invalidate() 与"重试无效"的实测一致。

（这是读源码的推测、不是结论。若 invalidate() 不是关键，则"停用后未回收 factory 注册"仍然需要一条恢复路径。）

Environment

• DeepSeek Harness Desktop 0.2.0-rc.2，macOS
• profile：desktop（默认桌面 profile）
• 插件：本地 link: 安装的组合包；dsh.client.platform = "web"；未声明 immediately
• 复现概率：100%（同一行多次重复）

期望

1. 停用 → 启用后 Client 模块能原地重新挂载（与 packages/client/modules/README.zh.md 的承诺一致）
2. 若暂时做不到，「重试」至少应当能恢复——现在它和首次失败一样无效