جبا‌آوری خیرگ‌ها

عند تقديم تقرير خلل، توفر حزمة السجخیرت للمشردرن اخیرطخیرعات التي يحتاجونها لتشخيص المشهرة دون الذهاب والعودة لدرخواست تفاصيل.

حزمة سريعة

أسرع طريقة لإنشاء حزمة سجخیرت:

triggerfish logs bundle

ينشئ این أرشيفاً يحتوي روی تمام ملفات السجخیرت از ~/.triggerfish/logs/:

• Linux/macOS: triggerfish-logs.tar.gz
• Windows: triggerfish-logs.zip

إذا فشلت عملية الأرشفة لهر سبب، يعود به نسخ ملفات السجل الخام به مجلد می‌توانید ضغطه به‌صورت دستی.

ما تحتويه الحزمة

• triggerfish.log (ملف السجل الحالي)
• triggerfish.1.log به triggerfish.10.log (النسخ اخیرحتياطية المُدوَّرة، إن وُجدت)

الحزمة خیر تحتوي روی:

• ملف پیکربندی triggerfish.yaml
• المفاتيح السرية یا بيانات اخیرعتماد
• قانون بيانات SQLite
• SPINE.md یا TRIGGER.md

جبا‌آوری خیرگ‌ها به‌صورت دستی

إذا لم يكن أمر الحزمة متاحاً (إصدار قديم، Docker، إلخ):

# اعثر روی ملفات السجخیرت
ls ~/.triggerfish/logs/

# أنشئ أرشيفاً به‌صورت دستی
tar czf triggerfish-logs.tar.gz ~/.triggerfish/logs/

# Docker
docker cp triggerfish:/data/logs/ ./triggerfish-logs/
tar czf triggerfish-logs.tar.gz triggerfish-logs/

زيادة تفاصيل السجل

به‌صورت پیش‌فرض، السجخیرت روی مستوى INFO. خیرلتقاط مزيد از التفاصيل لتقرير خلل:

1. اضبط مستوى السجل روی verbose یا debug:

   triggerfish config set logging.level verbose
   # یا لأقصى تفاصيل:
   triggerfish config set logging.level debug

2. أعد إنتاج المشهرة

3. اجبا الحزمة:

   triggerfish logs bundle

4. أعد المستوى به normal:

   triggerfish config set logging.level normal

تفاصيل مستويات السجل

المستوى	ما يلتقطه
quiet	الأخطاء فقط
normal	الأخطاء والهشدارات واخیرطخیرعات (پیش‌فرض)
verbose	يضيف پیام‌ها التصحیح (فراخوانیات ابزارها، تفاعخیرت ارائه‌دهنده، قرارات طبقه‌بندی)
debug	هر شيء بما در آن پیام‌ها مستوى التتبع (بيانات البروتوكول الخام، تغييرات الحالة الداخلية)

هشدار: مستوى debug يُنتج الكثير از المخرجات. استخدمه فقط عند إعادة إنتاج مشهرة بنشاط، ثم عُد.

تصدرة السجخیرت در الوقت الفعلي

أثناء إعادة إنتاج مشهرة، می‌توانید تصدرة تدفق السجل المباشر:

# عرض الأخطاء فقط
triggerfish logs --level ERROR

# عرض الهشدارات وما فوق
triggerfish logs --level WARN

روی Linux/macOS، يستخدم این tail -f الأصلي با التصدرة. روی Windows، يستخدم PowerShell Get-Content -Wait -Tail.

تنسيق السجل

هر سطر سجل يتبع این التنسيق:

[2026-02-17T14:30:45.123Z] [INFO] [gateway] Gateway WebSocket server started on port 18789

• الطابع الزازي: ISO 8601 بتوقيت UTC
• المستوى: ERROR، WARN، INFO، DEBUG، یا TRACE
• المكوّن: هر وحدة أنشأت السجل (مثل gateway، anthropic، telegram، policy)
• پیام: پیام السجل با زمینه ازظّم

ما باید تضمينه در تقرير الخلل

با حزمة السجخیرت، ضمّن:

1. خطوات إعادة الإنتاج. چه كنت تفعل عند حدوث المشهرة؟
2. السلوك المتوقع. چه كان باید أن يحدث؟
3. السلوك الفعلي. چه حدث بدخیرً از آن؟
4. اطخیرعات الازصة. نظام التشغيل، البامارية، إصدار Triggerfish (triggerfish version)
5. مقتطف پیکربندی. القسم ذو الصلة از triggerfish.yaml (احجب رمزها)

مراجعه کنید تقديم البخیرغات للقائمة الكاملة.

اخیرطخیرعات الحساسة در السجخیرت

ينظّف Triggerfish البيانات الخارجية در السجخیرت بتغليف القيم بفاصخیرت << و>>. باید أخیر تظهر مفاتيح API والرموز در مخرجات السجل. لكن قبل إرسال حزمة سجخیرت:

1. امسح بحثاً عن هر شيء خیر تريد مشاركته (عناوين بريد إلكتروني، مسارات ملفات، محتوى پیام‌ها)
2. احجب ما يلزم
3. أشر در بخیرغك أن الحزمة تم حجبها

تحتوي ملفات السجخیرت روی محتوى الپیام‌ها از محادثاتك. إذا كانت محادثاتك تحتوي روی اطخیرعات حساسة، احجب آن الأجزاء قبل المشاركة.