dsh-session-delete

为 DeepSeek Harness 的侧栏会话菜单增加永久删除操作，支持中文和英文。

在会话行的操作菜单中选择 删除会话，核对名称后点击 永久删除。正在执行任务的会话会被拒绝删除，插件不会强制停止任务。

删除后无法恢复。当前正式版本为 1.1.0，仅支持 DSH 0.2.1-rc.2。下载与更新说明见 v1.1.0 Release。

兼容性

会话状态	原版 DSH	安装本仓库生命周期补丁的 DSH
未加载的空闲历史会话	可以删除	可以删除
已打开或已恢复的空闲会话	拒绝删除	标准 Agent 会话安全关闭后删除
任务执行中、维护中或有待处理输入	拒绝删除	拒绝删除

只安装插件不会给 DSH 增加关闭会话的能力。 要删除已加载的空闲会话，需要额外应用 DSH 生命周期补丁。补丁针对固定版本源码，尚未合入上游；不支持关闭的第三方 Agent 会明确拒绝删除。

所有删除都要求单个 DSH Host 独占会话、缓存和工作区存储。多个 Desktop、Web 或 CLI 实例共用一套存储不受支持。

安装

在 DSH 的插件页面添加本地仓库路径，或使用 Git 地址：

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

启用插件后，在对应 Profile 的 cordis.patch.yml 中添加：

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

Desktop 默认配置位于 ~/.dsh/profiles/desktop/cordis.patch.yml；设置了 DSH_HOME 时使用对应目录。完成后重启 DSH Host；Desktop 用户可退出并重新打开应用。

singleHost 默认关闭，关闭时插件不会执行删除。只有确认存储由一个 Host 独占后才应启用；这是使用者的声明，不会自动检测其他进程，也不提供跨进程保护。

使用

1. 打开侧栏会话行的操作菜单，选择 删除会话。
2. 在确认框中核对会话名称和不可恢复提示。
3. 点击 永久删除。成功后，会话从列表移除；删除当前查看的会话时，页面回到新会话入口。

取消、Escape 或点击遮罩可以关闭尚未执行中的确认框。删除进行中会禁用重复提交和关闭操作。失败时保留确认框，分开显示失败原因及必要的数据状态。

删除范围

插件会清理目标会话的：

• 已识别的 JSONL 持久化日志。
• 当前会话投影缓存。
• Workspace 关联、置顶和归档记录。

用于上游写锁的 session.lock 和空目录会保留。工作区中的项目文件、导出副本、外部备份、附件及第三方插件数据不在清理范围内。

删除不是跨文件事务。路径不明、符号链接、异常存储结构、写入占用或无法确认的生命周期状态都会导致拒绝。共享存储和不遵守 DSH 生命周期的第三方后台写入不在支持范围内。

删除失败时

提示或情况	处理方式
会话正在运行	等待任务结束后重试；已归档也不代表没有活动任务
当前 DSH 不支持关闭已加载会话	安装生命周期补丁，或重启 Host 后在重新打开目标会话前删除
会话关闭或持久化失败	不继续文件删除；检查 DSH 日志，处理问题并重启 Host 后重试
部分清理失败	数据可能已部分删除；排除存储或 Workspace 错误后重试同一会话
请求中断或响应无效	结果未知；刷新核对，不能据此认为数据仍然完整
已删除，但列表刷新失败	点击 重试刷新，只重试客户端同步

同一 Host 内，同一会话的并发请求会合并处理。可安全重试清理，但这不等于删除具有原子性；必要步骤全部完成后才报告成功。

验证与限制

当前代码已有以下实测记录：

• 补丁版 Desktop 删除已打开的空闲会话：列表、日志、缓存及 Workspace 关联清理，重启后未回弹，其余对照日志哈希不变。
• 隔离 Host 验证空闲删除、活动拒绝、持久化关闭失败时保留数据，以及失败后的重启重试。
• 最新确认框使用实际客户端代码进行隔离预览，检查中文、英文长标题、活动拒绝提示和 Escape。新版排版尚未完成 Desktop 回归。

详情见 Desktop 记录、验收报告 和 补丁说明。文档中的历史测试数量不代表当前仓库仍提供对应测试套件。

目前仍依赖固定版本的部分内部缓存及 Workspace 接口，不保证其他 DSH 版本兼容。生命周期补丁只等待 DSH 能追踪的关闭工作和返回的 Promise，无法保证第三方脱离生命周期的后台任务已停止。本地 Desktop 补丁使用本机签名，后续官方更新可能覆盖它。

开发检查

npm ci
npm run check
npm run pack:check

CI 在 Linux/macOS、Node.js 22.19.0/24 上执行语法和 npm 打包检查。自动化测试套件及其 CI 步骤已按维护要求移除；以上命令不验证删除行为。行为验收应使用隔离临时目录。

上游接口分析及后续建议见 源码审查、API 提案 和 未提交的 Issue 草稿。

English

Adds Delete session to the DeepSeek Harness sidebar with Chinese and English UI. The 1.1.0 release supports DSH 0.2.1-rc.2 only. See the release and downloads.

Stock DSH supports deletion of unloaded idle sessions. Deleting a loaded idle session requires the separate lifecycle patch; updating this plugin alone does not patch DSH. Running tasks, maintenance, pending input and unsupported owners are refused without forced cancellation.

Install from a local path or the Git URL above, enable the plugin, and declare singleHost: true in the Profile patch only when one Host exclusively uses the storage. Restart the Host afterward. Shared storage is unsupported; this setting does not detect or lock out other processes.

Deletion permanently removes recognized session logs, the current projection cache and Workspace/pin/archive records. Lock files, empty directories, project files, attachments, exports, backups and third-party data remain. Partial cleanup is retryable but not atomic. A lost response means an unknown outcome; a confirmed deletion with a failed list refresh offers refresh-only retry.

Basic checks are npm ci, npm run check and npm run pack:check. The automated test suite has been removed. These checks do not establish deletion correctness; see the linked acceptance records for actual runtime verification and its limits.

License

MIT © 2026 huy8000