会话删除 FunnyDiodio/dsh-session-delete

dsh-session-delete

给 DeepSeek Harness 的会话「…」菜单补上真正的删除会话。

背景：DSH 官方（含桌面端）的会话存储层只有归档 / 置顶 / 重命名 / 分叉，从未提供删除；本插件补齐这一缺失能力，交互对齐主流智能体（ChatGPT / Claude 等）的删除语义。

⚠️ 删除前必读：备份什么、不备份什么

会永久消失（不可恢复）—— 会话的对话记录本身：

- 会话日志（每轮消息、工具调用轨迹、模型输出）与投影缓存被物理删除，且对其他所有会话、对模型、对搜索工具同时永久隐身——删了就是谁也想不起来了
- 若这个会话里有值得留的东西，删除前先做其中一件：
1. 让该会话的智能体把关键结论 / 决定 / 未完事项浓缩写入工作区一个 .md 摘要文件（推荐，最省事）
2. 用 DSH 自带的会话日志导出/下载功能留一份原始日志副本

不会被动——工作区里的文件：

- ✅ 该会话中生成或修改的工作区文件（代码、文档、作业……）全部原地保留，本插件不碰 ~/.dsh 之外的任何路径
- ❌ 反过来说：删会话不能用来「撤销」智能体改过的文件——文件属于工作区，不属于会话，想回滚请用 Git

功能

- 侧边栏每个会话行的「…」菜单新增红色删除会话行（位于「归档会话」之下），带垃圾桶图标、危险配色
- 确认对话框说明删除后果；对话框内含强制删除复选框（默认不勾选）
- 普通删除：拒绝正在生成回复 / 有后台工作 / 有未落盘内容的会话，提示直接引导勾选强制删除
- 勾选强制：先通过会话自身智能体的公开退场链把它从内存中释放（停止回复、释放日志句柄，并原生触发 session/disposed —— 桌面与手机端的行此刻即消失），再停掉后台工作（子代理 / 后台任务 / 定时提醒，与官方「停止并归档」同一机制），最后彻底删除：磁盘日志 + 投影缓存 + 注册表记账全部清除，不留幽灵行
- 极端情况下若会话被其标签页持锁无法自动释放，才提示关闭该标签页后重试（罕见兜底，非常规步骤）
- 被拒绝后复选框保持可见，当场勾选重试即可，无需关窗重开
- 删除成功后：已连接的所有客户端界面即时移除该行（无需重启）；磁盘上的会话日志目录、投影缓存文件被清除；工作区归属 / 置顶 / 归档记账一并清理
- 记录已丢失的「幽灵行」（历史版本遗留）再次点删除也能回收：按会话 id 清扫所有项目目录

安全护栏

- 只删除 ~/.dsh 内由会话 id 精确计算出的路径（与官方 JSONL 存储后端同一套编码），绝不触碰工作区
- 磁盘删除真实失败时中止流程且不修改注册表——不会出现「账删了、日志还在」的半途状态
- 删除顺序先清磁盘与内存索引、后做记账变更，杜绝「未分组」幽灵行复活
- 接口经宿主信任栅栏（仅回环 + 同源浏览器请求），外部页面无法调用；无任何网络外发，不读取或上传对话内容

安装

设置 → 插件 → 市场（Discover）搜索 dsh-session-delete（收录合并后），或命令行：

dsh plugin add @funny_diodio/dsh-session-delete # npm 源
dsh plugin add github:FunnyDiodio/dsh-session-delete # GitHub 源

（桌面端在对应配置档上执行；安装后重启或按提示重载生效。npm 源为预构建产物，安装免 allowBuilds 授权。）

要求 DSH ≥ 0.2.1-rc.1（dsh.bundle 协议 + 会话菜单插槽均自该线可用）。
适用：DSH NEXT、官方桌面端及任何内置 dsh Web GUI 的第三方客户端；纯命令行 / headless 宿主没有侧栏 UI，装了不会显示。

卸载

设置 → 插件里直接卸载：菜单项与对话框随之消失；已执行过的删除是永久操作，不受卸载影响（这也是为什么弹窗标题写着「不可撤销」）。

给开发者：实现速览

- Host（index.js）：webServer 精确路由 POST /session-delete/api/delete { sessionId, force? }，过 connection.requestRejection 信任栅栏；流程：live（force 时先经 Agent 公开 dispose() 释放内存态并等待其真正离场，释放不掉则 409 release-failed；非 force 一律 409）→ pending → （force 时 workspace/session-stop 停后台工作）→ activity → 磁盘删除（日志目录 + 投影缓存）→ 注册表内存索引逐出 → unarchive / unpin / detach → emit api-session/removed
- Client（client.js）：window.__ModuleLoader__ 注册；菜单行 sidebar.workspaces.session.menu.item order 420（archive=400 与 session-id=450 之间）；确认框走 shell.overlay；强制删除且该会话正显示在本页主视图时，先静默释放主视图（与用户手动关标签页同一条 un-retain 路径）再删，用户零感知；样式全部取自 --dsw-alias- 主题令牌，明暗色自适应；文案 zh/en 自管 + 注册进 locale 服务
- 路径编码与 dsh-session-persistence-jsonl 保持一致（projectKey / encodeSegment）， header 缺失时按 id 清扫全部项目目录兜底
- 版本线：v1.0.0 首发（新家 + 正式包名）；v1.1.0 复选框在错误下保持可见； v1.2.0 force 语义升级为「自动释放内存态会话后一步删净」；v1.2.1 发布定型（scoped npm 名）； v1.2.2 修复「开着标签页强制删除被拒」：客户端静默释放主视图 + 重试，宿主释放窗口加宽至 4s

License

MIT — 见 LICENSE。

English summary

dsh-session-delete 给 DeepSeek Harness 里每个会话的「...」菜单补上缺失的 Delete session* 一行（官方客户端只有归档、置顶、重命名、派生，没有可持久化的删除）。

- 确认对话框带一个 Force delete 复选框，即使出现拒绝类错误，这个复选框也始终可见。强制删除一键完成，不需要用户额外操作：先通过会话所属智能体的公开 teardown 释放会话（停止生成、释放日志句柄，原生 disposal 事件会让桌面端和手机端的这一行同时消失），再停掉后台工作（子代理、作业、定时任务，机制与已发布的「stop and archive」相同），最后删除全部内容。只有极少数情况，某个标签页把会话占得太死、无法释放，才会提示用户关闭它。
- 对话日志会被永久删除，其他会话和模型都看不到。删除前请先备份重要内容：让智能体把摘要压缩进工作区文件，或者导出会话日志。
- 工作区文件绝不会被改动：会话里创建或编辑过的文件都会保留（与 ChatGPT、Claude 的语义一致）。删除会话不是文件回滚。
- 只删除 ~/.dsh 内由会话 id 精确计算出的路径；磁盘删除失败时，会在任何记录变更之前中止；该路由位于主机信任围栏之后（loopback + 同源），不发起网络请求，不读取也不上传对话内容。
- 需要 DSH ≥ 0.2.1-rc.1；支持 DSH NEXT、官方桌面客户端，以及任何提供 dsh Web GUI 的主机。卸载会移除菜单行；已执行的删除保持删除状态。