AI-translated from English; not yet reviewed by a fluent editor.

# دقّق جلسة واحدة لوكيل برمجة باستخدام AgentsView

> اعثر في AgentsView على سجل محلي معروف لمحادثة وكيل برمجة، وافحص الرموز المسجلة ومصدر التكلفة، واقرأ تقرير يوم محدد النطاق دون اعتبار التقديرات فواتير.

By BIG CHANGE Editorial

Published: 2026-10-17T17:20:34.907Z
Updated: 2026-10-17T17:20:34.907Z
Canonical: https://bigchange.ai/blog/audit-coding-agent-session-agentsview

![Conceptual charcoal illustration of a local computer with one blank transcript line highlighted and an external drive beside it.](https://bigchange.ai/api/media/file/agentsview-local-session-audit-concept-v1.png)
AI-generated conceptual illustration by BIG CHANGE; no actual AgentsView interface, transcript, usage figure or billing result is depicted.

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

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

## قبل البدء

تحتاج إلى جلسة مكتملة لوكيل برمجة يُسمح لك بقراءتها، وعبارة مميزة أو معرّف جلسة ID من تلك المهمة، وإذن بقراءة دليل سجلاتها المحلي. يورد [Quick Start](https://www.agentsview.io/docs/quickstart/) تنزيلات سطح المكتب لأنظمة 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. ثبّت البرنامج وحدّد الملف التنفيذي

اختر طريقة واحدة من [دليل التثبيت](https://www.agentsview.io/docs/quickstart/). لواجهة CLI مستقلة، هذا هو تثبيت Python الدائم الموثّق:

```sh
pip install agentsview
agentsview --version
```

يقدّم الدليل أيضًا `uvx agentsview` للتشغيل دون تثبيت دائم، وأدوات تثبيت خاصة بالمنصات، وحزم سطح المكتب. على macOS، يربط cask في Homebrew واجهة CLI المرفقة بالتطبيق؛ وقد يحتاج التطبيق المثبت من DMG إلى إضافة دليل CLI إلى `PATH`. تأكد من الملف التنفيذي الذي يعثر عليه مفسر الأوامر قبل الوثوق بإصداره. يصنّف GitHub [v0.45.0](https://github.com/kenn-io/agentsview/releases/tag/v0.45.0) بأنه إصدار 9 أكتوبر، لكن استخدم نتيجتك الخاصة للأمر `--version` عند تفسير الشاشات وبنية التقرير.

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

عند تثبيت CLI أو تطبيق سطح المكتب على المضيف، جهّز دليل بيانات جديدًا وملف `config.toml` **قبل** بدء AgentsView. يوضح [دليل الإعداد](https://www.agentsview.io/docs/configuration/#disabling-session-providers) استخدام `disabled_agents` لاستبعاد موفري نظام الملفات المحلي، واستخدام `[agents.<id>].dirs` لاستبدال الجذور الافتراضية لموفر واحد. أدرج **معرّفات ID لجميع الموفرين الآخرين** من [جدول Session Discovery](https://www.agentsview.io/docs/configuration/#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](https://www.agentsview.io/docs/quickstart/#docker) الواجهة على `127.0.0.1` فقط، ويركّب مصدر وكيل للقراءة فقط، ويستخدم وحدة بيانات منفصلة. ركّب **فقط** جذر المصدر المصرح به، واضبط متغير الدليل المطابق داخل حاوية جديدة؛ واحذف بقية التركيبات من [مثال Compose للمشروع](https://github.com/kenn-io/agentsview/blob/main/docker-compose.prod.yaml). لا ترى الحاوية إلا أدلة جلسات المضيف المركّبة صراحة. تغطي صور Docker المنشورة Linux amd64 وarm64؛ ويحتاج هذا المسار إلى تثبيت Docker يعمل.

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

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

```sh
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](https://www.agentsview.io/docs/quickstart/). دوّن الوكيل ومعرّف الجلسة ID والتاريخ لربط نتيجة الاستخدام بالمحادثة الصحيحة.

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

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

افتح عرض الاستخدام للجلسة المطابقة، وحدّد حقول النموذج والإدخال والإخراج وإنشاء ذاكرة التخزين المؤقت وقراءتها التي سُجلت وتوفرت. يصف [دليل استخدام الرموز](https://www.agentsview.io/docs/token-usage/) تقارير التكلفة بأنها **تجريبية وما زالت تتطور**. يستوعب AgentsView بيانات النموذج والرموز الوصفية من سجلات المصدر، ويحتفظ بالاستخدام الخام للرموز في صفوف الرسائل. يستخدم التكاليف الصريحة التي يبلغ عنها المصدر إن توفرت؛ وإلا فيحسب تكلفة من الرموز المتاحة وأسعار النموذج. تسمي بيانات المنشأ في JSON هذه الحالات `reported`، `computed` أو `mixed`.

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

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

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

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

```sh
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](https://www.agentsview.io/docs/quickstart/) أن إيقاف الخدمة يوقف واجهة الويب ومراقب الجلسات معًا.

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

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

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

- [ملاحظات إصدار AgentsView v0.45.0](https://github.com/kenn-io/agentsview/releases/tag/v0.45.0): تغييرات مؤرخة في تغطية الوكلاء وبطاقات Usage والمزامنة وسلوك التسعير. ملاحظة الإصدار سجل من المورد، لا اختبار من BIG CHANGE.
- [AgentsView Quick Start](https://www.agentsview.io/docs/quickstart/): طرق التثبيت المدعومة وأوامر الخادم والخدمة وإعداد المصادر وضوابط البحث المحلي.
- [إعداد AgentsView](https://www.agentsview.io/docs/configuration/): اكتشاف المصادر واستبعاد الموفرين وموقع الأرشيف وحدود هذه الضوابط.
- [استخدام الرموز والتكاليف في AgentsView](https://www.agentsview.io/docs/token-usage/): تغطية المصادر وتقارير الاستخدام ومنشأ الأسعار والوضع غير المتصل وحدود التقارير المعروفة.
- [مستودع AgentsView](https://github.com/kenn-io/agentsview): الشيفرة المصدرية وترخيص MIT؛ ويصف المستودع الأرشيف الافتراضي بأنه محلي.

## Sources

- [ملاحظات إصدار AgentsView v0.45.0](https://github.com/kenn-io/agentsview/releases/tag/v0.45.0) — إصدار مؤرخ وتغييرات في الميزات والتغطية.
- [AgentsView Quick Start](https://www.agentsview.io/docs/quickstart/) — التثبيت والتشغيل واختيار المصادر وضوابط البحث.
- [إعداد AgentsView](https://www.agentsview.io/docs/configuration/) — اكتشاف المصادر واستبعاد الموفرين ودليل البيانات وحدود الضوابط.
- [استخدام الرموز والتكاليف في AgentsView](https://www.agentsview.io/docs/token-usage/) — تقارير استخدام تجريبية ومنشأ الأسعار والحدود.
- [مستودع الشيفرة المصدرية لـ AgentsView](https://github.com/kenn-io/agentsview) — الشيفرة المصدرية ووصف المشروع وترخيص MIT.