التنسيق القياسي للرسوم البيانية

في عام 2018، قمت بإنشاء نموذج شبكي لتحديد المجالات التي يجب أن أكرس وقتي لها ضمن مجتمع التكنولوجيا في ولاية أيوا. وتوسع النموذج ليشمل حوالي 10,000 عنصر — شركات، ومنظمات، وأشخاص، ومدن، وروابط. استخدمتُ «مركزية المتجه الذاتي» (eigenvector centrality) لإبراز العقد التي لم أكن متصلاً بها، والتي تتمتع بقدرة اتصال عالية في أماكن أخرى. وقد أثر ذلك على قرارات حقيقية: انضممتُ إلى مجلس إدارة TAI، واكتشفتُ مجتمعات لم أكن أعلم بوجودها، ورسمتُ خريطة لاختلافات الكثافة بين دي موين والنظم البيئية الساحلية.

ظل ذلك النموذج عالقًا في ذهني. على مدار السنوات التي قضيتها في شركة «Brale»، ظلت الرسوم البيانية للعلاقات الموجهة بالقوة تظهر باستمرار – حيث تُربط الجهات المصدرة بالأصول بالشبكات، وتربط مشغلي البرامج بسلاسل الكتل التي يعملون عليها. في كل مرة، يعيد شخص ما ابتكار اللغة البصرية. ماذا يعني اللون؟ ماذا يمثل الخط السميك؟ ما الشكل الذي يميز شركة عن شخص عن حدث؟ تُتخذ هذه القرارات من جديد في كل مشروع. ويضطر الشخص التالي الذي يفتح الرسم البياني إلى إجراء هندسة عكسية لكل ذلك قبل أن يتمكن من قراءة المحتوى.

في العام الماضي، قام «تنسيق العملة المستقرة المشتركة» (CSF) بتوحيد طريقة رسم تدفقات الأموال. ما عليك سوى لصق المواصفات في نموذج لغوي كبير (LLM)، وطلب تدفق أموال بتنسيق «stablecoin»، وسوف يتبع التنسيق في كل مرة. كنت أرغب في تحقيق الشيء نفسه بالنسبة لمخططات العلاقات. لذا قمت بكتابة «تنسيق المخططات القياسي» (Graphing Standard Format – GSF) – وهو قواعد نحوية صغيرة تحدد كيف يؤثر النوع على الشكل، وكيف يؤثر الوزن على الحجم، وكيف تتحكم مستويات الكثافة في ما يتم الكشف عنه.

هذه شبكتي، معروضة بتنسيق GSF:

الدوائر تمثل الأشخاص. المستطيلات المستديرة تمثل المؤسسات. المثلثات تمثل الأحداث – وهي تختلف عن الشركات التي تنظمها. الماسات تمثل الأماكن. السداسيات تمثل المفاهيم. الحبوب تمثل الأنظمة. انقر على أي عقدة لرؤية بطاقة ملفها الشخصي. قم بالتبديل إلى الوضع المتوسط لرؤية الألوان. لم تكن مضطرًا لاتخاذ أي قرار بشأن ذلك. فقد قامت GSF بذلك نيابة عنك.

إليك مقطع فيديو يوضح كيفية استخدام GSF لأول مرة. لقد أدى مهمته بشكل جيد جدًا!

GSF و CSF

كلاهما ينفذ نفس العناصر الأولية لطبقة القيم: ValueType، TransferType، Exchange. الخسارة الوحيدة عند الانتقال من CSF إلى GSF هي ترتيب التسلسل، لأن الرسوم البيانية غير زمنية.

المعيار

GSF القواعد الخاصة بالتصور – وليس التصور نفسه. وعند استخدامه، فهذا يعني أنك تحدد ما تريد عرضه، بينما يتولى التنسيق كيفية عرضه. ويظل الأساس متسقًا عبر جميع المشاريع.

ثلاثة أمور:

• GSF هي مجموعة القواعد. لا يتم تصورها أبدًا.
• مجموعة البيانات هي {view, nodes, links} مثال يتوافق مع GSF. وهذا هو ما يتم عرضه.
• يأخذ العارض القواعد بالإضافة إلى مجموعة البيانات ويرسم الصورة.

أربعة عناصر أساسية. كل ما يحتاجه مُصوِّر:

1. العلاقة – رابط بين كيانين بالضبط. الروابط تشكل الرسم البياني.
2. النوع – المصنف النوعي. يحدد الشكل واللون.
3. المتغيرات – حقيبة التفاصيل. تحتوي على كل ما لا يشمله النوع.
4. الوزن – المقياس الكمي. يحدد الحجم والعرض.

قاعدة الترميز: القيمة مقابل القيم. القيمة الكمية الواحدة (رقم، يُحمل في weight) تحدد الحجم والعرض. أما القيم النوعية (الفئة، الحالة، التسمية) فتحدد الشكل واللون والتجميع وما يظهر عند تمرير المؤشر فوق العنصر.

خيار تصميمي واحد يستحق الذكر: أنواع العلاقات عبارة عن سلاسل مفتوحة. لا توجد قائمة مغلقة. تحدد مجموعة البيانات الأنواع التي تحتاجها – يستخدم الرسم البياني أعلاه founder, cofounder, spinoutو operates، ولا يوجد أي منها في المواصفات. وقد تم عرضها بشكل جيد. تعمل GSF على إصلاح الترميز (كيفية تحويل الأنواع إلى أشكال وألوان)، وليس المفردات (الأنواع المسموح باستخدامها).

الكثافة

نفس مقياس CSF. مقدار التفاصيل والألوان التي يكشف عنها عارض البيانات:

• خفيف – أبيض وأسود. الشكل يرمز إلى النوع، ونمط الخط يرمز إلى فئة العلاقة (متصل = القيمة، متقطع = البيانات، منقط = مشتق)، والسماكة ترمز إلى المقدار، ورأس السهم يرمز إلى الاتجاه. بدون ألوان. جاهز للطباعة.
• متوسط – يضيف اللون كطبقة فوقية، ومفتاح توضيحي، ومتغيرات عند التمرير فوق العنصر.
• كثيف – السجل الكامل. جميع المتغيرات، ونقاط نهاية النقل، وإمكانيات التوسع.

قاعدة واحدة: يجب أن يُقرأ النمط الخفيف بالأسود والأبيض. اللون ليس أبدًا الإشارة الوحيدة.

التنسيق

يحتاج الرابط source, destination، و type. كل ما عدا ذلك اختياري:

{
  "format": "gsf",
  "version": "0.5.2",
  "renderer": "d3-force",
  "view": { "level": "light", "hops": 1, "focus": ["Person A"] },
  "links": [
    { "source": "Person A", "destination": "Person B", "type": "message" }
  ]
}

بالنسبة للرسوم البيانية ذات طبقة القيم، تحمل كائنات النقاط النهائية value_type و transfer_type على كل جانب. وعندما تختلف، فإن ذلك يشير إلى عملية تبادل – و via يحدد اسم المُبادِل:

{
  "format": "gsf",
  "version": "0.5.2",
  "renderer": "d3-force",
  "view": { "level": "heavy", "hops": 1, "focus": ["Brale"] },
  "nodes": [
    { "id": "Sender", "type": "org" },
    { "id": "Brale", "type": "org", "variables": { "sub_type": "exchange" } },
    { "id": "Recipient Wallet", "type": "system", "variables": { "sub_type": "wallet" } }
  ],
  "links": [
    {
      "source": { "id": "Sender", "value_type": "USD", "transfer_type": "wire" },
      "destination": { "id": "Recipient Wallet", "value_type": "USDC", "transfer_type": "solana" },
      "type": "transfers_via",
      "via": "Brale",
      "weight": 1000,
      "variables": { "exchange": "USD -> USDC", "rate": 1.0 }
    }
  ]
}

استخدامه

الصق ملف gsf-0.5.2.json في نموذج لغوي كبير (LLM) واطلب منه تحويل المادة المصدرية إلى مجموعة بيانات GSF. يتبع التنسيق في كل مرة – تمامًا مثل CSF. تم تصميم llm_instructions الكتلة الموجودة في المواصفات مصممة ليتم استهلاكها آليًا بشكل مباشر. تحقق من مستودع GSF للحصول على أحدث إصدار.

المعيار مفتوح المصدر: github.com/benmilne-com/standards/gsf. قم بإنشاء نسخة منه، واستخدمه، وساهم فيه.

الهيكل مجاني.