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

هذا شرح قائم على وثائق إصدار AgentsView v0.45.0 بتاريخ 9 أكتوبر 2026 وأدلة البدء السريع واستخدام الرموز الحالية، التي روجعت في 17 أكتوبر. لم تثبّت BIG CHANGE برنامج AgentsView، ولم تستورد سجل محادثة، ولم تختبر هذه الخطوات. تحقّق من الإصدار الذي تثبته، فقد تتغير الوثائق وقوائم الإصدارات.

قبل البدء

تحتاج إلى جلسة مكتملة لوكيل برمجة يُسمح لك بقراءتها، وعبارة مميزة أو معرّف جلسة ID من تلك المهمة، وإذن بقراءة دليل سجلاتها المحلي. يورد Quick Start تنزيلات سطح المكتب لأنظمة macOS وWindows وLinux، وحزم wheel لواجهة CLI على Linux x86_64 وaarch64، وmacOS x86_64 وarm64، وWindows x86_64 وarm64. تطبيق سطح المكتب جاهز في حزمة؛ وللبناء من المصدر متطلبات منفصلة من Go وNode وCGO. وفق دليل البدء السريع، لا تتطلب الأرشفة المحلية الأساسية حسابًا لخدمة مستضافة أو مفتاح API.

قد تحتوي سجلات الجلسات على مطالبات وشيفرة مصدرية ومدخلات أدوات وأسرار. اختر فقط الأدلة التي يسمح لك فريقك بفحصها. حدّد الموفرين والأدلة الجذرية التي يجوز للأرشيف استيعابها قبل تشغيله أول مرة: فمجرد تشغيل agentsview serve يكتشف المصادر الافتراضية المدعومة ويزامنها فورًا. أبقِ واجهة الويب على عنوان الحلقة الراجعة الموثّق لهذا التمرين. لا تفعّل مزامنة البيانات الخام المستضافة، أو الإرسال إلى PostgreSQL أو ClickHouse، أو النشر على Gist، أو الرؤى المولدة، أو نقطة نهاية تضمين مستضافة لمجرد الإجابة عن هذا السؤال. البحث الدلالي اختياري؛ والبحث المعتاد في النص الكامل يعمل بالفهرس المحلي.

1. ثبّت البرنامج وحدّد الملف التنفيذي

اختر طريقة واحدة من دليل التثبيت. لواجهة CLI مستقلة، هذا هو تثبيت Python الدائم الموثّق:

Terminal
pip install agentsview
agentsview --version

يقدّم الدليل أيضًا uvx agentsview للتشغيل دون تثبيت دائم، وأدوات تثبيت خاصة بالمنصات، وحزم سطح المكتب. على macOS، يربط cask في Homebrew واجهة CLI المرفقة بالتطبيق؛ وقد يحتاج التطبيق المثبت من DMG إلى إضافة دليل CLI إلى PATH. تأكد من الملف التنفيذي الذي يعثر عليه مفسر الأوامر قبل الوثوق بإصداره. يصنّف GitHub v0.45.0 بأنه إصدار 9 أكتوبر، لكن استخدم نتيجتك الخاصة للأمر --version عند تفسير الشاشات وبنية التقرير.

2. قيّد المصادر قبل المزامنة الأولى

عند تثبيت CLI أو تطبيق سطح المكتب على المضيف، جهّز دليل بيانات جديدًا وملف config.toml قبل بدء AgentsView. يوضح دليل الإعداد استخدام disabled_agents لاستبعاد موفري نظام الملفات المحلي، واستخدام [agents.<id>].dirs لاستبدال الجذور الافتراضية لموفر واحد. أدرج معرّفات ID لجميع الموفرين الآخرين من جدول Session Discovery في ذلك الدليل ضمن disabled_agents، واضبط dirs للموفر الوحيد المصرح به على الجذر المعتمد. مثلًا، يؤدي [agents.codex] مع dirs = ["/approved/codex/sessions"] إلى استبدال أدلة Codex الافتراضية؛ عدّل المسار وفق نظامك. إذا لم تكتمل قائمة الاستبعاد، فلا تبدأ خدمة المضيف بعد. تجاوز قيمة CODEX_SESSIONS_DIR أو CLAUDE_PROJECTS_DIR وحدها يغيّر جذر ذلك الموفر، لكنه يترك بقية الموفرين متاحين للاكتشاف الافتراضي الخاص بهم.

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

الحاوية المعزولة بديل عندما يصعب الاحتفاظ بقائمة استبعاد لجميع الموفرين الآخرين. يعرض مثال Docker في Quick Start الواجهة على 127.0.0.1 فقط، ويركّب مصدر وكيل للقراءة فقط، ويستخدم وحدة بيانات منفصلة. ركّب فقط جذر المصدر المصرح به، واضبط متغير الدليل المطابق داخل حاوية جديدة؛ واحذف بقية التركيبات من مثال Compose للمشروع. لا ترى الحاوية إلا أدلة جلسات المضيف المركّبة صراحة. تغطي صور Docker المنشورة Linux amd64 وarm64؛ ويحتاج هذا المسار إلى تثبيت Docker يعمل.

3. أنشئ الأرشيف المحلي

لواجهة CLI على المضيف ذات المصادر المحددة، شغّل الخادم الموثّق الذي يعمل في المقدمة:

Terminal
agentsview serve

بعد تطبيق نطاق المصادر والتحقق منه في الخطوة 2، يهيّئ هذا ~/.agentsview/sessions.db أو دليل البيانات المختار، ويكتشف سجلات الوكلاء المفعّلين، ويزامنها، ويراقب التغييرات، ويفتح http://127.0.0.1:8080. أبقِ تلك الطرفية مفتوحة. إذا فضّلت عملية في الخلفية، فاستخدم agentsview daemon start وكذلك agentsview daemon status؛ ويدير تطبيق سطح المكتب خلفيته الخاصة. قد يكتفي خادم متوافق يعمل بالفعل بإرجاع عنوان URL الخاص به؛ لذا تحقّق من وجود خدمة قيد التشغيل قبل افتراض أن إعدادك الجديد تحكّم في استيعاب البيانات.

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

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

4. ابحث عن المهمة وتحقّق من سجل المحادثة

في واجهة الويب، استخدم Ctrl/Cmd+K للبحث الحرفي عن عبارة مميزة من المهمة المعروفة. ضيّق القائمة حسب المشروع أو الوكيل أو التاريخ، ثم افتح النتيجة المرشحة وافحص الرسائل واستدعاءات الأدوات. إذا كان لديك بالفعل معرّف الجلسة الكامل ID أو UUID، فإن Ctrl/Cmd+G يفتحها مباشرة. هذه الضوابط موثّقة في Quick Start. دوّن الوكيل ومعرّف الجلسة ID والتاريخ لربط نتيجة الاستخدام بالمحادثة الصحيحة.

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

5. افحص حقول استخدام الجلسة

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

إذا أردت حفظ سجل قابل للقراءة آليًا لتلك الجلسة الواحدة، فإن مثال CLI للمشروع يستخدم agentsview session usage SESSION_ID --format json. استبدل SESSION_ID بالمعرّف ID الذي تحققت منه في سجل المحادثة، ثم احفظ JSON مع ملاحظة المهمة. افحص النموذج المبلّغ وفئات الرموز ومصدر التكلفة في ذلك الناتج قبل اقتباس أي إجمالي.

تعامل مع الحقل الفارغ أو النموذج الغائب على أنه مجهول. لا يستطيع AgentsView إعادة بناء استخدام لم يسجله الوكيل أصلًا. تقول ملاحظات الإصدار إن استيعاب Junie CLI يستبعد المحادثات واستدعاءات الأدوات الموجودة داخل IDE فقط، بينما يحتوي بديل النص العادي في Antigravity على المحادثة دون استخدام الرموز أو التكلفة. هذه أمثلة محددة على أن الجلسة القابلة للبحث لا تعني بالضرورة مبلغ إنفاق كاملًا. وقد يصف المبلغ الذي يبلغ عنه المصدر إجمالي الجلسة، بينما تظل توزيعاته حسب النموذج تقديرية.

6. حدّد نطاق تقرير اليوم

استخدم مرشحات التاريخ والمشروع والوكيل في صفحة Usage لفحص يوم الجلسة. تعرض الصفحة أيضًا جدول Top Sessions by Cost بروابط إلى سجلات المحادثات الفردية. لتقرير قابل للتدقيق في الطرفية، استبدل التاريخ المحلي للجلسة واسم الوكيل في:

Terminal
agentsview usage daily --since YYYY-MM-DD --until YYYY-MM-DD --agent codex --breakdown

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

لتقرير دون جلب دليل الأسعار، أضف --offline. يقول AgentsView إن ذلك يقرأ الأرشيف الموجود دون مزامنة المصادر أو بدء الخدمة، ويستخدم أسعارًا احتياطية مضمّنة. حدّث الأرشيف أولًا إذا كانت تغييرات الجلسة الحديثة مهمة؛ فالتقرير غير المتصل لا يكتشف سجلات جديدة. قد تجلب أوامر الاستخدام المعتادة أسعار LiteLLM وOpenRouter، بينما يتقادم الدليل المضمّن مع الإصدار المثبت.

7. فسّر الرقم وأوقف الخدمة

ضع على كل رقم وسمًا حسب مصدره. Computed يعني أن AgentsView ضرب الرموز المسجلة في الأسعار المختارة. Reported يعني أن المصدر قدّم تكلفة صريحة. Mixed يعني أن التقرير يجمع أنواعًا مختلفة. وحتى الرقم المبلّغ من المصدر لا يثبت مطابقة فاتورة الموفر للحساب كله. قارن بصورة مستقلة سجلات فوترة الموفر المعني أو خطته، خصوصًا عندما تهم مستويات الخدمة أو الخصومات أو حصة الاستخدام المشمولة بالاشتراك. تقول وثائق AgentsView إنه لا يستطيع استنتاج أسعار Batch أو Flex أو Priority أو الأسعار الإقليمية أو تخزين مؤقت لساعة واحدة عندما يغيب ذلك المستوى عن الاستخدام المحفوظ. بعض الرموز على جانب الأدوات غير موجودة في سجلات المحادثات المحلية.

معيار النجاح هو سجل محادثة مطابق يتفق وكيله ومعرّفه ID وتاريخه مع عرض الاستخدام المختار، مع تدوين حقول النموذج والرموز المتاحة ووسم غير المتاح بأنه مجهول. الناتج أرشيف محلي قابل للبحث وملاحظة استخدام محددة النطاق للمهمة أو اليوم، لا فاتورة. أوقف أمر agentsview serve الذي يعمل في المقدمة باستخدام Ctrl+C، أو أوقف خادم الخلفية باستخدام agentsview daemon stop. يوضح Quick Start أن إيقاف الخدمة يوقف واجهة الويب ومراقب الجلسات معًا.

التغيير الكبير

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

المصادر وقراءات إضافية

  • ملاحظات إصدار AgentsView v0.45.0: تغييرات مؤرخة في تغطية الوكلاء وبطاقات Usage والمزامنة وسلوك التسعير. ملاحظة الإصدار سجل من المورد، لا اختبار من BIG CHANGE.
  • AgentsView Quick Start: طرق التثبيت المدعومة وأوامر الخادم والخدمة وإعداد المصادر وضوابط البحث المحلي.
  • إعداد AgentsView: اكتشاف المصادر واستبعاد الموفرين وموقع الأرشيف وحدود هذه الضوابط.
  • استخدام الرموز والتكاليف في AgentsView: تغطية المصادر وتقارير الاستخدام ومنشأ الأسعار والوضع غير المتصل وحدود التقارير المعروفة.
  • مستودع AgentsView: الشيفرة المصدرية وترخيص MIT؛ ويصف المستودع الأرشيف الافتراضي بأنه محلي.