mirror of
https://github.com/tw93/Mole.git
synced 2026-02-04 15:04:42 +00:00
Simpler documentation
This commit is contained in:
156
GUIDE.md
156
GUIDE.md
@@ -1,156 +0,0 @@
|
||||
# Mole 小白使用指南
|
||||
|
||||
## 第一步:打开终端
|
||||
|
||||
终端是 Mac 自带的一个工具,用来输入命令操作电脑。
|
||||
|
||||
**方法一:快捷键(推荐)**
|
||||
|
||||
1. 按 `Command (⌘)` + `空格键`
|
||||
2. 在搜索框输入 `终端` 或 `Terminal`
|
||||
3. 按回车
|
||||
|
||||
**方法二:应用程序**
|
||||
|
||||
1. 打开访达
|
||||
2. 点左侧的应用程序
|
||||
3. 找到实用工具文件夹
|
||||
4. 双击终端
|
||||
|
||||
---
|
||||
|
||||
## 第二步:安装 Mole
|
||||
|
||||
**方法一:一键安装(推荐)**
|
||||
|
||||
复制下面命令,粘贴到终端,按回车:
|
||||
|
||||
```bash
|
||||
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash
|
||||
```
|
||||
|
||||
**方法二:Homebrew**
|
||||
|
||||
```bash
|
||||
brew install tw93/tap/mole
|
||||
```
|
||||
|
||||
|
||||
---
|
||||
|
||||
## 第三步:开始使用
|
||||
|
||||
终端输入 `mo` 回车。找不到命令就试 `mole`。
|
||||
|
||||
**操作方式:**
|
||||
|
||||
- `↑` `↓` 选菜单
|
||||
- `空格` 选中/取消
|
||||
- `回车` 确认
|
||||
- `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 analyze
|
||||
```
|
||||
|
||||
看哪些文件和文件夹占空间大。
|
||||
|
||||
**操作:** `↑` `↓` 选择、`回车` 进入、`←` 返回、`Delete` 删除、`q` 退出
|
||||
|
||||
### 查看帮助
|
||||
|
||||
```bash
|
||||
mo --help
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 第五步:注意事项
|
||||
|
||||
**推荐:** 每月清理一次,或磁盘快满时
|
||||
|
||||
**避免:** 频繁清理,或运行重要程序时清理
|
||||
|
||||
**安全:** Mole 只删缓存和日志,不碰应用配置、应用数据、系统文件、数据库
|
||||
|
||||
---
|
||||
|
||||
## 常见问题
|
||||
|
||||
**输密码看不到字符?** 终端安全设计,直接输完按回车。
|
||||
|
||||
**安装失败?** 检查网络,重新跑命令,还不行去 [GitHub Issues](https://github.com/tw93/mole/issues) 问。
|
||||
|
||||
**清理后能恢复吗?** 不用恢复。Mole 只删缓存和日志,应用会自动重新生成。应用卸载后无法恢复。
|
||||
|
||||
**多久清理一次?** 每月一次,或磁盘快满时。
|
||||
|
||||
**怎么更新?** `mo update`
|
||||
|
||||
**怎么卸载?** `mo remove`
|
||||
|
||||
**支持 Touch ID 吗?** Mole 用 `sudo` 请求权限,如果你给 `sudo` 启用了 Touch ID 就能用。
|
||||
|
||||
**如何启用 Touch ID?**
|
||||
|
||||
1. 终端输入 `sudo nano /etc/pam.d/sudo`
|
||||
2. 在顶部注释下加 `auth sufficient pam_tid.so`
|
||||
3. `Ctrl+O` 回车,`Ctrl+X` 退出
|
||||
|
||||
---
|
||||
|
||||
## 需要帮助?
|
||||
|
||||
- [GitHub 主页](https://github.com/tw93/mole)
|
||||
- [提交问题](https://github.com/tw93/mole/issues)
|
||||
- [完整文档](./README.md)
|
||||
|
||||
有用的话分享给朋友吧~
|
||||
23
README.md
23
README.md
@@ -29,7 +29,6 @@
|
||||
|
||||
- If your Mac is mission-critical, consider waiting for Mole to mature further - safety first
|
||||
- 如果这台 Mac 对你非常重要,建议等 Mole 更成熟时来使用,安全第一
|
||||
- Not tech-savvy? Check out the [小白使用指南](./GUIDE.md)
|
||||
|
||||
**Install:**
|
||||
|
||||
@@ -143,10 +142,24 @@ Total: 156.8GB
|
||||
|
||||
## FAQ
|
||||
|
||||
1. **Is Mole safe?** – Mole only cleans caches and logs, it doesn't touch app settings, user documents, or system files. Run `mo clean --dry-run` first to preview what will be removed.
|
||||
2. **How often should I clean?** – Once a month, or when disk space is running low.
|
||||
3. **Can I protect specific caches?** – Yes. Run `mo clean --whitelist` to choose which caches to keep. Common ones like Playwright browsers and HuggingFace models are already protected.
|
||||
4. **Does Mole support Touch ID?** – Mole uses `sudo` for privileges, so you'll get a password prompt unless you've configured Touch ID for sudo.
|
||||
**Is Mole safe?** Mole only cleans caches and logs, it doesn't touch app settings, user documents, or system files. Run `mo clean --dry-run` first to preview what will be removed.
|
||||
|
||||
**How often should I clean?** Once a month, or when disk space is running low.
|
||||
|
||||
**Can I protect specific caches?** Yes. Run `mo clean --whitelist` to choose which caches to keep. Common ones like Playwright browsers and HuggingFace models are already protected.
|
||||
|
||||
**Touch ID support?** Mole uses `sudo` for privileges, so you'll get a password prompt unless you've configured Touch ID for sudo.
|
||||
|
||||
**Enable Touch ID for sudo:**
|
||||
|
||||
```bash
|
||||
sudo nano /etc/pam.d/sudo
|
||||
|
||||
# Add this line below the comments at the top:
|
||||
auth sufficient pam_tid.so
|
||||
|
||||
# Save: Ctrl+O, then exit: Ctrl+X
|
||||
```
|
||||
|
||||
## Support
|
||||
|
||||
|
||||
Reference in New Issue
Block a user