mirror of
https://github.com/tw93/Mole.git
synced 2026-02-04 19:44:44 +00:00
228 lines
5.3 KiB
Markdown
228 lines
5.3 KiB
Markdown
# Mole Mac 清理工具 - 小白使用指南
|
||
|
||
> 一个完全不懂技术的 Mac 用户也能轻松使用的清理工具教程
|
||
|
||
## 第一步：打开终端
|
||
|
||
终端是 Mac 自带的一个工具，用来输入命令操作电脑。
|
||
|
||
**方法一：快捷键（推荐）**
|
||
|
||
1. 按下键盘上的 `Command (⌘)` + `空格键`
|
||
2. 在弹出的搜索框中输入 `终端` 或 `Terminal`
|
||
3. 按回车键，会打开一个黑色或白色的窗口
|
||
|
||
**方法二：应用程序**
|
||
|
||
1. 打开"访达"（Finder）
|
||
2. 点击左侧的"应用程序"
|
||
3. 找到"实用工具"文件夹
|
||
4. 双击"终端"图标
|
||
|
||
> 💡 小提示：这个窗口看起来可能有点专业，但别担心，接下来的操作都很简单！
|
||
|
||
---
|
||
|
||
## 第二步：安装 Mole
|
||
|
||
**方法一：一键安装（推荐）**
|
||
|
||
1. **复制安装命令**
|
||
用鼠标选中下面这一行，然后按 `Command (⌘)` + `C` 复制：
|
||
|
||
```bash
|
||
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash
|
||
```
|
||
|
||
2. **粘贴到终端**
|
||
- 在终端窗口中，按 `Command (⌘)` + `V` 粘贴
|
||
- 或者右键点击终端窗口，选择"粘贴"
|
||
|
||
3. **开始安装**
|
||
- 按下 `回车键`
|
||
- 等待几秒钟，会自动安装完成
|
||
- 看到类似"安装成功"的提示就完成了
|
||
|
||
**方法二：通过 Homebrew 安装**
|
||
|
||
如果你的电脑已经安装了 Homebrew，可以使用这个命令：
|
||
|
||
```bash
|
||
brew install tw93/tap/mole
|
||
```
|
||
|
||
> 💡 什么是 Homebrew？一个 Mac 软件管理工具。如果你不知道这是什么，请使用方法一。
|
||
|
||
> ⚠️ **重要：** 只选择一种方法安装！不要同时用两种方法，会产生冲突。
|
||
|
||
> ⚠️ 注意：第一次安装可能会要求你输入 Mac 的登录密码（输入时不会显示任何字符，这是正常的）
|
||
|
||
---
|
||
|
||
## 第三步：开始使用
|
||
|
||
1. **启动 Mole**
|
||
在终端中输入以下命令并按回车：
|
||
|
||
```bash
|
||
mole
|
||
```
|
||
|
||
2. **了解界面操作**
|
||
- 用键盘的 `↑` `↓` 方向键 选择菜单项
|
||
- 按 `空格键` 选中或取消选中
|
||
- 按 `回车键` 确认执行
|
||
- 按 `q` 键退出当前界面
|
||
|
||
---
|
||
|
||
## 第四步：常见操作
|
||
|
||
### 清理垃圾文件
|
||
|
||
**安全预览模式（推荐第一次使用）：**
|
||
|
||
```bash
|
||
mole clean --dry-run
|
||
```
|
||
|
||
这个命令只会**显示**哪些文件会被清理，**不会真的删除**。你可以先看看效果再决定。
|
||
|
||
**管理白名单（保护重要缓存）：**
|
||
|
||
```bash
|
||
mole clean --whitelist
|
||
```
|
||
|
||
交互式选择哪些缓存不要删除，比如开发工具的大型缓存（Homebrew、Gradle 等）。
|
||
|
||
**正式清理：**
|
||
|
||
```bash
|
||
mole clean
|
||
```
|
||
|
||
会清理系统缓存、日志、临时文件等，释放磁盘空间。Mole 很安全，只删除可重新生成的文件。
|
||
|
||
### 卸载应用（彻底删除）
|
||
|
||
```bash
|
||
mole uninstall
|
||
```
|
||
|
||
这个功能会：
|
||
|
||
- 显示你电脑上所有已安装的应用
|
||
- 用方向键选择要卸载的应用
|
||
- 按空格键标记（可以多选）
|
||
- 按回车确认删除
|
||
- **会连同应用的残留文件一起删除**
|
||
|
||
### 查看帮助
|
||
|
||
```bash
|
||
mole --help
|
||
```
|
||
|
||
可以查看所有可用的命令和说明。
|
||
|
||
### 磁盘空间分析 🆕
|
||
|
||
```bash
|
||
mole analyze
|
||
```
|
||
|
||
交互式查看哪些文件和文件夹最占空间，帮助你快速找到并清理大文件。
|
||
|
||
**基本操作：**
|
||
|
||
- `↑` `↓`：上下选择
|
||
- `回车`：进入文件夹 / 打开文件预览
|
||
- `←`：返回上级
|
||
- `Delete`：删除（需确认）
|
||
- `q`：退出
|
||
|
||
**小提示：**
|
||
|
||
- 文件夹会按大小排序，一目了然
|
||
- 文本文件可以直接预览，其他文件用系统默认应用打开
|
||
- 超过 15 项会自动分页，继续按方向键滚动查看
|
||
|
||
---
|
||
|
||
## 第五步：注意事项
|
||
|
||
### 使用建议
|
||
|
||
**推荐：**
|
||
- 第一次使用先 `--dry-run` 预览
|
||
- 定期清理（每月一次或磁盘快满时）
|
||
- 有大型缓存可用 `--whitelist` 保护
|
||
|
||
**避免：**
|
||
- 频繁清理（一周一次就够了）
|
||
- 运行重要程序时清理
|
||
|
||
### 安全保障
|
||
|
||
**Mole 只删除可重新生成的缓存和日志，不会删除：**
|
||
- 应用配置文件（.plist）- 你的设置会保留
|
||
- 应用数据（Application Support）- 重要文档不受影响
|
||
- 系统关键文件、IDE 数据、数据库等
|
||
|
||
**白名单保护：** 可以保护特定缓存不被删除
|
||
|
||
```bash
|
||
mole clean --whitelist # 交互式选择要保护的缓存
|
||
```
|
||
|
||
---
|
||
|
||
## 常见问题
|
||
|
||
### 为什么输入密码时看不到字符？
|
||
|
||
这是 Mac 终端的安全设计，密码不会显示，直接输入后按回车就行。
|
||
|
||
### 安装失败怎么办？
|
||
|
||
1. 检查网络连接是否正常
|
||
2. 尝试重新运行安装命令
|
||
3. 如果还不行，可以去 [GitHub Issues](https://github.com/tw93/mole/issues) 寻求帮助
|
||
|
||
### 清理后能恢复吗？
|
||
|
||
不需要恢复！Mole 只删除缓存和日志，应用会自动重新生成，不影响使用。
|
||
|
||
**注意：** 应用卸载后无法恢复（但配置文件会保留）
|
||
|
||
### 多久清理一次比较好？
|
||
|
||
- 磁盘空间充足：1-2 个月一次
|
||
- 磁盘快满了：立即清理
|
||
- 日常使用：看个人习惯
|
||
|
||
### 如何更新 Mole？
|
||
|
||
**如果是一键安装的：**
|
||
|
||
```bash
|
||
mole update
|
||
```
|
||
|
||
**如果是 Homebrew 安装的：**
|
||
|
||
```bash
|
||
brew upgrade mole
|
||
```
|
||
|
||
---
|
||
|
||
## 需要更多帮助？
|
||
|
||
- [GitHub 项目主页](https://github.com/tw93/mole)
|
||
- [提交问题反馈](https://github.com/tw93/mole/issues)
|
||
- [完整使用文档](./README.md)
|
||
|
||
**祝你使用愉快！如果觉得有用，欢迎分享给朋友 ✨**
|