JSON Toolkit

دليل صيغة TOON: خفّف JSON قبل إعطائه لنموذج لغوي

الخلاصة: عندما تمرّر مصفوفة متجانسة إلى نموذج لغوي بصيغة JSON، تستهلك أسماء المفاتيح المتكررة والأقواس توكنات. تعلن TOON البنية مرة واحدة عبر كائنات مسننة ومصفوفات جدولية، وتصبّ البيانات سطرًا بعد سطر. تُظهر المعايير الرسمية نحو 40% توكنات أقل مع دقة تحليل أعلى. يغطي هذا الدليل الصياغة، ومتى ينفع التوفير، ومتى لا يجدي التحويل، وكيفية ربط encode بـ decode.

متوسطقراءة نحو 6 دقيقةنُشر في 2026-11-10حُدِّث في 2026-11-10
صياغة المصفوفة الجدولية في TOON: رأس الحقول يُعلن مرة واحدة، وصفوف البيانات تُصبّ بالتتابع

العبء الصياغي لـ JSON لا يهم في النقل بين الآلات، لكنه في مدخل نموذج يُحاسَب بالتوكنات مال حقيقي: المصفوفة المتجانسة ذاتها تكرّر أسماء المفاتيح عشرات المرات، وكل قوس معقوف مع كل علامة تنصيص يقضم شريحة من الميزانية. TOON لا يخترع نموذج بيانات جديدًا — بل يعيد كتابة نموذج بيانات JSON بترميز أرخص.

ما هي TOON: ترميز آخر لـ JSON، لا منافس لها

TOON (Token-Oriented Object Notation) صيغة مفتوحة ظهرت عام 2025، وموقعها الرسمي يلملم في جملة واحدة: ترميز مضغوط بلا فقدان ومرئي لنموذج بيانات JSON. لا تُدخل أنواعًا جديدة — الكائنات والمصفوفات والسلاسل والأرقام والقيم المنطقية والقيمة null تقابل JSON واحدًا لواحد، وdecode(encode(x)) مساوٍ للبيانات الأصلية بدقة (الأنواع خارج JSON مثل Date أو NaN يجب تطبيعها أولًا). الذهاب والإياب بلا فقدان وحاسم: المدخل نفسه يعطي المخرج نفسه دائمًا، وهو أمر مهم لبناء أوامر قابلة لإعادة الإنتاج.

لأن TOON ترمّز نموذج بيانات JSON بالضبط، الاستخدام الصحيح لها هو صيغة حدودية: يواصل التطبيق عمله بـ JSON داخليًا، يتحول إلى TOON قبل وضع البيانات في الأمر مباشرةً، ويترجم ردًّا من النموذج. توثيقها الرسمي يسمي هذا "طبقة الترجمة". امتداد الملفات المتعارف عليه هو .toon؛ وللنقل عبر HTTP فإن الوسيط المؤقت هو text/toon، بترميز UTF-8.

تنبيه واحد عن ضجيج البحث: لا تخلط بينها وبين Toon Shader في رسوميات ثلاثية الأبعاد. المشترك كلمة واحدة.

لماذا JSON مكلف خصوصًا في مدخل النموذج اللغوي

خذ قائمة طلبات أو كشف مستخدمين أو ملخص سجلات مكتوبة كمصفوفة JSON. التوكنات تُصرف في ثلاثة مواضع:

  1. أسماء المفاتيح المتكررة. خمسون سجل طلب يكتبون "id" و"amount" و"status" خمسين مرة لكل واحد. ضاعف البيانات، يتضاعف العبء.
  2. علامات الترقيم البنيوية. الأقواس المعقوفة والمعقوفة المربعة والنقطتان والفواصل — كلها توكنات، والتداخل يحشرها أكثر إحكامًا.
  3. علامات التنصيص. كل مفتاح تقريبًا وكل قيمة سلسلة ملفوفة بعلامتي تنصيص مزدوجتين.

في المجموع: كلفة واجهة تُحاسَب بالتوكنات ترتفع مباشرةً؛ المدخلات الطويلة تصطدم بسقف نافذة السياق أبكر؛ وفي المدخلات الطويلة جدًا يُسقط النموذج الحقول أو يزيحها أكثر تواترًا. معيار الصفحة الرسمية: على مجموعة اختبار ببنى مختلطة وأربعة نماذج، نحو 40% توكنات أقل مع دقة تحليل ترتفع من 70% (JSON) إلى 74% (TOON). التوفير والدقة ليسا تبادلاً هنا، لأن البنية الأكثر إحكامًا تجعل الحدود أوضح أمام النموذج.

الصياغة: كائنات مسننة + مصفوفات جدولية

بيانات التنبؤ الجوي نفسها في ثلاث هيئات. نسخة JSON، نحو 117 توكن:

{
  "location": { "city": "Berlin", "country": "DE", "units": "metric" },
  "alerts": ["frost", "wind"],
  "forecast": [
    { "day": "Mon", "temp": { "min": -2, "max": 4 }, "condition": "snow", "rainChance": 80 },
    { "day": "Tue", "temp": { "min": 1, "max": 7 }, "condition": "cloudy", "rainChance": 20 },
    { "day": "Wed", "temp": { "min": 3, "max": 11 }, "condition": "sunny", "rainChance": 5 }
  ]
}

نسخة TOON، نحو 66 توكن:

location:
  city: Berlin
  country: DE
  units: metric
alerts[2]: frost,wind
forecast[3]{day,temp{min,max},condition,rainChance}:
  Mon,-2,4,snow,80
  Tue,1,7,cloudy,20
  Wed,3,11,sunny,5

ثلاث هيئات تغطي كل شيء، والمسلسِل يختارها آليًا وفق شكل البيانات:

الهيئة تناسب المكافئ في JSON
كائن مسنن كائنات متداخلة { "location": { ... } }، التسنن يحل محل الأقواس المعقوفة
مصفوفة سطرية مصفوفات قيم بدائية ["frost","wind"]، [2] تعلن الطول
مصفوفة جدولية مصفوفات كائنات متجانسة أسماء الحقول تظهر مرة واحدة في الرأس {day,temp{min,max},...}؛ وكل سطر لا يحوي إلا قيمًا مفصولة بفواصل

الكائنات المتداخلة المتجانسة (temp{min,max}) تُطوى في الرأس كمجموعة حقول متداخلة، وتبقى صفوف البيانات مسطحة. قاعدة التنصيص دنيا: السلاسل لا تنصَّص إلا إذا احوت فواصل أو محارف خاصة أو خُشيت قراءتها أرقامًا — أحد أسباب تفوق TOON على «JSON المضغوط» في عدّ التوكنات. الفارق الجوهري مع YAML: TOON تملك تعريفات طول صريحة ورؤوس حقول يمكن للآلة التحقق منها؛ ومع CSV: تحفظ التداخل والأنواع.

[N] و{fields}: درابزين بنيوي للنموذج

[3] و{day,...} ليستا لتوفير التوكنات فحسب — بل هما عقد قابل للتحقق تسلّمه للنموذج:

  • طول المصفوفة يمكّن النموذج من الإجابة الفورية عن «كم سجلًا في مجموعة البيانات» ويكشف الاقتطاع فورًا حين لا يتطابق عدد الأسطر.
  • رأس الحقول يعلن الأسماء مرة واحدة؛ والنموذج يصفّ القيم بالموضع بدل إعادة تخمين تطابق المفاتيح في كل سطر.

هذا وقاية، عكس الإصلاح بعد الوقوع. أداة إصلاح JSON (انظر دليل الإصلاح) تنقذ البيانات بعد أن يقذف النموذج JSON تالفًا؛ تعريفا الطول والحقول في TOON يخفضان في المدخل احتمال البيانات التالفة. افعل الاثنين معًا — ينخفض معدل فشل التحليل في منتصف الخط.

متى لا تستخدم TOON

قسمها الرسمي «When Not to Use TOON» صريح بدهشة. أربعة سيناريوهات، اتركها كما هي:

السيناريو لماذا نتجنبه الخيار الأفضل
بنى متداخلة بعمق وغير متجانسة الأهلية الجدولية ≈ 0%؛ JSON المضغوط يغلب غالبًا JSON مضغوط
مصفوفات شبه متجانسة حقول غير منتظمة، يتبخر التوفير أبقِ خط JSON كما هو
بيانات جدولية صرفة TOON يحمّل 5–10% عبئًا مقابل CSV CSV
حساسة للتأخير (نماذج محلية/مكمّاة) توكنات أقل ≠ استدلال أسرع قِس TTFT أولًا

تُقاس شبه التجانس بالأهلية الجدولية (tabular eligibility): رسميًا، عند أهلية 40–60% يكون التوفير هامشيًا فعلًا. للهجرة بين الصيغ كلفة حقيقية — المحللات والمتحققون والسكربتات اللاحقة تتغير جميعها — فإن كان الربح دون عشرة بالمئة فلا تلمس شيئًا.

التطبيق: encode / decode وأداة CLI

المكتبة الرسمية بـ TypeScript، في الاتجاهين:

npm install @toon-format/toon
# التحويل الدفعي يمر عبر CLI أيضًا
npx @toon-format/cli input.json -o output.toon
import { encode, decode } from '@toon-format/toon'

const data = {
  users: [
    { id: 1, name: 'Ada', role: 'admin' },
    { id: 2, name: 'Bob', role: 'user' },
  ],
}

const toon = encode(data)
// users[2]{id,name,role}:
//   1,Ada,admin
//   2,Bob,user

const back = decode(toon)  // مساوٍ للبيانات الأصلية بدقة

توجد تطبيقات بـ Python وGo وRust و.NET؛ قبل اختيار أحدها راجع قائمة التطبيقات في المستودع الرسمي للمواصفة وتأكد أنها تغطي الميزات الصياغية التي تستخدمها. قبل الإنتاج نفّذ تأكيد الذهاب والإياب: يجب أن يكون decode(encode(الأصل)) مساوٍ للأصل بعمق؛ وإلا فالعلة في التطبيق أو في البيانات.

كيف ينحشر في خط JSON القائم لديك

TOON لا يغير شيئًا في خط JSON لديك؛ يضيف تحويلًا حدّيًا. الترتيب الموصى به:

  1. تأكد أولًا أن JSON نظيف. JSON تالف يعطي TOON تالفًا. التحقق الصياغي والإصلاح مغطيان في دليل إصلاح JSON.
  2. افحص شكل البيانات. هل لكل كائنات المصفوفة الحقول نفسها؟ طبّع أولًا — أو اعترف أن التحويل لا يستحق العناء.
  3. حوّل ثم عيّن عينات. بعد التحويل قارن بضعة أسطر مع JSON الأصلي للتأكد أن صف الحقول لم ينزلق.
  4. قيّم النفع. للقوائم المتجانسة ينطبق استدلال سطرًا بسطر من دليل JSONL على التحويل الجاري؛ أما عن نسبة الحجم إلى الكلفة فيمنحك العلاقة الحقيقية بين JSON minify وgzip الدرس نفسه: قِس أولًا، ثم حوّل.

هل ستستبدل TOON الـ JSON؟

لا. TOON ترمّز نموذج بيانات JSON؛ مكانها حدّ الأمر، بينما يبقى التخزين والتبادل بين البرامج إقليم JSON. استخدمها لشريحة «الإعطاء للنموذج» واترك بقية السلسلة سليمة.

ما علاقة TOON بـ YAML وCSV؟

الكائنات تشبه YAML (تسنن بدل الأقواس المعقوفة)؛ والمصفوفات المتجانسة تشبه CSV (رأس يعلن مرة، وصفوف تجري). لكن TOON تملك تعريفات طول صريحة لا في YAML، وتحفظ تداخلًا وأنواعًا لا في CSV — هي واقفة بين الاثنين، بدرابزين تتحقق منه الآلة.

هل يفقد التحويل من TOON إلى JSON بيانات؟

لا: الكائنات والمصفوفات والسلاسل والأرقام والقيم المنطقية وnull تقابل واحدًا لواحد، وdecode(encode(x)) مساوٍ للأصل بدقة. تنبيه واحد — طبّع أولًا الأنواع خارج JSON مثل Date وNaN؛ وإلا فالتساوي لا يسري إلا بعد الذهاب والإياب.

كيف أتحقق من صحة TOON المُحوَّل؟

تحققان: تأكيد الذهاب والإياب (ترميز ثم فك، وتساوٍ عميق مع الأصل) وفحص الرأس بالنظر — يجب أن يساوي عدد [N] عدد الأسطر، وأن تصطف حقول {fields} واحدًا لواحد مع القيم المفصولة بفواصل في كل سطر. وفي جانب النموذج يمكنك أن تطلب منه إبلاغ طول المصفوفة قبل الإجابة.