.toon · text/plain

TOON: Token-Oriented Object Notation(面向 Token 的物件表示法)

TOON 結合類 YAML 的巢狀物件縮排與類 CSV 的表格標頭(`items[N]{col1,col2}:`),徹底消除 LLM 提示詞中重複出現的 JSON 鍵名。

快速解答: TOON 結合類 YAML 的巢狀物件縮排與類 CSV 的表格標頭(`items[N]{col1,col2}:`),徹底消除 LLM 提示詞中重複出現的 JSON 鍵名。 傳送結構一致的 JSON 物件陣列給 GPT-5、Claude 4 或 Gemini 時,將 LLM 提示詞 Token 成本大省 30%–60%。

結構類型階層式
人類可讀性高
支援巢狀結構支援
LLM Token 效率高
副檔名.toon
MIME 類型text/plain
最適合用於傳送結構一致的 JSON 物件陣列給 GPT-5、Claude 4 或 Gemini 時,將 LLM 提示詞 Token 成本大省 30%–60%。

核心優勢

  • 在結構規整的記錄陣列上可降低 30%–60% 的 LLM 輸入 Token 消耗
  • 保留明確陣列長度與欄位宣告標頭,維持大模型讀取精準度
  • 可透過 @toon-format/toon 無損往返還原為具型別 JSON

限制與權衡

  • 較新的格式,尚未被瀏覽器標準 JSON API 原生解析
  • 鍵名極度不規則的異質陣列節省幅度不如統一結構顯著
  • 須在 LLM 輸入輸出邊界加入一步編碼與解碼轉換

參考資料

在本機轉換與清理 TOON

相關工程指南

TOON 常見問題

TOON 相比 JSON 究竟能省下多少 LLM Token?

對於資料庫查詢列、API 清單或商品目錄等結構一致的物件陣列,僅在標頭宣告一次欄位名通常能減少 35% 至 60% Token。

TOON 轉回 JSON 時會遺失資料型別嗎?

不會。字串、數字、布林值、null、巢狀物件與陣列皆能精準無損地還原為合法 JSON。

在 TOON 表格區塊中哪種分隔符號效果最好?

逗號最標準易讀;當數值包含空格或逗號時,在 o200k_base 分詞下改用定位字元 (\t) 或直線符號 (|) 還能多省一點 Token。