工程+文档(B7色数治理·用户令): 色板整屏总闸三件落地——art-bible v3.36 §4.1色板分层增第三层「整屏有效色数总闸」(裁判面=成片出现的颜色数,上限128待定现用,构成推导源32x2+48+16,超限先合并禁加色,测量口径归闸件不载圣经)+shot_checker判据(有效色数=面积≥0.25%成片颜色,锯齿/字缘/阴影环/渐变中间带不判断·2026-11-02用户裁降噪口径;地板40整屏口径不变;上限128)+待办条目「正常屏唯一色数收敛」完成整条删除(双轨口径/上限/落点三点用户裁决闭合,现役七屏有效24~74全绿无治理面,吸收即死); 阈值扫描四档实测定0.25%(1-4Kpx中间带=阴影环渐变居所整带滤净,0.5%+连icon级token色都漏); 闸烟测camp eff=24与扫描一致

This commit is contained in:
DKChan committed 2026-11-02 04:27:27 +08:00
1 parent 5999cc7ba4
commit e3d362b767
3 files changed
+16 -14

No files matched your search

+2 -1
View File
@@ -1,6 +1,6 @@
# 美术圣经(Art Bible)— Dungeon Sweeper
> 项目:Dungeon Sweeper(扫雷 × 自动战斗 闯关 Roguelike)· 状态:**第 1–9 节定稿**;现行为 v3.35,历次修订明细见 git 提交史
> 项目:Dungeon Sweeper(扫雷 × 自动战斗 闯关 Roguelike)· 状态:**第 1–9 节定稿**;现行为 v3.36,历次修订明细见 git 提交史
>
> **Art Director Sign-Off(AD-ART-BIBLE)**:历次批均未签核——此为 Lean/Solo 模式(非 PHASE-GATE)下的现行治理状态;full 门禁签核时机待用户表态。
> 风格基调:地牢题材但**非暗黑风**——轻快明亮的幻想冒险风,全年龄;像素风;角色 2~3 头身。
@@ -222,6 +222,7 @@
- **换色合并欠账清单(全板重扫 6 对不达标,逐对清偿)**:`#18120C` ↔ `#181410`、`#33261B` ↔ `#362B20`、`#362B20` ↔ `#3A2E22`、`#3E362C` ↔ `#3E3731`、`#3E4048` ↔ `#3F4147`、`#453723` ↔ `#4A3B2A`——六对按「不过门即换色合并」纪律逐对清偿(并进最近既有色);清偿前该对不视作合规,清偿动作落本节修订。**本节所举反例 `#3A2E22` ↔ `#362B20` 正在这 6 对之内**,与本口径自洽。验收:机检〈全板色对中三通道差全部 <8/255 的对数 = 0〉
- **色板分层**:色板分两层管理——① **语义/UI token 板**:全作共享,硬上限 **48 色**,管 UI 语义色、墨色、材质色,跨屏恒定;② **场景环境子板**:**每屏一套,≤32 色,允许跨屏不共享**(环境色 = 天空、地面、植被、石材、火焰等随场景走的颜色)。新增环境色仍须过两道门(§4.2 语义检查 + 与既有任一色 RGB 三通道差禁止全部 <8/255),但**不占用 48 token 额度**;不过门照旧走「换色合并」,**禁加色绕行**。单张 PNG 的像素域色数上限 **≤32 色**另由 `standee_asset_check` 执法(按单图像素域取值方式计数,与本表 token 计数互不干扰)。额度不足时向作者报告,由作者决定压缩或合并既有色。验收:机检〈token 板 ≤48;每屏环境子板 ≤32〉
- **整屏有效色数总闸(色板第三层,2026-11-02 用户裁)**|整屏的色板纪律裁判面=**画面上成片出现的颜色数(有效色数)**,不是逐像素去重总数:多源并集与程序混合(压暗遮罩/软阴影/渐变/tween 中间帧)使逐像素色数随素材与渲染状态大幅漂移(实测同屏不同时点差一至九倍),不可治理也不承载观感。整屏唯一色数只保留「渲染真实发生」的存在性地板(地板值归闸件承载);**色板纪律的上限闸=每屏有效色数 ≤128**(**待定现用**——现行即执法、修订走登记,释义同色板增量纪律条)。构成推导源:双环境层 32×2+token 板 48+混合容差 16(←本条色板分层;推导源非额度分配,各层额度照旧独立执法)。超限处置沿色板增量纪律:先合并压缩既有色再进,禁加色绕行。有效色的测量口径(面积阈值等实现参数)归色数检查器承载,本圣经不载。验收:机检〈各屏有效色数 ≤128,口径=色数检查器现行定义〉
### 4.2 语义色彩规则
+14 -3
View File
@@ -8,7 +8,9 @@ r"""shot_checker.py — 整屏样张闸机检(B 档断言骨架扩全)。
断言(整屏样张闸 §1.4 四项的机检可判面):
A 屏级骨架: PNG 存在/尺寸=工程档/灰度 std≥8/唯一色数≥40(渲染真实发生——std≥8 取值在
圣经 §7.2 文字 4.5:1 推论下界之下、正常实测最低 19.3 之上;色数 40=正常实测地板 60
〔营地场景图,七屏最低〕的 2/3,低于一切正常屏,色数异常回落=画面异常信号,停下人工复查);
〔营地场景图,七屏最低〕的 2/3,低于一切正常屏,色数异常回落=画面异常信号,停下人工复查)/
有效色数≤128(色板整屏总闸,圣经 §4.1 第三层——只数面积 ≥0.25% 的成片颜色,锯齿/字缘/
阴影环/渐变中间带不判断,2026-11-02 用户裁口径;地板 40 保留整屏口径不变);
B 文字对比度: 已知文字框〔主墨/暖白 文字簇 vs 背景簇 p2/p98 极性无关〕WCAG ≥4.5:1
(战斗 C 区面板/结算明细提示等已知文字框——圣经 v3.5 §7.2 全局文字硬指标机检面);
C 明度三档带: 战斗屏 信息面(C 区面板均值) > 世界中(棋盘区均值) > 世界底(舞台无光柱区均值)
@@ -134,14 +136,23 @@ def main() -> int:
total = sum(hist)
mean = sum(i * c for i, c in enumerate(hist)) / total
std = (sum(c * (i - mean) ** 2 for i, c in enumerate(hist)) / total) ** 0.5
colors = len(set(img.getdata()))
color_counts = {}
for px in img.getdata():
color_counts[px] = color_counts.get(px, 0) + 1
colors = len(color_counts)
# 有效色数=面积 ≥0.25% 的成片颜色(1280 档=2560px)——锯齿/字缘/阴影环/渐变中间带
# 不判断(2026-11-02 用户裁降噪口径);地板 40 保留整屏口径不变。
eff_colors = sum(1 for v in color_counts.values() if v >= img.size[0] * img.size[1] * 0.0025)
if std < 8.0:
failures.append("%s: 灰度 std %.1f < 8(疑似空白/纯色)" % (name, std))
# 唯一色数下限=正常实测地板 60(营地场景图,七屏最低)的 2/3——低于一切正常屏;
# 色数异常回落=画面异常信号,停下人工复查。
if colors < 40:
failures.append("%s: 唯一色数 %d < 40(色数异常回落)" % (name, colors))
print("[shot_checker] %s — %s std=%.1f colors=%d" % (name, "x".join(map(str, img.size)), std, colors))
# 整屏有效色数总闸=色板纪律第三层上限(art-bible §4.1,2026-11-02 用户裁 128)。
if eff_colors > 128:
failures.append("%s: 有效色数 %d > 128(色板整屏总闸超限)" % (name, eff_colors))
print("[shot_checker] %s — %s std=%.1f colors=%d eff=%d" % (name, "x".join(map(str, img.size)), std, colors, eff_colors))
# B+C+D 断言(battle/menu 两屏为机检承载屏;camp/level 走骨架+目检清单)
if "shot_battle.png" in imgs:
-10
View File
@@ -2,16 +2,6 @@
本清单是流水线的唯一登记处:以后才做的事在此登记一条,随流水线段推进改状态,做完整条删除(条目记进度,不是各段的开工前置);各系统文档的「待办」节只留一行指路存根,不再自建条目。条目格式(标题=登记元数据含可选优先级,正文=实况/缺口/改动面/状态四属性)与状态机以 [doc-conventions §12.1](design/engineering/doc-conventions.md) 为权威。
#### 正常屏唯一色数收敛(2026-11-01 登记,来源=会话提及)
**实况**:实测凭据=render_gate 七屏 shot_checker 读数(2026-11-01 会话实测,1280 档整屏唯一色数):营地 60/设置 125/生涯 736/关卡 843/状态 865/菜单 968/战斗 1579–1884;历史 QA(2026-09-30)最低 495。正常屏色数 60–1579、数量级过大=颜色过杂,用户裁记待办治理;本批只调闸机阈值(正常地板 60 的 2/3=40),不动色板。关联文档:[美术圣经](design/art/art-bible.md)(§4.1 色板分层=色板纪律 owner)。
**缺口**:还差一次美术设计讨论——正常屏色数的目标上限、收敛手段(色板压缩/量化纪律)、与 §4.1 两层色板条款(token 板 ≤48/环境子板每屏 ≤32)的关系。
**改动面**:文档+美术素材
**状态**:待文档设计
#### palette_check 基线建档与双门机检化(2026-11-02 登记,来源=批次移交)
**实况**:证据=迭代 47 实现报告 §7.2(已按吸收即死退役,git 提交 3443890d 可考)——卡④ V10 素材级读数:15 张素材 palette_check 只读模式 0 红灯 0 新增色;但 48 令牌 baseline 目录在库缺位(机检无对照基线),§4.1 两道门(语义检查+RGB 三通道差)的双门机检化缺承载。归工程改动批:建 baseline 目录+闸件双门判据落地。