diff --git a/.planning/phases/10-docs-restructure/10-11-READER-REVIEW.md b/.planning/phases/10-docs-restructure/10-11-READER-REVIEW.md index 06fb05e..d4e1fa4 100644 --- a/.planning/phases/10-docs-restructure/10-11-READER-REVIEW.md +++ b/.planning/phases/10-docs-restructure/10-11-READER-REVIEW.md @@ -568,3 +568,23 @@ - 构建门禁:`cmd /c "pnpm exec tsx docs/.vitepress/init.ts && pnpm docs:build"` → **green**,输出 `build complete`,dead link = 0(新增预留仍为代码 span + HTML 注释,不产生链接)。 - 边界:仅改 `docs/intermediate/enemy-*.md` 与本记录;未改 `config.ts` 与生产代码;未新增文件;未创建 `10-11-SUMMARY.md`,未改 `STATE.md` / `ROADMAP.md`(按本次派发要求)。 +--- + +## 用户循环 · batch 11 记录(D-52 加粗边界修复) + +**范围:** 用户修订循环第 1 轮 batch 11(D-52 加粗边界)。按 CommonMark emphasis 边界(flanking)规则,`**…**` 的内容以标点结尾、且其后紧接普通文字时,不会被解析为加粗。 + +### 逐条处置 + +| # | 处置 | 改动文件 | +| --- | --- | --- | +| D-52 | `flags.md` 第 14 / 15 行的加粗短语以标点(`)`、`」`)结尾、其后又紧接`的`,触发 flanking 失败而不渲染;按 D-52 调整结构,去掉短语内的直角引号,使加粗内容以汉字结尾:`**返回或操作字段对象**的:`、`**直接操作字段值**的:`。 | `flags.md` | +| 全量自检 | 对 `docs/intermediate/*.md` 全量扫描(排除围栏代码块、行内代码 span 与 HTML 注释),按 CommonMark flanking 规则逐条判定 `**…**` 能否渲染:修复后 **0 处真实失效**,且无残留未配对的 `**`。`enemy-specials.md` 的 `/** {code} - {name} */` 位于行内代码内、并非强调,确认为误报、未改动。 | —— | + +### 校验 + +- 结构门禁:`flags.md` CRLF、单 H1(`STRUCT-OK`)。 +- 格式门禁:`node node_modules/prettier/bin/prettier.cjs --write docs/intermediate/flags.md`(D-45)→ `unchanged`。 +- 构建门禁:`cmd /c "pnpm exec tsx docs/.vitepress/init.ts && pnpm docs:build"` → **green**,输出 `build complete`,dead link = 0。 +- 边界:仅改 `docs/intermediate/flags.md` 与本记录;未改 `config.ts` 与生产代码;未新增文件;未创建 `10-11-SUMMARY.md`,未改 `STATE.md` / `ROADMAP.md`(按本次派发要求)。 + diff --git a/docs/intermediate/flags.md b/docs/intermediate/flags.md index 588fb21..6078128 100644 --- a/docs/intermediate/flags.md +++ b/docs/intermediate/flags.md @@ -11,8 +11,8 @@ Flag 里的每一项都对应一个**字段**(`IFlagCommonField`)。要读 系统接口因此分成两组,看名字就能分辨: -- **返回或操作「字段」(对象)**的:`setField` / `getField` / `getOrInsert` / `getOrInsertComputed`——它们返回字段对象本身; -- **直接操作「字段值」**的:`setFieldValue` / `addFieldValue` / `getFieldValue` / `getFieldValueDefaults`——只关心值,不暴露字段对象。 +- **返回或操作字段对象**的:`setField` / `getField` / `getOrInsert` / `getOrInsertComputed`——它们返回字段对象本身; +- **直接操作字段值**的:`setFieldValue` / `addFieldValue` / `getFieldValue` / `getFieldValueDefaults`——只关心值,不暴露字段对象。 怎么选?**只读写一次值**时用「值」那组更简单,不必多一步 `get()`;**要多次操作同一个字段、或要复用字段对象**(例如先拿到字段、再反复增减)时,用「字段对象」那组更省事。两者可以互相转换: