github/larksuite-cli
1
0
Fork 0
mirror of https://github.com/larksuite/cli.git synced 2026-07-07 17:45:15 +08:00
Code Issues Packages Projects Releases Wiki Activity

fix: optimize calendar,vc,minute skills

Browse Source
This commit is contained in:
胡港
2026-06-12 11:15:16 +08:00
parent e0490b73f3
commit 1ff071556d
19 changed files with 427 additions and 83 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
skills/lark-calendar/SKILL.md
View File

@@ -31,6 +31,8 @@ lark-cli calendar +agenda --as user
| Shortcut | 说明 |
|----------|------|
| [`+agenda`](references/lark-calendar-agenda.md) | 查看日程安排（默认今天） |
| [`+search-event`](references/lark-calendar-search-event.md) | 按关键词、时间范围和参会人搜索日程 |
| [`+meeting`](references/lark-calendar-meeting.md) | 通过日程事件 ID 获取关联的视频会议信息（meeting_id、meeting_note） |
| [`+create`](references/lark-calendar-create.md) | 创建日程并邀请参会人（ISO 8601 时间） |
| [`+update`](references/lark-calendar-update.md) | 更新既有日程字段，或独立增量添加/移除参会人和会议室 |
| [`+freebusy`](references/lark-calendar-freebusy.md) | 查询用户主日历的忙闲信息和 RSVP 状态 |
@@ -64,6 +66,8 @@ lark-cli calendar +agenda --as user
|----------|--------|
| 查询过去的会议（"昨天的会议""上周的会"） | [`../lark-vc/SKILL.md`](../lark-vc/SKILL.md)（会议数据含即时会议，仅查日程会遗漏） |
| 查询日历/日程或未来时间的会议 | 本 skill |
| 按关键词搜索日程 | 本 skill（`+search-event`） |
| 从日程获取关联的会议 ID 或纪要文档 | 本 skill（`+meeting`） |
| 预约/改约日程、添加/移除参会人、添加/更换会议室、调整时间 | 先判断新建 vs 编辑，再进入 [schedule-meeting 工作流](references/lark-calendar-schedule-meeting.md) |
## 任务类型分流

66
skills/lark-calendar/references/lark-calendar-meeting.md Normal file
View File

@@ -0,0 +1,66 @@
# calendar +meeting
> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
通过日程 ID（event_id） 获取关联的视频会议信息，包括会议 ID（meeting_id） 和绑定的会议纪要文档（meeting_note）。只读操作。
本 skill 对应 shortcut：`lark-cli calendar +meeting`。
## 命令
```bash
# 查询单个日程的会议信息
lark-cli calendar +meeting --event-ids <event_id>
# 指定日历 ID（默认使用主日历）
lark-cli calendar +meeting --event-ids <event_id1> --calendar-id <calendar_id>
```
## 参数
| 参数 | 必填 | 说明 |
|------|------|------|
| `--event-ids <ids>` | 是 | 日程事件实例 ID，逗号分隔支持批量，最多 50 个 |
| `--calendar-id <id>` | 否 | 日历 ID，默认使用主日历("primary") |
## 输出结果
返回 `meetings` 数组，每条记录包含：
| 字段 | 说明 |
|------|------|
| `event_id` | 日程 ID |
| `meeting_id` | 关联的视频会议 ID（如有）。 |
| `meeting_note` | 关联的会议纪要文档 Token（如有）。 |
## 典型场景
### 场景 1：从日程获取会议信息
```bash
# 1. 查看日程安排，获取 event_id
lark-cli calendar +agenda --start 2026-06-10 --end 2026-06-11
# 2. 获取日程关联的会议信息
lark-cli calendar +meeting --event-ids <event_id>
# 3. 用 meeting_id 进一步获取会议详情
lark-cli vc +detail --meeting-ids <meeting_id>
```
## 与其他命令的关系
| 需求 | 推荐命令 |
|------|---------|
| 从日程获取会议 ID 和纪要文档 | `calendar +meeting` |
| 通过会议 ID 获取 note_id 和 minute_token | `vc +detail --meeting-ids` |
| 通过 note_id 获取 note_doc_token / verbatim_doc_token / shared_doc_tokens | `note +detail --note-id` |
| 读取纪要 / 逐字稿 / 共享文档正文 | `docs +fetch --api-version v2 --doc <doc_token>` |
| 获取妙记产物（需手动指定 `--summary` / `--todo` / `--chapter` / `--keyword` / `--transcript`，不传不返回） | `minutes +detail --minute-tokens` |
## 参考
- [lark-calendar](../SKILL.md) — 日历全部命令
- [lark-vc](../../lark-vc/SKILL.md) — 视频会议（进一步获取会议详情）
- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

79
skills/lark-calendar/references/lark-calendar-search-event.md Normal file
View File

@@ -0,0 +1,79 @@
# calendar +search-event
> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
按关键词、时间范围和参会人搜索日历日程。只读操作。
本 skill 对应 shortcut：`lark-cli calendar +search-event`。
## 命令
```bash
# 按关键词搜索
lark-cli calendar +search-event --query "周会"
# 按时间范围过滤
lark-cli calendar +search-event --time-range "2026-04-20~2026-04-27"
# 按参会人过滤（支持用户 ou_、群聊 oc_、会议室 omm_）
lark-cli calendar +search-event --attendee-ids "ou_user1,oc_chat1,omm_room1"
# 组合搜索
lark-cli calendar +search-event --query "周会" --time-range "2026-04-20~2026-04-27" --attendee-ids "ou_user1"
# 指定日历 ID（默认使用主日历）
lark-cli calendar +search-event --query "周会" --calendar-id <calendar_id>
```
## 参数
| 参数 | 必填 | 说明 |
|------|------|------|
| `--calendar-id <id>` | 否 | 日历 ID，默认使用主日历 |
| `--query <keyword>` | 否 | 搜索关键词。默认为空 |
| `--attendee-ids <ids>` | 否 | 参会人 ID，逗号分隔。支持用户（`ou_`）、群聊（`oc_`）、会议室（`omm_`）前缀自动识别 |
| `--time-range <range>` | 否 | 搜索时间范围(ISO 8601 时间)，格式 `start~end`（如 `2026-04-20T00:00:00+08:00~2026-04-27T23:59:59+08:00`） |
| `--page-token <token>` | 否 | 分页 Token，获取下一页 |
| `--page-size <size>` | 否 | 每页条数，1-30，默认 20 |
> 开始时间必须早于结束时间，否则校验失败。
## 输出结果
| 字段 | 说明 |
|------|------|
| `calendar_id` | 搜索的日历 ID |
| `items` | 日程列表 |
| `has_more` | 是否有更多结果 |
| `page_token` | 下一页 Token |
### items 中的字段
| 字段 | 说明 |
|------|------|
| `event_id` | 日程 ID |
| `summary` | 日程主题 |
| `start` | 开始时间 |
| `end` | 结束时间 |
| `is_all_day` | 是否全天日程 |
| `app_link` | 日程应用链接 |
> 注意：如需日程详情，请使用 `calendar events get`。
## 分页
- 使用 `page_size` 控制每页条数（1-30），默认 20。
- 当 `has_more` 为 `true` 时，使用返回的 `page_token` 获取下一页。
- 必须持续翻页直到 `has_more` 为 `false`，确保不遗漏结果。
## 提示
- 搜索已结束的会议应优先使用 `vc +search`，因为即时会议不会出现在日历中。
## 参考
- [lark-calendar](../SKILL.md) — 日历全部命令
- [lark-calendar-meeting](lark-calendar-meeting.md) — 从日程获取会议信息
- [lark-vc](../../lark-vc/SKILL.md) — 搜索历史会议
- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

48
skills/lark-minutes/SKILL.md
View File

@@ -27,6 +27,7 @@ metadata:
| Shortcut | 说明 |
|----------|------|
| [`+search`](references/lark-minutes-search.md) | 按关键词、所有者、参与者、时间范围搜索妙记 |
| [`+detail`](references/lark-minutes-detail.md) | 查询妙记详情，按需获取 AI 产物（总结、待办、章节、逐字稿、关键词） |
| [`+download`](references/lark-minutes-download.md) | 下载妙记音视频媒体文件 |
| [`+upload`](references/lark-minutes-upload.md) | 上传 file_token 生成妙记 |
| [`+update`](references/lark-minutes-update.md) | 更新妙记标题 |
@@ -44,9 +45,9 @@ metadata:
| "把音视频转妙记/上传文件生成妙记" | 本 skill（`+upload`） |
| "重命名妙记/改妙记标题" | 本 skill（`+update`） |
| "替换说话人/把 A 的发言改成 B" | 本 skill（`+speaker-replace`） |
| "这个妙记的逐字稿/总结/待办/章节" | [lark-vc](../lark-vc/SKILL.md)（`vc +notes --minute-tokens`） |
| "这个妙记的逐字稿/总结/待办/章节（需保存逐字稿到文件）" | 本 skill（`+detail --minute-tokens --transcript`） |
| "xx 纪要的逐字稿/原始记录/谁说了什么" 且没有 `minute_token` / 妙记 URL / 本地音视频文件 | 不走本 skill；路由到 [lark-drive](../lark-drive/SKILL.md) / [lark-doc](../lark-doc/SKILL.md)，必要时再到 [lark-note](../lark-note/SKILL.md) |
| "把音视频文件转成纪要/逐字稿/文字稿" | 先本 skill（`+upload`），再 [lark-vc](../lark-vc/SKILL.md)（`vc +notes --minute-tokens`） |
| "把音视频文件转成纪要/逐字稿/文字稿" | 先本 skill（`+upload`），再本 skill（`minutes +detail --minute-tokens`） |
| 用户同时提到"会议/开会"和"妙记" | 先 [lark-vc](../lark-vc/SKILL.md)（`+search` → `+recording`），再本 skill |
## 核心概念
@@ -77,26 +78,28 @@ metadata:
### 3. 下载妙记音视频文件
1. 下载妙记音视频文件到本地，或获取有效期 1 天的下载链接。详见 [minutes +download](references/lark-minutes-download.md)。
2. `+download` 只负责音视频媒体文件。用户需要逐字稿、总结、待办、章节等纪要内容时，请使用 [vc +notes --minute-tokens](../lark-vc/references/lark-vc-notes.md)。
2. `+download` 只负责音视频媒体文件。用户需要逐字稿、总结、待办、章节等纪要内容时，请使用 `minutes +detail`。
3. 用户只想拿可分享的下载地址时，使用 `--url-only`；用户要落地到本地文件时，直接下载。
4. 未显式指定路径时，文件默认落到 `./minutes/{minute_token}/<server-filename>`，与 `vc +notes` 的逐字稿共享同一目录便于聚合。
4. 未显式指定路径时，文件默认落到 `./minutes/{minute_token}/<server-filename>`，与 `minutes +detail` 的逐字稿共享同一目录便于聚合。
> **注意**：`+download` 只负责音视频媒体文件。如果用户需要的是逐字稿、总结、待办、章节等纪要内容，请使用 [vc +notes --minute-tokens](../lark-vc/references/lark-vc-notes.md)。
> **注意**：`+download` 只负责音视频媒体文件。如果用户需要的是逐字稿、总结、待办、章节等纪要内容，请使用 `minutes +detail`。
### 4. 读取妙记的逐字稿、总结、待办、章节（只读）
1. 当用户要**查看 / 读取**"这个妙记的逐字稿""总结""待办""章节"时，使用 [vc +notes --minute-tokens](../lark-vc/references/lark-vc-notes.md)。
2. 如果当前上下文中已有 `minute_token`，可直接传给 `vc +notes`；如果只有妙记 URL，先提取 `minute_token`。
3. 如果用户给的是**本地音视频文件**，但目标是"转成纪要""转成逐字稿""转成文字稿""转成撰写文字"，应先按下文第 5 节上传文件生成妙记，再把返回的 `minute_url` 提取成 `minute_token`，继续调用 `vc +notes --minute-tokens`。
4. 用户如果直接给出本地文件名或路径，并要求"转逐字稿""转文字稿""整理成撰写文字"，这也是本 skill 的明确触发信号。
1. 当用户说"这个妙记的逐字稿""总结""待办""章节"时，请使用本 skill 的 `+detail` 命令。
2. `minutes +detail` **必须显式指定**要获取的产物 flag（`--summary` / `--todo` / `--chapter` / `--keyword` / `--transcript`），未传任何产物 flag 时只返回基础信息（如 `title`），不会返回任何 AI 产物内容。请求的产物即使为空也返回空值字段，便于程序化处理。
3. 如果当前上下文中已有 `minute_token`，可直接传给 `minutes +detail`；如果只有妙记 URL，先提取 `minute_token`。
4. 如果用户给的是**本地音视频文件**，但目标是"转成纪要""转成逐字稿""转成文字稿""转成撰写文字"，也支持；此时应先按下文第 5 节上传文件生成妙记，再把返回的 `minute_url` 提取成 `minute_token`，继续调用 `minutes +detail --minute-tokens`。
5. 用户如果直接给出本地文件名或路径，并要求"转逐字稿""转文字稿""整理成撰写文字"，这也是本 skill 的明确触发信号。
```bash
# 通过 minute_token 获取纪要产物（逐字稿、总结、待办、章节）
lark-cli vc +notes --minute-tokens <minute_token>
```
# 通过 minute_token 获取指定产物（必须显式列出要拿的 flag）
lark-cli minutes +detail --minute-tokens <minute_token> --summary --todo --chapter
> **跨 skill 路由**：逐字稿、AI 总结、待办、章节等纪要内容由 [lark-vc](../lark-vc/SKILL.md) 的 `+notes` 命令提供
> **读 vs 写**：`vc +notes` 只负责**读取** AI 产物。用户要**新建 / 修改 / 删除**妙记内的 AI 待办或替换 AI 总结，见下文第 6 节，**不要**走 [lark-task](../lark-task/SKILL.md)。
# 仅获取逐字稿并保存到文件
lark-cli minutes +detail --minute-tokens <minute_token> --transcript
```
> 用户要**新建 / 修改 / 删除**妙记内的 AI 待办或替换 AI 总结，见下文第 6 节，**不要**走 [lark-task](../lark-task/SKILL.md)。
### 5. 上传音视频文件生成妙记（并可继续获取纪要 / 逐字稿）
@@ -105,11 +108,11 @@ lark-cli vc +notes --minute-tokens <minute_token>
3. **处理流程**：
- **上传音视频获取 `file_token`**：使用 [`lark-cli drive +upload`](../lark-drive/references/lark-drive-upload.md) 上传本地文件到云空间（云盘/云存储）并获取 `file_token`。
- **生成妙记**：获取到 `file_token` 后，调用 [`lark-cli minutes +upload`](references/lark-minutes-upload.md) 将文件转换为妙记并获取 `minute_url` 链接。
- **继续获取纪要 / 逐字稿（按需）**：如果用户目标不是只要妙记链接，而是要纪要、逐字稿、总结、待办或章节，则从 `minute_url` 中提取 `minute_token`，再调用 [`lark-cli vc +notes --minute-tokens`](../lark-vc/references/lark-vc-notes.md) 获取对应产物。
- **继续获取纪要 / 逐字稿（按需）**：如果用户目标不是只要妙记链接，而是要纪要、逐字稿、总结、待办或章节，则从 `minute_url` 中提取 `minute_token`，再调用 [`lark-cli minutes +detail --minute-tokens`](references/lark-minutes-detail.md) 获取对应产物。
> **注意**：必须先获取飞书云空间（云盘/云存储）的 `file_token` 才能进行转换。
>
> **不要误走本地转写工具**：当用户目标是把本地音视频文件转成纪要、逐字稿、文字稿、撰写文字时，不要改用 `ffmpeg`、`whisper` 或其他本地 ASR/转码命令；标准路径就是 `drive +upload -> minutes +upload -> vc +notes --minute-tokens`。
> **不要误走本地转写工具**：当用户目标是把本地音视频文件转成纪要、逐字稿、文字稿、撰写文字时，不要改用 `ffmpeg`、`whisper` 或其他本地 ASR/转码命令；标准路径就是 `drive +upload -> minutes +upload -> minutes +detail --minute-tokens`。
### 6. 编辑妙记的 AI 待办与 AI 总结（写入）
@@ -141,11 +144,11 @@ lark-cli minutes +todo --minute-token <token> --as user --todos '[
]'
```
**更新 / 删除前**：先用 `vc +notes --minute-tokens <token>` 读取 `todos[].todo_id`（按 `content` 匹配目标条目；列表顺序不保证稳定，**不要**用"第 2 条"代替 `todo_id`）。
**更新 / 删除前**：先用 `minutes +detail --minute-tokens <token> --todo` 读取 `todos[].todo_id`（按 `content` 匹配目标条目；列表顺序不保证稳定，**不要**用"第 2 条"代替 `todo_id`）。
**无编辑权限**：若 CLI 返回 `error.type=no_edit_permission`，表示对**这条妙记**没有编辑权，应请所有者授权；**不要**误走 `auth login --scope`。
**逐字稿关键词替换无命中**：`minutes +word-replace` 时，若 CLI 返回 `error.type=words_not_found`，表示传入的 `source_word` 在该妙记逐字稿中**一个都没匹配到**，未做任何替换。这是**参数问题不是权限问题**：先用 `vc +notes --minute-tokens <token>` 读取当前逐字稿，核对 `source_word` 的精确写法与大小写后重试。
**逐字稿关键词替换无命中**：`minutes +word-replace` 时，若 CLI 返回 `error.type=words_not_found`，表示传入的 `source_word` 在该妙记逐字稿中**一个都没匹配到**，未做任何替换。这是**参数问题不是权限问题**：先用 `minutes +detail --minute-tokens <token> --transcript` 读取当前逐字稿，核对 `source_word` 的精确写法与大小写后重试。
**替换 AI 总结全文**：见 [minutes +summary](references/lark-minutes-summary.md)。
@@ -166,17 +169,15 @@ Minutes (妙记) ← minute_token 标识
> - 用户说"妙记列表 / 搜索妙记 / 某个关键词的妙记" → `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`
> - 用户如果要的是妙记基础信息，拿到 `minute_token` 后用 `minutes minutes get`；用户如果要**读取**逐字稿、文字稿、撰写文字、总结、待办、章节，再走 `vc +notes --minute-tokens`
> - 用户如果要的是妙记基础信息，拿到 `minute_token` 后用 `minutes minutes get`；用户如果要的是逐字稿、文字稿、撰写文字、总结、待办、章节，走 `minutes +detail`
> - “我的妙记”“参与的妙记”等自然语言映射细则，以 [minutes +search](references/lark-minutes-search.md) 为准
> - 结果有多页时，使用 `page_token` 持续翻页，直到确认没有更多结果
> - `minutes +search` 单次最多返回 `200` 条；结果总数没有固定上限
> - 用户说"这个妙记的标题 / 时长 / 封面 / 链接" → `minutes minutes get`
> - 用户说"下载这个妙记的视频 / 音频 / 媒体文件" → `minutes +download`
> - 用户要**读取**"这个妙记的逐字稿 / 文字稿 / 撰写文字 / 总结 / 待办 / 章节" → [vc +notes --minute-tokens](../lark-vc/references/lark-vc-notes.md)
> - 用户要在**妙记内新建 / 修改 / 删除 AI 待办**（含「妙记里加待办」「任务1 已完成」等）→ [`minutes +todo`](references/lark-minutes-todo.md)，**禁止**走 lark-task
> - 用户要**替换妙记 AI 总结全文** → [`minutes +summary`](references/lark-minutes-summary.md)
> - 用户说"这个妙记的逐字稿 / 文字稿 / 撰写文字 / 总结 / 待办 / 章节" → 使用 [vc +notes --minute-tokens](../lark-vc/references/lark-vc-notes.md)
> - 用户说"通过文件生成妙记 / 把音视频转妙记" → 先上传获取 `file_token`，然后使用 `minutes +upload`
> - 用户说"把音视频文件转成纪要 / 逐字稿 / 文字稿 / 撰写文字 / 总结 / 待办 / 章节" → 先上传获取 `file_token`，调用 `minutes +upload` 生成 `minute_url`，再提取 `minute_token` 走 `vc +notes --minute-tokens`
> - 用户说"把音视频文件转成纪要 / 逐字稿 / 文字稿 / 撰写文字 / 总结 / 待办 / 章节" → 先上传获取 `file_token`，调用 `minutes +upload` 生成 `minute_url`，再提取 `minute_token` 走 `minutes +detail --minute-tokens`
> - 用户说"重命名妙记 / 改妙记标题 / 修改妙记名字" → `minutes +update`
> - 用户说"替换说话人 / 把 A 的发言改成 B / 重新归属发言人" → `minutes +speaker-replace`
> - 用户说"批量替换逐字稿关键词" → `minutes +word-replace`
@@ -223,7 +224,6 @@ lark-cli minutes <resource> <method> [flags]
## 不在本 skill 范围
- 已有 `minute_token` 的纪要/逐字稿/总结/待办/章节内容获取 → [lark-vc](../lark-vc/SKILL.md)（`vc +notes --minute-tokens`）
- 只有自然语言纪要标题的逐字稿查询 → 文档搜索 / Docx 正文读取；有显式 `vc-node-id` 才进入 [lark-note](../lark-note/SKILL.md)
- 搜索历史会议记录 → [lark-vc](../lark-vc/SKILL.md)
- 查询未来的会议日程 → [lark-calendar](../lark-calendar/SKILL.md)

85
skills/lark-minutes/references/lark-minutes-detail.md Normal file
View File

@@ -0,0 +1,85 @@
# minutes +detail
> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
通过妙记 Token 查询妙记详情，支持按需获取 AI 产物（总结、待办、章节、逐字稿、关键词）。只读操作。
> **重要约束**：必须**显式指定**要获取哪些产物的 flag（`--summary` / `--todo` / `--chapter` / `--keyword` / `--transcript`），未传任何产物 flag 时只返回基础信息（如 `title`），不会返回任何 AI 产物内容。一次性获取所有产物可使用：`--summary --todo --chapter --keyword --transcript`。
本 skill 对应 shortcut：`lark-cli minutes +detail`。
## 命令
```bash
# 查询妙记基础信息（标题）
lark-cli minutes +detail --minute-tokens obcxxxxxxxxxx
# 批量查询（逗号分隔，最多 50 个）
lark-cli minutes +detail --minute-tokens obcxxxxxxxxxx,obcyyyyyyyyyy
# 按需获取 AI 产物
lark-cli minutes +detail --minute-tokens obcxxxxxxxxxx --summary --todo --chapter --transcript --keyword
# 逐字稿输出到文件（默认 ./minutes/{minute_token}/transcript.txt）
lark-cli minutes +detail --minute-tokens obcxxxxxxxxxx --transcript
# 覆盖已有逐字稿文件
lark-cli minutes +detail --minute-tokens obcxxxxxxxxxx --transcript --overwrite
```
## 参数
| 参数 | 必填 | 说明 |
|------|------|------|
| `--minute-tokens <tokens>` | 是 | 妙记 Token，逗号分隔支持批量，最多 50 个。仅支持小写字母和数字 |
| `--summary` | 否 | 包含 AI 总结 |
| `--todo` | 否 | 包含待办事项 |
| `--chapter` | 否 | 包含章节纪要 |
| `--transcript` | 否 | 包含逐字稿（保存到本地文件） |
| `--keyword` | 否 | 包含推荐关键词 |
| `--overwrite` | 否 | 覆盖已存在的逐字稿文件（仅 `--transcript` 有效） |
| `--dry-run` | 否 | 预览 API 调用，不执行 |
## 输出结果
返回 `minutes` 数组，每条记录包含：
| 字段 | 说明 |
|------|------|
| `minute_token` | 妙记 Token |
| `title` | 妙记标题（如有） |
| `artifacts` | AI 产物（仅指定了 `--summary`/`--todo`/`--chapter`/`--transcript`/`--keyword` 时返回） |
### artifacts 字段
请求的 AI 产物**始终返回对应字段**：
| 字段 | 类型 | 说明 |
|------|------|------|
| `artifacts.summary` | string | AI 总结。为空时返回 `""` |
| `artifacts.todos` | array | 待办事项列表。为空时返回 `[]` |
| `artifacts.chapters` | array | 章节列表。为空时返回 `[]` |
| `artifacts.keywords` | array | 关键词列表。为空时返回 `[]` |
| `artifacts.transcript_file` | string | 逐字稿本地文件路径。为空时返回 `""` |
> 未请求的产物不会出现在 `artifacts` 中。例如只传了 `--summary`，则 `artifacts` 中只有 `summary` 字段。
### 逐字稿文件路径
指定 `--transcript` 时，逐字稿默认保存到 `./minutes/{minute_token}/transcript.txt`，与 `minutes +download` 的默认落点保持一致，便于 Agent 聚合同一妙记的所有产物。
## 如何获取输入参数
| 输入参数 | 获取方式 |
|---------|---------|
| `minute_token` | 从妙记 URL 中提取，如 `https://sample.feishu.cn/minutes/obcxxx` → `obcxxx` |
| `minute_token` | `vc +detail --meeting-ids` → 结果中的 `minute_token` 字段 |
| `minute_token` | `vc +recording --meeting-ids` → 结果中的 `minute_token` 字段 |
| `minute_token` | `minutes +search` → 结果中的 `minute_token` 字段 |
## 参考
- [lark-minutes](../SKILL.md) — 妙记全部命令
- [lark-vc](../../lark-vc/SKILL.md) — 视频会议（获取 minute_token）
- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

10
skills/lark-minutes/references/lark-minutes-download.md
View File

@@ -43,7 +43,7 @@ lark-cli minutes +download --minute-tokens obcnxxxxxxxxxxxxxxxxxxxx --dry-run
| `--url-only` | 否 | 仅返回下载链接，不下载文件 |
| `--dry-run` | 否 | 预览 API 调用，不执行 |
> **默认落点**：未指定 `--output` / `--output-dir` 时，文件落到 `./minutes/{minute_token}/<server-filename>`。文件名沿用服务端 Content-Disposition / Content-Type 推断，Agent 可从 `saved_path` 字段读取实际路径。同一 minute_token 的录像和 `vc +notes` 的逐字稿默认会落在**同一目录**下，方便聚合。
> **默认落点**：未指定 `--output` / `--output-dir` 时，文件落到 `./minutes/{minute_token}/<server-filename>`。文件名沿用服务端 Content-Disposition / Content-Type 推断，Agent 可从 `saved_path` 字段读取实际路径。同一 minute_token 的录像和 `minutes +detail` 的逐字稿默认会落在**同一目录**下，方便聚合。
## 核心约束
@@ -85,7 +85,7 @@ API 限流 5 次/秒，批量下载时需注意控制频率。
| 字段 | 说明 |
|------|------|
| `minute_token` | 妙记 Token（用于 Agent 索引） |
| `artifact_type` | 固定为 `"recording"`（与 `vc +notes` 的 `"transcript"` 区分） |
| `artifact_type` | 固定为 `"recording"`（与 `minutes +detail` 的 `"transcript"` 区分） |
| `saved_path` | 文件保存的本地路径（绝对路径） |
| `size_bytes` | 文件大小（字节） |
@@ -125,13 +125,13 @@ API 限流 5 次/秒，批量下载时需注意控制频率。
## 提示
- 音视频文件可能较大，下载无固定超时限制（由用户 Ctrl+C 控制取消）。
- 默认落点 `./minutes/{minute_token}/` 与 `vc +notes` 的逐字稿共享同一目录，方便 Agent 聚合同一会议的所有产物。
- 默认落点 `./minutes/{minute_token}/` 与 `minutes +detail` 的逐字稿共享同一目录，方便 Agent 聚合同一会议的所有产物。
- 单 token 模式下 `--output` 若传入已存在目录（如 `--output ./existing-dir`），等价于 `--output-dir`，文件落入该目录（cp 语义）。
- 批量模式下 `--output` 不接受已存在的文件路径（会报错），应改用 `--output-dir`。
- 如需获取妙记的纪要内容（逐字稿、AI 总结等），请使用 [vc +notes](../../lark-vc/references/lark-vc-notes.md)。
- 如需获取妙记的纪要内容（逐字稿、AI 总结等），请使用 [minutes +detail](lark-minutes-detail.md)。
## 参考
- [lark-minutes](../SKILL.md) — 妙记全部命令
- [lark-vc-notes](../../lark-vc/references/lark-vc-notes.md) — 会议纪要查询
- [lark-minutes-detail](lark-minutes-detail.md) — 妙记详情与 AI 产物查询
- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

10
skills/lark-minutes/references/lark-minutes-search.md
View File

@@ -129,8 +129,6 @@ CLI 会先按输入的本地日历日语义解析，再标准化为 RFC3339 时
2. `vc +recording` 获取 `minute_token`
3. `minutes minutes get` 查询妙记基础信息
不要为了查"妙记信息"直接走 `vc +notes --meeting-ids`。`vc +notes` 只适用于逐字稿、总结、待办、章节等纪要内容。
<br />
## 时间格式
@@ -173,8 +171,8 @@ lark-cli minutes +search --query "预算复盘" --page-size 20 --page-token '<PA
# 首先查询妙记元信息（标题、时长、封面） → 用本 skill
lark-cli minutes minutes get --params '{"minute_token": "obcn***************"}'
# 查妙记关联的纪要产物：逐字稿、总结、待办、章节等 → 用 lark-cli vc +notes
lark-cli vc +notes --minute-tokens obcn_EXAMPLE_TOKEN
# 查妙记关联的纪要产物：逐字稿、总结、待办、章节等 → 用 lark-cli minutes +detail
lark-cli minutes +detail --minute-tokens obcn_EXAMPLE_TOKEN
```
## 常见错误与排查
@@ -192,7 +190,7 @@ lark-cli vc +notes --minute-tokens obcn_EXAMPLE_TOKEN
- 当用户说“我的妙记”时，优先理解为 `--owner-ids me`。
- 当用户说“我参与的妙记”“我参加过的妙记”时，默认理解为 `--owner-ids me` 与 `--participant-ids me` 两次查询后的并集。
- 当用户明确说“仅我参与但不是我拥有”时，才优先理解为 `--participant-ids me`。
- 当用户同时提到“会议 / 会 / 开会 / 某场会”和“妙记”时，优先先定位会议；如果要的是妙记信息，走 `vc +recording` → `minutes minutes get`，只有要纪要内容时才走 `vc +notes --minute-tokens`。
- 当用户同时提到“会议 / 会 / 开会 / 某场会”和“妙记”时，优先先定位会议；如果要的是妙记信息，走 `vc +detail` 获取 `minute_token` → `minutes minutes get`，只有要纪要内容时才走 `minutes +detail --minute-tokens`。
- 必须使用 `--format json` 输出，你更加擅长解析 JSON 数据。
- 排查参数与请求结构时优先使用 `--dry-run`。
- 搜索的时间范围最大为 1 个月，如果需要搜索更长时间范围的妙记，需要拆分为多次时间范围为一个月查询。
@@ -200,7 +198,7 @@ lark-cli vc +notes --minute-tokens obcn_EXAMPLE_TOKEN
## 参考
- [lark-minutes](../SKILL.md) -- 妙记相关命令
- [lark-vc-notes](../../lark-vc/references/lark-vc-notes.md) -- 基于 `minute_token` 获取逐字稿、总结、待办、章节等产物
- [lark-minutes-detail](lark-minutes-detail.md) -- 基于 `minute_token` 获取逐字稿、总结、待办、章节等产物
- [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数
- [lark-vc](../../lark-vc/SKILL.md) -- 视频会议全部命令

12
skills/lark-minutes/references/lark-minutes-upload.md
View File

@@ -31,13 +31,13 @@
```
- 命令执行成功后，将返回生成的妙记链接 `minute_url`。
3. **如需纪要 / 逐字稿 / 文字稿 / 撰写文字，继续提取 `minute_token` 调用 `vc +notes`**
3. **如需纪要 / 逐字稿 / 文字稿 / 撰写文字，继续提取 `minute_token` 调用 `minutes +detail`**
- 从返回的 `minute_url` 中提取路径最后一段，得到 `minute_token`。
- 如果用户要的是纪要、逐字稿、文字稿、撰写文字、总结、待办或章节，继续调用：
```bash
lark-cli vc +notes --minute-tokens <minute_token>
lark-cli minutes +detail --minute-tokens <minute_token> --transcript
```
- `vc +notes --minute-tokens` 会返回纪要文档、逐字稿文档，以及 AI 内置产物（总结、待办、章节）；必要时还会把逐字稿落地到本地文件。
- `minutes +detail --minute-tokens` 会返回纪要文档、逐字稿文档，以及 AI 内置产物（总结、待办、章节）；必要时还会把逐字稿落地到本地文件。
> **异步生成提示**：API 会立即返回 `minute_url`，但妙记可能仍在异步生成中，您可以直接通过该妙记链接查看当前的处理状态和转写结果。
@@ -48,7 +48,7 @@
lark-cli minutes +upload --file-token boxcnxxxxxxxxxxxxxxxx
# 通过 minute_token 继续获取纪要 / 逐字稿 / 文字稿 / AI 产物
lark-cli vc +notes --minute-tokens obcnxxxxxxxxxxxxxxxx
lark-cli minutes +detail --minute-tokens obcnxxxxxxxxxxxxxxxx
```
## 参数
@@ -81,9 +81,9 @@ lark-cli vc +notes --minute-tokens obcnxxxxxxxxxxxxxxxx
1. 使用 `lark-cli drive +upload --file <path>` 上传本地音视频文件到云空间（云盘/云存储）
2. 从返回结果中取出 `file_token`
3. 调用 `lark-cli minutes +upload --file-token <file_token>` 生成妙记
4. 如果目标是纪要、逐字稿、文字稿、撰写文字、总结、待办或章节，再从 `minute_url` 提取 `minute_token`，继续调用 `lark-cli vc +notes --minute-tokens <minute_token>`
4. 如果目标是纪要、逐字稿、文字稿、撰写文字、总结、待办或章节，再从 `minute_url` 提取 `minute_token`，继续调用 `lark-cli minutes +detail --minute-tokens <minute_token>`
> **边界说明**：`minutes +upload` 本身只负责把文件转成妙记并返回 `minute_url`。纪要内容、逐字稿、文字稿、撰写文字、总结、待办、章节属于后续产物获取，应由 [vc +notes](../../lark-vc/references/lark-vc-notes.md) 承接。
> **边界说明**：`minutes +upload` 本身只负责把文件转成妙记并返回 `minute_url`。纪要内容、逐字稿、文字稿、撰写文字、总结、待办、章节属于后续产物获取，应由 [minutes +detail](lark-minutes-detail.md) 承接。
## 输出结果示例

5
skills/lark-note/SKILL.md
View File

@@ -12,6 +12,11 @@ metadata:
身份：仅使用 `--as user`。使用前阅读 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)。
**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-vc/references/vc-domain-boundaries.md`](../lark-vc/references/vc-domain-boundaries.md)**，不读将导致命令使用、会议产物决策、领域边界职责判断错误：
> 1. 了解日历 & VC、会议产物 & 文档的关联关系和职责划分
> 2. 了解会议产物（妙记和纪要）之间的关联关系，例如：**妙记和纪要产生条件相互独立**
> 3. 了解不同会议产物的组成部分，以便根据需求决策使用哪种产物的数据
Note 域只接受显式 `note_id`：用户直接提供，或 `docs +fetch --api-version v2` 返回的 `<vc-transcribe-tab vc-node-id="...">` 中的 `vc-node-id`。不要从 `doc_token`、标题、正文或 backlink 反推 `note_id`。
## 命令路由

6
skills/lark-vc-agent/SKILL.md
View File

@@ -55,8 +55,8 @@ metadata:
2. 输入是 **`meeting_id`**（长数字 ID），不是 9 位会议号。
3. Bot 必须**真实参会过**（先 `+meeting-join`），否则事件流通常不可见。具体的状态边界、结束后宽限窗口与错误码（如 `10005 / 20001 / 20002`）请查看 `+meeting-events` reference。
4. **不能做会后复盘**，**不能替代参会人快照查询**。如果会议已结束：
- 想拿纪要文档或逐字稿文档 token：用 `lark-cli vc +notes --meeting-ids <meeting.id>`
- 想拿 AI 产物（summary / todos / chapters）或导出逐字稿文件：先用 `lark-cli vc +recording --meeting-ids <meeting.id>` 拿 `minute_token`，再用 `lark-cli vc +notes --minute-tokens <minute_token>`
- **优先（拿纪要类文档：智能纪要 / 逐字稿 / 共享文档）**：先 `lark-cli vc +detail --meeting-ids <meeting.id>` 拿 `note_id` 和 `minute_token`；再 `lark-cli note +detail --note-id <note_id>` 拿 `note_doc_token`（智能纪要）/ `verbatim_doc_token`（逐字稿）。
- **备选（拿妙记 AI 产物）**：用上一步的 `minute_token` 调 `lark-cli minutes +detail --minute-tokens <minute_token> --summary --todo --chapter --keyword --transcript`（**必须显式指定产物 flag，不传则不返回任何产物内容**）。
- 想看参会人快照：用 `vc meeting get --with-participants`（见 [`lark-vc`](../lark-vc/SKILL.md)）
5. **默认必须使用** **`--page-all`**，除非用户明确要求“只查一页”，或确实需要控制返回体大小。
6. 输出格式默认优先 `--format pretty`（时间线更易读）；只有在需要完整保留原始消息流与结构化字段时，才使用 `--format json`。
@@ -84,7 +84,7 @@ MID=$(echo "$JOIN" | jq -r '.data.meeting.id')
lark-cli vc +meeting-events --meeting-id "$MID" --page-all --format pretty
# 3. 会后可选：取纪要 / 逐字稿（跨到 lark-vc）
lark-cli vc +notes --meeting-ids "$MID"
lark-cli vc +detail --meeting-ids "$MID"
```
如果用户随后明确要求退出 / 离开 / 结束参会，再单独调用 `lark-cli vc +meeting-leave --meeting-id "$MID"`。

8
skills/lark-vc-agent/references/lark-vc-agent-meeting-events.md
View File

@@ -222,7 +222,7 @@ lark-cli vc +meeting-events \
|---------|---------|---------|
| `--meeting-id is required` | 未传入 `--meeting-id` | 传入长数字 `meeting.id` |
| `10005 bot is not in meeting` | bot 从未真实入会该会议；或会议已结束但 bot 从未在会中出现过 | 先 `+meeting-join --meeting-number <9位号>` 真实入会再查；如果会议已经结束且当时 bot 没进过会，本接口也拉不到数据。**如果只是想看参会人快照，改用 `lark-cli vc meeting get --params '{"meeting_id":"<meeting.id>"}' --with-participants`**（不依赖 bot 身份参会） |
| `20001 meeting_status_MEETING_END` | 会议已结束且已超出后端允许的 5 分钟宽限窗口 | 本接口不再适合继续拉取事件。若要拿纪要文档或逐字稿 token，用 `lark-cli vc +notes --meeting-ids <meeting.id>`；若要拿 AI 产物（summary / todos / chapters）或导出逐字稿文件，先用 `lark-cli vc +recording --meeting-ids <meeting.id>` 拿 `minute_token`，再用 `lark-cli vc +notes --minute-tokens <minute_token>`；参会人请用 `lark-cli vc meeting get --params '{"meeting_id":"<meeting.id>"}' --with-participants` |
| `20001 meeting_status_MEETING_END` | 会议已结束且已超出后端允许的 5 分钟宽限窗口 | 本接口不再适合继续拉取事件。**会后拉产物分两步走**：① `lark-cli vc +detail --meeting-ids <meeting.id>` 拿 `note_id` 和 `minute_token`；② 优先 `lark-cli note +detail --note-id <note_id>` 取 `note_doc_token` / `verbatim_doc_token` / `shared_doc_tokens` 后用 `docs +fetch` 读正文；若用户要妙记 AI 产物（summary / todos / chapters / transcript），用 `lark-cli minutes +detail --minute-tokens <minute_token> --summary --todo --chapter --transcript`（**必须显式指定 flag，不传则不返回产物**）；参会人请用 `lark-cli vc meeting get --params '{"meeting_id":"<meeting.id>"}' --with-participants` |
| `20002 meeting not exist` | `meeting_id` 错误，或会议实例当前已不可获取（常见于把 9 位会议号当 meeting_id 传） | 确认传入的是长数字 `meeting_id`，不是 9 位会议号 |
| `HTTP 404` / `HTTP 500` | 服务端当前无法找到或处理该会议实例 | 换一个正在进行且 bot 可见的 meeting_id，或排查后端问题 |
@@ -230,8 +230,8 @@ lark-cli vc +meeting-events \
- 这是**会中事件流**查询，不适合拿来搜历史会议记录；搜历史会议请用 `+search`。
- 如果会议已经结束，不要卡在 `+meeting-events`：
- 想拿纪要文档或逐字稿 token：用 `lark-cli vc +notes --meeting-ids <meeting.id>`
- 想拿 AI 产物（summary / todos / chapters）或导出逐字稿文件：先用 `lark-cli vc +recording --meeting-ids <meeting.id>` 拿 `minute_token`，再用 `lark-cli vc +notes --minute-tokens <minute_token>`
- 想拿纪要文档或逐字稿 token：用 `lark-cli vc +detail --meeting-ids <meeting.id>`
- 想拿 AI 产物（summary / todos / chapters）或导出逐字稿文件：先用 `lark-cli vc +detail --meeting-ids <meeting.id>` 拿 `minute_token`，再用 `lark-cli minutes +detail --minute-tokens <minute_token>`
- 事件列表是否完整，取决于 bot 何时入会、何时离会，以及后端当前可见的会中事件范围。对于已结束会议，通常只在**结束后 5 分钟内**、且 bot **曾经在会中**时还能继续拉到事件。
- 查询"谁参加过某会议"请用 `vc meeting get --params '{"meeting_id":"<id>","with_participants":true}'`——这是参会人**快照** API，不依赖 bot 是否参会，对已结束会议也可查；**不要** 用 `+meeting-events` 做参会人查询。
@@ -241,7 +241,7 @@ lark-cli vc +meeting-events \
- [lark-vc-agent-meeting-leave](lark-vc-agent-meeting-leave.md) — 用户明确要求时离会
- [lark-vc-search](../../lark-vc/references/lark-vc-search.md) — 搜索历史会议（获取 meeting_id）
- [lark-vc-recording](../../lark-vc/references/lark-vc-recording.md) — 查询 minute_token
- [lark-vc-notes](../../lark-vc/references/lark-vc-notes.md) — 获取会议纪要
- [lark-vc-detail](../../lark-vc/references/lark-vc-detail.md) — 获取会议详情
- [lark-vc-agent](../SKILL.md) — Agent 参会能力（本 skill）
- [lark-vc](../../lark-vc/SKILL.md) — 视频会议原子域（Meeting / Note 等核心概念）
- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

12
skills/lark-vc-agent/references/lark-vc-agent-meeting-join.md
View File

@@ -103,8 +103,14 @@ lark-cli vc +meeting-join --meeting-number 123456789
# 第 2 步：会议结束后，查询录制（拿到 minute_token）
lark-cli vc +recording --meeting-ids <meeting.id>
# 第 3 步：查询会议纪要（总结 / 待办 / 章节 / 逐字稿）
lark-cli vc +notes --meeting-ids <meeting.id>
# 第 3 步：查询会议详情，拿到 note_id 和 minute_token
lark-cli vc +detail --meeting-ids <meeting.id>
# 第 4 步：根据用户诉求拉取实际产物
# 优先：通过 note_id 获取纪要文档 token，再用 docs +fetch 读取正文
lark-cli note +detail --note-id <note_id>
# 备选：通过 minute_token 获取妙记产物（必须显式指定要哪些产物）
lark-cli minutes +detail --minute-tokens <minute_token> --summary --todo --chapter --transcript
```
## 常见错误与排查
@@ -129,7 +135,7 @@ lark-cli vc +notes --meeting-ids <meeting.id>
- [lark-vc-agent-meeting-events](lark-vc-agent-meeting-events.md) — 会中事件流
- [lark-vc-search](../../lark-vc/references/lark-vc-search.md) — 搜索历史会议记录
- [lark-vc-recording](../../lark-vc/references/lark-vc-recording.md) — 查询 minute_token
- [lark-vc-notes](../../lark-vc/references/lark-vc-notes.md) — 获取会议纪要
- [lark-vc-detail](../../lark-vc/references/lark-vc-detail.md) — 获取会议详情
- [lark-vc-agent](../SKILL.md) — Agent 参会能力（本 skill）
- [lark-vc](../../lark-vc/SKILL.md) — 视频会议原子域（Meeting / Note 等核心概念）
- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

14
skills/lark-vc-agent/references/lark-vc-agent-meeting-leave.md
View File

@@ -77,11 +77,17 @@ lark-cli vc +meeting-leave --meeting-id <meeting.id>
如果用户只是要求会议结束后拉录制、纪要或逐字稿，不要先调用 `+meeting-leave`；直接跨到 `lark-vc` 查询会后产物。
```bash
# 第 1 步：会议结束后查询录制
# 第 1 步：会议结束后查询录制（minute_token）
lark-cli vc +recording --meeting-ids <meeting.id>
# 第 2 步：查询会议纪要
lark-cli vc +notes --meeting-ids <meeting.id>
# 第 2 步：查询会议详情，拿到 note_id 和 minute_token
lark-cli vc +detail --meeting-ids <meeting.id>
# 第 3 步：根据用户诉求继续拉产物
# 优先：通过 note_id 获取纪要文档 token，再用 docs +fetch 读正文
lark-cli note +detail --note-id <note_id>
# 备选：通过 minute_token 获取妙记产物（必须显式指定 flag）
lark-cli minutes +detail --minute-tokens <minute_token> --summary --todo --chapter --transcript
```
## 常见错误与排查
@@ -104,7 +110,7 @@ lark-cli vc +notes --meeting-ids <meeting.id>
- [lark-vc-agent-meeting-events](lark-vc-agent-meeting-events.md) — 会中事件流
- [lark-vc-search](../../lark-vc/references/lark-vc-search.md) — 搜索历史会议（获取 meeting_id）
- [lark-vc-recording](../../lark-vc/references/lark-vc-recording.md) — 查询 minute_token
- [lark-vc-notes](../../lark-vc/references/lark-vc-notes.md) — 获取会议纪要
- [lark-vc-detail](../../lark-vc/references/lark-vc-detail.md) — 获取会议详情
- [lark-vc-agent](../SKILL.md) — Agent 参会能力（本 skill）
- [lark-vc](../../lark-vc/SKILL.md) — 视频会议原子域（Meeting / Note 等核心概念）
- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

13
skills/lark-vc/SKILL.md
View File

@@ -35,7 +35,7 @@ lark-cli vc +search --query "站会" --start-time ...
| Shortcut | 说明 |
|----------|------|
| [`+search`](references/lark-vc-search.md) | 搜索历史会议记录（需至少一个筛选条件） |
| [`+notes`](references/lark-vc-notes.md) | 查询会议纪要和妙记产物（通过 meeting-ids、minute-tokens 或 calendar-event-ids） |
| [`+detail`](references/lark-vc-detail.md) | 通过 meeting-ids 获取会议详情，包括 note_id 和 minute_token |
| [`+recording`](references/lark-vc-recording.md) | 通过 meeting-ids 或 calendar-event-ids 查询 minute_token |
- 使用任何 Shortcut 前，必须先读其对应 reference 文档。
@@ -49,7 +49,8 @@ lark-cli vc +search --query "站会" --start-time ...
| 查"今天有哪些会议" | `vc +search`（已结束）+ lark-calendar（未开始），合并展示 |
| 只按自然语言标题查"xx 纪要的逐字稿 / 原始记录 / 谁说了什么" | 先到 [lark-drive](../lark-drive/SKILL.md) / [lark-doc](../lark-doc/SKILL.md)；仅在已拿到 `note_id` / `vc-node-id` 后再到 [lark-note](../lark-note/SKILL.md) |
| Agent 真实入会/离会、会中实时事件 | [lark-vc-agent](../lark-vc-agent/SKILL.md) |
| 本地音视频文件转纪要/逐字稿 | 先走 [lark-minutes](../lark-minutes/SKILL.md) 上传，再回 `vc +notes --minute-tokens` |
| 妙记信息/时长/封面/链接 | 先走 `vc +detail` 获取 `minute_token`，再用 [lark-minutes](../lark-minutes/SKILL.md) 的 `minutes get` |
| 本地音视频文件转纪要/逐字稿 | 先走 [lark-minutes](../lark-minutes/SKILL.md) 上传，再用 `minutes +detail --minute-tokens` |
## 核心概念
@@ -98,7 +99,7 @@ lark-cli docs +fetch --api-version v2 --doc <note_doc_token> --doc-format markdo
# 并非所有纪要都有封面画板，没有 <whiteboard> 标签时跳过即可
lark-cli docs +media-download --type whiteboard --token <whiteboard_token> --output ./minutes/<minute_token>/cover
```
> **产物目录规范**：同一会议的所有下载产物（录像、逐字稿、封面图等）统一放到 `./minutes/{minute_token}/` 目录下。这与 `minutes +download` 和 `vc +notes --minute-tokens` 的默认落点保持一致，便于 Agent 聚合。显式路径（如封面图）需手动对齐到同一目录。
> **产物目录规范**：同一会议的所有下载产物（录像、逐字稿、封面图等）统一放到 `./minutes/{minute_token}/` 目录下。这与 `minutes +download` 和 `minutes +detail --minute-tokens` 的默认落点保持一致，便于 Agent 聚合。显式路径（如封面图）需手动对齐到同一目录。
> **纪要相关文档 — 根据用户意图选择：**
> - `note_doc_token` → **AI 智能纪要**（AI 总结 + 待办）
@@ -106,7 +107,7 @@ lark-cli docs +media-download --type whiteboard --token <whiteboard_token> --out
> - 用户说"逐字稿""完整记录""谁说了什么"时 → 按 `note_display_type` 路由，详见 [`+notes`](references/lark-vc-notes.md)
> - 用户说"纪要""总结""纪要内容"时，应同时返回 `note_doc_token` 和 `meeting_notes`（如有）
> - 用户意图不明确时，应展示所有文档链接让用户选择，而不是替用户决定
> - 如果用户提供的是**本地音视频文件**并说"转纪要""转逐字稿"，不要直接从 `vc +notes` 开始；应先用 [minutes +upload](../lark-minutes/references/lark-minutes-upload.md) 生成 `minute_url`，再提取 `minute_token` 调用 `vc +notes --minute-tokens`
> - 如果用户提供的是**本地音视频文件**并说"转纪要""转逐字稿"，不要直接从 `vc +detail` 开始；应先用 [minutes +upload](../lark-minutes/references/lark-minutes-upload.md) 生成 `minute_url`，再提取 `minute_token` 调用 `minutes +detail --minute-tokens`
### 3. 纪要文档与逐字稿链接
1. 纪要文档、逐字稿文档与关联的共享文档默认使用文档 Token 返回。
@@ -137,7 +138,7 @@ lark-cli vc meeting get --params '{"meeting_id":"<meeting_id>","with_participant
| 用户意图 | 推荐命令 | 所在 skill |
|---------|---------|--------|
| 参会人快照（谁参加过、何时入/离会，任意时点）| `vc meeting get --with-participants` | 本 skill |
| 已结束会议的发言内容 | 先 `vc +notes`，再按 `note_display_type` 路由 | 本 skill / [`lark-note`](../lark-note/SKILL.md) |
| 已结束会议的发言内容 | 优先：`vc +detail` 取 `note_id` 再 `note +detail` 取 `verbatim_doc_token` 后 `docs +fetch`；备选：`vc +detail` 取 `minute_token` 再 `minutes +detail --transcript` | [lark-note](../lark-note/SKILL.md) / [lark-minutes](../lark-minutes/SKILL.md) |
| **进行中会议**的实时事件流（转写、聊天、共享、会中加入/离开）| `vc +meeting-events` | [`lark-vc-agent`](../lark-vc-agent/SKILL.md) |
| **Agent 真实入会 / 离会** | `vc +meeting-join` / `vc +meeting-leave` | [`lark-vc-agent`](../lark-vc-agent/SKILL.md) |
@@ -193,5 +194,5 @@ lark-cli vc meeting get --params '{"meeting_id": "<meeting_id>", "with_participa
- 查询未来的会议日程 → [lark-calendar](../lark-calendar/SKILL.md)
- Agent 真实入会/离会、会中实时事件 → [lark-vc-agent](../lark-vc-agent/SKILL.md)
- 只有纪要文档标题的逐字稿查询 → 文档搜索 / Docx 正文读取；有显式 `vc-node-id` 才进入 [lark-note](../lark-note/SKILL.md)
- 本地音视频文件转纪要/逐字稿 → [lark-minutes](../lark-minutes/SKILL.md)（上传后回 `vc +notes`）
- 本地音视频文件转纪要/逐字稿 → [lark-minutes](../lark-minutes/SKILL.md)（上传后使用 `minutes +detail`）
- 妙记搜索/下载/上传/重命名/替换说话人 → [lark-minutes](../lark-minutes/SKILL.md)

71
skills/lark-vc/references/lark-vc-detail.md Normal file
View File

@@ -0,0 +1,71 @@
# vc +detail
> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
通过会议 ID 获取会议详情，包括会议基本信息、关联的纪要 ID（`note_id`）和妙记 Token（`minute_token`）。只读操作。
本 skill 对应 shortcut：`lark-cli vc +detail`。
## 命令
```bash
# 批量查询（逗号分隔，最多 50 个）
lark-cli vc +detail --meeting-ids 69xxxxxxxxxxxxx28,69xxxxxxxxxxxxx29
```
## 参数
| 参数 | 必填 | 说明 |
|------|------|------|
| `--meeting-ids <ids>` | 是 | 会议 ID，逗号分隔支持批量，最多 50 个 |
## 输出结果
返回 `meetings` 数组，每条记录包含：
| 字段 | 说明 |
|------|------|
| `meeting_id` | 会议 ID |
| `meeting_no` | 会议 9 位号码 |
| `topic` | 会议主题 |
| `start_time` | 开始时间 |
| `end_time` | 结束时间 |
| `note_id` | 关联的纪要 ID。 |
| `minute_token` | 关联的妙记 Token。 |
## 典型场景
### 场景 1：获取会议的纪要和妙记关联
`vc +detail` 只能拿到 `note_id` 和 `minute_token`，不直接返回纪要文档 token 与妙记产物内容。要获取实际产物，需根据用户诉求继续调用 `note +detail` 或 `minutes +detail`：
```bash
# 1. 获取会议详情，拿到 note_id 和 minute_token
lark-cli vc +detail --meeting-ids 69xxxxxxxxxxxxx28
# 2. 用 note_id 获取纪要文档 Token（note_doc_token / verbatim_doc_token / shared_doc_tokens）
lark-cli note +detail --note-id <note_id>
# 3. 用 minute_token 获取妙记产物
# ⚠️ 必须显式指定 --summary / --todo / --chapter / --keyword / --transcript 中至少一个 flag，
# 不传任何 flag 则不会返回任何产物内容。
lark-cli minutes +detail --minute-tokens <minute_token> --todo --transcript
```
> **路由建议**：当用户未明确指定使用妙记时，**优先**走 `note +detail` 链路（纪要文档信息更完整、含逐字稿原文），仅在 `note_id` 为空或用户要求妙记产物时才走 `minutes +detail`。
## 与其他命令的关系
| 需求 | 推荐命令 |
|------|---------|
| 只需获取 note_id 和 minute_token | `vc +detail` |
| 需要纪要文档 Token（note_doc_token、verbatim_doc_token 等） | `note +detail --note-id` |
| 需要妙记的 AI 产物（总结、待办、章节、逐字稿） | `minutes +detail --minute-tokens` |
## 参考
- [lark-vc](../SKILL.md) — 视频会议全部命令
- [lark-note-detail](../../lark-note/references/lark-note-detail.md) — 查询纪要详情命令介绍
- [lark-minutes-detail](../../lark-minutes/references/lark-minutes-detail.md) — 查询妙记详情命令介绍
- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

9
skills/lark-vc/references/lark-vc-recording.md
View File

@@ -5,7 +5,7 @@
通过 meeting_id 或 calendar_event_id 查询对应的 minute_token。这是 VC 域和 Minutes 域之间的桥梁命令。只读操作。
> **边界提醒：** 如果用户明确要的是"妙记信息""妙记详情""妙记链接""minute_token""标题""时长""owner"这类妙记元信息，先用本命令拿到 `minute_token`，再调用 `minutes minutes get`。不要直接切到 `vc +notes`；`vc +notes` 只用于纪要内容和逐字稿。
> **边界提醒：** 如果用户明确要的是"妙记信息""妙记详情""妙记链接""minute_token""标题""时长""owner"这类妙记元信息，先用本命令拿到 `minute_token`，再调用 `minutes minutes get`。不要直接切到 `minutes +detail`；`minutes +detail` 只用于纪要内容和逐字稿。
本 skill 对应 shortcut：`lark-cli vc +recording`。
@@ -102,7 +102,8 @@ lark-cli minutes minutes get --params '{"minute_token":"<minute_token>"}'
lark-cli vc +recording --meeting-ids xxx
# 第 2 步：使用上一步返回的 minute_token 获取完整纪要
lark-cli vc +notes --minute-tokens <minute_token>
# ⚠️ 必须显式指定要获取的产物 flag，不传则不会返回任何产物内容
lark-cli minutes +detail --minute-tokens <minute_token> --summary --todo --chapter --transcript
```
### 场景 4：先搜索会议，再获取录制并下载
@@ -143,11 +144,11 @@ lark-cli minutes +download --minute-tokens <minute_token>
- 默认使用 `--format json` 输出，Agent 更擅长解析 JSON 数据。
- 排查参数与请求结构时优先使用 `--dry-run`。
- `minute_token` 从录制 URL 尾段解析（`https://meetings.feishu.cn/minutes/{minute_token}`）。
- 拿到 `minute_token` 后，如果要妙记基础信息，优先传给 `minutes minutes get`；如果要下载媒体文件，传给 `minutes +download`；如果要逐字稿、总结、待办、章节，再传给 `vc +notes --minute-tokens`。
- 拿到 `minute_token` 后，如果要妙记基础信息，优先传给 `minutes minutes get`；如果要下载媒体文件，传给 `minutes +download`；如果要逐字稿、总结、待办、章节，再传给 `minutes +detail --minute-tokens`。
## 参考
- [lark-vc](../SKILL.md) — 视频会议全部命令
- [lark-vc-search](lark-vc-search.md) — 搜索历史会议（获取 meeting_id）
- [lark-vc-notes](lark-vc-notes.md) — 获取会议纪要
- [lark-minutes-detail](../../lark-minutes/references/lark-minutes-detail.md) — 获取会议纪要
- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

10
skills/lark-vc/references/lark-vc-search.md
View File

@@ -11,7 +11,7 @@
`--query` 只用于真实会议关键词，例如会议主题、项目名、评审名、客户名。用户只是说"我这月参加的所有视频会议"、"最近两周我组织的所有视频会议"、"总结主要议题 / 看看参会情况"时，本质是历史会议列表和后续总结，不要把"回顾"、"所有视频会议"、"总结主要议题"等动作词放进 `--query`。这类请求应先用时间范围 + `--participant-ids` / `--organizer-ids` 搜全量候选，再按结果继续取纪要或录制信息。
列表阶段只负责找会议记录；总结阶段必须继续取证。若用户要求"主要议题"、"主要决策"、"参会情况"，先确认搜索结果的 `meeting_id`、时间、组织者/参与者符合过滤条件，然后用 `vc +notes` 或 `vc +recording` / `minutes` 读取纪要、妙记或录制信息。没有纪要或妙记时，如实说明只能基于会议标题/参会数据汇总，不要编造议题。
列表阶段只负责找会议记录；总结阶段必须继续取证。若用户要求"主要议题"、"主要决策"、"参会情况"，先确认搜索结果的 `meeting_id`、时间、组织者/参与者符合过滤条件，然后用 `vc +detail` 或 `minutes` 读取纪要、妙记或录制信息。没有纪要或妙记时，如实说明只能基于会议标题/参会数据汇总，不要编造议题。
## 典型触发表达
@@ -161,7 +161,7 @@ lark-cli vc +search --query "周会" --page-size 15 --page-token "<PAGE_TOKEN>"
```bash
# 如果要会议纪要 / 逐字稿 / AI 总结 / 待办 / 章节
lark-cli vc +notes --meeting-ids <MEETING_ID>
lark-cli vc +detail --meeting-ids <MEETING_ID>
# 如果要会议对应的妙记信息 / minute_token / 妙记链接
lark-cli vc +recording --meeting-ids <MEETING_ID>
@@ -183,11 +183,11 @@ lark-cli minutes minutes get --params '{"minute_token":"<MINUTE_TOKEN>"}'
- 排查参数与请求结构时优先使用 `--dry-run`。
- 搜索的时间范围最大为 1 个月，如果需要搜索更长时间范围的会议，需要拆分为多次时间范围为一个月查询。
- 不要使用 `yesterday`、`today` 这类相对时间字面量；请先转换成明确日期，例如 `2026-03-10`。
- 用户如果明确问的是“妙记信息”而不是“纪要内容”，不要默认走 `vc +notes`；应先用 `vc +recording`。
- 用户如果明确问的是“妙记信息”而不是“纪要内容”，不要默认走 `vc +detail`；应先用 `vc +recording`。
## 参考
- [lark-vc](../SKILL.md) -- 视频会议全部命令
- [lark-vc-recording](lark-vc-recording.md) -- 查询会议对应的 minute_token
- [lark-vc-notes](lark-vc-notes.md) -- 获取会议纪要
- [lark-vc-detail](lark-vc-detail.md) -- 获取会议详情
- [lark-vc-recording](lark-vc-recording.md) -- 基于 meeting_id 查询 minute_token
- [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数

27
skills/lark-vc/references/vc-domain-boundaries.md
View File

@@ -93,8 +93,20 @@ lark-cli vc +search --start "<YYYY-MM-DD>" --end "<YYYY-MM-DD>" --format json
##### 获取会议产物
当用户提供 `meeting_id` 并需要会议产物时，先用 `vc +detail` 拿到 `note_id` 和 `minute_token`：
```bash
lark-cli vc +notes --meeting-ids '<meeting_id1>,<meeting_id2>'
lark-cli vc +detail --meeting-ids '<meeting_id1>,<meeting_id2>'
```
详细用法请阅读 [`lark-vc-detail.md`](lark-vc-detail.md)。
**优先路径：通过 `note_id` 获取纪要产物**
如果用户未明确要求使用妙记，且返回了 `note_id`，**优先**使用 `note +detail` 获取纪要文档的 token 信息：
```bash
lark-cli note +detail --note-id <note_id>
```
可获取会议的所有产物信息，包括：
@@ -102,17 +114,20 @@ lark-cli vc +notes --meeting-ids '<meeting_id1>,<meeting_id2>'
- 智能纪要（`note_doc_token`）— AI 生成的总结和待办信息
- 逐字稿（`verbatim_doc_token`）— 完整的会中发言记录（仅 `normal` 纪要可直接读取该文档）
- 共享文档（`shared_doc_token`）— 会中投屏共享的文档
- 妙记 Token（`minute_token`）— 如存在录制产物则返回
详细用法请阅读 [`lark-vc-notes.md`](lark-vc-notes.md)。
拿到文档 token 后，再通过 Doc 域 `docs +fetch` 拉取文档正文内容（见 Step 3）。详细用法请阅读 [`lark-note-detail.md`](../../lark-note/references/lark-note-detail.md)。
如果返回了 `minute_token`，可通过以下命令获取妙记的详细信息（总结、待办、章节、文字记录）：
**备选路径：通过 `minute_token` 获取妙记产物**
如果 `note_id` 为空，或用户明确要求使用妙记产物，则使用 `minutes +detail` 获取妙记的具体产物：
```bash
lark-cli vc +notes --minute-tokens '<minute_token1>,<minute_token2>'
# 必须显式指定要获取的产物 flag，至少传一个；不传则不会返回任何产物内容
lark-cli minutes +detail --minute-tokens '<minute_token1>,<minute_token2>' \
--summary --todo --chapter --keyword --transcript
```
可获取妙记的总结、待办、章节、文字记录等信息。详细用法请阅读 [`lark-vc-notes.md`](lark-vc-notes.md)。
> **注意**：`minutes +detail` 需要**手动指定**要获取的产物 flag，可选 `--summary`（总结）、`--todo`（待办）、`--chapter`（章节）、`--keyword`（关键词）、`--transcript`（文字记录）。**未传任何产物 flag 时不会返回产物内容**，请按用户诉求按需指定。详细用法请阅读 [`lark-minutes-detail.md`](../../lark-minutes/references/lark-minutes-detail.md)。
#### Step 3: 按 `note_display_type` 拉取正文 / 逐字稿

21
skills/lark-workflow-meeting-summary/SKILL.md
View File

@@ -37,7 +37,10 @@ lark-cli auth login --domain vc,drive # 含读取纪要文档正文、生成
{时间范围} ─► vc +search ──► 会议列表 (meeting_ids)
│
▼
vc +notes ──► 纪要文档 tokens
vc +detail ──► 获取 note_id
│
▼
note +detail ──► 纪要文档 tokens
│
▼
drive metas batch_query 纪要元数据
@@ -69,12 +72,16 @@ lark-cli vc +search --start "<YYYY-MM-DD>" --end "<YYYY-MM-DD>" --format json --
1. 查询会议关联的纪要信息
```bash
lark-cli vc +notes --meeting-ids "id1,id2,...,idN"
# 首先获取 note_id 和 minute_token
lark-cli vc +detail --meeting-ids "id1,id2,...,idN"
# 然后用 note_id 获取文档 tokens（如有多个需分别获取）
lark-cli note +detail --note-id "note_id"
```
- 根据上一步搜集到的 `meeting-id` 查询会议纪要。
- 单次最多查询 50 个纪要信息，超过 50 个需分批调用。
- 部分会议返回 `no notes available`，在最终输出中标注"无纪要"
- 记录每个会议的 `note_id`（纪要 ID）、`note_display_type`（展示类型：`unknown` / `normal` / `unified`）、`note_doc_token`（纪要文档 Token）和 `verbatim_doc_token`（逐字稿文档 Token）
- 根据上一步搜集到的 `meeting-id` 查询。
- 单次最多查询 50 个，超过 50 个需分批调用。
- 部分会议没有 `note_id` 或报错 `no notes available`，在最终输出中标注"无纪要"。
- 记录每个纪要的 `note_id`（纪要 ID）、`note_display_type`（展示类型：`unknown` / `normal` / `unified`）、`note_doc_token`（纪要文档 Token）和 `verbatim_doc_token`（逐字稿文档 Token）。
> **逐字稿路由按 `note_display_type` 决定**（详见 [vc-domain-boundaries.md](../lark-vc/references/vc-domain-boundaries.md) 的 Note 域）：
> - `normal`：逐字稿是独立文档，链接/正文走 `verbatim_doc_token`。
@@ -110,6 +117,6 @@ lark-cli docs +update --api-version v2 --doc "<url_or_token>" --command append -
## 参考
- [lark-shared](../lark-shared/SKILL.md) — 认证、权限（必读）
- [lark-vc](../lark-vc/SKILL.md) — `+search`、`+notes` 详细用法
- [lark-vc](../lark-vc/SKILL.md) — `+search`、`+detail` 详细用法
- [lark-note](../lark-note/SKILL.md) — `note +detail`、`note +transcript`（unified 纪要逐字稿）
- [lark-doc](../lark-doc/SKILL.md) — `+fetch`、`+create`、`+update` 详细用法