profile

إدارة الملف التعريفي المشترك لـ Apothem.

profile مجموعة أوامر ذات أربعة أوامر فرعية: init، وshow، وset، وedit. الملف التعريفي المشترك هو مصدر الحقيقة الوحيد الذي يُجسِّده كل محوّل إطار عمل في إعداده الأصلي.

الموجزCopy Anchor Link

apothem profile init [--profile PATH] [--force]
                     [--quiet|-q] [--verbose|-v]
                     [--format plain|json] [--json] [--no-color]
apothem profile show [--profile PATH] [--quiet|-q] [--verbose|-v]
                     [--format plain|json] [--json] [--no-color]
apothem profile set KEY VALUE
                     [--profile PATH] [--quiet|-q] [--verbose|-v]
                     [--format plain|json] [--json] [--no-color]
apothem profile edit [--profile PATH] [--quiet|-q] [--verbose|-v]
                     [--format plain|json] [--json] [--no-color]

الخيارات المشتركةCopy Anchor Link

يقبل كل أمر فرعي الخيارات المشتركة أدناه.

الأوامر الفرعيةCopy Anchor Link

profile initCopy Anchor Link

يُنشئ هيكلًا أوّليًا أدنى لملف تعريفي صالح وفق المخطط في ~/.config/apothem/profile.yaml أو --profile PATH. تُحفَظ الملفات الموجودة ما لم يُقدَّم --force.

السطر الأول من الهيكل الأوّلي سطر وضع yaml-language-server يُسمّي قيمة $id لمخطط الملف التعريفي، https://apothem.ahmedgad.com/schemas/profile.schema.json. يقدّم الموقع المخطط المُحزَّم على ذلك العنوان، لذا فإن المحرّر الذي يدعم لغة YAML يتحقّق من الملف التعريفي أثناء تحريرك له. وكل مخطط مُحزَّم تحت src/apothem/schemas/ يُقدَّم بالطريقة نفسها على https://apothem.ahmedgad.com/schemas/<file>.

profile showCopy Anchor Link

يعرض الملف التعريفي المشترك بعد التحقّق منه وتوسيع قيمه الافتراضية. مع --json يكون المستند هو الملف التعريفي نفسه، تتصدّره schema_version: نسخة مخطط الملف التعريفي التي قرأه المحرّك على أساسها (راجع عقد مخرجات JSON).

profile set KEY VALUECopy Anchor Link

يُعيِّن مفتاحًا في الملف التعريفي المشترك. KEY مسار منقوط ينزل داخل الملف التعريفي المتداخل (identity.name، وpreferences.style، وenforcement.sprints، وharnesses.<harness>.preferences.style)؛ والمفتاح المفرد الذي لا نقطة فيه يُعيِّن عقدة في المستوى الأعلى. تُخزَّن VALUE سلسلةً حرفية — لا تُحوَّل الكلمات المجرّدة قسرًا (تبقى no هي "no"، وتبقى 2024-01-01 و1.0 سلاسل نصّية) — باستثناء true/false (أعلام الفرض المنطقية) والإدخال الصريح [...]/{...} بصيغة قائمة/خريطة. ويُتحقَّق من الملف التعريفي المُجمَّع بالكامل مقابل المخطط قبل الكتابة؛ ويُرفَض التعيين غير الصالح ويبقى الملف التعريفي على القرص دون تغيير.

profile editCopy Anchor Link

يفتح الملف التعريفي المشترك في محرّر النظام.

أخطاء التحقّقCopy Anchor Link

كل أمر يقرأ الملف التعريفي يتحقّق منه مقابل المخطط المُحزَّم ويُبلِغ عن كل مشكلة يجدها في تمريرة واحدة، بحيث يمكن لتعديل واحد أن يُصلحها جميعًا:

• المخرجات النصّية العادية تُسمّي المشكلة الأولى كاملةً (Field، وReason، وFix، وOffending value (redacted): المُدخَل الذي فشل، مع استبدال القيم ذات هيئة الأسرار بـ <redacted>؛ وهو ليس أبدًا بديلًا مقترحًا)، ثم تسرد حتى عشر مشكلات أخرى تحت Other problems.
• مخرجات JSON تحتفظ بالمشكلة الأولى في حقول المستوى الأعلى من الكائن error، وتضيف مصفوفة errors تضمّ كل مشكلة (code، وfield، وreason، وfix، وsafe_value).
• المفاتيح غير المعروفة لا تُردِّد إلا المفتاح غير المتوقَّع وقيمته المُنقَّحة، لا الملف التعريفي كاملًا.
• علامات الكتلة المُدارة. لا يجوز لأي مفتاح أو قيمة نصّية أن يحتوي <!-- BEGIN APOTHEM MANAGED BLOCK --> أو <!-- END APOTHEM MANAGED BLOCK -->. يكتب Apothem هاتين العلامتين حول الكتلة التي يديرها في ملفات التعليمات، ويقع نصّ الملف التعريفي داخل تلك الكتلة، لذا فإن وجود علامة فيه سيشطر الكتلة. ويفشل كل حقل من هذا النوع بالرمز profile.managed_block_marker: يكون field مساره المنقوط (مثل rules.2 أو mcp_servers.search.env.SEARCH_MODE) ويُسمّي reason العلامة. ولا تُردَّد القيمة نفسها أبدًا (قيمة safe_value هي null)، إذ قد تكون بيانات اعتماد.

يكتب profile init (وكل أمر آخر يُنشئ هيكلًا أوّليًا لملف تعريفي) schema_version: 1. ويُقرَأ الملف التعريفي الذي لا يحمل schema_version على أنه النسخة 1.

أمثلةCopy Anchor Link

apothem profile init
apothem profile init --profile ./profile.yaml --force --json
apothem profile show
apothem profile show --json
apothem profile set seriousness SHARED
apothem profile set rules '["Use fake placeholders in examples."]'
apothem profile edit

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

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

• apothem install — يُجسِّد الملف التعريفي في إطار عمل
• apothem doctor — يُشغِّل تشخيصات التثبيت على مستوى النظام