Merge branch 'master' into chat-style-v2
This commit is contained in:
DKChan committed
commit
ef98a879ec
14 files changed
+3202
-1722
No files matched your search
@@ -1,7 +1,7 @@
|
||||
# 生图提示词卡(角色级资产)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),不需要提示词。意图动画三档是动画资产,等一屏样张锁方案后另立规格卡,本文件不覆盖。
|
||||
> **边界**:本文件只管**角色级**资产的生图通道。图标/格面/样张走脚本管线(⚙ 代理出),规格在 art-bible §4.6 与 [art-assets-checklist](art-assets-checklist.md),不需要提示词。**场景级资产(营地场景图的背景层与八个物件层)另立 [camp-scene-prompts](camp-scene-prompts.md),本文件不覆盖**;两卡的角色/场景分工以「谁的资产谁出卡」为界,同一段提示词不两处维护。意图动画三档是动画资产,等一屏样张锁方案后另立规格卡,本文件不覆盖。
|
||||
> **前世**:v1.0(2026-09-20,主角三态+六敌种)于 2026-09-22 经裁决移除;本版按「美术圣经 §5 落地后重生成」拍板重写(正序:B 路线),继承 seed 纪律 / 色相禁入带 / `#F2F2F2` 生成底色。**建立**:2026-09-22 · 状态:提示词卡成文,出图未开始
|
||||
|
||||
---
|
||||
|
||||
@@ -0,0 +1,156 @@
|
||||
# 营地场景 · 分层生图提示词卡 v1.0
|
||||
|
||||
> **性质**：营地场景图（1280×800，一张可点击场景图 + 八个物件层）的出图执行侧文件。**场景级资产，与角色级 [art-prompts](art-prompts.md) 并列，两文件互不覆盖**。
|
||||
> **依据**：色彩与氛围 = `reports/提案-营地色彩与氛围脚本-2026-10-23.md`（本卡不复述色值）；坐标与层序 = `artwork/2026-10-23-营地场景/布局草案-1280x800.html`；物件命名与消费链 = [asset-path-map](asset-path-map.md)；画法与交付形态 = [art-bible](art-bible.md) §6.2。冲突时色彩以色彩脚本为准，画法以 art-bible 为准。
|
||||
> **边界**：只管营地场景图的分层出图。角色、图标、格面走 art-prompts.md 与脚本管线，不需要提示词。
|
||||
> **建立**：2026-10-25 · 状态：九条提示词成文，出图未开始（出图通道由作者自定）
|
||||
|
||||
---
|
||||
|
||||
## 0. 使用流程（四步）
|
||||
|
||||
1. **出图**：按下面各条把提示词贴进生图渠道。出图前先放**风格参考图**（见 §1）。
|
||||
2. **入库**：候选原图放 `artwork/candidates/<资产名>/`，文件名 `v1.png / v2.png / v3.png`。
|
||||
3. **后处理**：脚本管线代跑——去底转透明、降采样到终稿尺寸（整数倍）、色板量化、四联底测试条。
|
||||
4. **转正**：终稿转入切片资产目录，按坐标表接线。
|
||||
|
||||
**出图顺序（先锁后产，不能跳）**：概念脚本 → **本卡提示词** → 贴风格参考图出背景层 → 作者确认风格前缀 → 才扩产八件。
|
||||
|
||||
---
|
||||
|
||||
## 1. 风格参考图（每次出图都要带）
|
||||
|
||||
| 参考图 | 作用 |
|
||||
|---|---|
|
||||
| `artwork/2026-10-23-营地场景/Gemini_Generated_Image_ykrc0nykrc0nykrc.jpg` | 定色调、氛围、构图关系（作者提供的参照物） |
|
||||
| `game/assets/art/character/character_hero_idle.png` | 定像素密度、平涂质感、描边（项目自家已定稿像素图） |
|
||||
|
||||
**禁止**拿未经验证的自造图当参考图——风格错了整批全废。
|
||||
|
||||
贴参考图时，在提示词末尾接这一句：
|
||||
|
||||
```
|
||||
Style reference: the attached images are this game's own finished pixel art and its camp scene reference — match only their rendering style, the same pixel density, flat shading, thin warm cream outline and warm limited palette. They are style references only: do not copy their character, gear or props, and do not put any character into the scene.
|
||||
```
|
||||
|
||||
> **描边取奶油色**，不取参照物的深灰褐：去底脚本走"奶油描边膨胀 3px 当屏障"吞底色，深褐描边会让该步失效。这条是技术前提，不是美术取向；若改深褐，需另换去底方案。
|
||||
|
||||
---
|
||||
|
||||
## 2. 背景层（`scene_camp_bg`，不可点，不透明全幅）
|
||||
|
||||
**出图画布**：2560×1600（终稿 1280×800 的 2 倍，保证整数倍降采样）
|
||||
**画什么**：天空、远山、地面、木围墙、门柱与门洞
|
||||
**不画什么**：七个物件、门扇、角色、接地阴影——那些是上面的独立图层
|
||||
|
||||
```
|
||||
Pixel art style. True pixel art game background layer drawn with chunky square pixels, strict pixel grid alignment, hard edges, no anti-aliasing, no gradients, flat colors only, a limited palette of about 24 colors, retro 16-bit look, Aseprite style, all ages, flat side view, orthographic, no perspective distortion. Wide horizontal composition, 16:10 aspect ratio. This is the BACKGROUND LAYER ONLY of a small adventurer camp: sky, distant hills, ground and the wooden palisade wall around it. It must contain no camp objects, no gate leaves, no characters and no drop shadows, because all of those are drawn as separate transparent layers on top of this one. COLOR SCRIPT — cool recedes, warm advances: the sky, the hills, the ground and the wall are all COOL, pale, desaturated and low in contrast; there is no warm accent anywhere in this layer, warm color belongs only to the separate object layers drawn on top. ATMOSPHERIC DEPTH: every plane that is farther away is lighter, closer to the value of the sky, cooler, lower in contrast and simpler in detail, while the nearest plane is the darkest and highest in contrast. SKY (top of frame): the lightest thing in the picture, flat pale cool off-white with a faint blue-grey tint, no yellow or cream tone, no sun anywhere; the very top strip of the frame, about one sixteenth of the frame height, stays completely calm and empty because a HUD bar is drawn over it; at most one or two extremely simple flat low-contrast clouds. FAR DISTANCE: two or three layers of low rolling hill silhouettes in pale cool blue-grey, each farther layer lighter, cooler and lower in contrast than the one in front, fading towards the value of the sky, no trees, no individual foliage; the foot of the hills is cut off and hidden behind the wall, so there is no visible horizon line and no distant ground band between the hills and the wall. MIDDLE GROUND: the base line where the logs meet the ground sits at two thirds of the frame height measured from the bottom edge; at that height runs a wooden palisade wall across the whole width of the frame, built from closely spaced vertical logs standing side by side with no gaps between them, every log cut to a sharp point at the top, a solid barrier that completely blocks the view of the outside — no horizontal rails, no see-through gaps, no ranch-style post-and-rail fence; the wall is painted in a muted, greyed wood brown. In the middle of the wall one wide gap holds two thick gate posts slightly taller than the wall, and between them an opening showing a dirt path running away into the distance; the gate opening itself stays empty, because the two gate leaves are a separate layer. FOREGROUND GROUND: the darkest area of the picture, dry packed bare earth in a neutral desaturated grey-brown, never golden, amber or warm yellow, hard flat color blocks, hard edges, no gradient, no grass, no grass tufts, no weeds and no plants of any kind; the ground meets the foot of the wall cleanly with no shadow band and no gradient. Do not add any of the following: realistic, photorealistic or 3D rendering; painterly brushwork, smooth anti-aliased lines, gradient or dithered shading, glossy highlights; black or heavy dark outlines; drop shadows, contact shadows or any shadow band; blur or compression artifacts; a vignette, dark corners, or any mood darkening; night, dusk, moon, stars, sunset or sunrise light; a sun or any light source drawn in the sky; a visible horizon line, a distant ground band or any distant grass strip below the hills; trees, forests or foliage in the distance; grass, grass tufts, weeds or plants in the foreground; a ranch-style post-and-rail fence, a see-through fence, flat-topped posts or horizontal rails; any warm, golden, amber or yellow cast on the sky, on the hills or on the ground; any camp object, furniture, crate, barrel, fire, tent or tool; any gate leaf, door panel or hinge; any purple or magenta anywhere; any text, letters, numbers, watermark, signature or logo; any frame, border, panel, arrow or UI element; any characters, people, creatures or animals.
|
||||
```
|
||||
|
||||
### 出图画布上的坐标（终稿 ×2）
|
||||
|
||||
| 元素 | 终稿 1280×800 | 出图画布 2560×1600 |
|
||||
|---|---|---|
|
||||
| 顶栏 HUD 保留带 | y ≤ 48 | **y ≤ 96**（保持空旷） |
|
||||
| 围墙带 | y 267–310 | **y 534–620** |
|
||||
| 门洞（必须留空） | x 520–760 | **x 1040–1520** |
|
||||
| 门柱 | x 500–520 / 760–780 | **x 1000–1040 / 1520–1560** |
|
||||
|
||||
---
|
||||
|
||||
## 3. 八个物件层（透明底，单件各一张）
|
||||
|
||||
### 组装方式（不要逐条重复前缀）
|
||||
|
||||
每件提示词 = **风格前缀** + **本件正文** + **否定后缀**。前缀与后缀在**本节单点定义**，九张共用，避免同一段话九处维护。
|
||||
|
||||
**风格前缀**（八件共用，照抄）：
|
||||
|
||||
```
|
||||
Pixel art style. True pixel art game object drawn with chunky square pixels, strict pixel grid alignment, hard edges, no anti-aliasing, no gradients, flat colors only, a limited palette of about 24 colors, retro 16-bit look, Aseprite style, all ages, flat side view, orthographic, no perspective distortion, one single object, centered, the whole object visible with a small margin around it, on a plain flat uniform light grey #F2F2F2 background, thin warm cream outline around the whole silhouette, flat shading, and one small dark oval contact shadow directly beneath the object.
|
||||
```
|
||||
|
||||
**否定后缀**（八件共用，照抄）：
|
||||
|
||||
```
|
||||
Do not add any of the following: realistic, photorealistic or 3D rendering; painterly brushwork, smooth anti-aliased lines, gradient or dithered shading, glossy highlights; black or heavy dark outlines; blur or compression artifacts; a vignette, dark corners, or any mood darkening; any purple or magenta anywhere; any text, letters, numbers, watermark, signature or logo; any frame, border, panel, arrow or UI element; any characters, people, creatures or animals; any scenery, any ground plane or any second object — plain flat uniform light grey #F2F2F2 background only.
|
||||
```
|
||||
|
||||
### 逐件正文（只替换这一段）
|
||||
|
||||
| 件 | 层 | 终稿矩形 | 出图画布 | 正文 |
|
||||
|---|---|---|---|---|
|
||||
| 布告板 | L1 | 130×140 | 260×280 | §3.1 |
|
||||
| 门扇 | L2 | 240×220 | 480×440 | §3.2 |
|
||||
| 木桩 | L3 | 120×180 | 240×360 | §3.3 |
|
||||
| 锻炉·铁砧 | L4 | 240×240 | 480×480 | §3.4 |
|
||||
| 帐篷 | L5（不可点） | 300×170 | 600×340 | §3.5 |
|
||||
| 宝箱 | L6 | 130×90 | 260×180 | §3.6 |
|
||||
| 笔记本 | L7 | 100×80 | 200×160 | §3.7 |
|
||||
| 篝火 | L8 | 160×160 | 320×320 | §3.8 |
|
||||
|
||||
**3.1 布告板（→ 图鉴）**
|
||||
```
|
||||
A wooden notice board hung on a wall, with two or three blank pinned papers, no writing on them, one corner of a paper slightly curled; wood brown #8A5A34 frame, warm tan stone #C9AF83 papers.
|
||||
```
|
||||
|
||||
**3.2 门扇（→ 冒险）**
|
||||
```
|
||||
Two wooden gate leaves hanging from their hinges, half open and tilted outward, each made of thick planks with a cross brace and dark iron fittings, seen from the front, the pair shown together as one single object; wood brown #8A5A34 planks, dark iron fittings.
|
||||
```
|
||||
|
||||
**3.3 木桩（→ 天赋树）**
|
||||
```
|
||||
A single wooden training post standing on the ground, wrapped with a straw rope pad around its middle, rounded top; wood brown #8A5A34 post, straw rope in warm tan #C9AF83.
|
||||
```
|
||||
|
||||
**3.4 锻炉·铁砧（→ 锻造工坊）**
|
||||
```
|
||||
One single forge object made of two tightly joined parts standing close together with only a small vertical offset: a stone forge with a short chimney and a warm orange glow in its mouth, and directly in front of it a dark iron anvil on a low block, the anvil partly hidden behind the forge; warm tan stone #C9AF83 stone body, wood brown #8A5A34 accents, the forge mouth glowing candlelight yellow #F6C667.
|
||||
```
|
||||
|
||||
**3.5 帐篷（承载件，不可点）**
|
||||
```
|
||||
A canvas tent with a low wooden frame and a fabric flap tied back to one side, showing a dark opening; canvas in warm tan #C9AF83, frame and poles in wood brown #8A5A34.
|
||||
```
|
||||
|
||||
**3.6 宝箱（→ 秘宝匣）**
|
||||
```
|
||||
A small closed wooden treasure chest with dark iron bands and a small lock plate on the front; wood brown #8A5A34 body, dark iron fittings.
|
||||
```
|
||||
|
||||
**3.7 笔记本（→ 生涯记录）**
|
||||
```
|
||||
A small open journal lying flat, pages spread open, no writing on the pages; paper in warm tan #C9AF83, cover in wood brown #8A5A34.
|
||||
```
|
||||
|
||||
**3.8 篝火（→ 离开营地）**
|
||||
```
|
||||
A campfire made of a ring of grey stones around crossed stacked logs with a warm orange-yellow flame above them; warm tan stone #C9AF83 stones, wood brown #8A5A34 logs, candlelight yellow #F6C667 flame, and this flame is the single most saturated area of the object.
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. 验收（机检 + 目检）
|
||||
|
||||
**背景层**
|
||||
- 黄度 =(R+G)/2−B 分区取样：天空 ≤20、远山 ≤20、地面 ≤35
|
||||
- 冷色像素占比 ≥55%；本层不应出现任何暖色高饱和像素
|
||||
- 目检：顶部约 1/16 完全空旷；无地平线；围墙密排尖桩、桩顶削尖、不透缝；门洞空着没有门扇
|
||||
|
||||
**八件**
|
||||
- 单件居中、四周留边、整件完整不出画
|
||||
- 底色均匀 `#F2F2F2`、奶油描边闭合（去底脚本要能识别到屏障）
|
||||
- 正下方一个小深色接地影
|
||||
- 单张色数 ≤32（量化后）、缩放为整数倍无拉伸痕迹
|
||||
- **篝火例外**：整张仍画火堆＋火焰，命中矩形只取下半（上半火焰只展示不可点），分界线等成图后按实际画面切
|
||||
|
||||
---
|
||||
|
||||
## 5. 待裁（不阻塞出图，阻塞坐标表与定稿）
|
||||
|
||||
1. **帐篷尺寸**：现 300×170 待重定，重定后按比例重出
|
||||
2. **门扇高宽**：现 240×220，围墙带只有 43px 高，比例待裁
|
||||
3. **布告板位置**：现 y330 悬空在围墙下方，建议 `(845, 268, 130, 140)` 挂回围墙带
|
||||
4. **描边颜色追认**：本卡按奶油色（去底技术前提）；若改参照物的深灰褐，需换去底方案
|
||||
5. **营地环境子板色值**：art-bible §4.1 为数值单点，色值待作者拍板，本卡不复述
|
||||
@@ -133,44 +133,58 @@
|
||||
|
||||
### 12.1 待办清单条目格式与状态机
|
||||
|
||||
待办清单是流水线的唯一登记处：要做的事先登记一条，随流水线段推进改状态，做完整条删除。一条条目分两层——**标题=登记元数据**（何时登记、从哪来、走哪条设计轨，登记后不再变），**正文=四个属性**（随进程演进）。
|
||||
待办清单是流水线的唯一登记处：要做的事先登记一条，随流水线段推进改状态，做完整条删除。一条条目分两层——**标题=登记元数据**（何时登记、从哪来、紧急度，登记后不再变），**正文=四个属性**（随进程演进）。四个属性各管一件事：`实况` 管凭据，`缺口` 管这条的**输入**（还缺哪一次设计），`改动面` 管这条的**产出**（要动哪些面），`状态` 管这条走到流水线哪一段。
|
||||
|
||||
标题格式（尖括号处按实际填写）：
|
||||
标题格式（尖括号处按实际填写，方括号内为可选段）：
|
||||
|
||||
```
|
||||
#### <条目名>（<YYYY-MM-DD>登记，来源=<playnote／会话提及／审计发现／批次移交>，设计面=<文档轨／美术轨／双轨／工程直入／反哺点>）
|
||||
#### <条目名>（<YYYY-MM-DD>登记，来源=<playnote／会话提及／审计发现／批次移交>[，优先级＝<P0／P1／P2>]）
|
||||
```
|
||||
|
||||
`优先级` 是紧急度标记，可选，规则三条：不写＝默认档 P2；只有用户明示才写，会话不得自行给任何条目定档；P0 最高、P2 最低。它只服务阅读时的排序，不参与开工门、编排四查与状态机。`P0/P1/P2` 这组记号在本仓库只指待办紧急度，新文档禁另立别义。
|
||||
|
||||
正文四属性模板：
|
||||
|
||||
```
|
||||
**现状**＝关联文档清单，一行一件：它是什么（设计定稿／需求卡片／相关文档）＋文件路径＋版本号与日期（闭合类文件必带）；必要时在清单前配一句现状说明。机制解释与论证过程不写在这里，归权威文档。路径用普通文本或行内代码书写，机器可搜索。工程直入条目必须在现状里指认证据（bug 证据或工程债条目）。
|
||||
**缺口**：还差哪一次设计讨论／哪份设计产物才能写卡。尚有未闭合的设计轨时此属性必须存在；全部设计轨闭合后删除。
|
||||
**归属**：主责系统文档或线别。
|
||||
**实况**＝关联文档清单，一行一件：它是什么（设计定稿／需求卡片／相关文档）＋文件路径＋版本号与日期（闭合类文件必带）；必要时在清单前配一句实际情况说明。机制解释与论证过程不写在这里，归权威文档。路径用普通文本或行内代码书写，机器可搜索。无设计线段的条目（需求性工程条目与直改类条目）必须在实况里指认证据（bug 证据或工程债条目）。
|
||||
**缺口**：还差哪一次设计讨论／哪份设计产物才能写卡。尚有未闭合设计段时此属性必须存在；设计线全部闭合后删除。
|
||||
**改动面**＝文档／美术素材／游戏代码／工具代码 四档取多，多档用＋连接、禁重复、按上表次序排列。登记时即写，随进程若产出面变宽要补档。
|
||||
**状态**：按状态机取词。
|
||||
```
|
||||
|
||||
状态机按标题里的设计面分轨，状态一律取下例用词。状态行按**状态段累积制**书写：条目每推进一段，就把新状态段接在状态行末尾，段与段用＋号连接，书写顺序=推进顺序；已过去的段一律保留、禁删——状态履历供编排四查与开工核验比对。每段各自按状态词白名单校验，＋号只作状态段连接符。
|
||||
`改动面` 四档的划线判据（按被改对象的路径归属，与闸的分域同口径）：
|
||||
|
||||
```
|
||||
各轨推进序列（双轨条目设计阶段两段并列推进，一文档轨一美术轨）：
|
||||
文档轨：待文档设计 → 文档设计中 → 文档设计已闭合
|
||||
美术轨：待美术设计 → 美术设计中 → 美术设计已闭合
|
||||
进入下游段（待写卡及之后）的前置条件——双轨：两个设计轨闭合段都在场；单轨：本轨闭合段在场
|
||||
下游共用序列：待写卡 → 已写卡 → 已编迭代 N → 完成即整条删除
|
||||
直改类（工程/文档设计/美术素材改动）：登记 → 待执行 → 完成即整条删除（经设计讨论的可前置闭合段，如「文档设计已闭合＋待执行」）
|
||||
单轨累积示例（已编迭代）：文档设计已闭合＋待美术设计＋已写卡＋已编迭代 2
|
||||
```
|
||||
|
||||
状态行只写状态词：去掉特批标记与「（备选）」后缀后，残留任何括号即违规。闭合类状态词（文档设计已闭合／美术设计已闭合／已写卡／已写入）的证据——设计定稿路径+版本、art-bible 条款版本、需求卡片路径、落点文档+版本——一律写在现状的关联文档清单里，由流水线闸到正文核对；已编迭代 N 段的交叉核依据＝现状清单里的需求卡片路径。
|
||||
|
||||
三条特殊通道：
|
||||
|
||||
| 设计面 | 通道规则 |
|
||||
| 档 | 覆盖范围 |
|
||||
|---|---|
|
||||
| 工程直入（需求性） | 缺陷修复／重构等改游戏行为的条目＝需求改动：登记即「待写卡」，凭现状里指认的证据跳过设计轨 |
|
||||
| 工程直入（工程性） | 工程债／测试基建／工具维护等不动游戏行为的配套条目＝工程改动：登记即「待执行」，用户发令直改，不走写卡 |
|
||||
| 反哺点专条 | 待裁决 → 已写入 → 删除 |
|
||||
| 文档 | 本仓库的 .md 权威文档：`design/` 设计文档与 `design/engineering/` 规约、`design/art/art-bible`、根流程件（roadmap／待办清单／体验验证清单） |
|
||||
| 美术素材 | 本条目要出的图：`artwork/` 在途样张与 `game/assets/art/` 终稿 |
|
||||
| 游戏代码 | `game/` 全部：脚本与场景、`data/tables/*.tres` 数值表、`tests/`、`probe/`、`sim/`——表值直接改变游戏运行结果，归本档 |
|
||||
| 工具代码 | `tools/` 与仓库根 python 脚本（含各验证闸件）＋流水线技能件 `.zcode/skills/`、`.qoder/skills/`（技能改的是流水线行为，与闸件同类） |
|
||||
|
||||
只写本条目自己交付的产出面，不预写下游实现批要动的面。`reports/` 下的需求卡片与批次产出物属过程件（第 11 节管辖），不计入 `文档` 档。四档与 AGENTS.md 硬红线的「改动四类」对应关系：`游戏代码`＝需求改动（走写卡与编排段）、`工具代码`／`文档`／`美术素材` 三档各自对应工程改动／文档设计改动／美术素材改动三类直改通道；一条条目可以同时含多档。
|
||||
|
||||
状态段用词自带所属设计线——`待文档设计`／`文档设计中`／`文档设计已闭合` 是文档线，`待美术设计`／`美术设计中`／`美术设计已闭合` 是美术线，不需要在标题另行声明走哪条线。状态一律取下例用词。状态行按**状态段累积制**书写：条目每推进一段，就把新状态段接在状态行末尾，段与段用＋号连接，书写顺序=推进顺序；跨线的段一律保留、禁删（同一设计线内只留最新一段），下游段一旦写下不回收——状态履历供编排四查与开工核验比对。每段各自按状态词白名单校验，＋号只作状态段连接符。
|
||||
|
||||
```
|
||||
各设计线推进序列（同条目两条线并列推进时，两段各写各的）：
|
||||
文档线：待文档设计 → 文档设计中 → 文档设计已闭合
|
||||
美术线：待美术设计 → 美术设计中 → 美术设计已闭合
|
||||
下游共用序列（需求改动）：待写卡 → 已写卡 → 已编迭代 N → 完成即整条删除
|
||||
直改序列（工程改动／文档设计改动／美术素材改动）：登记 → 待执行 → 完成即整条删除（经设计讨论的可前置闭合段，如「文档设计已闭合＋待执行」）
|
||||
累积示例：文档设计已闭合＋待美术设计＋已写卡
|
||||
```
|
||||
|
||||
设计线段与下游段同条并存是合法形态：状态行里出现过的**每条设计线各自留最新一段**，跨线依赖不阻塞本条推进（文档线闭合后写卡、美术线仍未出图，就把 `文档设计已闭合` 与 `待美术设计` 并写）。「写卡前本条要落的那条设计线必须已闭合」是实现侧的执行义务，由编排段查卡片凭据核对，不靠标题声明——闸只查同线并现多段。
|
||||
|
||||
状态行只写状态词：去掉特批标记与「（备选）」后缀后，残留任何括号即违规。闭合类状态词（文档设计已闭合／美术设计已闭合／已写卡／已写入）的证据——设计定稿路径+版本、art-bible 条款版本、需求卡片路径、落点文档+版本——一律写在实况的关联文档清单里，由流水线闸到正文核对；已编迭代 N 段的交叉核依据＝实况清单里的需求卡片路径。
|
||||
|
||||
三种条目形态与一种后缀：
|
||||
|
||||
| 形态 | 规则 |
|
||||
|---|---|
|
||||
| 需求性工程条目（需求改动） | 缺陷修复／重构等改游戏行为的条目：状态首段直接落「待写卡」、整行不含设计段，凭实况里指认的证据跳过设计线；改动面必含 `游戏代码` |
|
||||
| 直改类条目（工程改动／文档设计改动／美术素材改动） | 不动游戏行为的配套改动：登记即「待执行」，用户发令直改，不走写卡与编排段；改动面取 `工具代码`／`文档`／`美术素材` 三档 |
|
||||
| 反哺点专条 | 状态取 待裁决 → 已写入 → 删除，不走设计线也不走下游序列 |
|
||||
| 备选库条目 | 暂不排期、留在备选库的条目：状态词后缀「（备选）」 |
|
||||
|
||||
特批标记见 12.4。
|
||||
|
||||
@@ -16,14 +16,14 @@
|
||||
|
||||
## 2. 五段流水线
|
||||
|
||||
**需求改动**（游戏代码，含随逻辑写/改的测试）按五段流水线走：**登记 → 文档设计／美术设计（双轨）→ 写需求卡片 → 迭代编排 → 实现**；工程／文档设计／美术素材三类改动不走写卡与编排段，走「登记 →（如需设计讨论）→ 用户发令直改 → 按改动域跑闸 → 完成删条目」。两层口径（2026-10-25 用户立）：需求卡片＝需求单位的实施文档，任何工作量皆可写、皆可编入迭代；工作量限制只属迭代层——迭代估时总量 <5 个工作日＝「冻结待凑批」，不可开工。段间不自动流转，每段转进由用户发令；每段一个技能入口（五者均装于项目 `.zcode/skills/`：doc-design／asset-ingest／req-card／iter-plan／iter），登记不立技能（条目格式由流水线闸强制）。设计工作在会话内进行、用户主导、禁无监管自跑。
|
||||
**需求改动**（游戏代码，含随逻辑写/改的测试）按五段流水线走：**登记 → 文档设计／美术设计（两条设计线）→ 写需求卡片 → 迭代编排 → 实现**；工程／文档设计／美术素材三类改动不走写卡与编排段，走「登记 →（如需设计讨论）→ 用户发令直改 → 按改动域跑闸 → 完成删条目」。两层口径（2026-10-25 用户立）：需求卡片＝需求单位的实施文档，任何工作量皆可写、皆可编入迭代；工作量限制只属迭代层——迭代估时总量 <5 个工作日＝「冻结待凑批」，不可开工。段间不自动流转，每段转进由用户发令；每段一个技能入口（五者均装于项目 `.zcode/skills/`：doc-design／asset-ingest／req-card／iter-plan／iter），登记不立技能（条目格式由流水线闸强制）。设计工作在会话内进行、用户主导、禁无监管自跑。
|
||||
|
||||
| 段 | 入口技能 | 产出 | 出入口铁律 |
|
||||
|---|---|---|---|
|
||||
| 一·登记 | 无（闸管格式） | 待办清单条目 | 条目=标题登记元数据＋正文四属性（现状/缺口/归属/状态）；标题登记后不再变，正文随进程演进。格式与状态机权威=doc-conventions 第 12 节 |
|
||||
| 二·文档设计／美术设计 | doc-design（文档轨，兼任反哺点写入）／asset-ingest（美术录入；样张素材由用户主导产出） | GDD 文档或 art-bible／过审样张素材 | 用户提起或从待办清单取出；会话内进行、用户主导、禁无监管自跑；经用户点头确认心智一致才许写入文档；完成判据=待裁点清零，带未裁点的是讨论稿；轨闭合凭据记入待办清单现状清单（文档轨=文档路径+版本号，美术轨=art-bible 条款版本） |
|
||||
| 三·写需求卡片 | req-card | 需求卡片 | 轨闭合后用户发令；新玩法/新系统/新内容必须有设计定稿前置，例外=工程直入中改游戏行为的条目（缺陷修复／重构）凭证据跳过设计轨；工程直入中的配套维护条目（工程债/测试基建/工具维护，不动游戏行为）＝工程改动，不走本段，登记后「待执行」直改；卡片必经 grilling 多轮复核、零待裁点才成立；写完在待办清单状态记「已写卡」，卡片路径记入现状清单（防遗忘） |
|
||||
| 四·迭代编排 | iter-plan | roadmap 迭代行 | 编排四查：①每卡卡片文件存在 ②每卡设计闭合凭据齐（或工程直入证据）③估时与冻结线——所选卡估时按区间**中值**求和（单位工作日、写精确值不取整）：**卡片任何工作量均可编入**（2026-10-25 用户立：工作量限制属迭代层、非卡片层）；编入后迭代总量 <5 个工作日＝迭代行状态「冻结待凑批」、不可开工，凑批 ≥5 后由编排段改「待开工」（迭代体量偏好，2026-10-21 用户立、2026-10-25 改冻结制）；5–10 个工作日为常规区间；超过 10 个工作日须经用户确认（确认前呈报整批/拆批两案等裁，禁自行拆分或塞入），确认后迭代行随带日期特批标记；超过 20 个工作日禁止编（硬上限，用户确认也不放行，必须拆批）④写完 roadmap 行后跑流水线闸确认绿；编入未完成迭代，新开迭代行经用户确认 |
|
||||
| 一·登记 | 无（闸管格式） | 待办清单条目 | 条目=标题登记元数据（日期/来源/可选优先级）＋正文四属性（实况/缺口/改动面/状态）；标题登记后不再变，正文随进程演进。格式与状态机权威=doc-conventions 第 12 节 |
|
||||
| 二·文档设计／美术设计 | doc-design（文档线，兼任反哺点写入）／asset-ingest（美术录入；样张素材由用户主导产出） | GDD 文档或 art-bible／过审样张素材 | 用户提起或从待办清单取出；会话内进行、用户主导、禁无监管自跑；经用户点头确认心智一致才许写入文档；完成判据=待裁点清零，带未裁点的是讨论稿；设计线闭合凭据记入待办清单实况清单（文档线=文档路径+版本号，美术线=art-bible 条款版本）；缺哪条线写在缺口属性，闭合与否写在状态段 |
|
||||
| 三·写需求卡片 | req-card | 需求卡片 | 设计线闭合后用户发令；新玩法/新系统/新内容必须有设计定稿前置，例外=需求性工程条目（缺陷修复／重构等改游戏行为）凭实况里的证据指认跳过设计线；配套维护类（工程债/测试基建/工具维护，不动游戏行为）＝工程改动直改类，不走本段，登记后「待执行」由用户发令直改；卡片必经 grilling 多轮复核、零待裁点才成立；写完在待办清单状态记「已写卡」，卡片路径记入实况清单（防遗忘） |
|
||||
| 四·迭代编排 | iter-plan | roadmap 迭代行 | 编排四查：①每卡卡片文件存在 ②每卡设计闭合凭据齐（或需求性工程条目的证据指认）③估时与冻结线——所选卡估时按区间**中值**求和（单位工作日、写精确值不取整）：**卡片任何工作量均可编入**（2026-10-25 用户立：工作量限制属迭代层、非卡片层）；编入后迭代总量 <5 个工作日＝迭代行状态「冻结待凑批」、不可开工，凑批 ≥5 后由编排段改「待开工」（迭代体量偏好，2026-10-21 用户立、2026-10-25 改冻结制）；5–10 个工作日为常规区间；超过 10 个工作日须经用户确认（确认前呈报整批/拆批两案等裁，禁自行拆分或塞入），确认后迭代行随带日期特批标记；超过 20 个工作日禁止编（硬上限，用户确认也不放行，必须拆批）④写完 roadmap 行后跑流水线闸确认绿；编入未完成迭代，新开迭代行经用户确认 |
|
||||
| 五·实现 | iter | 代码与配置，可运行的游戏 | 需求卡片永不单独施工，统一由用户指定迭代号触发（=U0 开工令），按 iter 技能与本文 §3 执行；**本段是代码实现批：禁写 `design/` 与根规则文件，产出物只落 `reports/`（见 §3 第 12 条）**；设计权威文档（GDD/art-bible）批内一律不更新；完成人闸=实机目检清单+代拍板追认单登记交用户即完成批内义务 |
|
||||
|
||||
**实现段零裁断**：实现段的输入在编排段出口已锁死（卡片零待裁点＋设计闭合凭据齐＋编排四查过）。实现中冒出卡片没写清的分歧=上游缺陷——停该卡、待办清单状态回退＋缺口补记，退回上游；禁自答、禁内联提问求裁断；该卡停摆不阻塞同迭代其他卡。环境故障与测试红走异常分级（自救重试／记录继续／停机呈报）。代拍板白名单保留：授权发生在卡片审问阶段，实现只执行预授权；批后追认单=备案确认。
|
||||
|
||||
@@ -13,4 +13,4 @@ rows = [
|
||||
|
||||
; 节点图源已换代为参数化生成器（关卡节点图生成 v1.1）——本表逐关行只承载关卡序号/显示名/恢复比例，
|
||||
; 不再携带节点数据；图 = f(参数档, 种子)，参数档见 level_gen_params.tres 三行（消费侧按 level_index 解析后交 generate）。
|
||||
; 旧 15 张模板池（3 关 × 5）随迭代 35 卡② 清出，历史查 git 提交史与 tools/t5_build_templates.py、t17_fanout2_rebuild.py 留档。
|
||||
; 旧 15 张模板池（3 关 × 5）已清出，历史查 git 提交史与 tools/t5_build_templates.py、t17_fanout2_rebuild.py 留档。
|
||||
+4
-4
@@ -1,4 +1,4 @@
|
||||
# tests/integration/node_map_templates_test.gd — L2 集成用例：关卡节点图生成·确定性承载
|
||||
# tests/integration/node_map_determinism_test.gd — L2 集成用例：关卡节点图生成·确定性承载
|
||||
# 断言面 = 生成图确定性套（批 B 断言迁移自 smoke_all.gd，G12 施工组；
|
||||
# 主会话裁决六整套集成不拆——跨四系统且走落盘）。
|
||||
# 跨系统面 = RngService（纯派生流零计数器占用）×
|
||||
@@ -7,7 +7,7 @@
|
||||
# SaveManager＋MetaProgression（首次冒险布尔位收束置位落盘——真实档写盘）。
|
||||
# 与单元侧同入口同协议：extends SceneTree＋Kit.check 主通道；--script 模式无 autoload，
|
||||
# ConfigDB 显式实例化构造注入；表加载失败不中止（沿被迁断言面的源语义——诊断展开，红由具体断言落）。
|
||||
# 运行：godot --headless --path game --script res://tests/integration/node_map_templates_test.gd
|
||||
# 运行：godot --headless --path game --script res://tests/integration/node_map_determinism_test.gd
|
||||
extends SceneTree
|
||||
|
||||
const Kit := preload("res://tests/unit/test_kit.gd")
|
||||
@@ -23,12 +23,12 @@ func _init() -> void:
|
||||
# 表加载失败不中止（承 G2/G3/G4/G5 同款：表损坏的红落在具体断言上）
|
||||
var load_ok: bool = _db.load_tables("res://data/tables", true)
|
||||
if not load_ok:
|
||||
push_error("[node_map_templates_test] 表加载返回失败——诊断如下（红由具体断言落）")
|
||||
push_error("[node_map_determinism_test] 表加载返回失败——诊断如下（红由具体断言落）")
|
||||
for d in _db.diagnostics():
|
||||
if d.severity == "error" or d.severity == "fatal":
|
||||
push_error(" [%s] %s: %s" % [d.severity, d.category, d.message])
|
||||
_smoke_generated_map_determinism()
|
||||
quit(Kit.finish("node_map_templates_test"))
|
||||
quit(Kit.finish("node_map_determinism_test"))
|
||||
|
||||
|
||||
# ---- 关卡节点图生成·确定性承载断言面 ----
|
||||
File renamed without changes.
@@ -87,7 +87,7 @@ func _suites() -> Array:
|
||||
{"path": "res://tests/unit/presentation/modal_flow_test.gd", "expect": 0}, # 模态编排纯逻辑（V6：直接 new/互斥域谓词/三例外锁/演播后排窗）
|
||||
# ---- L2 集成层（跨系统用例，与 unit/ 的隔离断言面分工）----
|
||||
{"path": "res://tests/integration/save_rng_roundtrip_test.gd", "expect": 0}, # 存档⇄RNG 快照往返（SaveManager 迁移链 × 断点消费 × RNG 续跑 × 停点态确定性）
|
||||
{"path": "res://tests/integration/node_map_templates_test.gd", "expect": 0}, # 关卡节点图生成·确定性承载（生成图复现×首冒险置位落盘——批 B 自 smoke_all 迁入，裁决六整套集成不拆）
|
||||
{"path": "res://tests/integration/node_map_determinism_test.gd", "expect": 0}, # 关卡节点图生成·确定性承载（生成图复现×首冒险置位落盘——批 B 自 smoke_all 迁入，裁决六整套集成不拆）
|
||||
{"path": "res://tests/integration/cross_system_flow_test.gd", "expect": 0}, # 跨系统真实流×落盘（RNG 事件日志落盘/专长断点往返/存档摘要集成/试玩记录仪真实结算流——批 B 转办块宿主，裁决一/二/三/七）
|
||||
# ---- core 四件与呈现层两件的直接单测 ----
|
||||
{"path": "res://tests/unit/core/board_generator_test.gd", "expect": 0}, # 棋盘生成（尺寸合表/数字＝八邻雷数/同种子逐位一致/可推理自洽）
|
||||
|
||||
@@ -33,7 +33,7 @@ func _test_pool_damage() -> void:
|
||||
var d := _floor_val() + 9 # 表值推导的任意正探针量（非玩法行值）
|
||||
Kit.check("中性双池 (0,0) 原样透传", DamageMathScript.pool_damage(d, 0, 0) == d)
|
||||
Kit.check("负敌方池压低不增高", DamageMathScript.pool_damage(d, 0, int(db.settlement.pool_clamp_lo)) <= d)
|
||||
Kit.check("正主角池抬升不低于原值", DamageMathScript.pool_damage(d, int(db.settlement.pool_clamp_hi), 0) >= d)
|
||||
Kit.check("正·主角池抬升不低于原值", DamageMathScript.pool_damage(d, int(db.settlement.pool_clamp_hi), 0) >= d)
|
||||
Kit.check("主角池单调不减（+50% vs +49% 探针档）", DamageMathScript.pool_damage(d, 50, 0) >= DamageMathScript.pool_damage(d, 49, 0))
|
||||
Kit.check("对称性：池值互换结果不变（乘算交换）", DamageMathScript.pool_damage(d, 30, -20) == DamageMathScript.pool_damage(d, -20, 30))
|
||||
Kit.check("输出非负（maxi(0,·) 封底）", DamageMathScript.pool_damage(d, int(db.settlement.pool_clamp_lo), int(db.settlement.pool_clamp_lo)) >= 0)
|
||||
|
||||
+2455
-1352
File diff suppressed because it is too large.
Load diff
@@ -0,0 +1,147 @@
|
||||
# 提案：营地色彩与氛围脚本（2026-10-23）
|
||||
|
||||
> **性质**：设计讨论段过程稿。**只确立「营地该长什么样、什么风格、什么感觉」，不出图、不改 `art-bible` 主色板。**
|
||||
> 上游依据：`art-bible` §2.8（营地情绪）、§4.1 色板分层与对比硬指标、§4.2 适用域条款、§6.1 战斗背景后退条款、§6.2 营地场景、§8 定值单点纪律；外部调研见 §4。
|
||||
> 下游：本脚本是 §13 生图提示词的色彩依据；色值候选在此**单点**提出，待作者追认后按 §4.1「场景环境子板」条款登记（环境子板每屏一套、≤32 色、允许跨屏不共享、不占 48 token 额度）。
|
||||
|
||||
---
|
||||
|
||||
## 0. 四问速览（只读这一段也能定）
|
||||
|
||||
| 问 | 答 |
|
||||
|---|---|
|
||||
| **① 现状差在哪** | 营地整屏发黄发闷。实测：天空黄度 51、地面黄度 81（黄度 =(R+G)/2−B，越大越黄）。**占屏约七成的大面积——天空、远山、地面——全是暖色**，找不到一块冷色来平衡。 |
|
||||
| **② 建议做什么** | 给营地补一张**环境子板**，按「**冷的大面积后退、暖的小面积前进**」重新分工：天与山与地走冷灰，暖色只留给物件（火、木、石），火焰是唯一高饱和。 |
|
||||
| **③ 为什么选它** | 这是空气透视的通行做法（远处更淡、更冷、对比更弱，近处更暗、更暖、对比更强），且 `art-bible` §4.2 已写明**环境层不受色相独占约束**——远山走冷色完全合规，不需要动任何暖色条款。 |
|
||||
| **④ 怎么验证** | 出图后按 §2.5 的面积占比与黄度阈值实量：天空黄度 ≤20、地面黄度 ≤35；暖色面积 ≤30%。这两条可机检，不靠眼估。 |
|
||||
|
||||
---
|
||||
|
||||
## 1. 诊断：黄不是设计意图，是三个缺口叠加
|
||||
|
||||
### 1.1 事实（出图实测，非推测）
|
||||
|
||||
| 版本 | 天空 RGB | 天空黄度 | 地面 RGB | 地面黄度 |
|
||||
|---|---|---|---|---|
|
||||
| 首版方向稿 | (249, 229, 188) 奶黄 | 51 | (157, 119, 57) 暖褐 | 81 |
|
||||
| 修正天空后 | (217, 221, 202) 灰白 | 17 | (146, 128, 97) 仍偏褐 | 40 |
|
||||
|
||||
天空改冷后黄度掉到 17，画面立刻不那么"尿黄"——**说明元凶是大面积的色温，不是物件本身**。地面只降到 40，因为当时提示词里还挂着棋盘色 `裸土 #B39A78`。
|
||||
|
||||
### 1.2 三个缺口
|
||||
|
||||
**缺口一：营地没有自己的环境子板，大面积色是借来的。**
|
||||
`art-bible` §4.1 主色板里能撑大面积的暖色只有两个——`掩尘 #C9AF83`、`裸土 #B39A78`。但这两色的语义是**棋盘格底**（未开格／已开格），营地场景直接拿来当地面和石头用，等于把棋盘色板铺满了占屏七成的面积。§4.1 那组硬指标（L≥0.30、饱和 ≤0.55）是**棋盘数字可读性**指标，搬到场景大面积上只剩弱约束，管不住色相。
|
||||
|
||||
**缺口二：「全作最暖」被泛化到了不该暖的地方。**
|
||||
§6.2 写的是「承载 §2.8——全作最暖：烛光黄 `#F6C667` × 木色 `#8A5A34`」。这两个色的本体是**火焰与木构**，是"人留下的东西"。它被理解成了"整屏都要暖"，于是天空、远山、地面全部跟着暖。
|
||||
|
||||
**缺口三：两条构图口径把仅有的冷色来源拿掉了。**
|
||||
作者口径「近景不要草」删掉了暖调场景里**唯一的天然冷色平衡源（绿植）**；「不要远景地面／地平线」又删掉了山脚那片本可以做成冷灰绿的地带。剩下来的大面积只剩天、山、地——三者全暖，必然发黄。
|
||||
|
||||
### 1.3 与美术圣经核对：没有任何条款要求营地大面积是暖的
|
||||
|
||||
| 条款 | 原文要点 | 对本议题的含义 |
|
||||
|---|---|---|
|
||||
| §4.2 适用域 | **纯环境氛围（背景／装饰／远景／非语义物件）不受色相独占约束**，只受 §3.4 焦点预算与低饱和后退约束 | 远山、天空走冷色**完全合规**，不被任何语义色独占条款拦 |
|
||||
| §6.1 战斗背景 | 背景整体**低对比自然后退**，禁止抢焦点 | 营地远景可沿用同款"后退"逻辑，冷灰正是后退手段 |
|
||||
| §4.1 色板分层（2026-10-22 作者裁） | 场景环境子板：**每屏一套、≤32 色、允许跨屏不共享**；新增环境色须过 §4.2 语义检查 + 与既有任一色 RGB 三通道差 ≥8/255 | 营地可以**单独拥有一套环境色**，不必挤占棋盘主色板，也不占 48 token 额度 |
|
||||
| §2 明度分层（2026-09-29 v3.0） | 空间纵深走明度分层允许域（光照氛围／色相饱和／形体承载），非情绪压暗 | 空气透视的"远景趋近天空明度、对比变弱"与既有明度分层同族，不冲突 |
|
||||
|
||||
**结论**：要改的不是美术圣经的暖色条款，而是**补一张营地环境子板**，并把"全作最暖"收回它本来的位置——暖的是物件，不是整屏。
|
||||
|
||||
---
|
||||
|
||||
## 2. 修正后的定位：营地应该长什么样
|
||||
|
||||
### 2.1 一句话氛围定位
|
||||
|
||||
> **白天、干爽、有风的开阔营地。暖的是「人留下的东西」（火、木头、皮革、石头），冷的是「野外的东西」（天、远山、地面）。玩家第一眼看到的是篝火和物件，天与山只是安静地退在后面。**
|
||||
|
||||
### 2.2 三个感觉词（写提示词与验收都照这三条判）
|
||||
|
||||
| 感觉词 | 落到画面上是什么 | 反例（出现即判红） |
|
||||
|---|---|---|
|
||||
| **干爽** | 降饱和、无湿气；地面是干实土不是泥泞 | 整屏油润、饱和过高、像黄昏金光 |
|
||||
| **安稳** | 暖色集中在篝火与木构上，是"人味"，不是整屏染色 | 天空、远山也发暖 → 变成"整屏黄疸" |
|
||||
| **空旷** | 远景只有天与山，无地平线、无杂物、无树 | 远景长出树、屋、地平线 |
|
||||
|
||||
### 2.3 冷暖分工（核心规则，一句话记住）
|
||||
|
||||
**冷＝大面积＝后退；暖＝小面积＝前进。**
|
||||
|
||||
- 冷（后退层）：天空、远山、地面 —— 冷灰白／冷灰蓝／中性灰褐，低饱和
|
||||
- 暖（前进层）：火焰、木构、石头、绳垫、毯子 —— 只在这一层出现暖色
|
||||
- **唯一高饱和＝篝火火焰**（§3.4 焦点预算：首焦唯一，其余全部让位）
|
||||
|
||||
### 2.4 空气透视三档（远近各层怎么拉开）
|
||||
|
||||
**空气透视**＝空气隔在中间，越远的东西看起来越淡、越冷、对比越弱、细节越少；近处相反，更暗、更暖、对比更强、细节更多。
|
||||
|
||||
| 层 | 明度 | 色温 | 饱和 | 对比 | 细节 |
|
||||
|---|---|---|---|---|---|
|
||||
| **远**（天空／远山） | 最亮，趋近天空 | **冷** | 最低 | 最弱 | 只剩剪影，无单体树 |
|
||||
| **中**（木围墙／门／布告板） | 中 | 中性偏冷（木色压灰） | 低 | 弱 | 简化，无个体木纹 |
|
||||
| **近**（地面／七件） | **最暗** | **暖（仅此层）** | 中（火焰为唯一高饱和） | 最强 | 完整、清晰、可读 |
|
||||
|
||||
> 注：本表的明度关系是**营地环境子板内部**的纵深关系，与棋盘的世界底／中层档互不干扰（环境子板允许跨屏不共享）。
|
||||
|
||||
### 2.5 面积占比（把"别太黄"变成可机检的数）
|
||||
|
||||
| 色温区 | 建议占比 | 判据 |
|
||||
|---|---|---|
|
||||
| 冷色面积（天＋山＋地） | **≥ 55%** | 低于则整屏偏暖 |
|
||||
| 暖色面积（物件与木构） | **≤ 30%** | 高于则"黄疸" |
|
||||
| 火焰高饱和 | **≤ 3%** | 高于则抢焦（违反 §3.4 焦点预算） |
|
||||
|
||||
配套黄度阈值（出图后实量）：**天空黄度 ≤20、地面黄度 ≤35**。
|
||||
|
||||
### 2.6 色值候选方向（待作者定，§4.1 是数值单点事实源）
|
||||
|
||||
只给方向不给死值——定色值须由作者拍板，且新色要过两道门（§4.2 语义检查 + 与既有任一色 RGB 三通道差 ≥8/255）：
|
||||
|
||||
| 大面积 | 方向 |
|
||||
|---|---|
|
||||
| 天空 | 冷灰白、微带蓝灰，全画明度最高 |
|
||||
| 远山 | 冷灰蓝，越远越淡越冷（空气透视），趋近天空明度 |
|
||||
| 地面 | 中性灰褐，降饱和，全画明度最低，**绝不带金黄／琥珀** |
|
||||
| 木构（中景围墙） | 木色 `#8A5A34` 压一档饱和走中性偏冷——它是中景，必须后退 |
|
||||
| 物件（近景） | 木色 `#8A5A34`、掩尘 `#C9AF83` 保持本色；火焰烛光黄 `#F6C667` 为唯一高饱和 |
|
||||
|
||||
---
|
||||
|
||||
## 3. 与美术圣经的关系：哪些不动、哪些要新建
|
||||
|
||||
| 项 | 处理 | 理由 |
|
||||
|---|---|---|
|
||||
| §6.2「全作最暖：烛光黄 × 木色」 | **不动**，但收回适用范围＝**物件层**，不含天空／远山／地面 | 两色本体是火与木，泛化到整屏是把"物件色"当成了"环境色" |
|
||||
| §4.1 主色板（掩尘／裸土等） | **不动**；营地地面**停止挪用** `裸土 #B39A78` | 那是棋盘格底色，语义不同域 |
|
||||
| §4.2 适用域条款 | **不动**，本脚本正是依据它给环境层定冷色 | 环境层本就不受色相独占约束 |
|
||||
| 营地环境子板 | **新建**（本脚本 §2.6 为候选） | §4.1 色板分层条款已开通道：每屏一套、≤32 色、不占 48 额度 |
|
||||
| §4.1 硬指标（L≥0.30、饱和 ≤0.55） | **不动**，仅说明它是棋盘可读性指标、不搬到场景大面积 | 避免把格底指标误当场景指标 |
|
||||
|
||||
---
|
||||
|
||||
## 4. 外部调研依据
|
||||
|
||||
### 4.1 三条通行原则（多来源一致）
|
||||
|
||||
1. **空气透视**：越远越亮（趋近天空明度）、越冷（偏蓝）、对比越弱、细节越少；近处相反——暗、暖、高对比、有细节。（来源：Fiveable《Atmospheric perspective》、ArtExamples《Atmospheric Perspective》、科普中国「空气透视」条目——后者原文："近处色彩偏暖，远处色彩偏冷""最远处冷暖不分而形成为一片蓝灰色"）
|
||||
2. **冷暖分工**：暖色前进、冷色后退。像素画环境里"背景多走冷、前景多走暖，以此拉开纵深"。（来源：PixelPaletteSwap《Color Theory for Pixel Art》；Peace on Paper《Warm vs Cool Tricks》技巧一"暖前景、冷背景"）
|
||||
3. **饱和即焦点**：高饱和只留给焦点，大面积必须降饱和。（来源：Pixel-Editor《Color Theory for Pixel Art》"Keep saturated colors sparse"）
|
||||
|
||||
### 4.2 同类游戏参照
|
||||
|
||||
**暖而不脏**的 cozy 像素阵营：Stardew Valley、Moonlighter、Eastward、Forager、Littlewood、Spirittea、Potion Permit（来源：The Cozy Gaming Nook 两次 cozy 像素专题）。
|
||||
|
||||
**其中 Stardew Valley 最值得对照**：它同样是"暖乡土"调子，靠**大面积绿色植被**做冷色平衡（来源：ImageToPixel 的分析——Stardew 走"golden hour"暖调、无抖动、细描边，但画面里绿植占比极大）。
|
||||
|
||||
**对本项目的直接推论**：营地按作者口径**禁草**、**禁远景地面**，等于把 Stardew 赖以平衡的绿植整块拿掉。所以冷色平衡只能由**天空与远山**承担——这两块必须明确走冷，否则整屏无解。
|
||||
|
||||
---
|
||||
|
||||
## 5. 待裁（由作者定，不擅自动）
|
||||
|
||||
1. **营地环境子板色值**（§2.6 仅给方向）——定色值属 `art-bible` §4.1 的活，且新色须过 §4.2 语义检查 + RGB 三通道差 ≥8/255 两道门。
|
||||
2. **面积占比与黄度阈值**（§2.5）——是否作为营地场景图的机检判据写进验收表。
|
||||
3. **木围墙的色温**——中景走"中性偏冷"要比物件木色压一档饱和，是否与 §6.2「木色 `#8A5A34`」的物件用法冲突（我的判断：不冲突，压饱和不是换色，但需作者确认）。
|
||||
+57
-18
@@ -40,6 +40,7 @@ import bisect
|
||||
import re
|
||||
import subprocess
|
||||
import sys
|
||||
from datetime import date
|
||||
from pathlib import Path
|
||||
|
||||
ROOT = Path(__file__).resolve().parent.parent
|
||||
@@ -326,24 +327,27 @@ def base_commit():
|
||||
return "<git 不可用，未取得基点 commit>"
|
||||
|
||||
|
||||
def render_list(entries, funcs_by_src, src_names) -> str:
|
||||
"""生成验证集清单骨架。白话释义/处置两列留待回填（回填不动冻结列）。
|
||||
多源按（源文件, 函数）分章——跨文件同名函数不并章；章头行号＝该源文件内行号。"""
|
||||
def render_list(entries, funcs_by_src, src_names, carry=None) -> str:
|
||||
"""生成验证集清单。冻结列＝机器提取；「白话释义/处置」两列：承接命中行用旧清单回填，
|
||||
其余落（待填）由维护回填（回填不动冻结列）。多源按（源文件, 函数）分章——跨文件同名
|
||||
函数不并章；章头行号＝该源文件内行号。头注全部由当次数据生成，禁批次专名与写死计数。"""
|
||||
carry = carry or {}
|
||||
out = []
|
||||
out.append("# 验证集清单（迁移参照物·冻结）")
|
||||
out.append("# 验证集清单（断言快照·冻结）")
|
||||
out.append("")
|
||||
out.append("> 生成日期：2026-10-22 · 基点 commit：`%s` · 源：%s" % (base_commit(), "、".join(src_names)))
|
||||
out.append("> 提取口径：静态 `check(` 调用点，括号配平归集（可跨行）。批 B 基点实测 smoke_all.gd 调用点 1065 处；")
|
||||
out.append("> 行级 `grep -c \"check(\"` = 1067 是另一口径——多出的 2 行为 `func check(` 定义行与")
|
||||
out.append("> 一处注释行（「禁恒真 check(true)」），非调用点。运行时计数大于静态计数＝循环展开条目，")
|
||||
out.append("> 两口径各自浮动，禁互相换算（tests/README「断言计数双口径」）。")
|
||||
out.append("> 生成命令：`python tools/extract_checks.py --extract`（可复现；重新生成须 --force）。")
|
||||
out.append("> 生成日期：%s · 基点 commit：`%s` · 源：%s" % (date.today().isoformat(), base_commit(), "、".join(src_names)))
|
||||
out.append("> 提取口径：静态 `check(` 调用点，括号配平归集（可跨行）；缺省源＝三宿主遍历")
|
||||
out.append("> （unit/**＋integration/**＋system_test.gd）。本基点实测 %d 个静态调用点；行级" % len(entries))
|
||||
out.append("> `grep -c \"check(\"` 是另一口径（含 `func check(` 定义行与注释行），两口径各自浮动，")
|
||||
out.append("> 禁互相换算（tests/README「断言计数双口径」）。运行时计数大于静态计数＝循环展开条目。")
|
||||
out.append("> 生成命令：`python tools/extract_checks.py --extract`（可复现；重新生成须 --force；")
|
||||
out.append("> 承接旧清单回填列须 --carry-from <旧清单>）。")
|
||||
out.append("> 冻结纪律：每条的「标签原文」「cond 摘要」「quiet」三列为机器提取逐字保真，禁任何改写；")
|
||||
out.append("> cond 摘要＝原文跨行折叠单行（连续空白并一空格），单元格内 `|`→`\\|`、`\\`→`\\\\` 转义，读回还原。")
|
||||
out.append("> 「白话释义」「处置」两列由维护回填，不属冻结面。")
|
||||
out.append("> 出口对账：`python tools/extract_checks.py --diff game/tests/验证集清单.md --src <宿主文件>...`")
|
||||
out.append("> ——标签／cond／计数三对齐才算迁移完（合同 §五出口机检）。")
|
||||
out.append("> 维护义务：此后断言新增/删除/改判必须同步本清单（test-conventions §9.3 锚）。")
|
||||
out.append("> 「白话释义」「处置」两列由维护回填（未承接行为（待填）），不属冻结面。")
|
||||
out.append("> 对账：`python tools/extract_checks.py --diff game/tests/验证集清单.md`（缺省三宿主源）")
|
||||
out.append("> ——标签／cond／计数三对齐才算同步完。维护义务：断言新增/删除/改判必须同步本清单")
|
||||
out.append("> （test-conventions §8.3 维护锚）。")
|
||||
out.append("")
|
||||
seq = 0
|
||||
by_gf = []
|
||||
@@ -361,8 +365,12 @@ def render_list(entries, funcs_by_src, src_names) -> str:
|
||||
out.append("|---|---|---|---|---|---|---|")
|
||||
for e in es:
|
||||
seq += 1
|
||||
out.append("| %d | %d | %s | %s | （待填） | | %s |" % (
|
||||
seq, e["line"], esc_cell(label_cell(e)), esc_cell(fold(e["cond"])), esc_cell(fold(e["quiet"]))))
|
||||
hit = carry.get((fold(e["cond"]), e["label_literal"], fold(e["label_suffix"])))
|
||||
disp = esc_cell(hit[0]) if hit else "（待填）"
|
||||
act = esc_cell(hit[1]) if hit else ""
|
||||
out.append("| %d | %d | %s | %s | %s | %s | %s |" % (
|
||||
seq, e["line"], esc_cell(label_cell(e)), esc_cell(fold(e["cond"])), disp, act,
|
||||
esc_cell(fold(e["quiet"]))))
|
||||
out.append("")
|
||||
out.append("---")
|
||||
out.append("全源共 %d 章、%d 条（静态调用点口径）。" % (len(by_gf), seq))
|
||||
@@ -389,6 +397,8 @@ def parse_list(path: Path):
|
||||
label_raw = unesc_cell(cells[2])
|
||||
cond = unesc_cell(cells[3])
|
||||
quiet = unesc_cell(cells[6])
|
||||
disp = unesc_cell(cells[4])
|
||||
action = unesc_cell(cells[5])
|
||||
lit_m = LITERAL_RE.match(label_raw)
|
||||
literal = lit_m.group(0) if lit_m else label_raw
|
||||
suffix = label_raw[lit_m.end():].strip() if lit_m else ""
|
||||
@@ -400,10 +410,25 @@ def parse_list(path: Path):
|
||||
"label_suffix": suffix,
|
||||
"cond": cond,
|
||||
"quiet": quiet,
|
||||
"disp": disp,
|
||||
"action": action,
|
||||
})
|
||||
return entries
|
||||
|
||||
|
||||
CARRY_RENAME = ("node_map_templates_test.gd", "node_map_determinism_test.gd")
|
||||
|
||||
|
||||
def carry_cells(frozen_rows):
|
||||
"""旧清单行 → 承接映射：指纹（与 entry_key 同构）→（白话释义, 处置）。
|
||||
承接文本内的旧宿主文件名一并映射为新名（唯一在册更名对象）。"""
|
||||
m = {}
|
||||
for r in frozen_rows:
|
||||
key = (fold(r["cond"]), r["label_literal"], fold(r["label_suffix"]))
|
||||
m[key] = (r.get("disp", "").replace(*CARRY_RENAME), r.get("action", "").replace(*CARRY_RENAME))
|
||||
return m
|
||||
|
||||
|
||||
def _short(s, n=80):
|
||||
s = s.replace("\n", " ")
|
||||
return s if len(s) <= n else s[:n] + "…"
|
||||
@@ -531,6 +556,8 @@ def main() -> int:
|
||||
help="断言源文件（可多个；缺省＝三宿主遍历 unit/**＋integration/**＋system_test.gd）")
|
||||
ap.add_argument("--out", default=str(DEFAULT_OUT), help="--extract 输出路径")
|
||||
ap.add_argument("--force", action="store_true", help="输出文件已存在时允许覆盖")
|
||||
ap.add_argument("--carry-from", default=None, metavar="旧清单",
|
||||
help="--extract 时按指纹承接旧清单「白话释义／处置」两列（旧宿主文件名映射为新名）")
|
||||
args = ap.parse_args()
|
||||
if sum(bool(x) for x in (args.extract, args.diff, args.list_funcs)) != 1:
|
||||
print("[extract_checks] 用法：--extract / --diff <清单文件> / --list-funcs 三选一")
|
||||
@@ -543,9 +570,21 @@ def main() -> int:
|
||||
if out.exists() and not args.force:
|
||||
print("[extract_checks] FAIL：清单已存在（%s）——冻结参照物防误覆，重生成须加 --force" % out)
|
||||
return 2
|
||||
carry = {}
|
||||
if args.carry_from:
|
||||
cf = Path(args.carry_from)
|
||||
if not cf.is_file():
|
||||
print("[extract_checks] FAIL：--carry-from 旧清单不可读：%s" % cf)
|
||||
return 2
|
||||
old_rows = parse_list(cf)
|
||||
carry = carry_cells(old_rows)
|
||||
print("[extract_checks] 旧清单 %d 行 → 承接指纹 %d 个" % (len(old_rows), len(carry)))
|
||||
entries, funcs_by_src = extract_all(src_paths)
|
||||
out.write_text(render_list(entries, funcs_by_src, [p.name for p in src_paths]), encoding="utf-8", newline="\n")
|
||||
print("[extract_checks] 已生成 %s（%d 个源文件、%d 个调用点）" % (out, len(src_paths), len(entries)))
|
||||
out.write_text(render_list(entries, funcs_by_src, [p.name for p in src_paths], carry), encoding="utf-8", newline="\n")
|
||||
hitn = sum(1 for e in entries
|
||||
if (fold(e["cond"]), e["label_literal"], fold(e["label_suffix"])) in carry)
|
||||
print("[extract_checks] 已生成 %s（%d 个源文件、%d 个调用点、承接回填 %d 行）"
|
||||
% (out, len(src_paths), len(entries), hitn))
|
||||
return 0
|
||||
if args.diff:
|
||||
lp = Path(args.diff)
|
||||
|
||||
+100
-83
@@ -2,14 +2,8 @@
|
||||
# -*- coding: utf-8 -*-
|
||||
r"""pipeline_gate.py — 工作流程流水线闸（待办清单条目状态机＋roadmap 迭代总表＋需求卡片口径＋一次交叉核）。
|
||||
|
||||
职责：机检待办清单条目（标题元数据/属性齐备/状态词白名单/条件凭据/状态段累积制在场约束/特批/
|
||||
零命中）与 roadmap 迭代总表（六列/状态五形态/卡片与报告存在性/编入时间与预计周期的
|
||||
历史行「—」豁免/周期校验（>20 判红、超 10 须带日期特批标记、<5 须处「冻结待凑批」态）/单元格白名单/零命中）；「已编迭代↔已写卡段↔迭代行
|
||||
卡片列」交叉核只此一处。2026-10-18 卡片冲突修订批补两条卡片机检：C1 关联文档同步面的
|
||||
文档义务口径（生效 2026-10-17）、C2 设计事实源声明（生效 2026-10-18）——两条都按文件名
|
||||
日期只追新规生效日之后的卡，旧卡属 git 历史留档不回头改。2026-10-21 验收闭合批补 C3：
|
||||
改动—验收对照表的结构检查（生效 2026-10-21）——只查节/列/行/必填格非空，不判断覆盖真假；
|
||||
覆盖真假由独立验收审计判。
|
||||
职责：机检待办清单条目（标题元数据与可选优先级档名/四属性齐备与旧属性名防回潮/状态词白名单/
|
||||
改动面四档白名单/条件凭据/无设计线段条目的证据指认/状态段累积制/特批/零命中）与 roadmap 迭代总表（六列/状态五形态/卡片与报告存在性/编入时间与预计周期的
|
||||
约束：每红项一行「文件:行号 判据名 一句白话说明」，exit 0=全绿 / 1=有红 / 2=输入件缺失；
|
||||
卡片与报告存在性相对 --repo-root 解析（缺省=本文件上两级）；待办清单与 roadmap 均已为新格式
|
||||
（2026-10-18 数据整改批），本闸已注册进 tools/run_all_gates.sh 文档域（08c 流水线闸）。
|
||||
@@ -24,7 +18,8 @@ DEFAULT_TODO = Path("待办清单.md")
|
||||
DEFAULT_ROADMAP = Path("roadmap.md")
|
||||
|
||||
SOURCE_WORDS = ("playnote", "会话提及", "审计发现", "批次移交")
|
||||
FACE_WORDS = ("文档轨", "美术轨", "双轨", "工程直入", "反哺点")
|
||||
PRIORITY_WORDS = ("P0", "P1", "P2")
|
||||
SURFACE_WORDS = ("文档", "美术素材", "游戏代码", "工具代码")
|
||||
STATUS_WORDS = (
|
||||
"待文档设计", "文档设计中", "文档设计已闭合",
|
||||
"待美术设计", "美术设计中", "美术设计已闭合",
|
||||
@@ -32,11 +27,14 @@ STATUS_WORDS = (
|
||||
)
|
||||
# 这些状态 = 设计未闭合，条目必须带「**缺口**」属性；其余状态不得带
|
||||
GAP_REQUIRED = ("待文档设计", "文档设计中", "待美术设计", "美术设计中")
|
||||
# 状态段累积制（doc-conventions §12.1）：下游段在场时的上游闭合段在场约束
|
||||
# 状态段累积制（doc-conventions §12.1）：下游段在场时禁残留未闭合设计段
|
||||
DOWNSTREAM_WORDS = ("待写卡", "已写卡", "已编迭代")
|
||||
PRESENCE_FACES = ("文档轨", "美术轨", "双轨")
|
||||
DOC_DESIGN_WORDS = ("待文档设计", "文档设计中", "文档设计已闭合")
|
||||
ART_DESIGN_WORDS = ("待美术设计", "美术设计中", "美术设计已闭合")
|
||||
DESIGN_WORDS = DOC_DESIGN_WORDS + ART_DESIGN_WORDS
|
||||
FANBU_WORDS = ("待裁决", "已写入") # 反哺点专条用词，不走设计线也不走下游序列
|
||||
# 工程形态条目的证据指认形态：审计报告路径／文件:行号址／「证据＝」句／审计 P 编号
|
||||
EVIDENCE_RE = re.compile(r"reports/\S+|[\w/.\-]+:\d{2,}|证据\s*[＝=]|审计\s*P\d")
|
||||
ROADMAP_HEADER = ("迭代代号", "状态", "需求卡片", "编入时间", "预计周期", "实现报告")
|
||||
RESERVED_RETIRED = "已退役（git 历史可考）"
|
||||
|
||||
@@ -63,7 +61,10 @@ ITER_RE = re.compile(r"迭代\s*(\d+)")
|
||||
APPROVAL_RE = re.compile(r"〔用户特批([^〕]*)〕")
|
||||
CRED_RE = re.compile(r"[（(]([^（）()]*)[）)]")
|
||||
CARD_SEP_RE = re.compile(r"<br\s*/?>|\n|、") # 迭代行卡片列一格多卡的分隔（§12.2 一格一行一卡）
|
||||
ATTR_LINE_RE = re.compile(r"^\*\*(现状|缺口|归属|状态)\*\*\s*[：:]\s*(.*)$")
|
||||
ATTR_LINE_RE = re.compile(r"^\*\*(实况|缺口|改动面|状态)\*\*\s*[：:]\s*(.*)$")
|
||||
LEGACY_ATTR_RE = re.compile(r"^\*\*(现状|归属)\*\*") # 已废除的属性名，出现即红
|
||||
PRIORITY_RE = re.compile(r"优先级\s*[=＝]\s*\**([A-Za-z0-9]+)\**")
|
||||
SURFACE_SEP_RE = re.compile(r"＋|\+")
|
||||
HEADING_RE = re.compile(r"^(#{1,4})\s+")
|
||||
SEP_ROW_RE = re.compile(r"^\|[\s\-|:]+$")
|
||||
STATUS_COL_RE = re.compile(
|
||||
@@ -106,32 +107,29 @@ def parse_todo(text):
|
||||
|
||||
|
||||
def check_title(title, line, issues, where):
|
||||
"""判据 1：标题须含日期、来源=四选一、设计面=五选一。返回设计面词（可能 None）。"""
|
||||
"""判据 1：标题须含登记日期与「来源=」四选一；优先级可选、写则须三档；禁残留「设计面=」。"""
|
||||
if not DATE_RE.search(title):
|
||||
issues.append((where, line, "标题元数据", "标题缺登记日期（YYYY-MM-DD 形态）"))
|
||||
face = None
|
||||
m = re.search(r"来源=([^\s，,（()）]+)", title)
|
||||
if not m:
|
||||
issues.append((where, line, "标题元数据", "标题缺「来源=」标记"))
|
||||
elif m.group(1) not in SOURCE_WORDS:
|
||||
issues.append((where, line, "标题元数据",
|
||||
"来源词「%s」不在四选一（playnote/会话提及/审计发现/批次移交）" % m.group(1)))
|
||||
m = re.search(r"设计面=([^\s，,（()）]+)", title)
|
||||
if not m:
|
||||
issues.append((where, line, "标题元数据", "标题缺「设计面=」标记"))
|
||||
elif m.group(1) not in FACE_WORDS:
|
||||
issues.append((where, line, "标题元数据",
|
||||
"设计面词「%s」不在五选一（文档轨/美术轨/双轨/工程直入/反哺点）" % m.group(1)))
|
||||
else:
|
||||
face = m.group(1)
|
||||
return face
|
||||
if "设计面=" in title:
|
||||
issues.append((where, line, "标题残留设计面",
|
||||
"「设计面=」不是条目属性：所属设计线看状态段用词，产出面写「**改动面**」（§12.1）"))
|
||||
m = PRIORITY_RE.search(title)
|
||||
if m and m.group(1) not in PRIORITY_WORDS:
|
||||
issues.append((where, line, "优先级档名",
|
||||
"优先级「%s」不在三档（P0/P1/P2；不写＝P2，档名只由用户给）" % m.group(1)))
|
||||
|
||||
|
||||
def check_segment(word, line, issues, where):
|
||||
"""判据 3 的单段校验。返回 (合法状态词|None, 已编迭代号|None)。
|
||||
|
||||
2026-10-20 状态栏纯化批：状态行只写状态词（§12.1），括号凭据已废止——
|
||||
闭合证据改到现状关联文档清单核对（check_todo 内），本函数只认状态词本身。
|
||||
状态行只写状态词（§12.1），括号凭据已废止——闭合证据改到实况关联文档清单
|
||||
核对（check_todo 内），本函数只认状态词本身。
|
||||
"""
|
||||
def red(name, msg):
|
||||
issues.append((where, line, name, msg))
|
||||
@@ -149,14 +147,14 @@ def check_segment(word, line, issues, where):
|
||||
return base, None
|
||||
|
||||
|
||||
def check_status(raw, line, face, issues, where):
|
||||
def check_status(raw, line, issues, where):
|
||||
"""判据 3＋状态段累积制（§12.1）＋特批/备选。返回 (状态词列表, 已编迭代号|None)。
|
||||
|
||||
累积制：按＋切段后段数不限，逐段各自合法；再查两条结构约束——
|
||||
下游段（待写卡/已写卡/已编迭代）在场时上游闭合段必须在场（带日期特批可豁免）；
|
||||
双轨设计阶段（无下游段）必须恰两段且一文档一美术。
|
||||
累积制：按＋切段后段数不限，逐段各自合法；再查一条结构约束——下游段
|
||||
（待写卡/已写卡/已编迭代）在场时禁残留未闭合设计段（带日期特批可豁免）。
|
||||
所属设计线由状态段用词自身表明，闸不读标题声明。
|
||||
状态行只写状态词（§12.1）：去掉特批标记与（备选）后缀后，残留任何括号即红——
|
||||
证据写现状关联文档清单，由 check_todo 到正文核对；此处点名病因后短路，
|
||||
证据写实况关联文档清单，由 check_todo 到正文核对；此处点名病因后短路，
|
||||
不再产出碎片「状态词非法」误导红。
|
||||
"""
|
||||
content = raw.strip()
|
||||
@@ -173,7 +171,7 @@ def check_status(raw, line, face, issues, where):
|
||||
content = content.replace("（备选）", "").replace("(备选)", "").strip()
|
||||
if re.search(r"[（()）]", content):
|
||||
issues.append((where, line, "状态行含括号内容",
|
||||
"括号里的信息（路径/版本/说明）写进现状关联文档清单，状态行只留状态词（§12.1）"))
|
||||
"括号里的信息（路径/版本/说明）写进实况关联文档清单，状态行只留状态词（§12.1）"))
|
||||
return [], None
|
||||
segs = [s.strip() for s in content.split("＋") if s.strip()]
|
||||
if not segs:
|
||||
@@ -186,33 +184,23 @@ def check_status(raw, line, face, issues, where):
|
||||
words.append(w)
|
||||
if it is not None:
|
||||
iter_no = it
|
||||
downstream = [w for w in words if w in DOWNSTREAM_WORDS]
|
||||
if downstream and face in PRESENCE_FACES and not dated_approval:
|
||||
need = []
|
||||
if face in ("文档轨", "双轨") and "文档设计已闭合" not in words:
|
||||
need.append("文档设计已闭合")
|
||||
if face in ("美术轨", "双轨") and "美术设计已闭合" not in words:
|
||||
need.append("美术设计已闭合")
|
||||
if need:
|
||||
issues.append((where, line, "在场约束",
|
||||
"下游段（%s）在场但缺上游闭合段 %s（带日期特批可豁免）"
|
||||
% ("、".join(downstream), "、".join(need))))
|
||||
if face == "双轨" and not downstream:
|
||||
n_doc = sum(1 for w in words if w in DOC_DESIGN_WORDS)
|
||||
n_art = sum(1 for w in words if w in ART_DESIGN_WORDS)
|
||||
if len(segs) != 2 or n_doc != 1 or n_art != 1:
|
||||
issues.append((where, line, "双轨段数",
|
||||
"设计面=双轨设计阶段须恰两段且一文档一美术（现 %d 段：文档轨 %d、美术轨 %d）"
|
||||
% (len(segs), n_doc, n_art)))
|
||||
# 同一设计线只留最新一段：并现两段说明推进时忘了收旧段，或把另一条线的段
|
||||
# 误写进本线条目；跨条设计线的未闭合依赖（如文档线已闭合写卡、美术线仍待设计）合法。
|
||||
for track, name in ((DOC_DESIGN_WORDS, "文档线"), (ART_DESIGN_WORDS, "美术线")):
|
||||
hit = [w for w in words if w in track]
|
||||
if len(hit) > 1:
|
||||
issues.append((where, line, "设计线段并现",
|
||||
"%s同时出现 %s（同线只留最新一段，§12.1）" % (name, "、".join(hit))))
|
||||
return words, iter_no
|
||||
|
||||
|
||||
def check_todo(text, issues, where, root):
|
||||
"""待办清单全部判据。返回交叉核链（已编迭代条目 → (行号, 迭代号, 卡片路径|None)）。
|
||||
|
||||
2026-10-20 状态栏纯化批：闭合类状态词的证据核对从状态栏括号改到现状关联文档
|
||||
清单（§12.1「状态行只写状态词」）——已写卡对 reports/ 卡片路径＋磁盘存在性，
|
||||
文档轨闭合/已写入对 design/ 路径＋版本号，美术轨闭合对 art-bible＋版本号。
|
||||
闭合类状态词的证据核对只在实况关联文档清单内进行（§12.1「状态行只写状态词」）：
|
||||
已写卡对 reports/ 卡片路径＋磁盘存在性，文档设计已闭合／已写入对 .md 路径＋版本号，
|
||||
美术设计已闭合对 art-bible 版本凭据。工程形态条目（状态无设计段且已进下游段）
|
||||
必须在实况指认证据。
|
||||
"""
|
||||
entries = parse_todo(text)
|
||||
links = []
|
||||
@@ -222,57 +210,86 @@ def check_todo(text, issues, where, root):
|
||||
return links
|
||||
for e in entries:
|
||||
line = e["line"]
|
||||
face = check_title(e["title"], line, issues, where)
|
||||
check_title(e["title"], line, issues, where)
|
||||
attrs, attr_line = {}, {}
|
||||
for ln, raw in e["body"]:
|
||||
m = ATTR_LINE_RE.match(raw.strip())
|
||||
if m and m.group(1) not in attrs:
|
||||
attrs[m.group(1)] = m.group(2)
|
||||
attr_line[m.group(1)] = ln
|
||||
for req in ("现状", "归属", "状态"):
|
||||
s = raw.strip()
|
||||
m = ATTR_LINE_RE.match(s)
|
||||
if m:
|
||||
if m.group(1) not in attrs:
|
||||
attrs[m.group(1)] = m.group(2)
|
||||
attr_line[m.group(1)] = ln
|
||||
elif LEGACY_ATTR_RE.match(s):
|
||||
issues.append((where, ln, "属性名已废除",
|
||||
"「%s」不在条目四属性内（现行＝实况/缺口/改动面/状态，§12.1）"
|
||||
% s[2:s.index("**")]))
|
||||
for req in ("实况", "改动面", "状态"):
|
||||
if req not in attrs:
|
||||
issues.append((where, line, "属性缺失", "条目缺「**%s**」属性" % req))
|
||||
if "状态" not in attrs:
|
||||
continue
|
||||
words, iter_no = check_status(
|
||||
attrs["状态"], attr_line["状态"], face, issues, where)
|
||||
# 现状属性全文（含清单续行）：证据核对只看现状，其他属性不算数
|
||||
xian_lines, in_xian = [], False
|
||||
words, iter_no = check_status(attrs["状态"], attr_line["状态"], issues, where)
|
||||
# 改动面：四档取多，＋连接，禁重复、禁自造词
|
||||
if "改动面" in attrs:
|
||||
parts = [p.strip() for p in SURFACE_SEP_RE.split(attrs["改动面"]) if p.strip()]
|
||||
if not parts:
|
||||
issues.append((where, attr_line["改动面"], "改动面缺档",
|
||||
"「**改动面**」为空（须写四档取多：文档/美术素材/游戏代码/工具代码）"))
|
||||
else:
|
||||
bad = [p for p in parts if p not in SURFACE_WORDS]
|
||||
if bad:
|
||||
issues.append((where, attr_line["改动面"], "改动面档名非法",
|
||||
"「%s」不在四档（文档/美术素材/游戏代码/工具代码，§12.1）"
|
||||
% "、".join(bad)))
|
||||
dup = sorted({p for p in parts if parts.count(p) > 1})
|
||||
if dup:
|
||||
issues.append((where, attr_line["改动面"], "改动面重复档",
|
||||
"重复写「%s」（每档只写一次）" % "、".join(dup)))
|
||||
# 实况属性全文（含清单续行）：证据核对只看实况，其他属性不算数
|
||||
live_lines, in_live = [], False
|
||||
for ln, raw in e["body"]:
|
||||
m = ATTR_LINE_RE.match(raw.strip())
|
||||
if m:
|
||||
in_xian = m.group(1) == "现状"
|
||||
if in_xian:
|
||||
xian_lines.append(m.group(2))
|
||||
elif in_xian:
|
||||
xian_lines.append(raw)
|
||||
xian = "\n".join(xian_lines)
|
||||
xline = attr_line.get("现状", line)
|
||||
# 证据核对一：已写卡 → 现状清单须有卡片路径，逐条验磁盘存在
|
||||
in_live = m.group(1) == "实况"
|
||||
if in_live:
|
||||
live_lines.append(m.group(2))
|
||||
elif in_live:
|
||||
live_lines.append(raw)
|
||||
live = "\n".join(live_lines)
|
||||
live_line = attr_line.get("实况", line)
|
||||
# 证据核对一：已写卡 → 实况清单须有卡片路径，逐条验磁盘存在
|
||||
cards = []
|
||||
if "已写卡" in words:
|
||||
cards = RESEARCH_RE.findall(xian)
|
||||
cards = RESEARCH_RE.findall(live)
|
||||
if not cards:
|
||||
issues.append((where, xline, "正文缺卡片路径",
|
||||
"状态段「已写卡」在场，但现状关联文档清单里没有 "
|
||||
issues.append((where, live_line, "正文缺卡片路径",
|
||||
"状态段「已写卡」在场，但实况关联文档清单里没有 "
|
||||
"reports/需求卡片-*.md 路径（§12.1：证据写正文）"))
|
||||
else:
|
||||
for rp in cards:
|
||||
if not (root / rp).is_file():
|
||||
issues.append((where, line, "卡片路径不存在",
|
||||
"现状清单里的卡片路径 %s 相对仓库根不存在" % rp))
|
||||
# 证据核对二：文档轨闭合／反哺已写入 → 现状清单须有文档路径＋版本号
|
||||
"实况清单里的卡片路径 %s 相对仓库根不存在" % rp))
|
||||
# 证据核对二：文档线闭合／反哺已写入 → 实况清单须有文档路径＋版本号
|
||||
# （待办清单正文里的指针是相对路径，形如 systems/… 或 design/…，只认 .md 收尾＋版本号）
|
||||
if "文档设计已闭合" in words or "已写入" in words:
|
||||
if not (re.search(r"[^\s ，,（）()]+\.md", xian) and VER_RE.search(xian)):
|
||||
issues.append((where, xline, "正文缺设计定稿指针",
|
||||
"状态段含文档轨闭合词，但现状清单里没有带版本号的文档路径（§12.1：证据写正文）"))
|
||||
# 证据核对三：美术轨闭合 → 现状清单须有 art-bible 版本凭据
|
||||
if not (re.search(r"[^\s ，,（）()]+\.md", live) and VER_RE.search(live)):
|
||||
issues.append((where, live_line, "正文缺设计定稿指针",
|
||||
"状态段含文档线闭合词，但实况清单里没有带版本号的文档路径（§12.1：证据写正文）"))
|
||||
# 证据核对三：美术线闭合 → 实况清单须有 art-bible 版本凭据
|
||||
if "美术设计已闭合" in words:
|
||||
if not ("art-bible" in xian.lower() and VER_RE.search(xian)):
|
||||
issues.append((where, xline, "正文缺美术凭据",
|
||||
"状态段「美术设计已闭合」在场，但现状清单里没有 "
|
||||
if not ("art-bible" in live.lower() and VER_RE.search(live)):
|
||||
issues.append((where, live_line, "正文缺美术凭据",
|
||||
"状态段「美术设计已闭合」在场，但实况清单里没有 "
|
||||
"art-bible 版本凭据（§12.1：证据写正文）"))
|
||||
# 无设计线段条目的证据指认：需求性工程条目（待写卡及以后）与直改类条目（待执行）
|
||||
# 都跳过设计线，实况必须给得出证据；反哺点专条不在此列。
|
||||
if (words and not any(w in DESIGN_WORDS for w in words)
|
||||
and not any(w in FANBU_WORDS for w in words)
|
||||
and not EVIDENCE_RE.search(live)):
|
||||
issues.append((where, live_line, "无设计线段缺证据指认",
|
||||
"状态整行无设计线段（需求性工程条目或直改类条目），实况须指认证据"
|
||||
"（reports/ 路径／文件:行号址／「证据＝」句／审计 P 编号，§12.1）"))
|
||||
need_gap = any(w in GAP_REQUIRED for w in words)
|
||||
if need_gap and "缺口" not in attrs:
|
||||
issues.append((where, line, "缺口属性",
|
||||
@@ -524,7 +541,7 @@ def check_cards(root, issues):
|
||||
if when >= SOURCE_RULE_DATE and not any(mark in text for mark in SOURCE_MARKS):
|
||||
issues.append((str(path), 1, "设计事实源缺失",
|
||||
"须含「设计事实源」或「唯一事实源」声明句（req-card §2 三选一，"
|
||||
"GDD 节＋版本号／样张＋art-bible 版本／工程直入证据指认）"))
|
||||
"GDD 节＋版本号／样张＋art-bible 版本／工程形态证据指认）"))
|
||||
if when >= LEDGER_RULE_DATE:
|
||||
check_ledger(text, path, issues)
|
||||
if AUDIT_MARK not in text:
|
||||
|
||||
@@ -1,22 +1,22 @@
|
||||
# 待办清单
|
||||
|
||||
本清单是流水线的唯一登记处：要做的事先在此登记一条，随流水线段推进改状态，做完整条删除；各系统文档的「待办」节只留一行指路存根，不再自建条目。条目格式（标题＝登记元数据，正文＝现状/缺口/归属/状态四属性）与状态机以 [doc-conventions §12.1](design/engineering/doc-conventions.md) 为权威。
|
||||
本清单是流水线的唯一登记处：要做的事先在此登记一条，随流水线段推进改状态，做完整条删除；各系统文档的「待办」节只留一行指路存根，不再自建条目。条目格式（标题＝登记元数据含可选优先级，正文＝实况/缺口/改动面/状态四属性）与状态机以 [doc-conventions §12.1](design/engineering/doc-conventions.md) 为权威。
|
||||
|
||||
#### 超预算图策略升级路径——等比缩放与滚动视口两案待裁（2026-10-24 登记，来源=批次移交，设计面=文档轨）
|
||||
#### 超预算图策略升级路径——等比缩放与滚动视口两案待裁（2026-10-24 登记，来源=批次移交）
|
||||
|
||||
**现状**：迭代 34 卡④（信息迷雾可见性批，已合回 master，提交 16a7ec80）按「参数限图」交付，图包络约 10 层×8 槽即当前冻结画布的屏预算上限。若后续定值批需要更大的完整可见图，两条升级路径都要动冻结件，均未设计：①等比缩放——动「节点图标 20px 烘焙 1:1」与「通道折线冻结 2/3/4px」两条冻结值；②滚动视口——新增视口交互范式。迭代 35 生成图实测深度域 L3 达 0–13，已超出该上限（level-map 已登记随动缺口，本批不裁方案）。
|
||||
**实况**：迭代 34 卡④（信息迷雾可见性批，已合回 master，提交 16a7ec80）按「参数限图」交付，图包络约 10 层×8 槽即当前冻结画布的屏预算上限。若后续定值批需要更大的完整可见图，两条升级路径都要动冻结件，均未设计：①等比缩放——动「节点图标 20px 烘焙 1:1」与「通道折线冻结 2/3/4px」两条冻结值；②滚动视口——新增视口交互范式。迭代 35 生成图实测深度域 L3 达 0–13，已超出该上限（level-map 已登记随动缺口，本批不裁方案）。
|
||||
- 相关文档 design/gdd/systems/冒险循环/关卡节点图生成.md v1.3（调参表「图包络」行）
|
||||
- 相关文档 design/gdd/ux/level-map.md（画布冻结公式）
|
||||
|
||||
**缺口**：两案需用户裁决后再走设计讨论；未裁前禁改画布冻结件。
|
||||
|
||||
**归属**：[关卡节点图生成](design/gdd/systems/冒险循环/关卡节点图生成.md)（图包络约束）＋ [level-map](design/gdd/ux/level-map.md)（画布与交互呈现）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### game 代码结构审查批——行为缺陷定点修＋结构重构候选（2026-10-24 登记，来源=审计发现，设计面=工程直入）
|
||||
#### game 代码结构审查批——行为缺陷定点修＋结构重构候选（2026-10-24 登记，来源=审计发现）
|
||||
|
||||
**现状**：审计报告＝reports/审计-game代码结构审查-2026-10-24.md（2026-10-24，全目录只读审查，零测试执行、结论全部静态阅读）。缺陷证据（报告 §二 Critical 行为缺陷段＋定点清单，含行号）九件：①core/damage_controller.gd:215 用 `==` 比较单位字典（Godot 4 语义＝逐键内容比较）——内容全同双敌其一死亡误作废对方单据，应 `is_same()`；②presentation/views/standee_body.gd:172/188 蓄力意图档常量错配（GOLD_INK vs GOLD_DEEP）死代码，三档运动签名设计失效且无测试覆盖；③presentation/views/battle_end_overlay.gd:281-287 庆祝 tween set_loops 无限叠加泄漏（close 只隐藏不 kill）；④批量模拟×两层调试并发互斥缺口（presentation/views/debug_overlay.gd:84＋presentation/main.gd:712-715/1489＋presentation/tune_sim_controller.gd:46-58——用户两击可并触发，演出扭曲＋测量作废）；⑤presentation/modal_stack.gd:23-29 未登记层/重复开层静默降级（违 fail-fast，当前调用面无违规者属埋雷）；⑥core/minesweeper_rules.gd:8-9 两条核心信号零契约成文（违 code-conventions §2.1）＋全库信号注释载体普遍 `#` 非 `##`；⑦明细行类型封闭枚举漂移（core 实发 13 类 vs battle_orchestrator.gd 头注 9 类）；⑧core/level_runner.gd:895/779 玩法数值字面量（relic 基价 15.0、散折 0.8，自注 provisional）；⑨presentation/views/battle_stage_view.gd:332-338 以 display_name 子串匹配解析受击目标（同名敌错位，应携带 enemy_id）。另有定点小件与结构重构候选（报告 §三）：main.gd 1508 行可判离块 ~440 行／board_view.gd 1219 行瓦片算法＋英雄精灵可拆／adventure_runner 令牌池子系统 ~500 行可拆 CurioDeck／level_runner 商店子系统 ~260 行可拆／断点 schema 三处重复登记可单点化——重构候选非缺陷，是否立项由写卡段呈报用户裁决。**2026-10-24 写卡会话收口**：用户裁五件重构候选全部立项（卡①缺陷修先行落地后重构再动）；缺陷⑦明细行枚举漂移划归「架构与规范对齐批」条目（词表 13/15 归该批裁决，缺陷卡不碰头注）；报告 §三「其余小件」（level_map 视图直读/BFS、main 死变量与 confirm 旁路、settle_batch 空判、row_pacer 常驻 flush、_fatal assert 剥离、rng_service early-return）未立项，留审计报告在册待后续点名。切卡输入＝审计报告 §二/§三，四卡均零待裁点。
|
||||
**实况**：审计报告＝reports/审计-game代码结构审查-2026-10-24.md（2026-10-24，全目录只读审查，零测试执行、结论全部静态阅读）。缺陷证据（报告 §二 Critical 行为缺陷段＋定点清单，含行号）九件：①core/damage_controller.gd:215 用 `==` 比较单位字典（Godot 4 语义＝逐键内容比较）——内容全同双敌其一死亡误作废对方单据，应 `is_same()`；②presentation/views/standee_body.gd:172/188 蓄力意图档常量错配（GOLD_INK vs GOLD_DEEP）死代码，三档运动签名设计失效且无测试覆盖；③presentation/views/battle_end_overlay.gd:281-287 庆祝 tween set_loops 无限叠加泄漏（close 只隐藏不 kill）；④批量模拟×两层调试并发互斥缺口（presentation/views/debug_overlay.gd:84＋presentation/main.gd:712-715/1489＋presentation/tune_sim_controller.gd:46-58——用户两击可并触发，演出扭曲＋测量作废）；⑤presentation/modal_stack.gd:23-29 未登记层/重复开层静默降级（违 fail-fast，当前调用面无违规者属埋雷）；⑥core/minesweeper_rules.gd:8-9 两条核心信号零契约成文（违 code-conventions §2.1）＋全库信号注释载体普遍 `#` 非 `##`；⑦明细行类型封闭枚举漂移（core 实发 13 类 vs battle_orchestrator.gd 头注 9 类）；⑧core/level_runner.gd:895/779 玩法数值字面量（relic 基价 15.0、散折 0.8，自注 provisional）；⑨presentation/views/battle_stage_view.gd:332-338 以 display_name 子串匹配解析受击目标（同名敌错位，应携带 enemy_id）。另有定点小件与结构重构候选（报告 §三）：main.gd 1508 行可判离块 ~440 行／board_view.gd 1219 行瓦片算法＋英雄精灵可拆／adventure_runner 令牌池子系统 ~500 行可拆 CurioDeck／level_runner 商店子系统 ~260 行可拆／断点 schema 三处重复登记可单点化——重构候选非缺陷，是否立项由写卡段呈报用户裁决。**2026-10-24 写卡会话收口**：用户裁五件重构候选全部立项（卡①缺陷修先行落地后重构再动）；缺陷⑦明细行枚举漂移划归「架构与规范对齐批」条目（词表 13/15 归该批裁决，缺陷卡不碰头注）；报告 §三「其余小件」（level_map 视图直读/BFS、main 死变量与 confirm 旁路、settle_batch 空判、row_pacer 常驻 flush、_fatal assert 剥离、rng_service early-return）未立项，留审计报告在册待后续点名。切卡输入＝审计报告 §二/§三，四卡均零待裁点。
|
||||
|
||||
关联文档清单：
|
||||
- 需求卡片 reports/需求卡片-game行为缺陷定点修批-2026-10-24.md（2026-10-24 v1.2（grilling 两轮复核通过），缺陷修主卡·迭代批，八件缺陷＋定点小件七件，零待裁点）
|
||||
@@ -24,141 +24,119 @@
|
||||
- 需求卡片 reports/需求卡片-重构boardview拆件批-2026-10-24.md（2026-10-24 v1.2（grilling 两轮复核通过），重构卡 R2·迭代批，零待裁点）
|
||||
- 需求卡片 reports/需求卡片-重构runner拆件与断点schema单点批-2026-10-24.md（2026-10-24 v1.2（grilling 两轮复核通过），重构卡 R3·迭代批，零待裁点）
|
||||
|
||||
**归属**：game/ 呈现层与 core 域（缺陷定点修，迭代批）；结构重构候选另立批次由用户裁决。切卡输入＝审计报告 §二/§三
|
||||
**改动面**：游戏代码
|
||||
|
||||
**状态**：待写卡＋已写卡＋已编迭代 37
|
||||
|
||||
#### S9 类型闸正则失灵修复——R2 恒零命中＋static 函数漏网（2026-10-24 登记，来源=审计发现，设计面=工程直入）
|
||||
#### S9 类型闸正则失灵修复——R2 恒零命中＋static 函数漏网（2026-10-24 登记，来源=审计发现）
|
||||
|
||||
**现状**：工程债证据＝reports/审计-game代码结构审查-2026-10-24.md §二 C1（已独立复现）：tools/audit_type_hints.py:29 的 FUNC_DECL 正则两洞——①无返回类型声明按 GDScript 语法必然以 `:` 结尾，正则要求 `)` 后只跟 `->`/注释/行尾，R2 目标形态 100% 失配（R2 从上线起恒零命中恒绿）；②`^(\s*)func` 不认 `static ` 前缀，static 函数对 R2/R3 整体漏网。实证存量（闸当前退出码 0）：core/level_runner.gd:632、core/attunement.gd:10、presentation/main.gd:565、presentation/views/hud_presenter.gd:10-11、core/reward_economy.gd:104/119/131/146、core/unit_container.gd:275（写卡会话路径订正：hud_presenter 实址 game/presentation/hud_presenter.gd，非 views/）。属架构文档测试域自警的「规则扫描面为空＝恒绿」静默失效模式（零命中自检因 R1/R3 仍有命中能力未拦住）。2026-10-25 规则修订（改动四类）：本件属工程改动（闸件修复，直改类）。执行口径＝修 `tools/audit_type_hints.py:29` FUNC_DECL 正则两洞（①无返回类型声明的声明形态恒失配；②`^(\s*)func` 不认 `static ` 前缀），存量以开工时盘面清点（实证九址为已知下限），验收走撤销证明。原需求卡片按违形退役：结论已回写本条目，卡片删除，全稿查 git 历史（提交 546e5113）。
|
||||
**实况**：工程债证据＝reports/审计-game代码结构审查-2026-10-24.md §二 C1（已独立复现）：tools/audit_type_hints.py:29 的 FUNC_DECL 正则两洞——①无返回类型声明按 GDScript 语法必然以 `:` 结尾，正则要求 `)` 后只跟 `->`/注释/行尾，R2 目标形态 100% 失配（R2 从上线起恒零命中恒绿）；②`^(\s*)func` 不认 `static ` 前缀，static 函数对 R2/R3 整体漏网。实证存量（闸当前退出码 0）：core/level_runner.gd:632、core/attunement.gd:10、presentation/main.gd:565、presentation/views/hud_presenter.gd:10-11、core/reward_economy.gd:104/119/131/146、core/unit_container.gd:275（写卡会话路径订正：hud_presenter 实址 game/presentation/hud_presenter.gd，非 views/）。属架构文档测试域自警的「规则扫描面为空＝恒绿」静默失效模式（零命中自检因 R1/R3 仍有命中能力未拦住）。2026-10-25 规则修订（改动四类）：本件属工程改动（闸件修复，直改类）。执行口径＝修 `tools/audit_type_hints.py:29` FUNC_DECL 正则两洞（①无返回类型声明的声明形态恒失配；②`^(\s*)func` 不认 `static ` 前缀），存量以开工时盘面清点（实证九址为已知下限），验收走撤销证明。原需求卡片按违形退役：结论已回写本条目，卡片删除，全稿查 git 历史（提交 546e5113）。
|
||||
|
||||
**归属**：tools/ 静态扫描域（闸件修复，工程改动直改类——gdstyle 引入批 2026-10-24 已按同款形态完成：先摸存量、闸改动配撤销证明）
|
||||
**改动面**：工具代码
|
||||
|
||||
**状态**：待执行
|
||||
|
||||
#### S13 gdstyle 免名单把数字当身份——存量债改小也报「基线外新违规」（2026-10-25 登记，来源=批次移交，设计面=工程直入）
|
||||
#### S13 gdstyle 免名单把数字当身份——存量债改小也报「基线外新违规」（2026-10-25 登记，来源=批次移交）
|
||||
|
||||
**现状**：工程债证据＝迭代 35 卡② 合回前后实测（master 合回笔 `5499eb9c`）。闸件 `tools/gdstyle_gate.py:82` 把每条违规登记成三元组「文件|规则|消息全文」，而 gdstyle 的消息文本里带具体数字（如 `function 'resume_adventure' is 104 lines long (max 50)`），基线 `tools/gdstyle_baseline.txt`（241 行）按整句逐字比对——**只要某函数的行数/分支数/变量数发生变化，老违规就匹配不上，被判「基线外新违规」并判红，改小也算新增**。卡② 一批即因此冒出 12 项假新增，逐条对基线旧值核实全是存量债的计数漂移：`config_db_cross_validator.cross_validate` 159→107 行／31→21 分支／39→24 局部／嵌套 6→5（本批按卡片删除跨表校验④整段所致，债变小）、`level_runner` 类变量 40→38 且其「文件 1013 行超长」违规已消失（债被还掉）、`start_level_external` 参数 8→7、`main.gd` 1509→1507、`adventure_runner` 类变量 43→42／文件 1050→1051／`resume_adventure` 104→108 行（本批加断点代差标记键拒绝检查多 4 行）。本批真正新写的超标仅 1 处（新函数 `validate_graph` 72 行／20 分支），已当场拆成四段修掉。**盘面后果**：卡② 按用户令零复跑合回，master 尖 5499eb9c 从未整套跑绿过代码域闸；下一次任何批跑代码域闸都会看到 S13 红这 12 项（不处理则每批重复一次「要么重生成基线、要么被红挡在合回前」）。卡片裁决留档（卡片已违形退役，git 历史可考）：四待裁点已拍板——稳定身份键／恶化判据超登记值即红／本批治本＋批内刷新基线／refresh 加对账自检与骤降守卫；验收按 2026-10-24 撤销证明口径执行。2026-10-25 规则修订（改动四类）：本件属工程改动（闸件修复，直改类）——原卡片按违形退役，结论已回写本条目，卡片删除，全稿查 git 历史（提交 36b444eb）；执行口径＝治本档（四待裁点已拍板项照录上文），用户发令直改。
|
||||
**实况**：工程债证据＝迭代 35 卡② 合回前后实测（master 合回笔 `5499eb9c`）。闸件 `tools/gdstyle_gate.py:82` 把每条违规登记成三元组「文件|规则|消息全文」，而 gdstyle 的消息文本里带具体数字（如 `function 'resume_adventure' is 104 lines long (max 50)`），基线 `tools/gdstyle_baseline.txt`（241 行）按整句逐字比对——**只要某函数的行数/分支数/变量数发生变化，老违规就匹配不上，被判「基线外新违规」并判红，改小也算新增**。卡② 一批即因此冒出 12 项假新增，逐条对基线旧值核实全是存量债的计数漂移：`config_db_cross_validator.cross_validate` 159→107 行／31→21 分支／39→24 局部／嵌套 6→5（本批按卡片删除跨表校验④整段所致，债变小）、`level_runner` 类变量 40→38 且其「文件 1013 行超长」违规已消失（债被还掉）、`start_level_external` 参数 8→7、`main.gd` 1509→1507、`adventure_runner` 类变量 43→42／文件 1050→1051／`resume_adventure` 104→108 行（本批加断点代差标记键拒绝检查多 4 行）。本批真正新写的超标仅 1 处（新函数 `validate_graph` 72 行／20 分支），已当场拆成四段修掉。**盘面后果**：卡② 按用户令零复跑合回，master 尖 5499eb9c 从未整套跑绿过代码域闸；下一次任何批跑代码域闸都会看到 S13 红这 12 项（不处理则每批重复一次「要么重生成基线、要么被红挡在合回前」）。卡片裁决留档（卡片已违形退役，git 历史可考）：四待裁点已拍板——稳定身份键／恶化判据超登记值即红／本批治本＋批内刷新基线／refresh 加对账自检与骤降守卫；验收按 2026-10-24 撤销证明口径执行。2026-10-25 规则修订（改动四类）：本件属工程改动（闸件修复，直改类）——原卡片按违形退役，结论已回写本条目，卡片删除，全稿查 git 历史（提交 36b444eb）；执行口径＝治本档（四待裁点已拍板项照录上文），用户发令直改。
|
||||
|
||||
**预计改动面（两档，第一条只治标）**：① 治标＝人工跑一次 `python tools/gdstyle_gate.py --refresh` 重生成基线＋一笔提交，约 5 分钟，但键形态未改，下一批再动这些文件还会重演；② 治本＝改 `tools/gdstyle_gate.py` 的键构造段（:77-90，约 10–20 行）为「文件|规则|函数名」——函数名从消息里正则提取 `function 'x'`，无函数名的条目（类变量数/文件长度）退化为「文件|规则」，并**另加一条恶化判据**防新键吞掉真问题（同一函数当前指标较基线登记值恶化超阈值即判红，纯规范化数字会把 104→300 行的恶化也放过去，不可只靠数字抹平）；随动＝重生成 `tools/gdstyle_baseline.txt`（241 行按新键重排）、`tools/run_all_gates.sh` 头注与 `game/tests/README.md` 工具速查表的 S13 描述各一行、撤销证明四项（新增一处真超标必红／同函数改小改大的数字漂移禁止再冒新／恶化超阈值必红／禁闸内自动重生成清基线换绿的自检仍绿——各配撤销该判据见红＋还原复绿）。合计约 **0.5 个工作日**，工程改动（tools/ 闸机面）直改类。
|
||||
两档方案（第一条只治标）：① 治标＝人工跑一次 `python tools/gdstyle_gate.py --refresh` 重生成基线＋一笔提交，约 5 分钟，但键形态未改，下一批再动这些文件还会重演；② 治本＝改 `tools/gdstyle_gate.py` 的键构造段（:77-90，约 10–20 行）为「文件|规则|函数名」——函数名从消息里正则提取 `function 'x'`，无函数名的条目（类变量数/文件长度）退化为「文件|规则」，并**另加一条恶化判据**防新键吞掉真问题（同一函数当前指标较基线登记值恶化超阈值即判红，纯规范化数字会把 104→300 行的恶化也放过去，不可只靠数字抹平）；随动＝重生成 `tools/gdstyle_baseline.txt`（241 行按新键重排）、`tools/run_all_gates.sh` 头注与 `game/tests/README.md` 工具速查表的 S13 描述各一行、撤销证明四项（新增一处真超标必红／同函数改小改大的数字漂移禁止再冒新／恶化超阈值必红／禁闸内自动重生成清基线换绿的自检仍绿——各配撤销该判据见红＋还原复绿）。合计约 **0.5 个工作日**，工程改动（tools/ 闸机面）直改类。
|
||||
|
||||
**归属**：tools/ 静态扫描域（闸件修复，工程改动直改类）——与「S9 类型闸正则失灵修复」「S6/S7/S8 静态规则落地」两条同族：规则扫描面自身失灵/失准，防线不可信即等于没有防线
|
||||
**改动面**：文档＋工具代码
|
||||
|
||||
**状态**：待执行
|
||||
|
||||
#### S6/S7/S8 静态规则落地——编排唯一性/禁 await/信号纪律三闸（2026-10-24 登记，来源=审计发现，设计面=工程直入）
|
||||
#### S6/S7/S8 静态规则落地——编排唯一性/禁 await/信号纪律三闸（2026-10-24 登记，来源=审计发现）
|
||||
|
||||
**现状**：工程债证据＝reports/审计-game代码结构审查-2026-10-24.md §二 C2：三规则 static_scan.sh TODO 在案（架构文档静态扫描表自认未落地）——S6 core↔core 信号禁 lambda 捕获 self、S7 B2/B3/B4 API 符号命中文件 ⊆ B1 文件集、S8 结算路径 await 零命中。2026-10-24 审查人工 grep 结论干净（core 零 await、A2/B3/B4 零相互直调），但防线缺位＝回归无闸。S7 前置：须先在架构文档成文 B1 文件集边界（含 core/settlement/ 五段类与 damage_controller——现归属表零条目，见「架构与规范对齐批」条目①）。**2026-10-24 用户裁：条目整条冻结待④（「架构与规范对齐批」）裁决后再写卡**——写卡会话核对结论：S6（core 信号禁 lambda）与 S8（结算路径禁 await，文件集可按现行结算文件直接枚举）与④零依赖、技术上可先行，但按「先裁④再动③」整条冻结不先行。
|
||||
**实况**：工程债证据＝reports/审计-game代码结构审查-2026-10-24.md §二 C2：三规则 static_scan.sh TODO 在案（架构文档静态扫描表自认未落地）——S6 core↔core 信号禁 lambda 捕获 self、S7 B2/B3/B4 API 符号命中文件 ⊆ B1 文件集、S8 结算路径 await 零命中。2026-10-24 审查人工 grep 结论干净（core 零 await、A2/B3/B4 零相互直调），但防线缺位＝回归无闸。S7 前置：须先在架构文档成文 B1 文件集边界（含 core/settlement/ 五段类与 damage_controller——现归属表零条目，见「架构与规范对齐批」条目①）。**2026-10-24 用户裁：条目整条冻结待④（「架构与规范对齐批」）裁决后再写卡**——写卡会话核对结论：S6（core 信号禁 lambda）与 S8（结算路径禁 await，文件集可按现行结算文件直接枚举）与④零依赖、技术上可先行，但按「先裁④再动③」整条冻结不先行。
|
||||
|
||||
**归属**：tools/ 静态扫描域（工程改动直改类）；S7 依赖「架构与规范对齐批」先裁 B1 文件集
|
||||
**改动面**：工具代码
|
||||
|
||||
**状态**：待写卡
|
||||
|
||||
#### 验证集清单快照重生成——断言索引含退役措辞与旧行号（2026-10-25 登记，来源=审计发现，设计面=工程直入）
|
||||
#### 架构与规范对齐批——代码结构审查发现的文档-实现漂移（2026-10-24 登记，来源=审计发现）
|
||||
|
||||
**现状**：工程债证据＝迭代 35 卡② 验收审计申报（git 历史可考：合回提交 5499eb9c 内的 reports/iter35-卡②-验收审计-2026-10-24.md，该产出物已按吸收即死退役）：game/tests/验证集清单.md 是批 B 迁移时的断言文本快照索引，只由 tools/extract_checks.py 手工重生成、不进任何闸；卡② 断言面换代后十余行仍含 first_script／template_pick 等退役措辞与过期行号（实测 first_script 8 处、template_pick 2 处），与宿主现文不符。2026-10-25 规则修订（改动四类）：本件属工程改动（测试基建维护，直改类）。执行口径＝走重生成：tools/extract_checks.py 两小改（头注模板数据驱动化＋新增 --carry-from 按同指纹承接「白话释义／处置」两列、承接文本内旧宿主文件名映射为新名）后 --extract --force 重生成（缺省三宿主全量口径；实测漂移＝清单 1067 条 vs 现提取 1544 条〔消失 67／新增 539／字面变更 14 对〕，template_pick 实测 3 处——登记句「2 处」少数一行），--diff 须 PASS；重生成后 grep node_map_templates／first_script／template_pick 预期零命中（若命中须全为反向断言）。原需求卡片按违形退役：结论已回写本条目，卡片删除，全稿查 git 历史（提交 1fb44cf4）。
|
||||
|
||||
**归属**：game/tests/验证集清单.md＋tools/extract_checks.py（重生成路线，2026-10-25 定）
|
||||
|
||||
**状态**：待执行
|
||||
|
||||
#### 测试宿主改名——node_map_templates_test.gd 已承载生成图确定性断言（2026-10-25 登记，来源=审计发现，设计面=工程直入）
|
||||
|
||||
**现状**：工程债证据＝迭代 35 卡② 反哺点⑧：game/tests/integration/node_map_templates_test.gd 现承载「生成图确定性断言套」，文件名中的 templates 是模板时代遗留；manifest 登记行＝game/tests/run_all.gd:90。改名为 node_map_determinism_test.gd 须同批改 manifest 路径行。2026-10-25 规则修订（改动四类）：本件属工程改动（测试基建维护，直改类）。执行口径＝git mv 宿主两件（.gd＋.uid）＋改 run_all.gd:90 路径行＋文件内 4 处自引用字面量（:1/:10/:26/:31），断言判据零改动，直跑新名退出码 0 为验收。原需求卡片按违形退役（结论已回写本条目，卡片删除，git 历史可考）。
|
||||
|
||||
**归属**：game/tests/integration/＋game/tests/run_all.gd manifest
|
||||
|
||||
**状态**：待执行
|
||||
|
||||
#### level.tres 表尾注释含迭代叙事（2026-10-25 登记，来源=审计发现，设计面=工程直入）
|
||||
|
||||
**现状**：工程债证据＝迭代 35 卡② 反哺点⑨：game/data/tables/level.tres 表尾注释写「旧 15 张模板池（3 关 × 5）随迭代 35 卡② 清出」，与 doc-conventions §5 禁写变更叙事有张力；卡② 卡片 T3 明令表尾写模板去向注记，故处置面限于叙事形态（删迭代号、保留图源换代事实句），不删去向事实。2026-10-25 规则修订（改动四类）：本件属工程改动（数据表注释维护，直改类），执行口径＝条目原裁（删迭代号、保留去向事实句、表内零改动）。原需求卡片按违形退役（结论已回写本条目，卡片删除，git 历史可考）。
|
||||
|
||||
**归属**：game/data/tables/level.tres
|
||||
|
||||
**状态**：待执行
|
||||
|
||||
#### 架构与规范对齐批——代码结构审查发现的文档-实现漂移（2026-10-24 登记，来源=审计发现，设计面=文档轨）
|
||||
|
||||
**现状**：审计报告＝reports/审计-game代码结构审查-2026-10-24.md（§二 C3/C4/C5＋§三 漂移清单）。漂移与待裁件七件：①架构文档「模块归属」多行 API 清单与实现不符（A2 try_* 便捷形/B2 ambush_grant_plan/B4 equivalence_supply 不存在；实有 grant_reserve_ap/finish_round_stop/check_skill_unlocks 未登记；damage_controller 与 settlement/ 五段类零条目——S7 落地的前置）；②code-conventions §1.3 核心写调用位置——三拆件控制器（presentation/curio_interact_controller.gd、camp_shop_presenter.gd、treasure_interact_controller.gd）持写调用 vs 规范「只允许在组合根出现」的 spec-AC 冲突，须裁「改规范成文组合根家族」vs「调用收回 main」；③A3→EffectEngine 反向依赖（core/action_economy.gd:43-49）——真违约或事实源失真二选一（effect_engine 降层登记基础层 vs B1 代发 vs 仅补登记）；④架构文档 :149/151 层合同计数写死 17 项 vs LAYER_CONTRACT 实 18 项；⑤明细行协议三处三个数（头注 9/实发 13/架构文档 15）；⑥§1.3 例举 submit_window_selection 符号已退役；⑦core/effect_engine.gd:360 校验文案「9 项」实为 18 项。
|
||||
**实况**：审计报告＝reports/审计-game代码结构审查-2026-10-24.md（§二 C3/C4/C5＋§三 漂移清单）。漂移与待裁件七件：①架构文档「模块归属」多行 API 清单与实现不符（A2 try_* 便捷形/B2 ambush_grant_plan/B4 equivalence_supply 不存在；实有 grant_reserve_ap/finish_round_stop/check_skill_unlocks 未登记；damage_controller 与 settlement/ 五段类零条目——S7 落地的前置）；②code-conventions §1.3 核心写调用位置——三拆件控制器（presentation/curio_interact_controller.gd、camp_shop_presenter.gd、treasure_interact_controller.gd）持写调用 vs 规范「只允许在组合根出现」的 spec-AC 冲突，须裁「改规范成文组合根家族」vs「调用收回 main」；③A3→EffectEngine 反向依赖（core/action_economy.gd:43-49）——真违约或事实源失真二选一（effect_engine 降层登记基础层 vs B1 代发 vs 仅补登记）；④架构文档 :149/151 层合同计数写死 17 项 vs LAYER_CONTRACT 实 18 项；⑤明细行协议三处三个数（头注 9/实发 13/架构文档 15）；⑥§1.3 例举 submit_window_selection 符号已退役；⑦core/effect_engine.gd:360 校验文案「9 项」实为 18 项。
|
||||
|
||||
**缺口**：一次 doc-design 会话逐点裁决（②③有方案取舍须用户拍板，①④⑤⑥⑦为机械对齐）；裁决后走文档设计改动直改写入 design/engineering/。
|
||||
|
||||
**归属**：design/engineering/（architecture.md「模块归属」节＋「呈现层装配」节、code-conventions §1.3）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### 死断言候选三条处置——照迁禁删断言的退役或改判待裁（2026-10-25 登记，来源=批次移交，设计面=工程直入）
|
||||
#### 死断言候选三条处置——照迁禁删断言的退役或改判待裁（2026-10-25 登记，来源=批次移交）
|
||||
|
||||
**现状**：批 B 断言迁移施工验出三条死断言候选（照迁禁删，宿主在座、结构复核通过、拦截能力未证——执行序遮断或执行前提在本机不可达）：① V2-s4 旧单档迁移不变式 `game/tests/system_test.gd:185`（本机磁盘态已固化，可红面「旧档在而槽 1 缺」在生产码变异下不可达；补审 A-2 已补结构例外标签——迁移逻辑本体由 save_manager_domain v0 迁移链断言覆盖）；② V3g 营地入口缺失 `game/tests/system_test.gd:481`（menu campbtn 置 null 后 boot 信号接线先崩，护栏在执行序上被遮断不可达，拦截语义由 boot 崩与前置断言代偿）；③ 区间行上下阶实际流动 `game/tests/unit/core/board_gen_reward_test.gd:297`（守面 `samples` 与 `seen[rid].size()` 为同一字典同引用恒假，系源码自带的测试侧死逻辑、非生产缺陷）。证据＝批B迁移账本 :238/:241/:273（账本已退役，考古＝git 历史——删除批 53075baa，删除前全稿见历史版本 5644d30c）＋冻结基点 `game/tests/验证集清单.md` 头注（commit 1aea9397）。另：核代码补审 C-2～C-6 五件测试增强候选原登记备查于账本 §十五，随账本退役并入本条备查——C-2 计数闸残缝（visible 标志位≠渲染面，隐藏匿名旧钮接回双闸漏过）、C-3 _stage_faces extra 静默吞键（match 无默认臂）、C-4 顺序耦合无守卫（boot_chain 须先于驱动执行；lifecycle_matrix 永久改写槽模板不还原）、C-5 camp 残留档使 V3g 红的原因标注误导（不静默）、C-6 V1a 候选表与 LAYER_CONTRACT 双维护（新增层忘登则漏检盖顶回归）。
|
||||
**实况**：批 B 断言迁移施工验出三条死断言候选（照迁禁删，宿主在座、结构复核通过、拦截能力未证——执行序遮断或执行前提在本机不可达）：① V2-s4 旧单档迁移不变式 `game/tests/system_test.gd:185`（本机磁盘态已固化，可红面「旧档在而槽 1 缺」在生产码变异下不可达；补审 A-2 已补结构例外标签——迁移逻辑本体由 save_manager_domain v0 迁移链断言覆盖）；② V3g 营地入口缺失 `game/tests/system_test.gd:481`（menu campbtn 置 null 后 boot 信号接线先崩，护栏在执行序上被遮断不可达，拦截语义由 boot 崩与前置断言代偿）；③ 区间行上下阶实际流动 `game/tests/unit/core/board_gen_reward_test.gd:297`（守面 `samples` 与 `seen[rid].size()` 为同一字典同引用恒假，系源码自带的测试侧死逻辑、非生产缺陷）。证据＝批B迁移账本 :238/:241/:273（账本已退役，考古＝git 历史——删除批 53075baa，删除前全稿见历史版本 5644d30c）＋冻结基点 `game/tests/验证集清单.md` 头注（commit 1aea9397）。另：核代码补审 C-2～C-6 五件测试增强候选原登记备查于账本 §十五，随账本退役并入本条备查——C-2 计数闸残缝（visible 标志位≠渲染面，隐藏匿名旧钮接回双闸漏过）、C-3 _stage_faces extra 静默吞键（match 无默认臂）、C-4 顺序耦合无守卫（boot_chain 须先于驱动执行；lifecycle_matrix 永久改写槽模板不还原）、C-5 camp 残留档使 V3g 红的原因标注误导（不静默）、C-6 V1a 候选表与 LAYER_CONTRACT 双维护（新增层忘登则漏检盖顶回归）。
|
||||
|
||||
**归属**：game/tests/（system_test.gd＋unit/core/board_gen_reward_test.gd）＋测试基建
|
||||
**改动面**：游戏代码
|
||||
|
||||
**状态**：待写卡
|
||||
|
||||
#### 营地五界面窗口化批——营地功能页点开后的呈现形态（2026-10-22 登记，来源=会话提及，设计面=文档轨，优先级＝**绝对**）
|
||||
#### 营地五界面窗口化批——营地功能页点开后的呈现形态（2026-10-22 登记，来源=会话提及）
|
||||
|
||||
**现状**：营地场景图（卡④）把旧四柜台换成「一张可点击的场景图」，从场景图点进去的**五个功能界面**——锻造工坊／秘宝匣／天赋树（树淬炼）／奖励格图鉴／生涯记录——其**呈现形态尚未定稿**：是各开独立全屏页（生涯先例），还是作为**窗口**打开（场景根留底）。**作者 2026-10-22 明示意图＝窗口打开，不是全屏页**。该形态原属卡④ §9 代拍板白名单第 2 条（非用户裁、且「缩放虚化」第三形态禁批内自选），故单独立批，不在美术设计段定值。
|
||||
**实况**：营地场景图（卡④）把旧四柜台换成「一张可点击的场景图」，从场景图点进去的**五个功能界面**——锻造工坊／秘宝匣／天赋树（树淬炼）／奖励格图鉴／生涯记录——其**呈现形态尚未定稿**：是各开独立全屏页（生涯先例），还是作为**窗口**打开（场景根留底）。**作者 2026-10-22 明示意图＝窗口打开，不是全屏页**。该形态原属卡④ §9 代拍板白名单第 2 条（非用户裁、且「缩放虚化」第三形态禁批内自选），故单独立批，不在美术设计段定值。
|
||||
|
||||
**依赖（单向）**：**强依赖卡④**（场景图素材定稿 + 五界面入口改挂）完成；卡④不依赖本条 ⇒ 排序在卡④之后。**与「营地美术素材怎么生成」无关联**（不影响出图／分层／提示词）。
|
||||
|
||||
**缺口**：① 窗口形态与叠层规则定稿（独立全屏页＝场景根隐藏／单一内页切换＝场景根留底）；② **窗口化＝场景根留底 ⇒ 会引出「背景要不要压暗／虚化」**，而该点撞上 art-bible §2（2026-10-22 缩窄后**仍禁情绪表达**，背景压暗属氛围表达仍在禁区）与卡④「缩放虚化禁批内自选」——**须在该批开工前一并裁掉**；③ 五界面各自的返回／关闭钮（卡④ v1.1 已承诺各带一个）。
|
||||
- 相关文档：卡④ §9 代拍板域 → 独立成批（呈现层＋文档线）；窗口形态与叠层规则写入 `LAYER_CONTRACT` 与 [camp](design/gdd/ux/camp.md)「叠层与开合」节
|
||||
|
||||
**归属**：卡④ §9 代拍板域 → 独立成批（呈现层 + 文档轨）；窗口形态与叠层规则写入 `LAYER_CONTRACT` 与 [camp](design/gdd/ux/camp.md)「叠层与开合」节
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### 验收闭合规则——下一次迭代实测评估（2026-10-21 登记，来源=审计发现，设计面=工程直入）
|
||||
#### 验收闭合规则——下一次迭代实测评估（2026-10-21 登记，来源=审计发现）
|
||||
|
||||
**现状**：2026-10-21 已改工作流技能与规约——[测试规范](design/engineering/test-conventions.md) 新增 §9（改动—验收对照表、真实入口、撤销证明、禁削弱、独立验收审计），[AGENTS.md](AGENTS.md) 硬性红线新增「验收闭合」，`req-card`／`iter`／`batch-closure` 三份技能同步，[流水线闸](tools/pipeline_gate.py) 新增 C3 卡片结构检查。规则文本已落地，还没在真实迭代上跑过。
|
||||
**实况**：2026-10-21 已改工作流技能与规约——[测试规范](design/engineering/test-conventions.md) 新增 §9（改动—验收对照表、真实入口、撤销证明、禁削弱、独立验收审计），[AGENTS.md](AGENTS.md) 硬性红线新增「验收闭合」，`req-card`／`iter`／`batch-closure` 三份技能同步，[流水线闸](tools/pipeline_gate.py) 新增 C3 卡片结构检查。规则文本已落地，还没在真实迭代上跑过。
|
||||
|
||||
**归属**：下一次迭代的实现批（按新规写卡、施工、审计）。本条目不是必做任务，是顺带观察项：该迭代跑完若没有出现验收缺漏、也没有误红，规则即视作通过，收尾时整条删除；只有实测发现缺漏或误红，才转成修订任务。
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待裁决
|
||||
|
||||
#### UI 贴图重构批——元进度件仍是程序化占位（2026-10-13 登记，来源=审计发现，设计面=美术轨）
|
||||
#### UI 贴图重构批——元进度件仍是程序化占位（2026-10-13 登记，来源=审计发现）
|
||||
|
||||
**现状**：营地的柜台场景贴图与元进度图标目前都是程序化画出来的临时形态，没有上贴图。这条债原先只写在美术侧的资产清单里（[美术资产清单](design/art/art-assets-checklist.md) 第 134 行与第 175 行，原文注明"营地现为程序化占位，状态记录 121⑧ 口径，排期归 UI 贴图重构批"），2026-10-13 由 UI 美化三层诊断转立本清单专条。规格其实已经定了——烛光黄 `#F6C667` 配木色 `#8A5A34`（见 [美术圣经](design/art/art-bible.md) §4.4），素材来源允许走"通用图标改色复用"这条低成本渠道。2026-10-21 用户裁营地交互重做五卡整体列入 Alpha：营地柜台贴图随之转入卡④营地场景图新建批（新场景取代现四柜台覆盖层），本条只余元进度件贴图终稿，排 Beta。
|
||||
**实况**：营地的柜台场景贴图与元进度图标目前都是程序化画出来的临时形态，没有上贴图。这条债原先只写在美术侧的资产清单里（[美术资产清单](design/art/art-assets-checklist.md) 第 134 行与第 175 行，原文注明"营地现为程序化占位，状态记录 121⑧ 口径，排期归 UI 贴图重构批"），2026-10-13 由 UI 美化三层诊断转立本清单专条。规格其实已经定了——烛光黄 `#F6C667` 配木色 `#8A5A34`（见 [美术圣经](design/art/art-bible.md) §4.4），素材来源允许走"通用图标改色复用"这条低成本渠道。2026-10-21 用户裁营地交互重做五卡整体列入 Alpha：营地柜台贴图随之转入卡④营地场景图新建批（新场景取代现四柜台覆盖层），本条只余元进度件贴图终稿，排 Beta。
|
||||
|
||||
**缺口**：还差一次「自己画 vs 找 CC0 素材改色」的美术裁决（见 [美术资产清单](design/art/art-assets-checklist.md) §0 的复用渠道闸），裁决后才能定素材工单写卡。
|
||||
|
||||
**归属**：UI 贴图重构批（美术线；须先裁决是自己画还是找 CC0 素材改色，两条备选见 [美术资产清单](design/art/art-assets-checklist.md) §0 的复用渠道闸）
|
||||
**改动面**：美术素材＋游戏代码
|
||||
|
||||
**状态**：待美术设计（备选）
|
||||
|
||||
#### 战斗一屏样张 P0 未开工——界面成品是否过审的那把尺子还没建（2026-10-13 登记，来源=审计发现，设计面=美术轨）
|
||||
#### 战斗一屏样张 P0 未开工——界面成品是否过审的那把尺子还没建（2026-10-13 登记，来源=审计发现）
|
||||
|
||||
**现状**：[美术圣经](design/art/art-bible.md) §7.1 明文写着"程序化占位＝临时态，任何屏的终稿闸＝§1.4 整屏样张过闸；占位态禁止跨里程碑"。而 [美术素材状态清单](design/art/art-status-checklist.md) 把「战斗一屏样张」这件最高优先级的素材标的是**未开始**——也就是说，**判定界面美术算不算过关的那把尺子到现在还没造出来**。2026-10-16 曾编入迭代 30 卡②（UI 呈现三卡批序位②），2026-10-17 用户裁定不满足「迭代＝代码实现批」的开发条件、剔除回待设计（理由＝样张交付物本身就是设计规格，正式字体与素材均未定稿；同日样张批开工已被用户终止）。v1.4 旧卡留 reports/需求卡片-战斗一屏样张批-2026-10-16.md 作素材，非已写卡状态，重启不得直接开工。Alpha 出口裁决：列入 Alpha 硬前置——站桩帧动画的定版前置与主角＋三 Boss 重产都依赖它。
|
||||
**实况**：[美术圣经](design/art/art-bible.md) §7.1 明文写着"程序化占位＝临时态，任何屏的终稿闸＝§1.4 整屏样张过闸；占位态禁止跨里程碑"。而 [美术素材状态清单](design/art/art-status-checklist.md) 把「战斗一屏样张」这件最高优先级的素材标的是**未开始**——也就是说，**判定界面美术算不算过关的那把尺子到现在还没造出来**。2026-10-16 曾编入迭代 30 卡②（UI 呈现三卡批序位②），2026-10-17 用户裁定不满足「迭代＝代码实现批」的开发条件、剔除回待设计（理由＝样张交付物本身就是设计规格，正式字体与素材均未定稿；同日样张批开工已被用户终止）。v1.4 旧卡留 reports/需求卡片-战斗一屏样张批-2026-10-16.md 作素材，非已写卡状态，重启不得直接开工。Alpha 出口裁决：列入 Alpha 硬前置——站桩帧动画的定版前置与主角＋三 Boss 重产都依赖它。
|
||||
|
||||
**缺口**：还差「设计讨论→需求澄清→美术定稿」一轮设计（样张即设计目标图，产出尺寸档/色板/明度档清单反向给素材批），定稿后重新立卡方可开发。旧卡 v1.4（reports/需求卡片-战斗一屏样张批-2026-10-16.md）在册但非已写卡状态，其前置未完成三件：①这一轮设计未做，样张的目标规格清单没有来源；②战斗一屏所需素材未定稿（前置里的正式字体半边已定稿——2026-10-24 用户裁 Fusion Pixel 单套即终稿，见 [美术圣经](design/art/art-bible.md) §7.4）；③2026-10-17 用户已终止该批开工，重启须重新立卡。
|
||||
- 相关文档：美术线（战斗一屏样张的验收标准归 [战斗表现](design/gdd/systems/战斗循环/战斗表现.md) 与 [美术圣经](design/art/art-bible.md) §5.1 共裁）
|
||||
|
||||
**归属**：美术线（战斗一屏样张的验收标准归 [战斗表现](design/gdd/systems/战斗循环/战斗表现.md) 与 [美术圣经](design/art/art-bible.md) §5.1 共裁）
|
||||
**改动面**：美术素材
|
||||
|
||||
**状态**：待美术设计
|
||||
|
||||
#### UI 氛围层与九宫格切片观感修——光柱硬边与面板切片错位（2026-10-13 登记，来源=审计发现，设计面=美术轨）
|
||||
#### UI 氛围层与九宫格切片观感修——光柱硬边与面板切片错位（2026-10-13 登记，来源=审计发现）
|
||||
|
||||
**现状**：原两处，一处已修一处存续。①光柱硬边**已修**（2026-10-14 迭代 26 T4：`ui_kit.gd` 第 263 行起的光柱贴片改带内 alpha 0→0.05→0 三角过渡＋纵向衰减上亮下暗，grilling Q7 裁连续 alpha 方案；LINEAR 白名单已随反哺入册 art-bible v3.14 §8.2）。②九宫格切片错位**存续**——结算屏与图例屏的面板边缘可见错位小方块，成因是九宫格切片参数与素材尺寸不匹配（仪式石框 258 字节小图按 12 像素切片、石板亮面板 314 字节按 16 像素切片，铺到四百多像素宽面板中段拉出错位），须先核素材尺寸能否撑住新切片值（border_stone/panel_stone 均 48×48），可能要重出素材，归「UI 贴图重构批」后续贴图批次。
|
||||
**实况**：原两处，一处已修一处存续。①光柱硬边**已修**（2026-10-14 迭代 26 T4：`ui_kit.gd` 第 263 行起的光柱贴片改带内 alpha 0→0.05→0 三角过渡＋纵向衰减上亮下暗，grilling Q7 裁连续 alpha 方案；LINEAR 白名单已随反哺入册 art-bible v3.14 §8.2）。②九宫格切片错位**存续**——结算屏与图例屏的面板边缘可见错位小方块，成因是九宫格切片参数与素材尺寸不匹配（仪式石框 258 字节小图按 12 像素切片、石板亮面板 314 字节按 16 像素切片，铺到四百多像素宽面板中段拉出错位），须先核素材尺寸能否撑住新切片值（border_stone/panel_stone 均 48×48），可能要重出素材，归「UI 贴图重构批」后续贴图批次。
|
||||
|
||||
**缺口**：还差「UI 贴图重构批」里的素材尺寸核对与「是否重出素材」裁决，才能定切片修法。
|
||||
|
||||
**归属**：呈现层表现批（光柱纯改代码〔已修〕；九宫格切片需连带核对素材尺寸能否撑住新切片值，可能要重出素材，属美术线连带面）
|
||||
**改动面**：美术素材＋游戏代码
|
||||
|
||||
**状态**：待美术设计
|
||||
|
||||
#### 旧行为 MC 行为锚全数作废——重锚归数值批（2026-10-06 登记，来源=批次移交，设计面=文档轨）
|
||||
#### 旧行为 MC 行为锚全数作废——重锚归数值批（2026-10-06 登记，来源=批次移交）
|
||||
|
||||
**现状**：案C 地图伤害账殿后批（git 7ef18ac，状态记录 371）改变每轮结算行为序——授予段不再兑付任何伤害（伤害形态单据暂存至战斗段末，段内序＝主角先手→逐敌还手→地图账），既有全部 MC 行为锚与基线逐项比对锚所锚行为已不存在，**全数作废**；新段内序断言已入冒烟闸。按 sim-data MC 缓存层规则（无数值调整禁重跑），重锚不在改动批执行；重锚前一切 MC 旧读数只作历史存档，禁止与新行为逐项比对。M4 数值批卡 v1.2 已收该义务（F19：对拍锚按案C 新序重推导、T6 四带复算按新行为首采立新锚）。
|
||||
**实况**：案C 地图伤害账殿后批（git 7ef18ac，状态记录 371）改变每轮结算行为序——授予段不再兑付任何伤害（伤害形态单据暂存至战斗段末，段内序＝主角先手→逐敌还手→地图账），既有全部 MC 行为锚与基线逐项比对锚所锚行为已不存在，**全数作废**；新段内序断言已入冒烟闸。按 sim-data MC 缓存层规则（无数值调整禁重跑），重锚不在改动批执行；重锚前一切 MC 旧读数只作历史存档，禁止与新行为逐项比对。M4 数值批卡 v1.2 已收该义务（F19：对拍锚按案C 新序重推导、T6 四带复算按新行为首采立新锚）。
|
||||
|
||||
**缺口**：M4 数值批卡片已随 2026-10-16 删卡令退役；2026-10-18 用户裁＝本条留待办清单、未设计未启动、不另行归属，未来数值标定窗口重开时重走设计段再写卡。
|
||||
|
||||
**归属**：M-4 数值批（用户 2026-10-06 确认此为影响数值难度的重要变量）。
|
||||
**改动面**：文档＋游戏代码
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### 双层 BD 延期与备选内容总登记（2026-10-03 登记，来源=批次移交，设计面=文档轨）
|
||||
#### 双层 BD 延期与备选内容总登记（2026-10-03 登记，来源=批次移交）
|
||||
|
||||
**现状**：需求卡片/整合定稿系中间文档，落地完成后按吸收即死退役——用户令「只删除已完成落地的内容」，本条自承载全部**未落地**内容防丢失（每项自包含，不依赖指针）。
|
||||
**实况**：需求卡片/整合定稿系中间文档，落地完成后按吸收即死退役——用户令「只删除已完成落地的内容」，本条自承载全部**未落地**内容防丢失（每项自包含，不依赖指针）。
|
||||
|
||||
**二期件组**（触发＝迭代 12 出口读数+用户点名立项；各件机制形态已定，数值 provisional）：
|
||||
- **战斗→扫雷跨阶段回流**（穿刺流）：击杀轻甲敌人返还 1 AP——战斗收益反哺开格动机；AP 经济新管道，谨慎件（威胁红线③边缘，立项须专项论证）
|
||||
@@ -181,296 +159,316 @@
|
||||
|
||||
**缺口**：全组为备选库：各件启用须用户发令立项，届时按件走设计讨论定机制形态与数值（二期件组机制形态已定、数值 provisional；R4 乙组重启属红线变更须用户发起）。
|
||||
|
||||
**归属**：备选库总登记（本条自承载；组内各件启用时按内容归专长重设计扩充批／秘宝内容批／商店 spec／战斗结算等对应批）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计（备选）
|
||||
|
||||
#### 扩展节点类型——危险/精英节点与特殊地形节点（2026-10-21 登记，来源=会话提及，设计面=文档轨）
|
||||
#### 扩展节点类型——危险/精英节点与特殊地形节点（2026-10-21 登记，来源=会话提及）
|
||||
|
||||
**现状**：用户 2026-10-21 会话定方向：Alpha 版只留现行四类（战斗/奖励/恢复/商店），以下两类留到以后再做——①危险/精英节点（怪物与普通战斗不同、奖励肥）；②特殊地形节点（效果修饰：地图战斗资源、敌我伤害、金币比例等）。内容未设计。
|
||||
**实况**：用户 2026-10-21 会话定方向：Alpha 版只留现行四类（战斗/奖励/恢复/商店），以下两类留到以后再做——①危险/精英节点（怪物与普通战斗不同、奖励肥）；②特殊地形节点（效果修饰：地图战斗资源、敌我伤害、金币比例等）。内容未设计。
|
||||
|
||||
关联文档清单：
|
||||
- 相关文档 design/gdd/systems/冒险循环/关卡节点图生成.md v1.1（2026-10-21，扩展节点类型位概念）
|
||||
|
||||
**缺口**：两类扩展节点的机制形态与数值未设计（用户明示暂不进 Alpha）。
|
||||
|
||||
**归属**：[关卡节点图生成](design/gdd/systems/冒险循环/关卡节点图生成.md)（扩展节点类型位＋配比）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计（备选）
|
||||
|
||||
#### 天赋树实装批登记欠账余两件——AP 上限 clamp 与三选一刷新软上限（2026-10-12 登记，来源=批次移交，设计面=文档轨）
|
||||
#### 天赋树实装批登记欠账余两件——AP 上限 clamp 与三选一刷新软上限（2026-10-12 登记，来源=批次移交）
|
||||
|
||||
**现状**：迭代 21 天赋树实装批顺带入册欠账三条，2026-10-13 三件终态：① **AP 上限 clamp 缺位（缺陷）**——树「开局姿态」（每关首轮 AP+1）、AP 件、时沙同走 `action_economy.gd:239 _pending_ap_delta` 排队，轮始兑现仅下限钳制（`:254 maxi(0, …)`，无上限）；**用户裁暂不设上限**——provisional 天花板亦不投，随未来数值标定窗口连同全部 AP 数值统一标定（M4 数值批已废）。② **三选一刷新软上限（设计问）**——停点内 GP 付费刷新倍率增长（×1.8/次曲线）×停点间基础价随进度递增，全程无软上限；**定性确认＝设计问非缺陷，用户裁维持现状**，归未来数值标定窗口处理，不提前单开讨论。③ **Y（_attune_refresh_y）不入断点存档（可利用漏洞）**——已修复注销（2026-10-13 用户令提前单独开修：断点快照扩列 `attune_refresh_y`＋续玩 `resume_adventure` 优先读断点〔缺键回退参数面＝旧档行为零变化〕＋单测两断言；冒烟 938/0+单测 24 套全绿）。①②留待办清单待未来数值标定窗口（M4 数值批已废；2026-10-18 用户裁＝不另行归属、未设计未启动）。
|
||||
**实况**：迭代 21 天赋树实装批顺带入册欠账三条，2026-10-13 三件终态：① **AP 上限 clamp 缺位（缺陷）**——树「开局姿态」（每关首轮 AP+1）、AP 件、时沙同走 `action_economy.gd:239 _pending_ap_delta` 排队，轮始兑现仅下限钳制（`:254 maxi(0, …)`，无上限）；**用户裁暂不设上限**——provisional 天花板亦不投，随未来数值标定窗口连同全部 AP 数值统一标定（M4 数值批已废）。② **三选一刷新软上限（设计问）**——停点内 GP 付费刷新倍率增长（×1.8/次曲线）×停点间基础价随进度递增，全程无软上限；**定性确认＝设计问非缺陷，用户裁维持现状**，归未来数值标定窗口处理，不提前单开讨论。③ **Y（_attune_refresh_y）不入断点存档（可利用漏洞）**——已修复注销（2026-10-13 用户令提前单独开修：断点快照扩列 `attune_refresh_y`＋续玩 `resume_adventure` 优先读断点〔缺键回退参数面＝旧档行为零变化〕＋单测两断言；冒烟 938/0+单测 24 套全绿）。①②留待办清单待未来数值标定窗口（M4 数值批已废；2026-10-18 用户裁＝不另行归属、未设计未启动）。
|
||||
|
||||
**缺口**：还差未来数值标定窗口的标定执行（M4 数值批已废；2026-10-18 用户裁＝本条留待办清单、未设计未启动、不另行归属）。
|
||||
- 相关文档：① [行动经济](design/gdd/systems/排雷循环/行动经济.md)；② 行动经济+三选一/商店刷新经济（数值归未来数值标定窗口——M4 数值批已废）；③ [存档序列化](design/gdd/systems/表现与支撑/存档序列化.md)（断点域）+ [冒险结构](design/gdd/systems/冒险循环/冒险结构.md)（续玩参数面）——③已修复注销
|
||||
|
||||
**归属**：① [行动经济](design/gdd/systems/排雷循环/行动经济.md)；② 行动经济+三选一/商店刷新经济（数值归未来数值标定窗口——M4 数值批已废）；③ [存档序列化](design/gdd/systems/表现与支撑/存档序列化.md)（断点域）+ [冒险结构](design/gdd/systems/冒险循环/冒险结构.md)（续玩参数面）——③已修复注销
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### 棋盘战斗键盘/手柄输入（2026-10-04 登记，来源=会话提及，设计面=文档轨）
|
||||
#### 棋盘战斗键盘/手柄输入（2026-10-04 登记，来源=会话提及）
|
||||
|
||||
**现状**：战斗棋盘操作现行唯一输入＝鼠标——左键已开格＝移动/未开格＝挖掘，右键＝封印（封印印记一次性承诺，无移除手段），悬停承载合法性反馈（可挖域微光 + BFS 路径点迹）；全仓无 InputEventKey/JoypadButton 处理，project.godot 无自定义 InputMap 动作。**可行性已核（2026-10-04）：可做**——分发接缝现成，board_view `action_requested(cell, kind)`（kind ∈ {dig, move, flag_place, flag_pull}）是唯一出口，键盘/手柄作第二输入前端产出同款信号即可，规则引擎合法性校验零改动；Godot InputMap 原生支持键盘与手柄绑定同一动作，与鼠标并存不冲突。用户期望操作形态：十字方向移动；挖掘/封印各一独立键；方向控制选定 8 向挖掘或封印目标（8 向恰与现行可挖域同集，十字移动与立绘 4 向既有裁决一致）；键盘移动语义＝逐格步进。连带设计点四条（实施批先裁）：① 键盘模式需屏上光标格承载现行悬停反馈；② 键盘默认键位与手柄键位映射待定；③ 弹层界面（结算/三选一/商店/设置等）现行全鼠标，手柄全覆盖需焦点导航——是否同批待裁（2026-10-06 增补：暂停层〔现状态面板〕Esc 快捷通道并入本条随键盘批统一实施，弹层清单 +1 项）；④ 键位自定义是否进设置面待裁。排期 Beta（2026-10-04 登记；可行性已核毕，立项时按 roadmap 开卡）。
|
||||
**实况**：战斗棋盘操作现行唯一输入＝鼠标——左键已开格＝移动/未开格＝挖掘，右键＝封印（封印印记一次性承诺，无移除手段），悬停承载合法性反馈（可挖域微光 + BFS 路径点迹）；全仓无 InputEventKey/JoypadButton 处理，project.godot 无自定义 InputMap 动作。**可行性已核（2026-10-04）：可做**——分发接缝现成，board_view `action_requested(cell, kind)`（kind ∈ {dig, move, flag_place, flag_pull}）是唯一出口，键盘/手柄作第二输入前端产出同款信号即可，规则引擎合法性校验零改动；Godot InputMap 原生支持键盘与手柄绑定同一动作，与鼠标并存不冲突。用户期望操作形态：十字方向移动；挖掘/封印各一独立键；方向控制选定 8 向挖掘或封印目标（8 向恰与现行可挖域同集，十字移动与立绘 4 向既有裁决一致）；键盘移动语义＝逐格步进。连带设计点四条（实施批先裁）：① 键盘模式需屏上光标格承载现行悬停反馈；② 键盘默认键位与手柄键位映射待定；③ 弹层界面（结算/三选一/商店/设置等）现行全鼠标，手柄全覆盖需焦点导航——是否同批待裁（2026-10-06 增补：暂停层〔现状态面板〕Esc 快捷通道并入本条随键盘批统一实施，弹层清单 +1 项）；④ 键位自定义是否进设置面待裁。排期 Beta（2026-10-04 登记；可行性已核毕，立项时按 roadmap 开卡）。
|
||||
|
||||
**缺口**：还差 Beta 立项时的输入方案设计讨论——四个连带裁决点（光标反馈承载/键位映射/弹层焦点导航范围/键位自定义）先裁再开卡。
|
||||
- 相关文档：[排雷玩法](design/gdd/systems/排雷循环/排雷玩法.md)（动作语义与 8 向目标规则主责）+ [HUD 框架](design/gdd/systems/表现与支撑/HUD框架.md)（键盘光标与合法性反馈呈现）+ [设置与本地化](design/gdd/systems/表现与支撑/设置与本地化.md)（键位自定义，可选面）
|
||||
|
||||
**归属**：[排雷玩法](design/gdd/systems/排雷循环/排雷玩法.md)（动作语义与 8 向目标规则主责）+ [HUD 框架](design/gdd/systems/表现与支撑/HUD框架.md)（键盘光标与合法性反馈呈现）+ [设置与本地化](design/gdd/systems/表现与支撑/设置与本地化.md)（键位自定义，可选面）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### 技能池情境条件触发器（2026-10-18 登记，来源=会话提及，设计面=文档轨）
|
||||
#### 技能池情境条件触发器（2026-10-18 登记，来源=会话提及）
|
||||
|
||||
**现状**：低血触发防御、玩家停手时的偷袭技等情境出招——载体＝技能行触发条件字段（P1 字段位已预留）；启用是敌人系统修订，不是调参。（原条目无登记日期，按本批格式整改补登 2026-10-18。）
|
||||
**实况**：低血触发防御、玩家停手时的偷袭技等情境出招——载体＝技能行触发条件字段（P1 字段位已预留）；启用是敌人系统修订，不是调参。（原条目无登记日期，按本批格式整改补登 2026-10-18。）
|
||||
|
||||
**缺口**：还差敌人系统修订的设计讨论——情境触发器的条件形态、字段语义与首批触发器清单。
|
||||
- 相关文档：[敌人系统](design/gdd/systems/战斗循环/敌人系统.md)（P1）
|
||||
|
||||
**归属**：[敌人系统](design/gdd/systems/战斗循环/敌人系统.md)（P1）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### 个体化变体池（2026-10-18 登记，来源=会话提及，设计面=文档轨）
|
||||
#### 个体化变体池（2026-10-18 登记，来源=会话提及）
|
||||
|
||||
**现状**：A 型好斗/ B 型守势、精英专属池（技能池共识点 A 的 A2 案）；现行同敌种同池模板，实例分歧只来自摇号涌现。（原条目无登记日期，按本批格式整改补登 2026-10-18。）
|
||||
**实况**：A 型好斗/ B 型守势、精英专属池（技能池共识点 A 的 A2 案）；现行同敌种同池模板，实例分歧只来自摇号涌现。（原条目无登记日期，按本批格式整改补登 2026-10-18。）
|
||||
|
||||
**缺口**：还差敌人系统的变体池设计讨论——A2 案的池构成方案与精英专属池边界。
|
||||
- 相关文档：[敌人系统](design/gdd/systems/战斗循环/敌人系统.md)（P1）
|
||||
|
||||
**归属**：[敌人系统](design/gdd/systems/战斗循环/敌人系统.md)（P1）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### 全局特殊间隔旋钮（2026-10-18 登记，来源=会话提及，设计面=文档轨）
|
||||
#### 全局特殊间隔旋钮（2026-10-18 登记，来源=会话提及）
|
||||
|
||||
**现状**：异名特殊技背靠背现行概率低（是变化不是失控）；若实测仍嫌，备用闸＝全局「特殊技后至少隔 N 拍」——登记备用，未实测不启用。（原条目无登记日期，按本批格式整改补登 2026-10-18。）
|
||||
**实况**：异名特殊技背靠背现行概率低（是变化不是失控）；若实测仍嫌，备用闸＝全局「特殊技后至少隔 N 拍」——登记备用，未实测不启用。（原条目无登记日期，按本批格式整改补登 2026-10-18。）
|
||||
|
||||
**缺口**：还差备用闸的条款设计（N 值与作用域）——仅当实测读数支持时才启动讨论。
|
||||
- 相关文档：[敌人系统](design/gdd/systems/战斗循环/敌人系统.md) 与[难度曲线与Boss](design/gdd/systems/冒险循环/难度曲线与Boss.md)（P1）
|
||||
|
||||
**归属**：[敌人系统](design/gdd/systems/战斗循环/敌人系统.md) 与[难度曲线与Boss](design/gdd/systems/冒险循环/难度曲线与Boss.md)（P1）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计（备选）
|
||||
|
||||
#### 敌方技能图鉴 / 学习呈现（2026-10-18 登记，来源=会话提及，设计面=文档轨）
|
||||
#### 敌方技能图鉴 / 学习呈现（2026-10-18 登记，来源=会话提及）
|
||||
|
||||
**现状**：池与权重不公开（D4/D5）口径下的进阶信息面——玩家侧技能知识系统（见过 → 认得 → 记谱）；首发三池学习成本低，后置（P2）。（原条目无登记日期，按本批格式整改补登 2026-10-18。）
|
||||
**实况**：池与权重不公开（D4/D5）口径下的进阶信息面——玩家侧技能知识系统（见过 → 认得 → 记谱）；首发三池学习成本低，后置（P2）。（原条目无登记日期，按本批格式整改补登 2026-10-18。）
|
||||
|
||||
**缺口**：还差玩家侧技能知识系统的呈现设计讨论（HUD 承载形态与记谱口径），P2 后置面。
|
||||
- 相关文档：[HUD 框架](design/gdd/systems/表现与支撑/HUD框架.md) 与[敌人系统](design/gdd/systems/战斗循环/敌人系统.md)（P2）
|
||||
|
||||
**归属**：[HUD 框架](design/gdd/systems/表现与支撑/HUD框架.md) 与[敌人系统](design/gdd/systems/战斗循环/敌人系统.md)（P2）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### 削弱档位的最终数值（2026-09-18 登记，来源=会话提及，设计面=文档轨）
|
||||
#### 削弱档位的最终数值（2026-09-18 登记，来源=会话提及）
|
||||
|
||||
**现状**：削弱取值域 [60,85] 与投值 −65 来自旧体系裁决；"封印标中必须比随便挖一格更值"的当量终值由[战斗结算](design/gdd/systems/战斗循环/战斗结算.md)与[地图战斗资源](design/gdd/systems/战斗循环/地图战斗资源.md)共裁。**语义侧已定案（2026-09-18 盘问会话，结构修复批落地）**：削弱叠层改续时——同名重复授予只刷新剩余结算数、层数恒 1（结构性消饱和）；现行表值为临时值（provisional）。已入 M4 数值批卡 v1.2 件①（duration 终值投定＋当量锚复算落文；含 β 带 [1.2,2.5] 可行子区间推算、flag_hit_premium=125 纳入同窗检算、`clear_dominance_audit.py` WEAKEN_PCT 常量随投值同步）；2026-10-05 裁点已全裁并经同日联审二裁修订（P1甲/P2甲/P3甲/P4甲），跑批待 U0 用户发令、发起前须用户批准。
|
||||
**实况**：削弱取值域 [60,85] 与投值 −65 来自旧体系裁决；"封印标中必须比随便挖一格更值"的当量终值由[战斗结算](design/gdd/systems/战斗循环/战斗结算.md)与[地图战斗资源](design/gdd/systems/战斗循环/地图战斗资源.md)共裁。**语义侧已定案（2026-09-18 盘问会话，结构修复批落地）**：削弱叠层改续时——同名重复授予只刷新剩余结算数、层数恒 1（结构性消饱和）；现行表值为临时值（provisional）。已入 M4 数值批卡 v1.2 件①（duration 终值投定＋当量锚复算落文；含 β 带 [1.2,2.5] 可行子区间推算、flag_hit_premium=125 纳入同窗检算、`clear_dominance_audit.py` WEAKEN_PCT 常量随投值同步）；2026-10-05 裁点已全裁并经同日联审二裁修订（P1甲/P2甲/P3甲/P4甲），跑批待 U0 用户发令、发起前须用户批准。
|
||||
|
||||
**缺口**：M4 数值批卡片已随 2026-10-16 删卡令退役；2026-10-18 用户裁＝本条留待办清单、未设计未启动、不另行归属，未来数值标定窗口重开时重走设计段再写卡。
|
||||
|
||||
**归属**：战斗结算与地图战斗资源共裁（数值终值归状态层重设计批）——执行载体待未来数值标定窗口重开时重定（M4 数值批已废）
|
||||
**改动面**：文档＋游戏代码
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### 单体寻址的接口扩展位（2026-10-18 登记，来源=会话提及，设计面=文档轨）
|
||||
#### 单体寻址的接口扩展位（2026-10-18 登记，来源=会话提及）
|
||||
|
||||
**现状**：对敌效果现行一律全体存活敌人共享一份层数；将来若要"只削弱其中一个"，需要给实例加目标寻址字段——扩展位已预留，首个单体效果上线时补列，并随之裁决归集与呈现语义。（原条目无登记日期，按本批格式整改补登 2026-10-18。）
|
||||
**实况**：对敌效果现行一律全体存活敌人共享一份层数；将来若要"只削弱其中一个"，需要给实例加目标寻址字段——扩展位已预留，首个单体效果上线时补列，并随之裁决归集与呈现语义。（原条目无登记日期，按本批格式整改补登 2026-10-18。）
|
||||
|
||||
**缺口**：还差首个单体效果上线时的归集与呈现语义设计讨论与字段补列方案。
|
||||
|
||||
**归属**：增益状态（首个单体效果上线时顺带）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计（备选）
|
||||
|
||||
#### 空刷新的可见性（2026-10-18 登记，来源=会话提及，设计面=文档轨）
|
||||
#### 空刷新的可见性（2026-10-18 登记，来源=会话提及）
|
||||
|
||||
**现状**：刷新类策略在剩余次数已满时再授予是合法空操作（返回成功、无任何变化），与"溢出不静默吞"的诚实原则存在张力；MVP 无刷新类内容行，首批刷新行上线时顺带裁决。（原条目无登记日期，按本批格式整改补登 2026-10-18。）
|
||||
**实况**：刷新类策略在剩余次数已满时再授予是合法空操作（返回成功、无任何变化），与"溢出不静默吞"的诚实原则存在张力；MVP 无刷新类内容行，首批刷新行上线时顺带裁决。（原条目无登记日期，按本批格式整改补登 2026-10-18。）
|
||||
|
||||
**缺口**：还差首批刷新行上线时的空刷新语义裁决（提示形态与诚实原则的平衡）。
|
||||
|
||||
**归属**：增益状态（首批刷新行上线时顺带）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计（备选）
|
||||
|
||||
#### 冒险前资源配比预设（构筑提案）（2026-09-18 登记，来源=会话提及，设计面=文档轨）
|
||||
#### 冒险前资源配比预设（构筑提案）（2026-09-18 登记，来源=会话提及）
|
||||
|
||||
**现状**：构筑提案 2026-09-18 立项、八项裁决全裁（2026-10-04），设计闭合机制＝[元进度](design/gdd/systems/跨局循环/元进度.md)「冒险开始参数面与覆盖值通道」（零新机制）；2026-10-05 挂起——移出 roadmap 迭代 14，八项裁决与需求卡片冻结保留，重启须用户另行发令；全案与淘汰依据原载已退役提案（git 历史可考），裁决细节冻结在卡片。关联文档：[元进度](design/gdd/systems/跨局循环/元进度.md) v1.0（闭合凭据；现行 v1.21 已复核在役，2026-10-18 文档体检第 10 项）；需求卡片 reports/需求卡片-冒险前资源配比预设批-2026-10-04.md（文件头挂冻结横幅）。
|
||||
**实况**：构筑提案 2026-09-18 立项、八项裁决全裁（2026-10-04），设计闭合机制＝[元进度](design/gdd/systems/跨局循环/元进度.md)「冒险开始参数面与覆盖值通道」（零新机制）；2026-10-05 挂起——移出 roadmap 迭代 14，八项裁决与需求卡片冻结保留，重启须用户另行发令；全案与淘汰依据原载已退役提案（git 历史可考），裁决细节冻结在卡片。关联文档：[元进度](design/gdd/systems/跨局循环/元进度.md) v1.0（闭合凭据；现行 v1.21 已复核在役，2026-10-18 文档体检第 10 项）；需求卡片 reports/需求卡片-冒险前资源配比预设批-2026-10-04.md（文件头挂冻结横幅）。
|
||||
- 相关文档：[地图战斗资源](design/gdd/systems/战斗循环/地图战斗资源.md)修订批（基础配比的权重覆盖语义 + GDD 修订）与[元进度](design/gdd/systems/跨局循环/元进度.md)（解锁容量与注入生产者）共裁；呈现面归[HUD 框架](design/gdd/systems/表现与支撑/HUD框架.md)与[教学引导](design/gdd/systems/表现与支撑/教学引导.md)顺带。
|
||||
|
||||
**归属**：[地图战斗资源](design/gdd/systems/战斗循环/地图战斗资源.md)修订批（基础配比的权重覆盖语义 + GDD 修订）与[元进度](design/gdd/systems/跨局循环/元进度.md)（解锁容量与注入生产者）共裁；呈现面归[HUD 框架](design/gdd/systems/表现与支撑/HUD框架.md)与[教学引导](design/gdd/systems/表现与支撑/教学引导.md)顺带。
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：文档设计已闭合＋已写卡（备选）
|
||||
|
||||
#### GP 经济换算失衡——GP 袋面值与商店价格的换算关系复查（2026-10-07 登记，来源=审计发现，设计面=文档轨）
|
||||
#### GP 经济换算失衡——GP 袋面值与商店价格的换算关系复查（2026-10-07 登记，来源=审计发现）
|
||||
|
||||
**现状**：道具三层审查的换算发现——小 GP 袋 20 ≈ 商店两三次首购（首购基价 4-5、A 链爬升前）≈ +2~4 点属性，而小攻击件只值 +1——「拿钱」在三选一面里经常比「拿数值」划算，且 GP 袋是池内最大户（23/98 张）进一步放大倾向。用户判「太离谱」。复查范围＝GP 袋面值（20/50）× 商店基价（4/4/4/5）× 价格曲线（A=1.8 / b=1.1）× 战斗 GP 掉落（普通 3 / 精英 5 / Boss 8，关级加值 0/1/2）四处联动；目标＝钱与属性件的换算效率回到设计意图（拿钱 vs 拿数值的取舍成立；GP 袋最大户地位要么有理由要么让位）。连带前提：L1 无商店节点使 GP 在第一关无消费口——「L1 商店编排」不另立条目、归本条复查范围（按 L1 是否补商店分两种情形各算一遍）。留待办清单待未来数值标定窗口（M4 数值批已废；2026-10-18 用户裁＝不另行归属、未设计未启动）。
|
||||
**实况**：道具三层审查的换算发现——小 GP 袋 20 ≈ 商店两三次首购（首购基价 4-5、A 链爬升前）≈ +2~4 点属性，而小攻击件只值 +1——「拿钱」在三选一面里经常比「拿数值」划算，且 GP 袋是池内最大户（23/98 张）进一步放大倾向。用户判「太离谱」。复查范围＝GP 袋面值（20/50）× 商店基价（4/4/4/5）× 价格曲线（A=1.8 / b=1.1）× 战斗 GP 掉落（普通 3 / 精英 5 / Boss 8，关级加值 0/1/2）四处联动；目标＝钱与属性件的换算效率回到设计意图（拿钱 vs 拿数值的取舍成立；GP 袋最大户地位要么有理由要么让位）。连带前提：L1 无商店节点使 GP 在第一关无消费口——「L1 商店编排」不另立条目、归本条复查范围（按 L1 是否补商店分两种情形各算一遍）。留待办清单待未来数值标定窗口（M4 数值批已废；2026-10-18 用户裁＝不另行归属、未设计未启动）。
|
||||
|
||||
**缺口**：还差四处联动的换算复查设计（含 L1 商店编排两种情形）——随未来数值标定窗口执行（M4 数值批已废，留待办清单未设计未启动）。
|
||||
- 相关文档：[难度曲线与Boss](design/gdd/systems/冒险循环/难度曲线与Boss.md)调参批（未来数值标定窗口）+ 奇物池结构顺带
|
||||
|
||||
**归属**：[难度曲线与Boss](design/gdd/systems/冒险循环/难度曲线与Boss.md)调参批（未来数值标定窗口）+ 奇物池结构顺带
|
||||
**改动面**：文档＋游戏代码
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### 迭代 10 奖励重构联动欠账（2026-10-01 登记，来源=批次移交，设计面=文档轨）
|
||||
#### 迭代 10 奖励重构联动欠账（2026-10-01 登记，来源=批次移交）
|
||||
|
||||
**现状**：迭代 10 奖励重构批（worktree 分支 m3-iter10-20261001）落地面产生三条后续义务——①钥石产出重标：渠道改「Boss/精英击杀掉落」（大奖励 keystone_per_level 退役、boss_keystone 重锚 provisional），现行元进度产出结构作废，标定义务重开；②通关率带重扫：通关回血 20%（血回满→部分回血，难度上压方向）+ 三选一件值/权重/次数上限 knob（AP 件＝每场战斗首轮 +1 AP 强度敏感轴）；③同调位读数源切换——**已清偿（2026-10-03 迭代 11 第①批 T7**：过渡键表/schema/断言三处退役，读取点归零，现行事实源＝Attunement.slots 谓词表实时求值）。①②已入 M4 数值批卡 v1.2 件③（F7/F8；通关率带重扫与 T6 四带复算并账、一次跑批双认账），跑批待 U0 用户发令、发起前须用户批准。
|
||||
**实况**：迭代 10 奖励重构批（worktree 分支 m3-iter10-20261001）落地面产生三条后续义务——①钥石产出重标：渠道改「Boss/精英击杀掉落」（大奖励 keystone_per_level 退役、boss_keystone 重锚 provisional），现行元进度产出结构作废，标定义务重开；②通关率带重扫：通关回血 20%（血回满→部分回血，难度上压方向）+ 三选一件值/权重/次数上限 knob（AP 件＝每场战斗首轮 +1 AP 强度敏感轴）；③同调位读数源切换——**已清偿（2026-10-03 迭代 11 第①批 T7**：过渡键表/schema/断言三处退役，读取点归零，现行事实源＝Attunement.slots 谓词表实时求值）。①②已入 M4 数值批卡 v1.2 件③（F7/F8；通关率带重扫与 T6 四带复算并账、一次跑批双认账），跑批待 U0 用户发令、发起前须用户批准。
|
||||
|
||||
**缺口**：M4 数值批卡片已随 2026-10-16 删卡令退役；2026-10-18 用户裁＝本条留待办清单、未设计未启动、不另行归属，未来数值标定窗口重开时重走设计段再写卡。
|
||||
|
||||
**归属**：①元进度设计批 + 曲线调参批 ②曲线调参批（现行窗） ③秘宝同调实施批（已清偿 2026-10-03）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### 调参批数值点评登记（2026-10-01 登记，来源=批次移交，设计面=文档轨）
|
||||
#### 调参批数值点评登记（2026-10-01 登记，来源=批次移交）
|
||||
|
||||
**现状**：格面资源八型批后顺带登记的数值点评——① 增伤型奖励/惩罚幅度 50/25 不对称是否有意；② 削弱型 65/25 同问（且 percent 套个位数取整偏粗）；③ 回血奖励过薄（值 1、权重全池最低 2）；④ 警觉/行动点修正两新词数值全部 provisional；⑤ 行动经济"满停一轮＝一刷"节拍在 AP±1 修正下的对账——①-⑤五条已入 M4 数值批卡 v1.2 件②（F5，逐条裁决落文）；⑥ **格面资源正负兑付倍率差回调（2026-10-07 用户裁）**——2026-10-01「踩雷必须痛」抬档（heal +2/−6、pierce/magic +2/−8 等，负向 3-4 倍于正向）系错误的加难杠杆：难度提升应走怪物性能路线而非抬地图惩罚，回调归未来数值标定窗口（M4 数值批已废），标错/开雷同档同罚维持不动（同批裁）；⑥连同本条整体留待办清单未设计未启动（2026-10-18 用户裁）。里程碑立规（2026-10-09）：M4＝Beta 阶段、M3 未由用户明令关闭前不排期。
|
||||
**实况**：格面资源八型批后顺带登记的数值点评——① 增伤型奖励/惩罚幅度 50/25 不对称是否有意；② 削弱型 65/25 同问（且 percent 套个位数取整偏粗）；③ 回血奖励过薄（值 1、权重全池最低 2）；④ 警觉/行动点修正两新词数值全部 provisional；⑤ 行动经济"满停一轮＝一刷"节拍在 AP±1 修正下的对账——①-⑤五条已入 M4 数值批卡 v1.2 件②（F5，逐条裁决落文）；⑥ **格面资源正负兑付倍率差回调（2026-10-07 用户裁）**——2026-10-01「踩雷必须痛」抬档（heal +2/−6、pierce/magic +2/−8 等，负向 3-4 倍于正向）系错误的加难杠杆：难度提升应走怪物性能路线而非抬地图惩罚，回调归未来数值标定窗口（M4 数值批已废），标错/开雷同档同罚维持不动（同批裁）；⑥连同本条整体留待办清单未设计未启动（2026-10-18 用户裁）。里程碑立规（2026-10-09）：M4＝Beta 阶段、M3 未由用户明令关闭前不排期。
|
||||
|
||||
**缺口**：M4 数值批卡片已随 2026-10-16 删卡令退役；2026-10-18 用户裁＝本条留待办清单、未设计未启动、不另行归属，未来数值标定窗口重开时重走设计段再写卡。
|
||||
- 相关文档：[难度曲线与Boss](design/gdd/systems/冒险循环/难度曲线与Boss.md)难度曲线调参批
|
||||
|
||||
**归属**：[难度曲线与Boss](design/gdd/systems/冒险循环/难度曲线与Boss.md)难度曲线调参批
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### 成长系数与关卡怪物难度提升的节奏（2026-10-16 登记，来源=playnote，设计面=文档轨）
|
||||
#### 成长系数与关卡怪物难度提升的节奏（2026-10-16 登记，来源=playnote）
|
||||
|
||||
**现状**：来源＝playnote 用户反馈「一开始不能让角色的成长系数太高。比如在没经过升级之前，你的成长系数是跟不上关卡怪物难度提升的；但是后续能力解锁之后，成长系数才能匹配得上」。语义两读：**读法甲＝节奏缺陷呈报**（前期成长跟不上怪物难度提升＝要修的数值节奏问题，归属难度曲线与Boss＋元进度解锁节奏的数值面）；**读法乙＝设计哲学陈述**（前期成长刻意克制、后期靠能力解锁追平＝既定设计，应反哺难度曲线的设计语义）。2026-10-16 用户定性＝数值校准类、与数值欠账同类任务，甲/乙两读随定性消解（无论现行节奏好坏，调它都是数值校准面的事）；不进 [08-Alpha版本标准](design/gdd/08-Alpha版本标准.md)（数值调优义务 2026-10-16 v1.6 起不入版本标准）；按里程碑立规属 Beta 阶段面，Alpha 不排期；留待办清单数值欠账组，未设计未启动（2026-10-18 用户裁＝不另行归属）。
|
||||
**实况**：来源＝playnote 用户反馈「一开始不能让角色的成长系数太高。比如在没经过升级之前，你的成长系数是跟不上关卡怪物难度提升的；但是后续能力解锁之后，成长系数才能匹配得上」。语义两读：**读法甲＝节奏缺陷呈报**（前期成长跟不上怪物难度提升＝要修的数值节奏问题，归属难度曲线与Boss＋元进度解锁节奏的数值面）；**读法乙＝设计哲学陈述**（前期成长刻意克制、后期靠能力解锁追平＝既定设计，应反哺难度曲线的设计语义）。2026-10-16 用户定性＝数值校准类、与数值欠账同类任务，甲/乙两读随定性消解（无论现行节奏好坏，调它都是数值校准面的事）；不进 [08-Alpha版本标准](design/gdd/08-Alpha版本标准.md)（数值调优义务 2026-10-16 v1.6 起不入版本标准）；按里程碑立规属 Beta 阶段面，Alpha 不排期；留待办清单数值欠账组，未设计未启动（2026-10-18 用户裁＝不另行归属）。
|
||||
|
||||
**缺口**：还差并入数值欠账组的归属落位（Beta 阶段数值校准窗口处理）。
|
||||
- 相关文档：[难度曲线与Boss](design/gdd/systems/冒险循环/难度曲线与Boss.md) + [元进度](design/gdd/systems/跨局循环/元进度.md)（成长系数语义面）
|
||||
|
||||
**归属**：[难度曲线与Boss](design/gdd/systems/冒险循环/难度曲线与Boss.md) + [元进度](design/gdd/systems/跨局循环/元进度.md)（成长系数语义面）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### 「封锁-蓄力」combo 设计素材（2026-10-07 登记，来源=会话提及，设计面=文档轨）
|
||||
#### 「封锁-蓄力」combo 设计素材（2026-10-07 登记，来源=会话提及）
|
||||
|
||||
**现状**：用户想法（暂不立件，素材登记）——两件套：件一＝抬高刷新雷图代价（储备池 RAP 成本飙高）+ 刷新时解锁所有格子（全板开）；件二＝本回合留着 AP 没有刷新 → 获得减伤。联动＝抬价逼留 AP、留 AP 给减伤、憋够一发全板解锁。我方补充登记五点：①形态骨架＝「封锁-蓄力」combo 结构（抬高某动作代价封路 + 不做给补偿 + 憋到后的爆发）；②件一＝风险契约句式的扫雷侧版——碰撞点待裁：刷新开全板与清图判定/清图奖励/连锁展开的关系（算不算清图、发不发清图奖励）；③件二词表可承载（on round_end when 本轮未刷新且余 AP≥X → 减伤/护盾），「本轮未刷新」事实＝扩签候选；④归层按判定尺逐件裁（两件偏机制改写→专长域；但「刷新代价」是扫雷侧经济参数→秘宝域亦可）；⑤防躺赢注记：憋的收益须小于正常挖格期望（否则最优解＝永远不挖，玩法塌缩）。
|
||||
**实况**：用户想法（暂不立件，素材登记）——两件套：件一＝抬高刷新雷图代价（储备池 RAP 成本飙高）+ 刷新时解锁所有格子（全板开）；件二＝本回合留着 AP 没有刷新 → 获得减伤。联动＝抬价逼留 AP、留 AP 给减伤、憋够一发全板解锁。我方补充登记五点：①形态骨架＝「封锁-蓄力」combo 结构（抬高某动作代价封路 + 不做给补偿 + 憋到后的爆发）；②件一＝风险契约句式的扫雷侧版——碰撞点待裁：刷新开全板与清图判定/清图奖励/连锁展开的关系（算不算清图、发不发清图奖励）；③件二词表可承载（on round_end when 本轮未刷新且余 AP≥X → 减伤/护盾），「本轮未刷新」事实＝扩签候选；④归层按判定尺逐件裁（两件偏机制改写→专长域；但「刷新代价」是扫雷侧经济参数→秘宝域亦可）；⑤防躺赢注记：憋的收益须小于正常挖格期望（否则最优解＝永远不挖，玩法塌缩）。
|
||||
|
||||
**缺口**：还差立项裁决（暂不立件）——若立项，先裁碰撞点与归层，再走机制设计讨论。
|
||||
|
||||
**归属**：专长重设计扩充批 / 秘宝内容批（归层顺带裁）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计（备选）
|
||||
|
||||
#### 袋装摇号（格面资源池结构备选——保底型增多后的重构方向）（2026-10-07 登记，来源=会话提及，设计面=文档轨）
|
||||
#### 袋装摇号（格面资源池结构备选——保底型增多后的重构方向）（2026-10-07 登记，来源=会话提及）
|
||||
|
||||
**现状**：地图战斗资源池保底结构（四档概率 + 按型保底 + 档位保底上限，现行事实源＝[地图战斗资源](design/gdd/systems/战斗循环/地图战斗资源.md)候选集合节）以「摇完整板校验补签」的补丁式实现起步——简单够用。备选正规形态＝**袋装摇号**：装板时按各档配额数好牌再洗开发放，保底天然成立、分布精确；代价＝摇号结构重写 + 偏运硬币/board_skew 两路权重投影须改为袋面投影。启用条件＝保底登记型增多、补签逻辑复杂化时。来源＝2026-10-07 地图层题四讨论，用户裁「先挂在待办清单」。
|
||||
**实况**：地图战斗资源池保底结构（四档概率 + 按型保底 + 档位保底上限，现行事实源＝[地图战斗资源](design/gdd/systems/战斗循环/地图战斗资源.md)候选集合节）以「摇完整板校验补签」的补丁式实现起步——简单够用。备选正规形态＝**袋装摇号**：装板时按各档配额数好牌再洗开发放，保底天然成立、分布精确；代价＝摇号结构重写 + 偏运硬币/board_skew 两路权重投影须改为袋面投影。启用条件＝保底登记型增多、补签逻辑复杂化时。来源＝2026-10-07 地图层题四讨论，用户裁「先挂在待办清单」。
|
||||
|
||||
**缺口**：还差启用条件触发后的摇号结构重写设计讨论（含两路权重投影改袋面投影的方案）。
|
||||
|
||||
**归属**：[地图战斗资源](design/gdd/systems/战斗循环/地图战斗资源.md)（重评归该层内容批或数值批窗口）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计（备选）
|
||||
|
||||
#### 战斗节点地图类型差异化——更多地图主题（2026-10-13 登记，来源=playnote，设计面=文档轨）
|
||||
#### 战斗节点地图类型差异化——更多地图主题（2026-10-13 登记，来源=playnote）
|
||||
|
||||
**现状**：来源＝playnote 用户试玩记录「修改地图的奖励类型：战斗节点增加不同的地图类型，比如有些图踩雷受到更多的伤害，有些图标雷可以造成更多的伤害，有些图伤害会减半需要凑更多清图奖励（这些都是暂时的设定）」。**已实装的部分**：首发形态整图变异「贫矿脉」已于 2026-10-16 用户令屏蔽删行（Boss 图回落 region 变异，原体验验证清单⑪ 目检项随之转记失效）——本条剩余面不变：在此之上再做**更多地图主题**（踩雷伤害更高/标雷伤害更高/伤害减半需凑更多清图奖励）。**2026-10-13 用户裁定：排 Beta 版本，Alpha 不做**——已移入 [08-Alpha版本标准](design/gdd/08-Alpha版本标准.md)「六 · Alpha 不含」节。
|
||||
**实况**：来源＝playnote 用户试玩记录「修改地图的奖励类型：战斗节点增加不同的地图类型，比如有些图踩雷受到更多的伤害，有些图标雷可以造成更多的伤害，有些图伤害会减半需要凑更多清图奖励（这些都是暂时的设定）」。**已实装的部分**：首发形态整图变异「贫矿脉」已于 2026-10-16 用户令屏蔽删行（Boss 图回落 region 变异，原体验验证清单⑪ 目检项随之转记失效）——本条剩余面不变：在此之上再做**更多地图主题**（踩雷伤害更高/标雷伤害更高/伤害减半需凑更多清图奖励）。**2026-10-13 用户裁定：排 Beta 版本，Alpha 不做**——已移入 [08-Alpha版本标准](design/gdd/08-Alpha版本标准.md)「六 · Alpha 不含」节。
|
||||
|
||||
**缺口**：还差 Beta 立项时的地图主题设计讨论——按本条原始想法重新评估（用户标注「这些都是暂时的设定」，到时需重订而非照抄）。
|
||||
- 相关文档：[棋盘生成](design/gdd/systems/排雷循环/棋盘生成.md)（board_biome 图主题词表）+ [地图战斗资源](design/gdd/systems/战斗循环/地图战斗资源.md)（图主题差异化插槽）+ [地形变异](design/gdd/systems/排雷循环/地形变异.md)（整图变异承载面）
|
||||
|
||||
**归属**：[棋盘生成](design/gdd/systems/排雷循环/棋盘生成.md)（board_biome 图主题词表）+ [地图战斗资源](design/gdd/systems/战斗循环/地图战斗资源.md)（图主题差异化插槽）+ [地形变异](design/gdd/systems/排雷循环/地形变异.md)（整图变异承载面）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### 基线通关率越带，加难杠杆扫描未执行（2026-09-18 登记，来源=审计发现，设计面=文档轨）
|
||||
#### 基线通关率越带，加难杠杆扫描未执行（2026-09-18 登记，来源=审计发现）
|
||||
|
||||
**现状**：原登记＝现行扫描读数 60% 越 [30%, 50%] 上界；其后目标带两度换代（2026-09-17 带 [10,25]；2026-09-20 重投基线批后分带修正为 L1 [35,55] / L2 [25,45]，旧带失锚作废）——**新带下普通档双关落带、完美档 56%/40% 亦落带，加难紧迫性解除**。C1 终态已落表（2026-09-29 返工批：占比回退 5+plb 0+岩浆 1；U2 裁断 b 项推翻 C3 四件组合裁 **C1 两刀**〔岩浆 effect_value 2→1+逐层变异基数 2→0；变异占比维持 5%、卓尔血维持 130〕，a 项甲＝新杠杆授权〔完美 L1 89% 挂账废止，归难度曲线与Boss.md 带换代节承接〕；U2 裁断全录见 git 提交 f9c1a8a）。剩余面＝调参批的行值 provisional→正式扫描义务（门＝真人批 k 系数）；新增调参杠杆位＝变异 effect_value（荆棘丛 1 / 岩浆 2）与 percent_of_cells（5%）/ per_level_bonus（+2/关），扫描时与既有三类杠杆（血量锚走廊 r_boss [1.1, 1.35]〔2026-09-17 注：数值压缩批后 Boss 生命已 ÷3 缩水，180–207 为压缩前基线锚，复算随调参批〕、群战上探、注入衰减 0.5 → 0.6）合并比较；落带前全部现行行值维持 provisional-pending-scan。
|
||||
**实况**：原登记＝现行扫描读数 60% 越 [30%, 50%] 上界；其后目标带两度换代（2026-09-17 带 [10,25]；2026-09-20 重投基线批后分带修正为 L1 [35,55] / L2 [25,45]，旧带失锚作废）——**新带下普通档双关落带、完美档 56%/40% 亦落带，加难紧迫性解除**。C1 终态已落表（2026-09-29 返工批：占比回退 5+plb 0+岩浆 1；U2 裁断 b 项推翻 C3 四件组合裁 **C1 两刀**〔岩浆 effect_value 2→1+逐层变异基数 2→0；变异占比维持 5%、卓尔血维持 130〕，a 项甲＝新杠杆授权〔完美 L1 89% 挂账废止，归难度曲线与Boss.md 带换代节承接〕；U2 裁断全录见 git 提交 f9c1a8a）。剩余面＝调参批的行值 provisional→正式扫描义务（门＝真人批 k 系数）；新增调参杠杆位＝变异 effect_value（荆棘丛 1 / 岩浆 2）与 percent_of_cells（5%）/ per_level_bonus（+2/关），扫描时与既有三类杠杆（血量锚走廊 r_boss [1.1, 1.35]〔2026-09-17 注：数值压缩批后 Boss 生命已 ÷3 缩水，180–207 为压缩前基线锚，复算随调参批〕、群战上探、注入衰减 0.5 → 0.6）合并比较；落带前全部现行行值维持 provisional-pending-scan。
|
||||
|
||||
**缺口**：还差真人批 k 系数到账后的加难紧迫性重判，再定正式扫描与杠杆标定设计。
|
||||
- 相关文档：难度曲线与Boss调参批，扫描执行与[棋盘生成](design/gdd/systems/排雷循环/棋盘生成.md)工具交付联动
|
||||
|
||||
**归属**：难度曲线与Boss调参批，扫描执行与[棋盘生成](design/gdd/systems/排雷循环/棋盘生成.md)工具交付联动
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计（备选）
|
||||
|
||||
#### 三方向各自的解锁清单与定价（2026-09-21 登记，来源=审计发现，设计面=文档轨）
|
||||
#### 三方向各自的解锁清单与定价（2026-09-21 登记，来源=审计发现）
|
||||
|
||||
**现状**：三方向（属性、遭遇、道具池）各自的解锁清单与定价：多少钥石换什么，各自怎么铺。来源＝元进度 待设计问题清单第 2 条。部分完成（2026-09-21 元进度实现批再收窄；2026-09-23 换算率标定批再收窄）——**三柜台结构与 provisional 定价已落地**（属性锻造三档血+3/攻+1/甲+1、Boss 两档、工坊六件阈值 1/1/2/2/3/3 按总通关次数——全部读 `data/tables/meta.tres`）；换算率三行已投值 6/9/1（冒险条件口径实测，护甲行强条目重测履行）。剩余面＝定价数字与 Boss 两档终值——已入 M4 数值批卡 v1.2 件④（F11/F12；含待办清单死文本两句全刷义务：「base 10 公比 150」滞后〔meta.tres 现行 forge base_price=20，2026-09-22 数值设计批对齿〕与「Boss 两档 L1 5/1·L2 8/2·L3 12/3」死数字句〔现值首杀 3/3/3 · 复杀 2/2/3〕，T4 判据按两句全刷执行）。
|
||||
**实况**：三方向（属性、遭遇、道具池）各自的解锁清单与定价：多少钥石换什么，各自怎么铺。来源＝元进度 待设计问题清单第 2 条。部分完成（2026-09-21 元进度实现批再收窄；2026-09-23 换算率标定批再收窄）——**三柜台结构与 provisional 定价已落地**（属性锻造三档血+3/攻+1/甲+1、Boss 两档、工坊六件阈值 1/1/2/2/3/3 按总通关次数——全部读 `data/tables/meta.tres`）；换算率三行已投值 6/9/1（冒险条件口径实测，护甲行强条目重测履行）。剩余面＝定价数字与 Boss 两档终值——已入 M4 数值批卡 v1.2 件④（F11/F12；含待办清单死文本两句全刷义务：「base 10 公比 150」滞后〔meta.tres 现行 forge base_price=20，2026-09-22 数值设计批对齿〕与「Boss 两档 L1 5/1·L2 8/2·L3 12/3」死数字句〔现值首杀 3/3/3 · 复杀 2/2/3〕，T4 判据按两句全刷执行）。
|
||||
|
||||
**缺口**：M4 数值批卡片已随 2026-10-16 删卡令退役；2026-10-18 用户裁＝本条留待办清单、未设计未启动、不另行归属，未来数值标定窗口重开时重走设计段再写卡。
|
||||
|
||||
**归属**：元进度设计批
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### 第二 / 三关棋盘观感——亮度与对比度（2026-10-13 登记，来源=playnote，设计面=双轨）
|
||||
#### 第二 / 三关棋盘观感——亮度与对比度（2026-10-13 登记，来源=playnote）
|
||||
|
||||
**现状**：来源＝playnote 用户试玩记录「UI 优化，第二第三关的棋盘看着太累了；不知道是因为亮度还是对比度的原因，看着非常费劲，非常不舒服」。2026-10-13 用户裁定：**这是需要做的**，且本就属版本标准的覆盖范围——[08-Alpha版本标准](design/gdd/08-Alpha版本标准.md)「五 · 表现」已新增「棋盘观感（第二 / 三关亮度与对比度）」行，标待做。**开工前须先定性（沿用既有裁决）**：是**素材轴**问题（棋盘瓦片与格面图标本身的明度与色相），还是 **UI 轴**问题（舞台底色与叠加层的对比关系）——两轴修法完全不同，定性错了等于白改一轮；该定性要求（原备忘 (e) 项）是本条的开工前置。2026-10-16 曾编入迭代 30 卡③（UI 呈现三卡批序位③），2026-10-17 用户裁定剔除回待设计（自身挂「素材轴/UI 轴」定性人闸＋甲/乙〔recolor/远程生图重产〕素材裁点；若裁乙，其瓦片规格依赖战斗一屏样张批的目标规格清单产出）。v1.4 旧卡留 reports/需求卡片-二三关棋盘观感批-2026-10-16.md 作素材，非已写卡状态。与已完成注销的「呈现层残余 <4.5:1 文字位」分工：本条管**棋盘区域整体的观感**（亮度/对比度/费劲感，体感问题），彼条管**具体文字位的对比度读数**（机检可判硬指标），两条不同面不互相替代。Alpha 出口裁决：Alpha 必须，先做素材轴／UI 轴对照定性；出口＝用户实机目检不再判「看着费劲」。
|
||||
**实况**：来源＝playnote 用户试玩记录「UI 优化，第二第三关的棋盘看着太累了；不知道是因为亮度还是对比度的原因，看着非常费劲，非常不舒服」。2026-10-13 用户裁定：**这是需要做的**，且本就属版本标准的覆盖范围——[08-Alpha版本标准](design/gdd/08-Alpha版本标准.md)「五 · 表现」已新增「棋盘观感（第二 / 三关亮度与对比度）」行，标待做。**开工前须先定性（沿用既有裁决）**：是**素材轴**问题（棋盘瓦片与格面图标本身的明度与色相），还是 **UI 轴**问题（舞台底色与叠加层的对比关系）——两轴修法完全不同，定性错了等于白改一轮；该定性要求（原备忘 (e) 项）是本条的开工前置。2026-10-16 曾编入迭代 30 卡③（UI 呈现三卡批序位③），2026-10-17 用户裁定剔除回待设计（自身挂「素材轴/UI 轴」定性人闸＋甲/乙〔recolor/远程生图重产〕素材裁点；若裁乙，其瓦片规格依赖战斗一屏样张批的目标规格清单产出）。v1.4 旧卡留 reports/需求卡片-二三关棋盘观感批-2026-10-16.md 作素材，非已写卡状态。与已完成注销的「呈现层残余 <4.5:1 文字位」分工：本条管**棋盘区域整体的观感**（亮度/对比度/费劲感，体感问题），彼条管**具体文字位的对比度读数**（机检可判硬指标），两条不同面不互相替代。Alpha 出口裁决：Alpha 必须，先做素材轴／UI 轴对照定性；出口＝用户实机目检不再判「看着费劲」。
|
||||
|
||||
**缺口**：还差「素材轴 / UI 轴」定性设计讨论与甲/乙素材裁点裁决；素材轴若走重产，还依赖战斗一屏样张批的目标规格清单产出。旧卡 v1.4（reports/需求卡片-二三关棋盘观感批-2026-10-16.md）在册但非已写卡状态，其前置未完成三件：①「素材轴 / UI 轴」定性未做，这是既有条款规定的开工前置；②甲（recolor 现瓦片）／乙（远程生图重产）素材裁点未裁；③若裁乙，瓦片规格压在样张批的目标规格清单上，而那份清单的前置正是上一条未完成的样张设计轮——本条第三项压在卡②身上。
|
||||
- 相关文档：[HUD框架](design/gdd/systems/表现与支撑/HUD框架.md)（UI 轴：舞台底与叠加层）+ [美术圣经](design/art/art-bible.md)（素材轴：瓦片与格面图标的明度色相）——定性前两方共裁
|
||||
|
||||
**归属**：[HUD框架](design/gdd/systems/表现与支撑/HUD框架.md)（UI 轴：舞台底与叠加层）+ [美术圣经](design/art/art-bible.md)（素材轴：瓦片与格面图标的明度色相）——定性前两方共裁
|
||||
**改动面**：美术素材＋游戏代码
|
||||
|
||||
**状态**：待文档设计＋待美术设计
|
||||
|
||||
#### 棋盘格边长三方取值不一致——待扩板定档处置（2026-10-06 登记，来源=批次移交，设计面=文档轨）
|
||||
#### 棋盘格边长三方取值不一致——待扩板定档处置（2026-10-06 登记，来源=批次移交）
|
||||
|
||||
**现状**：迭代 16「UI 设计对齐批」P2 已裁「棋盘格边长零改动」（本次不动棋盘游戏画面），由此三方取值不一致作为**已知偏差**登记：①代码＝`board_view.gd:251` 动态公式 `clampi(cell, 26, 46)` + `:114` 默认 46.0；②art-bible §8.1(:433) 冻结锚点＝45px（10×10）/ 36px（12×12）；③demo 原型＝44px（`src/ui-prototype.html:288`）；另有 HUD框架:72 装板校验区间 [30,45]。**当前未被任何断言触发**（属潜在不一致，不是缺陷）。按需求卡片契约 R7「禁单侧改完留漂移」，本批**代码与文档均不改**；处置时机＝扩板（13×13/14×14）定档时随格边长专项一并处理（§8.1 亦注明扩板换算值未定稿）。来源＝UI对齐批需求卡片（已退役，git 历史可查）§2.1「已知偏差」行。
|
||||
**实况**：迭代 16「UI 设计对齐批」P2 已裁「棋盘格边长零改动」（本次不动棋盘游戏画面），由此三方取值不一致作为**已知偏差**登记：①代码＝`board_view.gd:251` 动态公式 `clampi(cell, 26, 46)` + `:114` 默认 46.0；②art-bible §8.1(:433) 冻结锚点＝45px（10×10）/ 36px（12×12）；③demo 原型＝44px（`src/ui-prototype.html:288`）；另有 HUD框架:72 装板校验区间 [30,45]。**当前未被任何断言触发**（属潜在不一致，不是缺陷）。按需求卡片契约 R7「禁单侧改完留漂移」，本批**代码与文档均不改**；处置时机＝扩板（13×13/14×14）定档时随格边长专项一并处理（§8.1 亦注明扩板换算值未定稿）。来源＝UI对齐批需求卡片（已退役，git 历史可查）§2.1「已知偏差」行。
|
||||
|
||||
**缺口**：还差扩板定档时的格边长专项裁决（三方取值归一＋§8.1 扩板换算值定稿）。
|
||||
|
||||
**归属**：格边长专项（或 UI 设计对齐批后续专项）；开工＝用户点名
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计（备选）
|
||||
|
||||
#### 资产升档重产批（art-bible v3.0 中修挂账③，2026-09-29 登记，来源=批次移交，设计面=美术轨）
|
||||
#### 资产升档重产批（art-bible v3.0 中修挂账③，2026-09-29 登记，来源=批次移交）
|
||||
|
||||
**现状**：v3.0 §8.2 档位上调方向候选（主角立绘 48×72→64×96 档、敌立绘三档上调评估）**已实质完成**——2026-10-06 art-bible v3.7 八敌逐键定档（源档 36–94、显示 ×2 整数；派生管线＝pixel-1 紧裁→等比缩至档高→dom_block_resize）取代 64/96/128 升档路线；存在感问题改经方案二（B 区 270 / 立绘显示上限 188 / 血条状态落底排）解决，不再走升档路线。裁决史：2026-09-30 迭代 9 三裁决案乙（本迭代不升档，先收 Alpha 真人读数再定；A4 尺寸基线冻结〔立绘 46×48/小人源 32×32〕维持有效）；2026-10-04 用户令暂不做、先忽略；2026-10-06 用户令优先级再降（维持挂起；同日 playnote 立绘批评已由「立绘逐键定档批」承接兑现）。**剩余挂起项＝提灯点亮解禁候选**（character-design 提灯，v3.0 明度分层允许空间光照），重启＝用户点名或 M-4 升档批。Alpha 出口裁决：不进 Alpha，排 Beta；提灯候选随 Beta 资产批重议。
|
||||
**实况**：v3.0 §8.2 档位上调方向候选（主角立绘 48×72→64×96 档、敌立绘三档上调评估）**已实质完成**——2026-10-06 art-bible v3.7 八敌逐键定档（源档 36–94、显示 ×2 整数；派生管线＝pixel-1 紧裁→等比缩至档高→dom_block_resize）取代 64/96/128 升档路线；存在感问题改经方案二（B 区 270 / 立绘显示上限 188 / 血条状态落底排）解决，不再走升档路线。裁决史：2026-09-30 迭代 9 三裁决案乙（本迭代不升档，先收 Alpha 真人读数再定；A4 尺寸基线冻结〔立绘 46×48/小人源 32×32〕维持有效）；2026-10-04 用户令暂不做、先忽略；2026-10-06 用户令优先级再降（维持挂起；同日 playnote 立绘批评已由「立绘逐键定档批」承接兑现）。**剩余挂起项＝提灯点亮解禁候选**（character-design 提灯，v3.0 明度分层允许空间光照），重启＝用户点名或 M-4 升档批。Alpha 出口裁决：不进 Alpha，排 Beta；提灯候选随 Beta 资产批重议。
|
||||
|
||||
**缺口**：还差提灯点亮解禁候选的重议设计（升档批或用户点名触发时一并裁）。
|
||||
- 相关文档：[art-bible](design/art/art-bible.md) §8.2 · 资产管线批
|
||||
|
||||
**归属**：[art-bible](design/art/art-bible.md) §8.2 · 资产管线批
|
||||
**改动面**：美术素材
|
||||
|
||||
**状态**：待美术设计（备选）
|
||||
|
||||
#### 立绘清晰度回退评估——是否改用高清图（2026-10-13 登记，来源=playnote，设计面=美术轨）
|
||||
#### 立绘清晰度回退评估——是否改用高清图（2026-10-13 登记，来源=playnote）
|
||||
|
||||
**现状**：来源＝playnote 用户试玩记录「现在的立绘太丑了，像素化的粒度太低了，导致根本看不清立绘；看是否可以改回用较为高清的图片？还有一个问题是大小的问题……现在地精的图片看起来比熊地精还要大，这并不合理」。2026-10-13 用户裁定：与「第二 / 三关棋盘观感」同属**美术线更新**。**两个子问题现状不同**：子问题一＝怪物大小比例不合理——**已兑现**（体量语义改生物体型〔character-design §5.2，弃强度线性映射〕＋八敌逐键定档〔art-bible §8.2〕），剩余面＝用户是否复核验收；子问题二＝像素粒度过低/是否改回高清图——**方向已裁（2026-10-14 用户裁）**：「还是像素风格立绘，但是不需要像现在太过于像素」，定性为**精细手绘像素**（不是插画、不是 HD-2D、不回退高清图；裁决录＝[美术审计-cursor会话存档](reports/美术审计-cursor会话存档-2026-10-14.md) §2.2；权威面 art-bible/character-design 口径节反哺另批），粒度问题已改派生管线（八敌源档 36–94 全过可读门槛：24 糊/32 可读/48 清楚）。[08-Alpha版本标准](design/gdd/08-Alpha版本标准.md) 未决项已随裁删除（2026-10-16 状态刷新批）。Alpha 出口裁决：Alpha 范围＝主角＋三个 Boss 按新口径重产，其余敌种当前可读则保留到 Beta。
|
||||
**实况**：来源＝playnote 用户试玩记录「现在的立绘太丑了，像素化的粒度太低了，导致根本看不清立绘；看是否可以改回用较为高清的图片？还有一个问题是大小的问题……现在地精的图片看起来比熊地精还要大，这并不合理」。2026-10-13 用户裁定：与「第二 / 三关棋盘观感」同属**美术线更新**。**两个子问题现状不同**：子问题一＝怪物大小比例不合理——**已兑现**（体量语义改生物体型〔character-design §5.2，弃强度线性映射〕＋八敌逐键定档〔art-bible §8.2〕），剩余面＝用户是否复核验收；子问题二＝像素粒度过低/是否改回高清图——**方向已裁（2026-10-14 用户裁）**：「还是像素风格立绘，但是不需要像现在太过于像素」，定性为**精细手绘像素**（不是插画、不是 HD-2D、不回退高清图；裁决录＝[美术审计-cursor会话存档](reports/美术审计-cursor会话存档-2026-10-14.md) §2.2；权威面 art-bible/character-design 口径节反哺另批），粒度问题已改派生管线（八敌源档 36–94 全过可读门槛：24 糊/32 可读/48 清楚）。[08-Alpha版本标准](design/gdd/08-Alpha版本标准.md) 未决项已随裁删除（2026-10-16 状态刷新批）。Alpha 出口裁决：Alpha 范围＝主角＋三个 Boss 按新口径重产，其余敌种当前可读则保留到 Beta。
|
||||
|
||||
**缺口**：还差立绘按「精细手绘像素」新口径重产的设计——整屏方向稿与地面/立绘密度同批锁（与战斗一屏样张批联动）后才可出重产工单。
|
||||
- 相关文档：[角色设计](design/art/character-design.md)（立绘规格与体量语义）+ [美术圣经](design/art/art-bible.md)（像素管线与档位）
|
||||
|
||||
**归属**：[角色设计](design/art/character-design.md)（立绘规格与体量语义）+ [美术圣经](design/art/art-bible.md)（像素管线与档位）
|
||||
**改动面**：美术素材
|
||||
|
||||
**状态**：待美术设计
|
||||
|
||||
#### 站桩帧动画——Alpha 定版闸前完成（2026-10-06 登记，来源=审计发现，设计面=美术轨）
|
||||
#### 站桩帧动画——Alpha 定版闸前完成（2026-10-06 登记，来源=审计发现）
|
||||
|
||||
**现状**：审计报告 P0-3——定稿立绘零帧动画；现行动画全部程序化（死亡碎裂/受击闪白/意图徽标弹入＝程序 tween，非帧资产）。用户裁定**动画是较往后的优化，Alpha 版本定版时间点之前完成即可**——当前 Alpha 开发期达成「看上去可游玩」即可。路线未拍板，审计报告三路线供重启时裁决：①**拆件驱动**（报告推荐：定稿立绘切部件〔头/躯干/臂/腿/武器〕+ 节点层级 tween 驱动——零身份漂移、帧数无限、内存小；项目已有先例＝shovel_swing 三帧 + 程序化死亡碎裂）②AI 关键姿势 + 人工修 + 程序补帧 ③全 AI 逐帧（不推荐：身份漂移/像素抖动）。前置依赖＝「立绘→派生形态」管线（等比整数缩放 + 降色 ≤32 + 脚底基线对齐 + 命名合规）——该管线同时是棋盘小人重出与八敌档位重算的前提。Alpha 出口裁决：列入 Alpha 定版前置清单——定版前完成最小版，路线预选拆件驱动；未完成则顺延 Beta，不占功能迭代。
|
||||
**实况**：审计报告 P0-3——定稿立绘零帧动画；现行动画全部程序化（死亡碎裂/受击闪白/意图徽标弹入＝程序 tween，非帧资产）。用户裁定**动画是较往后的优化，Alpha 版本定版时间点之前完成即可**——当前 Alpha 开发期达成「看上去可游玩」即可。路线未拍板，审计报告三路线供重启时裁决：①**拆件驱动**（报告推荐：定稿立绘切部件〔头/躯干/臂/腿/武器〕+ 节点层级 tween 驱动——零身份漂移、帧数无限、内存小；项目已有先例＝shovel_swing 三帧 + 程序化死亡碎裂）②AI 关键姿势 + 人工修 + 程序补帧 ③全 AI 逐帧（不推荐：身份漂移/像素抖动）。前置依赖＝「立绘→派生形态」管线（等比整数缩放 + 降色 ≤32 + 脚底基线对齐 + 命名合规）——该管线同时是棋盘小人重出与八敌档位重算的前提。Alpha 出口裁决：列入 Alpha 定版前置清单——定版前完成最小版，路线预选拆件驱动；未完成则顺延 Beta，不占功能迭代。
|
||||
|
||||
**缺口**：还差 Alpha 定版批的路线正式拍板（预选拆件驱动）——拍板后立帧数规格与资产工单。
|
||||
- 相关文档：[art-bible](design/art/art-bible.md) §8.4 帧数规格 · 战斗表现批
|
||||
|
||||
**归属**：[art-bible](design/art/art-bible.md) §8.4 帧数规格 · 战斗表现批
|
||||
**改动面**：美术素材
|
||||
|
||||
**状态**：待美术设计
|
||||
|
||||
#### 主角描边素材侧复核（2026-10-06 登记，来源=会话提及，设计面=美术轨）
|
||||
#### 主角描边素材侧复核（2026-10-06 登记，来源=会话提及）
|
||||
|
||||
**现状**：待决项 B 已按用户拍板走**文档例外条款**（character-design.md §5.1 v1.9：主角四态硬描边＝深褐 `(40,19,13)` 显式例外，浅砖面对比更高；**素材不顺带修改**）。本条仅为复核钩子：样张批（圣经 §1.4）终审时若发现深描边例外不成立（对比优势不实/与敌方同屏割裂感可感），素材侧修订（描边统一暖白族）**须先经本条重启**再开工，禁止直接动图。
|
||||
**实况**：待决项 B 已按用户拍板走**文档例外条款**（character-design.md §5.1 v1.9：主角四态硬描边＝深褐 `(40,19,13)` 显式例外，浅砖面对比更高；**素材不顺带修改**）。本条仅为复核钩子：样张批（圣经 §1.4）终审时若发现深描边例外不成立（对比优势不实/与敌方同屏割裂感可感），素材侧修订（描边统一暖白族）**须先经本条重启**再开工，禁止直接动图。
|
||||
|
||||
**缺口**：还差样张批终审触发的深描边例外复核——复核成立即注销，不成立则重启素材修订设计。
|
||||
- 相关文档：[character-design](design/art/character-design.md) §5.1 · 样张批
|
||||
|
||||
**归属**：[character-design](design/art/character-design.md) §5.1 · 样张批
|
||||
**改动面**：美术素材
|
||||
|
||||
**状态**：待美术设计（备选）
|
||||
|
||||
#### 在途草稿整理批——3349 个失管草稿（2026-10-06 登记，来源=审计发现，设计面=工程直入）
|
||||
#### 在途草稿整理批——3349 个失管草稿（2026-10-06 登记，来源=审计发现）
|
||||
|
||||
**现状**：审计 P2-1——`artwork/ui-reuse-2026-09-23/` 独占 3043 个草稿（91%），vN 命名率 0%，冗余 41 文件，残留非素材文件（.url ×8 / .ogg ×6 / .ai ×2 / .swf ×1）；根因＝脚本链覆盖「生成→验证」但**缺「草稿整理」段**。整理涉及**批量文件移动/删除**，按用户惯例须先 dry-run 呈报清单、经确认再分批执行。执行窗口随实现批；开工＝用户点名。
|
||||
**实况**：审计 P2-1——`artwork/ui-reuse-2026-09-23/` 独占 3043 个草稿（91%），vN 命名率 0%，冗余 41 文件，残留非素材文件（.url ×8 / .ogg ×6 / .ai ×2 / .swf ×1）；根因＝脚本链覆盖「生成→验证」但**缺「草稿整理」段**。整理涉及**批量文件移动/删除**，按用户惯例须先 dry-run 呈报清单、经确认再分批执行。执行窗口随实现批；开工＝用户点名。
|
||||
- 相关文档：[art-bible](design/art/art-bible.md) §8.3 归档纪律（原则已写入）· 资产管线批（工具+文件操作）
|
||||
|
||||
**归属**：[art-bible](design/art/art-bible.md) §8.3 归档纪律（原则已写入）· 资产管线批（工具+文件操作）
|
||||
**改动面**：美术素材＋工具代码
|
||||
|
||||
**状态**：待写卡
|
||||
|
||||
#### 圣经口号型条款机检化批（2026-10-06 登记，来源=审计发现，设计面=文档轨）
|
||||
#### 圣经口号型条款机检化批（2026-10-06 登记，来源=审计发现）
|
||||
|
||||
**现状**：审计 P2-4——圣经约 55% 条款属口号型（如「暖倾向无压抑」「同一圆角率」无值），与可机检条款混排。目标＝逐条审查标注「可机检/目检/口号」三档分行，口号型逐步改写为带值或带判据条款。工程量＝全文级（541 行逐条），非一轮能毕。**2026-10-06 三档标注格式已拍板**（←机检/←目检/←方向性，规范见 art-bible 头注「条款验收标注纪律」；数值类推荐「待定现用」态）——本批执行＝按此格式分章补标，每章交付用户抽验。挂账：随整屏样张闸前整备批启动，分章推进。
|
||||
**实况**：审计 P2-4——圣经约 55% 条款属口号型（如「暖倾向无压抑」「同一圆角率」无值），与可机检条款混排。目标＝逐条审查标注「可机检/目检/口号」三档分行，口号型逐步改写为带值或带判据条款。工程量＝全文级（541 行逐条），非一轮能毕。**2026-10-06 三档标注格式已拍板**（←机检/←目检/←方向性，规范见 art-bible 头注「条款验收标注纪律」；数值类推荐「待定现用」态）——本批执行＝按此格式分章补标，每章交付用户抽验。挂账：随整屏样张闸前整备批启动，分章推进。
|
||||
|
||||
**缺口**：还差整屏样张闸前整备批的启动——格式已定，差启动时点与分章执行。
|
||||
- 相关文档：[art-bible](design/art/art-bible.md) 全文 · 样张批前置整备
|
||||
|
||||
**归属**：[art-bible](design/art/art-bible.md) 全文 · 样张批前置整备
|
||||
**改动面**：文档＋工具代码
|
||||
|
||||
**状态**：待文档设计（备选）
|
||||
|
||||
#### 战斗区背景图替换——B 区舞台插画 + 临时光柱退役（2026-10-07 登记，来源=会话提及，设计面=美术轨）
|
||||
#### 战斗区背景图替换——B 区舞台插画 + 临时光柱退役（2026-10-07 登记，来源=会话提及）
|
||||
|
||||
**现状**：B 区舞台现行＝程序化平色底（`UiKit.STAGE_BG`，`battle_stage_view.gd:47`）+ **顶光柱氛围层**（`:55-63` 四柱，x 基准 110/900/1055/1210@1280，60 段叠层矩形自顶向下渐宽窄渐隐〔顶 α26→0〕，层序＝bg < 光柱 < 世界）——二者均系 §6.1 方向稿的**临时占位**，用户口径「光柱只是临时方案，换正式战斗背景后效果更好」。正式件已立资产契约：`stage/stage_bg.png`（源 1280×270，B 区全高含明细带底；三关换挡走 §4.3 `wall_ambient` tint 槽，不按板出三张），属审计 P1-2 查得的「B 区舞台背景插画 0 张」缺口。**光柱在背景到位后顺带退役或吸收进背景绘制**（不再作为独立程序层）。**与立绘探顶解耦**：大体档「允许向上溢出盒顶 N px」的判定（2026-10-07 用户裁甲案）**不依赖光柱是否存在**，换背景零返工。
|
||||
**实况**：B 区舞台现行＝程序化平色底（`UiKit.STAGE_BG`，`battle_stage_view.gd:47`）+ **顶光柱氛围层**（`:55-63` 四柱，x 基准 110/900/1055/1210@1280，60 段叠层矩形自顶向下渐宽窄渐隐〔顶 α26→0〕，层序＝bg < 光柱 < 世界）——二者均系 §6.1 方向稿的**临时占位**，用户口径「光柱只是临时方案，换正式战斗背景后效果更好」。正式件已立资产契约：`stage/stage_bg.png`（源 1280×270，B 区全高含明细带底；三关换挡走 §4.3 `wall_ambient` tint 槽，不按板出三张），属审计 P1-2 查得的「B 区舞台背景插画 0 张」缺口。**光柱在背景到位后顺带退役或吸收进背景绘制**（不再作为独立程序层）。**与立绘探顶解耦**：大体档「允许向上溢出盒顶 N px」的判定（2026-10-07 用户裁甲案）**不依赖光柱是否存在**，换背景零返工。
|
||||
|
||||
**缺口**：还差出图前置条件的达成——立绘定档与站桩重排实装批的 **C0 盒高账定案后再出图**（避免 B 区高度/构图二次返工）；开工＝用户点名。
|
||||
- 相关文档：[art-bible](design/art/art-bible.md) §6.1（资产契约）+ §8.3 归档纪律 · 资产管线批；出图工单归 [art-assets-checklist](design/art/art-assets-checklist.md) / 实装批任务书
|
||||
|
||||
**归属**：[art-bible](design/art/art-bible.md) §6.1（资产契约）+ §8.3 归档纪律 · 资产管线批；出图工单归 [art-assets-checklist](design/art/art-assets-checklist.md) / 实装批任务书
|
||||
**改动面**：美术素材＋游戏代码
|
||||
|
||||
**状态**：待美术设计
|
||||
|
||||
@@ -478,133 +476,135 @@
|
||||
|
||||
> **节头注记（2026-10-04 用户拍板）**：教学引导定稿批整体改排 **Beta 阶段**——当前 Alpha 版不做教学相关工作，本节五条全部随之改排（2026-09-19 的 Alpha 排期拍板被本拍板取代）。同日五问讨论已形成初裁与设计提案，提案已归档 `archive/` 目录（磁盘留存、不入 git，Beta 批立项底稿，引用以其「归档状态与初裁记录」节为准）。初裁摘要：①教学形态＝丙1 混合（首次冒险编排式首遇提示〔挂 first_script 锚、不锁操作〕+其余全程情景触发）；②「因果教学顺序」问题**注销**——只教扫雷操作，结算读法不设教学（用户裁：结算只是表达、展现、演出，无策略内容；展示层每行带来源标注已自带归因；教学引导.md 旧前提〔设计目的句/P0 候选归因提示/验收第 2 条〕随 Beta 批文档定稿清除）；③图例面板按循环段落分组、无结算段；④不做「再教一次」——改走独立「帮助」手册面（全部内容放一个文档）；⑤教学文案内容权归设置与本地化（两文档负责表对齐随 Beta 批）。**未裁三疑点**（Beta 立项时先裁）：增益叠层节奏条目去留／帮助入口位置（设置面为推荐）／图例面板与帮助手册的内容分工。
|
||||
|
||||
#### 教学形态未定（2026-10-04 登记，来源=审计发现，设计面=文档轨）
|
||||
#### 教学形态未定（2026-10-04 登记，来源=审计发现）
|
||||
|
||||
**现状**：教学的具体形态未定：线性开局教程，还是全部走情景触发式提示？来源＝待设计问题清单第 1 条。2026-10-04 用户拍板本节整体改排 Beta（Alpha 不做教学）；同日五问讨论初裁＝丙1 混合（见本节头注记），定稿归 Beta 批。
|
||||
**实况**：教学的具体形态未定：线性开局教程，还是全部走情景触发式提示？来源＝待设计问题清单第 1 条。2026-10-04 用户拍板本节整体改排 Beta（Alpha 不做教学）；同日五问讨论初裁＝丙1 混合（见本节头注记），定稿归 Beta 批。
|
||||
|
||||
**缺口**：还差 Beta 立项后的教学形态定稿讨论（初裁丙1 混合待定稿，见本节头注记）。
|
||||
|
||||
**归属**：教学引导定稿批
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### 因果教学顺序（2026-10-04 登记，来源=审计发现，设计面=文档轨）
|
||||
#### 因果教学顺序（2026-10-04 登记，来源=审计发现）
|
||||
|
||||
**现状**：因果教学顺序未定：先教扫雷操作，还是先教读结算明细？两者如何衔接？来源＝待设计问题清单第 2 条。2026-10-04 五问讨论初裁＝**该问题注销**——只教扫雷操作，结算读法不设教学（用户裁：结算只是表达、展现、演出，无策略内容）；教学引导.md 旧前提随 Beta 批文档定稿清除。
|
||||
**实况**：因果教学顺序未定：先教扫雷操作，还是先教读结算明细？两者如何衔接？来源＝待设计问题清单第 2 条。2026-10-04 五问讨论初裁＝**该问题注销**——只教扫雷操作，结算读法不设教学（用户裁：结算只是表达、展现、演出，无策略内容）；教学引导.md 旧前提随 Beta 批文档定稿清除。
|
||||
|
||||
**缺口**：还差 Beta 批文档定稿时对初裁结论的落文清算（教学引导.md 旧前提清除）。
|
||||
**缺口**：还差 Beta 批文档定稿时对初裁结论的写入文档清算（教学引导.md 旧前提清除）。
|
||||
|
||||
**归属**：教学引导定稿批
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### 图例面板的条目全集与分组方式（2026-10-04 登记，来源=审计发现，设计面=文档轨）
|
||||
#### 图例面板的条目全集与分组方式（2026-10-04 登记，来源=审计发现）
|
||||
|
||||
**现状**：图例面板的条目全集与分组方式待定。来源＝待设计问题清单第 3 条。2026-10-04 五问讨论初裁＝图例面板按循环段落分组、无结算段（见本节头注记）；图例面板与帮助手册的内容分工属未裁三疑点之一（Beta 立项时先裁）。
|
||||
**实况**：图例面板的条目全集与分组方式待定。来源＝待设计问题清单第 3 条。2026-10-04 五问讨论初裁＝图例面板按循环段落分组、无结算段（见本节头注记）；图例面板与帮助手册的内容分工属未裁三疑点之一（Beta 立项时先裁）。
|
||||
|
||||
**缺口**：还差 Beta 立项后的图例面板定稿讨论（分组初裁待定稿＋与帮助手册内容分工裁决）。
|
||||
|
||||
**归属**：教学引导定稿批
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### 教学文案定稿权与本地化流程的分工（2026-10-04 登记，来源=审计发现，设计面=文档轨）
|
||||
#### 教学文案定稿权与本地化流程的分工（2026-10-04 登记，来源=审计发现）
|
||||
|
||||
**现状**：教学文案的定稿权归属，以及与本地化流程的分工——两边共担，裁决时须对齐（设置与本地化原登记「文案定稿权与翻译流程的分工」；教学引导「待设计问题清单」第 4 条同事项，合并于此）。来源＝待设计问题清单 + 设置与本地化原登记。2026-10-04 五问讨论初裁＝教学文案内容权归设置与本地化，两文档负责表对齐随 Beta 批（见本节头注记）。
|
||||
**实况**：教学文案的定稿权归属，以及与本地化流程的分工——两边共担，裁决时须对齐（设置与本地化原登记「文案定稿权与翻译流程的分工」；教学引导「待设计问题清单」第 4 条同事项，合并于此）。来源＝待设计问题清单 + 设置与本地化原登记。2026-10-04 五问讨论初裁＝教学文案内容权归设置与本地化，两文档负责表对齐随 Beta 批（见本节头注记）。
|
||||
|
||||
**缺口**：还差 Beta 批的两文档负责表对齐定稿。
|
||||
- 相关文档：教学引导与[设置与本地化](design/gdd/systems/表现与支撑/设置与本地化.md)共裁
|
||||
|
||||
**归属**：教学引导与[设置与本地化](design/gdd/systems/表现与支撑/设置与本地化.md)共裁
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
#### "再教一次"入口与图例面板兼任手册（2026-10-04 登记，来源=审计发现，设计面=文档轨）
|
||||
#### "再教一次"入口与图例面板兼任手册（2026-10-04 登记，来源=审计发现）
|
||||
|
||||
**现状**：是否提供"再教一次"的入口（图例面板是否兼任手册）待定。来源＝待设计问题清单第 5 条。2026-10-04 五问讨论初裁＝不做「再教一次」，改走独立「帮助」手册面（全部内容放一个文档；见本节头注记）；帮助入口位置属未裁三疑点之一（设置面为推荐，Beta 立项时先裁）。
|
||||
**实况**：是否提供"再教一次"的入口（图例面板是否兼任手册）待定。来源＝待设计问题清单第 5 条。2026-10-04 五问讨论初裁＝不做「再教一次」，改走独立「帮助」手册面（全部内容放一个文档；见本节头注记）；帮助入口位置属未裁三疑点之一（设置面为推荐，Beta 立项时先裁）。
|
||||
|
||||
**缺口**：还差 Beta 立项后的帮助手册面定稿讨论（初裁待定稿＋帮助入口位置裁决）。
|
||||
|
||||
**归属**：教学引导定稿批（待教学形态定稿后评估）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
### 生涯（跨局汇总与历史回看承接面）
|
||||
|
||||
#### 「生涯」界面——冒险中数据回看的唯一承接处（2026-10-04 登记，来源=会话提及，设计面=文档轨）
|
||||
#### 「生涯」界面——冒险中数据回看的唯一承接处（2026-10-04 登记，来源=会话提及）
|
||||
|
||||
**现状**：2026-10-04 用户裁决（UI 落码计划 P-C7）——冒险中不给数据回看：settlement_review_overlay（结算明细回看）与结算框「明细回看」钮在冒险中退役，战报带只留单行「上轮」；历史战报/结算明细的查看去向＝新「生涯」界面（跨局汇总/历史冒险回看/图鉴承接）。来源＝UI 重设计原型 v2 落码计划裁决记录（已退役，git 历史可查 §七）。**设计提纲已成文**：[systems/跨局循环/生涯.md](design/gdd/systems/跨局循环/生涯.md) v0.1 范围草案五节成文〔信息架构/承载内容清单/与既有界面关系/分期实装建议/待裁点〕，P0-P5 六裁点已全裁并写入文档〔P0甲 提纲落现行事实源 / P1甲 主菜单一级入口 / P2甲 每局一行摘要+cap 扩容 N+补用时埋点 / P3甲 敌人图鉴优先 / P4甲 局内不放入口+生涯零跳转 / P5甲 settlement_review 复活承接〕。**期一已落地**（2026-10-07 迭代 18 卡④实装批：生涯页六类九项+主菜单入口+终身计数域存档 v6，批末全量域闸全绿；实机人闸＝体验验证清单⑲ 生涯页目检节）。剩余面＝期二（历史回看/图鉴）与期三实装＋P6 营地最近冒险条带去留（新发现待裁点，随提纲评审一并裁）。**迭代 19 卡②遗留件（2026-10-08 登记）**：settlement_review_overlay.gd 现态考证＝未接线遗留件（全仓零引用，M9 结算框改版「明细回看」钮退役后遗留）——处置两途：①随生涯实装批按 P5 甲复活承接（重接线入生涯）；②确认不再需要则正式退役删除文件；二选一归生涯实装批/用户裁。Alpha 出口裁决：期二、期三全部排 Beta——Alpha 只保留期一，不在 Alpha 内做生涯新内容。
|
||||
**实况**：2026-10-04 用户裁决（UI 落码计划 P-C7）——冒险中不给数据回看：settlement_review_overlay（结算明细回看）与结算框「明细回看」钮在冒险中退役，战报带只留单行「上轮」；历史战报/结算明细的查看去向＝新「生涯」界面（跨局汇总/历史冒险回看/图鉴承接）。来源＝UI 重设计原型 v2 落码计划裁决记录（已退役，git 历史可查 §七）。**设计提纲已成文**：[systems/跨局循环/生涯.md](design/gdd/systems/跨局循环/生涯.md) v0.1 范围草案五节成文〔信息架构/承载内容清单/与既有界面关系/分期实装建议/待裁点〕，P0-P5 六裁点已全裁并写入文档〔P0甲 提纲落现行事实源 / P1甲 主菜单一级入口 / P2甲 每局一行摘要+cap 扩容 N+补用时埋点 / P3甲 敌人图鉴优先 / P4甲 局内不放入口+生涯零跳转 / P5甲 settlement_review 复活承接〕。**期一已落地**（2026-10-07 迭代 18 卡④实装批：生涯页六类九项+主菜单入口+终身计数域存档 v6，批末全量域闸全绿；实机人闸＝体验验证清单⑲ 生涯页目检节）。剩余面＝期二（历史回看/图鉴）与期三实装＋P6 营地最近冒险条带去留（新发现待裁点，随提纲评审一并裁）。**迭代 19 卡②遗留件（2026-10-08 登记）**：settlement_review_overlay.gd 现态考证＝未接线遗留件（全仓零引用，M9 结算框改版「明细回看」钮退役后遗留）——处置两途：①随生涯实装批按 P5 甲复活承接（重接线入生涯）；②确认不再需要则正式退役删除文件；二选一归生涯实装批/用户裁。Alpha 出口裁决：期二、期三全部排 Beta——Alpha 只保留期一，不在 Alpha 内做生涯新内容。
|
||||
|
||||
**缺口**：还差提纲用户评审收尾与 P6 营地最近冒险条带去留裁决——裁完才能立期二/期三实装卡（期一已交付，期二/三未预占排期）。本条排 Beta，不阻塞 Alpha；重启时再补 P6 与 N 终值。
|
||||
|
||||
**归属**：新界面立项（用户发令后排批）；退役落码随 UI 落码批 M8/M9
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待文档设计（备选）
|
||||
|
||||
### GP 经济
|
||||
|
||||
#### 商店独立刷新机制——两参数待调参 + 机制文档回写（2026-10-04 登记，来源=会话提及，设计面=文档轨）
|
||||
#### 商店独立刷新机制——两参数待调参 + 机制文档回写（2026-10-04 登记，来源=会话提及）
|
||||
|
||||
**现状**：2026-10-04 用户裁决（P-C2+Q2 二次裁）推翻关卡节点地图 v1.5「无独立刷新、重抽绑购买」口径，定案＝**基础免费 0 次 + GP 刷新（ceil(20×1.8^已付费刷) provisional）+ 池源同源（共享池，与三选一同一账本）**；**天赋/营地侧「刷新次数」增益＝用户既有意向（口头裁决，曾因未写入文档丢失——Q2 追认），后续由用户调整添加，实现面预留 free_count=天赋增益位**。未定：天赋增益的具体形态与数值。**机制已落码**（SR-1 随 UI 落码批收官，2026-10-04/05）；**三选一同款付费刷新已落码**（2026-10-06 用户令——「三选一对齐商店，得有刷新」：免费双源〔刷新件 X/冒险池 Y〕用尽后 GP 付费刷新，同旋钮同曲线同钱包；机制登记归[秘宝](design/gdd/systems/跨局循环/秘宝.md)「三选一刷新双源」节）。剩余待办：①调参（shop_refresh_free/曲线两参数 provisional，归未来数值标定窗口顺带——M4 数值批已废）；②天赋增益形态与数值（设计未定）；③机制文档回写核对（冒险结构共享池账本节/关卡节点地图商店行 v1.6 已记，本条完成时核对三处同步）。
|
||||
**实况**：2026-10-04 用户裁决（P-C2+Q2 二次裁）推翻关卡节点地图 v1.5「无独立刷新、重抽绑购买」口径，定案＝**基础免费 0 次 + GP 刷新（ceil(20×1.8^已付费刷) provisional）+ 池源同源（共享池，与三选一同一账本）**；**天赋/营地侧「刷新次数」增益＝用户既有意向（口头裁决，曾因未写入文档丢失——Q2 追认），后续由用户调整添加，实现面预留 free_count=天赋增益位**。未定：天赋增益的具体形态与数值。**机制已落码**（SR-1 随 UI 落码批收官，2026-10-04/05）；**三选一同款付费刷新已落码**（2026-10-06 用户令——「三选一对齐商店，得有刷新」：免费双源〔刷新件 X/冒险池 Y〕用尽后 GP 付费刷新，同旋钮同曲线同钱包；机制登记归[秘宝](design/gdd/systems/跨局循环/秘宝.md)「三选一刷新双源」节）。剩余待办：①调参（shop_refresh_free/曲线两参数 provisional，归未来数值标定窗口顺带——M4 数值批已废）；②天赋增益形态与数值（设计未定）；③机制文档回写核对（冒险结构共享池账本节/关卡节点地图商店行 v1.6 已记，本条完成时核对三处同步）。
|
||||
|
||||
**缺口**：还差天赋增益形态与数值的设计讨论（用户调整时裁）与 M4 窗口的两参数标定；③回写核对随完成时点履行。
|
||||
|
||||
**归属**：M4 数值批（调参两参数顺带）；天赋增益随天赋侧内容批
|
||||
**改动面**：文档＋游戏代码
|
||||
|
||||
**状态**：待文档设计
|
||||
|
||||
### 文档与结构
|
||||
|
||||
#### qa/ 实现报告收尾·孤儿遗留七项余三项（2026-10-14 登记，来源=批次移交，设计面=工程直入）
|
||||
#### qa/ 实现报告收尾·孤儿遗留七项余三项（2026-10-14 登记，来源=批次移交）
|
||||
|
||||
**现状**：qa 收尾批核查 iter19 系列出口报告遗留移交项时发现**不在待办清单在册**的七项（acceptance-package §三.2/card0 §5.3/followup §七.3/uibackfill §6.2-4/verify §6.1/3/7）。已结案的（tree_rules 受理闭环、X/Y 双源、S1 七项违例修复、提灯目检项、tests.yml 休眠等）已在各报告标注结案证据，不入本条。2026-10-24 处置：第②③④项随迭代 36 卡C 落地销号（营地 STONE 深档六处、迷雾三关派生行、开场后缀条件加算区），第⑥项按用户 2026-10-24 裁整条注销（TG_* 装饰带非文字，不另立探针）。余三项均为挂号备查/顺路件，无排期承诺：
|
||||
**实况**：qa 收尾批核查 iter19 系列出口报告遗留移交项时发现**不在待办清单在册**的七项（acceptance-package §三.2/card0 §5.3/followup §七.3/uibackfill §6.2-4/verify §6.1/3/7）。已结案的（tree_rules 受理闭环、X/Y 双源、S1 七项违例修复、提灯目检项、tests.yml 休眠等）已在各报告标注结案证据，不入本条。2026-10-24 处置：第②③④项随迭代 36 卡C 落地销号（营地 STONE 深档六处、迷雾三关派生行、开场后缀条件加算区），第⑥项按用户 2026-10-24 裁整条注销（TG_* 装饰带非文字，不另立探针）。余三项均为挂号备查/顺路件，无排期承诺：
|
||||
|
||||
1. **design/diagrams 越界**（熵增闸存量红，archify 架构图批 00712d5 旧债）：脚本自文「新分类先过用户拍板再改两处白名单」。修案二选一——甲＝用户拍板 `design/diagrams` 入 DESIGN_SUBDIRS 白名单（archify 总图批产物归位）；乙＝迁出 design/ 归位合法区。**归属**：熵增闸白名单（AGENTS.md Project Layout+脚本白名单两处）
|
||||
5. **字面量墨收测前置**（iter19 卡②遗留）：bcard 属性描述/类型脚注/✓章/primary_button 字四处内联 Color8 无常量形态，收测需先在 ui_kit 立常量（呈现批顺路件，改 ui_kit 越当批面）。**归属**：呈现优化批（ui_kit 常量面）
|
||||
7. **商店房截图纳屏**（iter19 卡①遗留）：商店房截图纳屏留后续呈现批（考证结论在 shot_probe 头注）。本项原并列的「`数据配置.md:223` 历史行死指」半句已于 2026-10-21 实查核销——禁写变更记录规约生效后该文件的版本史行整段已不存在（现全文 212 行，文内零版本史行），被指对象随之消亡。**归属**：呈现批
|
||||
1. **design/diagrams 越界**（熵增闸存量红，archify 架构图批 00712d5 旧债）：脚本自文「新分类先过用户拍板再改两处白名单」。修案二选一——甲＝用户拍板 `design/diagrams` 入 DESIGN_SUBDIRS 白名单（archify 总图批产物归位）；乙＝迁出 design/ 归位合法区。落点＝熵增闸白名单（AGENTS.md Project Layout+脚本白名单两处）
|
||||
5. **字面量墨收测前置**（iter19 卡②遗留）：bcard 属性描述/类型脚注/✓章/primary_button 字四处内联 Color8 无常量形态，收测需先在 ui_kit 立常量（呈现批顺路件，改 ui_kit 越当批面）。落点＝呈现优化批（ui_kit 常量面）
|
||||
7. **商店房截图纳屏**（iter19 卡①遗留）：商店房截图纳屏留后续呈现批（考证结论在 shot_probe 头注）。本项原并列的「`数据配置.md:223` 历史行死指」半句已于 2026-10-21 实查核销——禁写变更记录规约生效后该文件的版本史行整段已不存在（现全文 212 行，文内零版本史行），被指对象随之消亡。落点＝呈现批
|
||||
|
||||
**归属**：①熵增闸白名单 ⑤呈现优化批 ⑦呈现批——逐项见现状清单
|
||||
**改动面**：游戏代码＋工具代码
|
||||
|
||||
**状态**：待写卡（备选）
|
||||
|
||||
#### 奖励节点三选一实装（2026-10-25 登记，来源=批次移交，设计面=工程直入）
|
||||
#### 奖励节点三选一实装（2026-10-25 登记，来源=批次移交）
|
||||
|
||||
**现状**：局内奖励节点现为零兑付直通占位——`game/core/level_runner.gd:462-466` `"reward"` 分支注记「奖励点内容未定…节点保留占位、零兑付直通」，实跑选路直接跳过；L1 全部模板零商店节点（`game/data/tables/level.tres` L1 行＝20 battle/5 boss/5 rest/5 reward，零 shop），现行局内 bonus 唯一可达来源＝L2 商店货架。而规格已定：[node-reward](design/gdd/ux/node-reward.md) v2.8＝奖励节点从冒险牌库抽三选一（属性值提升与补给；与通关专长三选一同库分流），池与库存口径归[冒险结构](design/gdd/systems/冒险循环/冒险结构.md)「奖励节点三选一池」节（共享令牌库、消耗即上限）。连带影响：迭代 36 卡C 路径②原设计「奖励节点拿属性卡→下一关开场行带后缀」不可驱动，已改快照喂入形态通过；wa4 探针半（三选一停点弹层头部断言）保留为条件断言、**拦截能力未证**（test-conventions §6 口径），本条实装后须重跑该断言。
|
||||
**实况**：局内奖励节点现为零兑付直通占位——`game/core/level_runner.gd:462-466` `"reward"` 分支注记「奖励点内容未定…节点保留占位、零兑付直通」，实跑选路直接跳过；L1 全部模板零商店节点（`game/data/tables/level.tres` L1 行＝20 battle/5 boss/5 rest/5 reward，零 shop），现行局内 bonus 唯一可达来源＝L2 商店货架。而规格已定：[node-reward](design/gdd/ux/node-reward.md) v2.8＝奖励节点从冒险牌库抽三选一（属性值提升与补给；与通关专长三选一同库分流），池与库存口径归[冒险结构](design/gdd/systems/冒险循环/冒险结构.md)「奖励节点三选一池」节（共享令牌库、消耗即上限）。连带影响：迭代 36 卡C 路径②原设计「奖励节点拿属性卡→下一关开场行带后缀」不可驱动，已改快照喂入形态通过；wa4 探针半（三选一停点弹层头部断言）保留为条件断言、**拦截能力未证**（test-conventions §6 口径），本条实装后须重跑该断言。
|
||||
|
||||
**归属**：[node-reward](design/gdd/ux/node-reward.md)（呈现）＋[冒险结构](design/gdd/systems/冒险循环/冒险结构.md)（节点内容与池）——level_runner.gd 奖励节点分支＋adventure 奖励节点候选
|
||||
**改动面**：游戏代码
|
||||
|
||||
**状态**：待写卡
|
||||
|
||||
#### 闸与探针存量噪声两件——_round_rows 类型错与批上下文挂死（2026-10-25 登记，来源=批次移交，设计面=工程直入）
|
||||
#### 闸与探针存量噪声两件——_round_rows 类型错与批上下文挂死（2026-10-25 登记，来源=批次移交）
|
||||
|
||||
**现状**：迭代 36 批末观测到两件存量噪声（非本批引入）：①`ui_click_probe` 与 `battle_log_view` 绿跑亦复现 `_round_rows`（Array[Dictionary]）append String 的运行期 TypedArray 报错——日志失真但断言仍绿；②`level_shop_economy_test` 在闸批量上下文存在挂死形态（直跑恒绿），`tools/probe_gate.sh` 的 per-suite timeout 只杀 wrapper 不杀引擎子进程，孤儿泄漏会殃及后续全部 Godot 启动（批末四次闸跑批中断的根源，处置＝清杀泄漏进程＋删重建 `game/.godot`）。两件均登记待后续测试基建批处置。
|
||||
**实况**：证据＝迭代 36 批末闸机观测（非本批引入）。两件存量噪声：①`ui_click_probe` 与 `battle_log_view` 绿跑亦复现 `_round_rows`（Array[Dictionary]）append String 的运行期 TypedArray 错误——日志失真但断言仍绿；②`level_shop_economy_test` 在闸批量上下文存在挂死形态（直跑恒绿），`tools/probe_gate.sh` 的 per-suite timeout 只杀 wrapper 不杀引擎子进程，孤儿泄漏会殃及后续全部 Godot 启动（批末四次闸跑批中断的根源，处置＝清杀泄漏进程＋删重建 `game/.godot`）。两件均登记待后续测试基建批处置。
|
||||
- 相关文档：`game/presentation/views/battle_log_view.gd` 与 `game/probe/ui_click_probe.gd`（类型面）；`tools/probe_gate.sh`（进程树回收面）——测试基建
|
||||
|
||||
**归属**：`game/presentation/views/battle_log_view.gd` 与 `game/probe/ui_click_probe.gd`（类型面）；`tools/probe_gate.sh`（进程树回收面）——测试基建
|
||||
**改动面**：游戏代码＋工具代码
|
||||
|
||||
**状态**：待写卡（备选）
|
||||
|
||||
#### 美术资产链路审计两项 P0 — 待用户裁决（2026-10-09 登记，来源=审计发现，设计面=双轨）
|
||||
#### 美术资产链路审计两项 P0 — 待用户裁决（2026-10-09 登记，来源=审计发现）
|
||||
|
||||
**现状**：**P0①（文档面）**：`design/art/art-bible.md` 第 68/527 行与 art-status-checklist 第 13 行至今仍引用已丢失的冻结样张 sample-batch-v3-final-2026-09-30.png（磁盘实测零命中），死指涉待修复。**P0②（美术面）**：主角棋盘小人未走像素管线（插值糊图），重产事项未在任何登记处在册。审计报告 HTML 件从未进版本库、现已删除，两项 P0 的现状以本条正文为准。裁＝修复死指涉+登记重产，或判过期随旧管线退役。2026-10-13 用户令随「UI 美化三层诊断」登记：本条属第三层「观感提升」，Alpha 阶段需完成。
|
||||
**实况**：**P0①（文档面）**：`design/art/art-bible.md` 第 68/527 行与 art-status-checklist 第 13 行至今仍引用已丢失的冻结样张 sample-batch-v3-final-2026-09-30.png（磁盘实测零命中），死指涉待修复。**P0②（美术面）**：主角棋盘小人未走像素管线（插值糊图），重产事项未在任何登记处在册。审计报告 HTML 件从未进版本库、现已删除，两项 P0 的现状以本条正文为准。裁＝修复死指涉+登记重产，或判过期随旧管线退役。2026-10-13 用户令随「UI 美化三层诊断」登记：本条属第三层「观感提升」，Alpha 阶段需完成。
|
||||
|
||||
**缺口**：还差用户的路线裁决（修复死指涉＋登记重产，还是判过期随旧管线退役）——裁决后文档面修复与美术重产登记各按轨推进。
|
||||
|
||||
**归属**：art（art-bible/美术管线）
|
||||
**改动面**：文档＋美术素材
|
||||
|
||||
**状态**：待文档设计＋待美术设计
|
||||
|
||||
#### 技术债观察登记——长函数余量与 lambda 连接防回归（2026-10-15 登记，来源=批次移交，设计面=工程直入）
|
||||
#### 技术债观察登记——长函数余量与 lambda 连接防回归（2026-10-15 登记，来源=批次移交）
|
||||
|
||||
**现状**：迭代 27 需求卡片两项「登记待办清单观察」义务批内漏登，卡片核对时补登——①**长函数 17 个**中非结算段的装配/校验函数（`level_map_screen.gd` 选路装配 155 行/`camp_overlay_view.gd` 152 行/`debug_overlay.gd` 114 行/`treasure_item_table.gd` schema 校验群等；`main._build_ui` 已随场景拆分自然解体、`_settle`/`_resolve_hero_attack` 已随波二拆段＝17 中 3 件已消解，余 14 件）；②**lambda 连接 76 处**（presentation 6/smoke 62/tests 8——实读无泄漏，登记防回归）。长函数拆分无独立需求驱动不动；lambda 连接数若有审计工具化需求归类型闸后续。
|
||||
**实况**：证据＝迭代 27 需求卡片两项「登记待办清单观察」义务批内漏登、卡片核对时补登——①**长函数 17 个**中非结算段的装配/校验函数（`level_map_screen.gd` 选路装配 155 行/`camp_overlay_view.gd` 152 行/`debug_overlay.gd` 114 行/`treasure_item_table.gd` schema 校验群等；`main._build_ui` 已随场景拆分自然解体、`_settle`/`_resolve_hero_attack` 已随波二拆段＝17 中 3 件已消解，余 14 件）；②**lambda 连接 76 处**（presentation 6/smoke 62/tests 8——实读无泄漏，登记防回归）。长函数拆分无独立需求驱动不动；lambda 连接数若有审计工具化需求归类型闸后续。
|
||||
|
||||
**归属**：工程债观察备忘（不阻塞，不排期；新增此类代码沿现役规范评审盯）
|
||||
**改动面**：游戏代码
|
||||
|
||||
**状态**：待写卡（备选）
|
||||
|
||||
#### 测试域遗留（2026-10-16 登记，来源=批次移交，设计面=工程直入）
|
||||
#### 测试域遗留（2026-10-16 登记，来源=批次移交）
|
||||
|
||||
**现状**：迭代 29 把验收语义从「跑一遍没崩＝通过」扭到「三层完备＋判定可靠」，三硬闸（退出码／脚本错误扫描／断言数下限）已落地，L2/L3 从零建起承载。本批未收的余量集中登记在此，均不阻塞、不排期：
|
||||
**实况**：证据＝迭代 29 批内未收余量（交付报告与验收审计申报，报告已按吸收即死退役、git 历史可考）。迭代 29 把验收语义从「跑一遍没崩＝通过」扭到「三层完备＋判定可靠」，三硬闸（退出码／脚本错误扫描／断言数下限）已落地，L2/L3 从零建起承载。本批未收的余量集中登记在此，均不阻塞、不排期：
|
||||
|
||||
| # | 事项 | 归属与要点 |
|
||||
| # | 事项 | 落点与要点 |
|
||||
|---|---|---|
|
||||
| 1 | **余下 3 个 core 模块仍零指名单测**：`board_data`／`reward_economy`／`skill_lottery` | 测试基建批。本批补了 minesweeper_rules／board_generator／config_db_resolver／config_db_cross_validator 四件；余三件按同一手法补（判据＝能否在 `--script` 模式不加载 autoload 验完） |
|
||||
| 2 | **render_gate 的 SCRIPT ERROR 扫描仍缺失** | 测试基建批。判定主体是 golden 容差与取证文件存在性，脚本错误不改退出码时无扫描面；本批只把矩阵状态如实记为「缺失」，收它的写法待裁 |
|
||||
@@ -614,112 +614,116 @@
|
||||
| 6 | **`smoke_all.gd` 拆分**（单文件承载 1127 项检查） | 工程债批。本批按契约只做入闸与改名裁点，不拆不重构；拆分登记在册 |
|
||||
| 7 | **parity 逐位一致比对的触面判定为粗粒度路径匹配** | 测试基建批。触面表含 `battle_orchestrator.gd`，改该文件即要求批准发起 MC；若嫌过重可精化到「是否改动取数/结算数值」的语义面 |
|
||||
|
||||
**归属**：测试基建批／工程债批（不阻塞，不排期）——逐条见现状表
|
||||
**改动面**：游戏代码
|
||||
|
||||
**状态**：待写卡（备选）
|
||||
|
||||
#### 营地交互重做·五张需求卡片（2026-10-18 登记，来源=会话提及，设计面=文档轨）
|
||||
#### 营地交互重做·五张需求卡片（2026-10-18 登记，来源=会话提及）
|
||||
|
||||
**现状**：2026-10-17~18 需求讨论澄清会话产出结论文档，用户令按工作内容维度拆卡、卡片不预占迭代号。五卡已写（顺序＝执行顺序）：①存档制数据层改造批 ②主菜单三入口化批 ③选档界面新建批 ④营地场景图新建批 ⑤Esc 浮窗与营地顶栏批（各卡估时与内容见卡片自身）。三道复核：grilling 子 Agent 对抗审查（五卡各一）→v1.1；用户裁定「事项按推荐的来」→v1.2；用户两次订正（**卡④留在批内不踢出**；前置归用户自立批，Agent 不代跑不代产——曾越权起草的点选反馈设计稿 v0.1 已撤回删除）→卡④ v2.2；**卡④ 2026-10-21 用户令退回美术设计段（v2.3，非有效卡，美术设计闭合后重立卡）**。①②③⑤ 零待裁点可编工程波次：②③ 硬耦合同波（「进入存档」钮落点＝选档界面），① 是 ③ 前置；⑤ 随 ④ 代码波同行。Alpha 出口裁决（2026-10-21 用户裁）：五卡整体列入 Alpha——08「三 · 界面」已开条目，Alpha 出口依赖五卡完工与卡④三个用户侧前置销号。**工程波次一已落地（2026-10-22）**：卡①②③ 随迭代 33 实现批合回 master（合并提交 ebf40947／5c2a7bcf／508f190b，总收口 6e8f72b2），三卡需求卡片与批次产出物已按「吸收即死」退役（设计口径已吸收进 存档序列化.md／生涯.md／camp.md／08-Alpha版本标准.md v1.13／art-bible.md v3.18，反哺落文凭据=文档批 git 提交 1864f157＋9f7b3e8a）；卡④（营地场景图）退回美术设计段待重立卡、卡⑤（Esc 浮窗）随卡④ 代码波同行，两卡未编排——编入哪一迭代由用户经迭代编排段发令。关联文档：
|
||||
**实况**：2026-10-17~18 需求讨论澄清会话产出结论文档，用户令按工作内容维度拆卡、卡片不预占迭代号。五卡已写（顺序＝执行顺序）：①存档制数据层改造批 ②主菜单三入口化批 ③选档界面新建批 ④营地场景图新建批 ⑤Esc 浮窗与营地顶栏批（各卡估时与内容见卡片自身）。三道复核：grilling 子 Agent 对抗审查（五卡各一）→v1.1；用户裁定「事项按推荐的来」→v1.2；用户两次订正（**卡④留在批内不踢出**；前置归用户自立批，Agent 不代跑不代产——曾越权起草的点选反馈设计稿 v0.1 已撤回删除）→卡④ v2.2；**卡④ 2026-10-21 用户令退回美术设计段（v2.3，非有效卡，美术设计闭合后重立卡）**。①②③⑤ 零待裁点可编工程波次：②③ 硬耦合同波（「进入存档」钮落点＝选档界面），① 是 ③ 前置；⑤ 随 ④ 代码波同行。Alpha 出口裁决（2026-10-21 用户裁）：五卡整体列入 Alpha——08「三 · 界面」已开条目，Alpha 出口依赖五卡完工与卡④三个用户侧前置销号。**工程波次一已落地（2026-10-22）**：卡①②③ 随迭代 33 实现批合回 master（合并提交 ebf40947／5c2a7bcf／508f190b，总收口 6e8f72b2），三卡需求卡片与批次产出物已按「吸收即死」退役（设计口径已吸收进 存档序列化.md／生涯.md／camp.md／08-Alpha版本标准.md v1.13／art-bible.md v3.18，反哺落文凭据=文档批 git 提交 1864f157＋9f7b3e8a）；卡④（营地场景图）退回美术设计段待重立卡、卡⑤（Esc 浮窗）随卡④ 代码波同行，两卡未编排——编入哪一迭代由用户经迭代编排段发令。关联文档：
|
||||
- 设计澄清定稿：reports/需求澄清-营地交互重做-2026-10-18.md（v1.0：目标体验原话／目标结构树＋纵深稿／10 条交互裁决／验收口径／切批原则／遗留待裁）
|
||||
- 卡④：reports/需求卡片-营地场景图新建批-2026-10-18.md（v2.3，**2026-10-21 用户令退回美术设计段，非有效卡**，美术设计闭合后重立卡，见缺口）
|
||||
- 卡⑤：reports/需求卡片-ESC浮窗与营地顶栏批-2026-10-18.md
|
||||
|
||||
**缺口**：卡④（营地场景图）**已退回美术设计段**（2026-10-21 用户令）——美术轨未闭合，按 req-card 第〇步不具写卡资格，现卡 v2.3 为非有效卡，五项前置销号后方可重立卡：P1 美术渠道（**2026-10-22 已裁＝B 插画级新产**，✦ 渠道作者自跑远程生图管线；规格沿用 art-bible §8.1/§8.2 既有裁决）；P2 像素规格（Q6 甲过渡口径已裁，执行归用户线）；P3 点选反馈设计稿（用户线，未受命开工；Agent 曾越权起草 v0.1，已按用户令撤回删除）；P4 参照物（用户后续找）；P5 GDD/art-bible 落文（定稿后用户发令）。销号完毕且美术定稿（样张过审＋art-bible 条款版本）后卡④方可进代码实现波次。
|
||||
**缺口**：卡④（营地场景图）**已退回美术设计段**（2026-10-21 用户令）——美术线未闭合，按 req-card 第〇步不具写卡资格，现卡 v2.3 为非有效卡，五项前置销号后方可重立卡：P1 美术渠道（**2026-10-22 已裁＝B 插画级新产**，✦ 渠道作者自跑远程生图管线；规格沿用 art-bible §8.1/§8.2 既有裁决）；P2 像素规格（Q6 甲过渡口径已裁，执行归用户线）；P3 点选反馈设计稿（用户线，未受命开工；Agent 曾越权起草 v0.1，已按用户令撤回删除）；P4 参照物（用户后续找）；P5 GDD/art-bible 落文（定稿后用户发令）。销号完毕且美术定稿（样张过审＋art-bible 条款版本）后卡④方可进代码实现波次。
|
||||
|
||||
**归属**：营地交互重做（数据层＋呈现层＋美术线；五卡路径见现状清单，批次归属与波次由用户按工作量另裁）
|
||||
**改动面**：文档＋游戏代码＋美术素材
|
||||
|
||||
**状态**：文档设计已闭合＋待美术设计＋已写卡＋已写卡
|
||||
|
||||
#### 需求卡片入库纪律未登记——502 批遗留的悬空待办（2026-10-18 登记，来源=批次移交，设计面=反哺点）
|
||||
#### 需求卡片入库纪律未登记——502 批遗留的悬空待办（2026-10-18 登记，来源=批次移交）
|
||||
|
||||
**现状**：2026-10-16 迭代 29 编入批（提交 `21c83f5`）认定「需求卡片写进了 roadmap 却没在待办清单登记」属流程漏洞，需要补一条卡片入库纪律。该条至今在待办清单清单内查无（2026-10-17 与 2026-10-18 两次全文检索零命中）。唯一记过它的地方是根目录状态文件未决面第 31 行，该文件已于 2026-10-18 用户裁废除，故改记本条防遗忘。待裁：这条纪律要不要立；立则写进归属所指的 process-conventions。
|
||||
**实况**：2026-10-16 迭代 29 编入批（提交 `21c83f5`）认定「需求卡片写进了 roadmap 却没在待办清单登记」属流程漏洞，需要补一条卡片入库纪律。该条至今在待办清单清单内查无（2026-10-17 与 2026-10-18 两次全文检索零命中）。唯一记过它的地方是根目录状态文件未决面第 31 行，该文件已于 2026-10-18 用户裁废除，故改记本条防遗忘。待裁：这条纪律要不要立；立则写进归属所指的 process-conventions。
|
||||
- 相关文档：design/engineering/process-conventions.md 五段流水线的登记段
|
||||
|
||||
**归属**：design/engineering/process-conventions.md 五段流水线的登记段
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待裁决
|
||||
|
||||
---
|
||||
|
||||
#### req-card 技能的 WorkBuddy 与 ZCode 两份副本内容不一致——取齐待裁（2026-10-18 登记，来源=批次移交，设计面=反哺点）
|
||||
#### req-card 技能的 WorkBuddy 与 ZCode 两份副本内容不一致——取齐待裁（2026-10-18 登记，来源=批次移交）
|
||||
|
||||
**现状**：用户级技能 req-card 在本机有两份副本，分别位于 WorkBuddy 与 ZCode 两个 harness 的用户目录 skills/req-card/SKILL.md（都在仓库之外，仓内没有任何登记处）。2026-10-18 逐字节比对：两份内容不同——迭代 28 那批只补了 ZCode 一份，WorkBuddy 那份没跟着改。这条欠账此前只记在根目录会话状态文件的未决面第 32 行，该文件已于 2026-10-18 用户裁废除，故改记本条。待裁：以哪一份为权威取齐，或两份各自演化。
|
||||
**实况**：用户级技能 req-card 在本机有两份副本，分别位于 WorkBuddy 与 ZCode 两个 harness 的用户目录 skills/req-card/SKILL.md（都在仓库之外，仓内没有任何登记处）。2026-10-18 逐字节比对：两份内容不同——迭代 28 那批只补了 ZCode 一份，WorkBuddy 那份没跟着改。这条欠账此前只记在根目录会话状态文件的未决面第 32 行，该文件已于 2026-10-18 用户裁废除，故改记本条。待裁：以哪一份为权威取齐，或两份各自演化。
|
||||
|
||||
**归属**：用户级技能 req-card（仓库外两份副本）
|
||||
**改动面**：工具代码
|
||||
|
||||
**状态**：待裁决
|
||||
|
||||
---
|
||||
|
||||
#### 「魔法道具」与「罕见」两个旧叫法的残留未扫——扫不扫待裁（2026-10-18 登记，来源=批次移交，设计面=反哺点）
|
||||
#### 「魔法道具」与「罕见」两个旧叫法的残留未扫——扫不扫待裁（2026-10-18 登记，来源=批次移交）
|
||||
|
||||
**现状**：「魔法道具」随 2026-09-15 可选类道具删除而失效，「罕见」随 2026-09-14 分辨率档位批换装而失效，正文里仍有残留。2026-10-18 实数（全仓 markdown 检索）：魔法道具 23 处、罕见 17 处；此前根目录状态文件记的「约 30 处／约 18 处」系旧读数。两词都不在 `tools/doc_term_audit.py` 的退役词表里，机器闸抓不到，只能人工裁。待裁：扫或不扫；扫则把两词追加进 doc_term_audit 退役词表防再犯。
|
||||
**实况**：「魔法道具」随 2026-09-15 可选类道具删除而失效，「罕见」随 2026-09-14 分辨率档位批换装而失效，正文里仍有残留。2026-10-18 实数（全仓 markdown 检索）：魔法道具 23 处、罕见 17 处；此前根目录状态文件记的「约 30 处／约 18 处」系旧读数。两词都不在 `tools/doc_term_audit.py` 的退役词表里，机器闸抓不到，只能人工裁。待裁：扫或不扫；扫则把两词追加进 doc_term_audit 退役词表防再犯。
|
||||
- 相关文档：design/gdd/ 正文用语（权威对照=design/gdd/术语表.md）
|
||||
|
||||
**归属**：design/gdd/ 正文用语（权威对照=design/gdd/术语表.md）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待裁决
|
||||
|
||||
---
|
||||
|
||||
#### 「通关」与「通过第 N 关」两种口径混用——统一与否待裁（2026-10-18 登记，来源=批次移交，设计面=反哺点）
|
||||
#### 「通关」与「通过第 N 关」两种口径混用——统一与否待裁（2026-10-18 登记，来源=批次移交）
|
||||
|
||||
**现状**：「通关」一词既被用来指「打完一整局冒险」，也被用来指「通过第 N 关」，2026-10-18 实测 design/gdd 内 188 处（此前状态文件记 273 处，口径是全仓）。歧义直接影响难度曲线读数与验收判据的表述——同一个「通关率」两种读法差一个数量级。待裁：是否定单一口径并逐处改写。
|
||||
**实况**：「通关」一词既被用来指「打完一整局冒险」，也被用来指「通过第 N 关」，2026-10-18 实测 design/gdd 内 188 处（此前状态文件记 273 处，口径是全仓）。歧义直接影响难度曲线读数与验收判据的表述——同一个「通关率」两种读法差一个数量级。待裁：是否定单一口径并逐处改写。
|
||||
- 相关文档：design/gdd/01-核心循环.md 与难度曲线、验收类文档的措辞口径
|
||||
|
||||
**归属**：design/gdd/01-核心循环.md 与难度曲线、验收类文档的措辞口径
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待裁决
|
||||
|
||||
---
|
||||
|
||||
#### 流程动词族黑话的第二波清扫待发令——GDD 正文约三千处（2026-10-18 登记，来源=批次移交，设计面=反哺点）
|
||||
#### 流程动词族黑话的第二波清扫待发令——GDD 正文约三千处（2026-10-18 登记，来源=批次移交）
|
||||
|
||||
**现状**：2026-10-15 用语规范批只按 A 表替换了词面约 250 处（十二行），流程动词族——需要作者额外解释才看得懂的一类说法——在 GDD 正文仍有约三千处未处理。第二波至今未发令。待裁：第二波的范围与发令时点。
|
||||
**实况**：2026-10-15 用语规范批只按 A 表替换了词面约 250 处（十二行），流程动词族——需要作者额外解释才看得懂的一类说法——在 GDD 正文仍有约三千处未处理。第二波至今未发令。待裁：第二波的范围与发令时点。
|
||||
- 相关文档：design/gdd 全树正文用语（权威词表=design/gdd/术语表.md 用语规范节）
|
||||
|
||||
**归属**：design/gdd 全树正文用语（权威词表=design/gdd/术语表.md 用语规范节）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：待裁决
|
||||
|
||||
---
|
||||
|
||||
#### 调试入口写死行必须在发布前删除——game/presentation/main.gd:196（2026-10-18 登记，来源=批次移交，设计面=工程直入）
|
||||
#### 调试入口写死行必须在发布前删除——game/presentation/main.gd:196（2026-10-18 登记，来源=批次移交）
|
||||
|
||||
**现状**：2026-10-16 用户令把调试入口改为恒开，`game/presentation/main.gd:196` 的 `_debug_entry` 现恒为 true、不再读环境变量（2026-10-18 实查该行仍为 `_debug_entry = true` 并带「发布前清」注释；:197 是最顶层浮层角标的可见性赋值）。发布前删掉 :196 这一行即可——角标可见性随门控失效自动隐藏，无第二处改动点。不删的后果：正式包里调试浮层与角标常显。证据=该行代码注释与 2026-10-16 调试入口批的实装记录。
|
||||
**实况**：2026-10-16 用户令把调试入口改为恒开，`game/presentation/main.gd:196` 的 `_debug_entry` 现恒为 true、不再读环境变量（2026-10-18 实查该行仍为 `_debug_entry = true` 并带「发布前清」注释；:197 是最顶层浮层角标的可见性赋值）。发布前删掉 :196 这一行即可——角标可见性随门控失效自动隐藏，无第二处改动点。不删的后果：正式包里调试浮层与角标常显。证据=该行代码注释与 2026-10-16 调试入口批的实装记录。
|
||||
|
||||
**归属**：game/presentation/main.gd（Alpha 发布准备）
|
||||
**改动面**：游戏代码
|
||||
|
||||
**状态**：待写卡
|
||||
|
||||
|
||||
---
|
||||
|
||||
#### L3 屏壳切换探针的判定被仓库外存档状态污染，跑批绿红不可复现（2026-10-18 登记，来源=审计发现，设计面=工程直入）
|
||||
#### L3 屏壳切换探针的判定被仓库外存档状态污染，跑批绿红不可复现（2026-10-18 登记，来源=审计发现）
|
||||
|
||||
**现状**：2026-10-18 卫生批跑全量档时 03 探针 --click 与 04 探针 --full 双双「基线绿→现红」，唯一失效单元是 `game/probe/screen_flow_probe.gd` 的第④步（菜单开新冒险进不去，⑤⑥⑦三条随之因前置不满足连带红）。根因已钉死且与本批及任何代码改动无关：`user://save.json`（主区与所有 worktree 共用同一份、不入 git）里现存一个 `breakpoint` 断点，而 `game/presentation/main.gd:476-482` 按「二轮修改批 A」的用户目检裁决，在 `save_manager.has_breakpoint()` 时弹实底确认框「已有未完冒险（第 N 关）——开新冒险将覆盖旧断点」并直接返回、不开冒险；探针第④步只用前缀匹配找「▶ 开始冒险」并按下、等 3 帧就断言进冒险屏，它隐含假设「存档里没有断点」。三条判据：主区那份未受本批影响的 master（`ea69670c`）单跑同一探针复现完全一样的 7 处；同一 worktree 同一代码把 save.json 临时移开再跑立刻 `PASS — 六步主流程＋回退路径全绿`（跑完存档逐字节还原，sha1 `dd67444c35be` 与移开前一致）；`game/**/*.gd` 自 10-17 那次绿回执 `7ffd1dc0` 之后零改动。断点来源＝上一轮 `ui_click_probe` 或任一会话跑到中途留下的未完冒险（存档账目已累积到 `adventure_total=6`、`level_clear_counts={1:18,2:7,3:4}`）。后果是验证闸的绿红取决于「这台机器上谁最后跑过」，正是 test-conventions §8「判定可靠性优先于覆盖率」所管的同一类缺陷。修复方向两条，均待写卡时定：探针侧自救（第④步前先走弃断点通道，或在确认框上按「开新冒险」再断言）＝改 `game/`；跑批侧隔离（给探针配独立 user 目录）＝改 `tools/probe_gate.sh`，⚠ 此路有一条未验障碍——本日用 `--user-dir` 指到空目录跑该探针，Godot 挂住零输出、超时未出结论，走这条要先查明成因。证据已指认，按 §12.1 工程直入通道跳过设计轨。
|
||||
**实况**：2026-10-18 卫生批跑全量档时 03 探针 --click 与 04 探针 --full 双双「基线绿→现红」，唯一失效单元是 `game/probe/screen_flow_probe.gd` 的第④步（菜单开新冒险进不去，⑤⑥⑦三条随之因前置不满足连带红）。根因已钉死且与本批及任何代码改动无关：`user://save.json`（主区与所有 worktree 共用同一份、不入 git）里现存一个 `breakpoint` 断点，而 `game/presentation/main.gd:476-482` 按「二轮修改批 A」的用户目检裁决，在 `save_manager.has_breakpoint()` 时弹实底确认框「已有未完冒险（第 N 关）——开新冒险将覆盖旧断点」并直接返回、不开冒险；探针第④步只用前缀匹配找「▶ 开始冒险」并按下、等 3 帧就断言进冒险屏，它隐含假设「存档里没有断点」。三条判据：主区那份未受本批影响的 master（`ea69670c`）单跑同一探针复现完全一样的 7 处；同一 worktree 同一代码把 save.json 临时移开再跑立刻 `PASS — 六步主流程＋回退路径全绿`（跑完存档逐字节还原，sha1 `dd67444c35be` 与移开前一致）；`game/**/*.gd` 自 10-17 那次绿回执 `7ffd1dc0` 之后零改动。断点来源＝上一轮 `ui_click_probe` 或任一会话跑到中途留下的未完冒险（存档账目已累积到 `adventure_total=6`、`level_clear_counts={1:18,2:7,3:4}`）。后果是验证闸的绿红取决于「这台机器上谁最后跑过」，正是 test-conventions §8「判定可靠性优先于覆盖率」所管的同一类缺陷。修复方向两条，均待写卡时定：探针侧自救（第④步前先走弃断点通道，或在确认框上按「开新冒险」再断言）＝改 `game/`；跑批侧隔离（给探针配独立 user 目录）＝改 `tools/probe_gate.sh`，⚠ 此路有一条未验障碍——本日用 `--user-dir` 指到空目录跑该探针，Godot 挂住零输出、超时未出结论，走这条要先查明成因。证据已指认，按 §12.1 属需求性工程条目，跳过设计线。
|
||||
|
||||
**归属**：game/probe/screen_flow_probe.gd（探针自救面）与 tools/probe_gate.sh（跑批隔离面）——测试基建
|
||||
**改动面**：游戏代码＋工具代码
|
||||
|
||||
**状态**：待写卡
|
||||
|
||||
|
||||
---
|
||||
|
||||
#### 效果引擎「系统无状态」原则缺架构文档条目（2026-10-20 登记，来源=会话提及）
|
||||
|
||||
#### 效果引擎「系统无状态」原则缺架构文档条目（2026-10-20 登记，来源=会话提及，设计面=文档轨）
|
||||
|
||||
**现状**：用户 2026-10-19 会话裁定的 ECS 架构依据（系统无状态——效果引擎这类系统零运行时可变状态、数据由宿主对象持有并随宿主生灭、状态按参数传入系统、系统只做判定）是「效果引擎无状态化」重构批的立项判据（上游＝迭代 31 卡② 移交的计数器寿命域判据线——该登记条目已在本条闭合时整条删除，判据现由 architecture.md v1.9 条 8 承载；提案=reports/提案-效果引擎无状态化-2026-10-19.md v1.3 §7.9 #1），但 `design/engineering/architecture/architecture.md`「架构原则」节（原 7 条）无「系统无状态」条目——立项判据暂无权威文档出处（2026-10-19 全仓检索「无状态／纯计算」零命中，提案 §10.3 实查；原 `design/registry/` 两 yaml 已随 2026-10-19 用户裁注销删除，无可迁凭据）。重构批是代码批、禁写 `design/`，文档级补条只能另立文档批。
|
||||
**实况**：用户 2026-10-19 会话裁定的 ECS 架构依据（系统无状态——效果引擎这类系统零运行时可变状态、数据由宿主对象持有并随宿主生灭、状态按参数传入系统、系统只做判定）是「效果引擎无状态化」重构批的立项判据（上游＝迭代 31 卡② 移交的计数器寿命域判据线——该登记条目已在本条闭合时整条删除，判据现由 architecture.md v1.9 条 8 承载；提案=reports/提案-效果引擎无状态化-2026-10-19.md v1.3 §7.9 #1），但 `design/engineering/architecture/architecture.md`「架构原则」节（原 7 条）无「系统无状态」条目——立项判据暂无权威文档出处（2026-10-19 全仓检索「无状态／纯计算」零命中，提案 §10.3 实查；原 `design/registry/` 两 yaml 已随 2026-10-19 用户裁注销删除，无可迁凭据）。重构批是代码批、禁写 `design/`，文档级补条只能另立文档批。
|
||||
|
||||
**现状换代（2026-10-21 文档批写入完成）**：architecture.md「架构原则」节已补第 8 条「系统无状态」（条文序位=呈现层契约成文条之后，与条 1 核心层纯逻辑、条 5 fail-fast 交叉核过无冲突），effect_engine 模块行与战斗域装配节同步改写为 ctx 形态描述——design/engineering/architecture/architecture.md v1.9（2026-10-21 用户裁写入）。
|
||||
|
||||
**归属**：design/engineering/architecture/architecture.md（架构原则节）
|
||||
**改动面**：文档
|
||||
|
||||
**状态**：文档设计已闭合
|
||||
|
||||
---
|
||||
|
||||
#### 结算明细日志行序重锚批（2026-10-21 登记，来源=批次移交，设计面=反哺点）
|
||||
#### 结算明细日志行序重锚批（2026-10-21 登记，来源=批次移交）
|
||||
|
||||
**现状**：迭代 32 卡① N7 改动互换 `seal_miss`／`insurance_used` 两行日志顺序并改写豁免态 highlight（豁免态＝insurance_used 行先行且 highlight 置空；未豁免态＝两行相对序不变但 `seal_miss` 发射时点后移——完整对照见 git 提交 d00f24a8 批内实现报告，报告已退役）；`playtest_logger._on_step_row` 逐行落盘含 highlight 字段，与基线数据逐项比对的 JSONL sha256 校验必红，实现批按规未发起、11 号闸落 skip。**用户 2026-10-21 裁＝批准另立重锚批，发起时点另定**（重锚批只能由用户发起）。
|
||||
**实况**：迭代 32 卡① N7 改动互换 `seal_miss`／`insurance_used` 两行日志顺序并改写豁免态 highlight（豁免态＝insurance_used 行先行且 highlight 置空；未豁免态＝两行相对序不变但 `seal_miss` 发射时点后移——完整对照见 git 提交 d00f24a8 批内实现报告，报告已退役）；`playtest_logger._on_step_row` 逐行落盘含 highlight 字段，与基线数据逐项比对的 JSONL sha256 校验必红，实现批按规未发起、11 号闸落 skip。**用户 2026-10-21 裁＝批准另立重锚批，发起时点另定**（重锚批只能由用户发起）。
|
||||
- 相关文档：`sim-data/` 锚与 `tools/parity_anchor.py`（重锚执行归用户发令批）
|
||||
|
||||
**归属**：`sim-data/` 锚与 `tools/parity_anchor.py`（重锚执行归用户发令批）
|
||||
**改动面**：工具代码
|
||||
|
||||
**状态**：待裁决
|
||||
Reference in new issue
Block a user