Skip to content

feat: recommend keywords for minutes #944

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
zhangjun-bytedance wants to merge 1 commit into
base: main
Choose a base branch
from
Open

feat: recommend keywords for minutes #944

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 6 additions & 3 deletions skills/lark-minutes/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,8 +34,9 @@ metadata:
2. 如果用户给的是妙记 URL，应先从 URL 末尾提取 `minute_token`，再调用 `minutes minutes get`。
3. 如果是会议 / 日程上下文中的妙记基础信息，先通过 VC 链路拿到 `minute_token`，再调用 `minutes minutes get`。
4. 用户意图不明确时，默认先给基础元信息，帮助确认是否命中目标妙记。
5. 当用户问“这个妙记讲了什么 / 主题 / 话题 / 关键词 / 标签”时，先用 `minutes minutes get` 看返回的 `keywords`（推荐关键词），它由服务端基于妙记内容生成；若 `keywords` 为空再走 `vc +notes --minute-tokens` 拉取总结 / 章节。

> 使用 `lark-cli schema minutes.minutes.get` 可查看完整返回值结构。核心字段包含：`title`（标题）、`cover`（封面 URL）、`duration`（时长，毫秒）、`owner_id`（所有者 ID）、`url`（妙记链接）。
> 使用 `lark-cli schema minutes.minutes.get` 可查看完整返回值结构。核心字段包含：`title`（标题）、`cover`（封面 URL）、`duration`（时长，毫秒）、`owner_id`（所有者 ID）、`url`（妙记链接）、`note_id`（关联纪要 ID）、`keywords`（推荐关键词，弱依赖，可能为空；服务端失败时不会让主响应失败）。

### 3. 下载妙记音视频文件

Expand Down Expand Up @@ -78,8 +79,9 @@ lark-cli vc +notes --minute-tokens <minute_token>

```text
Minutes (妙记) ← minute_token 标识
├── Metadata (标题、封面、时长、owner、url) → minutes minutes get
└── MediaFile (音频/视频文件) → minutes +download
├── Metadata (标题、封面、时长、owner、url、note_id) → minutes minutes get
├── Keywords (推荐关键词，弱依赖) → minutes minutes get （顶层 keywords 字段）
└── MediaFile (音频/视频文件) → minutes +download
```

> **能力边界**：`minutes` 负责 **搜索妙记、查看基础元信息、下载音视频文件、上传音视频生成妙记**。
Expand All @@ -94,6 +96,7 @@ Minutes (妙记) ← minute_token 标识
> - 结果有多页时，使用 `page_token` 持续翻页，直到确认没有更多结果
> - `minutes +search` 单次最多返回 `200` 条；结果总数没有固定上限
> - 用户说"这个妙记的标题 / 时长 / 封面 / 链接" → `minutes minutes get`
> - 用户说"这个妙记的主题 / 关键词 / 标签 / 讲了什么" → 先 `minutes minutes get` 取 `keywords`，为空再走 [vc +notes --minute-tokens](../lark-vc/references/lark-vc-notes.md)
> - 用户说"下载这个妙记的视频 / 音频 / 媒体文件" → `minutes +download`
> - 用户说"这个妙记的逐字稿 / 文字稿 / 撰写文字 / 总结 / 待办 / 章节" → 使用 [vc +notes --minute-tokens](../lark-vc/references/lark-vc-notes.md)
> - 用户说"通过文件生成妙记 / 把音视频转妙记" → 先上传获取 `file_token`，然后使用 `minutes +upload`
Expand Down
Loading