verify
مرجع واجهة سطر الأوامر لأمر apothem verify.
يتحقّق من تثبيت محوّل إطار عمل.
الموجز
apothem verify --harness NAME|all [--profile PATH] [--project PATH]
[--quiet|-q] [--verbose|-v]
[--format plain|json] [--json] [--no-color]يستدعي تنفيذ verify() لكل محوّل مختار. ولا يخرج بالرمز 0 إلا عندما تُبلغ
كل المحوّلات المختارة أن أهدافها المُدارة موجودة وصالحة. دون --profile
يكون الفحص بنيويًا — يجب أن يكون كل هدف مُدار موجودًا وصالحًا. ومع
--profile يشترط الفحص إضافةً إلى ذلك الأمانة للملف التعريفي، فيُخفق
التحقّق من تثبيتٍ موجود لكنه منحرف، مجيبًا عن السؤال «هل هذا الملف التعريفي بعينه
مثبّت بأمانة؟» لا عن مجرّد «هل هو موجود؟».
بالنسبة إلى المحوّل الذي يكتب المهارات إلى دليلك المنزلي، يتحقّق verify
أيضًا من أن كل مجلّد مهارة يتوقّعه موجود ومعه SKILL.md، أيًّا كان التثبيت
الذي كتبه، لذا يجتاز التحقّق جهازٌ لم تُثبَّت عليه إلا أداة واحدة من الأدوات التي
تتشارك مجلّدًا. ويُخفق حين يكون مجلّد مفقودًا، وحين يعود مجلّد يحمل اسم مهارة من
Apothem إلى شيء لم يكتبه Apothem. ويذكر الصف الفاشل أيّهما:
في الوضع العادي يليه سطر Note:، وفي صف JSON يسرد كائن
user_level المسارات missing وunlisted
ورسالة message. شغّل install
لاستعادة مجلّد مفقود؛ وأعد تسمية المجلّد الغريب أو انقله، ثم شغّل
update.
يحترم المسح بـ --harness all قائمة exclude_harnesses في
الملف التعريفي — وهي الاستثناءات نفسها التي طبّقتها دفعة
install/update — لذا لا يُبلغ التحقّق أبدًا عن إطار عمل مُستثنى عمدًا
بوصفه مفقودًا. تأتي الاستثناءات من --profile عند تمريره، وإلا فمن الملف
التعريفي الافتراضي؛ وإذا كان الملف الافتراضي غير قابل للقراءة أو غائبًا، يتراجع
السلوك إلى السجلّ الكامل.
الخيارات
| الخيار | الوصف |
|---|---|
--harness NAME | محوّل إطار العمل المراد التحقّق منه، أو all للمجموعة الشاملة للسجلّ كله (مطلوب). |
--profile PATH | ملف YAML للملف التعريفي المشترك الذي تُفحَص الأمانة له. ودونه يكون الفحص بنيويًا بحتًا. |
--project PATH | جذر المشروع لأُطُر العمل ذات نطاق المشروع. |
--quiet, -q | يُخمِد المخرجات المعلوماتية؛ لا تُصدَر إلا الأخطاء. |
--verbose, -v | يُصدِر مخرجات تشخيصية إضافية. |
--format plain|json | صيغة المخرجات (الافتراضي: plain). |
--json | اختصار لـ --format json. |
--no-color | يعطّل رموز ألوان ANSI في المخرجات. |
-h, --help | يعرض المساعدة ويخرج. |
مخرجات JSON
{
"schema_version": 1,
"status": "success",
"command": "verify",
"action": "verified",
"harness": "claude-code",
"files_written": [],
"results": [
{
"harness": "claude-code",
"outcome": "unchanged",
"operation": "verify",
"path": "C:\\Users\\Example\\.claude\\settings.json",
"message": "managed targets verified",
"installed": true,
"verified": true
}
],
"warnings": [],
"error": null,
"installed": true,
"verified": true,
"output_path": "C:\\Users\\Example\\.claude\\settings.json"
}عندما يكون أي إطار عمل مختار مفقودًا أو غير صالح، تكون قيمة status هي
error، ويحمل صفّ النتيجة المُخفِق verified: false، وتخرج
العملية بالرمز 1.
أمثلة
apothem verify --harness claude-code
apothem verify --harness claude-code --json
apothem verify --harness all --project .رموز الخروج
| الرمز | المعنى |
|---|---|
| 0 | تُحقِّق من إطار العمل — كل الأهداف المُدارة موجودة وصالحة |
| 1 | لم يُتحقَّق من إطار العمل — أهداف مُدارة مفقودة أو غير صالحة |
| 64 | خطأ استخدام: خيار أو أمر غير معروف، أو قيمة خيار مفقودة أو غير صالحة. ومع --json يكون الخطأ غلاف JSON يحمل الرمز cli.usage. |
انظر أيضًا
- apothem install — تثبيت إعداد إطار عمل
- apothem update — إعادة تطبيق الملف التعريفي الحالي على إطار عمل
- apothem doctor — تشخيصات التثبيت على مستوى النظام كله