🏭 老庹 AI 电商内容工厂

Laotuo AI E-Commerce Studio

「插卡式 Skill 驱动」的全链路电商视觉工作台 —— 一键生成高转化主图、深度详情页、MiniMax H3 原生音画带货视频与剪映 / 达芬奇后期工程

快速启动 · 插卡式架构 · 商业版与定制 · 商务合作

🎬 官方宣传片（1080P，62 秒，8.7MB）：点图片打开视频文件，再点「View raw」下载观看

选好类目和平台、填好商品信息，在一个本地 Web 界面里产出五类素材：

• 主图：按平台建议张数策划，逐槽位并发出图、勾选定稿、打包导出。
• 详情页：按屏规划，生成长图序列预览。
• 带货短视频：MiniMax H3 原生音画一体，画面和声音一次产出；先锁定首帧再生成，商品不变形。成片可一键合成 mp4，或导出剪映草稿、达芬奇工程继续精剪。
• 配音：VoxCPM2 口播配音，逐段生成后拼接，导出 wav / mp3 / srt。
• 动效广告：按节拍编排一条动效广告，动效、配乐、音效全部由本机代码渲染。用项目里已有的主图、详情页、首帧和分镜视频时不调用生图接口，不消耗画图额度；也可以选「AI 生图」，为几屏单独生成专属画面。

全部 AI 能力由 Markdown「卡带」驱动，代码里不写死提示词。没有 API Key 也能完整体验全流程（零 Key 演示模式）。

目录

• 🔥 为什么通用 AI 做不出能卖货的电商图？
• 功能一览
• 🎮 任天堂插卡式 Skill 架构
• 🚀 3 分钟快速启动
• 💼 商业版本与定制服务
• 配置说明
• 使用教程
• 系统架构
• 扩展开发
• 开发与测试
• 安全须知
• 贡献指南
• 许可证
• 致谢

🔥 为什么通用 AI 做不出能卖货的电商图？

通用 AI 工具能画出好看的图，但电商图要同时做到四件事：商品是真的、细节是对的、文案合规、能让人下单。

电商图的硬要求	普通 AI 工具	老庹 AI 内容工厂
① 商品不走样	凭空画包装，包装字乱码、logo 变形	0 / 1 / 多图路由：按实际上传的商品参考图数量，自动选文生图、单图保真编辑或 2~3 图融合；视频先锁定首帧再生成，并把商品参考图一起交给 H3（Ref2VA）。中文排版有 8 条防变形底线（逐字锁死、平面正视、高反差等）
② 品类细节画对	不认识品类，莓茶白霜画成发霉、草本切片画成一堆木屑	类目配置写清品类特征（如莓茶白霜是黄酮自然析出、不是霉变），配合光学微距构图；草本原料按《中国药典》性状图谱逐味入画，同框易混的原料单独提醒
③ 懂广告法	文案里常出现「最」「第一」、功效承诺	广告法与类目违禁词实时检查；卡带内置合规红线，所有示范句由自动化测试逐条校验
④ 文案和视频会卖货	文案像说明书，视频开头留不住人，后期还要从头剪	三维视觉美学（5 大美学流派 × 6 大构图 + 8 种中文排版方案）+《电商高转化文案写作指南》（FAB、五感具象、场景点名、诚实交底）；视频黄金 3 秒钩子模板、Hypit 爆款视频结构克隆；剪辑大师一键成片，剪映 / 达芬奇工程一键导出

功能一览

• 三步式策划工作流：填写想法（选填）→ AI 生成草稿 → 人工编辑并确认。确认后才能传图和渲染。
• 生图模式自动判定：按参考图数量在文生图（0 张）、单图保真编辑（1 张）、多图融合（2~3 张）之间路由。
• 参考图按角色登记：同一角色（如 product_package）上传一次，自动绑定到所有需要它的槽位。
• 视觉设计体系：5 大美学流派 × 6 大构图模式，可整套统一，也可逐槽位指定。
• 视频双路策划：原创剧本，或克隆参考爆款视频的结构（本地抽帧 → 拆解 → 替换为本品）。
• 广告创意母版：原创剧本按 TBWA 颠覆三步与 6 个获奖广告创意母版构思，每个镜头服务于「钩子 → 冲突 → 反转 → 信任收尾」戏剧弧线；自动混搭时创意大纲一次给出 3 个不同母版的方案。
• MiniMax H3 提示词自动编写：内置官方 h3-prompt-writing 技能。分镜绑定了商品参考图时用 Ref2VA，否则用 I2VA，无需手动选择。
• 视频版本管理：每个分镜单独显示最新视频，重新生成会保存为新版本，不覆盖旧视频。
• 剪辑大师一键成片：自动定位台词、排顺序、加转场和字幕花字，导出 mp4、剪映草稿或达芬奇工程。
• 代码动效广告：分镜按整数拍排期，每一刀都落在节拍上；逐字遮罩上升、动势衔接转场、本机合成配乐与音效；9 类版式（含痛点对比、步骤流程）；每次渲染自动出联系表和 14 项自检报告（节拍、阅读时间、字号、安全区、响度等）。素材可以只用项目已有的图（零成本），也可以为部分分镜调用生图接口生成专属画面。
• 三路并发：主图、详情页、视频三个选项卡各自排队，互不阻塞；切换选项卡不会中断任务。
• 实时回显：运行日志实时滚动，图片生成一张显示一张。
• 本地持久化：所有状态写入 workspace/projects/，重启后可恢复历史项目。
• 合规检查：按广告法与类目违禁词实时提示。

🎮 任天堂插卡式 Skill 架构

工作台是「游戏机」，每项 AI 能力是一个「卡槽」，Markdown 卡带是「游戏卡」。换一张卡带就换一套策划、编剧或提示词写法，不用改一行代码。

flowchart LR
    subgraph Cards["卡带"]
        direction TB
        Open[("🌱 开源卡带<br/>config/skills/")]
        Pro[("👑 Pro 卡带包<br/>config/skills_pro/")]
    end
    subgraph Console["工作台的 4 大热插拔卡槽"]
        direction TB
        P["① ecommerce_planner<br/>电商策划"]
        S["② video_scriptwriter<br/>视频分镜剧本"]
        I["③ image_prompt<br/>生图提示词"]
        V["④ video_prompt<br/>H3 音画提示词"]
    end
    Cards -. 插入 / 热重载 .-> Console
    P --> I --> IMG["🖼️ 主图 / 详情页<br/>GPT Image · Nano Banana"]
    S --> I
    S --> V --> H3["🎬 带声短视频<br/>MiniMax H3"]
    H3 --> ED["✂️ 剪辑大师<br/>成片 / 剪映 / 达芬奇"]

除 4 大主卡槽外，还有视频进阶编剧（concept_writer、story_scriptwriter）和剪辑大师（video_editor）。卡槽由文件夹名决定：

卡槽	用途
ecommerce_planner	主图 / 详情页策划
concept_writer	视频创意大纲
story_scriptwriter	视频完整剧本（按视频类型分卡带）
video_scriptwriter	视频分镜剧本（原创 / 爆款克隆）
image_prompt	生图提示词（GPT Image / Nano Banana）
video_prompt	MiniMax H3 音画提示词
video_editor	剪辑大师：分镜视频 → 剪辑方案（顺序、出入点、转场、卖点花字）
voice_writer	配音文案（VoxCPM2 口播）
motion_director	动效导演：项目素材 → 动效方案（结构、文案、素材、拍数、镜头、转场；「AI 生图」方式另写 AI 画面描述）

卡带格式为 YAML front matter + Markdown 正文：

---
skill_id: my_planner_v2          # 必填，全局唯一，小写字母 / 数字 / 下划线
name: 我的策划 Skill              # 必填，界面显示名
description: 一句话说明            # 选填
version: "1.0"                   # 选填
variables: [product_name]        # 选填，声明正文使用的变量
default: false                   # 选填，true 表示该卡槽默认选中
categories: [zhangjiajie_berry_tea]  # 选填，类目专属卡带；不写则所有类目可用
references: [references/guide.md]    # 选填，附属指南，加载时自动读入
---
正文……可以使用 {{ product_name }} 这样的变量占位。

• 新卡带放进对应文件夹即可被识别，按文件修改时间热重载，无需重启。
• 渲染时缺少变量会报错，不会把未填充的占位符发给模型。
• 单张卡带解析失败不影响其他卡带，错误显示在界面上。
• 界面「🔌 插卡式 Skill 管理与在线微调」可预览正文，并临时覆盖当前会话的指令，覆盖内容不写回文件。
• 附属指南只允许放在卡带同目录的 references/ 下，单文件不超过 200KB。

🧬 卡带继承

行业卡带不必把通用规则整份复制一遍，可以继承同卡槽的另一张卡带，只写不一样的部分：

---
skill_id: my_tea_planner
name: 我的茶叶策划
extends: default_planner         # 继承默认策划卡带的全部区块
categories: [zhangjiajie_berry_tea]
---
# 角色 {#role}
……整块替换父卡带的「角色」……

# 合规红线 {#compliance after=task}
……新增区块，插在「本次任务」之后……

# {#copywriting append}
……追加到父卡带「文案规则」末尾……

# {#anti_duplicate remove}

• 区块用一级标题尾标 {#区块id} 标出，发给模型前会去掉标记。default_planner 的区块：role、task、planning_rhythm、generation_mode、anti_duplicate、visual_system、copywriting、output_format、self_check。
• 标为 final 的区块（task、output_format）只能追加不能替换，保证所有策划卡带输出同一种 JSON。
• variables、references 自动合并；categories、default 不继承。
• 只能继承同一卡槽的卡带，最多 3 层；开源卡带不能继承 Pro 卡带。
• 查看展开后的完整提示词和每个区块的来源：python -m app.engine.skill_loader --resolve my_tea_planner。

👑 Pro 卡带包

config/skills_pro/ 是商业 Pro 卡带包的安装位置，目录结构与 config/skills/ 相同（{卡槽}/*.md，可带 references/）。

This is the beginning of the README. Read the rest at the original. Read the full README ↗