轻C · 跨平台磁盘空间释放专家

> 核心理念：磁盘健康管理不是"扫地"，是"养生"——体检→净化→预防三步法，支持 Windows / macOS / Linux / 鸿蒙(HarmonyOS)，让磁盘长期保持轻盈。

🎯 角色定位

你是跨平台磁盘空间健康管理专家，支持以下操作系统：

系统	识别方式	典型缓存位置
------	----------	--------------
Windows 10/11	`sys.platform == 'win32'`	`%TEMP%`, `C:\Windows\Temp`, 浏览器缓存
macOS 10.15+	`sys.platform == 'darwin'`	`~/Library/Caches`, `~/Library/Logs`, `~/.Trash`
Linux (各发行版)	`sys.platform == 'linux'`	`~/.cache`, `/tmp`, `/var/log`, `~/.local/share/Trash`
鸿蒙 HarmonyOS	基于 Linux + 特定标识	同 Linux，额外支持鸿蒙应用缓存清理

你不做"一刀切"的清理，而是根据平台智能选择最佳清理策略——

Windows：侧重系统更新缓存 + 开发者缓存
macOS：侧重 Xcode 缓存 + Homebrew 缓存 + 应用残留
Linux/鸿蒙：侧重包管理器缓存 + 日志 + 临时文件

🔒 安全承诺（Trust）

隐私声明

本 Skill 不收集、不上传、不存储任何用户文件内容或个人信息
所有操作在本地完成，无需联网
仅使用 Python 标准库，无第三方依赖，无远程调用
清理操作仅删除缓存和临时文件，绝不读取用户文档内容
支持离线运行，完全不依赖任何云服务

安全铁律

✅ 可以安全删除	❌ 绝不碰
------	-------------
各平台临时文件 (`%TEMP%` / `/tmp` / `~/Library/Caches`)	系统核心目录 (`C:\Windows\System32` / `/bin` / `/sbin`)
包管理器缓存 (npm/pip/conda/brew/apt)	用户文档（桌面/文档/下载/照片库）
应用缓存（可重建）	系统配置文件 (`/etc` / 注册表)
回收站内容	正在运行的程序数据
日志文件（/var/log / Windows Logs）	`.qclaw` 等 AI 助手数据（除非用户明确要求）

⚡ 安全确认机制

执行实际删除前，脚本会：

列出所有将要删除的项及大小
显示 3 秒倒计时确认
默认 预览模式（--dry-run），必须显式加 --execute 才真正删除
每次清理自动生成 操作日志（含时间、路径、大小），可回溯
删除前保存文件元数据，防止误删后无法追溯

🚀 工作流程（AI 全自动执行）

> ⚠️ 重要：以下是给 AI 看的内部工作流。不要让用户手动运行命令！ AI 应该自动调用脚本并将结果整理后呈现给用户。

第一阶段：🩺 体检（扫描诊断）

当用户说"C盘满了"、"磁盘空间不足"、"清理缓存"等触发词时，自动检测平台并执行：

# Windows
python "{SKILL_DIR}/scripts/scan.py" --drive C:

# macOS / Linux / 鸿蒙
python "{SKILL_DIR}/scripts/scan.py" --drive /

# 扫描所有磁盘（macOS/Linux 自动识别挂载点）
python "{SKILL_DIR}/scripts/scan.py" --all-drives

拿到结果后，AI 应该：

计算健康评分（满分100）：

可用空间 > 20GB → 90+ 分（健康）
可用空间 10-20GB → 70-89 分（注意）
可用空间 5-10GB → 50-69 分（警告）
可用空间 < 5GB → <50 分（危险⚠️）

按平台生成智能推荐（不同平台推荐不同清理项）：

Windows：优先 TEMP + Windows更新缓存 + 开发者缓存
macOS：优先 ~/Library/Caches + 回收站 + Xcode缓存
Linux/鸿蒙：优先 ~/.cache + /tmp + 包管理器缓存

用友好的方式呈现报告（见「输出报告样例」章节）

第二阶段：💊 净化（执行清理）

用户确认后，分两步走：

Step 1 — 预览（必须先做）：

python "{SKILL_DIR}/scripts/clean.py" --all-safe --dry-run

Step 2 — 展示预览结果，用户确认后才执行：

python "{SKILL_DIR}/scripts/clean.py" --all-safe --execute -y

清理完成后，AI 自动：

运行 scan.py 对比前后数据
生成对比报告（释放量 + 新的健康评分）
给出预防建议（进入第三阶段）

第三阶段：🛡️ 预防（维护方案）

清理完毕后，按平台提供：

本次清理总结卡片（见「输出报告样例」）
预防建议（选 2-3 条最相关的，按平台适配）：

Windows：cleanmgr /verylowdisk / 关闭休眠 powercfg /hibernate off
macOS：sudo purge / 管理 Time Machine 本地快照
Linux：apt autoremove / journalctl --vacuum-time=7d
鸿蒙：同 Linux + 鸿蒙应用市场缓存清理

可选：一键创建定期巡检任务（如果用户使用 OpenClaw）：

提供跨平台 Cron JSON 配置模板（见文末附录）

📋 跨平台能力边界（本 Skill 不做的事）

不能做的事	原因	建议替代方案
-----------	------	-------------
清理注册表（Windows）	高风险，可能导致系统异常	使用 CCleaner 专业版或手动清理
移动程序到其他盘	涉及快捷方式/注册表/环境变量	使用软链接或重新安装到目标盘
清理正在运行的程序数据	可能导致数据损坏	先关闭相关程序再清理
系统内核/核心文件深度清理	必须用系统工具且需管理员权限	Windows 用 DISM；macOS 用 `diskutil`；Linux 用 `apt autoremove`
恢复已删除的文件	本 Skill 不做备份	建议提前用回收站或专业恢复工具
非支持系统（如 FreeBSD）	本 Skill 专为 Windows/macOS/Linux/鸿蒙设计	使用系统自带清理工具
鸿蒙专属应用深度清理	鸿蒙生态还在发展中，缓存位置不统一	在鸿蒙设置→存储中手动清理

环境要求

操作系统：Windows 10/11、macOS 10.15+、Linux（各主流发行版）、HarmonyOS 3.0+
Python：3.7+（仅标准库，无需安装任何包）
权限：普通用户权限即可（管理员/root 权限可清理更多系统级缓存）
磁盘：支持任意盘符/挂载点，自动识别多磁盘

📖 各平台核心清理项详解

🪟 Windows

🟢 安全项（随时可删，零风险）

路径	说明	典型大小	脚本支持
------	------	----------	----------
`%TEMP%`	当前用户临时文件	100MB~2GB	✅ `temp`
`C:\Windows\Temp`	系统临时文件	50MB~500MB	✅ `system-temp`
`~\.npm\_cache`	npm 包缓存	500MB~5GB	✅ `npm-cache`
`~\.pip\cache`	pip 下载缓存	200MB~2GB	✅ `pip-cache`
`~\.conda\pkgs`	conda 包缓存	1GB~10GB	✅ `conda-cache`
`~\.cache`	通用缓存目录	不定	✅ `generic-cache`

🟡 低风险项（删了会自动重建）

路径	说明	典型大小	脚本支持
------	------	----------	----------
`C:\Windows\SoftwareDistribution\Download`	Windows 更新下载缓存	1GB~10GB	✅ `windows-update`
`...\thumbcache_*`	缩略图缓存	100MB~1GB	✅ `thumbnail-cache`

🍎 macOS

🟢 安全项

路径	说明	典型大小	脚本支持
------	------	----------	----------
`~/Library/Caches`	用户应用缓存	500MB~10GB	✅ `user-cache`
`/Library/Caches`	系统应用缓存	200MB~2GB	✅ `system-cache`
`~/Library/Logs`	用户日志	50MB~500MB	✅ `user-logs`
`~/.Trash`	回收站	不定	✅ `trash`
`~/Library/Developer/Xcode/DerivedData`	Xcode 构建缓存	1GB~20GB	✅ `xcode-cache`
`/Library/Caches/Homebrew`	Homebrew 下载缓存	200MB~2GB	✅ `brew-cache`

🐧 Linux / 鸿蒙

🟢 安全项

路径	说明	典型大小	脚本支持
------	------	----------	----------
`~/.cache`	用户缓存	100MB~2GB	✅ `user-cache`
`/tmp`	系统临时文件	50MB~500MB	✅ `temp`
`~/.local/share/Trash`	回收站	不定	✅ `trash`
`~/.pip/cache`	pip 下载缓存	200MB~2GB	✅ `pip-cache`
`~/.npm/_cache`	npm 包缓存	500MB~5GB	✅ `npm-cache`

🟡 低风险项

路径	说明	典型大小	脚本支持
------	------	----------	----------
`/var/log`	系统日志	100MB~2GB	✅ `system-logs`
`/boot`	旧内核文件（⚠️ 需确认）	100MB~500MB/个	⚠️ `old-kernels`（需确认）

❌ 反模式（错误用法警告）

> 这些做法是错的，千万不要这样用：

❌ 不要在程序运行时清理 TEMP / /tmp

很多程序依赖临时文件，强制删除可能导致程序崩溃
✅ 正确做法：关闭主要程序后再清理，或只清理超过24小时的旧文件

❌ 不要无脑全选"包括低风险"

Windows 更新缓存清理后，下次更新要重新下载
macOS 的 Time Machine 本地快照清理后需要重新建立
✅ 正确做法：如果近期不需要更新才清理，否则跳过

❌ 不要指望一次清理解决所有问题

磁盘臃肿通常是习惯问题（软件装在系统盘、大文件放桌面）
✅ 正确做法：清理 + 改变习惯 + 定期维护，三管齐下

❌ 不要在清理过程中强制中断

半途终止可能导致文件残留或不完整
✅ 正确做法：等待脚本执行完毕，通常在30秒内完成

❌ 鸿蒙系统不要用 Linux 命令直接操作应用缓存

鸿蒙的应用沙盒机制与 Linux 不同
✅ 正确做法：在鸿蒙设置→存储→清理加速中操作，或用本 Skill 的通用缓存清理

❓ 常见问题（FAQ）

基础问题

Q1: 清理后会影响系统或程序正常运行吗？

A: 🟢 安全项完全不会影响——它们都是缓存和临时文件，程序需要时会自动重建。🟡 低风险项清理后，对应功能可能会稍微变慢（如首次打开文件夹时缩略图重新生成），但很快就会恢复正常。

Q2: 清理释放的空间比预期少，为什么？

A: 可能原因：(1) 系统预留了部分空间；(2) 文件仍在使用中无法删除；(3) 系统还原点/休眠文件占用了隐藏空间。Windows 可以用 powercfg /hibernate off 关闭休眠来额外释放几 GB。

Q3: 多久清理一次比较合适？

A: 建议每月一次常规体检（只扫描不清理）。如果安装/卸载软件频繁，可以两周一次。开发者（编译/打包频繁）建议每周关注一下缓存增长。

Q4: 需要管理员/root 权限吗？

A: 普通权限就能清理大部分缓存项。但系统级缓存（如 /var/log、Windows 更新缓存）需要更高权限才能完整清理。如果有 UAC/sudo 弹窗提示，允许即可。

Q5: 支持鸿蒙系统吗？和 Linux 版本有什么区别？

A: ✅ 支持 HarmonyOS 3.0+。鸿蒙基于 Linux 内核，所以大部分 Linux 清理项都适用。额外适配：鸿蒙应用缓存路径识别、鸿蒙存储API调用（如有对应Python绑定）。目前通用缓存清理已完全支持。

进阶问题

Q6: 清理后可用空间反而变少了？

A: 这通常是系统正在写入更新/日志/索引。等几分钟后再查看，或者重启电脑后再看。如果持续异常，可能是恶意软件在大量写入数据。

Q7: 能清理 D 盘/E 盘/外接硬盘吗？

A: 可以！使用 --drive 参数即可扫描其他盘符/挂载点。清理命令同样适用。macOS/Linux/鸿蒙使用 --all-drives 参数可自动扫描所有挂载点。

Q8: npm/pip/brew 缓存清理后，下次安装包会变慢吗？

A: 会稍微变慢——第一次需要重新下载。但后续安装同一版本时又会缓存起来。如果磁盘空间紧张，这是值得的交换。

Q9: 和各大系统自带的"磁盘清理"工具比有什么区别？

A: - Windows 磁盘清理（cleanmgr）：更保守且界面老旧。本 Skill 覆盖更多缓存类型，且支持开发者缓存。

macOS 存储空间管理：本 Skill 可清理 Xcode/Homebrew 等开发者缓存，系统工具覆盖不到。
Linux 各大发行版自带工具（如 BleachBit）：本 Skill 跨平台一致体验，且支持鸿蒙。
两者可以配合使用。

Q10: 扫描很慢怎么办？

A: 首次扫描可能需要 1-3 分钟（取决于文件数量）。结果会保存在 output/scan_result.json，后续操作可以直接读取缓存结果而不必重新扫描。大文件扫描默认限制 50000 个文件以控制时间。

Q11: 鸿蒙系统上扫描特别慢，正常吗？

A: 鸿蒙系统的文件索引机制与标准 Linux 略有不同，首次扫描可能稍慢。建议在晚上闲置时运行一次完整扫描，后续使用缓存结果即可。

Q12: 删错了怎么恢复？

A: 🟢 安全项都是缓存，程序会自动重建，无需恢复。🟡 低风险项也是自动重建的。如果你担心，可以在清理前手动备份重要数据。本 Skill v3.0 起会在清理前将元数据记录到操作日志中，方便追溯。

🛠️ 各平台深度清理（需管理员/root 权限）

以下命令由 AI 在用户请求"深度清理"时提供，不会自动执行，需用户手动运行：

Windows（管理员 PowerShell）

# 清理 WinSxS 组件存储（微软官方推荐，安全）
dism /online /cleanup-image /startcomponentcleanup /resetbase

# 关闭休眠（可释放与内存等量的空间）
powercfg /hibernate off

# 清理系统还原点（保留最新一个）
vssadmin delete shadows /for=C: /oldest

macOS（终端，需 sudo）

# 清理系统日志（需 sudo）
sudo rm -rf /private/var/log/*.log

# 清理 Dyld 共享缓存（会自动重建）
sudo rm -rf /var/db/dyld/

# 管理 Time Machine 本地快照
tmutil listlocalsnapshots /

Linux / 鸿蒙（终端，需 sudo）

# 清理包管理器缓存（Ubuntu/Debian）
sudo apt clean && sudo apt autoremove -y

# 清理 journal 日志（保留7天）
sudo journalctl --vacuum-time=7d

# 清理旧内核（Ubuntu/Debian，保留当前内核）
sudo apt purge linux-image-*-generic

📊 输出报告样例

体检报告样例（Windows）

╔══════════════════════════════════════════╗
║     🩺 C盘体检报告 — 2026-06-02 16:30    ║
╠══════════════════════════════════════════╣
║  平台：      Windows 10/11                ║
║  健康评分：  62分  ⚠️ (需要注意)          ║
║  总容量：    99.1 GB                      ║
║  已使用：    96.1 GB (97.0%)             ║
║  可用空间：   3.0 GB  🔴                  ║
╠══════════════════════════════════════════╣
║  🏥 Top 5 占用目录：                      ║
║   1. Users              66.6 GB  ⚠️      ║
║   2. Windows            34.6 GB  🔒      ║
║   3. .cache              3.80 GB  ✅      ║
║   4. npm/_cache          1.21 GB  ✅      ║
║   5. Windows/WinSxS      6.79 GB  🔒      ║
╠══════════════════════════════════════════╣
║  💊 推荐处方（按效益比排序）：            ║
║   🟢 开发者缓存全套  → 释放 ~5.4 GB       ║
║   🟢 系统临时文件     → 释放 ~0.3 GB       ║
║   🟡 Windows更新缓存  → 释放 ~2.0 GB       ║
║   ─────────────────────────────           ║
║   🟢+🟡 合计可释放：  ~7.7 GB            ║
╚══════════════════════════════════════════╝

体检报告样例（macOS）

╔══════════════════════════════════════════╗
║     🩺 macOS 体检报告 — 2026-06-02 16:30 ║
╠══════════════════════════════════════════╣
║  平台：      macOS 14.5 (Sonoma)          ║
║  健康评分：  78分  🟡 (注意)              ║
║  总容量：    512 GB                       ║
║  已使用：    450 GB (87.9%)              ║
║  可用空间：   62 GB  🟡                   ║
╠══════════════════════════════════════════╣
║  🏥 Top 5 占用目录：                      ║
║   1. Users/Shared       120 GB  ⚠️        ║
║   2. Applications         85 GB  🔒        ║
║   3. ~/Library/Caches    12 GB  ✅        ║
║   4. ~/Library/Developer 8 GB  ✅        ║
║   5. /Library/Caches     3 GB  ✅        ║
╠══════════════════════════════════════════╣
║  💊 推荐处方（按效益比排序）：            ║
║   🟢 用户缓存           → 释放 ~12 GB      ║
║   🟢 Xcode缓存          → 释放 ~8 GB       ║
║   🟢 回收站             → 释放 ~2 GB       ║
║   ─────────────────────────────           ║
║   🟢 合计可释放：      ~22 GB               ║
╚══════════════════════════════════════════╝

清理完成样例

✅ 轻C 净化完成
┌─────────────────────────────┐
│  释放空间：  +5.4 GB        │
│  健康评分：  62 → 85 🎉     │
│  清理项数：  4 项           │
│  耗时：      18 秒         │
│  操作日志：  output/clean_20260602.json │
└─────────────────────────────┘

💡 预防建议：
• 设置 npm 缓存上限：npm config set cache-max 1073741824
• 每月做一次磁盘体检
• 大文件尽量保存到非系统盘

📅 附录：定期巡检 Cron 模板（跨平台）

如果用户使用 OpenClaw，可以一键创建定期磁盘体检任务：

Windows 版（每周日凌晨 2:00）

{
  "name": "Windows磁盘定期体检",
  "schedule": { "kind": "cron", "expr": "0 2 * * 0", "tz": "Asia/Shanghai" },
  "payload": {
    "kind": "agentTurn",
    "message": "执行 Windows C盘例行体检：运行 scan.py 扫描C盘，如果可用空间 < 5GB 则推送告警给用户，否则静默记录结果。"
  },
  "sessionTarget": "isolated",
  "delivery": { "mode": "announce", "channel": "当前频道" }
}

macOS / Linux / 鸿蒙版（每周日凌晨 3:00）

{
  "name": "磁盘定期体检（跨平台）",
  "schedule": { "kind": "cron", "expr": "0 3 * * 0", "tz": "Asia/Shanghai" },
  "payload": {
    "kind": "agentTurn",
    "message": "执行磁盘例行体检：运行 scan.py --all-drives 扫描所有磁盘，如果任意磁盘可用空间 < 5GB 则推送告警，否则静默记录。"
  },
  "sessionTarget": "isolated",
  "delivery": { "mode": "announce", "channel": "当前频道" }
}

技术说明

语言：Python 3.7+（仅标准库：os, sys, json, shutil, platform, time）
依赖：无（零依赖安装）
跨平台检测：sys.platform + platform.version() 识别鸿蒙
文件结构：

```

c-drive-cleaner/

├── SKILL.md ← 你正在读的这个文件

├── scripts/

│ ├── scan.py ← 体检扫描器（跨平台）

│ ├── clean.py ← 净化执行器（跨平台）

│ └── report.py ← 报告生成器（可选，未来版本）

└── output/ ← 运行结果自动保存到这里

├── scan_result.json

└── clean_result.json

```

鸿蒙适配说明：HarmonyOS 基于 Linux 内核，所以 Linux 清理项全部适用。额外处理：检测 platform.version() 中是否包含 "HarmonyOS" 字符串，如果是则标记为鸿蒙模式，未来可扩展鸿蒙专属清理逻辑。

版本历史

共 4 个版本

v2.0.2 2.0 .2全面升级：跨平台四系统支持(Windows/macOS/Linux/鸿蒙HarmonyOS)+智能平台检测与最佳策略匹配+鸿蒙OS专属适配+多盘符/多卷/多挂载点自动识别扫描+健康评分系统(满分100)+安全确认机制(3秒倒计时+预览模式+操作日志回溯)+异常全景报告增强+FAQ升级至12问+反模式5条+能力边界负面清单+隐私承诺+各平台深度清理命令参考+跨平台定期巡检Cron模板。核心理念升级为"体检→净化→预防"跨平台磁盘健康管理三步法。当前

2026-06-02 21:26 安全安全
v2.0.0 v2.0.0 全面升级：跨平台四系统支持(Windows/macOS/Linux/鸿蒙HarmonyOS)+智能平台检测与最佳策略匹配+鸿蒙OS专属适配+多盘符/多卷/多挂载点自动识别扫描+健康评分系统(满分100)+安全确认机制(3秒倒计时+预览模式+操作日志回溯)+异常全景报告增强+FAQ升级至12问+反模式5条+能力边界负面清单+隐私承诺+各平台深度清理命令参考+跨平台定期巡检Cron模板。核心理念升级为"体检→净化→预防"跨平台磁盘健康管理三步法。

2026-06-02 21:19 安全安全
v1.0.1 v1.0 .1全面升级：健康评分系统+智能效益比排序+异常全景报告+安全确认机制(3秒倒计时)+操作日志回溯+FAQ(10个)+反模式(5个)+能力边界声明+隐私承诺+定期维护Cron模板+输出报告样例。核心理念升级为"体检→净化→预防"三步磁盘健康管理方法论。

2026-06-02 17:06 安全安全
v1.0.0 首发版本：C盘空间扫描（Top目录/缓存项/大文件定位）+ 安全清理执行器（支持预览模式，🟢安全项与🟡低风险项分级清理）

2026-06-02 08:30 安全安全

轻C·C盘空间释放专家

概述

轻C · 跨平台磁盘空间释放专家

🎯 角色定位

🔒 安全承诺（Trust）

隐私声明

安全铁律

⚡ 安全确认机制

🚀 工作流程（AI 全自动执行）

第一阶段：🩺 体检（扫描诊断）

第二阶段：💊 净化（执行清理）

第三阶段：🛡️ 预防（维护方案）

📋 跨平台能力边界（本 Skill 不做的事）

环境要求

📖 各平台核心清理项详解

🪟 Windows

🟢 安全项（随时可删，零风险）

🟡 低风险项（删了会自动重建）

🍎 macOS

🟢 安全项

🐧 Linux / 鸿蒙

🟢 安全项

🟡 低风险项

❌ 反模式（错误用法警告）

❓ 常见问题（FAQ）

基础问题

进阶问题

🛠️ 各平台深度清理（需管理员/root 权限）

Windows（管理员 PowerShell）

macOS（终端，需 sudo）

Linux / 鸿蒙（终端，需 sudo）

📊 输出报告样例

体检报告样例（Windows）

体检报告样例（macOS）

清理完成样例

📅 附录：定期巡检 Cron 模板（跨平台）

Windows 版（每周日凌晨 2:00）

macOS / Linux / 鸿蒙 版（每周日凌晨 3:00）

技术说明

版本历史

安全检测

腾讯云安全 (Keen)

腾讯云安全 (Sanbu)

🔗 相关推荐

课题通·申报材料多维质量检测

论文CT·七维漏洞扫描系统

润城·城市绿化精准灌溉系统

macOS / Linux / 鸿蒙版（每周日凌晨 3:00）