tj-short

TJ Short | Codex 短剧带货 Skill

用 Codex 把产品图推进为短剧带货项目：产品分析、地区锁定、人物备案板、高冲突脚本、4×3 首帧宫格、9:16 分镜、模型专属提示词、字幕与交付检查；分镜/首帧图片默认通过 salpx 中转站 gpt-image-2.5-sunburst 生成，视频默认通过 salpx Wan 3.0（wan3.0-*）生成。

English Version

项目简介

TJ Short 是一个面向 Codex 的「短剧带货 Skill」公开模板。它的核心不是单纯写剧本，也不是单纯调用视频模型，而是在 Codex 里把短剧带货从产品图一路推进到可执行交付物：

产品分析 -> 地区锁定 -> 三个 brief -> 产品证明圣经 -> 四库一表（角色 / 场景 / 产品道具 / 证据 + 12 镜头生产表）-> 人物备案板 -> salpx gpt-image-2.5-sunburst 生成 4×3 首帧宫格 -> 自动切 12 张 9:16 首帧 -> salpx Wan 3.0 视频提示词/API 提交（文生 / 首帧 / 首尾帧 / 多素材参考）-> 字幕与投放切片计划。

这里的分工很明确：

• Codex（或 WorkBuddy 等宿主 agent）是生产大脑：负责判断、写作、落文件、提示词、manifest、字幕、复盘和隐私检查。
• salpx 中转站是图片执行层：负责用 gpt-image-2.5-sunburst 生成产品证明图、分镜宫格和干净 9:16 首帧。
• salpx Wan 3.0 是默认且唯一的视频执行层：负责把锁定的首帧/参考素材和 prompt 生成 raw clip；图片与视频共用同一个 SALPX_API_KEY。

Skill Card

它适合：

• 宠物食品、宠物用品、消费品、工具类产品的短剧种草
• 需要先做 1 集正片 + 2 条投放切片验证的团队
• 想在 Codex 里把产品图自动变成短剧项目文件的创作者
• 想用 salpx 生成分镜/首帧图片，再用 salpx Wan 3.0 做视频（含 30 秒直出、多图/视频/音频参考）的创作者
• 面向 TikTok Shop US、Amazon US 或美国本土消费者做短剧带货的团队
• 想把短剧带货流程沉淀成 Skill、模板或团队 SOP 的项目

核心原则：

产品不是主角。人物、宠物、关系和代价先成立，产品只在关键时刻证明真相、改变行为或推动选择。

版本历史摘要

完整记录见：docs/changelog.md

为什么值得试

• 它是 Codex Skill，不只是文档：能指导 Codex 逐步产出真实项目文件
• Codex 负责策略、剧本、分镜、首帧、提示词和交付清单
• salpx 中转站负责生成分镜宫格、首帧和产品证明图；salpx Wan 3.0 负责生成视频素材
• 美国地区项目不做中文短剧直译，必须按美国人物、场景、对白、字幕、CTA 和平台语境重写
• 不写「痛点 -> 产品 -> 满意 -> 下单」的广告小剧情
• 前 30%-50% 先建立冲突、误会和关系压力
• 产品后置为证据位：喂养记录、操作过程、前后行为、关键物证
• 图生视频前先做三镜试生：剧情钩子、产品证据位、结尾追更钩子
• 首帧生产默认宫格优先：先用一张 4×3 宫格出 12 个镜头，再切 12 张 9:16；单张首帧只用于失败格、补拍格或三镜试生精修
• Wan 3.0 单次 2–30 秒整数直出，默认 5 秒做试片、8–10 秒做剧情段；omni 固定 10 秒作为可选路线，节奏压缩交给后期剪辑
• 不同视频模型分开处理：Wan 3.0 按素材类型选 text_to_video / first_frame / first_last_frame / reference，提示词里用 图1/图2、视频1、音频1 指派素材职责；Seedance2 用 图片1/视频1/音频1 和主体定义；omni 只写首帧之后的动作；Veo 走电影镜头和场景语言
• Seedance2 可见人脸优先走“人物备案板 -> 平台备案 -> 备案资产引用”；不把水印当成备案证明
• Seedance2 可见人物项目必须先有人物备案板交付物：角色主体库.md、人物备案板需求.md、Seedance2参考包计划.md
• 严格分阶段：启动只做产品诊断和 A/B/C；选方案后先生成项目文件和人物备案板交付物；之后才做分镜、宫格、视频 prompt 和提交
• 人物备案板继续用于设计、备案和团队审核；真正生视频时优先抽取“人脸特写 + 全身/半身服装图 + 场景/产品/运镜/音频参考”
• Seedance2 正式首帧/宫格不降级成整张漫画：同一人物镜头必须先出 face_pencil 强、face_pencil 中、blur_feature 三候选，逐张预检后选人脸和表演信息最完整的通过图
• 产品无人物首帧只用于 API 冒烟测试或产品证据镜头，不能静默替代人物表演镜头
• Seedance2 prompt 必须用 图片1、视频1、音频1 这种素材序号，不直接把 asset ID 写成角色名
• 备案不可用或仍失败时，再使用 face_pencil 或 blur_feature 修复虚拟角色参考，不默认改成无脸镜头
• 公开发布前默认做 key、隐私路径、任务响应和大文件检查

美国市场本地化硬规则

当目标地区选择 美国 / US / United States / TikTok Shop US / Amazon US 时，TJ Short 不把中文短剧翻译成英文，而是从一开始锁定美国市场语境。

必须符合：

• 对白和字幕默认使用自然美式英语，除非用户明确要求双语。
• 人物姓名、职业、家庭关系、冲突方式、幽默感、购物动作和 CTA 要像美国短视频电商内容。
• 场景优先使用美国日常生活空间：apartment、suburban home、kitchen、garage、dorm、pet store、clinic、gym、office、driveway 等。
• 手机界面、订单、价格、时间、地址、按钮文案使用美国习惯和美元口径。
• CTA 使用 Shop now、Check TikTok Shop、Get yours today、Available on Amazon 等美国平台表达。
• 医疗、营养、金融、儿童、宠物健康、美容、安全等品类必须用证据型表达，避免承诺疗效、收益或保证结果。

禁止默认出现：

家人们 / 直播间 / 橱窗 / 点小黄车 / 加微信 / 私信我
9块9包邮 / 人民币口径
中国小区、中文医院、中文街景、中文电商 UI
中文短剧式婆媳/相亲/职场套路直接翻译成英文

如果美国锁定项目中出现这些错位元素，项目必须标记为 locale_mismatch_us_market，修正后才能进入首帧或视频生成。

Seedance2 可见人脸

短剧镜头需要人脸表演时，不建议直接裁掉脸。

硬门槛：先做人物备案板交付物，再做首帧宫格和视频提示词。只有 参考资产角色表.md 不够。

流程硬门槛：

1. 启动阶段：只做产品诊断和 A/B/C，不写完整分镜和视频 prompt。
2. 选方案后：先生成 产品证明圣经.md、角色主体库.md、人物备案板需求.md、Seedance2参考包计划.md。
3. 角色门通过后：再生成 12 镜头分镜、4×3 首帧宫格、切图报告和模型专属提示词。

成本硬规则：不要一开始逐张生成 12 个独立首帧。标准做法是 4×3 宫格 -> 自动切 12 张 9:16 -> 预检 -> 只补拍失败格/关键试生格。

Seedance2 可见人物正式首帧从宫格/首帧阶段就按三候选处理：

1. 如果 salpx / 平台支持人物备案或真人备案，先把人物备案板备案，拿到平台内备案资产 ID，再用这个备案资产生成 Seedance2。
2. 备案资产要保留原平台引用；下载后重新上传可能失去备案状态。
3. 从人物备案板中抽取或生成单人参考：图片1=人脸特写，图片2=全身/半身服装图，再配场景、产品、运镜或音频参考。
4. 同一镜头生成三候选：face_pencil_strong、face_pencil_medium、blur_feature（模糊主图 + 五官特写）。
5. 三候选逐张做 Seedance2 预检测或受控单镜头测试。
6. 在通过候选里，选人脸信息保留最完整、表演最清楚的一张；失败图不重复原图硬撞，记录原因后换资产路线。
7. 提示词中定义主体：将图片1中的面部特征、图片2中的服装造型定义为林夏，后续持续使用同一角色名。

禁止：人脸不过时把正式首帧整体改成漫画、动画、插画或商业分镜风。那只能做预览草稿，不能作为默认正式首帧。

产品无人物首帧只用于产品证据镜头或 salpx API 冒烟测试，不能作为人物表演镜头被拒后的默认正式替代。

注意：LibTV 等水印不是备案证明，真实备案号也不要写进公开仓库。公开示例统一用 asset-YYYYMMDDHHMMSS-xxxxx 这类占位格式。

详细 SOP 见：docs/seedance2-face-compliance.md

和其他项目 / Skill 的区别

详细公平对比见：docs/comparison.md

案例预览

脱敏案例：宠物营养咀嚼片短剧。三张图分别对应高冲突开场、产品证据位、结尾追更钩子。

人物备案板 / 人物卡

角色主体不建议只用单张漂亮头像。关键角色应先生成横版人物备案板，用来锁定主视觉、三视图、表情、服装材质、产品接触行为和视觉关键词。后续首帧、分镜和视频 prompt 只引用这个角色主体，不在每个镜头重新发明人物。

开场钩子：明早九点送走	产品证据：按体重拌粮记录	结尾钩子：明早确认

案例脚本见：examples/xiderdl-lucky/ep01-high-conflict.md

交付物说明

一个合格的 TJ Short 项目建议交付这些文件：

流程架构

使用环境

仓库内容

如何安装

方式 A：作为 Codex Skill 安装

git clone https://github.com/tttg2010/tj-short.git
mkdir -p ~/.codex/skills/tj-short
cp tj-short/skill/SKILL.md ~/.codex/skills/tj-short/SKILL.md

如果使用 WorkBuddy，把 skill/SKILL.md 连同 docs/、scripts/、prompts/、assets/、examples/、.env.example 一起放到 ~/.workbuddy/skills/tj-short/，重开一个会话即可生效，不需要额外的安装命令。

安装或更新 Skill 后，必须重新启动 Codex，否则 Codex 可能还在使用旧缓存：

重新启动codex！
重新启动codex！
重新启动codex！

要在 Codex 里完整尝试短剧带货生产，请先到 salpx.com 中转站注册用户，获取 API Key。生图（gpt-image-2.5-sunburst）和视频（wan3.0-*）共用这一个 key。填入本地 .env：

SALPX_API_KEY=你的_salpx_api_key
SALPX_BASE_URL=https://www.salpx.com/v1
SALPX_IMAGE_MODEL=gpt-image-2.5-sunburst
SALPX_VIDEO_MODEL=wan3.0-720p

取 key 顺序：环境变量 → --env 指定的项目 .env → ~/.config/salpx/credentials.env。

没有 salpx API Key 时，Codex 仍可生成产品分析、剧本、分镜、首帧提示词和 manifest，但不能提交图片或视频任务。

然后在 Codex 里直接说：

短剧带货启动

或：

用 TJ Short 帮我把这张产品图做成短剧带货项目

方式 B：只使用脚本和模板

git clone https://github.com/tttg2010/tj-short.git
cd tj-short
python3 -m pip install requests
cp .env.example .env

然后到 salpx.com 注册用户并获取 API Key，在本地 .env 填入 SALPX_API_KEY——生图和生视频共用这一个 key。参考 .env.example，真实 key 只保存在本地。

注意：.env 已在 .gitignore 中，真实 key 不应提交到 GitHub。

如何使用：SOP 流程

Step 0：在 Codex 里启动 Skill

推荐起手式：

短剧带货启动

产品诊断给出 A/B/C 后，再复制下一步：

短剧带货，选 A，地区 美国，图片模型 salpx / gpt-image-2.5-sunburst，视频模型 salpx / wan3.0-720p（可选 wan3.0-1080p、wan3.0-hm-*、omni_flash、seedance-2-mini-480p），产品是：你的产品一句话

Codex 接下来应该先分析产品素材，并给出三个可选 brief，而不是直接写完整剧本。

启动守门规则：

• 只要说 短剧带货启动，Codex 第一轮不能直接生成完整制作包。
• 没有产品图或产品信息时，Codex 必须先问产品，不能凭空写职场、穿搭、情感等泛化案例。
• 即使你说“生成视频”，也要先走：产品诊断 -> 3 个 brief -> 选择 A/B/C。
• 完整提交 salpx 视频任务前（wan3.0-*），需要先到 salpx.com 注册并把 API Key 放进本地 .env；提交前会先报价，29 秒以上的 1080p 任务必须明确同意。

Step 1：Codex 做产品诊断

先回答 4 个问题：

• 卖什么？
• 卖给谁？
• 产品动作是什么？
• 凭什么让观众相信？

如果产品动作和可信证据说不清，不要进入出片。

Step 2：写三个 brief

每个 brief 只写到可选择深度：

• 剧情发动机
• 人物关系
• 前 5 秒危机
• 误会与真相
• 产品证据位
• 主卖点
• CTA
• AI 可拍性

用户选中一个 brief 后，Codex 再进入项目态，创建或更新真实项目文件。

Step 3：Codex 写高冲突单集

推荐节奏：

0-5s：外部压力或关系威胁
5-20s：对白冲突
20-40s：误会升级
40-55s：真相浮出
55-70s：产品作为证据进入
70-90s：关系反转 + 追更钩子

Step 4：Codex 先做 4×3 首帧宫格，再切 12 张 9:16 首帧

不要一开始单独生成 12 张首帧，也不要先为三镜试生额外生成三张图。标准成本控制流程是：

1. 生成一张可切图的 4×3 宫格，12 格对应本集 12 个镜头。
2. 自动切出 12 张干净的 9:16 首帧，并记录切图报告。
3. 预检每一格的剧情、人物、产品、字幕和边框问题。
4. 从切出的首帧选 HC-01（开场强钩子）、HC-09（产品证据位）、HC-12（结尾追更钩子）进入三镜试生。

只有宫格无法切图、某一格预检失败、用户明确要求独立首帧，或三镜试生需要精修时，才单独补拍该镜头。正式首帧必须是干净 9:16 全屏图，不要字幕、画中画、白边框或模糊补边。

Step 5：Codex 编译 prompt，salpx 生图，Wan 3.0 生视频

如果需要先生成宫格、首帧或产品证明图，使用 gpt-image-2.5-sunburst：

python3 scripts/salpx_production_client.py --env .env image \
  --model gpt-image-2.5-sunburst \
  --prompt "vertical 9:16 ecommerce short-drama first frame..." \
  --size 1024x1792 \
  --out-dir outputs/images \
  --name ep01-shot01

视频统一走 salpx Wan 3.0（wan3.0-*），与生图共用同一个 SALPX_API_KEY。最常用的是首帧图生视频：把通过预检的 9:16 首帧作为 first_frame，生成 raw clip。

python3 scripts/wan3_video_client.py --env .env video \
  --model wan3.0-720p \
  --prompt "8-second vertical 9:16 US TikTok Shop short-drama clip, no subtitles, no extra props..." \
  --duration 8 \
  --ratio 9:16 \
  --first-frame path/to/first-frame.png \
  --wait \
  --out outputs/videos/shot-01.mp4

需要严格首尾帧时补 --last-frame（first_last_frame 模式，不能与参考素材混用）：

python3 scripts/wan3_video_client.py --env .env video \
  --model wan3.0-720p \
  --prompt "Animate naturally from the first frame and finish on the last frame. No subtitles." \
  --duration 6 --ratio 9:16 \
  --first-frame path/to/first-frame.png \
  --last-frame path/to/last-frame.png \
  --wait --out outputs/videos/shot-01.mp4

需要身份锁定、运镜迁移、声音或口型同步时走 reference 模式（参考图最多 10 张；参考视频最多 5 段、合计 15 秒；参考音频最多 5 段、合计 15 秒）：

python3 scripts/wan3_video_client.py --env .env video \
  --model wan3.0-1080p \
  --prompt "图1 是女主，图2 是产品包装；视频1 定运镜；音频1 是她的声音，口型贴合音频1" \
  --duration 10 --ratio 9:16 \
  --ref-image path/to/character.png \
  --ref-image path/to/product.png \
  --ref-video path/to/dance.mp4 \
  --ref-audio path/to/voice.mp3 \
  --wait --out outputs/videos/shot-01.mp4

价格与门禁：

带参考视频时按「出片秒数 + 参考视频秒数」计费，提交时先按 15 秒上限预扣、完成后结算；失败或超时全额退还。--dry-run 可以先校验素材并算出价格，不产生费用。

提交前必须先把模型、分辨率、秒数、是否带参考视频和金额报给用户并取得同意——30 秒 1080p 是 ¥25.20，不允许默认提交。

完整说明见 docs/wan3-api-production.md。

omni_flash（固定 10 秒）与 Seedance2 / Veo 仍作为可选历史路线保留，请求字段与 Wan 3.0 不同，不要混用。

Step 6：Codex 审片

检查：

• 是否完成本镜头剧情任务
• 是否提前泄露后续信息
• 是否产品硬广化
• 是否出现字幕、乱码、画中画或白边
• 是否台词归属错误
• 是否需要后期配音

三镜通过后，再扩展到全 12 镜头。

Step 7：Codex 整理后期交付

最终成片必须补：

• 字幕
• 配音或可用原声
• 原音低混
• 抽帧预览
• 发布前评分
• 投放切片

无字幕 raw 视频只能算素材，不算可发布成片。

星级评价标准

如果你在 30 分钟内能完成下面动作，这个 Skill 就值得给 5 星：

参考来源

本项目的工作流受到以下项目或方法启发，并在公开仓库中明确致谢：

• OnlyShot：短剧带货、产品证据位、项目化交付思路
• short-drama：短剧结构、分镜、出片流程
• Emily2040/seedance-2.0：镜头契约、项目状态胶囊、参考资产职责、one-variable retake

本仓库不是这些项目的官方发行版，而是一个公开安全、可复用的实践模板。

Keywords / 关键词

Codex 短剧带货、短剧带货 Skill、AI 短剧生成、AI 带货视频、产品图生视频、商品图生视频、salpx Wan 3.0、wan3.0、Wan 3.0、万相 3.0、30 秒视频直出、多图参考、视频参考、声音参考、口型同步、salpx、salpx 中转站、gpt-image-2.5-sunburst、omni_flash、Seedance 2.0、seedance-2-mini-480p、Veo、图生视频、AI 视频生成、短剧分镜、4×3 首帧宫格、9:16 首帧、人物备案板、角色主体库、Seedance2 人脸合规、face_pencil、blur_feature、美国市场本地化、产品证明、带货脚本、短视频电商、TikTok Shop 内容、跨境电商视频、Codex Skill、Prompt 工程。

公开安全

本仓库不包含：

• 真实 API key
• .env
• 私有产品原图
• API 响应
• task ID
• 下载 URL
• 本地绝对路径
• 生成视频文件

发布前请阅读：docs/privacy-and-release.md