源委=P0 收口讨论批(2026-10-06,用户令「讨论期只改文档」)——派生自 3549 次 可读性实测(24 糊/32 可读/48 清楚/64 细节完整)与用户三体型约束(钩爪恐魔>灰矮人、 灰矮人<熊地精、食人魔酋长>熊地精)+ 定档总图用户确认。 ① 八敌站桩源档由「全敌共用 48」改逐键定档(tools/pixelize_candidates.py 新增 STANDEE_TIER_H:地精36/巨蜘蛛38/灰矮人46/钩爪恐魔58/熊地精62/食人魔酋长74/ 蛛化卓尔90/灰矮人石君王94;主角 48 不变,显示一律 ×2 整数 NEAREST=72–188)。 旧 f_enemy=48/max_h 系数退役(它把普通怪压到 21–24px、全员低于可读门槛); SIZES 明确降级为「中间分辨率表」(决定中间图多细,不决定最终体量),并纠注 ogre_chief=192 系分辨率选择非 Boss 档归属。派生管线 = pixel-1 紧裁 → 等比缩 至各自档高 → dom_block_resize 块内众数降采样(禁走 recon / 重跑 remove_bg)。 ② 排版改方案二:B 区 252→270(≈1/3 屏)/ C·D 548→530,扫雷盘 438×438 原尺寸 不缩、格子不变(压缩由面板空档吸收);站桩内部重排=立绘双脚落石台上缘、血条 +状态/名字行落底排全场一线;大体档(drider/duergar_king)头部探出盒顶压进光 柱区,血条仍落底、意图徽标压胸;「血条悬浮头顶 + 盒内居中」排式退役。 ③ 体量语义修订(character-design §5.2):强度先验 → 生物体型,小块精英与大体普 通怪并存;§5.1 新增主角描边例外(深褐 40,19,13,浅砖面对比更高);§5.5 登记 钩爪恐魔「宽≥高」豁免(58 高窄条长臂束状剪影,待样张批复验)。 ④ 定值单点纪律(art-bible §8 头注):数字定值只落 §4.1 主色板 + §8.2,其余章指 路禁复述;§4.1 新增色板 48 色上限 + 新色须与既有任一色 RGB 三通道差 ≥8。 ⑤ §8.3 归档纪律(图片不入 git / 过程稿归档+对象存储 / 主文档禁引 artwork 散路径) + 三检查器挂点(色板检查器 / 路径核对器 / standee_asset_check 硬闸升级规格)。 ⑥ 方向:=ission:24 rectifikace 地形色值对齐 §4.1(岩石 #8B755B→#C9AF83、地面 #564232→#B39A78,两处提示词同步);生图渠道改为「远程对话式正主 + 本地 ComfyUI 备选」;地形瓦片改拼表制正主(三步法),分张降为回退路径。 ⑦ 对账更正:asset-path-map 废路径 production/mockups → artwork/mockups; art-status-checklist 格子样张 ⬜→✅、受击反馈/弹道 ⬜→◐(共 ✅4/◐8/⬜3)。 ⑧ 06 新登记四条:站桩帧动画(Alpha 定版闸前)/ 主角描边素材侧复核 / 3349 草稿 dry-run 整理 / 口号型条款机检化(三档标注格式已拍板)。 纯文档 + 1 个 Python 常量表改动,未出图未动引擎代码;重产与实装归后续任务书批。 doc 三闸/冒烟未跑(讨论批:非 loop 批且用户未点名,两入口铁规)。
3.4 KiB
3.4 KiB
素材路径分工约定(asset-path-map)
- 定立:2026-09-26(用户立约指令「把哪些路径、哪些位置是干什么的确定好」——台账 161)
- 效力:全仓素材批的路径判据单点;新素材批开工前对照,违例=实施缺陷
1. 目录分工总表
| 路径 | 角色 | 入 git | 游戏运行时引用 |
|---|---|---|---|
design/art/candidates/** |
设计侧源档(母版 PNG/.pxo/GIF/对比图/验收留底)——素材的原产地与档案库,游戏禁直接引用。目录按需创建(首批候选入库时建,2026-10-06 对账注:当前两 worktree 均未建立,非路径作废) | 否(.gitignore 三行规则;*.md 指引例外) |
禁(res:// 路径禁指 candidates) |
game/assets/art/** |
游戏运行时素材唯一落地处(res://assets/art/...)——定稿素材从 candidates 拷贝入此,改名按圣经 §8.3 | 否(untracked,勿 git add;worktree 间需脚本拷贝同步) | 唯一合法引用源 |
game/assets/ui/icons/** |
UI 图标(状态图标批特例——唯一已提交入 git 的素材目录) | 是(2026-09-24 批特例) | 是 |
artwork/mockups/** |
混合样张/版式对比图(设计评审产物,非游戏素材;样张 v3、关卡地图样张等实存于此)——2026-10-06 对账更正:原写的 production/mockups/** 系废路径 |
否 | 禁 |
2. 素材流(新素材批标准路径)
- 产出/候选: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 - 整理(2026-10-06 P2-1 固化段——脚本链第四段:生成→验证→整理→入包):定稿入包后当批清 candidates 子目录——保留定稿源 + 最相邻候选 2 版(默认策略,可按资产调整),其余打包归
archive/;非素材残留(.url/.ogg/.ai/.swf 等)剔出;批量执行一律 dry-run 清单先行,经用户确认再动文件(2026-10-06 用户惯例)
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)) |
board/ |
砖面/旗印记(三关换皮 + 封印旗;2026-10-06 对账更正——旧 board_floor/wall/pillar_dungeon_* 命名退役) |
terrain_floor_<board_type>_.png(三关地面系)、flag_seal.png |
4. 坐标/朝向等工程侧约定备查
- 素材基准朝向:角色/铲帧一律朝左入库,右向=运行时
flip_h(镜像帧不入包,right 变体留 candidates) - 挥铲握把锚:画布 (18,12)(三帧同位——以手为圆心旋转的预烤相位)
- 缩放纪律:圣经 §8.2 整数缩放为一般规则;棋盘小人 1.5× 系 2026-09-26 用户明示裁决(豁免注记归 art-bible 批另落)