From 35a5973cbeada7e464d56f17340d4c7bbf43d1bb Mon Sep 17 00:00:00 2001
From: unanmed <1319491857@qq.com>
Date: Fri, 18 Sep 2026 12:24:27 +0800
Subject: [PATCH] docs(04): plan hero-mover interface exploration (04-02)

---
 .planning/ROADMAP.md                                |  4 ++++
 .planning/STATE.md                                  | 12 ++++++------
 .planning/phases/04-render-adaptation/04-02-PLAN.md |  2 ++
 .planning/phases/04-render-adaptation/04-CONTEXT.md | 13 +++++++++++++
 .planning/state.json                                |  6 +++---
 5 files changed, 28 insertions(+), 9 deletions(-)

diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md
index 83d71ba..b4adeea 100644
--- a/.planning/ROADMAP.md
+++ b/.planning/ROADMAP.md
@@ -184,8 +184,12 @@ Plans:
 **Plans**: 1/2 plans executed（第一步·只读对账已完成；第二步·勇士移动接口探索（只读）已规划 — 04-CONTEXT D-01/D-02/D-13/D-17/D-18；后续适配实施与双布局待探索结果与缺失候选裁决后另行规划）
 
 Plans:
+**Wave 1**
 
 - [x] 04-01-PLAN.md — 渲染端 ↔ 数据端接口对账（只读清点，产出 `04-RENDER-INTERFACE-AUDIT.md`；按 ① 错配 / ② 数据端缺失 / ③ 多余旧路径 三类登记）
+
+**Wave 2** *(blocked on Wave 1 completion)*
+
 - [ ] 04-02-PLAN.md — 勇士移动接口探索（只读，D-17）：产出 `04-HERO-MOVER-INTERFACE.md`（数据端现行接口 / 渲染端现状 / 逐成员三态对账 / 缺失接口候选 / 未确定 / 处置；排除 `HeroRendering`（D-18）与 `core.*`（D-12）；不改任何代码，适配（04-03+）未规划）
 
 **UI hint**: yes
diff --git a/.planning/STATE.md b/.planning/STATE.md
index 8f5040e..08eb587 100644
--- a/.planning/STATE.md
+++ b/.planning/STATE.md
@@ -3,16 +3,16 @@ gsd_state_version: "1.0"
 milestone: v1.0
 current_phase: 04
 current_phase_name: 渲染适配与双布局
-status: verifying
+status: executing
 stopped_at: Completed 04-01-PLAN.md（只读对账账本已交付；阶段 4 剩余工作待用户拆分）
-last_updated: "2026-09-18T02:52:58.322Z"
+last_updated: "2026-09-18T04:24:14.367Z"
 last_activity: 2026-09-18
 last_activity_desc: Phase 04 execution started
-state_head: 4327e6733b1e241c3a840a91c63c9c10e860624c
+state_head: 908fbf385b8517429de5c3095e0b79b46ecd1df6
 progress:
   total_phases: 7
   completed_phases: 0
-  total_plans: 72
+  total_plans: 73
   completed_plans: 71
 milestone_name: milestone
 ---
@@ -28,9 +28,9 @@ See: .planning/PROJECT.md (updated 2026-09-17)
 
 ## Current Position
 
-Phase: 04 (渲染适配与双布局) — EXECUTING
+Phase: 04 (渲染适配与双布局) — READY TO EXECUTE
 Plan: 1 of 1
-Status: Phase complete — ready for verification
+Status: Ready to execute
 Last activity: 2026-09-18 — Phase 04 execution started
 
 Progress: [█████░░░░░] 50%
diff --git a/.planning/phases/04-render-adaptation/04-02-PLAN.md b/.planning/phases/04-render-adaptation/04-02-PLAN.md
index a5d5d28..798dba8 100644
--- a/.planning/phases/04-render-adaptation/04-02-PLAN.md
+++ b/.planning/phases/04-render-adaptation/04-02-PLAN.md
@@ -63,6 +63,8 @@ Phase 4 第二个增量（D-17）：对**勇士移动子系统**做**只读接
 
 **后续适配（04-03+）在本 run 不规划**：适配依赖本探索输出，且需用户先裁决缺失候选（D-13/D-17）。
 
+**后续增量决策（显式延后，本计划不涉及、不实施）：** CONTEXT.md 的三项设计补充裁定属于**后续增量**，与本 run 的只读勇士移动接口探索无关，故本计划不规划、不设计、不实施、不裁决它们，留待相应增量规划时另行覆盖：D-14（全局 `hook` 和 `loading` 也是 legacy 内容，需删除）、D-15（存档系统 UI 尚未接入新的存档系统）、D-16（渲染端结构化重构：拆为 `base-system-client` 三层，不再需要 common）。三者均不在本计划的交付物、对账范围或范围门禁内。
+
 **执行前置关卡（AGENTS.md，第一个 block 点）：** 本计划第一个执行步骤是 Task 0 —— 先向用户汇报「本计划要解决的问题 / 大致解决方案 / 范围边界与禁令」，然后**停下等待**用户明确回复「可以执行」四个字。收到该回复前，任何任务都不得执行，也不得派发执行子代理；无论触发方式（`/gsd-execute-phase`、`/gsd-manager`、`/gsd-autonomous`、子代理/执行器派发）或配置模式（`.planning/config.json` 的 `yolo`、`workflow.auto_advance`）如何，均不得自动放行。故本计划 `autonomous: false`。
 
 Purpose: 勇士移动是本次对账暴露的主要失配点（D-17）。在动适配代码前先把「数据端到底提供什么、渲染端到底需要什么、差在哪」钉死到接口成员级，避免按旧形状直接改渲染端。
diff --git a/.planning/phases/04-render-adaptation/04-CONTEXT.md b/.planning/phases/04-render-adaptation/04-CONTEXT.md
index 265bd05..b8c2772 100644
--- a/.planning/phases/04-render-adaptation/04-CONTEXT.md
+++ b/.planning/phases/04-render-adaptation/04-CONTEXT.md
@@ -36,6 +36,19 @@
 ### 执行方式
 - **D-09:** 允许派子代理进行只读扫描（不得修改任何文件）。
 
+### 设计补充（用户裁定，2026-09-18；仅记录，暂不执行）
+- **D-10:** `HeroRendering` 删除；渲染端相关的数据存储放到渲染端，渲染端自身也可以继承 `ISaveableContent`。
+- **D-11:** 诸如 `getHeroStatusOn` 这种裸函数，除非它是功能性函数，或者属于某些已明确的函数（如 replay 的那些修饰器裸函数），否则大多是将要删除的。
+- **D-12:** 所有调用 `core.*` 或 `client.*` 的地方大多需要删除。现行接口设计倾向**无全局单例**：所有内容全部挂到主类上，主类允许多例。其中 `core.*` 属旧引擎适配，应属于**第五阶段**，暂时可忽略；`client.*` 属于**本阶段**需要处理的内容。
+- **D-13:** 数据端缺失接口可能较多，等到开始改的时候再逐步确认（本阶段不从对账清单一次性定死缺失接口）。
+- **D-14:** 全局 `hook` 和 `loading` 也是 legacy 内容，需要删除。
+- **D-15:** 存档系统的 UI 目前还未接入新的存档系统。
+- **D-16:** 渲染端还需要进行结构化重构：将渲染端拆为类似数据端的 common-base-system-state 结构，但只需拆为三层——`base-system-client`（不再需要 common）。
+
+### 下一步聚焦（用户裁定，2026-09-18；待规划）
+- **D-17:** 由对账结果看，主要失配点在**勇士移动**部分。下一步规划：把**勇士移动适配到新接口**——先进行**接口探索**（并找出缺失的接口），再进行**适配工作**。
+- **D-18:** `HeroRendering` 相关暂不处理：用户先修改数据端，之后再处理。
+
 ### the agent's Discretion
 - D-07 的「影响」字段具体写法、「多余旧路径」是否需要进一步细分，交由 AI 在对账执行时按实际情况把握，但不得据此扩大范围。
 
diff --git a/.planning/state.json b/.planning/state.json
index 12f5719..8592719 100644
--- a/.planning/state.json
+++ b/.planning/state.json
@@ -41,8 +41,8 @@
   ],
   "next": {
     "command": "/gsd:progress --next",
-    "label": "Advance to the next step (verify)",
-    "reason": "Phase 04 of 7 · ready to verify"
+    "label": "Advance to the next step",
+    "reason": "Phase 04 of 7 · executing"
   },
-  "updated_at": "2026-09-18T02:52:40.728Z"
+  "updated_at": "2026-09-18T04:24:14.460Z"
 }