qinze
a65d6f23ec
Fix CLI command bugs surfaced by full real-machine QA: - aitable: make chart/dashboard share update --enabled a string flag so "--enabled false" disables instead of silently enabling (bool flag + space-syntax help example inverted the action); clarify chart update requires --config; make form get filter by view-id client-side so it returns a single form; drop inline // comments from chart JSON examples - chat: resolve conversation-info --user to openDingTalkId, register --id/--conversation-id/--chat aliases; cap list-all-conversations --limit at 100 and reject larger values instead of silent truncation; detect webhook errcode failures instead of wrapping them as success; remove duplicate group/members subcommand registration in help - contact: register --dept/--depts as the primary dept flags to match the RunE parsing (were only registered as --id/--ids) - sheet: emit clean JSON for media-upload and export under --format json, suppressing progress lines that leaked onto stdout - wiki: correct node create --type enum (drop unsupported asheet, add axls/able/appt/adraw/amind) - ding: default message list --type to ALL since the server rejects an empty type Fix helper scripts (mono and multi): - aitable import/export flag names and tableId length regex - mail search --limit, contact dept response keys and userInfo nesting - attendance_my_record whoami compatibility, calendar_schedule_meeting event id unwrapping, drive_tree_list recursion via fileId, report scripts migrated off deprecated report list/detail Sync skill docs (mono and multi) to real-machine behavior across all products: command indexes, flag names, enums, return-structure keys, and cross-product intent routing; annotate genuinely server-side limitations and the no-op global --jq/--fields flags.
6.8 KiB
6.8 KiB
邮件
SKILL.md 中 #9 内联 4 条 lite：
mail-list-mailbox、mail-search、mail-send、mail-reply-forward，见dws-shared/references/best_practices/_common/lite-recipes.md。下列 recipe、专用规则与消歧请在命中 #9 且超出上述 lite 时阅读本文。 产品命令见 mail.md。通用批量/并行见dws-shared/references/best_practices/_common/conventions.md。
专用规则（#9 非 lite 步骤必守）
- KQL 语法强制：邮件搜索的查询条件只能通过
--query参数以 KQL 语法传入（如subject:周报），禁止臆造--subject、--sender、--from-address等不存在的 flag。详见 mail.md 中 KQL 查询字段说明。 - 邮箱地址前置：大部分邮件命令需要
--email或--from参数，执行前必须先通过mail mailbox list获取当前用户邮箱（返回字段是emailAccounts），禁止猜测邮箱地址。 - 查找他人邮箱：需要获取某人邮箱地址时，不要用
mailbox list（只返回自己的），必须走三路并发查询流程（见 mail.md 中「查找他人邮箱地址」章节）。 - 附件下载三步走：先
message search搜索邮件获取 messageId，再attachment list获取附件 ID 和文件名，最后逐个attachment download下载。不存在download_batch/download_all等批量下载命令，禁止编造。 - 危险操作确认：
batch-delete执行前必须向用户确认，同意后加--yes。
与其他场景消歧
- "给某人发邮件"（只知姓名不知邮箱）→ 先走「查找他人邮箱地址」三路并发，再
mail-send。 - "找某人邮箱"（终点是获取邮箱地址）→ 三路并发查询，不走
mail-search。 - "搜某人发的邮件"（终点是邮件内容）→
mail-search，KQL 用from:xxx。 - "催+邮件" →
mail-send发催促邮件，不是 #1 消息。 - "邮件+待办" → 先
mail-search找邮件内容，再走 #2 创建待办。
Recipe 速查（本表步骤，非 SKILL lite）
| Recipe | 步骤 |
|---|---|
mail-get |
mail message get --email <邮箱> --id <messageId> → 查看邮件完整内容（含正文） |
mail-message-list |
mail message list --email <邮箱> → 列出文件夹中的邮件（默认收件箱）；--folder-id <id> 指定文件夹、--limit <n> 分页 |
mail-folder-list |
mail folder list --email <邮箱> → 列举文件夹；--folder <id> 查子文件夹 |
mail-folder-manage |
mail folder create/update/delete：创建/重命名/删除文件夹（先 folder list 取 folders[].id） |
mail-tag-list |
mail tag list --email <邮箱> → 列举邮件标签 |
mail-tag-manage |
mail tag create/update/delete：创建/重命名/删除标签（先 tag list 取 tags[].id，系统标签不可改删） |
mail-thread-get |
mail thread get --email <邮箱> --id <conversationId> → 获取会话（邮件线程）详情 |
mail-thread-list |
mail thread list --email <邮箱> --folder <folderId> --limit <n> → 列出文件夹下的会话 |
mail-thread-manage |
mail thread update/batch-update（标记已读未读/加移标签）、thread trash/batch-trash（移入已删除，须 --yes） |
mail-attachment-list |
mail attachment list --email <邮箱> --id <messageId> → 列举指定邮件的附件 |
mail-attachment-download |
1. mail attachment list --email <邮箱> --id <messageId> → 取附件 id 和 name2. mail attachment download --email <邮箱> --message-id <messageId> --attachment-id <attachmentId> --name <文件名> |
mail-batch-move |
mail message batch-move --email <邮箱> --ids <id1,id2,...> --folder <folderId>（常用 folderId: 2=收件箱, 6=已删除） |
mail-batch-delete |
mail message batch-delete --email <邮箱> --ids <id1,id2,...>（危险操作，须先确认；仅移入已删除文件夹，非物理永久删除） |
mail-batch-update |
mail message batch-update --email <邮箱> --ids <id1,id2,...> --action markRead/markUnread/addTags/removeTags（加移标签需 --tags） |
mail-verify |
mail message verify --email <邮箱> --internet-message-id <id> → 查发送状态（sendStatus 在 message.sendStatus） |
mail-draft-create |
mail draft create --from <邮箱> --subject "<标题>" → 取草稿 ID result.message.id（可选 --to、--content、--cc） |
mail-draft-update |
mail draft update --from <邮箱> --id <draftId> --subject "<新标题>"（可选 --content、--to、--cc） |
mail-draft-send |
mail draft send --from <邮箱> --id <draftId> |
mail-template |
mail template create/list/get/update/delete（草稿模板 --is-draft 不出现在 list，只能 get；非草稿模板不可 update） |
mail-contact |
mail contact create/list/update/batch-delete：管理个人联系人（非通讯录搜人，搜人用 user search） |
mail-auto-reply-get |
mail auto-reply get --email <邮箱> → 获取自动回复配置 |
mail-rule |
mail rule list/create/update/delete/adjust：管理个人收信规则 |
Full / 多步组合
| Recipe | 行动指南（固定路线） |
|---|---|
| search-and-download-attachment | 1. mail mailbox list → 从 emailAccounts 取邮箱2. mail message search --email <邮箱> --query "<KQL>" --limit 20 → 取 messageId 列表3. 对每封邮件执行 mail attachment list --email <邮箱> --id <messageId> → 列出附件取 id 和 name4. 对每个附件逐个执行 mail attachment download --email <邮箱> --message-id <messageId> --attachment-id <attachmentId> --name <文件名>（仅支持逐个下载，不存在批量下载命令） |
| search-reply-forward | 1. mail mailbox list → 取邮箱2. mail message search --email <邮箱> --query "<KQL>" --limit 10 → 取 messageId3. 展示搜索结果供用户选择 4. 按用户指示执行 reply / reply-all / forward（参见 lite mail-reply-forward） |
| batch-mail-cleanup | 1. mail mailbox list → 从 emailAccounts 取邮箱2. mail message search --email <邮箱> --query "<KQL>" --limit 100 → 取多个 messageId3. 展示列表供用户确认 4. mail message batch-move --email <邮箱> --ids <id1,id2,...> --folder 6 或 batch-delete 都是移入「已删除」文件夹，并非物理永久删除（对已在已删除文件夹的邮件再执行返回 success 但无效；CLI 无永久删除路径，需在客户端手动清空） |
| send-to-person-by-name | 1. mail mailbox list → 取发件邮箱2. 走「查找他人邮箱地址」三路并发查询获取收件人邮箱（见 mail.md） 3. mail message send --from <发件邮箱> --to <收件邮箱> --subject "<标题>" --content "<内容>" |