前言¶
在 DeepSeek Harness（DSH）里管理对话时，官方只提供「归档」：会话从导航里藏起来，但日志和缓存仍留在本机磁盘。做本地清理、换机前删敏感会话，或单纯不想留归档垃圾时，单靠归档不够。
社区插件 dshx-session-delete（维护者 callaumyan-design，分类：客户端）在侧边栏每个会话的「…」菜单里增加 「删除对话」，并在 host 端提供 DSH 本体没有的删除接口，把归档后的数据从磁盘上清掉。下面介绍它做什么、怎么装、怎么用，以及删除失败时的行为。
这是什么¶
dshx-session-delete 是一个 DSH 客户端向插件：纯 JavaScript，无构建步骤。它在 Web / Desktop profile 下向工作区 UI 注入菜单项，并注册 POST /dshx-session-delete/delete，由 host 停止残留活动后永久删除会话日志目录与投影缓存。
DSH 生态强调「一切皆插件」；插件目录在 SkillHub 等社区站点展示，与 DeepSeek / 幻方无官方从属关系。安装前建议自行查看 GitHub 仓库 源码与 MIT 许可证——插件以当前 dsh 进程权限运行。
核心功能¶
- 侧边栏入口：在每个会话的 「…」菜单 中增加 「删除对话」（相对官方仅有归档的补足）。
- 两步删除流程（用户确认后）：
- 先通过官方 workspace API 停止并归档该会话，使其从导航中移除；
- 再请求POST /dshx-session-delete/delete，由 host 端清理并永久删除日志目录与投影缓存。 - 失败时的安全行为：若第 2 步失败，会话仅保持归档状态，可在「显示已归档」中找回，不会出现「删了一半又找不到」的中间态。
- 不可恢复：删除是永久的，没有回收站（README 中已明确警告）。
在 DeepSeek Harness 0.2.0-rc.2（desktop / web profile）上开发和使用；package.json 中当前版本为 1.2.2。
安装与启用¶
按你使用的 profile 选择一条命令（须使用资料中的完整命令，含 --profile）：
# Web profile
dsh plugin --profile web add github:callaumyan-design/dshx-session-delete
# Desktop（使用 DSH Desktop 自带的 dsh 命令；安装前先从托盘完全退出 Desktop）
dsh plugin --profile desktop add github:callaumyan-design/dshx-session-delete
安装后重启 DSH（marketplace 元数据标明 requiresRestart: true）。
卸载：
dsh plugin --profile <profile> remove dshx-session-delete
将 <profile> 替换为 web 或 desktop。
典型用法¶
无需额外配置文件或环境变量；安装并重启后即可在 UI 中操作。
- 在侧边栏找到要删的会话，打开该会话旁的 「…」菜单。
- 选择 「删除对话」，在确认对话框中确认（请知悉删除不可恢复）。
- 插件先归档会话，再调用 host 删除接口；若删除接口失败，到 「显示已归档」 中仍可看到该会话。
host 侧删除由插件注册的 POST /dshx-session-delete/delete 完成，一般用户只需通过菜单操作，无需手写 HTTP 请求。
适用场景与注意¶
适合：需要在本机彻底移除某次 DSH 对话及其磁盘痕迹的用户；与官方「只归档、不删盘」的默认能力形成互补。
注意：
- 删除永久，无回收站；误删无法通过 DSH 恢复。
- 插件以安装它的
dsh进程权限访问文件系统；不信任的插件不应随意安装，应先审源码。 - 第 2 步失败时数据仍在归档状态，可再次尝试删除或手动处理归档会话。
- GitHub 星标为 0（截至资料抓取时），不代表质量结论，仅作生态规模参考。
结尾¶
dshx-session-delete 用一条侧边栏菜单和 host 删除端点，把「从列表隐藏」和「从磁盘清掉」拆开又串成可靠流程：先归档保底，再永久删除；失败则留在归档里可找回。
