# 实施计划 顺序按**风险递减**排列:每一步都有可独立验证的门禁,失败即停,不进入下一步。 ## 0. 纯逻辑与测试夹具 - 在 `workbench/client/src/edit/` 新增参数值的纯逻辑:数值格式化/解析(保留 `1.`、`-`、空串中间态)、范围校验、`station ↔ 米` 换算。 - 与现有 `meters.ts` / `projection.ts` / `selection.ts` 同侧,**不得 import OpenLayers**。 - 失败优先的 vitest:越界判定的边界值、中间态解析不丢字符、米↔station 往返不漂移。 - 门禁:新增模块的单测在 node 下跑通,且 `grep -r "from 'ol" ` 对新文件无命中。 ## 1. 面板只读渲染 - 新增面板组件,遍历 `editHandles` 渲染:中文名、`value.current`、单位、`[min, max]`。**此步不可编辑。** - 多个 `road-lane-divider` 按 `boundaryIndex` 分行;不可编辑手柄呈禁用态并显示 `disabledReason`。 - 依 `handle.constraintId` 是否存在标记"已修改"。 - 区间每条路一行,以米显示。 - 验证:选中不同道路、选中含保留区的道路、选中多车道道路,面板结构正确。 - 门禁:`directEdit` 开关关闭时面板不渲染、不请求 manifest,网络轨迹与 main 一致。 ## 2. 拖拽 → 面板回流 - 拖拽值**直接写 DOM 节点**(ref + `textContent` / `value`),不经 React 渲染。 `direct-edit-client.md` §7:rAF 合并是**最低要求**,"写到源头"才是生产规则;ghost 直接写 OL source,面板的等价物是直接写 DOM。 - **禁止**在 `handleDragEvent` 中 `setState`;gesture 结束时才做一次 state 对账。 - 禁止在 `setState` updater 内计算或读 OL 状态(§6)。 - 验证:拖拽过程中面板数值实时跟随;用 render 计数确认**面板未新增任何渲染**。 注意门禁不是"拖拽期间渲染 0 次"——`onSettled` 的 `setManifest` 本就会在拖拽中随防抖预览触发渲染,那是服务端权威预览的固有代价,改动前就存在。要证明的是 `pointermove` 自身不再产生渲染。 - 拖拽中落地的预览会把 manifest 换成滞后一个防抖周期的值,需保证数字不在两者间闪烁。 - 门禁:节流有效性必须在此步证明。手柄当前仅 5~6 个,问题不会自行显现;跳过则后续无从归因。 ## 3. 输入通道:预览、gesture 边界、commit - 输入框接入 `draftFor` → `PreviewRequester.schedule()`,复用 80ms 防抖与 `previewSeq` 仲裁。 - gesture 边界按 `design.md` 表实现:`focus` 铸 operationId,`onChange` 只预览,`blur` / `Enter` 走 `flush()` + `commitGesture()`,`Escape` 回滚 + `cancel()`。 - 聚焦期间显示本地文本 draft,失焦后跟随 `value.current`。 - **`EditSession` 与 `gestureIdentity()` 不得修改**;若发现需要改,说明边界映射错了,退回重审。 - 验证:输入框改值与拖到同一数值产出同形约束;输入 `1.53` 后一次 Ctrl+Z 回到修改前;键入 `1.` 期间到达的预览响应不改写输入框。 - 门禁:一次非空表单编辑可在正式重编译结果中观察到几何变化。只交付 UI 不算通过。 ## 4. 范围拒绝与极值填入 - 越界输入:标红、**不发预览请求**、不进 undo 栈、保留最后一个有效预览。 - 拖拽与滑杆的夹值行为保持不变(`projectHandleValue` 不改)。 - 范围提示中的极值可点击填入。 - 验证:越界时网络面板无新请求;blur 后无新 undo 步骤;点击极值可正常提交;拖拽越界时手柄仍停在极限。 - 门禁:夹值与拒绝的差异必须体现为 `design.md` 中的同一条不变量,不得实现成两条并列策略。 ## 5. 重置与区间换算 - 每行"重置"删除该约束,使该行回到未修改态(`constraintId` 消失、值回落基线)。 - 区间的米↔station 换算实现并单测;**区间行受 `intervalEditingSupported` 门控,当前为 `false` 故不渲染**。 理由与 range 手柄一致(`flag.ts:46`):`compileGeometry()` 不读 `profile.interval`,一个改了没效果的输入框比没有更糟。 换算只在用户实际编辑时进行,渲染路径不做米→station→米 往返。 - 验证:重置后保存重编译,该参数回到基线;换算函数往返无累积漂移;开关为 `false` 时面板不出现区间行。 ## 6. 加固与手测 - `saveDirectEdits()` 入口强制结算未闭合 gesture,不依赖 blur/click 顺序。 - 手测清单: - 输入未失焦直接点"保存",修改被正确持久化。 - 拖拽与输入交替操作,undo/redo 序列正确。 - 快速连续输入,乱序预览响应不覆盖较新结果。 - 切换选中道路时未闭合的输入被正确结算或放弃。 - OpenLayers `Map` 未被重建,仅受影响 source 被替换。 - 门禁:交付前 `directEdit` 开关行为与改动前一致。 ## 验证命令 ```sh npm run format:check npm run test npm run test:client npm run test:client:unit npm run build ``` ## 风险文件 - `workbench/client/src/App.tsx`:974 行单组件。面板 state 与拖拽回流都落在此处,是重渲染风险的集中点;必要时先抽出编辑状态再加面板。 - `workbench/client/src/edit/session.ts`:**不应修改**。若实现中需要改动,说明 gesture 边界映射有误。 - `workbench/client/src/edit/projection.ts`:`projectHandleValue` 的夹值是拖拽正确性的一部分(见其 75 行注释),不得为"统一行为"而移除。 - `workbench/client/src/edit/preview-request.ts`:防抖与 `previewSeq` 仲裁由两条通道共用,任何改动同时影响拖拽。 - `src/compile/direct-edit-solver.js`:**本任务不改**。若发现必须改,先确认不是把服务端校验缺口混进了本任务范围。