doctor

فحص سلامة ما هو مُثبَّت. فبينما يتحقّق apothem verify من أُطُر العمل التي تختارها، يفحص doctor كل إطار عمل مُثبَّت والملف التعريفي المشترك في تمريرة واحدة.

الموجزCopy Anchor Link

apothem doctor [--project PATH] [--quiet|-q] [--verbose|-v]
               [--format plain|json] [--json] [--no-color]

ما الذي يفحصهCopy Anchor Link

• الملف التعريفي المشترك. يُتحقَّق من الملف التعريفي الموجود مقابل المخطط المُحزَّم؛ ويفشل الملف المشوَّه برمز تشخيصه. أما الملف التعريفي المفقود فيُبلَّغ عنه ولا يُعَدّ فشلًا (يُنشئ install واحدًا).
• أُطُر العمل المُثبَّتة فقط. يُبلَّغ عن إطار العمل غير المُثبَّت بالحالة not_installed ولا يُعَدّ فشلًا، لذا يجتاز الفحصَ جهازٌ فيه إطار عمل سليم واحد. وتُفحَص أُطُر العمل ذات نطاق المشروع عندما يُسمّي --project جذرها؛ ومن دونه يُبلَّغ عنها بالحالة needs_project.
• التحقّق. يجب أن يجتاز كل إطار عمل مُثبَّت الفحص نفسه الذي يُجريه verify.
• زمن تشغيل الخطّافات. لكل إطار عمل جرى التحقّق منه، يقرأ doctor الملفات التي كتبها أحدث تثبيت له، ويعثر على أوامر الخطّافات التي سجّلها Apothem هناك، ويُشغِّل كل مُفسِّر وكل برنامج خطّاف نصّي مرة واحدة بحمولة لا تفعل شيئًا (الوسائط المُسجَّلة مضافًا إليها --help، و{} على stdin، ودليل عمل مؤقّت، مع إزالة PYTHONPATH). لا يُكتَب أي شيء. ويُفشِل الفحصَ مُفسِّرٌ مفقود، أو برنامج نصّي مفقود، أو انهيار وقت الاستيراد.

يُسمّي كل فحص فاشل إصلاحًا له. يخرج بالرمز 0 عندما لا يفشل أي فحص، وبالرمز 1 خلاف ذلك.

مخرجات JSONCopy Anchor Link

يحتفظ --json بالحقول السابقة (version، وpython، وplatform، وprofile_path، وprofile_exists، وprofile_valid، وharnesses، وall_ok، وprofile_error عندما يكون الملف التعريفي غير صالح) ويضيف:

• profile_error_code — رمز تشخيص الملف التعريفي، عندما يكون الملف التعريفي غير صالح.
• project — جذر --project المُحلَّل، أو null.
• harnesses[].status — ok، أو not_installed، أو needs_project، أو verify_failed، أو hook_failed، أو error؛ إضافةً إلى verified وhooks ({"probed": N, "failed": [...]}، أو null عندما لا يوجد سجلّ تثبيت).
• checks — سجلّ واحد لكل فحص: code (مثل harness.verify_failed، أو hook.start_failed، أو ledger.unreadable، أو رمز profile.*)، وstatus (pass، أو fail، أو info)، وharness، وmessage، وfix.

{
  "schema_version": 1,
  "all_ok": false,
  "checks": [
    {
      "code": "hook.start_failed",
      "status": "fail",
      "harness": "claude-code",
      "message": "claude-code: a registered hook command cannot start: …",
      "fix": "Check that the interpreter in the hook command exists and runs, then …"
    }
  ]
}

الخياراتCopy Anchor Link

أمثلةCopy Anchor Link

apothem doctor
apothem doctor --project .
apothem doctor --json

تطبع الصيغة الافتراضية plain تشخيصات مقروءة للبشر؛ ويُصدِر --json (المكافئ لـ --format json) مستندًا قابلًا للقراءة آليًا على stdout، مناسبًا لتمريره عبر الأنابيب إلى أدوات أخرى.

رموز الخروجCopy Anchor Link

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

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