china-email

name	china-email
description	Use domestic IMAP/SMTP email accounts such as QQ Mail, NetEase Mail, Ali Mail, Tencent Exmail, 139 Mail, or custom enterprise mailboxes to search messages, read email, save attachments, summarize inboxes, and draft or send replies.

China Email

Overview

Use this skill when the user wants to work with domestic Chinese email accounts through the China Email plugin. The plugin is protocol-based, so prefer IMAP search and message reads before making claims about mailbox state.

Setup Expectations

• The mailbox must have IMAP/SMTP enabled in the provider's web settings.
• The password should be an authorization code, app password, or client password.
• Prefer china_email_start_setup for setup so users do not need to edit JSON.
• The account config is saved to ~/.china-email/accounts.json by the setup wizard, and can still be overridden with CHINA_EMAIL_CONFIG or single-account environment variables.

Workflow

1. Call china_email_list_accounts first if the user did not specify which configured account to use.
2. If no accounts are configured, call china_email_start_setup and give the user the returned local URL.
3. Use china_email_search_messages to shortlist messages by sender, subject, date, unread state, or text.
4. Use china_email_read_message for the specific UID before summarizing, replying, or saving attachments.
5. Use china_email_save_attachments only when the user asks to download or inspect attachments locally.
6. For drafts or replies, prefer china_email_create_draft so the message appears in the provider's Drafts mailbox for user review.
7. For sending, call china_email_send_email with dry_run: true first unless the user explicitly asked to send immediately. With the current tool, dry_run: true saves a mailbox draft by default; use preview_only: true only when the user wants chat-only preview text.

Write Safety

• Never expose configured passwords or authorization codes.
• Preserve exact recipients, subjects, dates, and quoted facts from source messages.
• Treat dry_run: false as a real send operation and use it only with explicit user intent.
• Do not delete, archive, mark read, move, or label messages in this MVP.

Output Conventions

• Summaries should state the mailbox scope, such as account, mailbox, and scan limit.
• Draft replies should be saved to the mailbox Drafts folder when possible, with a clear subject and recipient list.
• If a search is limited to recent messages, say that plainly.