cc-viewer 1.7.23 → 1.8.1

package/README.md

@@ -35,6 +35,13 @@ brew install cc-viewer
 brew upgrade cc-viewer   # use this to upgrade; do NOT use npm install -g to upgrade a brew-installed ccv
 ```
 
+#### Install via pnpm (global)
+
+```bash
+pnpm add -g cc-viewer
+pnpm add -g cc-viewer@latest   # use this to upgrade; do NOT use npm install -g to upgrade a pnpm-installed ccv
+```
+
 ### How to start
 
 ccv is a drop-in replacement for claude — all arguments are passed through to claude while the Web Viewer is launched alongside it.
@@ -54,6 +61,18 @@ Once started in programming mode, the web page opens automatically.
 
 cc-viewer also ships as a native desktop app: [download page](https://github.com/weiesky/cc-viewer/releases)
 
+### SDK mode (headless, `ccv -SDK`)
+
+`ccv -SDK` runs the session through the Agent SDK instead of an interactive terminal — no terminal panel, messages are sent from the web UI, and everything else (session logs, streaming typewriter, usage stats) works the same as in terminal mode.
+
+```bash
+ccv -SDK                # headless session; chat from the browser
+ccv -SDK -c             # continue the most recent session
+ccv -SDK --model sonnet # pick a model
+```
+
+Approvals (Bash/Edit/Write/WebFetch/…) pop up in the browser with allow / deny / allow-for-session, and `AskUserQuestion` / plan prompts appear as modals. `npm publish` always requires an explicit approval — even with `--d`. Requires the `@anthropic-ai/claude-agent-sdk` package (bundled with cc-viewer); falls back to terminal mode if unavailable.
+
 ### Choose the Claude executable
 
 On the local CCV page, open **Global Settings → Claude executable** to choose the
@@ -181,6 +200,7 @@ The **Edit System Prompt** modal (hamburger menu → Edit System Prompt) is tabb
 * The **Default** tab keeps the classic behavior: it writes `CC_SYSTEM.md` (override) or `CC_APPEND_SYSTEM.md` (append) into the current workspace, injected as `--system-prompt-file` / `--append-system-prompt-file` on the next ccv launch.
 * **Model tabs**: click **+ Add model**, type a name such as `opus` or `Gemini3`, and pick a scope — **Global** (`~/.claude/cc-viewer/system_prompt/`, applies to every workspace) or **Workspace** (`<project>/system_prompt/`). The name field offers type-ahead suggestions from your locally configured models (hot-reload proxy profiles and `settings.json`); names already added in the chosen scope are hidden, and arbitrary free-form names remain allowed. Each tab has its own Append/Override switch and Markdown preview.
 * Entries are stored as uppercase files: `OPUS_SYSTEM.md` (override) or `OPUS_APPEND_SYSTEM.md` (append). Matching is fuzzy — a case-insensitive substring of the model ID resolved from the ACTIVE configuration (an active third-party proxy profile's model mapping > the launch environment's `ANTHROPIC_MODEL`/`CLAUDE_MODEL` > the `model` configured in `settings.json`; with no configuration signal, no entry is injected), so `opus` matches `claude-opus-4-8[1m]` regardless of version. Switching the proxy profile mid-session re-matches only after the claude session is restarted, and a `--model` flag passed through extra args is not consulted (known limitations). A workspace match beats a global one; within a scope the longest name wins; a matched entry fully replaces the Default files for that launch.
+* **Built-in presets are default-effective:** the package ships tuned prompts for `deepseek-v4-pro`, `deepseek-v4-flash`, `GLM-5.2`, `Qwen-3.7-Max`, `kimi-k2.7-code` and `kimi-k3` — when the resolved model matches one of them and no entry of yours matches, the built-in prompt is injected automatically (your own files always win: workspace > global > built-in). Built-in tabs carry a **Built-in** badge in the modal: edit and save to materialize your override, or use the tab's × to **disable** a built-in (recorded in `<scope>/system_prompt/.builtin-disabled.json`). A disabled built-in falls back to the Default files, and the header entry stays visible marked "Disabled" so you can re-enable it at any time.
 * Saving a tab empty deletes the entry. Model switches made mid-session apply at the next relaunch. Set `CCV_DISABLE_AUTO_SYSTEM_PROMPT=1` to disable all automatic injection. You may commit `<project>/system_prompt/` to share prompts with your team, or add it to `.gitignore` to keep them private.
 
 ### Logger mode (view the complete Claude Code session)

package/cli.js

@@ -16,6 +16,7 @@ import { ensureHooks, removeAllManagedHooks } from './server/lib/ensure-hooks.js
 import { injectCliJsAt, removeCliJsInjectionAt, INJECT_START as _INJECT_START, INJECT_END as _INJECT_END, buildInjectBlock as _buildInjectBlock } from './server/lib/cli-inject.js';
 import { normalizeBasePath } from './server/lib/base-path.js';
 import { mergeSettingsIntoArgs } from './server/lib/settings-merge.js';
+import { splitSdkLaunchArgs } from './server/lib/launch-config.js';
 import { createHardenedCleanup, installWinKeypressFallback } from './server/lib/term-signals.js';
 
 const __dirname = fileURLToPath(new URL('.', import.meta.url));
@@ -486,7 +487,7 @@ async function runCliMode(extraClaudeArgs = [], cwd, noOpen = false) {
   // IM worker：服务器监听成功后把真实端口回填进 im.lock（manager 据此做 HTTP 身份探测）
   if (process.env.CCV_IM_PLATFORM) {
     try {
-      const { updateImLockPort } = await import('./server/lib/im-lock.js');
+      const { updateImLockPort } = await import('./server/lib/im/im-lock.js');
       updateImLockPort(process.env.CCV_IM_PLATFORM, port);
     } catch (e) {
       console.error('[CC Viewer] updateImLockPort failed:', e.message);
@@ -587,15 +588,15 @@ async function runCliMode(extraClaudeArgs = [], cwd, noOpen = false) {
 // 外加：全局唯一锁、CC_APPEND_SYSTEM.md 人格预置/迁移、IM 专属 env。由 im-process-manager 以 detached 子进程拉起，
 // 也可手动 `ccv --im <id>` 启动。
 async function runImMode(platformId) {
-  const { getDescriptor } = await import('./server/lib/im-config.js');
+  const { getDescriptor } = await import('./server/lib/im/im-config.js');
   if (!getDescriptor(platformId)) {
     console.error(t('cli.imUnknownPlatform', { id: platformId }));
     process.exit(1);
   }
 
-  const { acquireImLock, releaseImLock, imDir } = await import('./server/lib/im-lock.js');
-  const { ensureImAppendSystem, migrateImClaudeMd } = await import('./server/lib/im-append-system.js');
-  const { ensureImBuiltinSkills } = await import('./server/lib/im-skills.js');
+  const { acquireImLock, releaseImLock, imDir } = await import('./server/lib/im/im-lock.js');
+  const { ensureImAppendSystem, migrateImClaudeMd } = await import('./server/lib/im/im-append-system.js');
+  const { ensureImBuiltinSkills } = await import('./server/lib/im/im-skills.js');
 
   const dir = imDir(platformId);
   mkdirSync(dir, { recursive: true });
@@ -653,14 +654,21 @@ async function runSdkMode(extraClaudeArgs = [], cwd, noOpen = false) {
   const { registerWorkspace } = await import('./server/workspace-registry.js');
   await registerWorkspace(workingDir);
 
-  // 不需要 ensureHooks — SDK canUseTool 处理 AskUserQuestion + 权限
-  // 不需要 proxy — SDK 直接管理 API 通信
+  // 不需要 ensureHooks — SDK canUseTool 处理 AskUserQuestion + 权限；
+  // 也不向子进程注入 CCVIEWER_PORT，让 CCV 的 settings bridges 保持休眠，避免双通道审批。
 
-  // 设置环境标记（必须在 import server.js 之前）
+  // 设置环境标记（必须在 import proxy.js / server.js 之前 — proxy.js → interceptor.js
+  // 可能触发 server.js 加载，而 server.js 的 isCliMode/isSdkMode 在模块顶层求值且只执行一次）
   process.env.CCV_CLI_MODE = '1';
   process.env.CCV_SDK_MODE = '1';
   process.env.CCV_PROJECT_DIR = workingDir;
-  process.env.CCV_PROXY_MODE = '1'; // 使 interceptor.js 惰性
+  process.env.CCV_PROXY_MODE = '1';
+
+  // 启动本地回环代理 — SDK 子进程的 API 流量经 ANTHROPIC_BASE_URL 指向这里，
+  // 报文捕获/落盘/流式推送与 PTY 模式走同一条 wire 通路
+  const { startProxy } = await import('./server/proxy.js');
+  const proxyPort = await startProxy();
+  process.env.CCV_PROXY_PORT = String(proxyPort);
 
   // 启动 HTTP 服务器
   const serverMod = await import('./server/server.js');
@@ -685,12 +693,75 @@ async function runSdkMode(extraClaudeArgs = [], cwd, noOpen = false) {
     permissionMode = 'bypassPermissions';
   }
 
+  // 合并用户 --settings 与注入的 env.ANTHROPIC_BASE_URL（与 PTY 的 --settings 注入
+  // 等价、同一 helper，注入键优先）；SDK 模式下经 options.settings 传给 query()。
+  // settingsMerge.args 已剥离 --settings；其余参数（--model/-c/-r 等）的映射后续接入。
+  const proxyBaseUrl = `http://127.0.0.1:${proxyPort}`;
+  const settingsMerge = mergeSettingsIntoArgs(extraClaudeArgs, { env: { ANTHROPIC_BASE_URL: proxyBaseUrl } }, { cwd: workingDir });
+  if (settingsMerge.warningDetail) {
+    console.warn(`[CC Viewer] --settings merge failed (${settingsMerge.warningDetail.reason}): ${settingsMerge.warningDetail.value}`);
+  }
+
+  // 子进程 env：代理指向 + 禁自动更新 + EDITOR 劫持（对齐 pty-manager 的注入面；
+  // 刻意不注入 CCVIEWER_PORT/PROTOCOL/INTERNAL_TOKEN — settings bridges 在 SDK 模式休眠）
+  const editorScript = resolve(__dirname, 'server', 'lib', 'ccv-editor.js');
+  const childEnv = {
+    ...process.env,
+    ANTHROPIC_BASE_URL: proxyBaseUrl,
+    // 与 PTY 子进程同款(pty-manager.js:247):SDK 子进程的 cli.js 若已被 -logger/PTY 注入
+    // interceptor,CCV_PROXY_MODE=1 让它只装 fetch hook 而不再自起 server;wire 捕获本来
+    // 就发生在主进程 proxy 的出站 fetch(ANTHROPIC_BASE_URL 指过来),此键保证子进程不双起。
+    CCV_PROXY_MODE: '1',
+    CCV_LOG_DIR: process.env.CCV_LOG_DIR || LOG_DIR,
+    DISABLE_AUTOUPDATER: '1',
+    EDITOR: `${process.execPath} ${editorScript}`,
+    VISUAL: `${process.execPath} ${editorScript}`,
+    CCV_EDITOR_PORT: String(port),
+  };
+  // 与 PTY 同款剥离(pty-manager.js:250-256):内部短路开关与 server 专属模式标记不外泄。
+  delete childEnv.CCV_SKIP_THINKING_DISPLAY;
+  delete childEnv.CCV_WORKSPACE_MODE;
+  delete childEnv.CCV_ELECTRON_MULTITAB;
+
+  // 用户参数映射到 SDK options：--model/-c/-r/--fork-session 提升为 SDK 原生 option
+  // （resume-pin 语义也需要它们），其余参数经 extraArgs 原样透传给 CLI 子进程。
+  // 不再静默丢弃任何参数。
+  const sdkArgs = splitSdkLaunchArgs(settingsMerge.args);
+  if (sdkArgs.pickerResume) {
+    console.warn('[CC Viewer] SDK mode: bare -r (interactive session picker) is not supported headless — starting a fresh session. Use -r <sessionId> to resume a specific session.');
+  }
+
   // 初始化 SDK 会话
+  // claudeExecutable 走与 PTY 相同的解析优先级(configured → codefuse → native → PATH → npm)。
+  // 缺了它 SDK 会从 PATH 解析 claude,在装有 agent-security headless guard 的机器上
+  // 会挑到一个 spawn 即被 SIGKILL 的二进制(PTY 交互式终端不在其拦截范围,headless 正中)。
+  let sdkClaudeSelection = null;
+  try {
+    sdkClaudeSelection = assertUsableClaudeSelection(resolvePreferredClaudeSelection());
+  } catch (err) {
+    console.error(`[CC Viewer] ${err.message}`);
+    process.exit(1);
+  }
+  const sdkClaudePath = sdkClaudeSelection?.path || null;
+  if (sdkClaudePath) {
+    process.env.CCV_CLAUDE_EXECUTABLE = sdkClaudePath;
+    console.log(`[CC Viewer] SDK mode: claude executable → ${sdkClaudePath} (${sdkClaudeSelection.source})`);
+  } else {
+    console.warn('[CC Viewer] SDK mode: no claude executable resolved — SDK will fall back to PATH/builtin discovery.');
+  }
+  // 观测面走与 PTY 相同的 wire 通路(SDK 子进程流量经 ANTHROPIC_BASE_URL 到 ccv proxy →
+  // fetch hook → v2 transcript → SSE),sdk-manager 不再另接 v2/streaming 注入。
   sdkManager.initSdkSession(workingDir, basename(workingDir), {
-    onEntry: (entry) => serverMod.pushSdkEntry(entry),
-    onStreamingStatus: (data) => serverMod.setSdkStreamingState(data),
     broadcastWs: (msg) => serverMod.broadcastWsMessage(msg),
     permissionMode,
+    env: childEnv,
+    settings: JSON.parse(settingsMerge.settingsJson),
+    model: sdkArgs.model,
+    claudeExecutable: sdkClaudePath,
+    launchResume: (sdkArgs.continue || sdkArgs.resume || sdkArgs.forkSession)
+      ? { continue: sdkArgs.continue, resumeId: sdkArgs.resume, forkSession: sdkArgs.forkSession }
+      : null,
+    userArgs: sdkArgs.rest,
     runWaterfallHook: (await import('./server/lib/plugin-loader.js')).runWaterfallHook,
     // Round-3 P0: SDK mode has no Stop hook (ensureHooks() skipped above), so
     // the only place we learn a turn ended is the SDK 'result' message. Forward
@@ -707,6 +778,9 @@ async function runSdkMode(extraClaudeArgs = [], cwd, noOpen = false) {
       try { serverMod.broadcastTurnEnd(sessionId, ts); }
       catch (err) { console.warn('[sdk] broadcastTurnEnd threw:', err?.message); }
     },
+    // query 级失败(spawn/protocol/iterator)推到 Web UI toast —— 此前只有 console.error,
+    // 死掉的 query 在 UI 上看与挂起无异。
+    onQueryError: (message) => serverMod.broadcastWsMessage({ type: 'sdk-error', message }),
   });
 
   // 注册 SDK 回调到 server.js（WS 消息路由用）
@@ -714,6 +788,13 @@ async function runSdkMode(extraClaudeArgs = [], cwd, noOpen = false) {
   serverMod.setSdkCancelApproval(sdkManager.cancelApproval);
   serverMod.setSdkSendUserMessage(sdkManager.sendUserMessage);
   serverMod.setSdkInterruptTurn(sdkManager.interruptTurn);
+  serverMod.setSdkGetPendingApprovals(sdkManager.getPendingApprovals);
+  serverMod.setSdkGetInitSnapshot(sdkManager.getSdkInitSnapshot);
+  // Busy-queue bubble actions (queue-send-now / queue-remove / queue-clear / replay).
+  serverMod.setSdkSendQueuedNow(sdkManager.sendQueuedNow);
+  serverMod.setSdkRemoveQueued(sdkManager.removeQueued);
+  serverMod.setSdkClearQueued(sdkManager.clearQueued);
+  serverMod.setSdkGetQueueSnapshot(sdkManager.getQueueSnapshot);
 
   // 自动打开浏览器
   const protocol = serverMod.getProtocol();

package/concepts/ar/GlobalSettings.md

@@ -122,12 +122,12 @@ CC-Viewer 自动注册到 `~/.claude/settings.json` 的 `hooks.PreToolUse` 中
 
 ### 1. AskUserQuestion 桥接
 - **匹配器**: `"AskUserQuestion"`
-- **命令**: `node <安装目录>/server/lib/ask-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/ask-bridge.js`
 - **作用**: 将 Claude 的问题转发到 Web UI，等待用户回答
 
 ### 2. 权限审批桥接
 - **匹配器**: `""` (空 = 匹配所有工具)
-- **命令**: `node <安装目录>/server/lib/perm-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/perm-bridge.js`
 - **作用**: 仅 `Bash`/`Edit`/`Write`/`NotebookEdit` 需要 Web UI 审批，其余自动放行
 
 ## 七、Shell 集成

package/concepts/ar/ToolsFirst.md

@@ -10,7 +10,7 @@
 ┌─────────────────────────────────────────────────┐
 │ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
 │ 2. System Prompt                                 │
-│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+│ 3. Messages (conversation history + current step)│  ← End of cache prefix
 └─────────────────────────────────────────────────┘
 ```
 

package/concepts/da/GlobalSettings.md

@@ -122,12 +122,12 @@ CC-Viewer 自动注册到 `~/.claude/settings.json` 的 `hooks.PreToolUse` 中
 
 ### 1. AskUserQuestion 桥接
 - **匹配器**: `"AskUserQuestion"`
-- **命令**: `node <安装目录>/server/lib/ask-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/ask-bridge.js`
 - **作用**: 将 Claude 的问题转发到 Web UI，等待用户回答
 
 ### 2. 权限审批桥接
 - **匹配器**: `""` (空 = 匹配所有工具)
-- **命令**: `node <安装目录>/server/lib/perm-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/perm-bridge.js`
 - **作用**: 仅 `Bash`/`Edit`/`Write`/`NotebookEdit` 需要 Web UI 审批，其余自动放行
 
 ## 七、Shell 集成

package/concepts/da/ToolsFirst.md

@@ -10,7 +10,7 @@ Når Anthropic's API opbygger KV-Cache, sammensætter den konteksten til et præ
 ┌─────────────────────────────────────────────────┐
 │ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
 │ 2. System Prompt                                 │
-│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+│ 3. Messages (conversation history + current step)│  ← End of cache prefix
 └─────────────────────────────────────────────────┘
 ```
 

package/concepts/de/GlobalSettings.md

@@ -122,12 +122,12 @@ CC-Viewer 自动注册到 `~/.claude/settings.json` 的 `hooks.PreToolUse` 中
 
 ### 1. AskUserQuestion 桥接
 - **匹配器**: `"AskUserQuestion"`
-- **命令**: `node <安装目录>/server/lib/ask-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/ask-bridge.js`
 - **作用**: 将 Claude 的问题转发到 Web UI，等待用户回答
 
 ### 2. 权限审批桥接
 - **匹配器**: `""` (空 = 匹配所有工具)
-- **命令**: `node <安装目录>/server/lib/perm-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/perm-bridge.js`
 - **作用**: 仅 `Bash`/`Edit`/`Write`/`NotebookEdit` 需要 Web UI 审批，其余自动放行
 
 ## 七、Shell 集成

package/concepts/de/ToolsFirst.md

@@ -10,7 +10,7 @@ Wenn die Anthropic API den KV-Cache aufbaut, verkettet sie den Kontext in dieser
 ┌─────────────────────────────────────────────────┐
 │ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
 │ 2. System Prompt                                 │
-│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+│ 3. Messages (conversation history + current step)│  ← End of cache prefix
 └─────────────────────────────────────────────────┘
 ```
 

package/concepts/en/GlobalSettings.md

@@ -125,12 +125,12 @@ CC-Viewer auto-registers hooks in `~/.claude/settings.json` under `hooks.PreTool
 
 ### 1. AskUserQuestion Bridge
 - **Matcher**: `"AskUserQuestion"`
-- **Command**: `node <install_dir>/server/lib/ask-bridge.js`
+- **Command**: `node <install_dir>/server/lib/ask/ask-bridge.js`
 - **Purpose**: Forward Claude's questions to Web UI, wait for user answers
 
 ### 2. Permission Approval Bridge
 - **Matcher**: `""` (empty = match all tools)
-- **Command**: `node <install_dir>/server/lib/perm-bridge.js`
+- **Command**: `node <install_dir>/server/lib/ask/perm-bridge.js`
 - **Purpose**: Only `Bash`/`Edit`/`Write`/`NotebookEdit` require Web UI approval; others pass through
 
 ## 7. Shell Integration

package/concepts/en/ToolsFirst.md

@@ -10,7 +10,7 @@ When Anthropic's API constructs the KV-Cache, it concatenates context into a pre
 ┌─────────────────────────────────────────────────┐
 │ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
 │ 2. System Prompt                                 │
-│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+│ 3. Messages (conversation history + current step)│  ← End of cache prefix
 └─────────────────────────────────────────────────┘
 ```
 

package/concepts/es/GlobalSettings.md

@@ -122,12 +122,12 @@ CC-Viewer 自动注册到 `~/.claude/settings.json` 的 `hooks.PreToolUse` 中
 
 ### 1. AskUserQuestion 桥接
 - **匹配器**: `"AskUserQuestion"`
-- **命令**: `node <安装目录>/server/lib/ask-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/ask-bridge.js`
 - **作用**: 将 Claude 的问题转发到 Web UI，等待用户回答
 
 ### 2. 权限审批桥接
 - **匹配器**: `""` (空 = 匹配所有工具)
-- **命令**: `node <安装目录>/server/lib/perm-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/perm-bridge.js`
 - **作用**: 仅 `Bash`/`Edit`/`Write`/`NotebookEdit` 需要 Web UI 审批，其余自动放行
 
 ## 七、Shell 集成

package/concepts/es/ToolsFirst.md

@@ -10,7 +10,7 @@ Cuando la API de Anthropic construye el KV-Cache, concatena el contexto en un pr
 ┌─────────────────────────────────────────────────┐
 │ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
 │ 2. System Prompt                                 │
-│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+│ 3. Messages (conversation history + current step)│  ← End of cache prefix
 └─────────────────────────────────────────────────┘
 ```
 

package/concepts/fr/GlobalSettings.md

@@ -122,12 +122,12 @@ CC-Viewer 自动注册到 `~/.claude/settings.json` 的 `hooks.PreToolUse` 中
 
 ### 1. AskUserQuestion 桥接
 - **匹配器**: `"AskUserQuestion"`
-- **命令**: `node <安装目录>/server/lib/ask-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/ask-bridge.js`
 - **作用**: 将 Claude 的问题转发到 Web UI，等待用户回答
 
 ### 2. 权限审批桥接
 - **匹配器**: `""` (空 = 匹配所有工具)
-- **命令**: `node <安装目录>/server/lib/perm-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/perm-bridge.js`
 - **作用**: 仅 `Bash`/`Edit`/`Write`/`NotebookEdit` 需要 Web UI 审批，其余自动放行
 
 ## 七、Shell 集成

package/concepts/fr/ToolsFirst.md

@@ -10,7 +10,7 @@ Lorsque l'API Anthropic construit le KV-Cache, elle concatène le contexte en un
 ┌─────────────────────────────────────────────────┐
 │ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
 │ 2. System Prompt                                 │
-│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+│ 3. Messages (conversation history + current step)│  ← End of cache prefix
 └─────────────────────────────────────────────────┘
 ```
 

package/concepts/it/GlobalSettings.md

@@ -122,12 +122,12 @@ CC-Viewer 自动注册到 `~/.claude/settings.json` 的 `hooks.PreToolUse` 中
 
 ### 1. AskUserQuestion 桥接
 - **匹配器**: `"AskUserQuestion"`
-- **命令**: `node <安装目录>/server/lib/ask-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/ask-bridge.js`
 - **作用**: 将 Claude 的问题转发到 Web UI，等待用户回答
 
 ### 2. 权限审批桥接
 - **匹配器**: `""` (空 = 匹配所有工具)
-- **命令**: `node <安装目录>/server/lib/perm-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/perm-bridge.js`
 - **作用**: 仅 `Bash`/`Edit`/`Write`/`NotebookEdit` 需要 Web UI 审批，其余自动放行
 
 ## 七、Shell 集成

package/concepts/it/ToolsFirst.md

@@ -10,7 +10,7 @@ Quando l'API di Anthropic costruisce il KV-Cache, concatena il contesto in un pr
 ┌─────────────────────────────────────────────────┐
 │ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
 │ 2. System Prompt                                 │
-│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+│ 3. Messages (conversation history + current step)│  ← End of cache prefix
 └─────────────────────────────────────────────────┘
 ```
 

package/concepts/ja/GlobalSettings.md

@@ -122,12 +122,12 @@ CC-Viewer 自动注册到 `~/.claude/settings.json` 的 `hooks.PreToolUse` 中
 
 ### 1. AskUserQuestion 桥接
 - **匹配器**: `"AskUserQuestion"`
-- **命令**: `node <安装目录>/server/lib/ask-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/ask-bridge.js`
 - **作用**: 将 Claude 的问题转发到 Web UI，等待用户回答
 
 ### 2. 权限审批桥接
 - **匹配器**: `""` (空 = 匹配所有工具)
-- **命令**: `node <安装目录>/server/lib/perm-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/perm-bridge.js`
 - **作用**: 仅 `Bash`/`Edit`/`Write`/`NotebookEdit` 需要 Web UI 审批，其余自动放行
 
 ## 七、Shell 集成

package/concepts/ja/ToolsFirst.md

@@ -10,7 +10,7 @@ Anthropic のAPIがKV-Cacheを構築する際、コンテキストを以下の**
 ┌─────────────────────────────────────────────────┐
 │ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
 │ 2. System Prompt                                 │
-│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+│ 3. Messages (conversation history + current step)│  ← End of cache prefix
 └─────────────────────────────────────────────────┘
 ```
 

package/concepts/ko/GlobalSettings.md

@@ -122,12 +122,12 @@ CC-Viewer 自动注册到 `~/.claude/settings.json` 的 `hooks.PreToolUse` 中
 
 ### 1. AskUserQuestion 桥接
 - **匹配器**: `"AskUserQuestion"`
-- **命令**: `node <安装目录>/server/lib/ask-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/ask-bridge.js`
 - **作用**: 将 Claude 的问题转发到 Web UI，等待用户回答
 
 ### 2. 权限审批桥接
 - **匹配器**: `""` (空 = 匹配所有工具)
-- **命令**: `node <安装目录>/server/lib/perm-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/perm-bridge.js`
 - **作用**: 仅 `Bash`/`Edit`/`Write`/`NotebookEdit` 需要 Web UI 审批，其余自动放行
 
 ## 七、Shell 集成

package/concepts/ko/ToolsFirst.md

@@ -10,7 +10,7 @@ Anthropic의 API가 KV-Cache를 구성할 때, 컨텍스트를 다음 **고정
 ┌─────────────────────────────────────────────────┐
 │ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
 │ 2. System Prompt                                 │
-│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+│ 3. Messages (conversation history + current step)│  ← End of cache prefix
 └─────────────────────────────────────────────────┘
 ```
 

package/concepts/no/GlobalSettings.md

@@ -122,12 +122,12 @@ CC-Viewer 自动注册到 `~/.claude/settings.json` 的 `hooks.PreToolUse` 中
 
 ### 1. AskUserQuestion 桥接
 - **匹配器**: `"AskUserQuestion"`
-- **命令**: `node <安装目录>/server/lib/ask-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/ask-bridge.js`
 - **作用**: 将 Claude 的问题转发到 Web UI，等待用户回答
 
 ### 2. 权限审批桥接
 - **匹配器**: `""` (空 = 匹配所有工具)
-- **命令**: `node <安装目录>/server/lib/perm-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/perm-bridge.js`
 - **作用**: 仅 `Bash`/`Edit`/`Write`/`NotebookEdit` 需要 Web UI 审批，其余自动放行
 
 ## 七、Shell 集成

package/concepts/no/ToolsFirst.md

@@ -10,7 +10,7 @@ Når Anthropic's API bygger opp KV-Cache, setter den sammen konteksten til et pr
 ┌─────────────────────────────────────────────────┐
 │ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
 │ 2. System Prompt                                 │
-│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+│ 3. Messages (conversation history + current step)│  ← End of cache prefix
 └─────────────────────────────────────────────────┘
 ```
 

package/concepts/pl/GlobalSettings.md

@@ -122,12 +122,12 @@ CC-Viewer 自动注册到 `~/.claude/settings.json` 的 `hooks.PreToolUse` 中
 
 ### 1. AskUserQuestion 桥接
 - **匹配器**: `"AskUserQuestion"`
-- **命令**: `node <安装目录>/server/lib/ask-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/ask-bridge.js`
 - **作用**: 将 Claude 的问题转发到 Web UI，等待用户回答
 
 ### 2. 权限审批桥接
 - **匹配器**: `""` (空 = 匹配所有工具)
-- **命令**: `node <安装目录>/server/lib/perm-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/perm-bridge.js`
 - **作用**: 仅 `Bash`/`Edit`/`Write`/`NotebookEdit` 需要 Web UI 审批，其余自动放行
 
 ## 七、Shell 集成

package/concepts/pl/ToolsFirst.md

@@ -10,7 +10,7 @@ Gdy Anthropic API buduje KV-Cache, łączy kontekst w prefiks w tej **stałej ko
 ┌─────────────────────────────────────────────────┐
 │ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
 │ 2. System Prompt                                 │
-│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+│ 3. Messages (conversation history + current step)│  ← End of cache prefix
 └─────────────────────────────────────────────────┘
 ```
 

package/concepts/pt-BR/GlobalSettings.md

@@ -122,12 +122,12 @@ CC-Viewer 自动注册到 `~/.claude/settings.json` 的 `hooks.PreToolUse` 中
 
 ### 1. AskUserQuestion 桥接
 - **匹配器**: `"AskUserQuestion"`
-- **命令**: `node <安装目录>/server/lib/ask-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/ask-bridge.js`
 - **作用**: 将 Claude 的问题转发到 Web UI，等待用户回答
 
 ### 2. 权限审批桥接
 - **匹配器**: `""` (空 = 匹配所有工具)
-- **命令**: `node <安装目录>/server/lib/perm-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/perm-bridge.js`
 - **作用**: 仅 `Bash`/`Edit`/`Write`/`NotebookEdit` 需要 Web UI 审批，其余自动放行
 
 ## 七、Shell 集成

package/concepts/pt-BR/ToolsFirst.md

@@ -10,7 +10,7 @@ Quando a API da Anthropic constrói o KV-Cache, ela concatena o contexto em um p
 ┌─────────────────────────────────────────────────┐
 │ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
 │ 2. System Prompt                                 │
-│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+│ 3. Messages (conversation history + current step)│  ← End of cache prefix
 └─────────────────────────────────────────────────┘
 ```
 

package/concepts/ru/GlobalSettings.md

@@ -122,12 +122,12 @@ CC-Viewer 自动注册到 `~/.claude/settings.json` 的 `hooks.PreToolUse` 中
 
 ### 1. AskUserQuestion 桥接
 - **匹配器**: `"AskUserQuestion"`
-- **命令**: `node <安装目录>/server/lib/ask-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/ask-bridge.js`
 - **作用**: 将 Claude 的问题转发到 Web UI，等待用户回答
 
 ### 2. 权限审批桥接
 - **匹配器**: `""` (空 = 匹配所有工具)
-- **命令**: `node <安装目录>/server/lib/perm-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/perm-bridge.js`
 - **作用**: 仅 `Bash`/`Edit`/`Write`/`NotebookEdit` 需要 Web UI 审批，其余自动放行
 
 ## 七、Shell 集成

package/concepts/ru/ToolsFirst.md

@@ -10,7 +10,7 @@
 ┌─────────────────────────────────────────────────┐
 │ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
 │ 2. System Prompt                                 │
-│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+│ 3. Messages (conversation history + current step)│  ← End of cache prefix
 └─────────────────────────────────────────────────┘
 ```
 

package/concepts/th/GlobalSettings.md

@@ -122,12 +122,12 @@ CC-Viewer 自动注册到 `~/.claude/settings.json` 的 `hooks.PreToolUse` 中
 
 ### 1. AskUserQuestion 桥接
 - **匹配器**: `"AskUserQuestion"`
-- **命令**: `node <安装目录>/server/lib/ask-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/ask-bridge.js`
 - **作用**: 将 Claude 的问题转发到 Web UI，等待用户回答
 
 ### 2. 权限审批桥接
 - **匹配器**: `""` (空 = 匹配所有工具)
-- **命令**: `node <安装目录>/server/lib/perm-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/perm-bridge.js`
 - **作用**: 仅 `Bash`/`Edit`/`Write`/`NotebookEdit` 需要 Web UI 审批，其余自动放行
 
 ## 七、Shell 集成

package/concepts/th/ToolsFirst.md

@@ -10,7 +10,7 @@
 ┌─────────────────────────────────────────────────┐
 │ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
 │ 2. System Prompt                                 │
-│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+│ 3. Messages (conversation history + current step)│  ← End of cache prefix
 └─────────────────────────────────────────────────┘
 ```
 

package/concepts/tr/GlobalSettings.md

@@ -122,12 +122,12 @@ CC-Viewer 自动注册到 `~/.claude/settings.json` 的 `hooks.PreToolUse` 中
 
 ### 1. AskUserQuestion 桥接
 - **匹配器**: `"AskUserQuestion"`
-- **命令**: `node <安装目录>/server/lib/ask-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/ask-bridge.js`
 - **作用**: 将 Claude 的问题转发到 Web UI，等待用户回答
 
 ### 2. 权限审批桥接
 - **匹配器**: `""` (空 = 匹配所有工具)
-- **命令**: `node <安装目录>/server/lib/perm-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/perm-bridge.js`
 - **作用**: 仅 `Bash`/`Edit`/`Write`/`NotebookEdit` 需要 Web UI 审批，其余自动放行
 
 ## 七、Shell 集成

package/concepts/tr/ToolsFirst.md

@@ -10,7 +10,7 @@ Anthropic'in API'si KV-Cache'i oluştururken, bağlamı bu **sabit sırayla** bi
 ┌─────────────────────────────────────────────────┐
 │ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
 │ 2. System Prompt                                 │
-│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+│ 3. Messages (conversation history + current step)│  ← End of cache prefix
 └─────────────────────────────────────────────────┘
 ```
 

package/concepts/uk/GlobalSettings.md

@@ -122,12 +122,12 @@ CC-Viewer 自动注册到 `~/.claude/settings.json` 的 `hooks.PreToolUse` 中
 
 ### 1. AskUserQuestion 桥接
 - **匹配器**: `"AskUserQuestion"`
-- **命令**: `node <安装目录>/server/lib/ask-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/ask-bridge.js`
 - **作用**: 将 Claude 的问题转发到 Web UI，等待用户回答
 
 ### 2. 权限审批桥接
 - **匹配器**: `""` (空 = 匹配所有工具)
-- **命令**: `node <安装目录>/server/lib/perm-bridge.js`
+- **命令**: `node <安装目录>/server/lib/ask/perm-bridge.js`
 - **作用**: 仅 `Bash`/`Edit`/`Write`/`NotebookEdit` 需要 Web UI 审批，其余自动放行
 
 ## 七、Shell 集成