مقالات معمّقة حول التكنولوجيا التي تشكّل المستقبل.

libghostty 1.0: دروس في تصميم واجهة C ABI مستقرة

يوضح libghostty 1.0 كيف تصمم واجهة C ABI مستقرة: مقابض معتمة، ومُعدِّلات بمفاتيح تعدادية، وإصدارات رموز يفرضها CI، وبنية تبدأ من المكتبة.

رسم توضيحي لنواة مضيئة واحدة مشتركة تشغّل شاشات كثيرة شبيهة بالطرفية، متصلة بخيوط من الضوء.
نواة محاكاة واحدة بوجوه كثيرة: libghostty تعمل اليوم داخل بيئات التطوير المتكاملة والمحررات وواجهات الطرفية النصية والطرفيات الجديدة على حد سواء.

تخيّل أنك في الفريق المسؤول عن الطرفية داخل بيئات JetBrains. محاكي الطرفية الخاص بكم، JediTerm، به خلل من النوع الذي تتخصص فيه محاكيات الطرفية، إذ تظهر تسلسلات هروب غامضة بشكل خاطئ ويصعب استنساخ الخلل بشكل مُحبط. يمكنك إصلاحه. أو يمكنك حذف عقد من كود المحاكاة المتراكم وربط المشروع بمكتبة C ذات واجهة ABI مستقرة، يصونها شخص آخر ويختبرها ويطوّعها لتعمل على تسعة أنظمة تشغيل. اختارت JetBrains الخيار الثاني. كل مستخدم لـ IntelliJ وPyCharm وGoLand، أي أكثر من 12.5 مليون مستخدم نشط حسب تقرير JetBrains نفسها، يعمل الآن على طرفية مدعومة بـ libghostty، التي وصلت إلى الإصدار 1.0 هذا الأسبوع.

هذا هو الرقم الأبرز، لكن القصة الأهم تكمن تحته. libghostty هي نواة محاكاة الطرفية المستخرجة من Ghostty، طرفية Mitchell Hashimoto المعتمدة على تسريع معالج الرسوميات، وقد أُصدرت كمكتبة C مستقلة مع سياسة صارمة لاستقرار ABI. قبل عام لم تكن لها واجهة C ولا سوى مستهلك واحد. أما اليوم فلديها إصدار 1.0 موسوم، وحزم جاهزة للتوزيع، وقائمة تبنٍّ تضم أبرز أدوات المطورين. والطريق من «تطبيق يحوي تفاصيل داخلية» إلى «مكتبة تثق بها الصناعة» درس في الانضباط الهندسي يتجاوز الطرفيات بكثير.

من التطبيق إلى المكتبة: كيف استُخرجت libghostty

محاكاة الطرفية من تلك المجالات التي تبدو سهلة من بعيد، لكنها قاسية بهدوء عند الاقتراب. عقود من تسلسلات الهروب، وبروتوكولات رسوميات متنافسة، وتجميع الحروف الموحدة (Unicode grapheme clustering)، وإعادة تنسيق سجل التمرير عند تغيير الحجم، كلها ألغام يكتشفها كل مؤلف طرفية من جديد. سبق أن كتبت عن كيفية عمل الطرفيات الحديثة المعتمدة على تسريع معالج الرسوميات، من تحليل TTY إلى أطالس الرموز، والفكرة المتكررة هي أن طبقة المحاكاة هي المكان الذي تذهب فيه الصحة البرمجية لتموت. إنها الشيفرة التي تريد كتابتها مرة واحدة واختبارها حتى الإنهاك ثم مشاركتها.

يبدو أن مؤلف Ghostty أدرك ذلك منذ البداية. كُتب التطبيق بلغة Zig مع بنية لنواة المحاكاة تسمح بفصلها، أولاً كوحدة Zig، ثم خلف واجهة C، والآن كـ libghostty-vt 1.0 بدورة إصدار خاصة وحزم خاصة ومستهلكين خاصين. لم يكن الاستخراج فكرة متأخرة ولا حركة تسويقية؛ فقد أعلن المشروع النية قبل أكثر من عام من وجود واجهة C، ثم أمضى ذلك العام في جعل الحد الفاصل حقيقياً. ترتيب الخطوات مهم: لم تُرفع المكتبة إلى 1.0 حين اشتغل الكود، بل حين أصبح العقد المحيط بالكود مستقراً بما يكفي لتقديم وعود بشأنه.

تشير قائمة المستهلكين إلى أن الرهان نجح. لدى Neovim طلب دمج معتمد يستبدل libvterm بـ libghostty-vt، وهو تغيير يغلق مشكلة عمرها عشر سنوات تتعلق بإعادة تنسيق سجل التمرير عند تغيير الحجم، وهذا يوضح كم تبقى هذه الجروح مفتوحة حين يحتفظ كل مشروع بمحاكيه الخاص. ويعمل مطورو KDE على نموذج أولي لخليفة Konsole باستخدامها. ويستخدمها Turborepo من Vercel لعرض مخرجات المهام. واستخدمها Antithesis لاختبار برامج TUI بشكل عشوائي، فكشفت عن أخطاء حقيقية في btop. وبنى أحدهم طرفية لـ Emacs عليها، وهناك بناء WebAssembly بواجهة متوافقة مع xterm.js. وتوجد روابط مجتمعية للغات Rust وGo وJavaScript وSwift وPython وNET. وElixir وDart وJava.

تصميم واجهة C ABI مستقرة: مقابض معتمة ومفاتيح تعدادية

هذا هو الجزء الذي تستحق سرقته لمشاريعك. تفشل معظم مكتبات C في البقاء طويلاً ليس لأن الكود يتعفن، بل لأن ABI يتكلس: تكتسب البنية حقلاً جديداً فيحتاج كل مستهلك إلى إعادة الترجمة، أو يتغير توقيع دالة فتختفي الرموز، أو يكبر التعداد فتتغير قيمه. تصميم libghostty درس مكثف في تجنب الثلاثة، والتقنيات مجرّبة وقديمة وقلما تُستخدم بالقدر الكافي.

/* The clunky way: the struct IS the ABI.
* Add a field and every consumer recompiles or corrupts memory. */
typedef struct {
int rows;
int cols;
int scrollback_limit;
/* ... forty more fields your ABI now depends on forever */
} term_config_t;
/* The libghostty way: an opaque handle plus enum-keyed access.
* The library can add a hundred new settings without one new symbol. */
typedef struct ghostty_terminal_s ghostty_terminal_t;
typedef enum {
GHOSTTY_TERMINAL_ROWS,
GHOSTTY_TERMINAL_COLS,
GHOSTTY_TERMINAL_SCROLLBACK_LIMIT,
/* new keys append here, forever */
} ghostty_terminal_key_t;
ghostty_result_t ghostty_terminal_get(
const ghostty_terminal_t *terminal,
ghostty_terminal_key_t key,
void *out);
ghostty_result_t ghostty_terminal_set(
ghostty_terminal_t *terminal,
ghostty_terminal_key_t key,
const void *value);

ثلاثة قرارات تحمل العبء الأكبر. أولاً، كل كائن مقبض معتم: المستدعي يحمل مؤشرات لا بنى، فتستطيع المكتبة إعادة تشكيل أحشائها بحرية بين الإصدارات. ثانياً، تعيش عشرات القيم القابلة للقراءة والكتابة خلف مجموعة صغيرة من دوال الجلب والتعيين المعتمدة على تعداد. الوظيفة الجديدة تعني ثابت تعداد جديداً، لا رمزاً مُصدَّراً جديداً، وأي برنامج بُني بترويسات أحدث لكنه يعمل مع مكتبة أقدم سيحصل على نتيجة نظيفة هي GHOSTTY_UNSUPPORTED بدلاً من عطل أو بيانات عشوائية. هذا التفصيل وحده هو الفرق بين التدهور الرشيق وخطأ segfault في الثالثة فجراً داخل منتج شخص آخر.

ثالثاً، البنى القليلة المتاحة للعامة تحمل حجمها الخاص أو تحجز حشواً، فيمكن إلحاق الحقول دون كسر التخطيط، وهي الحيلة نفسها التي استخدمتها sockaddr وواجهة Win32 لعقود. التعدادات مثبتة على int في كل مترجم، بقدر ما يسمح به معيار C، لأن التعداد الذي يتغير نوعه الأساسي بين المترجمات قنبلة موقوتة في ABI. لا شيء من هذا غريب، لكنه يُفعل فقط حين تقرر، من اليوم الأول، أن ABI ميزة في المنتج لا مصادفة ناتجة عن تخطيط الكود الحالي. وهذه هي فجوة المواصفة والتنفيذ في أنقى صورها: الـ ABI هو المواصفة، وكل ما عداه قابل للتفاوض.

  • مقابض معتمة لكل شيء. المستدعي لا يرى التخطيط، لذا يبقى التخطيط حراً في التغير.
  • دوال جلب وتعيين بمفاتيح تعدادية. الإعدادات الجديدة ثوابت جديدة لا رموز جديدة، والمكتبات القديمة تجيب بـ GHOSTTY_UNSUPPORTED بدلاً من الانهيار.
  • بنى عامة تحدد حجمها بنفسها. حقل struct_size يتيح إلحاق حقول لاحقاً، والحشو المحجوز يوفر مساحة مستقبلية.
  • أنواع تعداد مثبتة. التعدادات ثابتة على int حتى لا يتغير ABI بين المترجمات.
  • رموز مُصدَّرة بإصدارات على ELF. يرفض المحمّل الديناميكي المكتبة غير المتطابقة بالاسم، وبصوت عالٍ، وقت التحميل، لا بشكل غامض أثناء التشغيل.

فرض استقرار ABI في CI لا بحسن النية

كل مشروع يدّعي التوافق الخلفي، ونادراً ما يستطيع إثبات ذلك في يوم ثلاثاء عادي. يشغّل CI في libghostty أداة libabigail مقابل خط أساس محفوظ على لينكس، ويفحص كل تغيير بحثاً عن انحراف ABI، ويقارن بيانات الأنواع المرجعية على macOS وWebAssembly. الرموز المُصدَّرة على منصات ELF مُرقَّمة بالإصدارات، فيصبح المحمّل نفسه آلية فرض. الوعد لا يُصان بمراجعة الكود والحذر، بل بآلات تُفشل البناء حين يخطئ إنسان.

الـ ABI ليس عقداً توقّعه مرة واحدة. إنه وعد يجب أن يحافظ عليه CI في كل التزام.

هذا هو الجزء الذي أحث كل مؤلف مكتبة على نسخه أولاً، قبل أي تصميم للواجهة. فالفحص الآلي للـ ABI رخيص الإعداد، وأداة abidiff من libabigail أداة واحدة، وهو يحوّل وعداً اجتماعياً غامضاً («نحاول ألا نكسر الأشياء») إلى أثر صارم قابل للمراجعة («هذا خط الأساس، وهذا الفرق، وهذا التغيير متوافق أو غير متوافق»). والتوزيعات التي تقرر تضمين مكتبتك، والشركات التي تقرر ربطها ديناميكياً، تقيّم فعلياً ذلك الأثر. وسبب انتظار مشرفي Neovim لإصدار موسوم قبل الدمج ليس طقساً شكلياً، بل لأن التوزيعات تحتاج إلى تبعية مُرقَّمة قابلة للتغليف بشكل منفصل مع قصة توافق يمكنها الدفاع عنها.

حارس يقيس جسراً حجرياً عند مدخله، ويتحقق منه قبل السماح بالمرور.
استقرار ABI مفروض كنقطة تفتيش: كل تغيير يُقاس مقابل خط الأساس قبل أن يعبر.

التغليف والترخيص: العمل الممل الذي يوصل المكتبات إلى المستخدمين

اسأل أي مسؤول توزيع عما يقتل فرص مكتبة ما، ونادراً ما سيقول «الكود». بل هو البناء الذي لا يحترم --prefix أو DESTDIR، أو SONAME المفقود، أو التبعيات المضمّنة ذات التراخيص غير الواضحة، أو الأرشيف الذي لا يُبنى دون اتصال. تعامل libghostty 1.0 مع كل هذا كسطح إصدار: أرشيفات مصدر موقعة، وأرشيف تبعيات مرفق بتخطيط ذاكرة التخزين المؤقت الخاص بـ Zig للبناء الكامل دون اتصال، وSONAMEs صحيحة، وملفات pkg-config، وإعدادات حزم CMake، ومعلومات التصحيح محفوظة افتراضياً كي تتمكن التوزيعات من إزالتها. يوجد ملف PACKAGING-LIBGHOSTTY.md يُشحن داخل الأرشيف، مكتوب للمُغلِّف لا للمستخدم النهائي.

الترخيص نال المعاملة نفسها، وهو أكثر استراتيجية مما يبدو. المكتبة مرخّصة بموجب MIT، ولا تحتاج شيئاً سوى libc وقت التشغيل (ويمكن بناؤها بدون حتى ذلك)، وتترجم مع حفنة من التبعيات مرخّصة بشكل تساهلي: simdutf وGoogle Highway لعمليات SIMD، وجدول Unicode مضغوط، وWuffs لفك ترميز رسوميات Kitty، وكلها تُبنى دون libc++ فلا توجد تبعية على مكتبة C++ القياسية. لا يوجد أي ترخيص copyleft في الشجرة كلها. كل تبعية مدرجة في بيان قابل للقراءة الآلية يتضمن الإصدار وترخيص SPDX والتجزئة، تحديداً لكي تتمكن التوزيعات من ملء بيانات المكتبات المضمّنة دون تنقيب. وهناك حتى علم بناء لربط simdutf أو Highway من النظام ديناميكياً بدلاً من ذلك.

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

المنصات كوعود للواجهة البرمجية: القابلية للنقل وضبط الموارد

تغطي مصفوفة المنصات المختبَرة لينكس (glibc وmusl)، وmacOS، وiOS، وFreeBSD، وWindows، وAndroid، وWebAssembly المستقل، مع مستوى ثانٍ يشمل RISC-V بدون نظام تشغيل وARM thumb وWASI وWindows ARM64 وillumos وx86 بقالب 32 بت، وهو يُبنى في CI لكنه لا يشغّل الاختبارات بعد. تحصل كل منصة على الملفات التي يتوقعها نظامها البيئي: ملفات dylib مع @rpath وXCFrameworks لأبل، وملف DLL مع PDB ومكتبة استيراد لـ Windows (مع التحقق من الربط بـ MSVC في CI)، وبناء Android بحجم صفحة 16 كيلوبايت لأندرويد 15 فما فوق، ووحدة WASM أقل من ميغابايت مع تفعيل كل الميزات، وهي قابلة للتقليص بحذف أنظمة فرعية مثل البحث والتحديد وrasterization الخاصة بـ Kitty، مع بقاء كل دالة مُصدَّرة وإعادتها لـ GHOSTTY_UNSUPPORTED، فلا يحتاج كود المضيف إلى أي تعديل.

لكن قصة القابلية للنقل التي أعود إليها دائماً سلوكية. المكتبة لا تنشئ خيوطاً، ولا تخصص ذاكرة إلا عبر مخصص تذكره أنت. ذكر المؤلف أنه شغّل 10,000 طرفية حية، يشغّل كل منها صدفة حقيقية تنتج مخرجات، على خادم لينكس بمعالج رباعي النوى وذاكرة 8 غيغابايت، ولاحظ أن الاختناق كان في شهية bash للذاكرة لا في المكتبة، فاضطر إلى التحول إلى dash كي تتسع الصدفات في الذاكرة بينما تعمل libghostty-vt بسلاسة. «نحن لا ننشئ خيوطاً» و«نحن لا نمتلك مخصصك» وعدان للواجهة البرمجية حقيقيان بقدر أي توقيع دالة، وهما ما يجعل المكتبة قابلة للتضمين في سياقات مثل محركات الألعاب والأجهزة المدمجة وأدوات الاختبار العشوائي وحلقات الأحداث الخاصة بالآخرين، حيث ستكون تبعية كثيرة الخيوط عائقاً قاتلاً.

ماذا تعلّمنا libghostty عن البنية التي تبدأ من المكتبة

المقارنة الواضحة هي libvte، مكتبة المحاكاة المرتبطة بـ GTK والكامنة تحت طرفية GNOME وطرفية XFCE ونصف دزينة غيرها. أثبتت libvte النموذج منذ سنوات، أي نواة مشتركة واحدة وأغلفة رقيقة كثيرة، لكن ارتباطها بـ GTK حصر عالمها في سطح مكتب لينكس بأداة واحدة محددة. رهان libghostty أن النموذج نفسه، إذا فُصل عن أي أداة واجهة واشتُد في واجهة C ثابتة، يذهب أبعد بكثير: إلى بيئات تطوير مكتوبة بـ Java، ومحررات مكتوبة بـ C، وواجهات TUI مكتوبة بـ Go، ومتصفحات عبر WASM، ومنتجات تجارية لم تكن لتشحن تبعية GTK أبداً. والأدلة الأولية تقول إن الرهان صائب. عدد من يستخدمون طرفية مدعومة بـ libghostty يفوق بكثير عدد من يستخدمون Ghostty نفسه، بأضعاف كبيرة.

الدرس الأعمق يتعلق بالتسلسل. البنية التي تبدأ من المكتبة لا تعني كتابة مكتبة قبل أن تكون لديك حالة استخدام، فهذا طريق إلى تجريدات جميلة لا يحتاجها أحد. فعلت Ghostty العكس: بنت تطبيقاً حقيقياً، وتركت حدود المجالات تظهر تحت ضغط الإنتاج، ثم قوّت الفاصل الذي كانت تصونه طوال الوقت. وصلت واجهة C متأخرة، ولهذا بالضبط وصلت نظيفة. إذا كنت تملك تطبيقاً يحوي نواة قابلة لإعادة الاستخدام وصعبة حقاً، مثل محلل أو محاكٍ أو محرك تخطيط أو مكدس بروتوكولات، فالدليل واضح هنا: اجعل الحد الفاصل صادقاً منذ البداية، واعرضه عبر أضيق عقد ممكن، وضع الـ ABI تحت مراقبة CI، ونفّذ عمل التغليف الممل بجدية. تتراكم آثار النظام البيئي من هنا. كل خطأ يبلغ عنه مضمّن يحسّن طرفية كل مستهلك آخر، وكل بروتوكول جديد يصل إلى كل مكان في وقت واحد بدلاً من أن يتفتت بين عشرات الفروع الخاصة.

يقول Hashimoto إنه يمكنك الآن بناء طرفية في نحو 1,500 سطر من C تتفوق في ميزاتها على أغلب ما كان موجوداً قبل عام. هذه عبارة كنت سأصنفها عادةً ضمن حماس المشرفين، لكن مئة مشروع متتبَّع وأسطول IDE الكامل من JetBrains يوحيان بأن الادعاء يصمد أمام الواقع. ربما بدأ عصر كل تطبيق يبني محاكي الطرفية بيده في الانتهاء، وانتهى كما تنتهي هذه الأمور عادةً: ليس بتطبيق أفضل، بل بمكتبة أفضل.