cx-viewer 1.0.0

package/concepts/ar/UltraPlan.md

@@ -0,0 +1,55 @@
+# UltraPlan — آلة الأمنيات المطلقة
+
+## ما هو UltraPlan
+
+UltraPlan هو **التنفيذ المحلي** من cc-viewer لأمر `/ultraplan` الأصلي في Claude Code. يتيح لك استخدام الإمكانيات الكاملة لـ `/ultraplan` في بيئتك المحلية **دون الحاجة إلى تشغيل خدمة Claude الرسمية عن بُعد**، موجهاً Claude Code لإنجاز مهام التخطيط والتنفيذ المعقدة باستخدام **التعاون متعدد الوكلاء**.
+
+مقارنة بوضع Plan العادي أو Agent Team، يستطيع UltraPlan:
+- تقييم تعقيد المهمة تلقائياً واختيار استراتيجية التخطيط المثلى
+- نشر عدة وكلاء متوازيين لاستكشاف قاعدة الشفرة من أبعاد مختلفة
+- دمج البحث الخارجي (webSearch) للحصول على أفضل الممارسات في المجال
+- تجميع فريق Code Review تلقائياً بعد تنفيذ الخطة لمراجعة الشفرة
+- تشكيل حلقة مغلقة كاملة **خطة → تنفيذ → مراجعة → إصلاح**
+
+---
+
+## ملاحظات مهمة
+
+### 1. UltraPlan ليس كلي القدرة
+UltraPlan هو آلة أمنيات أكثر قوة، لكن هذا لا يعني أن كل أمنية يمكن تحقيقها. إنه أقوى من Plan و Agent Team، لكنه لا يستطيع مباشرة "جعلك تربح المال". خذ بعين الاعتبار حجم المهام المعقول — قسم الأهداف الكبيرة إلى مهام متوسطة قابلة للتنفيذ بدلاً من محاولة إنجاز كل شيء دفعة واحدة.
+
+### 2. الأكثر فعالية حالياً لمشاريع البرمجة
+قوالب UltraPlan وسير العمل الخاص به محسنة بعمق لمشاريع البرمجة. يمكن تجربة سيناريوهات أخرى (التوثيق، تحليل البيانات، إلخ.)، لكن قد ترغب في انتظار تكييفات الإصدارات المستقبلية.
+
+### 3. وقت التنفيذ ومتطلبات نافذة السياق
+- يستغرق تشغيل UltraPlan الناجح عادةً **30 دقيقة أو أكثر**
+- يتطلب أن يمتلك MainAgent نافذة سياق كبيرة (يُوصى بنموذج Opus بسياق 1M)
+- إذا كان لديك نموذج 200K فقط، **تأكد من تنفيذ `/clear` للسياق قبل التشغيل**
+- يعمل أمر `/compact` في Claude Code بشكل سيئ عندما تكون نافذة السياق غير كافية — تجنب نفاد المساحة
+- الحفاظ على مساحة سياق كافية هو شرط أساسي حاسم لنجاح تنفيذ UltraPlan
+
+إذا كانت لديك أي أسئلة أو اقتراحات حول UltraPlan المحلي، لا تتردد في فتح [Issues على GitHub](https://github.com/anthropics/claude-code/issues) للمناقشة والتعاون.
+
+---
+
+## كيف يعمل
+
+يقدم UltraPlan وضعين للتشغيل:
+
+### الوضع التلقائي
+يحلل تعقيد المهمة تلقائياً (درجة 4-12) ويوجه إلى استراتيجيات مختلفة:
+
+| المسار | الدرجة | الاستراتيجية |
+|--------|--------|--------------|
+| المسار A | 4-6 | تخطيط خفيف مع استكشاف مباشر للشفرة |
+| المسار B | 7-9 | تخطيط مع رسوم بيانية هيكلية (Mermaid / ASCII) |
+| المسار C | 10-12 | استكشاف متعدد الوكلاء + حلقة مراجعة مغلقة |
+
+### الوضع الإجباري
+ينشط مباشرة سير العمل الكامل متعدد الوكلاء للمسار C:
+1. نشر ما يصل إلى 5 وكلاء متوازيين لاستكشاف قاعدة الشفرة بشكل متزامن (البنية، تحديد الملفات، تقييم المخاطر، إلخ.)
+2. نشر وكيل بحثي اختيارياً للتحقيق في حلول المجال عبر webSearch
+3. تجميع جميع نتائج الوكلاء في خطة تنفيذ مفصلة
+4. نشر وكيل مراجعة لفحص الخطة بدقة من عدة وجهات نظر
+5. تنفيذ الخطة بعد الموافقة
+6. تجميع فريق Code Review تلقائياً للتحقق من جودة الشفرة بعد التنفيذ

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/BodyFields.md

@@ -0,0 +1,42 @@
+# Beskrivelse af Request Body-felter
+
+Beskrivelse af topniveau-felterne i Claude API `/v1/messages` request body.
+
+## Feltliste
+
+| Felt | Type | Beskrivelse |
+|------|------|------|
+| **model** | string | Navnet på den anvendte model, f.eks. `claude-opus-4-6`, `claude-sonnet-4-6` |
+| **messages** | array | Samtalens beskedhistorik. Hver besked indeholder `role` (user/assistant) og `content` (et block-array med tekst, billeder, tool_use, tool_result osv.) |
+| **system** | array | System prompt. Indeholder Codexs kerneinstruktioner, vejledning til brug af værktøjer, miljøoplysninger, CLAUDE.md-indhold m.m. Blokke med `cache_control` cachelagres via prompt caching |
+| **tools** | array | Liste over tilgængelige værktøjsdefinitioner. Hvert værktøj indeholder `name`, `description` og `input_schema` (JSON Schema). MainAgent har typisk 20+ værktøjer, SubAgent har kun få |
+| **metadata** | object | Request-metadata, indeholder typisk `user_id` til brugeridentifikation |
+| **max_tokens** | number | Maksimalt antal tokens i et enkelt modelsvar, f.eks. `16000`, `64000` |
+| **thinking** | object | Konfiguration af udvidet tænkning. `type: "enabled"` aktiverer tænketilstand, `budget_tokens` styrer øvre grænse for tænke-tokens |
+| **context_management** | object | Konfiguration af kontekststyring. `truncation: "auto"` tillader Codex automatisk at afkorte for lange beskedhistorikker |
+| **output_config** | object | Outputkonfiguration, f.eks. `format`-indstillinger |
+| **stream** | boolean | Om streaming-svar er aktiveret. Codex bruger altid `true` |
+
+## messages-struktur
+
+Hver beskeds `content` er et block-array med følgende almindelige typer:
+
+- **text**: Almindeligt tekstindhold
+- **tool_use**: Modellen kalder et værktøj (indeholder `name`, `input`)
+- **tool_result**: Resultatet af værktøjsudførelse (indeholder `tool_use_id`, `content`)
+- **image**: Billedindhold (base64 eller URL)
+- **thinking**: Modellens tænkeproces (udvidet tænketilstand)
+
+## system-struktur
+
+System prompt-arrayet indeholder typisk:
+
+1. **Kerne-agent-instruktioner** ("You are Codex...")
+2. **Regler for brug af værktøjer**
+3. **CLAUDE.md-indhold** (projektspecifikke instruktioner)
+4. **Færdighedspåmindelser** (skills reminder)
+5. **Miljøoplysninger** (OS, shell, git-status osv.) — Codex er faktisk meget afhængig af git. Hvis projektet har et git-repository, kan Codex vise bedre forståelse af projektet, herunder hente fjernændringer og commit-historik til analyse
+
+Blokke markeret med `cache_control: { type: "ephemeral" }` cachelagres af Anthropic API i 5 minutter. Ved cache-hit faktureres de som `cache_read_input_tokens` (betydeligt billigere end `input_tokens`).
+
+> **Bemærk**: For specialiserede klienter som Codex er Anthropic-serveren faktisk ikke fuldstændigt afhængig af `cache_control`-attributten i requesten til at bestemme cacheadfærd. Serveren anvender automatisk cachestrategier for bestemte felter (som system prompt og tools-definitioner), selv når requesten ikke eksplicit indeholder `cache_control`-markering. Derfor behøver du ikke undre dig, når du ikke ser denne attribut i request body — serveren har allerede udført cacheoperationen bag kulisserne, men viser det bare ikke til klienten. Det er en stiltiende aftale mellem Codex og Anthropic API.

package/concepts/da/CacheRebuild.md

@@ -0,0 +1,36 @@
+# 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é)

package/concepts/da/GlobalSettings.md

@@ -0,0 +1,232 @@
+# CC-Viewer 全局配置参考
+
+## 一、全局设置面板（UI）
+
+通过左上角菜单 → "全局设置" 打开。
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+| 过滤无关请求 | 开关 | 开 | 隐藏心跳、count_tokens、子代理等非主代理请求 |
+| 默认展开 Body Diff JSON | 开关 | 关 | 请求详情面板中的 Body Diff 区域默认展开 |
+| 日志目录设置 | 文本输入 | `~/.claude/cc-viewer` | 项目日志的读写根目录，支持 `~/` 展开。修改后回车或失焦保存，立即生效 |
+
+## 二、显示设置面板（UI）
+
+通过左上角菜单 → "显示设置" 打开。
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+| 折叠工具结果 | 开关 | 开 | 聊天视图中折叠工具调用结果块 |
+| 展开思考过程 | 开关 | 开 | 默认展开 Claude 的思考/推理过程块 |
+| 完整展示所有内容 | 开关 | 关 | 显示完整的工具调用内容，不截断 |
+| 自动恢复会话 | 开关 + 选项 | 关 | 遇到会话恢复提示时自动选择：`继续` 或 `新建` |
+
+## 三、偏好设置文件
+
+所有 UI 设置持久化到 `<日志目录>/preferences.json`，通过 `/api/preferences` 接口读写。
+
+```json
+{
+  "lang": "zh",
+  "filterIrrelevant": true,
+  "expandDiff": false,
+  "collapseToolResults": true,
+  "expandThinking": true,
+  "showFullToolContent": false,
+  "logDir": "~/.claude/cc-viewer",
+  "resumeAutoChoice": null,
+  "disabledPlugins": [],
+  "presetShortcuts": []
+}
+```
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `lang` | string | 界面语言（zh/en/zh-TW/ko/ja/de/es/fr/it/da/pl/ru/ar/no/pt-BR/th/tr/uk） |
+| `filterIrrelevant` | boolean | 过滤无关请求 |
+| `expandDiff` | boolean | 默认展开 Body Diff JSON |
+| `collapseToolResults` | boolean | 折叠工具结果 |
+| `expandThinking` | boolean | 展开思考过程 |
+| `showFullToolContent` | boolean | 完整展示内容 |
+| `logDir` | string | 日志目录路径 |
+| `resumeAutoChoice` | null / "continue" / "new" | 自动恢复会话选择 |
+| `disabledPlugins` | string[] | 已禁用的插件文件名列表 |
+| `presetShortcuts` | array | Agent Team 快捷指令预设 |
+
+## 四、环境变量
+
+### CC-Viewer 专有
+
+| 变量名 | 默认值 | 说明 |
+|--------|--------|------|
+| `CCV_LOG_DIR` | `~/.claude/cc-viewer` | 日志存储根目录。特殊值：`tmp`/`temp` 使用系统临时目录 |
+| `CCV_CLI_MODE` | 未设置 | `=1` 启用 CLI 模式（PTY 终端） |
+| `CCV_SDK_MODE` | 未设置 | `=1` 启用 Agent SDK 模式（无终端） |
+| `CCV_WORKSPACE_MODE` | 未设置 | `=1` 启用工作空间选择模式 |
+| `CCV_PROJECT_DIR` | `process.cwd()` | 项目工作目录，用于文件操作和 Git 命令 |
+| `CCV_PROXY_PORT` | 未设置 | 本地 MITM 代理端口 |
+| `CCV_BYPASS_PERMISSIONS` | 未设置 | `=1` 跳过工具权限审批（配合 `--dangerously-skip-permissions`） |
+| `CCV_DISABLE_DELTA` | 未设置 | `=1` 禁用增量日志存储，每次写入完整消息 |
+| `CCV_DEBUG` | 未设置 | `=1` 启用 HTTP 代理调试日志 |
+| `CCV_DEBUG_PLUGINS` | 未设置 | `=1` 启用插件加载调试日志 |
+
+### 内部 IPC
+
+| 变量名 | 说明 |
+|--------|------|
+| `CCVIEWER_PORT` | 服务端口，供 ask-bridge/perm-bridge 通信 |
+| `CCV_EDITOR_PORT` | 服务端口，供 ccv-editor 文件编辑桥接 |
+
+### 外部变量（读取）
+
+| 变量名 | 说明 |
+|--------|------|
+| `ANTHROPIC_BASE_URL` | 自定义 Anthropic API 地址 |
+| `SHELL` | 用户 Shell（PTY 启动和 Shell 配置检测） |
+| `http_proxy` / `HTTPS_PROXY` 等 | HTTP 代理配置（通过 undici EnvHttpProxyAgent） |
+
+## 五、CLI 命令参数
+
+```
+ccv [选项] [claude 参数...]
+```
+
+### CC-Viewer 专有选项
+
+| 参数 | 说明 |
+|------|------|
+| `-logger` | 安装/修复 Claude Code hooks |
+| `--uninstall` / `-uninstall` | 卸载所有 CC-Viewer 集成 |
+| `--help` / `-h` / `help` | 显示帮助信息 |
+| `--version` / `-v` | 显示版本号 |
+| `-SDK` / `--sdk` | 使用 Agent SDK 模式 |
+| `--d` | `--dangerously-skip-permissions` 简写 |
+| `--ad` | `--allow-dangerously-skip-permissions` 简写 |
+| `run` | 通过代理运行命令（`ccv run -- claude ...`） |
+
+### Claude 透传参数（常用）
+
+| 参数 | 说明 |
+|------|------|
+| `-c` / `--continue` | 继续上一次会话 |
+| `-r` / `--resume` | 恢复指定会话 |
+| `-p` / `--print` | 非交互式输出 |
+| `--model` | 指定模型 |
+| `--permission-mode` | 权限模式 |
+| `--system-prompt` | 自定义系统提示词 |
+| `--max-budget-usd` | 最大预算 |
+
+## 六、Hook 配置
+
+CC-Viewer 自动注册到 `~/.claude/settings.json` 的 `hooks.PreToolUse` 中：
+
+### 1. AskUserQuestion 桥接
+- **匹配器**: `"AskUserQuestion"`
+- **命令**: `node <安装目录>/lib/ask-bridge.js`
+- **作用**: 将 Claude 的问题转发到 Web UI，等待用户回答
+
+### 2. 权限审批桥接
+- **匹配器**: `""` (空 = 匹配所有工具)
+- **命令**: `node <安装目录>/lib/perm-bridge.js`
+- **作用**: 仅 `Bash`/`Edit`/`Write`/`NotebookEdit` 需要 Web UI 审批，其余自动放行
+
+## 七、Shell 集成
+
+CC-Viewer 在 `~/.zshrc`（或 `.bashrc`）中注入 `claude()` 函数：
+
+```bash
+# >>> CC-Viewer Auto-Inject >>>
+claude() { ... }
+# <<< CC-Viewer Auto-Inject <<<
+```
+
+所有 `claude` 命令自动通过 CC-Viewer 代理，实现日志捕获和 Web UI 功能。
+
+卸载：`ccv --uninstall` 或手动删除标记之间的内容。
+
+## 八、代理配置（Proxy Profile）
+
+存储在 `<日志目录>/profile.json`，通过 UI 的"代理切换"面板管理。
+
+```json
+{
+  "active": "max",
+  "profiles": [
+    { "id": "max", "name": "Default" },
+    { "id": "my-proxy", "name": "自定义", "baseURL": "https://...", "apiKey": "sk-..." }
+  ]
+}
+```
+
+| 字段 | 说明 |
+|------|------|
+| `active` | 当前激活的配置 ID（`"max"` = 直连，无代理） |
+| `id` | 唯一标识 |
+| `name` | 显示名称 |
+| `baseURL` | 代理 API 地址（替换请求 origin） |
+| `apiKey` | 代理 API 密钥（替换认证头） |
+| `models` | 可用模型列表 |
+| `activeModel` | 当前选中的模型 |
+
+## 九、插件系统
+
+插件目录：`<日志目录>/plugins/`
+
+### 支持的 Hook 类型
+
+| Hook | 类型 | 说明 |
+|------|------|------|
+| `httpsOptions` | 瀑布 | 提供 HTTPS 证书（返回 `{ cert, key }` 或 `{ pfx }`） |
+| `localUrl` | 瀑布 | 修改本地访问 URL |
+| `serverStarted` | 并行 | 服务器启动通知 |
+| `serverStopping` | 并行 | 服务器停止通知 |
+| `onNewEntry` | 并行 | 新日志条目写入通知 |
+
+插件启用/禁用通过 `preferences.json` 的 `disabledPlugins` 数组管理。
+
+## 十、目录结构
+
+```
+~/.claude/cc-viewer/               # 日志根目录
+├── preferences.json               # 用户偏好设置
+├── workspaces.json                # 工作空间注册表
+├── profile.json                   # 代理配置
+├── plugins/                       # 插件目录
+│   └── my-plugin.js
+├── <项目名>/                       # 每个项目的日志目录
+│   ├── <项目名>_20260404_123456.jsonl  # JSONL 日志文件
+│   ├── <项目名>.json              # 统计数据（后台生成）
+│   └── images/                    # 上传图片的持久副本
+└── ...
+
+/tmp/cc-viewer-uploads/            # 临时上传文件目录
+```
+
+## 十一、服务器配置
+
+| 配置 | 值 | 说明 |
+|------|-----|------|
+| 端口范围 | 7008-7099 | 自动扫描可用端口 |
+| 绑定地址 | 0.0.0.0 | 所有网络接口 |
+| 访问令牌 | 随机 16 字节 hex | 局域网访问需要 `?token=xxx`，本机免认证 |
+| HTTPS | 仅通过插件 | 需要插件提供 `httpsOptions` hook |
+| CORS | `*` | 允许所有来源 |
+| 上传限制 | 50MB | 单文件最大上传大小 |
+
+## 十二、URL 参数
+
+| 参数 | 说明 |
+|------|------|
+| `?token=xxx` | 局域网访问认证令牌 |
+| `?logfile=path` | 打开指定历史日志文件（只读模式） |
+
+## 十三、localStorage 配置
+
+| 键 | 说明 |
+|-----|------|
+| `cxv_cacheExpireAt` | 缓存倒计时到期时间 |
+| `cxv_cacheType` | 缓存类型标签 |
+| `ccv_sseSlim` | 启用 SSE 增量裁剪（桌面端性能优化） |
+| `ccv_calibrationModel` | KV-Cache 上下文窗口校准模型 |
+| `ccv_fileExplorerOpen` | 文件浏览器面板开关 |
+| `cc-viewer-terminal-width` | 终端面板宽度（像素） |

package/concepts/da/KVCacheContent.md

@@ -0,0 +1,49 @@
+# KV-Cache cacheindhold
+
+## Hvad er Prompt Caching?
+
+Når du samtaler med Claude, sender hver API-anmodning den komplette samtalekontekst (system prompt + værktøjsdefinitioner + beskedhistorik). Anthropics prompt caching-mekanisme cacher allerede beregnet præfiksindhold på serversiden, og hvis præfikset er det samme ved efterfølgende anmodninger, genbruges cacheresultatet direkte, hvilket springer gentagne beregninger over og reducerer latens og omkostninger betydeligt.
+
+I cc-viewer omtales denne mekanisme som "KV-Cache", der svarer til prompt caching på Anthropic API-niveau — ikke key-value cachen i transformerens opmærksomhedslag internt i LLM'en.
+
+## Hvordan caching fungerer
+
+Anthropics prompt caching sammenkæder cachenøgler i en fast rækkefølge:
+
+```
+Tools → System Prompt → Messages (til cache breakpoint)
+```
+
+Så længe dette præfiks er helt identisk med en hvilken som helst anmodning inden for TTL-vinduet, rammer API'en cachen (returnerer `cache_read_input_tokens`) i stedet for at genberegne (`cache_creation_input_tokens`).
+
+> **Claude Code er ikke stærkt afhængig af `cache_control`-attributten — serveren fjerner nogle af disse attributter, men kan stadig oprette cache fint, så fraværet af `cache_control`-attributten betyder ikke, at indholdet ikke er cachet**
+>
+> For specialklienter som Claude Code er Anthropics server ikke fuldstændig afhængig af `cache_control`-attributten i anmodningen til at bestemme cache-adfærd. Serveren udfører automatisk cache-strategier for specifikke felter (som system prompt og værktøjsdefinitioner), selv når anmodningen ikke eksplicit indeholder `cache_control`-markører. Derfor behøver du ikke undre dig, når du ikke ser denne attribut i anmodningens body — serveren har allerede udført cache-operationen bag kulisserne, den har bare ikke eksponeret denne information for klienten. Dette er en stiltiende aftale mellem Claude Code og Anthropic API.
+
+## Hvad er "aktuelt KV-Cache cacheindhold"?
+
+Det "aktuelle KV-Cache cacheindhold" vist i cc-viewer er indhold udtrukket fra den seneste MainAgent-anmodning, som befinder sig før cachegrænsen (cache breakpoint). Det omfatter specifikt:
+
+- **System Prompt**: Claude Codes systeminstruktioner, herunder kerne-agent-instruktioner, retningslinjer for værktøjsbrug, CLAUDE.md-projektinstruktioner, miljøinformation osv.
+- **Tools**: Listen over aktuelt tilgængelige værktøjsdefinitioner (såsom Read, Write, Bash, Agent, MCP-værktøjer osv.)
+- **Messages**: Den del af samtalehistorikken, der er cachet (normalt ældre beskeder, op til det sidste `cache_control`-mærke)
+
+## Hvorfor se cacheindholdet?
+
+1. **Forstå konteksten**: Vid hvad Claude i øjeblikket "husker", og hjælp dig med at vurdere, om dens adfærd matcher forventningerne
+2. **Omkostningsoptimering**: Cache-hit koster langt mindre end genberegning. At se cacheindholdet hjælper dig med at forstå, hvorfor visse anmodninger udløste cache-genopbygning (cache rebuild)
+3. **Fejlfinding af samtale**: Når Claudes svar ikke matcher forventningerne, kan kontrol af cacheindholdet bekræfte, om system prompt og beskedhistorik er korrekte
+4. **Overvågning af kontekstkvalitet**: Under fejlfinding, ændring af konfiguration eller justering af prompts giver KV-Cache-Text et centraliseret overblik, der hjælper dig med hurtigt at bekræfte, om kernekonteksten er forringet eller forurenet med uventet indhold — uden at skulle gennemgå rå beskeder én efter én
+
+## Flerlags cachestrategi
+
+KV-Cachen tilhørende Claude Code er ikke blot én enkelt cache. Serveren genererer separate cacher for Tools og System Prompt, uafhængigt af Messages-cacheen. Fordelen ved dette design er: når beskedstakken bliver forstyrret (f.eks. kontekstafkortning, beskedændringer) og kræver genopbygning, invaliderer det ikke samtidig Tools- og System Prompt-cacherne, hvilket undgår fuldstændig genberegning.
+
+Dette er en optimeringstrategi på serversiden — fordi Tools-definitioner og System Prompt er relativt stabile under normal brug og sjældent ændres, maksimerer separat caching af dem reduktionen af unødvendig genopbygningsomkostning. Så når du observerer cachen, vil du bemærke, at bortset fra Tools-genopbygning, som kræver fuldstændig genopfriskning af alle cacher, kan ødelæggelse af System Prompt og Messages stadig arve tilgængelige cacher.
+
+## Cache-livscyklus
+
+- **Oprettelse**: Ved første anmodning eller efter cache-udløb opretter API'en en ny cache (`cache_creation_input_tokens`)
+- **Hit**: Efterfølgende anmodninger med identisk præfiks genbruger cachen (`cache_read_input_tokens`)
+- **Udløb**: Cachen har en TTL (time-to-live) på 5 minutter og udløber automatisk derefter
+- **Genopbygning**: Når system prompt, værktøjsliste, model eller beskedindhold ændres, matcher cachenøglen ikke, hvilket udløser genopbygning af det tilsvarende niveau

package/concepts/da/MainAgent.md

@@ -0,0 +1,23 @@
+# 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 |

package/concepts/da/ProxySwitch.md

@@ -0,0 +1,50 @@
+# Hot-Switch Proxy
+
+## Overview
+
+Hot-Switch Proxy lets you dynamically redirect API requests to a different endpoint without restarting Claude Code. This is useful when using third-party API proxy services.
+
+> ⚠️ Do not use this feature if you are a Claude Max subscriber.
+
+## Fields
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| **Name** | ✅ | Display name for this proxy, used to identify it |
+| **Base URL** | ✅ | Base URL of the API service (e.g. `https://api.example.com`). The original request origin will be replaced |
+| **API Key** | ✅ | API key for the proxy service, replaces the original authentication |
+| **Models** | ❌ | Comma-separated list of models supported by this proxy (e.g. `model-a, model-b`) |
+| **Active Model** | ❌ | Select the active model from the list. The `model` field in requests will be replaced |
+
+## How It Works
+
+When a proxy is active, `interceptor.js` performs the following before each API request:
+
+1. **URL Rewrite** — Replaces the request origin with the proxy's Base URL
+2. **Auth Replace** — Replaces `x-api-key` or `Authorization` header with the proxy's API Key
+3. **Model Replace** — If an active model is set, replaces the `model` field in the request body
+
+## Config File
+
+Configuration is stored at `~/.claude/cc-viewer/profile.json`. Click the folder icon in the title to open the directory:
+
+```json
+{
+  "active": "my-proxy",
+  "profiles": [
+    { "id": "max", "name": "Max" },
+    {
+      "id": "my-proxy",
+      "name": "My Proxy",
+      "baseURL": "https://api.example.com",
+      "apiKey": "sk-xxx",
+      "models": ["model-a", "model-b"],
+      "activeModel": "model-a"
+    }
+  ]
+}
+```
+
+- `active` — ID of the current profile. Set to `"max"` for direct connection (no proxy)
+- `profiles` — Profile list. `id: "max"` is built-in and cannot be deleted
+- Changes take effect within ~1.5 seconds (monitored via `fs.watchFile`), no restart needed

package/concepts/da/QRCode.md

@@ -0,0 +1,25 @@
+# Mobil QR-kode adgang
+
+## Sådan virker det
+
+CC Viewer starter en HTTP-server og genererer en **LAN-adresse** (f.eks. `http://192.168.1.100:7008`). Scan QR-koden for at tilgå Claude Code fra din telefon via det samme WiFi-netværk.
+
+## Hvorfor kan jeg ikke oprette forbindelse?
+
+1. **Ikke på det samme netværk** — Telefon og computer skal være på det samme WiFi (samme router/samme netværksnavn)
+2. **Firewall-blokering** — Systemets firewall kan blokere indgående forbindelser
+3. **Virksomhedsnetværk-isolation** — AP-isolation kan forhindre kommunikation mellem enheder
+4. **VPN-interferens** — En VPN kan forstyrre netværksruten
+
+## Sikkerhedsadvarsel
+
+> ⚠️ CC Viewers LAN-tjeneste er tilgængelig for alle enheder på det samme netværk.
+
+- Vær forsigtig på **offentligt WiFi**
+- CC Viewer bruger **token-godkendelse** til at beskytte LAN-adgang
+- Anbefales at bruge på betroede netværk
+
+## Ud over LAN
+
+- **Tunneling-værktøjer** — frp, ngrok, Tailscale osv.
+- **CC Viewer plugins** — Konfigurer proxy-middleware via plugin-systemet

package/concepts/da/ResponseFields.md

@@ -0,0 +1,50 @@
+# Feltbeskrivelse for Response Body
+
+Feltbeskrivelse for responslegemet i Claude API `/v1/messages`.
+
+## Felter på øverste niveau
+
+| Felt | Type | Beskrivelse |
+|------|------|------|
+| **model** | string | Det faktiske modelnavn, f.eks. `claude-opus-4-6` |
+| **id** | string | Unik identifikator for dette svar, f.eks. `msg_01Tgsr2QeH8AVXGoP2wAXRvU` |
+| **type** | string | Fast værdi `"message"` |
+| **role** | string | Fast værdi `"assistant"` |
+| **content** | array | Array af indholdsblokke fra modellens output, herunder tekst, værktøjskald, tænkeproces m.m. |
+| **stop_reason** | string | Stopårsag: `"end_turn"` (normal afslutning), `"tool_use"` (værktøj skal udføres), `"max_tokens"` (token-grænse nået) |
+| **stop_sequence** | string/null | Den sekvens der udløste stop, normalt `null` |
+| **usage** | object | Statistik over tokenforbrug (se nedenfor) |
+
+## content-bloktyper
+
+| Type | Beskrivelse |
+|------|------|
+| **text** | Modellens tekstsvar, indeholder feltet `text` |
+| **tool_use** | Anmodning om værktøjskald, indeholder `name` (værktøjsnavn), `input` (parametre), `id` (kalds-ID, bruges til at matche tool_result) |
+| **thinking** | Udvidet tænkeindhold (vises kun når thinking-tilstand er aktiveret), indeholder feltet `thinking` |
+
+## Detaljer om usage-feltet
+
+| Felt | Beskrivelse |
+|------|------|
+| **input_tokens** | Antal input-tokens uden cache-hit (faktureres til fuld pris) |
+| **cache_creation_input_tokens** | Antal tokens der blev cachet i denne anmodning (cache-skrivning, faktureres højere end normalt input) |
+| **cache_read_input_tokens** | Antal tokens med cache-hit (cache-læsning, faktureres væsentligt lavere end normalt input) |
+| **output_tokens** | Antal tokens i modellens output |
+| **service_tier** | Serviceniveau, f.eks. `"standard"` |
+| **inference_geo** | Inferensregion, f.eks. `"not_available"` angiver at regionsinformation ikke er tilgængelig |
+
+## cache_creation-underfelter
+
+| Felt | Beskrivelse |
+|------|------|
+| **ephemeral_5m_input_tokens** | Antal tokens for korttids-cacheoprettelse med 5 minutters TTL |
+| **ephemeral_1h_input_tokens** | Antal tokens for langtids-cacheoprettelse med 1 times TTL |
+
+> **Om cache-fakturering**: Enhedsprisen for `cache_read_input_tokens` er væsentligt lavere end for `input_tokens`, mens enhedsprisen for `cache_creation_input_tokens` er lidt højere end normalt input. Derfor kan en høj cache-hitrate i løbende samtaler reducere omkostningerne markant. Via "hitrate"-metrikken i cc-viewer kan du nemt overvåge dette forhold.
+
+## Betydning af stop_reason
+
+- **end_turn**: Modellen har afsluttet sit svar normalt
+- **tool_use**: Modellen skal kalde et værktøj, og content vil indeholde en `tool_use`-blok. I den næste anmodning skal `tool_result` tilføjes i messages for at fortsætte samtalen
+- **max_tokens**: `max_tokens`-grænsen er nået og svaret er afkortet, det kan være ufuldstændigt

package/concepts/da/SubAgent-Search.md

@@ -0,0 +1,20 @@
+# SubAgent: Search
+
+## Definition
+
+Search er en sub-agent-type der startes af Claude Codes hovedagent for at udføre kodesøgninger. Den udfører målrettede fil- og indholdssøgninger ved hjælp af værktøjer som Glob, Grep og Read, og returnerer derefter resultaterne til forælderagenten.
+
+## Adfærd
+
+- Startes automatisk når hovedagenten skal søge i eller udforske kodebasen
+- Kører i en isoleret kontekst med skrivebeskyttet adgang
+- Bruger Glob til filmønster-matchning, Grep til indholdssøgning og Read til filinspection
+- Returnerer søgeresultater til forælderagenten til videre behandling
+
+## Hvornår det vises
+
+Search sub-agenter vises typisk når:
+
+1. Hovedagenten skal finde specifikke filer, funktioner eller kodemønstre
+2. Brugeren anmoder om en bred udforskning af kodebasen
+3. Agenten undersøger afhængigheder, referencer eller anvendelsesmønstre

package/concepts/da/Teammate.md

@@ -0,0 +1,26 @@
+# Teammate
+
+## Definition
+
+Teammate er en samarbejdende agent i Claude Code Agent Team-tilstand. Når hoved-agenten opretter et team via `TeamCreate` og genererer teammates ved hjælp af `Agent`-værktøjet, kører hver teammate som en uafhængig agent-proces med sit eget kontekstvindue og værktøjssæt og kommunikerer med teammedlemmer via `SendMessage`.
+
+## Forskelle fra SubAgent
+
+| Egenskab | Teammate | SubAgent |
+|----------|----------|----------|
+| Livscyklus | Vedvarende, kan modtage flere beskeder | Engangsopgave, destrueres efter fuldførelse |
+| Kommunikation | SendMessage tovejsbeskeder | Forælder→barn envejskald, returnerer resultat |
+| Kontekst | Uafhængig fuld kontekst, bevares på tværs af ture | Isoleret opgavekontekst |
+| Samarbejdsmodel | Teamsamarbejde, kan kommunikere indbyrdes | Hierarkisk struktur, interagerer kun med forælder-agent |
+| Opgavetype | Komplekse flertrinsopgaver | Enkeltopgaver som søgning og udforskning |
+
+## Adfærd
+
+- Oprettes af hoved-agenten (team lead) via `Agent`-værktøjet og tildeles et `team_name`
+- Deler opgaveliste via `TaskList` / `TaskGet` / `TaskUpdate`
+- Går i idle-tilstand efter hver udførelsesrunde og venter på at blive vækket af nye beskeder
+- Kan afsluttes elegant via `shutdown_request`
+
+## Forklaring af statistikpanelet
+
+Teammate-statistikpanelet viser antallet af API-kald for hver teammate. Kolonnen `Name` er teammate-navnet (f.eks. `reviewer-security`, `reviewer-pipeline`), og kolonnen `Antal` er det samlede antal API-anmodninger genereret af den pågældende teammate.