@fectivnfy112358/minimax-code-web 0.1.0-preview.0 → 0.1.0-preview.3

package/server/assets/skills/lark-tools/cli-skills/lark-mail/references/lark-mail-reply-all.md

@@ -0,0 +1,184 @@
+# mail +reply-all
+
+> **前置条件：** 先阅读 [`../../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+回复全部会自动处理：
+- 自动聚合原邮件发件人、原 To、原 Cc
+- 自动排除当前用户地址，避免回给自己
+- 自动维护会话头（`In-Reply-To` / `References`）
+
+> **默认草稿**：`+reply-all` 默认保存为草稿，不会立即发送。如需立即发送，添加 `--confirm-send` 参数（仅在用户明确确认后使用）。
+
+本 skill 对应 shortcut：`lark-cli mail +reply-all`。
+
+## CRITICAL — 发送工作流（必须遵循）
+
+此命令默认**只保存草稿**，不会发送邮件。回复全部会发送给**所有**原始收件人，需要发送时**必须**按以下步骤操作：
+
+**Step 1** — 创建回复全部草稿（不带 `--confirm-send`）：
+```bash
+lark-cli mail +reply-all --message-id <邮件ID> --body '<回复正文>'
+```
+→ 返回 `draft_id`
+
+**Step 2** — 向用户展示回复摘要（目标邮件、回复内容、完整收件人列表 To/Cc），请求确认发送
+
+**Step 3** — 用户明确同意后，发送该草稿：
+```bash
+lark-cli mail user_mailbox.drafts send --params '{"user_mailbox_id":"me","draft_id":"<Step 1 返回的 draft_id>"}'
+```
+
+**禁止跳过 Step 1 直接使用 `--confirm-send`。禁止在用户未明确同意的情况下执行 Step 3。**
+
+## 命令
+
+```bash
+# 回复全部（默认保存为草稿）— HTML 推荐
+lark-cli mail +reply-all --message-id <邮件ID> --body '<p><b>已完成</b>，详见下方说明。</p>'
+
+# 回复全部并追加收件人/抄送（草稿）
+lark-cli mail +reply-all --message-id <邮件ID> --body '<p>同步更新</p>' --to lead@example.com --cc pm@example.com
+
+# 从回复名单中排除某些地址（草稿）
+lark-cli mail +reply-all --message-id <邮件ID> --body '<p>见上</p>' --remove bot@example.com,noreply@example.com
+
+# 回复全部时插入内嵌图片（推荐：直接用相对路径，自动解析）
+lark-cli mail +reply-all --message-id <邮件ID> --body '<p>详见图示：<img src="./logo.png" /></p>'
+
+# 纯文本回复全部（仅在内容极简时使用）
+lark-cli mail +reply-all --message-id <邮件ID> --body '收到，已处理。'
+
+# 确认发送（用户明确确认后才可使用）
+lark-cli mail +reply-all --message-id <邮件ID> --body '<p>收到，已处理。</p>' --confirm-send
+
+# Dry Run（仅打印请求，不发送）
+lark-cli mail +reply-all --message-id <邮件ID> --body '测试' --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--message-id <id>` | 是 | 被回复的邮件 ID |
+| `--body <text>` | 是 | 回复正文。推荐使用 HTML 获得富文本排版；也支持纯文本。根据回复正文和原邮件正文自动检测 HTML。使用 `--plain-text` 可强制纯文本模式。支持 `<img src="./local.png" />` 相对路径自动解析为内嵌图片（仅支持相对路径，不支持绝对路径） |
+| `--from <email>` | 否 | 发件人邮箱地址（EML From 头）。使用别名（send_as）发信时，设为别名地址并配合 `--mailbox` 指定所属邮箱。默认读取邮箱主地址 |
+| `--mailbox <email>` | 否 | 邮箱地址，指定草稿所属的邮箱（默认回退到 `--from`，再回退到 `me`）。当发件人（`--from`）与邮箱不同时使用。可通过 `accessible_mailboxes` 查询可用邮箱 |
+| `--to <emails>` | 否 | 额外收件人，多个用逗号分隔（追加到自动聚合结果） |
+| `--cc <emails>` | 否 | 额外抄送，多个用逗号分隔 |
+| `--bcc <emails>` | 否 | 密送邮箱，多个用逗号分隔 |
+| `--remove <emails>` | 否 | 从自动聚合结果中排除的邮箱，多个用逗号分隔 |
+| `--plain-text` | 否 | 强制纯文本模式，忽略所有 HTML 自动检测。不可与 `--inline` 同时使用 |
+| `--attach <paths>` | 否 | 附件文件路径，多个用逗号分隔。相对路径 |
+| `--inline <json>` | 否 | 高级用法：手动指定内嵌图片 CID 映射。推荐直接在 `--body` 中使用 `<img src="./path" />`（自动解析）。仅在需要精确控制 CID 命名时使用此参数。格式：`'[{"cid":"mycid","file_path":"./logo.png"}]'`，在 body 中用 `<img src="cid:mycid">` 引用。不可与 `--plain-text` 同时使用 |
+| `--signature-id <id>` | 否 | 签名 ID。附加邮箱签名到回复正文与引用块之间。运行 `mail +signature` 查看可用签名。不可与 `--plain-text` 同时使用 |
+| `--confirm-send` | 否 | 确认发送回复（默认只保存草稿）。仅在用户明确确认后使用 |
+| `--send-time <timestamp>` | 否 | 定时发送时间，Unix 时间戳（秒）。需至少为当前时间 + 5 分钟。配合 `--confirm-send` 使用可定时发送邮件 |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+## 返回值
+
+默认（草稿模式）：
+```json
+{
+  "ok": true,
+  "data": {
+    "draft_id": "草稿ID",
+    "tip": "draft saved. To send: lark-cli mail user_mailbox.drafts send --params '{...}'"
+  }
+}
+```
+
+`--confirm-send` 模式：
+```json
+{
+  "ok": true,
+  "data": {
+    "message_id": "邮件ID",
+    "thread_id":  "会话ID"
+  }
+}
+```
+
+## 典型场景
+
+### 场景 1：用户说"帮我回复全部说同意"（只创建草稿）
+```bash
+lark-cli mail +reply-all --message-id <邮件ID> --body '<p>同意，没有问题。</p>'
+```
+→ 返回 `draft_id`，告诉用户回复全部草稿已创建。
+
+### 场景 2：用户说"回复全部说已确认"（需要发送）
+```bash
+# Step 1: 创建回复全部草稿
+lark-cli mail +reply-all --message-id <邮件ID> --body '<p>已确认。</p>'
+# → 返回 draft_id
+
+# Step 2: 向用户确认 "回复全部草稿已创建：收件人 alice@, bob@, carol@，内容「已确认。」确认发送吗？"
+
+# Step 3: 用户确认后发送
+lark-cli mail user_mailbox.drafts send --params '{"user_mailbox_id":"me","draft_id":"<draft_id>"}'
+```
+
+### 场景 3：用户说"下午 3 点回复全部说已确认"（定时发送）
+```bash
+# Step 1: 创建回复全部草稿
+lark-cli mail +reply-all --message-id <邮件ID> --body '<p>已确认。</p>'
+# → 返回 draft_id
+
+# Step 2: 向用户确认 "回复全部草稿已创建：收件人 alice@, bob@, carol@，内容「已确认。」定时 <目标时间> 发送。确认吗？"
+
+# Step 3: 用户确认后定时发送（send_time 为 Unix 时间戳，需至少当前时间 + 5 分钟）
+lark-cli mail user_mailbox.drafts send --params '{"user_mailbox_id":"me","draft_id":"<draft_id>"}' --data '{"send_time":"<unix_timestamp>"}'
+```
+
+### 场景 4：用户说"等等，先不回复了"（取消定时发送）
+```bash
+# 取消定时发送（取消后邮件变回草稿）
+lark-cli mail user_mailbox.drafts cancel_scheduled_send --params '{"user_mailbox_id":"me","draft_id":"<draft_id>"}'
+```
+→ 取消成功后邮件恢复为草稿状态，用户可重新编辑或在之后重新发送。
+
+## 实现说明
+
+- 自动收件人规则：原发件人优先进入 To，原 To/Cc 进入 Cc。
+- 地址会去重（大小写不敏感）。
+- 自动排除当前用户地址（enterprise email），并叠加 `--remove` 规则。
+- 通过 raw EML 维护会话头并尽量复用原 `thread_id`。
+
+## 发送后跟进
+
+回复发送成功后：
+
+**1. 确认投递状态**（仅立即发送 — 无 `--send-time` 时必须）
+
+用返回的 `message_id` 查询投递状态：
+
+```bash
+lark-cli mail user_mailbox.messages send_status --params '{"user_mailbox_id":"me","message_id":"<发送返回的 message_id>"}'
+```
+
+状态码：1=正在投递, 2=投递失败重试, 3=退信, 4=投递成功, 5=待审批, 6=审批拒绝。向用户简要报告投递结果，异常状态需重点提示。
+
+**1b. 定时发送（指定了 `--send-time`）**
+
+定时发送不会立即产生 `message_id`，因此 `send_status` 在定时发送成功后会返回"待发送"状态，**不建议在定时发送后立即查询**。可在预定发送时间后再查询。
+
+如需取消定时发送：
+
+```bash
+lark-cli mail user_mailbox.drafts cancel_scheduled_send --params '{"user_mailbox_id":"me","draft_id":"<draft_id>"}'
+```
+
+**取消后邮件会变回草稿**，可继续编辑或在之后重新发送。
+
+**2. 标记已读**（可选）— 询问用户是否需要将原邮件标记为已读。如果用户同意：
+
+```bash
+lark-cli mail user_mailbox.messages batch_modify_message --params '{"user_mailbox_id":"me"}' --data '{"message_ids":["<原邮件ID>"],"remove_label_ids":["UNREAD"]}'
+```
+
+## 相关命令
+
+- `lark-cli mail +reply` — 仅回复发件人
+- `lark-cli mail +forward` — 转发邮件
+- `lark-cli mail user_mailbox.messages get` — 查看邮件详情

package/server/assets/skills/lark-tools/cli-skills/lark-mail/references/lark-mail-reply.md

@@ -0,0 +1,220 @@
+# mail +reply
+
+> **前置条件：** 先阅读 [`../../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+回复指定邮件，自动处理：
+- 主题前缀 `Re: `（已含常见回复前缀时不重复叠加）
+- 默认收件人为原邮件发件人
+- RFC 2822 会话头（`In-Reply-To` / `References`）维护邮件会话
+
+> **默认草稿模式**：`+reply` 默认保存为草稿，不会立即发送。如需立即发送，使用 `--confirm-send` 参数（须经用户明确确认）。**优先使用 `+reply` 而不是 `+draft-create` 来创建回复草稿**，因为 `+reply` 会自动处理主题、收件人和会话头。
+
+本 skill 对应 shortcut：`lark-cli mail +reply`，内部步骤：
+1. `GET /open-apis/mail/v1/user_mailboxes/me/messages/{message_id}` — 获取原邮件元数据
+2. `GET /open-apis/mail/v1/user_mailboxes/me/profile` — 获取邮箱主地址（`primary_email_address`，填入默认 From 头）
+3. `POST /open-apis/mail/v1/user_mailboxes/me/drafts` — 创建草稿
+4. `POST /open-apis/mail/v1/user_mailboxes/me/drafts/{draft_id}/send` — 发送草稿（仅在指定 `--confirm-send` 时执行）
+
+## CRITICAL — 发送工作流（必须遵循）
+
+此命令默认**只保存草稿**，不会发送邮件。需要发送时，**必须**按以下步骤操作：
+
+**Step 1** — 创建回复草稿（不带 `--confirm-send`）：
+```bash
+lark-cli mail +reply --message-id <邮件ID> --body '<回复正文>'
+```
+→ 返回 `draft_id`
+
+**Step 2** — 向用户展示回复摘要（目标邮件、回复内容、收件人），请求确认发送
+
+**Step 3** — 用户明确同意后，发送该草稿：
+```bash
+lark-cli mail user_mailbox.drafts send --params '{"user_mailbox_id":"me","draft_id":"<Step 1 返回的 draft_id>"}'
+```
+
+**禁止跳过 Step 1 直接使用 `--confirm-send`。禁止在用户未明确同意的情况下执行 Step 3。**
+
+## 命令
+
+```bash
+# 回复一封邮件（默认保存为草稿，返回 draft_id）— HTML 推荐
+lark-cli mail +reply --message-id <邮件ID> --body '<p><b>已收到</b>，稍后跟进。</p>'
+
+# 回复并追加收件人/抄送（保存为草稿）
+lark-cli mail +reply --message-id <邮件ID> --body '<p>已处理</p>' --to lead@example.com --cc colleague@example.com
+
+# 回复时插入内嵌图片（推荐：直接用相对路径，自动解析）
+lark-cli mail +reply --message-id <邮件ID> --body '<p>详见图示：<img src="./logo.png" /></p>'
+
+# 纯文本回复（仅在内容极简时使用）
+lark-cli mail +reply --message-id <邮件ID> --body '收到，谢谢！'
+
+# 指定发件人地址
+lark-cli mail +reply --message-id <邮件ID> --body '收到' --from me@example.com
+
+# 确认发送回复（用户明确确认后使用）
+lark-cli mail +reply --message-id <邮件ID> --body '<p>收到，谢谢！</p>' --confirm-send
+
+# Dry Run（仅打印请求，不执行）
+lark-cli mail +reply --message-id <邮件ID> --body '<p>测试</p>' --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--message-id <id>` | 是 | 被回复的邮件 ID |
+| `--body <text>` | 是 | 回复正文。推荐使用 HTML 获得富文本排版；也支持纯文本。根据回复正文和原邮件正文自动检测 HTML。使用 `--plain-text` 可强制纯文本模式。支持 `<img src="./local.png" />` 相对路径自动解析为内嵌图片（仅支持相对路径，不支持绝对路径） |
+| `--from <email>` | 否 | 发件人邮箱地址（EML From 头）。使用别名（send_as）发信时，设为别名地址并配合 `--mailbox` 指定所属邮箱。默认读取邮箱主地址 |
+| `--mailbox <email>` | 否 | 邮箱地址，指定草稿所属的邮箱（默认回退到 `--from`，再回退到 `me`）。当发件人（`--from`）与邮箱不同时使用。可通过 `accessible_mailboxes` 查询可用邮箱 |
+| `--to <emails>` | 否 | 额外收件人，多个用逗号分隔（追加到原发件人） |
+| `--cc <emails>` | 否 | 抄送邮箱，多个用逗号分隔 |
+| `--bcc <emails>` | 否 | 密送邮箱，多个用逗号分隔 |
+| `--plain-text` | 否 | 强制纯文本模式，忽略所有 HTML 自动检测。不可与 `--inline` 同时使用 |
+| `--attach <paths>` | 否 | 附件文件路径，多个用逗号分隔。相对路径 |
+| `--inline <json>` | 否 | 高级用法：手动指定内嵌图片 CID 映射。推荐直接在 `--body` 中使用 `<img src="./path" />`（自动解析）。仅在需要精确控制 CID 命名时使用此参数。格式：`'[{"cid":"mycid","file_path":"./logo.png"}]'`，在 body 中用 `<img src="cid:mycid">` 引用。不可与 `--plain-text` 同时使用 |
+| `--signature-id <id>` | 否 | 签名 ID。附加邮箱签名到回复正文与引用块之间。运行 `mail +signature` 查看可用签名。不可与 `--plain-text` 同时使用 |
+| `--confirm-send` | 否 | 确认发送回复（默认只保存草稿）。仅在用户明确确认后使用 |
+| `--send-time <timestamp>` | 否 | 定时发送时间，Unix 时间戳（秒）。需至少为当前时间 + 5 分钟。配合 `--confirm-send` 使用可定时发送邮件 |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+## 返回值
+
+默认（草稿模式）：
+```json
+{
+  "ok": true,
+  "data": {
+    "draft_id": "草稿ID",
+    "tip": "draft saved. To send: lark-cli mail user_mailbox.drafts send --params '{...}'"
+  }
+}
+```
+
+`--confirm-send` 模式（发送成功）：
+```json
+{
+  "ok": true,
+  "data": {
+    "message_id": "邮件ID",
+    "thread_id":  "会话ID"
+  }
+}
+```
+
+## 典型场景
+
+### 场景 1：用户说"帮我写个回复草稿"（只创建草稿）
+```bash
+lark-cli mail +reply --message-id <邮件ID> --body '<p>收到，谢谢！</p>'
+```
+→ 返回 `draft_id`，告诉用户回复草稿已创建。**注意：用 `+reply` 而不是 `+draft-create`**，这样草稿会自动关联原邮件的主题、收件人和会话头。
+
+### 场景 2：用户说"回复这封邮件说已处理"（需要发送）
+```bash
+# Step 1: 创建回复草稿
+lark-cli mail +reply --message-id <邮件ID> --body '<p>已处理，谢谢。</p>'
+# → 返回 draft_id
+
+# Step 2: 向用户确认 "回复草稿已创建：回复给 alice@example.com，内容「已处理，谢谢。」确认发送吗？"
+
+# Step 3: 用户确认后发送
+lark-cli mail user_mailbox.drafts send --params '{"user_mailbox_id":"me","draft_id":"<draft_id>"}'
+```
+
+### 场景 3：用户说"下午 3 点回复这封邮件说已处理"（定时发送）
+```bash
+# Step 1: 创建回复草稿
+lark-cli mail +reply --message-id <邮件ID> --body '<p>已处理，谢谢。</p>'
+# → 返回 draft_id
+
+# Step 2: 向用户确认 "回复草稿已创建：回复给 alice@example.com，内容「已处理，谢谢。」定时 <目标时间> 发送。确认吗？"
+
+# Step 3: 用户确认后定时发送（send_time 为 Unix 时间戳，需至少当前时间 + 5 分钟）
+lark-cli mail user_mailbox.drafts send --params '{"user_mailbox_id":"me","draft_id":"<draft_id>"}' --data '{"send_time":"<unix_timestamp>"}'
+```
+
+### 场景 4：用户说"等等，先不回复了"（取消定时发送）
+```bash
+# 取消定时发送（取消后邮件变回草稿）
+lark-cli mail user_mailbox.drafts cancel_scheduled_send --params '{"user_mailbox_id":"me","draft_id":"<draft_id>"}'
+```
+→ 取消成功后邮件恢复为草稿状态，用户可重新编辑或在之后重新发送。
+
+## 实现说明
+
+### 会话维护
+
+本 shortcut 通过 raw EML 方式发送，包含标准 RFC 2822 会话头：
+
+```
+In-Reply-To: <原邮件smtp_message_id>
+References:  <原邮件references + smtp_message_id>
+```
+
+若原邮件有 `thread_id`，发送时会一并传入，确保回复归入同一会话。
+
+### 收件人与引用
+
+- 默认回复给原邮件发件人（`head_from`）
+- `--to` 会在默认收件人基础上追加
+- 自动拼接引用块（纯文本或 HTML）
+
+## 发送后跟进
+
+回复发送成功后：
+
+**1. 确认投递状态**（仅立即发送 — 无 `--send-time` 时必须）
+
+用返回的 `message_id` 查询投递状态：
+
+```bash
+lark-cli mail user_mailbox.messages send_status --params '{"user_mailbox_id":"me","message_id":"<发送返回的 message_id>"}'
+```
+
+状态码：1=正在投递, 2=投递失败重试, 3=退信, 4=投递成功, 5=待审批, 6=审批拒绝。向用户简要报告投递结果，异常状态需重点提示。
+
+**1b. 定时发送（指定了 `--send-time`）**
+
+定时发送不会立即产生 `message_id`，因此 `send_status` 在定时发送成功后会返回"待发送"状态，**不建议在定时发送后立即查询**。可在预定发送时间后再查询。
+
+如需取消定时发送：
+
+```bash
+lark-cli mail user_mailbox.drafts cancel_scheduled_send --params '{"user_mailbox_id":"me","draft_id":"<draft_id>"}'
+```
+
+**取消后邮件会变回草稿**，可继续编辑或在之后重新发送。
+
+**2. 标记已读**（可选）— 询问用户是否需要将原邮件标记为已读。如果用户同意：
+
+```bash
+lark-cli mail user_mailbox.messages batch_modify_message --params '{"user_mailbox_id":"me"}' --data '{"message_ids":["<原邮件ID>"],"remove_label_ids":["UNREAD"]}'
+```
+
+## 编辑回复草稿
+
+`+reply` 创建的草稿正文包含引用区（原邮件的引用块）。如果需要编辑回复草稿的正文，**必须通过 `--patch-file` 使用 `set_reply_body` op**，它仅替换用户撰写部分，自动保留引用区。value 只传新的用户撰写内容，不要包含引用区。
+
+```bash
+# 编辑回复草稿正文（自动保留引用区）
+cat > ./patch.json << 'EOF'
+{ "ops": [{ "op": "set_reply_body", "value": "<p>修改后的回复内容</p>" }] }
+EOF
+lark-cli mail +draft-edit --draft-id <draft_id> --patch-file ./patch.json
+```
+
+如果用户要修改引用区内容或去掉引用区，则使用 `set_body` 全量替换。
+
+## 注意事项
+
+- 需要已登录且具备写/读邮件权限（`mail:user_mailbox.message:modify mail:user_mailbox.message:readonly mail:user_mailbox:readonly`）；缺 scope 时按 `cli-skills/lark-shared/SKILL.md` §Agent 代理发起认证 canonical 模板补
+- 邮件 ID 可从 `lark-cli mail user_mailbox.messages list` 获取
+- `--bcc` 仅在发送链路中生效，通常不会在收件方看到
+
+## 相关命令
+
+- `lark-cli mail user_mailbox.messages list` — 列出邮件
+- `lark-cli mail user_mailbox.messages get` — 读取邮件详情
+- `lark-cli mail +reply-all` — 回复全部
+- `lark-cli mail +forward` — 转发邮件

package/server/assets/skills/lark-tools/cli-skills/lark-mail/references/lark-mail-send.md

@@ -0,0 +1,178 @@
+# mail +send
+
+> **前置条件：** 先阅读 [`../../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+发送新邮件，支持：
+- 纯文本或 HTML 正文
+- 抄送/密送
+- 本地文件附件（`--attach`）
+- 内嵌图片（`--inline`，CID 可用随机字符串）
+
+本 skill 对应 shortcut：`lark-cli mail +send`。
+
+## CRITICAL — 发送工作流（必须遵循）
+
+此命令默认**只保存草稿**，不会发送邮件。需要发送时，**必须**按以下步骤操作：
+
+**Step 1** — 创建草稿（不带 `--confirm-send`）：
+```bash
+lark-cli mail +send --to <收件人> --subject '<主题>' --body '<正文>'
+```
+→ 返回 `draft_id`
+
+**Step 2** — 向用户展示邮件摘要（收件人、主题、正文预览），请求确认发送
+
+**Step 3** — 用户明确同意后，发送该草稿：
+```bash
+lark-cli mail user_mailbox.drafts send --params '{"user_mailbox_id":"me","draft_id":"<Step 1 返回的 draft_id>"}'
+```
+
+**禁止跳过 Step 1 直接使用 `--confirm-send`。禁止在用户未明确同意的情况下执行 Step 3。**
+
+## 命令
+
+```bash
+# 保存为草稿（默认行为，不发送）— HTML 格式推荐
+lark-cli mail +send --to alice@example.com --subject '周报' \
+  --body '<p>本周进展：</p><ul><li>完成 A 模块</li><li>修复 3 个 bug</li></ul>'
+
+# 保存为草稿并抄送
+lark-cli mail +send --to alice@example.com --cc bob@example.com --subject '状态更新' --body '<b>已完成</b>'
+
+# 确认发送（仅在用户明确确认后使用）
+lark-cli mail +send --to alice@example.com --subject '周报' \
+  --body '<p>本周进展如下...</p>' --confirm-send
+
+# 保存带附件的草稿
+lark-cli mail +send --to alice@example.com --subject '请查收' --body '<p>见附件</p>' --attach ./report.pdf,./logs.zip
+
+# 保存带内嵌图片的草稿（推荐：直接用相对路径，自动解析）
+lark-cli mail +send --to alice@example.com --subject '预览图' --body '<img src="./logo.png" />'
+
+# 纯文本邮件（仅在内容极简时使用）
+lark-cli mail +send --to alice@example.com --subject '确认' --body '收到，谢谢'
+
+# Dry Run（仅打印请求，不执行）
+lark-cli mail +send --to alice@example.com --subject '测试' --body '<p>test</p>' --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--to <emails>` | 是 | 收件人邮箱，多个用逗号分隔 |
+| `--subject <text>` | 是 | 邮件主题 |
+| `--body <text>` | 是 | 邮件正文。推荐使用 HTML 获得富文本排版；也支持纯文本（自动检测）。使用 `--plain-text` 可强制纯文本模式。支持 `<img src="./local.png" />` 相对路径自动解析为内嵌图片（仅支持相对路径，不支持绝对路径） |
+| `--from <email>` | 否 | 发件人邮箱地址（EML From 头）。使用别名（send_as）发信时，设为别名地址并配合 `--mailbox` 指定所属邮箱。默认读取邮箱主地址 |
+| `--mailbox <email>` | 否 | 邮箱地址，指定草稿所属的邮箱（默认回退到 `--from`，再回退到 `me`）。当发件人（`--from`）与邮箱不同时使用。可通过 `accessible_mailboxes` 查询可用邮箱 |
+| `--cc <emails>` | 否 | 抄送邮箱，多个用逗号分隔 |
+| `--bcc <emails>` | 否 | 密送邮箱，多个用逗号分隔 |
+| `--plain-text` | 否 | 强制纯文本模式，忽略 HTML 自动检测。不可与 `--inline` 同时使用 |
+| `--attach <paths>` | 否 | 附件文件路径，多个用逗号分隔。相对路径 |
+| `--inline <json>` | 否 | 高级用法：手动指定内嵌图片 CID 映射。推荐直接在 `--body` 中使用 `<img src="./path" />`（自动解析）。仅在需要精确控制 CID 命名时使用此参数。格式：`'[{"cid":"mycid","file_path":"./logo.png"}]'`，在 body 中用 `<img src="cid:mycid">` 引用。不可与 `--plain-text` 同时使用 |
+| `--signature-id <id>` | 否 | 签名 ID。附加邮箱签名到正文末尾。运行 `mail +signature` 查看可用签名。不可与 `--plain-text` 同时使用 |
+| `--confirm-send` | 否 | 确认发送邮件（默认只保存草稿）。仅在用户明确确认收件人和内容后使用 |
+| `--send-time <timestamp>` | 否 | 定时发送时间，Unix 时间戳（秒）。需至少为当前时间 + 5 分钟。配合 `--confirm-send` 使用可定时发送邮件 |
+| `--dry-run` | 否 | 仅打印请求，不执行 |
+
+## 返回值
+
+**草稿模式（默认）：**
+
+```json
+{
+  "ok": true,
+  "data": {
+    "draft_id": "草稿ID",
+    "tip": "draft saved. To send: lark-cli mail user_mailbox.drafts send --params '{...}'"
+  }
+}
+```
+
+**发送模式（`--confirm-send`）：**
+
+```json
+{
+  "ok": true,
+  "data": {
+    "message_id": "邮件ID",
+    "thread_id":  "会话ID"
+  }
+}
+```
+
+## 典型场景
+
+### 场景 1：用户说"帮我写一封邮件给 Alice"（只创建草稿）
+```bash
+lark-cli mail +send --to alice@example.com --subject '周报' --body '<p>本周进展如下...</p>'
+```
+→ 返回 `draft_id`，告诉用户草稿已创建，可在飞书邮件 UI 中预览和编辑。
+
+### 场景 2：用户说"发邮件给 Alice 说收到了"（需要发送）
+```bash
+# Step 1: 创建草稿
+lark-cli mail +send --to alice@example.com --subject '收到' --body '<p>已收到，谢谢！</p>'
+# → 返回 draft_id
+
+# Step 2: 向用户确认 "邮件草稿已创建：收件人 alice@example.com，主题「收到」。确认发送吗？"
+
+# Step 3: 用户确认后发送
+lark-cli mail user_mailbox.drafts send --params '{"user_mailbox_id":"me","draft_id":"<draft_id>"}'
+```
+
+### 场景 3：用户说"下午 3 点给 Alice 发一封周报"（定时发送）
+```bash
+# Step 1: 创建草稿（定时发送也走草稿流程）
+lark-cli mail +send --to alice@example.com --subject '周报' --body '<p>本周进展如下...</p>'
+# → 返回 draft_id
+
+# Step 2: 向用户确认 "邮件草稿已创建：收件人 alice@example.com，主题「周报」，定时 <目标时间> 发送。确认吗？"
+
+# Step 3: 用户确认后定时发送（send_time 为 Unix 时间戳，需至少当前时间 + 5 分钟）
+lark-cli mail user_mailbox.drafts send --params '{"user_mailbox_id":"me","draft_id":"<draft_id>"}' --data '{"send_time":"<unix_timestamp>"}'
+```
+
+### 场景 4：用户说"等等，先不发那封邮件了"（取消定时发送）
+```bash
+# 取消定时发送（取消后邮件变回草稿）
+lark-cli mail user_mailbox.drafts cancel_scheduled_send --params '{"user_mailbox_id":"me","draft_id":"<draft_id>"}'
+```
+→ 取消成功后邮件恢复为草稿状态，用户可重新编辑或在之后重新发送。
+
+## 发送后跟进
+
+### 立即发送（无 `--send-time`）
+
+邮件发送成功后（收到 `message_id`），**必须**调用 `send_status` 查询投递状态：
+
+```bash
+lark-cli mail user_mailbox.messages send_status --params '{"user_mailbox_id":"me","message_id":"<发送返回的 message_id>"}'
+```
+
+状态码：1=正在投递, 2=投递失败重试, 3=退信, 4=投递成功, 5=待审批, 6=审批拒绝。向用户简要报告各收件人投递结果，异常状态需重点提示。
+
+### 定时发送（指定了 `--send-time`）
+
+定时发送不会立即产生 `message_id`，因此 `send_status` 在定时发送成功后会返回"待发送"状态，**不建议在定时发送后立即查询**。可在预定发送时间后再查询投递状态。
+
+如需取消定时发送，可在预定时间前调用取消接口：
+
+```bash
+lark-cli mail user_mailbox.drafts cancel_scheduled_send --params '{"user_mailbox_id":"me","draft_id":"<draft_id>"}'
+```
+
+**取消后邮件会变回草稿**，可继续编辑或在之后重新发送。
+
+## 实现说明
+
+- 使用 EML 构建器生成完整 MIME 邮件并 base64url 编码后发送。
+- `--attach` 作为普通附件添加。相对路径。
+- `--inline` 接受 JSON 数组，每项需提供 `cid`（唯一标识符，可用随机十六进制字符串）和 `file_path`（相对路径），作为 inline part 嵌入邮件。
+
+## 相关命令
+
+- `lark-cli mail +reply` — 回复邮件
+- `lark-cli mail +reply-all` — 回复全部
+- `lark-cli mail +forward` — 转发邮件
+- `lark-cli mail user_mailbox.messages list` — 列出邮件