Skip to content

Commit 58829ae

Browse files
committed
docs(ui): 更正登记制语义注释的过期表述
`surfaceResidual.ts` 的判据语义块里两处与本表实际口径不符(一处在 T19 之前就已过期): ① 「9 行 legacy 登记值之和 == `FROZEN_SURFACE_TAG_TOTAL`」—— 批 5/7 抬总数时该和**未动** ⇒ 真值是 `SURFACE_TAG_FROZEN_LEGACY_COUNT`(今日 14 vs 47,两个不同的数); ② 「新登记行 ⇒ `file` 不在 legacy 集里」—— T19 改键后判据看**档位**(`tier: "new"`), 按文件判会在同文件双行时把 new 行算进 legacy 面。 纯注释改动,无值变化:29 行 / Σ 47 / legacy 9 行和 14 一字不动;门禁与判据件读数不变。
1 parent 0ffb46f commit 58829ae

1 file changed

Lines changed: 7 additions & 5 deletions

File tree

‎app/src/ui/primitives/surfaceResidual.ts‎

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -134,13 +134,15 @@ export const SHADOW_RESIDUAL: readonly { file: string; kind: ShadowResidualKind;
134134
* token 变量 `var(--ed-bg-surface/…)` 绕开原语)。裁决:改成**登记制** —— 新文件把调用点登记进来
135135
* (登记即计数),在保留全部防漂移牙齿的前提下允许合法增长。**这不是放宽**。
136136
*
137-
* ★ 判据语义(`surfaceTagRegistry.test.ts` ⑪ 逐条读它;**改本表 = 改这三条的口径**)
138-
* ① **legacy 行**(下列 9 条,来自 T17-B 迁移快照):
137+
* ★ 判据语义(`surfaceTagRegistry.test.ts` ⑪ 逐条读它;**改本表 = 改这四条的口径**)
138+
* ① **legacy 档行**(下列 9 条,来自 T17-B 迁移快照):
139139
* · 登记值 = `≤` 上限(棘轮只许降:真迁走一处 ⇒ 手工收紧本行 **+** 总数 **+**
140140
* `SURFACE_TAG_FROZEN_LEGACY_COUNT`,三处同改);
141-
* · 这 9 行的**登记值之和恒等于 `FROZEN_SURFACE_TAG_TOTAL`** ⇒ 未登记的涨、表值被悄悄降、
142-
* 总数被单独手改 —— 三条都会红。
143-
* ② **新登记行**(批 5 起新增;`count ≥ 1` 且 `file` **不在** legacy 集里):
141+
* · 这 9 行的**登记值之和恒等于 `SURFACE_TAG_FROZEN_LEGACY_COUNT`**(迁移面的份额;批 5/7 抬
142+
* `FROZEN_SURFACE_TAG_TOTAL` 时**未动**该和 ⇒ 两个数今日是 14 与 47,不是同一个数)⇒ 未登记的涨、
143+
* 表值被悄悄降、总数被单独手改 —— 三条都会红。
144+
* ② **new 档行**(批 5 起新增;`count ≥ 1` 且 `tier: "new"` —— 判据看**档位**,不看「文件在不在
145+
* legacy 集里」;后者在同文件双行时会把 new 行算进 legacy 面):
144146
* · `count` 必须**恰等于**实测(不是 ≤)—— 防「先把表抬高再看」;
145147
* · 同一次提交必须手工抬高 `FROZEN_SURFACE_TAG_TOTAL` **并**同步 `SURFACE_TAG_ANCHOR.entries`
146148
* (只许抬高到「Σ 登记值」;凭空抬高总数而不登记 ⇒ 红)。

0 commit comments

Comments
 (0)