ΓDocsInteractiveNet

specs · 规范索引

本目录存放可实现的规范(与 docs/ 的设计叙述分开)。版本化;破坏性变更需 ADR。

文件 内容 状态
net-ir.md 网 IR 的 JSON/二进制表示 draft v0.1
trace.md 交互/effect/remote 事件与重放格式 draft v0.1
wasm-api.md Netbook / 调试器使用的 WASM API draft v0.1
ain-sync.md Join/Select/Barrier/Gate 语义与类型 draft v0.1
grammar.md Ainet 词法/语法(Core + Flow) draft v0.1
flow-spec.md M2 FlowSpec:agent/edge/budget/effect/trace/重放 draft v0.1
flow-grammar.md M3 Ainet Flow 文本语法与诊断 draft v0.1
wire-protocol.md M4a coordinator ↔ worker NDJSON/TCP 协议 draft v0.1
cell-protocol.md M4c cell worker:spawn/deliver/snapshot/migrate draft v0.1

约定:

  • 所有 schema 带 version;不兼容变更升 major。
  • 所有 ID 在单个 net 内唯一;跨 net 引用用 (net_id, cell_id)。
  • 序列化必须确定性(字段排序、无浮点 NaN、hash 稳定)。
  • 示例中的数字/字符串仅用于说明,不作为测试向量;测试向量在 tests/golden/。

在 GitHub 编辑本文