SuperAPI AI 工具集

toon-format

编程与开发

查看项目

更新于 10-16 07:27

技能介绍

用途:TOON 是 JSON 数据模型的紧凑、人类可读编码,用于减少 LLM 输入 token,同时保持或提升模型理解准确度。它用 YAML 式缩进表示嵌套对象,用 CSV 式表格表示同构数组。

主要能力:支持标量、嵌套对象、扁平数组(key[N]: v1,v2)和同构对象数组(key[N]{f1,f2}: 后接 N 行)。含引号规则处理逗号、冒号、换行;提供 encode/decode API 与 CLI 转换、管道、--pretty、--stats。

使用方式:安装 npm install @toon-format/toon(或 pnpm/yarn);CLI 全局安装 npm install -g @toon-format/toon,用 toon encode input.json、toon decode input.toon 转换。API 中 import { encode, decode } from '@toon-format/toon'。编码选项含 tabular(always/never/auto)、indent、quoting。可注入 LLM 提示,并附格式说明。

适用场景:同构对象数组(节省最多)、RAG 检索上下文、批量 API 调用、Express 中间件 text/toon。

限制:深层嵌套或非均匀数据需与 JSON 对比基准;纯扁平表格可考虑 CSV;程序化 API 调用仍用 JSON,仅 LLM 输入转 TOON;手写 TOON 需声明数组长度、缩进一致、正确引号;数字与布尔需用正确 JS 类型,否则往返类型丢失。官方规范、在线 Playground 与 GitHub 仓库见资料。