GLM (Z.ai)
محوّل إطار عمل Apothem لـ GLM (Z.ai) بوصفه واجهة خلفية للنماذج قابلة للضبط.
المورّد: Z.ai
اسم التثبيت: glm
الحالة: إتاحة عامة
الإعداد الأصلي: <project>/.apothem/providers/glm.toml
يضبط محوّل glm واجهة GLM (Z.ai) بوصفها واجهة خلفية للنماذج.
تُوجَّه إلى GLM أداةٌ تتحدّث البروتوكول المتوافق مع Anthropic أو
المتوافق مع OpenAI، بضبط عنوان URL أساسي للواجهة الخلفية ومفتاح،
وتختار المحوّل بالراية --harness glm مثل أي محوّل آخر. وهو يكتب ملف
إعداد مزوّد يُسجِّل سطحَي التوافق كليهما، بحيث يمكن ربط أي أداة متوافقة بعائلة
نماذج GLM.
وتشحن Z.ai أيضًا أداة برمجة رسمية من إنتاجها، هي ZCode، التي تسمّيها وثائق Z.ai «Agentic Development Environment» (بيئة تطوير وكيلية). ولا يضبط هذا المحوّل ZCode. ولم يفحص Apothem سطح الإعداد الخاص بـ ZCode، لذا لا يكتب المحوّل له شيئًا.
التثبيت
apothem install --harness glm --project /path/to/projectيكتب المحوّل ملف مزوّد واحدًا بنطاق المشروع يُسجِّل نقاط نهاية الواجهة الخلفية لـ GLM وعناصر نائبة يضبطها المُشغِّل.
الملفات المكتوبة: <project>/.apothem/providers/glm.toml
تعيين الملف التعريفي إلى الإعداد الأصلي
يُسجِّل ملف المزوّد واجهتين خلفيتين. تستخدم الواجهة الخلفية المتوافقة مع
Anthropic عنوان URL الأساسي
https://api.z.ai/api/anthropic؛ وتتوجّه الأداة التي تتحدّث بروتوكول
Anthropic إلى GLM بضبط ANTHROPIC_BASE_URL،
وANTHROPIC_AUTH_TOKEN، وAPI_TIMEOUT_MS اختياريًا. ويسرد
الجدول [backends.anthropic_compatible.env] في الملف تلك المتغيّرات، ويسرد
كذلك ANTHROPIC_DEFAULT_OPUS_MODEL،
وANTHROPIC_DEFAULT_SONNET_MODEL، وANTHROPIC_DEFAULT_HAIKU_MODEL،
التي تربط أدوار opus وsonnet وhaiku في الأداة بنماذج
GLM. تستخدم الواجهة الخلفية المتوافقة مع OpenAI عنوان
URL الأساسي https://api.z.ai/api/coding/paas/v4. رمز المصادقة
عنصر نائب تستبدله بمفتاح Z.ai الخاص بك — لا يكتب Apothem سرًّا
حقيقيًا أبدًا. مُعرِّفات النماذج متقلّبة بتغيّر النسخ، لذا لا يُثبِّت
Apothem أيًّا منها؛ ويحمل الملف عناصر نائبة <GLM_MODEL_ID>
تملؤها من وثائق Z.ai الحالية. لا
شيء من الملف التعريفي المشترك يدخل هذا الملف؛ فهو قالب ثابت.
ربط الأدوار بالنماذج
تتعارض تصريحات Z.ai نفسها بشأن ربط الأدوار بالنماذج، لذا يترك الملف قيم
ANTHROPIC_DEFAULT_*_MODEL الثلاث عناصرَ نائبة ويحمل تعليق
TODO(clarify) فوقها. وأنت من يقرّر أي ربط يستخدم:
- يربط مثال
settings.jsonاليدوي في دليل الإعداد المتوافق مع Anthropic لدى المورّد دورَي opus وsonnet بـglm-5.3[1m]ودور haiku بـglm-5.3-flash[1m]، ويضبطCLAUDE_CODE_AUTO_COMPACT_WINDOWعلى1000000. - يسرد الربط الافتراضي المُعلَن في الدليل نفسه
GLM-5.3-Flashللأدوار الثلاثة كلها. - تعتمد أداة
@z_ai/coding-helperمن Z.ai افتراضيًاglm-5.3-flash، وتُلحِق[1m]بالأدوار الثلاثة كلها، وتكتب نافذة ضغط قدرها1048576.
لا يُثبِّت Apothem أيًّا من هذه القيم ولا يختار بينها.
ملاحظات التوافق
لا تكشف الواجهة الخلفية GLM أي سطح للقواعد أو الأوامر أو المهارات أو
الخطّافات، لذا لا يكتب المحوّل سوى ملف مزوّد الواجهة الخلفية ولا شيء غيره. ولم
يفحص Apothem ما إذا كانت ZCode تكشف أسطحًا كهذه.
يبقى مفتاح Z.ai الخاص بك واختياراتك لمُعرِّفات النماذج ملكًا للمُشغِّل.
اصطلاحات سطح المورّد التي يعتمد عليها المحوّل مُثبَّتة في
src/apothem/harnesses/glm/STANDARD-CONVENTION-PIN.md، ملتقَطة بوصفها لقطة
مقابل وثائق Z.ai الحيّة.
يُشغِّل GLM عائلة نماذج GLM من Z.ai؛ راجع مرجع إعداد المورّد للاطلاع على سطح الإعداد الحالي الخاص بالواجهة الخلفية والنموذج والتوافق مع Anthropic.
التحقّق
apothem verify --harness glm --project /path/to/projectيؤكّد أمر التحقّق ما يلي:
- الإعداد الأصلي موجود في المسار المتوقَّع.
- ملف المزوّد موجود وغير فارغ.
- روتين التحقّق الخاص بالمحوّل يُبلِغ عن النجاح.
التحديث
apothem update --harness glm --project /path/to/projectيصبح ملف المزوّد ملكًا لك بمجرّد وجوده. لا يكتب install ولا
update القالب إلا حين يكون .apothem/providers/glm.toml
غائبًا، ولا يكتب أيٌّ منهما فوقه أبدًا بعد ذلك، لذا يبقى مرجع مفتاحك واختياراتك
للنماذج بعد كل إعادة تشغيل. لاعتماد قالب أحدث، انقل ملفك جانبًا، وشغّل
update، وانسخ قيمك إلى الملف الجديد.
إلغاء التثبيت
apothem uninstall --harness glm --project /path/to/projectلا يُزيل ملف المزوّد إلا حين يكون Apothem قد أنشأه وما يزال قالبًا غير مُعدَّل، وينسخه احتياطيًا أولًا تحت جذر النسخ الاحتياطية في Apothem. ويُحتسَب الملف غير المُعدَّل الذي كتبه إصدار سابق حين يُظهِر سجلّ التثبيت الخاص بـ Apothem للمشروع أنه كتب الملف: إذ يُسجِّل ملف البيان (manifest) بصمة كل قالب شحنه المشروع. ومن دون سجلّ تثبيت، لا تُزال إلا نسخة مطابقة تمامًا للقالب الحالي. ويُترَك في مكانه أي ملف أنشأته أنت أو عدّلته. لا يتأثّر ملف YAML الخاص بالملف التعريفي المشترك ولا محرّك Apothem.
بوابة المطابقة
python -m apothem.conformity.gate --all .استكشاف الأخطاء وإصلاحها
| العَرَض | الإصلاح |
|---|---|
| ملف الإعداد غير موجود | أعد تشغيل apothem install --harness glm --project /path/to/project |
| فشل التحقّق | ملف المزوّد مفقود أو فارغ. إذا كان مفقودًا، فشغّل apothem update --harness glm --project /path/to/project. وإذا كان فارغًا، فانقل .apothem/providers/glm.toml جانبًا أولًا، ثم شغّل update وتحقّق مجدّدًا |
| محتوى إعداد غير متوقَّع | عدّل .apothem/providers/glm.toml مباشرةً؛ فـApothem لا يُعيد كتابة ملف موجود أبدًا، ولا يضيف الملف التعريفي المشترك إليه شيئًا. وللحصول على قالب جديد، انقل الملف جانبًا وشغّل apothem update --harness glm --project /path/to/project |
مفاتيح الضبط
| الراية | القيمة الافتراضية | الوصف |
|---|---|---|
--dry-run | false | معاينة التثبيت دون كتابة ملفات. |
انظر أيضًا
- كل أُطُر العمل — الفهرس الكامل للأدوات المدعومة
- دليل التثبيت — ثبّت Apothem في إطار العمل هذا
- مرجع
apothem harnesses— اسرد المحوّلات وافحصها من واجهة سطر الأوامر