diff --git a/.planning/phases/10-docs-restructure/10-27-USER-REVIEW.md b/.planning/phases/10-docs-restructure/10-27-USER-REVIEW.md
new file mode 100644
index 0000000..eb0ea07
--- /dev/null
+++ b/.planning/phases/10-docs-restructure/10-27-USER-REVIEW.md
@@ -0,0 +1,41 @@
+# 高级 II 用户修订记录
+
+## 第 1 轮（2026-10-20，待执行）
+
+**状态：** 已记录，明日继续执行。修改方式将按 GSD 流程派发子代理（只改 `docs/advanced/ii/*.md`，必要时含 `docs/advanced/*.md`）。
+
+| # | 用户意见 | 落点 |
+|---|----------|------|
+| U6-01 | `const hits = state.enemyContext.scanRange(new RingRange() ...)`：把 `new RingRange()` 提出来作为常量；引擎代码风格不建议在此内联 `new` | `custom-range.md` |
+| U6-02 | 范围要专门讲 `estimatePointCount`：只要求尽量快地估算大致数量，不要为数量准确牺牲性能（否则自动判断可能因估算太慢而变慢） | `custom-range.md` |
+| U6-03 | 有些代码未包裹完整类上下文导致高亮错误，重点关注**类的方法**；适用于后续所有文档（D-70） | 全部 |
+| U6-04 | 点事件与图块事件较复杂，**单独开一篇文档**讲；重点：二者区别、跟随移动的区别、二者都可以自己设置且跟随存档 | 新增文档（II） |
+| U6-05 | 「事件基准」简单提一句即可：`markPure` 与 `ref` 是样板内部优化接口，一般不要调用，除非清楚自己在做什么 | `static-vs-dynamic-tiles.md` |
+| U6-06 | 装备 `getModifier` 的实现细节不用讲，只说它用于获取装备修饰器 | `equipment-system.md` |
+| U6-07 | 若 `slots` 定义为字符串，也可以传索引；索引最精确、字符串是粗略描述（同名时无法指定具体槽）。文档写成「不能混用」应改 | `equipment-system.md` |
+| U6-08 | 「修饰器与存档的关键约定」讲的是内部实现：章节开头写「此章节讲解一下 XXX 的内部实现」；这类纯内部实现章节应放在文档靠后，前面主要讲使用（D-69） | `equipment-system.md` 及后续 |
+| U6-09 | `loadEvent` / `unloadEvent` 尚未实现，文档要说明「还未实现」，待后续实现再改 | `equipment-system.md` |
+| U6-10 | 内置录像行为还没做完，不要用内置作为示例；直接用注释写一行省略已有录像码枚举 | `custom-replay-command.md` |
+| U6-11 | 被动录像的典型案例：弹出一个选择框，玩家选择内容；录像无法提前知道弹出什么选择框，只能等选择框出现后由选择框系统自己读录像选择——用这个案例讲被动录像 | `custom-replay-command.md` |
+| U6-12 | 主动/被动录像的推进部分太复杂，不要讲太细：被动步用完后要调用 `next`，否则再次调用还是这个被动步（可能确实需要在多处调用，但务必 next）；主动步实现 `execute` 即可 | `custom-replay-command.md` |
+| U6-13 | 讲明「被动步为什么必须跟在主动步之后、且在主动步完成前全部被使用」：若主动步执行完才轮到被动步，被动步未被调用会永远卡住；主动步需要被动步时会报错。实际中被动步一定源于某个主动操作 | `custom-replay-command.md` |
+| U6-14 | 录像注册建议写到插件里：安装别人的插件时无需自己再注册录像，只需新增录像码；这是样板推荐写法 | `custom-replay-command.md` |
+| U6-15 | 记录处：`apply` 才是应写 `@shouldReplay` 的地方（它才可能修改状态），`use` 只是调用 `apply`，可以不写；且 `use` 里有 `if` 判断，不能用时会直接告警 | `custom-replay-command.md` |
+| U6-16 | 沙盒播放不用讲（且原文讲错了）：沙盒播放必须启用录像，否则播放结束没有记录任何录像，不能重播也不能验证；样板会内置沙盒播放，作者几乎不需要自己写 | `custom-replay-command.md` |
+| U6-17 | 被动步忘记 `next` 不是不推进，只是不读下一个录像；若此时主动录像播完，会继续播放后面的录像 | `custom-replay-command.md` |
+| U6-18 | 自动寻路中不要用 `Infinity` 把一个点设为不可达；不可达应由谓词控制，用 `Infinity` 不标准 | `pathfinding.md` |
+| U6-19 | 样板所有 `.jsonc` 只允许开头那条带系统前缀注释的注释，后面不允许注释；勇士属性处不要说 `.jsonc` 允许注释。且 `.jsonc` 由编辑器修改，留占位 | `adding-hero-attribute.md`（及 `.jsonc` 相关内容） |
+| U6-20 | 新增勇士属性若需存档迁移，建议用 Executor 实现——Executor 本就是为了这个目标而存在 | `adding-hero-attribute.md` |
+| U6-21 | 内容层是 JSONC，不经过 TypeScript 的 `Record` 检查；TS 手写 `IItemEquipData<IHeroAttr>` 的 `Record` 细节作者不需要知道，这段不用专门说 | `adding-hero-attribute.md` |
+| U6-22 | 怪物上下文不要讲手动更新（样板已基本做好，少数情况才需 `markDirty`）；细节过多、难懂，要降低理解难度。刷新只说：若怪物申请了上下文查询，周围怪物更新时它也要更新——这正是必须用 `query()` 而非 `handler.context` 的原因。局部刷新与全量重建章节缩减到现在的一半 | `enemy-context-and-combat.md` |
+
+## 高级 I 待补内容（用户 2026-10-20 提出，待后续补写）
+
+| # | 主题 | 说明 |
+|---|------|------|
+| AI-GAP-01 | 移动 Mover | 高级 I 未讲，需补写 |
+| AI-GAP-02 | FaceHandler 系列接口 | 高级 I 未讲，需补写 |
+
+## 迭代记录
+
+（待执行后追加）
diff --git a/.planning/phases/10-docs-restructure/10-CONTEXT.md b/.planning/phases/10-docs-restructure/10-CONTEXT.md
index 0aafc41..1ca2036 100644
--- a/.planning/phases/10-docs-restructure/10-CONTEXT.md
+++ b/.planning/phases/10-docs-restructure/10-CONTEXT.md
@@ -190,6 +190,9 @@
   9. **怪物上下文与战斗深入**：buildup 管线、优先级、缓存/脏标记、伤害系统与光环/查询/最终的交互。
   推荐顺序：导览 → 范围对象 → 图块（含点事件/图块事件）→ 装备 → 录像指令 → 寻路 → 勇士属性 → 怪物属性 → 怪物上下文与战斗。仍以数据端为主；渲染端与编辑器内容按 D-47 占位。
 - **D-68（高级 II 读者水平）：** 不要给高级 II 读者预设过高的代码水平。目标读者应设定为：**已经理解了绝大多数常用语法；认真阅读样板后，能把一部分简单系统和中等复杂度的系统读明白**。审阅人格与文档难度均按此标准，而不是按「资深引擎开发者」预设。
+- **D-69（纯内部实现章节，长期规范）：** 讲解**纯内部实现**的章节，开头必须写明「此章节讲解一下 XXX 的内部实现」；这类章节应放在文档**靠后**位置，文档前面以「如何使用」为主。适用于后续所有文档写作。
+- **D-70（代码块完整类上下文，长期规范）：** 代码块必须包裹**完整的类上下文**（尤其是类的方法），确保语法高亮正确；不要单独展示脱离类的方法体。适用于后续所有文档写作。
+- **D-71（高级 I 待补内容）：** 高级 I 还有未讲内容，待后续补写：**移动 Mover**、**FaceHandler 系列接口**。当前先完成高级 II，之后再补。
 
 </decisions>