补充变换角点偏移编辑器设计合同

新增四角选择与单组输入交互设计文档

记录 Transform offset 映射、方向键语义与验收边界

docs/README.md

@@ -30,6 +30,7 @@
 - [GameAgent 资源自由画板与快速编辑](./technical/【技术方案】GameAgent资源自由画板与快速编辑-2026-08-20.md)
 - [UI 工作流资源桥接与 Runtime 执行](./【技术方案】UI工作流资源桥接与Runtime执行-2026-08-24.md)
 - [UI 编辑器 Godot 容器布局](./technical/【技术方案】UI编辑器Godot容器布局模型-2026-08-18.md)
+- [UI 编辑器变换角点偏移编辑器](./technical/【设计】UI编辑器变换角点偏移编辑器-2026-09-03.md)
 - [UI 编辑器子节点显示规则](./technical/【技术方案】UI编辑器子节点显示规则-2026-08-18.md)
 - [UI 编辑会话模块边界](./technical/【前端架构】UI编辑会话模块边界-2026-08-19.md)
 

docs/technical/【设计】UI编辑器变换角点偏移编辑器-2026-09-03.md

@@ -0,0 +1,45 @@
+# UI 编辑器变换角点偏移编辑器
+
+更新时间：`2026-09-03`
+
+## 目标
+
+将 UI 编辑器 Inspector 中的 offset 编辑从两行 `offset_min/offset_max` 改为四角选择式编辑：界面展示左上、右上、左下、右下四个角，用户先选择一个角，再使用唯一的一组 X/Y 数字输入和四个方向键调整该角。
+
+本次只改变编辑器表现和交互，不改变 `Transform` 数据结构、持久化格式或后端契约。
+
+## 数据映射
+
+四角是现有两个 offset 向量的投影，不是四组独立数据：
+
+| 选中角 | X 输入写入 | Y 输入写入 |
+| --- | --- | --- |
+| 左上 | `offset_min[0]` | `offset_min[1]` |
+| 右上 | `offset_max[0]` | `offset_min[1]` |
+| 左下 | `offset_min[0]` | `offset_max[1]` |
+| 右下 | `offset_max[0]` | `offset_max[1]` |
+
+输入框始终显示对应 `Transform` 的原始 offset 值，保留现有正负号；不转换成 CSS `right`/`bottom` 语义。切换角时读取同一组共享分量，修改后其他受影响角会随数据更新而同步。
+
+## 交互
+
+- 组件内部维护当前选中角，默认左上；节点或 `transform` 切换时重置为左上。
+- 四角按钮按左上、右上、左下、右下空间位置排布；当前角高亮并提供可访问名称。
+- 页面只渲染一组 X/Y 数字输入和一组上、下、左、右方向键，二者都只作用于当前选中角。
+- 方向键每次按 `1` 调整对应分量；按住支持连续触发，按住 `Shift` 时步长为 `10`。
+- 方向键映射：左/右调整选中角的 X， 上/下调整选中角的 Y。具体写入字段遵循上表，因此移动角点可能改变矩形尺寸。
+- 数字输入沿用现有行为：失焦或回车提交，Escape 恢复当前值，非法或空值不写回；只读状态禁用所有变更入口。
+- 锚点预设、自定义锚点、无效矩形 warning、根节点禁止修改等现有行为保持不变。
+
+## 非目标
+
+- 不新增四角持久化字段，不修改 `Transform` schema 或后端接口。
+- 不提供四角独立状态，也不提供整体平移快捷键。
+- 不增加移动端专属布局或移动端交互。
+
+## 验收
+
+1. 四角选择能正确驱动唯一一组 X/Y 输入，并按数据映射表写回 `offset_min/offset_max`。
+2. 四方向键只修改当前选中角对应分量，步长、Shift 加速、长按行为可用。
+3. 输入提交、Escape 回滚、非法值、只读状态和现有 warning 行为不回归。
+4. `Transform` 类型、持久化数据和现有锚点编辑行为保持不变。