1
0
mirror of https://github.com/tw93/Mole.git synced 2026-02-05 10:18:48 +00:00
Files
Mole/GUIDE.md
2025-10-09 00:32:55 +08:00

232 lines
4.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Mole 小白使用指南
> 不懂技术也能用的 Mac 清理工具教程
## 第一步:打开终端
终端是 Mac 自带的一个工具,用来输入命令操作电脑。
**方法一:快捷键(推荐)**
1.`Command (⌘)` + `空格键`
2. 在搜索框输入 `终端``Terminal`
3. 按回车
**方法二:应用程序**
1. 打开访达
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
```
> 什么是 HomebrewMac 软件管理工具。不知道的话用方法一。
>
> **注意:** 只选一种方法装,别两种都用,会冲突。
>
> 安装时可能要验证管理员权限Touch ID 或输密码都行,输密码时不显示字符是正常的
---
## 第三步:开始使用
1. **启动 Mole**
在终端输入并回车:
```bash
mo
```
找不到命令的话,试试 `mole`,功能一样。
2. **界面操作**
- `` `` 方向键选菜单
- `空格键` 选中/取消
- `回车键` 确认
- `q` 键退出
---
## 第四步:常见操作
### 重要提示
**首次使用建议:**
1. **预览模式:** 先跑 `mo clean --dry-run` 看看会删什么,不会真删
2. **白名单保护:** 用 `mo clean --whitelist` 保护重要缓存
3. **谨慎使用:** Mac 很重要的话,等 Mole 更成熟再用
### 清理垃圾文件
**预览模式(第一次用建议先试):**
```bash
mo clean --dry-run
```
只显示会删什么,不会真删。先看看再决定。
**白名单管理:**
```bash
mo clean --whitelist
```
选哪些缓存不删,比如开发工具的大型缓存。
**正式清理:**
```bash
mo clean
```
清理系统缓存、日志、临时文件等释放空间。Mole 只删可重新生成的文件,放心用。
### 卸载应用
```bash
mo uninstall
```
这个功能:
- 显示所有已装应用
- 方向键选,空格标记,可多选
- 回车确认删除
- **连残留文件一起删**
### 查看帮助
```bash
mo --help
```
查看所有命令。
### 磁盘空间分析 🆕
```bash
mo analyze
```
看哪些文件和文件夹占空间大,快速找到并清理。
**操作:**
- `` ``:选择
- `回车`:进入文件夹/预览文件
- ``:返回上级
- `Delete`:删除
- `q`:退出
> 需要权限时先试 Touch ID不支持再输密码。
**提示:**
- 文件夹按大小排序
- 文本文件直接预览,其他用默认应用打开
- 超过 15 项自动分页
---
## 第五步:注意事项
### 使用建议
**推荐:** 定期清理,每月一次或磁盘快满时
**避免:** 频繁清理,或在运行重要程序时清理
### 安全保障
Mole 只删缓存和日志,不碰这些:
- 应用配置
- 应用数据
- 系统文件
- IDE 数据
- 数据库
---
## 常见问题
### 为什么输密码看不到字符?
Mac 终端安全设计,直接输完按回车就行。
### 安装失败怎么办?
1. 检查网络
2. 重新跑安装命令
3. 还不行去 [GitHub Issues](https://github.com/tw93/mole/issues) 问
### 清理相关
**清理后能恢复吗?** 不用恢复。Mole 只删缓存和日志,应用会自动重新生成。注意:应用卸载后无法恢复。
**多久清理一次?** 每月一次,或磁盘快满时。
### 如何更新和卸载 Mole
**更新:** `mo update`Homebrew 装的会自动 `brew update && brew upgrade mole`
**卸载:** `mo remove`,自动识别安装方式,清理所有文件
### Mole 支持 Touch ID 吗?
Mole 用 `sudo` 请求权限,默认输密码。如果你给 `sudo` 启用了 Touch ID可以直接按指纹失败再输密码。
### 如何让命令行支持 Touch ID
1. 打开配置:`sudo nano /etc/pam.d/sudo`
2. 在顶部注释下加:
```txt
auth sufficient pam_tid.so
```
3. 保存退出:`Ctrl+O` 回车,`Ctrl+X`。以后 `sudo` 会先提示 Touch ID。
---
## 需要帮助?
- [GitHub 主页](https://github.com/tw93/mole)
- [提交问题](https://github.com/tw93/mole/issues)
- [完整文档](./README.md)
有用的话分享给朋友吧~