From d4116fbd49b47ab735de354a5386a6288130b992 Mon Sep 17 00:00:00 2001
From: tw93 <tw93@qq.com>
Date: Sun, 1 Mar 2026 21:04:48 +0800
Subject: [PATCH] docs(readme): reduce duplicate quick-start guidance

---
 README.md | 21 ++++++++-------------
 1 file changed, 8 insertions(+), 13 deletions(-)

diff --git a/README.md b/README.md
index 67ca726..2c7ad76 100644
--- a/README.md
+++ b/README.md
@@ -61,19 +61,15 @@ mo remove                    # Remove Mole from system
 mo --help                    # Show help
 mo --version                 # Show installed version
 
-mo clean --dry-run           # Preview the cleanup plan
-mo clean --whitelist         # Manage protected caches
-mo clean --dry-run --debug   # Detailed preview with risk levels and file info
+# Safe preview before applying changes
+mo clean --dry-run
+mo uninstall --dry-run
+mo purge --dry-run
 
-mo optimize --dry-run        # Preview optimization actions
-mo optimize --debug          # Run with detailed operation logs
+# --dry-run also works with: optimize, installer, remove, completion, touchid enable
+mo clean --dry-run --debug   # Preview + detailed logs
 mo optimize --whitelist      # Manage protected optimization rules
-mo uninstall --dry-run       # Preview app uninstall actions
-mo purge --dry-run           # Preview project artifact purge
-mo installer --dry-run       # Preview installer cleanup actions
-mo touchid enable --dry-run  # Preview Touch ID sudo config changes
-mo completion --dry-run      # Preview shell completion file updates
-mo remove --dry-run          # Preview Mole self-removal
+mo clean --whitelist         # Manage protected caches
 mo purge --paths             # Configure project scan directories
 mo analyze /Volumes          # Analyze external drives only
 ```
@@ -81,8 +77,7 @@ mo analyze /Volumes          # Analyze external drives only
 ## Tips
 
 - Video tutorial: Watch the [Mole tutorial video](https://www.youtube.com/watch?v=UEe9-w4CcQ0), thanks to PAPAYA 電腦教室.
-- Safety first: Deletions are permanent. Review carefully with dry-run before applying changes. See [Security Audit](SECURITY_AUDIT.md).
-- Debug and logs: Use `--debug` for detailed logs. Combine with `--dry-run` for a full preview. File operations are logged to `~/.config/mole/operations.log`. Disable with `MO_NO_OPLOG=1`.
+- Safety and logs: Deletions are permanent. Review with `--dry-run` first, and add `--debug` when needed. File operations are logged to `~/.config/mole/operations.log`. Disable with `MO_NO_OPLOG=1`. See [Security Audit](SECURITY_AUDIT.md).
 - Navigation: Mole supports arrow keys and Vim bindings `h/j/k/l`.
 
 ## Features in Detail