التوثيق

CLI (acctl)

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

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

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

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

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

إرشادات إضافية:

cargo build --release -p acctl

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

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

acctl --help

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

الأمرالوصف
runإطلاق daemon مع اكتشاف التكوين
tailبث الأحداث من سجل الالتزام
replayإعادة تشغيل الأحداث في وضع عدم الاتصال للتحليل
snapshotإنشاء أو استعادة اللقطات
diagتشغيل تشخيصات البيئة
adaptersإطلاق محولات البروتوكول
bundle-debugإنشاء أرشيف تصحيح للأحداث

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

تحقق من بيئتك وتكوينك:

إرشادات إضافية:

acctl diag --print-config

هذا يحقق:

إرشادات إضافية:

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

الخطوة 4 - متابعة سجل الالتزام

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

acctl tail --commit-log /path/to/commit_log.log

خيارات:

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

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

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

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

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

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

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

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

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

acctl snapshot restore \
  --input snapshot.json \
  --commit-log /path/to/commit_log.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

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

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

إرشادات إضافية:

ls -la /path/to/commit_log.log

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

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

cargo build --release -p assetcore-adapters

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

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

إرشادات إضافية:

المتغيرالوصف
ASSETCORE_WRITE_URLتجاوز عنوان URL لعملية الكتابة
ASSETCORE_READ_URLتجاوز عنوان URL لعملية القراءة

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