diff --git a/skills/lark-vc/references/lark-vc-search.md b/skills/lark-vc/references/lark-vc-search.md index effabb10a..d184582d7 100644 --- a/skills/lark-vc/references/lark-vc-search.md +++ b/skills/lark-vc/references/lark-vc-search.md @@ -7,6 +7,12 @@ 本 skill 对应 shortcut:`lark-cli vc +search`(调用 `POST /open-apis/vc/v1/meetings/search`)。 +## 关键词使用边界 + +`--query` 只用于真实会议关键词,例如会议主题、项目名、评审名、客户名。用户只是说"我这月参加的所有视频会议"、"最近两周我组织的所有视频会议"、"总结主要议题 / 看看参会情况"时,本质是历史会议列表和后续总结,不要把"回顾"、"所有视频会议"、"总结主要议题"等动作词放进 `--query`。这类请求应先用时间范围 + `--participant-ids` / `--organizer-ids` 搜全量候选,再按结果继续取纪要或录制信息。 + +列表阶段只负责找会议记录;总结阶段必须继续取证。若用户要求"主要议题"、"主要决策"、"参会情况",先确认搜索结果的 `meeting_id`、时间、组织者/参与者符合过滤条件,然后用 `vc +notes` 或 `vc +recording` / `minutes` 读取纪要、妙记或录制信息。没有纪要或妙记时,如实说明只能基于会议标题/参会数据汇总,不要编造议题。 + ## 典型触发表达 以下说法通常应优先使用 `vc +search`: @@ -42,6 +48,12 @@ lark-cli vc +search --organizer-ids "ou_a,ou_b" # 按参与者过滤(open_id,逗号分隔) lark-cli vc +search --participant-ids "ou_x,ou_y" +# 查询我这个月参加过的历史会议,不带关键词 +lark-cli vc +search --start "" --end "" --participant-ids "ou_me" + +# 查询最近两周我组织的历史会议,不带关键词 +lark-cli vc +search --start "" --end "" --organizer-ids "ou_me" + # 按会议室过滤 lark-cli vc +search --room-ids "123,456" @@ -76,6 +88,10 @@ lark-cli vc +search --query "周会" --format json 所有参数均可选,但必须至少提供一个过滤条件:`--query`、`--start`、`--end`、`--organizer-ids`、`--participant-ids` 或 `--room-ids`。 +没有真实关键词时,时间范围或人员过滤已经满足这个约束,`--query` 可以省略。 + +涉及"本月"、"最近两周"这类相对时间时,先基于执行当天计算 `""` 占位符,再运行命令;不要沿用文档示例生成时的具体日期。 + ### 2. 仅搜索历史会议 `vc +search` 只能搜索已结束的历史会议记录,不用于查询未来日程。查询未来会议安排请使用 [lark-calendar](../../lark-calendar/SKILL.md)。 @@ -129,6 +145,7 @@ lark-cli vc +search --query "周会" --format json - 继续翻页时,使用响应中的 `page_token` 搭配 `--page-token` 发起下一次查询。 - 不要假设调大 `--page-size` 就能拿全结果;分页遍历时应以 `has_more` 和 `page_token` 为准。 - `total` 数量小于 50 时,自动分页获取所有结果;`total` 数量大于 50 时,向用户确认是否获取全部结果。 +- 用户说"所有 / 全部 / 统计 / 按时间排序"时,先完成分页和去重,再排序或统计;不要只用第一页回答。 ```bash # First page