QQ Mail Manager

Problem Addressed

Command-line QQ Mail handling tends to fail in two places: first, mail_id is only unique inside a single folder, so cross-folder operations that deduplicate by mail_id alone can delete, move, or send the wrong message; second, deletion, moving, and sending are destructive actions, so they must be previewed and confirmed before execution.

How It Works

The skill wraps QQ Mail management into explicit scripts for listing folders, browsing/searching mail, reading message details, downloading attachments, marking read/unread, moving/deleting mail, and sending mail.

• Unique addressing: every operation must use the folder + mail_id combination instead of mail_id alone.
• Preview first: deletion, moving, and sending should show key fields such as folder, mail_id, subject, sender, and date, then wait for confirmation.
• Controlled pagination: only one search_emails call is made per turn; when has_more=true, the user is asked whether to continue.
• Safer sending: use --body-file and --subject-file when the body contains line breaks, quotes, HTML, or is long, reducing shell-escaping issues.

Boundaries And Notes

• QQ Mail must have IMAP/SMTP enabled, and the setup should use the mailbox address plus authorization code, not the login password.
• Deletion moves mail to the trash and does not support permanent deletion.
• Semantic search should be used only when the user explicitly asks for it; keyword, field, or date filtering should use search_emails.
• If a script returns error or partial, stop destructive follow-up actions and report the issue to the user.