TONL（令牌优化表示语言）

TONL 是一个生产就绪的数据平台，结合了紧凑的序列化以及强大的查询、修改、索引和流式处理能力。它专为 LLM 的令牌效率而设计，同时提供丰富的 API 用于数据访问和操作。

🎉 最新版本：v2.5.2 - 文档与测试卓越

📚 v2.5.2（2025年12月20日）

• 216项新测试 - 共计162个测试套件中的698项测试，通过率为100%
• 浏览器文档 - 完整的docs/BROWSER.md 和 docs/ERROR_HANDLING.md
• 4个浏览器示例 - React 18 和 Vue 3 交互式演示
• 5处安全修复 - 所有 npm 漏洞均已修复
• 更新依赖项 - 所有包均升级至最新版本

🔧 v2.5.1（2025年12月11日）

• 8项关键错误修复，包括防止 DoS 攻击和异步处理问题

🛡️ v2.5.0（2025年12月3日）

• 企业级安全加固及优化模块

🧪 测试卓越：

• 698项全面测试 - 全部通过，成功率为100%
• 96项安全测试 - 覆盖所有攻击向量
• 并发测试 - 线程安全性验证
• 浏览器测试 - 跨平台兼容性

🏠 主页: tonl.dev 📦 GitHub: github.com/tonl-dev/tonl 📖 文档: 完整指南

📋 目录

• 为什么选择TONL？
• 快速入门
• 格式概述
• 功能集
• 性能
• 安全性
• 用例
• 浏览器使用
• API 参考
• 开发
• 路线图
• 文档
• 贡献
• 许可证

---

为什么选择TONL？

🗜️ 体积缩小多达60% - 减少 JSON 大小及 LLM 令牌成本 👁️ 人类可读 - 清晰的文本格式，而非二进制 🚀 极速高效 - 比目标快10到1600倍 🔒 生产级安全 - 100% 安全加固（v2.0.3） 🛠️ TypeScript优先 - 完整类型安全与智能感知 📦 零依赖 - 纯 TypeScript，无臃肿代码 🌐 浏览器就绪 - 压缩后仅10.5 KB（IIFE/UMD） ✅ 100% 测试覆盖 - 核心功能496项测试全部通过

---

🚀 快速入门

安装

npm install tonl

基本用法

import { TONLDocument, encodeTONL, decodeTONL } from 'tonl';

// 从 JSON 创建
const doc = TONLDocument.fromJSON({
  users: [
    { id: 1, name: "Alice", role: "admin", age: 30 },
    { id: 2, name: "Bob", role: "user", age: 25 }
  ]
});

// 使用类似 JSONPath 的语法进行查询
doc.get('users[0].name');                          // 'Alice'
doc.query('users[*].name');                        // ['Alice', 'Bob']
doc.query('users[?(@.role == "admin")]');          // [{ id: 1, ... }]
doc.query('$..age');                               // 递归获取所有年龄

// 聚合（v2.4.0）
doc.count('users[*]');                             // 2
doc.sum('users[*]', 'age');                        // 55
doc.avg('users[*]', 'age');                        // 27.5
doc.groupBy('users[*]', 'role');                   // { admin: [...], user: [...] }
doc.aggregate('users[*]').stats('age');            // { count, sum, avg, min, max, stdDev }

// 模糊匹配（v2.4.0）
import { fuzzySearch, soundsLike } from 'tonl/query';
fuzzySearch('Jon', ['John', 'Jane', 'Bob']);       // [{ value: 'John', score: 0.75 }]
soundsLike('Smith', 'Smyth');                      // true

// 时间查询（v2.4.0）
import { parseTemporalLiteral, isDaysAgo } from 'tonl/query';
parseTemporalLiteral('@now-7d');                   // 7天前
isDaysAgo(someDate, 30);                           // 是否在过去30天内？

// 修改数据
doc.set('users[0].age', 31);
doc.push('users', { id: 3, name: "Carol", role: "editor", age: 28 });

// 导航与遍历
for (const [key, value] of doc.entries()) {
  console.log(key, value);
}

doc.walk((path, value, depth) => {
  console.log(`${path}: ${value}`);
});

// 导出
const tonl = doc.toTONL();
const json = doc.toJSON();
await doc.save('output.tonl');

// 经典 API（编码/解码）
const data = { users: [{ id: 1, name: "Alice" }] };
const tonlText = encodeTONL(data);
const restored = decodeTONL(tonlText);

// 高级优化（v2.0.1+）
import { AdaptiveOptimizer, BitPacker, DeltaEncoder } from 'tonl/optimization';

// 自动优化
const optimizer = new AdaptiveOptimizer();
const result = optimizer.optimize(data);  // 自动选择最佳策略

// 特定优化器
const packer = new BitPacker();
const packed = packer.packBooleans([true, false, true]);

const delta = new DeltaEncoder();
const timestamps = [1704067200000, 1704067201000, 1704067202000];
const compressed = delta.encode(timestamps, 'timestamp');

CLI 使用

🎮 交互式 CLI（全新 v2.3.1）

# 交互式统计仪表盘
tonl stats data.json --interactive
tonl stats data.json -i --theme neon

# 文件比较模式
tonl stats data.json --compare --theme matrix

# 交互式探索
tonl stats --interactive  # 不需文件即可启动菜单驱动式探索

📊 标准命令

# 开始使用（显示帮助）
tonl

# 版本信息
tonl --version

# 将 JSON 编码为 TONL（完美往返，特殊键加引号）
tonl encode data.json --out data.tonl --smart --stats

# 带预处理的编码（清理并使键更易读）
tonl encode data.json --preprocess --out data.tonl

# 将 TONL 解码为 JSON
tonl decode data.tonl --out data.json

# 查询数据
tonl query users.tonl "users[?(@.role == 'admin')]"
tonl get data.json "user.profile.email"

# 根据模式验证
tonl validate users.tonl --schema users.schema.tonl

# 格式化并美化
tonl format data.tonl --pretty --out formatted.tonl

# 比较令牌成本
tonl stats data.json --tokenizer gpt-5

🎨 交互式主题（v2.3.1）

# 可用主题：默认、霓虹、矩阵、赛博朋克
tonl stats data.json -i --theme neon        # 明亮的霓虹色
tonl stats data.json -i --theme matrix      # 绿色矩阵风格
tonl stats data.json -i --theme cyberpunk   # 青紫色赛博朋克风
tonl stats data.json -i --theme default     # 干净的终端颜色

⚖️ 文件比较（v2.3.1）

# 并排比较 JSON 和 TONL 文件
tonl stats data.json --compare
tonl stats data.json --compare --theme neon

# 交互式比较模式
tonl stats data.json -i --compare

---

📊 格式概述

对象数组（表格格式）

JSON（245字节，89个标记）：

{
  "users": [
    { "id": 1, "name": "Alice", "role": "admin" },
    { "id": 2, "name": "Bob, Jr.", "role": "user" },
    { "id": 3, "name": "Carol", "role": "editor" }
  ]
}

TONL（158字节，49个标记——减少45%）：

#version 1.0
users[3]{id:u32,name:str,role:str}:
  1, Alice, admin
  2, "Bob, Jr.", user
  3, Carol, editor

嵌套对象

JSON：

{
  "user": {
    "id": 1,
    "name": "Alice",
    "contact": {
      "email": "alice@example.com",
      "phone": "+123456789"
    },
    "roles": ["admin", "editor"]
  }
}

TONL：

#version 1.0
user{id:u32,name:str,contact:obj,roles:list}:
  id: 1
  name: Alice
  contact{email:str,phone:str}:
    email: alice@example.com
    phone: +123456789
  roles[2]: admin, editor

---

✨ 完整功能集

🔄 核心序列化

• 紧凑格式：比 JSON 小 32%-45%（字节数和标记数）
• 可读性高：清晰的文本格式，语法简洁
• 双向兼容：支持与 JSON 的完美互转
• 智能编码：自动选择最优分隔符和格式
• 类型提示：可选模式信息用于验证

🔍 查询与导航 API

• JSONPath 查询：users[?(@.age > 25)]、$..email
• 过滤表达式：==、!=、>、<、&&、||、contains、matches
• 通配符支持：users[*].name、**.email
• 树遍历：entries()、keys()、values()、walk()
• LRU 缓存：重复查询命中率超过 90%

✏️ 修改 API

• CRUD 操作：set()、get()、delete()、push()、pop()
• 批量操作：merge()、update()、removeAll()
• 变更跟踪：diff() 提供详细变更报告
• 快照：文档版本管理和对比
• 原子文件编辑：安全保存并自动备份

⚡ 性能与索引

• 哈希索引：O(1) 精确匹配查找
• BTree 索引：O(log n) 范围查询
• 复合索引：多字段索引
• 流式处理：处理数十 GB 文件仅需不到 100 MB 内存
• 管道操作：可链式执行过滤/映射/归约转换

🗜️ 高级优化

• 字典编码：通过查找表压缩值（节省 30%-50%）
• 差分编码：顺序数据压缩（节省 40%-60%）
• 游程编码：重复值压缩（节省 50%-80%）
• 位打包：布尔值和小整数的位级压缩（节省 87.5%）
• 数值量化：降低浮点数精度（节省 20%-40%）
• 模式继承：跨数据块重用列模式（节省 20%-40%）
• 层次分组：提取嵌套结构中的公共字段（节省 15%-30%）
• 分词器感知：针对 LLM 分词器优化以减少标记使用（节省 5%-15%）
• 列重排：基于熵排序以提高压缩效率
• 自适应优化器：根据数据模式自动选择策略

✅ 模式与验证

• 模式定义：.schema.tonl 文件，采用 TSL（TONL 模式语言）
• 13 种约束：required、min、max、pattern、unique、email 等
• TypeScript 生成：从模式自动生成类型
• 运行时验证：可通过程序或 CLI 验证数据
• 严格模式：强制遵守模式要求

🛠️ 开发者工具

• 🎮 交互式 CLI 控制台：实时文件分析，支持主题和进度可视化
• ⚖️ 文件比较系统：JSON 和 TONL 并排比较，提供详细指标
• 🎨 可视化定制：多种终端主题（默认、霓虹、矩阵、赛博朋克）
• 交互式 REPL：在终端中交互探索数据
• 模块化 CLI 套件：encode、decode、query、validate、format、stats，采用命令模式架构
• 浏览器支持：ESM、UMD、IIFE 构建（压缩后 8.84 KB）
• VS Code 扩展：为 .tonl 文件提供语法高亮
• TypeScript 优先：全面的 IntelliSense 和类型安全

---

📊 性能对比

指标	JSON	TONL	TONL Smart	改善幅度
大小（字节）	245	167	158	更小 36%
标记数（GPT-5）	89	54	49	减少 45%
编码速度	1.0x	15x	12x	快 12-15 倍
解码速度	1.0x	10x	10x	快 10 倍
查询速度	-	-	1600x	目标：<1ms

基准测试基于典型的电商产品目录数据

---

🔒 安全与质量

✅ 测试：          698+ 测试通过（100% 覆盖率）
✅ 安全：           已修复所有漏洞（100%）
✅ 安全测试：       96 项安全测试通过
✅ 代码质量：       TypeScript 严格模式
✅ 依赖项：         运行时无依赖
✅ 包体积：         浏览器端压缩后 10.5 KB
✅ 性能：           比目标快 10-1600 倍
✅ 生产就绪：       已准备就绪且完全安全

安全性：

• ✅ 防止 ReDoS、路径遍历、缓冲区溢出
• ✅ 防范原型污染、命令注入
• ✅ 修复整数溢出、类型强制转换问题
• ✅ 全面的输入验证和资源限制

详情请参阅 SECURITY.md 和 CHANGELOG.md。

---

🎯 使用场景

LLM 提示词

在提示词中加入结构化数据时，可将标记成本降低 32%-45%：

const prompt = `分析以下用户数据：\n${doc.toTONL()}`;
// 标记数减少 45% = API 成本降低

配置文件

既紧凑又清晰的人类可读配置：

config{env:str,database:obj,features:list}:
  env: production
  database{host:str,port:u32,ssl:bool}:
    host: db.example.com
    port: 5432
    ssl: true
  features[3]: auth, analytics, caching

API 响应

高效传输数据并进行模式验证：

app.get('/api/users', async (req, res) => {
  const doc = await TONLDocument.load('users.tonl');
  const filtered = doc.query('users[?(@.active == true)]');
  res.type('text/tonl').send(encodeTONL(filtered));
});

数据管道

大型数据集的流式处理：

import { createEncodeStream, createDecodeStream } from 'tonl/stream';

createReadStream('huge.json')
  .pipe(createDecodeStream())
  .pipe(transformStream)
  .pipe(createEncodeStream({ smart: true }))
  .pipe(createWriteStream('output.tonl'));

日志聚合

紧凑的结构化日志：

logs[1000]{timestamp:i64,level:str,message:str,metadata:obj}:
  1699564800, INFO, "用户登录", {user_id:123,ip:"192.168.1.1"}
  1699564801, ERROR, "DB 超时", {query:"SELECT...",duration:5000}
  ...

---

🌐 浏览器使用

ESM（现代浏览器）

<script type="module">
  import { encodeTONL, decodeTONL } from 'https://cdn.jsdelivr.net/npm/tonl@2.4.1/+esm';

  const data = { users: [{ id: 1, name: "Alice" }] };
  const tonl = encodeTONL(data);
  console.log(tonl);
</script>

UMD（通用）

<script src="https://unpkg.com/tonl@2.4.1/dist/browser/tonl.umd.js"></script>
<script>
  const tonl = TONL.encodeTONL({ hello: "world" });
  console.log(tonl);
</script>

打包大小：

• ESM：15.5 KB（压缩后）
• UMD：10.7 KB（压缩后）
• IIFE：10.6 KB（压缩后）

示例： 请参阅 examples/browser/，以获取交互式的 React 和 Vue 示例。

---

📚 完整 API 参考

TONLDocument 类

// 创建
TONLDocument.fromJSON(data)
TONLDocument.parse(text)                           // 解析 TONL 字符串
TONLDocument.fromFile(filepath)                    // 异步文件加载
TONLDocument.fromFileSync(filepath)                // 同步文件加载

// 查询
doc.get(path: string)                              // 获取单个值
doc.query(query: string)                           // 获取多个值
doc.exists(path: string)                           // 检查是否存在

// 修改
doc.set(path: string, value: any)                  // 设置值
doc.delete(path: string)                           // 删除值
doc.push(path: string, value: any)                 // 向数组追加元素
doc.pop(path: string)                              // 从数组中移除最后一个元素
doc.merge(path: string, value: object)             // 深度合并对象

// 导航
doc.entries()                                      // 迭代器<[key, value]>
doc.keys()                                         // 迭代器<string>
doc.values()                                       // 迭代器<any>
doc.walk(callback: WalkCallback)                   // 遍历树结构
doc.find(predicate: Predicate)                     // 查找单个匹配项
doc.findAll(predicate: Predicate)                  // 查找所有匹配项
doc.some(predicate: Predicate)                     // 是否存在至少一个匹配项
doc.every(predicate: Predicate)                    // 是否所有项都匹配

// 索引
doc.createIndex(name: string, path: string, type?) // 创建索引
doc.dropIndex(name: string)                        // 删除索引
doc.getIndex(name: string)                         // 获取索引

// 导出
doc.toTONL(options?: EncodeOptions)                // 导出为 TONL 格式
doc.toJSON()                                       // 导出为 JSON 格式
doc.save(filepath: string, options?)               // 保存到文件
doc.size()                                         // 文件大小（字节）
doc.stats()                                        // 统计信息对象

编码/解码 API

// 编码
encodeTONL(data: any, options?: {
  delimiter?: "," | "|" | "\t" | ";";
  includeTypes?: boolean;
  version?: string;
  indent?: number;
  singleLinePrimitiveLists?: boolean;
}): string

// 智能编码（自动优化）
encodeSmart(data: any, options?: EncodeOptions): string

// 解码
decodeTONL(text: string, options?: {
  delimiter?: "," | "|" | "\t" | ";";
  strict?: boolean;
}): any

Schema API

import { parseSchema, validateTONL } from 'tonl/schema';

// 解析模式
const schema = parseSchema(schemaText: string);

// 验证数据
const result = validateTONL(data: any, schema: Schema);

if (!result.valid) {
  result.errors.forEach(err => {
    console.error(`${err.field}: ${err.message}`);
  });
}

流式 API

import { createEncodeStream, createDecodeStream, encodeIterator, decodeIterator } from 'tonl/stream';

// Node.js 流
createReadStream('input.json')
  .pipe(createEncodeStream({ smart: true }))
  .pipe(createWriteStream('output.tonl'));

// 异步迭代器
for await (const line of encodeIterator(dataStream)) {
  console.log(line);
}

---

✅ 模式验证

使用 TONL 模式语言（TSL）定义模式：

@schema v1
@strict true
@description "用户管理模式"

# 定义自定义类型
User: obj
  id: u32 必填
  username: str 必填，长度3-20，格式^[a-zA-Z0-9_]+$
  email: str 必填，格式email，且全小写
  age: u32? 范围13-150
  roles: list<str> 必填，至少1个，且唯一

# 根模式
users: list<User> 必填，至少1个
totalCount: u32 必填

13 种内置约束：

• required - 字段必须存在
• min / max - 数值范围或字符串/数组长度限制
• length - 精确长度
• pattern - 正则表达式验证（或快捷方式：email、url、uuid）
• unique - 数组元素必须唯一
• nonempty - 字符串/数组不能为空
• positive / negative - 数字的正负号
• integer - 必须是整数
• multipleOf - 整除性检查
• lowercase / uppercase - 强制字符串大小写

完整参考请见 docs/SCHEMA_SPECIFICATION.md。

---

🛠️ 开发

构建与测试

# 安装依赖
npm install

# 构建 TypeScript
npm run build

# 运行所有测试（698+ 测试）
npm test

# 监听模式
npm run dev

# 清理构建产物
npm run clean

基准测试

# 字节大小比较
npm run bench

# 令牌估算（GPT-5、Claude 3.5、Gemini 2.0、Llama 4）
npm run bench-tokens

# 全面性能分析
npm run bench-comprehensive

CLI 开发

# 在本地安装 CLI
npm run link

# 测试命令
tonl encode test.json
tonl query data.tonl "users[*].name"
tonl format data.tonl --pretty

# 测试交互功能（v2.3.1+）
tonl stats data.json --interactive
tonl stats data.json -i --theme neon
tonl stats data.json --compare

---

🗺️ 路线图

✅ v2.5.1 - 已完成（最新版本）

• ✅ 修复关键漏洞（数组扩展 DoS、JSON.stringify 漏洞、异步处理问题）
• ✅ 482 个测试，通过率 100%
• ✅ 提升稳定性和错误处理能力

✅ v2.5.0 - 已完成

• ✅ 聚合函数（count、sum、avg、groupBy、stats、median、percentile）
• ✅ 模糊字符串匹配（Levenshtein、Jaro-Winkler、Soundex、Metaphone）
• ✅ 时间查询（@now-7d、before、after、sameDay、daysAgo）
• ✅ 763+ 个全面测试，通过率 100%

✅ v2.2+ - 已完成

• ✅ 革命性的交互式 CLI 控制台，支持实时分析
• ✅ 完成模块化架构改造（735→75 行代码）
• ✅ 文件对比系统，支持并排分析
• ✅ 多种视觉主题（默认、霓虹、矩阵、赛博朋克）

✅ v2.0+ - 已完成

• ✅ 高级优化模块（额外压缩 60%）
• ✅ 完整的查询、修改、索引和流式 API
• ✅ 模式验证与 TypeScript 生成
• ✅ 浏览器支持（10.5 KB 打包文件）
• ✅ 100% 测试覆盖率及安全性加固

🚀 未来

• 增强的 VS Code 插件（IntelliSense、调试）
• 带有实时转换功能的在线 Playground
• Python、Go、Rust 实现
• 二进制 TONL 格式，用于极致压缩

完整开发愿景请见 ROADMAP.md。

---

📖 文档

针对用户

• 入门指南 - 适合初学者的教程，附带示例
• API 参考文档 - 包含示例的完整 API 文档
• CLI 文档 - 命令行工具使用指南
• 浏览器 API - 支持 ESM、UMD 和 IIFE 构建的浏览器端使用说明
• 错误处理 - 错误类及故障排除
• 查询 API - 类似 JSONPath 的查询语法参考
• 修改 API - CRUD 操作指南
• 导航 API - 树形结构遍历方法
• 用例 - 现实场景与解决方案

针对实现者（其他语言）

• 实现参考 - 与语言无关的实现指南
• 转换示例 - 超过 20 个 JSON↔TONL 转换示例
• 格式规范 - 技术格式规范
• 模式规范 - TSL（TONL 模式语言）规范

想在 Python、Go、Rust 或其他语言中实现 TONL 吗？ 请查看 实现参考，其中包含完整的算法、伪代码和测试要求！

---

🤝 贡献

我们欢迎各种贡献！请阅读 CONTRIBUTING.md，了解：

• 开发环境搭建
• 代码风格指南
• 测试要求
• 拉取请求流程
• 架构概览

---

📄 许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

---

🌟 链接

• 官网: tonl.dev
• npm 包: npmjs.com/package/tonl
• GitHub: github.com/tonl-dev/tonl
• 问题追踪: github.com/tonl-dev/tonl/issues
• 讨论区: github.com/tonl-dev/tonl/discussions
• VS Code 扩展: [即将推出]

---

TONL 快速上手指南

TONL (Token-Optimized Notation Language) 是一个专为大语言模型（LLM）优化的数据平台，结合了紧凑的序列化格式与强大的查询、修改及流处理能力。它能显著减少 JSON 体积和 LLM Token 消耗，同时保持人类可读性。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows, macOS, 或 Linux
• 运行时环境：
  • Node.js: 推荐 v18.0.0 或更高版本
  • npm: 随 Node.js 安装，建议升级至最新版
• 前置依赖：无（TONL 是纯 TypeScript 编写，零运行时依赖）

💡 国内加速建议：如果您在中国大陆地区，建议使用淘宝镜像源加速安装过程：

npm config set registry https://registry.npmmirror.com

安装步骤

通过 npm 包管理器安装 TONL：

npm install tonl

若需使用命令行工具（CLI），可全局安装：

npm install -g tonl

基本使用

1. 代码集成 (TypeScript/JavaScript)

以下示例展示了如何创建文档、执行类 JSONPath 查询、聚合数据以及修改内容。

import { TONLDocument, encodeTONL, decodeTONL } from 'tonl';

// 1. 从 JSON 创建文档
const doc = TONLDocument.fromJSON({
  users: [
    { id: 1, name: "Alice", role: "admin", age: 30 },
    { id: 2, name: "Bob", role: "user", age: 25 }
  ]
});

// 2. 查询数据 (支持 JSONPath 语法)
doc.get('users[0].name');                          // 输出: 'Alice'
doc.query('users[*].name');                        // 输出: ['Alice', 'Bob']
doc.query('users[?(@.role == "admin")]');          // 输出: [{ id: 1, ... }]
doc.query('$..age');                               // 递归获取所有年龄

// 3. 数据聚合 (v2.4.0+)
doc.count('users[*]');                             // 输出: 2
doc.sum('users[*]', 'age');                        // 输出: 55
doc.avg('users[*]', 'age');                        // 输出: 27.5
doc.groupBy('users[*]', 'role');                   // 按角色分组

// 4. 修改数据
doc.set('users[0].age', 31);
doc.push('users', { id: 3, name: "Carol", role: "editor", age: 28 });

// 5. 遍历文档
doc.walk((path, value, depth) => {
  console.log(`${path}: ${value}`);
});

// 6. 导出与序列化
const tonlText = doc.toTONL();   // 转换为紧凑的 TONL 格式
const jsonData = doc.toJSON();   // 转回标准 JSON
await doc.save('output.tonl');   // 保存到文件

// 7. 经典编码/解码 API
const data = { users: [{ id: 1, name: "Alice" }] };
const encoded = encodeTONL(data);
const decoded = decodeTONL(encoded);

2. 命令行工具 (CLI)

安装全局包后，您可以在终端直接使用 tonl 命令进行文件处理、统计和分析。

查看帮助与版本：

tonl
tonl --version

文件格式转换：

# 将 JSON 编码为 TONL (智能优化模式，带统计信息)
tonl encode data.json --out data.tonl --smart --stats

# 将 TONL 解码回 JSON
tonl decode data.tonl --out data.json

数据查询：

# 在 TONL 文件中查询特定条件
tonl query users.tonl "users[?(@.role == 'admin')]"

# 在 JSON 文件中获取特定字段
tonl get data.json "user.profile.email"

交互式统计面板 (推荐)：

# 启动交互式仪表盘，分析文件大小与 Token 节省情况
tonl stats data.json --interactive

# 指定主题风格 (neon, matrix, cyberpunk, default)
tonl stats data.json -i --theme neon

# 对比 JSON 与 TONL 的文件大小差异
tonl stats data.json --compare

格式化与验证：

# 美化输出 TONL 文件
tonl format data.tonl --pretty --out formatted.tonl

# 根据 Schema 验证数据
tonl validate users.tonl --schema users.schema.tonl