feishu-cli-vc

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

飞书视频会议与妙记

Feishu Video Conferencing and Minutes

搜索历史会议记录、获取会议纪要和逐字稿、查看妙记基础信息。

feishu-cli：如尚未安装，请前往 riba2534/feishu-cli 获取安装方式。

Search for historical meeting records, obtain meeting minutes and verbatim transcripts, and view basic Minutes information.

feishu-cli: If you have not installed it yet, please go to riba2534/feishu-cli to get the installation method.

前置条件

Prerequisites

认证：需要有效的 App Access Token（环境变量
```
FEISHU_APP_ID
```
+
```
FEISHU_APP_SECRET
```
，或
```
~/.feishu-cli/config.yaml
```
）
权限：应用需开通
```
vc:room:readonly
```
（会议室只读）、
```
vc:meeting:readonly
```
（会议记录只读）、
```
minutes:minutes:readonly
```
（妙记只读）
验证：
```
feishu-cli auth status
```
确认认证状态正常

Authentication: Valid App Access Token is required (environment variables
```
FEISHU_APP_ID
```
+
```
FEISHU_APP_SECRET
```
, or
```
~/.feishu-cli/config.yaml
```
)
Permissions: The application needs to enable
```
vc:room:readonly
```
(meeting room read-only),
```
vc:meeting:readonly
```
(meeting record read-only),
```
minutes:minutes:readonly
```
(Minutes read-only)
Verification: Run
```
feishu-cli auth status
```
to confirm the authentication status is normal

命令速查

Command Quick Reference

搜索历史会议

Search Historical Meetings

搜索飞书视频会议的历史记录，支持按时间范围、会议号、会议状态过滤。

bash

feishu-cli vc search [选项]

参数	类型	说明
`--start`	string	起始时间（Unix 秒级时间戳）
`--end`	string	结束时间（Unix 秒级时间戳）
`--meeting-no`	string	会议号精确匹配
`--meeting-status`	int	会议状态（1=进行中，2=已结束）
`--page-size`	int	每页数量（默认 20）
`--page-token`	string	分页 token（上一页返回）
`-o json`	string	JSON 格式输出

Search the historical records of Feishu video conferences, support filtering by time range, meeting number, and meeting status.

bash

feishu-cli vc search [options]

Parameter	Type	Description
`--start`	string	Start time (Unix timestamp in seconds)
`--end`	string	End time (Unix timestamp in seconds)
`--meeting-no`	string	Exact match of meeting number
`--meeting-status`	int	Meeting status (1=in progress, 2=ended)
`--page-size`	int	Number of items per page (default 20)
`--page-token`	string	Pagination token (returned from previous page)
`-o json`	string	Output in JSON format

获取会议纪要

Get Meeting Minutes

获取指定会议的纪要内容（包含结构化摘要和逐字稿）。

--meeting-id

和

--minute-token

二选一，互斥。

bash

feishu-cli vc notes [选项]

参数	类型	说明
`--meeting-id`	string	通过会议 ID 获取纪要（与 `--minute-token` 互斥）
`--minute-token`	string	通过妙记 token 获取纪要（与 `--meeting-id` 互斥）
`-o json`	string	JSON 格式输出

Obtain the minutes content of the specified meeting (including structured summary and verbatim transcript). Choose either

--meeting-id

--minute-token

, they are mutually exclusive.

bash

feishu-cli vc notes [options]

Parameter	Type	Description
`--meeting-id`	string	Obtain minutes by meeting ID (mutually exclusive with `--minute-token` )
`--minute-token`	string	Obtain minutes by Minutes token (mutually exclusive with `--meeting-id` )
`-o json`	string	Output in JSON format

获取妙记基础信息

Get Basic Minutes Information

获取妙记的元数据（标题、创建时间、时长、参与者等）。

bash

feishu-cli minutes get <minute_token> [选项]

参数	类型	说明
`<minute_token>`	string	妙记 token（必填，位置参数）
`-o json`	string	JSON 格式输出

Obtain the metadata of Minutes (title, creation time, duration, participants, etc.).

bash

feishu-cli minutes get <minute_token> [options]

Parameter	Type	Description
`<minute_token>`	string	Minutes token (required, positional parameter)
`-o json`	string	Output in JSON format

使用示例

Usage Examples

bash

undefined

bash

undefined

搜索最近一周的会议（假设当前时间戳为 1711584000）

Search for meetings in the last week (assuming current timestamp is 1711584000)

feishu-cli vc search --start 1710979200 --end 1711584000

搜索已结束的会议

Search for ended meetings

feishu-cli vc search --meeting-status 2

按会议号精确查找

Exact search by meeting number

feishu-cli vc search --meeting-no "123456789"

分页获取更多会议记录

Get more meeting records with pagination

feishu-cli vc search --page-size 50

通过会议 ID 获取会议纪要

Get meeting minutes by meeting ID

feishu-cli vc notes --meeting-id "6911xxxxx"

通过妙记 token 获取纪要

Get minutes by Minutes token

feishu-cli vc notes --minute-token "obcnxxxxx"

获取妙记基础信息

Get basic Minutes information

feishu-cli minutes get obcnxxxxx

JSON 格式输出（便于程序解析）

Output in JSON format (easy for program parsing)

feishu-cli vc search --meeting-status 2 -o json feishu-cli minutes get obcnxxxxx -o json

undefined

feishu-cli vc search --meeting-status 2 -o json feishu-cli minutes get obcnxxxxx -o json

undefined

典型工作流

Typical Workflow

查找某次会议并获取纪要

Find a meeting and get its minutes

bash

undefined

bash

undefined

1. 搜索时间范围内的会议

1. Search for meetings within the time range

feishu-cli vc search --start 1710979200 --end 1711584000 -o json

→ 找到目标会议的 meeting_id

→ Get the meeting_id of the target meeting

2. 获取会议纪要

2. Get meeting minutes

feishu-cli vc notes --meeting-id "<meeting_id>"

→ 输出会议摘要和逐字稿

→ Output meeting summary and verbatim transcript

3. 如果有妙记 token，也可以查看妙记详情

3. If you have Minutes token, you can also view Minutes details

feishu-cli minutes get <minute_token>

undefined

feishu-cli minutes get <minute_token>

undefined

权限要求

Permission Requirements

功能	所需权限
搜索会议记录	`vc:meeting:readonly`
会议室信息	`vc:room:readonly`
获取妙记信息	`minutes:minutes:readonly`

Function	Required Permission
Search meeting records	`vc:meeting:readonly`
Meeting room information	`vc:room:readonly`
Get Minutes information	`minutes:minutes:readonly`

注意事项

Notes

时间参数：
```
--start
```
和
```
--end
```
使用 Unix 秒级时间戳（非毫秒），可通过
```
date +%s
```
获取当前时间戳
meeting-id vs minute-token：
```
vc notes
```
的两个参数互斥，不能同时使用；meeting-id 来自
```
vc search
```
的结果，minute-token 来自妙记 URL 或
```
minutes get
```
返回
妙记 token 来源：飞书妙记 URL 格式为
```
https://xxx.feishu.cn/minutes/<minute_token>
```
，从 URL 中提取即可
数据时效：会议记录和妙记需要会议结束后一段时间才能查询到，实时会议无法获取纪要
权限申请：
```
vc:meeting:readonly
```
和
```
minutes:minutes:readonly
```
需要在飞书开放平台单独申请开通

Time parameters:
```
--start
```
and
```
--end
```
use Unix timestamp in seconds (not milliseconds), you can get the current timestamp via
```
date +%s
```
meeting-id vs minute-token: The two parameters of
```
vc notes
```
are mutually exclusive and cannot be used at the same time; meeting-id comes from the result of
```
vc search
```
, minute-token comes from Minutes URL or the return of
```
minutes get
```
Minutes token source: Feishu Minutes URL format is
```
https://xxx.feishu.cn/minutes/<minute_token>
```
, you can extract it from the URL
Data timeliness: Meeting records and Minutes can only be queried after the meeting ends for a period of time, and minutes cannot be obtained for real-time meetings
Permission application:
```
vc:meeting:readonly
```
and
```
minutes:minutes:readonly
```
need to be applied separately on Feishu Open Platform