cc-viewer 1.6.294 → 1.6.296

package/server/lib/updater.js

@@ -107,7 +107,7 @@ export function isAnyCcvBusy({ currentPid, busy, portRange, lsofImpl } = {}) {
 
   const [start, end] = Array.isArray(portRange) && portRange.length === 2 ? portRange : [7008, 7099];
   const pid = typeof currentPid === 'number' ? currentPid : process.pid;
-  const runLsof = lsofImpl || ((cmd) => execSync(cmd, { timeout: 2000, encoding: 'utf-8' }));
+  const runLsof = lsofImpl || ((cmd) => execSync(cmd, { timeout: 2000, encoding: 'utf-8', windowsHide: true }));
 
   try {
     const out = String(runLsof(`lsof -iTCP:${start}-${end} -sTCP:LISTEN -P -n -Fp`));
@@ -216,7 +216,9 @@ export async function checkAndUpdate(options = {}) {
         const child = spawnImpl(
           'npm',
           ['install', '-g', `cc-viewer@${remoteVersion}`, '--no-audit', '--no-fund'],
-          { detached: true, stdio: 'ignore', shell: process.platform === 'win32' }
+          // windowsHide：Windows 下 shell 模式经 cmd.exe 跑 npm.cmd（console-subsystem），
+          // 不隐藏会在后台更新期间常驻一个可见控制台窗口；POSIX 上为 no-op。
+          { detached: true, stdio: 'ignore', shell: process.platform === 'win32', windowsHide: true }
         );
         if (child && typeof child.unref === 'function') child.unref();
       } catch (err) {

package/server/pty-manager.js

@@ -178,7 +178,7 @@ export async function spawnClaude(proxyPort, cwd, extraArgs = [], claudePath = n
   if (process.versions.electron) {
     const { execSync } = await import('node:child_process');
     try {
-      nodePath = execSync(process.platform === 'win32' ? 'where node' : 'which node', { encoding: 'utf-8' }).trim();
+      nodePath = execSync(process.platform === 'win32' ? 'where node' : 'which node', { encoding: 'utf-8', windowsHide: true }).trim();
       if (process.platform === 'win32') nodePath = nodePath.split('\n')[0].trim();
     } catch {
       nodePath = process.platform === 'win32' ? 'node' : '/usr/local/bin/node';

package/server/routes/ask-perm.js

@@ -223,7 +223,7 @@ function askHook(req, res, parsedUrl, isLocal, deps) {
 // Phase 3: short-poll handoff endpoint. ask-bridge GET /api/ask-hook/:id/result?wait=30000
 // 在 wait ms 内若答案/cancel 到达 → 立即返；否则返 204 让 client 重发。
 // 内存有 entry → 注册 listener；内存无 → 查 disk consume（server 重启场景）。
-function askHookResult(req, res, parsedUrl, isLocal, deps) {
+async function askHookResult(req, res, parsedUrl, isLocal, deps) {
   const url = parsedUrl.pathname;
   try {
     // URL 形如 /api/ask-hook/<id>/result?wait=30000；id 受白名单约束（与 POST 同源）
@@ -242,7 +242,7 @@ function askHookResult(req, res, parsedUrl, isLocal, deps) {
     // 用 consumeIfFinal 单次 withLock 内判 status 决定是否 delete —— 旧设计的
     // "consume + 若 pending 再 setEntry 写回" 两段是 race window：中间被 markAnswered 命中后，
     // setEntry 走 status guard 已经不会覆盖；但不删的 pending 也无须重写一遍。
-    const diskEntry = askStoreConsumeIfFinal(id);
+    const diskEntry = await askStoreConsumeIfFinal(id);
     if (diskEntry && diskEntry.status === 'answered') {
       res.writeHead(200, { 'Content-Type': 'application/json' });
       res.end(JSON.stringify({ answers: diskEntry.answers || {} }));

package/server/routes/dingtalk.js

@@ -80,6 +80,8 @@ function dingtalkConfigPost(req, res, parsedUrl, isLocal, deps) {
       allowStaffIds: incoming.allowStaffIds,
       maxChunkChars: incoming.maxChunkChars,
       blockOnSkipPermissions: incoming.blockOnSkipPermissions,
+      ackCard: incoming.ackCard,
+      cardTemplateId: incoming.cardTemplateId,
     });
     // 驱动进程管理器（替代旧的在进程 reloadBridge）：启用→重启 worker，停用→停 worker。
     try {

package/server/routes/events.js

@@ -96,7 +96,7 @@ function resumeChoice(req, res, parsedUrl, isLocal, deps) {
         } catch { }
       });
       // 流式分段广播 full_reload，避免全量加载 OOM
-      const reloadTotal = countLogEntries(LOG_FILE);
+      const reloadTotal = await countLogEntries(LOG_FILE);
       deps.clients.forEach(client => {
         try { client.write(`event: load_start\ndata: ${JSON.stringify({ total: reloadTotal, incremental: false })}\n\n`); } catch { }
       });
@@ -313,7 +313,7 @@ async function requests(req, res) {
 }
 
 // 分页历史条目端点：移动端"加载更多"按需拉取
-function entriesPage(req, res, parsedUrl) {
+async function entriesPage(req, res, parsedUrl) {
   const before = parsedUrl.searchParams.get('before');
   const limitVal = Math.min(parseInt(parsedUrl.searchParams.get('limit'), 10) || 100, 500);
   if (!before || isNaN(new Date(before).getTime())) {
@@ -322,7 +322,7 @@ function entriesPage(req, res, parsedUrl) {
     return;
   }
   try {
-    const result = readPagedEntries(LOG_FILE, { before, limit: limitVal });
+    const result = await readPagedEntries(LOG_FILE, { before, limit: limitVal });
     // entries 是原始 JSON 字符串数组，parse 后返回给客户端
     // ExitPlanMode V2 空 input 的条目用 enrichRawIfNeeded 在 raw 阶段补全
     const entries = result.entries.map(raw => {

package/server/routes/files-fs.js

@@ -614,7 +614,7 @@ function openFile(req, res, parsedUrl, isLocal, deps) {
       if (plat === 'darwin') {
         execFile('open', [fullPath], () => {});
       } else if (plat === 'win32') {
-        execFile('cmd.exe', ['/c', 'start', '', fullPath], () => {});
+        execFile('cmd.exe', ['/c', 'start', '', fullPath], { windowsHide: true }, () => {});
       } else {
         execFile('xdg-open', [fullPath], () => {});
       }
@@ -842,7 +842,7 @@ function createDir(req, res, parsedUrl, isLocal, deps) {
 function openLogDir(req, res) {
   const dir = LOG_FILE ? dirname(LOG_FILE) : LOG_DIR;
   const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'explorer' : 'xdg-open';
-  execFile(cmd, [dir], () => {});
+  execFile(cmd, [dir], { windowsHide: true }, () => {});
   res.writeHead(200, { 'Content-Type': 'application/json' });
   res.end(JSON.stringify({ ok: true, dir }));
 }
@@ -851,7 +851,7 @@ function openProfileDir(req, res) {
   const dir = dirname(PROFILE_PATH);
   if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
   const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'explorer' : 'xdg-open';
-  execFile(cmd, [dir], () => {});
+  execFile(cmd, [dir], { windowsHide: true }, () => {});
   res.writeHead(200, { 'Content-Type': 'application/json' });
   res.end(JSON.stringify({ ok: true, dir }));
 }
@@ -859,7 +859,7 @@ function openProfileDir(req, res) {
 function openProjectDir(req, res) {
   const dir = process.env.CCV_PROJECT_DIR || process.cwd();
   const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'explorer' : 'xdg-open';
-  execFile(cmd, [dir], () => {});
+  execFile(cmd, [dir], { windowsHide: true }, () => {});
   res.writeHead(200, { 'Content-Type': 'application/json' });
   res.end(JSON.stringify({ ok: true, dir }));
 }

package/server/routes/logs.js

@@ -6,9 +6,9 @@ import { _projectName } from '../interceptor.js';
 import { listLocalLogs, deleteLogFiles, mergeLogFiles, archiveLogFiles, validateLogPath } from '../lib/log-management.js';
 import { countLogEntries, streamRawEntriesAsync } from '../lib/log-stream.js';
 
-function localLogs(req, res) {
+async function localLogs(req, res) {
   try {
-    const result = listLocalLogs(LOG_DIR, _projectName);
+    const result = await listLocalLogs(LOG_DIR, _projectName);
     res.writeHead(200, { 'Content-Type': 'application/json' });
     res.end(JSON.stringify(result));
   } catch (err) {
@@ -96,7 +96,7 @@ async function localLog(req, res, parsedUrl) {
     // 独立 SSE 流：直接向请求方返回 event-stream，不走 /events 广播
     validateLogPath(LOG_DIR, file);
     const filePath = join(LOG_DIR, file);
-    const total = countLogEntries(filePath);
+    const total = await countLogEntries(filePath);
 
     res.writeHead(200, {
       'Content-Type': 'text/event-stream',
@@ -151,10 +151,10 @@ function deleteLogs(req, res, parsedUrl, isLocal, deps) {
 function mergeLogs(req, res, parsedUrl, isLocal, deps) {
   let body = '';
   req.on('data', chunk => { body += chunk; if (body.length > deps.MAX_POST_BODY) req.destroy(); });
-  req.on('end', () => {
+  req.on('end', async () => {
     try {
       const { files } = JSON.parse(body);
-      const merged = mergeLogFiles(LOG_DIR, files);
+      const merged = await mergeLogFiles(LOG_DIR, files);
       res.writeHead(200, { 'Content-Type': 'application/json' });
       res.end(JSON.stringify({ ok: true, merged }));
     } catch (err) {

package/server/routes/project-meta.js

@@ -4,6 +4,23 @@ import { join } from 'node:path';
 import { PACKAGE_JSON } from '../_paths.js';
 import { LOG_DIR } from '../../findcc.js';
 import { _projectName } from '../interceptor.js';
+import { detectHomebrewInstall } from '../lib/updater.js';
+
+// 判定当前 cc-viewer 的安装渠道，供前端精准匹配升级命令。
+//   - electron：桌面版（in-process server），走 GitHub Releases 重新下载安装包。
+//   - brew：Homebrew Cellar 布局命中 → `brew upgrade cc-viewer`（npm install -g 会跟 Cellar 打架）。
+//   - npm：默认兜底 → `npm install -g cc-viewer --registry=...`（指定官方源避免镜像滞后拿到旧版本）。
+// deps 仅供单测注入；失败安全：detect 抛异常时回落到 npm（不会误导 brew 用户走 npm）。
+export function getInstallMethod({
+  electron = process.versions && process.versions.electron,
+  detect = detectHomebrewInstall,
+} = {}) {
+  if (electron) return 'electron';
+  try {
+    if (detect()) return 'brew';
+  } catch { /* 探测失败 → 回落 npm */ }
+  return 'npm';
+}
 
 function projectName(req, res) {
   res.writeHead(200, { 'Content-Type': 'application/json' });
@@ -20,7 +37,7 @@ function versionInfo(req, res) {
   try {
     const pkg = JSON.parse(readFileSync(PACKAGE_JSON, 'utf-8'));
     res.writeHead(200, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify({ version: pkg.version }));
+    res.end(JSON.stringify({ version: pkg.version, installMethod: getInstallMethod() }));
   } catch {
     res.writeHead(500, { 'Content-Type': 'application/json' });
     res.end(JSON.stringify({ error: 'Failed to read version' }));

package/server/routes/workspaces.js

@@ -1,14 +1,14 @@
 // Workspace routes (moved verbatim from server.js handleRequest).
-import { existsSync, statSync, unwatchFile } from 'node:fs';
+import { existsSync, statSync } from 'node:fs';
 import { basename } from 'node:path';
 import { LOG_FILE, initForWorkspace, resetWorkspace } from '../interceptor.js';
-import { watchLogFile, getWatchedFiles } from '../lib/log-watcher.js';
+import { watchLogFile, unwatchAll } from '../lib/log-watcher.js';
 import { readClaudeProjectModel } from '../lib/context-watcher.js';
 import { countLogEntries, streamRawEntriesAsync } from '../lib/log-stream.js';
 
 function workspacesList(req, res, parsedUrl, isLocal, deps) {
-  import('../workspace-registry.js').then(({ getWorkspaces }) => {
-    const workspaces = getWorkspaces();
+  import('../workspace-registry.js').then(async ({ getWorkspaces }) => {
+    const workspaces = await getWorkspaces();
     res.writeHead(200, { 'Content-Type': 'application/json' });
     res.end(JSON.stringify({ workspaces, workspaceMode: deps.isWorkspaceMode && !deps.workspaceLaunched }));
   }).catch(err => {
@@ -30,7 +30,7 @@ function workspacesLaunch(req, res, parsedUrl, isLocal, deps) {
       }
 
       const { registerWorkspace } = await import('../workspace-registry.js');
-      registerWorkspace(wsPath);
+      await registerWorkspace(wsPath);
 
       // Electron multi-tab 模式：管理 server 只触发 callback，不做日志初始化
       // 所有日志相关操作（initForWorkspace、watchLogFile、spawnClaude）由 tab-worker 子进程负责
@@ -73,7 +73,7 @@ function workspacesLaunch(req, res, parsedUrl, isLocal, deps) {
       });
 
       // 流式分段广播以刷新会话区域，避免全量加载 OOM
-      const wsReloadTotal = countLogEntries(LOG_FILE);
+      const wsReloadTotal = await countLogEntries(LOG_FILE);
       deps.clients.forEach(client => {
         try { client.write(`event: load_start\ndata: ${JSON.stringify({ total: wsReloadTotal, incremental: false })}\n\n`); } catch {}
       });
@@ -107,7 +107,7 @@ function workspacesAdd(req, res, parsedUrl, isLocal, deps) {
         return;
       }
       const { registerWorkspace } = await import('../workspace-registry.js');
-      const entry = registerWorkspace(wsPath);
+      const entry = await registerWorkspace(wsPath);
       res.writeHead(200, { 'Content-Type': 'application/json' });
       res.end(JSON.stringify({ ok: true, workspace: entry }));
     } catch (err) {
@@ -120,8 +120,8 @@ function workspacesAdd(req, res, parsedUrl, isLocal, deps) {
 function workspacesDelete(req, res, parsedUrl) {
   const url = parsedUrl.pathname;
   const id = url.split('/').pop();
-  import('../workspace-registry.js').then(({ removeWorkspace }) => {
-    const removed = removeWorkspace(id);
+  import('../workspace-registry.js').then(async ({ removeWorkspace }) => {
+    const removed = await removeWorkspace(id);
     res.writeHead(200, { 'Content-Type': 'application/json' });
     res.end(JSON.stringify({ ok: removed }));
   }).catch(err => {
@@ -138,10 +138,7 @@ function workspacesStop(req, res, parsedUrl, isLocal, deps) {
     // 接续原有清理流程
 
     // 停止日志监听
-    for (const logFile of getWatchedFiles().keys()) {
-      unwatchFile(logFile);
-    }
-    getWatchedFiles().clear();
+    unwatchAll();
 
     // 重置 interceptor 状态
     resetWorkspace();

package/server/server.js

@@ -40,13 +40,18 @@ import './lib/adapters/wecom-adapter.js';    // side-effect: registers the WeCom
 import './lib/adapters/discord-adapter.js';  // side-effect: registers the Discord adapter
 import { loadConfig } from './lib/im-config.js';
 
-const execFileAsync = promisify(execFile);
-const execAsync = promisify(exec);
+// Windows：git.exe / cmd.exe 等 console-subsystem 子进程从无控制台的 worker node.exe 启动时
+// 会各弹一个可见控制台窗口（diff/status 轮询路径高频闪现）。在 promisify 包装层统一默认
+// windowsHide（POSIX 上为 no-op，调用方传入可覆盖）。deps.execFileAsync 注入下游路由同样受益。
+const _execFileAsyncRaw = promisify(execFile);
+const execFileAsync = (cmd, args, opts) => _execFileAsyncRaw(cmd, args, { windowsHide: true, ...opts });
+const _execAsyncRaw = promisify(exec);
+const execAsync = (cmd, opts) => _execAsyncRaw(cmd, { windowsHide: true, ...opts });
 
 // execFile with stdin input support (for git check-ignore --stdin)
 function execWithStdin(cmd, args, input, options) {
   return new Promise((resolve, reject) => {
-    const child = spawn(cmd, args, { ...options, stdio: ['pipe', 'pipe', 'pipe'] });
+    const child = spawn(cmd, args, { ...options, stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true });
     let stdout = '';
     let stderr = '';
     child.stdout.on('data', d => { stdout += d; });
@@ -70,7 +75,7 @@ import { loadAuthConfig, loadAuthState, saveAuthConfig, clearProjectOverride, ge
 import { checkAndUpdate } from './lib/updater.js';
 import { loadPlugins, runWaterfallHook, runParallelHook } from './lib/plugin-loader.js';
 import { CONTEXT_WINDOW_FILE, readModelContextSize } from './lib/context-watcher.js';
-import { watchLogFile, startWatching, getWatchedFiles, sendEventToClients, sendToClients } from './lib/log-watcher.js';
+import { watchLogFile, startWatching, unwatchAll, sendEventToClients, sendToClients } from './lib/log-watcher.js';
 import { cleanupExtractCache } from './lib/jsonl-archive.js';
 
 
@@ -81,6 +86,7 @@ function getPrefsFile() { return join(LOG_DIR, 'preferences.json'); }
 let claudeSettings = {};
 // SSR theme 注入自检状态：模板缺 data-theme 时仅首次 warn（避免高 QPS 刷屏）
 let _ssrThemeAttrWarned = false;
+let _indexHtmlCache = null; // { html: string, mtime: number }
 try {
   const settingsPath = join(getClaudeConfigDir(), 'settings.json');
   if (existsSync(settingsPath)) {
@@ -156,14 +162,13 @@ const ASK_HOOK_TIMEOUT_MS = ASK_TIMEOUT_MS;
 // 任何 pendingAskHooks.set(...) 后必须调 _persistAskEntry；.delete(...) 后必须调 _persistAskDelete。
 function _persistAskEntry(id, entry) {
   if (!entry || !Array.isArray(entry.questions)) return;
-  // 异步触发：磁盘 IO 不阻塞 ask 主流程（落盘失败不影响业务）
   setImmediate(() => {
-    try { askStoreSetEntry(id, { questions: entry.questions, createdAt: entry.createdAt }); } catch {}
+    askStoreSetEntry(id, { questions: entry.questions, createdAt: entry.createdAt }).catch(() => {});
   });
 }
 function _persistAskDelete(id) {
   setImmediate(() => {
-    try { askStoreDeleteEntry(id); } catch {}
+    askStoreDeleteEntry(id).catch(() => {});
   });
 }
 
@@ -681,16 +686,20 @@ async function handleRequest(req, res) {
     const serveIndexHtml = () => {
       try {
         const indexPath = join(DIST_DIR, 'index.html');
-        let html = readFileSync(indexPath, 'utf-8');
-        let themeColor = 'light';
+        // mtime 缓存：避免每次请求都 readFileSync（Windows Defender 下每次读 5-50ms）
+        let st;
+        try { st = statSync(indexPath); } catch { return false; }
+        if (!_indexHtmlCache || _indexHtmlCache.mtime !== st.mtimeMs) {
+          _indexHtmlCache = { html: readFileSync(indexPath, 'utf-8'), mtime: st.mtimeMs };
+        }
+        let html = _indexHtmlCache.html;
+        let themeColor = process.platform === 'win32' ? 'dark' : 'light';
         try {
           if (existsSync(getPrefsFile())) {
             const prefs = JSON.parse(readFileSync(getPrefsFile(), 'utf-8'));
             if (prefs.themeColor === 'dark' || prefs.themeColor === 'light') themeColor = prefs.themeColor;
           }
-        } catch { /* 读 prefs 失败就走默认 light */ }
-        // 自检：模板里没有 <html ... data-theme="..."> 时 replace 静默 no-op，SSR 优化失效但不报错。
-        // 仅首次 warn 避免高 QPS 刷屏（_ssrThemeAttrWarned 单进程一次性）。
+        } catch {}
         if (!_ssrThemeAttrWarned && !/<html[^>]*data-theme="[^"]*"/.test(html)) {
           _ssrThemeAttrWarned = true;
           console.warn('[serveIndexHtml] dist/index.html 没有 <html data-theme="..."> 属性，SSR theme 注入将不生效。检查 index.html 模板。');
@@ -770,11 +779,11 @@ export async function startViewer() {
   // 内存 Map 不 hydrate：旧 res 已死、新 ask-bridge 重连同 toolUseId 会自动复用槽位
   // （server.js 已有"旧 res 已断 → 复用"分支），无需在这里主动重建内存态。
   // 留下来的 disk 镜像供 /api/pending-asks 端点查询，让浏览器重连后仍能看见 pending 列表。
-  setImmediate(() => { try { askStorePruneStale(ASK_HOOK_TIMEOUT_MS); } catch {} });
+  setImmediate(() => { askStorePruneStale(ASK_HOOK_TIMEOUT_MS).catch(() => {}); });
   // 长跑进程兜底：短轮询路径下 markAnswered 标的终态 entry 若 ask-bridge 已死（GET 不再来 consume），
   // 仅靠启动 prune 永远清不掉。1h 周期触发一次，.unref() 不阻塞进程退出。
   const _pruneAskStoreInterval = setInterval(() => {
-    try { askStorePruneStale(ASK_HOOK_TIMEOUT_MS); } catch {}
+    askStorePruneStale(ASK_HOOK_TIMEOUT_MS).catch(() => {});
   }, 60 * 60 * 1000);
   _pruneAskStoreInterval.unref();
 
@@ -1263,7 +1272,7 @@ async function setupTerminalWebSocket(httpServer) {
               // Phase 3: short-poll 模式不立即删 disk —— 落 answered 让 GET listener / disk consume 拿
               if (askEntry.shortPoll) {
                 let wrote = false;
-                try { wrote = askStoreMarkAnswered(askId, msg.answers); } catch {}
+                try { wrote = await askStoreMarkAnswered(askId, msg.answers); } catch {}
                 if (wrote) {
                   _notifyShortPollAnswer(askId, msg.answers);
                   askAnswered = true;
@@ -1296,7 +1305,7 @@ async function setupTerminalWebSocket(httpServer) {
               // 不唤醒 listener（让 listener 等到 GET hit disk 拿到真实抢答者答案）—— 自然 idempotent。
               // 给当前 ws 发 ack-already-answered 让前端关 modal、不误覆盖灰态。
               let wrote = false;
-              try { wrote = askStoreMarkAnswered(askId, msg.answers); } catch {}
+              try { wrote = await askStoreMarkAnswered(askId, msg.answers); } catch {}
               if (wrote) {
                 _notifyShortPollAnswer(askId, msg.answers);
                 askAnswered = true;
@@ -1406,7 +1415,7 @@ async function setupTerminalWebSocket(httpServer) {
                 pendingAskHooks.delete(cancelId);
                 // Phase 3: short-poll 同样要让 disk + listener 知道，否则 ask-bridge 永远收不到 cancelled
                 if (askEntry.shortPoll) {
-                  try { askStoreMarkCancelled(cancelId, cancelReason); } catch {}
+                  try { await askStoreMarkCancelled(cancelId, cancelReason); } catch {}
                   _notifyShortPollCancel(cancelId, cancelReason);
                 } else {
                   _persistAskDelete(cancelId);
@@ -1424,7 +1433,7 @@ async function setupTerminalWebSocket(httpServer) {
                 // first-wins：disk 已是终态（如另一 client 抢先 answer）时 markCancelled 返 false，
                 // 不能唤醒 listener 用 cancel 覆盖真实 answer —— 让 listener 下次 GET consumeIfFinal
                 // 拿到真实 disk 终态自然投递。
-                const wrote = askStoreMarkCancelled(cancelId, cancelReason);
+                const wrote = await askStoreMarkCancelled(cancelId, cancelReason);
                 if (wrote) {
                   _notifyShortPollCancel(cancelId, cancelReason);
                   handled = true;
@@ -1640,10 +1649,12 @@ const _pendingTurnEndTimers = new Map(); // key: sessionId(string) | null → {
 // 空串 / 非数 / 范围外都回 default + warn 一次。
 const TURN_END_DEBOUNCE_MS = (() => {
   const raw = process.env.CCV_TURN_END_DEBOUNCE_MS;
-  if (raw === undefined || raw === '' || /^\s*$/.test(raw)) return 10_000;
+  // IM worker 需要快速 turn_end 以驱动队列——默认 200ms（够 coalesce 重复 POST，不拖延回复）。
+  const imDefault = process.env.CCV_IM_PLATFORM ? 200 : 10_000;
+  if (raw === undefined || raw === '' || /^\s*$/.test(raw)) return imDefault;
   const n = Number(raw);
-  if (!Number.isFinite(n)) { console.warn(`[turn-end] CCV_TURN_END_DEBOUNCE_MS=${raw} not finite, using 10000`); return 10_000; }
-  if (n < 100 || n > 60_000) { console.warn(`[turn-end] CCV_TURN_END_DEBOUNCE_MS=${n} out of [100,60000], using 10000`); return 10_000; }
+  if (!Number.isFinite(n)) { console.warn(`[turn-end] CCV_TURN_END_DEBOUNCE_MS=${raw} not finite, using ${imDefault}`); return imDefault; }
+  if (n < 100 || n > 60_000) { console.warn(`[turn-end] CCV_TURN_END_DEBOUNCE_MS=${n} out of [100,60000], using ${imDefault}`); return imDefault; }
   return n;
 })();
 let _isStopping = false;
@@ -1819,11 +1830,8 @@ async function _doStop() {
       }
     } catch { }
   }
-  for (const logFile of getWatchedFiles().keys()) {
-    unwatchFile(logFile);
-  }
+  unwatchAll();
   unwatchFile(CONTEXT_WINDOW_FILE);
-  getWatchedFiles().clear();
   clients.forEach(client => client.end());
   // Truncate in place (not `clients = []`) so the array reference stays stable across
   // stop/start cycles — deps.clients and _logWatcherOpts() hold this same reference.

package/server/workspace-registry.js

@@ -1,6 +1,8 @@
 // Workspace Registry - 工作区持久化管理
-import { readFileSync, writeFileSync, existsSync, mkdirSync, statSync, readdirSync, openSync, closeSync, unlinkSync } from 'node:fs';
+import { readFileSync, writeFileSync, existsSync, mkdirSync, unlinkSync } from 'node:fs';
+import { readdir, stat } from 'node:fs/promises';
 import { renameSyncWithRetry } from './lib/file-api.js';
+import { withFileLockAsync } from './lib/async-file-lock.js';
 import { join, basename, resolve } from 'node:path';
 import { randomBytes } from 'node:crypto';
 import { LOG_DIR } from '../findcc.js';
@@ -9,51 +11,6 @@ import { LOG_DIR } from '../findcc.js';
 function getWorkspacesFile() { return join(LOG_DIR, 'workspaces.json'); }
 function getLockFile() { return join(LOG_DIR, 'workspaces.lock'); }
 
-function sleep(ms) {
-  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
-}
-
-function withLock(fn) {
-  mkdirSync(LOG_DIR, { recursive: true });
-  const deadline = Date.now() + 2000;
-  // 如果锁文件超过 5 秒未更新，认为它是死锁（前一个进程崩溃）
-  const STALE_THRESHOLD = 5000;
-
-  while (true) {
-    try {
-      const fd = openSync(getLockFile(), 'wx');
-      closeSync(fd);
-      break;
-    } catch (err) {
-      if (err?.code === 'EEXIST') {
-        if (Date.now() < deadline) {
-          // 检查是否为陈旧锁
-          try {
-            const stats = statSync(getLockFile());
-            if (Date.now() - stats.mtimeMs > STALE_THRESHOLD) {
-              // 尝试强制移除锁
-              try { unlinkSync(getLockFile()); } catch { }
-              // 立即重试获取
-              continue;
-            }
-          } catch {
-            // stat 失败可能意味着锁刚被释放，继续循环尝试获取
-          }
-          sleep(25);
-          continue;
-        }
-      }
-      throw err;
-    }
-  }
-
-  try {
-    return fn();
-  } finally {
-    try { unlinkSync(getLockFile()); } catch { }
-  }
-}
-
 export function loadWorkspaces() {
   try {
     if (!existsSync(getWorkspacesFile())) return [];
@@ -69,7 +26,7 @@ export function saveWorkspaces(list) {
   try {
     mkdirSync(LOG_DIR, { recursive: true });
     writeFileSync(tmpFile, JSON.stringify({ workspaces: list }, null, 2));
-    
+
     // Windows 上 renameSync 可能会因为目标文件存在或被占用而失败。统一走 server/lib/file-api.js
     // renameSyncWithRetry helper（同款重试策略，跟 interceptor / log-management 一致）。
     renameSyncWithRetry(tmpFile, getWorkspacesFile());
@@ -87,8 +44,8 @@ function _invalidatePolicyCache() {
     .catch(() => { /* policy 模块可能在某些 entry 下未加载,无副作用即可 */ });
 }
 
-export function registerWorkspace(absolutePath) {
-  const result = withLock(() => {
+export async function registerWorkspace(absolutePath) {
+  const result = await withFileLockAsync(getLockFile(), () => {
     const resolvedPath = resolve(absolutePath);
     const projectName = basename(resolvedPath).replace(/[^a-zA-Z0-9_\-\.]/g, '_');
     const list = loadWorkspaces();
@@ -113,13 +70,13 @@ export function registerWorkspace(absolutePath) {
     list.push(entry);
     saveWorkspaces(list);
     return entry;
-  });
+  }, { ensureDir: LOG_DIR });
   _invalidatePolicyCache();
   return result;
 }
 
-export function removeWorkspace(id) {
-  const result = withLock(() => {
+export async function removeWorkspace(id) {
+  const result = await withFileLockAsync(getLockFile(), () => {
     const list = loadWorkspaces();
     const filtered = list.filter(w => w.id !== id);
     if (filtered.length !== list.length) {
@@ -127,30 +84,27 @@ export function removeWorkspace(id) {
       return true;
     }
     return false;
-  });
+  }, { ensureDir: LOG_DIR });
   if (result) _invalidatePolicyCache();
   return result;
 }
 
-export function getWorkspaces() {
+export async function getWorkspaces() {
   const list = loadWorkspaces();
-  return list
-    .map(w => {
-      let logCount = 0;
-      let totalSize = 0;
-      const logDir = join(LOG_DIR, w.projectName);
-      try {
-        if (existsSync(logDir)) {
-          const files = readdirSync(logDir);
-          for (const f of files) {
-            if (f.endsWith('.jsonl')) {
-              logCount++;
-              try { totalSize += statSync(join(logDir, f)).size; } catch { }
-            }
-          }
+  const enriched = await Promise.all(list.map(async (w) => {
+    let logCount = 0;
+    let totalSize = 0;
+    const logDir = join(LOG_DIR, w.projectName);
+    try {
+      const files = await readdir(logDir);
+      for (const f of files) {
+        if (f.endsWith('.jsonl')) {
+          logCount++;
+          try { totalSize += (await stat(join(logDir, f))).size; } catch { }
         }
-      } catch { }
-      return { ...w, logCount, totalSize };
-    })
-    .sort((a, b) => new Date(b.lastUsed) - new Date(a.lastUsed));
+      }
+    } catch { }
+    return { ...w, logCount, totalSize };
+  }));
+  return enriched.sort((a, b) => new Date(b.lastUsed) - new Date(a.lastUsed));
 }