前言¶

DeepSeek Harness (DSH) 采用插件化架构。在日常使用中，清理无效会话或对错误的 AI 回复进行补救是常见需求。dsh-session-delete 插件通过扩展侧栏菜单和消息交互，提供了彻底的会话删除能力（清理日志、工作区、内存实例及界面行）以及消息重试功能。

核心功能¶

该插件提供以下主要能力：

1. 侧栏会话删除：在侧栏会话行「…」菜单中新增「删除此会话」选项，支持永久移除会话日志目录、工作区归属、宿主内存实例以及客户端列表行。
2. 消息重试：在用户消息与 AI 回复的复制按钮右侧添加「重试」按钮，点击可将输入重新提交给模型。
3. 批量清理：支持批量删除会话（单次最多 200 个），并支持清理失效行（sweep）。
4. 运行保护：对运行中的会话进行双重拒绝（服务端与客户端），防止误删。
5. 回收站配置：支持通过配置项控制删除模式（trashMode），可选择直接永久删除或进入回收站。

安装与启用¶

本插件依赖 DSH 0.2.x 或更高版本。将插件目录放入工作区，执行以下命令：

install_bundle target: <本目录绝对路径>

执行后，插件会将自身打包进当前 profile，并自动加载。若插件未自动生效，需重启 DSH。

使用方法¶

删除会话¶

在侧栏会话行点击「…」，选择「删除此会话」，在弹窗中确认即可。运行中的会话无法删除。

批量删除¶

1. 点击侧栏「工作区」标题右边的「批量删除」进入批量模式。
2. 勾选需要删除的会话行（支持官方搜索与分组筛选）。
3. 点击「确认删除」执行永久删除。

重试消息¶

在用户消息或 AI 回复的复制按钮右侧，点击刷新图标进行重试。此操作仅重发文本内容，不重发附件。

配置说明¶

插件支持可选配置项 trashMode，用于控制删除行为：

- insert:
    - id: session-delete
      name: dsh-session-delete
      config:
        trashMode: purge

• purge（默认）：直接永久删除会话产物，不可恢复。
• recycle：优先进入系统回收站，失败时降级至插件回收区。

注意事项¶

1. 不可恢复：默认 purge 模式下删除不可恢复，需还原时请设置 trashMode: recycle 并使用 @mzzsfy/dsh-session-manager 等工具找回。
2. 运行保护：运行中的会话无法删除，这是服务端与客户端的双重限制。
3. 无 peer 依赖：不声明任何 @deepseek-ai/dsh-* peerDependencies，兼容性判定仅依赖 DSH 版本。
4. 仅支持非运行中会话：sweep 功能仅针对产物已不存在的会话进行列表清理。