A Fluent Design GUI for Mole CLI — system cleanup, analysis, and optimization, beautifully reimagined.

Revel is a desktop application that wraps Mole CLI in a native-like, Fluent Design interface. It makes system maintenance on macOS intuitive and visually pleasing — no terminal required for everyday cleanup, analysis, and optimization tasks.

• macOS — Mole CLI is macOS-only (Revel has cross-platform support planned)

• Node.js 18+ and pnpm (package manager)

• Mole CLI installed:

  brew install tw93/tap/mole

# Install dependencies
pnpm install

# Start development mode (Vite dev server + HMR + Electron)
pnpm dev

# Build for production
pnpm build

# Package macOS app (DMG + ZIP)
pnpm build:mac

Build outputs are placed in dist/, and packaged releases in release/.

Main Process (main.js)
├── Window management (BrowserWindow)
├── System tray (Tray)
├── IPC communication (ipcMain)
├── Command execution (child_process.spawn)
└── Privilege escalation (osascript sudo)

Renderer Process (Vue 3 App)
├── 9 views (Welcome, Clean, Analyze, Status, …)
├── Custom theme engine (themes/engine.js)
├── Fluent Design CSS system (style.css)
└── IPC calls via secure bridge (window.electronAPI)

Preload Script (preload.js)
└── Secure context bridge (contextBridge)

The project uses three independent Vite configs — no electron-vite wrapper:

• vite.renderer.config.js — Renderer dev server + HMR
• vite.main.config.js — Main process (library mode, CJS, Node 24)
• vite.preload.config.js — Preload script (library mode, CJS)

Cleanup	Disk Analysis	System Status
One-click system cache cleanup	Visual disk space analysis	Real-time resource monitoring

App Uninstall	System Optimize	Project Cleanup

The project maintains a four-layer testing pyramid:

CI (GitHub Actions) runs lint, format check, unit tests, and production build on every push.

1. First run: Grant Full Disk Access permission (System Settings > Privacy & Security > Full Disk Access)

2. Some operations require admin privileges — macOS will prompt via a system dialog

3. Mole CLI (mo) must be available in your PATH

4. The app stores preferences in localStorage (theme, language, data source, auto-launch, etc.)

5. Unsigned app: macOS Gatekeeper will block the first launch. Run the following command to allow it:

   sudo xattr -rd com.apple.quarantine /Applications/Revel.app

• Mole CLI — the command-line tool that powers Revel
• Fluent Design System — Microsoft's design language
• Electron — cross-platform desktop framework
• Vue 3 — progressive JavaScript framework

MIT © a1121611810. See LICENSE for details.

Revel 是 Mole CLI 的图形界面工具，采用 Microsoft Fluent Design 设计风格，使用 Vue 3 + Electron 构建。让 macOS 系统维护变得直观而美观 — 无需记忆命令，轻松完成清理、分析和优化。

• macOS — Mole CLI 仅支持 macOS（Revel 有计划支持跨平台）

• Node.js 18+ 和 pnpm（包管理器）

• Mole CLI 已安装：

  brew install tw93/tap/mole

# 安装依赖
pnpm install

# 启动开发模式（Vite dev server + HMR + Electron）
pnpm dev

# 生产构建
pnpm build

# 打包 macOS 应用（DMG + ZIP）
pnpm build:mac

构建产物输出到 dist/，打包版本输出到 release/。

主进程 (main.js)
├── 窗口管理 (BrowserWindow)
├── 系统托盘 (Tray)
├── IPC 通信 (ipcMain)
├── 命令执行 (child_process.spawn)
└── 权限提升 (osascript sudo)

渲染进程 (Vue 3 App)
├── 9 个视图页面（欢迎、清理、分析、状态…）
├── 自定义主题引擎 (themes/engine.js)
├── Fluent Design CSS 系统 (style.css)
└── 通过安全桥接调用 IPC (window.electronAPI)

预加载脚本 (preload.js)
└── 安全上下文桥接 (contextBridge)

项目使用三个独立的 Vite 配置，不依赖 electron-vite 封装：

• vite.renderer.config.js — 渲染进程开发服务器 + HMR
• vite.main.config.js — 主进程（库模式，CJS，Node 24）
• vite.preload.config.js — 预加载脚本（库模式，CJS）

清理功能	磁盘分析	系统状态
一键清理系统缓存	可视化磁盘空间分析	实时监控 CPU/内存/磁盘

应用卸载	系统优化	项目清理

项目维护四层测试体系：

CI（GitHub Actions）每次推送自动运行 lint、格式化检查、单元测试和生产构建。

1. 首次运行需要在 macOS 上授予完全磁盘访问权限（系统设置 > 隐私与安全性 > 完全磁盘访问权限）

2. 部分操作需要管理员权限，会通过 macOS 系统对话框请求授权

3. 确保 Mole CLI（mo）在 PATH 中可用

4. 应用偏好设置存储在 localStorage（主题、语言、数据源、开机启动等）

5. 未签名应用：macOS 安全机制会阻止首次启动，需执行以下命令放行：

   sudo xattr -rd com.apple.quarantine /Applications/Revel.app

• Mole CLI — Revel 依赖的命令行工具
• Fluent Design System — Microsoft 设计语言
• Electron — 跨平台桌面框架
• Vue 3 — 渐进式 JavaScript 框架

MIT © a1121611810。详见 LICENSE。

Built with ❤️ and Fluent Design