前言¶
开发机磁盘被缓存、重复包和大文件慢慢占满时，常见做法是装系统清理工具或直接 rm。前者往往黑盒，后者一旦误删很难挽回。若希望 Agent 按固定流程帮你「先看报告、再按风险分批处理」，且默认只进废纸篓而不硬删，可以把 SkillHub 上的 电脑磁盘清理（@kunlungrowth/kunlun-pc-cleaner）装进 Cursor、Claude Code 等支持 SKILL.md 的客户端，用对话驱动扫描与整理。
这是什么¶
电脑磁盘清理 是昆仑增长在 SkillHub 发布的 enterprise 来源 Skill，当前版本 v1.2.1，分类为 it-ops-security，标签 requires_api_key=false（无需 API Key）。
一句话定位：先 只读扫描 生成回收报告，再 按风险分级 分批把文件移入废纸篓（绝不硬删除），并覆盖重复文件、缓存、大文件、旧下载、截图与视频等场景；实现上需处理 macOS / Windows / Linux 的路径差异。
- SkillHub 页面：https://www.skillhub.cn/skills/kunlungrowth/kunlun-pc-cleaner
- 坐标：
@kunlungrowth/kunlun-pc-cleaner
核心功能¶
以下能力均来自 SkillHub 官方简介，未在页面写明的能力不展开。
-
只读扫描与回收报告
第一步不改动磁盘，只扫描并输出可读的回收报告，便于你先判断要动哪些目录、能腾出多少空间。 -
风险分级与分批执行
对候选文件做风险分级，确认后再分批移入废纸篓，避免一次性大批量误操作。 -
软删除策略
明确约定移入废纸篓，不做硬删除，降低误删不可恢复的风险。 -
多场景覆盖
重复文件、缓存、大文件、旧下载、截图与视频等常见占盘类型纳入同一套流程。 -
跨平台路径
同一 Skill 面向 macOS、Windows、Linux，由 Skill 内逻辑区分各系统路径习惯。
安装与启用¶
SkillHub 推荐通过其安装文档与 CLI 安装到 当前 Agent 的 skills 目录；装错目录会导致客户端识别不到，必要时需重启客户端。
1、检查或安装 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装，可按官方文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill¶
将 Skill 安装到当前环境对应的 skills 目录（--dir 必填）。常用路径示例：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装命令形式（包名以 SkillHub 坐标为准）：
skillhub install kunlungrowth/kunlun-pc-cleaner --dir ~/.cursor/skills/
也可把下面提示词发给 AI，让其按安装文档操作：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@kunlungrowth/kunlun-pc-cleaner`。
Cursor、Codex CLI、Claude Code 的差异主要体现在 skills 目录路径；安装步骤本身均遵循 SkillHub 安装与优先源配置。公开资料未单独列出各客户端的额外配置项时，无需臆造配置文件。
典型用法¶
公开页面未附带完整对话脚本，可复现的流程与官方简介一致：
- 在已启用该 Skill 的 Agent 中说明目标（例如：扫描用户目录下的缓存与大文件，先不要删除）。
- 等待 Agent 完成 只读扫描，阅读生成的 回收报告（路径、大小、类型、风险档位）。
- 按报告勾选或指定批次，确认后让 Agent 分批移入废纸篓；未确认前不应执行移动。
- 若结果不符合预期，在系统废纸篓中恢复文件（Skill 侧承诺不硬删，恢复依赖各 OS 废纸篓机制）。
具体扫描范围、风险分级规则与命令实现写在 Skill 包内的 SKILL.md 中，安装后由 Agent 按该文件执行。
适用场景与注意¶
适合谁
- 需要定期腾磁盘、又希望过程可审计、可分批确认的开发者。
- 在 macOS / Windows / Linux 多环境切换、希望 Agent 统一处理路径差异的用户。
- 不愿把清理完全交给闭源一键工具、更希望「先报告再动手」的团队。
限制与注意
- 能力边界以 SkillHub 简介为准；未声明的能力（例如未写明的聊天附件场景）不要默认存在。
- 「绝不硬删除」指 Skill 设计为移入废纸篓；仍应在每批执行前核对报告，重要数据先备份。
- 分类为 it-ops-security，适合当作运维向辅助能力，生产机或共享服务器上使用前宜单独评估权限与扫描范围。
- 安装、搜索、升级依赖
skillhubCLI 与网络；沙箱或限网环境需放开相应权限。
结尾¶
电脑磁盘清理 把磁盘整理收成「只读报告 → 风险分级 → 确认后入废纸篓」的 Agent 工作流，面向重复文件、缓存、大文件、旧下载与截图视频等常见占盘场景，并考虑三端路径差异。需要安装或更新时，以 SkillHub 页面与安装文档为准：
https://www.skillhub.cn/skills/kunlungrowth/kunlun-pc-cleaner
