@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-signature.md

@@ -0,0 +1,98 @@
+# mail +signature
+
+> **前置条件：** 先阅读 [`../../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+查看邮箱签名列表或详情。返回签名的类型、默认使用情况、内容预览等信息。TENANT（企业）签名的模板变量会被自动替换为实际值。
+
+本 skill 对应 shortcut：`lark-cli mail +signature`。
+
+## 命令
+
+```bash
+# 列出所有签名
+lark-cli mail +signature
+
+# 查看某个签名的详情（渲染后的内容预览、模板变量值、图片信息）
+lark-cli mail +signature --detail <signature_id>
+
+# 指定邮箱
+lark-cli mail +signature --from shared@example.com
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--from <email>` | 否 | 邮箱地址（默认 `me`） |
+| `--detail <id>` | 否 | 签名 ID，查看详情。省略则列出所有签名 |
+
+## 返回值
+
+**列表模式：**
+
+```json
+{
+  "ok": true,
+  "data": {
+    "signatures": [
+      {
+        "id": "<签名ID>",
+        "name": "个人签名",
+        "type": "USER",
+        "content_preview": "这是我的签名内容 [image] 超链接哈哈"
+      },
+      {
+        "id": "<签名ID>",
+        "name": "企业签名",
+        "type": "TENANT",
+        "is_send_default": true,
+        "is_reply_default": true,
+        "content_preview": "企业签名 姓名：陈煌 部门：研发团队"
+      }
+    ]
+  }
+}
+```
+
+**详情模式（`--detail`）：**
+
+```json
+{
+  "ok": true,
+  "data": {
+    "id": "<签名ID>",
+    "name": "企业签名",
+    "type": "TENANT",
+    "is_send_default": true,
+    "is_reply_default": true,
+    "images": [
+      {"cid": "76CEB29E-...", "file_key": "121011...", "image_name": "image.png"}
+    ],
+    "template_vars": {"B-NAME": "陈煌", "B-DEPARTMENT": "研发团队"},
+    "content_preview": "企业签名 姓名：陈煌 部门：研发团队"
+  }
+}
+```
+
+## 字段说明
+
+| 字段 | 说明 |
+|------|------|
+| `type` | `USER`（用户签名，可编辑）或 `TENANT`（企业签名，管理员模板控制） |
+| `is_send_default` | 是否为新邮件的默认签名 |
+| `is_reply_default` | 是否为回复/转发的默认签名 |
+| `images` | 签名内联图片元数据（仅详情模式） |
+| `template_vars` | TENANT 签名的模板变量已替换值（仅详情模式） |
+| `content_preview` | 签名内容的纯文本预览（`<img>` 显示为 `[image]`，最长 200 字符） |
+
+## 与 compose shortcut 配合
+
+获取签名 ID 后，可在发送/回复/转发时附加签名：
+
+```bash
+# 查看签名列表获取 ID
+lark-cli mail +signature
+
+# 在发送邮件时附加签名
+lark-cli mail +send --to alice@example.com --subject '你好' --body '<p>内容</p>' --signature-id <签名ID>
+```

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

@@ -0,0 +1,111 @@
+# mail +thread
+
+> **前置条件：** 先阅读 [`../../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+读取指定会话中的所有邮件，按发送时间升序排列。每条邮件结构与 `+message` 相同。
+
+在实现上，每个 `messages[]` 项与 `mail +message` 的构建方式一致：安全元数据字段直接透传，正文/附件辅助字段由 shortcut 派生。每条邮件使用统一的 `attachments[]` 列表，涵盖普通附件和内嵌图片。
+
+本 skill 对应 shortcut `lark-cli mail +thread`，内部调用：
+- `GET /open-apis/mail/v1/user_mailboxes/{mailbox}/threads/{thread_id}` — 获取会话中所有邮件的完整内容
+
+## 命令
+
+```bash
+# 读取完整会话
+lark-cli mail +thread --thread-id <thread-id>
+
+# 仅纯文本正文（更小的负载，适合 AI 处理）
+lark-cli mail +thread --thread-id <thread-id> --html=false
+
+# 指定邮箱
+lark-cli mail +thread --mailbox user@example.com --thread-id <thread-id>
+
+# JSON 输出
+lark-cli mail +thread --thread-id <thread-id> --format json
+
+# Dry Run
+lark-cli mail +thread --thread-id <thread-id> --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 默认值 | 说明 |
+|------|------|--------|------|
+| `--thread-id <id>` | 是 | — | 会话 ID（`thread_id`） |
+| `--mailbox <email>` | 否 | 当前用户 | 邮箱地址（`user_mailbox_id`） |
+| `--html` | 否 | true | 是否返回 HTML 正文（`false` 仅返回纯文本，减少带宽） |
+| `--format <mode>` | 否 | json | 输出格式：`json`（默认）/ `pretty` / `table` / `ndjson` / `csv` |
+| `--dry-run` | 否 | — | 仅打印请求，不执行 |
+
+## 返回值
+
+成功时返回 `{"ok": true, "data": ...}` 结构，`data` 字段包含：
+
+```json
+{
+  "thread_id":     "会话 ID",
+  "message_count": 2,
+  "messages": [
+    { "...与 +message 输出结构相同（最早的在前）..." },
+    { "......" }
+  ]
+}
+```
+
+顶层字段：
+
+| 字段 | 说明 |
+|------|------|
+| `thread_id` | `--thread-id` 请求的会话 ID |
+| `message_count` | 成功获取的邮件数量 |
+| `messages` | 按 `internal_date` 升序排列的邮件列表（最早的在前） |
+
+每个 `messages[]` 项使用与 [`mail +message`](./lark-mail-message.md#返回值) 相同的结构。完整字段列表参见 [`+message` 字段说明](./lark-mail-message.md#字段说明) 和 [`+message` security_level](./lark-mail-message.md#security_level)。
+
+> 注意：使用 `--format json` 获取结构化输出。所有 JSON 输出统一包裹在 `{"ok": true, "data": ...}` 结构中。
+
+## 注意事项
+
+- **JSON 输出可直接使用**，可直接读取，无需额外编码转换。
+- JSON 输出中 `messages[].body_html` 里的 `<` / `>` 可能显示为 `\u003c` / `\u003e`（JSON 安全转义，内容不变，`jq -r` 可还原）。
+- `mail +thread` 不再在读取会话时获取附件/图片下载 URL。如后续步骤需要 URL，请针对特定的 `message_id` 和 `attachment_ids` 调用原生附件 URL API。
+- 与 `+message` 一样，普通附件和内嵌图片都出现在 `messages[].attachments[]` 中，使用同一个 `user_mailbox.message.attachments download_url` API。
+- 查看某条邮件的原始 HTML：
+
+```bash
+lark-cli mail +thread --thread-id <thread_id> --format json | jq -r '.data.messages[0].body_html'
+```
+
+## 典型场景
+
+### 查看会话时间线 → 生成摘要
+
+```bash
+# 1. 从某封邮件获取 thread_id
+lark-cli mail +message --message-id <id> --html=false --format json | jq '.data.thread_id'
+
+# 2. 读取完整会话（仅纯文本）
+lark-cli mail +thread --thread-id <thread_id> --html=false --format json
+
+# 3. 让 LLM 分析 messages[].body_plain_text 并生成会话摘要
+```
+
+### 回复会话中最新一封邮件
+
+```bash
+# 获取最新一封邮件的 message_id
+lark-cli mail +thread --thread-id <thread_id> --html=false --format json | \
+  jq '.data.messages[-1].message_id'
+
+# 回复
+lark-cli mail +reply --message-id <last_message_id> --body "..."
+```
+
+## 相关命令
+
+- `lark-cli mail +message` — 读取单封邮件
+- `lark-cli mail +reply` — 回复邮件
+- `lark-cli mail +forward` — 转发邮件
+- `lark-cli mail user_mailbox.message.attachments download_url` — 按需获取邮件附件/图片下载 URL
+- `lark-cli mail user_mailbox.messages list` — 列出收件箱邮件（获取 `thread_id`）

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

@@ -0,0 +1,122 @@
+
+# mail +triage
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+查看收件箱邮件摘要（date / from / subject / message_id），用于快速浏览和决定读哪封邮件。
+
+## 用法
+
+```bash
+# 默认：收件箱邮件（默认 20 条，默认table 格式）
+lark-cli mail +triage
+
+# 查看收件箱未读
+lark-cli mail +triage --filter '{"folder":"inbox","is_unread":true}'
+
+# 全文搜索
+lark-cli mail +triage --query "合同审批"
+
+# 按发件人 / 主题搜索
+lark-cli mail +triage --filter '{"from":["boss@example.com"],"subject":"季度报告"}'
+
+# 按时间范围搜索（如"上周的邮件"）
+lark-cli mail +triage --query "项目评审" --filter '{"time_range":{"start_time":"2026-03-16T00:00:00+08:00","end_time":"2026-03-22T23:59:59+08:00"}}'
+
+# 指定文件夹
+lark-cli mail +triage --filter '{"folder":"sent"}'
+
+# 系统标签（可通过 folder 或 label 传入，搜索时自动转为 folder）
+lark-cli mail +triage --filter '{"folder":"flagged"}'
+lark-cli mail +triage --filter '{"label":"important"}'
+lark-cli mail +triage --filter '{"label":"重要邮件"}'
+
+# json/data 格式可配合 jq 处理
+lark-cli mail +triage --format json | jq '.messages[].subject'
+
+# 分页：先取 10 条，再用 page_token 翻页
+lark-cli mail +triage --max 10 --format json
+# 输出中包含 page_token，传入下一次请求
+lark-cli mail +triage --page-token 'list:FfccvoqPd...' --max 10 --format json
+
+# --page-size 是 --max 的别名
+lark-cli mail +triage --page-size 10
+```
+
+## 参数
+
+| 参数 | 默认 | 说明 |
+|------|------|------|
+| `--filter <json>` | — | 筛选条件（见下方字段说明） |
+| `--query <text>` | — | 全文搜索关键词 |
+| `--format <mode>` | `table` | `table` / `json` / `data`（`json` 和 `data` 均输出含分页信息的对象） |
+| `--max <n>` | `20` | 最大返回条数（1-400），内部自动分页拉取 |
+| `--page-size <n>` | — | `--max` 的别名，两者含义相同；同时指定时 `--page-size` 优先 |
+| `--page-token <token>` | — | 上一次响应返回的分页令牌，传入后从该位置继续拉取。令牌带 `search:` 或 `list:` 前缀，标识来源路径，不可混用 |
+| `--labels` | — | table 格式时额外显示 labels 列 |
+| `--mailbox <id>` | `me` | 邮箱地址 |
+
+### `--filter` 支持的字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `folder` | string | 文件夹名称筛选。系统文件夹固定值：`inbox`/`sent`/`draft`/`trash`/`spam`/`archive`/`priority`/`flagged`/`other`/`scheduled`，也支持自定义文件夹名称。子文件夹需用 `parent_name/child_name` 格式，可通过 folder list 接口查看 |
+| `folder_id` | string | 文件夹 ID，优先级高于 `folder`。系统值：`INBOX`/`SENT`/`DRAFT`/`TRASH`/`SPAM`/`ARCHIVED`，自定义文件夹为数字 ID |
+| `label` | string | 自定义标签名称筛选。子标签需用 `parent_name/child_name` 格式，可通过 label list 接口查看 |
+| `label_id` | string | 标签 ID，优先级高于 `label`。自定义标签为数字 ID |
+| `is_unread` | boolean | 是否未读 |
+| `from` | string[] | 发件人 |
+| `to` | string[] | 收件人 |
+| `subject` | string | 主题关键词 |
+| `has_attachment` | boolean | 是否有附件 |
+| `time_range` | object | 时间范围 `{"start_time":"2026-01-01T00:00:00+08:00","end_time":"..."}` |
+
+> **系统标签说明**：`IMPORTANT`/`FLAGGED`/`OTHER` 可通过 `folder` 或 `label` 传入（也支持中文别名 `重要邮件`/`已加旗标`/`其他邮件`、搜索名 `priority`/`flagged`/`other`）。搜索时自动转为 folder 字段，列表时自动转为 label_id。label list 接口不返回这三个系统标签。
+>
+> **⚠️ 注意**：查询未读请用 `"is_unread":true`。
+可运行 `mail +triage --print-filter-schema` 查看完整字段说明。
+
+## 输出
+
+### `--format json` / `--format data`
+
+两者输出格式相同，均为含分页信息的对象：
+
+```json
+{
+  "messages": [
+    {
+      "message_id": "SEU2...",
+      "date": "Fri, 21 Mar 2026 11:40:00 +0800",
+      "from": "Alice <alice@example.com>",
+      "subject": "Weekly update",
+      "labels": "INBOX,UNREAD"
+    }
+  ],
+  "count": 20,
+  "has_more": true,
+  "page_token": "list:FfccvoqPd_loLhtcRx8cx..."
+}
+```
+
+- `has_more`：是否还有下一页
+- `page_token`：传入 `--page-token` 可获取下一页；为空字符串表示已到末尾
+- token 前缀 `search:` / `list:` 标识来源 API 路径，不可混用
+
+### `table` 格式
+
+`page_token` 信息输出在 stderr，自动携带 `--query`/`--filter` 参数方便续页：
+```text
+15 message(s)
+next page: mail +triage --query '合同审批' --page-token 'search:abc123...'
+tip: use mail +message --message-id <id> to read full content
+```
+
+### 搜索分页注意事项
+
+搜索路径（使用 `--query` 或 `from`/`to`/`subject` 等 filter）的分页结果在**同一翻页链内**保持一致（无重复、无丢失）。但不同 `--max` 值发起的独立搜索可能返回不同排序，这是搜索 API 的固有行为。列表路径（仅 `folder`/`label` 筛选）无此限制。
+
+## 参考
+
+- [lark-mail](../SKILL.md) — 邮箱域总览
+- [lark-mail-watch](lark-mail-watch.md) — 实时监听新邮件

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

@@ -0,0 +1,94 @@
+
+# mail +watch
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+实时监听新邮件事件（`mail.user_mailbox.event.message_received_v1`）。
+
+**权限要求：** 应用需要 `mail:event`、`mail:user_mailbox.message:readonly` 权限，以及字段权限 `mail:user_mailbox.message.address:read`、`mail:user_mailbox.message.subject:read`、`mail:user_mailbox.message.body:read`，且机器人需订阅事件 `mail.user_mailbox.event.message_received_v1`。按需权限（缺失时会提示申请）：使用 `--folders` / `--folder-ids` 筛选自定义文件夹时需要 `mail:user_mailbox.folder:read`；使用 `--labels` / `--label-ids` 筛选自定义标签时需要 `mail:user_mailbox.message:modify`。
+
+## 命令
+
+```bash
+# 默认：表格输出 message 元数据
+lark-cli mail +watch
+
+# 仅输出 message 数据（jq 友好）
+lark-cli mail +watch --msg-format metadata --format data
+
+# 输出精简元数据（message_id / thread_id / folder_id / label_ids / internal_date / message_state）
+lark-cli mail +watch --msg-format minimal --format data
+
+# 输出纯文本全文
+lark-cli mail +watch --msg-format plain_text_full --format data
+
+# 输出完整 message（含正文相关字段）
+lark-cli mail +watch --msg-format full --format data
+
+# 输出原始事件体
+lark-cli mail +watch --msg-format event --format data
+
+# 监听指定邮箱
+lark-cli mail +watch --mailbox alice@company.com
+
+# 按文件夹/标签过滤（客户端过滤，支持名称或 ID）
+lark-cli mail +watch --folders '["收件箱项目"]' --label-ids '["FLAGGED"]'
+
+# 写入文件
+lark-cli mail +watch --msg-format metadata --output-dir ./mail-events
+
+# 查看各 --msg-format 的输出字段说明（解析前先运行）
+lark-cli mail +watch --print-output-schema
+```
+
+## 参数
+
+| 参数 | 默认 | 说明 |
+|------|------|------|
+| `--mailbox <id>` | `me` | 订阅目标邮箱 |
+| `--msg-format <mode>` | `metadata` | 输出模式：`metadata` / `minimal` / `plain_text_full` / `full` / `event` |
+| `--format <mode>` | `table` | 输出样式：`table` / `json` / `data` |
+| `--folder-ids <json-array>` | — | 文件夹 ID 过滤，如 `["INBOX","SENT"]` |
+| `--folders <json-array>` | — | 文件夹名称过滤（与 `--folder-ids` 取并集） |
+| `--label-ids <json-array>` | — | 标签 ID 过滤，如 `["FLAGGED","IMPORTANT"]` |
+| `--labels <json-array>` | — | 标签名称过滤（与 `--label-ids` 取并集） |
+
+> **过滤逻辑：** `--folder-ids`/`--folders` 与 `--label-ids`/`--labels` 之间是 **AND** 关系，即邮件必须**同时**匹配指定的文件夹和标签才会输出。同类参数内部是 **OR** 关系（匹配其中任一即可）。新收到的邮件通常只有系统标签（如 `UNREAD`、`IMPORTANT`），不会自动带有自定义标签。
+| `--output-dir <dir>` | — | 每条事件写入单独 JSON 文件 |
+| `--print-output-schema` | — | 打印各 `--msg-format` 的输出字段说明（解析输出前先运行此命令） |
+| `--dry-run` | — | 仅预览订阅请求，不实际连接 |
+
+## --msg-format 输出结构（--format json）
+
+每条事件输出为一行 NDJSON。
+
+**`metadata`**（默认，适合分拣/通知）
+```json
+{"ok":true,"data":{"message":{"message_id":"...","thread_id":"...","subject":"...","head_from":{"name":"Alice","mail_address":"alice@example.com"},"to":[{"name":"Bob","mail_address":"bob@example.com"}],"folder_id":"INBOX","label_ids":["IMPORTANT"],"internal_date":"1742800000000","message_state":1,"body_preview":"Please find attached..."}}}
+```
+
+**`minimal`**（仅 ID 和状态，适合追踪已读/文件夹变更）
+```json
+{"ok":true,"data":{"message":{"message_id":"...","thread_id":"...","folder_id":"INBOX","label_ids":["IMPORTANT"],"internal_date":"1742800000000","message_state":1}}}
+```
+
+**`plain_text_full`**（metadata 全部字段 + 完整纯文本正文）
+```json
+{"ok":true,"data":{"message":{"message_id":"...","subject":"...","head_from":{...},"folder_id":"INBOX","label_ids":[...],"body_preview":"...","body_plain_text":"<base64url>"}}}
+```
+
+**`event`**（原始 WebSocket 事件，不发起 API 请求，适合调试）
+```json
+{"ok":true,"data":{"header":{"event_id":"abc123","event_type":"mail.user_mailbox.event.message_received_v1","create_time":"1742800000000"},"event":{"message_id":"...","mail_address":"user@example.com"}}}
+```
+
+**`full`**（全部字段，含 HTML 正文和附件）
+```json
+{"ok":true,"data":{"message":{"message_id":"...","subject":"...","head_from":{...},"body_preview":"...","body_plain_text":"<base64url>","body_html":"<base64url>","attachments":[{"name":"report.pdf","size":102400}]}}}
+```
+
+## 参考
+
+- [lark-mail](../SKILL.md) — 邮箱域总览
+- [lark-mail-triage](lark-mail-triage.md) — 邮件摘要列表
+- [lark-event-subscribe](../../lark-event/references/lark-event-subscribe.md) — 通用事件订阅

package/server/assets/skills/lark-tools/cli-skills/lark-minutes/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: lark-minutes
+version: 1.0.0
+description: "飞书妙记：妙记相关基本功能。1.查询妙记列表（按关键词/所有者/参与者/时间范围）；2.获取妙记基础信息（标题、封面、时长 等）；3.下载妙记音视频文件；4.获取妙记相关 AI 产物（总结、待办、章节）。飞书妙记 URL 格式: http(s)://<host>/minutes/<minute-token>"
+metadata:
+  requires:
+    bins: ["lark-cli"]
+  cliHelp: "lark-cli minutes --help"
+---
+
+# minutes (v1)
+
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，其中包含认证、权限处理**
+
+## 核心概念
+
+- **妙记（Minutes）**：来源于飞书视频会议的录制产物或用户上传的音视频文件，通过 `minute_token` 标识。
+- **妙记 Token（minute\_token）**：妙记的唯一标识符，可从妙记 URL 末尾提取（例如 `https://*.feishu.cn/minutes/obcnq3b9jl72l83w4f14xxxx` 中的 `obcnq3b9jl72l83w4f14xxxx`）。如果 URL 中包含额外参数（如 `?xxx`），应截取路径最后一段。
+
+## 核心场景
+
+### 1. 搜索妙记
+
+1. 当用户描述的是"我的妙记""包含某个关键词的妙记""某段时间内的妙记"，优先使用 `minutes +search`。
+2. 仅支持使用关键词、时间段、参与者、所有者等筛选条件搜索妙记记录，对于不支持的筛选条件，需要提示用户。
+3. 搜索结果存在多条数据时，务必注意分页数据获取，不要遗漏任何妙记记录。
+4. 如果是会议的妙记，应优先使用 [vc +search](../lark-vc/references/lark-vc-search.md) 先定位会议，再按需通过 [vc +recording](../lark-vc/references/lark-vc-recording.md) 获取 `minute_token`。
+
+
+### 2. 查看妙记基础信息
+
+1. 当用户只需要确认某条妙记的标题、封面、时长、所有者、URL 等基础信息时，使用 `minutes minutes get`。
+2. 如果用户给的是妙记 URL，应先从 URL 末尾提取 `minute_token`，再调用 `minutes minutes get`。
+3. 用户意图不明确时，默认先给基础元信息，帮助确认是否命中目标妙记。
+
+> 使用 `lark-cli schema minutes.minutes.get` 可查看完整返回值结构。核心字段包含：`title`（标题）、`cover`（封面 URL）、`duration`（时长，毫秒）、`owner_id`（所有者 ID）、`url`（妙记链接）。
+
+### 3. 下载妙记音视频文件
+
+1. 下载妙记音视频文件到本地，或获取有效期 1 天的下载链接。详见 [minutes +download](references/lark-minutes-download.md)。
+2. `minutes +download` 只负责音视频媒体文件。
+3. 用户只想拿可分享的下载地址时，使用 `--url-only`；用户要落地到本地文件时，直接下载。
+
+> **注意**：`+download` 只负责音视频媒体文件。如果用户需要的是逐字稿、总结、待办、章节等纪要内容，请使用 [vc +notes --minute-tokens](../lark-vc/references/lark-vc-notes.md)。
+
+### 4. 获取妙记的逐字稿、总结、待办、章节
+
+1. 当用户说"这个妙记的逐字稿""总结""待办""章节"时，**不属于本 skill**。
+2. 应使用 [vc +notes --minute-tokens](../lark-vc/references/lark-vc-notes.md) 获取对应的纪要产物。
+3. 如果当前上下文中已有 `minute_token`，可直接传给 `vc +notes`；如果只有妙记 URL，先提取 `minute_token`。
+
+```bash
+# 通过 minute_token 获取纪要产物（逐字稿、总结、待办、章节）
+lark-cli vc +notes --minute-tokens <minute_token>
+```
+
+> **跨 skill 路由**：逐字稿、AI 总结、待办、章节等纪要内容由 [lark-vc](../lark-vc/SKILL.md) 的 `+notes` 命令提供
+
+## 资源关系
+
+```text
+Minutes (妙记) ← minute_token 标识
+├── Metadata (标题、封面、时长、owner、url) → minutes minutes get
+└── MediaFile (音频/视频文件) → minutes +download
+```
+
+> **能力边界**：`minutes` 负责 **搜索妙记、查看基础元信息、下载音视频文件**。
+>
+> **路由规则**：
+>
+> - 用户说"妙记列表 / 搜索妙记 / 某个关键词的妙记" → `minutes +search`
+> - 用户只是想看"我的妙记 / 某段时间内的妙记 / 妙记列表"，不要先走 [lark-vc](../lark-vc/SKILL.md)，而应直接使用本 skill
+> - 用户如果同时提到"会议 / 会 / 开会 / 某场会"，即使也提到了"妙记"，也应优先走 [lark-vc](../lark-vc/SKILL.md) 先定位会议，再通过 [vc +recording](../lark-vc/references/lark-vc-recording.md) 获取 `minute_token`
+> - 用户说"我的妙记 / 我拥有的妙记 / 我参与的妙记"时，可将相关过滤条件映射为 `me`；`me` 表示当前用户
+> - 结果有多页时，使用 `page_token` 持续翻页，直到确认没有更多结果
+> - `minutes +search` 单次最多返回 `200` 条；结果总数没有固定上限
+> - 用户说"这个妙记的标题 / 时长 / 封面 / 链接" → `minutes minutes get`
+> - 用户说"下载这个妙记的视频 / 音频 / 媒体文件" → `minutes +download`
+> - 用户说"这个妙记的逐字稿 / 总结 / 待办 / 章节" → 使用 [vc +notes --minute-tokens](../lark-vc/references/lark-vc-notes.md)
+
+## Shortcuts（推荐优先使用）
+
+Shortcut 是对常用操作的高级封装（`lark-cli minutes +<verb> [flags]`）。有 Shortcut 的操作优先使用。
+
+| Shortcut                                           | 说明                                                              |
+| -------------------------------------------------- | --------------------------------------------------------------- |
+| [`+search`](references/lark-minutes-search.md)     | Search minutes by keyword, owners, participants, and time range |
+| [`+download`](references/lark-minutes-download.md) | Download audio/video media file of a minute                     |
+
+- 使用 `+search` 命令时，必须阅读 [references/lark-minutes-search.md](references/lark-minutes-search.md)，了解搜索参数和返回值结构。
+- 使用 `+download` 命令时，必须阅读 [references/lark-minutes-download.md](references/lark-minutes-download.md)，了解下载参数和返回值结构。
+
+<!-- AUTO-GENERATED-START — gen-skills.py 管理，勿手动编辑 -->
+
+## API Resources
+
+```bash
+lark-cli schema minutes.<resource>.<method>   # 调用 API 前必须先查看参数结构
+lark-cli minutes <resource> <method> [flags] # 调用 API
+```
+
+> **重要**：使用原生 API 时，必须先运行 `schema` 查看 `--data` / `--params` 参数结构，不要猜测字段格式。
+
+### minutes
+
+- `get` — 获取妙记信息
+
+## 权限表
+
+| 方法            | 所需 scope                       |
+| ------------- | ------------------------------ |
+| `+search`     | `minutes:minutes.search:read`  |
+| `minutes.get` | `minutes:minutes:readonly`     |
+| `+download`   | `minutes:minutes.media:export` |
+
+<!-- AUTO-GENERATED-END -->

package/server/assets/skills/lark-tools/cli-skills/lark-minutes/references/lark-minutes-download.md

@@ -0,0 +1,119 @@
+
+# minutes +download
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+下载妙记的音视频媒体文件到本地，或获取有效期 1 天的下载链接。只读操作。
+
+本 skill 对应 shortcut：`lark-cli minutes +download`。
+
+## 命令
+
+```bash
+# 下载单个妙记的音视频文件
+lark-cli minutes +download --minute-tokens obcnq3b9jl72l83w4f149w9c
+
+# 指定输出路径
+lark-cli minutes +download --minute-tokens obcnq3b9jl72l83w4f149w9c --output ./meeting.mp4
+
+# 仅获取下载链接（有效期 1 天），不下载文件
+lark-cli minutes +download --minute-tokens obcnq3b9jl72l83w4f149w9c --url-only
+
+# 批量下载多个妙记
+lark-cli minutes +download --minute-tokens obcnq3b9jl72l83w4f149w9c,obcnexa7814k4t41c446fzwj
+
+# 批量下载到指定目录
+lark-cli minutes +download --minute-tokens obcnq3b9jl72l83w4f149w9c,obcnexa7814k4t41c446fzwj --output ./downloads
+
+# 预览 API 调用
+lark-cli minutes +download --minute-tokens obcnq3b9jl72l83w4f149w9c --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--minute-tokens <tokens>` | 是 | 妙记 Token，逗号分隔支持批量（最多 50 个） |
+| `--output <path>` | 否 | 输出路径：单个 token 时为文件路径，批量时为目录（默认当前目录） |
+| `--overwrite` | 否 | 覆盖已存在的输出文件 |
+| `--url-only` | 否 | 仅返回下载链接，不下载文件 |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+
+## 核心约束
+
+### 1. 妙记必须已完成转写
+
+音视频文件仅在妙记转写完成后可下载。如果妙记尚未准备好，API 会返回 `2091003` 错误。
+
+### 2. 下载链接有效期 1 天
+
+`--url-only` 返回的链接有效期为 1 天，过期后需重新获取。
+
+### 3. 频率限制
+
+API 限流 5 次/秒，批量下载时需注意控制频率。
+
+### 4. 所需权限
+
+| 身份 | 所需权限 |
+|------|---------|
+| user / bot | `minutes:minutes.media:export` |
+
+## 输出结果
+
+### 下载模式（默认）
+
+```json
+{
+  "saved_path": "访谈一则 & 澳成.mp4",
+  "size_bytes": 52428800
+}
+```
+
+| 字段 | 说明 |
+|------|------|
+| `saved_path` | 文件保存的本地路径 |
+| `size_bytes` | 文件大小（字节） |
+
+### URL 模式（--url-only）
+
+```json
+{
+  "download_url": "https://..."
+}
+```
+
+| 字段 | 说明 |
+|------|------|
+| `download_url` | 媒体文件下载链接（有效期 1 天） |
+
+## 如何获取 minute_token
+
+| 来源 | 获取方式 |
+|------|---------|
+| 妙记 URL | 从 URL 末尾提取，如 `https://sample.feishu.cn/minutes/obcnq3b9jl72l83w4f149w9c` → `obcnq3b9jl72l83w4f149w9c` |
+| 妙记元信息查询 | `lark-cli minutes minutes get --params '{"minute_token": "obcn..."}'` |
+| 会议纪要查询 | `lark-cli vc +notes --meeting-ids <id>` 返回结果中关联的妙记 token |
+
+## 常见错误与排查
+
+| 错误现象 | 错误码 | 根本原因 | 解决方案 |
+|---------|--------|---------|---------|
+| 参数无效 | 2091001 | minute_token 格式不正确 | 检查 token 是否完整（24 位） |
+| 资源不存在 | 2091002 | token 不存在 | 确认 minute_token 正确 |
+| 妙记尚未准备好 | 2091003 | 转写未完成 | 等待转写完成后重试 |
+| 资源已删除 | 2091004 | 妙记已被删除 | 确认妙记文件仍然存在 |
+| 权限不足 | 2091005 | 无阅读权限 | 检查是否有该妙记的访问权限 |
+| `missing required scope(s)` | — | 应用缺少权限 | 运行 `auth login --scope "minutes:minutes.media:export"` |
+
+## 提示
+
+- 音视频文件可能较大，下载无固定超时限制（由用户 Ctrl+C 控制取消）。
+- 未指定 `--output` 时，默认使用妙记原始标题作为文件名（如 `Office Oncall流程2.0宣讲.mp4`）。
+- 如需获取妙记的纪要内容（逐字稿、AI 总结等），请使用 [vc +notes](../../lark-vc/references/lark-vc-notes.md)。
+
+## 参考
+
+- [lark-minutes](../SKILL.md) — 妙记全部命令
+- [lark-vc-notes](../../lark-vc/references/lark-vc-notes.md) — 会议纪要查询
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数