Skip to the content.

fak — البداية السريعة: ذكاء اصطناعي محلي محكوم في نحو ١٠ دقائق

هذه صفحة دخول مُوطّنة (entry point)، وليست ترجمة كاملة للتوثيق. التوثيق الكامل بالإنجليزية — تمنحك هذه الصفحة جوهر fak، وإثبات الستين ثانية، ومسار التشغيل، ثم تُحيلك إلى مصدر الحقيقة الإنجليزي. تنبيه: هذه الصفحة مُولّدة آليًا وبانتظار مراجعة متحدّث أصلي — لأي تصحيح افتح issue أو PR. لغات أخرى ومداخل أخرى: مركز i18n.

الوعد

من الصفر إلى ذكاء اصطناعي محلي محكوم في نحو ١٠ دقائق: يعمل دون اتصال (offline)، دون مفتاح API، دون أي فاتورة سحابية، وبياناتك تبقى على جهازك. المعالج (CPU) وحده يكفي للنماذج الصغيرة — لا حاجة إلى GPU.

المسار الأسرع (أمر واحد)

غلّف وكيلك الحالي بنموذج محلي في أمر واحد — دون مفتاح، دون شبكة:

fak guard --gguf qwen2.5:7b -- claude

لا تُعيد كتابة وكيلك. إمّا توجّه base URL واحدًا إلى fak serve، أو تلفّ الوكيل القائم بالأمر أعلاه، فتمرّ كل tool call عبر أرضية الصلاحيات (capability floor) قبل أن تُنفَّذ.

إثبات في ٦٠ ثانية (دون مفتاح، دون نموذج، دون GPU)

go build -o fak ./cmd/fak
./fak preflight --policy examples/customer-support-readonly-policy.json --tool refund_payment --args "{}"   # -> DENY (POLICY_BLOCK)
./fak preflight --policy examples/customer-support-readonly-policy.json --tool search_kb     --args "{}"   # -> ALLOW
./fak agent --offline                                                                                       # injection مُوقَف، والمهمة تكتمل رغم ذلك

الحدّ الافتراضي هو الرفض (default-deny)، ويُفحَص داخل النواة على مسار الاستدعاء نفسه: فعلٌ ليس على قائمة السماح لا يمكن أن يُنفَّذ مهما جرى إقناع النموذج به — فشلٌ آمن (fail-closed)، لا انفتاح. وفي اختبارات حيّة، اخترق حقنُ الأوامر (prompt injection) خطَّ الأساس غير المحمي ٥ من ٥، بينما جدَره fak ٥ من ٥.

ما هو fak؟

fak ملفٌّ Go ثنائي واحد (static binary) يجلس بين وكيل الذكاء الاصطناعي والأدوات التي يستدعيها. يراجع كل tool call قبل تشغيله، ويعيد استخدام العمل المشترك المتكرر عبر الجلسة الطويلة — فتصبح نفس حلقة الوكيل أكثر أمانًا وأرخص وأسرع، دون إعادة كتابة.

كم هو أسرع؟ (بأمانة)

على جلسة مقيسة بـ ٥٠ دورة × ٥ وكلاء، الرقم الأمين هو ~4.1× عملٌ أقل مقابل مكدّس warm-cache مضبوط (tuned). أمّا رقم ~60× (نحو ١٩ ساعة إلى نحو ١٩ دقيقة) فصحيحٌ فقط مقابل النمط الساذج الذي يعيد إرسال كل شيء كل دورة — لا تقدّمه أبدًا كعنوان رئيسي؛ العنوان الأمين هو 4.1×. مكسب إعادة الاستخدام للاستضافة الذاتية فقط (self-host) وينطبق على الأساطيل كثيفة القراءة.

خصم التخزين المؤقت للمزوّد (prompt-cache) لا يصمد إلا إذا بقيت البادئة المخزّنة متطابقة بايتًا ببايت؛ يُسقط fak الأدوار الوسطى القديمة مع إبقاء البادئة متطابقة بايتيًا — وهذا ما يضمنه fak. أمّا استعمال المزوّد لذلك التخزين فقرارُه هو، وينقله fak دون أن يدّعيه.

لماذا يهمّ هذا في الخليج ومنطقة MENA

إلى أين تذهب بعد ذلك

License: Apache-2.0.