dsh-agent-clean

用过 DeepSeek Harness 桌面版的人，有时会遇到子代理面板卡住或状态对不上：条目删不掉、界面仍显示旧数据。根因往往不在「多删几行日志」——v4 会话日志要求 seq 稠密，删行会让整段会话无法加载；而界面又主要从投影缓存里的 subagentCatalog 渲染，只改日志也看不到效果。dsh-agent-clean 针对这类真实故障场景，把经过逆向与回归验证的非破坏性修复流程封装成可重复执行的工具。

核心思路是同时满足加载器与界面所需条件：把会话里属于该会话的子代理/目录事件改写成 catalog-dismissed 并标记 ignorable，把投影缓存写成合法的空目录状态，且绝不删除任何日志行、不改动会破坏身份校验的头部信息。每次写入前默认干跑，真正应用时会做全量备份，并在与真实路径一致的镜像上用桌面端真实加载器自检通过后才落盘；还可扫描并处理「会话目录已删、投影缓存仍残留」的孤立文件。你可以选择纯 CLI 在 DSH 外自行操作，也可安装可选插件半部，在「设置 → 会话清理」里查看各会话子代理条目数量、日志体积与孤立缓存，复制等价命令，或开启默认的「退出后自动清理」在完全退出后由后台助手执行同一套流水线。

适合已经熟悉 ~/.dsh（或 DSH_HOME）里会话与缓存布局、愿意在改文件前先看诊断结果的用户：日常维护、面板去同步后的恢复、批量 dismiss 或按需 purge 整会话、以及清理孤儿缓存。若你坚持手工掌控，关掉自动开关、按页面给出的命令逐步 dry run 再 --apply 即可；若你希望少记命令，记住完全退出 DSH 再重启，让清理在进程不在场时完成，重启后界面才会反映最新状态。