User Guide

What to do: confirm your machine meets the requirements before installing. Requirements: macOS 14.0 or later; the current build supports Apple Silicon (arm64) only, Intel support undecided; installed size about 3.5 MB (DMG 3,626,907 bytes).

What you will see: the disk image contains the app bundle — drag it into "Applications"; there are no extra memory or disk requirements.

What to verify first: get it only from official channels — the Download page on this site (direct DMG) or the GitHub open-source repo; do not use unofficial sources.

What to do: on first launch the app automatically shows a one-time "First-Use Guide" of three screens (titled, in order, "Look Carefully First", "Does Only One Thing", and "Permissions on Demand"); after reading, click "Get Started".

What you will see: the guide states four safety principles verbatim — scanning reads metadata only, analysis results are all unchecked by default, the only action is moving items to the system Trash, and all data is processed locally without upload or networking.

What to verify first: the guide itself requests no permissions; if you see a system permission prompt at that point, it contradicts this description — please record the page and wording and report it.

Note: after the guide completes, a completion marker is written locally, so it appears automatically only once; "View First-Use Guide Again" in Settings lets you revisit the three screens anytime.

What to do: open the first entry on the left, "Mac Status", and look at the health score and status evidence cards; click "Refresh Now" when you want updated readings.

What you will see: the score's expandable "Score Basis" lists each deduction actually in effect (like "Storage pressure −18"); the evidence card's "Basis and limitations" expands; trends show "Insufficient data; trend not shown for now" when samples are insufficient.

What to verify first: deductions should come only from storage pressure, sustained high load, memory pressure, and network disconnection; memory judgment follows system memory pressure, not usage percentage; this page should show no cleanup or delete buttons.

Note: "Refresh Now" only re-reads local metrics — it scans no directories and modifies no files.

What to do: under "Space Cleanup" on the left, enter "Cleanup Items" (the default subpage, also ⌘1) and click "Start Scan".

What you will see: results in four scan categories — user and app caches, user logs, and crash reports (all three marked "Safe to Clean"), plus downloaded installers (marked "Confirm Recommended", unchecked by default).

First verify paths and contents with "Show in Finder" or "Quick Look" in the candidate details, then decide what to check; the UI explains that items moved to the Trash can be put back manually in Finder.

What to verify first: when a scan finishes, nothing should be pre-checked; highlighting a row is not selecting it; with nothing checked, no usable execution entry should appear.

What to do: switch to "Space Analysis" (⌘2), add a smaller folder yourself at "Choose Scope" (e.g. "Downloads"), then click "Start Scan"; the button is disabled until a scope is selected.

What you will see: the results area contains "Capacity Distribution", "Directory Tree", and "Large Files"; the directory tree can expand/collapse all, with sorting, type filter, and threshold controls (Large Files defaults to 100 MB).

"Storage Whereabouts Diagnosis" on the same page consumes this round of results directly — it will not scan again; "Space Change" needs comparable records within the same scope and shows "Not comparable for now" with the reason when conditions are insufficient.

What to verify first: results describe only the scope selected this time; with no scope selected, your personal folders should never be auto-scanned; the Capacity Distribution denominator is "total counted in this scan", not total disk capacity; "Clear Results" only clears results in the current session memory.

If you use "Manual Handling" on the same page: it only handles items you select one by one and that pass pre-execution re-verification; it offers no permanent deletion, no select-all, and no bulk emptying.

What to do: enter "Deep Uninstall", click "Start Scan", choose an app in the "Installed Apps" list, then decide on leftovers.

What you will see: the app identity, its bundle, exactly associated leftovers, and the read-only "Login Items & Background Associations" area; "Footprint Overview" shows four usage layers and the four-state "Check Completeness" capsule.

What to verify first: leftovers are unchecked by default; only fixed paths with exactly matching Bundle Identifiers are shown; each item can be verified individually with "View Evidence" — viewing evidence itself never selects, ignores, uninstalls, or moves anything.

Boundary reminder: uninstall handles the app bundle first — if the bundle is not successfully moved to the Trash, all leftovers stay untouched; a running app is refused with "The app is still running. Quit it and try again."

What to do: in "Settings", review the five groups — Status Monitoring, Scan Performance, Scan Locations, Privacy & Security, and Space Change Records — plus the System Health Alerts, Permissions, and Ignore List areas.

What you will see: System Health Alerts are off by default and trigger only on sustained states; Space Change recording can be turned off or cleared anytime — turning it off only stops new records and deletes none.

The Permissions area states that both permissions are optional, requested only for the relevant action, and that declining affects no other features; it expands into a four-sentence "Why needed and when requested" explanation.

What to verify first: neither permission is requested at launch — Read Protected Directories appears only when scan results contain unreadable directories and you click through, Send Alerts only when you enable an alert category in Settings; revocation uses in-app deep links straight into System Settings.

Note: "Operation History" on the left reviews completed cleanups and uninstalls read-only; when nothing has been executed it shows "No operation records yet".

What to do: choose "About Sin Clean" in the app menu to see the version line (like "Version 1.0.0 (build N)") and the channel line; click "Check for Updates…" when needed.

What you will see: in sequence, possibly "Checking for updates…", "You're up to date.", "New version <version> (build <build>) found", "Downloading", "Continue installation…", "Installing…", "Update installed (<version>).", "<stage> failed: <reason>", and leftover notices.

What to verify first: before installing there must be a second confirmation titled "Install Update" whose body promises "The current Sin Clean will be replaced with the new version <version> (build <build>). The replacement happens locally; if it fails, the current version is restored automatically."

On failure: a failed replacement immediately moves the backup back and reports the result; a failed restore states honestly that the backup remains in its original directory; at launch, backups of unfinished updates are reported as "kept, not deleted" with the directory name.

1. 01

   Scan first, or choose a scope first

   Space Analysis starts no scan without a selected scope and never auto-selects one; every scan only reads information.

2. 02

   Check items one by one

   Cleanup and Manual Handling start with an empty selection — execution is possible only after you check items yourself; uninstall leftovers are likewise unchecked by default.

3. 03

   A second confirmation dialog

   The cleanup dialog shows item count, estimated size, and a path summary; the uninstall dialog shows the bundle plus checked leftovers, their count, total size, and a path summary.

If you want to test "Move to Trash", use only test files you prepared yourself and confirmed are disposable; read the full paths and the confirmation dialog first, then execute.

After execution you can cross-check the execution receipt, Operation History, and Finder's Trash; note that moving to the Trash does not free disk space immediately, and restoration is still done by Finder.

Do not experiment with real work files or frequently used apps: uninstall handles the app bundle first — if the bundle fails, all associated files are kept, and running apps are refused.

The interface covers Simplified Chinese, English, and Traditional Chinese: the source language is Simplified Chinese (zh-Hans), with complete English (en) and Traditional Chinese (zh-Hant) translations — 1,792 keys in the localization catalog, each with both translations.

There is no separate language switch in the app; the interface language follows the system language.