Containers

Bun (تجريبي)

Bun هو وقت تشغيل محلي اختياري لتشغيل TypeScript مباشرةً (bun run ...، bun --watch ...). يظل مدير الحزم الافتراضي هو pnpm، وهو مدعوم بالكامل وتستخدمه أدوات الوثائق. لا يستطيع Bun استخدام pnpm-lock.yaml وسيتجاهله.

التثبيت

  • Install dependencies

    bun install
    

    يتم تجاهل bun.lock / bun.lockb في git، لذلك لا يحدث أي تغيير زائد في المستودع. لتخطي كتابة ملف القفل بالكامل:

    bun install --no-save
    
  • Build and test

    bun run build
    bun run vitest run
    
  • سكربتات دورة الحياة

    يحظر Bun سكربتات دورة حياة الاعتماديات ما لم تُوثق صراحةً. في هذا المستودع، السكربتات التي تُحظر عادةً غير مطلوبة:

    • @whiskeysockets/baileys preinstall -- يتحقق من أن إصدار Node الرئيسي >= 20 (يستخدم OpenClaw افتراضيًا Node 24 ولا يزال يدعم Node 22 LTS، حاليًا 22.16+)
    • protobufjs postinstall -- يُصدر تحذيرات حول مخططات الإصدارات غير المتوافقة (لا توجد مخرجات بناء)

    إذا واجهت مشكلة وقت تشغيل تتطلب هذه السكربتات، فوثّقها صراحةً:

    bun pm trust @whiskeysockets/baileys protobufjs
    

    محاذير

    لا تزال بعض السكربتات تضع pnpm بشكل ثابت (مثلًا docs:build وui:* وprotocol:check). شغّلها عبر pnpm في الوقت الحالي.

    ذات صلة