docs: UI美化三层诊断入06待办——八条专条登记(一层纯工程三项/二层占位于素材三项/三层观感两项)+第三层存量三条补标Alpha需完成
登记来源=2026-10-13 用户提出界面美化需求并要求先作分析,同日令「三层全部作为独立待办事项登记、一律列 Alpha 阶段必须完成」。 新增八条:UI全局主题资源缺失/UI按钮状态矩阵缺档/全局纹理过滤未设为邻近采样(以上一层·纯工程,用户指定先做);UI贴图重构批(自美术资产清单转立免双写)/UI字体补完/战斗一屏样张P0(以上二层);UI氛围层与九宫格切片观感修/UI元素细节修(以上三层)。 补标:呈现层残余<4.5:1三处、未开格类型徽章呈现时机、美术资产链路审计P0两项——三条原已登记但缺 Alpha 阶段归属,本批补足并指认三层诊断。 零代码零数值零素材;doc三闸对基线零新增(lint 3 存量同款/死链3逐条一致/term五组一致)。
This commit is contained in:
1 parent
52fdaf6c57
commit
83fce01601
1 file changed
+69
-3
+69
-3
@@ -2,6 +2,72 @@
|
||||
|
||||
本清单是全项目待办事项的**唯一登记处**:各系统文档不再自建「待办」条目节,只留一行指路存根;新增待办事项一律直接登记本清单。条目按四个循环分组,组内按系统分节;每条事项一个四级标题,其下用粗体属性名成段——**现状**(现状与失义原因,自各系统文档原样搬运、措辞不改;跨文档重复条目合并为一条,登记在建议归属主责方名下,其余来源在现状中注明出处;相关但不同面的条目各自保留,现状末尾互相指认;搬运时仅将原文中的「本文 / 本系统」替换为对应系统名,并把相对链接改写为本文件位置可用的路径)、**归属**、**状态**。事项解决后**从本清单移除**(2026-09-18 用户拍板改口径,原"改状态留痕"废止):去向与依据登记当批台账与 active.md 快照,git 历史即留痕。
|
||||
|
||||
#### UI 全局主题资源缺失——引擎原生控件没有接管皮肤(2026-10-13 登记,UI 美化三层诊断 · 第一层)
|
||||
|
||||
**现状**:整个游戏工程没有任何主题资源(全库搜主题文件零命中),`game/project.godot` 里跟界面样式有关的只有一行全局字体设置。于是凡是没有被呈现层逐个手工盖上样式的引擎自带控件,全部显示为引擎默认的灰色圆角现代风,跟游戏的像素木石风格不搭——实机截图里能直接看到的就有营地右侧那条浅灰圆角滚动条(容器在 `camp_overlay_view.gd` 第 101 行起的三处滚动容器),此外设置面的音量滑轨、几乎所有界面的悬停提示气泡、任何下拉框与勾选框都是同一批默认皮肤。**这条为什么会存在**:游戏现行的界面样式做法是"逐个控件手工盖皮肤",而不是"一套主题统一管"——优点是色值与样式已全部单点收拢在 `ui_kit.gd`(这是很好的地基,四十四个消费方里只有两个文件各有两处裸色常量),缺点是没有被点到名的控件就等于没有皮肤。
|
||||
|
||||
**来源**:2026-10-13 用户提出对当前游戏界面做美化并要求先做分析;本条是分析中**此前未在任何登记处在册**的三项之一(另两项见下方两条)。
|
||||
|
||||
**归属**:呈现层表现批(纯工程改动,不动任何美术素材,也不改动 [美术圣经](../art/art-bible.md) §7 的定稿规格)
|
||||
|
||||
**状态**:待办(**Alpha 阶段需完成**)——UI 美化三层诊断分三层推进,本条属第一层「系统性缺口」;**用户 2026-10-13 已指定最先动这一层**。
|
||||
|
||||
#### UI 按钮状态矩阵缺档——悬停没有反馈、危险钮按下没有反馈、键盘焦点全站空白(2026-10-13 登记,UI 美化三层诊断 · 第一层)
|
||||
|
||||
**现状**:按钮至少应当具备常态 / 悬停 / 按下 / 禁用 / 键盘焦点五种状态,目前全站五种状态的覆盖数量很不齐(`ui_kit.gd` 里常态四处、悬停四处、按下三处、禁用一处、**键盘焦点零处**),具体三处缺档:①普通按钮的贴皮函数(第 541 到 555 行)把悬停态填的是**常态那张图**,等于鼠标移上去外观纹丝不动,同时它把悬停文字色也填成了同常态一样的墨色,两个通道一起失效;②危险钮(第 591 行起)只填了常态与悬停,**没有按下态也没有禁用态**,按下去没有下沉反馈;③全站没有任何键盘焦点样式,走的是引擎默认的灰色描边——这一点正好卡在本清单「棋盘战斗键盘/手柄输入」那条 Beta 待办的连带裁决点③(弹层界面的焦点导航要不要同批做)前面,**焦点态是它的前置件**。**影响**:这些不是纸面问题,玩家在实机上会直接感觉到"点了没反应"。
|
||||
|
||||
**归属**:呈现层表现批(纯工程;素材已有按钮常态与按下两张图)
|
||||
|
||||
**状态**:待办(**Alpha 阶段需完成**)——同第一层其余两条。**一个待拍板点**:悬停态怎么做还没定,两条备选——甲=重产一张悬停态贴图(多一份素材、控制力最好);乙=在常态图上做统一的轻微提亮(零素材、但要确认提亮后的对比度是否仍然满足 §7.2 的 4.5:1 硬指标)。此点需在需求卡片阶段由用户裁决,本批不自作主张。
|
||||
|
||||
#### 全局纹理过滤未设为邻近采样——像素资源非整数倍缩放会发糊(2026-10-13 登记,UI 美化三层诊断 · 第一层)
|
||||
|
||||
**现状**:`game/project.godot` 里没有设置全局的画布纹理过滤方式,引擎默认是线性插值(会把像素图的硬边算成模糊过渡)。像素美术的游戏应当全局设为邻近采样。现行做法是逐个位置手工写死——`ui_kit.gd` 的石纹底噪与图标容器、以及 `standee_body.gd` 第 222 行的站桩立绘都各自手写了邻近采样,其余位置则没有。这种"想起来才设一个"的写法容易漏,凡是漏掉的像素图在非整数倍缩放下都会糊。
|
||||
|
||||
**归属**:呈现层表现批(一行渲染设置)
|
||||
|
||||
**状态**:待办(**Alpha 阶段需完成**)——**风险提示**:改成全局邻近采样前须确认没有资源依赖线性插值(若有,这些资源的观感会跟着变),建议改完配一次实机目检确认,避免为了修一处把另一处弄坏。
|
||||
|
||||
#### UI 贴图重构批——营地与元进度件仍是程序化占位(原登记在美术侧,2026-10-13 由 UI 美化三层诊断转立本清单专条)
|
||||
|
||||
**现状**:营地的柜台场景贴图目前是程序化画出来的临时形态,没有上贴图。这条债原先只写在美术侧的资产清单里([美术资产清单](../art/art-assets-checklist.md) 第 134 行与第 175 行,原文注明"营地现为程序化占位,台账 121⑧ 口径,排期归 UI 贴图重构批"),规格其实已经定了——烛光黄 `#F6C667` 配木色 `#8A5A34`(见 [美术圣经](../art/art-bible.md) §4.4),素材来源允许走"通用图标改色复用"这条低成本渠道。
|
||||
|
||||
**归属**:UI 贴图重构批(美术线;须先裁决是自己画还是找 CC0 素材改色,两条备选见 [美术资产清单](../art/art-assets-checklist.md) §0 的复用渠道闸)
|
||||
|
||||
**状态**:待办(**Alpha 阶段需完成**)——本条自美术资产清单转立,是为了避免在两处各写一份内容;**素材的状态视图仍以 [美术素材状态清单](../art/art-status-checklist.md) 为准,本条只承载排期决定**。
|
||||
|
||||
#### UI 字体补完——缺拉丁像素字专件、且全局只有一个字重(2026-10-13 登记,UI 美化三层诊断 · 第二层)
|
||||
|
||||
**现状**:现在全局只有一套字(`ui_font_fusion_pixel_zh_hans.ttf`,缝合像素字体,中文覆盖好、授权干净,2026-09-27 用户拍板)。但 [美术圣经](../art/art-bible.md) §7.4 定的口径其实是**两套搭配**:拉丁用 Kenney 的像素字、中文用 Fusion Pixel。更要紧的是字重纪律——该条款允许"字号档差 + 墨色深浅 + 字重两档"三个手段一起做信息层级,现在只有单字重,等于层级只能靠字号档差这一个手段,这就是实机上"屏标题看起来不够重、标题跟正文拉不开"的根因([美术素材状态清单](../art/art-status-checklist.md) 把字体标为占位在役,也是这个意思)。
|
||||
|
||||
**归属**:呈现层表现批 + 美术线(须先裁决:补不补拉丁专件、要不要上第二个字重)
|
||||
|
||||
**状态**:待办(**Alpha 阶段需完成**)
|
||||
|
||||
#### 战斗一屏样张 P0 未开工——界面成品是否过审的那把尺子还没建(2026-10-13 登记,UI 美化三层诊断 · 第二层)
|
||||
|
||||
**现状**:[美术圣经](../art/art-bible.md) §7.1 明文写着"程序化占位=临时态,任何屏的终稿闸=§1.4 整屏样张过闸;占位态不得跨里程碑"。而 [美术素材状态清单](../art/art-status-checklist.md) 把「战斗一屏样张」这件最高优先级的素材标的是**未开始**——也就是说,**判定界面美术算不算过关的那把尺子到现在还没造出来**。看板总账十五件:已完成四件、占位在役八件、未开始三件。
|
||||
|
||||
**归属**:美术线(战斗一屏样张的验收标准归 [战斗表现](systems/战斗循环/战斗表现.md) 与 [美术圣经](../art/art-bible.md) §5.1 共裁)
|
||||
|
||||
**状态**:待办(**Alpha 阶段需完成**)——**意义提示**:按圣经条款,占位态是"不得跨里程碑"的,本条只要不做,界面美术就始终处于未定稿状态,上面所有呈现层改动做完也缺少验收依据。
|
||||
|
||||
#### UI 氛围层与九宫格切片观感修——光柱硬边与面板切片错位(2026-10-13 登记,UI 美化三层诊断 · 第三层)
|
||||
|
||||
**现状**:两处画法在实机上能直接看出瑕疵,成因同属"图表与参数没调到位",此前未在任何登记处在册:①背景斜光带的做法是生成一张 560×560 的贴片(`ui_kit.gd` 第 263 行起),贴片里只有一条宽 100 像素、**边缘没有任何过渡**的斜向亮带,透明度整条一样是 0.05,再平铺满全屏——铺开后就是等距的三块硬边梯形,看着像"屏幕上贴了三块白色补丁"而不是光。正常的光带应当横向有渐变、纵向有上亮下暗的衰减。②结算屏与图例屏的面板边缘能看到错位的小方块,这是九宫格切片参数与素材尺寸不匹配造成的拉伸接缝——仪式石框(258 字节的小图)按 12 像素切片、石板亮面板(314 字节)按 16 像素切片,铺到四百多像素宽的面板上时中段就会被拉出可见错位。
|
||||
|
||||
**归属**:呈现层表现批(光柱纯改代码;九宫格切片需连带核对素材尺寸能否撑住新切片值,可能要重出素材,属美术线连带面)
|
||||
|
||||
**状态**:待办(**Alpha 阶段需完成**)
|
||||
|
||||
#### UI 元素细节修——滑轨填充不可辨、图标垫深块、留白失衡、开发件外泄(2026-10-13 登记,UI 美化三层诊断 · 第三层)
|
||||
|
||||
**现状**:四处细节都是实机上的可见问题,均已核查确认未在任何登记处在册:①设置面的音量滑轨,"已填的那一段"和"没填的那一段"是同一个深棕色,玩家看不出当前值在哪——这条其实触犯了 [美术圣经](../art/art-bible.md) §7.2 的可读性硬条款;②商店与三选一的卡片上,图标一律垫一块颜色很深的方形底色块,在米色卡面上像硬贴上去的一块补丁;③留白失衡——商店三张卡片只占屏幕上半部分、下面近一半空着,三选一同款,营地三栏不等高(第一栏比旁边两栏矮一截);④主菜单及各屏左下角常驻一个"诊断转储"按钮(开发调试件),玩家看得见——2026-09-29 那轮界面重设计的对比报告里就已经把它列成"开发占位外泄、应从玩家画面移除",至今未处理。
|
||||
|
||||
**归属**:呈现层表现批
|
||||
|
||||
**状态**:待办(**Alpha 阶段需完成**)——①②③是观感改动,④只需关闭或移进调试浮窗,成本很低,可以顺手带上。
|
||||
|
||||
#### 旧行为 MC 行为锚全数作废——重锚归数值批(2026-10-06 登记)
|
||||
|
||||
**现状**:案C 地图伤害账殿后批(git 7ef18ac,台账 371)改变每轮结算行为序——授予段不再兑付任何伤害(伤害形态单据暂存至战斗段末,段内序=主角先手→逐敌还手→地图账),主角死亡短路语义随之换代(「授予段伤害致死短路先手」路径消失)。既有全部 MC 行为锚与对拍锚所锚行为已不存在,**全数作废**;新段内序断言已入冒烟闸。按 sim-data MC 缓存层规则(无数值调整禁重跑),重锚不在改动批执行。
|
||||
@@ -310,7 +376,7 @@
|
||||
|
||||
**归属**:[地图战斗资源](systems/战斗循环/地图战斗资源.md)极性提案实施批与HUD框架共裁
|
||||
|
||||
**状态**:待办。**2026-10-05 注**:类型色五族已由迭代 16「UI 设计对齐批」§3-N4c 立项 `TG_*` 常量(实查 `ui_kit.gd` 现无 tg 常量,五族以裸 `Color8` 内联于 `bonus_pick_overlay.gd:96-102` / `shop_overlay_view.gd:189`,且缺第五族 aoe `#E25676`);本条(**格面**未开格类型徽章)与卡顶色带同族不同落点,**不并入本批**,维持待办。**2026-10-07 注**:呈现规格简化为组粒度——组间五色相、组内不细分(通用增益组五族不再承诺组内分型;art-bible v3.12);实施批按组粒度执行。
|
||||
**状态**:待办(**Alpha 阶段需完成**——2026-10-13 用户令随「UI 美化三层诊断」登记:本条属第三层「观感提升」)。**2026-10-05 注**:类型色五族已由迭代 16「UI 设计对齐批」§3-N4c 立项 `TG_*` 常量(实查 `ui_kit.gd` 现无 tg 常量,五族以裸 `Color8` 内联于 `bonus_pick_overlay.gd:96-102` / `shop_overlay_view.gd:189`,且缺第五族 aoe `#E25676`);本条(**格面**未开格类型徽章)与卡顶色带同族不同落点,**不并入本批**,维持待办。**2026-10-07 注**:呈现规格简化为组粒度——组间五色相、组内不细分(通用增益组五族不再承诺组内分型;art-bible v3.12);实施批按组粒度执行。
|
||||
|
||||
#### 呈现层残余 <4.5:1 文字位(迭代 16 批外邻接发现,2026-10-06 登记)
|
||||
|
||||
@@ -318,7 +384,7 @@
|
||||
|
||||
**归属**:呈现优化后续批(或 UI 设计对齐批第二轮);开工 = 用户点名
|
||||
|
||||
**状态**:待办(2026-10-06 曾编入迭代 18 卡②,2026-10-07 用户令撤回——探讨阶段未排批;同日短暂编入迭代 19,随迭代 19 清空一并撤出,是否再排批待用户确认)
|
||||
**状态**:待办(**Alpha 阶段需完成**——2026-10-13 用户令随「UI 美化三层诊断」登记:本条属第三层「观感提升」,是三层里唯一能被机器检查直接判红的一组,验收不需要人眼比对;是否单独排批待用户确认)。2026-10-06 曾编入迭代 18 卡②,2026-10-07 用户令撤回——探讨阶段未排批;同日短暂编入迭代 19,随迭代 19 清空一并撤出。
|
||||
|
||||
#### 第二 / 三关棋盘观感——亮度与对比度(2026-10-13 用户裁定,Alpha 阶段需完成)
|
||||
|
||||
@@ -476,7 +542,7 @@
|
||||
|
||||
**归属**:art(art-bible/美术管线)
|
||||
|
||||
**状态**:待办(待用户裁决)
|
||||
**状态**:待办(待用户裁决;**Alpha 阶段需完成**——2026-10-13 用户令随「UI 美化三层诊断」登记:本条属第三层「观感提升」)
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in new issue
Block a user