dsh-disk-cleaner：DSH 侧边栏磁盘清理插件。左侧是项目名与一句话说明——先量出每个目录占多少，再让模型排出优先级和理由，勾选即清理；下面是 C 盘 93.6%（剩 13 GB）、D 盘 77.4%（剩 62 GB）两个用量环。右侧是真实扫描结果的面板复现：表头含模型选择器与 7.2 秒耗时，清理项列出回收站 1.1 GB（谨慎）、用户临时文件 512 MB（安全）、pnpm 存储 7.9 GB（仅提示），底部显示已选 2 项、预计释放 1.6 GB。

点开侧边栏，AI 帮你判断 C / D 盘哪些能删，勾选即清，并逐项回报释放的空间。

它不问你「要不要清」，而是先量出每个目录到底占多少，再让当前默认模型排出优先级和理由。你只需要看一眼、勾一下。

DSH 插件 · Windows 10 / 11 · Host 6 路由 · Client 2 槽位 · 204 项断言

安装

npm install @dencee/dsh-disk-cleaner

或在 DSH 的插件管理页里按包名安装。安装后侧边栏出现磁盘图标。

需要 DSH 0.2.x 与 Windows 10 / 11。

一次真实扫描

在这台 C 盘只剩 13 GB 的机器上跑一遍：

指标	实测
扫描耗时	7.2 秒
发现清理项	21 项
C 盘	已用 93.6%（200 GB 里剩 13 GB）
D 盘	已用 77.4%（275.8 GB 里剩 62 GB）

排在最前面的几项：

清理项	体积	风险
pnpm 存储	7.9 GB	仅提示
回收站	1.1 GB	谨慎
Gradle 缓存	1.1 GB	谨慎
Edge 缓存	519 MB	安全
用户临时文件	512 MB	安全
npm 缓存	258 MB	安全

体积是真跑出来的，不是估算——每个目录都限时遍历了一遍。上表里勾选「回收站」与「用户临时文件」两项，确认框会写明共释放 1.6 GB；hero 与流程图里的数字都取自这一次扫描。

怎么用

四个步骤沿一条竖脊推进：打开面板即自动扫描；7.2 秒量完 21 项目录体积，模型同时给出优先级与理由，此时列表已可勾选；勾选确认时推荐项已预选、确认框写明释放量；清理后逐项回报释放量与失败原因，本例回收站 1.1 GB 加临时文件 512 MB 共释放 1.6 GB。

左侧边栏点磁盘图标（在「插件」「定时任务」之后）。
面板打开即自动扫描 + 分析，不用点任何按钮；表头右侧的「模型」可选排序用哪个模型。
扫描完成后逐项勾选 —— AI 推荐的项默认已勾上。
点「清理选中项」，确认框里写明项数与预计释放量。
结果逐项列出释放量，失败项给出原因。

「重新扫描」随时重跑。「仅提示」的项目不可勾选，只给正确做法。

选模型

表头的「模型」下拉按 provider 分组列出宿主当前可用的模型。换模型只重排，不重新扫盘：同一批清理项、同一套勾选，只是换一个模型给优先级和理由。

模型自己声明了多档推理强度时，右侧多一个「强度」下拉；没声明就不显示。
选择记在本机，下次打开面板自动沿用；没选过就用宿主的默认模型。
选中的模型被移除后，面板退回默认模型，并在建议条里写明「谁排的序」，不会假装还是原来那个。

列表什么时候可以勾

扫描一结束列表就能勾，不等 AI。模型排序是并行的：它回来之前你先勾的项不会丢，回来之后也不会覆盖你的选择——只有在你什么都没动的情况下，它才会把推荐项打上勾。

慢盘上扫描可能算不完（机械硬盘、杀毒正在扫描）。这种条目仍然会显示，带「未完整统计」标签，再扫一次通常会算全，而不是从列表里消失。

动效只有一个目的：让你看见发生了什么

面板不动的时候是静的。四处动效各自对应一个状态变化，都不是装饰：

时机	动的东西	为什么
打开面板	各区块按阅读顺序错开 45ms 落位，只跑一次	面板是你刚点开的目的地
扫盘 / 清理中	一个旋转弧，不确定进度	遍历目录没有已知长度，不能编百分比
AI 排序落地	换了位置的行从旧位置滑到新位置；理由行的强调点跟着冒出来	顺序变了要看得见原因，不是瞬间换一张表
清理完成	释放总量从 0 数到目标值，结果卡落下	这个数字是你要的结果，看着它长起来才像「结果」

行的位移用 FLIP：改完布局后量每行的真实位置，差值反向施加再释放，所以不同行高（带路径的、带理由的）也算得准，不是假设统一行高。两处细节是刻意的：

没动的行不参与动画。整张列表每次刷新都抖一下比不动更糟。
prefers-reduced-motion: reduce 下位移和计数直接跳过，只保留最终状态；计数也不用中间帧，直接写目标值。

清理项

清理项不是写死的产品清单，而是按结构发现的。同样的代码在不同用户的电脑上会找出不同的软件。

分类	怎么找	风险
临时文件	`%TEMP%`、`%WINDIR%\Temp`、每个固定盘的 `Temp/tmp`	安全
回收站	每个固定盘的 `$RECYCLE.BIN`	谨慎
系统缓存	Windows 更新缓存、传递优化、字体缓存、日志与转储、Prefetch	安全 / 谨慎
系统旧数据	`Windows.old`、`$WINDOWS~BT`	高级
显卡缓存	遍历 `%LOCALAPPDATA%` 找 NVIDIA / AMD / D3D 的着色器缓存目录	安全
错误报告	WER 错误报告与崩溃记录	安全
浏览器	遍历 `%LOCALAPPDATA%`，凡符合 `<产品>\<配置>\Cache` 结构的都算 —— 不认产品名	安全
工具链	按生态分组发现：Node / Python / Rust / JVM / .NET / Go / Dart / Ruby / PHP / IDE	安全 / 谨慎
大文件	各盘 ≥300 MB 的用户数据，逐个可选	谨慎
仅提示	pnpm store、休眠文件、WinSxS、系统还原点	—

为什么是"发现"而不是"清单"

第一版按我知道的软件写死：6 个浏览器（Chrome、Edge、Brave、Vivaldi、360、QQ）、8 个工具链。那就是开发这台电脑上装的东西——换个人用 Opera、Arc、Yandex、Whale、UC 浏览器，或写 Flutter、Go、Ruby，全都漏掉。

现在的规则是结构而非名单：

浏览器：<产品>\User Data\<配置>\Cache 这个形状就是 Chromium 系，*\Profiles\*\cache2 这个形状就是 Firefox 系。发现逻辑在测试里被验证能找出 Opera / Yandex / Whale / Arc / Chromium / UCBrowser —— 这些名字源码里一个都没有。
盘符：不再写死 C–K，而是读系统真实的固定磁盘列表。装在 L: 的盘、或只有 C: 的电脑都正确。
工具链：按生态分组，新增一个工具只需在模式表加一行，不必再写一份清理项。

本机实测：自动发现了 Doubao（一个带 Chromium profile 的桌面应用）—— 这是写死清单时根本不知道存在的。

本机没装对应软件时该项目不出现。C:\Windows 与 ProgramData 下需要提权的目录读不了时标**「当前无权限读取」**，而不是假装 0 MB。

大文件只找用户数据。.exe/.dll/.asar/.node/.wasm/.sys/.pak 等扩展名，以及 Program Files、Windows、node_modules、resources\app、.git、.dsh\profiles 下的文件一律不列出——删除 app.asar 是卸掉一个应用，不是回收垃圾。

安全

五道护栏依次过滤：名称白名单跳过 dsh-*、node-compile-cache、chrome_* 等 21 类活目录；六小时 mtime 门槛；占用探测跳过被其他进程打开的文件；程序文件过滤使 .exe/.dll/.asar 永不列出；边界校验拒绝相对路径、磁盘根、受保护系统目录与用户主目录。底部注明 pnpm store 永不自动删除，正确做法是 pnpm store prune。

临时文件不是「删光 %TEMP%」

%TEMP% 里住着正在运行的程序的工作目录。其中 dsh-spill-* 是 DSH 保存工具完整输出的地方——删掉会直接打断正在进行中的会话。所以临时清理有三重保护：

保护	作用
名称白名单	`dsh-`、`node-compile-cache`、`chrome_`、`jest_`、`pnpm-` 等 21 类活目录跳过
6 小时 mtime 门槛	不是 1 小时。一个 40 分钟前启动的会话，可以有 2 小时前创建的目录
占用探测	被其他进程打开的文件/目录跳过，报为「占用中」而非失败

为什么 pnpm store 只提示、不删除

%LOCALAPPDATA%\pnpm\store 是 pnpm 的内容寻址存储，可能是已装包里每个文件的同一份数据。删掉它的后果不是「下次下载慢一点」：

之后任何一次 pnpm install 都要全量重下整个依赖图；
若某个依赖的上游 tarball 已失效，安装会在 pnpm 已 prune 之后失败；
node_modules 因此残缺，profile 里所有插件一起挂掉。

所以它只出现在「仅提示」里，正确做法是 pnpm store prune（只删无引用的包）。pnpm-cache 元数据缓存是独立的一项，可以删，只影响下载速度。

删除边界

浏览器只发清理项 id，不发路径；路径表在 Host 端固定
assertSafeTarget 拒绝：相对路径、磁盘根、受保护系统目录、用户主目录
不跟随符号链接与 junction
清理前弹确认框，写明项数与预计释放量
路由走宿主自己的 /api 信任围栏，无 Connection 服务时退回严格回环 + 同源校验

实现

半部	内容
Host	`/api/disk-cleaner` 6 条路由：`health` / `volumes` / `models` / `scan` / `analyze` / `clean`
Client	`sidebar.panellist` 图标 + `main` 面板，纯 `createElement`，样式只用 `--dsw-alias-*` 主题令牌

扫描用 fs.statfs 读容量、限时遍历测目录体积，三路测量并发跑。/models 把 llm.listProviders() + llm.listModels() + resolveModelInfo() 折成面板用的模型目录（含模型自带的推理强度档位）——某个 provider 列不出模型就单独记为失败，不影响其它 provider。/analyze 接受显式的 provider / model / reasoningEffort，缺省或模型已被移除时退回 agentDefaultModel.currentSelection()，并在回复里回报真正跑的模型。模型回复按 JSON 解析——解析失败、回复被代码围栏包住、或压根没挂模型，都会自动退回按体积排序，不会卡住面板。

测试

node test/smoke.mjs     # 真实扫描本机，含 AI 解析三种分支
node test/models.mjs    # 模型目录、显式选择、失效回退、无 llm 部署    28 项
node test/guards.mjs    # 信任围栏、参数校验、删除边界        18 项
node test/render.mjs    # 面板真实渲染：扫描→排序→勾选→清理→换模型→动效   56 项
node test/safety.mjs    # pnpm store 保护、临时白名单、程序文件过滤  86 项
node test/audit.mjs     # 目录审计：路径重叠、可达性、测量=删除、不穿透链接
node test/portable.mjs  # 可移植性：模拟陌生浏览器/无软件/嵌套目录的电脑  16 项
node dev/verify-strings.mjs  # 与上次提交逐字对照，确认中文文案没被改写

全部通过。safety.mjs 与 audit.mjs 在临时沙箱里验证「面板显示要删的量 = 实际删掉的量」，portable.mjs 在沙箱里造出别的用户电脑，都不动真实文件。

本地开发

想改代码时，把检出目录通过 link: 依赖挂到 desktop profile：

"@dencee/dsh-disk-cleaner": "link:<检出目录>"

改完后执行一次「插件」页里的开关（关 → 开），或重启 GUI，即生效。

许可

MIT

点开侧边栏，AI 帮你判断 C / D 盘哪些能删，勾选即清，并逐项回报释放的空间。

它不问你「要不要清」，而是先量出每个目录到底占多少，再让当前默认模型排出优先级和理由。你只需要看一眼、勾一下。

DSH 插件 · Windows 10 / 11 · Host 6 路由 · Client 2 槽位 · 204 项断言

安装

npm install @dencee/dsh-disk-cleaner

或在 DSH 的插件管理页里按包名安装。安装后侧边栏出现磁盘图标。

需要 DSH 0.2.x 与 Windows 10 / 11。

一次真实扫描

在这台 C 盘只剩 13 GB 的机器上跑一遍：

指标	实测
扫描耗时	7.2 秒
发现清理项	21 项
C 盘	已用 93.6%（200 GB 里剩 13 GB）
D 盘	已用 77.4%（275.8 GB 里剩 62 GB）

排在最前面的几项：

清理项	体积	风险
pnpm 存储	7.9 GB	仅提示
回收站	1.1 GB	谨慎
Gradle 缓存	1.1 GB	谨慎
Edge 缓存	519 MB	安全
用户临时文件	512 MB	安全
npm 缓存	258 MB	安全

怎么用

左侧边栏点磁盘图标（在「插件」「定时任务」之后）。
面板打开即自动扫描 + 分析，不用点任何按钮；表头右侧的「模型」可选排序用哪个模型。
扫描完成后逐项勾选 —— AI 推荐的项默认已勾上。
点「清理选中项」，确认框里写明项数与预计释放量。
结果逐项列出释放量，失败项给出原因。

「重新扫描」随时重跑。「仅提示」的项目不可勾选，只给正确做法。

选模型

模型自己声明了多档推理强度时，右侧多一个「强度」下拉；没声明就不显示。
选择记在本机，下次打开面板自动沿用；没选过就用宿主的默认模型。
选中的模型被移除后，面板退回默认模型，并在建议条里写明「谁排的序」，不会假装还是原来那个。

列表什么时候可以勾

慢盘上扫描可能算不完（机械硬盘、杀毒正在扫描）。这种条目仍然会显示，带「未完整统计」标签，再扫一次通常会算全，而不是从列表里消失。

动效只有一个目的：让你看见发生了什么

面板不动的时候是静的。四处动效各自对应一个状态变化，都不是装饰：

时机	动的东西	为什么
打开面板	各区块按阅读顺序错开 45ms 落位，只跑一次	面板是你刚点开的目的地
扫盘 / 清理中	一个旋转弧，不确定进度	遍历目录没有已知长度，不能编百分比
AI 排序落地	换了位置的行从旧位置滑到新位置；理由行的强调点跟着冒出来	顺序变了要看得见原因，不是瞬间换一张表
清理完成	释放总量从 0 数到目标值，结果卡落下	这个数字是你要的结果，看着它长起来才像「结果」

没动的行不参与动画。整张列表每次刷新都抖一下比不动更糟。
prefers-reduced-motion: reduce 下位移和计数直接跳过，只保留最终状态；计数也不用中间帧，直接写目标值。

清理项

清理项不是写死的产品清单，而是按结构发现的。同样的代码在不同用户的电脑上会找出不同的软件。

分类	怎么找	风险
临时文件	`%TEMP%`、`%WINDIR%\Temp`、每个固定盘的 `Temp/tmp`	安全
回收站	每个固定盘的 `$RECYCLE.BIN`	谨慎
系统缓存	Windows 更新缓存、传递优化、字体缓存、日志与转储、Prefetch	安全 / 谨慎
系统旧数据	`Windows.old`、`$WINDOWS~BT`	高级
显卡缓存	遍历 `%LOCALAPPDATA%` 找 NVIDIA / AMD / D3D 的着色器缓存目录	安全
错误报告	WER 错误报告与崩溃记录	安全
浏览器	遍历 `%LOCALAPPDATA%`，凡符合 `<产品>\<配置>\Cache` 结构的都算 —— 不认产品名	安全
工具链	按生态分组发现：Node / Python / Rust / JVM / .NET / Go / Dart / Ruby / PHP / IDE	安全 / 谨慎
大文件	各盘 ≥300 MB 的用户数据，逐个可选	谨慎
仅提示	pnpm store、休眠文件、WinSxS、系统还原点	—

为什么是"发现"而不是"清单"

现在的规则是结构而非名单：

浏览器：<产品>\User Data\<配置>\Cache 这个形状就是 Chromium 系，*\Profiles\*\cache2 这个形状就是 Firefox 系。发现逻辑在测试里被验证能找出 Opera / Yandex / Whale / Arc / Chromium / UCBrowser —— 这些名字源码里一个都没有。
盘符：不再写死 C–K，而是读系统真实的固定磁盘列表。装在 L: 的盘、或只有 C: 的电脑都正确。
工具链：按生态分组，新增一个工具只需在模式表加一行，不必再写一份清理项。

本机实测：自动发现了 Doubao（一个带 Chromium profile 的桌面应用）—— 这是写死清单时根本不知道存在的。

本机没装对应软件时该项目不出现。C:\Windows 与 ProgramData 下需要提权的目录读不了时标**「当前无权限读取」**，而不是假装 0 MB。

安全

临时文件不是「删光 %TEMP%」

保护	作用
名称白名单	`dsh-`、`node-compile-cache`、`chrome_`、`jest_`、`pnpm-` 等 21 类活目录跳过
6 小时 mtime 门槛	不是 1 小时。一个 40 分钟前启动的会话，可以有 2 小时前创建的目录
占用探测	被其他进程打开的文件/目录跳过，报为「占用中」而非失败

为什么 pnpm store 只提示、不删除

%LOCALAPPDATA%\pnpm\store 是 pnpm 的内容寻址存储，可能是已装包里每个文件的同一份数据。删掉它的后果不是「下次下载慢一点」：

之后任何一次 pnpm install 都要全量重下整个依赖图；
若某个依赖的上游 tarball 已失效，安装会在 pnpm 已 prune 之后失败；
node_modules 因此残缺，profile 里所有插件一起挂掉。

所以它只出现在「仅提示」里，正确做法是 pnpm store prune（只删无引用的包）。pnpm-cache 元数据缓存是独立的一项，可以删，只影响下载速度。

删除边界

浏览器只发清理项 id，不发路径；路径表在 Host 端固定
assertSafeTarget 拒绝：相对路径、磁盘根、受保护系统目录、用户主目录
不跟随符号链接与 junction
清理前弹确认框，写明项数与预计释放量
路由走宿主自己的 /api 信任围栏，无 Connection 服务时退回严格回环 + 同源校验

实现

半部	内容
Host	`/api/disk-cleaner` 6 条路由：`health` / `volumes` / `models` / `scan` / `analyze` / `clean`
Client	`sidebar.panellist` 图标 + `main` 面板，纯 `createElement`，样式只用 `--dsw-alias-*` 主题令牌

测试

node test/smoke.mjs     # 真实扫描本机，含 AI 解析三种分支
node test/models.mjs    # 模型目录、显式选择、失效回退、无 llm 部署    28 项
node test/guards.mjs    # 信任围栏、参数校验、删除边界        18 项
node test/render.mjs    # 面板真实渲染：扫描→排序→勾选→清理→换模型→动效   56 项
node test/safety.mjs    # pnpm store 保护、临时白名单、程序文件过滤  86 项
node test/audit.mjs     # 目录审计：路径重叠、可达性、测量=删除、不穿透链接
node test/portable.mjs  # 可移植性：模拟陌生浏览器/无软件/嵌套目录的电脑  16 项
node dev/verify-strings.mjs  # 与上次提交逐字对照，确认中文文案没被改写

全部通过。safety.mjs 与 audit.mjs 在临时沙箱里验证「面板显示要删的量 = 实际删掉的量」，portable.mjs 在沙箱里造出别的用户电脑，都不动真实文件。

本地开发

想改代码时，把检出目录通过 link: 依赖挂到 desktop profile：

"@dencee/dsh-disk-cleaner": "link:<检出目录>"

改完后执行一次「插件」页里的开关（关 → 开），或重启 GUI，即生效。

许可

MIT

denceee/dsh-disk-cleaner

安装

一次真实扫描

怎么用

选模型

列表什么时候可以勾

动效只有一个目的：让你看见发生了什么

清理项

为什么是"发现"而不是"清单"

安全

临时文件不是「删光 %TEMP%」

为什么 pnpm store 只提示、不删除

删除边界

实现

测试

本地开发

许可

Community comments

denceee/dsh-disk-cleaner

安装

一次真实扫描

怎么用

选模型

列表什么时候可以勾

动效只有一个目的：让你看见发生了什么

清理项

为什么是"发现"而不是"清单"

安全

临时文件不是「删光 %TEMP%」

为什么 pnpm store 只提示、不删除

删除边界

实现

测试

本地开发

许可

Community comments