diff --git a/GUIDE.md b/GUIDE.md index e366d37..3d488a6 100644 --- a/GUIDE.md +++ b/GUIDE.md @@ -78,6 +78,14 @@ brew install tw93/tap/mole ## 第四步:常见操作 +### ⚠️ 重要提示(请先阅读) + +**首次使用强烈建议:** + +1. **预览模式:** 先运行 `mole clean --dry-run` 查看将删除的内容,不会真的删除任何文件 +2. **白名单保护:** 使用 `mole clean --whitelist` 保护重要的缓存文件 +3. **谨慎使用:** 如果你的 Mac 非常重要(生产环境、关键工作设备),建议等待 Mole 更加成熟稳定后再使用 + ### 清理垃圾文件 **安全预览模式(推荐第一次使用):** @@ -154,30 +162,11 @@ mole analyze ### 使用建议 -**推荐:** - -- 第一次使用先 `--dry-run` 预览 -- 定期清理(每月一次或磁盘快满时) -- 有大型缓存可用 `--whitelist` 保护 - -**避免:** - -- 频繁清理(一周一次就够了) -- 运行重要程序时清理 +**推荐:** 定期清理(每月一次或磁盘快满时) · **避免:** 频繁清理(一周一次就够)或运行重要程序时清理 ### 安全保障 -**Mole 只删除可重新生成的缓存和日志,不会删除:** - -- 应用配置文件(.plist)- 你的设置会保留 -- 应用数据(Application Support)- 重要文档不受影响 -- 系统关键文件、IDE 数据、数据库等 - -**白名单保护:** 可以保护特定缓存不被删除 - -```bash -mole clean --whitelist # 交互式选择要保护的缓存 -``` +**Mole 只删除可重新生成的缓存和日志,不会删除:** 应用配置(.plist)、应用数据(Application Support)、系统关键文件、IDE 数据、数据库等 --- @@ -193,55 +182,17 @@ mole clean --whitelist # 交互式选择要保护的缓存 2. 尝试重新运行安装命令 3. 如果还不行,可以去 [GitHub Issues](https://github.com/tw93/mole/issues) 寻求帮助 -### 清理后能恢复吗? +### 清理相关问题 -不需要恢复!Mole 只删除缓存和日志,应用会自动重新生成,不影响使用。 +**清理后能恢复吗?** 不需要!Mole 只删除缓存和日志,应用会自动重新生成(注意:应用卸载后无法恢复) -**注意:** 应用卸载后无法恢复(但配置文件会保留) +**多久清理一次?** 建议每月一次,磁盘快满时立即清理 -### 多久清理一次比较好? +### 如何更新和卸载 Mole? -- 磁盘空间充足:1-2 个月一次 -- 磁盘快满了:立即清理 -- 日常使用:看个人习惯 +**更新:** 一键安装用 `mole update` · Homebrew 用 `brew upgrade mole`(检测不到新版本?先运行 `brew update`) -### 如何更新 Mole? - -**如果是一键安装的:** - -```bash -mole update -``` - -**如果是 Homebrew 安装的:** - -```bash -brew upgrade mole -``` - -**💡 提示:** 如果 `brew upgrade mole` 显示已是最新版本,但实际上有新版本发布: - -```bash -brew update # 先刷新 Homebrew tap 信息 -brew upgrade mole # 再执行升级 -``` - -### 如何卸载 Mole? - -如果你想要卸载 Mole(不管是一键安装还是 Homebrew 安装): - -```bash -mole remove -``` - -这个命令会: - -- 自动识别安装方式(Homebrew 或手动安装) -- 删除 Mole 可执行文件 -- 清理配置文件(`~/.config/mole/`) -- 清理缓存文件(`~/.cache/mole/`) - -**注意:** 卸载前会要求确认,请仔细阅读提示。 +**卸载:** 任何安装方式都用 `mole remove`(会自动识别安装方式,清理所有相关文件) --- diff --git a/README.md b/README.md index 8a93b34..efa6abf 100644 --- a/README.md +++ b/README.md @@ -52,11 +52,11 @@ mole remove # Remove Mole from system mole --help # Show help ``` -> 💡 New to terminal? Check [小白使用指南](./GUIDE.md) +> 💡 **New to terminal?** Check [小白使用指南](./GUIDE.md) > -> 💡 **Homebrew users:** If `brew upgrade mole` shows no updates, run `brew update` first to refresh the tap, then `brew upgrade mole` +> ⚠️ Start with `--dry-run` to preview, then enable `--whitelist` to protect caches; on mission-critical Macs, wait for Mole to mature—safety first. 首次使用非常建议用 `--dry-run` 预览删除内容,假如这台 Mac 非常重要,请等到 Mole 更成熟时候使用。 > -> 💡 **Tip:** Run `mole clean --dry-run` to preview, or `mole clean --whitelist` to protect important caches before cleanup +> 💡 **Homebrew users:** No updates showing? Run `brew update` first, then `brew upgrade mole` ## Features @@ -66,19 +66,19 @@ mole --help # Show help $ mole clean ▶ System essentials - ✓ User app cache (45.2GB) # Caches, logs, trash 20-50GB typical + ✓ User app cache (45.2GB) ✓ User app logs (2.1GB) ✓ Trash (12.3GB) -▶ Browser cleanup # Chrome, Safari, Arc 5-15GB typical +▶ Browser cleanup ✓ Chrome cache (8.4GB) ✓ Safari cache (2.1GB) -▶ Developer tools # npm, Docker, Xcode 15-40GB typical +▶ Developer tools ✓ Xcode derived data (9.1GB) ✓ Node.js cache (14.2GB) -▶ Others # Cloud, Office, Media 10-40GB typical +▶ Others ✓ Dropbox cache (5.2GB) ✓ Spotify cache (3.1GB)