前言¶
在 macOS 上做系统清理，很多人会用 Mole CLI：健康检查、清理预览、磁盘分析、应用清单与维护历史都在终端里完成。对长期在 DeepSeek Harness（DSH）里编排任务、看面板的开发者来说，频繁切到终端再记子命令，成本和误操作风险都不低。
大肥鱼 clean（dafish-clean）是社区维护的 DSH 客户端插件，在 Harness Web UI 里提供与 Mole CLI 能力对齐的深色面板，而不是另一套清理引擎。下文介绍它是什么、能做什么、如何安装，以及使用时的边界与安全模型。
这是什么¶
- 名称：大肥鱼 clean（Big Fat Fish clean）
- 维护者：lzyxczw-cyber
- 分类：客户端插件
- 仓库：github.com/lzyxczw-cyber/dafish-clean
- 定位：非官方的 Mole CLI 图形面板；不打包 Mole 代码或资源，通过调用本机已安装的
mole二进制读写其 JSON/文本输出。与 Mole 项目无隶属关系。 - 插件代码许可证：MIT（
package.json中版本为 1.0.3）。Mole CLI 为 GPL-3.0，需用户自行安装。
依赖环境：node >= 20，dsh >= 0.2.1-rc.2；文档标明兼容 0.2.1-rc.2+ 与 0.2.2-rc.1+。
核心功能¶
面板通过多个 Tab 映射 Mole 子命令，并在破坏性操作前普遍使用 --dry-run 预览。
| Tab | 对应能力 | 安全说明 |
|---|---|---|
| Status | mole status --json，约每 3 秒刷新 |
只读 |
| Clean | 先 mole clean --dry-run，确认后再 mole clean |
删除前需明确确认 |
| Apps | mole uninstall --list 与 --dry-run |
实际卸载交给 Terminal |
| Optimize | 先 mole optimize --dry-run，确认后再执行 |
维护前预览 |
| Analyze | mole analyze --json <path>，树图与下钻 |
只读 |
| Tools | mole purge / installer / slim --dry-run |
删除类操作交给 Terminal |
| History | mole history --json --limit 60 |
只读 |
设计要点（来自上游 README）：
- 长任务以后台作业运行，单行状态展示当前项、计数与耗时，可展开日志；切换 Tab 后运行状态与结果保留在持久化存储中。
- CLI 输出为英文时，面板将分组名、任务名、状态与摘要映射为中文，文件路径、应用名与进程名保持原样。
- 未检测到
mole时展示安装引导：可一键brew install mole（后台执行、不调用sudo），或复制官方安装方式后「再次检查」。二进制查找路径包括 Homebrew、/usr/local/bin、~/.local/bin、MOLE_BIN。
平台限制：当前仅支持 macOS（交接终端时使用 open / Terminal）。
安装与启用¶
任选一种方式安装到指定 profile，安装后刷新 DSH 页面（若提示则重启 host），从侧栏打开 大肥鱼 clean。
插件市场：在 DSH 中打开 Plugins → Plugin Market，搜索 dafish-clean / 大肥鱼 / Mole，点击安装。
从 GitHub 源码：
dsh plugin --profile <profile> add github:lzyxczw-cyber/dafish-clean
从 Release 压缩包（v1.0.3）：
dsh plugin --profile <profile> add https://github.com/lzyxczw-cyber/dafish-clean/releases/download/v1.0.3/dafish-clean-1.0.3.tgz
npm：
dsh plugin --profile <profile> add dafish-clean
包页：npmjs.com/package/dafish-clean。
安装前建议在仓库阅读源码与 LICENSE，确认与己方合规要求一致；插件以当前 DSH 进程权限运行，能否读写系统路径取决于 host 的启动方式与用户权限。
典型用法¶
- 确认 Mole：若侧栏打开后面板显示安装引导，按引导安装 Mole CLI 或手动安装后点击「再次检查」。
- 看健康状态：进入 Status，面板周期性拉取
mole status --json，用于快速判断系统概况。 - 清理前预览：在 Clean 先跑 dry-run，核对将要删除的项，再在确认对话框后执行真实
mole clean。 - 磁盘分析：在 Analyze 指定路径，查看 JSON 驱动的树图并下钻；该 Tab 为只读。
- 卸载应用：在 Apps 用 dry-run 预览后，按面板说明在 Terminal.app 中完成卸载（面板生成
.command交接，不假装全自动）。 - 查历史：在 History 查看最近最多 60 条清理相关记录。
破坏性写操作受作业锁约束，避免同类扫描或破坏性任务重叠；变更类本地路由要求同源请求并携带 x-dsh-mole 头。面板不执行 sudo，需提权的系统级清理仍由用户在终端完成。
适用场景与注意¶
适合谁
- 已在 macOS 上使用或打算使用 Mole CLI，且主要工作界面在 DSH 的开发者或运维人员。
- 希望在同一浏览器窗口内完成「预览 → 确认 → 执行/交接」，减少在 Harness 与终端之间来回切换的场景。
需要注意
- 非官方集成：显示名称刻意与 Mole 区分，不捆绑 Mole 商标资源；Mole for Mac（mole.fit）为独立产品，与本插件无关。
- 仅客户端：不替代 Mole CLI 的安装与许可义务；GPL-3.0 的 Mole 与用户自行安装的
mole二进制适用其原项目条款。 - 社区目录 skillhub.cn 上的插件页 为生态收录站点，与 DeepSeek / 幻方无官方从属关系；安装命令以仓库 README 为准。
结尾¶
大肥鱼 clean 把 Mole CLI 的系统健康、清理预览、磁盘分析、应用清单、维护与历史收敛到 DSH 侧栏中的一块深色面板，并强调 dry-run 与显式确认。若你已经在 Harness 里编排工作流，可以先在测试 profile 安装，确认 mole 检测与 Tab 行为符合预期后再用于日常机器。
