docs(04): plan hero-mover interface exploration (04-02)

This commit is contained in:
unanmed 2026-09-18 12:24:27 +08:00
parent 908fbf385b
commit 35a5973cbe
5 changed files with 28 additions and 9 deletions

View File

@ -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

View File

@ -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%

View File

@ -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。在动适配代码前先把「数据端到底提供什么、渲染端到底需要什么、差在哪」钉死到接口成员级避免按旧形状直接改渲染端。

View File

@ -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 在对账执行时按实际情况把握,但不得据此扩大范围。

View File

@ -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"
}