From e6200453d016167831c087204d2708788d80d118 Mon Sep 17 00:00:00 2001 From: Mushan Yang Date: Mon, 3 Aug 2026 13:11:55 -0700 Subject: [PATCH] docs(calendar): document meeting minute creation --- skills/lark-calendar/SKILL.md | 1 + .../references/lark-calendar-meeting.md | 45 ++++++++++++++++++- 2 files changed, 45 insertions(+), 1 deletion(-) diff --git a/skills/lark-calendar/SKILL.md b/skills/lark-calendar/SKILL.md index 79b982f8e0..f53f612361 100644 --- a/skills/lark-calendar/SKILL.md +++ b/skills/lark-calendar/SKILL.md @@ -129,6 +129,7 @@ lark-cli calendar +freebusy --start 2026-03-11 --end 2026-03-12 --user-id ou_xxx | 查询日历/日程或未来时间的会议 | 本 skill | | 按关键词搜索日程 | 本 skill（`+search-event`） | | 从日程获取关联的视频会议 ID 或用户绑定的会议纪要文档 | 本 skill（`+meeting`） | +| 为日程创建原生会议纪要，或排查失效的 `meeting_note` 关联 | 先读 [`+meeting`](references/lark-calendar-meeting.md) 的创建与能力边界说明 | | 从日程进一步拿 AI 智能纪要 / 逐字稿 / 妙记产物 | 先 `+meeting` 取 `meeting_id`，再 [`vc +detail`](../lark-vc/references/lark-vc-detail.md) → [`note +detail`](../lark-note/references/lark-note-detail.md) / [`minutes +detail`](../lark-minutes/references/lark-minutes-detail.md) | | 预约/改约日程、调整时间、添加/更换会议室、查会议室 | 先判断新建 vs 编辑，再进入 [schedule-meeting 工作流](references/lark-calendar-schedule-meeting.md) | | 仅编辑日程字段（标题/描述）或增删参会人（不涉及时间和会议室） | 先定位 `event_id`，再读 [+update](references/lark-calendar-update.md) 执行变更 | diff --git a/skills/lark-calendar/references/lark-calendar-meeting.md b/skills/lark-calendar/references/lark-calendar-meeting.md index 9dfac260f5..f9e1c794d2 100644 --- a/skills/lark-calendar/references/lark-calendar-meeting.md +++ b/skills/lark-calendar/references/lark-calendar-meeting.md @@ -37,4 +37,47 @@ lark-cli minutes +detail --minute-tokens --summary --todo --chapt # 3. 任意文档 token（meeting_note / note_doc_token / verbatim_doc_token / shared_doc_token）→ 正文 lark-cli docs +fetch --api-version v2 --doc --doc-format markdown -``` \ No newline at end of file +``` + +## 排查失效的会议纪要关联 + +`+meeting` 返回 `meeting_note` 后，可用 `docs +fetch` 检查文档是否仍可访问： + +```bash +lark-cli docs +fetch --api-version v2 --doc --doc-format markdown +``` + +若返回文档已删除的错误，说明日程仍保留着指向已删除文档的旧关联；不要把该 Token 当成可用纪要继续处理。 + +## 创建原生会议纪要 + +当前 CLI 没有对应的 typed Calendar 命令。确认用户确实要创建新纪要后，可使用官方 Calendar OpenAPI 的 raw API： + +```bash +# 先获取当前身份的主日历 ID +lark-cli calendar calendars primary --as user --format json + +# 为指定日程创建一个新的原生会议纪要文档 +lark-cli api POST \ + /open-apis/calendar/v4/calendars//events//meeting_minute \ + --as user \ + --format json +``` + +成功响应的 `data.doc_url` 是新建会议纪要的文档 URL。调用前需满足： + +- 目标日历是当前身份的主日历，且当前身份有 writer 权限； +- 日程至少有 1 个参与人； +- 日程的参与人权限不是 `none`； +- 应用具备 `calendar:calendar` 或 `calendar:calendar.event:update` 任一权限。 + +## 能力边界：不能通过 OpenAPI 绑定任意已有文档 + +创建会议纪要接口没有请求体，只会新建原生会议纪要并返回 `doc_url`。当前官方 `calendar.events.patch` 请求字段也不包含可写的 `meeting_note`、`doc_url` 或已有文档 Token，因此不能通过 Calendar OpenAPI 把任意已有 Doc/Wiki 文档重新绑定为日程会议纪要。 + +用户要求绑定已有文档时： + +1. 先用 `calendar +meeting` 检查现有关联； +2. 若关联文档已删除，明确说明这是失效的旧关联； +3. 提供可行替代方案：创建新的原生会议纪要后复制或链接内容，或把已有文档 URL 写入日程描述； +4. 若 Lark 客户端当前版本提供手动绑定/替换入口，可让用户在客户端完成，但不要声称 CLI 或 OpenAPI 已支持该操作。