遗忘会话 2026heshao/dsh-forget-session

dsh-forget-session

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

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

功能

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

- 「遗忘会话」（order 500，排在官方「置顶 / 重命名 / 分支 / 归档」之后）
- 点击后两段式确认：该行变成「再次点击确认遗忘」，再点一次才执行（菜单内完成，不弹窗；失败信息直接显示在这一行上，不静默）
- 成功后该行消失，顶部 Toast 汇报删除摘要（删了几个工件、几条警告）

| 删除对象 | 方式 |
| 正在运行的工作 | 官方 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