ZONFORMAT

💡 ZONFORMAT：LLM 时代的零开销数据标准

ZONFORMAT（零开销记法）是一种专为大型语言模型（LLM）设计的可读、极省 Token 的数据格式。它在紧凑性、效率方面超越了 JSON、YAML 和 TOON，能够为您的 API 调用节省约 30-40% 的费用！👏

---

✨ 产品亮点：

• 智能压缩，节省成本： 通过表格编码和最小化语法开销，相比 JSON 可实现 ~50% 的 Token 削减。这意味着更低的 LLM 调用费用和更大的有效上下文窗口。
• 人类可读性与机器效率兼顾： 语法简洁，无严格引用规则，布局清晰如 Markdown，同时为 LLM 提供高效处理能力。
• 100% 检索准确性： 自解释结构和明确的头部信息，确保 LLM 以几乎完美的准确率检索数据，消除歧义。
• 运行时安全验证： 零开销地对照严格模式（schema）验证 LLM 输出，类型安全、可靠。内置的验证层还能帮助 LLM 自我修正错误，提升输出质量。
• 面向流式处理设计： 支持字节级解析，可增量处理大型数据集，内存占用极小。
• 与 JSON 1:1 映射： 完全兼容 JSON 数据模型，包括对象、数组、字符串、数字、布尔值和 null，保证无损往返转换。
• 多语言支持： 提供生产就绪的 Python 和 TypeScript 库，轻松集成到您的技术栈中。

---

🎯 ZON 为什么能脱颖而出？

“我把 ZON 整合到我的智能体群中后，我的 OpenAI 账单直接‘跳崖’了。”

—— 某位试用用户的心声

LLM 的使用成本正在降低，但更大的上下文窗口也意味着更大的数据输入。标准 JSON 格式冗长且会消耗大量 Token，而 ZONFORMAT 则提供了一个更优解：

• Token 效率卓越： 比 JSON 减少 35-70% 的 Token，比 TOON 也减少 4-35%。在所有主流 LLM 中表现最佳或并列最佳。
• 零解析开销： 比 CSV 更“简单粗暴”的解析机制，让 LLM 爱不释手，处理速度更快。
• 验证与压缩一体： ZON 是唯一一个在同一个包中同时提供数据验证（如 Zod）和输入数据压缩的库，兼顾安全与效率。

---

⚙️ 核心功能一览：

• 字典压缩 (Dictionary Compression)： 自动识别重复字符串值并创建字典，存储索引而非重复值，大幅节省 Token。对于电商订单、日志文件等数据，可节省高达 38%-63% 的 Token。
• 类型强制转换 (Type Coercion)： 智能分析并转换 LLM 可能返回的字符串化数值或布尔值（如 "25" → 25，"true" → True），确保数据类型正确。
• LLM 感知字段排序 (LLM-Aware Field Ordering)： 根据 LLM 的注意机制，优化字段顺序（如将 ID、名称等高优先级字段前置），可带来 +4% 到 +7% 的准确性提升，特别在实体提取、数据检索和分类任务中效果显著。
• 分层稀疏编码 (Hierarchical Sparse Encoding)： 高效处理嵌套对象和缺失字段，通过点分表示法扁平化嵌套结构，支持多达 5 级的深度嵌套。
• 二进制格式 (Binary Format)： 提供 ZON-B 格式，将数据编码为紧凑的二进制缓冲区，进一步提升传输效率。
• 多重编码模式： 包含 compact（最大压缩）、readable（类 YAML 语法，人类可读）、llm-optimized（平衡清晰度与 Token 消耗）等模式，灵活适应不同场景。

---

🚀 快速上手：

Python 用户：

pip install zon-format

import zon

data = {
  "users": [
    {"id": 1, "name": "Alice", "role": "admin", "active": True},
    {"id": 2, "name": "Bob", "role": "user", "active": True}
  ]
}

encoded = zon.encode(data)
print(encoded)
# users:@(2):active,id,name,role
# T,1,Alice,admin
# T,2,Bob,user

decoded = zon.decode(encoded)
assert decoded == data # ✓ Lossless!

TypeScript/JavaScript 用户：

npm install zon-format

import { encode, decode } from 'zon-format';

const data = {
  posts: [
    { id: 1, title: 'Hello World', published: true },
    { id: 2, title: 'ZON Guide', published: true }
  ]
};

const encoded = encode(data);
console.log(encoded);
// posts:@(2):id,published,title
// 1,T,Hello World
// 2,T,ZON Guide

const decoded = decode(encoded);
// Identical to original - lossless!

---

🛠️ 命令行工具 (CLI)：

ZON 提供强大的命令行接口，方便文件转换、验证和分析：

npm install -g zon-format

• zon encode <file.json>: 将 JSON 转换为 ZON。
• zon decode <file.zonf>: 将 ZON 转换为 JSON。
• zon validate <file.zonf>: 验证 ZON 文件的语法。
• zon stats <file.zonf>: 显示 ZON 文件的统计信息（如大小、Token 节省量、解析时间）。
• zon format <file.zonf>: 标准化并美化 ZON 文件。

---

🌟 总结：

ZONFORMAT 不仅仅是一种数据格式，它更是一个为 LLM 时代打造的全面解决方案。它以卓越的 Token 效率，结合高准确性、可读性及强大的验证功能，助您在 LLM 应用中显著降低成本，提升性能，并确保数据可靠性。🤝 立即体验 ZONFORMAT，开启您的 LLM 高效之旅！