Files
Oshima-Game/docs/2D角色分解素材规范.md
2026-09-19 17:24:02 +08:00

536 lines
51 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
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.
# 《筽祀牻》2D 角色分解素材规范(以 02 汐月心音为例)
> 状态:4.75 头身与四方向移动方案已确认;运行时 LEFT(旧 `front-right`)、RIGHT(旧 `front-left`)、DOWN 与 UP 均已完成中性装配、待机/投掷运动及 176/132/88 px 三档循环播放验证;模板角色交付包 v1 与统一接入清单已完成;P0 v2 与 P1 v2 动作关键姿势已完成
> 适用目标:Godot 斜俯视战棋中的纯 2D 单位,固定镜头,脚底中心锚定
> 参考素材:`assets/images/characters/cards/汐月心音:银月刺客卡.png`、`assets/images/characters/overviews/铎京派系五人角色设定图.png`、02 号角色头像与技能图标
## 1. 结论
首个战场角色建议采用 **4.5~5 头身的轻 Q 版战斗比例**,而不是现有立绘约 7~7.5 头身的成体比例,也不采用 2~3 头身的大头萌系 Q 版。
2026-09-18 已通过比例对比图确认以 **4.75 头身**作为汐月心音及后续战场角色的首选测试基线。该比例仍需在实际 Godot 灰盒场景中验证,验证通过后再上升为全角色硬性规范。
若只能在“成体”和“Q 版”中二选一,应选 **Q 版**;但最终美术应明确标注为“轻 Q/战斗比例”,避免过度幼态化。
理由:
- 战场基础格为 128 × 64 px,常用镜头需同时显示约 10~14 格宽。正常人体比例缩小后,头、手、暗器与动作方向很难辨认。
- 心音的识别点是高马尾、银色羽刃、银肩甲、月白外衫和朱砂红绳。这些元素需要更大的头身占比、手部动作和轮廓面积。
- 轻 Q 比例可以保留她冷静、利落的成年刺客气质;纯萌系 Q 版会削弱离岸监狱、暗杀和铎京政治线的严肃感。
- 轻 Q 角色更容易与半隐藏网格、掩体和 HUD 共存,也便于后续 18 名角色统一剪影语言。
建议先做同一姿势的三档缩放测试:7 头身、4.75 头身、3 头身。将角色分别按战场显示高度 160、176、192 px 放入 128 × 64 菱形格和铎京灰盒地图,以 100%、75%、50% 三档镜头检查。默认候选为 **4.75 头身、显示高度约 176 px**。
## 2. 技术路线
心音适合作为 `Skeleton2D` 分解动画范例。源文件保留分层部件,Godot 中用骨骼完成呼吸、移动、瞄准、受击等连续动作;必要时把动画烘焙为 `AnimatedSprite2D` 序列帧,以兼容性能和批量生产。
不要为每一帧绘制完整人物。需要绘制的是:
1. 每个方向的中性战斗姿势分解件;
2. 关节弯曲时会露出的替换件;
3. 手型、脚型、表情和裙摆/马尾极端形变;
4. 每个动作的关键姿势参考;
5. 与角色身体分离的暗器、残影、月轮和命中特效。
正式品质改用四个画面方向:`up / down / left / right`。左右方向保留三分之四侧身表现,不要求严格正侧面;上下方向分别使用背面与正面构图。心音的发饰、腰包、持刃手和马尾存在固定不对称关系,因此 LEFT 与 RIGHT 仍需独立绘制,禁止通过水平镜像互相生成。
运行时映射暂定为:`left ← 旧 front-right`,`right ← 旧 front-left`;旧目录与清单暂不重命名,以免破坏已有提取、装配和运动路径。新制作的 UP/DOWN 及未来统一导出文件直接使用四方向名称。移动输入按主轴选择身体朝向,斜向临界区保持上一朝向以避免闪烁;身体只使用四向,但投射物、准星和技能 VFX 可以自由角度瞄准。
所有方向都以脚底中心为统一原点。人物贴图不烘焙脚底阴影、选中环、格子高亮和命中特效。
## 3. 首批动作清单
### P0:战斗竖切必需
| 动作 | 建议时长 | 关键姿势/图片 | 心音的表现重点 |
|---|---:|---:|---|
| `idle` 待机 | 1.8~2.4 s 循环 | 2 个极值姿势 | 重心微降,呼吸克制;手指靠近袖中羽刃;马尾与短披风低幅摆动 |
| `move` 移动 | 0.7~0.9 s 循环 | 4 个步态极值 | 轻跑而非普通走路;上身稳定、步幅轻快;不能像重装角色一样上下弹跳 |
| `attack_1` 普攻首击 | 0.35~0.5 s | 预备、出手、收势 3 张 | 单手甩出一枚羽刃,动作短、直、无大幅蓄力 |
| `attack_2` 被动追击 | 0.25~0.4 s | 换手、追刃、回正 3 张 | 与首击明显不同,建议反手追加两枚较小羽刃,表现“心灵之弦”的双段普攻 |
| `burst` 千羽瞬华 | 1.0~1.4 s | 起势、展开、指向、收束 4 张 | 低身洞悉弱点,旋身展开羽阵,最后并指锁定目标;月轮和羽群独立为特效层 |
| `hit` 受击 | 0.25~0.4 s | 受力极值、恢复 2 张 | 侧身卸力,幅度小但方向清晰;高马尾延迟甩动 |
| `defeat` 倒下 | 0.9~1.3 s + 静止 | 失衡、跪地、侧倒、地面 4 张 | 羽刃脱手但不飞远,最终轮廓不能超出单格太多 |
### P1:体现角色机制,建议与 P0 同批设计
| 动作 | 关键姿势/图片 | 用途 |
|---|---:|---|
| `ready` 观察/备战 | 2 张 | 轮到角色行动、选择目标时使用;视线先于身体转向 |
| `dodge` 闪避 | 压低、侧移、残影 3 张 | 对应爆发技提升闪避;身体瞬移,残影与月色轨迹独立 |
| `weakpoint_lock` 弱点锁定 | 观察、抬手标记 2 张 | 技能预览或暴露弱点时使用,强化“先观察后行动”的人设 |
| `cover_idle` 掩体待机 | 进入、贴靠、探身 3 张 | 地图已有掩体规则,避免角色站在墙后仍保持开阔地待机 |
| `cover_attack` 掩体出手 | 探身、投掷、收回 3 张 | 保持快速投掷,不让身体大面积穿过掩体 |
### P2:通用系统与展示扩展
- `item_use`:取物、使用、归位。
- `cast`:通用魔法起势与释放;法术本体独立为公共特效。
- `interact`:操作机关、拾取或开启目标。
- `victory`:确认安全后收回羽刃,不做活泼庆祝动作。
- `spawn`:从月色残影中落地,适合战斗开场。
- `revive`:跪地恢复到警戒姿势。
- `heavy_hit / knockback`:明显位移或破防时使用。
P0 共需约 20 张动作关键姿势参考;P1 再增加约 13 张。这些是动画设计稿数量,不等于最终逐帧图片数量。
## 4. 汐月心音的分解部件
### 身体基础
- 头部/颈部;
- 胸腔/腹部/骨盆;
- 左右上臂、前臂、手掌;
- 左右大腿、小腿、脚掌;
- 肩、肘、腕、髋、膝、踝部都需保留足够重叠区,旋转后不能露缝。
### 头发与面部
- 后脑基础发团、前刘海、左右鬓发;
- 高马尾根部、主马尾 2~3 段、末端散发;
- 银蓝发绳与羽形发簪独立;
- 眼白/虹膜/上眼睑、眉、嘴独立;
- 至少准备平静、专注、受击、虚弱 4 组表情,以及普通瞳和羽状发光瞳。
### 服装与硬质件
- 月白交领内衫、深靛胸腰甲、腰封;
- 左右肩部银色羽片护甲;
- 左右袖片、前裙片、后裙片、侧裙片分别拆开;
- 短披风至少拆成左、中、右三片;
- 朱砂腰绳、流苏和暗器袋独立;
- 护腕、腿甲与靴面尽量跟随对应肢体,但硬质尖角可单独切片以避免变形。
### 武器与特效挂点
- 单枚“千羽”、双枚追击羽刃、手持三枚扇形羽刃;
- 发簪形态与投掷形态分别绘制;
- 袖口、腰侧、发簪三个出刃挂点;
- 右手/左手握持点、目标锁定点、身体中心特效点、脚底特效点;
- 月轮、飞行羽群、轨迹、残影、弱点标记、命中闪光全部放入独立 VFX 图集,不与身体切片合并。
## 5. 需要制作的图稿
1. **比例测试图**:7 头身、4.75 头身、3 头身并排,附 128 × 64 格与实际战场缩放预览。
2. **四方向转面图**:UP/DOWN/LEFT/RIGHT 使用统一中性战斗姿势,先确认剪影、服装前后关系和光源。
3. **四方向分解源文件**:每个方向一组完整图层,关节重叠区与旋转轴清楚可见。
4. **P0 动作关键姿势表**:约 20 个关键姿势,先以 LEFT 与 RIGHT 验证动作语言,再扩展到 UP/DOWN。
5. **表情与替换件表**:眼、眉、嘴、手型、脚型、裙摆和马尾极端形变。
6. **千羽与 VFX 表**:暗器本体、月轮路径、残影、弱点标记和命中闪光。
7. **游戏内合成预览**:放入铎京灰盒地图,展示待机、移动、普攻、爆发、受击和倒下。
制作顺序调整为 `比例测试 → LEFT/RIGHT 三分之四侧身 → 左右完整分解与运动验证 → DOWN 正面 → UP 背面 → 游戏内四向验证`。不再生产八方向整套角色身体;斜向攻击由四向身体、手臂姿势与自由角度 VFX 共同表达。
当前已完成:
- `assets/images/2d-game-characters/02-xinyin/direction-map-v1.json`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-4way-direction-map-v1.png`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-proportion-comparison-v1.png`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-4dir-turnaround-v1.png`
- `assets/images/2d-game-characters/02-xinyin/source/xinyin-front-right-parts-sheet-v1.png`
- `assets/images/2d-game-characters/02-xinyin/source/action-keyposes/xinyin-p0-idle-move-attacks-v1.png`
- `assets/images/2d-game-characters/02-xinyin/source/action-keyposes/xinyin-p0-burst-hit-defeat-v1.png`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-action-readability-test-v1.png`
- `assets/images/2d-game-characters/02-xinyin/source/action-keyposes/xinyin-p0-corrections-v2.png`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-action-readability-test-v2.png`
- `assets/images/2d-game-characters/02-xinyin/source/action-keyposes/xinyin-p1-ready-dodge-weakpoint-v1.png`
- `assets/images/2d-game-characters/02-xinyin/source/action-keyposes/xinyin-p1-cover-v1.png`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-p1-readability-test-v1.png`
- `assets/images/2d-game-characters/02-xinyin/source/action-keyposes/xinyin-p1-ready-dodge-weakpoint-v2.png`
- `assets/images/2d-game-characters/02-xinyin/source/action-keyposes/xinyin-p1-cover-left-v1.png`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-p1-readability-test-v2.png`
- `assets/images/2d-game-characters/02-xinyin/parts/front-right/v1/`(40 件独立透明 PNG)
- `assets/images/2d-game-characters/02-xinyin/parts/front-right/v1/parts-manifest.json`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-front-right-extracted-parts-v1.png`
- `assets/images/2d-game-characters/02-xinyin/reference/xinyin-front-right-assembled-reference-v1.png`
- `assets/images/2d-game-characters/02-xinyin/assembled/front-right/xinyin-front-right-neutral-assembly-v4.png`
- `assets/images/2d-game-characters/02-xinyin/assembled/front-right/assembly-layout-v4.json`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-front-right-assembly-validation-v4.png`
- `assets/images/2d-game-characters/02-xinyin/motion/front-right/v3/`(7 个透明运动关键帧与清单)
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-front-right-motion-validation-v3.png`
- `assets/images/2d-game-characters/02-xinyin/previews/playback/xinyin-front-right-idle-scale-loop-v1.gif`
- `assets/images/2d-game-characters/02-xinyin/previews/playback/xinyin-front-right-throw-scale-loop-v1.gif`
- `assets/images/2d-game-characters/02-xinyin/motion/front-right/v3/playback-report.json`
- `assets/images/2d-game-characters/02-xinyin/source/rig-corrections/xinyin-front-right-rig-corrections-v1.png`(首版对照,马尾未正确分段)
- `assets/images/2d-game-characters/02-xinyin/source/rig-corrections/xinyin-front-right-rig-corrections-v2.png`(采用的补件源板)
- `assets/images/2d-game-characters/02-xinyin/parts/front-right/rig-corrections-v1/`(11 件透明补件与清单)
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-front-right-rig-corrections-v1.png`
- `assets/images/2d-game-characters/02-xinyin/source/front-left/xinyin-front-left-neutral-master-v1.png`(方向探索稿,保留作对照)
- `assets/images/2d-game-characters/02-xinyin/source/front-left/xinyin-front-left-neutral-master-v2.png`(当前前左高分辨率母版)
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-front-left-master-validation-v1.png`
- `assets/images/2d-game-characters/02-xinyin/source/front-left/xinyin-front-left-core-parts-sheet-v1.png`(17 件核心身体/四肢)
- `assets/images/2d-game-characters/02-xinyin/source/front-left/xinyin-front-left-soft-parts-sheet-v1.png`(26 件头发/衣摆/附件)
- `assets/images/2d-game-characters/02-xinyin/source/front-left/source-sheet-manifest-v1.json`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-front-left-parts-sheets-validation-v1.png`
- `assets/images/2d-game-characters/02-xinyin/parts/front-left/v1/`(43 件独立透明 PNG)
- `assets/images/2d-game-characters/02-xinyin/parts/front-left/v1/parts-manifest.json`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-front-left-extracted-parts-v1.png`
- `assets/images/2d-game-characters/02-xinyin/assembled/front-left/xinyin-front-left-neutral-assembly-v1.png`(首次装配候选,保留作对照)
- `assets/images/2d-game-characters/02-xinyin/assembled/front-left/xinyin-front-left-neutral-assembly-v2.png`(当前中性装配基线)
- `assets/images/2d-game-characters/02-xinyin/assembled/front-left/assembly-layout-v2.json`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-front-left-assembly-validation-v2.png`
- `assets/images/2d-game-characters/02-xinyin/source/rig-corrections/xinyin-front-left-rig-corrections-v1.png`(首版对照,马尾仍为大块候选)
- `assets/images/2d-game-characters/02-xinyin/source/rig-corrections/xinyin-front-left-rig-corrections-v2.png`(采用的前左补件源板)
- `assets/images/2d-game-characters/02-xinyin/parts/front-left/rig-corrections-v1/`(5 件透明补件与清单)
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-front-left-rig-corrections-v1.png`
- `assets/images/2d-game-characters/02-xinyin/assembled/front-left/xinyin-front-left-neutral-assembly-v4.png`(补件后的当前基线)
- `assets/images/2d-game-characters/02-xinyin/assembled/front-left/assembly-layout-v4.json`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-front-left-assembly-validation-v4.png`
- `assets/images/2d-game-characters/02-xinyin/motion/front-left/v1/`(运行时 RIGHT 的 7 个透明运动关键帧与清单)
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-front-left-motion-validation-v1.png`
- `assets/images/2d-game-characters/02-xinyin/previews/playback/xinyin-front-left-idle-scale-loop-v1.gif`
- `assets/images/2d-game-characters/02-xinyin/previews/playback/xinyin-front-left-throw-scale-loop-v1.gif`
- `assets/images/2d-game-characters/02-xinyin/motion/front-left/v1/playback-report.json`
- `assets/images/2d-game-characters/02-xinyin/source/down/xinyin-down-neutral-master-generation-v1.png`(内置图像生成的留档结果)
- `assets/images/2d-game-characters/02-xinyin/source/down/xinyin-down-neutral-master-v1.png`(增加透明安全边距后的当前 DOWN 母版)
- `assets/images/2d-game-characters/02-xinyin/source/down/master-manifest-v1.json`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-down-master-validation-v1.png`
- `assets/images/2d-game-characters/02-xinyin/source/down/xinyin-down-core-parts-sheet-v1.png`(17 件核心身体/四肢)
- `assets/images/2d-game-characters/02-xinyin/source/down/xinyin-down-soft-parts-sheet-v1.png`(拥挤排布的失败对照,保留用于追溯)
- `assets/images/2d-game-characters/02-xinyin/source/down/xinyin-down-soft-parts-sheet-v2.png`(当前 24 件头发/衣摆/附件板)
- `assets/images/2d-game-characters/02-xinyin/source/down/source-sheet-manifest-v1.json`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-down-parts-sheets-validation-v1.png`
- `assets/images/2d-game-characters/02-xinyin/parts/down/v1/`(41 件独立透明 PNG)
- `assets/images/2d-game-characters/02-xinyin/parts/down/v1/parts-manifest.json`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-down-extracted-parts-v1.png`
- `assets/images/2d-game-characters/02-xinyin/assembled/down/xinyin-down-neutral-assembly-v1.png`
- `assets/images/2d-game-characters/02-xinyin/assembled/down/assembly-layout-v1.json`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-down-assembly-validation-v1.png`
- `assets/images/2d-game-characters/02-xinyin/motion/down/v1/`(7 个透明运动关键帧与清单)
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-down-motion-validation-v1.png`
- `assets/images/2d-game-characters/02-xinyin/previews/playback/xinyin-down-idle-scale-loop-v1.gif`
- `assets/images/2d-game-characters/02-xinyin/previews/playback/xinyin-down-throw-scale-loop-v1.gif`
- `assets/images/2d-game-characters/02-xinyin/motion/down/v1/playback-report.json`
- `assets/images/2d-game-characters/02-xinyin/source/up/xinyin-up-neutral-master-generation-v1.png`(内置图像生成的留档结果)
- `assets/images/2d-game-characters/02-xinyin/source/up/xinyin-up-neutral-master-v1.png`(增加透明安全边距后的当前 UP 母版)
- `assets/images/2d-game-characters/02-xinyin/source/up/master-manifest-v1.json`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-up-master-validation-v1.png`
- `assets/images/2d-game-characters/02-xinyin/source/up/xinyin-up-core-parts-sheet-v1.png`(上臂仍带袖披的失败对照)
- `assets/images/2d-game-characters/02-xinyin/source/up/xinyin-up-core-parts-sheet-v2.png`(采用的 17 件核心板)
- `assets/images/2d-game-characters/02-xinyin/source/up/xinyin-up-soft-parts-sheet-v1.png`(肩甲/流苏层级混入的失败对照)
- `assets/images/2d-game-characters/02-xinyin/source/up/xinyin-up-soft-parts-sheet-v2.png`(采用的 24 件软性/附件板)
- `assets/images/2d-game-characters/02-xinyin/source/up/source-sheet-manifest-v1.json`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-up-parts-sheets-validation-v1.png`
- `assets/images/2d-game-characters/02-xinyin/parts/up/v1/`(41 件独立透明 PNG)
- `assets/images/2d-game-characters/02-xinyin/parts/up/v1/parts-manifest.json`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-up-extracted-parts-v1.png`
- `assets/images/2d-game-characters/02-xinyin/assembled/up/xinyin-up-neutral-assembly-v1.png`
- `assets/images/2d-game-characters/02-xinyin/assembled/up/assembly-layout-v1.json`
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-up-assembly-validation-v1.png`
- `assets/images/2d-game-characters/02-xinyin/motion/up/v1/`(7 个透明运动关键帧与清单)
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-up-motion-validation-v1.png`
- `assets/images/2d-game-characters/02-xinyin/previews/playback/xinyin-up-idle-scale-loop-v1.gif`
- `assets/images/2d-game-characters/02-xinyin/previews/playback/xinyin-up-throw-scale-loop-v1.gif`
- `assets/images/2d-game-characters/02-xinyin/motion/up/v1/playback-report.json`
- `assets/images/2d-game-characters/02-xinyin/template-package-v1.json`(四方向模板角色统一入口)
- `assets/images/2d-game-characters/02-xinyin/previews/xinyin-template-role-handoff-v1.png`
- `docs/02汐月心音模板角色交付说明.md`
- `templates/2d-character-v1/template-manifest.json`(后续角色的空白模板入口)
- `templates/2d-character-v1/production-checklist.md`
- `tools/scaffold_2d_character.py`
前右方向已按 8 邻域透明连通对象从源板中无串片拆出 40 件 PNG,每件保留 8 px 安全边距。清单记录源图裁切框、导出尺寸、建议层级和初始枢轴;左侧整身图单独保存为装配参考,不计入 40 件运行时部件。原始部件包仍标记为 `extracted-unvalidated`;11 件骨骼补件、美术侧中性站姿装配 v4 与关键帧运动验证 v3 已通过,引擎插值、关节补缝和游戏内缩放尚未验证。
当前没有 Godot 项目,故本阶段只完成可复现的美术资产拆分与元数据准备。`tools/Inspect-XinyinPartsSheet.ps1` 用于复查任意透明源板的对象编号,`tools/Extract-XinyinParts.ps1` 可从原始源板重新生成整套部件、清单、整身参考和检查总览,`tools/Extract-XinyinRigCorrections.ps1` 用于生成骨骼补件包,`tools/Build-XinyinAssemblyValidation.ps1` 与 `tools/Build-XinyinMotionValidation.ps1` 分别重建前右中性站姿和运动关键帧,`tools/build_xinyin_front_left_motion.py` 从前左装配 v4 重建运行时 RIGHT 的运动帧,`tools/build_xinyin_down_assembly.py` 与 `tools/build_xinyin_down_motion.py` 从正面部件重建 DOWN 中性站姿和运动关键帧,`tools/build_xinyin_up_master_validation.py` 与 `tools/build_xinyin_up_source_sheets_validation.py` 整理并验证 UP 母版和 17+24 件分解源板,`tools/extract_xinyin_up_parts.py` 从采用的两张 v2 源板重建 41 件 UP 独立部件、清单与检查总览,`tools/build_xinyin_up_assembly.py` 与 `tools/build_xinyin_up_motion.py` 分别重建 UP 的 32 件中性装配及 7 帧动作;通用 `tools/build_xinyin_motion_playback.py` 已支持 LEFT/RIGHT/DOWN/UP 四个运行时方向的三档循环复查,`tools/build_xinyin_template_package.py` 校验并重建统一交付清单和四向总览,`tools/scaffold_2d_character.py` 则为后续角色安全创建标准目录与初始配置。这些流程均不会覆盖原始源板或已有角色目录。
四方向运行时映射 v1:
- `left` 使用旧 `front-right` 美术包,人物鼻尖和持扇动作朝向画面左侧;该方向已经完成中性装配、待机/投掷运动与三档循环验证;
- `right` 使用旧 `front-left` 美术包,人物鼻尖和持扇动作朝向画面右侧;该方向已经完成中性装配 v4、骨骼补件及待机/投掷运动验证 v1;
- `up` 已完成严格背面高分辨率母版 v1、17+24 件分解源板、41 件独立裁切、32 件中性装配、待机/投掷运动及三档循环验证;`down` 已完成新正面高分辨率母版 v1、41 件独立裁切、32 件中性装配、待机/投掷运动与三档循环验证;旧四斜向转面图只保留为造型参考,不再作为最终方向数量;
- 旧目录保持不变,运行时或未来导出流程通过 `template-package-v1.json` 进入,再由 `direction-map-v1.json` 读取别名;新方向和最终标准化文件只使用 `up / down / left / right`;
- 方向选择使用主轴与 15% 斜向滞回区:横轴明显占优时选择 LEFT/RIGHT,纵轴明显占优时选择 UP/DOWN,临界区保持上一朝向;瞄准、投射物和 VFX 不受四向身体限制。
DOWN 正面母版 v1 结论:
- 新母版严格使用正面构图,头、胸和骨盆均朝向玩家,不沿用旧四斜向转面图中的三分之四角度,也不由 LEFT/RIGHT 镜像生成;
- 角色右手固定在画面左侧持三枚蓝银羽扇,角色左侧腰包和放松手固定在画面右侧;高马尾与外衣可以形成不对称轮廓,但双脚基线和身体主轴保持对称;
- 生成留档为 1024 × 1536 px 透明 PNG;正式母版增加 64 px 透明安全边距,画布为 1152 × 1664 px,可见 Alpha 范围为 957 × 1448 px,四边均未触碰;
- 母版采用约 4.75 头身的成年轻 Q 战斗比例;缩放到 352/176/88 px 后,高马尾、银羽肩甲、蓝银羽扇、白蓝衣摆和朱砂红绳仍可辨认;
- 母版本身状态为 `master-art-validated`;其核心/软性源板、独立裁切、中性装配与待机/投掷动作验证均已完成。
DOWN 分解源板 v1 结论:
- 核心板为 1536 × 1024 px 透明画布,检测到 17 个独立对象:头面、颈部、上身、骨盆、双肩甲、独立双上臂、双前臂、三种手型及双腿;肩甲、上臂、前臂和手没有互相粘连;
- 软性板首稿把八片衣摆的半透明边缘连成大块,保留为失败对照;v2 改用 6×4 隐形生产网格,每格只放一个对象,检测到 24 个独立对象;
- 软性板 v2 包含前发、后发帽、马尾根/中/尾、长银饰、双袖披、八片中性衣摆、一片动作替换衣摆、腰前布、腰包、双流苏及三种羽刃;
- 两张采用源板合计 41 件,在 Alpha 阈值 16、最小面积 80、8 邻域检测下均无跨件连接,画布四角透明;
- 源板状态为 `source-sheets-alpha-validated`;部件名称、父子层级、根枢轴与远端关节已经写入正式清单,并通过中性装配冻结当前取舍。
DOWN 独立部件包 v1 结论:
- 两张采用源板已按 Alpha 阈值 16 的 8 邻域连通对象裁切为 41 件独立透明 PNG,每件四周保留 10 px 安全边距;41 件均未触碰导出边缘;
- 核心件使用 `down-core-cNN-*`,软性件使用 `down-soft-cNN-*`,编号可回溯到源板诊断图;软性板 v1 不参与裁切,正式来源固定为 v2;
- A 组冻结为画面左侧/角色右侧/持扇手链,B 组冻结为画面右侧/角色左侧/放松手链;DOWN 严禁通过水平镜像交换这两组;
- `parts-manifest.json` 为每件记录源裁切框、输出尺寸、父节点、建议层级、根枢轴与下一关节点;红色十字为根枢轴,蓝色十字为下一关节;
- 原始部件包仍保留 `extracted-unvalidated` 状态,以区分“单件裁切”和“组合验证”;衣摆取舍、马尾链连接、手腕连续性和脚底基线已经由装配清单 v1 冻结。
DOWN 中性装配 v1 结论:
- 600 × 760 px 透明画布使用 32 件中性部件,另外 9 件作为投掷手、独立武器、替换衣摆/腰饰保留;41 件全部有明确去向,没有遗漏或重复使用;
- A 组保持画面左侧持扇,B 组保持画面右侧放松;肩—肘—腕通过关节内压重叠消除切口,三段马尾保持画面右后方轮廓,八片衣摆收束到骨盆挂点后再向两侧展开;
- 左右靴的 Alpha 脚底均落在 `y = 734`,基线差为 0 px;成图可见范围为 `x = 128..475`、`y = 93..734`,四边保持透明;
- `pelvis-hip-core` 已包含中性腰前布、红绳、流苏与腰包,因此对应独立件不在中性装配中重复叠画;动作时可按清单替换;
- 静态装配状态为 `static-art-validated`;其上制作的动作关键帧与三档循环也已通过,方向总状态见下节。
DOWN 动作验证 v1 结论:
- 已导出待机吸气/中性/呼气 3 帧及投掷准备/蓄势/释放/回收 4 帧,全部采用 600 × 760 px 透明画布;七帧脚底 Alpha 均落在 `y = 734`,基线差为 0 px,画布四边透明;
- 身体主轴始终保持严格正面,持扇 A 手从画面左侧蓄势并向左完全展开;释放帧切换为张手和单枚脱手羽刃,投射物与 VFX 的实际瞄准仍由运行时自由角度控制;
- 放松 B 手保持稳定,三段马尾和八片衣摆仅作滞后摆动;当前幅度内未出现明显断缝、穿脸或脚底漂移;
- 176/132/88 px 循环共用固定裁切框与脚底原点,不按帧重新居中;待机周期为 1360 ms,投掷回到中性的周期为 790 ms;
- 当前方向状态提升为 `motion-art-validated`。UP 背面母版、分解源板、独立部件包与中性装配已经完成,后续进入运动验证。
UP 背面母版 v1 结论:
- 新母版严格使用背面构图,后脑、肩背、躯干、骨盆、膝后与鞋跟均朝向玩家;没有露出脸部或侧脸,也没有沿用旧转面图的三分之四角度;
- 转身后的固定侧别为:角色右手/画面右侧持三枚蓝银羽刃,角色左手与黑色腰包位于画面左侧,长银花发饰和高马尾主体也向画面左后方展开;该关系不是对 DOWN 的简单水平镜像;
- 图像生成留档为 1044 × 1507 px 透明 PNG;正式母版置于 1152 × 1664 px 透明画布,可见 Alpha 范围为 998 × 1426 px,四边均未触碰;左右可见底部分别为 `y = 1520 / 1521`,差 1 px;
- 背部高领、肩带、银羽肩甲、红色腰绳、后腰结、腰包、八片衣摆、流苏、腿甲与鞋跟均具有可分解轮廓;352/176/88 px 下马尾、持扇手、白蓝衣摆和红绳仍可辨认;
- 母版状态为 `master-art-validated`;其核心身体/肢体板与软性部件/附件板也已完成,结论见下节。
UP 分解源板 v1 结论:
- 核心板采用 v2:1536 × 1024 px 透明画布,17 个独立对象;v1 的两件上臂错误混入完整袖披,保留为失败对照,v2 已改为紧凑的肩—肘黑色上臂段;
- 软性/附件板采用 v2:1536 × 1024 px、6×4 隐形生产网格、24 个独立对象;v1 的双袖披混入肩甲,九片衣摆中又有多片烘焙流苏/挂链,v2 已全部拆清;
- 采用板合计 41 件,在 Alpha 阈值 16、最小面积 80、8 邻域检测下恰好为 17+24 个连通对象,画布四角透明,没有跨格连接;
- UP 的 A 组冻结为画面右侧/角色右侧/持扇手链,B 组冻结为画面左侧/角色左侧/放松手及腰包侧;不得沿用 DOWN 的画面侧别;
- 源板状态为 `source-sheets-alpha-validated`;41 件对象已经完成独立裁切,进入部件包阶段。
UP 独立部件包 v1 结论:
- 两张采用的 v2 源板已按 Alpha 阈值 16 的 8 邻域连通对象裁切为 41 件独立透明 PNG;每件四周保留 10 px 安全边距,外边缘均为透明;
- 核心件使用 `up-core-cNN-*`,软性/附件件使用 `up-soft-cNN-*`,编号可以直接回溯源板诊断图;两张失败的 v1 源板不参与裁切;
- A 组冻结为画面右侧/角色右侧/持扇手链,B 组冻结为画面左侧/角色左侧/放松手及腰包侧;该约定与 DOWN 的画面侧别相反;
- `parts-manifest.json` 已为每件记录源裁切框、输出尺寸、父节点、建议层级、根枢轴与下一关节点;检查总览中的红色十字为根枢轴,蓝色十字为下一关节;
- 部件包保持 `extracted-unvalidated` 状态,用来区分原始裁切与组合验证;枢轴、层级和中性取舍已经由 UP 中性装配 v1 冻结。
UP 中性装配 v1 结论:
- 600 × 760 px 透明画布使用 32 件中性部件,另外 9 件作为投掷手、独立武器、替换衣摆/腰饰保留;41 件全部有明确去向,没有遗漏或重复使用;
- A 组保持画面右侧持扇,B 组保持画面左侧放松;肩—肘—腕通过关节内压重叠消除切口,三段马尾从头冠连续落向画面左侧腰后,八片衣摆从后腰向下展开;
- 左右靴的 Alpha 脚底均落在 `y = 735`,基线差为 0 px;成图可见范围为 `x = 130..469`、`y = 79..735`,画布四边保持透明;
- `pelvis-hip-core` 已包含中性腰后布、红绳、流苏与画面左侧腰包,因此对应独立件不在中性装配中重复叠画;动作时可按清单替换;
- 静态装配状态为 `static-art-validated`;其上的待机与投掷关键帧也已完成,结论见下节。
UP 动作验证 v1 结论:
- 已导出待机吸气/中性/呼气 3 帧及投掷准备/蓄势/释放/回收 4 帧,全部采用 600 × 760 px 透明画布;七帧脚底 Alpha 均落在 `y = 735`,基线差为 0 px,画布四边透明;
- 身体主轴始终保持严格背面,持扇 A 手从画面右侧蓄势并向右完全展开;释放帧切换为张手和单枚脱手羽刃,投射物与 VFX 的实际瞄准仍由运行时自由角度控制;
- 放松 B 手保持稳定,三段马尾和八片衣摆只作滞后摆动;当前幅度内未出现明显断缝、穿头或脚底漂移;
- 待机关键帧沿用 420/260/420 ms 节奏,投掷关键帧沿用 150/110/90/180 ms 节奏,与其余三个运行时方向保持一致;
- 动作状态为 `motion-art-validated`;其 176/132/88 px 固定裁切循环也已完成,结论见下节。
UP 三档循环验证 v1 结论:
- 待机循环使用 `inhale 420 ms → neutral 260 ms → exhale 420 ms → neutral 260 ms`,总周期 1360 ms;投掷循环使用 `ready 150 ms → windup 110 ms → release 90 ms → recover 180 ms → neutral 260 ms`,总周期 790 ms;
- 两组 GIF 均使用源画布上的同一 `484 × 677 px` 联合裁切框和同一脚底原点,没有按帧重新居中;所有源帧的可见底部均为 `y = 736`,范围差为 0;
- 176/132/88 px 三档分别对应 128×64、96×48、64×32 菱形格;缩至 88 px 后,背面朝向、画面右侧投掷、画面左侧马尾、白蓝衣摆和红色腰绳仍可辨认;
- GIF 分别包含 4 个待机播放帧和 5 个投掷播放帧,逐帧时长与 `motion-manifest.json` 一致;UP 至此达到与 LEFT/RIGHT/DOWN 相同的美术侧验证深度。
通用空白角色模板 v1 结论:
- 已从心音流程中抽离出 `templates/2d-character-v1/`,只保留四方向目录、4.75 头身基线、600×760 动作画布、底部中心原点、176/132/88 px 三档显示规格、七关键帧时序和阶段验收规则;
- 新角色默认直接使用 `up / down / left / right` 目录,不继承心音的 `front-left / front-right` 历史别名,也不继承其 A/B 侧别、武器手或附件关系;
- `production-checklist.md` 将流程拆为 G0~G7:角色基线、四向母版、分解源板、独立裁切、中性装配、动作验证、三档循环与模板交付;
- `validation-rules-v1.json` 固定透明边缘、脚底 0 px 差、联合裁切、禁止逐帧重居中、部件全量记账和镜像需显式批准等硬性门槛;
- `tools/scaffold_2d_character.py` 可按编号与名称安全生成新角色骨架,默认拒绝覆盖已有目录;模板 JSON、占位符替换和 dry-run 均已通过验证。
前左方向母版 v2 结论:
- `front-left` 是历史制作方向编号,运行时别名已经冻结为 `right`;本节继续使用旧名,只为保持已有文件路径和清单兼容;
- 旧制作方向定义以四斜向转面表第二姿为准,运行时移动方向则直接按画面 LEFT/RIGHT 判定;
- 羽扇/持械手固定在画面右侧,腰包与长银饰固定在画面左侧,高马尾主体位于左后方;后续部件板与动作不得整体水平镜像;
- `xinyin-p1-cover-left-v1.png` 表达的是左侧掩体的探身与遮挡关系,只作为动作姿势参考,不覆盖中性转面方向;
- v2 为 1017 × 1547 px 透明母版,四角透明;缩放到 352 px 工作高度、176 px 游戏基准高度和 88 px 检查高度后,高马尾、羽扇、白/靛衣摆及朱砂系带仍可辨认;
- v1 保留为方向探索对照,不进入后续拆分;下一阶段以 v2 为唯一来源绘制前左核心身体/肢体板和头发/衣摆/附件板。
前左分解源板 v1 结论:
- 核心板为 1536 × 1024 px 透明画布,恰好检测到 17 个独立对象:头面、颈部、上身、骨盆、双肩甲、双侧上臂/前臂/手型及双腿;
- 软性与附件板同为 1536 × 1024 px 透明画布,检测到 26 个独立对象:头发链、侧发、发饰、袖披、衣摆、腰布、腰包、流苏和三种羽刃;
- 两张源板合计 43 件,四角全透明,Alpha 阈值 16、最小面积 80 的 8 邻域检测下无串片;
- 软性板比原计划多出一片后裙候选,保留为动作替换件;马尾根部自带贴合头顶的花冠,独立长银饰仍作为可替换层;腰前布自带基线系绳,独立流苏作为运动替换件;
- 当前状态为 `source-sheets-alpha-validated`,尚未裁切成单件 PNG,也未完成前左中性站姿装配;下一阶段执行独立裁切、正式命名、枢轴与层级清单。
前左独立部件包 v1 结论:
- 两张源板已经按 8 邻域透明连通对象裁切为 43 件 PNG,每件四周保留 10 px 安全边距;核心板使用 `fl-core-cNN-*`,软性板使用 `fl-soft-cNN-*`,编号可以回溯到诊断图;
- `parts-manifest.json` 为每件记录源板、源裁切框、导出尺寸、父节点、建议层级、根枢轴及下一连接点;红色十字表示根枢轴,蓝色十字表示下一连接点;
- A/B 肢体按源板成组:A 为放松手链,B 为持扇/投掷手链;双腿沿用对应 A/B 组,具体画面侧在中性装配通过后冻结;
- 马尾根部与中段仍大于理想生产切片,当前只标记为可装配候选;中性装配必须检查接缝、旋转中心和对脸/躯干的穿插,未通过时再制作专用补件;
- 当前包状态为 `extracted-unvalidated`:透明裁切和元数据已完成,但层级、枢轴、九片衣摆取舍及中性轮廓仍需装配验证。
前左装配验证 v2 结论:
- 500 × 760 px 透明画布中使用 26 件部件重建中性站姿;可见 Alpha 范围为 362 × 679 px,四边保持透明,左右脚底基线差为 0 px;
- A 组冻结为画面左侧放松手链,B 组冻结为画面右侧持扇/投掷手链;羽扇在右、腰侧附件与长银饰在左的非对称关系与方向母版一致;
- 九片衣摆中采用 01~08 共八片,`coat-panel-alt-09` 保留为动作替换件;v2 加长衣摆并打开腿部站距后,轮廓不再像 v1 那样收成窄直筒;
- 袖臂源件已经包含可见肩甲与袖披,骨盆核心也已经包含中性腰前布、系绳和腰侧附件,因此独立肩甲、袖披及腰饰在当前装配中排除,避免重复叠画;
- 马尾根部单独使用可以形成稳定中性轮廓,但现有 `ponytail-middle` 与 `ponytail-tip` 仍是整块马尾候选,不是合格的连续链节;它们不进入当前基线,运动验证前需要专用三段补件;
- v2 状态为 `art-assembly-validated`,可作为前左静态美术基线;骨骼插值、待机呼吸和投掷动作尚未验证。
前左骨骼补件 v1 与装配 v4 结论:
- 首次补件源板虽然得到 5 个透明对象,但三件头发仍偏向完整马尾候选,根部还混入长银饰与头皮块,仅保留为失败对照;
- 第二版冻结为采用源板,包含去除银羽肩甲与外袖披的独立上臂 A/B,以及具有开放连接面的马尾根/中/尾,共 5 件;
- 5 件补件逐件保留 12 px 安全边距,均未触碰导出边缘;清单记录肩—肘和马尾根—中—尾连接点,状态为 `correction-parts-art-validated`;
- 装配 v4 使用 32 件部件:补件上臂替换复合上臂,独立肩甲固定回躯干,外袖披作为手臂附属层;马尾三段按根部 → 中段 → 末端连接并增加少量遮盖;
- v4 可见 Alpha 范围为 362 × 693 px,四边透明,左右脚底基线差为 0 px;肩甲权重、手腕连续性与马尾中性轮廓均通过美术检查;
- v4 取代 v2 成为当前前左静态基线;其上臂旋转、肩甲固定、袖披跟随和三段马尾滞后已在运行时 RIGHT 运动验证 v1 中通过美术侧检查。
运行时 RIGHT/旧前左运动验证 v1 结论:
- 已生成 `idle-inhale / idle-neutral / idle-exhale` 与 `throw-ready / throw-windup / throw-release / throw-recover` 共 7 个透明关键帧,动作节奏与运行时 LEFT 保持同一套 420/260/420 ms 呼吸节奏和 150/110/90/180 ms 投掷节奏;
- 所有帧统一使用 600 × 760 px 透明画布,在旧 500 px 装配画布左侧增加 50 px 安全区;7 帧四边透明,可见底边均为 y=745,基线差为 0 px;
- 持械侧使用肩—肘—腕连接点逐帧计算,蓄势时羽扇停在面部外侧而不遮挡眼睛,释放时手臂朝画面右侧展开;
- 释放帧隐藏中性持扇手,改用 `hand-throw-open-b` 与独立 `weapon-fan-open`,角色和脱手物均未触碰画布边缘;
- 马尾根/中/尾采用连续关节链,待机产生小幅呼吸滞后,蓄势、释放、回收产生方向明确的惯性摆动;当前幅度下没有明显断缝或穿过头面;
- 肩甲保持为躯干层,袖披随上臂以较小幅度转动;双腿、骨盆主根与脚底不参与动作,因此轮廓变化不会造成站立漂移;
- `motion-manifest.json` 记录 `runtimeDirection: right`、播放顺序、帧时长、完整部件变换、肩肘腕检查点和逐帧 Alpha 范围,可作为未来 Godot 动画导入或烘焙序列帧的直接输入。
运行时 RIGHT/旧前左循环播放验证 v1 结论:
- 待机循环为 `inhale 420 ms → neutral 260 ms → exhale 420 ms → neutral 260 ms`,总周期 1360 ms;投掷循环为 `ready 150 ms → windup 110 ms → release 90 ms → recover 180 ms → neutral 260 ms`,总周期 790 ms;
- 两张循环图同步展示 176/132/88 px 三档角色高度,分别搭配 128×64、96×48、64×32 菱形格;所有帧共用 x=85、y=42、479×712 px 的联合裁切框,不进行逐帧自动居中;
- 源帧可见底边的最小值和最大值均为 746,差值为 0 px;三档画面统一贴合诊断板 y=352 的脚底线,播放中没有上下跳动;
- 176 px 与 132 px 下高马尾、白色衣摆、朱砂系带、持扇手和朝右释放方向均清楚;88 px 下服装细节会合并,但马尾轮廓与投掷方向仍可读取;
- `build_xinyin_motion_playback.py` 已改为支持 `front-right` 与 `front-left` 参数,后续可用同一固定基线流程复查两个横向方向;诊断板背景只用于观看,原始运动 PNG 仍保持透明。
前右装配验证 v4 结论:
- 31 件部件参与中性站姿,其中 9 件来自骨骼补件包;其余原始切片继续作为动作替换件或未采用候选保留;
- C01 `hair-back-main` 实际包含两个被细发丝粘连的马尾方案,会在装配中形成悬空第二马尾,因此退出基线装配,改用 C03 与 C06 组合后发;
- C04 `hair-front` 已自带可见长流苏,C09 独立长发饰再次叠加会重复,因此基线装配不使用 C09;
- C15/C17 与 C18/C20 已退出基线装配,分别由独立上臂 A/B、前臂 A/B 和手型补件替换;C28/C29 重新作为躯干固定肩甲使用,不再随上臂旋转;
- 双腿、躯干、袖臂、八片衣摆、腰前垂布和腰包均可形成完整轮廓,透明件之间没有矩形裁切串片;
- A/B 肢体命名、肩—肘—腕连接和衣摆前后层级已通过待机呼吸与投掷动作验证,可作为前右方向当前基线;
- `assembly-layout-v4.json` 使用 500 × 760 px 美术画布,同时引用原始部件和骨骼补件两个清单,记录每件部件的目标枢轴、旋转、缩放与装配组;它是后续场景或动画工具的输入资料,不是 Godot 场景文件。
前右运动验证 v3 结论:
- 已生成 `idle_inhale / idle_neutral / idle_exhale` 与 `throw_ready / throw_windup / throw_release / throw_recover` 共 7 个透明关键帧;
- 呼吸只移动胸腔、头肩和软性部件 2~6 px,脚底与骨盆主根保持稳定,不会出现站立漂移;
- 蓄势帧把持械手收至面部外侧,避免武器遮挡眼睛;释放帧的独立上臂—前臂—手链条在大角度伸展下保持连续,没有透明断缝;
- 释放帧会隐藏持扇手、切换为投掷张手,并把展开羽扇作为独立脱手对象;肩甲继续固定在躯干,不再随上臂转动;
- 马尾根/中/尾分别产生滞后角度,当前幅度内接缝不明显、没有穿过头部或躯干;较大的马尾根部在实装比例下仍能接受,暂不重画;
- 所有运动帧统一使用 600 × 760 px 透明画布,并在装配原点左侧增加 50 px 安全区;7 帧均通过边缘透明检查,投掷释放帧不再被画布裁切;
- `motion-manifest.json` 保存帧时长、播放顺序、完整部件变换和肩肘手检查点,可直接作为未来动画系统的数据参考。
前右循环播放验证 v1 结论:
- 待机循环按 `inhale 420 ms → neutral 260 ms → exhale 420 ms → neutral 260 ms` 播放,总周期 1360 ms;作为战斗待机呼吸节奏合适;
- 投掷循环按 `ready 150 ms → windup 110 ms → release 90 ms → recover 180 ms → neutral 260 ms` 播放,总周期 790 ms;主要动作在 530 ms 内完成,释放点清楚;
- 两张循环图同时展示角色高度 176/132/88 px,对应 128×64、96×48、64×32 格子;三档均使用同一裁切范围和脚底基线,不做逐帧自动居中;
- 7 个源帧的可见底边完全一致,底边差值为 0 px,因此循环中的脚底没有上下跳动;
- 50% 下仍能通过左臂横向伸展识别投掷释放,但独立手型与羽刃细节不能作为唯一信息,正式效果仍应配合轨迹或闪光;
- GIF 背景、格子和红色脚底标记只用于诊断,透明运动源帧未被修改;播放报告记录固定裁切框、帧时长、循环顺序和校验结果。
前右骨骼补件 v1 结论:
- 现有运动验证确认 C15/C17 袖臂和 C18/C20 前臂属于复合切片,因此新增真正分开的上臂 A/B、前臂 A/B、放松手 A/B、持扇手、投掷张手,以及马尾根/中/尾,共 11 件;
- 首次生成的 `rig-corrections-v1` 中手臂和手型可用,但右侧仍是三个完整马尾候选,不能作为骨骼链,因此仅保留为失败对照;
- 第二版只修正右侧头发,透明检测恰好得到 11 个独立对象,所有部件之间无连接丝、无矩形串片;
- 每件补件保留 10 px 安全边距,清单记录源图裁切框、根枢轴与远端连接点:手臂为肩/肘或肘/腕,马尾为上一节/下一节;
- 马尾根部比理想生产切片大,但已经通过装配 v4 和运动 v3 的链条测试,在前右方向不再要求重画;
- 当前补件包状态为 `correction-parts-art-validated`,A/B 归属、根枢轴和远端连接点已通过美术侧验证;仍需未来引擎插值测试后才能成为最终运行时骨骼资产。
两张 P0 动作板的姿势顺序如下:
```text
板 1:idle_up, idle_down
move_contact_r, move_pass_r, move_contact_l, move_pass_l
attack_1_prepare, attack_1_release, attack_1_recover
attack_2_prepare, attack_2_release, attack_2_recover
板 2:burst_lock, burst_cross, burst_expand, burst_release
hit_recoil, hit_recover
defeat_stagger, defeat_kneel, defeat_fall, defeat_ground
```
动作可读性测试使用 128 × 64 px 基础格、176 px 基础角色高度,并同时检查 100%、75% 和 50% 三档缩放。v1 结论:
- 100% 与 75% 下,待机、移动、普攻、爆发、受击和倒下均能区分;
- 50% 下仍能判断动作大类,但 `attack_1` 与 `attack_2` 的羽刃数量和出手手型已经无法可靠辨认,正式动画需靠出手侧、轨迹颜色或音效强化差异;
- `burst` 的环形轮廓在三档缩放下都很醒目,但 VFX 不能计入角色碰撞或格子占用;
- `hit` 在 50% 下容易与攻击动作混淆,后续应加大上身后仰并收起主动投掷手;
- `defeat_ground` 的横向视觉范围超过单格,后续分解动画应把马尾和外裙进一步收拢。
v2 针对以上问题做了定向修正,并保留 v1 作为对照:
- `attack_1` 改为高位单臂直投,`attack_2` 改为低位横向双刃;50% 下已能依靠手臂高度和站姿宽度区分,羽刃数量只作为辅助信息;
- `hit` 增大后仰角度、收回双手并取消投掷表现,三档缩放下均不会再与主动攻击混淆;
- `defeat_ground` 收拢膝、裙片和马尾,视觉范围显著缩小;允许软性部件略超出格子,但逻辑占格仍固定为一格;
- v2 可作为后续分解和动画设计的当前基线,v1 不再用于新方向的动作扩展。
P1 v1 的姿势顺序与使用边界:
```text
板 1:ready_observe, ready_low
dodge_compress, dodge_dash, dodge_land
weakpoint_analyze, weakpoint_lock
板 2:cover_enter, cover_tuck, cover_peek
cover_attack_prepare, cover_attack_release, cover_attack_withdraw
```
- `dodge_dash` 的淡蓝残影属于独立 VFX,不计入身体切片;
- `weakpoint_lock` 的菱形/月牙准星属于目标提示层,不跟随角色骨骼;
- 当前掩体板只表达“威胁位于右上、角色在掩体后侧”的关系;正式制作时至少还需一套反向探身动作,不能通过简单水平镜像解决心音的发饰、腰包和投掷手方向;
- 掩体块仅为动作空间参考,不是正式地图素材,也不进入角色导出包。
P1 v1 可读性测试沿用 128 × 64 px 基础格、176 px 基础角色高度和 100%/75%/50% 三档缩放。结论:
- `ready_low` 在 50% 下仍能与待机和攻击区分,主要依靠低重心和未伸出的手臂;
- `dodge_dash` 的本体轮廓清楚,但淡蓝残影在 50% 下权重过高,正式 VFX 应降低不透明度、缩短拖尾并在动作结束前快速消失;
- `weakpoint_lock` 的手势在 50% 下只保留方向信息,准星仍可见;正式 UI 应给准星设置屏幕空间最小尺寸,不能完全随镜头等比缩小;
- `cover_idle` 与 `cover_attack` 在三档缩放下均能通过头肩暴露量和投掷手区分;
- 测试中的掩体块大于单格视觉宽度,仅用于验证遮挡关系,不作为正式掩体尺寸结论。
P1 v2 修正与补充:
- `dodge_dash` 残影缩短约 40%,降低为约 20%~25% 不透明度的单层拖尾;50% 下本体重新成为唯一主轮廓;
- 新增前左斜向的 `cover_enter_left / cover_tuck_left / cover_peek_left / cover_attack_prepare_left / cover_attack_release_left / cover_attack_withdraw_left`;
- 左右探身动作均为独立绘制,保留发饰、腰包与投掷手的非对称结构;
- P1 v2 并列测试显示两侧探身在 50% 下仍能依靠头肩暴露方向和投掷轨迹区分,可作为当前 P1 基线。
## 6. 导出与命名建议
```text
assets/images/2d-game-characters/
└─ 02-xinyin/
├─ source/ # PSD/KRA 等分层源文件
├─ parts/ # 各方向透明 PNG 分解件
│ ├─ front-right/v1/ # 历史目录;运行时映射为 LEFT
│ ├─ front-left/v1/ # 历史目录;运行时映射为 RIGHT
│ ├─ up/ # 背面方向
│ └─ down/ # 后续正面方向
├─ replacements/ # 表情、手型、裙摆、马尾替换件
├─ vfx/ # 千羽、月轮、轨迹、残影、命中特效
├─ previews/ # 比例和游戏内预览
└─ xinyin-rig.tscn # 后续 Godot Skeleton2D 场景
```
最终文件名采用 `02-xinyin_<direction>_<part>[_variant].png`,其中 `<direction>` 只允许 `up / down / left / right`。当前拆分为了保留与透明对象诊断图及脚本的映射,旧前右暂用 `fr-cNN-<part>.png`,旧前左暂用 `fl-core-cNN-<part>.png` 与 `fl-soft-cNN-<part>.png`;运行时通过方向映射清单读取,不直接批量改名。例如:
```text
02-xinyin_left_forearm-r.png
02-xinyin_right_hand-r-throw.png
02-xinyin_up_ponytail-02.png
02-xinyin_vfx_feather-single.png
```
透明 PNG 使用预乘边缘检查,分解件四周保留安全 padding。源文件以 2 倍于游戏显示尺寸制作;若默认显示高度为 176 px,工作高度建议约 352 px,并保留更高分辨率的角色设计母版。
## 7. 验收标准
- 角色缩放到约 176 px 高时,仍能一眼识别高马尾、银羽、白/靛轮廓和朱砂点色。
- 四方向的脚底原点一致,切换方向时人物不跳位。
- 待机、移动、首击、追击和爆发只看黑色剪影也能区分。
- 普攻首击与被动追击在 0.5 秒内仍有不同手型和重心变化。
- 任何关节旋转都不露透明缝,裙片、披风与马尾不穿过身体主轮廓。
- 倒地姿势不长期占用相邻格的主要视觉区域。
- 左上主光、右下投影与地图素材一致。
- 角色身体、脚底阴影、选中环、状态特效和技能 VFX 能独立开关。