前言¶
DeepSeek Harness (DSH) 采用插件化架构,会话的生命周期管理(归档、删除)通常需要手动操作或依赖 UI 交互。dsh-session-delete 插件通过命令行接口,将归档区与回收站的管理流程标准化,并提供了稳定的列表编号与关键字过滤功能,便于批量操作。
插件概述¶
名称:tangbingbinging/dsh-session-delete
维护者:TANGBINGBINGING
类别:记忆
定位:DeepSeek Harness (DSH) 会话生命周期管理插件,提供归档区与回收站的命令行管理能力。
核心功能¶
-
归档区管理 (
/t-archive)- 查看归档列表(按工作区分组)。
- 恢复会话。
- 将会话删除至回收站。
- 彻底清除(永久删除)。
-
回收站管理 (
/t-restore)- 查看回收站列表。
- 恢复会话至原工作区。
- 删除回收站中的会话。
- 清空回收站。
-
列表编号与过滤
- 稳定编号:列表编号在刷新后保持稳定,被操作的项目会留下空槽位(
————),便于识别。 - 关键字优先:输入关键字时,若唯一匹配则直接操作;若匹配多个,则生成临时列表,需通过
--kw操作。
- 稳定编号:列表编号在刷新后保持稳定,被操作的项目会留下空槽位(
-
多工作区支持
- 归档列表覆盖所有工作区。
- 回收站为全局。
- 恢复操作会自动将会话放回其原始工作区。
-
安全机制
- 拒绝删除正在进行中的会话(标记为
[运行中])。
- 拒绝删除正在进行中的会话(标记为
安装与启用¶
通过官方命令安装:
dsh plugin --profile web add github:TANGBINGBINGING/dsh-session-delete
安装后重启 DSH(npx @deepseek-ai/dsh web),即可在输入框中使用相关命令。
典型用法¶
列出归档:
/t-archive
恢复归档会话:
/t-archive 1 3
删除归档会话至回收站:
/t-archive --delete 1 3
永久删除归档会话:
/t-archive --delete --purge 1 3
关键字恢复(唯一匹配):
/t-archive "特定主题"
操作临时关键字列表:
/t-archive "关键词" # 生成临时列表
/t-archive --kw 1 # 在临时列表中操作第 1 项
回收站操作:
/t-restore # 列出回收站
/t-restore 1 # 恢复回收站第 1 项
/t-restore --delete 1 # 彻底删除回收站第 1 项
/t-restore --clear # 清空回收站
注意事项¶
- Bundle 架构:该插件为
dsh.bundle.patch类型,安装后会自动注册,无需手动在cordis.patch.yml中添加insert条目。 - 语言环境:默认输出中文。如需英文输出,需设置环境变量
DSH_LANG=en。 - 依赖要求:运行环境需 Node.js >= 20。
- 输入解析:支持数字(列表项)、
session-xxx格式的 ID 以及任意文本(关键字),解析与语言无关。 - 安全限制:带有
[运行中]标记的会话无法被删除。
结语¶
该插件为 DSH 用户提供了标准化的会话清理流程,配合稳定的列表编号与关键字过滤,能有效提升会话管理的效率。更多细节与源码可查阅 GitHub 仓库。