Qwen Code
محوّل إطار عمل Apothem لـ Qwen Code (إصدار تجريبي).
المورّد: Alibaba Cloud
اسم التثبيت: qwen-code
الحالة: إصدار تجريبي
الإعداد الأصلي: ~/.qwen/
التثبيت
apothem install --harness qwen-codeيكتب المحوّل إعدادات Qwen Code، ويثبّت مرساة سياق QWEN.md،
ويُسجِّل موزِّعات خطّافات Apothem، ويحوّل أوامر Apothem إلى ملفات
أوامر Qwen بصيغة Markdown، ويثبّت المهارات بوصفها أدلّة
SKILL.md، ويُكيِّف تعريفات المساعِدات بوصفها عوامل فرعية لـ Qwen.
الملفات المكتوبة:
~/.qwen/settings.json
~/.qwen/QWEN.md
~/.qwen/apothem/rules/00-apothem-profile.md
~/.qwen/commands/
~/.qwen/skills/
~/.qwen/agents/
~/.qwen/.apothem/support/{rules,templates,hooks}/الملف ~/.qwen/apothem/rules/00-apothem-profile.md هو وثيقة الملف التعريفي.
وهو يحمل هويتك وتفضيلاتك من الملف التعريفي المشترك.
تعيين الملف التعريفي إلى الإعداد الأصلي
يُجسِّد المحوّل مفاتيح settings.json المُوثَّقة للسياق والخطّافات، ويكتب
QWEN.md، وينسج أوامر Apothem ومهاراته وتعريفات مساعِداته عبر
أدلّة الاكتشاف الأصلية في Qwen Code. وتبقى القواعد والقوالب والمادة المصدرية
للخطّافات مادةَ دعم تحت ~/.qwen/.apothem/support/.
ملاحظات التوافق
~/.qwen/.apothem/support/ مادة دعم يُشير إليها QWEN.md وأوامر
الخطّافات في الإعدادات؛ وليس مساحة أسماء اكتشاف يملكها المورّد.
تنتهي كتلة Apothem في QWEN.md بقسم ملفات دعم Apothem
الذي يُسمّي الدليل المطلق تحت ~/.qwen/.apothem/support/ الذي تُحَلّ نسبةً
إليه كل إحالة بأسلوب المستودع (rules/<name>.md، وtemplates/...،
وhooks/...).
قوائم أدوات المهارات. يقرأ Qwen Code قائمة الأدوات المسموح بها للمهارة من
مفتاح البيانات الأمامية allowedTools المكتوب بصيغة camelCase، ويجب أن تكون
القيمة قائمة YAML. ويتجاهل المفتاح ذا الشَّرطة allowed-tools المكتوب
للوكلاء الآخرين. لذلك تحمل المهارات المثبّتة allowedTools بوصفه قائمة، مُدخلةً
واحدة في كل سطر، بدلًا من سلسلة allowed-tools المفصولة بفواصل في مجموعة
المصادر. وتحتفظ كل مُدخلة بتهجئة المصدر، بما في ذلك أنماط مثل
Bash(git status *). وتُثبَّت كل مفاتيح المهارة الأخرى، ومتن المهارة، دون تغيير.
مجلّدات المهارات. يكتب المحوّل المهارات في ~/.qwen/skills/. ويقرأ
Qwen Code أيضًا ~/.agents/skills/، وداخل المشروع .qwen/skills/
و.agents/skills/. وحين يحوي مجلّدان مهارةً بالاسم نفسه، تتقدّم تلك الموجودة
تحت .qwen، لذا تكون الأسبقية لمهارة Apothem في ~/.qwen/skills/
على مهارة بالاسم نفسه كتبها محوّل آخر في ~/.agents/skills/.
أحداث الخطّافات. يربط المحوّل SessionStart، وPreToolUse، وPreCompact،
وPostCompact، وStop. ويُعرِّف Qwen Code اثنين وعشرين حدث خطّاف،
وكل واحد من هذه الخمسة واحدٌ منها. وثلاثة من الاثنين والعشرين (SessionDelete،
وTodoCreated، وTodoCompleted) ليس لها حدث في Claude Code بالاسم
نفسه (إذ يسمّي Claude Code حدثَي المهام TaskCreated وTaskCompleted)؛
ولا يربط المحوّل أيًّا منها.
التحقّق
apothem verify --harness qwen-codeيؤكّد أمر التحقّق ما يلي:
- الإعداد الأصلي موجود في المسار المتوقَّع.
- كل هدف مُدار موجود؛ والملفات المُدارة غير فارغة، وتُحلَّل إعدادات JSON أو YAML. أضِف
--profile PATHلتتحقّق كذلك من أن الملفات المثبّتة تطابق ذلك الملف التعريفي. - روتين التحقّق الخاص بالمحوّل يُبلِغ عن النجاح.
التحديث
apothem update --harness qwen-codeيُحدِّث settings.json، وQWEN.md، والأوامر الأصلية، والمهارات،
والعوامل الفرعية، وشجرة دعم Apothem.
إلغاء التثبيت
apothem uninstall --harness qwen-codeيُزيل المُدخَلات التي أضافها المحوّل إلى ~/.qwen/settings.json (تبقى
مفاتيحك الخاصة وخوادم MCP ومعالِجات الخطّافات الخاصة بك، ولا يُحذَف الملف
إلا إذا كان Apothem هو من أنشأه ولم يتبقَّ فيه شيء يخصّك). ويُزيل كتلة
Apothem من ~/.qwen/QWEN.md ومن وثيقة الملف التعريفي
~/.qwen/apothem/rules/00-apothem-profile.md ويُبقي أي نص آخر فيهما؛
ولا يُحذَف كل ملف منهما إلا حين لا يتبقى فيه شيء آخر. ويُزيل كذلك ملفات
Apothem في ~/.qwen/commands/ و~/.qwen/skills/
و~/.qwen/agents/ و~/.qwen/.apothem/support/؛ وتبقى الملفات
الأخرى في تلك المجلّدات. يُنسَخ كل ملف احتياطيًا تحت ~/.apothem/backups/
قبل تغييره أو إزالته. لا يتأثّر ملف YAML الخاص بالملف التعريفي المشترك ولا
محرّك Apothem.
بوابة المطابقة
python -m apothem.conformity.gate --all .استكشاف الأخطاء وإصلاحها
| العَرَض | الإصلاح |
|---|---|
| ملف الإعداد غير موجود | أعد تشغيل apothem install --harness qwen-code |
| فشل التحقّق | شغّل apothem update --harness qwen-code، ثم تحقّق مجدّدًا |
| محتوى إعداد غير متوقَّع | افحص ~/.config/apothem/profile.yaml أو --profile PATH، ثم أعد تشغيل apothem update --harness qwen-code |
مفاتيح الضبط
| الراية | القيمة الافتراضية | الوصف |
|---|---|---|
--dry-run | false | معاينة التثبيت دون كتابة ملفات. |
انظر أيضًا
- كل أُطُر العمل — الفهرس الكامل للأدوات المدعومة
- دليل التثبيت — ثبّت Apothem في إطار العمل هذا
- مرجع
apothem harnesses— اسرد المحوّلات وافحصها من واجهة سطر الأوامر