From 70d232042e2b551c95af1ae4ae2e1e852c2994cc Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Sat, 26 Sep 2026 02:27:09 +0800 Subject: [PATCH] =?UTF-8?q?docs(art):=20=E9=AB=98=E5=A2=99=E7=93=A6?= =?UTF-8?q?=E7=89=87=E4=BD=93=E7=B3=BB=E5=9B=BA=E5=8C=96=E6=89=B9=20v2.9?= =?UTF-8?q?=E2=80=94=E2=80=94=E5=9C=A3=E7=BB=8F=20=C2=A73.2=20=E9=AB=98?= =?UTF-8?q?=E5=A2=99=E7=93=A6=E7=89=87=E4=BD=93=E7=B3=BB=E6=9D=A1+=C2=A78.?= =?UTF-8?q?5=20=E7=94=9F=E4=BA=A7=E5=88=86=E5=B7=A5=E6=9D=A1(=E7=94=A8?= =?UTF-8?q?=E6=88=B7=E6=8B=8D=E6=9D=BF=202026-09-26);comfyui-prompts=20?= =?UTF-8?q?=C2=A74bis=20=E5=9C=B0=E5=BD=A2=E5=A1=AB=E5=85=85=E7=BA=B9?= =?UTF-8?q?=E7=90=86=E5=9B=9B=E5=8D=A1+=E7=94=9F=E5=9B=BE=E6=8E=A7?= =?UTF-8?q?=E5=88=B6=E7=BA=AA=E5=BE=8B;art-assets-checklist=20=E6=8E=88?= =?UTF-8?q?=E6=9D=83=E4=B8=8E=E8=AF=84=E4=BC=B0=E7=99=BB=E8=AE=B0=E9=99=84?= =?UTF-8?q?=E5=BD=95;CLAUDE.md=20=E5=83=8F=E7=B4=A0=E7=BB=93=E6=9E=84?= =?UTF-8?q?=E4=BB=B6=E5=B7=A5=E4=BD=9C=E7=BA=AA=E5=BE=8B=E5=9B=9B=E6=9D=A1?= =?UTF-8?q?;design/research=20=E6=96=B0=E5=A2=9E=E8=AF=84=E4=BC=B0?= =?UTF-8?q?=E8=AE=B0=E5=BD=95=E4=B8=8E=E6=96=B9=E6=A1=88=E7=94=B2=E8=AF=8D?= =?UTF-8?q?=E8=A1=A8=E4=B8=A4=E6=A1=A3(=E6=8E=A5=E7=BA=BF=E6=89=B9?= =?UTF-8?q?=E8=BE=93=E5=85=A5)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CLAUDE.md | 7 +++ design/art/art-assets-checklist.md | 24 +++++++++ design/art/art-bible.md | 5 +- design/art/comfyui-prompts.md | 36 ++++++++++++- .../board-tile-vocab-plan-a-2026-09-26.md | 51 +++++++++++++++++++ ...rain-walls-source-evaluation-2026-09-25.md | 34 +++++++++++++ 6 files changed, 155 insertions(+), 2 deletions(-) create mode 100644 design/research/board-tile-vocab-plan-a-2026-09-26.md create mode 100644 design/research/terrain-walls-source-evaluation-2026-09-25.md diff --git a/CLAUDE.md b/CLAUDE.md index 4b56a1f3..0c59a6b8 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -65,3 +65,10 @@ - **fail-fast**：数据校验错误一律致命中止，无软回退 - **spec-AC 一致性**：规约与验收标准不得在同一输入上给出不同答案（所有 GDD 同尺度） - **评审隔离**：`/design-review` 必须在独立会话跑（与 `/design-system` 隔离） + +## 像素结构件工作纪律(2026-09-26,高墙批转角三返工复盘用户令落档) + +1. **先抄后造**:画任何像素结构件前,先从参考素材裁同类结构放大逐像素描述,再实现同款;禁止凭印象/第一性原理发明像素结构(圣经 §8.5 参考核验的执行口径)。 +2. **验收口径写成像素级视觉判据**:开工前把合格标准写成"X 与 Y 同列收尾/无悬空/无突出"式句子;自检放大最差交界处逐行核像素,不只看整板观感。 +3. **±1px 一律坐标推导**:单像素级结构先写坐标推导(哪条线在哪列、谁与谁齐平)留档再写码;禁蒙数试错。 +4. **修复默认附前后对比图+像素审计**,不等用户索要。 diff --git a/design/art/art-assets-checklist.md b/design/art/art-assets-checklist.md index 530ea7c6..a9863554 100644 --- a/design/art/art-assets-checklist.md +++ b/design/art/art-assets-checklist.md @@ -175,3 +175,27 @@ 字体(3.6)接入归表现批；营地件(3.5)归 UI 贴图重构批 分辨率档位 ✅已定案（1280×800 + 1920×1080，2026-09-22 用户确认）；art-bible §8 资产规范 ✅已成文（2026-09-23）——像素基准/画布/命名/帧数候选值就位，终值归样张批冻结 ``` + +## 附、已评素材包授权与结论登记(2026-09-26 并档,♻ 复用渠道) + +> 来源:tile-reuse-2026-09-23 / ui-reuse-2026-09-23 / terrain-walls-2026-09-25 三批复审记录(批目录已归档清退,本表为唯一仓内登记);详录=design/research 评估档。 + +### 授权总表(闸④预检结论) + +| 素材包 | 授权 | 署名义务 | 结论 | +|---|---|---|---| +| Kenney 全系(ui-pack/fantasy-ui-borders/game-icons/board-game-icons/kenney-fonts/roguelike 系/tiny-dungeon/tiny-town) | CC0 | 无 | ui-reuse 待审;tiny-dungeon 终局否决(架构不适配);余随批否决 | +| OGA Pixel UI 750(Kenney 作) / PixUI(CamTatz) / Handpainted stone | CC0 | 无 | ui-reuse 待审 | +| DENZI public domain art | CC0 | 无 | 否决 | +| beast-cave(OGA) | CC0 | 无 | **已选中入工程**(地砖批;2026-09-26 被 terrain_ 自产全套取代,源包归档) | +| JaggedStone / Screaming Brain / ExileGL / Corey Archer(OGA) | CC0 | 无 | 否决 | +| Calciumtrice / Buch / bart cobblestone(OGA) | CC-BY 3.0 | **需署名** | 否决 | +| LD rogue / Evert cave / poikilos underworld(OGA) | OGA-BY 3.0 | **需署名** | 否决 | +| game-icons.net 图标 | CC-BY 3.0 | **需署名** | 剪影风 26 枚已否决删除;余 10 枚节点/营地候选在 ui-reuse 待审 | +| Fusion Pixel 缝合像素字体 | SIL OFL 1.1 | 保留许可证 | ui-reuse 待审 | +| DCSS dngn / Lost Garden / Cavernlock / Aftertile / Voirol / oga-zelda-like(armm1998) | CC0 | 无 | 高墙批评估否决(架构/风格不适配;zelda-like 留作干净度基准) | +| Golden UI 系列 | CC-BY-SA | — | **闸④不过,未下载** | +| Gemini 生图(用户自跑) | 自产 | 无 | **terrain_ 高墙瓦片材质源(现行定稿)** | + +### 复用四闸(台账 130,现行) +色板量化 / 禁入带吸色 / 灰度可辨 / 授权干净(SA 不可、来路不明不可)。 diff --git a/design/art/art-bible.md b/design/art/art-bible.md index 794b7ce7..c24772c6 100644 --- a/design/art/art-bible.md +++ b/design/art/art-bible.md @@ -1,6 +1,6 @@ # 美术圣经(Art Bible)— Dungeon Sweeper -> 项目:Dungeon Sweeper(扫雷 × 自动战斗 闯关 Roguelike)· 状态:**第 1–9 节定稿**(§6 环境/§7 UI/§8 资产规范/§9 参考与反参考已于 2026-09-23 v1.8 按 D1/D2/D4/D5 框架成文;D3=§5 角色已于 v1.6 落地、v1.7 抽离独立文档;框架 2026-09-22 用户拍板,原登记于中间产物修订指导,经裁决不入库,明细归台账 125);历次修订明细见文末版本历史(现行为 v2.8) +> 项目:Dungeon Sweeper(扫雷 × 自动战斗 闯关 Roguelike)· 状态:**第 1–9 节定稿**(§6 环境/§7 UI/§8 资产规范/§9 参考与反参考已于 2026-09-23 v1.8 按 D1/D2/D4/D5 框架成文;D3=§5 角色已于 v1.6 落地、v1.7 抽离独立文档;框架 2026-09-22 用户拍板,原登记于中间产物修订指导,经裁决不入库,明细归台账 125);历次修订明细见文末版本历史(现行为 v2.9) > > **Art Director Sign-Off (AD-ART-BIBLE)**:历次批均 SKIPPED(v1.8 §6–9 补全亦 SKIPPED)— Lean/Solo mode(非 PHASE-GATE;§6–9 已成文,full 门禁签核时机待用户表态) > 风格基调(2026-09-10 用户定稿):地牢题材但**非暗黑风**——轻快明亮的幻想冒险风,全年龄;像素风;角色 2~3 头身 @@ -162,6 +162,7 @@ - **旗(封印印记)**:插旗动作的叙事呈现 = **封印**(玩家可见专名,2026-09-25 用户拍板,registry terminology 登记)——玩家对未开格插旗,即对该格(巢穴)实施封印,旗 = 封印印记;旗朱色(§4.1)与格内优先级栈位(§1.2)不变。封印特效(施印瞬间 + 印记常显形态)待表现批,资产归清单 §4 演出类;现行程序化占位 = 旗朱「旗」字形(棋盘惯例:贴图在位=字形退役)。←原一;P2;术语批 2026-09-25 - **可挖域接触带微光(交互反馈层,2026-09-25 用户拍板)**:挖掘期,英雄格周界与可挖墙(8 向相邻未开格)的接触面画呼吸微光——正交邻墙=该侧整条边,斜向邻墙=共享角点+向两侧各延伸半条边;光只画英雄格(空间)一侧、不进墙格(与角嵌纹样/装饰变体零冲突,数字砖心不涉)。世界观口径:未开格=墙、已开格=挖出的空间,微光=空间的灯光边界。色相=蓝族浅一档(§4.2 蓝条;与主角蓝框的分层归样张批);呼吸=§2.1 挖掘期唯一在动元素,减动效停格。角点为斜墙与正交墙共享、不逐格归因,逐格指认=悬停金框(现役)。旧「墙格整框绿相呼吸」随本条退役(实现切换归表现批,`DIG_EDGE` 绿相退役)。←§2.1;§4.2;P1 - **墙体**:圆角砌块堆叠,禁尖刺装饰——尖刺专属危险语义,装饰不得伪装逻辑差异。←原三 +- **高墙瓦片体系(2026-09-26 定稿,样张批追认)**:未挖格=**一整块 32×32 自含凸起岩体**(方案甲核心定义);素材语义名——未开格素材=**墙瓦片**,已开格素材=**地面瓦片**(术语 2026-09-26 用户立)。**边界=墨线纪律**:墙瓦片与相邻格分界一律 1px 深墨线、直线贴格边、零锯齿;墨线职责=分隔,不追求与地面融合(Tiny Dungeon 样图实证调研,见 `design/research/terrain-walls-source-evaluation-2026-09-25.md`)。**光照=单一北受光**:北缘=墨线内侧 1px 微亮棱(就地取色提亮,禁宽亮带);西/东缘=墨线后直进纹理、不加修饰;南缘=墨线+立面窄暗条(约 1/3 格高,横层理叠石、禁竖条纹栅栏感)。**凹角**:角点单像素落线;南立面侧凹角加 1px 立面收头——带身与转角竖线同列收尾,禁悬空、禁突出(v9.1/v9.2 两版返工实证)。现行定稿=`game/assets/art/board/terrain_*`(16 唯一墙瓦片+5 地面瓦片变体;词表与查表逻辑见 `design/research/board-tile-vocab-plan-a-2026-09-26.md`)。←原三;台账 164 - **变异格形状通道**(双通道之"形",与色无关):底砖圆角外轮廓不变,砖面内缘绘一圈定宽专属几何纹带(纹带形全作不与他类共用),砖心留白予数字与旗;验收标准=**灰度截图下仍可分类**。种类清单 = 地形变异六类型已定稿(地形变异 GDD;荆棘丛/藤蔓缠绕/岩浆/烬覆/落石/矿尘):**纹带形按轴只分两种**——伤害轴(荆棘丛/岩浆/落石)= 刺/缺排斥形,信息轴(藤蔓缠绕/烬覆/矿尘)= 遮蔽/缠绕形;同轴跨图类型只做色板变体(§4.3 `variant_tint` 槽),不做新纹形。样张批增查:岩浆纹带橙红须与危险红、旗朱互辨(变异格不是雷,色相邻近混淆风险);信息轴遮蔽呈现不得侵入数字色牌占位区(§1.4 验收 1 延伸)。←原一(纹理位次第 4,让位于数字/小人/旗);原三 ### 3.3 UI 形状语法(方向指导,细则迁 §7.1) @@ -435,6 +436,7 @@ - **结构件完整性**:格面立体感(高墙顶面/坡缘/角件/周界轮廓)只能来自**素材本体绘制的结构件拼装**(样例=Necesse 式缘件:专属底色+手绘细节+暗轮廓线的独立贴图);禁止以调色、渐变、明暗滤镜、跨格投影等生成手段伪造素材中不存在的结构。样稿暴露缺件时,正确动作=停下呈报缺口与「换素材/自产缺件」选项,由用户裁决后执行。 - **参考核验**:宣称「参考 X 游戏」前,必须取得并实际查看 X 的截图证据(像素级放大核验其实现方式),证据存 `production/mockups/` 或 `design/art/references/`;仅凭文字资料、记忆或宏观印象作出「X 是这样做」的断言无效。 - **图底分离**:已开地面的明度须低于未开格墙体,由素材选型承载(选更暗的地板砖),不靠渲染压暗实现。 +- **生产分工(2026-09-26 用户拍板)**:格面地形类素材=**材质归模型、结构归程序**——AI 生图模型只出无缝填充纹理(无边框/无亮边/均匀光照/方形);一切结构件(缘件/轮廓/立面/角件/收头)一律程序化绘制或手修,因为 autotile 任意拼接的边界像素约束超出 2D 生图模型能力(实证:2026-09-25 生图 5×5 瓦片表每枚砖自带啃咬边框与宽亮带,提示词无法根除)。**镜像规则**:东西对称结构件只许水平翻转(flip_h)复用、**禁旋转**——北受光下东西侧缘光照对称,镜像无损真;旋转会把北受光转到东边。 --- @@ -465,6 +467,7 @@ ## 版本历史 +- **v2.9(2026-09-26)高墙瓦片体系定稿批**(高墙批全程收官,用户拍板;台账 163/164):§3.2 新增「高墙瓦片体系」条——未挖格=一整块 32×32 自含凸起岩体(方案甲核心定义)+术语(墙瓦片/地面瓦片)+墨线边界纪律(1px 深墨线直线零锯齿,职责=分隔不融合)+单一北受光(北缘 1px 微亮棱/南缘立面窄暗条/凹角角点+立面侧 1px 齐平收头),定稿=`game/assets/art/board/terrain_*` 21 枚;§8.5 增「生产分工」条——材质归模型(AI 只出无缝填充纹理)、结构归程序(autotile 拼接约束超 2D 生图能力,实证在案)+镜像规则(只许 flip_h 禁旋转)。条口径=样张批追认(与 §8.4 方向集先例同)。词表与查表逻辑、搜包评估记录归 design/research 两档;过程文档随批清退(中间产物不入库先例,台账 127)。 - **v2.8(2026-09-25)可挖域接触带微光定稿批**(用户两拍板:①画法=接触带·空间侧——光画英雄格周界,正交邻墙=整边、斜向邻墙=角点+两半边;②色相=蓝族浅一档,顺路清偿旧 DIG_EDGE 绿相违 §4.2 绿禁则):§3.2 新增「可挖域接触带微光」条(画法/光只住空间一侧/角点不逐格归因、指认=悬停金框/呼吸与减动效守 §2.1/实现切换归表现批);§2.1 承载元素、§4.2 蓝条随批;battle.md 注记随批。背景=用户世界观口径「未开格=墙、已开格=挖出的空间」,微光=空间的灯光边界。 - **v2.7(2026-09-25)封印术语批**(用户拍板:Node2D 实现后「插旗」动作等价为**封印**——玩家对未开格插旗即对该格巢穴实施封印,旗 = 封印印记;机制键与规则全不变):§3.2 新增「旗(封印印记)」条——呈现语义/旗朱与栈位不变/封印特效(施印瞬间+印记常显形态)待表现批/现行占位 = 旗朱「旗」字形;§2.5 失败承载元素措辞随批(插过的旗 = 封印印记)。**登记面**——registry terminology 新增「封印」词条、00-游戏概念 术语层级专名表随收;连带同步:battle.md 呈现注记、art-assets-checklist §4 演出类新增封印特效两件(施印特效+印记常显)、art-status-checklist P3 行、character-design.md §5.4 插旗条注记(主角即插旗者)。**关联面**——可挖域接触带微光方案(用户同日提出:微光画英雄格周界接触面,正交整边/斜向角点+两半边)评估可行,实现归表现批,未入本批。 - **v2.6(2026-09-25)世界观对齐扫描批(甲档回填 + 完美排雷钩子收口 + 引用锚内联;用户三拍板)**:①**§4.6.4 敌种甲档回填数据实态**——bugbear(ward→light)/ ogre_chief(heavy→light)/ drider(heavy→ward),并注记甲档事实源 = `enemy.tres` armor_type(2026-09-18 甲重配批后 L1 全轻甲、L2 除 drider 外全轻甲、L3 duergar/duergar_king 重甲);连带修订 character-design.md §5.5(熊地精轻甲化/食人魔弃金属甲板改裸身皮条/卓尔改魔法甲符纹)与 comfyui-prompts.md v2.8(熊地精/食人魔/卓尔三卡提示词随改)——食人魔视觉重设计经用户拍板「按最新设定,裸身+魔法甲符纹」。②**§2.2 完美排雷钩子收口**——「若…落实…待 GDD 定夺」改现行事实(零误标且至少标中一面旗→追加第二份清图兑付+结算高光行,地图战斗资源 GDD 已定稿)。③**引用锚内联**——§3/§4 尾注 P1–P4 支柱语义内联(概念期 brainstorm 编号,现行 GDD 树不单列),§1.4 两处 game-concept 编号引用改语义内联。扫描背景=用户发起的圣经×关卡/世界观对齐审计;变异六类型/格面九类/状态九键/奖励 19 键/敌种八键/三柜台钥石/三关色板方向经核对全部一致,零其余不符。 diff --git a/design/art/comfyui-prompts.md b/design/art/comfyui-prompts.md index ef7482da..2374b517 100644 --- a/design/art/comfyui-prompts.md +++ b/design/art/comfyui-prompts.md @@ -1,4 +1,4 @@ -# 生图提示词卡(角色级资产)v2.8 +# 生图提示词卡(角色级资产)v2.9 > **性质**:美术清单生图通道(✦ 用户自跑,现走线上 API)的执行侧文件——每资产一段**自包含完整提示词**:正向 = 通用底座+主体+动作已拼妥、负向 = 通用底座+增补已并妥,整段复制直接贴进工作流即可,**不需要读其他文件、不需要拼装**。人物规格转写自 [character-design.md](character-design.md)(人物设计 v1.0,自 art-bible §5 迁出,圣经 §5 为存根),风格/色彩条款转写自 [art-bible](art-bible.md)(§4.1 主色板 / §4.2 语义色规则);冲突时人物规格以 character-design 为准、色彩以 art-bible 为准。 > **边界**:本文件只管生图通道。图标/格面/样张走脚本管线(⚙ 代理出),规格在 art-bible §4.6 与 [art-assets-checklist](art-assets-checklist.md),不需要提示词。意图动画三档是动画资产,等一屏样张锁方案后另立规格卡,本文件不覆盖。 @@ -252,6 +252,38 @@ Pixel art style. true pixel art game sprite drawn on a tiny 48x72 pixel canvas, 5. **头身**:2–3 头身之内,与站姿样张同世界观。 6. **同形象**:主角三态并排、兄弟精对熊地精、熊地精 A/B 对——兜帽/装备/剪影不串戏。 +## 4bis. 地形填充纹理(2026-09-26 定稿,材质归模型、结构归程序) + +> 范围注:本节为地形类资产首张卡(库原定位=角色级,地形类同库登记)。分工纪律=art-bible §8.5「生产分工」:**模型只出无缝填充纹理,结构件(缘件/轮廓/立面/角件)全部程序化**——autotile 拼接约束超出 2D 生图能力,勿让模型画瓦片结构(实证:5×5 瓦片表每枚必带边框亮框)。 + +**对话式生图控制纪律(2026-09-25/26 实证)**: +1. 同对话续写=对上一张图的**编辑模式**——变体必须各开新对话;同一对话里"same as X but ..."会被当成对最近一张的增量编辑。 +2. 英文 prompt 服从度明显高于中文(Gemini/Nano Banana 语料结构使然),提示词一律英文。 +3. 拼表(一张图多枚)必诱使模型给每枚画框——纯填充纹理一律**一张一跑**。 +4. 差异特征写第一句并给否定约束(如碎石斑变体须写明 `no cracks, no dark lines`);尺寸不写死(模型自定,原图越大裁切余量越足,后处理统一降采样)。 + +**①墙顶基面(无缝岩石)**: +``` +Seamless tileable pixel art texture of warm tan rock surface, top-down, for a dungeon board game. Flat 2D texture only — not an object, no perspective. Pattern fills the entire square evenly and wraps perfectly at all four edges. Absolutely no border, no frame, no bevel, no edge highlight, no vignette, no cast shadow. Uniform directionless lighting. Subtle darker seams between stone patches and small lighter facets, warm tan-brown palette around #8B755B. Clean retro pixel art look, limited palette, no gradients, no text, square image. +``` + +**②墙顶纹理变体 A(裂纹)**: +``` +Same as the rock surface texture but with a few thin darker crack lines scattered across it. Seamless tileable pixel art texture of warm tan rock, top-down, flat 2D texture only, wraps perfectly at all four edges, no border, no frame, no bevel, no edge highlight, no vignette, uniform directionless lighting, warm tan-brown palette around #8B755B, clean retro pixel art, limited palette, no gradients, no text, square image. +``` + +**③墙顶纹理变体 B(碎石斑)**: +``` +Same as the rock surface texture but with a few tiny lighter stone speckles sparsely scattered. Seamless tileable pixel art texture of warm tan rock, top-down, flat 2D texture only, wraps perfectly at all four edges, no border, no frame, no bevel, no edge highlight, no vignette, uniform directionless lighting, warm tan-brown palette around #8B755B, clean retro pixel art, limited palette, no gradients, no text, square image. +``` + +**④地面(无缝泥土,必须明显暗于墙顶)**: +``` +Seamless tileable pixel art texture of dry dirt ground, top-down, for a dungeon board game. Flat 2D texture only — not an object, no perspective. Pattern fills the entire square evenly and wraps perfectly at all four edges. No border, no frame, no edge highlight, no vignette, no cast shadow, uniform directionless lighting. Dark warm brown palette around #564232 — clearly darker than tan rock. A few thin cracks and tiny pebble speckles, sparse. Clean retro pixel art look, limited palette, no gradients, no text, square image. +``` + +后处理(程序侧,生成器 `_tools/gen_terrain_walls.py`,归档 zip 内):周期对齐无缝裁剪→BOX 降采样 32×32→环绕混合→量化(12 色)→结构件合成;②③亦可由①程序加纹理级裂纹/浅斑替代(2026-09-26 实证更稳)。 + ## 5. 明确不在本文件 - **意图准备动画三档、战斗演出类**:动画序列帧,等一屏样张锁动画方案后另立规格卡。 @@ -260,6 +292,8 @@ Pixel art style. true pixel art game sprite drawn on a tiny 48x72 pixel canvas, ## 版本历史 +- **v2.9(2026-09-26)地形填充纹理节批**(高墙批收官,用户拍板):新增 §4bis——地形类首张卡(墙顶基面/裂纹/碎石斑/地面四张自包含英文卡)+对话式生图控制纪律四条(编辑模式/英文优先/分张跑/否定约束);分工纪律转写 art-bible §8.5「生产分工」(模型只出无缝填充纹理,结构件程序化)。 + - **v2.8(2026-09-25)敌种甲档回填批**(圣经×关卡/世界观对齐扫描发现,规格上游 character-design.md v1.6 同批;用户拍板「按最新设定」):三卡随 `enemy.tres` 甲档实态修订——①熊地精 3.2 两版(A/B)正向:魔法甲「暖白符纹饰带」措辞退役,改轻甲「粗陋皮条+裸蓬毛无甲板」;②食人魔酋长 3.3:标题重甲→轻甲,正向「冷灰金属肩胸甲板」改「皮条骨饰+裸厚皮无甲板」,规格注随改;③蛛化卓尔精灵 3.5:标题重甲→魔法护甲,正向加「卓尔上体暖白秘法符纹饰带」(蛛腹几丁质保留、属天然甲壳),规格注随改。duergar/duergar_king 重甲卡与数据一致不动。 - **v2.7(2026-09-23)真像素硬化 + 本地通道清退批**(用户拍板:本地 ComfyUI 生图路线彻底关闭,生图一律线上 API 自跑;gg1 风格诊断后硬化方案随批写入):①全部 13 张正向卡触发词后插入真像素约束段——`true pixel art game sprite / tiny 48x72 pixel canvas / chunky square pixels / strict pixel grid alignment / hard edges / no anti-aliasing / no gradients / limited 16-color palette / aseprite style`;②各卡负向底座并入平滑系禁词——`smooth lines / anti-aliasing / gradient shading / painterly / glossy / high detail / vector illustration`;③§0「现行管线」句(Z-Image-Turbo GGUF + 像素 LoRA + 母版工作流 `art-t2i-master.json`,成因见 v2.1/v2.5)改写为线上 API 口径,自然语言类模型改写指引随批;④「ComfyUI 通道」措辞改「生图通道」(文件名沿用不改)。同日 repo 侧清退:`production/comfy/` 已删、comfy-mcp 注册已移除。 diff --git a/design/research/board-tile-vocab-plan-a-2026-09-26.md b/design/research/board-tile-vocab-plan-a-2026-09-26.md new file mode 100644 index 00000000..59794ad9 --- /dev/null +++ b/design/research/board-tile-vocab-plan-a-2026-09-26.md @@ -0,0 +1,51 @@ +# 方案甲·高墙瓦片词表与查表逻辑(2026-09-26 定稿) + +> 接线批(BoardWorld 查表合成器)的输入规格。定稿资产=`game/assets/art/board/terrain_*_dungeon.png` 21 枚。 +> 规范侧:art-bible §3.2「高墙瓦片体系」/§8.5「生产分工」(v2.9)。 + +## 一、唯一件词表(16 墙瓦片 + 5 地面瓦片) + +| 文件(terrain_ 前缀,均 _dungeon 后缀) | 邻接情形(n/e/s/w=True=邻格是墙) | +|---|---| +| wall_center | 四周皆墙(满格岩石顶面) | +| wall_center_crack / wall_center_speckle | 中心砖纹理变体(裂纹集/碎石斑;破平铺重复,分配 60/20/20) | +| wall_n | 北缘(上方地板):墨线+1px 微亮棱 | +| wall_s | 南缘(下方地板):墨线+立面窄暗条(约 1/3 格高) | +| wall_w | 西缘(左方地板):墨线;**东缘=水平镜像** | +| wall_nw | 凸角(上+左地板) | +| wall_sw | 凸角(下+左地板) | +| wall_hrun | 横条带中段(上下地板):顶微亮棱+底立面条 | +| wall_vrun | 竖条带中段(左右地板):双侧墨线 | +| wall_end_n | 端头(北向死头,南连墙):三向收缘 | +| wall_end_s | 端头(南连地板,北连墙):双侧缘+底暗条 | +| wall_end_w | 端头(左收缘,东连墙) | +| wall_lone | 孤立块(四周地板):四向收缘+底暗条 | +| wall_in_nw | 内凹角(西北对角是地板):角点单像素落线 | +| wall_in_sw | 内凹角(西南对角是地板):角点+立面侧 1px 齐平收头 | +| floor_1..5 | 地面瓦片 5 随机变体(明显暗于墙顶;按格坐标哈希分配) | + +## 二、运行时镜像(flip_h,禁旋转——北受光不受损) + +`wall_e←wall_w`、`wall_ne←wall_nw`、`wall_se←wall_sw`、`wall_end_e←wall_end_w`、`wall_in_ne←wall_in_nw`、`wall_in_se←wall_in_sw`。镜像件不出文件。 + +## 三、查表逻辑 + +1. 墙格取四邻(n/e/s/w)是否墙 → 16 正交情形映射(上表);板外视为墙。 +2. 四邻皆墙时查对角:**双凹角不做专件**——多对角地板时回落单凹角,优先级 nw>ne>sw>se(v3 用户裁定:双凹角仅对角阶梯缺口出现,极罕见,残留 1px 缝可接受)。 +3. 中心砖三变体按格坐标哈希分配(60/20/20),地板 5 变体同法——**初始化随机落定,禁逐轮重掷**(圣经原则三)。 + +## 四、雷坑与覆盖层 + +- 雷格已开态**不在本套**——后续独立贴图层承载(v3 用户裁定;旧 beast-cave 坑砖已于 2026-09-26 随旧砖清理删除,雷格贴图层自产)。 +- 覆盖层留白:墙瓦片给类型角嵌纹样+封印旗让位;地面瓦片中央给数字色牌让位(圣经 §1.2 优先级栈)。 + +## 五、已知限制(接线时知悉) + +1. 相邻成对双凹角(如 nw+ne)无专件,回落单件,角点自连不破闭合。 +2. 每变体单一贴图,大面积墙群有平铺重复感——可加 texture 变体(生成器 tex_idx 参数已留)。 +3. 非 center 基底+对角地板的混合情形(如北开缘+东南对角地板)凹角缺落点——22/47-blob 词表固有,升级 47-blob 另议。 +4. underdark/deep_underdark 换色=AI 纹理色调映射,方案随换色批定(生成器 PALETTES 色槽表已备程序侧三色)。 + +## 六、生成器 + +`归档-terrain-walls-2026-09-26.zip` 内 `_tools/gen_terrain_walls.py`(参数化:色槽表/纹理相位/边缘常量;确定性种子可复现;换色批/微调先解包)。 diff --git a/design/research/terrain-walls-source-evaluation-2026-09-25.md b/design/research/terrain-walls-source-evaluation-2026-09-25.md new file mode 100644 index 00000000..ad1390ec --- /dev/null +++ b/design/research/terrain-walls-source-evaluation-2026-09-25.md @@ -0,0 +1,34 @@ +# 地形高墙瓦片素材搜包评估记录(2026-09-25) + +> 挪档自 `candidates/terrain-walls-2026-09-25/0-需求规格与验收闸.md` §三/§五(批目录 2026-09-26 归档清退,本档为唯一仓内正本)。 +> 结论背景:雷图未挖格=一整块 32×32 自含凸起岩体(方案甲,用户裁决);本评估=为方案甲寻找 CC0 现成缘件包,全灭后转自产(终稿=AI 材质+程序结构,台账 164)。 + +## 一、评估表 + +| 候选 | 授权 | 16组合/结构 | 高墙语言 | 判定 | +|---|---|---|---|---| +| Cavernlock cave terrain(onlyjb) | CC0 | ✓ 有机连通 | ✗ 单一灰噪,缘上零处理,读作迷雾 | 淘汰,留作连通参考 | +| Aftertile | CC0 | — | 水晶幽灵风,非洞窟石质 | 淘汰 | +| Voirol Basic Map 32×32 | CC0 | ✓(地表转场标准 blob 布局) | ✗ 地物转场非高墙 | 留作 blob 布局参考 | +| cave-tileset(blender) | CC-BY 3.0 | 未验(预览损坏) | — | 待续 | +| Zelda-like tilesets and sprites(armm1998) | CC0 | ✗ 无高墙体系(无顶面受光缘件/四向缘/凹角/孤立块) | ✗ cave.png 黑顶系无细节空腔黑,图底分离失败(实证) | 淘汰;**风格✓✓留档=自产缘件的清晰度基准** | +| DCSS dngn(官方仓库取样) | CC0(LICENSE 实证:Public Domain\|CC0 most tiles) | 自含块架构(每族 ×4 变体) | ✓ 顶面+立面+轮廓烘焙于单枚;shadow ×5 向独立投影层 | 最强候选,**用户裁决:不要乙(自含块),坚持甲(缘件查表)** | +| Lost Garden mountain_landscape_25(OGA) | CC0(页面 CC-BY/CC0 双标) | ✗ 整块预排有机地形,非网格缘件 | ✓ 受光碎石顶面+暗立面+垂边,暖棕调 | 方案甲最接近但不可用:任意形状自动拼合不成立(实证),缺内凹角/孤立块 | +| Kenney Tiny Dungeon(kenney.nl,重开复核) | CC0(License 实证) | ✗ 缎带轮廓帽有凸凹角,但无可平铺亮顶面填充/立面带/地板投影层;帽条底色烤死 | ✗ 缎带平墙语言(包作者示例图实证) | **终局否决(用户确认维持方案甲)**:实拼样张证套不进;备查=若他日改「缎带平墙」架构(=修改方案甲裁决),本包为合格候选,届时雷坑砖/色牌/旗同屏适配另验;重下 URL 在批归档内 | + +## 二、方案甲搜包结论 + +- CC0 直达渠道(OGA/GitHub)内,**规整网格+缘件齐全(16 组合+凹角)+洞窟石质**的现成包:未找到。Cavernlock=有机连通无高度;DCSS=自含块;Lost Garden=整块手摆;Tiny Dungeon=缎带平墙。 +- itch.io 三候选当时被墙(代理出口亦被拒),需手动下载验收(若日后重启搜包):Pix-Quest Top-Down(Pixelsnorf)/Pixelart Forest v2 Cliff Update(zedpxl)/FREE Pixel Art Mountains(karsiori)。 +- 由此转自产:先程序全自产(v6/v7 两轮被用户否决:迷彩斑块、砌石物件级)→ 终版 **AI 材质+程序结构混合**(v9.3,台账 164)。 + +## 三、边界处理调研结论(2026-09-25,用户拍板进圣经 §3.2) + +| 来源 | 做法 | +|---|---| +| Tiny Dungeon(CC0) | 1px 深墨线直线分界,墙对沙地/泥土同一条线;直线零锯齿;角部盖帽 | +| oga-zelda-like(CC0) | 水/土边界=深色扇贝形描边;石块逐枚暗描边 | +| ITB | 格级高差靠悬崖立面承担,无全缘墨线 | +| Necesse | 轮廓帽缘件+地板侧投影层(双层地图) | + +结论:墨线职责=分隔,不融合;有了墨线就不需要锯齿(锯齿是无墨线时的遮丑补丁);直线轮廓拼缝天然连续。