- Home
- Plugin
- Strumenti e capacità
- dsh-sweeper
dsh-sweeper
dushiqi1987/dsh-sweeper
Audits the files tool runs leave behind in your workspace: every path written by a write or edit call, plus DSH spill files, is cross-checked against the session logs, the disk and git. Everything untracked that no tool has touched for a week is listed in two tiers, and only the tier you select moves into a restorable trash batch. Report-only by default; the model can suggest extra candidates but five server-side checks gate every suggestion. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.
Installazione
dsh plugin --profile web add github:dushiqi1987/dsh-sweeperREADME
dsh-sweeper
静态扫描历史会话里的工具产物,分两档展示;你自己勾选,点「清理选中」批量移到插件回收站,可随时恢复。
怎么用
装好后,DSH 设置的左侧栏出现「清理对话垃圾」。打开它:
- 静态读取所有会话的工具执行流(
tool/call/tool/result/job/*),不需要模型参与,不产生对话,不花 token。 - 建一份产物账本:每个被
write/edit写过的文件、每个dsh-spill落盘文件,记录产生它的会话、轮次、工具、时间,以及之后有没有被工具再次使用。 - 与磁盘对账(是否存在、大小、mtime),按两档列出:
| 档位 | 条件 |
|---|---|
| 无脑删 | 位于 .scratch/、tmp/、temp/、__pycache__、*.bak 等临时目录(或 %TEMP%/dsh-spill-*),产生后再没被任何工具当文件用过,且最后活动时间早于 7 天前 |
| 不确定 | 同上但之后被工具用过;或产生它的工具调用失败过(半成品);或超过 1 MB |
两条硬规则:
- 一周内被工具用过的,不进列表(只在顶部「保护」里计数)。
- 清理 =
rename进DSH_HOME/plugin-data/dsh-sweeper/trash/<批次>/,并写manifest.json;不调用unlink删用户文件。
路由
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /plugins/dsh-sweeper/report | 报告 JSON(?refresh=1 强制重扫,默认缓存 60s);含一次性 token |
| POST | /plugins/dsh-sweeper/delete | {token, keys, confirmed:true, acknowledge?},把选中项移进回收站 |
| GET | /plugins/dsh-sweeper/trash | 回收站批次列表 |
| POST | /plugins/dsh-sweeper/restore | {batchId},整批恢复 |
| POST | /plugins/dsh-sweeper/purge | {batchId, confirmed:true},永久删除该批次 |
| GET | /plugins/dsh-sweeper/health | 扫描状态 |
POST 必须带 x-dsh-sweeper: 1 头(跨站请求无法携带自定义头,借此挡掉 CSRF);token 与最近一次扫描绑定,过期或重扫后失效;选中「不确定」项时必须 acknowledge: true。
删除前的兜底检查
lib/trash.js 对每个待移动的路径独立复核,任何一条不满足就跳过:
- 必须是绝对路径、不带
..、不在盘符根/一级目录; - 不在
DSH_HOME(sessions / storages / attachments / profiles)或~/.agents之内; realpath必须等于原路径(穿过链接/联接点的拒绝);- 必须是普通文件,大小与 mtime 与扫描时一致(扫描后被改过就跳过);
- 跨卷时退化为「复制 + 删源」,任一步失败就不动原文件。
边界
- 不给模型注册任何工具。
- 不发任何外部网络请求。
- 报告只含路径与元数据,不含对话正文。
模型复核(可选,第三页签)
POST /plugins/dsh-sweeper/review {token, autoDelete?, model?, timeoutMs?, debug?}
把当前扫描结果的摘要(最多 100 条,短编号 i1…iN,只含路径/档位/类型/大小/闲置天数/是否失败)交给宿主模型服务(ctx.get('llm'),默认取 agentDefaultModel.currentSelection(),本机是 opencode-go / deepseek-v4.1-flash),让它逐行回答:
D i12 → 删
K i30 → 留
Q i24 问题 → 问用户
约束(提示词 + 代码双层):
- 模型只能引用编号,输不出文件操作;插件侧不做 shell、不拼命令行、不执行模型给的任何字符串。
- 返回里
tier === 'safe'的D才会自动进回收站;tier === 'unsure'的D一律降级为「询问用户」。 - 编号对不上的(乱编、大小写变体、路径回显)进
unknown,直接丢弃(fail-closed)。 - 模型调用失败 → 502,一个文件都不动。
- 所有「删」都是
rename进回收站,可在「回收站」页签整批恢复。
调用方也可不开自动清理:autoDelete: false 只返回建议,由前端按钮逐条确认。
让模型顺便「发现」新垃圾
除了给定候选,插件还会把已知临时目录里从没出现在任何会话日志中的旧文件(.scratch/、tmp/、__pycache__/、dsh-spill-* 内,深度 3,跳过 node_modules/.git/.venv/dist/build 等,只取 7 天前修改的)作为 B 段清单 x1…xN 一起交给模型,让它分两类:
A x12 → 可以直接清理(无脑删档)
S x30 → 可选清理(有价值但可删,交给用户勾选)
K x44 → 留着
返回的每一项都要过 vetProposals() 复检才会展示:key 必须在本轮 hints 里、lstat 必须是普通文件且不是链接、大小与 mtime 未变(±2s)、不超过 50 MB、git ls-files 确认未跟踪。没过的进 extra.rejected 并在界面上折叠显示,不会被执行。
- 前端:
extra.sweep给一个「清理这 N 项」按钮;extra.optional是复选框,勾完才走/delete {extra:true}。 - 想连这部分也自动清:
/review {extraAuto: true}(默认关)。 - 扫描范围硬限制:系统临时目录整根不扫(
%TEMP%里有别的程序的文件),只认dsh-spill-*这种 DSH 自己建的目录;含 U+FFFD 或[object的坏路径直接丢弃。
移植到别的电脑
代码里没有任何绝对路径、没有用户名、没有盘符假设。所有根目录都是运行时算出来的:
| 用途 | 来源 |
|---|---|
| DSH 主目录 | $DSH_HOME,没设就是 ~/.dsh |
| 回收站 | <DSH 主目录>/plugin-data/dsh-sweeper/trash(自动创建) |
| 候选路径 | 从目标机器自己的会话日志里解析,不预置任何目录 |
| 临时目录根 | os.tmpdir(),并且整根不扫,只认其中的 dsh-spill-* |
| 模型 | 目标机器的 agentDefaultModel.currentSelection() |
lib/paths.js 统一处理分隔符、大小写、盘符与 POSIX 路径,Windows / macOS / Linux 走同一套判断。
在别人的电脑上装:
- 把整个
dsh-sweeper目录拷过去(node_modules不用带,本插件零运行时依赖)。 plugin_manager→install_bundle,target 指向那个目录。- 打开设置左栏的「清理对话垃圾」。
依赖只有两个:目标 DSH 版本要提供 sessionPersistence / webServer / settings.section(缺了会在插件加载时报错,不会静默);git 是可选的,没有它只是 gitTracked 那一道校验变成「未知」,其余四道照旧。
上线硬化(v1.0)
- 并发:同一时刻只允许一次扫描、一次模型复核,重复请求返回
409。 - 令牌:
token与「当前这一份报告」绑定;报告不重建就不换 token,多次 GET 可以共用一个 token;重扫或恢复后自动作废。 - 缓存:
GET /report默认复用 60 秒内的结果(?refresh=1强制重扫);缓存判定用首次发布时间,不会因为反复刷新而永不重扫。 - 恢复:
restore会逐条校验 manifest 里的原始路径(绝对盘符、无..、不落在~/.dsh、~/.agents、回收站自身),失败条目保留在批次里,全部成功才删批次目录。 - 复制完整性:跨卷搬运后校验目标大小与原文件一致,不一致就反向搬回并报错。
- 错误可见:服务端异常写入
/report.lastError与/health.error,页面顶部显示可重试的错误卡片。 - 接口约定:所有写接口要求
x-dsh-sweeper: 1头;/delete还需token+confirmed:true;勾选包含「不确定」项时再加acknowledge:true。
自测
仓库自带两套检查,git push 后由 GitHub Actions 在 Node 14.21.3 / 20 / 22 三个版本上跑:
node --check lib/*.js test/harness.js scripts/selfcheck.mjs # 语法
node scripts/selfcheck.mjs # 清单 + 补丁 + 语言文件
cd test && npm install && npm test # 12 个 UI 状态的 SSR 冒烟
selfcheck 检查的是商店和 dsh plugin add 真正会看的东西:dsh.bundle.patch 存在、cordis.patch.yml 里有 insert 且有 id/name(且 name 等于包名)、exports 与 files 里的路径都真实存在、两份 locale 都有 meta.title 与 meta.description。任何一个不满足就退出码非 0。
CI 里还有一步 npm pack 后检查 tarball 里确实有 package/cordis.patch.yml —— 这一条最容易在「本地能装、发出去装不上」时踩到。
Node 14 是特意留着的:宿主运行时就是 v14.21.3,插件在这上面必须能 import(node: 前缀、??=、可选链这些都不能越界)。
额外的手工预览(不在 CI 里,需要本机装过 DSH):
cd uitest && npm i && node harness.js # 同 test/,路径指向本仓库
node preview.js # 生成 ../preview.html 静态预览
Plugin correlati
archify (deepseek-harness)
tt-a1i/archify
WeKnora (dsh-weknora)
tencent/weknora
next-ai-draw-io (dsh-plugin)
dayuanjiang/next-ai-draw-io
weknora
tencent/weknora