用途:TOON 是 JSON 的紧凑、人类可读、模式感知编码,便于 LLM 阅读,并在良好提示下生成。它特别适合统一的对象数组(表格数据):键只声明一次,行只携带值。当需要向 LLM 传入大型结构化上下文、希望用结构护栏([N] 计数与 {fields} 表头)减少模型漂移并支持校验、或需要接近 CSV 可读性但无损表示 JSON 时使用 TOON。若需与标准 JSON 系统互操作、数据极不规则(参差对象)或纯机器对机器场景,则优先用 JSON/JSONL/CSV。
主要能力:识别 TOON 常见形态(key: value 标量/对象、带长度的数组 users[3]:、带字段表头的表格数组 users[3]{id,name,role}:,行以分隔符分隔,默认逗号,制表符常更优);JSON 与 TOON 双向转换;token 统计与效率优化;可选结构压缩(编码 --keyFolding safe,解码 --expandPaths safe)。
使用方式:CLI 最快,适合流水线。编码:npx @toon-format/cli input.json -o output.toon;解码:npx @toon-format/cli input.toon -o output.json;统计:npx @toon-format/cli input.json --delimiter "\t" --stats -o output.toon。应用内可用 @toon-format/toon 库。提示 LLM 时:输入用标注 toon 的代码块包裹,展示而非解释;要求输出时给出表头模板(如 users[N]{id,name,role}:),明确 2 空格缩进、[N] 与行数一致、只输出代码块。模型生成的 TOON 必须校验(官方工具默认严格模式),失败则用同一模板重出或回退 JSON。本技能还含 scripts/toon_convert.py 包装脚本,可提取 Markdown 中的 TOON 代码块并调用官方 CLI,支持 --encode/--decode、--delimiter、--stats 及折叠/展开标志。
限制:资料未提供具体收费、价格、平台与效果数据;不规则数据可能不比 JSON 更紧凑;需标准 JSON 互操作时不宜使用。