前言¶
DeepSeek Harness (DSH) 采用插件化架构，方便扩展能力。在 Windows 环境下，C 盘空间不足通常不是因为简单的垃圾文件，而是缓存、索引、模型等本该放在别处的内容堆积。直接删除 IDE 索引或虚拟磁盘会带来重建成本甚至数据丢失风险。
dsh-windows-c-cleanup 插件通过「扫描 → 五级分级 → 生成报告 → 用户确认 → 分层执行/迁移」的流水线，将清理变成一条可审计的操作链路。
核心功能¶
插件提供以下核心能力：
- 扫描：按规则库和热点目录进行全盘扫描。
- 五级分级：将清理项分为可安全删除、谨慎删除、建议迁移、保护名单、长期防护五级，并附带判定理由。
- 可视化报告：生成 Markdown 或 JSON 格式的报告，展示释放空间与趋势。
- 分层执行：支持安全层批量执行与谨慎层逐项确认。
- 迁移与回滚：支持将缓存迁移至其他盘，并在原位置保留目录联接（junction），支持一键回滚。
- 历史趋势与 JSON 报告：记录历史扫描数据，对比空间变化。
- 定时扫描与告警：支持定时任务，在空间不足时触发告警。
- Web GUI 面板：通过 Web 界面完成「看懂 → 勾选 → 预演 → 执行」的全流程。
安装与启用¶
推荐使用 npm 安装，因为自带构建产物，无需本地编译。安装后需重启 DSH 才能生效。
dsh plugin --profile web add dsh-windows-c-cleanup
若需钉住特定版本：
dsh plugin --profile web add dsh-windows-c-cleanup@0.5.2
典型用法¶
插件注册了 disk_cleanup 工具，常用参数如下：
action：必填。scan（扫描）、apply（执行）、migrate（迁移）等。scope：hotspots（仅测热点）或full（全盘 Top-N）。dryRun：默认true。预演模式，不实际删除文件。grade：按层级选择范围（safe、caution、migrate）。
常见操作示例：
// 1. 扫描 C 盘
{ "action": "scan", "scope": "full" }
// 2. 安全层预演（不删文件）
{ "action": "apply", "grade": "safe" }
// 3. 迁移到 D 盘
{ "action": "migrate", "items": ["C:\\Users\\..."], "targetDrive": "D" }
// 4. 永久删除（需关闭 dryRun）
{ "action": "apply", "items": ["..."], "mode": "permanent", "dryRun": false }
适用场景与注意¶
适用场景：
* Windows 环境下 DSH 运行空间不足。
* 需要审计清理操作，避免误删关键文件。
* 希望将缓存迁移至其他盘以长期节省 C 盘空间。
注意事项：
* 插件不是「一键删缓存」脚本，而是把清理拆成可审计的流水线。
* 安装后必须重启 DSH 才能加载。
* 迁移时目标盘必须与源盘不同，否则拒绝执行。
* 迁移操作会在原位置保留 junction 联接，确保应用无感。
* dryRun 默认为 true，执行前请务必检查报告。
* GitHub 直装需要构建审批，推荐直接使用 npm 安装。
总结¶
该插件为 DSH 在 Windows 环境下提供了标准化的磁盘管理能力。通过分级机制和迁移策略，用户可以在保证安全的前提下，有效释放系统盘空间。
