MangoDisk README

项目的 README,来自 github.com/harry0703/MangoDisk。合并为一个 markdown 文件:README.md。

MangoDisk application icon MangoDisk

Disk cleanup, storage analysis, and privacy protection for macOS, Windows, and Linux

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Русский

Latest release macOS supported Windows supported Linux supported Tauri 2 Rust Core

MangoDisk Overview dashboard

What MangoDisk Can Do

Storage

1. Deep Cleanup

Recover storage used by everyday apps, development work, and AI tools. Find caches, build artifacts, and local models in one place, without hunting through hidden folders:

Smart recommendations help you make safe choices quickly. You can also review items individually and see the estimated reclaimable space upfront, keeping every cleanup predictable and under your control.

2. Large File Cleanup

Quickly find the largest files and reclaim space used by old installers, videos, archives, and other bulky content without digging through folders one by one.

3. Duplicate File Cleanup

Reclaim space taken up by duplicate copies without treating files as duplicates just because they share a name. Smart selection keeps at least one file in every group, so cleanup stays effortless and safe.

4. Disk Space Analysis

See where your disk space is going at a glance. Switch between a treemap and a sunburst chart, and choose how many levels to display to explore space usage and folder structure. Browse folders alongside the file list to quickly find the largest folders and files and decide what to clean up.

Privacy & Security

5. Privacy Cleanup

Keep browsing history, searches, cookies, recent items, and clipboard data from lingering on your computer. Clear traces left by browsers, applications, and the system to reduce exposure of your activity and make everyday privacy easier to manage.

System Tools

6. Application Uninstall and Cleanup

Uninstall applications and clear related caches, settings, and leftovers so removing an application actually gives you the space back. Potential personal files are handled cautiously to reduce the risk of accidental deletion.

7. Startup Item Management

Reduce unnecessary startup delays and background resource use, so your computer starts faster and feels lighter. Turn items back on at any time when you need them again.

8. System Optimization

Reduce unnecessary settings that slow down your system or get in the way. Balance performance, privacy, and personal preferences so your computer feels faster and easier to use.

9. System Maintenance

Fix common problems like missing search results, incorrect icons, no sound, or network connection failures—without hunting down fixes or typing complex commands. Get your computer back to normal sooner.

10. Context Menus (Windows)

Available since version 1.2.3

Keep right-click menus tidy and easy to use. Browse entries by menu location or app, disable, restore or remove supported items, and adjust menus for individual file types.

Add everyday actions such as copying paths and opening a terminal, along with shortcuts to system tools.

Activity

11. Operation History

Keep a clear record of every cleanup and system change. See how much space you recovered, what completed successfully, and whether anything still needs your attention.

Resource Usage and Memory Management

Available since version 1.1.1

Track CPU, GPU, memory, network speeds and disk activity in real time, with trends to help you understand resource use. On supported devices, you can also check temperatures, power usage, battery status and disk health.

Quickly find resource-heavy apps, quit those you no longer need, and free memory manually or automatically.

Display metrics in the menu bar, taskbar, system tray or a floating desktop window. Customize the content and appearance to keep an eye on your computer without opening the main window.

AI Explanations

Available since version 1.1.0

Unsure what an item does or what might happen if you change it? AI explanations use the item's description and current scan results to explain its purpose and what to consider before taking action. Spend less time looking things up and make more informed choices.

Get explanations directly from items in Deep Cleanup (built-in rules), Privacy Cleanup, Startup Item Management, System Optimization, and System Maintenance.

Official releases include free explanations each day, with the option to connect your own AI service. AI offers guidance; you decide which actions to take.

Safety and Rules

[!IMPORTANT] MangoDisk puts data safety ahead of reclaiming more space. Cleanup rules and system optimizations only ship after their safety boundaries are clearly defined and they pass validation on real systems.

MangoDisk scans in read-only mode by default. Before cleanup, deletion, uninstall, or system setting changes begin, you can review and confirm exactly what will happen. Results are saved to Operation History.

System Optimization only uses built-in, validated settings. It never accepts arbitrary registry paths, terminal commands, or scripts. MangoDisk reads each setting again after changing it and calls out high-impact items and changes that require administrator access or a restart.

MangoDisk maintains its own cleanup rules. Third-party projects may provide research leads, but a candidate rule is only accepted after reliable sources, safe boundaries, and real-system behavior have been verified. Anything without a clear safety boundary is excluded.

The complete rule library and revision history are open for inspection: view the MangoDisk cleanup rule library.

Screenshots

Deep Cleanup
Make room for what matters by clearing accumulated caches, build artifacts, and AI models you no longer need

MangoDisk Deep Cleanup interface

Large File Cleanup
Find the files taking up the most space without digging through folders

MangoDisk Large File Cleanup interface
Duplicate File Cleanup
Safely remove exact duplicates while keeping at least one copy

MangoDisk Duplicate File Cleanup interface
Disk Space Analysis
See where your storage is going and quickly find the largest files and folders

MangoDisk Disk Space Analysis interface
Startup Item Management
Reduce unnecessary startup programs for faster sign-in and less background activity

MangoDisk Startup Item Management interface
Application Uninstall and Cleanup
Uninstall applications and remove related leftovers to reclaim more space

MangoDisk Application Uninstaller interface
System Optimization
Optimize performance, privacy, and everyday usability in one click

MangoDisk System Optimization interface
System Maintenance
Fix common system issues quickly and get your computer back to normal

MangoDisk System Maintenance interface
Privacy Cleanup
Leave fewer activity traces behind and keep everyday use more private

MangoDisk Privacy Cleanup interface

Before You Begin

[!CAUTION]

  1. Cleanup, permanent deletion, and uninstall operations may not be reversible. Review the selected content and keep reliable backups of important data.
  2. Before running system maintenance or changing a startup item or system setting, make sure you understand its purpose and impact.
  3. Some system optimizations can affect security, privacy, battery life, or update behavior.

Desktop App

Download MangoDisk from the official download page or GitHub Releases, then follow the instructions for your operating system below.

macOS

Requirements: macOS Monterey 12.5 or later.

Install with Homebrew:

brew install --cask harry0703/tap/mangodisk

Manual installation: Download the DMG from the official download page, open it, and drag MangoDisk into the Applications folder.

Windows

Requirements: 64-bit Windows 10 or later.

Install with PowerShell:

irm https://get.mangodisk.app | iex

Install with WinGet (official source):

winget install --id MangoDisk.MangoDisk --exact --source winget

Manual installation: Download the Windows installer from the official download page and follow the installation prompts.

Linux

Recommended: Ubuntu 22.04 LTS or later, on x64 or ARM64.

Available as .deb packages and AppImages. Compatibility with other Linux distributions depends on their system libraries and desktop environment.

Install with Homebrew: Requires a recent Homebrew version and a desktop environment.

brew install --cask harry0703/tap/mangodisk

Install from the terminal (Debian/Ubuntu): This command detects your architecture and installs the latest matching .deb package.

curl -fsSL https://get.mangodisk.app/linux | bash

Manual installation: Choose the package for your architecture on the official download page.

Command Line (CLI)

Use MangoDisk in your terminal or scripts, with the same safety-first cleanup engine as the desktop app.

macOS

Install with Homebrew:

brew install harry0703/tap/mangodisk-cli

Windows

Install with PowerShell:

irm https://get.mangodisk.app/cli | iex

Install with WinGet (official source):

winget install --id MangoDisk.CLI --exact --source winget

Linux

Prebuilt standalone CLI downloads are not yet available for Linux. Follow the Build from Source instructions below to build it yourself.

Usage Examples

If mangodisk is not immediately available after installation, open a new terminal, then verify the installation:

mangodisk --version

Common commands:

# Scan and show cleanable content without changing anything
mangodisk clean

# Apply the same smart recommendations as the desktop application
mangodisk clean --apply

# Preview all selectable content without deleting anything
mangodisk clean --apply --selection all --dry-run

# Produce machine-readable JSON output
mangodisk clean --format json --no-progress

mangodisk clean only scans and never modifies files by default. To perform cleanup in a non-interactive environment, you must also pass --yes to confirm explicitly. Run the following command for all available options:

mangodisk clean --help

Build from Source

Prerequisites

For platform-specific dependencies, see the Tauri 2 prerequisites.

Get the Source and Run the Desktop Application

git clone https://github.com/harry0703/MangoDisk.git
cd MangoDisk
pnpm install --frozen-lockfile
pnpm tauri:dev

Run the Required Checks

pnpm check
cargo test --manifest-path src-tauri/Cargo.toml -p mangodisk-core

Build the Desktop Installer

pnpm tauri:build

Build the CLI

pnpm cli:build

Local builds do not include the signing, notarization, or update metadata provided by official MangoDisk releases. Use them for local development and validation only.

Contributing

Issues, cleanup rules, fixes, and new features are welcome. Read CONTRIBUTING.md and AGENTS.md before getting started.

Routine cleanup coverage should use build-validated, declarative TOML rules. See src-tauri/crates/mangodisk-core/rules/README.md for the rule schema, safety constraints, and validation instructions.

Before submitting changes, run at least:

pnpm check
cargo test --manifest-path src-tauri/Cargo.toml -p mangodisk-core

Report security vulnerabilities privately through GitHub Security Advisories as described in SECURITY.md. Do not open a public issue for a security vulnerability.

Technology Stack

License

MangoDisk is open source under the GNU General Public License v3.0. Third-party components remain subject to their respective licenses.

MangoDisk (harry0703/MangoDisk)

正在搜索数据库…

这是什么?MangoDisk 是一款以安全为先的磁盘清理与存储分析工具,适用于 macOS、Windows 和 Linux。它可以找出可回收的缓存、大文件和重复文件,支持卸载应用、管理开机启动项,并提供系统优化和维护工具。
这是桌面应用还是命令行工具?两者兼有:它是基于 Tauri 构建、使用 Vue 3/TypeScript 界面的桌面应用,同时还提供一个命令行界面,与桌面应用使用同一套清理引擎。
我该如何安装 MangoDisk?在 macOS 和 Windows 上,你可以通过 Homebrew 或 WinGet/PowerShell 安装,也可以直接下载 DMG 或 Windows 安装程序。在 Linux 上,提供 .deb 软件包和 AppImage 格式,并附带一个可自动检测架构的安装脚本,适用于 Debian/Ubuntu。
清理操作总是安全且可以撤销的吗?并非如此。清理、永久删除和卸载操作可能无法撤销,因此你应当先检查所选内容,并提前备份。该工具默认以只读模式扫描,并且只执行经过验证的内置规则,不会运行任意脚本或修改注册表。
支持哪些操作系统版本?macOS Monterey 12.5 及以上版本、64 位 Windows 10 及以上版本,以及 Linux(推荐 x64 或 ARM64 架构的 Ubuntu 22.04 LTS 及以上版本);其他 Linux 发行版则取决于其系统库。
它会把我的数据发送到别处吗?扫描和清理均在本地运行,默认只读;不过,AI 解释功能可以选择连接 AI 服务,以获取项目的相关背景信息。文档中没有提到清理引擎本身会上传扫描数据。
重复文件清理如何避免误删?它识别的是真正的重复文件,而不是仅仅名称相同的文件;智能选择功能会在每一组中始终保留至少一份副本,因此清理默认是安全的。
AI 解释功能是什么?它会结合某个项目的说明及当前扫描结果,解释该项目的用途,以及修改或删除它可能产生的后果,帮助你在采取行动前做出判断。官方发布版本提供每日免费的解释次数,并可选择连接你自己的 AI 服务。
我可以通过命令行以非交互方式运行清理吗?可以。不过 mangodisk clean 默认只扫描,从不修改文件;你必须显式添加 --yes 参数,才会真正执行清理。
清理规则在添加前如何验证?MangoDisk 维护着自己的规则库。候选规则只有在经过可靠来源、安全边界和真实系统行为的验证后才会被接受;任何没有明确安全边界的规则都会被排除,完整的规则库也可供查阅。
作者
harry0703
大小
11.2 MB
星标
5.9K
时长
3个月
提交 · 90 天