Перейти к основному содержимому
D

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.

Установка

dsh plugin --profile web add github:dushiqi1987/dsh-sweeper

README

dsh-sweeper

CI license

静态扫描历史会话里的工具产物,分两档展示;你自己勾选,点「清理选中」批量移到插件回收站,可随时恢复。

怎么用

装好后,DSH 设置的左侧栏出现「清理对话垃圾」。打开它:

  1. 静态读取所有会话的工具执行流(tool/call / tool/result / job/*),不需要模型参与,不产生对话,不花 token。
  2. 建一份产物账本:每个被 write/edit 写过的文件、每个 dsh-spill 落盘文件,记录产生它的会话、轮次、工具、时间,以及之后有没有被工具再次使用。
  3. 与磁盘对账(是否存在、大小、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 走同一套判断。

在别人的电脑上装:

  1. 把整个 dsh-sweeper 目录拷过去(node_modules 不用带,本插件零运行时依赖)。
  2. plugin_manager → install_bundle,target 指向那个目录。
  3. 打开设置左栏的「清理对话垃圾」。

依赖只有两个:目标 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 静态预览

Похожие плагины