短视频内容审核

技能文档

---
name: lingyi-short-video-content-audit
title: 短视频内容审核
category: 内容创作
description: 短视频发布前内容合规质检工具。支持口播文本质检或本地视频上传走多模态质检，产出文本层实质质检清单、画面声音人工复核清单、特殊行业专项检查与总判定。当用户需要在视频发布前检查违禁词、做口播合规审查、按广告法排查短视频风险时触发。触发词：短视频内容审核、口播合规、发布前违禁词、广告法视频、视频合规质检。
---

# 短视频内容审核

对即将发布的视频做发布前合规排雷：**文本层实质质检 + 画面声音检查清单 + 特殊行业双关 + 总判定**。

| 环节 | 耗时 | 扣点 |
|------|------|------|
| **本地视频上传**（可选） | 视文件大小 | **不扣点**（上传换取后续分析用 id） |
| **内容质检（仅口播文本）** | 约 1 分钟 | 约 20 点（按 token 实扣；**首次成功读取结果时结算**） |
| **内容质检（有 video / video_id，走多模态）** | 约 5–10 分钟，片长更长会再往上 | 同上 |
| **Excel 空白模板**（本地） | 秒级 | 不扣点 |

⚠️ **对用户说话要说人话。** 不提 task_id、退出码、接口路径等技术细节。一句只做一件事。

⚠️ **边界**：本技能**不在本地解析**视频画面；用户给本地视频时由脚本上传后由远端完成提取与质检。无视频时也可只传口播/字幕文本质检。

## 技能工作流

### 步骤1：检查鉴权配置

1. 密钥读取顺序：技能目录 `config.json` 的 `LY_API_KEY` → 环境变量 `LY_API_KEY`。
2. 缺失时引导用户到服务方获取页 `https://claw.lingyishuke.com/webapps/01claw-auth/index.html` 获取并配置，取得前不创建任务。

### 步骤2：收集输入

| 用户提供 | 说明 |
|----------|------|
| **口播/字幕** | 与本地视频 / video_id 至少其一；**仅文本**时建议 ≥20 字 |
| **本地视频** | 拖入文件或给路径；脚本上传换 `video_id`（≤100MB） |
| **video_id** | 已有则直接用，**跳过上传**；可与 text 同给 |
| **平台** | 抖音/视频号/小红书/B站/快手，可多选；默认全平台 |
| **行业** | 可选，医美/金融/教培等影响专项检查 |
| **资质** | 可选 |
| **标题封面 / 是否带货** | 可选 |

平台映射：抖音→`douyin`，视频号→`channels`，小红书→`xhs`，B站→`bilibili`，快手→`kuaishou`。

### 步骤3：扣点确认（硬门禁）

新任务创建前，必须先说明预估扣点并等用户明确确认；**未确认 / 未回应 / 改主意 → 禁止运行创建脚本**。仅 `--poll-task` 续轮询不重复确认。

> 本次短视频内容审核预计扣点约 20 点，实际按 token 用量实扣。是否继续？

等用户明确说「继续 / 可以 / 确认」等同意表述后再跑脚本。用户未确认、未回应、或要求先改口播/换视频时，**不要运行脚本**。上传本身不单独扣点。失败重试：用户同意「再试一次」后，才可跑 `--retry-task` 或重新创建；重新创建新任务须再走一次扣点确认。

### 步骤4：创建质检任务（含本地上传）

确认后跑脚本：若有本地视频 → 自动上传换 `video_id` → 创建质检任务；拆分轮询，禁止长同步阻塞。

```bash
# 本地视频：上传 → 创建质检
python3 scripts/video_compliance.py --video "/path/to/video.mp4" --platforms douyin,xhs --only-create

# 仅口播文本
python3 scripts/video_compliance.py --text "<口播>" --platforms douyin,xhs --only-create

# 已有 video_id（可与 text 同给）
python3 scripts/video_compliance.py --video-id <video_id> --platforms channels --only-create
```

本地视频上限 **100MB**；支持 mp4 / mov / m4v / avi / mkv / webm / flv / wmv。超限或格式不对直接参数错误退出，不发起上传。

### 步骤5：轮询与交付报告

循环 `--poll-task`：退出码 0 交付 / 13 继续等 / 12 失败 / 9 上传失败可重试。

```bash
python3 scripts/video_compliance.py --poll-task <task_id> --out ./短视频内容审核报告.md
```

- **扣点时机**：任务完成后**第一次**成功读取结果时结算（只扣一次）。
- 脚本默认轮询间隔 **60s**；拆分模式下单次 `--poll-task` 只查一次。
- 有视频时远端要下载、压缩、多模态抽取再质检，**5–10 分钟仍是 running 属正常**，不要按「一两分钟」判断失败；至少等到 **10 分钟** 再考虑异常。

交付时按顺序：

1. **渲染报告**：把返回的 Markdown 报告完整给用户。
2. **告知实际扣点**：`VIDEO_QC_POINTS_USED` 非空 →「本次任务实际扣除 {N} 点」；为空 →「本次约 20 点（实际以账户明细为准）」。
3. **失败告知**：任务已发起但未成功产出报告时，告知「因异常本次未完成，相应点数已退回/未扣除（以账户为准）」，并询问是否重试；上传阶段失败（退出码 9）任务未创建，**不扣点**。

### 步骤6：生成 Excel 空白模板

报告交付后**必须再生成**本地可填 Excel 空白模板（不扣点，无需为此单独确认）：

```bash
python3 scripts/gen_qc_xlsx.py --out ./短视频内容审核清单.xlsx
# 缺 openpyxl 时：
python3 scripts/gen_qc_xlsx.py --install-deps --out ./短视频内容审核清单.xlsx
```

stdout 含 `VIDEO_QC_XLSX_FILE=<绝对路径>`。对用户说：

> Excel 模板已生成：<路径>，打开即可填；对话里的质检报告 Markdown 与之一一对应。

收尾示例：

> 质检报告如上 ✅ 本次实际扣除 {N} 点。画面相关项请按清单人工再看一眼。Excel 模板：<路径>。

## 输出协议

脚本 stdout 依次输出：

```
VIDEO_QC_VIDEO_ID=<上传或传入的 video_id，可有可无>
VIDEO_QC_POINTS_USED=<实扣，来自 data.total_points>
VIDEO_QC_PLAN_POINTS=20
VIDEO_QC_REPORT_FILE=<路径>
VIDEO_QC_TASK_ID=<id>
=== VIDEO_QC_REPORT_START ===
<Markdown>
=== VIDEO_QC_REPORT_END ===
```

## 退出码

| 码 | 对用户 |
|----|--------|
| 0 | 渲染报告 |
| 2/8 | 取/换 API Key |
| 3 | 补参数 / 换合法视频（格式、大小） |
| 4 | 充值 |
| 9 | 视频上传失败，可稍后重试（**未扣点**） |
| 12 | 出了点问题，点数已退回，要不要再试？ |
| 13 | 还在质检 → 继续 poll |

`gen_qc_xlsx.py` 缺 openpyxl 时退出码 2：引导 `pip3 install openpyxl` 或 `--install-deps`。

## 原则

- **新任务必须先扣点确认再跑脚本**；未确认不得创建任务
- 本地视频：脚本内上传后质检；报告以脚本返回为准，**禁止改写**
- 异步创建 → 轮询 → 可选重试；禁止一次长阻塞
- Excel **本地**生成、不联网、不扣点
- 报告骨架与样例见 `references/template.md`、`references/sample.md`

使用说明

# 短视频内容审核

短视频发布前合规质检工具：文本层实质质检（违禁词、广告法风险）+ 画面声音人工复核清单 + 特殊行业专项检查 + 总判定，交付结构化质检报告与可填 Excel 清单。

## 使用

先配置服务密钥（`config.json` 的 `LY_API_KEY` 或同名环境变量，获取方式见 SKILL.md「技能工作流」），然后直接对话：

```text
帮我质检这段口播文案能不能发抖音：<口播文本>
这是一个本地视频 /path/to/video.mp4，发布前帮我做全平台合规排雷
```

## 工作原理

口播文本或上传的视频由远端多模态服务质检（异步任务，约 1–10 分钟），产出四部分报告：质检口径、文本层问题清单（含改写建议）、画面声音人工复核清单、总判定（可发布/需修改/不建议发布）；本地脚本额外生成 Excel 空白模板供逐条复核。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。