Documentation Index
Fetch the complete documentation index at: https://docs.wolffi.sh/llms.txt
Use this file to discover all available pages before exploring further.
فلسفة التصميم
هذه هي المبادئ التي تحكم كل قرار في Wolffish. يجب أن تتبعها التغييرات المستقبلية — بما في ذلك مساهمات المجتمع.Markdown هو المصدر الموثوق
كل قطعة من سلوك الوكيل تعيش في ملفات Markdown قابلة للقراءة البشرية: الشخصية (soul.md)، والإجراءات (agents.md)، وتعليمات المهارات (SKILL.md)، وأنماط الخطر، والذاكرة، وسجلات المهام، والملاحظات. لا يحتوي الكود أبدًا على آراء حول ما ينبغي أن يفعله الوكيل. هو فقط يقرأ Markdown ويعمل بناءً عليه.
هذا يعني أنه يمكنك قراءة دماغ وكيلك بالكامل باستخدام محرر نصوص، والتحكم في إصداراته باستخدام git، وتحرير السلوك دون إعادة بناء التطبيق، ومشاركة القدرات عبر مشاركة ملفات Markdown.
الكود هو مجرد أنابيب توصيل
وحدات وقت التشغيل الخمس عشرة هي كود تنسيق. تنقل البيانات بين ملفات Markdown ونموذج اللغة. لا تتخذ هي القرارات — نموذج اللغة هو من يتخذها بناءً على سياق Markdown الذي يتلقاه. الكود “الذكي” الوحيد هو مطابقة الكلمات المفتاحية في RAS (لتسجيل الصلة) ومطابقة التعابير النمطية في amygdala (لأنماط الأمان). كل شيء آخر هو إدخال/إخراج للملفات، وطلبات HTTP، وضم سلاسل نصية.استدعاء واحد لنموذج اللغة لكل رسالة
يقوم خطّ المعالجة بتجميع السياق قبل استدعاء نموذج اللغة، وليس باستدعائه عدة مرات. بناء السياق هو كود خالص — استعلامات SQLite، ومطابقة الكلمات المفتاحية، وقراءة الملفات. يُستدعى نموذج اللغة مرة واحدة مع السياق المُجمَّع. إذا استدعى نموذج اللغة أدوات، تعود النتائج إليه لاستدعاء آخر. لكن لا يوجد أبدًا استدعاء لنموذج اللغة من أجل “تحديد ما يجب البحث عنه” أو “تصنيف الرسالة”. هذه عمليات يقوم بها الكود.خطّ معالجة حتمي، ونموذج لغة مبدع
نفس المدخل يسلك نفس المسار عبر نفس البوابات في كل مرة. يقوم thalamus بالتوجيه، وRAS بالتقييم، وprefrontal بالتجميع، وamygdala بالبوابة. هذا حتمي. يضيف نموذج اللغة الإبداع والذكاء في نقطة محددة واحدة في خطّ المعالجة. البنية المحيطة به صارمة وقابلة للتنبؤ.محلي أولًا، معزَّز بالسحابة
التجربة الأساسية تعمل بنسبة 100% دون اتصال باستخدام نموذج Ollama محلي. مزودو السحابة (Claude وOpenAI) يحسّنون الجودة لكنهم ليسوا ضروريين أبدًا. الذاكرة، والمهارات، والملاحظات — كلها محلية. الاعتماد السحابي الوحيد هو استدعاءات واجهة برمجة تطبيقات نموذج اللغة، وهذه تتدرج إلى المحلي عند الفشل.القدرات مكتفية بذاتها
نواة وقت التشغيل لا تعرف شيئًا عن أدوات بعينها. الشل، نظام الملفات، git — كلها مجلدات قدرات في مساحة العمل. كل منها يحتوي على SKILL.md واختياريًا مجلد plugin/. يكتشفها cerebellum ويحمّلها. يمكنك حذف أي قدرة دون كسر النواة.احتفظ بكل شيء، ودَع الدمج يقرر
يحفظ hippocampus كل دور من المحادثة. يسجل basalganglia كل نتيجة أداة. يسجل corpus كل حدث. لا يُهمل شيء وقت الكتابة. مهمة الدمج الليلية في brainstem (المدعومة بنموذج لغة) هي التي تقرر ما يستحق الترقية إلى المعرفة طويلة المدى.ابنِ من أجل نماذج المستقبل الذكية
تفترض تعليمات Markdown نموذجًا ذكيًا يتبع التعليمات جيدًا. لا تضف حلولًا برمجية مؤقتة لسلوك نموذج غبي — حسّن Markdown بدلًا من ذلك. عندما تصبح النماذج أذكى، يتسع نهج “Markdown أولًا” بشكل طبيعي.مجلد واحد يحكمها جميعًا
كل شيء يلامسه Wolffish يعيش في~/.wolffish/. احذفه، يُعاد كل شيء إلى وضعه الأول. لا عمليات يتيمة، ولا تغييرات على مستوى النظام، ولا حالة متناثرة.