cc-viewer 1.6.345 → 1.7.0

package/findcc.js

@@ -1,4 +1,4 @@
-import { resolve, join } from 'node:path';
+import { resolve, join, sep } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { existsSync, realpathSync, readFileSync } from 'node:fs';
 import { homedir, tmpdir, arch } from 'node:os';
@@ -22,11 +22,42 @@ const NODE_MODULES = resolve(__dirname, '..');
  * Claude Code's config from ~/.claude/ to a custom location.
  * @returns {string} absolute path to the Claude config directory
  */
+// ████████ Test isolation barrier L1c helper — DO NOT REMOVE (2026-07-12 data loss) ████████
+// A ccv-hosted shell exports CCV_LOG_DIR=<real user data dir> (and possibly CLAUDE_CONFIG_DIR)
+// into every child process — the claude pty, its Bash tool, any nested shell. A direct
+// `node --test <file>` run there inherits those vars and sails through the explicit-value fast
+// paths below, handing the test process the REAL user directories; test fixtures/cleanup then
+// delete real user data (confirmed 2026-07-12: a pty-manager fixture's finally-rmSync wiped the
+// user's global system_prompt/ model prompts). Policy: a test process may only ever target
+// disposable temp directories. This helper decides whether an explicit dir qualifies.
+function isDisposableTmpPath(p) {
+  const roots = new Set();
+  const t = resolve(tmpdir());
+  roots.add(t);
+  try { roots.add(realpathSync(t)); } catch { /* keep the unresolved form */ }
+  if (process.platform !== 'win32') { roots.add('/tmp'); roots.add('/private/tmp'); }
+  const forms = new Set([resolve(p)]);
+  try { forms.add(realpathSync(resolve(p))); } catch { /* path may not exist yet */ }
+  for (const f of forms) {
+    for (const r of roots) {
+      if (f === r || f.startsWith(r + sep)) return true;
+    }
+  }
+  return false;
+}
+
 export function getClaudeConfigDir() {
   const envDir = process.env.CLAUDE_CONFIG_DIR;
   if (envDir && typeof envDir === 'string' && envDir.trim()) {
     const raw = envDir.trim();
-    return raw.startsWith('~/') ? join(homedir(), raw.slice(2)) : resolve(raw);
+    const resolved = raw.startsWith('~/') ? join(homedir(), raw.slice(2)) : resolve(raw);
+    // ████ L1d: in test context an explicit CLAUDE_CONFIG_DIR must still be a throwaway dir —
+    // an inherited real config dir would re-open the 2026-06-06 updater CACHE_DIR hole. ████
+    if (process.env.NODE_TEST_CONTEXT && !isDisposableTmpPath(resolved)) {
+      console.warn(`[findcc] L1d test-isolation barrier: CLAUDE_CONFIG_DIR="${raw}" is not under the OS temp dir — forcing a private guard config dir (tests may only target disposable temp dirs)`);
+      return join(tmpdir(), 'cc-viewer-test', `guard-cfg-${process.pid}-${threadId}`);
+    }
+    return resolved;
   }
   // ████████ Test isolation barrier L1b — DO NOT REMOVE (prevents data-loss regressions, 2026-06-06) ████████
   // CCV_LOG_DIR=tmp only redirects LOG_DIR; it does not cover this function: updater.js's
@@ -69,7 +100,21 @@ function resolveLogDir() {
       return join(tmpdir(), 'cc-viewer-test', `${process.pid}-${threadId}`);
     }
     const expanded = raw.startsWith('~/') ? join(homedir(), raw.slice(2)) : raw;
-    return resolve(expanded);
+    const resolved = resolve(expanded);
+    // ████████ Test isolation barrier L1c — DO NOT REMOVE (2026-07-12 data loss) ████████
+    // The NODE_TEST_CONTEXT guard below only covers the no-CCV_LOG_DIR case; this explicit-value
+    // fast path used to accept ANY inherited dir. Inside a ccv-hosted shell CCV_LOG_DIR points at
+    // the real ~/.claude/cc-viewer, so a direct `node --test <file>` there resolved LOG_DIR to
+    // real user data — test cleanup then deleted it (2026-07-12: the user's global system_prompt/
+    // entries were wiped this way, twice). Tests may only target disposable temp dirs: anything
+    // outside the OS temp root is forced to the private guard dir. Use CCV_LOG_DIR=tmp or a
+    // mkdtemp path in tests. Unit test: test/logdir-test-guard.test.js.
+    if (process.env.NODE_TEST_CONTEXT && !isDisposableTmpPath(resolved)) {
+      console.warn(`[findcc] L1c test-isolation barrier: CCV_LOG_DIR="${raw}" is not under the OS temp dir — forcing a private guard LOG_DIR (tests may only target disposable temp dirs; use CCV_LOG_DIR=tmp or a mkdtemp path)`);
+      return join(tmpdir(), 'cc-viewer-test', `guard-${process.pid}-${threadId}`);
+    }
+    // ████████████████████████████████████████████████████████████████████████████
+    return resolved;
   }
   // Test isolation barrier: in node:test environment (NODE_TEST_CONTEXT is auto-injected by the
   // test runner and inherited by spawned child processes via spread env), if CCV_LOG_DIR is not
@@ -93,13 +138,13 @@ export let LOG_DIR = resolveLogDir();
  * will automatically see the updated value.
  */
 export function setLogDir(dir) {
-  if (!dir || typeof dir !== 'string') return;
+  if (!dir || typeof dir !== 'string') return false;
   const raw = dir.trim();
-  if (!raw) return;
+  if (!raw) return false;
   const resolved = resolve(raw.startsWith('~/') ? join(homedir(), raw.slice(2)) : raw);
   // Security: restrict to home directory or /tmp to prevent writes to system directories
   const home = homedir();
-  if (!resolved.startsWith(home) && !resolved.startsWith('/tmp/')) return;
+  if (!resolved.startsWith(home) && !resolved.startsWith('/tmp/')) return false;
   LOG_DIR = resolved;
   // workspace registry file location changes with LOG_DIR; the allowlist cache (including
   // registered workspaces) must be invalidated. Lazy import to avoid circular dependency
@@ -107,6 +152,7 @@ export function setLogDir(dir) {
   import('./server/lib/file-access-policy.js')
     .then(m => m.bumpWorkspacesVersion?.())
     .catch(() => { /* CLI-only entry points may not have the policy module loaded; side-effect free */ });
+  return true;
 }
 
 // npm package name candidates (priority order)
@@ -234,10 +280,16 @@ export function resolveNpmClaudePath() {
             const match = normReal.match(/(.*node_modules\/@[^/]+\/[^/]+)\//);
             if (match) {
               const packageDir = match[1];
+              // Claude Code 1.x: cli.js (injected with interceptor)
               const cliPath = join(packageDir, CLI_ENTRY);
               if (existsSync(cliPath)) {
                 return cliPath;
               }
+              // Claude Code 2.x layout ships no cli.js — the package's bin/ binary IS
+              // the entry point; without this fallback the resolver returns null and
+              // the launch dies with no claude at all.
+              const binPath = findNpmBinFallback(packageDir);
+              if (binPath) return binPath;
             }
           }
         } catch { }
@@ -255,16 +307,36 @@ export function resolveNpmClaudePath() {
   const globalRoot = getGlobalNodeModulesDir();
   if (globalRoot) {
     for (const packageName of PACKAGES) {
-      const cliPath = join(globalRoot, packageName, CLI_ENTRY);
+      const pkgDir = join(globalRoot, packageName);
+      // Claude Code 1.x: cli.js
+      const cliPath = join(pkgDir, CLI_ENTRY);
       if (existsSync(cliPath)) {
         return cliPath;
       }
+      // Claude Code 2.x: no cli.js, fall back to the package's bin/ entry.
+      const binPath = findNpmBinFallback(pkgDir);
+      if (binPath) return binPath;
     }
   }
 
   return null;
 }
 
+// Claude Code 2.x npm packages ship no cli.js — bin/claude(.exe) is the entry point.
+// `claude.exe` is checked FIRST even on POSIX: 2.1.x's package.json maps
+// `bin: {"claude": "bin/claude.exe"}` on every platform (verified on macOS 2.1.207,
+// where bin/claude.exe is the platform-native binary hard-linked into bin/).
+// Returns the first existing bin candidate under `<pkgDir>/bin`, or null (1.x layout).
+function findNpmBinFallback(pkgDir) {
+  const binDir = join(pkgDir, 'bin');
+  const names = process.platform === 'win32' ? ['claude.exe', 'claude.cmd'] : ['claude.exe', 'claude'];
+  for (const name of names) {
+    const binPath = join(binDir, name);
+    if (existsSync(binPath)) return binPath;
+  }
+  return null;
+}
+
 /**
  * 从 which/where 的原始输出中挑出能直接 CreateProcess/exec 的候选行。
  * Windows 的 `where` 会列出 PATH 中全部同名匹配——npm 全局安装时第一行往往是给

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-viewer",
-  "version": "1.6.345",
+  "version": "1.7.0",
   "description": "Claude Code logging, visualization, and management toolkit — launch a web viewer alongside Claude Code with full request/response tracing, proxy, and mobile support",
   "license": "MIT",
   "main": "server.js",
@@ -20,6 +20,7 @@
     "build:sourcemap": "CCV_SOURCEMAP=1 node build.js",
     "start": "node server.js",
     "lint:control-bytes": "node scripts/check-no-control-bytes.js",
+    "verify:wire-v2": "node cli.js verify",
     "pretest": "npm run lint:control-bytes",
     "pretest:cli": "npm run lint:control-bytes",
     "pretest:coverage": "npm run lint:control-bytes",

package/server/i18n.js

@@ -223,8 +223,8 @@ const i18nData = {
     "uk": "\nДля видалення виконайте: ccv --uninstall"
   },
   "cli.help": {
-    "zh": "CC Viewer CLI — Claude Code 的 Web Viewer 前端\n\n用法: ccv [选项] [命令] [提示词]\n\n默认启动交互式会话 + Web Viewer，所有参数透传给 claude。\n\n参数:\n  prompt                                    你的提示词\n\nCCV 专属选项:\n  -SDK, --sdk                               使用 Agent SDK 模式（无终端，结构化交互）\n  -logger                                   安装/修复 Claude Code Hook\n  --uninstall                               移除 CC Viewer 集成\n  --d                                       --dangerously-skip-permissions 的快捷方式\n  --ad                                      --allow-dangerously-skip-permissions 的快捷方式\n  --log-dir <path>                          自定义 JSONL 日志存储目录\n  --no-open                                 启动时不自动打开浏览器\n  --user-name <name>                        自定义显示名称\n  --user-avatar <path|url>                  自定义头像图片（文件路径或 URL）\n  --usePassword[=<pwd>]                     启用密码登录（远程访问需密码或 token；不带值则随机生成 6 位（2 字母 + 4 数字））\n  --pid[=<name>]                            锁定实例 id：让本 ccv 的「仅展示当前会话」视图按实例隔离（下次用同一 id 复用）\n\nClaude 选项（透传）:\n  -c, --continue                            继续当前目录最近的对话\n  -r, --resume [value]                      通过会话 ID 恢复对话，或打开交互式选择器\n  -p, --print                               打印响应后退出（适用于管道）\n  -d, --debug [filter]                      启用调试模式\n  -w, --worktree [name]                     为此会话创建新的 git worktree\n  --model <model>                           当前会话使用的模型\n  --effort <level>                          努力级别 (low, medium, high, max)\n  --dangerously-skip-permissions            跳过所有权限检查\n  --allowedTools <tools...>                 允许的工具列表\n  --disallowedTools <tools...>              禁止的工具列表\n  --system-prompt <prompt>                  会话系统提示词\n  --append-system-prompt <prompt>           追加系统提示词\n  --mcp-config <configs...>                 加载 MCP 服务器配置\n  --permission-mode <mode>                  权限模式\n  --add-dir <directories...>                额外允许访问的目录\n  --max-budget-usd <amount>                 API 调用最大预算（仅 --print）\n  --output-format <format>                  输出格式（仅 --print）: text, json, stream-json\n  --json-schema <schema>                    结构化输出的 JSON Schema\n  --verbose                                 详细模式\n  -h, --help                                显示帮助\n  -v, --version                             显示版本\n\n  更多选项请参考: claude --help\n\n示例:\n  ccv                                       启动交互模式\n  ccv -c                                    继续上次对话\n  ccv -r                                    恢复对话\n  ccv -p \"hello\"                             打印模式\n  ccv --model opus                          指定模型\n  ccv --d                                   跳过权限确认（快捷方式）\n  ccv --ad                                  允许跳过权限（不立即启用，可通过 Shift+Tab 切换）\n  ccv -c --model sonnet --effort max        组合使用\n  ccv -SDK                                  Agent SDK 模式（无终端）\n  ccv -SDK --d                              SDK 模式 + 跳过权限\n  ccv -logger                               安装/修复 Hook\n  ccv --log-dir ~/my-logs                   使用自定义日志目录\n  ccv --no-open                             启动时不打开浏览器\n  ccv --user-name \"Alice\" --user-avatar ./avatar.png  自定义用户身份\n  ccv --log-dir /tmp/test --no-open         组合 CCV 选项",
-    "en": "CC Viewer CLI — Web Viewer frontend for Claude Code\n\nUsage: ccv [options] [command] [prompt]\n\nStarts an interactive session with Web Viewer by default. All args are passed\nthrough to claude.\n\nArguments:\n  prompt                                    Your prompt\n\nCCV Options:\n  -SDK, --sdk                               Use Agent SDK mode (no terminal, structured interaction)\n  -logger                                   Install/repair Claude Code hook\n  --uninstall                               Remove CC Viewer integration\n  --d                                       Shortcut for --dangerously-skip-permissions\n  --ad                                      Shortcut for --allow-dangerously-skip-permissions\n  --log-dir <path>                          Custom JSONL log storage directory\n  --no-open                                 Don't auto-open browser on startup\n  --user-name <name>                        Custom display name for this session\n  --user-avatar <path|url>                  Custom avatar image (file path or URL)\n  --usePassword[=<pwd>]                     Enable password login (remote needs password or token; bare flag → random 6-char: 2 letters + 4 digits)\n  --pid[=<name>]                            Lock an instance id so this ccv's current-session view is isolated per instance (reuse the same id next run)\n\nClaude Options (passed through):\n  -c, --continue                            Continue the most recent conversation\n  -r, --resume [value]                      Resume a conversation by session ID, or open picker\n  -p, --print                               Print response and exit (useful for pipes)\n  -d, --debug [filter]                      Enable debug mode\n  -w, --worktree [name]                     Create a new git worktree for this session\n  --model <model>                           Model for the current session\n  --effort <level>                          Effort level (low, medium, high, max)\n  --dangerously-skip-permissions            Bypass all permission checks\n  --allowedTools <tools...>                 Allowed tool names\n  --disallowedTools <tools...>              Disallowed tool names\n  --system-prompt <prompt>                  System prompt for the session\n  --append-system-prompt <prompt>           Append to default system prompt\n  --mcp-config <configs...>                 Load MCP servers from JSON files or strings\n  --permission-mode <mode>                  Permission mode for the session\n  --add-dir <directories...>                Additional directories to allow access to\n  --max-budget-usd <amount>                 Max dollar amount for API calls (--print only)\n  --output-format <format>                  Output format (--print only): text, json, stream-json\n  --json-schema <schema>                    JSON Schema for structured output\n  --verbose                                 Enable verbose mode\n  -h, --help                                Show help\n  -v, --version                             Show version\n\n  For all options, see: claude --help\n\nExamples:\n  ccv                                       Start interactive mode\n  ccv -c                                    Continue last conversation\n  ccv -r                                    Resume a conversation\n  ccv -p \"hello\"                             Print mode\n  ccv --model opus                          Specify model\n  ccv --d                                   Skip permission prompts (shortcut)\n  ccv --ad                                  Allow bypass mode (not active, toggle via Shift+Tab)\n  ccv -c --model sonnet --effort max        Combine options\n  ccv -SDK                                  Agent SDK mode (no terminal)\n  ccv -SDK --d                              SDK mode + bypass permissions\n  ccv -logger                               Install/repair hook\n  ccv --log-dir ~/my-logs                   Use custom log directory\n  ccv --no-open                             Start without opening browser\n  ccv --user-name \"Alice\" --user-avatar ./avatar.png  Custom user profile\n  ccv --log-dir /tmp/test --no-open         Combine CCV options",
+    "zh": "CC Viewer CLI — Claude Code 的 Web Viewer 前端\n\n用法: ccv [选项] [命令] [提示词]\n\n默认启动交互式会话 + Web Viewer，所有参数透传给 claude。\n\n参数:\n  prompt                                    你的提示词\n\nCCV 专属选项:\n  -SDK, --sdk                               使用 Agent SDK 模式（无终端，结构化交互）\n  -logger                                   安装/修复 Claude Code Hook\n  --uninstall                               移除 CC Viewer 集成\n  --d                                       --dangerously-skip-permissions 的快捷方式\n  --ad                                      --allow-dangerously-skip-permissions 的快捷方式\n  --log-dir <path>                          自定义 JSONL 日志存储目录\n  --no-open                                 启动时不自动打开浏览器\n  --user-name <name>                        自定义显示名称\n  --user-avatar <path|url>                  自定义头像图片（文件路径或 URL）\n  --usePassword[=<pwd>]                     启用密码登录（远程访问需密码或 token；不带值则随机生成 6 位（2 字母 + 4 数字））\n\nClaude 选项（透传）:\n  -c, --continue                            继续当前目录最近的对话\n  -r, --resume [value]                      通过会话 ID 恢复对话，或打开交互式选择器\n  -p, --print                               打印响应后退出（适用于管道）\n  -d, --debug [filter]                      启用调试模式\n  -w, --worktree [name]                     为此会话创建新的 git worktree\n  --model <model>                           当前会话使用的模型\n  --effort <level>                          努力级别 (low, medium, high, max)\n  --dangerously-skip-permissions            跳过所有权限检查\n  --allowedTools <tools...>                 允许的工具列表\n  --disallowedTools <tools...>              禁止的工具列表\n  --system-prompt <prompt>                  会话系统提示词\n  --append-system-prompt <prompt>           追加系统提示词\n  --mcp-config <configs...>                 加载 MCP 服务器配置\n  --permission-mode <mode>                  权限模式\n  --add-dir <directories...>                额外允许访问的目录\n  --max-budget-usd <amount>                 API 调用最大预算（仅 --print）\n  --output-format <format>                  输出格式（仅 --print）: text, json, stream-json\n  --json-schema <schema>                    结构化输出的 JSON Schema\n  --verbose                                 详细模式\n  -h, --help                                显示帮助\n  -v, --version                             显示版本\n\n  更多选项请参考: claude --help\n\n示例:\n  ccv                                       启动交互模式\n  ccv -c                                    继续上次对话\n  ccv -r                                    恢复对话\n  ccv -p \"hello\"                             打印模式\n  ccv --model opus                          指定模型\n  ccv --d                                   跳过权限确认（快捷方式）\n  ccv --ad                                  允许跳过权限（不立即启用，可通过 Shift+Tab 切换）\n  ccv -c --model sonnet --effort max        组合使用\n  ccv -SDK                                  Agent SDK 模式（无终端）\n  ccv -SDK --d                              SDK 模式 + 跳过权限\n  ccv -logger                               安装/修复 Hook\n  ccv --log-dir ~/my-logs                   使用自定义日志目录\n  ccv --no-open                             启动时不打开浏览器\n  ccv --user-name \"Alice\" --user-avatar ./avatar.png  自定义用户身份\n  ccv --log-dir /tmp/test --no-open         组合 CCV 选项",
+    "en": "CC Viewer CLI — Web Viewer frontend for Claude Code\n\nUsage: ccv [options] [command] [prompt]\n\nStarts an interactive session with Web Viewer by default. All args are passed\nthrough to claude.\n\nArguments:\n  prompt                                    Your prompt\n\nCCV Options:\n  -SDK, --sdk                               Use Agent SDK mode (no terminal, structured interaction)\n  -logger                                   Install/repair Claude Code hook\n  --uninstall                               Remove CC Viewer integration\n  --d                                       Shortcut for --dangerously-skip-permissions\n  --ad                                      Shortcut for --allow-dangerously-skip-permissions\n  --log-dir <path>                          Custom JSONL log storage directory\n  --no-open                                 Don't auto-open browser on startup\n  --user-name <name>                        Custom display name for this session\n  --user-avatar <path|url>                  Custom avatar image (file path or URL)\n  --usePassword[=<pwd>]                     Enable password login (remote needs password or token; bare flag → random 6-char: 2 letters + 4 digits)\n\nClaude Options (passed through):\n  -c, --continue                            Continue the most recent conversation\n  -r, --resume [value]                      Resume a conversation by session ID, or open picker\n  -p, --print                               Print response and exit (useful for pipes)\n  -d, --debug [filter]                      Enable debug mode\n  -w, --worktree [name]                     Create a new git worktree for this session\n  --model <model>                           Model for the current session\n  --effort <level>                          Effort level (low, medium, high, max)\n  --dangerously-skip-permissions            Bypass all permission checks\n  --allowedTools <tools...>                 Allowed tool names\n  --disallowedTools <tools...>              Disallowed tool names\n  --system-prompt <prompt>                  System prompt for the session\n  --append-system-prompt <prompt>           Append to default system prompt\n  --mcp-config <configs...>                 Load MCP servers from JSON files or strings\n  --permission-mode <mode>                  Permission mode for the session\n  --add-dir <directories...>                Additional directories to allow access to\n  --max-budget-usd <amount>                 Max dollar amount for API calls (--print only)\n  --output-format <format>                  Output format (--print only): text, json, stream-json\n  --json-schema <schema>                    JSON Schema for structured output\n  --verbose                                 Enable verbose mode\n  -h, --help                                Show help\n  -v, --version                             Show version\n\n  For all options, see: claude --help\n\nExamples:\n  ccv                                       Start interactive mode\n  ccv -c                                    Continue last conversation\n  ccv -r                                    Resume a conversation\n  ccv -p \"hello\"                             Print mode\n  ccv --model opus                          Specify model\n  ccv --d                                   Skip permission prompts (shortcut)\n  ccv --ad                                  Allow bypass mode (not active, toggle via Shift+Tab)\n  ccv -c --model sonnet --effort max        Combine options\n  ccv -SDK                                  Agent SDK mode (no terminal)\n  ccv -SDK --d                              SDK mode + bypass permissions\n  ccv -logger                               Install/repair hook\n  ccv --log-dir ~/my-logs                   Use custom log directory\n  ccv --no-open                             Start without opening browser\n  ccv --user-name \"Alice\" --user-avatar ./avatar.png  Custom user profile\n  ccv --log-dir /tmp/test --no-open         Combine CCV options",
     "zh-TW": "CC Viewer CLI — Claude Code 的 Web Viewer 前端\n\n用法: ccv [選項] [命令] [提示詞]\n\n預設啟動互動式會話 + Web Viewer，所有參數透傳給 claude。\n\n參數:\n  prompt                                    你的提示詞\n\nCCV 專屬選項:\n  -SDK, --sdk                               使用 Agent SDK 模式（無終端，結構化互動）\n  -logger                                   安裝/修復 Claude Code Hook\n  --uninstall                               移除 CC Viewer 整合\n  --d                                       --dangerously-skip-permissions 的快捷方式\n  --ad                                      --allow-dangerously-skip-permissions 的快捷方式\n  --log-dir <path>                          自訂 JSONL 日誌儲存目錄\n  --no-open                                 啟動時不自動開啟瀏覽器\n  --user-name <name>                        自訂顯示名稱\n  --user-avatar <path|url>                  自訂頭像圖片（檔案路徑或 URL）\n\nClaude 選項（透傳）:\n  -c, --continue                            繼續當前目錄最近的對話\n  -r, --resume [value]                      透過會話 ID 恢復對話，或開啟互動式選擇器\n  -p, --print                               列印回應後退出（適用於管道）\n  -d, --debug [filter]                      啟用除錯模式\n  -w, --worktree [name]                     為此會話建立新的 git worktree\n  --model <model>                           當前會話使用的模型\n  --effort <level>                          努力級別 (low, medium, high, max)\n  --dangerously-skip-permissions            跳過所有權限檢查\n  --allowedTools <tools...>                 允許的工具列表\n  --disallowedTools <tools...>              禁止的工具列表\n  --system-prompt <prompt>                  會話系統提示詞\n  --append-system-prompt <prompt>           追加系統提示詞\n  --mcp-config <configs...>                 載入 MCP 伺服器設定\n  --permission-mode <mode>                  權限模式\n  --add-dir <directories...>                額外允許存取的目錄\n  --max-budget-usd <amount>                 API 呼叫最大預算（僅 --print）\n  --output-format <format>                  輸出格式（僅 --print）: text, json, stream-json\n  --json-schema <schema>                    結構化輸出的 JSON Schema\n  --verbose                                 詳細模式\n  -h, --help                                顯示說明\n  -v, --version                             顯示版本\n\n  更多選項請參考: claude --help\n\n範例:\n  ccv                                       啟動互動模式\n  ccv -c                                    繼續上次對話\n  ccv -r                                    恢復對話\n  ccv -p \"hello\"                             列印模式\n  ccv --model opus                          指定模型\n  ccv --d                                   跳過權限確認（快捷方式）\n  ccv --ad                                  允許跳過權限（不立即啟用，可透過 Shift+Tab 切換）\n  ccv -c --model sonnet --effort max        組合使用\n  ccv -SDK                                  Agent SDK 模式（無終端）\n  ccv -SDK --d                              SDK 模式 + 跳過權限\n  ccv -logger                               安裝/修復 Hook\n  ccv --log-dir ~/my-logs                   使用自訂日誌目錄\n  ccv --no-open                             啟動時不開啟瀏覽器\n  ccv --user-name \"Alice\" --user-avatar ./avatar.png  自訂使用者身份\n  ccv --log-dir /tmp/test --no-open         組合 CCV 選項"
   },
   "cli.cMode.notFound": {
@@ -2355,26 +2355,6 @@ const i18nData = {
     "tr": "Araç Kullanım İstatistikleri",
     "uk": "Статистика використання інструментів"
   },
-  "ui.mergeLogs": {
-    "zh": "合并日志",
-    "en": "Merge Logs",
-    "zh-TW": "合併日誌",
-    "ko": "로그 병합",
-    "ja": "ログを結合",
-    "de": "Logs zusammenführen",
-    "es": "Fusionar logs",
-    "fr": "Fusionner les logs",
-    "it": "Unisci log",
-    "da": "Flet logs",
-    "pl": "Scal logi",
-    "ru": "Объединить логи",
-    "ar": "دمج السجلات",
-    "no": "Slå sammen logger",
-    "pt-BR": "Mesclar logs",
-    "th": "รวมบันทึก",
-    "tr": "Logları birleştir",
-    "uk": "Об'єднати логи"
-  },
   "ui.openLog": {
     "zh": "打开",
     "en": "Open",
@@ -2395,66 +2375,6 @@ const i18nData = {
     "tr": "Aç",
     "uk": "Відкрити"
   },
-  "ui.mergeNotConsecutive": {
-    "zh": "请选择连续的日志文件",
-    "en": "Please select consecutive log files",
-    "zh-TW": "請選擇連續的日誌檔案",
-    "ko": "연속된 로그 파일을 선택하세요",
-    "ja": "連続したログファイルを選択してください",
-    "de": "Bitte wählen Sie aufeinanderfolgende Log-Dateien",
-    "es": "Seleccione archivos de log consecutivos",
-    "fr": "Veuillez sélectionner des fichiers de log consécutifs",
-    "it": "Seleziona file di log consecutivi",
-    "da": "Vælg venligst sammenhængende logfiler",
-    "pl": "Wybierz kolejne pliki logów",
-    "ru": "Выберите последовательные файлы логов",
-    "ar": "يرجى اختيار ملفات سجلات متتالية",
-    "no": "Velg sammenhengende loggfiler",
-    "pt-BR": "Selecione arquivos de log consecutivos",
-    "th": "กรุณาเลือกไฟล์บันทึกที่ต่อเนื่องกัน",
-    "tr": "Lütfen ardışık log dosyalarını seçin",
-    "uk": "Виберіть послідовні файли логів"
-  },
-  "ui.mergeTooLarge": {
-    "zh": "选中的日志文件总大小超过 400MB",
-    "en": "Selected log files exceed 400MB",
-    "zh-TW": "選中的日誌檔案總大小超過 400MB",
-    "ko": "선택한 로그 파일의 총 크기가 400MB를 초과합니다",
-    "ja": "選択したログファイルの合計サイズが 400MB を超えています",
-    "de": "Ausgewählte Log-Dateien überschreiten 400MB",
-    "es": "Los archivos de log seleccionados superan los 400MB",
-    "fr": "Les fichiers de log sélectionnés dépassent 400 Mo",
-    "it": "I file di log selezionati superano i 400MB",
-    "da": "Valgte logfiler overstiger 400MB",
-    "pl": "Wybrane pliki logów przekraczają 400MB",
-    "ru": "Выбранные файлы логов превышают 400МБ",
-    "ar": "ملفات السجلات المحددة تتجاوز 400 ميجابايت",
-    "no": "Valgte loggfiler overstiger 400MB",
-    "pt-BR": "Arquivos de log selecionados excedem 400MB",
-    "th": "ไฟล์บันทึกที่เลือกมีขนาดรวมเกิน 400MB",
-    "tr": "Seçilen log dosyaları 400MB'ı aşıyor",
-    "uk": "Вибрані файли логів перевищують 400МБ"
-  },
-  "ui.mergeSuccess": {
-    "zh": "日志合并成功",
-    "en": "Logs merged successfully",
-    "zh-TW": "日誌合併成功",
-    "ko": "로그 병합 성공",
-    "ja": "ログの結合に成功しました",
-    "de": "Logs erfolgreich zusammengeführt",
-    "es": "Logs fusionados correctamente",
-    "fr": "Logs fusionnés avec succès",
-    "it": "Log uniti con successo",
-    "da": "Logs flettet",
-    "pl": "Logi scalone pomyślnie",
-    "ru": "Логи успешно объединены",
-    "ar": "تم دمج السجلات بنجاح",
-    "no": "Logger slått sammen",
-    "pt-BR": "Logs mesclados com sucesso",
-    "th": "รวมบันทึกสำเร็จ",
-    "tr": "Loglar başarıyla birleştirildi",
-    "uk": "Логи успішно об'єднано"
-  },
   "ui.askQuestion": {
     "zh": "提问",
     "en": "Question",
@@ -2935,65 +2855,25 @@ const i18nData = {
     "tr": "Hata: --im bir platform kimliği gerektirir (örn. dingtalk)",
     "uk": "Помилка: --im потребує id платформи (напр. dingtalk)"
   },
-  "cli.pidInvalid": {
-    "zh": "错误: --pid 需要一个非空的实例名（如 --pid=alpha）",
-    "en": "Error: --pid requires a non-empty instance name (e.g. --pid=alpha)",
-    "zh-TW": "錯誤: --pid 需要一個非空的實例名稱（如 --pid=alpha）",
-    "ko": "오류: --pid에는 비어 있지 않은 인스턴스 이름이 필요합니다 (예: --pid=alpha)",
-    "ja": "エラー: --pid には空でないインスタンス名が必要です (例: --pid=alpha)",
-    "de": "Fehler: --pid erfordert einen nicht leeren Instanznamen (z. B. --pid=alpha)",
-    "es": "Error: --pid requiere un nombre de instancia no vacío (p. ej. --pid=alpha)",
-    "fr": "Erreur : --pid nécessite un nom d'instance non vide (p. ex. --pid=alpha)",
-    "it": "Errore: --pid richiede un nome di istanza non vuoto (es. --pid=alpha)",
-    "da": "Fejl: --pid kræver et ikke-tomt instansnavn (f.eks. --pid=alpha)",
-    "pl": "Błąd: --pid wymaga niepustej nazwy instancji (np. --pid=alpha)",
-    "ru": "Ошибка: --pid требует непустого имени экземпляра (например, --pid=alpha)",
-    "ar": "خطأ: --pid يتطلب اسم نسخة غير فارغ (مثل --pid=alpha)",
-    "no": "Feil: --pid krever et ikke-tomt instansnavn (f.eks. --pid=alpha)",
-    "pt-BR": "Erro: --pid requer um nome de instância não vazio (ex.: --pid=alpha)",
-    "th": "ข้อผิดพลาด: --pid ต้องการชื่ออินสแตนซ์ที่ไม่ว่าง (เช่น --pid=alpha)",
-    "tr": "Hata: --pid boş olmayan bir örnek adı gerektirir (örn. --pid=alpha)",
-    "uk": "Помилка: --pid потребує непорожнього імені екземпляра (напр. --pid=alpha)"
-  },
-  "cli.instanceId": {
-    "zh": "实例 PID: {id}",
-    "en": "Instance PID: {id}",
-    "zh-TW": "實例 PID: {id}",
-    "ko": "인스턴스 PID: {id}",
-    "ja": "インスタンス PID: {id}",
-    "de": "Instanz-PID: {id}",
-    "es": "PID de instancia: {id}",
-    "fr": "PID d'instance : {id}",
-    "it": "PID istanza: {id}",
-    "da": "Instans-PID: {id}",
-    "pl": "PID instancji: {id}",
-    "ru": "PID экземпляра: {id}",
-    "ar": "PID النسخة: {id}",
-    "no": "Instans-PID: {id}",
-    "pt-BR": "PID da instância: {id}",
-    "th": "PID อินสแตนซ์: {id}",
-    "tr": "Örnek PID: {id}",
-    "uk": "PID екземпляра: {id}"
-  },
-  "cli.instanceHistory": {
-    "zh": "该项目历史 PID: {ids}",
-    "en": "Past PIDs for this project: {ids}",
-    "zh-TW": "此專案歷史 PID: {ids}",
-    "ko": "이 프로젝트의 이전 PID: {ids}",
-    "ja": "このプロジェクトの過去の PID: {ids}",
-    "de": "Frühere PIDs für dieses Projekt: {ids}",
-    "es": "PIDs anteriores de este proyecto: {ids}",
-    "fr": "PID précédents pour ce projet : {ids}",
-    "it": "PID precedenti per questo progetto: {ids}",
-    "da": "Tidligere PID'er for dette projekt: {ids}",
-    "pl": "Poprzednie PID-y tego projektu: {ids}",
-    "ru": "Прежние PID этого проекта: {ids}",
-    "ar": "معرّفات PID السابقة لهذا المشروع: {ids}",
-    "no": "Tidligere PID-er for dette prosjektet: {ids}",
-    "pt-BR": "PIDs anteriores deste projeto: {ids}",
-    "th": "PID ก่อนหน้าของโปรเจกต์นี้: {ids}",
-    "tr": "Bu projenin önceki PID'leri: {ids}",
-    "uk": "Попередні PID цього проєкту: {ids}"
+  "cli.v1LogsFound": {
+    "zh": "发现 {count} 个项目存在未迁移的旧格式日志，可运行 ccv convert <项目> 或 ccv convert --all 迁移",
+    "en": "{count} project(s) have unmigrated legacy logs — run `ccv convert <project>` or `ccv convert --all`",
+    "zh-TW": "發現 {count} 個專案存在未遷移的舊格式日誌，可執行 ccv convert <專案> 或 ccv convert --all 遷移",
+    "ko": "{count}개 프로젝트에 마이그레이션되지 않은 이전 형식 로그가 있습니다. `ccv convert <프로젝트>` 또는 `ccv convert --all`을 실행하세요",
+    "ja": "{count} 件のプロジェクトに未移行の旧形式ログがあります。`ccv convert <project>` または `ccv convert --all` を実行してください",
+    "de": "{count} Projekt(e) haben nicht migrierte alte Logs — `ccv convert <Projekt>` oder `ccv convert --all` ausführen",
+    "es": "{count} proyecto(s) tienen registros antiguos sin migrar — ejecute `ccv convert <proyecto>` o `ccv convert --all`",
+    "fr": "{count} projet(s) ont des journaux anciens non migrés — exécutez `ccv convert <projet>` ou `ccv convert --all`",
+    "it": "{count} progetto/i con log in formato precedente non migrati — esegui `ccv convert <progetto>` o `ccv convert --all`",
+    "da": "{count} projekt(er) har ikke-migrerede ældre logfiler — kør `ccv convert <projekt>` eller `ccv convert --all`",
+    "pl": "{count} projekt(ów) ma niezmigrowane starsze logi — uruchom `ccv convert <projekt>` lub `ccv convert --all`",
+    "ru": "В {count} проект(ах) есть неперенесённые логи старого формата — выполните `ccv convert <проект>` или `ccv convert --all`",
+    "ar": "{count} مشروع(ات) بها سجلات قديمة غير مُرحّلة — شغّل `ccv convert <project>` أو `ccv convert --all`",
+    "no": "{count} prosjekt(er) har umigrerte eldre logger — kjør `ccv convert <prosjekt>` eller `ccv convert --all`",
+    "pt-BR": "{count} projeto(s) têm logs antigos não migrados — execute `ccv convert <projeto>` ou `ccv convert --all`",
+    "th": "มี {count} โปรเจกต์ที่มีบันทึกรูปแบบเก่ายังไม่ย้าย — รัน `ccv convert <project>` หรือ `ccv convert --all`",
+    "tr": "{count} projede taşınmamış eski günlükler var — `ccv convert <proje>` veya `ccv convert --all` çalıştırın",
+    "uk": "{count} проєкт(ів) мають неперенесені старі логи — виконайте `ccv convert <проєкт>` або `ccv convert --all`"
   },
   "cli.imUnknownPlatform": {
     "zh": "错误: 未知的 IM 平台: {id}",