> ## 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.

# المشاريع

> تعليمات دائمة وملفات تُطلِع كل محادثة تبدأ بداخلها

# موجزٌ دائمٌ لعملك

بعض العمل ليس محادثة واحدة — بل عشرات المحادثات تتقاسم سياقاً واحداً: التعليمات نفسها تتكرر، والملفات نفسها تُرفَق من جديد، والخلفية نفسها تُشرَح مرةً بعد مرة. **المشروع** يمنح ذلك العمل بيتاً. هو حزمة مسماة من **تعليمات دائمة** و**ملفات**؛ وكل محادثة تبدأ بداخله تبدأ وقد أُطلِعت سلفاً، دون أن تلصق شيئاً.

المشروع أربعة أشياء:

| الجزء              | ما هو                                                                   |
| ------------------ | ----------------------------------------------------------------------- |
| **العنوان**        | اسم المشروع، يظهر أينما ظهرت محادثاته                                   |
| **الرمز التعبيري** | وجهه — على صفحة المشاريع، وواجهة المحادثة، وشريط المحادثات              |
| **التعليمات**      | نص موجّه يُحقَن حرفياً في كل دور من كل محادثة في المشروع                |
| **الملفات**        | مجموعة ملفات مرجعية مصانة، تُعرَض على النموذج بأسمائها وتُقرأ عند الطلب |

## كيف يعمل الإطلاع

كل دور من محادثة المشروع يحمل كتلة `<project>` مُلحقة بموجّه النظام:

* **التعليمات** تُحقَن **حرفياً** — فهي نص موجّه من تأليفك، وهي *السياق* بعينه.
* **الملفات** تُحقَن **قائمةً فقط**: اسم كل ملف وحجمه ومساره المطلق — لا محتواه أبداً. هذه هي [سياسة المرفقات التي يقودها النموذج](/ar/architecture/context-compaction) نفسها المعمول بها في مرفقات المحادثة: يرجع وولفيش إلى الملف بأدواته (`pdf_info` / `pdf_search` / `pdf_read` لملفات PDF، و`file_read` بنطاقات أسطر، و`image_view` للصور، وأدوات الجداول والمستندات) لحظة يهمّ محتواه، ويُمنَع صراحةً من ادّعاء معرفة ملفٍ لم يقرأه أو يبحث فيه خلال المحادثة.

هذا الفصل هو ما يتيح لمشروعٍ أن يحمل مرجع PDF من 3,000 صفحة دون أن يكلّف شيئاً حتى اللحظة التي يعتمد فيها سؤال فعلاً عليه. تُحسَب الكتلة مرة واحدة لكل دور، فلا تزعج تخزين الموجّه المؤقت في منتصف الدور — وعبر الأدوار لا تتغير إلا حين تعدّل المشروع.

<Note>
  الملف الذي اختفى من القرص يُعرَض **مفقوداً** بدل أن يُسقَط بصمت — يخبرك وولفيش بدل أن يخمّن.
</Note>

## صفحة المشاريع

افتح **المشاريع** من قائمة التطبيق. كل مشروع بطاقة تعرض رمزه وعنوانه ومتى **عُدّل** ومتى **استُخدم** آخر مرة وكم محادثةً له وكم ملفاً يحمل — مع إجراءات **لعرض محادثاته** أو **تحريره** أو **حذفه**. والصفحة تُنعش نفسها حيّةً حين يتغيّر شيء من تحتها — اطلب من وولفيش وسط محادثة بناء مشروع أو تزويده بالملفات وراقب بطاقته تتحدّث في مكانها.

زر **جديد** ينشئ مشروعاً ويفتح حوار التحرير:

* **العنوان والرمز** — الأيقونة من منتقي رموز تعبيرية قابل للبحث.
* **التعليمات** — حقل Markdown يُحفَظ تلقائياً لحظات بعد توقفك عن الكتابة (انضباط محرّر [الإجراءات](/ar/configuration/procedures) نفسه: لا زر حفظ، بل **تم** فقط).
* **الملفات** — أرفقها بمنتقي ملفات. كل مصدر **يُنسَخ إلى مجلد المشروع الخاص** (`uploads/project-<id>/` في مساحة العمل)، فيملك المشروع ملفاته ولا يتعلّق أبداً بأصلٍ يُنقل أو يُحذف لاحقاً. وإزالة ملف تحذف نسخة المشروع؛ والأصول خارج مساحة العمل لا تُمَسّ أبداً.
* **محادثة جديدة** — تبدأ محادثةً داخل المشروع من الحوار مباشرة؛ و**مغادرة المشروع** تُخرج المحادثة الحالية منه.

حذف المشروع يُبقي محادثاته السابقة في السجل — تفقد سياق المشروع في الأدوار المقبلة فحسب.

## المحادثات داخل المشروع

ابدأ محادثة مشروع بأيٍّ من هذه الطرق:

* **مرّر المؤشر على زر المحادثة الجديدة** — تنكشف مشاريعك بطاقاتٍ؛ اختر واحداً فتبدأ المحادثة الجديدة بداخله من أول كلمة.
* **من صفحة المشاريع أو حوارها** — إجراء «محادثة جديدة».
* **من هاتفك** — يسرد `/project` على [تيليجرام](/ar/channels/telegram) و[واتساب](/ar/channels/whatsapp) مشاريعك بالأرقام؛ رُدّ بأحدها لتبدأ محادثة بداخله. و`/new` داخل المشروع يبقى عمداً في المشروع؛ و`/project close` هو المخرج.

الربط يعيش **على المحادثة نفسها** (حقل `projectId` مختوم على ملفها)، فينجو من إعادة التشغيل والدمج والتنقل بين القنوات — محادثة المشروع المُكمَلة في أي مكان تبقى محادثة مشروع.

ومحادثات المشروع معروفة أينما ظهرت:

* **محادثة المشروع الفارغة** تستبدل بواجهة وولفيش هويةَ المشروع نفسه — رمزه وعنوانه ومعاينة تعليماته — والنقر عليها يفتح محرّر المشروع.
* **شريط المحادثات** في محادثة مشروع يعرض **محادثات ذلك المشروع وحدها**، تحت عنوان المشروع.
* رقاقات الشريط وصفوف **السجل** تلبس رمز المشروع التعبيري.

## الإجراءات والأتمتة داخل مشروع

العمل المتكرر يُربَط بمشروع أيضاً:

* **[الإجراء](/ar/configuration/procedures)** المربوط بمشروع يعمل بتعليمات المشروع وملفاته، وتُسجَّل محادثات تشغيلاته تحته.
* **[الأتمتة](/ar/configuration/heartbeat)** تُربَط عبر علامة `project:` في كتلة مهمتها — فتنال تشغيلاتها المجدولة الإطلاع نفسه.

فإجراء «مسودة الحالة الأسبوعية» داخل مشروع *العميل فلان* يعرف العميل والنبرة والوثائق المرجعية في كل مرة ينطلق.

## عبر وولفيش

لست مضطراً للمس الصفحة — قدرة **`projects`** تمنح وولفيش اليدين نفسيهما:

* *«أنشئ مشروعاً لتجديد المطبخ بهذه الملفات»* ← `project_create` + `project_add_files`
* *«ما مشاريعي؟»* ← `project_list` (الرقم والرمز والعنوان وعدد الملفات)
* *«اعرض مشروع التجديد»* ← `project_view` (التعليمات الكاملة والملفات بوجود كلٍّ منها وحجمه)
* *«غيّر اسمه / رمزه / أعد كتابة تعليماته»* ← `project_update`
* *«ماذا ناقشنا فيه؟»* ← `project_conversations` ثم `conversation_read` على أيٍّ منها
* *«احذفه»* ← `project_delete` (يطلب تأكيدك أولاً)

## أين تعيش

تُخزَّن المشاريع في ملف JSON واحد عند `brain/projects.json` في [مساحة العمل](/ar/architecture/workspace) — قائمة مسطّحة تُكتَب ذرّياً، تماماً مثل [الإجراءات](/ar/configuration/procedures). كل سجل هو `{ id, title, icon, instructions, files, createdAt, updatedAt }`، وكل مرجع ملف يشير داخل مساحة العمل إلى نسخة المشروع الخاصة. عامِله بوصفه بيانات مُدارة: أنشئ وعدّل واحذف من الصفحة أو عبر وولفيش بدل التحرير اليدوي.

## انظر أيضاً

* [دورة حياة السياق](/ar/architecture/context-compaction) — سياسة المرفقات التي يقودها النموذج والتي تركب عليها ملفات المشاريع
* [الإجراءات](/ar/configuration/procedures) — أوامر محفوظة يمكن أن تعمل داخل مشروع
* [النبض والجدولة](/ar/configuration/heartbeat) — مهام مجدولة يمكن أن تعمل داخل مشروع
* [القدرات المدمجة](/ar/capabilities/built-in-capabilities) — قدرة `projects` وأدواتها الثماني