cc-viewer 1.6.271 → 1.6.273

package/cli.js

@@ -5,15 +5,18 @@ import { resolve, isAbsolute } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { homedir } from 'node:os';
 import { spawn } from 'node:child_process';
-import { t } from './i18n.js';
-import { INJECT_IMPORT, resolveCliPath, resolveNativePath, resolveNpmClaudePath, buildShellCandidates, setLogDir, LOG_DIR, hasClaude2xWrapper, getGlobalNodeModulesDir, PACKAGES, getClaudeConfigDir } from './findcc.js';
-import { ensureHooks } from './lib/ensure-hooks.js';
+import { t } from './server/i18n.js';
+import { INJECT_IMPORT, LEGACY_INJECT_IMPORTS, resolveCliPath, resolveNativePath, resolveNpmClaudePath, buildShellCandidates, setLogDir, LOG_DIR, hasClaude2xWrapper, getGlobalNodeModulesDir, PACKAGES, getClaudeConfigDir } from './findcc.js';
+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';
 
 const __dirname = fileURLToPath(new URL('.', import.meta.url));
 
-const INJECT_START = '// >>> Start CC Viewer Web Service >>>';
-const INJECT_END = '// <<< Start CC Viewer Web Service <<<';
-const INJECT_BLOCK = `${INJECT_START}\n${INJECT_IMPORT}\n${INJECT_END}`;
+// 注入 marker 常量定义在 server/lib/cli-inject.js（便于单元测试）；
+// 本文件仅 re-export 给 helper 与 hook 使用，保持现有行为。
+const INJECT_START = _INJECT_START;
+const INJECT_END = _INJECT_END;
+const INJECT_BLOCK = _buildInjectBlock(INJECT_IMPORT);
 
 
 const SHELL_HOOK_START = '# >>> CC-Viewer Auto-Inject >>>';
@@ -198,36 +201,17 @@ function removeShellHook() {
 }
 
 function injectCliJs() {
-  const content = readFileSync(cliPath, 'utf-8');
-  if (content.includes(INJECT_START)) {
-    return 'exists';
-  }
-  // 保留主导 EOL：若原文件 CRLF，注入完仍 CRLF（否则 split('\n')+join('\n') 会把 Win 文件
-  // 一次性转 LF，git/编辑器抱怨混合行尾且对哈希签名敏感的脚本可能失效）。
-  const eol = content.includes('\r\n') ? '\r\n' : '\n';
-  const lines = content.split(/\r?\n/);
-  lines.splice(2, 0, INJECT_BLOCK);
-  writeFileSync(cliPath, lines.join(eol));
-  return 'injected';
+  return injectCliJsAt(cliPath, INJECT_IMPORT, LEGACY_INJECT_IMPORTS);
 }
 
 function removeCliJsInjection() {
-  try {
-    if (!existsSync(cliPath)) return 'not_found';
-    const content = readFileSync(cliPath, 'utf-8');
-    if (!content.includes(INJECT_START)) return 'clean';
-    const regex = new RegExp(`${INJECT_START}\\n${INJECT_IMPORT}\\n${INJECT_END}\\n?`, 'g');
-    writeFileSync(cliPath, content.replace(regex, ''));
-    return 'removed';
-  } catch {
-    return 'error';
-  }
+  return removeCliJsInjectionAt(cliPath, INJECT_IMPORT, LEGACY_INJECT_IMPORTS);
 }
 
 async function runProxyCommand(args) {
   try {
     // Dynamic import to avoid side effects when just installing
-    const { startProxy } = await import('./proxy.js');
+    const { startProxy } = await import('./server/proxy.js');
     const proxyPort = await startProxy();
 
     // args = ['run', '--', 'command', 'claude', ...] or ['run', 'claude', ...]
@@ -285,7 +269,7 @@ async function runProxyCommand(args) {
     // 可通过环境变量 CCV_SKIP_THINKING_DISPLAY=1 强制跳过。
     const isClaudeCmd = cmd === 'claude' || /[\\/]claude(\.exe)?$/.test(cmd);
     if (isClaudeCmd && process.env.CCV_SKIP_THINKING_DISPLAY !== '1') {
-      const { withDefaultThinkingDisplay } = await import('./pty-manager.js');
+      const { withDefaultThinkingDisplay } = await import('./server/pty-manager.js');
       cmdArgs = withDefaultThinkingDisplay(cmdArgs);
     }
 
@@ -308,7 +292,7 @@ async function runProxyCommand(args) {
   }
 }
 
-// ensureHooks() extracted to lib/ensure-hooks.js (shared with electron/tab-worker.js)
+// ensureHooks() extracted to server/lib/ensure-hooks.js (shared with electron/tab-worker.js)
 
 async function runCliMode(extraClaudeArgs = [], cwd, noOpen = false) {
   // 首先尝试 npm 版本（包括 nvm 安装），找不到再尝试 native 版本
@@ -329,7 +313,7 @@ async function runCliMode(extraClaudeArgs = [], cwd, noOpen = false) {
   const workingDir = cwd || process.cwd();
 
   // 注册工作区
-  const { registerWorkspace } = await import('./workspace-registry.js');
+  const { registerWorkspace } = await import('./server/workspace-registry.js');
   registerWorkspace(workingDir);
 
   // 确保 AskUserQuestion hook 已注册到 ~/.claude/settings.json
@@ -347,12 +331,12 @@ async function runCliMode(extraClaudeArgs = [], cwd, noOpen = false) {
   }
 
   // 1. 启动代理
-  const { startProxy } = await import('./proxy.js');
+  const { startProxy } = await import('./server/proxy.js');
   const proxyPort = await startProxy();
   process.env.CCV_PROXY_PORT = String(proxyPort);
 
   // 3. 启动 HTTP 服务器
-  const serverMod = await import('./server.js');
+  const serverMod = await import('./server/server.js');
 
   // 等待服务器启动完成
   await new Promise(resolve => {
@@ -368,7 +352,7 @@ async function runCliMode(extraClaudeArgs = [], cwd, noOpen = false) {
   const serverProtocol = serverMod.getProtocol();
 
   // 3. 启动 PTY 中的 claude
-  const { spawnClaude, killPty } = await import('./pty-manager.js');
+  const { spawnClaude, killPty } = await import('./server/pty-manager.js');
   try {
     await spawnClaude(proxyPort, workingDir, extraClaudeArgs, claudePath, isNpmVersion, port, serverProtocol, serverMod.getInternalToken());
   } catch (err) {
@@ -416,7 +400,7 @@ async function runSdkMode(extraClaudeArgs = [], cwd, noOpen = false) {
   // 检查 SDK 是否可用
   let sdkManager;
   try {
-    sdkManager = await import('./lib/sdk-manager.js');
+    sdkManager = await import('./server/lib/sdk-manager.js');
     if (!sdkManager.isSdkAvailable()) throw new Error('query not available');
   } catch {
     console.warn('[CC Viewer] Agent SDK not available, falling back to PTY mode (-C)');
@@ -426,7 +410,7 @@ async function runSdkMode(extraClaudeArgs = [], cwd, noOpen = false) {
   const workingDir = cwd || process.cwd();
 
   // 注册工作区
-  const { registerWorkspace } = await import('./workspace-registry.js');
+  const { registerWorkspace } = await import('./server/workspace-registry.js');
   registerWorkspace(workingDir);
 
   // 不需要 ensureHooks — SDK canUseTool 处理 AskUserQuestion + 权限
@@ -439,7 +423,7 @@ async function runSdkMode(extraClaudeArgs = [], cwd, noOpen = false) {
   process.env.CCV_PROXY_MODE = '1'; // 使 interceptor.js 惰性
 
   // 启动 HTTP 服务器
-  const serverMod = await import('./server.js');
+  const serverMod = await import('./server/server.js');
 
   await new Promise(resolve => {
     const check = () => {
@@ -467,7 +451,7 @@ async function runSdkMode(extraClaudeArgs = [], cwd, noOpen = false) {
     onStreamingStatus: (data) => serverMod.setSdkStreamingState(data),
     broadcastWs: (msg) => serverMod.broadcastWsMessage(msg),
     permissionMode,
-    runWaterfallHook: (await import('./lib/plugin-loader.js')).runWaterfallHook,
+    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
     // it to the same SSE channel the Stop hook bridge uses in PTY mode.
@@ -545,12 +529,12 @@ async function runCliModeWorkspaceSelector(extraClaudeArgs = [], noOpen = false)
   process.env.CCV_WORKSPACE_MODE = '1';
 
   // 启动代理
-  const { startProxy } = await import('./proxy.js');
+  const { startProxy } = await import('./server/proxy.js');
   const proxyPort = await startProxy();
   process.env.CCV_PROXY_PORT = String(proxyPort);
 
   // 启动 HTTP 服务器（工作区模式，不初始化 interceptor 日志）
-  const serverMod = await import('./server.js');
+  const serverMod = await import('./server/server.js');
 
   // 工作区模式下 server.js 跳过了自动启动，需要手动调用
   await serverMod.startViewer();
@@ -588,7 +572,7 @@ async function runCliModeWorkspaceSelector(extraClaudeArgs = [], noOpen = false)
   }
 
   // 注册退出处理
-  const { killPty } = await import('./pty-manager.js');
+  const { killPty } = await import('./server/pty-manager.js');
   const cleanup = () => {
     killPty();
     serverMod.stopViewer().finally(() => process.exit());
@@ -702,16 +686,33 @@ if (isUninstall) {
     console.log(t('cli.uninstall.hookFail', { error: shellResult.error }));
   }
 
-  // 清理 statusLine 配置和脚本（兼容历史版本遗留）
+  // 清理 settings.json 里的 cc-viewer-managed hooks + 历史 statusLine 残留
+  // 一次性 read-modify-write，避免对 settings.json 做两轮 IO。
   try {
     const settingsPath = resolve(getClaudeConfigDir(), 'settings.json');
     if (existsSync(settingsPath)) {
       const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+      let mutated = false;
+
+      // 1) 移除所有带 cc-viewer-managed marker 的 hook entry（PreToolUse + Stop）
+      //    无此清理 → npm uninstall 后用户 settings.json 仍含 dead path → claude 启动
+      //    时每个工具调用都 ENOENT 报错。
+      const removed = removeAllManagedHooks(settings);
+      if (removed > 0) {
+        mutated = true;
+        console.log(`Removed ${removed} cc-viewer-managed hook entr${removed === 1 ? 'y' : 'ies'} from settings.json`);
+      }
+
+      // 2) 历史 statusLine 残留
       if (settings.statusLine?.command?.includes('ccv-statusline')) {
         delete settings.statusLine;
-        writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+        mutated = true;
         console.log('Cleaned statusLine config from settings.json');
       }
+
+      if (mutated) {
+        writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+      }
     }
     const ccvScript = resolve(getClaudeConfigDir(), 'ccv-statusline.sh');
     if (existsSync(ccvScript)) {

package/concepts/ar/GlobalSettings.md

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

package/concepts/ar/MainAgent.md

@@ -6,7 +6,7 @@ MainAgent هو سلسلة الطلبات الرئيسية في Claude Code عن
 
 ## طريقة التعرف
 
-في cc-viewer، يُعرَّف MainAgent من خلال `req.mainAgent === true`، ويتم تعيينه تلقائياً بواسطة `interceptor.js` عند التقاط الطلب.
+في cc-viewer، يُعرَّف MainAgent من خلال `req.mainAgent === true`، ويتم تعيينه تلقائياً بواسطة `server/interceptor.js` عند التقاط الطلب.
 
 شروط التحديد (يجب استيفاؤها جميعاً):
 - جسم الطلب يحتوي على حقل `system` (system prompt)

package/concepts/ar/ProxySwitch.md

@@ -18,7 +18,7 @@ Hot-Switch Proxy lets you dynamically redirect API requests to a different endpo
 
 ## How It Works
 
-When a proxy is active, `interceptor.js` performs the following before each API request:
+When a proxy is active, `server/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

package/concepts/da/GlobalSettings.md

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

package/concepts/da/MainAgent.md

@@ -6,7 +6,7 @@ MainAgent er den primære requestkæde i Claude Code, når det ikke er i agent t
 
 ## Identifikationsmetode
 
-I cc-viewer identificeres MainAgent via `req.mainAgent === true`, automatisk markeret af `interceptor.js` ved request-opfangning.
+I cc-viewer identificeres MainAgent via `req.mainAgent === true`, automatisk markeret af `server/interceptor.js` ved request-opfangning.
 
 Betingelser for bestemmelse (alle skal være opfyldt):
 - Request body indeholder feltet `system` (system prompt)

package/concepts/da/ProxySwitch.md

@@ -18,7 +18,7 @@ Hot-Switch Proxy lets you dynamically redirect API requests to a different endpo
 
 ## How It Works
 
-When a proxy is active, `interceptor.js` performs the following before each API request:
+When a proxy is active, `server/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

package/concepts/de/GlobalSettings.md

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

package/concepts/de/MainAgent.md

@@ -6,7 +6,7 @@ MainAgent ist die Hauptanfragekette von Claude Code im Nicht-Agent-Team-Modus. J
 
 ## Erkennung
 
-In cc-viewer wird MainAgent durch `req.mainAgent === true` identifiziert und von `interceptor.js` beim Abfangen der Anfrage automatisch markiert.
+In cc-viewer wird MainAgent durch `req.mainAgent === true` identifiziert und von `server/interceptor.js` beim Abfangen der Anfrage automatisch markiert.
 
 Erkennungsbedingungen (alle müssen erfüllt sein):
 - Der Request-Body enthält das `system`-Feld (System-Prompt)

package/concepts/de/ProxySwitch.md

@@ -18,7 +18,7 @@ Hot-Switch Proxy lets you dynamically redirect API requests to a different endpo
 
 ## How It Works
 
-When a proxy is active, `interceptor.js` performs the following before each API request:
+When a proxy is active, `server/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

package/concepts/en/GlobalSettings.md

@@ -122,12 +122,12 @@ CC-Viewer auto-registers hooks in `~/.claude/settings.json` under `hooks.PreTool
 
 ### 1. AskUserQuestion Bridge
 - **Matcher**: `"AskUserQuestion"`
-- **Command**: `node <install_dir>/lib/ask-bridge.js`
+- **Command**: `node <install_dir>/server/lib/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>/lib/perm-bridge.js`
+- **Command**: `node <install_dir>/server/lib/perm-bridge.js`
 - **Purpose**: Only `Bash`/`Edit`/`Write`/`NotebookEdit` require Web UI approval; others pass through
 
 ## 7. Shell Integration

package/concepts/en/MainAgent.md

@@ -6,7 +6,7 @@ MainAgent is the primary request chain in Claude Code when not in agent team mod
 
 ## Identification
 
-In cc-viewer, MainAgent is identified by `req.mainAgent === true`, automatically tagged by `interceptor.js` during request capture.
+In cc-viewer, MainAgent is identified by `req.mainAgent === true`, automatically tagged by `server/interceptor.js` during request capture.
 
 Criteria (all must be met):
 - The request body contains a `system` field (system prompt)

package/concepts/en/ProxySwitch.md

@@ -18,7 +18,7 @@ Hot-Switch Proxy lets you dynamically redirect API requests to a different endpo
 
 ## How It Works
 
-When a proxy is active, `interceptor.js` performs the following before each API request:
+When a proxy is active, `server/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

package/concepts/es/GlobalSettings.md

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

package/concepts/es/MainAgent.md

@@ -6,7 +6,7 @@ MainAgent es la cadena de solicitudes principal de Claude Code en estado no agen
 
 ## Método de identificación
 
-En cc-viewer, MainAgent se identifica mediante `req.mainAgent === true`, marcado automáticamente por `interceptor.js` durante la captura de la solicitud.
+En cc-viewer, MainAgent se identifica mediante `req.mainAgent === true`, marcado automáticamente por `server/interceptor.js` durante la captura de la solicitud.
 
 Condiciones de determinación (deben cumplirse todas):
 - El cuerpo de la solicitud contiene el campo `system` (system prompt)

package/concepts/es/ProxySwitch.md

@@ -18,7 +18,7 @@ Hot-Switch Proxy lets you dynamically redirect API requests to a different endpo
 
 ## How It Works
 
-When a proxy is active, `interceptor.js` performs the following before each API request:
+When a proxy is active, `server/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

package/concepts/fr/GlobalSettings.md

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

package/concepts/fr/MainAgent.md

@@ -6,7 +6,7 @@ MainAgent est la chaîne de requêtes principale de Claude Code en état non age
 
 ## Méthode d'identification
 
-Dans cc-viewer, MainAgent est identifié par `req.mainAgent === true`, marqué automatiquement par `interceptor.js` lors de la capture de la requête.
+Dans cc-viewer, MainAgent est identifié par `req.mainAgent === true`, marqué automatiquement par `server/interceptor.js` lors de la capture de la requête.
 
 Conditions de détermination (toutes doivent être remplies) :
 - Le corps de la requête contient le champ `system` (system prompt)

package/concepts/fr/ProxySwitch.md

@@ -18,7 +18,7 @@ Hot-Switch Proxy lets you dynamically redirect API requests to a different endpo
 
 ## How It Works
 
-When a proxy is active, `interceptor.js` performs the following before each API request:
+When a proxy is active, `server/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

package/concepts/it/GlobalSettings.md

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

package/concepts/it/MainAgent.md

@@ -6,7 +6,7 @@ MainAgent è la catena di richieste principale di Claude Code quando non è in m
 
 ## Metodo di identificazione
 
-In cc-viewer, MainAgent è identificato tramite `req.mainAgent === true`, contrassegnato automaticamente da `interceptor.js` al momento della cattura della richiesta.
+In cc-viewer, MainAgent è identificato tramite `req.mainAgent === true`, contrassegnato automaticamente da `server/interceptor.js` al momento della cattura della richiesta.
 
 Condizioni di determinazione (tutte devono essere soddisfatte):
 - Il corpo della richiesta contiene il campo `system` (system prompt)

package/concepts/it/ProxySwitch.md

@@ -18,7 +18,7 @@ Hot-Switch Proxy lets you dynamically redirect API requests to a different endpo
 
 ## How It Works
 
-When a proxy is active, `interceptor.js` performs the following before each API request:
+When a proxy is active, `server/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

package/concepts/ja/GlobalSettings.md

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

package/concepts/ja/MainAgent.md

@@ -6,7 +6,7 @@ MainAgent は、Claude Code が非 agent team 状態における主幹リクエ
 
 ## 識別方法
 
-cc-viewer では、MainAgent は `req.mainAgent === true` で識別され、`interceptor.js` がリクエストキャプチャ時に自動的にマーキングします。
+cc-viewer では、MainAgent は `req.mainAgent === true` で識別され、`server/interceptor.js` がリクエストキャプチャ時に自動的にマーキングします。
 
 判定条件（すべて満たす）：
 - リクエストボディに `system` フィールド（system prompt）が含まれる

package/concepts/ja/ProxySwitch.md

@@ -18,7 +18,7 @@ Hot-Switch Proxy lets you dynamically redirect API requests to a different endpo
 
 ## How It Works
 
-When a proxy is active, `interceptor.js` performs the following before each API request:
+When a proxy is active, `server/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

package/concepts/ko/GlobalSettings.md

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

package/concepts/ko/MainAgent.md

@@ -6,7 +6,7 @@ MainAgent는 Claude Code가 비 agent team 상태에서의 주간 요청 체인
 
 ## 식별 방법
 
-cc-viewer에서 MainAgent는 `req.mainAgent === true`로 식별되며, `interceptor.js`가 요청 캡처 시 자동으로 마킹합니다.
+cc-viewer에서 MainAgent는 `req.mainAgent === true`로 식별되며, `server/interceptor.js`가 요청 캡처 시 자동으로 마킹합니다.
 
 판정 조건 (모두 충족):
 - 요청 본문에 `system` 필드 (system prompt) 포함

package/concepts/ko/ProxySwitch.md

@@ -18,7 +18,7 @@ Hot-Switch Proxy lets you dynamically redirect API requests to a different endpo
 
 ## How It Works
 
-When a proxy is active, `interceptor.js` performs the following before each API request:
+When a proxy is active, `server/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

package/concepts/no/GlobalSettings.md

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

package/concepts/no/MainAgent.md

@@ -6,7 +6,7 @@ MainAgent er hovedforespørselskjeden i Claude Code når den ikke er i agent tea
 
 ## Identifisering
 
-I cc-viewer identifiseres MainAgent gjennom `req.mainAgent === true`, som automatisk settes av `interceptor.js` ved forespørselsfangst.
+I cc-viewer identifiseres MainAgent gjennom `req.mainAgent === true`, som automatisk settes av `server/interceptor.js` ved forespørselsfangst.
 
 Bestemmelsesvilkår (alle må oppfylles):
 - Forespørselskroppen inneholder `system`-felt (system prompt)

package/concepts/no/ProxySwitch.md

@@ -18,7 +18,7 @@ Hot-Switch Proxy lets you dynamically redirect API requests to a different endpo
 
 ## How It Works
 
-When a proxy is active, `interceptor.js` performs the following before each API request:
+When a proxy is active, `server/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

package/concepts/pl/GlobalSettings.md

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

package/concepts/pl/MainAgent.md

@@ -6,7 +6,7 @@ MainAgent to główny łańcuch żądań Claude Code w trybie bez agent team. Ka
 
 ## Sposób identyfikacji
 
-W cc-viewer MainAgent jest identyfikowany przez `req.mainAgent === true`, automatycznie oznaczany przez `interceptor.js` podczas przechwytywania żądania.
+W cc-viewer MainAgent jest identyfikowany przez `req.mainAgent === true`, automatycznie oznaczany przez `server/interceptor.js` podczas przechwytywania żądania.
 
 Warunki kwalifikacji (wszystkie muszą być spełnione):
 - Treść żądania zawiera pole `system` (system prompt)

package/concepts/pl/ProxySwitch.md

@@ -18,7 +18,7 @@ Hot-Switch Proxy lets you dynamically redirect API requests to a different endpo
 
 ## How It Works
 
-When a proxy is active, `interceptor.js` performs the following before each API request:
+When a proxy is active, `server/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

package/concepts/pt-BR/GlobalSettings.md

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