dsh-delete-session

两半边都是无需构建的朴素 JavaScript：Host 半边是导出 apply/inject 的 Node ESM，浏览器半边是 window.__ModuleLoader__.load({ id, factory }) 形态的模块，React 由外壳注入。本包在运行时不 import 任何 harness 的东西——Host 半边只用 Node 内置模块，浏览器半边只用页面已经发布的服务。

那条私有路由

浏览器碰不到文件系统，所以客户端通过一条私有 HTTP 路由调用 Host 半边：POST /dsh-delete-session。路由由每进程随机生成的 48 位十六进制 token 守卫，该 token 经 webServer.tapIndex 以 <meta name="dsh-delete-session-token"> 注入每份渲染出的 index.html，客户端再用 x-dsh-delete-session-token 头回传。跨源页面读不到这个 meta，自定义头又会强制一次外部源无法满足的预检。方法、token、JSON 结构都在碰任何东西之前校验，请求体上限 256 KiB。

刻意保留两套请求契约：

扁平契约出现得更早，至今仍然提供，所以客户端遇到批量升级之前的 Host 半边时会退化成逐条请求（识别方法是它回 400/404/405）。每条结果都带稳定的 code——ok、invalid-id、current、running、root-missing、log-locked、empty、bad-body、forbidden、method、internal——本地化文案由客户端负责，Host 不需要知道页面语言。

客户端挂在哪里

侧栏在这两个位置都没有提供增量 slot，所以两个入口都由注册在 shell.overlay 里的同一个座位组件注入到产品自己的 DOM 上。

• 菜单项。 捕获阶段的 click 监听记录下被点 … 按钮所在行的 session id，它是从该行的 React fiber 里读出来的（memoizedProps.node.id，以 session- 开头——这个前缀同时也把 Workspace 行排除掉）。随后 MutationObserver 通过「同时含 Fork 与 Archive 两个来自实时 workspace 词典的标签」来确认新弹出的菜单，收敛到仍同时含有这两个标签的最小子树，再把红色条目追加进去。
• 区头按钮。 它作为区头的直系子节点插在 *_headerActions 那组图标之前。那组容器的上限是 60px——正好两个 28px 图标按钮——并且 overflow: hidden，塞第三个会被裁掉。定位靠 CSS module 类名的后缀（_sectionHeader、_headerActions），因为前缀 hash 每次上游构建都会重生成；主路径以任意渲染出的 role="treeitem" 行为锚点，不对侧栏之外的文档结构做任何假设，页面上还没有会话行时则退化成按区头自己的文案（两种语言拼写都带上）匹配。

React 用自己持有的 DOM 引用做增删，不会移除自己不认识、也不属于它的兄弟节点，所以插在两个 React 子节点之间的节点是安全的；万一某次重渲染把它带走，观察者的下一批变更就会补回来。座位被卸载时，它拥有的每个节点、监听器与样式表都会被移除。

两个值得知道的设计决定

• 先归档再删文件，且绝不 detachSession。 Workspace 注册表的归档集合设计上保留会话的记账 slot——"归档的会话保留它的 sessionIds slot，取消归档时能回到原位"——而且它本来就会在会话头部不再可解析时把 slot 过滤掉。早期版本在删完日志后又调了 detachSession，结果会话从它的 Workspace 里掉了出去，用户刚删掉的那一行以「未分组」的形式重新出现。现在什么都不摘。
• 客户端自己摘掉那一行。 Host 没有任何公开途径去 dispose 一个由别的所有者创建的对话，而让客户端删行的事件（api-session/removed）只由 session/disposed 触发，插件够不到。调用 sessions.handleSessionRemoved(id) 用的就是同一条中继，这正是"Host 仍把对话留在内存里、行却立刻消失"的原因；归档集合则仍是列表刷新后用来对账的持久过滤器。

失败处理

归档先尝试，失败不算致命：删不掉的日志返回 log-locked 并在 detail 里带上目录；由于归档可能已经把行藏起来了，客户端会追加"该行已从侧栏隐藏，但日志文件未能删除"，而不是假装删除成功。<DSH_HOME>/sessions 根目录缺失会在碰任何东西之前以 root-missing 失败关闭。日志本就不存在的对话以 ok + alreadyGone: true 上报，这让重试保持幂等。

两个零依赖的冒烟测试覆盖两半边，且不需要启动 DSH：

npm test
# 也可单独跑
node test/host-smoke.mjs      # 在临时 $DSH_HOME 上驱动真实路由
node test/client-render.mjs   # 用最小 React 与 DOM 桩渲染真实座位组件

Host 测试同时是上面那两条规则的回归守卫：它断言归档发生在日志被删之前，并断言 detachSession 从未被调用。客户端测试用一个手写的小 DOM 驱动挂载副作用，因此区头注入、点击开框的接线、幂等重注入、文案兜底都被检查到。

改动这里之前值得记住的坑：

1. 删完不要动 Workspace 记账。 那就是「未分组」bug：被删的行会以游离项的身份回来。见上面的设计决定。
2. 不要把区头按钮塞进 *_headerActions。 它上限 60px 且 overflow: hidden，第三个子节点会被裁掉。
3. 不要在座位的挂载 effect 里订阅任何东西、并把订阅 disposer 当作 cleanup 返回。 曾经这样做让整个座位在挂载时被卸载：apply 正常完成、slots.register 也返回了 disposer，但组件永远不出现。深浅色因此改成"打开对话框时采样一次"，而不是实时跟随。
4. 子进程不展开 %VAR%。 cmd.exe 里 echo %DSH_HOME% 会原样输出字符串；请像 Host 半边那样直接读 process.env.DSH_HOME，回退到 <home>/.dsh。
5. Host Guard 禁止碰别的 Cordis Context。 service.ctx.emit(...) 会被拒绝；插件只能用自己 apply(ctx) 的那个 ctx。
6. 运行中的对话在两边都必须保持不可删。 客户端置灰是为了说明原因；即使客户端没拦，Host 也会拒绝。

Profile 机制：patch 层能热更，模块代码不能。改 cordis.patch.yml 立即生效，改 lib/index.js 需要重启进程，改 lib/client.js 在下次刷新页面时生效。