pi-cleanup
清理 ~/.pi 目录垃圾的扫帚工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-cleanup。 它的用途是：清理 ~/.pi 目录垃圾的扫帚工具 完整的 Skill 内容见：https://321skill.com/skills/pi-cleanup/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用 pi-cleanup 清理我的 ~/.pi 目录中的垃圾文件'，它会自动扫描并列出 DS_Store、失效 PID 文件、空目录等，然后询问是否清理。确认后即可释放磁盘空间，保持 Pi 环境整洁。
介绍
pi-cleanup 是一个专为 /.pi 目录设计的手动清理工具，用于清除该目录下积累的各种无用文件和残留数据。随着 Pi 生态的长期使用，/.pi 中会堆积 DS_Store 文件、失效的上下文模式统计 PID 文件、空会话目录、闲置会话以及子代理运行产生的旧版 run-N 工件。这些垃圾不仅占用磁盘空间，还可能影响 Pi 环境的稳定性和性能。pi-cleanup 提供了一种安全、可控的清理方式，帮助用户定期维护 Pi 工作目录的整洁。
使用方法非常简单，通过 npm 全局安装后，在终端中直接运行 pi-cleanup 命令即可。工具会自动扫描 ~/.pi 目录，识别出上述各类垃圾文件，并给出清理建议。用户可以根据需要选择清理全部或指定类型，操作直观且可逆。它作为 pi-delete-session 的补充，专注于更细粒度的清理场景。
适合所有使用 Pi 开发环境或智能体工作流的开发者、运维工程师和智能体开发者。尤其适合那些长期运行 Pi 项目、频繁切换上下文或使用子代理的用户，这些场景下 ~/.pi 目录容易快速膨胀。定期运行 pi-cleanup 可以有效预防磁盘空间不足和文件系统碎片化问题。
使用前建议先备份重要的会话数据，虽然工具会尽量避免误删，但自动识别可能偶有遗漏。如果遇到清理后某些功能异常，可以临时关闭清理并检查残留文件。另外，此工具仅处理 ~/.pi 目录，不涉及其他系统目录，请放心使用。
核心特点
与 pi-delete-session 侧重删除整个会话不同，pi-cleanup 专注于清理会话之外的各类零碎垃圾（如 DS_Store、PID 文件、空目录、旧工件），且操作更精细，可按类型选择性清理。
注意事项
不适用于清理系统级缓存或非 Pi 相关的目录，也不支持自动定时清理（需手动执行）。
常见问题
pi-cleanup 会误删重要数据吗？
工具会识别明显的垃圾文件，但建议在清理前手动备份重要会话。如果误删，可尝试从回收站恢复（部分系统支持）。
和 pi-delete-session 有什么区别？
pi-delete-session 专门删除整个会话，而 pi-cleanup 清理的是散落的垃圾文件，两者互补，可配合使用。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-cleanup/raw/index.md 读取 pi-cleanup 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-cleanup/raw/index.md（查看排版版本）