前言¶
用 DSH NEXT 做智能体或日常对话时，侧边栏里的会话会随时间累积：标题相近、跨工作区难找、想批量归档或按时间清理时，往往只能逐条点选，删错或漏备份的风险也更高。系统自带的会话列表侧重打开与继续，对「看清来源与占用状态、按规则保留、确认后再删」的支持有限。
下面介绍社区插件 DSH Chat Prune（仓库 Cans518/dsh-chat-prune）。它在 DSH NEXT 侧边栏提供单条删除与「管理对话」入口，并在执行删除或批量操作前提供预览、可选备份与逐条结果反馈。
这是什么¶
DSH Chat Prune 是由维护者 Cans518 发布的 DSH 社区插件，分类为客户端。定位是：为 DSH NEXT 整理对话——统一查看、批量归档、按规则保留，确认后修剪。
插件与 DSH 官方无隶属关系；安装与使用前应自行查看仓库源码与 MIT License。插件在当前 dsh 进程权限下运行，删除与备份均作用于本机数据目录，安装前请确认来源可信。
核心功能¶
以下能力均来自项目 README 中的功能说明。
| 能力 | 说明 |
|---|---|
| 侧边栏入口 | 删除单条对话，或从底部打开管理窗口；适配侧边栏展开与折叠 |
| 搜索与筛选 | 按标题、工作区、会话 ID、来源、状态、更新时间和大小查找 |
| 批量管理 | 跨页选择，批量归档、取消归档、置顶、取消置顶或删除 |
| 保留规则 | 每个工作区保留最近 N 条，并可只选择早于指定天数的候选记录 |
| 多来源管理 | 合并多个 DSH 数据目录；连接各自本机宿主后统一操作 |
| 预览与备份 | 执行前核对完整目标清单，逐条反馈结果，可停止尚未开始的操作 |
| 主题适配 | 跟随宿主浅色、深色和自定义主题 |
数据行为要点： 归档保留记录；删除会移除本地记录。单条删除默认不备份；批量删除默认勾选备份。开启备份时，备份失败则不删除；备份保存在对应数据目录的 deleted-sessions/。置顶、运行中、无法安全释放、记录缺失或时间未知的对话在按规则修剪时受保护。
运行环境¶
安装前请对照 README 中的环境说明。
- 系统： 在线删除当前仅支持 Windows；README 写明 macOS / Linux 暂不支持在线删除。
- 宿主： DSH NEXT，需要客户端插件、工作区服务和会话持久化服务。
- 安装工具： 桌面版自带的
dsh命令。 - Node.js： 安装包已含构建产物，普通用户无需本地编译；
package.json中engines.node为>=20，开发建议 Node.js 24。
package.json 中 engines.dsh 为 >=0.2.0-rc.2 <0.3.0；宿主接口可能随版本变化，边界细节见仓库内 technical-reference.md。
安装与启用¶
先做 profile 初始化：启动一次 DSH NEXT，再从系统托盘正常退出。然后使用桌面版提供的命令安装（README 给出的 Release 包地址，当前示例版本为 v0.5.0）：
dsh plugin --profile desktop add https://github.com/Cans518/dsh-chat-prune/releases/download/v0.5.0/dsh-chat-prune-0.5.0.tgz
重新打开 DSH 即可使用。安装包已包含构建产物，安装时会自动启用插件，无需克隆仓库、编译或手动添加 YAML 挂载条目。
若从 Releases 下载 .tgz 与 SHA256SUMS.txt 校验后本地安装：
dsh plugin --profile desktop add "C:\Downloads\dsh-chat-prune-0.5.0.tgz"
终端找不到 dsh 时，先在 DSH NEXT 桌面版中启用命令行入口并重新打开终端。使用 Web profile 时将 desktop 换成 web，并安装到实际使用的 profile。
卸载（不会恢复已删记录，也不会清理已有备份）：
dsh plugin --profile desktop remove dsh-chat-prune
典型用法¶
删除一条对话¶
展开左侧工作区，将鼠标移到具体会话行，点击垃圾桶。核对目标与备份设置后确认删除；按 Escape 或点「取消」可放弃。
批量整理¶
- 点击侧边栏底部的「管理对话」。
- 搜索或筛选记录，选择本页或全部筛选结果。
- 选择归档、置顶或删除等操作，点击「预览所选操作」。
- 核对完整目标清单后再确认执行；结果逐条显示，可停止尚未开始的操作。
按规则修剪¶
在管理窗口点击「保留规则」，例如设置「每个工作区保留最近 10 条，只修剪早于 30 天的记录」，生成候选后预览并确认。「最近 N 条」按每个来源中的整个工作区计算。
多来源连接、筛选规则、备份配置与常见问题见仓库 使用指南；恢复步骤见技术说明中的备份与恢复章节。
适用场景与注意¶
适合谁： 长期在 DSH NEXT 中积累大量会话、需要按工作区或时间批量归档/删除、或希望合并多个本机 DSH 数据目录统一管理的 Windows 用户。
务必注意：
- 删除由数据目录所属宿主执行，并检查会话写入所有权；正在运行或无法安全释放的会话会被拒绝。
- 未连接宿主的额外来源只读展示；移除来源设置不会删除对话。
- 更新插件前正常退出 DSH，并另存自己修改过的插件配置；按新 Release 说明执行
dsh plugin --profile desktop add <新安装包地址>后重新打开 DSH。
社区插件目录为独立站点，与 DeepSeek / 幻方无官方从属关系；选用插件时请自行评估权限与数据安全。
延伸阅读¶
DSH Chat Prune 把「看清再删、规则保留、批量预览」收进侧边栏与管理窗口，适合在 DSH NEXT 里做定期会话整理；具体行为以仓库 README 与版本 Release 为准。
