.toon · text/plain

TOON: Token-Oriented Object Notation(面向 Token 的对象表示法)

TOON 结合了类似 YAML 的嵌套对象缩进与类似 CSV 的表格表头声明(`items[N]{col1,col2}:`),消除大模型提示词中重复出现的 JSON 键名。

快速解答: TOON 结合了类似 YAML 的嵌套对象缩进与类似 CSV 的表格表头声明(`items[N]{col1,col2}:`),消除大模型提示词中重复出现的 JSON 键名。 向 GPT-5、Claude 4 或 Gemini 传入结构统一的 JSON 对象数组时,将提示词 Token 成本直降 30%–60%。

结构类型层级结构
人类可读性高
支持嵌套支持
LLM Token 效率高
文件扩展名.toon
MIME 类型text/plain
适用场景向 GPT-5、Claude 4 或 Gemini 传入结构统一的 JSON 对象数组时,将提示词 Token 成本直降 30%–60%。

核心优势

  • 在结构规整的记录数组上可减少 30%–60% 的 LLM 输入 Token 消耗
  • 通过显式数组长度与字段声明保持模型理解的高准确率
  • 可经由 @toon-format/toon 无损往返还原为强类型 JSON

局限与权衡

  • 新兴格式,尚未被浏览器原生 JSON API 直接内置解析
  • 当数组每项字段极不统一时,省 Token 幅度不如整齐数组明显
  • 需在调用大模型的输入输出边界增加一层编解码转换

参考资料

本地转换与清理 TOON

相关工程指南

TOON 常见问题

TOON 相比 JSON 究竟能节省多少大模型 Token?

对于数据库查询结果、API 列表或商品目录等结构一致的对象数组,仅在表头声明一次字段名通常可节省 35% 至 60% Token。

TOON 转回 JSON 时会丢失数据类型吗?

不会。字符串、整数小数、布尔值、null 以及嵌套对象和数组均可精确无损地还原为 JSON。

在 TOON 表格块中选择哪种分隔符效果最好?

逗号最通用直观;当字段内容常含空格或逗号时,在 o200k_base 分词器下切换为制表符 (\t) 或竖线 (|) 还能再省少量 Token。