✨ feat: 实现 ControllerClient HTTP 兼容层及 FANUC 运行时

- 新增 Flyshot.ControllerClientCompat 兼容层模块
  - 新增 Flyshot.Runtime.Fanuc 运行时模块
  - 新增 LegacyHttpApiController 暴露 HTTP 兼容 API
  - 补充 RuntimeOrchestrationTests 等测试覆盖
  - 补充 docs/ 兼容性需求与逆向工程文档
  - 更新 Host 注册、配置及解决方案引用

  变更概览：
  - Flyshot.ControllerClientCompat — 旧 ControllerClient 语义的 HTTP 适配
  - Flyshot.Runtime.Fanuc — IControllerRuntime 的 FANUC 真机实现
  - LegacyHttpApiController — HTTP API 兼容旧 SDK
  - docs/ — 兼容性需求与逆向工程分析文档
  - 测试：RuntimeOrchestrationTests、LegacyHttpApiCompatibilityTests

AGENTS.md

@@ -37,7 +37,12 @@
 flyshot-replacement/
   ├─ src/
   │  ├─ Flyshot.Server.Host/
+  │  ├─ Flyshot.ControllerClientCompat/
+  │  ├─ Flyshot.Core.Config/
   │  ├─ Flyshot.Core.Domain/
+  │  ├─ Flyshot.Core.Planning/
+  │  ├─ Flyshot.Core.Triggering/
+  │  ├─ Flyshot.Runtime.Fanuc/
   │  └─ Flyshot.Runtime.Common/
   ├─ tests/
   │  ├─ Flyshot.Server.IntegrationTests/
@@ -64,8 +69,10 @@ flyshot-replacement/
 - `Flyshot.Core.Triggering`
   - `TrajectoryDO` 等价时间轴
   - `shot_flags / offset_values / addr` 解析
-- `Flyshot.LegacyGateway`
-  - `50001/TCP+JSON` 兼容接入
+- `Flyshot.ControllerClientCompat`
+  - HTTP 控制器后端兼容服务
+  - 旧 `ControllerClient` 语义适配
+  - 不启动 `50001/TCP+JSON` 监听
 - `Flyshot.Runtime.Fanuc`
   - `10010 / 10012 / 60015`
 - `Flyshot.Web.Status`
@@ -135,6 +142,20 @@ flyshot-replacement/
 - `../analysis/FANUC_realtime_comm_analysis.md`
 - `../FlyingShot/FlyingShot/Include/ControllerClient/ControllerClient.h`
 
+### 6.1 父目录资料引用约定
+
+- 日常开发、测试和 Codex 会话默认从 `flyshot-replacement/` 根目录启动。
+- 当前仓库内的 `@` 引用默认只覆盖本仓库文件，不要假设它能索引父目录资料。
+- 引用父目录资料时，统一直接写明确路径，优先使用相对路径，例如：
+  - `../analysis/ICSP_algorithm_reverse_analysis.md`
+  - `../analysis/ControllerServer_analysis.md`
+  - `../FlyingShot/FlyingShot/Include/ControllerClient/ControllerClient.h`
+- 当路径较长或跨工具复制时，可以使用绝对路径，但在文档和注释中优先保留相对路径写法，便于仓库整体搬迁。
+- 父目录中的 `analysis/`、`FlyingShot/`、`RobotController/`、`RPS/` 默认视为参考资料区，不在这些目录中继续落地新实现。
+- 新实现、测试、兼容层代码、设计文档和运行说明，都应优先写入 `flyshot-replacement/` 内部。
+- 如果父目录资料中的某段结论会长期影响本仓库实现，应在本仓库 `docs/` 中补充归纳说明，并标明来源路径，而不是要求后续开发反复回看聊天记录。
+- 如果需要引用父目录样本文件做测试输入，优先通过只读方式加载；只有在测试需要固化样本且样本已明确收敛时，才复制到本仓库测试数据目录。
+
 ## 7. 任务推进方式
 
 - `README.md` 中的 Todo 需要随着阶段推进同步更新。
@@ -148,3 +169,8 @@ flyshot-replacement/
 - `Flyshot.Server.Host` 已提供最小 `/healthz`。
 - 最小集成测试已通过。
 - 解决方案构建已通过。
+- HTTP-only `ControllerClientCompat` 已覆盖旧 HTTP 控制器后端的主要兼容语义。
+- `Flyshot.Core.Planning` 已落地 `icsp` 与 `self-adapt-icsp` 的最小规划链路。
+- `Flyshot.Core.Triggering` 已能从 `shot_flags / offset_values / addr` 生成触发时间轴。
+- `Flyshot.Runtime.Fanuc` 已提供状态型最小运行时骨架，供兼容服务执行规划结果。
+- `ExecuteTrajectory` / `ExecuteFlyShotTraj` 已接入 `Planning + Triggering + Runtime`，不再只是兼容层内存赋值。