TOON 协议与 AIDotNet.Toon 实践指南
内容提要
TOON 是一种高效的序列化格式，通常比 JSON 节省 30-60% 的 tokens。它通过简化语法、减少冗余和使用缩进结构来优化数据表示，适合均匀对象数组，但对于深度嵌套数据，JSON 可能更高效。TOON 在 .NET 中提供了易用的 API。
延伸解读
TOON 的优势与适用场景
TOON 格式在处理均匀对象数组时表现出色，通常能节省 30-60% 的 tokens。这使得 TOON 特别适合需要高效数据传输的场景，如大规模数据处理和机器学习输入。对于字段重复较多的情况，TOON 的简化语法也能显著提高效率。
TOON 与 JSON 的比较
虽然 TOON 在节省 tokens 方面表现优异，但在处理深度嵌套或非均匀结构的数据时，JSON 可能更为高效。因此，在选择使用 TOON 还是 JSON 时，开发者应根据数据结构的复杂性进行评估，以确保选择最合适的序列化格式。
AIDotNet.Toon 的使用便捷性
AIDotNet.Toon 提供了与 System.Text.Json 一致的 API，使得 .NET 开发者能够轻松上手。通过 NuGet 安装和简单的代码示例，开发者可以快速实现 TOON 的序列化与反序列化，降低了学习成本，提升了开发效率。
Q&A
TOON 协议的主要特点是什么？
TOON 协议的主要特点包括高效的 token 使用、简化的语法、基于缩进的结构和表格数组等。
TOON 与 JSON 的主要区别是什么？
TOON 通常比 JSON 节省 30-60% 的 tokens，适合均匀对象数组，而 JSON 更适合深度嵌套和非均匀数据。
如何在 .NET 中使用 AIDotNet.Toon 库？
可以通过 NuGet 或源码引入 AIDotNet.Toon 库，并使用 C#.ToonSerializer 提供的 API 进行序列化和反序列化。
TOON 协议适合哪些数据结构？
TOON 协议适合均匀对象数组和字段重复较多的场景，但对于深度嵌套或非均匀结构的数据，JSON 可能更高效。
TOON 的语法速查提供了哪些示例？
TOON 的语法速查提供了对象、嵌套对象、行内原子数组和表格数组等多种示例，展示如何表示不同的数据结构。
如何处理 TOON 的解码错误？
TOON 统一抛出 C#.ToonFormatException，包含错误分类与位置信息，帮助定位解码错误。
