Implement WebAssembly runtime and kinematics coverage
This commit is contained in:
@@ -5,17 +5,23 @@
|
||||
**生成器**：[`scripts/context_packet.py`](../scripts/context_packet.py)
|
||||
**测试**：[`scripts/test_context_packet.py`](../scripts/test_context_packet.py)
|
||||
|
||||
本文件只解决两个问题：任务如何拆到可以持续接续的大小，以及一次任务交接究竟允许携带什么上下文。架构、功能范围、源文件关联和发布门禁分别以[技术路线](linuxcnc-web-wasm-technical-roadmap.md)、[源程序关联目录](linuxcnc-web-wasm-source-map.md)、[覆盖矩阵](linuxcnc-web-wasm-simulation-coverage.md)和[执行与交付策略](linuxcnc-web-wasm-execution-strategy.md)为准。本文件不复制这些文档的内容。
|
||||
本文件只解决两个问题：任务如何拆到可以持续接续的大小，以及一次任务交接究竟允许携带什么上下文。架构、功能范围、源文件关联和发布门禁分别以[技术路线](linuxcnc-web-wasm-technical-roadmap.md)、[完整仿真机床实施蓝图](linuxcnc-web-wasm-full-port-implementation.md)、[运动学完整移植计划](linuxcnc-web-wasm-kinematics-migration-plan.md)、[源程序关联目录](linuxcnc-web-wasm-source-map.md)、[覆盖矩阵](linuxcnc-web-wasm-simulation-coverage.md)和[执行与交付策略](linuxcnc-web-wasm-execution-strategy.md)为准。本文件不复制这些文档的内容。
|
||||
|
||||
## 1. 不变量
|
||||
|
||||
1. 一个任务只有一个主工作流、一个里程碑、一个可验证结果和一个回滚点。跨三个以上工作流必须拆分。
|
||||
2. 一个上下文包只有固定八段：`header`、`baseline`、`scope`、`contracts`、`evidence`、`risks`、`next`、`forbidden`。禁止追加 `history`、聊天记录或完整日志段。
|
||||
2. 一个上下文包只有固定八段：`header`、`baseline`、`scope`、`contracts`、`evidence`、`risks`、`next`、`forbidden`。禁止追加 `history`、聊天记录或完整日志段。`nextTask.md` 只是 8 KiB 以内的启动指针，历史和证据摘要必须移到按需读取的索引。
|
||||
3. 默认 profile 为 `feature`（4,096 tokens/16 KiB）；里程碑任务才使用 `milestone`（8,192 tokens/32 KiB）。`doc` 和 `contract` 只在确有需要时使用。
|
||||
4. `total_bytes` 同时限制序列化包和选中证据负载：`context_bytes = packet_bytes + selected_evidence_bytes`。`evidence_bytes` 是独立的证据总量上限，不能用文件数量替代。
|
||||
5. 证据在生成阶段筛选。可选证据被排除时必须记录稳定 `reason_code`；必需证据无法容纳时生成失败，不输出部分成功包。
|
||||
6. 交接只携带最新包、context lock 摘要、受影响 manifest ID 和可重跑命令。完整日志、golden 和差异报告只通过路径、大小和哈希引用。
|
||||
|
||||
7. 模型请求必须为输出预留独立预算。`context` 输入预算、请求外固定开销（system/developer、工具 schema 和必要的当前状态摘要）、`max_output_tokens` 和模型上下文窗口分别记录；不能把完整日志追加到输入后再把输出预算设为最大值。连续执行从最新包重建请求，旧对话只保留路径/哈希，不能累加。请求失败时先缩减输入证据或拆分任务，不自动重试同一超大请求。
|
||||
|
||||
8. 流式响应必须经过 [`scripts/model_stream.py`](../scripts/model_stream.py) 的有界 SSE 消费器。只有收到 `response.completed` 且 provider `usage` 通过校验时结果才可复用；断流、残缺 UTF-8、`response.failed`、`context_length_exceeded`、usage 缺失/不一致或 `max_output_tokens` 截断都必须写入 metadata-only checkpoint。checkpoint 只能保存 `context_id`、`packet_id`、事件/字节计数、输出哈希和恢复建议，不得保存半截模型文本；恢复必须生成新的、更小的 packet。
|
||||
|
||||
9. `context_packet.py` 的 `token_limit`、`total_bytes`、`evidence_bytes` 和 `max_files` 覆盖值只能小于或等于 profile 默认值；扩大值必须改用新的、经过审查的 profile。没有 provider tokenizer 时，生成器和校验器按 UTF-8 字节作硬上界；调用方拿到精确令牌数后可通过 `--input-tokens` 替换保守估算，但不得放宽 profile 上限。
|
||||
|
||||
### 1.1 包的分层读取
|
||||
|
||||
任务执行者按以下顺序读取，读到足够完成任务即停止：
|
||||
@@ -137,6 +143,29 @@ next: INV-06b
|
||||
| COM-05a | 能力/限制注册表 | 全量 manifest | INV-02b、CORE-07b | contract |
|
||||
| COM-05b | 未支持能力解释 | 能力注册表 | COM-05a | doc |
|
||||
|
||||
#### 3.3.1 K0-K8：运动学主线
|
||||
|
||||
运动学任务按实现族和验收闭环拆分，完整契约、来源文件和测试矩阵见[运动学完整移植计划](linuxcnc-web-wasm-kinematics-migration-plan.md)。下列 ID 是最小任务目录的入口，不得把 CORE-07 作为一个不可拆分的大任务：
|
||||
|
||||
| ID | 单一结果 | 依赖 | Profile |
|
||||
|---|---|---|---|
|
||||
| K0-INV-01 | 运动学源文件、符号、缺失测试输入审计 | INV-01..02 | milestone |
|
||||
| K0-INV-02 | `configs/sim` 运动学入口图和参数样本 | K0-INV-01 | feature |
|
||||
| K0-ORACLE-01 | native FK/IK JSONL golden schema 和样本 | K0-INV-01 | contract |
|
||||
| K1-CONTRACT-01 | pose/joint、flags、home、错误码 C ABI | K0-ORACLE-01、CORE-02 | contract |
|
||||
| K1-CONTRACT-02 | 坐标映射、extra joints、数值/迭代政策 | K1-CONTRACT-01 | feature |
|
||||
| K2-TRIV-01 | trivkins 四种类型、重复轴和 home | K1-CONTRACT-02 | feature |
|
||||
| K2-COUPLED-01 | corexy/rose/max/rotate 及 HAL 等价链 | K2-TRIV-01、RT-02a | feature |
|
||||
| K3-5AXIS-01 | 5axiskins、xyzac/xyzbc TRT | K2-COUPLED-01 | feature |
|
||||
| K3-ROBOT-01 | GenSer、SCARA、PUMA、Scorbot | K1-CONTRACT-02 | feature |
|
||||
| K4-PARALLEL-01 | Delta、RotaryDelta、Tripod | K1-CONTRACT-02 | feature |
|
||||
| K4-PARALLEL-02 | Hexapod、Pentapod 迭代正解和分支 | K4-PARALLEL-01 | feature |
|
||||
| K5-SWITCH-01 | switchkins 静态切换和 lastpose | K3、K4 | contract |
|
||||
| K5-USER-01 | userk/ugenser 构建期静态能力 | K5-SWITCH-01 | feature |
|
||||
| K6-MOTION-01 | TP→IK→motion→FK feedback | K2..K5、CORE-04/06 | milestone |
|
||||
| K7-REG-01 | 全配置、UI 姿态和浏览器故障回归 | K6、FE/COM | milestone |
|
||||
| K8-REL-01 | 运动学兼容、来源和发布闭合 | K7、REL-01 | milestone |
|
||||
|
||||
### 3.4 M4-M5：前端、回归和发布
|
||||
|
||||
| ID | 单一结果 | 直接输入 | 依赖 | Profile |
|
||||
@@ -176,7 +205,7 @@ next: INV-06b
|
||||
### 4.1 正常交接
|
||||
|
||||
1. 从 context lock 和父任务摘要生成新的 `packet_id`；只填本子任务的八段。
|
||||
2. 用候选证据的实际字节数调用生成器。生成前就排除 `E1`-`E5`，输出后只接受 `budget.packet_bytes <= byte_limit` 且 `packet_bytes + selected_evidence_bytes <= byte_limit`。
|
||||
2. 用候选证据的实际字节数调用生成器。生成前就排除 `E1`-`E6`，输出后只接受 `budget.packet_bytes <= byte_limit`、`packet_bytes + selected_evidence_bytes <= byte_limit` 且估算输入令牌不超过 profile 上限。
|
||||
3. 完成一步就更新 `evidence`、`risks`、`next`；不追加旧包全文。
|
||||
4. 提交正文只写 `Context-ID`、`Context-Packet`、子任务 ID、测试命令和证据路径。
|
||||
|
||||
@@ -201,7 +230,7 @@ budget.packet_bytes <= byte_limit
|
||||
budget.packet_bytes + budget.selected_evidence_bytes <= byte_limit
|
||||
selected_evidence_bytes <= evidence_byte_limit
|
||||
selected_evidence_files <= evidence_file_limit
|
||||
所有排除项都有 E1-E5 reason_code
|
||||
所有排除项都有 E1-E6 reason_code
|
||||
required 证据无法容纳时命令失败且不写输出
|
||||
```
|
||||
|
||||
@@ -209,6 +238,10 @@ required 证据无法容纳时命令失败且不写输出
|
||||
|
||||
```bash
|
||||
python3 -m unittest discover -s scripts -p 'test_*.py' -v
|
||||
python3 scripts/validate_task_pointer.py
|
||||
python3 scripts/validate_model_budget.py <packet.json> --context-window <model-window> --overhead-tokens <current-request-overhead>
|
||||
```
|
||||
|
||||
流式请求还必须通过 `scripts/test_model_stream.py`：覆盖跨 chunk UTF-8、无终态断流、provider failure/context overflow、usage 校验、输出截断和 checkpoint 不包含部分文本。网络传输异常只能记录为 `stream_disconnected`，不能重试原 packet。
|
||||
|
||||
本规范的目标不是把所有信息压进一个更大的包，而是让每个任务只携带完成当前结果所需的最小、可重建、可审计上下文。
|
||||
|
||||
Reference in New Issue
Block a user