OpenCode

المورّد: OpenCode اسم التثبيت: opencode الحالة: إصدار تجريبي الإعداد الأصلي: ~/.config/opencode/

التثبيتCopy Anchor Link

apothem install --harness opencode

يكتب المحوّل إعداد JSON الخاص بـ OpenCode، ويثبّت مهارات Apothem في سطح مهارات OpenCode، ويحوّل مطالبات الأوامر إلى ملفات أوامر Markdown خاصة بـ OpenCode، ويُطبِّع تعريفات مساعِدات Apothem بوصفها مساعِدات فرعية لـ OpenCode.

الملفات المكتوبة:

~/.config/opencode/opencode.json
~/.config/opencode/apothem/rules/00-apothem-profile.md
~/.config/opencode/commands/
~/.config/opencode/skills/
~/.config/opencode/agents/
~/.config/opencode/.apothem/support/{rules,templates,hooks}/

تعيين الملف التعريفي إلى الإعداد الأصليCopy Anchor Link

يُجسِّد المحوّل opencode.json مع قائمة ملفات instructions تُسمّي وثيقة ملفك التعريفي، والقواعد الأساسية الأربع، وفهرس القواعد، ثم ينشر كل حزمة مشتركة من حزم Apothem إمّا إلى سطح أصلي في OpenCode وإمّا إلى شجرة دعم فرعية يملكها Apothem. وتُنسَخ العناصر الفرعية المطابقة الموجودة التي يديرها Apothem احتياطيًا قبل استبدالها.

ملاحظات التوافقCopy Anchor Link

يدمج OpenCode كل ملف تُسمّيه قائمة instructions في كل جلسة (قواعد OpenCode). لذلك تُسمّي القائمة وثيقة ملفك التعريفي أولًا، ثم القواعد التي تكون قيمة alwaysApply فيها true فقط، بمسار صريح واحد ~/.config/opencode/.apothem/support/rules/<name>.md لكلٍّ منها؛ ويوسّع OpenCode البادئة ~/ نسبةً إلى دليلك المنزلي. وتلك القواعد هي agnostic-posture، وauthority-inquiry، وcontext-management، وsession-closure، وفهرس القواعد apothem-rule-index. ولا يقصر OpenCode أي قاعدة على مسارات، لذا تُقرَأ كل قاعدة أخرى عند الطلب. وتبقى مُثبَّتةً بوصفها مادة مرجعية تحت ~/.config/opencode/.apothem/support/، ويُسمّي الفهرس كل قاعدة والموقف الذي يستدعيها. وأيُّ قاعدة أو مهارة أو أمر يُحيل إلى قاعدة أو قالب أو مطالبة خطّاف يقرؤها من هناك. تستخدم الأوامر والمهارات وتعريفات المساعِدات مواقع الاكتشاف الأصلية.

تحمل وثيقة الملف التعريفي ~/.config/opencode/apothem/rules/00-apothem-profile.md هويتك وتفضيلاتك من الملف التعريفي المشترك، وتنتهي بقسم ملفات دعم Apothem الذي يُسمّي الدليل المطلق تحت ~/.config/opencode/.apothem/support/ الذي تُحَلّ نسبةً إليه كل إحالة بأسلوب المستودع (rules/<name>.md، وtemplates/...، وhooks/...). وهي أول مُدخَل في instructions، لذا يُحمِّلها OpenCode في كل جلسة.

يسرد ملف opencode.json الذي كتبه إصدار سابق نمط glob واحدًا هو ~/.config/opencode/.apothem/support/rules/*.md، الذي يُحمِّل كل قاعدة، أو مسارًا صريحًا لكل واحدة من القواعد الثماني والعشرين التي كانت حينها دائمة التفعيل. يستبدل apothem install وapothem update أيًّا من الشكلين بالقائمة أعلاه، فيُسقطان المسارات الأربعة والعشرين التي لم تعد تُحمَّل عند الإطلاق، ويُزيل apothem uninstall كل ذلك. ويُحتفَظ بمُدخَلات instructions الخاصة بك في كل الحالات.

التحقّقCopy Anchor Link

apothem verify --harness opencode

يؤكّد أمر التحقّق ما يلي:

1. الإعداد الأصلي موجود في المسار المتوقَّع.
2. كل هدف مُدار موجود؛ والملفات المُدارة غير فارغة، وتُحلَّل إعدادات JSON أو YAML. أضِف --profile PATH لتتحقّق كذلك من أن الملفات المثبّتة تطابق ذلك الملف التعريفي.
3. روتين التحقّق الخاص بالمحوّل يُبلِغ عن النجاح.

التحديثCopy Anchor Link

apothem update --harness opencode

يُحدِّث opencode.json، والأوامر الأصلية، والمهارات، وتعريفات المساعِدات، وشجرة دعم Apothem.

إلغاء التثبيتCopy Anchor Link

apothem uninstall --harness opencode

يُزيل المُدخَلات التي أضافها المحوّل إلى ~/.config/opencode/opencode.json (تبقى مفاتيحك الخاصة وخوادم MCP ومُدخَلات instructions الخاصة بك، ولا يُحذَف الملف إلا إذا كان Apothem هو من أنشأه ولم يتبقَّ فيه شيء يخصّك). ويُزيل كتلة Apothem من وثيقة الملف التعريفي ~/.config/opencode/apothem/rules/00-apothem-profile.md ويُبقي أي نص آخر فيها؛ ولا يُحذَف ذلك الملف إلا حين لا يتبقى فيه شيء آخر. ويُزيل كذلك ملفات Apothem في ~/.config/opencode/commands/ و~/.config/opencode/skills/ و~/.config/opencode/agents/ و~/.config/opencode/.apothem/support/؛ وتبقى الملفات الأخرى في تلك المجلّدات. يُنسَخ كل ملف احتياطيًا تحت ~/.apothem/backups/ قبل تغييره أو إزالته. لا يتأثّر ملف YAML الخاص بالملف التعريفي المشترك ولا محرّك Apothem.

بوابة المطابقةCopy Anchor Link

python -m apothem.conformity.gate --all .

استكشاف الأخطاء وإصلاحهاCopy Anchor Link

مفاتيح الضبطCopy Anchor Link

انظر أيضًاCopy Anchor Link

• كل أُطُر العمل — الفهرس الكامل للأدوات المدعومة
• دليل التثبيت — ثبّت Apothem في إطار العمل هذا
• مرجع apothem harnesses — اسرد المحوّلات وافحصها من واجهة سطر الأوامر