@amaster.ai/pi-lark 0.1.14 → 0.1.16
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +4 -4
- package/skills/lark-apps/SKILL.md +1 -0
- package/skills/lark-apps/references/lark-apps-db.md +2 -0
- package/skills/lark-apps/references/lark-apps-env-pull.md +1 -1
- package/skills/lark-apps/references/lark-apps-env.md +1 -1
- package/skills/lark-apps/references/lark-apps-export.md +62 -0
- package/skills/lark-apps/references/lark-apps-local-dev.md +1 -1
- package/skills/lark-apps/references/lark-apps-observability.md +1 -1
- package/skills/lark-base/SKILL.md +6 -5
- package/skills/lark-base/references/lark-base-app.md +3 -3
- package/skills/lark-base/references/lark-base-dashboard-block-config.md +21 -3
- package/skills/lark-base/references/lark-base-dashboard.md +1 -1
- package/skills/lark-base/references/lark-base-data-query.md +1 -1
- package/skills/lark-base/references/lark-base-field-create.md +1 -1
- package/skills/lark-base/references/lark-base-field-update.md +1 -1
- package/skills/lark-base/references/lark-base-form-questions-create.md +1 -1
- package/skills/lark-base/references/lark-base-form-questions-update.md +1 -1
- package/skills/lark-base/references/lark-base-form-submit.md +1 -1
- package/skills/lark-base/references/lark-base-view-set-filter.md +1 -1
- package/skills/lark-base/references/lark-base-view.md +109 -0
- package/skills/lark-base/references/lark-base-workflow-schema.md +90 -12
- package/skills/lark-base/references/lark-base-workflow.md +99 -3
- package/skills/lark-calendar/SKILL.md +13 -8
- package/skills/lark-calendar/references/lark-calendar-meeting-relation.md +99 -0
- package/skills/lark-calendar/references/lark-calendar-meeting.md +1 -1
- package/skills/lark-calendar/references/lark-calendar-recurring.md +3 -1
- package/skills/lark-calendar/references/lark-calendar-transfer.md +1 -1
- package/skills/lark-doc/SKILL.md +1 -1
- package/skills/lark-doc/references/lark-doc-create-workflow.md +8 -10
- package/skills/lark-doc/references/lark-doc-media-download.md +1 -1
- package/skills/lark-doc/references/lark-doc-media-insert.md +1 -1
- package/skills/lark-doc/references/lark-doc-media-preview.md +1 -1
- package/skills/lark-doc/references/lark-doc-resource-cover.md +1 -1
- package/skills/lark-doc/references/lark-doc-script.md +11 -17
- package/skills/lark-drive/references/lark-drive-add-comment.md +1 -1
- package/skills/lark-drive/references/lark-drive-apply-permission.md +1 -1
- package/skills/lark-drive/references/lark-drive-copy.md +1 -1
- package/skills/lark-drive/references/lark-drive-cover.md +1 -1
- package/skills/lark-drive/references/lark-drive-create-folder.md +1 -1
- package/skills/lark-drive/references/lark-drive-create-shortcut.md +1 -1
- package/skills/lark-drive/references/lark-drive-delete.md +1 -1
- package/skills/lark-drive/references/lark-drive-download.md +1 -1
- package/skills/lark-drive/references/lark-drive-export-download.md +1 -1
- package/skills/lark-drive/references/lark-drive-export.md +1 -1
- package/skills/lark-drive/references/lark-drive-import.md +1 -1
- package/skills/lark-drive/references/lark-drive-inspect.md +2 -2
- package/skills/lark-drive/references/lark-drive-list-comments.md +1 -1
- package/skills/lark-drive/references/lark-drive-move.md +4 -4
- package/skills/lark-drive/references/lark-drive-permission-guide.md +1 -1
- package/skills/lark-drive/references/lark-drive-preview.md +1 -1
- package/skills/lark-drive/references/lark-drive-pull.md +1 -1
- package/skills/lark-drive/references/lark-drive-push.md +1 -1
- package/skills/lark-drive/references/lark-drive-search.md +1 -1
- package/skills/lark-drive/references/lark-drive-status.md +1 -1
- package/skills/lark-drive/references/lark-drive-task-result.md +4 -4
- package/skills/lark-drive/references/lark-drive-update-title.md +1 -1
- package/skills/lark-drive/references/lark-drive-upload.md +1 -1
- package/skills/lark-drive/references/lark-drive-version-delete.md +1 -1
- package/skills/lark-drive/references/lark-drive-version-get.md +1 -1
- package/skills/lark-drive/references/lark-drive-version-history.md +1 -1
- package/skills/lark-drive/references/lark-drive-version-revert.md +1 -1
- package/skills/lark-drive/references/lark-drive-workflow-topic-move-collector-execute.md +1 -1
- package/skills/lark-im/SKILL.md +7 -1
- package/skills/lark-im/references/lark-im-chat-create.md +1 -1
- package/skills/lark-im/references/lark-im-chat-list.md +1 -1
- package/skills/lark-im/references/lark-im-chat-members-list.md +1 -1
- package/skills/lark-im/references/lark-im-chat-messages-list.md +7 -2
- package/skills/lark-im/references/lark-im-chat-search.md +1 -1
- package/skills/lark-im/references/lark-im-chat-update.md +1 -1
- package/skills/lark-im/references/lark-im-feed-groups.md +1 -1
- package/skills/lark-im/references/lark-im-feed-shortcut-create.md +1 -1
- package/skills/lark-im/references/lark-im-feed-shortcut-list.md +1 -1
- package/skills/lark-im/references/lark-im-feed-shortcut-remove.md +1 -1
- package/skills/lark-im/references/lark-im-flag-cancel.md +1 -1
- package/skills/lark-im/references/lark-im-flag-create.md +1 -1
- package/skills/lark-im/references/lark-im-flag-list.md +1 -1
- package/skills/lark-im/references/lark-im-message-enrichment.md +1 -1
- package/skills/lark-im/references/lark-im-message-read-status.md +1 -1
- package/skills/lark-im/references/lark-im-messages-edit.md +1 -1
- package/skills/lark-im/references/lark-im-messages-mget.md +20 -3
- package/skills/lark-im/references/lark-im-messages-reply.md +1 -1
- package/skills/lark-im/references/lark-im-messages-resources-download.md +3 -1
- package/skills/lark-im/references/lark-im-messages-search.md +2 -2
- package/skills/lark-im/references/lark-im-messages-send.md +1 -1
- package/skills/lark-im/references/lark-im-reactions.md +1 -1
- package/skills/lark-im/references/lark-im-threads-messages-list.md +6 -2
- package/skills/lark-mail/SKILL.md +19 -8
- package/skills/lark-mail/references/lark-mail-draft-create.md +1 -1
- package/skills/lark-mail/references/lark-mail-draft-edit.md +1 -1
- package/skills/lark-mail/references/lark-mail-forward.md +1 -1
- package/skills/lark-mail/references/lark-mail-reply-all.md +1 -1
- package/skills/lark-mail/references/lark-mail-reply.md +1 -1
- package/skills/lark-mail/references/lark-mail-rules.md +87 -4
- package/skills/lark-mail/references/lark-mail-send.md +1 -1
- package/skills/lark-mail/references/lark-mail-thread-modify.md +73 -0
- package/skills/lark-mail/references/lark-mail-thread-trash.md +62 -0
- package/skills/lark-mail/references/lark-mail-triage.md +1 -1
- package/skills/lark-mail/references/lark-mail-watch.md +2 -2
- package/skills/lark-markdown/references/lark-markdown-create.md +1 -1
- package/skills/lark-markdown/references/lark-markdown-diff.md +1 -1
- package/skills/lark-markdown/references/lark-markdown-fetch.md +1 -1
- package/skills/lark-markdown/references/lark-markdown-overwrite.md +1 -1
- package/skills/lark-markdown/references/lark-markdown-patch.md +1 -1
- package/skills/lark-meeting/SKILL.md +2 -2
- package/skills/lark-meeting/references/lark-minutes-search.md +2 -2
- package/skills/lark-meeting/references/lark-vc-meeting-events.md +15 -15
- package/skills/lark-meeting/references/lark-vc-search.md +10 -7
- package/skills/lark-meeting/scenes/create-and-edit-minutes.md +4 -0
- package/skills/lark-meeting/scenes/live-meeting-attend.md +2 -2
- package/skills/lark-meeting/scenes/live-meeting-interact.md +1 -1
- package/skills/lark-meeting/scenes/query-meeting-and-artifacts.md +3 -3
- package/skills/lark-shared/references/lark-wiki-token-routing.md +7 -7
- package/skills/lark-sheets/SKILL.md +60 -173
- package/skills/lark-sheets/references/lark-sheets-batch-update.md +10 -10
- package/skills/lark-sheets/references/lark-sheets-chart.md +68 -34
- package/skills/lark-sheets/references/lark-sheets-conditional-format.md +4 -4
- package/skills/lark-sheets/references/lark-sheets-filter-view.md +1 -1
- package/skills/lark-sheets/references/lark-sheets-filter.md +2 -2
- package/skills/lark-sheets/references/lark-sheets-float-image.md +2 -2
- package/skills/lark-sheets/references/lark-sheets-formula-translation.md +90 -4
- package/skills/lark-sheets/references/lark-sheets-formula-verify.md +49 -13
- package/skills/lark-sheets/references/lark-sheets-pivot-table.md +13 -13
- package/skills/lark-sheets/references/lark-sheets-range-operations.md +12 -9
- package/skills/lark-sheets/references/lark-sheets-read-data.md +14 -12
- package/skills/lark-sheets/references/lark-sheets-search-replace.md +3 -3
- package/skills/lark-sheets/references/lark-sheets-sheet-structure.md +8 -4
- package/skills/lark-sheets/references/lark-sheets-sparkline.md +2 -2
- package/skills/lark-sheets/references/lark-sheets-styles-put.md +2 -2
- package/skills/lark-sheets/references/lark-sheets-visual-standards.md +22 -19
- package/skills/lark-sheets/references/lark-sheets-workbook.md +22 -7
- package/skills/lark-sheets/references/lark-sheets-write-cells.md +66 -57
- package/skills/lark-sheets/scripts/lark_chart_quality_check.py +1540 -0
- package/skills/lark-sheets/scripts/lark_chart_size_advisor.py +409 -0
- package/skills/lark-sheets/scripts/lark_chart_size_rules.py +292 -0
- package/skills/lark-sheets/scripts/lark_inspect_workbook.py +37 -9
- package/skills/lark-sheets/scripts/lark_sheet_read_cli.py +53 -0
- package/skills/lark-sheets/scripts/{sheets_df.py → lark_sheets_df.py} +1 -1
- package/skills/lark-slides/SKILL.md +11 -18
- package/skills/lark-slides/references/cli/lark-slides-add-slide.md +1 -1
- package/skills/lark-slides/references/cli/lark-slides-create.md +3 -3
- package/skills/lark-slides/references/cli/lark-slides-delete-slide.md +1 -1
- package/skills/lark-slides/references/cli/lark-slides-history.md +1 -8
- package/skills/lark-slides/references/cli/lark-slides-media-upload.md +6 -11
- package/skills/lark-slides/references/cli/lark-slides-replace-slide.md +15 -16
- package/skills/lark-slides/references/cli/lark-slides-update-slide.md +2 -2
- package/skills/lark-slides/references/cli/lark-slides-xml-presentation-slide-get.md +3 -108
- package/skills/lark-slides/references/cli/lark-slides-xml-presentation-slide-replace.md +6 -183
- package/skills/lark-slides/references/cli/lark-slides-xml-presentations-get.md +26 -143
- package/skills/lark-slides/references/lark-slides-xml-presentation-slide-get.md +3 -3
- package/skills/lark-slides/references/lark-slides-xml-presentation-slide-replace.md +2 -2
- package/skills/lark-slides/references/lark-slides-xml-presentations-get.md +2 -2
- package/skills/lark-slides/references/workflow/error-handling.md +3 -3
- package/skills/lark-slides/references/workflow/slides-editing.md +10 -11
- package/skills/lark-slides/references/xml/slides_xml_schema_definition.xml +333 -20
- package/skills/lark-task/references/lark-task-assign.md +1 -1
- package/skills/lark-task/references/lark-task-comment.md +1 -1
- package/skills/lark-task/references/lark-task-complete.md +1 -1
- package/skills/lark-task/references/lark-task-create.md +1 -1
- package/skills/lark-task/references/lark-task-followers.md +1 -1
- package/skills/lark-task/references/lark-task-get-my-tasks.md +1 -1
- package/skills/lark-task/references/lark-task-get-related-tasks.md +1 -1
- package/skills/lark-task/references/lark-task-reminder.md +1 -1
- package/skills/lark-task/references/lark-task-reopen.md +1 -1
- package/skills/lark-task/references/lark-task-search.md +1 -1
- package/skills/lark-task/references/lark-task-set-ancestor.md +1 -1
- package/skills/lark-task/references/lark-task-tasklist-create.md +1 -1
- package/skills/lark-task/references/lark-task-tasklist-members.md +1 -1
- package/skills/lark-task/references/lark-task-tasklist-search.md +1 -1
- package/skills/lark-task/references/lark-task-tasklist-task-add.md +1 -1
- package/skills/lark-task/references/lark-task-update.md +1 -1
- package/skills/lark-task/references/lark-task-upload-attachment.md +1 -1
- package/skills/lark-wiki/SKILL.md +1 -2
- package/skills/lark-wiki/references/lark-wiki-delete-space.md +1 -1
- package/skills/lark-wiki/references/lark-wiki-move-to-drive.md +1 -1
- package/skills/lark-wiki/references/lark-wiki-move.md +4 -3
- package/skills/lark-wiki/references/lark-wiki-node-create.md +4 -3
- package/skills/lark-wiki/references/lark-wiki-node-delete.md +8 -4
- package/skills/lark-wiki/references/lark-wiki-node-get.md +7 -4
- package/skills/lark-sheets/references/lark-sheets-legacy-command-migration.md +0 -152
- package/skills/lark-sheets/scripts/lark_chart_layout_check.py +0 -472
|
@@ -50,7 +50,7 @@ Calendar 日程 ──meeting_note────────────► Doc(
|
|
|
50
50
|
│
|
|
51
51
|
└── 录制 ──► Minutes 妙记 (minute_token)
|
|
52
52
|
├── AI 产物:Summary / Todo / Chapter / Keyword
|
|
53
|
-
├── Transcript
|
|
53
|
+
├── Transcript(文字记录,别名:「转写」「逐字稿」「文字记录」)
|
|
54
54
|
└── 原始音视频
|
|
55
55
|
|
|
56
56
|
本地音视频 ─────────────────────────────► Minutes 妙记 (minute_token)
|
|
@@ -61,7 +61,7 @@ Calendar 日程 ──meeting_note────────────► Doc(
|
|
|
61
61
|
| Calendar 日程 | `event_id` | 日历上的日程,包含时间、参与人、会议室和 RSVP,可预约或关联 VC 会议;不是完整的会议记录。日程上的 `meeting_note` 是用户手工绑定的 Doc,与 AI 智能纪要无关。 |
|
|
62
62
|
| Meeting 会议 | `meeting_id` | 实际发生的视频会议,可以来自 Calendar,也可以是没有日程的即时会议。会议主题、时间、参会人快照和会中事件属于会议数据;Note 与 Minutes 是它可能关联的会后产物。 |
|
|
63
63
|
| Note 智能纪要 | `note_id` | 开启 AI 总结后形成的逻辑产物集合。`note_display_type` 决定获取逐字稿中文字记录的不同方式。 |
|
|
64
|
-
| Minutes 妙记 | `minute_token` |
|
|
64
|
+
| Minutes 妙记 | `minute_token` | 由会议录制或本地音视频上传生成,包含总结、待办、章节、关键词、文字记录(别名:「转写」「逐字稿」「文字记录」)和原始音视频;可以关联 VC 会议,也可以独立存在。 |
|
|
65
65
|
| Doc 文档 | Doc token | 内容载体,不是会议标识。`note_doc_token`、`shared_doc_tokens` 和部分 `verbatim_doc_token` 指向 Doc;Doc token 不能当作 `note_id` 或 `meeting_id`。 |
|
|
66
66
|
|
|
67
67
|
### 核心标识
|
|
@@ -67,8 +67,8 @@ lark-cli minutes +search --query "预算复盘" --format json
|
|
|
67
67
|
| 参数 | 必填 | 说明 |
|
|
68
68
|
| ------------------------- | -- | ------------------------------------ |
|
|
69
69
|
| `--query <text>` | 否 | 搜索关键词 |
|
|
70
|
-
| `--owner-ids <ids>` | 否 | 所有者 open\_id
|
|
71
|
-
| `--participant-ids <ids>` | 否 | 参与者 open\_id
|
|
70
|
+
| `--owner-ids <ids>` | 否 | 所有者 open\_id 列表,逗号分隔;多值为 OR 语义;支持传 `me` 表示当前用户 |
|
|
71
|
+
| `--participant-ids <ids>` | 否 | 参与者 open\_id 列表,逗号分隔;多值为 OR 语义;支持传 `me` 表示当前用户 |
|
|
72
72
|
| `--start <time>` | 否 | 开始时间(ISO 8601 或仅日期) |
|
|
73
73
|
| `--end <time>` | 否 | 结束时间(ISO 8601 或仅日期) |
|
|
74
74
|
| `--page-size <n>` | 否 | 每页数量,默认 `15`,最大 `30` |
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
|
|
2
2
|
# vc +meeting-events
|
|
3
3
|
|
|
4
|
-
查询一场正在进行的视频会议中的会中事件列表。该命令是**读操作**,必须沿用 `meeting_id`
|
|
4
|
+
查询一场正在进行的视频会议中的会中事件列表。该命令是**读操作**,必须沿用 `meeting_id` 的来源身份:用户身份发现的会议继续用用户身份读,应用身份发现或应用机器人入会得到的会议继续用应用身份读。会议结束后不要再用此命令拉取事件,应改为查询会议产物。
|
|
5
5
|
|
|
6
6
|
本 skill 对应 shortcut:`lark-cli vc +meeting-events`(调用 `GET /open-apis/vc/v1/bots/events`)。
|
|
7
7
|
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
|
|
10
10
|
- `meeting_id` 来自 `+meeting-list-active --as user`:后续读取事件继续 `--as user`。
|
|
11
11
|
- `meeting_id` 来自 `+meeting-list-active --as bot --user-id <user_open_id>` 或 `+meeting-join --as bot`:后续读取事件继续 `--as bot`。
|
|
12
|
-
-
|
|
12
|
+
- 应用身份下,应用机器人必须当前在该会中;应用身份 active meeting 返回的是“目标用户在会中且应用机器人也在会中”的会议,不表示可以读取任意 `meeting_id`。
|
|
13
13
|
|
|
14
14
|
## 命令
|
|
15
15
|
|
|
@@ -53,20 +53,19 @@ lark-cli vc +meeting-events --as <same_identity> --meeting-id <id> --page-token
|
|
|
53
53
|
|
|
54
54
|
- `+meeting-events` 支持 `--as user` 和 `--as bot`。
|
|
55
55
|
- 用户身份路径:用户身份发现的会议继续用用户身份读取。
|
|
56
|
-
-
|
|
56
|
+
- 应用身份路径:应用机器人必须当前在会中;不要拿任意 `meeting_id` 直接查。
|
|
57
57
|
- 不要在拿到 `meeting_id` 后随意切换身份。身份不一致时,常见结果是空列表、`no permission` 或 `bot is not in meeting`。
|
|
58
58
|
|
|
59
|
-
### 3.
|
|
59
|
+
### 3. 应用身份的可见性条件
|
|
60
60
|
|
|
61
|
-
|
|
61
|
+
若应用机器人已离会或未入会,后端通常会报:
|
|
62
62
|
- `bot is not in meeting, no permission`
|
|
63
63
|
|
|
64
|
-
|
|
64
|
+
执行准则:
|
|
65
65
|
|
|
66
|
-
-
|
|
67
|
-
-
|
|
68
|
-
-
|
|
69
|
-
- **应用机器人从未真实入会过**:即使会议仍在进行或刚结束,也会返回 `10005 bot is not in meeting`
|
|
66
|
+
- **会议进行中**:要求应用机器人**当前仍在会中**。
|
|
67
|
+
- **应用机器人从未真实入会过**:会中读取会返回 `10005 bot is not in meeting`。
|
|
68
|
+
- **会议已经结束**:会返回会议结束错误;不要尝试继续拉取事件,改用会议详情、纪要、逐字稿或录制等会后产物。
|
|
70
69
|
|
|
71
70
|
### 4. 自动分页规则
|
|
72
71
|
|
|
@@ -112,7 +111,7 @@ lark-cli vc +meeting-events --as <same_identity> --meeting-id <id> --page-token
|
|
|
112
111
|
- 如果上下文没有明确 `meeting_id`,先按用户当前意图选择身份:问“我/当前用户所在会议”用 `lark-cli vc +meeting-list-active --as user --format json`;问“应用机器人可见的目标用户会议”用 `lark-cli vc +meeting-list-active --as bot --user-id <user_open_id> --format json`。返回多个会议时先让用户选择。
|
|
113
112
|
- 如果上下文只有 9 位会议号,先按当前身份执行 `+meeting-list-active` 并按 `meeting_no` 匹配;匹配到唯一会议后再查事件。不要为了总结会议而自动调用 `+meeting-join`。
|
|
114
113
|
- 确认 `meeting_id` 后,沿用其来源身份执行 `lark-cli vc +meeting-events --as <same_identity> --meeting-id <id> --page-all --format pretty` 拉取最新事件流。
|
|
115
|
-
-
|
|
114
|
+
- 如果事件流显示共享内容(JSON 事件类型为 `magic_share_started`;pretty 时间线按 `start_reason` 显示“开始共享”或“正在共享”),并包含文档标题或 URL 等线索,必须继续读取共享文档内容后再生成总结,不能只根据共享事件和文档标题概括会议内容。
|
|
116
115
|
- 若存在多个共享文档,按用户问题读取相关文档;处理某条文档上下文事件时必须按该 item 的 `share_id` 精确关联,不能用“最近一次共享”替代。
|
|
117
116
|
- 若文档读取失败,必须明确说明“以下总结仅基于会中事件流,未成功读取共享文档内容”。
|
|
118
117
|
|
|
@@ -134,6 +133,7 @@ lark-cli vc +meeting-events --as <same_identity> --meeting-id <id> --page-token
|
|
|
134
133
|
| 路径 | 含义与处理 |
|
|
135
134
|
| --- | --- |
|
|
136
135
|
| `payload.magic_share_started_items[].share_id/share_doc` | 建立一次共享会话与文档 URL/title 的映射。缺 `share_id` 时不建立映射。 |
|
|
136
|
+
| `payload.magic_share_started_items[].start_reason` | `share_started` 或缺失表示真实开始;`share_detected` 表示开启 Agent 入会能力时发现已有共享。两者都建立共享映射。 |
|
|
137
137
|
| `payload.magic_share_ended_items[].share_id` | 结束同一 `share_id` 的共享会话;不得结束其他映射。 |
|
|
138
138
|
| `payload.document_context_changed_items[]` | 结构化消费按原序读取;pretty timeline 沿用统一时间排序。每项恰有一个已知 context 才生成 pretty 条目,未知/歧义项只保留 raw。 |
|
|
139
139
|
| `item.operator` | 当前 item 的 actor;缺 ID/name 时不猜共享发起人。 |
|
|
@@ -249,7 +249,7 @@ lark-cli drive +list-replies \
|
|
|
249
249
|
| `participant_left` | 有参会人离开会议 |
|
|
250
250
|
| `chat_received` | 收到会中聊天消息 |
|
|
251
251
|
| `transcript_received` | 收到转写文本 |
|
|
252
|
-
| `magic_share_started` |
|
|
252
|
+
| `magic_share_started` | 开始共享,或开启 Agent 入会能力时发现已有共享;由 `start_reason` 区分 |
|
|
253
253
|
| `magic_share_ended` | 结束共享 |
|
|
254
254
|
| `document_context_changed` | 评论聚焦、章节定位或元素预览上下文变化 |
|
|
255
255
|
| `countdown_changed` | 会中倒计时被设置、延长、提前结束、关闭窗口,或自然结束、临近提醒 |
|
|
@@ -306,9 +306,9 @@ lark-cli vc +meeting-events \
|
|
|
306
306
|
| 错误现象 | 根本原因 | 解决方案 |
|
|
307
307
|
|---------|---------|---------|
|
|
308
308
|
| `--meeting-id is required` | 未传入 `--meeting-id` | 传入长数字 `meeting.id` |
|
|
309
|
-
| `10005 bot is not in meeting` |
|
|
309
|
+
| `10005 bot is not in meeting` | 使用应用身份读取,但应用机器人当前不在会中 | 如果 `meeting_id` 来自用户身份发现,改回 `--as user`;如果确实要应用身份读取,先让应用机器人入会,再用 `--as bot`。**如果只是想看参会人快照,改用 `lark-cli vc meeting get --params '{"meeting_id":"<meeting.id>","with_participants":true}'`** |
|
|
310
310
|
| 用户身份无权限 / 不可见 | 当前用户不是该会议的可见参与者,或 `meeting_id` 不是从用户身份路径获得 | 不要反复执行 `auth login`。先确认 `meeting_id` 是否来自 `+meeting-list-active --as user`;如果用户明确要切到应用身份,再通过 `+meeting-list-active --as bot --user-id <user_open_id>` 获取应用身份可读的 `meeting_id`,或在用户明确同意后让应用机器人入会,再用 `+meeting-events --as bot` 读取 |
|
|
311
|
-
| `20001 meeting_status_MEETING_END` |
|
|
311
|
+
| `20001 meeting_status_MEETING_END` | 会议已经结束 | 本接口不再适合继续拉取事件。先用 `lark-cli vc +detail --meeting-ids <meeting.id>` 获取会议产物信息,再根据 `note_display_type` / `note_id` / `minute_token` 和用户意图选择纪要正文、逐字稿或妙记;参会人请用 `lark-cli vc meeting get --params '{"meeting_id":"<meeting.id>"}' --with-participants` |
|
|
312
312
|
| `20002 meeting not exist` | `meeting_id` 错误,或会议实例当前已不可获取(常见于把 9 位会议号当 meeting_id 传) | 确认传入的是长数字 `meeting_id`,不是 9 位会议号 |
|
|
313
313
|
| 应用身份权限不足 | 应用权限、租户安装或权限可访问的数据范围未配置完整 | 不要执行 `auth login`。请应用开发者开通 `vc:meeting.bot.join:write`;再检查应用发布/安装和权限可访问的数据范围;配置正确仍失败时,保留错误码和 `log_id`,按服务端权限异常排查 |
|
|
314
314
|
| `HTTP 404` / `HTTP 500` | 服务端当前无法找到或处理该会议实例 | 换一个正在进行且 bot 可见的 meeting_id,或排查后端问题 |
|
|
@@ -319,7 +319,7 @@ lark-cli vc +meeting-events \
|
|
|
319
319
|
- 如果会议已经结束,不要卡在 `+meeting-events`:
|
|
320
320
|
- 先用 `lark-cli vc +detail --meeting-ids <meeting.id>` 获取会议产物信息。
|
|
321
321
|
- 再根据 `note_display_type`、`note_id`、`minute_token` 和用户意图,按 `lark-meeting` 的产物决策读取纪要正文、逐字稿或妙记。
|
|
322
|
-
-
|
|
322
|
+
- 事件列表是否完整,取决于应用机器人何时入会、何时离会,以及后端当前可见的会中事件范围。会议结束后改用会议产物,不要继续拉取事件。
|
|
323
323
|
- 查询"谁参加过某会议"请用 `vc meeting get --params '{"meeting_id":"<id>","with_participants":true}'`——这是参会人**快照** API,不依赖 bot 是否参会,对已结束会议也可查;**不要** 用 `+meeting-events` 做参会人查询。
|
|
324
324
|
|
|
325
325
|
## 相关场景
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
|
|
2
2
|
# vc +search
|
|
3
3
|
|
|
4
|
-
|
|
4
|
+
搜索已结束的历史会议记录,支持关键词、时间范围、组织者、参与者、会议室多条件过滤。只读,支持 `--as user` / `--as bot`。
|
|
5
5
|
|
|
6
6
|
## 关键词使用边界
|
|
7
7
|
|
|
@@ -28,6 +28,7 @@ lark-cli vc +search --query "周会"
|
|
|
28
28
|
|
|
29
29
|
# 通过 9 位会议号查询会议 ID
|
|
30
30
|
lark-cli vc +search --query "123456789" --format json --as user
|
|
31
|
+
lark-cli vc +search --query "123456789" --format json --as bot
|
|
31
32
|
|
|
32
33
|
# 查询某一天开过的会(单日查询时,start 和 end 必须填写同一天)
|
|
33
34
|
lark-cli vc +search --start 2026-03-10 --end 2026-03-10
|
|
@@ -54,9 +55,9 @@ lark-cli vc +search --query "周会" --page-token "<PAGE_TOKEN>"
|
|
|
54
55
|
| `--query <text>` | 否 | 9 位会议号或搜索关键词 |
|
|
55
56
|
| `--start <time>` | 否 | 开始时间(ISO 8601 或仅日期) |
|
|
56
57
|
| `--end <time>` | 否 | 结束时间(ISO 8601 或仅日期) |
|
|
57
|
-
| `--organizer-ids <ids>` | 否 | 组织者 open_id
|
|
58
|
-
| `--participant-ids <ids>` | 否 | 参与者 open_id
|
|
59
|
-
| `--room-ids <ids>` | 否 | 会议室 ID
|
|
58
|
+
| `--organizer-ids <ids>` | 否 | 组织者 open_id 列表,逗号分隔;多值为 OR 语义 |
|
|
59
|
+
| `--participant-ids <ids>` | 否 | 参与者 open_id 列表,逗号分隔;多值为 OR 语义 |
|
|
60
|
+
| `--room-ids <ids>` | 否 | 会议室 ID 列表,逗号分隔;多值为 OR 语义 |
|
|
60
61
|
| `--page-size <n>` | 否 | 每页数量,默认 `15`,最大 `30` |
|
|
61
62
|
| `--page-token <token>` | 否 | 翻页标记,用于获取下一页 |
|
|
62
63
|
| `--dry-run` | 否 | 预览 API 调用,不执行 |
|
|
@@ -75,9 +76,11 @@ lark-cli vc +search --query "周会" --page-token "<PAGE_TOKEN>"
|
|
|
75
76
|
|
|
76
77
|
`vc +search` 只能搜索已结束的历史会议记录,不用于查询未来日程。查询未来会议安排请使用 [lark-calendar](../../lark-calendar/SKILL.md)。
|
|
77
78
|
|
|
78
|
-
### 3.
|
|
79
|
+
### 3. 支持 user 和 bot 身份
|
|
79
80
|
|
|
80
|
-
|
|
81
|
+
该接口支持 `--as user` 和 `--as bot`。user 身份需要完成 `lark-cli auth login` 并具备 `vc:meeting.search:read` 权限;bot 身份使用应用的 tenant access token,需要确认当前应用已开通 `vc:meeting.search:read` scope,且运行环境能获取有效的 TAT。
|
|
82
|
+
|
|
83
|
+
搜索得到 `meeting_id` 后,后续 `vc +detail`、`vc +recording`、`vc meeting get` 和 `note +detail` 必须显式沿用本次搜索使用的身份。不要为了绕过权限错误自动切换身份。
|
|
81
84
|
|
|
82
85
|
### 4. 支持分页
|
|
83
86
|
|
|
@@ -131,7 +134,7 @@ lark-cli vc +search --query "周会" --page-size 15 --page-token "<PAGE_TOKEN>"
|
|
|
131
134
|
| 命令直接报错,要求提供过滤条件 | 没有传入 `--query`、时间范围或任何过滤 ID | 至少补充一个过滤条件后重试 |
|
|
132
135
|
| 时间参数校验失败 | `--start` 或 `--end` 格式不合法 | 改用 ISO 8601 或 `YYYY-MM-DD` |
|
|
133
136
|
| 搜不到未来会议 | `vc +search` 只查历史会议 | 改用 [lark-calendar](../../lark-calendar/SKILL.md) 查询未来日程 |
|
|
134
|
-
| 权限不足 | 未授权 `vc:meeting.search:read` |
|
|
137
|
+
| 权限不足 | 未授权 `vc:meeting.search:read` | `--as user`:按提示完成用户授权;`--as bot`:检查 tenant access token 和应用 scope,不要执行 `auth login` |
|
|
135
138
|
|
|
136
139
|
## 提示
|
|
137
140
|
- 必须使用 `--format json` 输出,便于稳定解析。
|
|
@@ -72,6 +72,10 @@ lark-cli minutes +todo --minute-token <token> --operation add|update|delete ...
|
|
|
72
72
|
|
|
73
73
|
## 批量替换逐字稿关键词
|
|
74
74
|
|
|
75
|
+
`+word-replace` 修改的是妙记「转写/逐字稿/文字记录」中的字面词条(同一产物的不同叫法)。
|
|
76
|
+
|
|
77
|
+
`--minute-token` 必须是妙记 token(例如 `obcn...`),合法输入只有两种:`minutes +search` / `vc +recording` 等接口返回的 `token` 字段,或从妙记 URL 里提取最后一段路径并去掉 query 参数后的裸 token。禁止直接传妙记标题、URL 里的 slug、会议主题或完整妙记 URL;不确定时先跑 `minutes +search` / `vc +recording` 拿到 `minute_token` 再执行替换。
|
|
78
|
+
|
|
75
79
|
```bash
|
|
76
80
|
lark-cli minutes +word-replace --minute-token <token> --replace-words '[{"source_word":"<old>","target_word":"<new>"}]' --as user
|
|
77
81
|
```
|
|
@@ -77,10 +77,10 @@ lark-cli vc +meeting-events --as bot --meeting-id <meeting_id> --page-all --form
|
|
|
77
77
|
|
|
78
78
|
- 默认使用 `--page-all` 拉取当前完整事件流,并保留返回的 `page_token` 供后续增量查询。
|
|
79
79
|
- 回答“现在、刚刚、最新”或总结当前会议前,重新拉取最新事件;不直接复用旧快照。
|
|
80
|
-
-
|
|
80
|
+
- 应用机器人必须当前在会中;不要用任意 `meeting_id` 尝试读取。
|
|
81
81
|
- 会中事件不能替代已结束会议的参会人快照、纪要、逐字稿或录制。
|
|
82
82
|
|
|
83
|
-
|
|
83
|
+
事件类型、分页、会后产物替代路径和文档上下文处理见 [`lark-vc-meeting-events`](../references/lark-vc-meeting-events.md)。
|
|
84
84
|
|
|
85
85
|
## 发送会中文本或表情
|
|
86
86
|
|
|
@@ -35,7 +35,7 @@ lark-cli vc +meeting-events --as <same_identity> --meeting-id <meeting_id> --pag
|
|
|
35
35
|
- 默认用 pretty 理解时间线;需要精确结构化字段、文档上下文或转发到 IM 时使用 JSON。
|
|
36
36
|
- 不要用会中事件代替已结束会议的参会人快照或会后复盘。
|
|
37
37
|
|
|
38
|
-
|
|
38
|
+
事件类型、分页、会后产物替代路径和错误码见 [`lark-vc-meeting-events`](../references/lark-vc-meeting-events.md)。
|
|
39
39
|
|
|
40
40
|
## 读取共享内容和文档上下文
|
|
41
41
|
|
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
| 已有信息 | 操作 |
|
|
16
16
|
|---|---|
|
|
17
17
|
| `meeting_id` | 直接查询会议或关联产物 |
|
|
18
|
-
| `meeting_no` / 9 位会议号 | 用 `vc +search --query "<meeting_no>" --format json --as
|
|
18
|
+
| `meeting_no` / 9 位会议号 | 用 `vc +search --query "<meeting_no>" --format json --as <source_identity>` 搜索会议,从结果的 `id` 取得 `meeting_id` |
|
|
19
19
|
| Calendar `event_id` | 用 `calendar +meeting` 获取 `meeting_id` 和用户绑定的 `meeting_note` |
|
|
20
20
|
| `note_id` | 直接进入 [智能纪要场景](query-note-and-artifacts.md) |
|
|
21
21
|
| `minute_token` / 妙记 URL | 直接进入 [妙记场景](query-minutes-and-artifacts.md);URL 取路径最后一段并去掉 query 参数 |
|
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
没有标识时,用 `vc +search` 搜索已经结束的会议:
|
|
24
24
|
|
|
25
25
|
```bash
|
|
26
|
-
lark-cli vc +search --query <query> --start <start> --end <end> --format json
|
|
26
|
+
lark-cli vc +search --query <query> --start <start> --end <end> --format json --as <source_identity>
|
|
27
27
|
```
|
|
28
28
|
|
|
29
29
|
- 至少提供关键词、时间范围、组织者、参与者或会议室中的一个条件;不要把“总结”“回顾”“所有会议”等动作词当作 `--query`。
|
|
@@ -38,7 +38,7 @@ lark-cli vc +search --query <query> --start <start> --end <end> --format json
|
|
|
38
38
|
|
|
39
39
|
## 选择查询身份
|
|
40
40
|
|
|
41
|
-
- `vc +search
|
|
41
|
+
- `vc +search`、`vc +detail`、`vc +recording`、`vc meeting get` 和 `note +detail` 均支持用户或应用身份。没有既有身份上下文时默认使用用户身份;用户明确要求应用视角或当前链路已经使用应用身份时,使用 `--as bot`。
|
|
42
42
|
- 已有 `meeting_id`、`note_id` 或 `minute_token` 时,沿用其来源身份;后续 Minutes、Note、Doc 和 Drive 命令都显式传入同一个 `--as`。不要为查询参会人或绕过权限错误擅自切换身份。
|
|
43
43
|
- `note +transcript` 仅支持用户身份。应用身份查到 unified Note 时,先说明限制,只有用户明确同意后才切换身份。
|
|
44
44
|
|
|
@@ -12,22 +12,22 @@ lark-cli drive +inspect --url 'https://xxx.feishu.cn/wiki/<wiki_token>'
|
|
|
12
12
|
|
|
13
13
|
输出中的 `type` 是底层对象类型,`token` 是后续命令应使用的 canonical token。`wiki_node` 字段保留节点侧信息,如 `space_id`、`node_token`、`obj_token`、`obj_type`。
|
|
14
14
|
|
|
15
|
-
##
|
|
15
|
+
## 节点详情方式
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
如果后续操作需要 Wiki 节点侧的字段,使用 `wiki +node-get`:
|
|
18
18
|
|
|
19
19
|
```bash
|
|
20
|
-
lark-cli wiki
|
|
20
|
+
lark-cli wiki +node-get --node-token 'https://xxx.feishu.cn/wiki/<wiki_token>' --format json
|
|
21
21
|
```
|
|
22
22
|
|
|
23
23
|
从返回值中读取:
|
|
24
24
|
|
|
25
25
|
| 字段 | 含义 |
|
|
26
26
|
|------|------|
|
|
27
|
-
| `
|
|
28
|
-
| `
|
|
29
|
-
| `
|
|
30
|
-
| `
|
|
27
|
+
| `data.obj_type` | 底层对象类型,如 `docx`、`doc`、`sheet`、`bitable`、`slides`、`file`、`mindnote` |
|
|
28
|
+
| `data.obj_token` | 底层对象 token,用于对应业务 skill 或原生 API |
|
|
29
|
+
| `data.node_token` | Wiki 节点 token,用于 Wiki 节点层级操作 |
|
|
30
|
+
| `data.space_id` | 所属知识空间 |
|
|
31
31
|
|
|
32
32
|
## 路由
|
|
33
33
|
|