1

docs/technical/AI_CHARACTER_ANIMATION_TECHNICAL_SOLUTION_2026-04-04.md

@@ -265,6 +265,15 @@
 
 但对“第一版角色动作资产生产”来说，它更适合作为增强通道，不建议先做成唯一主依赖。
 
+实现更新（`2026-04-19`）：
+
+- 当前仓库的 `image-to-video` 角色动作生成入口已切到火山方舟 `Seedance`
+- 采用双参考图首尾帧方案：图片 1 约束首帧，图片 2 约束尾帧
+- 当前请求体中的两张参考图角色分别固定为 `first_frame / last_frame`
+- 当前固定参数为 `1:1`、`480p`、`4 秒`、单次 `1` 个视频
+- 当前固定动作入口收敛为 `idle / run / attack / die`，不再内置固定 `hurt`
+- 提示词里传给视频模型的动作名统一使用英文动作名
+
 ## 5.3 补充路线：腾讯云相关能力
 
 腾讯云相关接口里，`提交图片跳舞任务` 提供了：
@@ -422,12 +431,12 @@
 - `idle`
 - `run`
 - `attack`
-- `jump`
-- `hurt`
 - `die`
 
 系统自动选择对应参考视频模板。
 
+`jump`、`hurt` 这类扩展动作不再作为当前编辑器固定按钮，改为后续扩展动作槽位或手动补齐。
+
 ### B. 视频驱动
 
 用户上传参考动作视频，系统抽姿态后再生成角色动作。
@@ -498,6 +507,8 @@ flowchart LR
 - 文生图时，优先生成与当前项目角色素材视角一致的单人全身图
 - 有参考图时，优先做“角色指定 + 风格收敛 + 视角纠偏”
 - 用户直接上传素材时，先做校验、裁切、背景清理和尺寸标准化
+- 编辑器未上传参考图时，主形象阶段默认附加一张由项目内可扮演角色 idle 帧拼成的风格参考板，用来锁定像素动作角色的轮廓语言、右朝向、体型比例与配色组织，避免模型只放大 Q 版比例却丢掉像素感
+- 风格约束优先级里，“像素动作角色感”高于“Q 版比例提示”；比例只允许轻度偏大头，不允许退化成普通软萌插画或儿童绘本风
 
 ### 角色视角要求
 
@@ -623,6 +634,16 @@ flowchart LR
 8. 生成 Sprite Sheet
 9. 输出动画元数据
 
+### 当前工程的抠像补充策略
+
+针对角色动作视频抽帧后常见的“后段帧出现白底”“角色轮廓残留绿幕像素点”问题，当前工程内的背景清理不再只依赖单一绿幕阈值，而是统一改为以下顺序：
+
+1. 先识别边界连通的可移除背景区域，同时覆盖纯绿色绿幕和高亮低色差白底。
+2. 再向主体边缘的半透明软边做一轮有限扩张，把压缩后残留的白边、绿边纳入透明化处理。
+3. 最后对贴近透明边缘的像素做去污，优先压掉绿色溢色，并把白边/绿边颜色拉回附近前景主体颜色，减少抽帧后的轮廓发白、发绿。
+
+这样可以避免把角色内部的白色高光、白色装备整体误删，同时能更稳定地清理视频模型在末段帧里偶发的白背景和压缩噪点。
+
 ### 像素化策略
 
 推荐做法：
@@ -703,7 +724,14 @@ export interface GeneratedCharacterAnimationAsset {
   id: string;
   characterId: string;
   visualAssetId: string;
-  action: BaseAnimationSlot | 'cast' | 'talk' | 'skill1' | 'skill2' | 'skill3' | 'skill4';
+  action:
+    | BaseAnimationSlot
+    | 'cast'
+    | 'talk'
+    | 'skill1'
+    | 'skill2'
+    | 'skill3'
+    | 'skill4';
   sourceProvider: 'aliyun-wan' | 'volc-seedance' | 'tencent' | 'local';
   sourceMode: 'template' | 'video-drive' | 'audio-drive';
   frameCount: number;
@@ -914,20 +942,26 @@ draft
 
 第一版要求以下基础动作槽位全部有内容：
 
-| 动作槽位 | 是否必填 | 建议来源 |
-| --- | --- | --- |
-| `idle` | 必填 | 模板生成 |
-| `acquire` | 必填 | 可由短持物 / 抬手动作生成 |
-| `attack` | 必填 | 模板生成 |
-| `run` | 必填 | 模板生成 |
-| `jump` | 必填 | 模板生成 |
-| `double_jump` | 必填 | 可由跳跃二次变体生成 |
-| `jump_attack` | 必填 | 跳跃攻击模板 |
-| `dash` | 必填 | 冲刺模板 |
-| `hurt` | 必填 | 受击模板 |
-| `die` | 必填 | 倒地 / 消散模板 |
-| `climb` | 必填 | 攀爬模板 |
-| `wall_slide` | 必填 | 可由攀爬或停滞帧变体生成 |
+当前编辑器固定生成入口补充说明（`2026-04-19`）：
+
+- 固定按钮只保留 `idle / run / attack / die`
+- `hurt` 不再作为固定生成按钮
+- 如果运行时仍需 `hurt` 资源，应通过后续扩展动作槽位或手动补齐
+
+| 动作槽位      | 是否必填 | 建议来源                  |
+| ------------- | -------- | ------------------------- |
+| `idle`        | 必填     | 模板生成                  |
+| `acquire`     | 必填     | 可由短持物 / 抬手动作生成 |
+| `attack`      | 必填     | 模板生成                  |
+| `run`         | 必填     | 模板生成                  |
+| `jump`        | 必填     | 模板生成                  |
+| `double_jump` | 必填     | 可由跳跃二次变体生成      |
+| `jump_attack` | 必填     | 跳跃攻击模板              |
+| `dash`        | 必填     | 冲刺模板                  |
+| `hurt`        | 必填     | 受击模板                  |
+| `die`         | 必填     | 倒地 / 消散模板           |
+| `climb`       | 必填     | 攀爬模板                  |
+| `wall_slide`  | 必填     | 可由攀爬或停滞帧变体生成  |
 
 这里“不能为空”指的是：
 
@@ -961,14 +995,13 @@ draft
 
 先优先做这些高价值模板：
 
-| 模板 | 推荐时长 | 是否循环 | 说明 |
-| --- | --- | --- | --- |
-| `idle` | 2s-4s | 是 | 微动作、呼吸 |
-| `run` | 2s-3s | 是 | 固定侧向 |
-| `attack` | 2s-4s | 否 | 近战基础攻击 |
-| `jump` | 1s-2s | 否 | 起跳与空中姿态 |
-| `hurt` | 1s-2s | 否 | 受击短动作 |
-| `die` | 2s-4s | 否 | 倒下或消散 |
+| 模板     | 推荐时长 | 是否循环 | 说明           |
+| -------- | -------- | -------- | -------------- |
+| `idle`   | 2s-4s    | 是       | 微动作、呼吸   |
+| `run`    | 2s-3s    | 是       | 固定侧向       |
+| `attack` | 2s-4s    | 否       | 近战基础攻击   |
+| `jump`   | 1s-2s    | 否       | 起跳与空中姿态 |
+| `die`    | 2s-4s    | 否       | 倒下或消散     |
 
 ### 12.4 不建议第一阶段就重投入的动作