disk-manager

Disk Manager 是一个面向工作区环境的磁盘空间管理技能，强调在优先回收空间的同时不危及用户数据。

用途 当用户提出以下需求时可使用该技能：检查磁盘占用、清理存储、移除缓存与构建产物、归档不活跃项目，或自动化周期性清理策略。

安全模型 技能将扫描结果分为三个等级，并按此方式呈现：

• 可安全删除：缓存与字节码，包括 pycache、.pytest_cache、.mypy_cache、.ruff_cache、*.pyc。
• 可重建：依赖与构建输出，包括 node_modules、dist、build、.next、target。
• 需人工确认：任何用户创作或可能不可替代的内容。 未经明确确认，绝不删除第二级或第三级内容。

核心工作流

1. 先扫描：运行 scripts/scan_workspace.py 生成分类后的可清理项。
2. 展示 dry-run 影响：运行 scripts/safe_cleanup.py --dry-run，让用户看到预计可回收的字节数。
3. 执行已批准的清理：安全清理运行 scripts/safe_cleanup.py；项目归档运行 scripts/archive_project.py --project <name>。
4. 操作后验证：重新运行扫描器，报告回收前后的空间情况。

命令

1. 全工作区扫描 python3 skills/disk-manager/scripts/scan_workspace.py （使用 --json 输出机器可读结果）

2. 安全清理 dry-run python3 skills/disk-manager/scripts/safe_cleanup.py --dry-run （使用 --json 输出机器可读结果）

3. 执行安全清理 python3 skills/disk-manager/scripts/safe_cleanup.py （使用 --json 输出机器可读结果）

4. 归档不活跃项目 python3 skills/disk-manager/scripts/archive_project.py --project my-project

报告格式 向用户报告时，始终包含：扫描到的总工作区字节数、按等级划分的可回收字节数、占用最大项的确切路径、预计释放字节数（dry-run）或已验证释放字节数（清理后）。输出保持简洁且可操作，并始终把建议与已执行操作分开呈现。

参考 分级与防护规则见 references/cleanup-policy.md。