docs(10-26..10-27): 收尾高级 II（读者审阅 + 用户修订）

- 记录用户最终确认：通过，并补记读者审阅结论（阻断性问题 = 0） - 新增 10-26 / 10-27 SUMMARY：三轮读者审阅与 U6/U7/U8 修订循环 - 最终 prettier 检查通过，docs:build 构建 green、无 dead link
2026-10-30 04:40:18 +08:00 · 2026-10-23 20:56:02 +08:00 · 2026-10-23 20:56:02 +08:00 · 4f31be1396
commit 4f31be1396
parent 7d323e1674
4 changed files with 441 additions and 1 deletions
--- a/.planning/phases/10-docs-restructure/10-26-READER-REVIEW.md
+++ b/.planning/phases/10-docs-restructure/10-26-READER-REVIEW.md
@ -126,3 +126,15 @@
 - `adding-hero-attribute.md` / `adding-enemy-attribute.md`：护甲边界改为「夹紧后 `≥ 100`」——此时最终伤害为 `0`（勇士侧）或勇士每回合伤害为 `0`、怪物无法被击败（怪物侧），负值夹到 `0`；不再表述为「大于 100 会变成治疗」。

 **验证**：prettier 格式化通过；`pnpm exec tsx docs/.vitepress/init.ts && pnpm docs:build` 通过。
+
+## 结论（2026-10-23）
+
+对照第 1 轮 B-01..B-12、第 2 轮 B-13..B-14 与第 3 轮复查，逐条状态如下。
+
+| 条目      | 状态   | 依据                                                                 |
+| --------- | ------ | -------------------------------------------------------------------- |
+| B-01..B-12 | 已消除 | 第 1 轮修复记录；构建通过                                            |
+| B-13..B-14 | 已消除 | 第 2 轮修复记录；B-14 后经 10-27/U8-02 按用户口径进一步重写          |
+| 第 3 轮复查 | 已消除 | 本轮只提出 5 个非阻断项并全部修正，未再出现阻断性问题；构建通过       |
+
+**阻断性问题 = 0，审阅通过。** 仍存在的问题仅为已记录的非阻断说明与后续 10-27 用户循环处理的事项；未复用高级 I 人格，未越界修改站点配置、生产代码或渲染端内容。
--- a/.planning/phases/10-docs-restructure/10-26-SUMMARY.md
+++ b/.planning/phases/10-docs-restructure/10-26-SUMMARY.md
@ -0,0 +1,184 @@
+---
+phase: 10-docs-restructure
+plan: 26
+subsystem: docs
+tags: [reader-review, persona, advanced-ii, blocking-issues, prettier, build-gate]
+
+# Dependency graph
+requires:
+  - phase: 10-docs-restructure
+    provides: "10-25 已接入侧边栏的高级 II 九篇与导览"
+provides:
+  - ".planning/phases/10-docs-restructure/10-26-READER-REVIEW.md：D-68 人格、首轮 12 条阻断 + 19 条非阻断、第 2 轮 2 条阻断 + 7 条非阻断、第 3 轮复查与结论"
+  - "docs/advanced/ii/*.md：按读者视角修正的阻断问题（链路、时序、优先级、存档/录像一致性）"
+  - "阻断性问题 = 0，审阅通过（第 1–3 轮记录 + 收尾结论）"
+affects: [10-27]
+
+# Actuals (#2632)
+actuals:
+  tokens: 20434
+  tasks: 3
+  commits: 3
+  plan_head_before: b04ff5d209f55d220ded3b454bdbf10e1724ea93
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns:
+    - "独立子代理以 D-68 读者人格只提问、不改文件；执行者把问题归类为阻断/非阻断并定位到文件与章节"
+    - "阻断问题按轮迭代，每轮跑 prettier + 全量构建门禁；最多 3 轮，收敛后写结构化结束标记"
+    - "复审对照首轮清单逐条标注「已消除」或「仍存在」，不引入新功能"
+
+key-files:
+  created:
+    - .planning/phases/10-docs-restructure/10-26-READER-REVIEW.md
+  modified:
+    - docs/advanced/ii/index.md
+    - docs/advanced/ii/custom-range.md
+    - docs/advanced/ii/static-vs-dynamic-tiles.md
+    - docs/advanced/ii/equipment-system.md
+    - docs/advanced/ii/custom-replay-command.md
+    - docs/advanced/ii/pathfinding.md
+    - docs/advanced/ii/adding-hero-attribute.md
+    - docs/advanced/ii/adding-enemy-attribute.md
+    - docs/advanced/ii/enemy-context-and-combat.md
+
+key-decisions:
+  - "读者人格严格执行 D-68 提示词，并在记录中明确「未复用高级 I / 中级人格」"
+  - "B-14 当时以源码语义写成「相对现役装备」，并记录与审阅建议的差异；该口径后由 10-27/U8-02 按用户明确要求改为空槽语义"
+  - "非阻断问题只记录、不擅自扩大范围（D-14）；第 3 轮只处理复查新提出的 5 条非阻断项"
+  - "收尾时依据第 1–3 轮记录补记结构化结论「阻断性问题 = 0，审阅通过」，不改动历史轮次内容"
+
+patterns-established:
+  - "读者审阅循环：人格 → 问题清单 → 逐轮修阻断 → 同人格复审 → 结束标记"
+  - "每轮修复后 prettier + 构建双门禁：`build complete` 且无 dead link"
+
+requirements-completed: []
+
+coverage:
+  - id: D1
+    description: "10-26-READER-REVIEW.md：D-68 人格逐字记录、九篇范围、首轮问题清单与阻断/非阻断归类"
+    verification:
+      - kind: automated_ui
+        ref: "PowerShell 断言：人格提示词（空白归一化后逐字）+ 九篇范围 + REVIEW-II-OK"
+        status: pass
+    human_judgment: true
+    rationale: "人格提示词是否等价、问题是否算阻断，需按 D-46/D-68 人工判断"
+  - id: D2
+    description: "第 1 轮 12 条阻断问题修正（范围、图块、装备、录像、寻路、勇士/怪物属性、战斗上下文）"
+    verification:
+      - kind: automated_ui
+        ref: "pnpm exec tsx docs/.vitepress/init.ts && pnpm docs:build"
+        status: pass
+    human_judgment: true
+    rationale: "构建只能证明无死链与语法正确，链路/时序是否讲对需读者与用户复核"
+  - id: D3
+    description: "第 2 轮 2 条新增阻断问题修正（护甲验证方向、compareEquip 边界）"
+    verification:
+      - kind: automated_ui
+        ref: "pnpm exec tsx docs/.vitepress/init.ts && pnpm docs:build"
+        status: pass
+    human_judgment: true
+    rationale: "护甲数值方向与对比语义需业务方确认"
+  - id: D4
+    description: "第 3 轮复查：5 条非阻断项修正，阻断清零并写结束标记"
+    verification:
+      - kind: automated_ui
+        ref: "node node_modules/prettier/bin/prettier.cjs --check docs/advanced/ii/*.md && pnpm docs:build"
+        status: pass
+    human_judgment: true
+    rationale: "复审结论是判断性输出，需人工确认可接受"
+
+# Metrics
+duration: 40min
+completed: 2026-10-23
+status: complete
+---
+
+# Phase 10 Plan 26: 高级 II 读者审阅 Summary
+
+**以 D-68 数据端作者人格完成三轮读者审阅：14 条阻断问题全部消除、22 条非阻断问题按记录处理，九篇保持可构建、无死链**
+
+## Performance
+
+- **Duration:** 约 40 分钟（2026-10-21 20:09–20:48，含首轮审阅派发）
+- **Started:** 2026-10-21T20:09:28+08:00（首轮修复提交）
+- **Completed:** 2026-10-21T20:48:08+08:00（第 3 轮复查提交）
+- **Tasks:** 3（Task 0 审批门已由派发上下文放行）
+- **Files modified:** 10（九篇正文 + 审阅记录）
+
+## Accomplishments
+
+- `10-26-READER-REVIEW.md` 逐字记录 D-68 人格提示词与九篇审阅范围，并明确标记「未复用高级 I / 中级人格」；首轮归出 12 条阻断、19 条非阻断，均定位到文件与章节。
+- 第 1 轮修掉全部 12 条阻断：`scanRange` 只筛上下文怪物视图而非枚举空格；`transferToDynamic` 的 `keepEvent` 语义；装备验证的 equip/save/unequip/load 顺序与 `onChangeModifier` 不是穿戴钩子；被动录像 `IReplayPassiveHandler.next(status)` 的归属与记录链路；寻路移动中不接管、需 `onEnd` 或 `interrupt()`；`Dir4FaceHandler` 改从 `@user/data-common` 导入；护甲插入点换成保留全部分支的完整伤害计算器；无来源全局光环改实现 `IAuraView`；`setFloor` 不置 `needUpdate`；区分特殊光环优先级与常规查询同码排序；补旧存档迁移入口。
+- 第 2 轮由同人格审阅新增 2 条阻断并修正：护甲 50→0 的回合数与总伤害方向（减半而非翻倍）、`compareEquip` 的对比边界与 `-1` 语义；同时收敛 7 条非阻断。
+- 第 3 轮复查只提出 5 条非阻断（`block.static` 空格判定、被动录像枚举缺 `SkillEffect`、对比表、读档后 `dirty()`、护甲 `≥ 100` 边界），全部修正，未再出现阻断问题。
+- 每轮均执行 prettier 与 `pnpm exec tsx docs/.vitepress/init.ts && pnpm docs:build`，构建 green、`build complete`、无 dead link。
+
+## Task Commits
+
+1. **Task 2 第 1 轮：修复读者阻断问题** - `2d25a32` (docs)
+2. **Task 2 第 2 轮：修复读者问题** - `153bc8b` (docs)
+3. **Task 3 复查：修复复审非阻断项** - `04aae34` (docs)
+
+**Plan metadata:** 本 SUMMARY 与收尾结论提交（docs）
+
+_注：本计划相关提交共 3 个；同一区间内另有其它阶段提交，未计入本计划。_
+
+## Files Created/Modified
+
+- `.planning/phases/10-docs-restructure/10-26-READER-REVIEW.md` - 人格、范围、三轮问题清单、逐轮修复与结论。
+- `docs/advanced/ii/index.md` - 导览中的占位与边界表述修正。
+- `docs/advanced/ii/custom-range.md` - `scanRange` 语义、验证摆怪与 `iterateLoc` 检查、整数半径。
+- `docs/advanced/ii/static-vs-dynamic-tiles.md` - `transferToDynamic` 事件清理、`toStatic` 移动检查、读档 `dirty()`。
+- `docs/advanced/ii/equipment-system.md` - 验证顺序、装备钩子、对比规则、修饰器构建。
+- `docs/advanced/ii/custom-replay-command.md` - 被动处理链、`next` 语义、`SkillEffect` 枚举。
+- `docs/advanced/ii/pathfinding.md` - 移动接管、导入来源、`InvalidInput` 原因、空格判定。
+- `docs/advanced/ii/adding-hero-attribute.md` - 完整伤害计算器、默认值语义、存档迁移、自爆与护甲。
+- `docs/advanced/ii/adding-enemy-attribute.md` - `IAuraView`、护甲验证方向与边界、默认模板。
+- `docs/advanced/ii/enemy-context-and-combat.md` - `setFloor` 置脏、优先级语义、`refreshEnemy` 范围。
+
+## Decisions Made
+
+- 读者人格按 D-68 执行：不预设高代码水平，但要求已理解常用语法、能读懂样板与部分中等复杂度系统；与高级 I（代码能力一般）、中级（不懂代码）明确区分。
+- B-14 当时选择以源码为准解释 `compareEquip`，并在记录中标注「与审阅建议的差异」；后续用户 U8-02 明确空槽语义后，文档在 10-27 按用户口径重写。
+- 非阻断问题按 D-14 只记录；第 3 轮复查新提出的 5 条非阻断项属于复审直接产物，按复审要求修正。
+- 收尾未改写历史轮次，只在记录末尾补「结论（2026-10-23）」与结构化结束标记。
+
+## Deviations from Plan
+
+None - plan executed exactly as written（三轮上限内收敛；收尾补记结束标记属于记录收口，不改文档语义）。
+
+## Issues Encountered
+
+- 复审建议与源码在 B-14 上不一致：当时按源码写为「相对现役装备」，并把差异写进审阅记录；该分歧最终由用户在 10-27/U8-02 以「空槽语义」定案。
+- `10-26-READER-REVIEW.md` 原先以第 3 轮复查段落结束，没有计划要求的结构化结束标记；收尾时按第 1–3 轮既有记录补记「阻断性问题 = 0，审阅通过」，未改动历史内容。
+- 构建经 `cmd /c` 执行；PowerShell 会把 VitePress 的 stderr（chunk 体积警告）包装成 RemoteException，以 `$LASTEXITCODE` 与输出中的 `build complete` 判定成功。
+
+## Known Stubs
+
+- 高级 III 仍只用代码 span `高级 III · 原理与架构` 与 `TODO(advanced-III)` 占位，按 D-47 不提供页面入口；属既有设计，不是本计划遗留。
+- `TODO(editor)` / `TODO(renderer)` 等占位按 D-47 指向编辑器与渲染端，留给后续阶段。
+- 10-27/U6-04 新增 `point-and-tile-events.md` 后，高级 II 实际为十篇；本计划的审阅与结论对应新增前的九篇范围。
+
+## User Setup Required
+
+None - no external service configuration required.
+
+## Next Phase Readiness
+
+- 高级 II 九篇已通过 D-68 读者视角的阻断清零，可进入 10-27 的用户主导修订循环。
+- 非阻断残项已在审阅记录中列明，交由用户判断是否修改。
+- 高级 III 页面仍待规划；当前占位不会造成死链。
+
+---
+
+*Phase: 10-docs-restructure*
+*Completed: 2026-10-23*
+
+## Self-Check: PASSED
+
+- `.planning/phases/10-docs-restructure/10-26-READER-REVIEW.md` 存在，含人格、三轮记录与结论
+- `docs/advanced/ii/*.md` 九篇存在
+- 提交 `2d25a32`、`153bc8b`、`04aae34` 存在
+- `.planning/phases/10-docs-restructure/10-26-SUMMARY.md` 存在
--- a/.planning/phases/10-docs-restructure/10-27-SUMMARY.md
+++ b/.planning/phases/10-docs-restructure/10-27-SUMMARY.md
@ -0,0 +1,234 @@
+---
+phase: 10-docs-restructure
+plan: 27
+subsystem: docs
+tags: [user-review, revision-loop, advanced-ii, editor-placeholder, anchors, build-gate]
+
+# Dependency graph
+requires:
+  - phase: 10-docs-restructure
+    provides: "10-26 已消除阻断问题的高级 II 九篇与读者审阅记录"
+provides:
+  - ".planning/phases/10-docs-restructure/10-27-USER-REVIEW.md：U6-01..U6-22、U7-01..U7-08、U8-01..U8-02 的逐条意见、处置与用户最终确认"
+  - "docs/advanced/ii/*.md：十篇最终正文（新增 point-and-tile-events.md），含 D-69..D-74 规范落地"
+  - "用户最终确认：通过（2026-10-23）"
+affects: [10-28, phase-10-closeout]
+
+# Actuals (#2632)
+actuals:
+  tokens: 27702
+  tasks: 2
+  commits: 8
+  plan_head_before: 6c9f8df8a5b4648d984468e7191ec84750676415
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns:
+    - "用户主导修订循环：用户逐条提意见 → 批量子代理修改 → 回报 → 用户继续提或确认；AI 不替用户判定「不算问题」"
+    - "内部实现章节放在文档靠后，并在开头标注「此章节讲解一下……的内部实现」（D-69）"
+    - "代码块保持完整类/函数上下文以避免高亮错误（D-70）"
+    - "源注释与实现不一致时以注释为准并报告用户（D-72）"
+    - "编辑器假定已完成，只用「需要编辑器」占位，不写无编辑器时的过渡做法（D-73）"
+    - "跨文档引用具体章节统一使用 `./xxx.md#标题` 锚点（D-74）"
+
+key-files:
+  created:
+    - .planning/phases/10-docs-restructure/10-27-USER-REVIEW.md
+    - .planning/phases/10-docs-restructure/10-27-SUMMARY.md
+    - docs/advanced/ii/point-and-tile-events.md
+  modified:
+    - docs/advanced/ii/index.md
+    - docs/advanced/ii/custom-range.md
+    - docs/advanced/ii/static-vs-dynamic-tiles.md
+    - docs/advanced/ii/equipment-system.md
+    - docs/advanced/ii/custom-replay-command.md
+    - docs/advanced/ii/pathfinding.md
+    - docs/advanced/ii/adding-hero-attribute.md
+    - docs/advanced/ii/adding-enemy-attribute.md
+    - docs/advanced/ii/enemy-context-and-combat.md
+    - docs/.vitepress/config.ts
+
+key-decisions:
+  - "新增 `point-and-tile-events.md`（U6-04）：点事件与图块事件单独成篇，侧边栏由 9 篇扩为 10 篇"
+  - "D-69：装备修饰器与存档等纯内部实现章节移到文档靠后，并在开头标注为内部实现"
+  - "D-70：代码块必须包在完整类/函数上下文中，避免片段式高亮错误"
+  - "D-71：高级 I 待补 Mover 与 FaceHandler 系列接口，记录为 AI-GAP-01/02，待后续补写"
+  - "D-72：`transferToDynamic` 以方法注释为准（不论 keepEvent 都清空源图块事件），实现与注释不一致处已向用户报告，未擅自改实现"
+  - "D-73：全篇假定编辑器完成，`.jsonc` 内容只写「需要编辑器」占位，不写无编辑器时的过渡方案"
+  - "D-74：跨文档具体章节引用改用标题锚点；高级 II 改完后再回头检查高级 I 与中级教程"
+  - "U8-02：`compareEquip` 按用户口径改为空槽语义，覆盖 10-26/B-14 当时按源码写的「相对现役装备」"
+  - "U7-03：文档以方法注释为准；源码仅在 `keepEvent=true` 分支清空事件的不一致作为待报告项保留"
+
+patterns-established:
+  - "用户修订批处理：按主题分批（A–G），每批 prettier + 构建后单独提交"
+  - "占位规范：编辑器未实现的部分用 `> **需要编辑器**：...`，高级 III 仍用代码 span，不造死链"
+  - "锚点规范：只给明确指向具体章节的链接加 `#标题`，指向整篇的链接保持原样"
+
+requirements-completed: []
+
+coverage:
+  - id: D1
+    description: "U6-01..U6-22：范围常量与估算、事件独立成篇、装备与录像讲法收敛、寻路与属性/上下文简化"
+    verification:
+      - kind: automated_ui
+        ref: "node node_modules/prettier/bin/prettier.cjs --check docs/advanced/ii/*.md && pnpm docs:build"
+        status: pass
+    human_judgment: true
+    rationale: "每条是否符合用户本领域口径，只能由用户判断"
+  - id: D2
+    description: "U7-01..U7-08：事件视图 set 签名、keepEvent 注释口径、mover 前置、位宽收敛、NoPath 语义、编辑器假定"
+    verification:
+      - kind: automated_ui
+        ref: "pnpm exec tsx docs/.vitepress/init.ts && pnpm docs:build"
+        status: pass
+    human_judgment: true
+    rationale: "注释优先口径与编辑器假定属于用户明确规范，需人工确认落点"
+  - id: D3
+    description: "U8-01..U8-02 + 批次 G：高级 II 5 处章节锚点、跨层 55 处锚点、compareEquip 空槽语义"
+    verification:
+      - kind: automated_ui
+        ref: "pnpm exec tsx docs/.vitepress/init.ts && pnpm docs:build（生成 HTML 锚点逐项核对）"
+        status: pass
+    human_judgment: true
+    rationale: "compareEquip 语义与锚点覆盖范围由用户定案"
+  - id: D4
+    description: "最终格式与全量构建：prettier --check 通过、build complete、dead link = 0"
+    verification:
+      - kind: automated_ui
+        ref: "node node_modules/prettier/bin/prettier.cjs --check docs/advanced/ii/*.md docs/advanced/*.md"
+        status: pass
+      - kind: automated_ui
+        ref: "pnpm exec tsx docs/.vitepress/init.ts && pnpm docs:build"
+        status: pass
+    human_judgment: false
+  - id: D5
+    description: "用户最终确认：通过（原文「已经没问题了」，2026-10-23）"
+    verification: []
+    human_judgment: true
+    rationale: "D-46 第 2 阶段 / D-57 要求收尾必须由用户明确确认，AI 不得自行收尾"
+
+# Metrics
+duration: 2d
+completed: 2026-10-23
+status: complete
+---
+
+# Phase 10 Plan 27: 高级 II 用户修订循环 Summary
+
+**用户主导 32 条修订（U6 22 条、U7 8 条、U8 2 条）后确认「已经没问题了」：高级 II 扩为十篇，D-69..D-74 规范落地，最终构建 green、无死链**
+
+## Performance
+
+- **Duration:** 约 2 天（2026-10-22 至 2026-10-23，含最终确认）
+- **Started:** 2026-10-21T22:02:43+08:00（首轮意见记录提交）
+- **Completed:** 2026-10-23（用户确认与收尾）
+- **Tasks:** 2 个执行任务（Task 2 修订、Task 4 收尾）；Task 0/1/3 为人工门，已由用户确认放行
+- **Files modified:** 11（十篇正文 + 用户审阅记录），另新增本 SUMMARY
+
+## Accomplishments
+
+- 第 1 轮 U6-01..U6-22（批次 A–C）全部落地：范围对象提为常量并补 `estimatePointCount` 取舍；新增 `point-and-tile-events.md` 让点事件/图块事件单独成篇，侧边栏与导览同步为十篇；装备只讲修饰器用途、槽位名称与索引的区别、内部实现章节后置（D-69）；`loadEvent` / `unloadEvent` 标明尚未实现；录像改用选择框讲被动场景、注册移入插件、`@shouldReplay` 标在 `apply`，删除沙盒播放并修正 `next` 不推进的表述；寻路不再用 `Infinity`；`.jsonc` 删除正文注释、旧存档迁移改用 Executor；怪物上下文删去手动置脏细节并压缩刷新章节。
+- 第 2 轮 U7-01..U7-08（批次 D–E）全部落地：事件视图 `set(priority, event)` 两参数必填、不会恢复默认事件；删去「模块级复用」等写法说明；`transferToDynamic` 按方法注释改为「不论 keepEvent 都清空源图块事件」并保留实现差异报告（D-72）；`mover` 小节前置到 `moveBlock` 之前并引用高级 I 占位；指令码位宽收敛为一句提示；录像示例恢复为技能示例；`NoPath` 改为正常结果；全篇按「需要编辑器」占位（D-73）。
+- 第 3 轮 U8-01..U8-02 落地：高级 II 5 处具体章节引用补标题锚点；`compareEquip` 改为按空槽语义解释，`-1` 即空槽，不再出现「相对现役装备」；批次 G 进一步为中级/高级 I/高级 II 的 55 处章节引用补锚点，并逐项核对生成 HTML 的 `id`。
+- 用户以「已经没问题了」确认通过，记录中以独占一行的 `用户最终确认：通过` 收口（2026-10-23）。
+- 收尾格式与构建：prettier `--check` 对 `docs/advanced/ii/*.md` 与 `docs/advanced/*.md` 全部通过；`cmd /c "pnpm exec tsx docs/.vitepress/init.ts && pnpm docs:build"` 退出 0、`build complete in 18.24s`、无 dead link。
+
+## Task Commits
+
+1. **Task 1 第 1 轮意见记录** - `011759f` (docs)
+2. **Task 2 批次 A（U6-01..09）** - `5751dd9` (docs)
+3. **Task 2 批次 B（U6-10..17）** - `9673a28` (docs)
+4. **Task 2 批次 C（U6-18..22）** - `cc3c4e8` (docs)
+5. **Task 2 批次 D（U7-01/03/04）** - `112e46f` (docs)
+6. **Task 2 批次 E（U7-02/05/06/07/08）** - `7409a47` (docs)
+7. **Task 2 批次 F（U8-01/02）** - `3d2d375` (docs)
+8. **Task 2 批次 G（D-74 跨层锚点）** - `343296c` (docs)
+
+**Plan metadata:** 本 SUMMARY 与最终确认记录提交（docs）
+
+_注：本计划相关提交共 8 个；同一区间内另有其它阶段提交，未计入本计划。_
+
+## Files Created/Modified
+
+- `.planning/phases/10-docs-restructure/10-27-USER-REVIEW.md` - 三轮用户意见、批次 A–G 处置、待报告项与最终确认。
+- `.planning/phases/10-docs-restructure/10-27-SUMMARY.md` - 本收尾摘要。
+- `docs/advanced/ii/point-and-tile-events.md` - 新增：点事件与图块事件的区别、跟随移动、作者设置与存档恢复。
+- `docs/advanced/ii/index.md` - 十篇索引、阅读路径与边界同步。
+- `docs/advanced/ii/custom-range.md` - 范围常量、`estimatePointCount`、整数半径。
+- `docs/advanced/ii/static-vs-dynamic-tiles.md` - `keepEvent` 注释口径、mover 前置、`moveBlock` 顺序。
+- `docs/advanced/ii/equipment-system.md` - 接口用途收敛、槽位写法、内部实现后置、`compareEquip` 空槽语义。
+- `docs/advanced/ii/custom-replay-command.md` - 被动步案例与 `next`、注册入插件、删除位宽与沙盒细节。
+- `docs/advanced/ii/pathfinding.md` - 谓词控制不可达、`NoPath` 正常结果。
+- `docs/advanced/ii/adding-hero-attribute.md` - `.jsonc` 占位、Executor 迁移、删去 `Record` 细节、护甲边界。
+- `docs/advanced/ii/adding-enemy-attribute.md` - 编辑器占位、默认模板说明、护甲边界。
+- `docs/advanced/ii/enemy-context-and-combat.md` - 删去手动置脏、压缩刷新章节、`query()` 依赖说明。
+- `docs/.vitepress/config.ts` - 高级 II 侧边栏增补 `point-and-tile-events`（9→10）。
+
+## Decisions Made
+
+- U6-04 新增第十篇 `point-and-tile-events.md`；这是用户明确要求的范围扩展，侧边栏与导览同步为十篇。
+- D-69..D-74 六条长期规范在本计划落地并记录：内部实现后置（D-69）、完整类上下文（D-70）、高级 I 待补内容（D-71）、注释优先并报告不一致（D-72）、编辑器假定（D-73）、章节锚点（D-74）。
+- U7-03 发现 `transferToDynamic` 注释与实现对 `keepEvent=false` 的描述不一致：按 D-72 以注释书写，并作为「待报告」保留，未修改源码。
+- U8-02 以用户口径覆盖 10-26/B-14 的源码解释：`compareEquip` 一律按空槽比较，`-1` 表示该侧空槽。
+- 批次 G 按 D-74 的待办把锚点检查扩展到中级与高级 I，共补 55 处；指向整篇文档的链接保持原样。
+
+## Deviations from Plan
+
+### Auto-fixed / 用户驱动的范围调整
+
+**1. [用户授权] 新增第十篇文档**
+- **Found during:** 第 1 轮 U6-04
+- **Issue:** 点事件与图块事件内容复杂，散落在图块篇中难以讲清。
+- **Fix:** 新建 `docs/advanced/ii/point-and-tile-events.md`，迁移并扩写相关章节；侧边栏与导览同步为十篇。
+- **Files modified:** `docs/advanced/ii/point-and-tile-events.md`、`docs/advanced/ii/static-vs-dynamic-tiles.md`、`docs/advanced/ii/index.md`、`docs/.vitepress/config.ts`
+- **Verification:** prettier + 全量构建通过，锚点可解析。
+- **Committed in:** `5751dd9`
+
+**2. [用户授权] 锚点检查扩展到高级 I 与中级教程**
+- **Found during:** 第 3 轮 U8-01（D-74 待办）
+- **Issue:** 高级 II 完成后需回头检查高级 I 与中级教程的同类未定位链接。
+- **Fix:** 扫描 217 条跨文档链接，为 55 处明确指向具体章节的引用补标题锚点。
+- **Files modified:** `docs/intermediate/*.md`、`docs/advanced/*.md`、`docs/advanced/ii/*.md`
+- **Verification:** 构建后逐项核对 `public/_docs` 生成 HTML 的 `id`。
+- **Committed in:** `343296c`
+
+---
+
+**Total deviations:** 2（均为用户明确要求的范围调整）
+**Impact on plan:** 范围扩展由用户逐条授权，未产生计划外改动；`config.ts` 仅增补侧边栏条目，未改其它配置。
+
+## Issues Encountered
+
+- `transferToDynamic` 的方法注释与实现不一致（`keepEvent=false` 且静态图块实例已存在时事件未被清空）：按 D-72 以注释为准书写，并向用户报告，未擅自修改源码。
+- `compareEquip` 的逐键回退实现与「空槽语义」不完全一致：按用户明确的空槽语义书写，细节作为待报告项保留。
+- 构建经 `cmd /c` 执行；PowerShell 会把 VitePress 的 chunk 体积警告包装成 stderr 输出，以 `$LASTEXITCODE` 与 `build complete` 判定成功。
+
+## Known Stubs
+
+- 高级 III 仍只用代码 span `高级 III · 原理与架构` 与 `TODO(advanced-III)` 占位，不提供真实链接（D-47）。
+- 编辑器相关 `.jsonc`、状态栏与图鉴章节使用 `> **需要编辑器**：...` 占位，按 D-73 等编辑器完成后补写。
+- 高级 I 的 Mover 与 FaceHandler 系列接口尚未补写（D-71 / AI-GAP-01、AI-GAP-02），记为后续待办。
+
+## User Setup Required
+
+None - no external service configuration required.
+
+## Next Phase Readiness
+
+- 高级 II 十篇已按用户口径收口，并获 `用户最终确认：通过`。
+- 全量构建 green、prettier 通过、无 dead link；D-09 人工验收所需材料齐备。
+- 后续待办：高级 III 页面规划；高级 I 的 Mover / FaceHandler 补写（D-71）；编辑器完成后回填 `.jsonc` 占位。
+
+---
+
+*Phase: 10-docs-restructure*
+*Completed: 2026-10-23*
+
+## Self-Check: PASSED
+
+- `.planning/phases/10-docs-restructure/10-27-USER-REVIEW.md` 存在，含 `用户最终确认：通过` 与用户原文
+- `.planning/phases/10-docs-restructure/10-27-SUMMARY.md` 存在
+- `docs/advanced/ii/` 十篇存在；侧边栏 10 个目标
+- 提交 `011759f`、`5751dd9`、`9673a28`、`cc3c4e8`、`112e46f`、`7409a47`、`3d2d375`、`343296c` 存在
+- prettier `--check` 通过；构建 `build complete in 18.24s`、无 dead link
--- a/.planning/phases/10-docs-restructure/10-27-USER-REVIEW.md
+++ b/.planning/phases/10-docs-restructure/10-27-USER-REVIEW.md
@ -149,4 +149,14 @@
    - `enemy-status-hooks.md` 的 `save` 参数引用 → `./hero-attribute.md#save-参数与读档一致性`（1 处）；
    - `advanced/plugin-system.md` → `./saveable-content.md#验证`（1 处）。
    - `hooks.md` 的「切换楼层前后」指向「需求 → 钩子对照表」中的表格行而非标题，无对应锚点，保持原样。
- **验证：** prettier（CRLF、全部 unchanged）→ `cmd /c "pnpm exec tsx docs/.vitepress/init.ts && pnpm docs:build"` 退出 0、`build complete in 20.29s`；逐项检查 `public/_docs` 生成 HTML 的 `id`，本次新增锚点与此前批次 F 的 5 个锚点全部可解析。
+    - **验证：** prettier（CRLF、全部 unchanged）→ `cmd /c "pnpm exec tsx docs/.vitepress/init.ts && pnpm docs:build"` 退出 0、`build complete in 20.29s`；逐项检查 `public/_docs` 生成 HTML 的 `id`，本次新增锚点与此前批次 F 的 5 个锚点全部可解析。
+
+---
+
+## 最终确认（2026-10-23）
+
+用户原文：「已经没问题了」。
+
+用户最终确认：通过
+
+**最终状态：** 高级 II 十篇（原九篇 + `point-and-tile-events.md`）已按 U6-01..U6-22、U7-01..U7-08、U8-01..U8-02 全部处理完毕，无待处理条目；prettier `--check` 通过，`docs:build` 构建 green、`build complete`、无 dead link。