[Proposal]: 工作流拓扑是照视频路线定的，三渲二被迫先买一张用不上的首帧

[johnnyzhang-eng]

现状

工作流节点链是这样：

01 角色设定 → 02 身份母版 → 03 动作首帧 → 04 生产方式 → 05 完整动画 → 06 动画审核

两个问题都出在顺序上。

① 「动作首帧」是视频路线的概念。 图生视频需要一张首帧图当输入；三渲二不需要——它要的是模型 + 动作名 + 朝向，帧是渲出来的，不是生出来的。而 03 是 04 的前置，所以走三渲二的用户也被迫先花钱生一张自己用不上的首帧。

按当前单价，八向角色的这一步是 10 积分 × 8 向 × 3 候选 = 240 积分，全部白花。

② 「生产方式」排在首帧之后，等于先付钱再选路线。 顺序反了：路线决定了后面要不要首帧，就该在花钱之前问。

提议的拓扑

01 角色设定
02 身份母版          ← 3D 资产在这里建（位置不变，现在就是对的）
03 生产方式          ← 提到首帧之前，这里才是分叉点
    ├─ 视频裁剪  → 04a 动作首帧 → 05 完整动画 → 06 动画审核
    └─ 三渲二    → 04b 动作与朝向 → 05 完整动画 → 06 动画审核
                    （选动作 + 选朝向，没有首帧这一步）

05 / 06 两条路共用——两条路线最后都进同一段后处理（抠图 → 对齐 → 定标 → 打包），节点也该在这里合流。

为什么值得做

三渲二这条路线的全部价值是「一次建模，动作与朝向的边际成本趋近于零」。现行拓扑在它前面强插一道按朝向计费的首帧，等于把这个价值先削掉一大块——再叠加 #890 说的按方向整价收费，用户从账单上完全看不出选它有任何好处。

范围与风险

改的是 frontend/src/features/workflow-controller/controller.ts 的节点图与依赖关系，不是小改动，牵连 controller.test.ts 与 workflow-editor 的投影。建议单独排期，不与其他改动同批。

先在本 Issue 里对齐拓扑，定稿后再开实现 Issue。

相关：#890（按方向整价收费）、#900（建完资产角色快照不刷新）

[johnnyzhang-eng]

今晚（2026-08-29）实测到了具体数字，比这条 issue 开的时候说得更严重。

一个单向项目，角色已经建好 3D 资产、三个动作全部烘好，用户接着建了两个动作节点、准备走三渲二。积分流水：

873  character_image  n=3  18:50   身份母版            −30
874  character_image  n=3  19:41   动作首帧（节点一）   −30
875  character_image  n=3  19:41   动作首帧（节点二）   −30
                                   ────────────────
                                   已花 90，其中 60 是动作首帧

而三渲二不读首帧。RenderFrameStrategy.__init__ 的入参只有 renderer / directions / material / size / min_coverage，没有 first_frame——那是 VideoFrameStrategy 才用的东西。

所以这 60 积分买到的东西，在选定三渲二的那一刻全部作废。

更值得注意的是另一侧：建 3D 资产那一步不走用户积分账（图生 3D + 绑骨的 30 积分是上游成本口径，用户账上没有对应扣款）。合起来看：

走三渲二时，用户付的钱 100% 是为一条他不走的路线付的。

单向项目是 30 积分/节点。八向的话这一步是 10 × 8 向 × 3 候选 = 240 积分，同样全部作废。

这不是"设计不够优雅"，是先扣钱、再问你要不要。本 issue 提议的拓扑（生产方式提到首帧之前）直接消掉它。

用户原话：「关键是这个动作首帧花了图片生成的钱啊，这个很荒谬」。

[johnnyzhang-eng]

方案定稿：不加字段，只把两个节点换个顺序

前面讨论过两个更大的改法，都排除了：

排除一：把「2.5D」当作 3D 路线开关。 2.5D 是相机视角（directional_movement=3 → 八向），三渲二是生产方式——一个描述画面长什么样，一个描述怎么造出来。合并的后果是「2.5D + 视频」的用户没有入口，而且将来加第三条路线没地方放。

排除二：项目上加一个 production_route 字段。 更根本的问题是：路线不是项目属性，也不是角色属性，是每个动作的属性。同一个角色，走路可以走三渲二，攻击只能走视频——attack 与 custom 在 ACTION_MOTIONS 里映射到 None，没有对应的预设动作可烘。项目级字段表达不了这件事。

定稿

现在   03 动作首帧 → 04 生产方式 → 05 完整动画 → 06 动画审核
                     ↑ 分叉点在这里，而钱在 03 已经花掉了

改成   03 生产方式 ─┬─ 选「视频截帧」→ 04 动作首帧 → 05 完整动画 → 06 动画审核
                    └─ 选「三渲二」──────────────→ 05 完整动画 → 06 动画审核

三渲二那一支没有动作首帧节点。RenderFrameStrategy.__init__ 的入参里本来就没有 first_frame（那是 VideoFrameStrategy 才用的），所以这一步对它一直是纯支出。

这一处改动解决的问题

走三渲二被迫先买一张用不上的首帧	消失。单向 30 积分 / 八向 240 积分，全部省下
先付钱、再选路线	顺序正过来
路线粒度不对	落到每个动作上，与 ACTION_MOTIONS 的真实约束对齐
游戏视角被迫承担路线语义	不用碰，它继续只管朝向
存量项目怎么迁移	不存在——没有新字段

「生产方式」节点的可选性判据

两条判据代码里都已经有了，只是问得太晚：

三渲二可选 ⟺ 该造型 3D 资产已就绪（outfit.model_3d_url 非空）
             且 该动作在可烘集合里（ACTION_MOTIONS[action] 非 None）

不满足时置灰并写明原因，别只说「不可用」：

• 「该造型还没有 3D 资产，先建资产再选这条路线」
• 「攻击 / 自定义动作没有对应的预设动作，只能走视频截帧」

范围与风险

只改 frontend/src/features/workflow-controller/controller.ts 的节点图：加动作时先建生产方式节点，选完再决定要不要建动作首帧节点。不动后端、不动数据库、不动视角定义。

牵连 controller.test.ts 与 workflow-editor 的节点投影，建议单独排期、不与其他改动同批。

相关

• 三渲二按 i2v 的整价收 50 积分，而它的上游调用数是 0 #890 三渲二按 i2v 整价收费（同一个根：三渲二的成本优势没有传给用户）
• [Bug]: 建完 3D 资产后角色快照不刷新，「生产方式」永远显示「暂无绑骨 3D 模型」 #900 建完资产角色快照不刷新（已修）
• [Bug]: 先传参考图会报「prompt 不能为空」，用户被迫先写描述 #907 先传参考图会丢图（已修）
• [Bug]: 用户上传的参考图不能直接当母版，只能眼看着系统拿它重画 #908 上传的图不能直接当母版（已修）

后三条都是「决策顺序错了」在不同位置的表现。