前言¶
在 DSH 里做开发或跑智能体时，本机磁盘常被缓存、残留和大文件占满，却又不希望用「一键删光」类工具直接永久删除。系统自带存储管理往往只给容量数字，缺少分档建议、审计与撤销。DeepClean MyDisk 是挂在 DSH 侧边栏的原生磁盘插件：扫描阶段只读，清理阶段只移动文件到废纸篓或隔离区，永久删除需二次确认且限于本插件移入的批次。下面介绍它的定位、能力与安装用法。
这是什么¶
DeepClean MyDisk（npm 包名 deepclean-mydisk）由 huangxiaoliang 维护，分类为 DSH 客户端插件，支持 macOS 与 Windows（Linux 宿主有分支但未验收）。它在 DSH 面板内提供实时容量、体检扫描、分类清理、空间分析、相似照片、跨盘移动、历史恢复，以及只读的 AI 解读入口；AI 不参与扫描与写操作，清理判断仍以面板分档与二次确认为准。
仓库：huangxiaoliang/deepclean-mydisk-plugin
目录页：SkillHub 插件页
核心功能¶
体检与清理¶
打开面板即可看到实时容量，不必先跑完体检。支持快速扫描与完整扫描，结果分为推荐清理、可选清理、需确认、受保护四档；受保护与只读项不可勾选，「需确认」项不会自动勾选。清理页按 7 类内容组织：开发缓存、浏览器缓存、应用缓存、应用残留、聊天软件缓存、其他缓存、系统缓存（Windows 的聊天软件专项分类与应用缓存扫描能力与 macOS 不完全一致，详见下文限制）。
移入废纸篓（macOS）或隔离区（Windows）不会立即释放空间；要在历史中永久删除本批次后才真正释放，且永久删除需二次确认。单次超过 200 项时服务端自动分片，每片独立批次、可统一撤销；扫描结果超过 10 分钟会过期并禁用清理。
空间与相似照片¶
「空间」以家目录为范围做目录分布（环形图、面包屑、下钻）与大文件列表，可筛选、排序，并支持把大文件移动到其他磁盘（移动不可撤销）。相似照片基于 dHash，扫描 Pictures / Downloads / Desktop / Documents，最多 600 张、单张至少 200 KB；云盘目录与照片图库会跳过。
历史、保护与 AI¶
历史页记录扫描趋势、隔离区/废纸篓占用、可恢复批次与永久删除；审计日志在 $DSH_HOME/deepclean-audit.log，历史数据在 $DSH_HOME/deepclean-history.json。设置页可维护保护名单（绝对路径及其子目录永不进入清理允许集合）、权限检查与中英切换。
AI 辅助为只读：体检解读、逐项解释、清理前复核、大文件「这是什么」、失败诊断与趋势分析等，仅把面板已算好的脱敏数据注入当前 DSH 会话；无可用会话时降级为复制提示词。
安装与启用¶
插件要求 DSH 版本在 >=0.2.1-rc.5 <0.3.0-0 范围内（见 package.json engines.dsh）。当前 npm 版本为 0.12.1，许可证 MIT。
先做 profile 选择，再执行下面之一（安装或修改 host/client 代码后需要重启 DSH）：
# 从 npm 安装（推荐；预构建，无构建步骤）
dsh plugin --profile <name> add deepclean-mydisk
# 或从 GitHub 安装
dsh plugin --profile <name> add github:huangxiaoliang/deepclean-mydisk-plugin
# 或在本地开发目录安装（改动即时映射）
dsh plugin --profile <name> add link:/绝对路径/deepclean-mydisk-plugin
平台依赖与权限¶
- macOS：系统自带
python3，扫描依赖du/plutil/sips；需「完全磁盘访问」才能扫全受保护路径，未授权时不扫描。 - Windows：
py -3（或python），扫描与照片解码为纯 Python + PowerShell.NET，不需要 Pillow；部分系统目录清理需管理员权限。
缺失本机 Python 3 时，扫描与权限检查不可用。
典型用法¶
- 安装并重启 DSH 后，从侧边栏打开 DeepClean MyDisk；在设置页完成权限检查（macOS）与保护名单配置。
- 在「体检」查看实时容量，按需选择快速或完整扫描；根据四档结果进入「清理」，用搜索、排序与「选择推荐项」勾选后二次确认，文件进入废纸篓/隔离区。
- 若要真正释放空间，到「历史」对对应批次永久删除（再次确认）；误删可用「恢复此批次」（跨重启可用）。
- 在「空间」下钻目录或筛大文件；跨盘移动前确认目标盘空间，注意云盘与 App 数据目录不可移动。
- 需要文字说明时，在体检或清理项上使用 AI 入口；仍以面板分档与确认为准。
界面入口对照：
| 入口 | 内容 |
|---|---|
| 体检（首页） | 实时容量、扫描与建议、AI 解读、扫描选项、向导、最近整理 |
| 清理 | 分类垃圾清理与相似照片 |
| 空间 | 目录分布与大文件 |
| 历史 | 趋势、隔离区/废纸篓、扫描历史、恢复与永久删除 |
| 设置 | 安全说明、双语、保护名单、权限、环境信息 |
适用场景与注意¶
适合在 DSH 日常使用中顺带做磁盘体检、可控清理与空间分析，尤其适合希望「先移走、可撤销、再决定是否永久删」的流程。插件以当前 DSH 进程权限运行；安装前应阅读仓库源码与 MIT 许可证，自行评估路径与数据风险。
务必知晓的安全边界（摘要）：扫描与查询只读；清理与移动默认只移动；只接受最近 10 分钟内的扫描结果；保护名单、符号链接、云盘与 App 数据目录由宿主二次校验。企业自建网盘可通过环境变量 DEEPCLEAN_CLOUD_ROOTS 补充云盘根路径。
已知限制包括：Windows 永久删除后可用空间可能因卷影副本短暂滞后；相似照片范围与格式受系统解码限制；撤销仅针对会话内批次时与「历史恢复」行为不同；AI 依赖当前会话且可能答错。完整列表见仓库 README「已知限制」。
问题反馈请开 GitHub Issues；安全问题勿公开 Issue，按 SECURITY.md 私下联系维护者。
结尾¶
DeepClean MyDisk 把「只读体检 + 可撤销清理 + 空间与照片整理」收进 DSH 侧边栏，并与 DSH 会话中的只读 AI 解读衔接，适合不想离开 Harness 就管理本机磁盘的用户。更多细节见仓库 DETAIL.zh.md 与 CHANGELOG.md。
- 目录页：https://www.skillhub.cn/plugins/huangxiaoliang/deepclean-mydisk-plugin
- GitHub：https://github.com/huangxiaoliang/deepclean-mydisk-plugin
