الأسئلة الشائعة

أسئلة شائعة، مرتّبة حسب التكرار.

ما هو apothem؟Copy Anchor Link

Apothem هو مدير إعدادات غير معتمِد على المضيف لأُطُر عمل المساعد البرمجي. تكتب ملفًا تعريفيًا مشتركًا واحدًا، فيُجسِّده Apothem في سطح الإعداد الأصلي لكل أداة — جامعًا القواعد السلوكية، والمعايير الإبداعية، والأوامر المائلة، والعاملين المُفوَّضين الدائمين، والخطّافات، والمهارات في مجموعة واحدة محكومة تظلّ متّسقة عبر كل إطار عمل.

مع أي أُطُر عمل للمساعد البرمجي يعمل؟Copy Anchor Link

Apothem غير معتمِد على إطار العمل. تُسقِط المحوّلات الخاصة بكل إطار عمل ضمن src/apothem/harnesses/<harness>/ الملف التعريفي المشترك في دليل الإعداد الأصلي لكل أداة. وسجلّ أُطُر العمل في زمن التشغيل هو المصدر المرجعي للمجموعة المدعومة؛ وتوثّق صفحات أُطُر العمل كلًّا منها. ويغطّي السجلّ حاليًا أُطُر العمل المدعومة التالية:

Claude Code, GitHub Copilot, Cursor, Gemini CLI, Codex, Windsurf, OpenCode,
Antigravity, Open-Claw, Hermes, Qwen Code, CodeBuddy, Kiro, Trae, Zed,
GLM (Z.ai), and Kimi Code

يُجسِّد محوّل Claude Code في ~/.claude/؛ ومُوزّع الخطّافات الخاص به محايد تجاه المضيف — إذ يحلّ جذر المنظومة من $CLAUDE_PROJECT_DIR أولًا، ثم $LLM_PROJECT_DIR، ثم يجرّب عمليات البحث النسبية إلى السكربت وإلى مجلد العمل، وأخيرًا يعود إلى $HOME/.claude.

هل يلزمني استخدام سلسلة حزمة الخطّة؟Copy Anchor Link

لا. سلسلة حزمة الخطّة هي أحد مكوّنات المنظومة. فالقواعد السلوكية، والمعايير الإبداعية، والخطّافات، وسلسلة أدوات التحقّق مفيدة بشكل مستقلّ.

كيف أخصّص القواعد دون عمل نسخة (fork) من المستودع؟Copy Anchor Link

أضِف سلسلة نصية إلى قائمة rules: في ~/.config/apothem/profile.yaml، ثم أعِد تشغيل التثبيت أو التحديث. وملفات القواعد الواقعة تحت src/apothem/rules/ تُعدِّل شجرة المصدر المُجمَّعة، التي يستبدلها مُثبِّت الأرشيف عند تشغيله مع --yes.

كيف أعطّل قاعدة مؤقتًا؟Copy Anchor Link

إمّا أن تعيد تسمية الملف خارج النمط src/apothem/rules/*.md أو تنقله إلى دليل شقيق لا يفحصه المُحمِّل.

ما الفرق بين القواعد والمهارات والعاملين المُفوَّضين؟Copy Anchor Link

• القواعد تحكم السلوك — التزامات دائمة التفعيل أو مُرشَّحة بالمسار يتّبعها المساعد.
• المهارات تقنيات قابلة لإعادة الاستخدام وقابلة للكشف — إشارة كشف، وإجراء، وخطّاف فرض.
• العاملون المُفوَّضون أدوار دائمة بقيود أدواتها الخاصّة ومُوجِّهات نظامها، يجري إرسالها عبر بروتوكول تنظيم العاملين.

كيف أبلّغ عن مشكلة أمنية؟Copy Anchor Link

راجع SECURITY.md. القنوات المدعومة هي استشارات أمن GitHub (GitHub Security Advisories) و[email protected].

كيف أساهم؟Copy Anchor Link

راجع المساهمة. باختصار: اقرأ CONTRIBUTING.md، واعمل نسخة (fork) من المستودع، وافتح طلب سحب (PR) مع قالب طلب السحب المعياري مُعبّأً، وتأكّد من نجاح فحوص التكامل المستمرّ — إذ يسرد دليل المطوّر البوابات التي يجب أن يجتازها طلب السحب.

أين تقع حالة المنظومة؟Copy Anchor Link

• حالة الخطّة لكل حزمة تقع ضمن <project>/.apothem/plans/{suite}/.
• ذاكرة Apothem تقع ضمن .apothem/memory/ أسفل جذر التثبيت (في Claude Code: ~/.claude/.apothem/memory/؛ و~/.apothem/memory/ حين تكون workspace.scope بقيمة user-home؛ و<project>/.apothem/memory/ لتثبيتات نطاق المشروع). أما الذاكرة التلقائية الخاصة بـ Claude Code فتقع ضمن جذر تهيئة إطار العمل، عند projects/{hash}/memory/ (في Claude Code: ~/.claude/projects/{hash}/memory/).
• الذاكرة عبر المشاريع تقع ضمن جذر تهيئة إطار العمل نفسه، عند .apothem/memory/ (في Claude Code: ~/.claude/.apothem/memory/).
• المسوّدات لكل جلسة تقع ضمن <project>/.apothem/plans/{suite}/_inputs/.

هل يمكنني متابعة عمل طويل الأمد في جلسة جديدة أو على جهاز آخر؟Copy Anchor Link

نعم. العمل طويل الأمد يُخرِج حالته الكاملة إلى حزمة .apothem/plans/ محلّية للمشروع — عقد استئناف إضافةً إلى بروتوكول بدء بارد —، بحيث لا يعيش العمل داخل سجلّ محادثة واحد. وبما أنّ الحالة موجودة في ملفّات مشروعك، فإنّ أي جلسة جديدة على أي حساب أو جهاز موجَّه إلى المشروع نفسه تستأنف العمل في مكانه. ولا يدفع Apothem الملفّات بين الحسابات بنفسه؛ بل تنتقل بالطريقة التي تنتقل بها ملفّات مشروعك أصلًا (التحكّم في الإصدارات، نسخة عمل مشتركة، دليل مُزامَن). راجع التخطيط القابل للاستئناف.

هل يحتاج Apothem إلى pip؟Copy Anchor Link

لا — ليس للمحرّك نفسه. المحرّك شجرة مصدر مكتفية ذاتيًا باعتماديات مُضمَّنة — إذ يعمل بصيغة python -m apothem من أي نسخة عمل، أو ذاكرة npx المؤقتة، أو شجرة المُلحَق على Python 3.10 أو أحدث من النظام، ولا يُثبِّت أيًّا من شيفرته الخاصّة في site-packages (click وrich هما المتطلّبان المُسبَقان الوحيدان للمُفسِّر). الاستثناء الاختياري الوحيد: إذا كان click أو rich مفقودًا، فإنّ المُثبِّت يعرض تشغيل pip install لهذين الاثنين فقط نيابةً عنك — مع تأكيدك، أو عبر --yes / APOTHEM_AUTO_INSTALL_DEPS=1. أمّا حِزَم Apothem الخاصّة فلا تُثبَّت أبدًا في site-packages.

كيف تعمل الخطّافات دون حزمة مُثبَّتة؟Copy Anchor Link

يُجسِّد apothem install مُوزّع الخطّافات وبوابة المطابقة ضمن جذر إطار العمل (في حالة Claude Code: ~/.claude/.apothem/support/hooks/ و ~/.claude/.apothem/support/conformity/)، وتستدعي إدخالات الخطّاف المُجسَّدة تلك النصوص بالمسار المُطلَق. وكلاهما نصوص مستقلّة من المكتبة القياسية (stdlib)، لذا تعمل الخطّافات على جهاز لم يرَ pip install قطّ.

كيف ألغي التثبيت بالكامل؟Copy Anchor Link

شغّل apothem uninstall --harness <name> لكل إطار عمل مُثبَّت، وأزِل المحرّك وفق قناة تثبيتك، واحذف ~/.apothem/ (النُسَخ الاحتياطية) إضافةً إلى ~/.config/apothem/ (ملفك التعريفي) إن أردت عدم بقاء أي أثر. ويشرح دليل إلغاء التثبيت كل قناة.

ما الترخيص الذي تخضع له المنظومة؟Copy Anchor Link

MIT — راجع LICENSE.