📝 Update Notes

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 只删除可重新生成的缓存和日志，不会删除：**
+**Mole 只删除可重新生成的缓存和日志，不会删除：** 应用配置（.plist）、应用数据（Application Support）、系统关键文件、IDE 数据、数据库等
-
-- 应用配置文件（.plist）- 你的设置会保留
-- 应用数据（Application Support）- 重要文档不受影响
-- 系统关键文件、IDE 数据、数据库等
-
-**白名单保护：** 可以保护特定缓存不被删除
-
-```bash
-mole clean --whitelist  # 交互式选择要保护的缓存
-```
 
 ---
 
@@ -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？
+**卸载：** 任何安装方式都用 `mole remove`（会自动识别安装方式，清理所有相关文件）
-
-**如果是一键安装的：**
-
-```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/`）
-
-**注意：** 卸载前会要求确认，请仔细阅读提示。
 
 ---
 

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)