CLI (acctl)

acctl هو واجهة المشغل المعتمدة لـ Asset Core. إنه يغلف سير العمل الذي تحتاجه للتحقق من الحوكمة، وإجراء التشخيصات، وإعادة تشغيل الحالة، والتعافي من الفشل عندما تفشل الأتمتة.

المتطلبات السابقة

• مجموعة أدوات Rust (مستقرة)
• تم بناء ثنائيات Asset Core (cargo build --release)

الخطوة 1 - تثبيت acctl

قم ببناء واجهة سطر الأوامر من المستودع:

cargo build --release -p acctl

الملف الثنائي موجود في target/release/acctl.

الخطوة 2 - عرض الأوامر المتاحة

acctl --help

قائمة الأوامر أدناه هي مرجع. للحصول على إرشادات مركزة على المهام، راجع دليل مشغل ACCTL.

الأوامر المتاحة:

الأمر	الوصف
adapters	إطلاق محولات البروتوكول (MCP/OpenAI/Gemini)
auth	المصادقة، فحص الأذونات، وإدارة الرموز
run	إطلاق الخدمات مع اكتشاف التكوين والتمهيد
namespaces	قائمة، توفير، وتحديث المساحات الاسمية
read-stream	تدفق التزام خدمة القراءة عبر SSE
tail	تدفق المظاريف من سجل المظاريف
replay	إعادة تشغيل المظاريف في وضع عدم الاتصال للتحليل
query-commits	استعلام تاريخ الالتزامات عبر خدمة القراءة
query-container-commits	تاريخ الالتزامات لحاوية
list-containers	قائمة الحاويات مع الفلاتر
get-container-contents	جلب الأرصدة، الفتحات، أو محتويات الشبكة
get-container-grid	فحص شغل الشبكة (منطقة اختيارية)
find-grid-free	العثور على نقاط ربط الشبكة الحرة لشكل ما
list-instances	قائمة الحالات مع الفلاتر
get-instance	جلب بيانات التعريف للحالة
owner-summary	تجميع البيانات لمالك
snapshot	إنشاء أو استعادة اللقطات
diag	تشغيل تشخيصات البيئة وفحوصات النقاط النهائية
bundle-debug	إنشاء أرشيف تصحيح للأحداث

الخطوة 3 - تشغيل التشخيصات

تحقق من بيئتك وإعداداتك:

acctl diag --print-config

هذا يحقق:

• مسارات ملفات التكوين
• إمكانية الوصول إلى سجل الالتزامات
• إصدارات سلسلة الأدوات

الخطوة 4 - متابعة سجل الظرف

بث الأحداث عند تنفيذها:

acctl tail --envelope-log /path/to/envelope.log

خيارات:

العلم	الوصف
--follow	متابعة بث الأحداث الجديدة
--format	تنسيق الإخراج: json أو summary
--from	البدء من تسلسل محدد

الخطوة 5 - إعادة التشغيل للتحليل

إعادة تشغيل الأحداث دون اتصال لتحليل الحالة:

acctl replay \
  --envelope-log /path/to/envelope.log \
  --from 0 \
  --to 1000

يُنتج Replay ملخصات حتمية دون الحاجة لتشغيل الـ daemon بالكامل.

الخطوة 6 - إنشاء لقطات

تصدير الحالة الحالية كلقطة JSON:

acctl snapshot create \
  --envelope-log /path/to/envelope.log \
  --output snapshot.json

استعادة من لقطة:

acctl snapshot restore \
  --input snapshot.json \
  --envelope-log /path/to/envelope.log

الخطوة 7 - إطلاق المحولات

ابدأ خادم MCP لدمج أدوات الذكاء الاصطناعي:

acctl adapters \
  --config /path/to/write.toml \
  --read-config /path/to/read.toml \
  --transport stdio

خيارات:

العلم	الوصف
--transport	البروتوكول: stdio أو sse
--port	منفذ الاستماع لـ SSE (SSE فقط)

الخطوة 8 - إنشاء حزم التصحيح

حزم العناصر الخاصة بتصنيف الحوادث:

acctl bundle-debug \
  --config /path/to/write.toml \
  --output debug-bundle.tar.gz

الحزمة تشمل:

• ملفات التكوين
• سجل التزام المقاطع
• نقاط التفتيش
• جمع مقاييس Prometheus
• بيان مع الطوابع الزمنية

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

”ملف التكوين غير موجود”

حدد المسار الكامل لتكوينك:

acctl run --config /absolute/path/to/config.toml

“سجل الالتزام غير متاح”

تحقق من أذونات الملف وأن المسار exists:

ls -la /path/to/commit_log.log

“لم يتم العثور على ملف ثنائي المحول”

قم ببناء المحولات أولاً:

cargo build --release -p assetcore-adapters

متغيرات البيئة

acctl يحترم هذه المتغيرات البيئية:

المتغير	الوصف
ASSETCORE_WRITE_URL	تجاوز عنوان URL لعملية الكتابة
ASSETCORE_READ_URL	تجاوز عنوان URL لعملية القراءة
ACCTL_ALLOW_PLAINTEXT_TOKEN_STORE	السماح بتخزين الرموز النصية العادية عند عدم توفر حلقة المفاتيح
ASSETCORE_BASE_DIR	تجاوز الدليل الأساسي للمسارات المحلولة

الخطوات التالية

• أساسيات النشر - تشغيل الخدمات في الإنتاج
• الصحة والقياسات - مراقبة نقاط النهاية
• دليل الأدوات - واجهة أدوات المحول القياسية