cc-viewer 1.6.326 → 1.6.327

package/dist/index.html

@@ -21,7 +21,7 @@
     // 整体显示大小已弃用 CSS zoom：Electron 改用 webFrame.setZoomFactor（首屏抢占见
     // electron/tab-content-preload.js），纯浏览器交由用户用浏览器自带快捷键缩放，故此处不再设 zoom。
   </script>
-  <script type="module" crossorigin src="/assets/index-CqCAViSO.js"></script>
+  <script type="module" crossorigin src="/assets/index-BzkiNZxR.js"></script>
   <link rel="modulepreload" crossorigin href="/assets/vendor-antd-x2KtHa4R.js">
   <link rel="modulepreload" crossorigin href="/assets/vendor-codemirror-z6VSi4ab.js">
   <link rel="modulepreload" crossorigin href="/assets/vendor-mdxeditor-Zi3mchEB.js">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-viewer",
-  "version": "1.6.326",
+  "version": "1.6.327",
   "description": "Claude Code Logger visualization management tool",
   "license": "MIT",
   "main": "server.js",

package/server/lib/interceptor-core.js

@@ -8,6 +8,13 @@ const SUBAGENT_SYSTEM_RE = /(?:command execution|file search|planning) specialis
 // 这类子代理继承完整 "You are Claude Code" prompt + Edit/Bash/Agent 工具，会误中轻量 MainAgent 启发式，故须显式排除。
 // 结尾 \b 锚定：仅匹配 `=true`（其后为 `;` / 空白 / 串尾），避免 `=truex` 之类误匹配。
 const SUBAGENT_BILLING_RE = /cc_is_subagent=true\b/;
+// 同进程 Agent/Task 队友（teammate）：system prompt 注入团队协作标记，但继承完整 "You are Claude Code"
+// prompt + Edit/Bash/Task 工具，且不带 --agent-name 进程参数（_isTeammate 认不出），会误中下方 MainAgent
+// 启发式 → 流式期间被当 mainAgent 开 live-stream，其 thinking 污染主「最新回复」overlay。须显式排除。
+// KEEP IN SYNC: server/lib/kv-cache-analyzer.js + src/utils/contentFilter.js（三处判据必须一致）。
+// 两处服务端实现(本文件 + kv-cache-analyzer)由 test/interceptor-core-mainagent.test.js 互校防漂移；
+// 前端 contentFilter 那份由 test/content-filter-unit.test.js 单测覆盖。
+const TEAMMATE_SYSTEM_RE = /running as an agent in a team|Agent Teammate Communication/i;
 
 export function getSystemText(body) {
   const system = body?.system;
@@ -22,6 +29,8 @@ export function isMainAgentRequest(body) {
   if (!body?.system || !Array.isArray(body?.tools)) return false;
 
   const sysText = getSystemText(body);
+  // 同进程队友 ⇒ 非 MainAgent（与最终重建 isMainAgentEntry 判据对齐，修流式期 teammate thinking 污染主 overlay）。
+  if (TEAMMATE_SYSTEM_RE.test(sysText)) return false;
   // cc_is_subagent=true ⇒ 子代理，绝非 MainAgent（cc_version 2.1.181+）。从源头让新日志的 mainAgent 字段为 false。
   if (SUBAGENT_BILLING_RE.test(sysText)) return false;
   if (!sysText.includes('You are Claude Code')) return false;

package/server/lib/terminal-env.js

@@ -16,6 +16,25 @@ export function stripClaudeNoFlickerUnlessOptedIn(env, sourceEnv = process.env)
   return env;
 }
 
+// 新版 Claude Code(v2.1.89+)默认全屏渲染(整屏原地重绘)→ 嵌入式 xterm 攒不出 scrollback、
+// 终端只剩一屏、上滚不到历史(claude 自身行为，cc-viewer 剥离 NO_FLICKER 也无济于事)。
+// cc-viewer 默认向 claude 注入官方开关 CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1，使其回到经典
+// 流式渲染、终端恢复可滚历史(与默认剥离 NO_FLICKER 同款取舍:保 scrollback)。想保留全屏无闪烁
+// 渲染的用户 opt-out:设 CCV_KEEP_CLAUDE_FULLSCREEN=1；亦尊重用户显式 export 的
+// CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN(含显式 '0' 主动开全屏)。
+export const KEEP_CLAUDE_FULLSCREEN_ENV = 'CCV_KEEP_CLAUDE_FULLSCREEN';
+
+export function applyClaudeAltScreenPref(env, sourceEnv = process.env) {
+  if (!env) return env;
+  const keepFullscreen = env[KEEP_CLAUDE_FULLSCREEN_ENV] === '1' || sourceEnv?.[KEEP_CLAUDE_FULLSCREEN_ENV] === '1';
+  if (!keepFullscreen && env.CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN == null) {
+    env.CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN = '1';
+  }
+  // 不把 cc-viewer 内部开关泄漏给子进程(对齐 _spawnClaudeImpl 对 CCV_ 短路开关的剥离)。
+  delete env[KEEP_CLAUDE_FULLSCREEN_ENV];
+  return env;
+}
+
 function ensureWrapperFile(dir, fileName, content) {
   mkdirSync(dir, { recursive: true });
   const file = join(dir, fileName);

package/server/pty-manager.js

@@ -4,7 +4,7 @@ import { join, dirname } from 'node:path';
 import { chmodSync, statSync } from 'node:fs';
 import { platform, arch, homedir } from 'node:os';
 import { createRequire } from 'node:module';
-import { prepareEmbeddedShellSpawn, stripClaudeNoFlickerUnlessOptedIn } from './lib/terminal-env.js';
+import { prepareEmbeddedShellSpawn, stripClaudeNoFlickerUnlessOptedIn, applyClaudeAltScreenPref } from './lib/terminal-env.js';
 import { killPtyTree } from './lib/term-signals.js';
 import { findSafeSliceStart, splitTrailingIncomplete } from './lib/ansi-safe-slice.js';
 
@@ -172,6 +172,10 @@ async function _spawnClaudeImpl(proxyPort, cwd, extraArgs = [], claudePath = nul
   // Claude Code NO_FLICKER 会让嵌入式 xterm 走 alt-screen 并丢失 scrollback。
   // cc-viewer 默认剥离继承值；确实需要时可显式设 CCV_KEEP_CLAUDE_CODE_NO_FLICKER=1。
   stripClaudeNoFlickerUnlessOptedIn(env);
+  // 新版 Claude Code 默认全屏渲染(整屏原地重绘)→ 终端只剩一屏、上滚不到历史。
+  // cc-viewer 默认注入 CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 让 claude 回经典流式渲染、终端可滚历史;
+  // 想保留全屏无闪烁渲染的用户设 CCV_KEEP_CLAUDE_FULLSCREEN=1 opt-out。
+  applyClaudeAltScreenPref(env);
 
   // Resolve real Node.js path (Electron's process.execPath is the Electron binary)
   let nodePath = process.execPath;
@@ -435,6 +439,9 @@ async function _spawnShellImpl() {
   delete shellEnv.CCVIEWER_INTERNAL_TOKEN;
   // 交互 shell 里手动敲 claude 时也禁鼠标，理由同 spawnClaude。
   shellEnv.CLAUDE_CODE_DISABLE_MOUSE ??= '1';
+  // 默认让 shell 内手敲的 claude 也回到经典流式渲染(终端可滚历史)，理由同 spawnClaude;
+  // CCV_KEEP_CLAUDE_FULLSCREEN=1 可 opt-out。
+  applyClaudeAltScreenPref(shellEnv);
   const shellSpawn = prepareEmbeddedShellSpawn(shell, shellEnv);
 
   ptyProcess = pty.spawn(shellSpawn.command, shellSpawn.args, {

package/server/scratch-pty-manager.js

@@ -3,7 +3,7 @@ import { dirname, join, basename } from 'node:path';
 import { chmodSync, statSync } from 'node:fs';
 import { platform, arch, homedir } from 'node:os';
 import { createRequire } from 'node:module';
-import { prepareEmbeddedShellSpawn } from './lib/terminal-env.js';
+import { prepareEmbeddedShellSpawn, applyClaudeAltScreenPref } from './lib/terminal-env.js';
 import { killPtyTree } from './lib/term-signals.js';
 import { findSafeSliceStart, splitTrailingIncomplete } from './lib/ansi-safe-slice.js';
 
@@ -137,6 +137,9 @@ export async function spawnScratch(id) {
     }
     delete env.ANTHROPIC_BASE_URL;
     env.CLAUDE_CODE_DISABLE_MOUSE ??= '1';
+    // 默认让 scratch 里手敲的 claude 也回到经典流式渲染、终端可滚历史;想保留全屏设
+    // CCV_KEEP_CLAUDE_FULLSCREEN=1 opt-out。CCV_* 已被上方剥离，opt-out 靠 sourceEnv(父进程 env)检测。
+    applyClaudeAltScreenPref(env);
     const shellSpawn = prepareEmbeddedShellSpawn(shell, env);
 
     s.lastExitCode = null;