Release v1.21.0: Add macos-cleaner skill

- Add macos-cleaner v1.0.0 - Intelligent macOS disk space recovery
- Safety-first philosophy with risk categorization (Safe/Caution/Keep)
- Smart analysis: caches, app remnants, large files, dev environments
- Interactive cleanup with explicit user confirmation
- Bundled scripts: analyze_caches, analyze_dev_env, analyze_large_files,
  find_app_remnants, safe_delete, cleanup_report
- Comprehensive references: cleanup_targets, mole_integration, safety_rules
- Update marketplace to v1.21.0
- Update all documentation (README.md, README.zh-CN.md, CHANGELOG.md, CLAUDE.md)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
daymade
2026-01-11 15:59:13 +08:00
parent 3f2f8f02ca
commit 4d6ed53c1e
16 changed files with 3546 additions and 10 deletions

View File

@@ -6,15 +6,15 @@
[![简体中文](https://img.shields.io/badge/语言-简体中文-red)](./README.zh-CN.md)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Skills](https://img.shields.io/badge/skills-27-blue.svg)](https://github.com/daymade/claude-code-skills)
[![Version](https://img.shields.io/badge/version-1.20.0-green.svg)](https://github.com/daymade/claude-code-skills)
[![Skills](https://img.shields.io/badge/skills-28-blue.svg)](https://github.com/daymade/claude-code-skills)
[![Version](https://img.shields.io/badge/version-1.21.0-green.svg)](https://github.com/daymade/claude-code-skills)
[![Claude Code](https://img.shields.io/badge/Claude%20Code-2.0.13+-purple.svg)](https://claude.com/code)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](./CONTRIBUTING.md)
[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/daymade/claude-code-skills/graphs/commit-activity)
</div>
专业的 Claude Code 技能市场,提供 27 个生产就绪的技能,用于增强开发工作流。
专业的 Claude Code 技能市场,提供 28 个生产就绪的技能,用于增强开发工作流。
## 📑 目录
@@ -216,6 +216,9 @@ claude plugin install iOS-APP-developer@daymade-skills
# Twitter/X 内容获取
claude plugin install twitter-reader@daymade-skills
# macOS 磁盘空间清理
claude plugin install macos-cleaner@daymade-skills
```
每个技能都可以独立安装 - 只选择你需要的!
@@ -1086,6 +1089,106 @@ python scripts/fetch_tweet.py https://x.com/user/status/123 output.md
---
### 26. **macos-cleaner** - 智能 macOS 磁盘空间恢复
**在 macOS 上恢复磁盘空间最安全的方式。** 通过智能分类和交互式清理,分析系统缓存、应用残留、大文件和开发环境。
**为什么 macos-cleaner 与众不同:**
- **安全优先理念**:在明确用户确认之前绝不删除。每项操作都包含风险评估(🟢 安全 / 🟡 谨慎 / 🔴 保留)。
- **智能胜于自动化**:先分析,详细解释,然后由你决定。与盲目删除的一键清理工具不同,我们帮助你理解要删除的内容及原因。
- **开发者友好**:深度分析 Docker、Homebrew、npm、pip 缓存 - 这些是通用清理工具遗漏的工具。
- **透明且教育性**:每项建议都包含对文件的解释、为什么安全(或不安全)以及删除后的影响。
- **专业品质**:由了解误删重要文件痛苦的开发者构建。包含全面的安全检查和 Time Machine 备份建议。
**我们的设计原则:**
1. **用户控制优先**:你做决定,我们提供洞察
2. **解释一切**:没有神秘的删除 - 完全透明的影响说明
3. **保守的默认值**:不确定时,我们保留而不是删除
4. **开发者视角**:理解开发工具缓存,而不仅仅是系统文件
5. **混合方法**结合脚本精度与可视化工具Mole 集成)
**使用场景:**
- 你的 Mac 磁盘空间不足(使用率 >80%
- 你是开发者Docker/npm/pip/Homebrew 缓存堆积如山
- 你想了解占用空间的内容,而不仅仅是盲目删除
- 你需要清理已卸载应用程序的残留
- 你更喜欢理解而非自动化
**主要功能:**
- **智能缓存分析**:按安全级别对系统缓存、应用缓存、日志进行分类
- **应用残留检测**:查找已卸载应用程序的孤立数据,并提供可信度评分
- **大文件发现**:智能分类(视频、归档、数据库、磁盘镜像、构建产物)
- **开发环境清理**Docker镜像、容器、卷、构建缓存、Homebrew、npm、pip、旧 Git 仓库
- **交互式安全删除**:批量确认、选择性删除、撤销友好(尽可能使用废纸篓)
- **前后报告**:跟踪空间恢复并提供详细分解
- **Mole 集成**:与可视化清理工具无缝协作,适合 GUI 偏好
- **风险分类**:每个项目都标有安全级别和说明
- **Time Machine 感知**:建议在大批量删除(>10 GB前进行备份
**我们的优势:**
-**通过透明度建立信任**:其他清理工具隐藏删除内容。我们展示一切并解释原因。
-**以开发者为中心**:我们清理 Docker而不仅仅是浏览器缓存。我们理解 `.git` 目录、`node_modules` 和构建产物。
-**内置安全检查**:保护系统文件、用户数据、凭据、活动数据库或正在使用的文件不被删除。
-**教育性**:了解什么可以安全删除及原因,以便你能自信地维护你的 Mac。
-**不是一键解决方案**:我们不会自动删除。如果你想要"立即清理所有内容",请使用其他工具。我们面向想要控制的用户。
**示例用法:**
```bash
# 安装技能
claude plugin install macos-cleaner@daymade-skills
# 要求 Claude Code 分析你的 Mac
"我的 Mac 快没空间了,帮我分析一下是什么在占用存储空间"
# Claude 将会:
# 1. 运行全面的磁盘分析
# 2. 展示带有安全级别的分类结果
# 3. 解释每个类别(缓存、残留、大文件、开发工具)
# 4. 推荐清理方法
# 5. 仅执行你确认的操作
# 示例分析输出:
📊 磁盘空间分析
━━━━━━━━━━━━━━━━━━━━━━━
总计: 500 GB
已用: 450 GB (90%)
可用: 50 GB (10%)
🟢 安全清理 (95 GB):
- 系统缓存: 45 GB (应用会自动重新生成)
- Homebrew 缓存: 5 GB (需要时重新安装)
- npm 缓存: 3 GB (清除安全)
- 旧日志: 8 GB (仅诊断数据)
- 废纸篓: 34 GB (已标记为删除)
🟡 建议审查 (62 GB):
- 大型下载: 38 GB (可能包含重要文件)
- 应用残留: 8 GB (验证应用是否真正卸载)
- Docker 镜像: 12 GB (可能正在使用)
- 旧 .git 仓库: 4 GB (验证项目是否已归档)
🔴 除非确定否则保留 (0 GB):
- 未检测到高风险项目
建议:从 🟢 安全项目开始 (95 GB),然后一起审查 🟡 项目。
```
**🎬 实时演示**
*即将推出*
📚 **文档**:参见 [macos-cleaner/references/](./macos-cleaner/references/) 了解:
- `cleanup_targets.md` - 每个清理目标的详细说明
- `mole_integration.md` - 如何将脚本与 Mole 可视化工具结合使用
- `safety_rules.md` - 全面的安全指南以及永远不应删除的内容
**要求**
- **Python 3.6+**macOS 预装)
- **macOS**(在 macOS 10.15+ 上测试)
- **可选**[Mole](https://github.com/tw93/Mole) 用于可视化清理界面
---
## 🎬 交互式演示画廊
想要在一个地方查看所有演示并具有点击放大功能?访问我们的[交互式演示画廊](./demos/index.html)或浏览[演示目录](./demos/)。
@@ -1146,6 +1249,9 @@ python scripts/fetch_tweet.py https://x.com/user/status/123 output.md
### Twitter/X 内容研究
使用 **twitter-reader** 无需 JavaScript 渲染或身份验证即可获取推文内容。非常适合记录社交媒体讨论、归档话题、分析推文内容或从 Twitter/X 收集参考资料。与 **markdown-tools** 结合可将获取的内容转换为其他格式,或与 **repomix-safe-mixer** 结合安全地打包研究集合。
### macOS 系统维护与磁盘空间恢复
使用 **macos-cleaner** 以安全优先的方式智能分析和恢复 macOS 上的磁盘空间。与盲目删除的一键清理工具不同macos-cleaner 解释每个文件是什么、按风险级别分类(🟢/🟡/🔴),并在任何删除前需要明确确认。非常适合处理 Docker/Homebrew/npm/pip 缓存膨胀的开发者、希望了解存储空间消耗的用户,或任何重视透明度而非自动化的人。结合基于脚本的精度和可选的 Mole 可视化工具集成以实现混合工作流。
### 技能发现与管理
使用 **skills-search** 从 CCPM 注册表中查找、安装和管理 Claude Code 技能。非常适合为特定任务发现新技能、为常见工作流安装技能包,以及保持技能集合的有序管理。
@@ -1185,6 +1291,7 @@ python scripts/fetch_tweet.py https://x.com/user/status/123 output.md
- **promptfoo-evaluation**:参见 `promptfoo-evaluation/references/promptfoo_api.md` 了解评测模式
- **iOS-APP-developer**:参见 `iOS-APP-developer/references/xcodegen-full.md` 了解 XcodeGen 选项与 project.yml 细节
- **twitter-reader**:参见 `twitter-reader/SKILL.md` 了解 API 密钥设置和 URL 格式支持
- **macos-cleaner**:参见 `macos-cleaner/references/cleanup_targets.md` 了解详细清理目标说明、`macos-cleaner/references/mole_integration.md` 了解 Mole 可视化工具集成、`macos-cleaner/references/safety_rules.md` 了解全面安全指南
## 🛠️ 系统要求
@@ -1203,6 +1310,7 @@ python scripts/fetch_tweet.py https://x.com/user/status/123 output.md
- **Promptfoo**(用于 promptfoo-evaluation`npx promptfoo@latest`
- **macOS + Xcode、XcodeGen**(用于 iOS-APP-developer
- **Jina.ai API 密钥**(用于 twitter-readerhttps://jina.ai/ 提供免费套餐
- **Mole**(可选,用于 macos-cleaner 可视化清理):从 https://github.com/tw93/Mole 下载
## ❓ 常见问题