dsh-session-recycler

English | 中文

DeepSeek Harness 的会话管理插件，只支持 Windows。

DSH 删一条对话，删掉的往往只是侧栏那一行；而这条对话到底改过哪些文件，也没人说得清。这个插件补的就是这两件事：

• 删得干净——删除分两段：先移进插件自己的回收站，随时能搬回侧栏原位置；确认不要了再彻底清，连带整条子代理树、侧栏账本、投影缓存、日志里相关的行、只被它引用过的附件，以及被清空后留下的空目录。
• 删得稳——动手前先确认会话已经不在写日志（还在写就拒绝，且整批一条都不动），再逐条校验目标状态；产物里混进系统目录、DSH 数据目录的，直接跳过不删。
• 说得清——右键一条对话，扫出它真正写过的文件（包括它写到工作区外面的那些临时脚本），在资源管理器里多选高亮；也能把完整路径清单交给助手，判断哪些可以删。

---

功能

1. 两段式删除

阶段	做什么	能恢复吗
移入回收站	会话目录整体 rename 进插件回收站（同盘原子操作，不复制）；子代理对话跟着主对话一起搬走；侧栏投影缓存行备份后摘除	能
彻底删除	删掉回收站里的整条对话链，清侧栏账本（sessionIds / 归档 / 置顶）、投影缓存及其 .bak、日志里提到这些会话的行、cache/ 下同名条目、只被它们引用过的附件对象与 files-v3 登记	不能
恢复	目录搬回原工作区绝对路径，投影缓存行写回，会话回到侧栏原来的槽位	—

移入回收站时日志、缓存、附件一律不动，只有彻底删除才连带清理。 工作区里的会话被清空后，空掉的工作区注册也会一并注销，侧栏不会留下一个空分组； 恢复时若该工作区已被注销，会按原路径重新建回来，会话仍然回到原位置。

删除前有三道闸：

1. 会话静止检查——隔 240ms 读两次会话日志的大小与修改时间，还在变说明这一轮没结束，拒绝删除并提示等这一轮结束。检查覆盖整棵子代理树，不只是主对话。
2. 整批预检——勾了多条时，任何一条不合格（正在写入、已不在、已在回收站、不在回收站）就整批拒绝，一条都不动，并说明是哪一条、为什么。
3. 删除范围围栏——产物里出现盘根（D:\）、SystemRoot、Program Files、ProgramData、DSH 数据目录时跳过，并把失败原因如实回报。

2. 会话管理面板

入口有两个：侧栏底部的「会话管理」，以及会话右键菜单里的「移入回收站」。

• 会话按工作区分组，组头可折叠；搜索框按标题或工作区过滤，「全选」作用于当前过滤结果，「全选本组」只作用于那一组
• 每行两行式：标题一行，大小 · 最后活动 · 子代理数一行；悬停或选中才显出「文件信息」入口，列表本身保持安静
• 两个页签（待清理 / 回收站）用下划线切换，各自带数量；勾选互不影响，切页即清空
• 底部只有一行：左边「已选 N 个会话 · 共 X」，右边是这一步能做的动作
• 回收站页的「同时删除文件产物」也收在这一行；识别结果做成可点的小字（3 个文件 · 1.2 MB），点开才是清单，不占版面
• 删除后如实回报：删了几个产物、几个失败、清掉几个空目录；一个都没识别到也会直说，不会让人以为删干净了

3. 打开文件目录

右键会话 →「打开文件目录」：

• 扫描整条对话链（主对话 + 它派生的所有子代理），只统计写操作产生的文件
• 按目录聚类，打开文件最集中的那个目录，并把命中的文件多选高亮
• 提示：已打开目录并高亮 N 个文件；另有 M 个文件在其它目录

右键会话 →「打开所有文件目录」：把散落在所有目录里的产物逐个目录打开并高亮， 不限制目录数。Explorer 操作通过串行队列执行，多个目录不会互相抢焦点。 打开方式可从面板右上角 ⚙ 查看；标签页自动化已停用，只用「多个窗口」。

产物识别的口径（只算产出，不算引用）：

来源	算产物
write / edit 工具调用的 file_path	✅
命令行里的写入目标：> >> 重定向、Set-Content / Out-File、New-Item -Path、Copy-Item / Move-Item 的目标、tar -czf 输出	✅
会话期间被改动过的文件（mtime 兜底）	✅
写在工作区之外的路径（例如会话自己造的 D:\buildtmp\verify-*.ps1）	✅ 照常列出与删除，但受上面第 3 条围栏约束
read / grep / read_image 打开过的文件	❌ 视图引用，不算
只在对话文字里被提到过的路径	❌

工作区之外的产物必须在正文里被完整写出才认得出；只靠 mtime 兜底扫描的，扫的是工作区范围。

4. 文件查询

右键会话 →「文件查询」：扫描这条对话的全部产物，生成一段分析提示词 （文件清单 + 目录分布 + 期望的输出格式），直接填进对话输入框，回车即可让助手 逐个说明文件用途，并归类为缓存 / 对话记录 / 生成文件 / 引用素材，给出哪些可以删。

输入框拿不到时（比如页面结构变了）自动退到剪贴板，粘贴即可。

5. 文件信息：复制当前所有路径

右键会话 →「文件信息」，或会话行右侧的「文件信息」按钮：扫描后在剪贴板里放一份 按类型分好组的完整路径清单——文件产物 / 缓存 / 工作目录 / 网络素材下载 / 对话记录， 分组内去重、按路径排序。粘到哪里都能直接用：搜索框、脚本、别的对话、文本比对工具。

---

安装

用安装包（推荐）

1. 完全退出 DeepSeek Harness（托盘图标右键退出，只关窗口不算）
2. 解压 dsh-session-recycler-<版本>.zip，双击 一键安装-纯PowerShell.cmd
3. 看到「安装完成」后重新打开 DeepSeek Harness，侧栏底部出现「会话管理」即成功

不需要联网，不需要管理员权限，不用自己装 Node 或 npm，只用 Windows 自带的 PowerShell 5.1。

装之前想先确认的话，给 cmd 加参数：

一键安装-纯PowerShell.cmd --check            只检查，不写任何文件
一键安装-纯PowerShell.cmd --dry-run          演练，打印会改什么
一键安装-纯PowerShell.cmd --profile desktop  机器上有多份 profile 时只装指定那份
一键安装-纯PowerShell.cmd --link             用目录链接代替复制（改源码即时生效）
一键安装-纯PowerShell.cmd --home D:\dsh-home 数据目录不在默认位置时指定

安装器只碰两样东西：把插件文件复制进 <profile>\node_modules\dsh-session-recycler\， 以及在 <profile>\package.json 里登记一条依赖和一个 bundle 声明； 改 package.json 之前会备份成 package.json.bak-<时间戳>。

卸载

双击 一键卸载-纯PowerShell.cmd，或：

.\install-dsh-session-recycler-native.ps1 --uninstall

会删掉 node_modules 里那份插件，并撤掉 package.json 里加过的两条登记。 回收站里已删的会话不会被删，它们在 %USERPROFILE%\.dsh\dsh-session-recycler\ 下，要清就手工删。

开发模式

把源码放到 <DSH_HOME>\local-plugins\dsh-session-recycler，在 profile 的 package.json 里登记：

"dependencies": { "dsh-session-recycler": "link:C:/Users/<you>/.dsh/local-plugins/dsh-session-recycler" }
"dsh": { "profile": { "bundles": ["...", "dsh-session-recycler"] } }

link: 是软链，改完重启 DSH 即生效，不用重跑安装。

---

实现要点

• 会话正文是多帧拼接的 zstd，Node 的 one-shot 解压只吐第一帧。这里按帧魔数 28 B5 2F FD 切开逐帧解压，才能拿到完整正文。
• 会话标题在 session/title 事件里，不在用户消息字段，后出现的 provider 标题优先于 fallback。
• 删除后侧栏不消失是宿主内存态没清。删之前要跑一遍销户： agent.cancel({kind:"disposed"}) → agent.scope.dispose() → agents.store.delete() → sessions.flush() → entry.detach() → 兜底 ctx.emit("session/disposed", session)。 少了最后一步，会话会被挪进「未分组」而不是消失。
• 工作区是独立实体（ctx.workspaceRegistry）。detachSession(id) 只从 sessionIds 里过滤掉 id， 工作区注册本身不会因为会话清空而消失，侧栏就会留一个空分组。所以摘完会话后要检查 sessionIds 是否为空，为空才 registry.delete(id)；恢复时若注册已不在，按原路径 registry.create(path) 重建再挂回去。
• 恢复要挂回原槽位：entity.attachSession(id) 是头插，还要 insertSessionBefore(id, anchor) 才能回到原来的位置，锚点取删除时记下的「它后面那个会话」。
• 回收站条目也要记 createdAt：彻底删除时的时间戳兜底扫描以它为基准，早先版本没写这个字段， 导致回收站里那条路永远扫不到东西——现在是写入时记下，老条目则在删除时现场回读成员头部补上。
• 附件清理先算后删：先把待删会话正文里的 sha256 收集起来，再算「还活着」的引用 （活会话 + 回收站里其它未删条目），差集才是能删的；顺序反了会把还能恢复的会话的附件一起删掉。
• 产物识别从正文里用正则抽路径片段（不要求整串是路径），再按会话时间扫工作区补漏； 只保留真实存在、非 node_modules/.git/dist、非工程配置文件、扩展名不在日志缓存黑名单里的普通文件。
• 资源管理器多选高亮走 Shell COM：$win.Document.SelectItem($item, 1)，连续调用是累加。 文件名不能走命令行参数（中文会被编码吃掉），改成 UTF-8 JSON 文件传；子进程也不能 detached， 否则 powershell 被提前结束、窗口根本开不出来。

---

已知限制

• 只在 Windows 上验证过（依赖 explorer.exe 与 Shell COM）。
• 工作区之外的产物，只有在对话正文里写出完整路径时才认得；命令行 cd 之后的相对写入仍可能漏。
• 清空空目录最多向上三层，更深的空壳会留下。
• 会话关联的定时任务不会随会话一起删，需要在「设置 → 定时任务」里单独处理。
• 标签页模式已停用：Windows 资源管理器无法保证自动化焦点安全，误触可能改到文件名。
• 只能安装在 DSH 里，依赖宿主提供的 react 与 @deepseek-ai/dsh-client-ui-primitives。

---

许可

MIT