Skip to content

Commit 396b5e5

Browse files
committed
docs(standards): 补回两条被替换条目的原句留档
1 parent 291b711 commit 396b5e5

2 files changed

Lines changed: 2 additions & 0 deletions

File tree

‎docs/standards/line-limit-exemptions.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -243,6 +243,7 @@
243243
> - 🔴 **顺带的机制结论(本批在提交机制上的两次实质改进,写进本节以备后来者)**:① 共享文件改用 **blob 构造 + `update-index --cacheinfo`**(`git show HEAD:<path>` 取 **LF 规范版本** → 只改自己那几行 → `hash-object -w` → 挂索引 → 提交,**不用 `--only`**);② 真实索引里已有别人暂存内容时改用**私有索引**(`GIT_INDEX_FILE` + `read-tree <HEAD>` + `add -- 只自己的路径` + `write-tree` + `commit-tree -p $(git rev-parse HEAD)` + `update-ref` **带旧值守卫**)—— **比 `--only` 安全**(不碰真实索引、不碰工作树)。**自证要看 `git diff HEAD -- <shared path>`**(`git diff --cached` 防不住 `--only`);**提交前先看 `git status --porcelain` 的「首列」**(出现 `M `/`A ` 且不是你的路径 ⇒ 索引里有别人的东西 ⇒ **必须**改用私有索引,否则 `git commit` 一定连带落库);**私有索引提交后必须 `git add -- <你的路径>` 重新对齐真实索引**,否则下一个人一裸提交就**回退**你的提交(§C41.2 连带回退 / §C54.2)。
244244
> - 🔴 **门禁盲区一例(§C51.7①)**:`app/src-tauri/src/commands_video.rs` 的**末尾换行被吞**(T21 实测 `s.endsWith("\n") === false`,`countLines()` = **356**)而 **`countLines()` 不变** ⇒ **本表与 `line-limits --full` 都看不见**。机理 = `countLines()` 的定义(`s.split("\n").length - (s.endsWith("\n") ? 1 : 0)`)**对「有无末尾换行」不敏感** —— 这是**口径的性质**,不是缺陷;但 🔴 **任何「逐字节一致」的纯搬迁 / 拆件声明都不许只靠行数**(批 7 的判据已升级为 **`Buffer.equals` 逐字节对拍 + `digest` / `sha256`**,§C26.4 / §C29)。**登记为技术债**(批 8 可考虑加一条「末尾换行 / EOF 形态」的机器判据)。
245245
> - 🔴 **散文对拍探针 = 批 8 的候选闸(§C11.8 ③)**:`scripts/check-exemption-prose.mjs`(批 7 T11 新建,**112 行**;口径 = `countLines()` 同源实现)把**本表的散文数字与 `check-command-registry.mjs` 的门禁读数对拍**(如「散文『311 条』== 门禁『定义 311』」;两态都成立、中途未同步期为**真阳性** `EXIT=1`)。🔴 **批 8 T17 已挂进 CI**:`.github/workflows/pr-check.yml` 的 `line-limits` job 内**单列** step「**Exemption table prose check**」(`:211`,`run: node scripts/check-exemption-prose.mjs`)⇒ **它已经是 CI 门禁**。🔴 **仍不进八闸集合**(理由未变:八闸的集合是批次间治理收口的逐字对账基线,扩闸会让对账漂移)、🔴 **仍不进 husky**;⚠️ **若它在 CI 上频繁假红 ⇒ 回退裁决、改回手工跑,并写明回退理由。****并进入 `pr-check.yml` 的 paths-filter 缺口名单**(§C41.4 U2;**缺口形态未变、逃逸文件集合 +1** —— 同源事实见 [`performance.md`](performance.md) 的懒侧门禁节)。⚠️ **探针按路径定位、不按死锚行号**(本表的 `:45` 因 T6 删行已下移为 **`:44`**,即 `app_commands.rs` 那行,其散文现为 **「311 条」**、行数值 **478**,T21 实测两者与门禁读数一致)。
246+
> - 🔻 **2026-09-13 加注(原句留档)**:本条在批 7 收口时逐字写「🔴 **已入库,但不入八闸 / CI / husky**(理由:八闸的集合是批 8 治理收口的对账基线,本批扩闸会让逐字对账漂移;散文数字天然易漂 ⇒ 硬门禁会频繁假红)⇒ **手工跑**(`--help` 与头注都自述「非门禁」)。」;🔴 **该句在本条被就地更正时被替换掉了**(批 8 T29,提交 `9b1e8aa8`,`git diff --numstat` 为 `3/3`)⇒ 按 [`documentation.md`](documentation.md) 的「原文 + 就地加注」形态**补回留档**。🔴 该句描述的是**当时**(批 7 收口)的登记,现状见本条上一段的加注。
246247
> - 🔴 **本批的贴边件清单(余量 ≤5,共 10 条)落在 [`v0.22` 批 7 节的「诚实代价」](../versions/v0.22.md)**(母本体例同批 4 的「9 个贴边文件」):**任何后续编辑必须先拆件**。其中 `app/src/components/notes/NotesReadingColumn.tsx` 的路径在批 7 台账(`rulings.md` §C49.5①)与派发语里被写成 `app/src/views/note/NotesReadingColumn.tsx` —— 🔴 **该路径不存在**(实测该文件在 `components/notes/`)⇒ **以 `components/notes/` 为准**。
247248
248249
---

‎docs/standards/performance.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,7 @@
6868
· 🔴 **登记③(`Surface` 迁移的可见变化 → 像素面的未决项)**:**圆角就地 `6 → 8`**(9 处 = 6 处随原语 `radius="panel"` + 3 处就地改;计划面 254 处、其余 245 处维持现状)· **边框与近白底「冷灰 → 暖纸」** · **`boxShadow` 字面量换 token**(含 1 处有损:方向性边缘投影换双向环境投影)· **遮罩统一**(`0 0 0 9999px rgba(0,0,0,.45)` 由**巨扩散**充当,`--ed-shadow-*` 承载不了)· **弱化文本墨度对比度**(2.54:1 → 5.13:1)。🔴 **这些量级与形态在 `app/src/ui/primitives/` 的基线件与残留件里各有出处;本规范不重复登记数值** —— 🔴 **它们的真判据是像素面**(jsdom **不排版、不加载样式表**)⇒ **「有读数」≠「已统一」**(目标值是**设计决定**,不是规范能裁的)。
6969
· 🔴 **登记④(字号越界与弱化灰的存量 → 只许降的棘轮)**:**字号越界**(`< 12px` 六档)与**弱化灰**(`#9ca3af`)**都已有棘轮件**(**冻结常量 + 逐文件表 + 锚**三连通;各表**逐文件合计 == 冻结总数** 且 **锚的条目数 == 冻结文件数**,本次现场复核**自洽**)。⇒ 🔴 **新增或迁移的 UI 不得扩充这两族存量**(判据 = 沿既有棘轮收紧,**不是**按「看起来更统一」改观感)。🔴 **迁移真降一处时要手工同步「冻结总数 + 逐文件表 + 锚」三处**;**常数与逐文件表必须恰等**(不许把常数手工改成自洽)。
7070
- 🔴 **同批登记(不在本文件,仅互指)**:`scripts/check-exemption-prose.mjs`(批 7 T11 新建的**散文对拍探针**,112 行)**仍不入八闸 / husky**,但**批 8 T17 已单列转正为 CI 门禁**(`pr-check.yml` 的 `line-limits` job 内 step「Exemption table prose check」`:212`)⇒ 登记为「**批 8 T17 已落地的 CI 门禁**」(§C11.8 ③),并**同样进入上面那条 paths-filter 缺口名单**;落点见 [`line-limit-exemptions.md`](line-limit-exemptions.md) 的批 7 收口加注。
71+
- 🔻 **2026-09-13 加注(原句留档)**:本条在批 7 收口时逐字写「**已入库但不入八闸 / CI / husky** ⇒ 登记为「**批 8 的候选闸**」(§C11.8 ③)」;🔴 **该句在本条被就地更正时被替换掉了**(批 8 T29,提交 `9b1e8aa8`,`git diff --numstat` 为 `1/1`)⇒ 按 [`documentation.md`](documentation.md) 的「原文 + 就地加注」形态**补回留档**。🔴 该句描述的是**当时**(批 7 收口)的登记,现状见本条上一段的加注。
7172

7273
### 第二部分:测量与 Profiling
7374

0 commit comments

Comments
 (0)