الانتقال إلى المحتوى الرئيسي

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 لأول مرة، يُنشئ مساحة العمل في ~/.wolffish/workspace/ وينسخ ملفات التكوين الافتراضية من القوالب المرفقة. إليك ما يُنشأ:

مساحة العمل

~/.wolffish/workspace/
└── brain/
    ├── identity/
    │   ├── soul.md          # شخصية الوكيل
    │   └── user.md          # ملفك الشخصي
    ├── prefrontal/
    │   └── agents.md        # إجراءات الوكيل وقواعد الأدوات
    ├── cerebellum/          # القدرات (shell, filesystem, git, إلخ)
    ├── hippocampus/         # الذاكرة (الحلقات، المُدمَجة، المعرفة)
    ├── motor/tasks/         # سجلات تنفيذ المهام
    ├── basalganglia/        # سجلات الملاحظات
    ├── brainstem/           # تكوين العمليات الخلفية
    ├── corpus/              # سجلات الأحداث
    ├── conversations/       # سجل الدردشة
    └── config.json          # تكوين التطبيق

خطوات الإعداد الأولي

  1. كشف Ollama — يتحقق Wolffish من تشغيل Ollama على localhost:11434. إن لم يجده، يرشدك خلال تثبيته.
  2. اختيار النموذج — اختر نموذجًا محليًا. يستطيع Wolffish تنزيل النماذج مباشرة إن لم تكن مثبتة.
  3. اختياري: مفاتيح API — اضبط مفاتيح Anthropic أو OpenAI في الإعدادات للحصول على ردود معزَّزة بالسحابة.

تخصيص وكيلك

بعد الإعداد الأولي، ستحتاج إلى تحرير ملفين:

user.md

أخبر Wolffish عن نفسك — اسمك، وتفضيلاتك، ومشاريعك، وحزمتك التقنية. كلما قدمت سياقًا أكثر، كانت ردود الوكيل أكثر صلة.

soul.md

عرّف شخصية الوكيل ونبرته وإرشادات سلوكه. هذه هي الشخصية التي يتقمصها الوكيل.

ما يحدث في كل تشغيل

بعد التشغيل الأول، كل تشغيل لاحق يقوم بما يلي:
  1. يقرأ config.json لإعدادات النموذج والمزود
  2. يهيّئ وحدات الدماغ الخمس عشرة عبر ناقل الأحداث (corpus)
  3. يفهرس ملفات Markdown في مساحة العمل ضمن cortex.db (SQLite FTS5)
  4. يبدأ العمليات الخلفية (مراقب الملفات، مجدول cron)
  5. يفحص صحة المزودين (Ollama، وواجهات السحابة إن كانت مُعدة)