For AI agents: the complete documentation index is available at https://a3s-lab.github.io/ash/v0.1.0/llms.txt, the full documentation bundle is available at https://a3s-lab.github.io/ash/v0.1.0/llms-full.txt, and this page is available as Markdown at https://a3s-lab.github.io/ash/v0.1.0/guide/ason.md.
  • 简体中文
  • v0.1.0
  • ASON

    ASON 是 ash 原生设计并实现的 LLM 优先结构化格式。它优先减少模型上下文中的重复 结构,同时保持严格 Schema、规范编码、流式边界和可恢复证据。

    示例

    s:0
    a:search
    d{p}:
    0:"src/runtime.rs"
    r{p,l,c}:
    0,42,governor
    0,88,stable_merge
    z{shown,total}:
    2,17
    q:ref-7
    • s:0:标量字段。
    • d{p}:路径字典列。
    • r{p,l,c}:同构搜索记录,列名只出现一次。
    • z{shown,total}:投影元数据。
    • q:完整证据引用,可以继续 slice 或 search。

    规范规则

    1. 字段和列顺序由消息 Schema 固定。
    2. 安全文本使用裸 Atom;需要时使用 UTF-8 字符串与最短转义。
    3. 重复字段、重复列、未知必需结构和非规范数字被拒绝。
    4. 解析器在构造完整模型前执行文档、集合、字符串与深度限制。
    5. decode 后再 encode 必须得到唯一字节序列。

    Token 证据

    固定格式语料在 cl100k_baseo200k_base 两个锁定 tokenizer 上得到同一结果:

    格式cl100ko200k相对紧凑行式 JSON
    规范 ASON6,3136,31262%
    紧凑行式 JSON10,19210,198100%

    这是格式语料回归数据,不是完整 Agent 任务质量或运行时性能结论。复现方式见 基准证据

    为什么不是普通 JSON

    JSON 对每条同构记录重复键名,并倾向内联长路径和大值。ASON 将结构重复移到 Schema 与列头,把大值留在有界存储中,只给模型返回引用和必要投影。它不是另一个格式的兼容层。