bestblogs-process-videos

视频批量转录与更新 (Process Videos)

查询 BestBlogs 中等待预处理的视频 → 用户选择 → 逐个转录并更新到 BestBlogs → 触发内容分析。

认证

需要两个环境变量：

所有请求需携带：

-H "Authorization: Bearer $BESTBLOGS_ADMIN_JWT_TOKEN"
-H "User-Id: $BESTBLOGS_ADMIN_USER_ID"
-H "Content-Type: application/json"

若环境变量未设置，提示用户配置。

接口地址：https://api.bestblogs.dev

转录脚本

本 skill 依赖 bestblogs-transcribe-youtube skill 的脚本，按以下顺序查找：

工作流概览（4 个阶段）

阶段一（查询视频列表）→ 阶段二（用户选择 / 快捷跳过）→ 阶段三（逐个处理）→ 阶段四（输出结果）

快捷模式

当用户在触发 skill 时已明确指定处理范围，跳过阶段二的确认，直接进入阶段三：

快捷模式下仍然输出视频列表摘要（总数、优先级分布），但不等待用户选择，立即开始处理。若查询结果为空，正常提示"暂无等待预处理的视频"并结束。

阶段一：查询等待预处理的视频

curl -s -X POST https://api.bestblogs.dev/api/admin/article/list \
  -H "Authorization: Bearer $BESTBLOGS_ADMIN_JWT_TOKEN" \
  -H "User-Id: $BESTBLOGS_ADMIN_USER_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "currentPage": 1,
    "pageSize": 20,
    "type": "VIDEO",
    "flowStatusFilter": "WAIT_PREPARE"
  }'

响应结构：

{
  "success": true,
  "data": {
    "currentPage": 1,
    "pageSize": 20,
    "pageCount": 1,
    "totalCount": 5,
    "dataList": [
      {
        "id": "RR_xxx",
        "title": "视频标题",
        "url": "https://www.youtube.com/watch?v=xxx",
        "sourceName": "来源名",
        "priority": "HIGH",
        "priorityDesc": "高",
        "publishDate": "2025-03-01T00:00:00.000+00:00",
        "publishDateStr": "2025-03-01"
      }
    ]
  }
}

始终检查 success 字段。 若列表为空，提示"暂无等待预处理的视频"并结束。

阶段二：用户选择

展示视频列表：

## 等待预处理的视频（共 N 个）

| # | ID | 标题 | 链接 | 来源 | 优先级 | 发布日期 |
|---|-----|------|------|------|--------|---------|
| 1 | RR_xxx | 视频标题 1 | [YouTube](https://www.youtube.com/watch?v=xxx) | 来源 A | HIGH | 2025-03-01 |
| 2 | RR_yyy | 视频标题 2 | [YouTube](https://www.youtube.com/watch?v=yyy) | 来源 B | MEDIUM | 2025-02-28 |

请选择要处理的视频：
- "全部" — 处理所有视频
- "1, 3, 5" — 处理指定编号的视频

等待用户选择后继续。

阶段三：逐个处理

严格串行处理。 每个视频必须完成以下 4 步后，再处理下一个视频：

步骤 A: 转录视频 → 步骤 B: 保存文件 → 步骤 C: 更新内容 → 步骤 D: 触发分析

ID-内容关联安全

步骤 A+B: 转录并保存

根据优先级选择思考级别：

mkdir -p ./contents/tmp/transcribe && \
npx -y bun <TRANSCRIBE_SCRIPT> --thinking <level> -o ./contents/tmp/transcribe/transcribe-<id>-<yyyyMMddHHmmss>.md <video-url>

文件保存到当前工作目录的 ./contents/tmp/transcribe/ 下，文件名：transcribe-{id}-{yyyyMMddHHmmss}.md。

> 注意：pro 模式会调用 Gemini Pro（需时较长），若 Chrome AppleScript 超时（ETIMEDOUT），自动降级为 think 模式重试一次。两次均失败时记录错误并跳过。

步骤 C: 更新内容

读取步骤 B 保存的文件内容，去除第一行的 H1 标题（以 # 开头的行）后，调用 API 更新。id 必须与文件名中的 {id} 一致。

> 原因：页面已有标题展示元素，内容中若包含标题会导致重复。本地保存的文件保留标题，仅在上传时去除。

去除标题的处理逻辑（python3）:

lines = content.split('\n')
# 跳过开头的空行和第一个 H1 标题行
start = 0
for i, line in enumerate(lines):
    if line.startswith('# '):
        start = i + 1
        break
content_without_title = '\n'.join(lines[start:]).lstrip('\n')

curl -s -X POST https://api.bestblogs.dev/api/admin/article/updateContent \
  -H "Authorization: Bearer $BESTBLOGS_ADMIN_JWT_TOKEN" \
  -H "User-Id: $BESTBLOGS_ADMIN_USER_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "RR_xxx",
    "markdownContent": "转录的 Markdown 内容..."
  }'

只传 markdownContent，服务端会自动转换为 displayDocument (HTML)。

步骤 D: 触发内容分析

updateContent 成功后，使用同一个 {id} 触发分析：

curl -s -X POST "https://api.bestblogs.dev/api/admin/article/runAnalysisFlow?id=RR_xxx" \
  -H "Authorization: Bearer $BESTBLOGS_ADMIN_JWT_TOKEN" \
  -H "User-Id: $BESTBLOGS_ADMIN_USER_ID" \
  -H "Content-Type: application/json"

> 重要：步骤 C 和步骤 D 必须作为独立命令分开执行，不能用 && 链式调用。原因：--data-raw 传递大内容时，curl 在服务端已成功响应后可能因 SSL 连接重置而返回 exit code 35，导致 && 后的命令不执行。

输出进度

每处理完一个视频，更新进度：

- [1/3] ✅ RR_xxx — 视频标题 1 (pro, 12345 字，已更新，已触发分析)
- [2/3] 🔄 RR_yyy — 视频标题 2 (think) 处理中...
- [3/3] ⏳ RR_zzz — 视频标题 3 (think)

单个视频任一步骤失败时，记录错误并继续处理下一个视频。

阶段四：输出最终结果

## 处理结果

| # | ID | 标题 | 链接 | 转录 | 更新 | 分析 | 文件 |
|---|-----|------|------|------|------|------|------|
| 1 | RR_xxx | 标题 1 | [YouTube](https://www.youtube.com/watch?v=xxx) | ✅ 12345 字 | ✅ | ✅ | ./contents/tmp/transcribe/transcribe-RR_xxx-20250305143022.md |
| 2 | RR_yyy | 标题 2 | [YouTube](https://www.youtube.com/watch?v=yyy) | ✅ 8901 字 | ✅ | ✅ | ./contents/tmp/transcribe/transcribe-RR_yyy-20250305143522.md |
| 3 | RR_zzz | 标题 3 | [YouTube](https://www.youtube.com/watch?v=zzz) | ❌ 转录失败 | - | - | - |

### 统计
- 成功：2
- 失败：1

错误处理