Clean WeChat And WPS Storage

Use this skill for macOS storage cleanup of WeChat and WPS Office. Always protect user data by scanning first, interviewing for cleanup scope, presenting a plan, and waiting for explicit confirmation before moving anything.

Workflow

1. Run a read-only scan:

``bash python3 scripts/wechatwpsstorage.py scan --format markdown ``

1. Interview the user before planning. Ask only about scopes that exist and have non-trivial size.
2. Present a cleanup plan with:

- target items and sizes - data impact - estimated total moved to Trash - rollback location and validation steps

1. Do not clean until the user explicitly confirms the plan.
2. After confirmation, run a dry run with the selected item IDs:

``bash python3 scripts/wechatwpsstorage.py move-to-trash --ids <id> <id> ``

1. If the dry run matches the confirmed plan, execute:

``bash python3 scripts/wechatwpsstorage.py move-to-trash --stop-apps --execute --ids <id> <id> ``

1. Re-run scan and report before/after sizes. Tell the user the Trash backup path and that disk space is not fully reclaimed until Trash is emptied.

Cleanup Scope Rules

Use these defaults when the user is unsure:

Never delete app bundles in /Applications unless the user asks to uninstall the app. Never permanently delete app data directly; move it to ~/.Trash/app-cleanup-YYYYMMDD-HHMMSS/.

Interview Prompts

Ask concise questions in Chinese. Use concrete choices:

• "只清缓存和日志，还是也清插件/运行时缓存？"
• "WPS 云文档本地缓存要清吗？清之前请确认云端已有文件。"
• "微信聊天数据要怎么处理：只清聊天媒体，还是删除本机这个账号的聊天记录？"
• "如果有多个微信账号目录，逐个列出大小并让用户选择账号。"

If the user already states the desired scope, do not re-ask. State the assumption in the plan.

Safety Checklist

Before executing cleanup:

• Confirm all selected item IDs came from scan.
• Confirm the plan says "move to Trash", not permanent delete.
• Stop WeChat and WPS before moving files.
• Preserve original path structure under the Trash backup directory.
• After moving, launch apps only for a basic start check; do not claim full validation of login, cloud sync, or message sending unless actually verified.

Rollback

If the user reports a problem before emptying Trash, restore by moving the affected directory from the backup path to its original path. Stop WeChat and WPS before restoring. Use the preserved path under the backup directory to identify the exact original location.