diff --git a/design/art/art-bible.md b/design/art/art-bible.md index c402355c..8c20509c 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);现行为 v3.15，历次修订明细见 git 提交史 +> 项目: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);现行为 v3.16，历次修订明细见 git 提交史 > > **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 头身 @@ -164,7 +164,7 @@ - **装饰变体(未开格氛围层)**:覆尘完整砖之上叠加裂纹/碎石斑/物件级点缀等装饰;2026-09-29 v3.0 物件级解禁——物件级装饰(小石块/陶片/骨殖等)须走**专属装饰形状家族**(与信息元素形状语言隔离、灰度下不与任何逻辑元素同形),数量配额按图类型定(候选 3–5 种,样张 v3 冻结),一律残缺、内凹、低对比而自然后退(§3.4);零信息纪律(分布随机、与雷/安/类型零相关、灰度下禁止制造新分类特征、分布每板一次跨轮不复掷)以原则三为准,此处不赘。←原三 - **结果整格表达(已开格)**:已开格按当格结果整格表达(结果清单见原则三);画法——产资源格的家族物件纹样用 §3.1 道具点剪影语言(直线几何体)角嵌于砖缘,砖心与数字字形占位区留白(已开格仍承载数字);危险格巢穴纹较已开格更凶一档,形状+颜色双通道不变。←原三;P3 - **未开格预读通道(微光单通道)**:类型预读 = 类型微光单通道(色相+明度双码,色带 §4.2);色弱类型主通道 = 微光明度梯度（组粒度——组间互辨；§2 微光明度例外）;格内零角嵌/箭头/加号类附加形(2026-09-28 用户裁「微光格只留微光」,退役史见 git 提交史)。←原一;原三 -- **旗(封印印记)**:插旗动作的叙事呈现 = **封印**(玩家可见专名,术语定义见 [术语表](../gdd/术语表.md)「封印」条;插旗动作面见《排雷玩法》)——旗 = 封印印记;封印色(§4.1,现行封印黑)与格内优先级栈位(§1.2)不变。封印特效(施印瞬间 + 印记常显形态)资产归清单 §4 演出类;旗印记纹理已落位、字形占位退役（迭代 9 卡⑬兑现；原 06 债务条目已完成移除）。←原一;P2;术语批 2026-09-25;封印紫批 2026-09-26;封印黑批 2026-09-28 +- **封印印记**:封印动作的叙事呈现 = **封印**(玩家可见专名,术语定义见 [术语表](../gdd/术语表.md)「封印」条;动作面见《排雷玩法》)——封印动作落在格上的印记称封印印记;封印色(§4.1,现行封印黑)与格内优先级栈位(§1.2)不变。封印特效(施印瞬间 + 印记常显形态)资产归清单 §4 演出类;封印印记纹理已落位（现行件=`seal_mark.png`，32×32 可选件）、字形占位退役（迭代 9 卡⑬已实现；原 06 债务条目已完成移除）。←原一;P2;术语批 2026-09-25;封印紫批 2026-09-26;封印黑批 2026-09-28 - **可挖域接触带微光(交互反馈层,2026-09-25 用户拍板)**:挖掘期,英雄格周界与可挖域(概念见《排雷玩法》动作合法性节;呈现义务见《HUD框架》可挖域指示)的接触面画呼吸微光——正交邻墙=该侧整条边,斜向邻墙=共享角点+向两侧各延伸半条边;光只画英雄格(空间)一侧、不进墙格(与装饰变体零冲突,数字砖心不涉);微光=空间的灯光边界(画法口径)。色相=蓝族浅一档(§4.2 蓝条;与主角蓝框的分层归样张批);呼吸=§2.1 挖掘期唯一在动元素,减动效停格。角点为斜墙与正交墙共享、不逐格归因,逐格指认=悬停金框(呈现交互归《HUD框架》悬停指示域)。←§2.1;§4.2;P1 - **墙体**:圆角砌块堆叠,禁尖刺装饰——尖刺专属危险语义,装饰禁止伪装逻辑差异。←原三 - **高墙瓦片体系(2026-09-26 定稿,样张批追认)**:未挖格=**一整块 32×32 自含凸起岩体**(方案甲核心定义);素材语义名——未开格素材=**墙瓦片**,已开格素材=**地面瓦片**(术语 2026-09-26 用户立)。**边界=墨线纪律**:墙瓦片与相邻格分界一律 1px 深墨线、直线贴格边、零锯齿;墨线职责=分隔,不追求与地面融合(Tiny Dungeon 样图实证调研后否决出局——TD 拼块套不进方案甲自含岩体定义,2026-09-25 终局维持方案甲;记录=git 提交 70d2320)。**光照=单一北受光**:北缘=墨线内侧 1px 微亮棱(就地取色提亮,禁宽亮带);西/东缘=墨线后直进纹理、不加修饰;南缘=墨线+立面窄暗条(约 1/3 格高,横层理叠石、禁竖条纹栅栏感)。**凹角**:角点单像素落线;南立面侧凹角加 1px 立面收头——带身与转角竖线同列收尾,禁悬空、禁突出(v9.1/v9.2 两版返工实证)。现行定稿=`game/assets/art/board/terrain_*`(16 唯一墙瓦片+5 地面瓦片变体;词表与查表逻辑见 `高墙瓦片词表（已落码 board_world.gd 查表，文件已退役）`)。**高墙感 D 投影档+整板悬崖(样张 v2 定稿 2026-09-28,用户 2026-09-27 四变体挑档)**:南临空墙格=立面口沿高光 2px `Color8(196,172,132)`+双段暗带(0.16/0.25 格边,黑罩 α0.60/0.82);北邻墙地面格=三段渐隐投影(顶带 0.22 格边,α0.28 起);整板悬崖=板底/右侧 `DEPTH_PX 8px` 暗面+列分隔竖缝+岩层横纹+口沿高光+接触 AO+底线收边+悬浮影(游戏 `board_world.gd` 同款结构件,样张脚本与游戏渲染常量同源——机检 F7 承载)。←原三;状态记录 164;样张 v2 批 2026-09-28 diff --git a/design/art/asset-path-map.md b/design/art/asset-path-map.md index 42262455..6173e83d 100644 --- a/design/art/asset-path-map.md +++ b/design/art/asset-path-map.md @@ -27,7 +27,7 @@ |---|---|---| | `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__.png（三关地面系）、flag_seal.png | +| `board/` | 砖面/封印印记（三关换皮 + 封印印记件；2026-10-06 对账更正——旧 `board_floor/wall/pillar_dungeon_*` 命名退役） | terrain_floor__.png（三关地面系）、seal_mark.png | ## 4. 坐标/朝向等工程侧约定备查 diff --git a/design/gdd/06-待办清单.md b/design/gdd/06-待办清单.md index 68e500dc..ea7dc883 100644 --- a/design/gdd/06-待办清单.md +++ b/design/gdd/06-待办清单.md @@ -689,3 +689,13 @@ **归属**：①`奇物.md` §1.1／§2.2／v2.2 行（已订正写入文档）；②`奇物.md` §1.3（:121／:223／:229）与 `02-系统清单.md:49`（待裁） **状态**：已写入（design/gdd/systems/冒险循环/奇物.md v3.19——第①项专长凭证归类订正）＋待裁决（第②项资源判据句，心智模型未对齐，不列候选不提前处置） + +--- + +#### 玩家面残留禁字清扫——图例/明细/日志/字形五处（2026-10-20 登记，来源=批次移交，设计面=工程直入） + +**现状**：迭代 31 卡① 已把 `game/` 的金币／插旗／雷格／惩罚格／`flag` 清零，但玩家可见文本仍残留「雷／排雷／插」五处（v3.15 命名纪律：玩家面禁「雷」，危险格对外风味＝地下城陷阱／怪物巢穴）：①`legend_overlay.gd:11` 图例行「插错可左键直接挖开…危险格吃**挖雷**惩罚」；②`status_slot_row.gd:42` 与 `settlement.tres:14` 明细来源名 `"mine_hit": "踩雷"`；③`battle_log_view.gd:194` 战斗日志「本板**完美排雷**已破——归因此封印」；④`board_fx_view.gd:102` 横幅「**完美排雷** ×2」；⑤`board_view.gd:737` 已开危险格单字字形 `glyph = "雷"`。①-④ 纯文案零风险；⑤ 改字形会动 golden 基线，须同步重制 C 档基准。开发注记面（`ui_kit.gd:37` 常量名 `RED_MINE` 与其注释）属内部语，按纪律保留。 + +**归属**：`game/presentation/` 与 `game/data/tables/settlement.tres`（走独立 worktree 批；⑤ 连带渲染基线） + +**状态**：待写卡 diff --git a/design/gdd/07-体验验证清单.md b/design/gdd/07-体验验证清单.md index fca4e440..23fd6bc9 100644 --- a/design/gdd/07-体验验证清单.md +++ b/design/gdd/07-体验验证清单.md @@ -302,3 +302,19 @@ | 3 | 出圈灭、入圈复亮 | 角色走远出 8 格圈→微光灭；走回→复亮；换图随旧图全重置 | | 4 | 整屏不脏 | 满圈微光同屏时棋盘不显脏、不抢焦点（焦点预算观感的人眼侧） | | 5 | 群伤暗档观感 | 绯红暗档 #A61D37（V=0.65 provisional）与其余四组同屏时的区分度、以及与危险红不误读的观感——读数归样张批复核 | + +--- + +## ㉙ 代码术语刷新与凭证件裁削批——玩家面目检（迭代 31 卡①/卡②；能力验证半=冒烟 1151 项 0 失败＋单元 34 套全绿＋对拍 120 局真差异 0 行＋`feat_vouchers` 39 项全绿＋变异六条五红） + +> 卡① 是纯重命名批（行为零变化），卡② 删两件凭证、把完美保险改为专长订阅式。机检能证明词面清零、数值零漂移与验收组全绿，但玩家面「旧词是否真的不见了、贴图是否还在、豁免的实际观感」仍要人眼看。登记不阻塞（2026-10-12 真人检测立规）。 + +| # | 目检项 | 判据 | +|---|---|---| +| 1 | 商店货币显示 | 商店界面货币显示「GP」，不再出现「金币」 | +| 2 | 图例/HUD 封印文案 | 图例与 HUD 显示「封印／封印印记」，不再出现「插旗／旗」；板面单字字形现为「封」 | +| 3 | 结算明细来源 | 结算明细来源显示「封印命中／封印未中」 | +| 4 | 封印印记贴图三关加载 | `seal_mark.png` 在 L1/L2/L3 三关均正常加载，非字形回退态 | +| 5 | 完美保险卡面文案 | 专长卡面文案读作「本场首次封印落空，不计入完美封印判定」，零「雷」字 | +| 6 | 稀有档三选一 | 三选一带不再出现同调电池／完美保险；稀有档仅剩 ap／rap／time_sand 三种 | +| 7 | 豁免后的完美第二份 | 带完美保险专长时，首次标错后清图仍能拿到「完美第二份」（订阅式豁免的实际观感） | diff --git a/design/gdd/systems/冒险循环/奇物.md b/design/gdd/systems/冒险循环/奇物.md index 4719d536..19f0dea7 100644 --- a/design/gdd/systems/冒险循环/奇物.md +++ b/design/gdd/systems/冒险循环/奇物.md @@ -104,7 +104,7 @@ 惊巢反制=退役进素材库（不迁入）。 -**资源类迁出件（2026-10-18 用户裁）**：完美保险自资源类迁入专长——理由：它给的是**规则豁免**而非可调动的余量（§1.1 判据「给规则的是专长」），效果=本场首次封印落空不计入完美封印判定。旧「资源类成员」归类系 2026-10-08 框架批写入、无用户裁断支撑，随本次改判注销。专长行的触发器规格与代码实现（含效果引擎词表扩签）归独立批，见 06 登记。 +**资源类迁出件（2026-10-18 用户裁）**：完美保险自资源类迁入专长——理由：它给的是**规则豁免**而非可调动的余量（§1.1 判据「给规则的是专长」），效果=本场首次封印落空不计入完美封印判定。旧「资源类成员」归类系 2026-10-08 框架批写入、无用户裁断支撑，随本次改判注销。专长行已于迭代 31 卡② 落表（合并 `3e076e22`）：`feats.tres` 单行 `when counter(insurance_used) lt 1` 承载「本场首次」，效果类型 `forgive_seal_miss` 随引擎扩签；配额按净删重裁（rare 9→7、总量 104→102）。 ### 扩签登记（迭代 20 实装已承载——2026-10-12 追认④写入文档换代） @@ -231,6 +231,7 @@ **补给类内部的异质性（统一表述）**：凭证全部即时消尽——不存在「持有凭证」这种状态；异质性不在凭证上，而在**被写入的系统资源的寿命**上：GP 钱包 / 生命 / 刷新存量 = 冒险级，储备池 = 节点级，时沙暂记 = 至下一战首轮兑付（系统资源清单对齐「凭证件表（新 3+留任 2）」节；「AP 上限」已归属性值提升轴，见 1.2）。 - 原在册的「秘宝充能」「完美资格」两笔随 2026-10-18 两件裁削注销——`attune_charges` 账本本身仍为秘宝基础设施保留（迭代 11，主动件充能每冒险重置），本次只删奇物侧写它的入口。 +- 完美资格的豁免走**订阅式自有累加账**：授予段在 `seal_missed` 命中时累加豁免数，判定取「误标总数 − 豁免数」得有效数；**不改写误标账本身、不拦截事件**（迭代 31 卡② 契约 2/3）。 - 登记此节防止把凭证当成会持续生效的东西去结算。 #### 1.4 分类判据 diff --git a/design/gdd/ux/interaction-patterns.md b/design/gdd/ux/interaction-patterns.md index f8c7e79e..584fc018 100644 --- a/design/gdd/ux/interaction-patterns.md +++ b/design/gdd/ux/interaction-patterns.md @@ -87,7 +87,7 @@ MVP 未使用标准控件（不入库）：toggle / dropdown / input field / tab - 数据源：[战斗结算](../systems/战斗循环/战斗结算.md#明细流水每一行都能指回你刚才的哪一步棋)步骤流（9 类行封闭协议（现行）；公共字段 `type/source_class/origin_cell/round_index/display_name/value/highlight?`）；**无来源行 = 断言失败** - 行模板：「{行为} {值} → {目标}（来源）」——来源标注（第 N 轮 · 安全格式）；行文案最长 token = 来源标签（4 汉字封闭枚举），模板预留 40% 膨胀宽度 - 聚合纪律：未生效类行（奖励未生效——现行 9 类行协议唯一未生效型，2026-09-20 收敛）按聚合计数呈现（防逐行惩罚轰炸）；衰减行聚合计数；效果行 value=单次贡献值、禁与 pool_value（池合成值）相加呈现；零值行可见不吞（免伤轮归因不断点） -- 高亮：highlight 字段 {flag_hit, clear_reward_h2, perfect_broken} → 金框强调；完美排雷 = 独立高光行 + 全屏喝彩级反馈 +- 高亮：highlight 字段 {flag_hit, clear_reward_h2, perfect_broken} → 金框强调；完美排雷 = 独立高光行 + 全屏喝彩级反馈。`perfect_broken` 的判据句读作「本板首次标错受检」，不等于完美资格已失——专长「完美保险」可在本场首次标错时豁免，实际资格按有效误标（误标总数 − 豁免数）判定 - 布局：固定槽高 + clip_contents；正文 ≥14px；数值暗底高对比；未生效类行带 icon/划线形状冗余 - 击杀标记呈现（H3 数据源 = 战斗结算流水击杀结果字段） diff --git a/design/gdd/术语表.md b/design/gdd/术语表.md index 7e816b21..5c080b48 100644 --- a/design/gdd/术语表.md +++ b/design/gdd/术语表.md @@ -11,7 +11,7 @@ | 安全格 | 没有惩罚的格子——挖开安全并获得其上信息与收益 | | 整图 | 单张棋盘（的整个范围）——原「整图」退役（2026-10-11 用户裁）。例：整图叠加层、整图作用域 | | 叠加层（整图叠加层） | 秘宝产生的信息的自持容器：按效果分类的格集，随图消亡、不回写棋盘（见[秘宝](systems/跨局循环/秘宝.md)） | -| 封印 / 控制 | 封印动作的机制名/玩家名：封印印记落在危险格上为「标中」（危险格被控制、化险为利），封错为「标空」（原「旗 / 控制」，2026-10-18 用户裁：「旗」概念不存在——动作=封印、印记=封印印记） | +| 封印 / 控制 | 封印动作的机制名/玩家名：封印印记落在危险格上为「标中」（危险格被控制、化险为利），封错为「标空」（原「旗 / 控制」，2026-10-18 用户裁：「旗」概念不存在——动作=封印、印记=封印印记）；代码契约键与标识符统一用 `seal_*`（原 `flag_*` 全族换代），板面单字字形=「封」 | | 真视 | 直接告诉玩家某范围内哪些格是危险格的效果（秘宝承重契约：一次最多 3×3，见[秘宝](systems/跨局循环/秘宝.md)核心规则） | | 类型微光 | 棋盘上按格子类型显示的提示光效（视野参数控制其显示范围） | | 换图 / 弃图刷新 | 清完一图进入下一图 / 花储备放弃当前图重开一张（代价见[行动经济](systems/排雷循环/行动经济.md)） | @@ -81,6 +81,13 @@ 两类的判定与道具定义卡必答见[核心循环](01-核心循环.md)「结算目标分两类：总线与抽屉」节。 +## 战斗与效果 + +| 术语 | 定义 | +|---|---| +| `seal_missed` | 封印落空事件（原 `flag_missed` 换代）：封印动作落在安全格上时发出，订阅面据此做限次与豁免判定（迭代 31 卡② 落地） | +| `forgive_seal_miss` | 本场首次封印落空豁免——专长「完美保险」的效果类型，`domain=battle` 首例；有效误标＝误标总数 − 豁免数，豁免不改写误标账（迭代 31 卡② 落地） | + ## 开发流程 | 术语 | 定义 | @@ -113,11 +120,12 @@ 注：「注销」仅用于清单条目办结义（销号/销账的替换词）；「结束登录状态」义仍按 STC 用「退出登录」。 -### B. 豁免条款（三类文本不改写） +### B. 豁免条款（四类文本不改写） 1. **历史文本**：git 提交说明、裁决记录中引用用户原话的句子——保留原用词，不按 A 表追改。 2. **对照性文本**：「退役词对照」表本身、「原 ××」式更名记载、禁令引举句——旧词在这些位置是内容本身，不是残留。 3. **玩家可见专名与机制词**：按「对外命名纪律」节与各系统文档现行用语使用（标中/踩雷等机制词在文档内部照常用）。 +4. **被检查的禁字不算使用**：守卫代码里作为检查对象的禁字字面量——`game/smoke/smoke_all.gd` 的 `contains("旗")` 检查项、`game/tests/unit/presentation/ui_font_asset_test.gd` 的字形集负探针、`game/data/tables/feats.tres` 头注的「desc 禁『雷/旗』字面」、`tools/doc_term_audit.py` 的退役词表定义行——不属换代范围：被检查的字不是对该字的使用，改写等于自毁守卫。术语清扫的复扫口径按 **game/ 全部文件类型、不排除任何扩展名**执行（迭代 31 卡① 实测：金币／插旗／雷格／惩罚格／`flag` 均 0 命中，残留仅为上述保留面）。 存量口径：A 表生效前已入库的正文不做强制清扫；文件后续被批次触碰时，顺带按 A 表换代。 @@ -135,6 +143,7 @@ | 金币 | GP（2026-10-18 用户裁：GP 是唯一正式命名，「金币」系 AI 噪音全库禁用） | | 插旗 | 封印（2026-10-18 用户裁：封印=正式动作名，全库统一，非比喻非「对外表达」别名） | | 旗（游戏概念语境） | 封印印记（2026-10-18 用户裁：「旗」概念不存在——封印动作落下的印记称封印印记） | +| flag_*（代码契约键/标识符） | seal_*（2026-10-18 用户裁全族换代；迭代 31 卡① 已清零） | ## 对外命名纪律（玩家可见命名，2026-10-11 用户令）