会话永久删除 huy8000/dsh-session-delete

dsh-session-delete

为 DeepSeek Harness 侧栏提供永久删除操作，保留原有菜单位置、确认流程和中英文界面。

当前版本为 1.1.0-rc.1，仅供独占存储环境的预发布验证，尚不满足完整的 1.1.0 发布条件。

删除不可恢复。插件没有回收站，也不删除导出副本、外部备份或第三方插件保存的数据。先备份重要对话。所有开发测试必须使用隔离临时目录，禁止使用真实用户 ~/.dsh 做删除测试。

支持范围与发布阻塞

- 仅核对并自动化验证 DSH 0.2.1-rc.2，对应上游提交 687f282e8625c6b8d11ff58211a90524be2e4317。不再声称整个 <0.3.0 范围兼容。
- 使用 JSONL Session Persistence 与 JSON per-record Projection Cache；支持未压缩及 .zstd 日志。实际位置取自正在运行的存储实例，不根据 process.env.DSH_HOME 猜测，因此也支持 DSH 正确配置后的自定义路径。
- 只删除不活动的冷会话。live 会话明确拒绝删除，不会停止任务，也不会调用私有 liveEntryFor()。上游没有向本插件提供现有 Agent 的官方销毁句柄；Session detach 也不等待异步 disposed 观察者完成。重启 Host，在打开目标会话之前重试，可以让普通历史会话成为冷会话。启动时自动创建的 live 会话仍可能无法删除。
- 缓存和 Workspace 仍需要限定版本的私有适配；缺失、被替换或不能核实版本时拒绝。详见 上游审查记录。部分布局没有必需服务时插件不会加载。
- 仅面向一个 Host 独占存储目录的部署。共享目录、多 Host 同时运行不受支持。未显式配置 singleHost: true 时默认拒绝磁盘删除和启动归档清理。 DSH 写句柄能排除其他进程的 Session 写入，但不能排除另一 Host 的冷读缓存回写或 Workspace 写入；插件无法可靠检测所有此类进程，因此不能声称跨进程删除完全安全。此边界也是公开发布前仍需解决的问题。
- 本轮 macOS、Node 24.12.0 / 22.19.0 各通过 74 项自动化测试。基线 e4077a3 的 Linux/macOS × Node 22.19/24 四个 CI 任务已成功；新候选须按具体提交 SHA 查看 GitHub Actions，不能用基线或本地结果替代。上一轮真实 Desktop 隔离实测见 记录，不代替本轮完整 UI 验收。Web/多客户端和 Windows 未验证。

安装与使用

本修复候选请先在临时 DSH_HOME 中验证，不建议直接替换唯一数据副本的环境。

在 DSH Plugins → Add plugin 输入本仓库的本地绝对路径，Install → Enable，重启 Host。也可通过以下仓库地址安装；请核对所选 ref，main 的修复候选与历史 1.0.0 代码行为不同：

git+https://github.com/huy8000/dsh-session-delete.git

CLI 安装示例（先启动过 Desktop profile，然后完全退出 Desktop）：

dsh plugin --profile desktop add "git+https://github.com/huy8000/dsh-session-delete.git"

CLI 安装依赖后仍需在插件页启用 bundle 并重启。不要绕过 DSH 的版本限制。若包管理布局使插件无法解析 DSH 的版本元信息，删除会返回 unsupported-runtime，应修复安装布局而非取消校验。

在临时实例确认只有一个 Host 使用 Session、Cache 和 Workspace 存储后，才在插件配置中设置：

singleHost: true

bundle 默认值为 false。可在临时 profile 的 cordis.patch.yml 用以下 patch 覆盖插件配置，然后重启：

- id: dsh-session-delete
config:
singleHost: true

这是部署者对存储独占条件的明确声明，并不是自动检测或跨进程锁。只有部署本身保证没有其他 Desktop、Web、CLI Host 或其他进程访问这些 Session、Cache、Workspace 目录时，才可以设置为 true。DSH 没有官方的全存储独占凭据，扫描进程也无法证明这一点，插件不会自动启用。本轮没有改动真实用户 ~/.dsh。

在会话行 ... → 删除会话，确认框会显示会话标题和不可恢复提示。进行中不能重复提交、关闭或更换目标；失败会保留错误信息。Host 删除完成但客户端刷新失败时，可单独重试刷新，不会再次提交删除。

实际删除流程

1. 校验 ID、已加载版本、服务结构和精确存储路径，并要求显式单 Host 部署声明。当前仅接受 [A-Za-z0-9_-]{1,200}；包含点、非 ASCII 等其他上游自定义 ID 明确拒绝，不声称这是 DSH 本身的完整 ID 规则。
2. 独立调用 workspace/session-activity。普通与已归档会话均检查；存在任何活动或 live Session/Agent 就拒绝。
3. 记录初始归档状态；先取得官方 sessionPersistence.open(id, 'write') 写所有权、Flush 并复核路径。写所有权、Flush 或这次路径检查失败，不会触发插件的归档，也不会丢掉原有置顶。
4. Prepared：调用 archiveSession(id, {}) 后独立复查活动和归档状态，建立按 ID 的缓存/Workspace 保护，保存最小恢复记录；再次检查目标目录。此时还没开始日志或缓存删除。rc.2 不提供归档条件回滚，之后若失败，返回当前归档状态，不自动 unarchive 或重新置顶以免覆盖其他客户端的操作。
5. Destructive：检查通过后才调用第一个日志 unlink（无日志时为缓存删除）；只清理可信 Header 定位目录中已识别的 generation，当前日志最后删除。缓存通过现有 Domain/KvTable 队列清理磁盘与内存；较早排队的写入先完成，尚未到达 put 的迟到写入被保护拒绝。
6. 等待插件取得的写句柄 Close，验证 Session 不在 live store 且 Persistence 不再返回目标，逐个等待 Workspace detach，清理 pin/archive，清除恢复记录，通过 Cordis parallel 分发 api-session/removed 并等待监听者结算（不等于浏览器接收确认）。
7. 客户端仅接受明确的 Host 完成结果；使用 DSH 的移除处理和刷新。移除先于加入已有刷新，复用上游列表 mutation journal，防止旧结果恢复会话行。客户端不再负责 unarchive，也不在 Host 失败后假装本地删除成功。

没有固定时间等待。 不活动并不等于可以安全卸载，所以 live 路径在第 2 步就拒绝，尚未实现原有“直接删除 live 会话”的目标。

文件范围和保留内容

<Session Persistence 实际 root>//<id>/session.jsonl[.zstd] <Projection Cache 实际 domain 目录>/sessions/<id>.json

仅删除上述已识别文件。遇到重复匹配目录、符号链接、硬链接、未知文件/子目录、元数据不一致或非 ENOENT I/O 错误会拒绝或报告部分失败，不扩大搜索和删除范围。目录检查只在 Session root 下扫描项目与目标 ID 两层。

会保留 session.lock 及空会话目录。上游 POSIX 锁依赖稳定 inode；删除锁文件会破坏互斥，Windows 也未验证过整目录删除。本实现不以“整个目录消失”作为成功标准。

恢复记录位于 <Session root>/.dsh-session-delete/<id>.json，仅保存 Header（可能包含项目路径），成功后清除。缓存后端保留的 .json.bak.、导出文件、外部备份和第三方会话附件不在本次删除契约中；发现未知 Session 目录内容会拒绝，需人工检查。

结果、故障与重试

| 状态 | 含义与操作 |
| deleted | 约定的日志、当前缓存、关联、pin/archive 与恢复记录清理完成，已发布移除通知 |
| already-absent | Session 已不存在，相关残留清理完成；重复请求可安全返回此状态 |
| rejected | 本次未开始日志/缓存删除；若归档已成功，会明确返回当前归档状态。保护未被使用且准备记录成功清除时会释放，否则明确返回保留保护 |
| partial | 已提交清理调用，或存在上次未完成的恢复记录；数据可能不完整，不代表每个失败都已经删掉文件。修复错误后重试同一 ID |

错误包含稳定 error、phase、dataState、archive.before/after/restoration、protection 和 releaseFailed。归档状态是返回时观测值，不是有版本保护的承诺；restoration: unsupported 表示无法安全自动恢复，不能推断归档只由本插件改变。归档成功后可能已取消置顶，插件不会在失败时擅自重新置顶。日志只记录 ID、阶段和错误类别，不记录对话内容。

dataState: preserved 只表示本次没有开始日志/缓存清理，不保证存储原本完整。已存在的恢复记录无法读取/解析时，不推断上次删除进度，返回 uncertain 并保留保护和证据，需人工检查 Host 日志及该记录。

断网、无效 JSON、响应缺少匹配的完成/失败结构均显示 Host 结果未知，不会声称数据保留或删除失败。请刷新核对，再按需重试同一 ID；Host 明确完成后只有客户端同步失败时，按钮才仅重试刷新。

同一服务实例中相同 ID 的同时请求共享一个操作；其他 ID 可以并行。启动仅清理确认不存在、没有恢复记录的孤儿归档关联，不自动继续破坏性工作。中断的删除保留恢复记录供显式重试；原 Header 与新 Session 不匹配会拒绝。操作不是事务，关闭浏览器不会取消已经接受的 Host 清理；突然退出 Host 的测试验证了可重试，但不承诺电源故障下的事务原子性。

准备失败且本次新建的保护没有拦截任何操作、写句柄成功关闭、准备记录成功清除时，会释放保护。已经拦截 put 或 Workspace 筛选、继承了旧保护、清理准备记录失败或无法确认写句柄释放时，保护保留并显示重试/重启指引；即使日志仍完整，Workspace 可见列表也可能被保护过滤。归档可通过 DSH 手动恢复，但恢复归档不会解除清理保护。

不可逆清理或恢复尝试的保护保留至对应服务退出，包括禁用插件后。启动只遍历恢复记录目录一层，恢复有效记录的保护，不自动删除数据；有恢复记录的 ID 即使已被其他客户端恢复归档，也不会被当作普通孤儿清理。同一 Host 生命周期内不要重用已删除的 ID；存储或缓存热替换后需要重启。重启不会恢复已删除数据，也不会清除仍有效的恢复记录。

目录的符号链接及硬链接会预检拒绝；Node 文件 API 无法提供跨平台 openat 式完整路径事务，因此不支持不可信本地进程在检查和 unlink 之间主动替换存储结构的环境。

开发与验证

npm ci
npm run check
npm test
npm run pack:check

无新增运行时第三方依赖。开发依赖固定上游模块版本，以 Node 原生 test runner 驱动真实持久化、原生写锁、Domain、Workspace、Connection、Session Controller 和 React 组件行为测试；测试使用临时目录并清理资源。React 测试渲染器会输出弃用提示，未将该提示视作浏览器验收。

覆盖冷会话、压缩日志、live 拒绝、两类活动会话、Flush/Close/文件/缓存/Workspace/归档故障、缓存迟到写入、跨进程写锁、进程中断恢复、并发/幂等、路径异常、自定义 root、孤儿标记与中英文组件行为。安全卸载 live 会话尚未实现，测试断言的是保守拒绝，不是成功删除。 详见 测试与手动步骤。

这个 1.1.0-rc.1 预发布版还不能用于完整的 1.1.0 发布，也不适合常规安装。它只验证了 DSH 0.2.1-rc.2。可以删除不活跃的冷会话；活跃会话会被明确拒绝，因为插件没有官方所有权能力，无法销毁这些会话的智能体并等待所有处置写入完成。请重启 Host 后重试，再打开普通的历史会话。

删除不可逆。清理范围包括：已识别的 JSONL 世代、当前投影缓存记录、Workspace 记账以及 pin/archive 标记。稳定的 session.lock inode 及其目录会保留。备份、导出和第三方产物不在本约定范围内。未知文件、链接、有歧义的路径、存储错误和不支持的接口一律按失败关闭处理。

写入所有权、Flush 和初始路径重新校验都在归档之前执行，因此这些环节失败会保留 archive/pin 状态。rc.2 没有归档修订号，也没有 compare-and-set 回滚；后续拒绝只会报告观察到的归档状态，不会撤销其他客户端的操作。只有在写入器和 journal 清理成功后，准备阶段才会释放新的未使用 fence。已使用或继承的 fence 会保留，即使没有删除任何日志。清理尝试或未完成的恢复会返回 partial；请用同一 ID 重试。响应丢失或无效意味着 Host 结果未知，不能据此认定失败或已保留。同一会话的请求会在进程内合并；迟到的缓存写入和 Workspace 挂载仍会被 fence 拦截。不使用固定 sleep，也不使用私有 detach。

缓存和 Workspace 适配器仍会访问 pinned 私有字段，并在服务整个生命周期内保留 fence，包括插件卸载时。磁盘删除默认关闭。只有存储确实由单个 Host 使用时，才设置 singleHost: true；这是运维人员的声明，不是自动检测。共享目录、多 Host 场景以及对抗性的并发文件系统替换仍不受支持。会话写入租约不是缓存或 Workspace 数据的全局锁。这些限制，加上缺少活跃会话拆除能力，使得无法宣称已通过完整发布验收。

安装这个工作区候选版本：在 Plugins → Add plugin 中填写它的本地绝对路径，启用插件，然后先在隔离的测试 home 中重启。运行 npm ci、npm run check、npm test 和 npm run pack:check。证据和手动检查项见上文的审计与测试文档。卸载插件不会恢复已删除的数据。

License

MIT © 2026 huy8000