Files
lingxi/docs/PRD/灵犀-信息流广告素材一站式生产平台PRD.md
Stev_Wang 140dc386c1 feat(client): A3 客户与行业目录(两级行业、客户组、字段审批)
背景:A3 需把行业 / 客户 / 客户组 / 客户级字段立为资产根节点;用户确认两级行业树与混搭 UI(行业 B / 客户列表 A / 详情 A / 新建 B / 客户组 B / 字段 A)。

改动:
- 新增 ADR-002,行业改为两级树,客户挂末级行业;同步 PRD / 技术架构 / 开发计划。
- 新增 client 模块:industries / customers / customer-groups / customer-fields 接口、真实 PrismaCustomerDirectory、客户状态机与客户转交、客户组数据范围解析、跨客户 404。
- 新增迁移与幂等种子(电商/金融两级行业、2 客户、1 客户组、4 条字段)。
- 前端新增行业/客户/客户组/字段审批页面与路由、导航更名(客户管理 / 行业管理 / 客户组),复用现有 token。
- 补充 shared 契约单测、client 集成用例、A3 浏览器 e2e。

影响面:client 模块与 client 表、shared 契约、web 路由/导航、ScopeContext 数据范围、OpenAPI 与种子;A1 客户转交占位由 client 实现替换。
回滚:回滚本提交;数据库保留新增表或按报告执行 down SQL;CUSTOMER_DIRECTORY 可切回空集实现。
验证:format:check / lint / typecheck / test 全绿(shared 131 / api 90 / web 125,共 346);test:int 5 文件 39 条;A3 e2e 1/1;build 8/8;真实浏览器六页验证通过。
2026-11-03 21:45:38 +08:00

1207 lines
96 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 灵犀 · 信息流广告素材一站式生产平台 PRD
| **项** | **内容** |
| --- | --- |
| 文档版本 | V1.6(图片线改为 PSD 模板套版 + 抠图合成) |
| 文档状态 | 待评审 |
| 基线文档 | `docs/PRD/灵犀_信息流素材生产平台_PRD_V0.3.md`(同事最新版) |
| 关联文档 | `docs/立项建议/灵犀_信息流素材生产平台_立项建议书_V0.1.md`(论证与决策依据,本文只保留结论) |
| 适用对象 | 产品、设计、研发、测试、业务方(运营 / 设计 / 文案 / 客户负责人) |
| 修订说明 | V1.0 在 PRD V0.2 基础上重排模块结构、补齐平台管理、精简表述;V1.1 增加多行业支持(行业包、要素卡表单设计器、行业合规规则集、客户级字段扩展),范围调整为电商 + 金融;V1.2 角色模型改为仅内置超级管理员、其余角色可配置(权限点 + 数据范围 + 特殊权限 + 职责互斥校验);V1.3 合入同事 PRD V0.3(行业=客户业务属性、行业/客户信息自定义填写、视频方向、视频在线预览与通用字符命名下载),按本文结构归并为「资产生产入口 + 视频线参数 + 信息模块」;V1.4 吸收参考项目「爆量魔方」已验证的脚本生产链路(脚本编号、结构化解析与模板库、行业指南与提示词配置、模型四层配置、客户在线审核、交付包、效果权重反哺),并明确图片抹版生产无先例、按自研设计;V1.5 吸收 baoliangmofang(爆量魔方重写版)可复用的素材/成片管理链路(素材为主对象与规格为属性、分片直传与秒传、送审与外部提审登记、脚本-素材血缘与关联率、效果回流与爆量阈值同源、分享链接安全口径)、对象存储上传链路与 pgvector 方案,并补充远期 AI 素材生产路线(M5 预研);同时如实记录:**两个参考仓库都没有图片出图 / 套版渲染的实现**,图片线仍按自研设计。V1.6 依据素材工坊(sucaigongfang)已上线的实测实现,把图片线从「AI 生成」改写为**确定性流水线**:PSD 模板 + 图层命名约定 + 自动抠图 + 多规格合成 + 批次命名快照;AI 文生图 / 图生图降为 M5 远期预研。不包含技术架构 |
> **怎么读这份文档**:第 1 章一页看懂全局;第 2–4 章是背景、角色与流程;第 5 章是功能需求主体,按"脚本 → 素材 → 资产 → 平台管理 → 导出"顺序;第 6 章是跨模块业务规则;第 7–10 章是范围、指标、合规与待确认;附录是差异说明与设计取舍。
---
## 1 一页看懂
### 1.1 产品是什么
**灵犀是一个面向信息流广告投放的素材生产平台**:把客户与被投放对象(商品、门店、金融产品等)的关键信息,稳定地变成可投放的图片和视频素材——图片走**确定性批量流水线**(PSD 模板套版 + 自动抠图 + 多规格合成),视频走 **AI 生成**(逐镜图生视频),并把过程中沉淀的模板、提示词、Logo、人物场景、合规规则等变成可复用资产。
它替代的不是"设计软件",而是**「微信里催需求 + 网盘里找素材 + 五六个 AI 工具之间来回倒」**这套现状流程。
**多行业怎么支持**:平台内核(生成、资产、权限、导出、审计)不分行业;行业差异收敛为可配置的**行业包**——一个行业包定义"要填哪些字段、用什么卖点体系、需要什么素材输入、遵守什么合规规则、脚本怎么排"。本期交付**电商(服饰为主)**与**金融**两个行业包,第三个行业只换配置。
**行业 = 客户所属的业务属性**(电商、金融等),是资产划分的一级目录;客户是二级目录,必须归属一个行业、不可跨行业移动。全部资产与生产任务都挂在这两级目录下(见 5.4.2)。
### 1.2 解决什么问题
| **现状** | **平台要达成的结果** |
| --- | --- |
| 一条素材从需求到可投要按天排期,赶不上投放窗口 | 常见素材需求当天出批,交付周期缩短一半以上 |
| 素材产能依赖少数几个熟手,人一忙就断供 | 批量生产,人均周产出翻倍,新人也能产出可用素材 |
| 每条素材都从零做,同品类换客户不继承经验 | 资产复用:新客户套用行业资产包,冷启动从"从零"到"一天" |
| 脚本、模板、成片散落在个人设备与网盘 | 全部入库可检索,人走资产在 |
| 多人多客户协作无权限边界、无操作留痕 | 客户级数据隔离 + 角色权限 + 全量审计 |
| AI 调用费用不可见、不可控 | 任务级成本可见,批量任务提交前预估成本 |
| 每接一个行业就要重写一套表单与流程 | 换行业只换行业包配置,内核不动 |
### 1.3 谁在用
运营(发起生产)、设计(资产与质量)、文案(脚本)、审核(合规)、AI 工程(模型与提示词)、主管(看产能与成本)、平台管理员(账号权限)。系统只内置「超级管理员」一个角色,其余角色由管理员自行配置(见第 3 章)。**客户不登录系统**,素材由运营代为交付。
### 1.4 核心链路(五步)
```
① 建行业 / 客户信息、选行业包并套客户资产包 → ② 生成脚本 → ③ 生成素材 → ④ 快筛勾选 → ⑤ 导出并归档
```
每一步的产出都是下一步的输入,且**都落资产**:脚本入库后供视频线选用;成片导出后自动归档,可被复用。
### 1.5 本期做什么 / 不做什么
| **本期做** | **本期不做** |
| --- | --- |
| 要素卡与卖点库(按行业包配置) | 通用视频剪辑器(时间线、调色、转场、逐帧精修) |
| 脚本生成、审核、入库 | 投放执行(账户搭建、计划复制) |
| 图片批量生产与规格矩阵 | 素材效果归因(只采集标签,不承诺归因) |
| 图片线:PSD 模板套版、自动抠图、多规格合成、ZIP 批量下载 | 图片线:AI 文生图 / 图生图(列入 M5 远期预研) |
| 视频逐镜生成与批量变体 | 客户自助登录与协作 |
| 资产库与复用度量 | 计费、结算、发票 |
| 平台管理:用户 / 客户 / 权限 / AI 配置 / 数据字典 / 审计 | 模型训练与微调(先接 API) |
| 行业包(电商 / 金融)与要素卡表单设计器 | 通用低代码平台(不做页面、流程、审批引擎) |
| 客户字段:基础字段 ≤ 10 个自由填,进入生成字段 ≤ 5 个需审批 | 客户自定义页面与复杂公式计算 |
---
## 2 背景与目标
### 2.1 业务背景
- **素材是投放的燃料**:客户按投放消耗产生价值,素材供给能力直接决定可承接的客户数与消耗上限。单条信息流素材的跑量周期通常只有数天,必须持续新增。
- **客户集中在服饰电商**(如得物、唯品会):SKU 多、上新快、卖点同质,竞争点在"素材数量 × 迭代速度"。
- **生成成本已大幅下降**:AI 把单条素材从"人天级"拉到"人时级"。瓶颈从"做不出来"变成"管不过来"。
- **生成工具不稀缺**:平台方工具(如巨量「即创」、腾讯「妙思」)已把脚本、出图、出片做到近乎免费,单纯"会用 AI"不构成优势。
- **业务不止一个行业**:客户目前以服饰电商为主(得物、唯品会),同时承接金融类客户(信贷 / 保险 / 理财)。两类客户的差距不在"AI 能力",而在**要素字段、素材形态、合规约束**:电商是"商品图 + 达人展示",金融是"产品要素 + 资质 + 风险提示 + 情景剧 / 口播",且金融素材的过审门槛远高于电商。若按单一行业硬编码,每接一个新行业就要重写一遍表单与规则。
> 结论:平台的价值不在"调用模型",而在**批量编排 + 私有资产 + 客户数据治理 + 行业可配置**四层。其中"行业可配置"决定能否低成本承接第二、第三个行业,因此不作为"以后再说"的增强项。
### 2.2 现状痛点
| **编号** | **环节** | **问题** | **影响** |
| --- | --- | --- | --- |
| PT-01 | 成本 | 单条素材制作成本高,只能少做、做简 | 可投素材不足,测试计划铺不满 |
| PT-02 | 产能 | 产能集中在少数人,急单靠拼凑 | 交付周期被排期锁死,错过投放窗口 |
| PT-03 | 质量 | 构图、信息层级、警示语不规范 | 提审被拒、返工,进一步挤占产能 |
| PT-04 | 冷启动 | 新客户每次从头积累,同品类经验不继承 | 人效随客户数线性下降 |
| PT-05 | 沉淀 | 脚本、模板、Logo 散落个人设备 | 人一走经验断档 |
| PT-06 | 治理 | 无账号权限与操作留痕,AI 成本不可见 | 客户素材有泄露风险,成本无法核算 |
| PT-07 | 工具链 | 脚本、出图、出片、存资产分散在多个工具 | 同一素材找不到"上一版",换工具就重做 |
| PT-08 | 基础数据 | 行业与客户信息靠口头约定,多处重复录入、口径不一致 | 资产归属混乱,跨行业无法隔离,复用找不到入口 |
### 2.3 目标
**业务目标**:在不降低过审率的前提下,把素材的"交付周期、单条成本、人均产能"改善到能支撑客户数增长的水平,并让经验沉淀为可复用资产。
**北极星指标**:人均每周产出的**可投素材数**(视频按条、图片按套加权),约束条件为一次过审率不下降、单条综合成本不上升。
**成功指标**(详见第 8 章):
| **指标** | **基线** | **目标** |
| --- | --- | --- |
| 需求交付周期 | 【待补】 | 缩短 50% 以上 |
| 人均周产出可投素材 | 【待补】 | 提升 2 倍以上 |
| 素材一次过审率 | 【待补】 | 不低于基线 |
| 单条综合成本 | 【待补】 | 下降 50% 以上 |
| 资产复用率 | 0 | ≥ 60% |
| 目标用户周活率 | 0 | ≥ 80%(上线 3 个月后) |
| 新行业上线周期 | 无 | 从行业包建档到首支可投素材 ≤ 5 个工作日(不含资产冷启动) |
### 2.4 分期
| **阶段** | **一句话目标** |
| --- | --- |
| M0 地基 | 能装人、能装客户、能装资产、能装行业(权限 / 客户 / 字典 / 资产模型 / 行业包与表单) |
| M1 主链路 | 一个真实客户完整走通"要素卡 → 脚本 → 图片 → 导出" |
| M2 提效 | 视频逐镜生成 + 批量变体 + 快筛 + AI 配置 |
| M3 复用 | 行业资产包 + 复用度量 + 效果标签 + 混合实拍 + 成片入库与送审登记 |
| M4 交付闭环 | 投放登记与效果回流:素材日指标、爆量判定、脚本权重反哺 |
| M5 远期(预研) | 自动字幕 → TTS 配音 → FFmpeg 时间线剪辑 → 一键成片 → 数字人 / 生成式画面 |
---
## 3 用户与角色
**系统只内置一个角色:超级管理员;其余角色全部由管理员自行配置。** 角色不是写死的岗位,而是「权限点组合 + 数据范围 + 特殊权限」的配置结果(见 5.4.3)。
| **角色** | **是否内置** | **说明** |
| --- | --- | --- |
| 超级管理员 | 是,唯一 | 拥有全部功能权限、全部数据范围与全部特殊权限;不可删除、不可修改权限、不可停用;账号数量受控(建议 ≤ 2 人) |
| 其他角色 | 否,全部可配置 | 管理员按需新建 / 复制 / 停用;权限点与数据范围可随时调整,变更即时生效并留痕 |
**岗位画像(配置角色时的参考,不是系统内置角色)**:
| **岗位** | **典型使用者** | **配角色时通常需要什么** |
| --- | --- | --- |
| 客户负责人 / 主管 | 团队负责人 | 看产能与成本、分配客户、审批跨客户复用;数据范围为本部门 |
| 投放运营 | 客户执行 | 要素卡、发起生成、快筛、导出;数据范围为负责客户 |
| 素材设计 | 设计 | 资产维护(模板 / Logo / 位置 / 人物场景)、图片与视频生成 |
| 脚本文案 | 文案 | 脚本模板与卖点、生成脚本(若与审核分离,不授予审核权限) |
| 审核 / 合规 | 审核 | 脚本与素材审核、警示语核对、审计只读 |
| AI 工程 | 研发 / 算法 | 模型接入与提示词配置、行业包编辑(不含发布) |
| 行业配置管理员 | 管理员或 AI 工程兼任 | 行业包与表单配置、合规规则集编辑(不含发布) |
**权限原则**:功能权限(权限点)按角色给,**数据权限按客户 / 客户组 / 部门给**;导出、AI 配置、审计、行业包发布、跨客户复用授权必须**单独授予**,不随角色复制默认带入;系统不做角色继承与嵌套(详见 5.4.3)。
---
## 4 整体业务流程
```mermaid
flowchart LR
A["① 行业 / 客户信息与资产准备<br/>行业 → 客户 · 行业包 · 资产包 · Logo / 警示语 / 模板 / 视频方向"] --> B["② 脚本<br/>要素卡 → 模板生成 → 质量校核 → 审核 → 入库"]
B --> C["③ 素材<br/>图片:批量合成<br/>视频:逐镜生成 · 多变体"]
C --> D["④ 快筛勾选<br/>按组并排 · 保留 / 淘汰"]
D --> E["⑤ 导出与归档<br/>本地目录 · 交付清单 · 成片入库"]
E -.-> F["资产复用<br/>下次生产直接选用"]
F -.-> B
F -.-> C
```
**四个关键交接点**(也是系统里最容易断的地方):
1. **行业 / 客户信息 → 行业包 → 资产**:行业(客户的业务属性)与客户是全平台的根节点,先有「行业 → 客户」两级目录,资产与生产任务才有归属。新客户第一步是在信息模块建档并选行业包、套用行业资产包(换 Logo 与警示语)。行业包决定"要素卡长什么样、能生成什么、要校核什么",没有行业包就没有可用字段,也没有可用合规规则。
2. **脚本入库 → 视频线**:视频只消费"已入库脚本",脚本必须拆到分镜级,否则视频只能整条抽卡。
3. **快筛 → 导出**:只导出勾选项;未勾选的不进入交付,也不算成本口径里的"可投"。
4. **导出 → 归档**:成片自动进入资产库,供二次加工与检索。
---
## 5 功能需求
> 优先级定义:**P0** = 首个可用版本必须有,缺了主链路不成立;**P1** = 提效与治理必需,首个版本后可排;**P2** = 增强,按资源安排。
### 5.1 脚本模块
**目标**:把要素卡里的信息批量变成"可生成、可拍摄"的**分镜级脚本**,而不是一段文案。
#### 5.1.1 输入:要素卡与卖点库
**要素卡**是"被投放对象"的结构化描述,替代原 PRD 的"产品信息(富文本)",解决三个问题:可批量、可校验(AI 编造时有据可查)、可复用。
**要素卡不是固定表单**:字段由客户所属**行业包**的 schema 渲染(配置方式见 5.4.8)。同一套页面,电商客户看到"款号、白底图、模特图",金融客户看到"产品类型、期限、费率 / 利率、风险等级、资质编号、风险提示语"。换行业包 = 换字段与校验规则,内核不改。
字段分四组(示例,实际以行业包为准):
| **组** | **电商(服饰为主)示例字段** | **金融(信贷 / 保险 / 理财)示例字段** |
| --- | --- | --- |
| 标的识别 | 商品名、款号、品类、品牌 | 产品名称、产品类型、期限、起投 / 额度区间 |
| 卖点与证据 | 材质、工艺、版型、上身效果、价格 | 费率 / 利率、优惠活动、保障范围、历史业绩(须合规表述) |
| 受众与场景 | 目标人群(年龄 / 风格 / 体型)、使用场景(通勤 / 约会…) | 适用人群、准入条件、使用场景(应急 / 装修 / 教育…) |
| 素材与合规 | 白底图、细节图、模特图、禁用表述 | 资质编号、风险等级、**强制风险提示文本**、禁用表述 |
字段按用途分三类属性(由行业包声明,不是全部可填):
- **必填且必须进入生成**:缺了不能生成(电商白底图、金融风险提示文本)。
- **选填但参与校核**:不填可生成,填了会被检查(价格、业绩表述)。
- **仅用于检索 / 报表**:不进提示词(内部 SKU 编码、合作机构编号)。
**卖点库**:标签体系由行业包定义——电商是 `材质 / 版型 / 功能 / 情绪 / 场景 / 价格`,金融是 `门槛 / 收益(合规表述)/ 灵活性 / 保障 / 期限 / 场景`。分行业级(公共复用)与客户级(私有),客户可追加标签。
#### 5.1.2 生成
**脚本模板(结构化资产)**:模板 = 叙事结构 + 分镜槽位 + 钩子类型 + 时长档 + 变量槽 + 提示词片段。变量槽如 `{{标的}} {{卖点}} {{人群}} {{场景}} {{价格}}`,批量时自动填充;变量必须能在行业包中找到定义(见 R-14)。
| **生成参数** | **说明** |
| --- | --- |
| 行业 / 客户 | 必填,决定资产与权限范围;行业决定使用哪个行业包 |
| 脚本模板 + 钩子类型(可多选) | 钩子类型来自行业包:电商为提问 / 反差 / 价格 / 场景;金融为痛点 / 算账 / 对比 / 权威 / 案例 |
| 要素卡 | 必填,按客户行业包渲染;可用一份卡生成多条 |
| 时长档 | 15s / 30s / 60s,与字数联动校验 |
| 投放平台 | 抖音 / 快手 / 小红书 / 朋友圈 / 横版等 |
| 指定卖点、人物设定、语气风格 | 选填,用于定向变体 |
| 是否含口播 | 口播走 TTS + lip sync 链路 |
| 生成数量(直填数量) | 简单场景直接填条数,受单批上限约束 |
| 变体矩阵 | 多模板 × 多钩子 × 多卖点展开,测钩子 / 卖点时优先用矩阵,见下 |
| 输出结构 | 纯文案 / 分镜表(分镜表才可直接进视频线) |
| 时长字数换算 | 15s≈45 字 / 30s≈90 字 / 60s≈180 字 / 90s≈270 字(约 3 字 / 秒口播),未命中时长档按 ×3 估算并提示 |
| 参考脚本数量 | 1–10 条(可手动指定);默认由系统按相似度自动检索,见下文「生成上下文」 |
| 创意程度 | 低 / 中 / 高,映射到模型温度(约 0.3 / 0.7 / 0.9)与提示词约束强度 |
| 品牌事实来源 | 要素卡 / 人工事实库 / 联网搜索;开启联网按次计费并留痕(见 Q-23) |
| 候选数量 | 默认 3,上限 5(管理员可配);生成后可「选中提交」或「全部存草稿」 |
**批量与变体矩阵**:
- 两种批量方式并存:直接填数量(快、简单)与变体矩阵(可控、可 A/B);**需要测钩子 / 卖点时用矩阵**。
- 矩阵不是"填 20 条",而是"选 2 个模板 × 3 个钩子 × 2 个卖点 = 展开 12 条,勾选 8 条生成"。
- 单批上限建议 ≤ 50 条(【待确认】);提交前显示"预计条数 × 预计耗时 × 预估成本"。
- 生成后做相似度检测,标记"与 #3 高度相似"的重复项,避免人工筛选成本反升。
- 异步任务,逐条返回,单条失败可重试。
**生成上下文的组装顺序**(吸收参考平台已验证做法,提示词不散落在代码里):
1. **系统提示词**:角色与输出契约(JSON schema)+ 5 条硬约束(不编造、时长内可念完、结构完整、合规表述、只输出 JSON);由 `ai_config.prompt_generate` 整段可覆盖,代码只保留兜底常量(见 R-23)。
2. **行业指南**:按客户行业匹配(精确行业 → 二级回退一级 → default → 内置准则),system 末尾追加「【行业指南 · {行业}】」;行业指南属行业包配置项,≤ 20000 字(见 5.4.7)。
3. **生成条件**:产品 / 平台 / 脚本方向 / 人群 / 卖点 / 基调 / 结构模板 / 时长 / 风格 / 附加要求,逐行拼装,便于排查「为什么生成成这样」。
4. **品牌事实**:启用联网搜索时先取事实摘要(失败降级不阻断),与要素卡字段一起进入上下文并落库留痕。
5. **参考脚本(RAG)**:三级降级检索——L1 全文索引,L2 多维筛选(行业 / 客户 / 方向 / 卖点 / 时长)打分,L3 同客户近期过审脚本兜底;参考正文每条截断 1500 字、最多 10 条,缓存 5 分钟;给参考脚本编号,要求模型回填「引用了哪几条」,用于溯源与效果反哺(见 R-24)。
> 不引入向量库:当前脚本量级(万级)下全文索引 + 结构化筛选已够,向量检索留到 M3 评估(见技术架构第 8 章决策)。
#### 5.1.3 质量校核
| **检查项** | **规则** | **处置** |
| --- | --- | --- |
| 事实一致性 | 不得出现要素卡之外的功能、材质、价格、销量、收益 | 拦截并标红 |
| 极限词 / 违禁词 | 通用词库 + 行业词库 + 平台规则 | 高亮,可配"警告 / 阻止" |
| 违禁词硬校验 | 行业违禁词库 + 客户禁用词(独立于通用极限词),命中位置逐处高亮 | 拦截并给出改写建议 |
| 结构完整 | 前 3 秒有钩子;结尾有行动引导或品牌露出 | 警告 |
| 时长匹配 | 字数 ÷ 语速(约 4–5 字/秒)与时长档偏差 > 20% | 警告并给建议字数 |
| 字幕长度 | 单行不超过约定字数 | 警告 |
| 卖点覆盖 | 至少覆盖 1 个核心卖点且与要素卡一致 | 警告 |
| 重复度 | 与本批次其他脚本相似度超阈值 | 标记建议淘汰 |
**行业附加规则**:除上述通用 7 项外,行业包可追加校核项(如金融的"必须出现风险提示""不得承诺收益""费率表述口径一致")。追加规则同样分"拦截 / 警告"两级,由行业配置管理员维护。
#### 5.1.4 审核与入库
- 列表 + 详情并排;敏感词高亮;支持单条通过 / 驳回 / 局部重写 / 整条重生成;支持批量通过。
- 审核关注四件事:卖点真实、合规、可拍性、时长够不够念完。
- 入库后带标签(行业 / 客户 / 品类 / 钩子 / 卖点 / 时长 / 平台),进入"已入库脚本"池。
- **已入库脚本被修改时生成新版本并重新审核**,避免"审过的和用着的不是一回事"。
- **脚本编号**:过审入库时按 `客户编码-YYMMDD+当日序号` 原子分配(如 `K12-26081901`),草稿不占号,并发不重号;编号是后续图片 / 视频任务与交付清单的匹配 key(见 R-21)。
- **客户在线审核(P1,可选)**:可生成免登录审核链接(有效期 7 / 14 / 30 / 90 天,二维码分享),客户在链接内看稿、批注、改稿或驳回,**改稿保留原稿快照**(见 R-22);不改变"客户不登录系统"的默认形态,只是把线下传稿换成受控链接(见 Q-22)。
- **交付包**:审核通过后可一键导出 Word 交付包(编号 + 标题 + 分镜表),或推送飞书(P2);交付记录可回查(见 E-07)。
#### 5.1.5 脚本状态
| **状态** | **含义** | **可执行动作** |
| --- | --- | --- |
| 草稿 | 参数已填未提交 | 编辑 / 删除 |
| 生成中 | 任务执行中 | 取消 |
| 待审核 | 生成完成(内部审核) | 通过 / 驳回 / 重生成 |
| 客户审核中 | 已推送客户审核链接 | 撤回 / 查看客户反馈 |
| 客户改稿 | 客户在链接内修改了内容 | 确认采纳 / 驳回(采纳后按新版本入库) |
| 客户驳回 | 客户明确不通过 | 按意见重生成 / 归档 |
| 已入库 | 可被视频线选用 | 发起视频制作 / 停用 |
| 使用中 | 已被素材任务引用 | 查看引用 / 停用 |
| 已停用 | 不再建议使用 | 恢复 |
| 失败 | 生成异常 | 重试 / 看原因 |
#### 5.1.6 功能清单
| **编号** | **功能** | **说明** | **优先级** |
| --- | --- | --- | --- |
| S-01 | 要素卡管理 | 新建 / 编辑 / 复制 / 停用;字段随行业包渲染;按客户与品类检索 | P0 |
| S-02 | 参考物料上传与白底图标记 | 白底图作为主体还原基准(是否必填由行业包声明) | P0 |
| S-03 | 卖点库管理 | 行业级 / 客户级,标签化,使用次数统计 | P1 |
| S-04 | 脚本模板管理 | 新建 / 编辑 / 版本 / 启停 | P0 |
| S-05 | 脚本批量生成 | 参数 + 模板 + 要素卡,异步任务 | P0 |
| S-06 | 变体矩阵展开 | 多模板 × 多钩子 × 多卖点,提交前预估 | P1 |
| S-07 | 自动质量校核 | 7 项检查,拦截 / 警告分级 | P0(基础四类)/ P1(重复度、卖点覆盖) |
| S-08 | 脚本审核 | 单条与批量,局部重写 | P0 |
| S-09 | 脚本入库与标签 | 标签化,检索 | P0 |
| S-10 | 脚本版本管理 | 已入库脚本修改须新版本 | P1 |
| S-11 | 脚本引用记录 | 被哪些素材任务引用 | P1 |
| S-12 | 脚本效果标签 | 起量 / 一般 / 未起量(人工标注) | P2 |
| S-13 | 脚本编号与序号分配 | 过审时原子取号,编号唯一、不重用 | P1 |
| S-14 | 结构化解析与自动打标 | 模型输出解析为分镜 / 标签,失败留原文可重试 | P0(基础)/ P1(自动打标) |
| S-15 | 结构模板库 | 人工创建 + AI 从过审脚本挖掘,发布 / 驳回 / 使用计数 | P1 |
| S-16 | 客户在线审核链接 | 免登录、有效期、改稿快照、二维码分享 | P1 |
| S-17 | 脚本交付包(Word / 飞书) | 编号 + 标题 + 分镜表;交付记录可查 | P1(Word)/ P2(飞书) |
| S-18 | 脚本版本对比与回滚 | 任一历史版本可 diff、可回滚 | P2 |
#### 5.1.7 结构化解析、模板库与效果反哺
- **结构化解析**:模型只输出 JSON,落库前做 schema 校验;字段固定为 `方向 / 钩子 / 分镜数组(名称、起止秒、画面描述)/ 卖点 / 语气 / 风格 / 人群 / 标签`。解析失败先重试 1 次,仍失败则保留原文并标记「待人工处理」,不静默丢稿。
- **自动打标**:平台 / 方向 / 钩子 / 卖点 / 人群 / 情绪 六类标签自动生成,人工可在详情页校正;标签是检索与 RAG 的索引基础。
- **模板库**:结构模板有两个来源——人工新建、AI 从高表现脚本中挖掘;挖掘产物进入「待审核」,人工发布后才可被生成引用,并统计使用次数与平均保留率(见 S-15)。
- **效果反哺**:素材线回传的保留 / 起量评价形成脚本权重(保留率高 → 权重高),RAG 检索按权重降序加权,让「好脚本」优先被参考(与 5.3.5 复用度量打通,P2)。
### 5.2 素材模块
**目标**:两条批量生产线(图片、视频),衡量标准只有一个——**每小时能产出多少条可投素材**。
#### 5.2.1 图片生产线
**输入**:客户 / 行业(决定行业包与可用模板)、**PSD 模板**(设计师上传,带命名图层)、**商品图与字段值**(一批多对象,含商品 ID / 名称 / 品牌)、展示方式(由行业包定义,可不指定让模板按默认位合成)、Logo、产品位置、警示语、**规格矩阵**、**输出参数**(是否抠图、尺寸与大小限制、JPG/PNG、质量、缩放模式、字号)、批次备注。
**流程**:
1. **设计师上传 PSD 模板**:解析图层、生成预览、登记可替换图层(无命名图层不放行,见下)
2. 选客户与行业 → 自动带出该客户资产包
3. 选模板(可多选)+ 选规格矩阵(可多平台)
4. **批量上传商品图**:文件名解析商品 ID / 名称 / 品牌,支持一份表格补齐字段;可逐条编辑
5. 设置输出参数(是否抠图、大小限制、格式与质量、缩放模式、字号)
6. 提交批次(异步,显示"共 N 张 × 预计耗时";可暂停 / 取消 / 单项重试)
7. **网格预览 + 按组快筛 + 勾选**(抠图失败降级为原图的条目自动标「低质量」,默认不勾选)
8. 导出 ZIP / 入库(命名按客户级规则并快照,导出即归档)
**规格矩阵**(做成可配置的数据字典,不写死):
| **位置** | **比例** | **建议尺寸** | **注意** |
| --- | --- | --- | --- |
| 抖音 / 快手竖版 | 9:16 | 1080 × 1920 | 右侧与底部 UI 遮挡 |
| 小红书竖版 | 3:4 | 1080 × 1440 | 顶部标题区 |
| 朋友圈 | 1:1 或 4:5 | 1080 × 1080 / 1350 | — |
| 横版信息流 | 16:9 | 1920 × 1080 | — |
| 电商主图 | 1:1 | 800 / 1200 方图 | 白底要求 |
(具体平台清单与尺寸【待确认】,由投放运营提供。)
**模板:PSD 与图层命名约定**(图片线的核心资产约定)
| **图层名前缀** | **语义** | **替换内容** | **约束** |
| --- | --- | --- | --- |
| `image_replacement_` | 商品图位 | 抠图后的商品图(或降级原图) | 按位缩放与裁切,主体不变形 |
| `clipping_mask_` | 剪贴蒙版容器 | 上层图片被裁进该形状(圆形 / 圆角矩形 / 文字轮廓) | 与上层成对出现;形状由设计决定 |
| `text_replacement_` | 文字位 | 字段值(名称 / 卖点 / 价格 / 警示语) | 字号、对齐、颜色继承 PSD;字体须在平台字体库登记 |
- **上传即解析**:`ag-psd` 读出图层,按前缀登记可替换层;**解析失败或没有任何命名图层 → 模板不入库**。
- 模板与规格绑定:模板声明画布尺寸与横竖版,规格矩阵据此筛出可用组合。
- 版本化:模板改版生成新版本并保留快照,历史批次不回溯重渲染。
**抠图与合成参数**
| **项** | **默认** | **说明** |
| --- | --- | --- |
| 自动抠图 | 开 | 本地 ONNX 模型(`@imgly/background-removal-node`)CPU 推理,图片不出内网 |
| 抠图失败降级 | 原图 + 标「低质量」 | 绝不静默通过;失败条目进「低质量」筛选,默认不勾选 |
| 输出格式 | JPG / PNG | JPG 质量可配;PNG 用**调色板色数**控体积(`sharp` 的 quality 对 PNG 无效) |
| 尺寸限制 | 客户级配置 | 上限 KB / MB,超限自动降质量并记录 |
| 缩放模式 | 等比裁切 / contain | 主体不变形优先 |
| 字体 | 镜像内置中文字体 | 缺字体 → 豆腐块静默错误,启动自检拦截 |
| 并发 | 素材队列 2(可调) | CPU 密集(解析 / 推理 / 合成),按实测内存与核数取小值 |
**批量任务、命名与历史**
| **对象** | **说明** |
| --- | --- |
| 批次 | 批次号 `{YYMMDD}{3 位当日序号}`(原子取号),记录总数 / 成功 / 失败 / 耗时 / 输出参数快照 / 命名快照 |
| 任务项 | 按「模板 × 商品图 × 规格」展开;状态 排队 / 处理中 / 完成 / 失败,失败带原因;重试 3 次仍失败才判失败 |
| 命名 | 客户级可配置(整名模板 + 字段池);未配置回落默认规则;**批次创建时快照**,改规则不影响历史批次 |
| 历史 | 按批次 / 客户 / 模板 / 状态检索;支持「重新生成」(复用同一批输入再跑一次) |
| 交付 | ZIP 流式打包(压缩级别 9,CPU 密集),产物限时保留(默认 3 天) |
> **为什么不走 AI 生成图片**:广告图要求商品、Logo、文案、警示语逐字准确且需过审,生成式方案在「主体还原、文字正确、合规可控」三项上都不可控;图片线用确定性合成把这三项变成可校验的工程问题。AI 生图仅作为 **M5 远期预研**(见第 10 章 Q-32),不进入本期范围。
**质量与合规校验**:
| **检查项** | **要求** |
| --- | --- |
| 安全区 | 文字与 Logo 不进入平台 UI 遮挡区 |
| Logo 完整性 | 不裁切、不遮挡、对比度足够 |
| 主体不变形 | 主体区域锁定比例,不做非等比拉伸(电商锁定商品区) |
| 警示语 | 内容、位置、字号、对比度四项校验 |
| 模板图层语义 | **模板必须带命名图层**(背景 / 商品位 / 文字位 / Logo 位 / 警示语位),否则不予入库 |
**行业附加校验**:行业包可追加检查项(如金融"风险提示字号不得小于正文""禁用收益率承诺表述"),与通用校验同表展示、分级处理。
**性能**:单张合成 ≤ 10s;预览 ≥ 50 张不卡;批量任务异步、进度可见、**中断可恢复**(100 张跑到第 87 张失败不必从头再来)。
#### 5.2.2 视频生产线
**输入**:已入库脚本、**视频方向(必选)**、要素卡与参考物料、人物设定(人物池,行业包可选)、场景(场景池)、景别与节奏、Logo、警示语、平台 / 时长 / **生成数量**、是否口播、BGM、光影与色调。
**素材形态由行业包声明**:电商是"达人到店 / 上身展示",金融是"情景剧 / 口播 / 信息图动效"。不需要人物池的行业可在行业包中关闭人物与场景槽位,视频线自动降级为"图文动效 + 字幕"链路。
**视频方向与脚本方向的分工**(二者并列、不合并):脚本方向决定"说什么"(钩子与叙事结构),视频方向决定"怎么呈现"(口播 / 剧情 / 产品展示 / 达人到店等画面组织方式)。视频方向是独立资产,候选集由行业包声明,运营在视频制作时必选(见 5.3.1)。
**生成、在线预览与命名下载**(基础交互,P0;逐镜生成是其内部实现):
1. 提交生成(异步,显示"共 N 条 × 预计耗时 × 预估成本"),逐条返回,单条失败可重试。
2. 完成后进入**在线预览**:逐条播放,支持播放 / 暂停 / 重播与断点续播;每条标注来源脚本与视频方向。
3. 支持单条勾选、全选、反选;**只有勾选项可进入命名与下载**;未勾选的结果保留在任务记录中,可稍后再选。
4. 统一命名或逐条命名(实时校验字符与长度)→ 下载到本地或导出到指定文件夹。
| **项** | **通用字符命名规则** |
| --- | --- |
| 允许字符 | 中文、英文字母、数字、下划线 `_`、短横线 `-` |
| 禁止字符 | 空格与系统保留字符(斜杠、反斜杠、冒号、星号、问号、引号、尖括号、竖线) |
| 占位符 | `{行业}` `{客户}` `{视频方向}` `{日期}` `{序号}`,也可直接输入固定文本 |
| 默认规则 | `{行业}-{客户}-{视频方向}-{序号}`,下载前可改 |
| 长度 | ≤ 100 字符 |
| 冲突处理 | 同名自动追加序号,不覆盖 |
**逐镜生成链路**(与"一条脚本一条片"的关键差别):
1. **分镜拆解**:脚本 → N 个镜头(场景 / 景别 / 时长 / 画面 / 台词)
2. **关键帧生成**(图生图):每镜生成首帧,参考物料在这一步锁定还原(电商=商品白底图)
3. **逐镜生成**(图生视频):每镜独立生成、独立重试
4. **口播合成**(如需):台词 → TTS → lip sync
5. **拼接与包装**:拼接、字幕、Logo、警示语、BGM
6. **成片校验**:时长、比例、黑帧、静音、字幕错字、合规
7. **快筛勾选**
> **成本设计原则**:任一镜不满意只重生成该镜,不重生成整条。整条重来是线性成本,单镜重来是常数成本。
**批量变体矩阵**:
| **轴** | **示例** | **用途** |
| --- | --- | --- |
| 脚本 | 3 条不同钩子 | 测钩子与结构 |
| 人物 | 人物 A / B / C | 测人物适配 |
| 场景 | 通勤 / 办公室 / 街拍 | 测场景代入 |
| 时长 | 15s / 30s | 测时长 |
- 建议选 2 个轴交叉(如 3 脚本 × 3 人物 = 9 条),不做全轴笛卡尔积。
- 提交前显示"预计条数 × 预计时长 × 预估成本",可设单批上限。
**快筛机制**(视频线的核心交互):
- AI 把候选从 5 条放大到 50 条,人的工作变成"3 分钟留下 5 条"。
- 按组并排播放、键盘快捷键(保留 / 淘汰 / 收藏)、"同组只留最佳"一键收敛。
- 淘汰理由可选(画面差 / 主体不对 / 台词怪 / 人物出戏),理由用于模型调优。
**一致性硬要求**:
| **要求** | **标准** |
| --- | --- |
| 主体还原 | 颜色、版型、细节严格按参考物料(电商按白底图),不得"生成相似款" |
| 人物一致 | 同一条视频跨镜头为同一人;不得照搬原模特 |
| 风格一致 | 光影与色调整条统一 |
| 文字准确 | 字幕与台词逐字一致,无错别字 |
| 音画同步 | 口播口型与台词对齐 |
**失败与成本**:
- 失败分类统计(审核拒绝 / 超时 / 参数非法 / 素材缺失 / 限流),用于选模型与排障。
- 失败不计入交付与计费;单镜可重试、可换模型重试。
- 单任务预算上限,超限提示;按客户 / 批次 / 模型统计成本。
**同质化控制**:保留 `实拍 / AI 生成 / 混合` 来源标签;预览时提示"与本客户近 30 天素材相似度高"。
#### 5.2.3 素材任务状态
| **状态** | **含义** |
| --- | --- |
| 排队 | 已提交,等待执行 |
| 生成中 | 图片合成中 / 视频逐镜生成中 |
| 待预览 | 产物就绪,等待快筛 |
| 已勾选 | 人工选中 |
| 已导出 | 已生成交付文件 |
| 已入库 | 已归档为资产 |
| 失败 | 存在失败项,可重试 |
#### 5.2.4 功能清单
| **编号** | **功能** | **优先级** |
| --- | --- | --- |
| M-01 | 图片批量合成(物料 × 模板) | P0 |
| M-02 | 规格矩阵与多平台出图 | P1 |
| M-03 | 图片网格预览与勾选 | P0 |
| M-04 | 图片质量与合规校验(安全区 / Logo / 变形 / 警示语) | P0(安全区、警示语)/ P1(其余) |
| M-05 | 批量任务进度、失败重试、中断恢复 | P0 |
| M-06 | 视频逐镜生成(分镜拆解 → 关键帧 → 图生视频 → 拼接) | P0(M2) |
| M-07 | 单镜替换与重生成 | P1 |
| M-08 | 视频批量变体矩阵 | P1 |
| M-09 | 视频快筛(分组并排、快捷键、同组收敛) | P1 |
| M-10 | 口播合成(TTS + lip sync) | P1(金融行业)/ P2(电商) |
| M-11 | 成片自动校验(时长 / 比例 / 黑帧 / 静音 / 字幕) | P1 |
| M-12 | 失败分类与成本预估、预算上限 | P1 |
| M-13 | 相似度提示与来源标签 | P2 |
| M-14 | 素材任务列表与检索 | P0 |
| M-15 | 视频方向选取(候选集由行业包声明) | P0(随 M2) |
| M-16 | 视频在线预览与逐条勾选(播放 / 断点续播 / 全选反选) | P0(随 M2) |
| M-17 | 成片命名(通用字符 + 占位符)与下载 / 导出双通道 | P0(随 M2) |
| M-18 | 成片批量上传(分片 / 断点续传 / hash 秒传 / 自动元数据) | P1(M2) |
| M-19 | 成片版本链与「采用版本」标记 | P1(M2) |
| M-20 | 素材库双视图与批量操作(zip 打包下载 / 批量改标签 / 批量送审) | P1(M2) |
| M-21 | 脚本-素材关联、血缘视图与「未关联」待办 | P1(M3) |
| M-22 | 素材分享链接(短时效 / 可作废 / 外部访问留痕) | P2(M3) |
| M-23 | 内部送审与外部平台提审登记(含驳回原因与截图凭证) | P1(M3) |
| M-24 | 投放登记与效果回流(日指标:消耗 / 曝光 / CTR / CVR / ROI) | P1(M3) |
| M-25 | 爆量判定与脚本参考权重反哺 | P2(M4) |
| M-26 | 素材关联率、复用排行与爆量榜看板 | P2(M4) |
| M-27 | 素材元素级拆解(钩子 / 卖点 / CTA 元素库) | P2(M5 预研) |
#### 5.2.5 成片管理、送审与效果回流(吸收 baoliangmofang)
> **为什么单列一节**:5.2.1–5.2.4 解决「怎么产出」,这一节解决「产出之后怎么管、怎么审、怎么用效果反哺」。参考项目(baoliangmofang / 爆量魔方重写版)在**素材管理侧**有可复用的设计,**但同样没有出图 / 套版渲染实现**——本节只吸收管理链路,渲染仍按 5.2.1 自研。
**1)素材模型口径:素材为主对象、规格为属性**
| **对象** | **识别** | **关键属性** |
| --- | --- | --- |
| 素材(Material) | `material_id` | 类型(图片 / 视频)、来源(平台生成 / 外部上传 / 实拍)、关联脚本(多对多)、所属制作任务、状态、采用版本 |
| 素材版本(Version) | `material_id` + `v1..vn` | 文件与缩略图、规格列表、校验结果、送审记录、是否采用 |
| 规格(Spec) | 规格码 | 平台、比例、分辨率、时长上限、命名后缀 |
- 9:16 / 1:1 / 4:3 是**同一素材的规格属性**,不各建一条素材;同源多规格共享内容指纹,只追加文件与差异参数,避免重复计费与重复审核。
- 素材与脚本是**多对多**:一条成片可对应多条脚本(混剪),一条脚本可产出多条成片(多变体)。关联必须建独立关联表,不得塞进 JSON 列——参考项目把脚本 ID 存 JSON 列后无法 join / 索引,本项目明确不照搬。
**2)外部成片入库(实拍 / 外部制作 / 历史素材)**
| **能力** | **要求** |
| --- | --- |
| 上传 | 分片 + 断点续传,后台上传不中断;单文件上限按对象存储策略(默认 2GB) |
| 秒传 | 前端算文件 hash → 预签名接口判重,命中直接引用已有对象,不重复占存储 |
| 自动元数据 | 时长、分辨率、码率、大小、首帧封面,入队异步提取,不阻塞上传 |
| 版本链 | 修改重传生成 v2 / v3,保留历史版本,可标记「采用版本」;送审基准取提交时刻的版本 |
| 降级 | 小文件(< 10MB)允许应用服务器代理上传,避免为小图接分片链路 |
**3)素材库与分享**
- 双视图:卡片视图(悬停静音预览)与表格视图(批量操作);筛选维度含客户、脚本编号、方向、状态、规格、时间。
- 批量操作:zip 打包下载(异步打包、产物限时保留,默认 3 天)、批量改标签、批量送审、登记投放。
- **分享链接安全口径**(P2,默认关闭):① HMAC-SHA256 签名 token,载荷含对象 ID 与过期时间,常量时间比较;② 短有效期(1–7 天)+ 可续期 + **可随时作废**;③ 按「IP + token」双维度限流;④ 全部外部访问写审计日志(IP / UA / 署名);⑤ 公开路由前缀与内部前缀彻底分离;⑥ 未评估公网可达性前不开放。
**4)状态机**
| **对象** | **状态流转** |
| --- | --- |
| 素材 | 上传中 → 待完善(缺元数据 / 缺关联)→ 待送审 → 送审中 → 已过审 / 已驳回;已过审 → 投放中 → 已下线;驳回后重传生成新版本并回到待送审 |
| 送审(统一抽象) | 待提交 → 送审中 → { 已通过 / 已驳回 / 已撤回(回待提交) };内部审核与外部平台提审共用同一批次对象,外部提审额外登记平台、提审时间、审核状态、驳回原因、截图凭证 |
**5)送审:内部审核 + 外部平台提审登记**
- 内部审核动作:通过 / 驳回(原因必填)/ 转交;审核基准 = 提交时冻结的版本,后续修改不影响本次结论。
- 外部提审只做**登记**(平台、时间、状态、驳回原因、凭证截图),平台 API 自动同步 P2;本系统不做投放账户对接。
- 一个「送审批次」可含多条素材;交付是批次的下游产物,不为交付另建一套并行批次——参考项目两套批次表并行导致对账困难,明确不照搬。
**6)脚本-素材关联与血缘**
- 关联总览:用(复用数 / 过审数 / 爆量数 / 累计消耗)四列排出「高效脚本榜」。
- 「未关联脚本的素材」进待办清单并计入关联率;允许先入库后匹配,但必须可见、可清理。
- 关联率 = 已关联素材 ÷ 全部素材,按客户与周统计;低于阈值提示补录。
**7)效果回流(M4)**
| **项** | **口径** |
| --- | --- |
| 投放登记 | 平台、账户、素材 ID / 计划 ID、起止时间;手工登记为主,平台 API 同步为 P2 |
| 日指标 | 消耗、曝光、点击、CTR、CVR、转化数、ROI,按「日 × 素材」落表,可累计 |
| 爆量判定 | 消耗达阈值且 ROI 达标即标记爆量;**阈值统一放系统配置,前端上限、DTO 校验、判定任务读同一处**,禁止在各处写常量 |
| 反哺 | 爆量素材回写脚本参考权重(评级 → 权重映射),RAG 召回按权重加权;派生指标(汇总 / 均值)不落库,查询时计算 |
**8)远期 AI 素材生产路线(M5 预研,不排期)**
建议顺序与理由:**自动字幕(ASR)→ TTS 配音 → FFmpeg 时间线剪辑 → 一键成片自动送审 → 数字人 / 生成式画面 → 素材元素级拆解**。前三项工程确定性高、成本低、见效快;数字人与文生图 / 图生视频受算力与版权约束,作为可选插槽,避免被卡住。素材元素级拆解把爆量成片拆成「钩子画面 / 卖点话术 / 结尾 CTA」进入元素库,是长期资产化的终局形态。
### 5.3 资产模块
**目标**:把"会被第二条素材复用"的东西全部资产化,做到可检索、可复用、可度量、有生命周期。
#### 5.3.1 资产分类
| **资产** | **作用** | **维护方** |
| --- | --- | --- |
| 行业包 | 一个行业的全套配置(字段、卖点体系、合规规则、模板、风格预设),可复制到新客户 | 行业配置管理员 |
| 脚本模板 | 脚本结构化载体 | 文案负责人 |
| 视频方向 | 视频"怎么呈现"的创意形式(口播 / 剧情 / 产品展示 / 达人到店),视频线必选参数;候选集由行业包声明 | 设计 / 运营 |
| 已入库脚本 | 视频线输入 | 文案 / 运营 |
| 图片模板 | 图片合成基础(需命名图层) | 设计 |
| Logo | 品牌露出(横 / 竖 / 白 / 黑多规格) | 客户负责人 |
| 产品位置 | 主体落位 | 设计 |
| 警示语 | 合规文案(按行业 / 平台 / 客户) | 审核 / 客户负责人 |
| 人物池 | 视频人物一致性 | 设计 + AI 工程 |
| 场景池 | 视频场景一致性 | 设计 + AI 工程 |
| 光影 / 色调预设 | 整条视频风格统一 | AI 工程 |
| BGM / 音效 | 视频氛围 | 设计 |
| 提示词模板 | 生成质量的核心 know-how(按行业包组织,可被客户覆盖) | AI 工程 |
| 要素卡模板 / 卖点库 | 脚本与素材的结构化输入(随行业包) | 运营 / 文案 / 行业配置管理员 |
| 成片 | 复用与二次加工 | 系统自动 |
> **提示词模板**是本项目最容易被低估的资产:它把"某个人会写 prompt"变成"平台会写 prompt"。若只能优先做一类新资产,选它。
#### 5.3.2 组织与继承
- 三级:**行业级(公共)→ 客户级(私有)→ 批次级(一次性)**。
- 客户级优先于行业级;同名时以客户级为准。
- 行业级变更不影响已被客户级覆盖的部分。
- **跨客户复用必须显式授权**并留痕(客户 A 的模板用于客户 B 属敏感操作)。
- 所有资产必须挂在「行业 → 客户」两级目录下;行业是客户的业务属性,客户不可跨行业移动(见 5.4.2)。
#### 5.3.3 生命周期
| **能力** | **规则** |
| --- | --- |
| 新建 / 上传 | 上传后进入"草稿",审核或校验通过后才"启用" |
| 版本 | 模板与提示词修改产生新版本;被引用时记录版本号 |
| 启用 / 停用 | 停用后不可被新任务选用,历史引用仍可预览 |
| 删除 | **未被引用的资产才可删除;已被引用的只能停用**(硬约束) |
| 复审 | 到期未复审自动降权;提示词月度、模板与人物场景季度、Logo 与警示语随客户变更 |
| 引用关系 | 任一资产可查"被哪些脚本 / 任务 / 成片引用",反向可查 |
#### 5.3.4 复用度量
- **复用率** = 使用了既有资产的产出 ÷ 总产出("既有"= 创建于本批次之前)。
- 资产库默认按"被复用次数 + 效果标签"排序,高频资产优先呈现。
- 停用资产仍被引用时,提示"需替换为 X",并阻止新任务选用。
#### 5.3.5 功能清单
| **编号** | **功能** | **优先级** |
| --- | --- | --- |
| A-01 | 资产库(按类型 / 行业 / 客户筛选) | P0 |
| A-02 | 资产上传与在线创建(模板、Logo、位置、警示语) | P0 |
| A-03 | 真实合成预览(非缩略图) | P0 |
| A-04 | 模板命名图层校验与准入 | P0 |
| A-05 | 资产排序 / 删减 / 启停 / 删除保护 | P0 |
| A-06 | 资产版本管理 | P1 |
| A-07 | 引用关系查看与失效替换 | P1 |
| A-08 | 人物池 / 场景池 / 光影 / BGM 管理 | P1 |
| A-09 | 提示词模板管理(版本、生效范围) | P1 |
| A-10 | 复用率与资产质量看板 | P2 |
| A-11 | 资产复审任务与降权 | P2 |
### 5.4 平台管理
**目标**:回答四个问题——谁能在什么范围内、对哪些数据、做什么操作,以及做完能不能查到。
#### 5.4.1 组织与账号
| **能力** | **规则** |
| --- | --- |
| 组织架构 | 部门 / 小组两级,不做无限层级 |
| 用户 | 内部账号,一人可多角色(可配置角色);不开放外部注册;客户不登录 |
| 角色 | 仅「超级管理员」内置且不可改,其余角色由管理员配置(见 5.4.3) |
| 登录 | 企业统一登录(SSO)或手机号验证(【待确认】) |
| 用户生命周期 | 入职创建 → 调岗调整 → 离职停用(**不删账号**),名下客户需转交 |
#### 5.4.2 客户管理
**行业与客户是资产划分的两级目录**:行业本身为两级树(一级行业 = 业务属性,如电商 / 金融;二级行业 = 细分分类,如服饰鞋包 / 信贷),客户挂末级行业。信息模块以「行业树 → 客户」上下级菜单呈现,是全部资产与生产任务的根节点。
最小集:客户名称 / 简称(**简称必填**,用于全部自动命名)、所属行业(绑定一个行业包,可申请客户级覆盖)、服务状态(在服务 / 暂停 / 结束)、内部负责人与客户侧对接人、交付偏好(命名习惯、目录结构、常用规格、素材禁忌)、客户资产包、自定义字段(分两层,见下)。
- **自定义字段分两层**:基础信息字段由运营录入时自由追加键值对(如门店编号、内部产品代码),每客户 ≤ 10 个,**只用于检索与报表,永不进入生成**;需要进入生成或参与校核的字段走 5.4.9 审批(≤ 5 个)。
- **唯一性**:一级行业名称全局唯一;二级行业名称在同一父级下唯一(不同一级行业下可重名);客户名称在同一末级行业下唯一。
- **不可跨行业移动**:客户必须归属一个末级行业,调整行业走「停用 + 新建」;删除行业前须校验其下无子行业、无客户、无资产,否则只能停用;有启用中的子行业时禁止停用。
- **新建客户时可套用行业资产包**:选行业 → 带出模板、场景、人物、提示词、卖点 → 替换为客户 Logo 与警示语。这是"新客户冷启动 ≤ 1 个工作日"的落地方式。
- **客户组**:把客户按行业 / 团队 / 服务等级分组;客户组是批量授权与数据范围的最小单位,避免逐个客户分配权限(见 5.4.3)。
- 客户暂停时只读,不能发起新生成;结束时全部只读,资产转"只读资产"。
- 不做合同、结算等 CRM 功能。
#### 5.4.3 角色与权限体系
**模型**:`用户 — 角色 — 权限点`(功能)+ **数据范围** + **特殊权限**。除超级管理员外,系统不硬编码任何角色;角色由管理员在「角色管理」中配置。
**一、内置角色:只有超级管理员**
| **项** | **规则** |
| --- | --- |
| 拥有权限 | 全部功能权限点 + 全部数据范围 + 全部特殊权限 |
| 不可变 | 不可删除、不可修改权限、不可停用;仅显示名可改 |
| 数量控制 | 建议 ≤ 2 人;授予超管须二次确认,并强制写入审计 |
| 用途 | 初始化平台、创建首个管理员角色、权限故障时兜底恢复;**日常业务操作不建议使用超管账号** |
**二、角色管理(管理员配置)**
| **能力** | **规则** |
| --- | --- |
| 新建角色 | 填名称与说明 → 勾选权限点 → 选数据范围 → 勾特殊权限;保存前自动做职责互斥校验 |
| 复制角色 | 以现有角色或示例模板为底稿快速创建,避免从零勾选 |
| 示例模板 | 提供 5–7 个起步模板(运营 / 设计 / 文案 / 审核 / AI 工程 / 行业配置 / 客户负责人),**均可改可删**,仅用于冷启动 |
| 停用 / 删除 | 停用即时生效(在线用户下次请求失效);删除前必须无在职用户绑定,否则只能停用 |
| 变更留痕 | 谁、何时、改了哪些权限点、影响多少用户,全部审计;受影响用户收到通知 |
| 数量建议 | 角色 ≤ 20 个,避免「一人一角色」导致权限不可治理 |
**三、权限点目录**(按模块 × 操作组织,配置角色时勾选)
| **模块** | **权限点** |
| --- | --- |
| 客户与组织 | 客户查看 / 新建 / 编辑 / 停用 / 转交;客户组管理;用户查看 |
| 行业包 | 查看;编辑(草稿);发布;导入导出 |
| 要素卡 | 查看;新建 / 编辑 / 复制;停用 |
| 脚本 | 模板查看 / 维护;生成;审核;入库 / 停用 |
| 素材 | 图片生成;视频生成;批量提交;预览与快筛;重生成 / 单镜替换 |
| 资产 | 查看;上传;编辑;启停;删除(受引用保护);版本回溯 |
| 平台管理 | 字典查看 / 编辑;AI 配置查看 / 编辑;模型额度;成本看板 |
| 导出与交付 | 发起导出;重导;交付清单;跨客户复用授权 |
| 报表与审计 | 生产 / 质量 / 成本 / 资产看板;审计查看 / 导出 |
**四、数据范围**(角色属性,决定「能看到哪些客户的数据」)
| **范围** | **含义** |
| --- | --- |
| 全部客户 | 所有客户(通常只给超管与行业负责人) |
| 本部门及下级 | 组织架构范围内 |
| 本部门 | 仅本部门 |
| 指定客户组 | 按客户组授权(客户组见 5.4.2),适合「一个小组服务一组客户」 |
| 负责客户 | 客户负责人 = 本人 |
| 本人创建 | 只看自己创建的数据 |
**五、特殊权限**(必须单独授予,不随角色复制带入)
导出、AI 配置、审计查看与导出、行业包发布、客户端字段审批、跨客户复用授权、批量删除。
> 通用规则:默认全部关闭;授予时二次确认;持有者名单可按季度导出复核(见 5.4.6)。
**六、职责互斥(SoD)**:保存角色时自动校验,命中即拒绝保存(超级管理员除外)
| **互斥对** | **为什么** |
| --- | --- |
| 脚本「生成」与脚本「审核」 | 自己写自己审,审核形同虚设 |
| 行业包「编辑」与行业包「发布」 | 一次改动影响所有客户,必须双人 |
| 客户端字段「申请」与「审批」 | 同上 |
**七、通用规则**
1. **导出单独授权**:导出是数据离开平台的唯一出口,必须单独权限点且全量留痕。
2. **AI 配置单独授权**:能改模型与额度的人,等于能花钱。
3. **跨客户复用需授权**:客户负责人确认并留痕。
4. **配置权与业务权分离**:行业包 / 表单 / 规则集属于「改一次影响全部客户」的操作,编辑与发布分离。
5. **权限季度复审**:避免调岗后权限仍在;敏感操作(删客户、批量导出、改额度、发布行业包、授予超管)二次确认。
6. **最小权限起步**:新角色默认全空,不预勾任何业务权限点,避免「抄一个全开角色」。
#### 5.4.4 AI 配置
**四层配置**(吸收参考平台已验证的分层):
| **层** | **配什么** | **关键字段** |
| --- | --- | --- |
| 供应商 Provider | 一家厂商一个(火山方舟 / DeepSeek / 阿里百炼 / 其他) | 平台类型、Base URL、密钥(加密存储,出参只给 `hasApiKey`)、状态 |
| 模型 Model | 供应商下的具体模型 | 模型名、上下文长度、最大输出、**默认参数(表单 / JSON 双模式)**、连通性测试 |
| 任务映射 TaskMapping | 每个用途的主 / 备模型 | 任务类型(脚本生成 / 解析 / 打标 / 校核 / 图生图 / 图生视频 / TTS)、主模型必填、备用可选、任务级参数覆盖 |
| 调用日志 CallLog | 每次调用的账本 | 任务、模型、耗时、token / 张 / 秒、估算金额、成败、错误码 |
**合并优先级**:任务级参数 > 模型级默认参数 > 供应商默认;提示词同理,`ai_config` 可整段覆盖代码兜底常量——**保存即生成版本快照、可回滚**,回滚也产生新版本号、不覆盖历史(见 R-23)。
**必须抽象的模型方言**(同一份配置换供应商不改业务代码):
| **差异点** | 表现 | 处理 |
| --- | --- | --- |
| 深度思考开关 | 豆包 / DeepSeek 用 `thinking.type`,通义用 `enable_thinking` 且需走 extra_body | 适配器内映射,业务只传「开 / 关 / 强度」 |
| 默认值相反 | 有的默认开思考、有的默认关 | 显式下发,不依赖供应商默认 |
| JSON 模式 | 通义要求提示词含 JSON 字样否则 400;DeepSeek 偶发空 content | 提示词强制含 JSON 契约 + 空内容重试 + 解析兜底 |
| 联网搜索 | Responses 接口支持、Chat 接口静默忽略 | 作为独立前置步骤,结果落库,失败降级不阻断 |
**其余规则**:
| **模块** | **内容** |
| --- | --- |
| 用途路由 | 脚本、图生图、视频、TTS 各用哪个模型链,可按客户覆盖 |
| 额度与预算 | 按角色 / 客户 / 任务限额,月度预算,80% 告警、100% 阻断 |
| 健康与降级 | 主模型失败 → 退避重试 → 备用模型 → 落失败原因;内容违规不重试 |
| 全局限流 | 按供应商配额设模块级并发上限,令牌不足即排队,避免批量任务瞬间打爆配额 |
| 成本口径 | 调用前预占、调用后按实际用量结算;**估算价与真实账单分列**,月度对账 |
| 密钥安全 | AES-256-GCM 加密存储,密钥来自环境变量;模型级密钥优先于供应商级;只回传 `hasApiKey` |
#### 5.4.5 数据字典
| **字典** | **用途** |
| --- | --- |
| 平台与规格 | 平台清单与尺寸比例(图片 / 视频通用) |
| 时长档 | 15s / 30s / 60s |
| 钩子类型 | 提问 / 反差 / 价格 / 场景 / 身份 / 悬念 |
| 景别 | 中近景 / 特写 / 全景 |
| 光影与风格 | 光影池(如 L1–L5) |
| 警示语类型 | 行业通用 / 平台强制 / 客户指定 |
| 禁用词库 | 通用极限词 + 行业词 + 客户词 |
| 失败原因 | 审核拒绝 / 超时 / 参数非法 / 限流 |
| 淘汰理由 | 画面差 / 主体不对 / 台词怪 / 人物出戏 |
| 脚本方向 | 口播 / 剧情 / 测评 / 种草 / 情景…,可按行业收窄 |
| 情绪与风格 | 亲和 / 专业 / 激情 / 幽默 / 悬念 |
| 人群标签 | 年龄 / 性别 / 身份 / 消费力,可扩展 |
| 素材形态 | 展示 / 口播 / 剧情 / 图文动效 / 信息图 |
> 注:「行业二级」不再作为字典项,改由 `industries` 两级行业树承载(ADR-002);其余字典口径不变。
**变更规则**:字典变更**只影响新数据,历史数据保留快照**;否则改一次字典,历史统计全部失真。
**通用枚举模型**:所有字典共用一张枚举表(类型 + 编码 + 名称 + 父编码 + 所属行业 + 排序 + 启用),一张表同时承载行业二级树与受控词表;编码不可改、名称可改;按行业作用域继承——查询取「本行业 + 父行业 + 通用」三层合并,行业包只覆盖差异项。
#### 5.4.6 审计
| **审计对象** | **记录** |
| --- | --- |
| 登录 / 登出 | 谁、何时、IP / 设备、结果 |
| 权限变更 | 给谁、加/减了什么、前后值 |
| 资产增删改 | 哪类资产、动作、前后值 |
| 生成任务 | 参数、模型、额度消耗、结果、失败原因 |
| **导出** | 导出哪些、多少、到哪、谁、何时 |
| 配置变更 | 字典 / 模型 / 额度 / 路由的前后值 |
| 敏感数据访问 | 客户资产包、成本数据、审计日志的查看 |
审计日志**只读、不可修改**,保留 ≥ 12 个月(【待确认】),支持按人 / 客户 / 时间检索;审计导出本身也要审计。
#### 5.4.7 行业包管理
行业包 = 一个行业的完整业务配置。平台按它渲染要素卡、组织卖点体系、决定素材形态、加载合规规则。**换行业 = 换行业包,不发版。**
| **槽位** | **内容** | **电商示例** | **金融示例** |
| --- | --- | --- | --- |
| 要素卡 schema | 字段、分组、必填、校验、变量映射 | 款号 / 材质 / 白底图 | 产品类型 / 费率 / 风险等级 / 资质 |
| 卖点体系 | 标签树 + 常用卖点 | 版型 / 面料 / 场景 | 门槛 / 收益 / 期限 / 保障 |
| 素材输入清单 | 必需参考物料 | 白底图(必须) | 产品资料、资质图、风险提示文本 |
| 素材形态 | 图片 / 视频可用的展示方式 | 平铺 / 模特上身 / 场景化 | 情景剧 / 口播 / 信息图动效 |
| 场景池 / 人物池 | 可选槽位,不需要则关闭 | 通勤 / 街拍 + 人物池 | 家庭 / 职场情景 + 可选 |
| 脚本结构 | 钩子类型、段落、时长档 | 前 3 秒钩子 + 卖点展示 | 痛点 + 算账 + 风险提示 + 行动引导 |
| 合规规则集 | 禁用词、强制提示语、必填资质、审核要点 | 极限词、价格真实性 | 不得承诺收益、风险提示必备、资质露出 |
| 平台规格 | 常用投放位与尺寸 | 抖音 / 小红书 / 朋友圈 | 同上 + 金融类投放资质要求 |
| 质量校核 | 行业附加检查项 | Logo 完整性、商品不变形 | 风险提示字号 / 位置、费率口径 |
能力:新建(可复制既有行业包)、编辑(走 5.4.8 设计器)、版本管理、发布审批、停用、导入导出(JSON)、与客户绑定、客户级覆盖。
**发布流程**:草稿 → 自动校验 → 双人复核 → 发布。发布后,历史要素卡保存当时 schema 版本快照,**不回改历史数据**。
**新行业上线路径**:复制最近似的行业包 → 改字段与合规规则 → 用一个真实客户试跑 1 个批次 → 发布。目标 ≤ 5 个工作日。
#### 5.4.8 表单设计器(要素卡 schema)
设计目标:让行业差异用配置表达,不靠发版;但**不做通用低代码平台**——只解决"要素卡字段"这一件事。
| **能力** | **说明** |
| --- | --- |
| 字段配置 | 类型、标签、必填、占位提示、校验规则(长度 / 正则 / 取值范围)、默认值 |
| 类型白名单 | 单行文本、多行文本、富文本、单选、多选、数值(含单位)、价格 / 费率、日期、日期区间、图片(单 / 多)、文件、关联实体、布尔开关、标签集(引用卖点库) |
| 分组与排序 | 分组、分栏、折叠、排序;**不开放自由布局拖拽** |
| 联动显隐 | 依赖字段 + 条件(等于 / 包含 / 大于),**最多两级**,禁止循环 |
| 选项来源 | 引用数据字典、卖点库、客户列表、平台规格 |
| 变量映射 | 字段 key 即提示词变量 `{{key}}`;声明是否进入生成、进入时在提示词中的位置与优先级 |
| 预览与试填 | 按客户视角预览表单,用一份真实要素卡验证变量渲染结果 |
| 版本与发布 | 草稿 / 已发布 / 已弃用;发布需审批,变更留审计 |
字段元数据(每个字段都必须声明):
| **属性** | **说明** |
| --- | --- |
| 字段 key | 生成时作为变量名,发布后不可改名(只能弃用后新建) |
| 字段类型 | 白名单内 |
| 是否必填 | 必填缺失时禁止提交生成 |
| 是否进入生成 | 决定是否拼进提示词 |
| 变量优先级 | 多个字段竞争同一提示词位置时的取舍规则 |
| 是否参与校核 | 关联到行业包中的校核规则 |
| 是否可检索 | 决定能否作为筛选条件与报表维度 |
| 生效范围 | 行业包级 / 客户覆盖级 |
**复杂度护栏(硬约束)**:
1. 字段类型只允许白名单,不支持自定义控件与脚本;
2. 联动最多两级依赖,不做循环、不做公式计算;
3. 每个行业包字段总数 ≤ 60;单客户追加字段 ≤ 5;
4. 已发布字段只可弃用(隐藏、保留数据),不可删除、不可改名;
5. 字段变更必须走发布流程,且必须说明"历史数据如何解释";
6. 设计器只对具备配置权限的角色开放,业务角色只填值。
**发布前自动校验**:变量引用完整性、必填字段是否满足生成链路、联动是否成环、枚举来源是否有效、引用的资产是否存在、字段 key 是否唯一、字段总数是否超限。
**明确不做**:任意公式、条件计算、跨行业共享字段的隐式继承、页面级自由布局。
#### 5.4.9 客户级字段扩展与审批
- 客户可追加 ≤ 5 个"进入生成"的字段(如活动编码、内部产品代码),默认**只用于检索与报表**,可申请进入生成。与 5.4.2 的自由基础字段区分:基础字段上限 10 个且永不进入生成;进入生成的字段上限 5 个且必须审批。
- 流程:客户负责人发起(字段定义 + 用途 + 是否进入生成)→ 由具备客户端字段审批权限的角色审批 → 生效;超限或被拒时给出明确提示。
- 约束:客户级字段只是叠加,不改变行业包 schema;导出与报表需标注"客户自定义字段";客户服务结束后字段只读。
- 审批与变更全部进审计(属配置变更类)。
#### 5.4.10 功能清单
| **编号** | **功能** | **优先级** |
| --- | --- | --- |
| P-01 | 用户与组织管理 | P0 |
| P-02 | 角色管理(新建 / 复制 / 停用角色,权限点与数据范围配置,职责互斥校验) | P0 |
| P-03 | 数据权限(客户 / 客户组 / 部门 / 本人) | P0 |
| P-04 | 客户管理与行业资产包套用 | P0 |
| P-05 | 行业树维护 | P0 |
| P-06 | 核心数据字典(平台规格、时长档、禁用词、警示语类型) | P0 |
| P-07 | 审计日志(关键操作)与检索 | P0(关键操作)/ P1(检索导出) |
| P-08 | 模型接入与额度配置 | P0(M0 接入)/ P1(额度) |
| P-09 | 用途路由与提示词版本管理 | P1 |
| P-10 | 健康探测与自动降级 | P1 |
| P-11 | 成本看板与分摊 | P1 |
| P-12 | 登录方式(SSO / 手机号) | P1 |
| P-13 | 系统配置(命名规则、导出设置、通知) | P1 |
| P-14 | 行业包管理(新建 / 复制 / 版本 / 发布 / 停用 / 导入导出) | P0 |
| P-15 | 表单设计器(字段 / 分组 / 校验 / 联动 / 变量映射 / 试填预览) | P0 |
| P-16 | 行业包发布审批与历史 schema 快照 | P0 |
| P-17 | 客户级字段扩展申请与审批(≤ 5 个) | P1 |
| P-18 | 行业合规规则集配置(禁用词 / 强制提示语 / 资质字段) | P0 |
### 5.5 导出与交付
| **项** | **规则** |
| --- | --- |
| 范围 | 只导出勾选项;支持按组导出(同组保留项) |
| 位置 | 本地文件夹,固定结构 `客户 / 交付日期 / 类型 / 批次`;视频另支持「下载到本地」 |
| 命名 | 脚本按编号 `客户编码-YYMMDD+序号`(见 5.1.4);图片成片沿用 `行业-客户-脚本方向-日期-序号` 并加规格后缀;视频成片支持**通用字符命名**(占位符 + 固定文本,规则见 5.2.2);同名自动加序号 |
| 留痕 | 谁、何时、哪些、导出到哪,全部记录 |
| 交付清单 | 批次内素材数、规格、对应脚本编号、审核状态、成本 |
| 格式 | 视频 MP4 / H.264 / 1080×1920 / 30fps;图片 JPG(质量 90+)或 PNG |
| 归档 | **导出即入库**,成片自动进入资产库 |
| 打包下载 | 多选素材 zip 打包,异步执行,产物限时保留(默认 3 天) |
| 分享 | 成片可生成短时效免登录预览链接(P2,规则见 5.2.5) |
| **编号** | **功能** | **优先级** |
| --- | --- | --- |
| E-01 | 勾选导出与目录结构 | P0 |
| E-02 | 命名规则与同名序号 | P0 |
| E-03 | 导出记录与审计 | P0 |
| E-04 | 交付清单 | P1 |
| E-05 | 成片自动归档 | P1 |
| E-06 | 按组导出与批量重导 | P2 |
| E-07 | 脚本交付包(Word / 飞书)与交付记录 | P1(Word)/ P2(飞书) |
---
## 6 关键业务规则(跨模块)
| **编号** | **规则** | **说明** |
| --- | --- | --- |
| R-01 | 命名规则 | 脚本 `行业-客户-脚本方向-日期-序号`;图片成片沿用同规则并加规格后缀;视频成片支持通用字符命名(中文 / 字母 / 数字 / 下划线 / 短横线 + 占位符,≤ 100 字符);同名自动加序号 |
| R-02 | 资产删除保护 | 被引用的资产只能停用,不能删除 |
| R-03 | 审核后修改 | 已入库脚本 / 已启用模板修改须产生新版本并重新审核 |
| R-04 | 客户数据隔离 | 任何查询必须带客户维度,禁止"先查全量再过滤" |
| R-05 | 导出即审计 | 导出全量留痕且可追溯 |
| R-06 | 批量成本前置 | 任何批量任务提交前必须显示预估成本与条数 |
| R-07 | 客户状态 | 暂停只读,结束为只读归档,不删除数据 |
| R-08 | 素材计数口径 | "可投素材" = 通过审核并完成导出;失败、淘汰不计入 |
| R-09 | AI 生成内容标识 | 按法规与平台要求做显式标识(如画面角标)与隐式标识(元数据),具体形式【待确认】 |
| R-10 | 字典变更 | 只影响新数据,历史保留快照 |
| R-11 | 要素卡 schema 版本化 | 已发布字段只可弃用、不可删除改名;历史要素卡保留当时快照,统计按填写时版本解释 |
| R-12 | 行业包发布审批 | 行业包变更须双人复核后发布,编辑与发布权限分离 |
| R-13 | 字段复杂度上限 | 每行业包字段 ≤ 60、单客户追加 ≤ 5、联动最多两级、字段类型限白名单 |
| R-14 | 生成变量完整性 | 必填且"进入生成"的字段缺失时禁止提交;提示词变量必须能在行业包中找到定义 |
| R-15 | 跨行业客户迁移 | 客户切换行业包须新建要素卡,旧卡保留只读,不自动套用新 schema 的必填字段 |
| R-16 | 角色可配置 | 除超级管理员外不内置业务角色;角色 = 权限点 + 数据范围 + 特殊权限;变更即时生效并留痕 |
| R-17 | 超级管理员保护 | 超管角色不可删改停用;授予超管须二次确认并审计;建议 ≤ 2 人 |
| R-18 | 职责互斥 | 生成与审核、行业包编辑与发布、字段申请与审批不可同属一个角色(超级管理员除外) |
| R-19 | 视频方向与脚本方向边界 | 脚本方向决定"说什么"(钩子与结构),视频方向决定"怎么呈现"(口播 / 剧情 / 产品展示);二者并列、不合并 |
| R-20 | 行业 / 客户目录 | 行业本身为两级树(一级行业 → 二级行业),客户挂末级行业;行业与客户构成资产归属的两级目录;客户不可跨行业移动,一级行业名称全局唯一、二级行业名称在同一父级下唯一、客户名称在同一末级行业下唯一 |
| R-21 | 脚本编号唯一 | 过审入库时按 `客户编码-YYMMDD+序号` 原子分配;草稿不占号;编号一经分配不重用、不可改 |
| R-22 | 客户审核链接安全 | 免登录链接须签名 + 有效期 + 限范围(只读 / 可改稿);链接可随时作废;改稿保留原稿快照与操作人 |
| R-23 | 提示词与模型配置版本化 | 保存即快照、可回滚;任务创建时记录所用版本号,事后可复现「当时为什么生成成这样」 |
| R-24 | 生成结果可溯源 | 每条脚本记录引用的参考脚本与品牌事实来源;缺失来源的「事实」不得进入生成 |
| R-25 | 素材粒度 | 素材为主对象、规格为属性:同源多规格不各建素材;素材与脚本多对多,必须用关联表,禁止 JSON 列存 ID |
| R-26 | 阈值同源 | 爆量消耗阈值、审核超时等阈值只存系统配置一处;前端上限、DTO 校验、任务判定读同一来源,禁止硬编码 |
| R-27 | 送审基准 | 审核结论绑定「提交时刻冻结的版本」;之后修改素材不改变本次结论,重审需新建批次 |
| R-28 | 分享与外部访问 | 分享链接必须签名 + 短时效 + 可作废,外部访问全部留痕;未评估公网可达性前不开放 |
| R-29 | 图片线不做生成式 | 图片生产只允许 PSD 模板套版 + 抠图 + 合成;引入 AI 生成图片须单独立项与预算 |
| R-30 | 低质量不可静默 | 抠图降级、缺字体、超限降质等必须打「低质量」标记并计入质量看板,不得按成功静默交付 |
---
## 7 优先级与版本范围
| **范围** | **包含** |
| --- | --- |
| **M0 地基** | P-01~P-06、P-07(关键操作审计)、P-08(模型接入)、**P-14~P-16、P-18**(行业包 / 表单设计器 / 发布审批 / 合规规则集)、A-01~A-05、S-01/S-02/S-04、E-01~E-03;**电商行业包 v1** |
| **M1 主链路** | S-05、S-07(基础)、S-08、S-09、M-01、M-03、M-04(安全区 / 警示语)、M-05、M-14、E-04、S-03、**S-13、S-14(基础)**、P-17;**金融行业包 v1 完成配置并试跑 1 个批次**;**视频方向资产随资产能力可用**;**图片线收口:PSD 模板套版 + 抠图 + 多规格 + ZIP 批量下载** |
| **M2 提效** | M-06、M-07、M-08、M-09、M-11、M-12、**M-15~M-17**、S-06、S-10、S-11、**S-15~S-17、E-07**、A-06~A-09、P-09~P-11、M-02;**第三个行业包(待定)** |
| **M3 复用** | A-10、A-11、S-12、**S-18**、M-10、M-13、E-05、E-06、P-12、P-13;**M-18~M-24(成片入库、素材库、送审、效果回流)** |
| **M4 交付闭环** | M-25、M-26(爆量判定、关联率与排行看板)+ 阈值配置固化 |
| **M5 远期(预研,不排期)** | M-27(元素级拆解)与 5.2.5-8 的 AI 素材生产路线 |
> 排序逻辑:**M0 先把"人、客户、资产、权限、行业"立住**;M1 用图片线验证"平台更快更便宜",同时把金融行业包配通;M2 再上视频(质量不确定性最高,且依赖脚本分镜、人物场景池、模型路由);M3 才谈复用与效果。若视频是业务绝对重心(【待确认】),需在 M1 内压缩图片线为最小可用。
> **多行业的代价(需要明确接受)**:表单设计器与行业包必须进 M0,否则第二、第三个行业无法并行配置,M0 工期约增加 2–3 周。换来的是"新行业只配置、不发版"。若坚持先单行业跑通,行业包仍按本文设计,但要素卡字段必须从第一天起按可配置方式建表,否则第二行业上线时要做数据迁移。
---
## 8 指标与验收
### 8.1 指标与埋点
| **指标** | **口径** | **关键埋点** |
| --- | --- | --- |
| 交付周期 | 需求登记 → 首次导出完成(自然日) | `request_created` / `export_done` |
| 人均周产能 | 可投素材 ÷ 参与人数 ÷ 周数 | `export_done` + 用户活跃 |
| 一次过审率 | 首次提审通过 ÷ 首次提审总数 | `script_approved` / `asset_rejected` |
| 单条综合成本 | (人力工时 × 人时成本 + AI 调用费 + 外部采购)÷ 可投条数 | `cost_recorded` |
| 资产复用率 | 使用既有资产的产出 ÷ 总产出 | `asset_referenced` |
| 周活率 | 周活跃 ÷ 目标用户数 | `login` / 核心操作 |
| 任务成功率 | 成功任务 ÷ 提交任务 | `task_finished`(含失败原因) |
| 图片 / 视频有效率 | 保留数 ÷ 生成数 | `video_kept` / `video_discarded` |
| 抠图一次通过率 | 未降级条目 ÷ 抠图条目 | `matting_ok` / `matting_fallback` |
| 低质量产出率 | 低质量标记条目 ÷ 产出条目 | `low_quality_flagged` |
| 预览勾选率 | 导出 / 下载选中数 ÷ 预览候选数(图片、视频分别统计) | `asset_selected` / `export_started` |
| 视频预览使用率 | 播放过预览的视频数 ÷ 待预览视频数 | `video_preview_play` |
| 新行业上线周期 | 行业包建档 → 首支可投素材(工作日) | `industry_pack_published` / `export_done` |
| 要素卡填写完整率 | 必填字段齐全的卡 ÷ 总卡数 | `brief_card_saved` |
| 素材关联率 | 已关联脚本的素材 ÷ 全部素材 | `material_linked` |
| 爆量素材占比 | 判定为爆量的素材 ÷ 已投放素材 | `material_hit` |
| 效果回流覆盖率 | 有日指标记录的素材 ÷ 已登记投放素材 | `metric_imported` |
| 分享链接滥用率 | 被限流 / 被作废的分享访问 ÷ 分享访问总量 | `share_link_blocked` |
**埋点原则**:功能上线即埋;每个任务记录模型、耗时、调用量、费用;事件必须带用户、客户、批次三个维度;**配置类事件(行业包发布、字段变更、客户端字段审批)必须单独留痕**,否则"为什么这条素材长这样"无法回溯。
**看板**:产能看板(主管 / 运营)、质量看板(审核 / 设计)、成本看板(主管 / AI 工程)、资产看板(设计 / AI 工程)。
### 8.2 验收标准(DoD)
| **编号** | **标准** | **判定** |
| --- | --- | --- |
| AC-01 | 至少 1 个真实客户完整走通"要素卡 → 脚本 → 素材 → 导出" | 业务方现场验收 |
| AC-02 | 8.1 中至少 3 项指标达标 | 上线后 60 天数据 |
| AC-03 | 目标用户周活 ≥ 50%,且至少 3 类岗位(如运营 / 设计 / 审核)日常使用 | 埋点 + 访谈 |
| AC-04 | 权限隔离可验证、导出与权限变更可审计 | 安全自查 + 抽样 |
---
## 9 非功能与合规要求
### 9.1 性能
| **项** | **要求** |
| --- | --- |
| 列表首屏 | ≤ 2s |
| 单条脚本生成 | ≤ 30s(超时按失败处理) |
| 图片单张合成 | ≤ 10s |
| 预览体验 | 图片 ≥ 50 张预览不卡顿,缩略图加载 ≤ 1s;勾选状态刷新后可恢复 |
| 视频预览 | 在线播放首帧 ≤ 2s,支持断点续播;单次预览 20 条以内不卡顿 |
| 批量任务 | 异步执行,进度可见,失败可重试,中断可恢复;下载支持批量打包 |
### 9.2 安全底线
1. 客户数据隔离:查询必须带客户维度。
2. 导出全量审计,且导出是唯一出口。
3. 被引用资产禁止删除。
4. 批量任务提交前必须显示预估成本。
5. 审计日志只读,任何角色不可修改。
### 9.3 合规
| **项** | **要求** |
| --- | --- |
| 广告法 | 极限词、虚假价格、材质与收益虚标拦截;要素卡事实校验 |
| AI 生成内容标识 | 按现行规定做显式与隐式标识;具体形式与位置【待确认】 |
| 肖像权 | 人物池入库需授权证明;禁止以真实人物(含明星)为原型的生成 |
| 客户素材保密 | 客户级隔离 + 跨客户复用授权 + 导出留痕 |
| 平台规则 | 规格、时长、审核规则做成数据字典,可随平台规则热更新 |
| 分行业合规 | 行业包内置合规规则集:金融必须带资质与风险提示、不得承诺收益;电商须真实价格与材质表述。规则随监管变化可配置更新,不依赖发版 |
---
## 10 待确认问题
| **编号** | **问题** | **需要谁回答** |
| --- | --- | --- |
| Q-01 | 视频与图片的产能占比与优先级?决定 M1 先图片还是并行 | 业务负责人 |
| Q-02 | 一次过审率、单条成本、交付周期的现状基线 | 审核 / 财务 / 运营 |
| Q-03 | 目标投放平台清单与具体尺寸规格 | 投放运营 |
| Q-04 | 口播类素材占比?决定 TTS / lip sync 优先级 | 运营 |
| Q-05 | 人物池 / 场景池的素材与授权来源 | 设计 / 法务 |
| Q-06 | AI 生成内容的标识方式与位置 | 法务 |
| Q-07 | 跨客户资产复用的审批人 | 主管 |
| Q-08 | 数据保留期与删除策略 | 法务 / 主管 |
| Q-09 | 月度 AI 调用预算上限 | 财务 / 主管 |
| Q-10 | 是否接入企业统一登录(SSO) | IT |
| Q-11 | 交付是否需要客户签收 / 交付单 | 客户负责人 |
| Q-12 | 现有可复用的素材 / 模板历史积累有多少 | 运营 / 设计 |
| Q-13 | 第三个行业是哪个?(电商 + 金融已定) | 业务负责人 |
| Q-14 | 行业包由谁编辑、谁复核发布?审批人是否固定两人 | 管理员 / 主管 |
| Q-15 | 金融客户需要哪些资质字段与强制提示语(按平台分别列) | 法务 / 运营 |
| Q-16 | 行业包字段上限 60、客户基础字段 10 个、进入生成字段 5 个是否合适 | 管理员 / 业务 |
| Q-17 | 超级管理员由谁持有、设几人?授予超管是否需要第二人审批 | 负责人 / IT |
| Q-18 | 数据范围是否需要细到单客户,还是客户组已够 | 主管 |
| Q-19 | 通用字符命名的占位符集合与顺序是否固定为 {行业}{客户}{视频方向}{日期}{序号} | 运营 / 研发 |
| Q-20 | 视频交付是「下载到本地」还是「导出到指定文件夹」(本文按两者都保留) | 研发 / 运营 |
| Q-21 | 行业 / 客户基础自定义字段上限 10 是否够用,是否需要按行业包配置 | 管理员 / 业务 |
| Q-22 | 是否启用「免登录客户审核链接」替代线下传稿?有效期与是否允许客户改稿 | 客户负责人 / 法务 |
| Q-23 | 品牌事实从哪来:联网搜索、人工事实库,还是仅要素卡 | 运营 / 法务 |
| Q-24 | 脚本编号是否沿用「客户编码-YYMMDD+序号」规则?客户编码由谁维护 | 管理员 / 运营 |
| Q-25 | 交付包是否必须 Word / 飞书,是否需要客户签收 | 客户负责人 |
| Q-26 | 素材粒度是否确认「素材为主对象、规格为属性」,还是允许一规格一条素材 | 研发 / 运营 |
| Q-27 | 是否启用免登录分享链接预览成片?有效期上限与作废责任人 | 客户负责人 / 法务 |
| Q-28 | 爆量判定阈值(消耗 / ROI)按什么口径?是否分行业 / 客户不同 | 投放 / 主管 |
| Q-29 | 效果数据来源:手工导入、平台后台导出,还是开放平台 API 同步 | 研发 / 投放 |
| Q-30 | PSD 图层命名约定由设计团队保证,还是平台提供半自动映射(识别不了的图层人工点选绑定) | 设计 / 产品 |
| Q-31 | 抠图质量标准:白底 / 纯色可批量,复杂背景、发丝、透明材质是否直接转人工,由谁定阈值 | 设计 / 运营 |
| Q-32 | 是否需要 AI 生图覆盖非电商行业(本需求在素材工坊已有方案文档但未上线),若需要何时立项(M5) | 产品 / 业务 |
---
## 附录
### 附录 A 与 PRD V0.2 / V0.3 的主要差异
| **项** | **PRD V0.2** | **本文** | **原因** |
| --- | --- | --- | --- |
| 模块结构 | 脚本 / 素材 / 编辑 / 管理 四模块 | 脚本 / 素材 / 资产 / 平台管理 三主线 + 一底座 | 消除"编辑"与"管理"双入口;管理模块独立成底座 |
| 脚本粒度 | 文案 | 分镜级 | 视频逐镜生成的前置条件 |
| 脚本输入 | 产品信息富文本 | 要素卡 + 卖点库(按行业包 schema 渲染) | 可校验、可复用、可批量,换行业不改内核 |
| 批量方式 | 填数量 | 变体矩阵 + 相似度去重 | 减少无效产出 |
| 视频生成 | 一条脚本一条片 | 逐镜生成 + 单镜替换 + 矩阵 | 成本从线性降为常数,支持 A/B |
| 素材筛选 | 逐个预览 | 按组并排快筛 | 先放大候选,再快速收敛 |
| 导出 | 导出即结束 | 导出即归档 | 半年后仍可检索"上次那版" |
| 管理模块 | 7 类资产列表 | 资产模块 + 平台管理(用户 / 客户 / 权限 / AI 配置 / 字典 / 审计) | 30–100 人协作与多客户隔离的刚需 |
| 资产类型 | 7 类 | 15 类(新增人物池、场景池、光影、BGM、提示词模板、要素卡、成片、视频方向) | 支撑视频一致性与 know-how 复用 |
| 行业支持 | 隐含单一行业,字段按电商硬编码 | 行业包可配置,本期电商 + 金融 | 承接第二、第三个行业不发版 |
| 字段变更 | 未定义 | 表单设计器 + schema 版本化 + 发布审批 + 历史快照 | 避免改字段破坏历史数据与统计口径 |
| 角色模型 | 固定 4 个角色(运营 / 设计·编辑 / 审核·管理 / 管理员) | 仅内置超级管理员,其余角色可配置(权限点 + 数据范围 + 特殊权限) | 固定角色与实际岗位分工必然错位;配置化后新增岗位不发版 |
| 信息入口(V0.3) | 编辑模块录入行业 / 客户,管理模块信息模块只读维护 | 资产生产入口录入,信息模块统一维护 | 保留本文"单一生产入口"架构,避免双入口 |
| 行业定义(V0.3) | 客户的业务属性(电商 / 金融),资产划分一级维度 | 同 V0.3,并作为行业包绑定点 | 与 V0.3 对齐 |
| 行业 / 客户字段(V0.3) | 录入时可自由填自定义键值对 | 基础字段 ≤ 10 自由填(仅检索 / 报表),进入生成字段 ≤ 5 需审批 | 兼顾录入效率与字段治理 |
| 视频方向(V0.3) | 新增独立资产,视频制作必选 | 纳入资产体系(15 类),候选集由行业包声明 | 统一"说什么 / 怎么呈现"分工 |
| 成片命名与下载(V0.3) | 通用字符命名 + 在线预览后勾选下载 | 同 V0.3,规则进 R-01 与 5.2.2 | 交付层与同事版对齐 |
| 参考项目复用(爆量魔方) | 参考项目只有脚本链路,无图片 / 视频生产实现 | 吸收脚本编号、结构化解析、模板库、行业指南、模型四层配置、客户在线审核、交付包、效果权重;图片 / 视频按自研设计 | 复用已验证的脚本 know-how,少踩一次坑 |
| 脚本编号 | 本文原为「行业-客户-脚本方向-日期-序号」 | 增补客户编码式编号(客户编码-YYMMDD+序号),与交付清单 / 素材任务同 key | 编号要能跨系统对账,已有平台已验证 |
| 客户审核 | 客户不登录,运营代操作 | 默认不变,增补 P1「免登录审核链接」 | 不改变权限模型,只把线下传稿线上化 |
| 素材模型(baoliangmofang) | 参考项目把素材做成「成片」对象,规格为属性(同源多规格) | 采纳:素材为主对象、规格为属性,多对多关联脚本 | 避免多规格重复计费与重复审核 |
| 素材管理链路(baoliangmofang) | 参考项目已有制作任务 / 成片上传 / 素材库 / 送审 / 效果回流设计 | 吸收入库、素材库、送审登记、效果回流;制作任务不并入(本项目以生成为主) | 只取与「生成平台」互补的管理侧能力 |
| 效果回流(baoliangmofang) | 日均消耗等阈值散落在代码与文档 | 采纳阈值同源(系统配置单一来源)+ 派生指标不落库 | 历史项目在这类口径上反复对账,代价高 |
| 图片线定位 | 本文原按「AI 生成」设计(图生图 + 关键帧) | 改为**确定性流水线**:PSD 模板套版 + 自动抠图 + 多规格合成;AI 生图降为 M5 预研 | 素材工坊(sucaigongfang)已规模化验证;广告图对文字 / 主体 / 合规的准确性要求高于创意性 |
| 模板资产形态 | 图片模板 = 上传的整图模板(缺图层语义,见 R-02 风险) | PSD 模板 + 命名图层约定入库,解析失败不放行 | 参考项目用 PS 剪贴蒙版已跑通,图层语义必须显式 |
| 抠图实现 | 未定义 | 本地 ONNX 模型 CPU 推理,失败降级原图并标低质量 | 不外传客户图片;降级路径必须可见 |
### 附录 B 关键设计取舍(一页说明为什么这样设计)
1. **生成能力采购,编排与资产自建**。模型是公共品且迭代极快;平台壁垒在客户数据、私有资产与治理。不把价值押在任何一家模型上。
2. **逐镜而非整条**。整条重生成时每次失败都要重来一遍;逐镜后"不满意只换一镜",成本可控、敢批量试。
3. **人工快筛而非全自动**。当前生成质量不足以直接交付,人的价值从"做素材"转为"快速判断",平台围绕这个动作设计。
4. **资产即生产输入**。模板、Logo、人物、提示词不是"配置项",而是被反复消费的资源,所以要有版本、引用关系、复审与复用度量。
5. **平台管理当底座**。多客户数据隔离、导出审计、AI 成本可控,不是"以后再说",而是 M0 就要有的地基——后补成本极高。
6. **指标锚定"可投"而非"生成"**。生成 100 条废片没有意义,北极星指标必须绑定通过审核与已导出。
7. **行业差异用"配置"表达,不用"分支"表达**。行业差异一旦写进代码分支,第三、第四个行业会把内核变成一堆 if;做成行业包 + schema,差异变成数据与版本。
8. **表单设计器是"受控设计器"**。开放字段类型、分组、校验、联动,但拒绝任意公式、脚本与页面拖拽。通用化的收益来自"少发版",不来自"什么都能配";三个护栏:类型白名单、字段与联动上限、发布必须过校验与审批。
9. **只内置超级管理员,其余角色配置化**。固定角色表在设计期就要猜准所有人的职责分工,实际一定错位(同一个「运营」在不同客户上权限并不相同)。改为「权限点目录 + 数据范围 + 特殊权限」后,角色成为配置;代价是上线时要配一轮角色,用示例模板降低冷启动成本、用职责互斥与最小权限兜住风险。
10. **信息前置:行业 → 客户两级目录是根节点**。所有资产与任务都必须有归属,否则跨客户复用、数据隔离、成本分摊都无处落账;因此行业 / 客户信息必须在任何生产动作之前建立,且客户不可跨行业移动。
11. **视频方向独立于脚本方向**。同一条脚本用口播、剧情、产品展示三种呈现方式,产出完全不同的成片;把"怎么呈现"做成独立资产,才能按方向统计复用率与效果,也让行业包只声明"本行业允许哪些方向"而不写死流程。
12. **脚本链路吸收既有平台,图片链路自研**。参考项目(爆量魔方)在脚本生成、结构化解析、审核与 AI 配置上有实战沉淀(编号、行业指南、四层模型配置、免登录审核),复用比重新发明便宜;但该平台**没有任何图片 / 视频渲染实现**,图片套版、规格矩阵、渲染队列必须自研,不能假设「参考一下就有」。
13. **素材为主对象、规格为属性**。若把 9:16 与 1:1 各建一条素材,同一创意要被反复送审、反复计费、反复关联脚本,效果数据也无法汇总;把规格降为属性后,素材成为唯一的"效果主体"和"复用主体"。
14. **阈值与派生指标只留一个来源**。参考项目最贵的教训不是功能缺失,而是同一阈值在文档、DTO、任务里各写一份导致对账。所以爆量阈值、审核超时、上限类数字只存系统配置一处,派生指标(汇总 / 均值 / 占比)不落库、查询时算。
---
### 附录 C 术语表
| **术语** | **含义** |
| --- | --- |
| 钩子(Hook) | 素材前三秒抓住注意力的开场设计 |
| 分镜 | 脚本拆分出的最小可生成单元(场景 + 景别 + 时长 + 画面 + 台词) |
| 景别 | 中近景 / 特写 / 全景等镜头尺度 |
| 变体矩阵 | 由脚本 × 人物 × 场景 × 时长等轴交叉生成的批量候选 |
| 快筛 | 按组并排预览,用最短时间从大量候选中保留少量可用素材 |
| 资产包 | 某客户 / 行业的模板、Logo、位置、警示语、人物场景等资产集合 |
| 命名图层 | 图片模板中带语义名称的图层(商品位 / 文字位 / Logo 位等),用于自动填充 |
| 可投素材 | 通过审核并完成导出的素材(不含失败与淘汰) |
| 行业包 | 一个行业的完整业务配置:要素卡 schema、卖点体系、素材形态、合规规则、脚本结构与投放规格 |
| 要素卡 | 被投放对象(商品 / 门店 / 金融产品等)的结构化描述表单,字段随行业包动态渲染 |
| 表单设计器 | 配置要素卡字段、分组、校验与联动的可视化编辑器(受控,非通用低代码) |
| schema 版本 | 要素卡字段定义的一次发布快照,历史数据按当时版本解释 |
| 客户覆盖 | 在行业包之上,为客户追加或覆盖的字段、规则与资产 |
| 权限点 | 可授权的最小功能操作(如「脚本审核」),角色由权限点组合而成 |
| 数据范围 | 角色能看到哪些客户 / 部门的数据,与功能权限正交 |
| 特殊权限 | 导出、AI 配置、审计、发布等高风险权限,必须单独授予 |
| 职责互斥(SoD) | 不允许同一角色同时持有的权限组合,防止自审自批 |
| 视频方向 | 视频"怎么呈现"的创意形式(口播 / 剧情 / 产品展示 / 达人到店),与脚本方向并列的独立资产 |
| 信息模块 | 承载「行业 → 客户」两级目录的模块,是全部资产的归属根节点 |
| 通用字符命名 | 成片命名规则:中文 / 字母 / 数字 / 下划线 / 短横线 + 占位符,禁止空格与系统保留字符,≤ 100 字符 |
| 客户简称 | 客户的短名称,必填,用于脚本与成片的自动命名 |
| 脚本编号 | 脚本过审入库时分配的唯一编号,格式 `客户编码-YYMMDD+当日序号` |
| 结构化解析 | 把模型输出的 JSON 校验并拆成方向 / 钩子 / 分镜 / 标签等字段的过程 |
| 模板库 | 可被生成引用的叙事结构模板,来源含人工新建与 AI 挖掘 |
| 行业指南 | 行业包内的一段业务写作规范,注入系统提示词末尾,≤ 20000 字 |
| 审核链接 | 供客户免登录查看 / 改稿 / 驳回的带签名有效期链接 |
| 交付包 | 审核通过后导出的脚本交付物(Word / 飞书),含编号、标题与分镜表 |
| 成片 | 已完成渲染或外部制作、可进入送审与投放的最终素材(图片或视频) |
| 素材规格 | 同一素材面向不同平台的变体属性(比例 / 分辨率 / 时长上限),不是独立素材 |
| 送审批次 | 一次提交审核的素材集合,内部审核与外部平台提审共用同一对象 |
| 提审登记 | 外部平台提审结果的记录(平台、时间、状态、驳回原因、凭证),非系统直连投放 |
| 素材关联率 | 已关联脚本的素材占全部素材的比例,衡量脚本-成片对账完整度 |
| 爆量判定 | 消耗达到阈值且 ROI 达标时把素材标记为爆量,用于榜单与脚本权重反哺 |
| 分享链接 | 带签名与有效期的免登录预览链接,可随时作废,访问留痕 |
| PSD 模板 | 设计师产出的分层源文件,图层按命名约定标注可替换位,是图片线的核心资产 |
| 图层命名约定 | 用图层名前缀声明语义(`image_replacement_` 商品位 / `clipping_mask_` 剪贴容器 / `text_replacement_` 文字位) |
| 抠图 | 自动移除商品图背景、输出透明底主体,供套版合成使用 |
| 批次快照 | 批次创建时冻结的输出参数与命名规则,保证历史结果可复现 |
| 低质量产出 | 抠图降级、缺字体、超限降质等仍产出但质量不达标的条目,必须显式标记 |
| 秒传 | 依据文件 hash 判断对象已存在则直接引用,不重复上传与存储 |
---
## 修订记录
| **版本** | **日期** | **说明** |
| --- | --- | --- |
| V1.0 | 2026-10-30 | 基于 PRD V0.2 与立项建议书整合为可评审 PRD:重排模块结构、补齐平台管理、精简表述 |
| V1.1 | 2026-10-30 | 增加多行业支持:行业包、要素卡表单设计器、行业合规规则集、客户级字段扩展与审批;范围调整为电商 + 金融 |
| V1.2 | 2026-10-30 | 角色模型改为「仅内置超级管理员、其余角色可配置」:新增权限点目录、数据范围、特殊权限、职责互斥校验与角色管理规则;新增 R-16~R-18、Q-17~Q-18 |
| V1.3 | 2026-11-02 | 合入同事 PRD V0.3:行业=客户业务属性与「行业 → 客户」两级目录、行业/客户自定义字段分层、视频方向纳入资产(15 类)、视频在线预览与通用字符命名下载、勾选率与视频预览指标、R-19~R-20、Q-19~Q-21;附录 A/B/C 同步 |
| V1.4 | 2026-11-02 | 吸收参考项目「爆量魔方」:脚本编号(客户编码-YYMMDD+序号)、结构化解析与模板库、生成上下文与 RAG 三级降级、行业指南、模型四层配置与方言抽象、免登录客户审核、交付包、效果权重反哺;新增 S-13~S-18、R-21~R-24、Q-22~Q-25、E-07 |
| V1.5 | 2026-11-02 | 吸收 baoliangmofang(爆量魔方重写版)素材侧能力:素材为主对象与规格为属性、成片入库(分片/秒传/自动元数据/版本链)、素材库双视图与打包下载、分享链接安全口径、送审与外部提审登记、脚本-素材血缘与关联率、效果回流与爆量阈值同源、远期 AI 素材生产路线(M5);新增 5.2.5、M-18~M-27、R-25~R-28、Q-26~Q-29 |
| V1.6 | 2026-11-02 | 图片线改为确定性流水线(依据素材工坊 sucaigongfang 实测实现):PSD 模板 + 图层命名约定(image_replacement_ / clipping_mask_ / text_replacement_)、本地 ONNX 抠图与失败降级标记、多规格合成与 ZIP 批量下载、批次参数与命名快照;AI 生图降为 M5 预研;新增 R-29~R-30、Q-30~Q-32;§1.1/§1.5/5.2.1/§7/§8.1/附录 A/B/C 同步 |