素材路径分工约定（asset-path-map）

定立：2026-09-26（用户立约指令「把哪些路径、哪些位置是干什么的确定好」）
效力：全仓素材批的路径判据单点；新素材批开工前对照，违例=实施缺陷

1. 目录分工总表

路径	角色	入 git	游戏运行时引用
`artwork/candidates/**`	候选原图与母版源档（PNG/.pxo/GIF/对比图/验收留底）——素材的原产地，游戏禁直接引用；随 `artwork/` 整目录不入 git（`design/art/candidates/` 已弃用，路径列入熵增闸退役名单）	否（`.gitignore` 三行规则；`*.md` 指引例外）	禁（res:// 路径禁指 candidates）
`game/assets/art/**`	游戏运行时素材唯一落地处（res://assets/art/...）——定稿素材从 `artwork/candidates/` 拷贝入此，改名按圣经 §8.3	否（untracked，勿 git add；worktree 间需脚本拷贝同步）	唯一合法引用源
`game/assets/ui/icons/**`	UI 图标（状态图标批特例——唯一已提交入 git 的素材目录）	是（状态图标入库特例）	是
`artwork/mockups/**`	混合样张/版式对比图（设计评审产物，非游戏素材；样张、关卡地图样张等实存于此）	否	禁

2. 素材流（新素材批标准路径）

产出/候选：artwork/candidates/ 对应子目录（如 hero-idle/）
验收定稿：用户拍板（候选目录留档不动）
入包：拷贝 → game/assets/art/<语义子目录>/，改名 §8.3 域键式（如 character_hero_portrait.png）
接线：代码 res://assets/art/... 引用（路径常量单点归 UiKit.TEX_*）；装载一律 UiKit.load_tex（exists 守卫——素材不入 git，缺位树回退），禁 preload
提交：只提交代码/文档；PNG 与 .import（全局忽略）均不入 git
整理（脚本链第四段：生成→验证→整理→入包）：定稿入包后当批清 artwork/candidates/ 子目录——保留定稿源 + 最相邻候选 2 版（默认策略，可按资产调整），其余打包归 archive/；非素材残留（.url/.ogg/.ai/.swf 等）剔出；批量执行一律 dry-run 清单先行，经用户确认再动文件

3. game/assets/art 语义子目录

子目录	内容	现役
`character/`	角色棋盘帧 + B 区立绘	character_hero_idle/walk（棋盘 32×32 朝左基准）、character_hero_portrait（B 区立绘 46×48）+ character_enemy_<键> 八敌
`fx/`	特效帧	shovel_swing_f0/f1/f2（挥铲三帧，握把锚 (18,12)）
`scene/`	场景图（背景层 + 地面层 + 围墙层 + 可点物件层；营地场景图首批）	营地 10 张：`scene_camp_bg`（背景层，不透明全幅=天空＋远山＋地面＋门洞小路）＋ `scene_camp_wall`（围墙层，透明底、门洞留透明缺口）＋ `scene_camp_gate / forge / chest / notebook / dummy / board / campfire`（七个可点物件）＋ `scene_camp_tent`（承载件，不可点）＋ `scene_stage_bg_dungeon` / `scene_stage_bg_underdark` / `scene_stage_bg_deep_underdark`（B 区战斗舞台背景层三关变体，✦ 插画级，顶部空区＋远景天然洞壁，不画近景地面，按 board_type 选图）＋ `scene_stage_ground`（B 区连续近景地面层，✦ 插画级，泥土/砂砾/碎石＋顶缘分隔带，跨关恒定）＋ `scene_stage_plaza`（B 区角色脚下小石台，48×12 九宫格件）——B 区战斗舞台背景与连续地面 2026-10-31 已入包；营地 10 张 2026-11-01 随迭代 47 卡④ 入包（`scene_camp_` 十件在役、`TEX_CAMP_` 十键消费；用户游戏内终审如有置换，按本行键名同径替换）
`board/`	砖面/封印印记（三关换皮 + 封印印记件）	terrain_floor_<board_type>_.png（三关地面系）、seal_mark.png

4. 坐标/朝向等工程侧约定备查

素材基准朝向：角色/铲帧一律朝左入库，右向=运行时 flip_h（镜像帧不入包，right 变体留 artwork/candidates/）
挥铲握把锚：画布 (18,12)（三帧同位——以手为圆心旋转的预烤相位）
缩放纪律：圣经 §8.2 整数缩放为一般规则；棋盘小人 1.5× 系用户明示裁决的登记例外（注记见 art-bible §8.2）

4.3 KiB Raw Blame History Unescape Escape

素材路径分工约定（asset-path-map）

1. 目录分工总表

2. 素材流（新素材批标准路径）

3. game/assets/art 语义子目录

4. 坐标/朝向等工程侧约定备查

4.3 KiB

Raw Blame History