Skip to main content

​
دماغ وكيلك على القرص

كل ما يعرفه وولفيش ويتذكره ويستطيع فعله يعيش في ~/.wolffish/workspace/. هذا هو دماغ وكيلك على القرص — قابل للقراءة، وقابل للتحرير، وقابل لإدارة الإصدار بـ git.

​
بنية المجلد

​
المبادئ الرئيسية

الملفات هي الحقيقة، وcortex.db ذاكرة مخبأة. تفهرس قاعدة بيانات SQLite كل ما سبق — الحلقات، والمعرفة، والمحادثات (كل رسالة وكل استدعاء أداة)، وتشغيلات المهام، والملاحظات، والاستخدام، والسجلات، والبيانات الوصفية للمخرجات — وهي قابلة للتخلص بالكامل: احذفها وسيُعيد وولفيش بناءها من الملفات المصدر. التشغيل العادي يحدّثها عبر فرق تزايدي على mtime/الحجم (~22 مللي ثانية)؛ ولا تحدث إعادة البناء الكاملة إلا عند ارتفاع رقم إصدار مخطط الفهرس (~1.3 ثانية لمساحة عمل بحجم 2GB)، وليس عند كل تشغيل. لا تحرّر cortex.db مباشرة أبدًا — حرّر الملفات المصدر بدلًا من ذلك. ملفات يومية بدل ملفات تنمو بلا توقف. الحلقات والملاحظات وسجلات الأحداث مقسَّمة حسب اليوم (YYYY-MM-DD.md). هذا يبقي الملفات الفردية صغيرة، ويسهّل تصفحها، ويتيح لـ brainstem تنظيف السجلات القديمة تلقائيًا. القدرات مكتفية بذاتها. كل مجلد تحت brain/cerebellum/ هو قدرة كاملة. يمكنك حذف أي منها دون التأثير على النظام الأساسي. يمكنك إضافة قدرات جديدة بإسقاط مجلد.

​
فحص مساحة العمل

يتضمن وولفيش عارض ملفات ومحرر Markdown مدمجَين — يمكنك تصفح وتعديل مساحة العمل بالكامل دون مغادرة التطبيق. لمعظم الحالات، هذا كل ما تحتاجه. يمكنك أيضًا فتح ~/.wolffish/workspace/ في أي محرر خارجي إذا فضّلت ذلك. بعض الأشياء المفيدة للفحص:

​
رقاقات المجلّدات الملموسة

على الحافّة العليا من نصّ المحادثة شريطُ رقاقات مجلّدات — كلُّ مجلّدٍ غيّرت المحادثةُ فيه ملفّات، وكم. وكلُّ رقاقةٍ على نقرةٍ من الفتح على سطح مكتبك، وتجيب سؤالاً واحداً: أين عمل هذا الدور؟ ومنذ الإصدار 1.0.309 ينطوي كلُّ مجلّدٍ ملموس إلى مجلّد المشروع الذي يفتح شجرته، والعدّاتُ تُجمع عبر كلّ ما تحته:
  • في محادثةٍ بلا مجلّد عملٍ محدَّد، كانت كلُّ رقاقةٍ تُسمّى بـطرف المسار الذي لمسه الدور — فـ…/wolffish-app/.github/workflows/ci.yml يُنتج رقاقةً تقرأ workflows — فكانت المجلّدات التي عملتَ فيها فعلاً غير مرئيّة.
  • والأسوأ أنّ عملاً يمتدّ على مشروعين مبنيَّين بالطريقة نفسها كان يضع رقاقتين اسمُ كلٍّ منهما src على الشريط، فوق شيفرتين مختلفتين، دون ما يميّز إحداهما عن الأخرى. والآن تقرأ الرقاقاتُ wolffish-app وwolffish-cloud.
  • والمسحُ يجري بالحدّ الأقصى أولاً — أوّل src أو lib أو test أو docs أو مجلّدٍ بنقطةٍ في المسار — بينما تُعبَر الحاوياتُ مثل apps مباشرةً، فيُحسَب سطحُ مكتب السحابة desktop لا apps عامّاً، وينطوي مجلّدُ .github في مشروعه بدل أن يطالب برقاقةٍ خاصّةٍ به.
  • والمساراتُ خارج مجلّدات العمل تحتفظ برقاقةٍ خاصّةٍ بها، وملفٌّ غُيِّر مباشرةً في مجلّد العمل ما زال يُحسَبه.

​
التحكم في الإصدار

يمكنك تنفيذ git init على مجلد مساحة العمل لإدارة إصدارات دماغ وكيلك. هذا يتيح لك تتبع تغييرات الشخصية، ومراجعة تطور الذاكرة، والتراجع عن تغييرات التكوين، ومشاركة إعدادات وكيلك مع الآخرين.