DKChan
0aa85ddb87
源委=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 批且用户未点名，两入口铁规）。
37 lines
3.4 KiB
Markdown
37 lines
3.4 KiB
Markdown
# 素材路径分工约定（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. 素材流（新素材批标准路径）
|
||
|
||
1. **产出/候选**：candidates 对应子目录（如 `hero-idle/`）
|
||
2. **验收定稿**：用户拍板（候选目录留档不动）
|
||
3. **入包**：拷贝 → `game/assets/art/<语义子目录>/`，改名 `§8.3` 域键式（如 `character_hero_portrait.png`）
|
||
4. **接线**：代码 `res://assets/art/...` 引用（路径常量单点归 `UiKit.TEX_*`）；装载一律 `UiKit.load_tex`（exists 守卫——素材不入 git，缺位树回退），**禁 preload**
|
||
5. **提交**：只提交代码/文档；PNG 与 `.import`（全局忽略）均不入 git
|
||
6. **整理（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>_<n>.png（三关地面系）、flag_seal.png |
|
||
|
||
## 4. 坐标/朝向等工程侧约定备查
|
||
|
||
- 素材基准朝向：角色/铲帧一律朝**左**入库，右向=运行时 `flip_h`（镜像帧不入包，right 变体留 candidates）
|
||
- 挥铲握把锚：画布 (18,12)（三帧同位——以手为圆心旋转的预烤相位）
|
||
- 缩放纪律：圣经 §8.2 整数缩放为一般规则；棋盘小人 1.5× 系 2026-09-26 用户明示裁决（豁免注记归 art-bible 批另落）
|