dsh-forget-session

DeepSeek Harness（DSH）插件：在会话行「…」菜单里加一个**「遗忘会话」**，把该会话从侧栏与磁盘上彻底移除。灵枢记忆插件的沉淀数据不受影响。桌面端与 Web 端通用（插件 UI 运行在两端同源的浏览器渲染层，行为一致）。

兼容性：已在 DeepSeek Harness 44.7.0（宿主内置 @deepseek-ai/[email protected] / cordis 4.0.5）上全量测试通过；声明的 peer 范围 >=0.1.5-rc.1 继续覆盖，本版本无需代码改动。

功能

仅在会话行「…」菜单新增一项：

删除对象	方式
正在运行的工作	官方 `workspace/session-stop` 瀑布（stopActivity 归档路径）
活体会话（Session store 内）	官方 `entry.detach()` 内部通道：`store.delete` + `attachments.delete` + `emitDisposed`（v2.2 新增，见下文根因 3）
工作区记账（workspace.json 的 sessionIds）	官方 `detachSession` 通道（domain 写链）
归档集合 / 置顶集合	官方 `unarchiveSession` / `unpinSession`
会话日志目录 `~/.dsh/sessions/<项目键>/<id>`	整目录删除（含 `_no-cwd`、历史无前缀布局、占用重试）
投影缓存分片 `~/.dsh/storages/session_projcache/sessions/<id>.json`	删除
投影缓存总表 `~/.dsh/storages/session_projcache.json` 的表项	读-改-写，其余内容原样保留
复活文件（句柄残留 / 迟到写入重建）	Host「复活守卫」在 ~2 分钟窗口内自动再删
侧栏会话行（客户端会话列表）	官方 `sessions.handleSessionRemoved(id)` + `sessions.refresh()`

不动的数据：灵枢记忆（~/.dsh/.dsh-memory）、附件、其他任何会话。

「未分组」= 客户端会话列表里的 id − 所有 workspace.sessionIds 的并集。对官方源码逐包取证后确认了两个复活路径：

根因	机制	对策
Windows 活体删除竞态	会话打开过就有 write handle / 跨进程 lease：`rm` 目录报 EBUSY/EPERM，v1 静默失败 → 文件残留 → 重启后 registry 重新收编；且删除后活体 teardown 的迟到 append 会重建已删目录	删除后验证性复查，占用类错误退避重试；布置复活守卫：2s 起指数退避（封顶 32s）、总窗 ~130s 周期复查，目录被重建立即再删
客户端列表复活	Host 的 `session.list` 仍会列出活体会话；客户端任何一次 `refreshList`（重连即触发）都会把已删行合并回来	删除后调用官方 `sessions.refresh()` 重拉基线，让复活行在可见前被再次摘掉
活体从未摘除（v2.2 根治）	`SessionStore` 没有公开的 remove API：会话一旦进入 store，`session.list`（合并活体 + 持久化）永远列出它 —— 删除后立刻回到「未分组」；且持久层 writer 握着 write handle 顶住磁盘，`rm` EBUSY，复活守卫删 ~130s 也是白删	走每个 store entry 自带的官方 `entry.detach()`（= `store.delete` + `attachments.delete` + `emitDisposed`）：既让行从 `session.list` 消失（官方 `api-session/removed` 帧），又释放持久层 write handle —— 删盘这一步才真正删得动

v2 一度还加过「会话体检 / 空壳清扫 / audit 盘点」等额外远端点，但它们并未随客户端契约挂载，点了只会得到 typert gateway 错误，属于无用面 —— 已全部移除，契约面只保留 delete 一个方法。

forgetSession 服务只暴露一个方法：

方法	参数	行为
`delete`	`{ sessionId }`	全瀑布删除（权威状态 + 磁盘工件 + 复活守卫）

用 DSH 官方命令安装（装进哪个 profile，就在哪个端生效）：

dsh plugin --profile web add github:2026heshao/dsh-forget-session

装完重启 DSH 即生效（--profile 后换成你实际使用的 profile 名）。

dsh plugin --profile web remove dsh-forget-session

remove 会同时移除依赖与补丁层，重启 DSH 后菜单恢复原状。

Host 半（lib/index.js）：TypertRemoteService，服务名 forgetSession， inject: ["workspaceRegistry"]。delete() 走官方状态通道（stop / unarchive / unpin / 活体 detach / detach），再按 session-persistence-jsonl 的同构路径算法（projectKey + encodeSegment）删除磁盘工件（占用类错误退避重试 + 验证性复查），清投影缓存，最后布置复活守卫。全程不手改 workspace.json —— 记账由 registry 的官方 mutate 写链完成。活体摘除经 ctx.get("sessions").store（公开类字段 Map）取 entry 调 entry.detach()，等价于官方 SessionStore.detachEntered。
浏览器半（lib/client.js）：window.__ModuleLoader__ 包， ctx.remote.$mount 只挂 delete 一个方法契约（strict codec 两键并写）， ctx.slots.inject("sidebar.workspaces.session.menu.item", ...) 注册菜单行； Toast 走 primitives.Toast，经模块级 toast bus + shell.overlay 常驻组件渲染（React hook 绝不能在 apply() 里调用 —— 渲染上下文之外没有 dispatcher，会让整个 fiber FAILED）。
复活守卫：delete() 成功后启动（无论本轮是否全清）；每档复查日志目录（cwd 已知按项目键定位，未知全扫）与分片缓存，删除再次成功会连带清分片。同一会话再次显式删除会重置守卫。

cd <本仓库目录>
node test/verify.mjs

隔离 HOME（DSH_FORGET_SESSION_HOME 指向临时目录），15 项断言覆盖：契约面只含 delete、delete 全瀑布（活体 flush/detach、目录/分片/总表项/ 工作区 detach）、正常会话零误伤、幂等、缺参报错、复活守卫清除被重建目录。

测试需要 @deepseek-ai/cordis 与 @deepseek-ai/dsh-typert-protocol （peer 依赖，随 DSH 提供），在装了本插件的 profile 内可直接运行。

DSH 官方设计是「会话只归档不删除」（见 dsh-client-ui-workspace README），本插件是官方通道之外的用户级补充；
若被删会话是本进程活体：先 flush 落盘缓冲事件，再经 entry.detach() 摘出 store（官方 dispose 通道会关持久层 write handle）。守卫窗口（~130s）内 teardown 的迟到写入都会被补删。建议在空闲会话上使用删除；
会话搜索索引（session-query-sqlite）的 openAt 非 never 时，已删会话行会在下次 _reconcile（任何一次搜索）自动收敛 —— 持久化列表已不含该 id，索引走 persistentDeletes 清掉它；openAt: never（默认）为内存态，自愈。

MIT