دليل مستخدم ZIAForge

الخطوات الأولى

يحتفظ ZIAForge بالمناقشة والتخطيط والتنفيذ والتحقق في مهمة واحدة. اختر Code لمشروع Git، أو Work للمستندات والبحث والنتائج الأخرى في مجلد عادي.

ابدأ بمهمة صغيرة في مشروع منفصل. إذا اخترت CLI أصليًا، فقم بتثبيته وتسجيل الدخول بحسابه الخاص في محطة طرفية أولاً. بدلاً من ذلك، قم بتكوين اتصال API. اشتراك CLI وAPI المدفوع هما طريقتان منفصلتان للاتصال؛ لا يقوم ZIAForge بتسجيل دخولك أو نقل الأرصدة بينهما.

1. افتح الإعدادات وتحقق من مجلد مساحة العمل واللغة. تعرض صفحة «حول» الهوية الدقيقة للبناء قيد التشغيل.
2. بالنسبة لـ Code، أضف مستودع Git في الشريط الجانبي. بالنسبة لـ Work، اختر مجلدًا منفصلاً عند إنشاء المهمة.
3. احفظ إعدادًا مسبقًا باستخدام CLI، وطراز، وجهد التفكير المنطقي، ومستوى الوصول. يمكنك أيضًا تحديد «مخصص» مباشرةً دون إعداد مسبق محفوظ.
4. أنشئ مهمة، واختر مسارها، وأدوارها، والتقدم اليدوي أو التلقائي. راجع الخيارات قبل البدء.

التعليمات ذات الصلة: نظرة عامة على المشروع · توافق الموفرين.

تثبيت حزمة سطح المكتب الصحيحة

اختر حزمة لنظام التشغيل وبنية CPU لديك: x64 أو arm64. يمكن لخط أنابيب البناء إنتاج تنسيقات macOS DMG/ZIP، ومثبت Windows NSIS/ZIP، وLinux DEB/RPM/AppImage/tar.gz/ZIP. الملف الذي تم إنشاؤه أو البناء المتقاطع ليس دليلاً على نجاح مثبت البرنامج وUI الأصلي على جهازك؛ راجع سجل التحقق من هذا الإصدار.

تتطلب بنيات macOS التي تستخدم Electron 44 وجود macOS 13 أو أحدث. استخدم حزمة arm64 على Apple Silicon وحزمة x64 لأجهزة Intel. قم بإنهاء التطبيق الأقدم تمامًا قبل الاستبدال. قد تكون حزم المعاينة غير موقعة وغير موثقة؛ لا تخلط بين عناصر التطوير والإصدار العام الموقع.

يحتاج Windows إلى نظام تشغيل مدعوم من إصدار Electron المجمع وGit المتوفر في PATH. اختر البنية المطابقة. لا تملك المعاينة غير الموقعة شهادة Authenticode. يجب أن يحتفظ ZIP المحمول بدليل التطبيق الكامل وملفات وقت التشغيل، وليس فقط ملفه التنفيذي.

يحتاج Linux إلى سطح مكتب رسومي متوافق، ومكتبات النظام التي يتطلبها Electron، وGit. لبيانات اعتماد التحكم المشفرة، وفر خدمة أسرار (Secret Service) صالحة مثل gnome-libsecret أو KWallet؛ لا يتم قبول الواجهة الخلفية غير الآمنة basic_text. لا تصادق أدلة الاختبارات الأولية في البيئات الخالية من واجهة رسومية/الحاويات على كل سطح مكتب أو توزيعة.

قم بتثبيت DEB باستخدام apt install ./file.deb، أو قم بتثبيت RPM من خلال مدير الحزم الخاص بتوزيعتك. يحتاج AppImage إلى إذن تنفيذي ودعم FUSE مناسب؛ ويُعد --appimage-extract-and-run بديلاً حيثما كان مدعومًا. استخرج حزم tar.gz وZIP مع جميع ملفات وقت التشغيل الخاصة بها. حافظ على الفصل بين بيانات المستخدم وملفات التطبيق عند استبدال حزمة.

للبناء من المصدر، استخدم Node 24 وGit وnpm ci، بما في ذلك مثبت Electron العادي. تتطلب عمليات إعادة البناء الأصلية أدوات النظام الأساسي: أدوات سطر أوامر Xcode على macOS؛ وMSVC C++ وWindows SDK وPython على Windows؛ والمترجم وmake وPython وpkg-config وأدوات التحزيم المطلوبة على Linux. اتبع PLATFORM_BUILDS.md للأوامر الدقيقة وحدود النظام الأساسي الحالية.

يتم حجز إصدارات الإطلاق مركزيًا وتكون المخرجات غير قابلة للتغيير. بناء التحقق CI ليس مثبتًا منشورًا. تحتوي أرشيفات المصدر على التعليمات البرمجية المصدرية وملف القفل والوثائق والبرامج النصية؛ وتُستثنى التبعيات وبيانات الاعتماد وملفات تعريف المستخدمين والأبحاث الخاصة. لا تستنتج أبدًا صحة ARM أو Windows الأصلية من بناء x64 ناجح.

التعليمات ذات الصلة: حزم المنصات، والمتطلبات الأساسية، وحدود التحقق · هوية البناء وفحوصات الإصدار.

Code: خمسة مسارات

يُقيّم Auto النطاق: قد ينتهي السؤال البسيط بإجابة، بينما تحتاج المهمة الأكبر إلى تحضير. يستقصي «إصلاح خطأ» السبب ويُعد تصحيحًا. يبدأ «المواصفات أولاً» بالحل الفني؛ بينما يبدأ «المتطلبات أولاً» بالمتطلبات ومعايير القبول.

يستخدم «متعدد الطرز» سياقات منفصلة للاستكشاف والتصميم والتنفيذ والمراجعة. لا يتطلب اسم المسار موفرين مختلفين: يستخدم كل دور الإعداد المسبق أو التكوين المخصص الذي تختاره.

تعزل شجرة العمل (Worktree) تغييرات Git الخاصة بمهمة ما. يعمل «الفرع» في النسخة المحددة التي تم سحبها. تحقق من المشروع والفرع والطراز قبل البدء؛ لا يتم إرسال وصف المهمة أيضًا إلى محادثة عادية.

بالنسبة لفكرة ذات خيارات تقنية أو متعلقة بالمنتج لم تُحسم بعد، استخدم «المتطلبات أولاً» وقم ببناء الأساس في المناقشة. يُصنّف Auto الطلب؛ وهو ليس أمرًا بتنفيذ كل عبارة قصيرة على الفور. يحفظ «حفظ المسودة» الطلب دون الاتصال بطراز؛ ويحفظ «بدء» التدفق المُدار ويطلقه مرة واحدة. تملك النسخ المكررة للمهمة (من نسخة واحدة إلى أربع نسخ) معرّفات إنشاء وإعدادات أدوار مستقلة.

التعليمات ذات الصلة: عقد سير عمل Code · ملفات تعريف مطالبات Code.

مناقشة Forge

يفتح «بدء» المناقشة المركزية. قم بالرد بشكل طبيعي، واطرح أسئلة معاكسة، وأضف قيودًا، وناقش الخيارات الفنية. تبقى المحادثة والأسئلة مع المهمة.

لا يعني إرسال النص قبول مستند أو تفويض خطة تنفيذ جديدة. يؤدي التوضيح أثناء التنفيذ أولاً إلى إيقاف الدور المُدار مؤقتًا وإعادة النظر في النطاق المتأثر. يمكن للإجابة عن سؤال ضمن خطوة مقبولة بالفعل مواصلة تلك الخطوة.

لإعادة النظر في الأساس بشكل متعمد، حدد «المتطلبات» أو «المواصفات» أو «التخطيط». يتطلب الإصدار الجديد قبولاً جديدًا للقرارات التابعة. تظل الخطوات المكتملة وأدلتها قائمة؛ وتبقى المراحل غير المكتملة التي تم استبدالها في السجل.

تختلف جلسات المراحل المُدارة عن المحادثة الحرة. استخدم مناقشة Forge بدلاً من إرسال مطالبات يدوية مباشرة إلى جلسة مملوكة لسير العمل.

التعليمات ذات الصلة: عقد مناقشة Forge.

المستندات والقرارات

افتح مستندًا، وتفقد إصداره، وأجرِ تعديلات عند الحاجة. يؤدي إرسال التعديلات عبر المناقشة إلى إنشاء إصدار جديد؛ لا يُعاد كتابة التقارير والنتائج التي تم التحقق منها بأثر رجعي.

قبل قبول خطة مقترحة، عدّل الترتيب والتعليمات ومعايير القبول وأوامر التحقق. فوض الأوامر الملموسة التي تفهمها: فهي تعمل في مجلد المهمة. يقترح «متعدد الطرز» خطوة تنفيذ واحدة لكامل المهمة، مع تفاصيل في مستنداته وتعليماته.

يُعد «الموافقة» قرارًا مدروسًا ومنفصلاً. لا يتجاوز Auto الأسئلة أو قبول المتطلبات والمواصفات والخطط. لا يمكن لمستند تم تغييره خارجيًا إعادة استخدام موافقة قديمة.

تظهر ملفات التحضير كمصنوعات (artifacts). يربطها إصدارها ومرحلة إنتاجها والتجزئة (hash) بنتيجة معينة. تظل مستندات Code خارج شجرة العمل ولا تدخل تلقائيًا في إيداع (commit).

تحقق من كل من المستند والقرار المعروض قبل القبول. يربط القبول ID البوابة الحالي ومراجعة الخطة وتجزئات المستندات المحتفظ بها. اطلب تغييرات عندما يكون النطاق أو الدليل غير صحيح. إذا أصبح القرار قديمًا، فأعد تحميل الحالة المحفوظة قبل اتخاذ خيار جديد؛ لا يمكن قبول ملف تم تغييره بموجب إصدار سابق.

التعليمات ذات الصلة: بوابات سير العمل وإصدارات المستندات.

التنفيذ والمراجعة

تُظهر «قائمة المهام» الخطوات الحقيقية والمحاولة الحالية ونتائج التحقق والمراجعة. لا يؤدي قول الوكيل "تم" إلى إكمال خطوة: يجب أن يتوفر الدليل المطلوب في الخطة.

يتوقف الوضع اليدوي مؤقتًا بين الخطوات المؤهلة. يُقدّم Auto الخطوات التي تم التحقق منها ويتيح محاولات إعادة محدودة. يُنشئ «إيقاف بعد» دائمًا نقطة فحص. يوقف «إيقاف مؤقت» العمل النشط لسير العمل؛ ولا يؤدي إغلاق اللوحة إلى إيقافه.

يستخدم المراجع المستقل سياقًا منفصلاً يحتوي على الملفات ونتائج التحقق. يجب حل كل نتيجة حظر مطلوبة؛ ولا يؤدي وجود مراجعين متعددين إلى إسقاط خطأ حظر بالتصويت.

في «متعدد الطرز»، يتطلب تصحيح النتائج قرارًا صريحًا. لا يبدأ التصحيح مراجعة أخرى بصمت: يفتح «مراجعة مرة أخرى» دورة جديدة. يمكن لتعليقات المراجعة أن تطلب إعادة النظر من المنسق دون تكرار التنفيذ.

لا يمكن تعديل الخطوات المكتملة بصمت. مع TDD، يجب أن تفشل الخطوة الحمراء (Red) فعليًا للسبب المتوقع، ثم يجب أن تنجح الخطوة الخضراء (Green). تمنع المحاولات المحدودة عمليات إعادة المحاولة اللانهائية.

احفظ مراجعي CLI/API المستقلين في «الإعدادات ← فرق المراجعة»، ثم حدد الفريق في Code أو Work. يعمل المراجعون بالتوازي، ويليهم مهندس تقارير الفريق. يمكنك أيضًا تكوين مراجعين مستقلين دون فريق محفوظ. يتلقى مهندس التقارير تقارير منظمة ومجهولة المصدر فقط، دون ملفات المشروع أو الأدوات؛ يتطلب هذا العزل حاليًا Claude Code أو API.

تحتاج كل خطوة تنفيذ إلى فحص قابل للتنفيذ، أو مراجعة مستقلة مطلوبة، أو كليهما. بدلاً من ذلك، تحتفظ مراحل التحضير بنتائج تم التحقق من صحتها وإيصالات المصنوعات؛ ولا تدعي هذه المراحل تشغيل اختبارات التنفيذ. لا ينجح الأمر إلا بعد تأكيد حالة الخروج الفعلية وتنظيف العمليات التابعة له. يجب أن يفشل فحص الخطوة الحمراء (Red) لـ TDD بشكل طبيعي قبل التنفيذ والتحقق من الخطوة الخضراء (Green)؛ ولا يُعد الملف التنفيذي المفقود أو انتهاء المهلة نتيجة حمراء صالحة.

تتوقف قواطع الدائرة الافتراضية بعد ثلاث محاولات فاشلة في خطوة واحدة أو خمسين محاولة إجمالاً. يستهلك المقاطعة محاولة ولكنه لا يُحسب بحد ذاته كمحاولة فاشلة. تظل الحدود والأدلة المكتملة قائمة بعد إعادة التشغيل؛ ولا تؤدي «إعادة المحاولة» إلى إعادة تعيينها. اقرأ الفشل المحتفظ به قبل تفويض محاولة أخرى.

التعليمات ذات الصلة: التحقق والمراجعة.

فرق المراجعة المتوازية ومهندس التقارير

افتح «الإعدادات ← فرق المراجعة» واحفظ فريقًا. أضف مراجعين مستقلين مع CLI أو API الخاص بهم، والطراز، وجهد التفكير المنطقي، والتخصص، ثم اختر مهندس تقارير. حدد الفريق في تكوين مراجعة المهمة. يمكن أيضًا للمراجع استخدام إعداد مسبق للمنفذ، ويظل «مخصص» متاحًا؛ ولا تزال للأدوار المستقلة سياقات منفصلة.

يعمل المراجعون بالتوازي على نفس أدلة المهمة. يتم الاحتفاظ بكل تقرير مطلوب وخطأ وحكم. يتلقى المهندس المعماري تقارير مرقمة ومجهولة المصدر دون أسماء المراجعين أو هويات الطراز أو الموفر أو محتويات المهمة الأصلية أو الوصول إلى المستودع أو الأدوات. ويقارن التقارير ويعيد حكمًا منظمًا واحدًا؛ ولا يُجري مراجعة جديدة للمصدر.

لا يمكن التنازل عن نتيجة حظر أو رفض مراجع مطلوب عن طريق تصويت الأغلبية أو تفضيل المهندس المعماري. تمنع التقارير المفقودة أو المشوهة الموافقة. افحص النتائج الفردية والقرار الإجمالي قبل قبول التصحيحات أو تفويضها. يتم حل الفريق المحفوظ وتجميده للتشغيل؛ ولا يؤدي تعديل إعداده المسبق إلى إعادة كتابة الأدلة المكتملة.

يستخدم مهندس التقارير فقط حاليًا تكوينات خالية من الأدوات مدعومة في Claude أو API. يظل Codex وAntigravity متاحين كمراجعين ولكن يُرفضان لدور المهندس المعماري المعزول هذا حتى يتوفر عقد موثق وخالٍ من الأدوات. لا تكفي المطالبة التي تنص على "لا توجد أدوات" وحدها.

التعليمات ذات الصلة: تكوين الفريق المكتوب نوعيًا · تجميع المراجعات.

تخصصات الوكيل وسياسة المطالبات

الطراز هو محرك التنفيذ؛ والتخصص هو ملف تعريف التعليمات. اختر «لا شيء» لعدم إضافة تخصص، أو «قياسي» للدليل الافتراضي، أو Auto للحصول على دليل مضمن ذي صلة، أو «يدوي» للأدلة المحددة وتعليماتك المقيدة الخاصة. يمكن للإعدادات المسبقة الاحتفاظ بالتحديد.

يغطي الكتالوج الأصلي البرمجة العامة، والهندسة المعمارية، والأمان، والموثوقية، والأداء، والاختبار، وسهولة استخدام الواجهة. يستخدم Auto نص المهمة/الخطوة المتاح لتحديد دليل؛ ولا يستدعي سرًا طرازًا آخر أو يصدق على الخبرة. يمكن فحص اقتراحات التخطيط وتغييرها قبل قبول خطة التنفيذ.

تساعد تخصصات المراجعة في توجيه الانتباه ولكنها لا تحل أبدًا محل الأدلة المستقلة أو حدود الوصول أو الحكم المنظم. تعامل مع التعليمات المخصصة كجزء من نطاق المهمة: لا تستخدمها لتجاوز قبول المستندات أو سياسة الأدوات أو المصادقة أو إخفاقات المراجعين.

التعليمات ذات الصلة: كتالوج المطالبات الأصلي.

Work: من السؤال إلى المستند

لا يتطلب Work وجود Git. ينشئ «افتراضي» مجلد مهمة منفصلاً؛ بينما يحدد «مخصص» مجلدًا موجودًا عبر أداة الاختيار الأصلية. يحفظ «حفظ المسودة» الإعدادات دون استدلال؛ ويقوم «بدء» بتشغيل المرحلة الأولى.

يجيب Auto مباشرة أو يقترح خطة مناسبة بمهام حقيقية. ينشئ العصف الذهني ideas.md قبل اختيار مزيد من الأفكار أو التقييم. يحتفظ البحث بـ findings.md والمصادر والقيود. ينتقل الكتابة من النية، وعندما يكون ذلك مفيدًا، من outline.md إلى مستند وصفي أو draft.md؛ وتحتفظ المراجعات بالإصدارات السابقة.

حدد مدخلات الملفات عبر أداة الاختيار الأصلية وأشر إليها باستخدام @. ينسخها التطبيق كمدخلات مهمة غير قابلة للتغيير ويتحقق من هويتها قبل التشغيل. ينشئ «افتراضي» مجلد مهمة مملوكًا للتطبيق؛ بينما يُعد الوصول إلى المجلد المخصص إذنًا محفوظًا من المالك. يمكن لمسودة محفوظة وغير مبدوءة تغيير مجلدها.

أنشئ نسخًا من 1 إلى 4 بإعدادات منفذ مستقلة. لا يمكن للمهام التي تستخدم مجلدات متداخلة الكتابة بالتزامن. ينطبق هذا التنسيق على عمليات ZIAForge، وليس على البرامج الخارجية العشوائية.

يستخدم «العصف الذهني العميق» ثلاثة عمال مستقلين افتراضيًا ويدعم ما يصل إلى ثمانية. حدد ترتيبهم وتكويناتهم، بما في ذلك إعادة استخدام إعداد مسبق في سياقات منفصلة. تحتفظ أسئلة العامل بأصولها؛ وتحصل التقارير المشوهة على محاولة إصلاح تنسيق واحدة. يظل الفشل الجزئي مرئيًا بدلاً من تقديمه على أنه نجاح بالإجماع.

يجمع «العميق» تقارير العمال المحتفظ بها في brainstorm_report.md ويطلب دائمًا قرارًا من المستخدم. تعمل المتابعة الصغيرة على مراجعة التقرير من خلال المنسق؛ وتبدأ التغييرات الكبيرة جولة أخرى من العمال المجمدين. تحتفظ المصنوعات بإصداراتها.

تُجمد الأدوار المحلولة عند إنشاء المهمة أو حفظ المسودة صراحةً. بعد الاستدعاء الأول، يمكن فقط تغيير التقدم التلقائي/اليدوي؛ استخدم مهمة جديدة لإعدادات أدوار أو طراز مختلفة. لا يؤدي تعديل إعداد مسبق عام إلى تغيير المراحل اللاحقة بصمت.

يتوقف الوضع اليدوي مؤقتًا بين المراحل المؤهلة، بما في ذلك المخطط التفصيلي الجوهري للكتابة. يمكن لـ Auto المتابعة عبر هذا المخطط التفصيلي. تظل الأسئلة، والخطط التنفيذية المقترحة، واتجاه العصف الذهني، ومراجعة التقرير العميق قرارات صريحة حتى في Auto. الاقتباس وحده لا يثبت حدوث التصفح، والملف الثنائي المحتفظ به وحده لا يثبت عرضه.

التعليمات ذات الصلة: أوضاع وقرارات Work.

الإعدادات المسبقة، والطرز، والوصول

يحفظ الإعداد المسبق CLI/API، والطراز، وجهد التفكير المنطقي، والأذونات. يحتوي تذييل المحادثة على أجزاء الإعداد المسبق، وCLI، والطراز، والخيارات. يعمل «مخصص» بدون إعداد مسبق؛ ويحفظ «إنشاء إعداد مسبق» التحديد الحالي.

يأتي الدليل من CLI أو API المثبت المحدد حيثما كان مدعومًا. يُحدّث «تحديث» القائمة دون تغيير التحديد. إذا كان الاكتشاف غير متاح، فأدخل ID طراز صريح؛ ويجب أن يظل الموفر يدعمه. تعتمد مستويات التفكير المنطقي على الطراز وCLI. يختلف الإعداد الافتراضي للموفر عن رمز «لا شيء» الصريح.

لا تطبق التغييرات إلا بعد إقرار الواجهة الخلفية. يتم تقييد التبديل أثناء دور نشط أو قائمة انتظار غير فارغة. تظل المسودات والسجل المرئي كما هي، ولكن تغيير الموفرين لا ينقل حالتهم الداخلية الخاصة.

في Forge، يُعد تصنيف الدور مهمًا: يمكن أن يستخدم التحضير «مخططًا» منفصلاً. يغير التذييل الدور المعروض؛ ويتم تحديد المراجعين والمساعدين في إعدادات سير العمل. قد يتم قفل السياسة الخاصة بالتنفيذ الذي تم التحقق منه بالفعل.

تختلف الأذونات بين الموفرين. تتوفر «للقراءة فقط» و«كتابة مساحة العمل» حيثما يدعم المحول ذلك. يستخدم Antigravity إعدادات CLI الأصلية أو الوصول الكامل المحدد صراحةً. الوصول الكامل ليس بيئة معزولة (sandbox).

يضيف التخصص توجيهًا للمطالبات، وليس طرازًا آخر أو إذنًا إضافيًا. تدعم الإعدادات المسبقة والأدوار «لا شيء»، و«قياسي»، وAuto، و«يدوي». يحدد Auto ملفات التعريف من نص الخطوة دون استدعاء طراز إضافي؛ ويقبل «يدوي» ما يصل إلى أربعة تخصصات وتعليمات مخصصة. يمكن تعديل المهام المقترحة من قِبل المخطط قبل قبول الخطة.

يظل إدخال ID الطراز أو الجهد يدويًا هو خيارك، ولكن قد يرفضه الموفر. لا يؤدي تعديل إعداد مسبق عام إلى تغيير محادثة قيد التشغيل أو خطة مقبولة بأثر رجعي. لتغيير محادثة خاملة عن قصد، استخدم عناصر التحكم في التكوين الخاصة بها وانتظر الإقرار. يجب قراءة الخيار المعطل على أنه حد في الإمكانات أو دورة الحياة، وليس تجاوزه عن طريق تحرير JSON المحفوظ.

التعليمات ذات الصلة: إمكانات الموفر.

المحادثات، والإيقاف، وقائمة الانتظار

تنتمي علامات التبويب المفتوحة، و«الأخيرة»، والمسودات إلى مهمة واحدة. يؤدي إغلاق علامة تبويب إلى إزالتها من «المفتوحة» مع الاحتفاظ بها في «الأخيرة»، ولا يوقف ذلك عملية الموفر الخاصة بها أو سير العمل المُدار. ابحث في السجل، أو أعد فتح محادثة، أو أغلق جميع علامات التبويب الإضافية من قائمة السجل.

يوقف «إيقاف» الدور الحالي مؤقتًا. انتظر حتى يكتمل التوقف قبل «الإرسال» التالي: الإقرار بالمقاطعة ليس اكتمالاً للعملية. يمكنك كتابة المسودة التالية في هذه الأثناء.

في المحادثة العادية، يحفظ «قائمة الانتظار» طلبًا لاحقًا بشكل منفصل عن المسودة الحالية. يوقف «إيقاف قائمة الانتظار مؤقتًا» التسليم الإضافي. يوقف «إيقاف» و«إنهاء» قائمة الانتظار مؤقتًا. بعد إعادة التشغيل، قم بـ «الاستئناف» أولاً، ثم «متابعة قائمة الانتظار» صراحةً.

«غير مؤكد» تعني أن حالة التسليم غير معروفة. لا يُعاد إرسال مثل هذه الرسالة تلقائيًا: افحص السجل، وانسخ النص إذا كان ذلك مناسبًا، وتجاهل العنصر الموجود في قائمة الانتظار. يُعد إرسالها مرة أخرى طلبًا جديدًا ومقصودًا.

تستخدم محادثات المراحل المُدارة سير العمل الخاص بها، وليس قائمة الانتظار العادية. يُظهر «متابعة المرحلة» المرحلة الحالية؛ يؤدي التحديد اليدوي لعلامة تبويب أخرى إلى إيقاف المتابعة. تُظهر سجلات CLI التشخيصات بشكل منفصل عن الاستجابة.

تعرض استجابات Markdown العناوين، والقوائم، والجداول، والروابط، والتعليمات البرمجية المحاطة بأسوار. تظل بطاقات الأدوات وتشخيصات CLI منفصلة عن الإجابة. يظهر التفكير المنطقي ومقاييس الرموز التي يبلغ عنها الطراز فقط عندما يكشف الموفر عنها فعليًا؛ لا تستنتج تفكيرًا منطقيًا خاصًا أو استخدامًا من الرسوم المتحركة.

بعد إرسال غير مؤكد أو إقرار من قائمة الانتظار، افحص السجل وأعد محاولة نفس الطلب المحتفظ به فقط عند إتاحته. يعني إيصال قائمة الانتظار أن التخزين قد قبل العنصر، وليس أن الاستدلال قد اكتمل. قم بإزالة عنصر غير مؤكد من قائمة الانتظار فقط كإجراء رفض صريح؛ لا يمكن لذلك سحب مطالبة تم تسليمها بالفعل.

التعليمات ذات الصلة: قائمة انتظار الرسائل الدائمة.

الملفات، وGit، والاكتمال

تعرض «الملفات» مجلد المهمة. قارن النتائج بالمتطلبات، وافتح المستندات، وتفقد الفروق (diffs). لا يثبت الاحتفاظ بملف ثنائي عرضه بشكل صحيح في تطبيقه المستهدف.

يوفر Git الحالة والتغييرات والعمليات مع النتائج المسجلة. تكون عمليات الإيداع (Commit) والدمج (Merge) والدفع (Push) يدوية بشكل افتراضي؛ وتُعد العمليات التلقائية خيارات منفصلة لخطة تم التحقق منها بالكامل.

لا تغير ملفات العمل بين التحقق والنشر: فالموافقة مرتبطة بالبايتات الدقيقة. تعوق التعارضات، وعمليات الدفع الفاشلة، ونتائج العمليات غير المعروفة التقدم حتى يتم اتخاذ قرار صريح. لا يخول Auto النشر بصمت.

لا يُنشئ Work أي فروع Git وليس لديه وضع نهائي لـ Git. احتفظ بالمستندات المطلوبة من المجلد المحدد، بما في ذلك الإصدارات والمصادر.

يوفر محرر الملفات تمييز بناء الجملة حسب الامتداد، والبحث والاستبدال، وسجل التراجع، والتفاف الأسطر، ومسودات لكل علامة تبويب. تحافظ عمليات الحفظ على ترميز UTF-8/UTF-16 المدعوم وترفض تعارضات التعديل الخارجية. تتطلب الترميزات الأخرى والمحتوى الثنائي محررًا خارجيًا. تمنع المسودات غير المحفوظة إنهاء التطبيق حتى يحفظها المالك أو يتجاهلها.

يتم تمكين التمييز اللوني الكامل لبنية النص (full syntax) حتى 8 MiB. وتُفتح الملفات النصية الأكبر حجمًا في نوافذ بحجم 256 KiB؛ كما يمكن تحميل الملفات التي يتراوح حجمها بين 8 و64 MiB صراحةً بالكامل بدون التمييز اللوني للبنية. وفوق 64 MiB، استخدم تحرير النوافذ والبحث المقيد عن التطابق التالي. هذا وضع محدود للملفات الكبيرة، وليس تكافؤًا تامًا مع Sublime Text للمستندات الكبيرة بأي حجم عشوائي.

يستخدم «فتح مجلد» سياق المهمة الحالية أو الفرع/شجرة العمل، بدلاً من فتح المستودع الأصلي فقط بصمت. يمكن لصف الملف الكشف عن الدليل الأصل لذلك الملف. يتم التحقق من صحة المسارات بواسطة الواجهة الخلفية مقابل أذونات المهمة المسجلة. لا يمكن تحرير الملفات الثنائية كنص عادي؛ استخدم العارض المستهدف واحتفظ بالبايتات الأصلية.

تُعد إزالة شجرة العمل إجراءً محميًا ومنفصلاً. أنهِ الجلسات المنظمة ومحطات الطرفية المتصلة قبل إزالتها، بما في ذلك الجلسات الخاملة. افحص نتيجة Git المحفوظة وحالة الاسترداد؛ فحذف سجل المهمة ليس بديلاً عن الحفاظ بأمان على العمل غير المودع.

التعليمات ذات الصلة: عقد المحرر المكتوب نوعيًا · سياسات Git.

اتصالات API

تضيف «الاتصالات» نقطة نهاية متوافقة مع OpenAI محددة صراحةً. أدخل اسمًا، وURL أساسيًا، وطرازًا، ومفتاحًا إذا لزم الأمر. تتطلب العديد من الخوادم URL أساسيًا ينتهي بـ /v1؛ راجع وثائق نقطة النهاية الخاصة بك.

يلزم HTTPS باستثناء HTTP للاسترجاع الداخلي. استخدم نقطة نهاية عادية دون بيانات اعتماد مضمنة في URL. تستخدم المفاتيح تشفير OS المدعوم ولا يتم إرجاعها إلى UI. يتطلب تغيير نقطة النهاية إعادة إدخال مفتاحها. يؤدي ترك حقل المفتاح فارغًا إلى الاحتفاظ بمفتاح محفوظ؛ يؤدي «إزالة المفتاح المحفوظ» إلى مسحه صراحةً.

لا تستخدم استدعاءات API اشتراك CLI. تختلف الأدوات والطرز عن الجلسات الأصلية، ولا يثبت اكتشاف الطراز الناجح إتمام الاستدلال. تظهر بيانات استخدام الرموز فقط عندما يعيدها الموفر فعليًا.

احتفظ ببيانات الاعتماد في «الاتصالات» بدلاً من نصوص المهمة أو تعليمات الإعداد المسبق. يتلقى المراجعون للقراءة فقط أدوات ملفات API المصرح بها لهم فقط؛ ولا يملك مهندس التقارير أي أدوات. يتم رفض استدعاءات الأدوات غير المدعومة بدلاً من تنفيذها بصمت. تختلف الخوادم في معلمات التفكير المنطقي، ودعم الأدوات، وقوائم الطرز؛ قارن أي خطأ بالعقد الخاص بنقطة النهاية لديك.

التعليمات ذات الصلة: اتصالات API.

الإعدادات، واللغات، وإعادة الضبط الآمنة

تحدد الإعدادات العامة مساحة العمل ولغة الواجهة والإعدادات الافتراضية. تدير «الاتصالات» نقاط نهاية API. تحتفظ «الإعدادات المسبقة» و«فرق المراجعة» بتكوينات الأدوار. يدير «التحكم عن بُعد» بيانات الاعتماد المحلية ونطاق الخادم وأذونات المالك؛ وتدير «التحديثات» مصدر الإصدار/القناة. يُظهر «حول» بنية التشغيل الدقيقة.

لغة الواجهة منفصلة عن لغة المطالبة وحالة مراجعة الوثائق. تظل أسماء المنتجات ومعرفات الأوامر وامتدادات الملفات ومعرفات نماذج المزود والأسماء التي ينشئها المستخدم معرفات. تتبع المساعدة لغة الواجهة المحددة عند توفر ترجمة حالية؛ وتُوضع علامات على الترجمات الآلية وتظل اللغة الإنجليزية هي المرجع المعتمد.

يؤدي حفظ إلى تطبيق التكوين المعروض. يمكن أن تؤدي إعادة ضبط قاعدة البيانات أو إعادة الضبط بحسب إعدادات المصنع إلى إزالة بيانات التعريف الخاصة بالتطبيق؛ احتفظ بالملفات وبنسخة احتياطية مجربة قبل استخدام إعادة الضبط عمداً. هذه العمليات هي إجراءات خاصة بالمالك المحلي. لا تستخدمها كاختصار للتحقيق في سير عمل فاشل أو سجل تالف.

التعليمات ذات الصلة: تعليمات الترجمة والتوطين · استعادة البيانات.

اسأل مساعد المساعدة

افتح «المساعدة»، واختر إعداداً مسبقاً متصلاً ومحفوظاً في لوحة المساعد الخاصة بها، واطرح أسئلة حول ZIAForge. تستخدم الإجابات الدليل المرجعي الإنجليزي الحالي ولغة الواجهة المحددة لديك. تفتح أزرار مراجع الأقسام مواضيع الدليل ذات الصلة، بحيث يمكنك مقارنة التفسير بالمرجع.

يحتفظ هذا المساعد بمحادثة خاصة منفصلة تتسع لما يصل إلى 100 مدخلة محفوظة و3 ميبي بايت. أدخل سؤالاً يصل طوله إلى 12,000 حرفاً؛ يؤدي «إرسال» إلى طرحه، ويؤدي «إيقاف» إلى إلغاء الإجابة النشطة مع الاحتفاظ بسؤالك متاحاً، ويؤدي «مسح» إلى إزالة محادثة المساعدة هذه. تظل مسودتك غير المرسلة واختيارك للإعداد المسبق محفوظين عند إغلاق «المساعدة» أو إعادة فتحها في نفس جلسة التطبيق، لكن المسودة لا تُحفظ على القرص. لا يرسل المساعد أوامر التطبيق، ولا يغير سير العمل أو يقبل بوابة. المشورة ليست تحققاً مباشراً من مهمة أو حساب أو اتصال خارجي.

تفرض جلسات مساعدة Claude Code وAPI سياسة عدم استخدام الأدوات المدعومة. تتطلب جلسات مساعدة Codex وAntigravity الأصلية وجود إذن الكمبيوتر الأصلي الحالي للمالك المحلي. وإذا تم تعطيله، يوضح التطبيق المتطلب الأساسي بدلاً من اختيار مزود مختلف. يمكن للمالك فقط تمكينه في إعدادات التحكم المحلي؛ ولا يمكن للمساعد تمكينه بنفسه.

تستخدم مساعدة Codex بيئة معزولة للقراءة فقط وترفض طلبات الموافقة على الأدوات. يستخدم Antigravity وضع الخطة وعلامة البيئة المعزولة الأصلية الخاصة به. هذه الأوضاع الأصلية ليست ضماناً شاملاً للتقييد على مستوى نظام التشغيل. يحدد تجزئة الدليل المصدر المرجع المستخدم للإجابة؛ وقد يظل التفسير المُنشأ خاطئاً، لذا افحص الأقسام المرتبطة به قبل اتخاذ أي إجراء. يتم تمييز الإجابات القديمة عندما يختلف إصدار الدليل المصدر الخاص بها عن الدليل الحالي.

التعليمات ذات الصلة: صيانة الدليل المرجعي والترجمة · مساعد التطبيق والأذونات.

المساعد وTelegram

يستخدم المساعد الإعداد المسبق المحدد وعنصر تحكم التطبيق API ذاته. إذن فحص الحالة وإذن تنفيذ العمليات منفصلان. افحص الأوامر والنتائج: فالنص الصادر عن المساعد ليس دليلاً على اكتمال الإجراء.

لا يمكن تمكين Telegram إلا بواسطة المالك المحلي، باستخدام رمز بوت مميز موجود ومعرف مالك رقمي ID. يقتصر التحكم على المحادثة الخاصة بذلك المالك. ويجب ألا يتلقى البوت غير المهيأ أو غير النشط رسائل التطبيق.

لا تقم بلصق الرمز المميز للبوت في المحادثة العادية. إن تهيئة التكامل لا تثبت اتصال Telegram ولا تنشئ بوتاً تلقائياً. يمكن أن تحتوي لقطات الشاشة والردود على بيانات خاصة بمساحة العمل.

حدد إعداداً مسبقاً للمساعد وامنح إذن تشغيل التطبيق بشكل منفصل عن الفحص. يتطلب تنفيذ المساعد لـ Codex وAntigravity الحصول على الإذن الأصلي للمالك؛ ولا يتم استبدالهما بصمت بجلسة API أو Claude خالية من الأدوات. يمكن عرض لقطات الشاشة في محادثة المساعد، لكن إدخال النموذج الحالي لا يتضمن تحليل الصور. لا تفترض أن المساعد قد فحص صورة بصرياً لمجرد أنه عرضها.

يمكن للمساعد فحص الملخصات والمهام والمحادثات وحالة سير العمل وسياق العملية ونوافذ التطبيق من خلال أدوات ذات أنواع محددة. ويمكنه تغيير الإعدادات العادية المسموح بها وإطلاق عمليات التطبيق المصرح بها. ولا يمكنه منح حقوق أصلية، أو الكشف عن بيانات الاعتماد المخزنة، أو تغيير منح مساحة العمل الجذرية عن بُعد، أو الموافقة على بوابة Forge لمجرد الملاءمة.

التعليمات ذات الصلة: عقد التحكم في التطبيق.

تشغيل بوت Telegram الخاص بك

أنشئ البوت الخاص بك أو احصل عليه، وابدأ محادثته الخاصة، وأدخل رمزه المميز ومعرف مستخدم Telegram الرقمي الخاص بك ID في إعدادات التحكم المحلي. لا تقم بتمكين التكامل إلا عندما تنوي أن يتصل التطبيق. معرف المالك ID هو معرف مستخدم، وليس اسم مستخدم أو بوت ID. تُقبل فقط الرسائل الواردة من ذلك المستخدم في المحادثة الخاصة ذاتها.

استخدم /start أو /menu أو /status للحصول على نظرة عامة على الإصدار قيد التشغيل وتعداد المشاريع/المهام وحالات المهام. تفتح الأزرار كلاً من «المشاريع» و«المهام» و«لقطة شاشة» و«المساعدة» و«اللغة». تعرض القوائم ثمانية عناصر في كل صفحة، مع أزرار تنقل «رجوع» و«تحديث» و«الصفحة الرئيسية» و«السابق/التالي». تقوم أزرار المشاريع بتصفية قائمة المهام. تعرض بطاقة المهمة تقدم سير العمل المحفوظ والنموذج/الإعداد المسبق والأسئلة المعلقة عند وجودها.

افتح محادثات المهمة لمعاينة المحادثات المفتوحة/الأخيرة ومحادثات مراحل سير العمل. تعرض كل معاينة ما يصل إلى ست من أحدث رسائل المستخدم/المساعد، مختصرة بصرياً إلى 200 حرف لكل منها. لا يظهر التفكير الخاص. قراءة السجل لا تبدأ مزوداً. المعاينات للقراءة فقط: لا يزال النص العادي و/ask TEXT يوجهان إلى مساعد التطبيق، ولا يوجهان أبداً وبشكل ضمني إلى محادثة المهمة التي تشاهدها.

يُعيد «تشغيل / متابعة» قراءة سير العمل الحالي Code أو Work ويبدأ سير عمل محفوظاً مؤهلاً. يطلب «إيقاف مؤقت» إيقافه مؤقتاً. ولا يقبل أي منهما المتطلبات أو المواصفات أو الخطة أو نتائج المراجعة أو الأسئلة؛ ويمنع القرار المعلق التشغيل. اتخذ القرارات في التطبيق، أو استخدم أمراً مصرحاً به صراحةً ومحدد النوع مع بوابته ومراجعته الحالية الدقيقة.

استخدم «اللغة» أو /language لتحديد أي من لغات الواجهة الـ 56 باسمها الأصلي. يؤدي هذا إلى حفظ التفضيل لهذا البوت وهذا المالك فقط. يؤدي «استخدام لغة التطبيق» إلى مسح هذا التفضيل. ولا يغير ذلك لغة التطبيق ولا أذونات الوصول؛ ولا يتم إعادة إرسال الرسائل الحالية تلقائياً.

يؤدي التنقل عادةً إلى تحديث رسالة القائمة المنشورة نفسها. للأزرار هويات مبهمة تنتهي صلاحيتها بعد 15 دقائق ويمكن استخدامها مرة واحدة؛ يؤدي تغيير البطاقة إلى إبطال أزرارها القديمة. لا يمكن للأزرار منتهية الصلاحية أو المستهلكة أو غير المتطابقة مع الرسالة أو الخاصة بعملية سابقة تنفيذ أي إجراء. يمكن استبدال الرسالة غير القابلة للتعديل بشكل قاطع ببطاقة جديدة؛ ولا يُعاد محاولة خطأ الشبكة غير المعروف كرسالة جديدة.

عند التنشيط، يتجاهل برنامج الاستقصاء الأعمال المتراكمة السابقة ويسجل قبول التحديث قبل الإرسال حتى لا تتم إعادة تشغيل الأوامر المقاطعة تلقائياً عند إعادة التشغيل. وهذا يمنع إعادة التشغيل؛ لكنه لا يضمن الاكتمال. تحقق من الحالة/السياق قبل إصدار عمل جديد عمداً بعد حدوث خطأ. لا توجد إشعارات تلقائية لحالة المهمة.

تظل الأوامر الصريحة متاحة: /projects و/tasks و/task TASK_ID و/run TASK_ID و/pause TASK_ID و/screenshot و/ask TEXT. ينشئ /new {JSON} مهمة من خلال createTask محدد النوع؛ ويرسل /command {JSON} أمر كتالوج صريحاً. اقرأ الكتالوج المباشر لمعرفة أشكال الوسائط. تنطبق نفس تصاريح الواجهة الخلفية ومنح المجلدات كما في التطبيق.

لا يرسل التطبيق أبداً قيم الرموز المميزة للبوت المخزنة إلى المساعد. ومع ذلك، قد تحتوي لقطات الشاشة والملخصات ونص المحادثة على معلومات خاصة بالمشروع. أوقف التكامل محلياً إذا لم يعد حساب البوت أو المالك موثوقاً به. قم بتدوير الرمز المميز المسرب مع مزود البوت، ثم قم بتحديث تكوينه المشفر محلياً.

التعليمات ذات الصلة: البوت الخاص والأوامر.

إذن الكمبيوتر الأصلي المخصص للمالك فقط

يبدأ الوصول الأصلي إلى الكمبيوتر معطلاً. يمكن للمالك فقط تمكينه في الإعدادات المحلية ← التحكم عن بُعد. لا يمكن للمساعد وأوامر HTTP/MCP/Telegram تمكين هذه العلامة لأنفسهم. إذا تم رفض عملية ما، فيجب على المساعد وصف الإعداد وترك القرار للمالك.

عند التمكين الصريح، يقبل computer.run ملفاً تنفيذياً ومصفوفة وسائط ومجلد عمل مطلقاً اختيارياً. ولا يستخدم إدراج الأوامر في الصدفة البرمجية، وله حد زمني قدره 30 ثانية، ويقيد المخرجات بـ 1 ميبي بايت. يتم رفض أي مجلد مفقود أو غير صالح يتم تقديمه؛ ويؤدي حذف cwd إلى استخدام مجلد الإعدادات المملوك للتطبيق، وليس HOME. يلغي «إنهاء» الأوامر النشطة المملوكة وينتظر تنظيف عملياتها.

نطاق القراءة/التشغيل للتطبيق والوصول الأصلي هما قرارات منفصلة. لا تقيد شجرة العمل وصول نظام الملفات لمزود غير مقيد. قم بإلغاء الوصول الأصلي بعد انتهاء المهمة إذا لم يعد مطلوباً، وافحص إيصالات الأوامر بدلاً من قبول نص المساعد كدليل.

التعليمات ذات الصلة: عقد التحكم المخصص للمالك فقط.

المتصفح والمثيلات البعيدة

يقوم المالك المحلي بتمكين الخادم واختيار عنوانه ومنفذه ونطاقه: القراءة للفحص أو التشغيل للإجراءات. عنوان 127.0.0.1 الافتراضي متاح فقط على هذا الكمبيوتر. يستمع 0.0.0.0 على واجهات الشبكة؛ راجع الوصول إلى الشبكة قبل تمكينه.

يفتح المتصفح نفس الواجهة بعد تسجيل الدخول برمز مميز. لا تقم بتضمين الرموز المميزة في الروابط العامة أو لقطات الشاشة. HTTP وحده لا يشفّر حركة المرور؛ استخدم قناة محمية عبر شبكة غير موثوقة.

يقوم المالك بتهيئة المثيلات الأخرى حسب URL والرمز المميز. يقوم الواجهة الخلفية بتمرير الطلبات بالوكالة؛ وهذا لا ينسخ مشاريعها إلى الجهاز المحلي. تحقق من المثيل المحدد قبل كل إجراء.

تنقل الأوامر والأحداث ذات الأنواع المحددة التحكم في التطبيق. لا يخول نطاق القراءة إجراء تعديلات على المهمة. التحكم الأصلي في الكمبيوتر هو خيار منفصل للمالك المحلي ويبدأ معطلاً.

يجب أن يظل التطبيق قيد التشغيل للتحكم في المتصفح وTelegram والوكيل الخارجي. لكل مثيل ملف تعريف خاص به، وحالة مهمة، ورمز مميز، ومنفذ خادم. لا تُعد استخدام ملف تعريف واحد بالتزامن بين مثيلات مستقلة. تقتصر أحداث المتصفح وردود الأوامر على المثيل المحدد؛ وتبديل UI لا ينقل الملفات أو ينسخ تسجيل الدخول الأصلي.

التعليمات ذات الصلة: HTTP والتحكم في المثيل.

OpenClaw وHermes ووكلاء خارجيون آخرون

استخدم API المصادق عليه للتحكم في التطبيق أو جسر MCP stdio المرفق. قم بتمكين الخادم محلياً، واختر القراءة أو التشغيل، وقم بتهيئة كل عميل باستخدام URL لذلك المثيل والرمز المميز. يلزم توفر Node.js 22 أو أحدث لتشغيل جسر MCP المستقل؛ لا يقوم تطبيق Electron بتثبيت عميل الوكيل الخاص بك. URL المتصفح ليس نقطة نهاية HTTP MCP قابلة للبث: قم بتقديمه كـ ZIAFORGE_URL إلى جسر stdio.

يكشف الجسر عن ziaforge_status وziaforge_commands وziaforge_command وziaforge_screenshot. ابدأ بالحالة وكتالوج الأوامر المباشر، ثم اقرأ system.context للمهمة المحددة. تتبع الأوامر ذات الأنواع المحددة نفس فحوصات المراجعة والبوابة ومجلد المهام والتنظيف مثل UI المحلي.

يتضمن كتالوج الأوامر المباشر documentation.guide، المساعدة المرجعية باللغة الإنجليزية، مع مسار مصدرها وsourceSha256. يتلقى مهندس التطبيق الداخلي نفس المرجع من خلال أدواته. وهذا يمنح الوكلاء سياق المنتج بالكامل دون الاعتماد على ملاحظات أقدم؛ ولا تمنح الوثائق وصولاً أبداً أو تحل محل قرار بشري حالي.

يجب على الوكلاء مناقشة المتطلبات والقرارات الفنية والتخطيط انطلاقاً من فكرة بشرية موجزة. ويجب عليهم الحفاظ على البوابات البشرية الصريحة، والنماذج المحددة، وسياسة يدوي/Auto، والمراجعة المطلوبة. ويجب ألا يختلقوا موافقة، أو يعيدوا تشغيل أوامر غير مؤكدة تحت ID جديد، أو ينشروا تغييرات Git دون نية المالك.

قم بتهيئة عدة خوادم MCP مسماة لعمليات تثبيت متعددة. التبديل بين المثيلات هو قرار توجيه وليس مزامنة. توجد أمثلة تهيئة OpenClaw وHermes في AGENT_CONTROL.md؛ ويجب التحقق من الإعداد والتوافق الخاصين بالعميل بالنسبة لإصدار العميل المثبت.

لا تزيل ذاكرة التخزين المؤقت الخارجية لـ requestId سوى تكرار مجموعة محدودة من الطلبات أثناء تشغيل التطبيق. تستخدم العمليات المستدامة هوياتها الخاصة: createRequestId لإنشاء المهام، وcommandId لقرارات سير العمل، وclientMessageId للرسائل، وoperationId لتعديلات Git. احتفظ بالهوية والحمولة الأصليتين بعد تلقي إقرار غير معروف؛ واقرأ الحالة المحفوظة قبل إصدار عمل جديد عمداً.

التعليمات ذات الصلة: تعليمات عميل MCP.

حدود CLI والأتمتة المحلية

يتحكم مرسل ziaf في نفس التطبيق قيد التشغيل وسير العمل المحفوظ. من المصدر، استخدم npm run ziaf -- list أو npm run ziaf -- status --task TASK_ID --json أو npm run ziaf -- start --task TASK_ID أو npm run ziaf -- pause --task TASK_ID. إن إقرار البدء الناجح لا يعني أن المهمة قد اكتملت.

يقوم --until-success بتمكين Auto عمداً لسير العمل المحفوظ، ولكن تظل الأسئلة والمراجعة وبوابات القبول والحدود ونقاط الفحص سارية. يؤدي الضغط على Ctrl+C إلى الخروج من المرسل المراقب؛ ولا يوقف سير عمل التطبيق ضمناً. راجع CLI.md لمعرفة رموز الخروج ونقطة النهاية المحلية ومعالجة ملف التعريف.

تخزن واجهة «الأتمتة» حالياً تعريفات العرض وعدادات التشغيل المحلية. وهي ليست أداة جدولة متكررة معتمدة ولا تثبت تشغيل دورة نموذج في الخلفية. للتنفيذ الفعلي، استخدم عناصر تحكم سير العمل المحفوظة أو ziaf أو API المصادق عليه وافحص إيصالاتها. لا تخلط بين لوحة العرض التوضيحي والجدولة غير الخاضعة للإشراف.

التعليمات ذات الصلة: أوامر المرسل.

الإصدار والتحديثات

يعرض «حول» الإصدار قيد التشغيل الدقيق. تتطلب التحديثات العامة مستودع إصدارات GitHub موثوقاً وقناة مستقرة أو للمعاينة. التحقق والتنزيل والتثبيت لها حالات منفصلة؛ والخطأ لا يعني أنه تم تثبيت تحديث.

التثبيت التلقائي مخصص لإصدارات macOS الموقعة. لا يتم تثبيت نسخ التطوير غير الموقعة تلقائياً من خلال هذه الآلية. للاستبدال اليدوي، قم بإنهاء التطبيق الحالي تماماً واستخدم حزمة برمجية موثوقة.

يعمل الفحص التلقائي فور تمكينه، ثم كل ست ساعات.

يستبعد المستقر إصدارات المعاينة؛ وتتيح المعاينة إصدارات التطوير أيضاً. الفحص الناجح يحدد فقط بيانات تعريف الإصدار المتاحة. يحتاج التنزيل والتثبيت إلى حزمة النظام الأساسي وتغذية الإصدارات المهيأة. تسليم Linux DEB هو مسار تثبيت منفصل؛ لا تفترض ترقية DEB تلقائياً بواسطة آلية تحديث macOS.

التعليمات ذات الصلة: جاهزية الإصدار.

إعادة التشغيل والاسترداد

على macOS، استخدم إنهاء / Q⌘ لإيقاف التشغيل بالكامل. قد يؤدي إغلاق النافذة إلى بقاء التطبيق قيد التشغيل. قم بإنهاء الإصدار القديم تماماً قبل استبدال التطبيق.

بعد التشغيل، حدد المهمة نفسها. يعود السجل والمسودات. يستعيد «استئناف» سياقاً أصلياً/محلياً ولكنه لا يرسل مسودة، ولا يلغي إيقاف قائمة الانتظار مؤقتاً، ولا يصرح بتكرار عملية غير معروفة.

إذا ظهر الاسترداد، فلا تعدل JSON يدوياً. افحص نوع المستند المتأثر، واحتفظ بالملفات الأصلية، وحدد نسخة احتياطية تم التحقق من صحتها. تؤدي استعادة قائمة انتظار أقدم إلى وضع علامة غير مؤكدة على عناصرها.

عندما يكون التسليم غير معروف، قد يحتاج سير العمل المُدار إلى إذن صريح للحصول على سياق جديد. يظل العمل السابق والمحاولات الفاشلة موجودين؛ والرفض المرئي أكثر أماناً من النجاح المصطنع.

قم بعمل نسخة احتياطية لملفات المهمة وملف تعريف التطبيق مع إغلاق جميع مثيلات التطبيق. المجلد المنسوخ ليس استعادة تم اختبارها. إذا طلب منك الاسترداد تحديد نسخة احتياطية تم التحقق من صحتها، فاحتفظ بالملفات التالفة بدقة أيضاً. استعادة سير عمل أو قائمة انتظار أقدم لا تخول إعادة تشغيل استدلال غير مؤكد أو عمليات Git.

التعليمات ذات الصلة: عقد الاسترداد.

استكشاف الأخطاء وإصلاحها

لم يتم العثور على CLI: تحقق من تثبيته وإصداره في طرفية عادية، ثم أعد تشغيل ZIAForge. وجود ملف تنفيذي لا يعني أنك قمت بتسجيل الدخول. استخدم آلية تسجيل الدخول الخاصة بالمزود نفسه.

النموذج غير متوفر أو فشل التفويض: قم بتحديث الاستكشاف، وحدد ID متاحاً وتحقق من حسابك وحدودك. لا تكرر طلباً غير مؤكد قبل فحص سجله.

توقف سير العمل: افتح المرحلة الحالية أو السؤال أو إيصال التحقق أو سجلات CLI. عالج السبب المحدد: سؤال دون إجابة، أو أمر، أو إذن مجلد، أو حد المحاولات. لا يمكن للمتابعة تحويل فحص فاشل إلى نجاح.

المجلد مفقود أو تم استبداله: استعد الوصول إلى المجلد الأصلي أو أنشئ مهمة جديدة. يجب ألا يستمر التطبيق من HOME. إذا لاحظت مسار cwd آخر، فأوقف الدور واحتفظ بالتشخيصات.

بالنسبة للتقرير، قم بتضمين إصدار «حول»، والمسار، وCLI/النموذج، والسلوك المتوقع والفعلي، ولقطة شاشة ومقتطف سجل آمن. أزل الأسرار والمحتوى الشخصي والمسارات التي لا يمكن نشرها.

الصفحة البعيدة غير متوفرة: تحقق من تمكين المالك للخادم، وتحقق من عنوان الاستماع والمنفذ، ثم قم بالمصادقة باستخدام رمز المثيل المميز الصحيح. يشير 401 إلى المصادقة؛ قد يكون التعديل المرفوض نطاق قراءة أو عنصراً للتحكم للمالك فقط. يؤدي تغيير الرمز المميز إلى إغلاق عملاء المتصفح الحاليين. لا تعرض منفذ فحص DevTools المنفصل كتحكم عن بُعد في التطبيق.

تم رفض حفظ المحرر: احتفظ بالمسودة، وافحص الملف الحالي على القرص وحل تعارض التغيير الخارجي. لا تتجاوز المقارنة عن طريق إعادة كتابة بيانات تعريف التطبيق. إذا كان التحميل الكامل للملفات الكبيرة غير متاح، فاستخدم تحرير/بحث النوافذ المدعوم أو محرراً خارجياً.

Telegram غير متوفر: تأكد من رمز البوت المميز، والمالك الرقمي، والمحادثة الخاصة، والحالة محلياً. يمكن لـ webhook أو أداة استقصاء متنافسة حظر الاستقصاء؛ ولا يحذف ZIAForge الـ webhook تلقائياً أو يستولي على أداة استقصاء أخرى. لا تتم إعادة تشغيل الأوامر المرفوضة أو المقاطعة عند حد غير معروف تلقائياً.

التعليمات ذات الصلة: الاختبار والتشخيص.

الإبلاغ عن المشكلات وفحص الأدلة

سجّل الإصدار قيد التشغيل الدقيق من «حول»، وOS/البنية، ووضع المهمة، والمزود/النموذج المحدد، والخطوات التي تعيد إنتاج المشكلة. صِف النتيجة المتوقعة والنتيجة الملاحظة. أرفق لقطة شاشة آمنة وإيصال التحقق أو الأمر المحتفظ به ذي الصلة، بدلاً من ملف تعريف خاص كامل.

قد تكشف سجلات CLI، ويوميات الأحداث، ونصوص النماذج المنقولة، وتتبعات المتصفح، ولقطات الشاشة عن كود المصدر، أو المسارات الشخصية، أو الرموز المميزة. افحص ونقّح قبل المشاركة. أداة تنقيح السجلات بأفضل جهد لا تصادق على أن لقطة الشاشة أو الأرشيف قابلان للنشر.

بالنسبة للمساهمين، يقرأ qa:doctor هوية البيئة/البناء؛ ويفتح qa:inspect ملف تعريف معزولاً مع نماذج بديلة للمزود. يثبت الاختبار الثابت مسار التطبيق الذي تم اختباره دون الاتصال بنموذج. الاستدلال المباشر، واتصال Telegram، وسطح مكتب Linux الأصلي، والتوقيع، وفحوصات الحزم البرمجية المجهزة هي أدلة منفصلة. راجع TESTING.md للاطلاع على الأوامر القابلة لإعادة الإنتاج وعمليات التنظيف.

التعليمات ذات الصلة: أوامر الأدلة.

البيانات المحلية والحدود

قد تحتوي المشاريع والتاريخ والخطط والمستندات والتشخيصات على نصوص خاصة. لا تنشر ملفات التعريف أو عمليات الالتقاط الأولية أو المفاتيح أو السجلات الكاملة مع كود المصدر.

على Linux، يتطلب حفظ API والتحكم وTelegram وبيانات اعتماد المثيل وجود GNOME Secret Service مفتوح أو KWallet؛ وبدون مخزن أسرار مدعوم، يرفض ZIAForge حفظ هذه الأسرار بدلاً من استخدام خيار Electron الاحتياطي لـ basic_text.

التخزين المحلي لا يعني بقاء الطلبات على جهاز الكمبيوتر الخاص بك: يقوم CLI/API المحدد بإرسالها إلى المزود الخاص به. مجلد العمل والإشراف على العمليات ليسا عزلاً لـ OS. افحص الأذونات المحددة.

ميّز بين أنواع الأدلة: تختبر الاختبارات الثابتة التطبيق بدون نموذج؛ ويختبر التشغيل الحي الأصلي حساب/CLI حقيقياً؛ وتصادق الفحوصات المجهزة على حزمة برمجية معينة. واجتياز أحدها لا يضمن اجتياز البقية.

يختلف نطاق التطبيق وشجرة العمل والمطالبة المخصصة للقراءة فقط عن الإنفاذ على مستوى نظام التشغيل. تكتشف سياسات المراجع/المساعد لـ Antigravity التغييرات في أدلة مساحة العمل المجمعة بدلاً من فرض وصول للقراءة فقط إلى نظام الملفات. ينفذ التحكم الأصلي في الكمبيوتر برامج مصرحاً بها من المالك خارج حدود أدوات التطبيق العادية؛ قم بإيقاف تشغيله عندما لا تعود هناك حاجة إليه.

التعليمات ذات الصلة: المصدر والنشر.

فهم وتعديل هذا المشروع المفتوح المصدر

اقرأ AGENTS.md وCONTRIBUTING.md أولاً، ثم PROJECT_MAP.md لمعرفة حدود المصدر الحالية. تحكم العقود المحددة الأنواع المنفذة ووثائق سير العمل/المزود الحالية السلوك. يحتفظ CONCEPT.md والأجزاء المعتمدة على الطرفية أولاً في ARCHITECTURE.md بالنية التاريخية ويجب عدم الخلط بينها وبين ادعاءات الإصدار الحالي.

مصدر المساعدة باللغة الإنجليزية هو docs/help/en.json. لا تقم بتعديل USER_GUIDE.md أو website/guide.html المنشأين يدوياً. قم بتغيير القسم المرجعي، وتحديث العقد المتأثر، وتشغيل node scripts/help/generate.cjs. تقرأ المساعدة داخل التطبيق نفس المصدر. راجع الإضافات مع التنفيذ الفعلي، بما في ذلك الحدود والأذونات والمسارات غير المدعومة.

كل لغة من لغات واجهة 56 لها حالة مساعدة منفصلة في docs/help/locales.json. ترجع المساعدة المفقودة أو غير المكتملة إلى اللغة الإنجليزية كخيار احتياطي. وتُوضع علامات على النصوص المترجمة آلياً بالكامل ويتم ربطها بتجزئة المصدر الإنجليزي، دون ادعاء بالمراجعة البشرية. تسجل الترجمة التي تمت مراجعتها بشرياً مراجعها بشكل إضافي. يجب أن تحافظ كل ترجمة على معرفات الأقسام، والإجراءات، ومعرفات الملفات/الأوامر والحدود الفنية، وأن تستخدم الاتجاه الصحيح، وأن يتم تحديثها عندما يتغير مصدرها الإنجليزي.

قبل الشحن، شغّل node scripts/help/generate.cjs --check لاكتشاف المخرجات المنشأة القديمة أو هياكل اللغات غير الصالحة أو روابط العقود المحلية المعطلة. تظل فحوصات ترجمة UI وفحوصات سلوك التطبيق منفصلة. يوفر HELP_MAINTENANCE.md إجراءات التحديث للمساهمين وAI؛ ويجب ألا تدعي الوثائق اجتياز اختبار لم يتم تشغيله.

التعليمات ذات الصلة: خريطة المشروع الحالية · صيانة الوثائق · تعليمات المساهمين · تعليمات الوكلاء.