diff

معاينة تغييرات التهيئة المُعلَّقة لمساعد برمجي واحد.

الموجز

apothem diff --harness NAME [--profile PATH] [--project PATH]
             [--quiet|-q] [--verbose|-v]
             [--format plain|json] [--json] [--no-color]

diff أمر فحص للقراءة فقط. ينفّذ التجسيد نفسه الذي ينفّذه أمر install، لكن في وضع التشغيل التجريبي — فلا يُكتَب أي شيء على القرص. ثم يصيّر، لكل هدف مُخطَّط، العملية ومسار الهدف والنتيجة و(بالنسبة إلى المراسي التي يملكها المشغّل والتي سيجري دمجها) الفرق الموحّد للتغيير. إنه الإجابة عن سؤال «ماذا سيفعل apothem install بهذا المساعد البرمجي الآن؟» دون إجراء التغيير.

بالنسبة إلى الأهداف التي يملكها المشغّل — وهي الملفات التي تحمل محتواك الخاص وكتلة يديرها Apothem معًا — يُظهِر الفرق الأسطر التي ستتغيّر بالضبط. أما الأهداف الأخرى، فتُلخَّص العملية والنتيجة المُخطَّطتان.

يعمل diff على مساعد برمجي واحد. وبخلاف status، فهو لا يقبل all؛ مرّر اسم مساعد برمجي واحد.

الخيارات

الخيار	الوصف
`--harness NAME`	محوّل المساعد البرمجي المراد معاينته (إلزامي؛ مساعد واحد، لا `all`).
`--profile PATH`	مسار YAML الملف التعريفي المشترك. الافتراضي `~/.config/apothem/profile.yaml`.
`--project PATH`	جذر المشروع للمساعدات البرمجية بنطاق المشروع. مطلوب عندما يكون المساعد المحدّد بنطاق المشروع.
`--quiet`, `-q`	يُخمِد المخرجات المعلوماتية؛ تُصدَر الأخطاء فقط.
`--verbose`, `-v`	يُصدِر مخرجات تشخيصية إضافية.
`--format plain\|json`	تنسيق المخرجات (الافتراضي: `plain`).
`--json`	اختصار لـ `--format json`.
`--no-color`	يُعطِّل رموز ألوان ANSI في المخرجات.
`-h`, `--help`	يعرض المساعدة ويخرج.

مخرجات JSON

يعكس غلاف --json غلاف التثبيت في وضع التشغيل التجريبي. تكون status بقيمة dry_run، وتكون files_written فارغة دائمًا، وتحمل كتلة materialization وقائمة results كامل تفاصيل الهدف المُخطَّط. ويحمل حقل detail.diff في كل صف نتيجة يملكه المشغّل سلسلة الفرق الموحّد.

{
  "status": "dry_run",
  "command": "diff",
  "action": "dry_run",
  "harness": "claude-code",
  "files_written": [],
  "results": [
    {
      "harness": "claude-code",
      "outcome": "updated",
      "operation": "sentinel_merge",
      "path": "C:\\Users\\Example\\.claude\\CLAUDE.md",
      "message": "dry run: no filesystem changes made",
      "detail": {
        "ownership_class": "operator-owned",
        "diff": "--- a/CLAUDE.md\n+++ b/CLAUDE.md\n@@ ..."
      }
    }
  ],
  "warnings": [],
  "error": null,
  "materialization": { "...": "..." }
}

أمثلة

apothem diff --harness claude-code
apothem diff --harness cursor --project .
apothem diff --harness claude-code --json

رموز الخروج

الرمز	المعنى
0	جرى الإبلاغ عن الفرق (التغييرات المُعلَّقة يُبلَّغ عنها، وليست خطأً)
1	خطأ متوقَّع في التحقّق أو الملف التعريفي أو المساعد البرمجي أو المشروع

انظر أيضًا

apothem status — يُبلِّغ عن حالة التثبيت/التحقّق/الانحراف لكل مساعد برمجي
apothem verify — يتحقّق من تثبيت مساعد برمجي واحد
apothem install — يطبّق التغييرات المُعايَنة