22 KiB
22 KiB
Airshelf 二期功能清单
由《二期需求整理总纲》拆解而来，颗粒度到「可派活/可估时」的功能项。 分期：上=二期上半程（骨架，先做）；下=二期下半程；并=可并行支线。 状态：明确=可开工；待确认=需先对齐（对象见备注）。 编号：模块.序号（1=主流程 2=电商内容 3=本地生活 4=自由创作 5=保存模板）。 开发进度：已完成=代码已落地可验收；部分完成=已做一半，缺口见备注；第N段=按文末《开发分段》排期，尚未开工。
模块 1 · 主流程优化（核心骨架，对应 PDF 9 条）
| 编号 | 功能 | 说明 | 分期 | 状态 | 开发进度 |
|---|---|---|---|---|---|
| 1.1 | 取消项目创建阶段的视频时长选择 | 时长移到脚本阶段（见 1.9） | 上 | 明确 | 已完成（第2段补齐）。新建向导里本就没有时长控件；脚本设定卡现在有「时长」那一栏（5–60 秒、5 秒一档），死值 60 秒已去掉 |
| 1.2 | 删除脚本创建的「AI 全生」按钮 | 流程简化 | 上 | 明确 | 已完成（第1段） |
| 1.3 | 「一句话主题」改名「脚本辅助生成」 | 含删除一句话主题框（PDF 第4条） | 上 | 明确 | 已完成（第1段）。改后确认风格人物即直接出稿，少一轮「追问主题」的来回 |
| 1.4 | 脚本创建三种方式入口 | 辅助生成 / 上传脚本 / 上传视频提炼（功能A） | 上 | 明确 | 已完成（第5段补齐）。三个入口都在脚本页空态并排；生成后脚本卡的「来源」徽标能分清是哪个入口出的稿（原先三种都记成「脚本辅助生成」） |
| 1.5 | 脚本辅助生成三选栏 | 表现形式 × 视频结构 × 时长；系统按商品信息推荐默认值 + 保留用户选择权 | 上 | 明确 | 已完成（第2段）。设定卡改成「表现形式 × 视频结构 × 人物 × 时长」四栏，进卡即带推荐值，每栏下方一句话说明 |
| 1.6 | 表现形式选项 | 口播 / 短剧 / Vlog | 上 | 待确认(需求方:选项是否定死/可增删) | 已完成（第2段）。三个选项前后端共用一份枚举，加一个 = 前后端各加一行 + 补一份套路文档 |
| 1.7 | 视频结构选项 | 痛点解决 / 前后对比 / 测评验证 / 场景种草 | 上 | 待确认(同上) | 已完成（第2段）。同 1.6，可增删 |
| 1.8 | 组合联动筛选 | 表现形式为主，视频结构按其筛选，禁矛盾组合（如口播+短剧） | 上 | 待确认(产品:组合规则) | 已完成（第2段）。表现形式为主筛结构；目前只禁一组「短剧 × 测评验证」（演出来的实测没可信度），要加规则改一张表即可 |
| 1.9 | 时长逻辑 | 复用另一平台现成「完全自由 5s 步长 5–60s」实现 + 表现形式推荐默认；后端单镜≤15s 切镜 | 上 | 待确认(开发:可移植/单镜约束) | 已完成（第2段，并进来一起做了）。总时长 5–60 秒 5 秒一档，单镜 4–15 秒不等长、加总精确等于总时长；写死 15 秒的六处已全打掉，脚本镜时长会同步到视频段（已出片的段不动）。真跑验证：40 秒短剧×痛点 → 5 镜 8/6/10/8/8；15 秒口播×前后对比 → 3 镜 4/7/4 |
| 1.10 | 上传脚本 | 仅 docx/txt；平台识别结构后优化、补齐钩子/卖点证明/转化内容 | 上 | 明确 | 已完成（第1段）。docx 用标准库在后端拆，没加新依赖；提示词已改为先识别结构、保留原意，再补钩子/卖点证明/转化 |
| 1.11 | 上传视频提炼（功能A） | 视频→结构化分镜（对齐画面描述七要素）→可人工逐镜编辑→喂脚本。⚠️必须可编辑（AI拆解有5类已知毛病） | 上 | 待确认(客户:是否要"迁移到新商品"步骤) | 已完成（第5段）。开工前那句「唯一一条新基建」经核实是高估了：现在的脚本模型本身就会读图（已实测），拆视频的 ffmpeg 也早就装在后端（第5阶段导出一直在用），真正新写的只有「按时间轴均匀抽帧」这一小段。链路：传视频 → 抽 4–12 帧 → 模型逐镜还原 → 中文分镜稿直接落在输入框里让人改 → 改完才交给脚本 agent 按你自己的商品重写。上限 3 分钟 / 200 MB，整条约 30–60 秒，计一次文本生成的费。语音转写没做，理由见下方「第5段」说明 |
| 1.12 | 三视图资产：双通道 | AI 生成 + 用户上传 均保留；样式调整：单独上传框、取消替换按钮 | 上 | 明确 | 已完成（第1段）。替换按钮已删，改成「上传三视图」直接选文件；还没图时预览区本身就是虚线上传框 |
| 1.13 | 三视图：重新生成入口确认 | 「取消替换按钮」不等于取消「重新生成三视图」能力，需保留生成入口 | 上 | 待确认(开发) | 已完成（第1段）。开发侧结论：不受影响——「AI 重新生成三视图」和「替换」本就是两个独立按钮，删一个不动另一个，预览面板里的「重跑」也在 |
| 1.14 | 故事板进页面自动生成 | 不再手动点「开始生成」；防刷新/返回/切页重复创建 | 上 | 明确 | 暂缓，需先补后端防重复。这条听起来是「删掉一个手动按钮」，但那个按钮正是目前唯一的防重复措施——后端收到一次请求就新建一次任务、预扣一次积分，本身不检查「这段是不是已经在跑了」。改成进页面自动触发后，用户每刷新一次页面就重新触发一次。前置工作 = 给后端补「已经在跑就不重复建」的判断，对用户不可见，但省掉它这功能不能上线 |
| 1.15 | 视频进页面自动生成 | 同 1.14；防重复创建视频任务 | 上 | 明确 | 暂缓，风险高于 1.14。视频是全流程最贵的一步，而提交侧后端完全没有防重复：点两次就是两个任务、扣两份积分。现在只有前端按钮禁用挡着，绕开它（刷新、开两个标签页、点太快）就会重扣。不补后端就上线 = 用户刷新一次重扣一批。补法与 1.14 同源，视频优先做 |
| 1.16 | 全流程积分消耗展示 | 生成前预估 + 结束后明细。⚠️依赖各环节计费标准先定清 | 上 | 待确认(PM:计费标准) | 部分完成，余下待 PM。余额、每步单价、单任务预估、实际扣除、消费流水都已经有了；缺的只是流程级汇总（进条前总预估 + 出片后一次性明细）。⚠️这个汇总不能让前端把各步单价加起来自己算：视频按实际时长和用量动态计价，还有重跑次数、团队折扣两步取整，前端算的数跟最后真扣的对不上，用户会觉得平台乱扣钱。得先定清计费口径，再由后端出数 |
| 1.17 | 保存模板 | 见模块 5（同一功能） | 下 | — | 第7段（见模块 5） |
模块 2 · 电商脚本内容（并入模块1，内容层）
| 编号 | 功能 | 说明 | 分期 | 状态 | 开发进度 |
|---|---|---|---|---|---|
| 2.1 | 表现形式 × 视频结构 套路内容沉淀 | 每个（合理）组合对应一份套路：结构骨架、镜头逻辑、钩子/CTA 规则 | 上 | 待确认(PM:内容谁沉淀) | 草稿已落地（第2段）。3 份表现形式 + 4 份视频结构 + 1 份组合矩阵，共 8 份套路文档已进技能库并生效。内容质量待 PM / 内容同学过一遍，改的是 md 文档，不用动代码 |
| 2.2 | 电商专家知识 v0.1 → 扩展 | 已有客户 SOP + 益生菌案例打底，扩为多组合 | 上 | 待确认(内容归属) | 已完成（第2段）。技能库新增「表现形式 × 视频结构」两个维度，按用户所选只加载对应的两份套路，不再一次性灌全部提示词 |
| 2.3 | 系统按商品信息推荐默认组合 | 品类/人群/卖点 → 推荐表现形式+结构默认值 | 上 | 明确 | 已完成（第2段）。按品类关键词推荐组合 + 时长（如数码 3C → 口播 × 测评验证 · 30 秒），推荐值可随时改，「重新推荐」可退回 |
模块 3 · 本地生活（依赖模块1先落地）
| 编号 | 功能 | 说明 | 分期 | 状态 | 开发进度 |
|---|---|---|---|---|---|
| 3.1 | 商品库新增「类目」字段 | 电商/本地生活；驱动后续挂 skill 与节点屏蔽。⚠️涉及商品库结构 | 下 | 待确认(PM/开发:范围排期) | 第8段。⚠️不能复用现有「品类」字段：商品库已有的品类是美妆/食品那种细分，「电商 / 本地生活」是另一个维度，必须新开字段，混用会打乱商品库筛选 |
| 3.2 | 团购 = 虚拟商品建模 | 无实物商品，沿用主流程 SOP | 下 | 明确 | 第8段 |
| 3.3 | 探店脚本结构 + 镜头语言 | 达人→门店→点餐→试吃→环境→到店核销；探店镜头语言 | 下 | 待确认(内容原料待补) | 第8段。与 2.1/2.2 同类：是内容活不是代码活，得先有人写 |
| 3.4 | 本地生活节点屏蔽 | 三视图可跳过、模特上身图入口隐藏（按类目标签自动） | 下 | 明确 | 第8段（依赖 3.1 的新字段） |
| 3.5 | 是否覆盖图片线（平台套图） | 覆盖则平台清单换（美团/点评/抖音本地生活…） | 下 | 待确认(需求方:范围) | 第8段 |
模块 4 · 自由创作打通（相对独立，可并行）
| 编号 | 功能 | 说明 | 分期 | 状态 | 开发进度 |
|---|---|---|---|---|---|
| 4.1 | 三库接入自由创作 | 商品库/模特库/资产库可 @引用（现状完全不能引用） | 并 | 明确 | 已完成（第6段）。自由创作页新增「引用平台素材」入口（页头按钮 + 输入条图标），弹窗里三个 tab 切换资产库 / 模特库 / 商品库；商品要先点进商品再挑它的素材；模特卡上直接给「形象图 / 三视图」两个引用按钮。挑中的素材和上传的一样进参考区、支持 @ 引用，首尾帧模式也能用 |
| 4.2 | 审核状态跟资产走机制 | 平台生成=已审免审；用户上传=审一次打标记；避免按库免审架空审核 | 并 | 明确 | 已完成（第6段）。判断只看素材的「来源」和「审核状态」两个字段，不看它在不在库里——按库免审就是架空审核：用户传一张图进资产库、再从自由创作引用出去，整套人像审核就白做了。表现：平台生成的直接可用；用户上传的没审过会显示黄色「待送审」并挡住，卡片上给一个「送审」按钮，审核通过后自动变成可引用。审核中/未通过都有明确文案，不会让用户一脸问号 |
| 4.3 | 分步实施 | 资产库先行（最干净）→ 模特库 → 商品库 | 并 | 明确 | 已完成（第6段）。三个库一次接完。后端只认一种「引用平台素材」，三个库的差别全在挑素材的界面上——以后再加第四个库也不用动后端 |
| 4.4 | 存量资产补审核状态标记 | 数据迁移：平台生成批量标已审、用户上传标待审 | 并 | 明确 | 跳过，不需要做。原计划是跑一次数据迁移给老资产批量打标记，实际不用：4.2 的判断是「按来源实时算」，平台生成的老资产天然免审、用户上传的老资产天然显示「待送审」，不刷数据结论也一样。少跑一次全表刷新 = 少一个出错的机会，故不做 |
模块 5 · 保存模板 / 视频替换（PDF 第9条）
| 编号 | 功能 | 说明 | 分期 | 状态 | 开发进度 |
|---|---|---|---|---|---|
| 5.1 | 保存模板 | 存带货套路/脚本结构/人物场景风格/镜头节奏/转化方式 | 下 | 明确 | 第7段。必须等第2、3段定稿：模板存的就是「表现形式 × 视频结构 × 时长」那套参数，参数还没定型就先做模板，改一次废一次 |
| 5.2 | 换商品重跑 pipeline | 换商品后重做商品理解、卖点适配、资产生成、故事板生成（=满足「视频商品替换」需求，路径②） | 下 | 明确 | 第7段 |
| 5.3 | 视频替换预期管理 | 产出为「同套路重出新视频」，非「仅换商品的原片」，需告知用户 | 下 | 待确认(客户:替换确切含义) | 第7段。是文案/沟通活，代码量很小，但要在客户签字前说清楚，否则验收时对不上 |
| 5.4 | 模板私有 vs 平台公共库 | 公共库价值大但复杂 | 下 | 待确认(PM) | 第7段。建议先只做私有模板，公共库另立一期 |
明确不做（防蔓延，一并记录）
| 项 | 处置 |
|---|---|
| 模特库改造 | 独立立项（已备《模特库机制设计》） |
| 商品链接解析入库 | backlog（爬虫维护+合规风险） |
| 一键白底图 | backlog（定位漂移） |
| 视频成片直接替换（路径①） | 不做，用模块5 路径②替代 |
待确认汇总（按对象，便于对齐）
需求方 / 客户：1.6/1.7 选项是否可增删 · 1.11 是否要迁移到新商品（已按「要迁移」实现：拆完的分镜稿会自动按当前项目的商品重写，参考视频里的商品/品牌/人物一律不保留；若客户其实想要「原样还原参考片」，回来改一句提示词即可）· 1.11 是否要接语音转写拿原片口播（当前没接，理由见第5段） · 3.5 是否覆盖图片线 · 5.3 替换确切含义 · 3.3 本地生活案例原料
PM：2.1/2.2 内容谁沉淀（★最高）· 1.16 计费标准 · 3.1 商品库改动排期 · 5.4 模板公共化 · 全局分期
开发：1.9 时长现成方案可移植/单镜约束 （已验证可移植，见 1.9 进度栏） · 1.13 三视图重新生成入口 （已确认不受影响） · 4.x 自由创作从0做引用工作量
开发分段（「开发进度」列里「第N段」的含义）
| 段 | 内容 | 说明 |
|---|---|---|
| 第1段 | 脚本入口清扫：1.2 · 1.3 · 1.4(上传脚本部分) · 1.10 · 1.12 · 1.13 | 无前置依赖，纯前端 + 一个小接口。已完成 |
| 第2段 | 表现形式 × 视频结构 + 时长：1.5 · 1.6 · 1.7 · 1.8 · 2.1 · 2.2 · 2.3 · 1.9 · 1.1 | 第3段的时长并进来一起做了（同一排选项，不搭两遍）。已完成，2.1 套路内容是草稿，待内容同学过一遍 |
| 已并入第2段 | ||
| 暂缓。1.14/1.15 的前置（后端防重复）没做完之前不开工，否则用户刷新一次重扣一批；1.16 等 PM 定计费口径 | ||
| 第5段 | 上传视频提炼：1.11 · 补 1.4 的第三个入口 | 已完成。原判「唯一一条新基建」偏保守：读图能力和 ffmpeg 都是现成的，实际只新写了抽帧。两件要跟需求方说清的：① 没接语音转写 —— 拆解只看画面，口播词只能从画面上的字幕读；带货参考片绝大多数带硬字幕，且口播本来就要按新商品重写，所以先不接。真要原片口播，需另开火山语音识别服务（新凭证 + 新计价，约 1 段工作量）。② 拆解稿是给人改的，不是直接出片 —— 稿子落在输入框里，用户逐镜校对完再点确定；AI 自己会在稿尾列「拆解存疑」提示该重点核对哪几条 |
| 第6段 | 自由创作接三库：模块 4 | 独立支线，不碰主流程 → 提前做掉。已完成（4.4 数据迁移经判断不需要做，理由见该行） |
| 第7段 | 保存模板 + 换商品重跑：模块 5（含 1.17） | 等第2、3段参数定稿 |
| 第8段 | 本地生活：模块 3 | 依赖主流程先稳，放最后 |
主链：第1 → 2 → 6 → 5 → 7（第1、2、5、6 段已完成；第3段已并入第2段；第4段暂缓，等后端防重复补完 + PM 定计费口径再回来）；第8段放最后。
至此模块1（脚本）除 1.14/1.15/1.16 三条暂缓项外全部做完，三个脚本入口都通了。下一站是第7段（保存模板 + 换商品重跑，模块5）。
⚠️ 需要跟 PM / 客户提前说清楚的四条（听起来简单、实际有雷）
- 1.11「画面描述七要素」的具体七项，需求文档里没给。开发按「下游重拍时最少需要哪些信息」定了这七项，请需求方比对确认：① 主体（谁/什么在画面里）② 动作 ③ 场景/环境 ④ 景别（特写/中景/全景）⑤ 运镜（固定/推拉摇移/跟拍）⑥ 光线氛围 ⑦ 商品露出方式（手持/特写/使用中/未出现）。这七项是照着平台脚本已有的字段挑的，改一项要连着改脚本结构，所以趁早对齐；纯加一项文字描述则很便宜。
- 1.14 / 1.15 自动生成 —— 见上，删按钮 = 拆掉唯一的防重复措施，会重复扣积分。已暂缓。
- 5.3 视频替换 —— 客户很可能理解成「原片不动，只把里面的商品换掉」，平台实际能做的是「沿用同一套路，重新生成一条新视频」。这两件事在客户脑子里是一回事，在验收现场是两回事。代码量很小，说不清楚的代价是整批返工，务必在签字前对齐。
- 3.1 商品库「类目」字段 —— 要加的「电商 / 本地生活」跟商品库已有的「品类」（美妆/食品那种细分）是两个维度，必须新开字段。图省事塞进同一个字段，现有商品库筛选会全乱。
功能清单 v1。与《二期需求整理总纲》配套，随分期与对齐结论更新。