ooodc
a7883dbed9
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段 - 强制每个任务都必须有唯一 id，且由用户负责生成 - 修改合并模式逻辑，merge=true 下保留未提及的旧任务 - 支持已完成和已取消任务重新激活（状态改回 pending 或 in_progress） - 禁止 in_progress 状态退回到 pending，必须标记为 completed 或 cancelled - 优化状态转换校验，允许特定状态间合法切换 - 简化任务变更消息，移除详细的新增/更新/移除统计 - 更新文档和示例，明确 id 必须由用户生成和使用 - 修复和补充测试，增强状态转换和合并模式验证 - 调整任务时间戳生成逻辑，统一使用当前时间及索引 - 该变更提供更合理的任务状态机械及管理模式，提升稳定性和易用性
105 lines
4.4 KiB
Markdown
105 lines
4.4 KiB
Markdown
# minutes +upload
|
||
|
||
> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
|
||
|
||
上传音视频文件到飞书妙记并生成妙记（Minute）。
|
||
|
||
本 skill 对应 shortcut：`lark-cli minutes +upload`。
|
||
|
||
## 典型触发表达
|
||
|
||
- "把这个音视频文件转成妙记"
|
||
- "把这个音视频文件转成纪要"
|
||
- "把这个音视频文件转成逐字稿、文字稿或撰写文字"
|
||
- "把这个音视频文件转成总结、待办或章节"
|
||
|
||
## 完整工作流
|
||
|
||
当用户要求将音视频文件转换为妙记，或进一步要纪要/逐字稿/文字稿/撰写文字时，必须按照以下步骤执行：
|
||
|
||
1. **上传文件至云空间（云盘/云存储）获取 file_token**
|
||
- 使用 `lark-cli drive +upload` 命令上传本地文件到云空间/云盘/云存储（Drive）：
|
||
```bash
|
||
lark-cli drive +upload --file <path/to/media/file>
|
||
```
|
||
- 从命令的返回结果中提取生成的 `file_token`。
|
||
|
||
2. **将 file_token 转换为妙记链接（minute_url）**
|
||
- 调用本 shortcut，将获取到的 `file_token` 转换为妙记：
|
||
```bash
|
||
lark-cli minutes +upload --file-token <file_token>
|
||
```
|
||
- 命令执行成功后，将返回生成的妙记链接 `minute_url`。
|
||
|
||
3. **如需纪要 / 逐字稿 / 文字稿 / 撰写文字，继续提取 `minute_token` 调用 `vc +notes`**
|
||
- 从返回的 `minute_url` 中提取路径最后一段，得到 `minute_token`。
|
||
- 如果用户要的是纪要、逐字稿、文字稿、撰写文字、总结、待办或章节，继续调用：
|
||
```bash
|
||
lark-cli vc +notes --minute-tokens <minute_token>
|
||
```
|
||
- `vc +notes --minute-tokens` 会返回纪要文档、逐字稿文档，以及 AI 内置产物（总结、待办、章节）；必要时还会把逐字稿落地到本地文件。
|
||
|
||
> **异步生成提示**：API 会立即返回 `minute_url`，但妙记可能仍在异步生成中，您可以直接通过该妙记链接查看当前的处理状态和转写结果。
|
||
|
||
## 命令示例
|
||
|
||
```bash
|
||
# 通过已上传到云空间（云盘/云存储）的 file_token 生成妙记
|
||
lark-cli minutes +upload --file-token boxcnxxxxxxxxxxxxxxxx
|
||
|
||
# 通过 minute_token 继续获取纪要 / 逐字稿 / 文字稿 / AI 产物
|
||
lark-cli vc +notes --minute-tokens obcnxxxxxxxxxxxxxxxx
|
||
```
|
||
|
||
## 参数
|
||
|
||
| 参数 | 必填 | 说明 |
|
||
|------|------|------|
|
||
| `--file-token <token>` | 是 | 已经上传到飞书云空间（云盘/云存储）的音视频文件的 file_token |
|
||
|
||
## 支持的格式与限制
|
||
|
||
待上传到妙记的原始音视频文件必须满足以下要求：
|
||
|
||
- 支持音频格式：`wav`、`mp3`、`m4a`、`aac`、`ogg`、`wma`、`amr`
|
||
- 支持视频格式：`avi`、`wmv`、`mov`、`mp4`、`m4v`、`mpeg`、`ogg`、`flv`
|
||
- 音视频时长不能超过 `6` 小时
|
||
- 文件大小不能超过 `6 GB`
|
||
|
||
> 说明：本 shortcut 只接收 `file_token`，不会直接读取本地文件内容，因此这些格式、时长和大小限制对应的是**原始上传文件**本身。若妙记生成失败，请先回查源文件是否满足上述要求。
|
||
|
||
## 核心约束
|
||
|
||
### 1. 必须提供 file_token
|
||
|
||
本接口不直接处理本地文件的上传，必须先使用 `drive +upload` 将文件上传到云空间（云盘/云存储）获取 `file_token`，然后再调用本接口。
|
||
|
||
### 2. 先上传，再生成妙记
|
||
|
||
推荐流程如下：
|
||
|
||
1. 使用 `lark-cli drive +upload --file <path>` 上传本地音视频文件到云空间（云盘/云存储）
|
||
2. 从返回结果中取出 `file_token`
|
||
3. 调用 `lark-cli minutes +upload --file-token <file_token>` 生成妙记
|
||
4. 如果目标是纪要、逐字稿、文字稿、撰写文字、总结、待办或章节，再从 `minute_url` 提取 `minute_token`，继续调用 `lark-cli vc +notes --minute-tokens <minute_token>`
|
||
|
||
> **边界说明**：`minutes +upload` 本身只负责把文件转成妙记并返回 `minute_url`。纪要内容、逐字稿、文字稿、撰写文字、总结、待办、章节属于后续产物获取，应由 [vc +notes](../../lark-vc/references/lark-vc-notes.md) 承接。
|
||
|
||
## 输出结果示例
|
||
|
||
```json
|
||
{
|
||
"minute_url": "http(s)://<host>/minutes/<minute-token>"
|
||
}
|
||
```
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| `minute_url` | 生成的妙记访问链接 |
|
||
|
||
## 参考
|
||
|
||
- [lark-minutes](../SKILL.md) -- 妙记相关功能说明
|
||
- [drive +upload](../../lark-drive/references/lark-drive-upload.md) -- 上传文件到云空间（云盘/云存储）
|
||
- [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数
|