wushenghua/aetherbound-guild
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
7fcea2dbb97aeac48ee2b30cdc35979e6f4990f3
aetherbound-guild/docs/plans/M84_REGISTERED_DEFECT_CLOSURE.md
T

16 KiB
Raw Blame History

M84 · 已登记缺陷收口（Guild 委托板 / Member 详情 / 130% 放大档）

权威：AGENTS.md（UI Restoration Memory / Plan-Driven Development）｜来源：M82-I01、M82-I02 （docs/plans/M82_MARKET_EMPTY_STATE_REPAIR.md 第 99-100 行）与 M83-I02 （docs/plans/M83_PARTY_LINE_TOP_RAIL.md）。 Owner 授权：2026-09-18「都要，你指导一下那个会话工作吧」——三个包全部开，由接手会话（监督） 定标与验收，另一会话按包实现。

运行方式（本包的组织约定）

  • 一个包 = 一个步骤 = 一个 focused commit = 一个源绑定 attempt = 一次监督验收； 三个包共享本计划，但互不合并，每包收口后才开下一包。
  • 实现方（另一会话）只做当前 IN_PROGRESS 的那一步；新发现只登记 issue register。
  • 监督方（接手会话）负责：定标（authored bounds / 验收数字）、独立复核（工作树、attempt journal、归档 PNG 目检）、必要时纠偏。未经监督方复核不放行 push。

Player-visible stopping point（三包各自成立）

  • HUB-001 / M82-I01：GuildKioskCopyArea 内的全部运行时文字只落在作者化告示板纸面上， 不压红帷幔、不外溢到柜面；告示板状态行在 1280×720 与 130% 档均达到可读字号与对比， 不再出现「字号偏小 / 对比偏弱」。
  • Member 详情 / M82-I02：详情区按批准稿声明的槽位逐个有运行时节点，不留声明了却空着的 信息位，也不出现无出处的新内容；密度达到可验收的占用下限。
  • 130% 放大档 / M83-I02：party_line、risk_board、risk_commitment 三页的正文级文字 在 130% 档真实放大（不再被 16/18/17px 上限压成与 100% 同尺寸），且在各自作者化槽位内不溢出； 探针新增「130% 必须放大」断言。

Measured facts（监督方实测，2026-09-18）

M83-I02 上限抑制（已定标）

页面 字号函数 上限 1280×720 实测（100% → 130%） 判定
party_line_page_view _party_text_size(design_size, clamp_ceiling=true) mini(16, …) 16 → 16（全页，除已修的顶栏 rail） 130% 无效
risk_board_page_view _risk_text_size() mini(18, …) 18 → 18（全部标签） 130% 无效
risk_commitment_page_view _risk_text_size() mini(17, …) 17 → 17、11 → 14 部分有效（大号被压）
guild_page_view _guild_text_size() 无上限（maxi(7, …)） 随档变化 正常
readiness_page_view _readiness_text_size() mini(30, …) 随档变化 正常
  • M66 探针（tools/m66_party_risk_visual_probe.gd）虽已跑 1.0/1.3 两档，但只断言不溢出； 上限把字号按回 100% 尺寸时，「不溢出」是假绿——这正是 M73 覆盖面里被漏掉的一类。
  • 参考实现：M83 已为 party 顶栏写出「在作者框内适配、随档放大」的样本（_party_rail_font_size()）。

M82-I01 Guild 定标（只读测量，2026-09-18）

来源纠正：Guild 页真正渲染的是 runtime/assets/backgrounds/m52_q_guild_background.png （2048×1152，guild_page_view.gd:14 用于 :56/:69）；guild_desk_v001/ 的 contract-board.png 属 GuildMasterKioskTexture 且 visible=false（:191）， world.png 是庭院图（无告示板）。红帷幔只存在于 m52_q_guild_background.png， 归因以它为准（不需要 owner 决定：它是本页唯一的作者化主图）。

主图实测（canvas = master × 0.625）：

区域 master px canvas px normalized
奶油纸面（5 张并集，最大一张 1423,230–1697,545） 1341,230 – 1875,555 838,144 – 1172,347 0.655,0.200–0.916,0.482
青绿底板＝内框 1404,223 – 1896,568 878,139 – 1185,355 0.686,0.194–0.926,0.493
木质外框 1404,205 – 1962,590 878,128 – 1226,369 0.686,0.178–0.958,0.512
红帷幔（r≥150, r−g≥60, g≤130） 1300,190 – 1899,289 812,119 – 1187,181 0.635,0.165–0.927,0.251

运行时代理（:200 起）：GuildKioskCopyArea = 画布 886,104 – 1212,389 （顶边 104 比板顶 139 高 35px，20% 面积压在帷幔上；右缘 1212 > 纸面 1172）。

节点 设计/实测字号 canvas rect 压帷幔 纸面占比
GuildKioskText（:205-208，标题） 13 → 18px 922,120–1139,198 15% 15%
GuildContractReason（:218-221） 9 → 12px 934,225–1184,318 0 21%
GuildMarketReason（:230-233） 9 → 12px 934,330–1184,439 0 3%
GuildNotice（:241-244） 8 → 11px 922,439–1139,489 0 0%（整条在纸面外）

对比度实测（背景取主图实测像素，docs/03_PAGES_AND_UX.md:994 要求正文 ≥4.5:1）： 顶部栏杆三处状态值 2.56 / 2.94 / 2.70:1（ink #2f3130）； GuildMarketReason 1.47:1（INK_SOFT #6a5236 压桌面木色）； GuildNotice 1.00:1（#a94b53 压同色木纹）；告示板标题/委托行 9.53 / 11.86:1（合格）。

判定：① 文字压帷幔/越纸面 —— 已复现；② 状态行与提示行对比不足 —— 已复现 （含 GuildNotice 几何+对比双失）；③ "字号偏小" —— 未复现：12px 高于仓库硬下限 11 （M52_SHARED_UI_RULES.md:189、ui_tokens.gd:89-91），若要抬高下限属 owner 决定， 本包按"不缩小、只加对比与几何修正"处理。

历史定标（首轮速测，保留）

  • 实拍 /private/tmp/m53-check/guild-1280x720-zh_CN-final.png：GuildKioskCopyArea = Rect2(0.692, 0.145, 0.255, 0.395) → 画布 885.8, 104.4 / 1212.2, 388.8， 顶边比 deconstruction-plan.json 的 contract_board.bounds=[0.625,0.285,0.985,0.875] （画布顶边 205.2）高约 101px；GuildKioskText（字号 13）墨迹压在红帷幔花边上； 状态行 可用 · 选择难度（y≈218）与 市场锁定 · 先确认当前委托（y≈353）字号目测 12–13px。

M82-I02 Member 定标（只读测量，2026-09-18）

  • 页面归属不唯一：仓库没有独立 "Member" 面；entry_shell.gd:2358 的 成员 / Roster 路由到花名册面，M68 计划标题把该面写作「花名册 / 成员详情 / 解雇审查 / 合同返回」。 两个候选：A company_roster_page_view.gd 的 RosterDetail（:78）、 B recruit_detail_page_view.gd 的 RecruitDetailFacts（:84）。
  • REC-001/REC-002 没有任何设计权威：docs/design-authority/design-index.json 的 19 个 批准页只有 SYS/HUB/PTY/RSK/BAT/SHP/OUT，REC-* 仅出现在 docs/03_PAGES_AND_UX.md:273-274 的散文（553/554 行给出内容要求但无可测槽位）。因此本包无法像 M82/M83 那样 「按批准稿槽位对齐」——缺的是权威本身。
  • 唯一可比声明：pages/SHP-002-recruit-review/approved/v001/text-slots.json 的 decision_facts anchor=[0.53,0.14,0.38,0.64]（画布 678.4,100.8 / 486.4×460.8），无 wrap/max_lines 键。
  • 缺口（散文要求但无运行时节点）：REC-002 的 position、company impact； REC-001 的 deployed status / readiness / equipment issue。运行时多出的无出处节点： RecruitDetailFutureReason、RETAINED、「已选成员 / SELECTED RECRUIT」。
  • 密度口径：仓库只有 M52「信息预算」（事实条数）与 M61 决策密度（时间）， ui_ink_check.gd 只管溢出越界；没有「区域墨迹占比」指标（本计划不新造指标）。
  • ★需 owner 决定：① M82-I02 的页面归属（A 花名册详情区 / B 成员详情面 / 两者）； ② 是否授权为 REC-002 补一份槽位声明（等于给该面补「设计权威」，属设计完成门范围）； ③ position 取值口径（base_front_to_rear_ids 还是 draft_front_to_rear_ids）。

Ordered steps

  1. M84-A：COMPLETE（2026-09-18） — M82-I01 Guild 委托板文字与状态行。 实测：纸面（5 张并集）= 838,144–1172,347；GuildKioskCopyArea 重锚到 884..1170 / 186..344； 四行（title/contract/market/notice）重排后 rect+ink 全部落在青绿底板 4px 内缩内、与红帷幔零相交； GuildNotice 回到纸面；对比度取样改在渲染帧上（顶部三枚状态在运行时 plate 上） 并按最差载体像素计算；探针新增 ABG_M84_GUILD_BOARD_OK 与几何/对比断言， 正式 attempt m84-guild-board PASS @ 44c775aa（监督方独立复算四行 6.06 / 5.21 / 5.08 / 4.66:1）。 注：该提交把 GuildNotice 的 ink 从 COLOR_DANGER 换成 PageChrome.INK，理由是它当时被误测为 3.9–4.2:1 —— 该理由已作废（实测 4.77:1），回迁由 M84-D 完成。
  2. M84-B：M82-I02 Member 详情信息架构/密度（提交二）。
  3. M84-C：COMPLETE（2026-09-18） — M83-I02 三页 130% 放大档 + 探针断言。 提交 ec954562（3 view + 探针）；正式 attempt m84-text-scale 20260918T000504Z-88818 PASS （ABG_M84_TEXT_SCALE_OK + ABG_M66_PARTY_RISK_INK_OK 各 1、strict=[]、36 帧）； 上限随档抬升 party 16→21 / risk_board 18→23 / risk_commitment 17→22； 监督方独立复算 130% 真变大 6 / 2 / 2、ink 溢出 0。
  4. M84-D：M84-I01 告警语义回迁（提交四，M84-C 复核通过后开）：
    • 范围已收窄（2026-09-18 更正）：原计划的"顶部状态行对比不足"经监督方在归档帧上复测为 假阳性。实测（guild-1280x720-zh_CN-final.png，值压在奶油承载牌 (253,233,177) 上）： GuildProgressStatus 10.29:1、GuildCoinStatus 9.19:1、 GuildAnchorCompanyStatus 9.31:1；代码确认 _status_slot() 早已为值挂了 PageChrome("card") 承载牌（guild_page_view.gd:445），值走共享 ABGM52GuildResourceStatus。 先前 2.56 / 2.94 / 2.70:1 是用木纹栏杆当载体算出来的（同一测量错误也出现在 M84-I01 的 "3.9–4.2:1" 里），故不再需要"给状态行加承载牌"，也不需要跨页回归。
    • 本包唯一待办：把 GuildNotice 从 PageChrome.INK 回迁 COLOR_DANGER （对奶油纸实测 4.77:1 / 4.92:1，语义与对比同时成立），并删掉 M84-I01 里"语义色暂缺"的描述。
    • 探针：tools/m53_guild_visual_probe.gd 的 GuildNotice 对比断言继续生效即可， 另加一条"notice ink == COLOR_DANGER"的语义断言；marker ABG_M84_NOTICE_SEMANTIC_OK。
    • 教训（写入共享 UI 规则）：对比度必须按实际渲染载体取样，不能按邻近主图材质取样； 否则会产出 M84-I01/M84-D 这类假阳性缺陷。

M84-C 1.0 基线哈希（harness 内参考值，2026-09-18）

⚠ 这些哈希只在采集它的那个 harness 内可比（监督方已实测：同一脚本连跑两次 6/6 一致；但监督方脚本 与探针 harness 之间风险两页会差——等待帧数/SubViewport 复用不同 + 逐帧动画相位）。因此它们 不是跨 harness 的门，只用于"同一 harness 改动前后"的自对照。零变化主证据仍是代数对拍。

页面 sha256
party_line zh_CN 35ca3e921e9cfffc72f9c98bc6672a8c93d763b6ebfa765c180593bc08977699
party_line en a10b6effc8f4d0642d151e5a80c7b6b0d21120b76a9a7bc8daf4b3c180111eb9
risk_board zh_CN eee28ded7fa4afdb1a0ffaac7ccd7c035ff597df2f3772ad86c97a4ab6367946
risk_board en a57b4564d953aa5643d45dce359d3758834e8f75cccf83d20a6cb576e751ded5
risk_commitment zh_CN 03c125188b54ed9ee72a7eef91d385ea90c10132a9496a49d32f08435ecca3ab
risk_commitment en 2a773e56536f82584196bed8f736706f17b6e88ccbfcb2e4aa15e37109e280db

Attempt 绑定规则（2026-09-18 确立）

  • 绑定实现修订。若实现提交之后 HEAD 又前进若干笔 docs-only 提交： ①原绑定继续有效，账本按"绑定 <impl-hash>；其后仅 docs-only， git diff <impl>..<tip> -- runtime/ 为空"记录； ②不要为了"对齐 HEAD"重复跑同一 attempt——浪费预算，且第二次绑到 docs 树上更难解释。
  • 实例：M84-C 绑定 ec954562；其后 d9a88e1f…cd53164b 共 5 笔 docs-only， git diff ec954562 cd53164b -- runtime/ 为空（已验证）。

Acceptance checks（每包都必须满足）

  • authored bounds 逐条对齐：每个文字节点的 rect 与 ink 都落在作者化容器内（含 130% 档）；
  • 严格探针 violations=0 且 marker 计数等于真实扫描数；130% 档新增放大断言；
  • 源绑定 attempt：--require-marker 恰好一次、strict_diagnostics=[]、workspace_removed=true、 带 PNG 的探针必须用真实渲染器运行（import 步骤 --headless --editor，测试步骤不加 --headless）；
  • foundation / DEV 契约测试不回归（既有失败需在包内用 stash 对照证明是既有状态）；
  • 监督方对归档 PNG 做目检（100% 与 130% 各至少一态）后才放行 push。

Frozen scope

玩法 / 经济 / 内容 / Save / 路由 / 数值 / 文案语义不变；不生成新美术、不改主图底图； Market / Party 已验收页不重做；M80-I10、M61-I05、M82-I04 不动。

  • 既有失败（非本包回归）：（M43 … returned state blocks later Contract） 与 （M20 … returned Guild keeps a later Contract closed）在基线 对照运行中同样失败；本包提交前后行为一致。

Issue register

  • M84-I01 OPEN（已复测，原判断需更正）："共享层缺少深危险红令牌（COLOR_DANGER #a94b53 在奶油纸面上只有 3.9–4.2:1）" —— 监督方独立复算：COLOR_DANGER 对奶油纸 (255,237,203) = 4.77:1、对更亮纸 (255,242,201) = 4.92:1，本来就 ≥4.5:1； PageChrome.RED #a8503f = 4.69 / 4.84:1 同样达标。原先的 3.9–4.2 是把木色桌面 (140,104,75 → 1.10:1) 当成了载体。因此：
    • 真正的缺陷是 GuildNotice 的语义色被换成中性 PageChrome.INK（红色告警语义丢失）， 而不是"没有可用的危险色"；回迁 COLOR_DANGER 即可同时满足对比与语义。
    • 参考值（ink × 载体）：INK #2f2417 对纸 13.2–13.6:1 / 对木色 3.03:1； INK_SOFT #6a5236 对纸 6.3:1 / 对木色 1.46:1；COLOR_SUCCESS #3d7449 对纸 4.81:1。
    • 规则（本计划确立）：语义色只在**作者化浅色载体（纸/牌）**上使用；任何文字若落在 木色或中灰载体上，必须换到深 ink 或换载体。
    • 更正：先前"M84-D 按此口径处理状态行"已作废——状态行本来就有承载牌、实测 10.29 / 9.19 / 9.31:1（详见第 4 步）；M84-D 只剩 GuildNotice 语义回迁 + 规则登记。
  • M84-I02 BLOCKER（2026-09-18，环境）：worker 会话 646ad682 选用的 opencode-go/deepseek-v4.1-flash 被上游拒绝——Internal error: The latest version of this model is only available hosted in China and requires explicit opt in: https://opencode.ai/workspace/wrk_01M2QVQ67CTNKXQP7JS39YHZ05/go （证据：~/.hapi/logs/2026-09-18-06-47-47-pid-29256.log 07:15:10 / 07:17:46、 ~/.hapi/logs/2026-09-18-07-18-20-pid-53908.log 07:18:31）。会话仍 lifecycle=running、 消息已入队（MessageQueue2 push() completed. Queue size: 1）但每次 prompt 都失败， 因此表现为"空闲不干活"。实测同档位可用模型：opencode-go/deepseek-v4-flash、 opencode-go/qwen3.8-max、opencode-go/glm-5.2、deepseek/deepseek-v4.1-flash （opencode ACP session/set_config_option + session/prompt 均返回正常）。 处置：在 GUI 把该会话模型换成 opencode-go/deepseek-v4-flash 后 resume，或按上面链接开启 opt-in。
  • 本包内新发现只登记，不顺手修。
Reference in New Issue View Git Blame Copy Permalink