抖音短视频脚本生成（存入飞书）

飞书配置

App Token（多维表 ID）： OKvxb7b4QaLUicsuuAfc4DshnFg

| 表名 | Table ID | 用途 | |------|----------|------| | 脚本生成需求表 | tblK6T5zBM1gu7a2 | 任务调度，读取待处理需求 | | 脚本生成表 | tblIxz4Uo79wtKjN | 脚本产出存储 | | 分镜案例表 | tblG3xwnQxfYBpvS | 优秀分镜案例参考 |

执行流程（必须完整跑完每一步）

Step 1：读取待处理需求

lark-cli base +record-list --base-token OKvxb7b4QaLUicsuuAfc4DshnFg \
  --table-id tblK6T5zBM1gu7a2 \
  --filter '{"处理状态":"待处理"}' \
  --limit 20

从每条需求记录中提取以下字段（均为 lookup 自动带入，无需额外查询）：

| 字段名 | 说明 | |--------|------| | 编号 | 需求 ID，如 2026042800009 | | 产品类目 | 如"数码3C" | | 品牌&价位定位 | 如"白牌性价比，¥49" | | 官方原生真实功能 | 核心功能描述 | | 独家差异化优势 | 产品核心卖点 | | 成分/材质/规格 | 产品规格参数 | | 合规宣传红线 | 禁止宣传的内容 | | 禁忌&慎用人群 | 不适合人群 | | 脚本类型 | 引流 / 带货 | | 脚本时长 | 目标时长（秒） | | 生产条数 | 每条需求生成几条脚本，默认2条 | | 其他说明 | 额外备注 | | record ID | 写入脚本时关联用，格式如 recXXXXXXXXX |

Step 2：参考分镜案例（可选，提升质量）

lark-cli base +record-list --base-token OKvxb7b4QaLUicsuuAfc4DshnFg \
  --table-id tblG3xwnQxfYBpvS \
  --limit 10

若找到同类目优秀案例，学习其节奏结构和镜头设计逻辑
若无同类目案例，按本 skill 内置专业编导标准直接生成

Step 3：生成脚本

每条需求默认生成 2 条差异化脚本（按"生产条数"字段，若有则遵从）。

3.1 差异化角度选择

每条需求的 2 条脚本，角度要明显不同。从以下 5 个方向中选 2 个互补的：

| 角度 | 核心逻辑 | 适合场景 | |------|----------|----------| | 痛点型 | 开场直击用户痛点，制造共鸣，再给出解决方案 | 解决实际问题的产品 | | 场景型 | 展示真实使用场景（多个），让用户代入自己的生活 | 高频使用场景的产品 | | 信任型 | 第三方测评/真实用户/数据背书，建立产品可信度 | 需要打消顾虑的产品 | | 好奇型 | 价格悬念/反常识/挑战认知，用猎奇感拉住注意力 | 高性价比或有独特卖点的产品 | | 对比型 | 与旧产品/竞品/行业平均对比，凸显产品优势 | 有明显改进点或替代价值的产品 |

飞书表「差异化角度」字段只接受这 5 个选项，不能用其他词。

3.2 每条脚本必须包含的 8 个模块

## 1、素材类型判定
（判定是原生共情素材/猎奇钩子素材/生活场景原生素材等）

## 2、核心用户痛点（3秒钩子）
（精准描述开场3秒命中哪个痛点或注意力）

## 3、包装后核心利益卖点
（将产品功能转化为用户利益语言）

## 4、适配使用场景
（3~5个具体真实使用场景）

## 5、出镜人设&口播风格
（出镜人设定位 + 口播语气风格）

## 6、完整分镜脚本
（详见 3.3 分镜表格式）

## 7、合规风险提示
（基于产品的"合规宣传红线"字段，列出3条以上禁止宣传内容）

## 8、拍摄规范要求
（针对本脚本的具体拍摄执行要点）

3.3 专业编导分镜表格式（11列，必须严格执行）

每个镜头用表格呈现，共 11 列：

| 列 | 说明 | |----|------| | 镜头序号 | 第 1、2、3… 个镜头 | | 时长 | 该镜头时间范围，如 0~3s | | 景别 | 特写 / 近景 / 中景 / 全景 / 极特写 | | 镜头运动 | 推 / 拉 / 摇 / 跟拍 / 固定 / zoom out 等 | | 背景&环境 | 场景描述+虚化程度+氛围感 | | 灯光色调 | 色温 / 打光方向 / 滤镜风格 | | 画面动作+人物神态 | 具体肢体动作+表情神态细节 | | 剪辑节奏 | 快切/慢推/跟焦/节奏音效等 | | 画面元素 | 需在画面中出现的关键视觉元素 | | 口播文案 | 该镜头对应的说话内容 | | 字幕 | 强调字幕关键词 | | 镜头作用逻辑 | 这个镜头的设计原因和对整体的作用 |

镜头数量参考： 15秒约4~5个镜头，18秒约5个镜头，30秒约6~7个镜头

3.4 脚本设计核心原则

开场0~3秒：必须命中痛点或制造强烈悬念，不能从产品介绍开始
中段展示：视觉化呈现功能卖点，用动作替代文字说明
结尾转化：价格锚点 + 「左下角」购物车引导，带货型必须有
合规边界：严格遵守产品"合规宣传红线"字段，不得越界
口播字数：15秒 ≤ 100字，18秒 ≤ 120字，30秒 ≤ 200字
差异化角度要真的不同：2条脚本开场方式、叙事结构都要有明显区别

Step 4：写入飞书脚本生成表

⚠️ 重要：含中文的 JSON 必须写入文件后用 @filepath 引用，不能直接拼接在命令行中。

4.1 写入单条脚本

# 先将内容写入临时 JSON 文件
cat > /tmp/script_temp.json << 'ENDJSON'
{
  "fields": ["关联需求", "脚本标题", "差异化角度", "脚本类型", "脚本内容"],
  "rows": [
    [
      [{"id": "recXXXXXXXXX"}],
      "产品名-角度名",
      "痛点型",
      "带货",
      "脚本正文内容..."
    ]
  ]
}
ENDJSON

# 执行写入（必须 cd 到目标目录后用相对路径）
cd /tmp && lark-cli base +record-batch-create \
  --base-token OKvxb7b4QaLUicsuuAfc4DshnFg \
  --table-id tblIxz4Uo79wtKjN \
  --json @script_temp.json

4.2 「差异化角度」字段合法值（只能用这5个）

痛点型 / 场景型 / 信任型 / 好奇型 / 对比型

4.3 「脚本类型」字段合法值

引流 / 带货

4.4 「关联需求」字段格式

必须是数组套对象：[{"id": "recXXXXXXXXX"}]

Step 5：更新需求状态为「已处理」

lark-cli base +record-update \
  --base-token OKvxb7b4QaLUicsuuAfc4DshnFg \
  --table-id tblK6T5zBM1gu7a2 \
  --record-id recXXXXXXXXX \
  --json '{"处理状态":"已处理"}'

每条需求的所有脚本全部写入成功后，再更新该需求状态。

踩坑记录（执行前必读）

| 问题 | 正确做法 | |------|----------| | 中文 JSON 在命令行会解析失败 | 写成临时文件，用 @filepath 引用，且必须 cd 到文件所在目录 | | 差异化角度写了"悬念型"报错 | 只能用：痛点型/场景型/信任型/好奇型/对比型 | | 关联需求格式写错 | 必须是 [{"id": "recXXX"}] 数组格式，不能是字符串 | | 分镜表无同类目案例 | 正常，直接按本 skill 编导标准生成，不需要等待 |

完成后汇报格式

执行完成后，向用户输出汇总表：

| 需求编号 | 产品 | 脚本类型 | 时长 | 生成脚本 |
|----------|------|----------|------|----------|
| XXXXXXXXX | 产品名 | 引流/带货 | Xs | 角度A + 角度B |

并说明：「X 条脚本已写入飞书脚本生成表，需求状态已更新为已处理。」