Kimi Code
محوّل إطار عمل Apothem لـ Kimi Code (إتاحة عامة).
المورّد: Moonshot
اسم التثبيت: kimi-code
الحالة: إتاحة عامة
الإعداد الأصلي: <project>/AGENTS.md، و<project>/.kimi-code/skills/، و<project>/.kimi-code/agents/، و<project>/.kimi-code/.apothem/support/
التثبيت
apothem install --harness kimi-code --project /path/to/projectيكتب المحوّل سطح الحوكمة المشترك لـ Apothem في ملف AGENTS.md
في جذر المشروع بوصفه كتلة مُدارة محدَّدة بعلامات حارسة (يُحفَظ نثر المُشغِّل الواقع
خارج العلامات الحارسة). ويثبّت المهارات، والأوامرَ مغلَّفةً بوصفها مهارات، في
دليل مهارات المشروع الأصلي في Kimi Code، وهو <project>/.kimi-code/skills/، ويثبّت
مساعِدات Apothem بوصفها عوامل فرعية لـ Kimi Code في <project>/.kimi-code/agents/ (راجع
العوامل الفرعية). وتبقى الحزم الأخرى تحت شجرة الدعم التي يملكها
Apothem في <project>/.kimi-code/.apothem/support/.
يقرأ ملفَّ AGENTS.md الخاص بالمشروع كثيرٌ من أدوات البرمجة إلى جانب
Kimi Code، لذا تُكتَب الكتلة بوصفها إرشادات على نطاق المشروع لا تُسمّي
أداة واحدة بعينها قارئًا لها.
يقرأ Kimi Code ملف التعليمات AGENTS.md في جذر المشروع وفق
الاصطلاح العام لـ AGENTS.md، ويقع إعداد المشروع تحت
<project>/.kimi-code/. ويَعُدّ Kimi Code جذرَ المشروع أقربَ دليل يحوي
.git، باحثًا صعودًا من دليل العمل، لذا مرِّر جذر المستودع بوصفه
--project. السطح <project>/.kimi-code/mcp.json
يملكه المُشغِّل؛ يُسمّيه Apothem لكنه لا يؤلّف فيه أي مُدخَلات.
الملفات المكتوبة: <project>/AGENTS.md (كتلة مُدارة)، والمهارات
والأوامر (بوصفها مهارات) تحت <project>/.kimi-code/skills/، وملف
<project>/.kimi-code/agents/<name>.md واحد لكل مساعِد من مساعِدات Apothem، وحزم
الخطّافات، والقواعد، والقوالب تحت <project>/.kimi-code/.apothem/support/.
العوامل الفرعية
يقرأ Kimi Code العامل الفرعي من ملف Markdown في .kimi-code/agents/ (أو
.agents/agents/)، وفق
وثائق Kimi Code عن العوامل الفرعية المخصّصة.
ويكتب التثبيت ملفًا واحدًا لكل مساعِد من مساعِدات Apothem في <project>/.kimi-code/agents/
للمساعِدات الأربعة عشر كلها. وهو يثبّت للمشروع فقط ولا يكتب أي مجلّد
~/.kimi-code/agents/.
يُبقي كل ملف تعليمات المساعِد دون تغيير ويحمل مفاتيح البيانات الأمامية التالية:
| المفتاح | ما يكتبه Apothem |
|---|---|
name، description | اسم المساعِد ووصفه. |
tools | الأدوات المسموح بها للمساعِد، بوصفها قائمة بأسماء أدوات Kimi Code. |
disallowedTools | الأدوات المحظورة على المساعِد، بوصفها قائمة بأسماء أدوات Kimi Code. ويطبّقه Kimi Code بعد tools. |
يطابق Kimi Code أسماء الأدوات مطابقةً تامة، بما فيها الأحرف الكبيرة، ويحذّر من
الاسم الذي لا يملك له أداة. لذا يُعيد التثبيت تسمية الأداتين اللتين يتهجّاهما Kimi Code بشكل مختلف،
WebFetch إلى FetchURL وTodoWrite إلى TodoList، ويستبعد الأسماء
التي لا يملك لها Kimi Code أداة: MultiEdit، وNotebookEdit، وPowerShell، وMonitor،
وArtifact، وTaskCreate، وTaskUpdate. والأداة المحظورة تبقى محظورة. وإن اختفت
كل الأدوات المسموح بها لمساعِد على هذا النحو، يحمل الملف tools: []، الذي لا يسمح بأي
أداة؛ أما حذف tools فسيسمح بكل الأدوات.
لا يكتب التثبيت أبدًا model (لا يملك Kimi Code مفتاح نموذج للعامل الفرعي، الذي
يستخدم نموذج الجلسة الرئيسية أو [secondary_model] في config.toml)، ولا
override (إذ سيسمح لملف في المشروع باستبدال عامل فرعي مدمج)، ولا subagents، ولا
whenToUse، ولا مفاتيح Apothem: maxTurns وversion وupdated وportability.
أمور ينبغي معرفتها:
- ملفات العوامل الفرعية ملفات مشروع عادية. أودِعها مع المشروع أو
أدرِج
.kimi-code/agents/في.gitignore؛ ولا يختار Apothem نيابةً عنك. - يستخدم Kimi Code المساعِد حين يُطلَب التفويض. فمنذ إصداره في
2026-10-25 يتولّى المهام بنفسه افتراضيًا بدلًا من إطلاق العوامل الفرعية
من تلقاء نفسه، لذا اطلب المساعِد باسمه، في رسالة أو في
AGENTS.md. ولا تزال صفحة المورّد عن العوامل الفرعية المخصّصة تصف الجدولة التلقائية، لذا قد يتغيّر هذا. - الملف على مستوى المشروع في
.kimi-code/agents/يتقدّم على التعريف الذي يحمل الاسم نفسه في المستويات الإضافية، ومستوى المستخدم، ومستوى الإضافات. أعطِ مساعِداتك الخاصة أسماءً تختلف عن أسماء Apothem. وتقرأ شيفرة Kimi Code أيضًا.kimi-code/agents/قبل المجلّد المشترك.agents/agents/، الذي لا يكتبه Apothem أبدًا، وتُبقي الأول من ملفين يحملان الاسم نفسه؛ ولا تذكر الوثائق ذلك. - الملف الخاص بك الذي يحمل اسم مساعِد من Apothem يُحفَظ تحت
~/.apothem/backups/ثم يُستبدَل. ولا يُعيده إلغاء التثبيت. ولا تُمَسّ الملفات ذات الأسماء الأخرى أبدًا. - كانت الإصدارات السابقة تُبقي ملفات المساعِدات في شجرة الدعم، في
.kimi-code/.apothem/support/agents/، حيث لم يكن Kimi Code يُحمِّلها. ويُزيلapothem updateأوapothem uninstallتلك النسخة بعد حفظها تحت~/.apothem/backups/.
تعيين الملف التعريفي إلى الإعداد الأصلي
يقرأ المحوّل الملف التعريفي المشترك لـ Apothem ويُجسِّد سطح التعليمات
AGENTS.md في جذر المشروع في كل تشغيل لـ apothem install أو
apothem update. تستقرّ القواعد السلوكية ومتن الحوكمة في الكتلة المُدارة
من AGENTS.md. وتستقرّ كل مهارة، وكل أمر مغلَّف بوصفه مهارة، في
.kimi-code/skills/<name>/SKILL.md، وهو دليل مهارات للمشروع يُحمِّله
Kimi Code. ولا يكتب المحوّل إلا ذلك المجلّد الخاص بـ Kimi، ولا يكتب أبدًا
.agents/skills/، الذي تقرؤه أدوات أخرى أيضًا. والمهارات التي تضيفها بنفسك إلى
.kimi-code/skills/ بأسماء أخرى يُحتفَظ بها عند التثبيت والتحديث
وإلغاء التثبيت. أما المهارة الموجودة هناك بالاسم نفسه لمهارة من Apothem فتُستبدَل:
يكتب التثبيت والتحديث فوقها، ويُزيلها إلغاء التثبيت، وكلٌّ منها بعد حفظ نسخة
بطابع زمني تحت ~/.apothem/backups/، ولا يطبع التثبيت أي إشعار
بهذا التعارض. أعطِ مهاراتك الخاصة أسماءً تختلف عن أسماء Apothem.
توضَع حزم الخطّافات، والقواعد، والقوالب تحت
.kimi-code/.apothem/support/ ويُشار إليها من سطح التعليمات.
ولا يُحمِّلها Kimi Code من شجرة الدعم، لذا فإن نسخ Apothem هناك
مادة مرجعية تشير إليها كتلة AGENTS.md. تنتهي الكتلة بقسم ملفات دعم
Apothem الذي يُسمّي، نسبةً إلى جذر المشروع، الدليلَ تحت
.kimi-code/.apothem/support/ الذي تُحَلّ نسبةً إليه كل إحالة بأسلوب المستودع
(rules/<name>.md، وtemplates/...، وhooks/...)، بحيث لا يحمل
ملف AGENTS.md المُودَع أي مسار خاص بجهاز بعينه. (سلوك Kimi Code وفق
صفحات التخصيص الخاصة به عن
المهارات،
وتعريفات المساعِدات،
والخطّافات، كما
قُرئت في 2026-10-24 للمهارات والخطّافات، وفي 2026-10-27 لتعريفات المساعِدات.)
ما لا يُثبَّت أصليًا
يوثّق Kimi Code موضعًا أصليًا للخطّافات. ولا يكتب فيه المحوّل بعد، للأسباب التالية.
- الخطّافات. يقرأ Kimi Code الخطّافات من المصفوفة
[[hooks]]في~/.kimi-code/config.toml($KIMI_CODE_HOME/config.tomlحين يكون ذلك المتغيّر مضبوطًا). ولا يكتب Apothem أيًّا منها. فذلك الملف على نطاق المستخدم بينما يكتب هذا المحوّل تحت جذر المشروع؛ ولا تسمح المُدخلة إلا بأربعة حقول (eventوcommandإلزاميان، وmatcherوtimeoutاختياريان) والحقل الإضافي يمنع الإعداد من التحميل؛ ولا يملك Apothem دمجًا لـ TOML يستطيع لاحقًا إزالة مُدخلاته وحدها. وتبقى السكربتات المساعدة للخطّافات في شجرة الدعم. - البيانات الأمامية للمهارات. توثّق صفحة المورّد مفاتيح
SKILL.mdالتالية:nameوdescription(وكلاهما إلزامي)، وtype، وwhenToUse، وdisableModelInvocation(ويُقبَل أيضًا بصيغةdisable-model-invocation)، وarguments. ولا تنصّ على أي قاعدة للمفاتيح الأخرى. وتُثبَّت المهارات بالبيانات الأمامية التي تحملها في مصدر Apothem، لذا تصل مفاتيح مثلversion، وupdated، وarchetype، وuserInvocable، وargument-hint، وportability، وallowed-toolsإلى Kimi Code، الذي قد يتجاهلها أو يرفضها. - المهارات ذات الأسماء المتطابقة. يعطي Kimi Code مستوى المشروع الأولوية على مستوى
المستخدم، لذا تتقدّم المهارة في
<project>/.kimi-code/skills/على المهارة التي تحمل الاسم نفسه في~/.agents/skills/، الذي يكتبه محوّل آخر من Apothem. ولا تقول صفحة المورّد كيف يترتّب.kimi-code/skills/و.agents/skills/أحدهما مقابل الآخر داخل مستوى المشروع.
ملاحظات التوافق
يقرأ Kimi Code تعليمات المشروع من AGENTS.md أو
.kimi-code/AGENTS.md ويتعرّف على .kimi-code/mcp.json بوصفه
سطح MCP الذي يملكه المُشغِّل؛ يُسمّي Apothem ذلك السطح لكنه لا
يؤلّف فيه أي مُدخَلات. ومن ملفَّي التعليمات هذين، لا يكتب المحوّل سوى
AGENTS.md في جذر المشروع، وهو الملف الذي يقرؤه Kimi Code بوصفه
تعليمات المشروع؛ ولا تذكر وثائق Kimi Code أيّ الملفين له الأسبقية حين
يوجدان معًا. لا يكشف Kimi Code عن سطح ملفات لشريط الحالة أو لأنماط
الإخراج، لذا لا تُجسَّد تلك الحزم.
يعمل Kimi Code على عائلة نماذج Kimi من Moonshot؛ راجع مرجع إعداد المورّد لمعرفة النموذج الحالي وسطح الإعداد.
التحقّق
apothem verify --harness kimi-code --project /path/to/projectيؤكّد أمر التحقّق ما يلي:
- الإعداد الأصلي موجود في المسار المتوقَّع.
- كل هدف مُدار موجود، بما في ذلك دليلا المهارات والعوامل الفرعية؛ والملفات المُدارة
غير فارغة، وتُحلَّل إعدادات JSON أو YAML. أضِف
--profile PATHلتتحقّق كذلك من أن الملفات المثبّتة تطابق ذلك الملف التعريفي. وبالنسبة إلى.kimi-code/agents/يتحقّق الفحص من وجود المجلّد، لا من وجود كل ملف مساعِد فيه؛ ويسرد الأمرapothem diff --harness kimi-code --project /path/to/projectملفات المساعِدات المفقودة أو القديمة. - روتين التحقّق الخاص بالمحوّل يُبلِغ عن النجاح.
التحديث
apothem update --harness kimi-code --project /path/to/projectيُعيد اشتقاق الكتلة المُدارة في AGENTS.md في جذر المشروع، والمهارات، وملفات
العوامل الفرعية، وحزم الدعم من الحالة الراهنة للملف التعريفي المشترك.
والتحديث فوق تثبيت أُجري قبل انتقال المهارات إلى .kimi-code/skills/
يُزيل الدليل القديم <project>/.kimi-code/.apothem/support/skills/، بحيث
تكون كل مهارة موجودة مرة واحدة. والتحديث فوق تثبيت من قبل انتقال المساعِدات
إلى .kimi-code/agents/ يُزيل الدليل القديم
<project>/.kimi-code/.apothem/support/agents/ بالطريقة نفسها. وتُحفَظ أولًا نسخة
بطابع زمني من كل دليل مُزال تحت ~/.apothem/backups/.
إلغاء التثبيت
apothem uninstall --harness kimi-code --project /path/to/projectيُزيل كتلة Apothem من AGENTS.md في جذر المشروع، ويُبقي أي نص
واقع خارج العلامات الحارسة. لا يُحذَف الملف إلا حين لا يتبقّى فيه شيء آخر. ويُزيل
كذلك المهارات التي وضعها Apothem تحت <project>/.kimi-code/skills/
(ويُحتفَظ بالمهارات التي أضفتها هناك بأسماء أخرى)، وملفات العوامل الفرعية تحت
<project>/.kimi-code/agents/ (ويُحتفَظ بالملفات التي أضفتها هناك بأسماء
أخرى، ويُزال المجلّد حين يبقى فارغًا)، وملفات الدعم تحت
<project>/.kimi-code/.apothem/support/، بما فيها دليلا skills/
وagents/ القديمان في شجرة الدعم لتثبيت لم يُحدَّث قط. قبل التغيير، تُحفَظ نسخة بطابع
زمني من كل ملف تحت ~/.apothem/backups/؛ ولا يُترك أي ملف نسخ احتياطي في
المشروع. لا يتأثّر ملف YAML الخاص بالملف التعريفي المشترك ولا محرّك
Apothem.
بوابة المطابقة
python -m apothem.conformity.gate --all .استكشاف الأخطاء وإصلاحها
| العَرَض | الإصلاح |
|---|---|
| ملف الإعداد غير موجود | أعد تشغيل apothem install --harness kimi-code --project /path/to/project |
| فشل التحقّق | شغّل apothem update --harness kimi-code --project /path/to/project، ثم تحقّق مجدّدًا |
| المهارات أو المساعِدات مفقودة في Kimi Code | تأكّد من أن --project يسمّي جذر المستودع (الدليل الذي يحوي .git)، ثم أعد تشغيل التثبيت |
| لا يستخدم Kimi Code أي مساعِد أبدًا | اطلبه باسمه. يتولّى Kimi Code المهام بنفسه ما لم يُطلَب التفويض |
| محتوى إعداد غير متوقَّع | افحص ~/.config/apothem/profile.yaml أو --profile PATH، ثم أعد تشغيل apothem update --harness kimi-code --project /path/to/project |
مفاتيح الضبط
| الراية | القيمة الافتراضية | الوصف |
|---|---|---|
--dry-run | false | معاينة التثبيت دون كتابة ملفات. |
انظر أيضًا
- كل أُطُر العمل — الفهرس الكامل للأدوات المدعومة
- دليل التثبيت — ثبّت Apothem في إطار العمل هذا
- مرجع
apothem harnesses— اسرد المحوّلات وافحصها من واجهة سطر الأوامر