.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 对比 JSON:将大模型提示词 Token 成本直降 30–60%了解 TOON(面向 Token 的对象表示法)如何消除均匀 JSON 数组中的重复键名,大幅降低 GPT-5、Claude 4 与 Gemini 2.5 调用成本。
- 本地从 CSV 与 JSON 构建合法的 JSONL 大模型微调数据集在浏览器本地从表格与 JSON 数组一键生成符合 OpenAI Chat、Alpaca 与 Gemini 要求的 .jsonl 微调数据集并逐行校验。
- 在本地将 PDF、Word 与 Excel 整理为 RAG 与大模型适用的纯净 Markdown100% 在本地将机密 PDF、Word DOCX 与 Excel 工作表转为结构清晰的 Markdown,精准保留标题层级与表格,提升 RAG 切分质量。
- 从 JSON 一键生成 TypeScript、Zod 与 Pydantic v2 强类型定义在本地将 API JSON 样本转化为嵌套 TypeScript 接口、Zod 运行时校验器与 Python Pydantic v2 模型,自动推断可选字段与别名。
相关格式
全部 24 种格式TOON 常见问题
TOON 相比 JSON 究竟能节省多少大模型 Token?
对于数据库查询结果、API 列表或商品目录等结构一致的对象数组,仅在表头声明一次字段名通常可节省 35% 至 60% Token。
TOON 转回 JSON 时会丢失数据类型吗?
不会。字符串、整数小数、布尔值、null 以及嵌套对象和数组均可精确无损地还原为 JSON。
在 TOON 表格块中选择哪种分隔符效果最好?
逗号最通用直观;当字段内容常含空格或逗号时,在 o200k_base 分词器下切换为制表符 (\t) 或竖线 (|) 还能再省少量 Token。