dsh-essential

English | 中文

面向 DeepSeek Harness 的可恢复对话删除插件。它在会话行菜单中添加“删除对话”，也注册人工命令 /delete-conversation；用户确认后，目标 Session 会进入删除队列，并通过 Workspace 的持久归档投影立即从列表中隐藏。DSH 下次启动时，插件会在 Web Workspace 建立会话索引之前校验该 Session 的完整生命周期，并把其 JSONL 目录原子移动到恢复垃圾箱。

为什么需要重启

当前 DSH 的 Session 持久化约定是只追加的，公开服务没有删除方法；活动 Agent 的销毁句柄也只属于创建者。插件不能安全地从活动写入者脚下移走日志。因此，删除分为两个阶段：当前进程只写入一条持久请求，下一次启动在任何会话恢复之前完成移动。这个边界避免日志重建、部分写入和生命周期竞争。

安装

本包是一个自包含的 DSH bundle，自带 cordis.patch.yml，不需要修改或重新构建 DeepSeek Harness 源码。直接从已构建的 Harness CLI 安装到 Web profile：

node /path/to/DSH/apps/cli/lib/bin.js plugin --profile web add /path/to/dsh-essential

安装后重启 DSH。Bundle 会：

• 挂载 @deepseek-ai/dsh-essential；
• 把 stateDir 设为 DSH home 下的 conversation-trash；
• 让 Web Workspace 等待 conversationDeletion 服务完成启动恢复后再建立 Session 索引。

直接写 cordis.yml 时，stateDir 必须是绝对路径：

- id: essential-conversation-delete
  name: '@deepseek-ai/dsh-essential'
  config:
    stateDir: /absolute/path/to/conversation-trash

使用

在会话列表中打开目标会话右侧的 … 菜单，选择“删除对话”。Web 会显示标题为“确认删除该对话吗？”的站内卡片，并提供“取消 / 删除对话”操作；不再使用浏览器原生弹窗。确认后通过不依赖活跃 Agent 的根级 Remote 提交目标会话的删除请求，并在请求成功后立即归档该 Session，使历史会话和当前会话都能从所有会话分组中隐藏。取消确认不会发出请求。

在 Harness 提供公开的会话菜单槽之前，插件会观察语义化的 Session 树行，并从 document 级稳定控制器把 React 操作 Portal 到宿主菜单 DOM。控制器不会随宿主菜单自动收起而销毁，因此确认卡片不会跟着菜单子树一起消失。pointer 边界桥会把跨 React 根进入“删除对话”的移动保留在宿主菜单内；若浏览器没有提供 relatedTarget，进入删除项时还会显式取消宿主的 pointer grace，同时继续支持真正移出菜单后的正常自动收起。目标身份优先从该行的 React owner 读取；唯一可见标题匹配只作为安全后备。若标题存在歧义，插件不会显示破坏性操作，避免误删错误会话。

删除进行中，确认卡片会锁定关闭与操作按钮，将主按钮改为“正在删除…”，并显示进度；请求失败或“已排队但暂时无法隐藏”的部分成功状态会直接显示在卡片中。完全成功时，会话行消失即为结果反馈，不再额外弹出成功提示。

立即隐藏只改变 Workspace 的列表投影，不会在活动进程中移动或删除日志；下次冷启动仍会按完整生命周期校验并把日志移入恢复垃圾箱。如果删除请求已写入但归档接口失败，插件会明确提示“已加入队列但暂时无法隐藏”，避免把延迟隐藏误报成删除失败。

也可以继续使用人工命令。删除当前对话：

/delete-conversation CONFIRM

按 Session id 删除另一个对话：

/delete-conversation  CONFIRM

确认成功后重启 DSH。插件在下次启动时把日志移至：

/trash//

目录中的 deletion.json 记录原目录。要恢复时，先停止 DSH，删除恢复目录中的 deletion.json，再把该目录移回 originalDirectory。不要在 DSH 运行时恢复。