wangdequan/KDL_WORK
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
fe13b081e3b481c59e268dcfdcd6130a5db4230d
KDL_WORK/03-推进台账.md
wangdequan fe13b081e3 Initial working1 implementation docs
2026-06-27 07:26:48 -04:00

1098 lines
54 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 03-推进台账
版本：0.3
日期：2026-06-27
## 1. 记录规则
每轮推进后追加记录，格式固定：
```text
轮次：
日期：
关联任务：
本轮目标：
做了什么：
改了哪些文件：
验证了什么：
问题和风险：
下一步：
```
## 2. 台账
### 轮次 001
日期：2026-06-27
关联任务：`KW-000`
本轮目标：根据用户要求，将 `working1` 实施文档调整为完全对标两份源文档：
1. `/home/meswork/kdl_work/work/doc/KDL_WASM计算接口设计.md`
2. `/home/meswork/kdl_work/work/doc/通用机器人编程语法规范.md`
做了什么：
1. 抽取 KDL WASM 文档中的目标、架构、API、数据类型、轨迹函数、诊断、P0/P1、测试要求和实施顺序。
2. 抽取 GRL 语法规范中的词法、顶层结构、类型系统、目标点、运动、Path、Operation、IO、流程控制、proc/func、异常、中断、多任务、品牌扩展、后处理、IR、语义检查、EBNF、P0/P1。
3. 将任务编号重排为：
- `KW-001` 到 `KW-013`：KDL WASM 计算接口实施。
- `KW-100` 到 `KW-112`：GRL 编程语法实施。
4. 删除当前实施范围中对其他源文档的依赖表述。
5. 按两份源文档重写功能范围、开发步骤、任务矩阵、验收证据和 ADR。
改了哪些文件：
1. `work/working1/README.md`
2. `work/working1/01-项目功能内容.md`
3. `work/working1/02-项目程序开发详细步骤.md`
4. `work/working1/03-推进台账.md`
5. `work/working1/04-任务矩阵.md`
6. `work/working1/05-验收证据.md`
7. `work/working1/06-决策记录.md`
验证了什么：
1. `work/doc/KDL_WASM计算接口设计.md` 存在。
2. `work/doc/通用机器人编程语法规范.md` 存在。
3. `working1` 当前文档只以这两份文档作为对标来源。
4. KDL P0 29 个函数已进入任务和验收证据。
5. GRL P0 14 类能力已进入任务和验收证据。
问题和风险：
1. 当前仍是实施文档，不包含实际代码实现。
2. KDL 性能指标需要真实 WASM 构建和浏览器环境验证。
3. GRL 后处理 golden file 需要补充 ABB、FANUC、KUKA 示例。
4. `trap/interrupt/task` 属于 GRL P1，若提前解析但不执行，必须返回明确诊断。
下一步：
1. 执行 `KW-001`：建立 KDL WASM wrapper 工程和 Worker RPC。
2. 并行执行 `KW-100`：建立 GRL lexer、单位规范化和关键字表。
3. 第一集成点为 `KW-103`：GRL `movej/movel/movec` 编译为 KDL request。
### 轮次 002
日期：2026-06-27
关联任务：`KW-001`、`KW-100`
本轮目标：按 `working1` 下一步连续推进，建立 KDL WASM wrapper/Worker RPC 工程骨架，并实现 GRL lexer、单位规范化和关键字表。
做了什么：
1. 新建 `/home/meswork/kdl_work/kdl-wasm` 工程骨架。
2. 增加 CMake/Emscripten WASM wrapper，导出 `kdl.js`、`kdl.wasm`、`kdl.d.ts`。
3. 增加 C ABI 占位边界：`kdl_init`、`kdl_create_robot`、`kdl_destroy_robot`、`kdl_get_robot_info`、`kdl_fk`、`kdl_ik`、`kdl_plan_movej`、`kdl_last_error` 等。
4. 增加 TypeScript KDL 类型、`KdlRpcRequest/KdlRpcResponse`、结构化错误、Worker dispatch、`kdl.worker.ts` 和 `KdlWorkerClient`。
5. Worker runtime 支持注入 native module loader；默认通过 ES module 动态加载 WASM wrapper，`init` 调用底层 `kdl_init`。
6. 增加 GRL lexer：注释、关键字、标识符、字符串、数字、source range、EOF token。
7. 增加 GRL 单位规范化：长度、角度、时间、质量、线速度、角速度、线加速度、角加速度、百分比。
8. 增加 Vitest 单元测试和 TypeScript 严格类型检查入口。
改了哪些文件：
1. `/home/meswork/kdl_work/package.json`
2. `/home/meswork/kdl_work/package-lock.json`
3. `/home/meswork/kdl_work/.gitignore`
4. `/home/meswork/kdl_work/kdl-wasm/CMakeLists.txt`
5. `/home/meswork/kdl_work/kdl-wasm/bindings/kdl_c_api.cpp`
6. `/home/meswork/kdl_work/kdl-wasm/bindings/kdl.d.ts`
7. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/*`
8. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/lexer/*`
9. `/home/meswork/kdl_work/kdl-wasm/web/tests/kdl/rpc.test.ts`
10. `/home/meswork/kdl_work/kdl-wasm/web/tests/grl/lexer.test.ts`
11. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
12. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
13. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm test` 通过，2 个测试文件共 11 个测试通过。
3. `npm run test -- kdl rpc` 通过。
4. `npm run test -- grl lexer` 通过。
5. `emcmake cmake -S kdl-wasm -B kdl-wasm/build-wasm -DCMAKE_BUILD_TYPE=Release -DKDL_SOURCE_DIR=/home/meswork/kdl_work/orocos_kinematics_dynamics/orocos_kdl` 通过。
6. `cmake --build kdl-wasm/build-wasm -j16` 通过。
7. `kdl-wasm/build-wasm/kdl.js`、`kdl-wasm/build-wasm/kdl.wasm`、`kdl-wasm/build-wasm/kdl.d.ts` 存在。
8. Node 动态加载 `kdl.js` 并调用 `kdl_init` 返回 `0`。
问题和风险：
1. `KW-001` 已完成工程骨架和 Worker RPC，但 C ABI 中机器人建模、FK/IK、轨迹规划仍是后续任务占位。
2. `KW-100` 已完成 lexer 和单位表，但 parser、AST、语义检查尚未开始。
3. 当前未启动浏览器 Worker 真实环境测试，Worker 加载通过注入 loader 和 Node 动态 import 验证；浏览器/Playwright 可在 UI 或集成环境出现后补充。
下一步：
1. 执行 `KW-002`：URDF XML 解析、`NormalizedRobotModel`、RobotHandle 生命周期和基础模型诊断。
2. 执行 `KW-101`：GRL parser 和 AST 骨架，覆盖最小文件、source range 和错误行列号。
### 轮次 003
日期：2026-06-27
关联任务：`KW-002`、`KW-101`
本轮目标：继续按台账推进，完成 URDF 到标准模型和 GRL parser/AST 骨架。
做了什么：
1. 增加 URDF XML 解析，读取 robot/link/joint/parent/child/origin/axis/limit。
2. 增加 `NormalizedRobotModel` 生成，包含 `robotId/name/baseLink/tipLink/links/joints/activeJointNames/limits/source.urdfHash`。
3. 增加 base/tip 连通性检查、unsupported joint type、jointOrder 和 limit override 处理。
4. 增加 TypeScript `RobotModelRegistry`，支持 RobotHandle create/getInfo/getJointLimits/destroy 生命周期。
5. 扩展 Worker runtime 和 `KdlWorkerClient`，支持 `loadRobotFromUrdf/createRobotFromModel/destroyRobot/getRobotInfo/getJointLimits`。
6. 增加 GRL AST 类型和 parser 骨架，覆盖 `language grl 0.1`、`module`、`import`、`proc`，并保留顶层 raw declaration。
7. 增加 parser 错误行列号和 source range 测试。
改了哪些文件：
1. `/home/meswork/kdl_work/package.json`
2. `/home/meswork/kdl_work/package-lock.json`
3. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/types.ts`
4. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/runtime.ts`
5. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/kdlClient.ts`
6. `/home/meswork/kdl_work/kdl-wasm/web/src/robot/*`
7. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ast/*`
8. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/parser/*`
9. `/home/meswork/kdl_work/kdl-wasm/web/tests/kdl/urdf.test.ts`
10. `/home/meswork/kdl_work/kdl-wasm/web/tests/grl/parser.test.ts`
11. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
12. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
13. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm test` 通过，4 个测试文件共 19 个测试通过。
3. `npm run test -- kdl urdf normalized-model` 通过。
4. `npm run test -- grl parser ast` 通过。
问题和风险：
1. RobotHandle 目前绑定 TypeScript 标准模型 registry，尚未创建真实 Orocos KDL `Tree/Chain` 求解器。
2. Parser 对数据声明、target、path、operation、语句体仍保留 raw token，细化工作进入 `KW-102` 到 `KW-109`。
下一步：
1. 执行 `KW-003`：基于标准模型实现 FK 和 fkAllLinks 的初版数值计算、维度诊断和 link 顺序测试。
2. 执行 `KW-102`：细化数据声明、类型系统、target/tool/frame/speed/zone 和 offset AST。
### 轮次 004
日期：2026-06-27
关联任务：`KW-003`、`KW-102`
本轮目标：继续推进 FK/fkAllLinks 计算接口，并把 GRL 数据声明、target、speed、zone、offset 编译为共享类型。
做了什么：
1. 增加基础位姿数学工具：矩阵相乘、RPY、轴角、四元数、pose compose。
2. 基于 `NormalizedRobotModel` 实现 TypeScript FK 基线，支持 revolute、continuous、prismatic、fixed joint。
3. 实现 `fk`，返回 flange、tcp、joints、diagnostics，并支持 tool/frame 选项。
4. 实现 `fkAllLinks`，返回 base-to-tip link pose 列表。
5. 增加 FK 维度和非法关节值结构化诊断。
6. 扩展 Worker runtime 和 `KdlWorkerClient`，暴露 `fk/fkAllLinks`。
7. 扩展 GRL AST 和 parser，结构化输出 `DataDeclaration`、`TargetDeclaration`、表达式 AST、object/call/array/offset。
8. 增加 GRL 数据编译函数，支持 `tool/frame/joint_target/pose_target/speed/zone/offset` 到共享数据结构。
9. 增加负数单位值解析，覆盖 `offset y -10 mm` 等场景。
改了哪些文件：
1. `/home/meswork/kdl_work/kdl-wasm/web/src/math/poseMath.ts`
2. `/home/meswork/kdl_work/kdl-wasm/web/src/robot/normalizedRobotModel.ts`
3. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/types.ts`
4. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/runtime.ts`
5. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/kdlClient.ts`
6. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ast/*`
7. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/parser/*`
8. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/*`
9. `/home/meswork/kdl_work/kdl-wasm/web/tests/kdl/fk.test.ts`
10. `/home/meswork/kdl_work/kdl-wasm/web/tests/grl/dataDeclarations.test.ts`
11. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
12. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
13. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm test` 通过，6 个测试文件共 28 个测试通过。
3. `npm run test -- kdl fk` 通过。
4. `npm run test -- grl types declarations targets` 通过。
5. `cmake --build kdl-wasm/build-wasm -j16` 通过。
问题和风险：
1. 当前 FK 是 TypeScript 标准模型基线，尚未与真实 Orocos KDL WASM solver 做数值 golden 对比。
2. GRL 数据编译已覆盖 P0 数据结构，但尚未做全局符号表、类型引用检查和重复定义诊断；这些进入 `KW-110`。
下一步：
1. 执行 `KW-004`：IK 和 ikBatch 的基础接口、失败原因和回代测试。
2. 执行 `KW-103`：解析 `movej/movel/movec`、当前 tool/frame/speed/zone，并编译为 KDL request。
### 轮次 005
日期：2026-06-27
关联任务：`KW-004`、`KW-103`
本轮目标：继续推进 IK/ikBatch 基础接口，并完成 GRL 运动语句到 KDL request 的第一个集成点。
做了什么：
1. 正式化 `IkOptions/IkResult`、`MoveJRequest/MoveLRequest/MoveCRequest` 类型。
2. 在 TypeScript 标准模型 registry 中实现 `ik` 和 `ikBatch`。
3. IK 当前支持 single-prismatic 和 Rz+Px 链，返回可达、关节限位、unsupported model 等结构化结果。
4. `ikBatch` 保持输入顺序，并在前一点成功时复用上一点结果作为后续 seed。
5. Worker runtime 和 `KdlWorkerClient` 暴露 `ik/ikBatch`。
6. 增加 GRL Motion IR：`MotionInstruction`、`MotionKind` 和 request 编译类型。
7. 增加 `buildMotionContext`，从 data/target 声明建立 targets、speeds、zones、tools、frames。
8. 增加 `parseProcedureMotionInstructions`，从 `proc` body token 解析 `set_tool/set_frame/set_speed/set_zone/movej/movel/movec`。
9. 增加 `compileMotionToKdlRequest`，生成 `MoveJRequest/MoveLRequest/MoveCRequest`。
改了哪些文件：
1. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/types.ts`
2. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/runtime.ts`
3. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/kdlClient.ts`
4. `/home/meswork/kdl_work/kdl-wasm/web/src/robot/normalizedRobotModel.ts`
5. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ir/*`
6. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/compileMotion.ts`
7. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/index.ts`
8. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/parser/parser.ts`
9. `/home/meswork/kdl_work/kdl-wasm/web/tests/kdl/ik.test.ts`
10. `/home/meswork/kdl_work/kdl-wasm/web/tests/grl/motionCompile.test.ts`
11. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
12. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
13. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm test` 通过，8 个测试文件共 34 个测试通过。
3. `npm run test -- kdl ik` 通过。
4. `npm run test -- grl motion` 通过。
5. `cmake --build kdl-wasm/build-wasm -j16` 通过。
问题和风险：
1. IK 当前是受限 TypeScript 几何基线，不是完整 Orocos KDL 迭代 IK。
2. `KW-103` 已完成直写 `proc` 内 motion 指令编译，但 path/operation 内 point/event 展开仍属于后续 `KW-104/KW-105`。
3. 独立 `integration grl-kdl-motion` 测试文件尚未建立，当前由 `grl motion` 和全量测试覆盖同一集成链路。
下一步：
1. 执行 `KW-005`：Jacobian、奇异性和基础检查 API。
2. 执行 `KW-104`：Path、event 和 `run_path` 编译为 PathPlanRequest。
### 轮次 006
日期：2026-06-27
关联任务：`KW-005`
本轮目标：实现 Jacobian、奇异性、关节限位、速度限位和可达性批量检查 API。
做了什么：
1. 正式化 `JacobianResult`、`LimitCheckResult`、`SingularityResult`、`ReachabilityResult` 类型。
2. 基于 FK 数值差分实现 `jacobian`，返回 6 x dof 矩阵。
3. 实现 `checkSingularity`，输出 manipulability、conditionNumber 和 `KDL_SINGULARITY` warning。
4. 实现 `checkJointLimits`，对超限关节输出 `KDL_JOINT_LIMIT`。
5. 实现 `checkVelocityLimits`，对轨迹点速度/加速度输出 `KDL_VELOCITY_LIMIT`、`KDL_ACCEL_LIMIT` 和最大比例。
6. 实现 `checkReachability/checkReachabilityBatch`，复用 IK 基线并保持批量顺序。
7. Worker runtime 和 `KdlWorkerClient` 暴露 KW-005 API。
改了哪些文件：
1. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/types.ts`
2. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/runtime.ts`
3. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/kdlClient.ts`
4. `/home/meswork/kdl_work/kdl-wasm/web/src/robot/normalizedRobotModel.ts`
5. `/home/meswork/kdl_work/kdl-wasm/web/tests/kdl/checks.test.ts`
6. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
7. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
8. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm run test -- kdl jacobian checks` 通过。
3. `npm test` 通过，9 个测试文件共 38 个测试通过。
4. `cmake --build kdl-wasm/build-wasm -j16` 通过。
问题和风险：
1. Jacobian 当前为 TypeScript 数值差分基线，后续真实 Orocos KDL solver 接入后应增加 golden 对比。
2. 奇异性指标当前使用线速度 Jacobian 的 Gram 行列式和列范数估算，适合作为 P0 诊断基线，不等价于完整工业控制器判据。
3. `KW-104` 依赖 `KW-011 planPath/validatePath`，本轮未推进，避免把 Path 集成误标完成。
下一步：
1. 执行 `KW-006`：位姿变换和 offset API。
2. 执行 `KW-007`：梯形速度曲线，为后续 `planMoveJ/planMoveL/planMoveC` 做准备。
### 轮次 007
日期：2026-06-27
关联任务：`KW-006`
本轮目标：实现位姿规范化、组合、逆变换、tool/frame 应用和 offset API。
做了什么：
1. 在数学模块补充 `inversePose` 刚体逆变换。
2. 增加 `kdl/poseApi.ts`，集中实现 `normalizePose/composePose/inversePose/applyToolAndFrame/applyOffset`。
3. `normalizePose` 支持 `position/quaternion`、`xyz/rpy`、`xyz/quat` 三种输入，并统一规范化四元数。
4. `applyToolAndFrame` 保持与当前 FK 一致的 `frame * target.pose * tool` 约定。
5. `applyOffset` 支持 `frame/world` 左乘偏移和 `tool` 右乘偏移，并保留 `PoseTarget` 元数据。
6. Worker runtime 和 `KdlWorkerClient` 暴露 KW-006 API。
7. 非法位姿输入返回 `KDL_INVALID_POSE` 结构化诊断。
改了哪些文件：
1. `/home/meswork/kdl_work/kdl-wasm/web/src/math/poseMath.ts`
2. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/poseApi.ts`
3. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/runtime.ts`
4. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/kdlClient.ts`
5. `/home/meswork/kdl_work/kdl-wasm/web/tests/kdl/poseApi.test.ts`
6. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
7. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
8. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm run test -- kdl pose offset` 通过，10 个测试文件共 43 个测试通过。
3. `npm test` 通过，10 个测试文件共 43 个测试通过。
4. `cmake --build kdl-wasm/build-wasm -j16` 通过。
问题和风险：
1. `frameId` 当前作为 `OffsetSpec` 元数据保留，尚未接入全局 frame registry；命名 frame 解析会在 `KW-110` 语义检查和后续路径集成中继续完善。
2. 位姿变换当前为 TypeScript 基线实现，后续 C ABI / WASM 真实封装可复用这些测试作为行为约束。
下一步：
1. 执行 `KW-007`：梯形速度曲线。
2. 之后按依赖推进 `KW-008 planMoveJ`。
### 轮次 008
日期：2026-06-27
关联任务：`KW-007`
本轮目标：实现梯形速度曲线 profile 和采样 API，为后续运动规划提供路径参数。
做了什么：
1. 将 `TrapProfileOptions/TrapSample/TrapProfileResult` 从 `JsonObject` 占位改为明确类型。
2. 增加 `kdl/trapProfile.ts`，实现 `makeTrapProfile` 和 `sampleTrapProfile`。
3. 长距离场景生成 trapezoid，短距离场景自动退化为 triangle。
4. 采样点输出 `index/time/s/sd/sdd`，其中 `s` 为 `[0,1]` 归一化路径参数。
5. 首末采样点严格固定为 `s=0` 和 `s=1`，中间采样按 `sampleTime` 单调生成。
6. 非法输入返回 `KDL_INVALID_TRAP_PROFILE` 结构化诊断。
7. Worker runtime 和 `KdlWorkerClient` 暴露 `makeTrapProfile/sampleTrapProfile`。
改了哪些文件：
1. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/types.ts`
2. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/trapProfile.ts`
3. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/runtime.ts`
4. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/kdlClient.ts`
5. `/home/meswork/kdl_work/kdl-wasm/web/tests/kdl/trapProfile.test.ts`
6. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
7. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
8. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm run test -- kdl trap-profile` 通过，11 个测试文件共 47 个测试通过。
3. `npm test` 通过，11 个测试文件共 47 个测试通过。
4. `cmake --build kdl-wasm/build-wasm -j16` 通过。
问题和风险：
1. 当前速度曲线是 TypeScript 基线实现，后续真实 KDL `VelocityProfile_Trap` 接入后应使用这些测试做行为对齐。
2. `startVelocity/endVelocity` 已做输入校验，但后续连续 path blend 对非零边界速度的策略还需要在 `KW-011` 中统一。
下一步：
1. 执行 `KW-008`：`planMoveJ`。
2. 继续把梯形速度曲线接入 MOVEJ 轨迹采样、限位和诊断。
### 轮次 009
日期：2026-06-27
关联任务：`KW-008`
本轮目标：实现 `planMoveJ`，把目标关节、梯形速度曲线、FK 和诊断串成可回放轨迹。
做了什么：
1. 将 `TrajectoryPoint/TrajectoryEvent/TrajectoryResult` 从 `JsonObject` 占位改为明确类型。
2. 在 `RobotModelRegistry` 中实现 `planMoveJ`。
3. `joint_target` 直接生成终点关节，`pose_target` 复用当前 IK 基线求终点关节。
4. 使用 `KW-007` 梯形速度曲线生成归一化 `s/sd/sdd`，并映射到每个关节的位置、速度、加速度。
5. 每个轨迹点执行 FK，输出 `flange/tcp`，用于仿真回放。
6. 覆盖起终点关节限位、采样点速度/加速度、奇异性和 P0 zone 近似诊断。
7. Worker runtime 和 `KdlWorkerClient` 暴露 `planMoveJ`。
改了哪些文件：
1. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/types.ts`
2. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/runtime.ts`
3. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/kdlClient.ts`
4. `/home/meswork/kdl_work/kdl-wasm/web/src/robot/normalizedRobotModel.ts`
5. `/home/meswork/kdl_work/kdl-wasm/web/tests/kdl/planMoveJ.test.ts`
6. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
7. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
8. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm run test -- kdl movej planMoveJ` 通过，12 个测试文件共 51 个测试通过。
3. `npm test` 通过，12 个测试文件共 51 个测试通过。
4. `cmake --build kdl-wasm/build-wasm -j16` 通过。
问题和风险：
1. `pose_target` 的 IK 仍使用当前 TypeScript 几何基线，真实 6 轴工业机器人求解要等 Orocos KDL solver 深度接入。
2. `zone` 在 P0 仍近似为 fine，连续 blend 会在 `KW-011` 统一处理。
3. 当前 MOVEJ 使用归一化同步参数实现，同起同停可用；品牌控制器级 look-ahead 和更复杂速度策略属于后续阶段。
下一步：
1. 执行 `KW-009`：`planMoveL`。
2. 复用 `TrajectoryResult`、梯形速度曲线和 IK seed 连续策略生成 TCP 直线轨迹。
### 轮次 010
日期：2026-06-27
关联任务：`KW-009`
本轮目标：实现 `planMoveL`，按 TCP 直线采样、逐点 IK，并输出可回放轨迹。
做了什么：
1. 在 `RobotModelRegistry` 中实现 `planMoveL`。
2. 使用起点 FK 得到 TCP 起点，按目标 pose 生成 TCP 直线采样 pose。
3. 使用 `KW-007` 梯形速度曲线按直线长度生成 `s/sd/sdd`。
4. 对每个采样点逐点 IK，seed 使用上一采样点关节解。
5. 每个轨迹点输出 `joints/jointVelocity/jointAcceleration/flange/tcp`。
6. 覆盖 TCP 直线误差、采样点 IK 失败、速度/加速度、奇异性和 P0 zone 近似诊断。
7. Worker runtime 和 `KdlWorkerClient` 暴露 `planMoveL`。
改了哪些文件：
1. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/runtime.ts`
2. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/kdlClient.ts`
3. `/home/meswork/kdl_work/kdl-wasm/web/src/robot/normalizedRobotModel.ts`
4. `/home/meswork/kdl_work/kdl-wasm/web/tests/kdl/planMoveL.test.ts`
5. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
6. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
7. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm run test -- kdl movel planMoveL` 通过，13 个测试文件共 54 个测试通过。
3. `npm test` 通过，13 个测试文件共 54 个测试通过。
4. `cmake --build kdl-wasm/build-wasm -j16` 通过。
问题和风险：
1. 姿态插值当前为 P0 固定目标四元数近似，完整 slerp 和 `tool_z_lock` 会在后续真实 KDL/轨迹阶段继续完善。
2. 当前 IK 基线仍只覆盖 single-prismatic 与 Rz+Px 链，通用 6 轴 MOVEL 依赖后续 Orocos KDL solver 深度接入。
3. `zone` 仍近似为 fine，连续 blend 进入 `KW-011`。
下一步：
1. 执行 `KW-010`：`planMoveC`。
2. 复用轨迹点结构、梯形速度曲线和逐点 IK seed 策略，补圆弧几何和退化诊断。
### 轮次 011
日期：2026-06-27
关联任务：`KW-010`
本轮目标：实现 `planMoveC`，完成三点圆弧几何、圆弧采样、逐点 IK 和退化诊断。
做了什么：
1. 在 `RobotModelRegistry` 中实现 `planMoveC`。
2. 基于起点 TCP、via、target 三点计算圆心、半径、法向、角度、弧长和方向。
3. 使用 `KW-007` 梯形速度曲线按圆弧长度生成 `s/sd/sdd`。
4. 对每个圆弧采样点逐点 IK，seed 使用上一采样点关节解。
5. 每个轨迹点输出 `joints/jointVelocity/jointAcceleration/flange/tcp`。
6. `TrajectoryResult.meta.circle` 输出 `center/radius/normal/angle/length/direction/maxArcError`。
7. 三点重合或共线返回 `KDL_ARC_DEGENERATE`。
8. Worker runtime 和 `KdlWorkerClient` 暴露 `planMoveC`。
改了哪些文件：
1. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/runtime.ts`
2. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/kdlClient.ts`
3. `/home/meswork/kdl_work/kdl-wasm/web/src/robot/normalizedRobotModel.ts`
4. `/home/meswork/kdl_work/kdl-wasm/web/tests/kdl/planMoveC.test.ts`
5. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
6. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
7. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm run test -- kdl movec planMoveC` 通过，14 个测试文件共 57 个测试通过。
3. `npm test` 通过，14 个测试文件共 57 个测试通过。
4. `cmake --build kdl-wasm/build-wasm -j16` 通过。
问题和风险：
1. MOVEC 当前为 P0 三点圆弧基线，尚未覆盖 `arcMode=center/radius` 和 `circleDirection=long/cw/ccw` 的完整品牌语义。
2. 姿态插值当前为 P0 固定目标四元数近似，完整 slerp 会在后续阶段继续完善。
3. 当前 IK 基线仍限制通用 6 轴 MOVEC 覆盖范围，真实 Orocos KDL solver 接入后需补更多 golden 测试。
下一步：
1. 执行 `KW-011`：`planPath` 和 `validatePath`。
2. 将 MOVEJ/MOVEL/MOVEC 段轨迹合并，并保留 segmentId、targetId、sourceMap 与诊断报告。
### 轮次 012
日期：2026-06-27
关联任务：`KW-011`
本轮目标：实现 `planPath` 和 `validatePath`，把 MOVEJ/MOVEL/MOVEC 段轨迹合并成整条路径，并输出段级验证报告。
做了什么：
1. 将 `MotionSegmentRequest/PathPlanRequest/PathPlanResult/SegmentValidationReport/PathValidationResult` 从占位类型改为明确结构。
2. 在 `RobotModelRegistry` 中实现 `planPath`。
3. `planPath` 按段调用 `planMoveJ/planMoveL/planMoveC`，并用上一段终点关节作为下一段起点。
4. 合并轨迹点时重新编号、累加时间，并保留 `segmentId/targetId/sourceMap`。
5. 空路径返回 `KDL_PATH_EMPTY` 结构化诊断。
6. 实现 `validatePath`，输出 `segmentReports`、`cycleTime`、速度/加速度比例、笛卡尔误差和诊断。
7. Worker runtime 和 `KdlWorkerClient` 暴露 `planPath/validatePath`。
改了哪些文件：
1. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/types.ts`
2. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/runtime.ts`
3. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/kdlClient.ts`
4. `/home/meswork/kdl_work/kdl-wasm/web/src/robot/normalizedRobotModel.ts`
5. `/home/meswork/kdl_work/kdl-wasm/web/tests/kdl/path.test.ts`
6. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
7. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
8. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm run test -- kdl path validation` 通过，15 个测试文件共 60 个测试通过。
3. `npm test` 通过，15 个测试文件共 60 个测试通过。
4. `cmake --build kdl-wasm/build-wasm -j16` 通过。
问题和风险：
1. `planPath` 当前按 P0 语义串行拼接各段，尚未实现连续 blend/look-ahead。
2. `validatePath` 的笛卡尔误差从已有段诊断和 `meta.circle.maxArcError` 汇总，后续可扩展更细的路径误差统计。
3. Path 中 event 和 `run_path` 的 GRL 语法编译仍属于 `KW-104`。
下一步：
1. 执行 `KW-012`：节拍估算、重采样和诊断报告。
2. 继续补 `estimateCycleTime/resampleTrajectory`，为路径报告和回放采样做准备。
### 轮次 013
日期：2026-06-27
关联任务：`KW-012`
本轮目标：实现节拍估算、轨迹重采样和诊断分级，为路径报告和回放采样提供基础 API。
做了什么：
1. 新增 `CycleTimeResult/CycleTimeSegment` 明确类型。
2. 实现 `estimateCycleTime`，支持单段 `TrajectoryResult` 和多段 `PathPlanResult`。
3. 实现 `resampleTrajectory`，按固定 `sampleTime` 重采样轨迹点并保持首末点稳定。
4. 重采样对关节、关节速度、关节加速度、flange 和 tcp 位置做线性插值。
5. 空轨迹返回 `KDL_RESAMPLE_EMPTY_TRAJECTORY` warning。
6. 非法采样时间抛出 `KDL_INVALID_SAMPLE_TIME` 结构化错误。
7. 成功重采样追加 `KDL_TRAJECTORY_RESAMPLED` info 诊断。
8. Worker runtime 和 `KdlWorkerClient` 暴露 `estimateCycleTime/resampleTrajectory`。
9. 将 path 段内 points 的 `segmentId/sourceMap` 与合并 points 保持一致，便于节拍和诊断定位。
改了哪些文件：
1. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/types.ts`
2. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/trajectoryUtils.ts`
3. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/runtime.ts`
4. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/kdlClient.ts`
5. `/home/meswork/kdl_work/kdl-wasm/web/src/robot/normalizedRobotModel.ts`
6. `/home/meswork/kdl_work/kdl-wasm/web/tests/kdl/trajectoryUtils.test.ts`
7. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
8. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
9. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm run test -- kdl cycle-time resample diagnostics` 通过，16 个测试文件共 63 个测试通过。
3. `npm test` 通过，16 个测试文件共 63 个测试通过。
4. `cmake --build kdl-wasm/build-wasm -j16` 通过。
问题和风险：
1. 节拍估算当前只统计 KDL 运动时间，`waitTime/ioTime` 保留为 0，完整 IO/等待节拍需等 GRL `KW-106` 接入。
2. 姿态重采样当前采用端点四元数选择的 P0 近似，完整 slerp 可在轨迹精度增强阶段补充。
3. 重采样暂未输出 TCP 速度/加速度，后续若 UI 或后处理需要可从采样点差分扩展。
下一步：
1. 执行 `KW-013`：C ABI / Embind 和性能优化。
2. 梳理当前 C ABI 导出、JS 包装接口和 TypedArray/批量性能基线，补最小可验收测试。
### 轮次 014
日期：2026-06-27
关联任务：`KW-013`
本轮目标：稳定 C ABI 导出和错误边界，补 TypedArray 高频 FK 接口，并记录性能基线。
做了什么：
1. C++ C ABI 增加 RobotHandle 生命周期缓存：`kdl_create_robot/kdl_destroy_robot/kdl_get_robot_info`。
2. `kdl_get_robot_info` 返回 JSON handle 信息，输出缓冲区不足时返回 `KDL_BUFFER_TOO_SMALL`。
3. 保持计算类 C ABI 函数为显式 `KDL_NOT_IMPLEMENTED`，避免伪造尚未接入的 C++ solver 能力。
4. 新增 `KdlNativeAbi`，封装 C ABI 导出检查、JSON 缓冲区读取、返回码检查和 `kdl_last_error` 结构化错误。
5. 扩展 Emscripten native module 类型，覆盖 `cwrap/UTF8ToString/_malloc/_free`。
6. 新增 `fkPose7`，通过 `Float64Array` 输入和可复用输出缓冲返回 TCP pose7。
7. Worker runtime 和 `KdlWorkerClient` 暴露 `fkPose7`。
8. 新增性能基线工具，记录 6 轴初始化、TypedArray FK、平面 IK、1000 点批量可达性、10 秒 4 ms 轨迹采样。
9. 新增 C ABI、性能和 `fkPose7` 测试。
改了哪些文件：
1. `/home/meswork/kdl_work/kdl-wasm/bindings/kdl_c_api.cpp`
2. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/nativeModule.ts`
3. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/nativeAbi.ts`
4. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/performanceBaseline.ts`
5. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/types.ts`
6. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/runtime.ts`
7. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/kdlClient.ts`
8. `/home/meswork/kdl_work/kdl-wasm/web/src/robot/normalizedRobotModel.ts`
9. `/home/meswork/kdl_work/kdl-wasm/web/tests/kdl/cAbi.test.ts`
10. `/home/meswork/kdl_work/kdl-wasm/web/tests/kdl/performance.test.ts`
11. `/home/meswork/kdl_work/kdl-wasm/web/tests/kdl/fk.test.ts`
12. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
13. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
14. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `cmake --build kdl-wasm/build-wasm -j16` 通过。
3. `npm run test -- kdl c-abi performance` 通过，18 个测试文件共 68 个测试通过。
4. `npm test` 通过，18 个测试文件共 70 个测试通过。
5. 性能基线：6 轴初始化 3.536 ms；TypedArray FK 平均 0.019288 ms；平面 IK 平均 0.010930 ms；1000 点可达性 7.166 ms；10 秒 4 ms 轨迹 2526 点、48.864 ms。
问题和风险：
1. C++ C ABI 当前稳定到导出、handle 生命周期和结构化错误边界，真实 FK/IK/Jacobian/轨迹求解仍由 TypeScript runtime 基线承载。
2. 性能基线中的 IK 是当前支持的平面 Rz+Px 模型，不代表通用 6 轴 IK 性能。
3. `fkPose7` 为 P0 高频 FK 输出，后续可继续补 `jacobian`/批量 FK 的 TypedArray 接口。
下一步：
1. 进入 `KW-104`：GRL Path、event 和 `run_path`。
2. 将 GRL path 语法编译到 `PathPlanRequest`，并保留 path point/source map/event 信息。
### 轮次 015
日期：2026-06-27
关联任务：`KW-104`
本轮目标：实现 GRL Path、event 和 `run_path`，将 path 编译为 KDL `PathPlanRequest`。
做了什么：
1. 将 `path` 从 raw top-level declaration 提升为结构化 `PathDeclaration` AST。
2. 新增 `PathDefaultsBlock/PathSourceBlock/PathPoint/PathEvent` AST 类型。
3. Parser 支持 `defaults/source/point/event before/after/at distance`。
4. `PathPlanRequest` 扩展 `pathId/events/source`，`MotionSegmentRequest` 扩展 `targetId/source`。
5. 新增 `compilePathToPlanRequest`，把 path point 编译为 `MotionSegmentRequest`。
6. Path defaults 支持 `tool/frame/speed/zone`，优先级高于当前上下文。
7. Source metadata 编译为 `PathPlanRequest.source`，并保留到每个 segment。
8. Event 编译为 `PathEventRequest` metadata，保留 timing、pointId、distance、kind、statement、sourceMap。
9. 新增 `parseProcedureRunPathStatements`，从 proc body token 提取 `run_path` 引用并保留 sourceMap。
10. Motion target 支持 `OffsetExpression`，`movel pick offset z 100 mm` 可编译为 offset 后的 PoseTarget。
11. 空 path、重复 point、event 引用缺失 point 均返回结构化错误。
改了哪些文件：
1. `/home/meswork/kdl_work/kdl-wasm/web/src/kdl/types.ts`
2. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ast/ast.ts`
3. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ast/index.ts`
4. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/parser/parser.ts`
5. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ir/motion.ts`
6. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ir/index.ts`
7. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/compileData.ts`
8. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/compileMotion.ts`
9. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/index.ts`
10. `/home/meswork/kdl_work/kdl-wasm/web/tests/grl/pathCompile.test.ts`
11. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
12. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
13. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm run test -- grl path run_path event` 通过，6 个测试文件共 22 个测试通过。
3. `npm test` 通过，19 个测试文件共 75 个测试通过。
4. `cmake --build kdl-wasm/build-wasm -j16` 通过。
问题和风险：
1. Event 当前保留为 metadata，具体 IO/Wait/Pulse IR 展开属于 `KW-106`。
2. `run_path` 目前提取 path 引用和 sourceMap，完整执行流组合将在 `KW-105/KW-110` 继续增强。
3. Path 的连续 blend/look-ahead 仍由 KDL 路径规划后续阶段处理，当前 GRL 编译只负责结构展开。
下一步：
1. 执行 `KW-105`：Operation 和 `run_operation`。
2. 解析 operation/process/actions，并将 `run_operation` 展开为 action + path + action 的 IR 骨架。
### 轮次 016
日期：2026-06-27
关联任务：`KW-105`
本轮目标：实现 GRL Operation 和 `run_operation`，将 operation 展开为 start action、path、end action 的 IR 骨架。
做了什么：
1. 将 `operation` 从 raw top-level declaration 提升为结构化 `OperationDeclaration` AST。
2. 新增 `OperationProcessBlock/OperationActionBlock` AST 类型。
3. Parser 支持 `kind/path/process/start_action/end_action`。
4. 新增 Operation IR 类型：`CompiledOperation/OperationActionInstruction/RunOperationInstruction/OperationExecutionStep`。
5. 新增 `compileOperation`，验证 operation 引用的 path 存在。
6. Process 参数编译为 metadata，保留字符串、数值、identifier 和复合字面量。
7. start/end action 编译为 metadata，保留 actionKind、operationId、statement 和 sourceMap。
8. 新增 `parseProcedureRunOperationStatements`，从 proc body token 提取 `run_operation`。
9. 新增 `expandRunOperation`，展开为 start action、`RUN_PATH`、end action。
10. 缺失 path 返回 `GRL_OPERATION_PATH_NOT_FOUND`，缺失 operation 返回 `GRL_OPERATION_NOT_FOUND`。
改了哪些文件：
1. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ast/ast.ts`
2. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ast/index.ts`
3. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/parser/parser.ts`
4. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ir/motion.ts`
5. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ir/index.ts`
6. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/compileMotion.ts`
7. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/index.ts`
8. `/home/meswork/kdl_work/kdl-wasm/web/tests/grl/operationCompile.test.ts`
9. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
10. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
11. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm run test -- grl operation run_operation` 通过，6 个测试文件共 23 个测试通过。
3. `npm test` 通过，20 个测试文件共 79 个测试通过。
4. `cmake --build kdl-wasm/build-wasm -j16` 通过。
问题和风险：
1. Operation action 当前保留为 metadata，具体 IO/Wait/Pulse 语义将在 `KW-106` 展开。
2. `expandRunOperation` 输出 IR 骨架，完整可执行 IR 调度仍属于 `KW-110`。
3. KDL 边界仍只接收 Path 展开的 motion segment，operation action 不直接进入 KDL 运动规划。
下一步：
1. 执行 `KW-106`：IO、wait 和 pulse。
2. 解析 IO 地址、wait、pulse，并把 path/operation action metadata 展开为对应 IR。
### 轮次 017
日期：2026-06-27
关联任务：`KW-106`
本轮目标：实现 GRL IO、wait 和 pulse 语义，将 procedure body、Path event 和 Operation action 中的 IO 语句展开为独立 IR，并保持 KDL 边界清晰。
做了什么：
1. 新增 IO IR 类型：`IoReference/IoWriteInstruction/WaitInstruction/PulseInstruction/IoFlowInstruction`。
2. 新增 `parseIoFlowStatements`，从 GRL token 编译 IO 写入、wait 和 pulse。
3. 支持 `io.di/do/ai/ao/gi/go/ri/ro` 和 `io.alias.*`，并按 `IoMap.allowedRanges` 校验地址范围。
4. 地址越界返回结构化错误 `GRL_IO_ADDRESS_NOT_FOUND`。
5. `wait` 支持条件字符串、`timeout`、`on_timeout alarm` 和 `on_timeout call`。
6. wait 条件覆盖 `all/any/rising/falling/changed` 表达式，并修正连续语句边界，避免 wait 吞掉后续 `pulse/io`。
7. `pulse` 生成 set/reset trace，并将 `ms/s` 等单位归一化为秒。
8. Operation action IR 保留原始 token，Path event metadata 保留原始 token，避免 statement 字符串丢失单位类型。
9. 新增 `compilePathEventIo` 和 `compileOperationActionIo`，可将 Path event / Operation action metadata 展开为 IO/wait/pulse IR。
10. statement fallback 使用 GRL lexer 重新解析，保持 `true/false` 和单位字面量类型正确。
11. 新增 `ioCompile.test.ts` 覆盖 procedure IO 流、alias、地址校验、wait timeout/on_timeout、pulse trace、Path event 和 Operation action 展开。
改了哪些文件：
1. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ir/motion.ts`
2. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ir/index.ts`
3. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/compileIo.ts`
4. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/compileMotion.ts`
5. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/index.ts`
6. `/home/meswork/kdl_work/kdl-wasm/web/tests/grl/ioCompile.test.ts`
7. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
8. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
9. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm run test -- grl io wait pulse` 通过，7 个测试文件共 28 个测试通过。
3. `npm test` 通过，21 个测试文件共 84 个测试通过。
4. `cmake --build kdl-wasm/build-wasm -j16` 通过。
问题和风险：
1. `WaitInstruction.condition` 当前保留为字符串 IR，尚未建立布尔表达式 AST；更完整的静态类型检查归入 `KW-110`。
2. IO/wait/pulse 当前作为独立 GRL IR，不直接进入 KDL；完整执行调度和与 path/operation 的顺序组合仍属于 `KW-110`。
3. IO alias 只在可解析为 `IoReference` 的位置解析；wait 条件内部的 alias 仍以条件字符串保留。
下一步：
1. 执行 `KW-107`：流程控制。
2. 解析 `if/elseif/else`、`while`、`for`、`switch`、`break/continue`、`label/jump`，并补充结构化流程 IR 和非法跳转诊断。
### 轮次 018
日期：2026-06-27
关联任务：`KW-107`
本轮目标：实现 GRL 流程控制语义层，将 procedure body token 编译为结构化流程 IR，并覆盖关键合法性诊断。
做了什么：
1. 新增流程控制 IR 类型：`ControlExpression/RawProcedureStatement/IfInstruction/WhileInstruction/ForInstruction/SwitchInstruction/BreakInstruction/ContinueInstruction/LabelInstruction/JumpInstruction`。
2. 新增 `parseProcedureControlFlow` 和 `parseControlFlowStatements`。
3. 支持 `if/elseif/else`，每个分支保留条件文本、原始 token、sourceMap 和嵌套 body。
4. 支持 `while` 和 `for i = from to to step step`，并维护 loop depth。
5. 支持 `switch/case/default`，case 值编译为常量，重复 case/default 返回结构化错误。
6. `break` 限定在 loop 或 switch 内，`continue` 限定在 loop 内。
7. `label/jump` 支持重复 label、缺失 label 和跳入内层块诊断。
8. 控制条件做 P0 bool 检查，明显数值/字符串条件报 `GRL_CONTROL_CONDITION_NOT_BOOL`。
9. 未识别普通语句保留为 `RAW_STATEMENT`，便于后续 KW-110 将 motion/io/run 等 IR 统一组合。
10. 新增 `controlFlow.test.ts` 覆盖正常流程树、非法条件、break/continue、switch case、label/jump。
改了哪些文件：
1. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ir/motion.ts`
2. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ir/index.ts`
3. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/compileControlFlow.ts`
4. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/index.ts`
5. `/home/meswork/kdl_work/kdl-wasm/web/tests/grl/controlFlow.test.ts`
6. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
7. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
8. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm run test -- grl control-flow` 通过，8 个测试文件共 33 个测试通过。
3. `npm test` 通过，22 个测试文件共 89 个测试通过。
4. `cmake --build kdl-wasm/build-wasm -j16` 通过。
问题和风险：
1. 条件 bool 检查目前是 P0 语法/字面量级别；基于 symbol table 的完整类型判断属于 `KW-110`。
2. 普通语句暂存为 `RAW_STATEMENT`，完整可执行 IR 顺序组合属于 `KW-110`。
3. label/jump 当前按块作用域防止跳入内层或兄弟块，未做更复杂的异常/多任务边界检查。
下一步：
1. 执行 `KW-108`：proc、func、参数方向和作用域。
2. 建立过程/函数签名、call/return 语义、参数方向检查和函数副作用限制。
### 轮次 019
日期：2026-06-27
关联任务：`KW-108`
本轮目标：实现 GRL proc/func/call/return 语义检查，覆盖参数方向、返回路径、作用域和函数副作用限制。
做了什么：
1. 将 `func` 从 `RawTopLevelDeclaration` 提升为结构化 `FunctionDeclaration` AST。
2. Parser 支持 `func return_type name(params) ... end`，保留参数 token 和 body token。
3. 新增 routine IR 类型：`ProcedureSignature/FunctionSignature/RoutineParameter/CallInstruction/ReturnInstruction/ProcFunctionAnalysis`。
4. 新增 `analyzeProcFunctionSemantics`，统一建立 proc/func 签名表。
5. 支持 `in/out/inout` 参数方向解析，默认参数方向为 `in`。
6. `call` 检查目标存在、参数数量、基础类型兼容和 out/inout 左值。
7. `out` 参数做所有正常返回路径赋值检查，并支持通过调用带 out/inout 参数的子过程完成赋值。
8. `return` 检查 proc 不能带返回值，func 必须返回且返回类型兼容。
9. func 默认禁止运动、`wait`、`pulse`、`run_path`、`run_operation` 和调用 procedure。
10. 自递归和名称遮蔽以 warning diagnostic 返回。
11. 新增 `procFunction.test.ts` 覆盖签名、call/return、out 赋值路径、左值检查、返回类型、函数副作用、递归 warning 和遮蔽 warning。
改了哪些文件：
1. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ast/ast.ts`
2. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ast/index.ts`
3. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/parser/parser.ts`
4. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ir/motion.ts`
5. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ir/index.ts`
6. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/compileProcFunction.ts`
7. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/index.ts`
8. `/home/meswork/kdl_work/kdl-wasm/web/tests/grl/procFunction.test.ts`
9. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
10. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
11. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm run test -- grl proc func scope` 通过，9 个测试文件共 39 个测试通过。
3. `npm test` 通过，23 个测试文件共 95 个测试通过。
4. `cmake --build kdl-wasm/build-wasm -j16` 通过。
问题和风险：
1. 参数和返回类型检查目前覆盖基础字面量、变量和简单函数调用，完整表达式类型推断仍归入 `KW-110`。
2. out 赋值路径采用保守控制流合并模型，异常路径和复杂 early-exit 仍待 `KW-109/KW-110` 联合完善。
3. 名称解析当前覆盖全局名、参数和本地声明，完整 symbol table 仍属于 `KW-110`。
下一步：
1. 执行 `KW-109`：异常、报警、中断和多任务语法。
2. P0 实现 alarm/raise/try/catch/finally 基础语义，P1 trap/interrupt/task 保留可解析结构和明确诊断。
### 轮次 020
日期：2026-06-27
关联任务：`KW-109`
本轮目标：实现 GRL alarm/raise/try/catch/finally 基础语义，并为 P1 trap/interrupt/task 提供可解析结构和明确未实现诊断。
做了什么：
1. 新增异常/报警 IR 类型：`AlarmInstruction/RaiseInstruction/TryInstruction/CatchInstruction/FinallyInstruction/UnsupportedRuntimeInstruction`。
2. 新增 `parseProcedureExceptionFlow` 和 `parseExceptionFlowStatements`。
3. 支持 procedure body 中的 `alarm`，保留 alarm id、message、severity 和 sourceMap。
4. 支持 `raise alarm_id`。
5. 支持 `try/catch/finally/end`，catch 可带 alarm id。
6. `try` 没有 catch/finally 时返回 `GRL_TRY_HANDLER_MISSING`。
7. `alarm` 或 `raise` 缺少 id 时返回结构化错误。
8. 修正 top-level raw parser，使 `task ... cycle ... end` 按 end-style block 收集，不再要求 `{}`。
9. `trap` 和 `task` 保留为完整 `RawTopLevelDeclaration` token block。
10. 新增 `analyzeExceptionSemantics`，对 P1 trap/task 输出 `UNSUPPORTED_RUNTIME` 和 `GRL_P1_UNIMPLEMENTED` warning。
11. procedure body 内 `enable/disable interrupt` 输出 `UNSUPPORTED_RUNTIME`，明确 P0 不执行。
12. 新增 `exceptionCompile.test.ts` 覆盖 alarm/raise、try/catch/finally、trap/task raw 语法和 P1 未实现诊断。
改了哪些文件：
1. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/parser/parser.ts`
2. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ir/motion.ts`
3. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ir/index.ts`
4. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/compileException.ts`
5. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/index.ts`
6. `/home/meswork/kdl_work/kdl-wasm/web/tests/grl/exceptionCompile.test.ts`
7. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
8. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
9. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm run test -- grl alarm interrupt task` 通过，10 个测试文件共 43 个测试通过。
3. `npm test` 通过，24 个测试文件共 99 个测试通过。
4. `cmake --build kdl-wasm/build-wasm -j16` 通过。
问题和风险：
1. P1 trap/interrupt/task 当前只解析和诊断，不执行调度。
2. 异常传播、finally 在复杂控制流中的执行顺序仍留给 `KW-110` 的统一 executable IR。
3. alarm/raise 目前只编译为 IR，不接入运行时报警系统。
下一步：
1. 执行 `KW-110`：语义检查、IR 和 source map。
2. 统一 Motion/IO/Wait/Call/Branch/Alarm/Return 等 IR，补齐第 21 章语义检查和 source map 快照。
### 轮次 021
日期：2026-06-27
关联任务：`KW-110`
本轮目标：实现统一 Semantic Analyzer、Executable IR、source map 聚合和 GRL 到 KDL request 的编译桥接。
做了什么：
1. 新增统一语义 IR：`SemanticProgramIr/SemanticSymbol/SemanticSourceMapEntry/ExecutableProcedure/ExecutableInstruction`。
2. 新增 executable control IR：`EXEC_IF/EXEC_WHILE/EXEC_FOR/EXEC_SWITCH`。
3. 新增 `compileSemanticProgram`，组合前序数据、target、path、operation、IO、流程控制、proc/func、异常/报警分析结果。
4. 输出 `symbols` 符号表，覆盖 data、target、path、operation、procedure、function、raw P1 declaration。
5. 输出 22 项 `semanticChecks` 清单，对齐 GRL 第 21 章 P0 检查面。
6. 统一 procedure executable IR，覆盖 Motion、IO、Wait、Pulse、RunPath、RunOperation、Call、Return、Branch、Alarm、UnsupportedRuntime。
7. 通过 `kdlBridge.motionRequests` 将 executable motion 映射为 KDL request。
8. 通过 `kdlBridge.pathRequests` 保留 PathPlanRequest。
9. 聚合 source map，覆盖 procedure 行列、path point/event、operation action。
10. 重复符号输出 `GRL_SYMBOL_DUPLICATE` diagnostic。
11. 修正 motion 参数解析跨行边界，避免 motion 表达式吞掉下一行 IO/wait/control token。
12. 新增 `semanticIr.test.ts` 覆盖完整程序、统一 IR、KDL bridge、source map 和重复符号诊断。
改了哪些文件：
1. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ir/motion.ts`
2. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/ir/index.ts`
3. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/compileMotion.ts`
4. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/compileSemantic.ts`
5. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/semantic/index.ts`
6. `/home/meswork/kdl_work/kdl-wasm/web/tests/grl/semanticIr.test.ts`
7. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
8. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
9. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm run test -- grl semantic ir sourcemap` 通过，11 个测试文件共 46 个测试通过。
3. `npm test` 通过，25 个测试文件共 102 个测试通过。
4. `cmake --build kdl-wasm/build-wasm -j16` 通过。
问题和风险：
1. `semanticChecks` 当前是 P0 检查面清单，完整逐项 spec 编号映射可在规范文本稳定后继续细化。
2. Executable IR 已统一主要 P0 指令，但虚拟控制器实际调度仍在后续任务中接入。
3. KDL bridge 当前覆盖 motion/path request，IO、Alarm、Call、Branch 不直接调用 KDL，符合边界设计。
下一步：
1. 执行 `KW-111`：ABB、FANUC、KUKA 后处理原型。
2. 基于 `SemanticProgramIr` 输出三品牌后处理 golden file 和转换报告。
### 轮次 022
日期：2026-06-27
关联任务：`KW-111`
本轮目标：实现 ABB RAPID、FANUC LS/TP 风格、KUKA KRL 三品牌后处理原型，并输出转换报告。
做了什么：
1. 新增 `kdl-wasm/web/src/grl/post` 后处理模块。
2. 新增 `postProcessBrand` 和 `postProcessAllBrands`，以 `SemanticProgramIr` 为输入。
3. ABB RAPID 原型输出 `MODULE/PROC`、`MoveJ/MoveL/MoveC`、`SetDO`、`WaitUntil`、`PulseDO`。
4. FANUC LS/TP 风格原型输出 `/PROG`、`/MN`、`J/L/C`、`DO`、`WAIT`、`PULSE`。
5. KUKA KRL 原型输出 `DEF`、`PTP/LIN/CIRC`、`$OUT`、`WAIT FOR`、`PULSE`。
6. speed/zone 映射覆盖 joint percent、linear speed、fine、distance zone。
7. `post_hint abb` 对 ABB 生效，对 FANUC/KUKA 产生 `GRL_POST_HINT_IGNORED` report。
8. 不支持的 executable IR 产生 `GRL_POST_UNSUPPORTED` report。
9. 新增 `postProcessor.test.ts`，用 golden 字符串覆盖三品牌文本和转换报告。
改了哪些文件：
1. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/post/postProcessor.ts`
2. `/home/meswork/kdl_work/kdl-wasm/web/src/grl/post/index.ts`
3. `/home/meswork/kdl_work/kdl-wasm/web/tests/post/postProcessor.test.ts`
4. `/home/meswork/kdl_work/work/working1/03-推进台账.md`
5. `/home/meswork/kdl_work/work/working1/04-任务矩阵.md`
6. `/home/meswork/kdl_work/work/working1/05-验收证据.md`
验证了什么：
1. `npm run typecheck` 通过。
2. `npm run test -- post abb fanuc kuka` 通过，1 个测试文件共 2 个测试通过。
3. `npm test` 通过，26 个测试文件共 104 个测试通过。
4. `cmake --build kdl-wasm/build-wasm -j16` 通过。
问题和风险：
1. FANUC 输出为 LS/TP 风格文本原型，并非完整 TP 二进制。
2. 品牌扩展目前以 `post_hint` raw symbol 为主，`@brand.*` 装饰语法仍留作后续扩展。
3. 后处理当前覆盖 P0 运动、IO、wait、pulse；更复杂流程控制展开策略可在后续虚拟控制器阶段细化。
下一步：
1. 执行 `KW-112`：自动生成规则和往返。
2. 生成稳定 GRL 文本，确保可 diff、可解析、可语义检查并可后处理。
Reference in New Issue View Git Blame Copy Permalink