关联主题:: Skills索引
同级::
下一级::

005｜硬盘小浣熊 Skill（Disk Raccoon）

一句话说明

硬盘小浣熊是一个面向 macOS 缓存清理的安全辅助 Skill：先只读检查磁盘空间和缓存分布，再用缓存地图区分“可安全清理、需要谨慎、不要触碰”的路径；只有在用户确认后才执行清理，并优先采用可恢复方式。

处理边界

它只处理可再生的缓存，不负责卸载应用、优化系统或清理未知数据。登录状态、消息数据库、聊天记录、密钥链、配置数据和无法确认用途的路径，默认不处理；它也不能替代备份和用户对重要数据的判断。

1. 基本信息

字段	内容
Skill 编号	005
展示名称	硬盘小浣熊
英文名称	Disk Raccoon
功能定位	只读诊断 macOS 缓存，按安全等级判断可清理范围，并在用户确认后优先用可恢复方式清理
适用平台/场景	macOS 磁盘空间不足、开发工具缓存过大、浏览器缓存排查、Telegram/飞书/微信等应用缓存检查
类型	开源
许可证	MIT
当前状态	已安装（Codex 本机）
调用方式	直接描述“磁盘满了”“帮我看看缓存”“Chrome 占用太大”等问题，也可用 disk-raccoon 指代
上游来源	orange2ai/disk-raccoon
关联概念	028｜Skill（AI技能）

2. 它解决什么问题

磁盘空间不足时，用户通常只能看到“系统数据很大”或某个应用占用异常，却不知道哪些内容可以删、删掉会不会丢数据、清理后能否恢复。硬盘小浣熊把这件事拆成三个可检查的问题：

1. 空间在哪里：先读取磁盘使用情况和候选缓存目录，不先删除。
2. 哪些可以动：依据缓存地图识别应用、路径、大小和安全等级；不认识的路径先标记为未知。
3. 怎样可恢复：得到用户确认后，优先把目标移入回收站，清理后重新测量空间，并说明应用下次启动可能需要重建缓存。

它的定位是“缓存清理助手”，不是系统优化器。下载文件、项目产物、照片、聊天记录和应用本体，除非用户明确要求且另有依据，否则不属于默认清理范围。

3. 标准工作流

3.1 第一轮：只读诊断

先使用 df、du、ls、pgrep 等只读检查，回答：磁盘还剩多少空间、哪些应用或缓存目录占用较大、对应应用是否仍在运行。第一轮不执行删除，不使用不可逆的批量清理命令。

3.2 第二轮：按缓存地图判断

每个候选项至少标注路径、大小、所属应用、安全等级和清理后果：

• 安全：可再生、通常不包含用户内容的缓存，仍需确认路径和应用状态。
• 谨慎：可能包含应用状态或重新登录/重新索引成本，必须进一步缩小范围并明确后果。
• 不要触碰：登录状态、消息数据库、聊天记录、密钥链、配置数据、系统目录和未知用途路径。

3.3 第三轮：确认后执行

执行前向用户列出每个目标的完整路径、占用大小、所属应用、安全等级和可能后果。用户确认后先退出相关应用，再优先使用 Python shutil.move 把目标移入 ~/.Trash；涉及系统目录或需要 sudo 的动作，只给出由用户自行确认和执行的命令，不由 Skill 代执行。

执行后重新检查可用空间和目录大小，并说明哪些缓存会在下次启动时自动重建，以及是否可能需要重新登录或等待首次索引。

4. 缓存地图示例

安全等级	典型对象	处理说明
安全	~/.cache/uv、npm/pip/yarn 缓存、Xcode DerivedData、Go/Rust/CocoaPods 缓存、Chrome Service Worker	先确认路径和大小；清除后通常由工具或应用重新生成。
安全	Telegram 媒体缓存	可以考虑清理媒体缓存，但 Telegram 的 postbox/db 等消息数据不在此范围。
谨慎	飞书/Lark 的 aha/users/<user-id>/profile_explorer、微信明确标注为 Caches 的子目录、Docker 数据	先退出应用并逐项核对；Docker 不直接删除 Docker.raw，微信优先使用应用内部的清理入口。
不要触碰	postbox/db、消息/聊天数据库、Keychain、登录状态、Cookie/本地状态、配置目录、未知路径、系统目录	这些内容可能导致丢失记录、重新登录、应用损坏或系统风险，默认不清理。

缓存地图是判断依据，不是“看到路径就删除”的清单。新应用或新路径不在地图中时，先研究和报告，不做猜测性清理。

5. 安全规则与限制

• 第一轮必须只读，用户确认前不删除任何内容。
• 删除前必须报告完整路径、大小、所属应用、安全等级和可能后果。
• 相关应用应先退出，避免文件被占用或正在写入。
• 优先移动到 ~/.Trash，保留用户恢复窗口；不使用未经确认的 rm -rf。
• 不触碰登录状态、消息数据库、聊天记录、密钥链、系统文件和未知路径。
• 需要 sudo 的系统级操作由用户自行执行，Skill 不替用户提权。
• 下载目录、项目构建产物和个人工作文件不是缓存；除非用户明确扩大范围，否则不纳入本 Skill。

6. 触发示例

• “磁盘快满了，帮我先看看哪些缓存占空间。”
• “Chrome 怎么占了这么多空间？先只读分析，不要直接删除。”
• “帮我清理开发工具缓存，给我列出安全等级和清理后果。”
• “Telegram 媒体缓存太大了，消息数据库不要动。”

如果用户要求卸载应用、清理照片/下载文件、删除项目或做系统优化，应先说明这已超出硬盘小浣熊的默认边界，再等待用户明确授权和新的处理范围。

7. 安装、来源与验证

• 本机 Skill 路径：/Users/bairimengyushi/.codex/skills/disk-raccoon/SKILL.md
• 兼容副本：当前未发现 .agents/skills/disk-raccoon/ 或 .claude/skills/disk-raccoon/。
• 上游项目：https://github.com/orange2ai/disk-raccoon
• 核对版本：上游 main 当前核对到提交 c44ef19042ad7a734154fe2b2ce9fcda1c38adcc。
• 许可证：上游仓库为 MIT License，版权声明为 2026 冯雷（MarsWave）。
• 本地一致性：本机 SKILL.md 与上游版本内容的 SHA-256 为 d7f7a6869ea3819e7099bd40c9a4ad63e900c6e36b195cf2c930d988cff9a875；本机 LICENSE 与上游内容的 SHA-256 为 7ecf0d4b83b890f3c30690d839b75b0352725d49d110797640fd09c0f58dcac7。
• 网页映射：说明页登记为本地 Skills 管理网页的 /skills/005，网页详情正文直接读取本页。

8. 关联资料

• Skills索引：永久编号与统一导航。
• 028｜Skill（AI技能）：复用的上位概念卡，本次不新建概念卡。
• Mac 系统数据排查与清理实录：相关的本地磁盘空间排查资料。
• 微信清理方法：微信缓存清理的既有资料，仍需遵守本 Skill 的逐项确认边界。

文档更新日志

• 2026.09.08｜建立 005 说明页：将本机新安装的 disk-raccoon 归档为“硬盘小浣熊”，记录其 macOS 缓存清理边界、三级安全等级、MIT 来源、安装状态、上游提交和本地一致性核验；同步登记 Skills索引与本地 Skills 管理网页 /skills/005。