Skip to content

Commit 189f9a5

Browse files
committed
docs(plans): 0-C1 口径文案同步为单一判据
计划里两处「等价于 ReadAllLines 或字节 0x0A 计数」不准确:字节口径对末尾不带换行的文件会少算 1,故不能作为等价判据。改为只认 ReadAllLines / countLines()。
1 parent 7bd8300 commit 189f9a5

1 file changed

Lines changed: 4 additions & 3 deletions

File tree

‎docs/superpowers/plans/2026-09-11-frontend-redesign-batch0c1-line-limit-governance.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
## Global Constraints
1414

1515
- **本次范围仅「口径 + 登记表 + 守卫」**:`0-C1` **不拆任何文件**。15 个 >600 文件的拆分是 `0-C2`(前端 5 个)与 `0-C3`(Rust 10 个)两份独立计划,本计划交付的是它们的**测量仪器与验收依据**。
16-
- **测量口径(唯一有效)**:行数 = 文件**全部行数**(含空行),等价于 `[System.IO.File]::ReadAllLines(path, UTF8).Count` 或字节 `0x0A` 计数。**禁止**用 `Get-Content`(本机 PowerShell 5.1 + 码页 `gb2312` 会按 GBK 解码、吞掉换行、最多少算 45 行/文件)与 `Measure-Object -Line`(只数非空行)。
16+
- **测量口径(唯一有效)**:行数 = 文件**全部行数**(含空行),以 `[System.IO.File]::ReadAllLines(path, UTF8).Count` 为准(即 `scripts/line-limits.mjs` 的 `countLines()`)。**不要用** `Get-Content`(本机 PowerShell 5.1 + 码页 `gb2312` 会按 GBK 解码、吞掉换行、最多少算 45 行/文件)· `Measure-Object -Line`(只数非空行)· **字节 `0x0A` 计数**(对末尾不带换行的文件会**少算 1**;本仓实测有 8 个这样的源文件,含 `NotesPage.tsx` 602/601)。
1717
- **硬限范围为实测 15 个**(用户 2026-09-11 裁决):前端 5 个 + Rust 10 个。规格原文的「4 个」只扫了前端且漏掉 `SessionListPanel.tsx`,本计划一并更正。
1818
- 单文件 ≤300 行(AGENTS.md §3)—— **本计划新增的脚本自身也必须满足**;若 `line-limits.mjs` 超过 300 行,必须拆分而不是登记。
1919
- 零新增依赖(`package.json` 的 `dependencies`/`devDependencies` 不得变化)。
@@ -83,8 +83,9 @@
8383
改为:
8484
```
8585
1. **模块化**:单文件 ≤300 行(>600 行必须硬拆;300-600 行登记豁免清单);纯逻辑与副作用物理分离;显式依赖注入。
86-
**行数口径(唯一有效)**:文件**全部行数**(含空行),等价于 `[System.IO.File]::ReadAllLines(path, UTF8).Count` 或字节 `0x0A` 计数。
87-
**禁止**用 `Get-Content` 数行(本机 PowerShell 5.1 + 码页 `gb2312` 会按 GBK 解码、吞换行、**少算**)与 `Measure-Object -Line`(**只数非空行**)。判定一律以 `node scripts/line-limits.mjs` 为准。
86+
**行数口径(唯一有效)**:文件**全部行数**(含空行),以 `[System.IO.File]::ReadAllLines(path, UTF8).Count` 为准 —— 即 `scripts/line-limits.mjs` 的 `countLines()`。
87+
⚠️ **不要用**:`Get-Content`(本机 PowerShell 5.1 + 码页 `gb2312` 会按 GBK 解码、吞换行、**少算最多 45 行**)· `Measure-Object -Line`(**只数非空行**)· **字节 `0x0A` 计数**(对**末尾不带换行**的文件会少算 1;本仓实测有 8 个这样的源文件,含 `NotesPage.tsx`)。
88+
判定一律以 `node scripts/line-limits.mjs` 为准。
8889
```
8990

9091
- [ ] **Step 2: 改 AGENTS.md §11**

0 commit comments

Comments
 (0)