cc-viewer 1.2.0 → 1.2.2

package/concepts/ar/Tool-TaskCreate.md

@@ -0,0 +1,38 @@
+# TaskCreate
+
+## التعريف
+
+إنشاء عناصر قائمة مهام منظمة، لتتبع التقدم وتنظيم المهام المعقدة وعرض تقدم العمل للمستخدم.
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `subject` | string | نعم | عنوان مختصر للمهمة، بصيغة الأمر (مثل "Fix authentication bug") |
+| `description` | string | نعم | وصف تفصيلي يتضمن السياق ومعايير القبول |
+| `activeForm` | string | لا | نص بصيغة المضارع المستمر يُعرض أثناء التنفيذ (مثل "Fixing authentication bug") |
+| `metadata` | object | لا | بيانات وصفية عشوائية مرفقة بالمهمة |
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- المهام المعقدة متعددة الخطوات (أكثر من 3 خطوات)
+- المستخدم قدم عدة عناصر مهام
+- تتبع العمل في وضع التخطيط
+- المستخدم طلب صراحة استخدام قائمة المهام
+
+**غير مناسب للاستخدام:**
+- مهمة واحدة بسيطة
+- عمليات بسيطة من 3 خطوات أو أقل
+- محادثة بحتة أو استعلام معلومات
+
+## ملاحظات
+
+- جميع المهام الجديدة تبدأ بحالة `pending`
+- `subject` بصيغة الأمر ("Run tests")، `activeForm` بصيغة المضارع المستمر ("Running tests")
+- بعد إنشاء المهمة يمكن تعيين التبعيات (blocks/blockedBy) عبر TaskUpdate
+- قبل الإنشاء يجب استدعاء TaskList للتحقق من عدم وجود مهام مكررة
+
+## الأهمية في cc-viewer
+
+TaskCreate هي عملية إدارة مهام داخلية في Claude Code، لا تنتج طلب API مستقل. لكن في Chat Mode يمكن رؤية كتلة tool_use التي يستدعي فيها النموذج هذه الأداة.

package/concepts/ar/Tool-TaskGet.md

@@ -0,0 +1,35 @@
+# TaskGet
+
+## التعريف
+
+الحصول على التفاصيل الكاملة للمهمة عبر معرف المهمة.
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `taskId` | string | نعم | معرف المهمة المراد الحصول عليها |
+
+## المحتوى المُرجع
+
+- `subject` — عنوان المهمة
+- `description` — المتطلبات التفصيلية والسياق
+- `status` — الحالة: `pending`، `in_progress` أو `completed`
+- `blocks` — قائمة المهام المحظورة بواسطة هذه المهمة
+- `blockedBy` — قائمة المهام السابقة التي تحظر هذه المهمة
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- الحصول على الوصف الكامل والسياق قبل بدء العمل
+- فهم علاقات التبعية للمهمة
+- الحصول على المتطلبات الكاملة بعد تعيين المهمة
+
+## ملاحظات
+
+- بعد الحصول على المهمة يجب التحقق من أن قائمة `blockedBy` فارغة قبل بدء العمل
+- استخدم TaskList لعرض معلومات ملخصة لجميع المهام
+
+## الأهمية في cc-viewer
+
+TaskGet هي عملية إدارة مهام داخلية، لا تنتج طلب API مستقل.

package/concepts/ar/Tool-TaskList.md

@@ -0,0 +1,36 @@
+# TaskList
+
+## التعريف
+
+عرض جميع المهام في قائمة المهام، لمراجعة التقدم العام والأعمال المتاحة.
+
+## المعاملات
+
+لا توجد معاملات.
+
+## المحتوى المُرجع
+
+معلومات ملخصة لكل مهمة:
+- `id` — معرف المهمة
+- `subject` — وصف مختصر
+- `status` — الحالة: `pending`، `in_progress` أو `completed`
+- `owner` — المسؤول (معرف agent)، فارغ يعني غير مُعيَّن
+- `blockedBy` — قائمة معرفات المهام غير المكتملة التي تحظر هذه المهمة
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- عرض المهام المتاحة (حالة pending، بدون owner، غير محظورة)
+- فحص التقدم العام للمشروع
+- البحث عن المهام المحظورة
+- البحث عن المهمة التالية بعد إكمال مهمة
+
+## ملاحظات
+
+- يُفضل معالجة المهام بترتيب المعرف (الأصغر أولاً)، لأن المهام المبكرة عادة توفر سياقاً للمهام اللاحقة
+- المهام التي لديها `blockedBy` لا يمكن المطالبة بها قبل رفع التبعية
+- استخدم TaskGet للحصول على التفاصيل الكاملة لمهمة محددة
+
+## الأهمية في cc-viewer
+
+TaskList هي عملية إدارة مهام داخلية، لا تنتج طلب API مستقل.

package/concepts/ar/Tool-TaskOutput.md

@@ -0,0 +1,34 @@
+# TaskOutput
+
+## التعريف
+
+الحصول على مخرجات المهام الخلفية قيد التشغيل أو المكتملة. ينطبق على shell الخلفية والوكلاء غير المتزامنين والجلسات البعيدة.
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `task_id` | string | نعم | معرف المهمة |
+| `block` | boolean | نعم | هل ينتظر بشكل محظور حتى اكتمال المهمة، الافتراضي `true` |
+| `timeout` | number | نعم | أقصى وقت انتظار (بالمللي ثانية)، الافتراضي 30000، الحد الأقصى 600000 |
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- فحص تقدم الوكلاء الخلفيين المُطلقين عبر Task (`run_in_background: true`)
+- الحصول على نتائج تنفيذ أوامر Bash الخلفية
+- انتظار اكتمال المهام غير المتزامنة والحصول على المخرجات
+
+**غير مناسب للاستخدام:**
+- المهام الأمامية — تُرجع النتائج مباشرة، لا حاجة لهذه الأداة
+
+## ملاحظات
+
+- `block: true` يحظر حتى اكتمال المهمة أو انتهاء المهلة
+- `block: false` للفحص غير المحظور للحالة الحالية
+- يمكن العثور على معرف المهمة عبر أمر `/tasks`
+- ينطبق على جميع أنواع المهام: shell الخلفية، الوكلاء غير المتزامنين، الجلسات البعيدة
+
+## الأهمية في cc-viewer
+
+استدعاء TaskOutput بحد ذاته لا ينتج طلب API، فهو عملية إدارة مهام داخلية في Claude Code ولا يظهر في سجل الطلبات.

package/concepts/ar/Tool-TaskStop.md

@@ -0,0 +1,27 @@
+# TaskStop
+
+## التعريف
+
+إيقاف مهمة خلفية قيد التشغيل.
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `task_id` | string | لا | معرف المهمة الخلفية المراد إيقافها |
+| `shell_id` | string | لا | مهمل، استخدم `task_id` بدلاً منه |
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- إنهاء المهام طويلة التشغيل التي لم تعد مطلوبة
+- إلغاء المهام الخلفية التي بدأت بالخطأ
+
+## ملاحظات
+
+- يُرجع حالة نجاح أو فشل
+- معامل `shell_id` مهمل، يجب استخدام `task_id`
+
+## الأهمية في cc-viewer
+
+استدعاء TaskStop بحد ذاته لا ينتج طلب API، وهو عملية إدارة مهام داخلية في Claude Code.

package/concepts/ar/Tool-TaskUpdate.md

@@ -0,0 +1,49 @@
+# TaskUpdate
+
+## التعريف
+
+تحديث حالة أو محتوى أو علاقات التبعية لمهمة معينة في قائمة المهام.
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `taskId` | string | نعم | معرف المهمة المراد تحديثها |
+| `status` | enum | لا | الحالة الجديدة: `pending` / `in_progress` / `completed` / `deleted` |
+| `subject` | string | لا | العنوان الجديد |
+| `description` | string | لا | الوصف الجديد |
+| `activeForm` | string | لا | نص بصيغة المضارع المستمر يُعرض أثناء التنفيذ |
+| `owner` | string | لا | المسؤول الجديد عن المهمة (اسم agent) |
+| `metadata` | object | لا | بيانات وصفية للدمج (تعيين القيمة إلى null لحذف المفتاح) |
+| `addBlocks` | string[] | لا | قائمة معرفات المهام المحظورة بواسطة هذه المهمة |
+| `addBlockedBy` | string[] | لا | قائمة معرفات المهام السابقة التي تحظر هذه المهمة |
+
+## تدفق الحالات
+
+```
+pending → in_progress → completed
+```
+
+يمكن الانتقال إلى `deleted` من أي حالة، مما يزيل المهمة نهائياً.
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- تعيين المهمة كـ `in_progress` عند بدء العمل
+- تعيين المهمة كـ `completed` بعد إنجاز العمل
+- تعيين علاقات التبعية بين المهام
+- تحديث محتوى المهمة عند تغيير المتطلبات
+
+**قواعد مهمة:**
+- لا تعيّن المهمة كـ `completed` إلا عند إنجازها بالكامل
+- عند مواجهة أخطاء أو عوائق، أبقِ الحالة `in_progress`
+- لا يجوز تعيين `completed` عند فشل الاختبارات أو عدم اكتمال التنفيذ أو وجود أخطاء غير محلولة
+
+## ملاحظات
+
+- قبل التحديث يجب الحصول على أحدث حالة للمهمة عبر TaskGet لتجنب البيانات القديمة
+- بعد إكمال المهمة استدعِ TaskList للبحث عن المهمة التالية المتاحة
+
+## الأهمية في cc-viewer
+
+TaskUpdate هي عملية إدارة مهام داخلية، لا تنتج طلب API مستقل.

package/concepts/ar/Tool-WebFetch.md

@@ -0,0 +1,36 @@
+# WebFetch
+
+## التعريف
+
+جلب محتوى صفحة ويب من عنوان URL محدد، وتحويل HTML إلى markdown، ومعالجة المحتوى باستخدام نموذج ذكاء اصطناعي وفقاً للـ prompt.
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `url` | string (URI) | نعم | عنوان URL الكامل المراد جلبه |
+| `prompt` | string | نعم | وصف المعلومات المراد استخلاصها من الصفحة |
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- الحصول على محتوى صفحات الويب العامة
+- الاطلاع على التوثيق عبر الإنترنت
+- استخلاص معلومات محددة من صفحات الويب
+
+**غير مناسب للاستخدام:**
+- عناوين URL التي تتطلب مصادقة (Google Docs، Confluence، Jira، GitHub إلخ) — يجب البحث أولاً عن أداة MCP مخصصة
+- عناوين GitHub URL — يُفضل استخدام `gh` CLI
+
+## ملاحظات
+
+- يجب أن يكون URL كاملاً وصالحاً
+- يتم ترقية HTTP تلقائياً إلى HTTPS
+- قد يتم تلخيص النتائج عندما يكون المحتوى كبيراً جداً
+- يتضمن ذاكرة مؤقتة ذاتية التنظيف مدتها 15 دقيقة
+- عند إعادة توجيه URL إلى مضيف مختلف، تُرجع الأداة عنوان URL المُعاد توجيهه ويجب إعادة الطلب بالعنوان الجديد
+- إذا كانت أداة web fetch مقدمة من MCP متاحة، يُفضل استخدامها
+
+## الأهمية في cc-viewer
+
+يظهر استدعاء WebFetch في سجل الطلبات كزوج من كتل محتوى `tool_use` / `tool_result`. يحتوي `tool_result` على ملخص محتوى صفحة الويب المعالج بالذكاء الاصطناعي.

package/concepts/ar/Tool-WebSearch.md

@@ -0,0 +1,32 @@
+# WebSearch
+
+## التعريف
+
+تنفيذ استعلامات محرك البحث، وإرجاع نتائج البحث للحصول على أحدث المعلومات.
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `query` | string | نعم | استعلام البحث (حرفان على الأقل) |
+| `allowed_domains` | string[] | لا | تضمين نتائج من هذه النطاقات فقط |
+| `blocked_domains` | string[] | لا | استبعاد نتائج من هذه النطاقات |
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- الحصول على أحدث المعلومات التي تتجاوز تاريخ قطع معرفة النموذج
+- البحث عن الأحداث الجارية وأحدث البيانات
+- البحث عن أحدث التوثيق التقني
+
+## ملاحظات
+
+- تُرجع نتائج البحث بتنسيق روابط markdown
+- بعد الاستخدام يجب إضافة قسم "Sources:" في نهاية الاستجابة مع قائمة عناوين URL ذات الصلة
+- يدعم تصفية النطاقات (تضمين/استبعاد)
+- يجب استخدام السنة الحالية في استعلامات البحث
+- متاح فقط في الولايات المتحدة
+
+## الأهمية في cc-viewer
+
+يظهر استدعاء WebSearch في سجل الطلبات كزوج من كتل محتوى `tool_use` / `tool_result`. يحتوي `tool_result` على قائمة نتائج البحث.

package/concepts/ar/Tool-Write.md

@@ -0,0 +1,32 @@
+# Write
+
+## التعريف
+
+كتابة المحتوى إلى نظام الملفات المحلي. إذا كان الملف موجوداً بالفعل فسيتم الكتابة فوقه.
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `file_path` | string | نعم | المسار المطلق للملف (يجب أن يكون مسار مطلق) |
+| `content` | string | نعم | المحتوى المراد كتابته |
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- إنشاء ملفات جديدة
+- عند الحاجة لإعادة كتابة محتوى الملف بالكامل
+
+**غير مناسب للاستخدام:**
+- تعديل محتوى جزئي في الملف — يجب استخدام Edit
+- لا ينبغي إنشاء ملفات توثيق (*.md) أو README بشكل استباقي، إلا إذا طلب المستخدم ذلك صراحة
+
+## ملاحظات
+
+- إذا كان الملف الهدف موجوداً بالفعل، يجب قراءته أولاً عبر Read وإلا سيفشل
+- يكتب فوق كامل محتوى الملف الموجود
+- يُفضل استخدام Edit لتحرير الملفات الموجودة، Write فقط لإنشاء ملفات جديدة أو إعادة الكتابة الكاملة
+
+## الأهمية في cc-viewer
+
+يظهر استدعاء Write في سجل الطلبات ككتلة محتوى `tool_use`، حيث يحتوي `input.content` على المحتوى الكامل المكتوب.

package/concepts/ar/Tool-executeCode.md

@@ -0,0 +1,33 @@
+# executeCode (mcp__ide__executeCode)
+
+## التعريف
+
+تنفيذ كود Python في Jupyter kernel الخاص بملف notebook الحالي.
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `code` | string | نعم | كود Python المراد تنفيذه |
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- تنفيذ الكود في بيئة Jupyter notebook
+- اختبار مقتطفات الكود
+- تحليل البيانات والحسابات
+
+**غير مناسب للاستخدام:**
+- تنفيذ الكود خارج بيئة Jupyter — يجب استخدام Bash
+- تعديل الملفات — يجب استخدام Edit أو Write
+
+## ملاحظات
+
+- هذه أداة MCP (Model Context Protocol)، مقدمة من تكامل IDE
+- يُنفذ الكود في Jupyter kernel الحالي، والحالة تستمر بين الاستدعاءات
+- ما لم يطلب المستخدم صراحة، يجب تجنب تعريف المتغيرات أو تعديل حالة kernel
+- تُفقد الحالة بعد إعادة تشغيل kernel
+
+## الأهمية في cc-viewer
+
+executeCode هي أداة MCP، تظهر في مصفوفة `tools` في سجل الطلبات باسم `mcp__ide__executeCode`. استدعاؤها ونتائجها تتبع نمط `tool_use` / `tool_result` القياسي. إضافة أو إزالة أدوات MCP تؤدي إلى تغيير مصفوفة tools، مما قد يؤدي إلى إعادة بناء الذاكرة المؤقتة.

package/concepts/ar/Tool-getDiagnostics.md

@@ -0,0 +1,32 @@
+# getDiagnostics (mcp__ide__getDiagnostics)
+
+## التعريف
+
+الحصول على معلومات التشخيص اللغوي من VS Code، بما في ذلك أخطاء الصياغة وأخطاء الأنواع وتحذيرات lint وغيرها.
+
+## المعاملات
+
+| المعامل | النوع | مطلوب | الوصف |
+|---------|-------|-------|-------|
+| `uri` | string | لا | عنوان URI للملف. إذا لم يُحدد يتم الحصول على معلومات التشخيص لجميع الملفات |
+
+## سيناريوهات الاستخدام
+
+**مناسب للاستخدام:**
+- فحص مشاكل الصياغة والأنواع وlint وغيرها من المشاكل الدلالية في الكود
+- التحقق بعد تحرير الكود من عدم إدخال أخطاء جديدة
+- بديل لأوامر Bash لفحص جودة الكود
+
+**غير مناسب للاستخدام:**
+- تشغيل الاختبارات — يجب استخدام Bash
+- فحص أخطاء وقت التشغيل — يجب استخدام Bash لتنفيذ الكود
+
+## ملاحظات
+
+- هذه أداة MCP (Model Context Protocol)، مقدمة من تكامل IDE
+- متاحة فقط في بيئة VS Code / IDE
+- يُفضل استخدام هذه الأداة بدلاً من أوامر Bash لفحص مشاكل الكود
+
+## الأهمية في cc-viewer
+
+getDiagnostics هي أداة MCP، تظهر في مصفوفة `tools` في سجل الطلبات باسم `mcp__ide__getDiagnostics`. استدعاؤها ونتائجها تتبع نمط `tool_use` / `tool_result` القياسي. إضافة أو إزالة أدوات MCP تؤدي إلى تغيير مصفوفة tools، مما قد يؤدي إلى إعادة بناء الذاكرة المؤقتة.

package/concepts/ar/Tools.md

@@ -0,0 +1,73 @@
+# نظرة عامة على أدوات Claude Code
+
+يوفر Claude Code مجموعة من الأدوات المدمجة للنموذج عبر آلية tool_use في Anthropic API. تحتوي مصفوفة `tools` في كل طلب MainAgent على تعريفات JSON Schema الكاملة لهذه الأدوات، ويستدعيها النموذج في الاستجابة عبر كتل محتوى `tool_use`.
+
+فيما يلي فهرس مصنف لجميع الأدوات.
+
+## نظام الوكلاء
+
+| الأداة | الغرض |
+|--------|--------|
+| [Task](Tool-Task.md) | بدء وكيل فرعي (SubAgent) لمعالجة المهام المعقدة متعددة الخطوات |
+| [TaskOutput](Tool-TaskOutput.md) | الحصول على مخرجات المهام الخلفية |
+| [TaskStop](Tool-TaskStop.md) | إيقاف مهمة خلفية قيد التشغيل |
+| [TaskCreate](Tool-TaskCreate.md) | إنشاء عنصر في قائمة المهام المنظمة |
+| [TaskGet](Tool-TaskGet.md) | الحصول على تفاصيل المهمة |
+| [TaskUpdate](Tool-TaskUpdate.md) | تحديث حالة المهمة والتبعيات وغيرها |
+| [TaskList](Tool-TaskList.md) | عرض جميع المهام |
+
+## عمليات الملفات
+
+| الأداة | الغرض |
+|--------|--------|
+| [Read](Tool-Read.md) | قراءة محتوى الملفات (يدعم النصوص والصور وPDF وJupyter notebook) |
+| [Edit](Tool-Edit.md) | تحرير الملفات عبر استبدال نصي دقيق |
+| [Write](Tool-Write.md) | كتابة أو الكتابة فوق الملفات |
+| [NotebookEdit](Tool-NotebookEdit.md) | تحرير خلايا Jupyter notebook |
+
+## البحث
+
+| الأداة | الغرض |
+|--------|--------|
+| [Glob](Tool-Glob.md) | البحث عن الملفات بمطابقة أنماط أسماء الملفات |
+| [Grep](Tool-Grep.md) | البحث في محتوى الملفات باستخدام ripgrep |
+
+## الطرفية
+
+| الأداة | الغرض |
+|--------|--------|
+| [Bash](Tool-Bash.md) | تنفيذ أوامر shell |
+
+## الويب
+
+| الأداة | الغرض |
+|--------|--------|
+| [WebFetch](Tool-WebFetch.md) | جلب محتوى صفحات الويب ومعالجته بالذكاء الاصطناعي |
+| [WebSearch](Tool-WebSearch.md) | استعلامات محرك البحث |
+
+## التخطيط والتفاعل
+
+| الأداة | الغرض |
+|--------|--------|
+| [EnterPlanMode](Tool-EnterPlanMode.md) | الدخول في وضع التخطيط لتصميم خطة التنفيذ |
+| [ExitPlanMode](Tool-ExitPlanMode.md) | الخروج من وضع التخطيط وتقديم الخطة لموافقة المستخدم |
+| [AskUserQuestion](Tool-AskUserQuestion.md) | طرح أسئلة على المستخدم للتوضيح أو اتخاذ القرارات |
+
+## الإضافات
+
+| الأداة | الغرض |
+|--------|--------|
+| [Skill](Tool-Skill.md) | تنفيذ المهارات (slash command) |
+
+## تكامل IDE
+
+| الأداة | الغرض |
+|--------|--------|
+| [getDiagnostics](Tool-getDiagnostics.md) | الحصول على معلومات التشخيص اللغوي من VS Code |
+| [executeCode](Tool-executeCode.md) | تنفيذ الكود في Jupyter kernel |
+
+## الأهمية في cc-viewer
+
+استدعاءات الأدوات هي من أهم البيانات القابلة للرصد في سجلات طلبات Claude Code. تحدد مصفوفة `tools` في كل طلب MainAgent مجموعة الأدوات المتاحة للنموذج، بينما تسجل كتل محتوى `tool_use` / `tool_result` في الاستجابة استدعاءات الأدوات الفعلية ونتائجها. يقوم cc-viewer بتحليل هذه البيانات لإعادة بناء سلسلة استدعاءات الأدوات الكاملة في Chat Mode.
+
+التغييرات في تعريفات الأدوات (مثل إضافة/إزالة أدوات بسبب اتصال/انقطاع خادم MCP) تؤدي إلى إعادة بناء الذاكرة المؤقتة، راجع [CacheRebuild](CacheRebuild.md).

package/concepts/ar/TranslateContextPollution.md

@@ -0,0 +1,46 @@
+# تلوث السياق في Translate API
+
+## الخلفية
+
+يتضمن CC-Viewer ميزة ترجمة مدمجة (`POST /api/translate`) تعمل بواسطة Anthropic Messages API. في التنفيذ المبكر، كانت طلبات الترجمة تعيد استخدام بيانات المصادقة المخزنة مؤقتاً من جلسة Claude Code — بما في ذلك رؤوس `x-api-key` و `authorization`. تسبب هذا في مشكلة خفية لكنها خطيرة: كانت نتائج الترجمة تعيد في كثير من الأحيان محتوى غير ذي صلة.
+
+## السبب الجذري
+
+### الفرق الجوهري بين طريقتي المصادقة
+
+يدعم Anthropic API طريقتين للمصادقة:
+
+| الطريقة | الرأس | المصدر النموذجي | الخصائص |
+|---------|-------|-----------------|---------|
+| مفتاح API | `x-api-key: sk-ant-...` | متغير البيئة / Console | عديم الحالة، كل طلب مستقل |
+| رمز OAuth | `authorization: Bearer sessionToken` | تسجيل دخول اشتراك Claude Code | مرتبط بالجلسة، يحتفظ الخادم بارتباط السياق |
+
+الفرق الجوهري: **مفاتيح API عديمة الحالة** — كل طلب مستقل تماماً؛ بينما **رموز جلسة OAuth ذات حالة** — يربط خادم Anthropic الطلبات التي تستخدم نفس الرمز بنفس سياق الجلسة.
+
+### سلسلة التلوث
+
+عندما يستخدم Claude Code تسجيل دخول OAuth بالاشتراك، يبدو تدفق المصادقة كالتالي:
+
+```
+المحادثة الرئيسية لـ Claude Code ──(authorization: Bearer sessionToken)──→ Anthropic API
+                                                                              ↑
+طلب ترجمة CC-Viewer ──(authorization: Bearer sessionToken)──→ Anthropic API
+```
+
+نظراً لأن طلبات الترجمة أعادت استخدام نفس رمز الجلسة، فقد يربط خادم Anthropic طلبات الترجمة بسياق المحادثة الرئيسية لـ Claude Code. يؤدي هذا إلى:
+
+1. **تأثر نتائج الترجمة بسياق المحادثة الرئيسية**: موجه النظام لطلب الترجمة هو "أنت مترجم"، لكن سياق الخادم لا يزال يحتوي على سجل محادثات Claude Code، مما قد يتداخل مع النموذج
+2. **تعطل المحادثة الرئيسية بسبب طلبات الترجمة**: قد يتم حقن محتوى طلبات الترجمة (أجزاء نصوص واجهة المستخدم) في سياق المحادثة الرئيسية، مما يتسبب في انحراف استجابات Claude Code
+3. **سلوك غير متوقع**: نظراً لأن تلوث السياق هو سلوك من جانب الخادم، لا يمكن للعميل اكتشافه أو التحكم فيه
+
+## الدروس المستفادة
+
+- **رموز جلسة OAuth ليست "مجرد مفتاح API آخر"** — فهي تحمل حالة من جانب الخادم، وإعادة استخدامها تعني مشاركة السياق
+- **يجب أن تستخدم استدعاءات الخدمات الداخلية مصادقة مستقلة وعديمة الحالة** لتجنب الارتباط بجلسات المستخدمين
+
+## المراجع
+
+- [Anthropic API Authentication Docs](https://docs.anthropic.com/en/api/getting-started)
+- [Claude Code Authentication](https://support.claude.com/en/articles/12304248-managing-api-key-environment-variables-in-claude-code)
+- [Anthropic Bans Subscription OAuth in Third-Party Apps](https://winbuzzer.com/2026/02/19/anthropic-bans-claude-subscription-oauth-in-third-party-apps-xcxwbn/)
+- [Claude Code Authentication: API Keys, Subscriptions, and SSO](https://developertoolkit.ai/en/claude-code/quick-start/authentication/)

package/concepts/da/BodyDiffJSON.md

@@ -0,0 +1,32 @@
+# Body Diff JSON (inkrementel sammenligning af request body)
+
+## Baggrund
+
+Claude Codes MainAgent bruger en mekanisme med fuld kontekstafsendelse — hver request inkluderer den komplette samtalehistorik, system prompt, værktøjsdefinitioner osv. Det betyder, at efterhånden som samtalen skrider frem, bliver request body stadigt større, og det bliver svært hurtigt at finde ud af "hvad blev der tilføjet i denne runde" ved at se på den rå Body.
+
+Body Diff JSON er skabt netop for at løse dette problem: den sammenligner automatisk body fra to på hinanden følgende MainAgent-requests og udtrækker den inkrementelle del, så du med ét blik kan se det faktisk tilføjede indhold i denne request.
+
+## Sådan fungerer det
+
+1. **Identificering af på hinanden følgende MainAgent-requests**: den aktuelle request skal være af typen MainAgent, og der skal eksistere en tidligere MainAgent-request
+2. **Felt-for-felt sammenligning**: alle felter på øverste niveau i request body gennemgås, og interne egenskaber med `_`-præfiks springes over
+3. **Intelligent forskeludtrækning**:
+   - Tilføjede felter: vises direkte
+   - Fjernede felter: vises ikke (påvirker normalt ikke forståelsen)
+   - Ændrede felter: den aktuelle værdi vises
+   - Særlig behandling af `messages`-arrayet: kun tilføjede beskeder vises (da normal samtale er i tilføjelsestilstand, og præfiksbeskeder forbliver uændrede)
+4. **Registrering af body-reduktion**: hvis den aktuelle request body er mindre end den forrige, betyder det, at der er sket en kontekstafkortning eller sessionsreset; i så fald vises en informationsbesked i stedet for diff
+
+## Typiske scenarier
+
+I en normal samtalerunde indeholder Body Diff JSON normalt kun:
+- `messages`: 1~2 tilføjede beskeder (brugerens input + assistentens svar fra forrige runde)
+
+Hvis du ser ændringer i felter som `system`, `tools`, `model` i diff'en, betyder det, at der er sket en konfigurationsændring i denne runde, hvilket ofte også er årsagen til cache-genopbygning.
+
+## Brug
+
+- Body Diff JSON vises i detaljepanelet for MainAgent-requesten
+- Klik på titlen for at udvide/skjule
+- Understøtter to visningstilstande, JSON og Text, samt kopiering med ét klik
+- Øverst til venstre under **CC-Viewer → Globale indstillinger** kan du indstille "Udvid Body Diff JSON som standard"

package/concepts/da/CacheRebuild.md

@@ -0,0 +1,40 @@
+# Cache Rebuild (cache-genopbygning)
+
+## Baggrund
+
+Anthropics prompt caching-mekanisme sammenkæder system → tools → messages (til cache breakpoint) fra requesten i rækkefølge som cache-nøgle. Når cache-nøglen er identisk med den forrige request, returnerer API'en `cache_read_input_tokens` (cache hit); når cache-nøglen ændres, genskaber API'en cachen og returnerer et stort antal `cache_creation_input_tokens`, dvs. cache-genopbygning.
+
+Cache-genopbygning medfører ekstra token-omkostninger (prisen for cache creation er højere end cache read), så det har direkte værdi for omkostningsoptimering at identificere årsagen til genopbygningen.
+
+## Klassificering af årsager til cache-genopbygning
+
+cc-viewer sammenligner body fra to på hinanden følgende MainAgent-requests for præcist at bestemme årsagen til cache-genopbygningen:
+
+| reason | Betydning | Bestemmelsesmetode |
+|--------|------|----------|
+| `ttl` | Cache udløbet | Der er gået mere end 5 minutter siden sidste MainAgent-request |
+| `system_change` | System prompt ændret | `JSON.stringify(prev.system) !== JSON.stringify(curr.system)` |
+| `tools_change` | Værktøjsdefinitioner ændret | `JSON.stringify(prev.tools) !== JSON.stringify(curr.tools)` |
+| `model_change` | Model skiftet | `prev.model !== curr.model` |
+| `msg_truncated` | Beskedstakken afkortet | Antallet af beskeder i den aktuelle request er mindre end i den forrige, normalt udløst af afkortning pga. kontekstvindue-overflow |
+| `msg_modified` | Historiske beskeder ændret | Præfiks-beskedernes indhold er inkonsistent (ved normal tilføjelse bør præfikset være identisk) |
+| `key_change` | Ukendt nøgleændring | Fallback når ingen af ovenstående betingelser matcher |
+
+## Bestemmelsesprioritering
+
+1. Først kontrolleres tidsintervallet — over 5 minutter bestemmes direkte som `ttl`, uden body-sammenligning
+2. Derefter kontrolleres i rækkefølge model, system, tools, messages
+3. En request kan matche flere årsager samtidigt (f.eks. modelskift + system prompt-ændring); i så fald indeholder `reasons`-arrayet alle matchende elementer, og tooltip'en viser dem på separate linjer
+
+## Almindelige scenarier
+
+- **`ttl`**: brugeren pauserede i mere end 5 minutter og fortsatte derefter, cachen udløb naturligt
+- **`system_change`**: Claude Code opdaterede system prompten (f.eks. indlæsning af ny CLAUDE.md, ændring af project instructions)
+- **`tools_change`**: tilslutning/frakobling af MCP-server medførte ændring af listen over tilgængelige værktøjer
+- **`model_change`**: brugeren skiftede model via `/model`-kommandoen
+- **`msg_truncated`**: en for lang samtale udløste kontekstvindue-styring, Claude Code afkortede tidlige beskeder
+- **`msg_modified`**: Claude Code redigerede historiske beskeder (f.eks. `/compact` erstattede originale beskeder med et komprimeret resumé)
+
+## Visning i cc-viewer
+
+I requestlisten viser requests med cache-genopbygning en rød prikindikator i cache-rækken. Ved mouseover vises en tooltip med den specifikke beskrivelse af genopbygningsårsagen (understøtter 18 sprog).

package/concepts/da/MainAgent.md

@@ -0,0 +1,30 @@
+# MainAgent
+
+## Definition
+
+MainAgent er den primære requestkæde i Claude Code, når det ikke er i agent team-tilstand. Hver interaktion mellem brugeren og Claude Code genererer en serie API-requests, hvor MainAgent-requests udgør den centrale samtalekæde — de bærer det komplette system prompt, værktøjsdefinitioner og beskedhistorik.
+
+## Identifikationsmetode
+
+I cc-viewer identificeres MainAgent via `req.mainAgent === true`, automatisk markeret af `interceptor.js` ved request-opfangning.
+
+Betingelser for bestemmelse (alle skal være opfyldt):
+- Request body indeholder feltet `system` (system prompt)
+- Request body indeholder `tools`-arrayet (værktøjsdefinitioner)
+- System prompten indeholder den karakteristiske tekst "Claude Code"
+
+## Forskelle fra SubAgent
+
+| Egenskab | MainAgent | SubAgent |
+|------|-----------|----------|
+| system prompt | Komplet Claude Code hoved-prompt | Forenklet opgavespecifikt prompt |
+| tools-array | Indeholder alle tilgængelige værktøjer | Indeholder normalt kun de få værktøjer, der er nødvendige for opgaven |
+| Beskedhistorik | Akkumulerer komplet samtale-kontekst | Indeholder kun beskeder relateret til underopgaven |
+| Cache-adfærd | Har prompt caching (5 minutters TTL) | Normalt ingen cache eller mindre cache |
+
+## Betydning i cc-viewer
+
+- **Cache-sporing**: prompt caching-status for MainAgent-requests påvirker direkte omkostningerne. Ved at overvåge forholdet mellem `cache_creation_input_tokens` og `cache_read_input_tokens` kan man vurdere cache hit-raten
+- **Analyse af cache-tab**: når en MainAgent-request viser stor cache creation (i stedet for cache read), betyder det, at cachen er gået tabt og genopbygget; cc-viewer markerer disse requests med en rød prikindikator
+- **Analyse af hovedkæden**: sekvensen af MainAgent-requests afspejler hele brugerens interaktionsproces med Claude Code og er de centrale data til analyse af sessionsadfærd
+- **Sessionsrekonstruktion**: cc-viewer rekonstruerer samtalevisningen (Chat Mode) gennem beskedhistorikken i MainAgent-requests