前言¶

在 Windows 上腾磁盘，常见做法是系统自带「磁盘清理」或第三方一键删。前者覆盖面有限，后者往往直接删除，路径一长就很难判断某个缓存目录是否仍被程序使用。DeepSeek Harness（DSH）把能力拆成插件后，可以在 Harness 里挂一个本地工作台：先扫描、再解释、最后由用户确认。下面介绍社区插件 dsh-disk-cleanup（维护者 miyunmoshi，分类 admin-security），它把「分析」和「清理」拆开——扫描阶段只读，清理阶段先移入隔离区而不是立刻永久删除。

这是什么¶

dsh-disk-cleanup 是面向 Windows 的 DSH 磁盘空间分析与安全清理插件，npm 包名 dsh-disk-cleanup，当前版本 0.2.2（MIT）。安装后左侧栏会出现「磁盘清理」入口，打开即完整本地工作台。

扫描、分类和风险判定在插件本地完成；Harness 里的 AI 助手可以在会话中解读扫描结果（每个候选文件的用途、来源、为何可清理、风险等级与建议），避免不了解用途就误删。插件不会把文件内容或路径上传到网络服务。

核心功能¶

扫描与展示¶

• 只读扫描：用户与 Windows 临时目录、AppData 缓存、浏览器缓存、更新残留、卸载残留线索、日志与崩溃转储、开发工具缓存、Windows 日志、回收站说明、大文件与重复文件等（详见 README「扫描范围」）。
• 可多盘同时扫描：系统盘深度扫描；其他盘仅扫常见缓存、日志、临时、更新与残留目录，不遍历用户文档或游戏内容。
• 多盘结果先按盘符（C:、D:、E: 等）分区，再按应用与类别展示；可点击盘符标题收起或展开。
• 按类别与「垃圾类型」筛选（缓存、日志、残留、安装更新、临时、重复、大文件、回收站）；每条记录带用途说明、清理原因、风险等级与建议。
• 文件说明中可显示常见中文应用名与公司/厂商名，并保留应用原名（例如：微信（腾讯 / WeChat））。

卸载残留线索¶

插件对照 Windows「已安装程序」登记：目录长期未更新、登记中无匹配项，且仍含缓存、日志、安装包或更新文件时，列为「疑似卸载残留」。这类条目风险固定为「需复核」，默认不勾选；含 save、savedata、.sav 等存档标记的目录按用户数据保护，不会当作残留。

清理方式：隔离区¶

用户勾选并确认后，文件移入隔离区，可在隔离区恢复，或二次确认后永久删除以释放空间。系统盘隔离路径为 %LOCALAPPDATA%\DSH Disk Cleanup\Quarantine；其他盘为该盘根目录 $DSH-Disk-Cleanup\Quarantine，以保证移动在同一磁盘内完成。

清理只接受当前扫描结果中的候选，并重新校验路径、大小与修改时间；路径不在允许目录、已变化、为符号链接或受保护系统目录时会拒绝。

安全边界（摘要）¶

• 扫描不写入、不移动、不删除任何文件。
• 插件接口只监听或接受本机回环地址请求，并校验随机会话令牌与同源请求。
• 用户文件、OneDrive 同步目录、应用配置、系统关键目录、回收站与恢复数据不会自动处理；Windows 日志会标注「谨慎」后列出。
• 清理浏览器或应用缓存前建议先退出对应程序；占用中的文件会在结果中报告，不会强杀进程。

扫描有时间、候选数量与哈希预算上限；达到上限时结果标记为「部分完成」。重复文件使用 SHA-256，哈希预算最多 1.5 GB。

安装与启用¶

已抓取 README 未给出独立的 CLI 安装命令行；按 DSH「一切皆插件」的用法，应在 Harness 的插件管理 中从社区目录安装本插件（目录页：https://www.skillhub.cn/plugins/miyunmoshi/dsh-disk-cleanup）。package.json 要求 Node >= 22。

安装后刷新 Harness 页面；桌面版若仍看不到「磁盘清理」入口，重启一次应用。安装前应自行查看 GitHub 源码与 MIT 许可证；插件以当前 DSH 进程权限运行，权限过大时扫描与移动范围会随之扩大。

典型用法¶

经过上面的安装与刷新，可按 README 步骤操作：

1. 在左侧栏点击「磁盘清理」。
2. 在「扫描磁盘」卡片中勾选要扫描的磁盘，点击「开始全面扫描」。
3. 扫描完成后，在左侧选择类别，或用顶部「垃圾类型」下拉框筛选，并展开应用分组。
4. 点击文件名查看详细用途、应用原名、公司或厂商和清理原因；需要时在会话中请 AI 解读列表。
5. 勾选要处理的文件，或使用「全选安全项」「选中当前筛选」。
6. 点击底部「移入隔离区」，阅读确认提示后执行。
7. 在「隔离区」中恢复文件，或在确认无误后永久删除以释放空间。

本地持久化路径（便于排查）：

%LOCALAPPDATA%\DSH Disk Cleanup\last-scan.json          # 上次扫描摘要与候选清单
%LOCALAPPDATA%\DSH Disk Cleanup\Quarantine\...\manifest.json
%LOCALAPPDATA%\DSH Disk Cleanup\quarantine-roots.json   # 其他盘隔离批次索引
# 其他盘示例：E:\$DSH-Disk-Cleanup\Quarantine\批次目录\

适用场景与注意¶

适合：主要在 Windows 上使用 DSH、希望先看清「删的是什么」再释放空间、并需要多盘与开发/浏览器缓存等常见垃圾类型梳理的用户。

注意：

• 仅 Windows；非 Windows 环境不适用。
• 疑似卸载残留只是登记未匹配的线索，便携软件也可能无登记，务必人工复核。
• 在 Harness 插件管理中卸载本插件时，隔离区目录不会自动删除；确认无需恢复后可手动删除 %LOCALAPPDATA%\DSH Disk Cleanup。
• SkillHub 社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-disk-cleanup 把 Windows 磁盘清理做成 DSH 内的本地工作台：只读扫描、可解释候选、隔离区可恢复，适合在 Harness 里结合 AI 解读再做决定。更多信息见目录页 skillhub.cn/plugins/miyunmoshi/dsh-disk-cleanup 与仓库 github.com/miyunmoshi/dsh-disk-cleanup。