coding-tool-x 3.7.3 → 3.7.5

package/src/server/api/opencode-projects.js

@@ -1,11 +1,17 @@
 const express = require('express');
 const router = express.Router();
 const {
-  getProjects,
   saveProjectOrder,
   deleteProject,
   isOpenCodeInstalled
 } = require('../services/opencode-sessions');
+const {
+  emptyProjectList,
+  getProjectListSnapshot,
+  invalidateProjectSnapshots
+} = require('../services/project-snapshots');
+const { invalidateSessionSnapshots } = require('../services/session-snapshots');
+const { runDashboardSnapshotWorker } = require('../services/dashboard-snapshot-worker');
 
 function isNotFoundError(error) {
   return !!(error && error.message === 'Project not found');
@@ -16,22 +22,24 @@ module.exports = (config) => {
    * GET /api/opencode/projects
    * 获取所有 OpenCode 项目列表
    */
-  router.get('/', (req, res) => {
+  router.get('/', async (req, res) => {
     try {
       if (!isOpenCodeInstalled()) {
         return res.json({
           projects: [],
           currentProject: null,
-          error: 'OpenCode CLI not installed or not found'
+          error: 'OpenCode CLI not installed or not found',
+          meta: { generatedAt: new Date().toISOString(), stale: false, refreshing: false, fallback: true, error: null }
         });
       }
 
-      const projects = getProjects();
-
-      res.json({
-        projects,
-        currentProject: projects[0] ? projects[0].name : null
+      const force = req.query?.fresh === '1';
+      const snapshot = await getProjectListSnapshot('opencode', {
+        fallbackValue: emptyProjectList(null),
+        force,
+        refresh: () => runDashboardSnapshotWorker('projects', 'opencode', config, { force })
       });
+      res.json({ ...snapshot.value, meta: snapshot.meta });
     } catch (err) {
       console.error('[OpenCode API] Failed to get projects:', err);
 
@@ -65,6 +73,7 @@ module.exports = (config) => {
       }
 
       saveProjectOrder(order);
+      invalidateProjectSnapshots('opencode');
       res.json({ success: true });
     } catch (err) {
       console.error('[OpenCode API] Failed to save project order:', err);
@@ -84,6 +93,8 @@ module.exports = (config) => {
 
       const { projectName } = req.params;
       const result = deleteProject(projectName);
+      invalidateProjectSnapshots('opencode');
+      invalidateSessionSnapshots('opencode', projectName);
       res.json(result);
     } catch (err) {
       if (isNotFoundError(err)) {

package/src/server/api/opencode-sessions.js

@@ -15,6 +15,14 @@ const {
 const { loadAliases } = require('../services/alias');
 const { broadcastLog } = require('../websocket-server');
 const { HOME_DIR } = require('../../config/paths');
+const {
+  defaultProjectInfo,
+  emptySessionList,
+  getSessionListSnapshot,
+  invalidateSessionSnapshots,
+  runSessionSnapshotWorker
+} = require('../services/session-snapshots');
+const { invalidateProjectSnapshots } = require('../services/project-snapshots');
 
 function isNotFoundError(error) {
   if (!error || !error.message) {
@@ -117,34 +125,23 @@ module.exports = (config) => {
    * GET /api/opencode/sessions/:projectName
    * 获取项目的所有会话
    */
-  router.get('/:projectName', (req, res) => {
+  router.get('/:projectName', async (req, res) => {
     try {
       if (!isOpenCodeInstalled()) {
         return res.status(404).json({ error: 'OpenCode CLI not installed' });
       }
 
       const { projectName } = req.params;
-      const sessions = getSessionsByProject(projectName);
-      const aliases = loadAliases();
-      const projects = getProjects();
-      const project = projects.find(p => p.name === projectName);
-
-      // 计算总大小
-      const totalSize = sessions.reduce((sum, session) => {
-        return sum + (session.size || 0);
-      }, 0);
-
-      res.json({
-        sessions,
-        totalSize,
-        aliases,
-        projectInfo: {
-          name: projectName,
-          fullPath: project?.fullPath || projectName,
-          path: project?.path || projectName,
-          displayName: project?.displayName || projectName
-        }
+      const force = req.query?.fresh === '1';
+      const snapshot = await getSessionListSnapshot('opencode', projectName, {
+        fallbackValue: emptySessionList(projectName, {
+          aliases: loadAliases(),
+          projectInfo: defaultProjectInfo(projectName)
+        }),
+        force,
+        refresh: () => runSessionSnapshotWorker('opencode', projectName, {}, { force })
       });
+      res.json({ ...snapshot.value, meta: snapshot.meta });
     } catch (err) {
       console.error('[OpenCode API] Failed to get sessions:', err);
       res.status(500).json({ error: err.message });
@@ -294,6 +291,8 @@ module.exports = (config) => {
 
       const { sessionId } = req.params;
       const result = deleteSession(sessionId);
+      invalidateSessionSnapshots('opencode', req.params.projectName);
+      invalidateProjectSnapshots('opencode');
 
       res.json(result);
     } catch (err) {
@@ -347,6 +346,11 @@ module.exports = (config) => {
         }
       });
 
+      if (deletedSessionIds.length > 0) {
+        invalidateSessionSnapshots('opencode', req.params.projectName);
+        invalidateProjectSnapshots('opencode');
+      }
+
       res.json({
         success: failed.length === 0,
         requestedCount: uniqueSessionIds.length,
@@ -372,6 +376,8 @@ module.exports = (config) => {
 
       const { sessionId } = req.params;
       const result = forkSession(sessionId);
+      invalidateSessionSnapshots('opencode', req.params.projectName);
+      invalidateProjectSnapshots('opencode');
       res.json(result);
     } catch (err) {
       if (isNotFoundError(err)) {
@@ -401,6 +407,7 @@ module.exports = (config) => {
       }
 
       saveSessionOrder(projectName, order);
+      invalidateSessionSnapshots('opencode', projectName);
       res.json({ success: true });
     } catch (err) {
       console.error('[OpenCode API] Failed to save session order:', err);

package/src/server/api/projects.js

@@ -1,33 +1,25 @@
 const express = require('express');
 const router = express.Router();
-const { getProjectsWithStats, saveProjectOrder, getProjectOrder, deleteProject } = require('../services/sessions');
+const { saveProjectOrder, deleteProject } = require('../services/sessions');
+const {
+  emptyProjectList,
+  getProjectListSnapshot,
+  invalidateProjectSnapshots
+} = require('../services/project-snapshots');
+const { invalidateSessionSnapshots } = require('../services/session-snapshots');
+const { runDashboardSnapshotWorker } = require('../services/dashboard-snapshot-worker');
 
 module.exports = (config) => {
   // GET /api/projects - Get all projects with stats
   router.get('/', async (req, res) => {
     try {
-      const projects = await getProjectsWithStats(config);
-      const order = getProjectOrder(config);
-
-      // Sort projects by saved order
-      let sortedProjects = projects;
-      if (order && order.length > 0) {
-        const orderMap = new Map(order.map((name, idx) => [name, idx]));
-        sortedProjects = [...projects].sort((a, b) => {
-          const aIdx = orderMap.has(a.name) ? orderMap.get(a.name) : 999999;
-          const bIdx = orderMap.has(b.name) ? orderMap.get(b.name) : 999999;
-          if (aIdx === bIdx) {
-            // Both are new, sort by lastUsed
-            return (b.lastUsed || 0) - (a.lastUsed || 0);
-          }
-          return aIdx - bIdx;
-        });
-      }
-
-      res.json({
-        projects: sortedProjects,
-        currentProject: config.currentProject || (sortedProjects[0] ? sortedProjects[0].name : null)
+      const force = req.query?.fresh === '1';
+      const snapshot = await getProjectListSnapshot('claude', {
+        fallbackValue: emptyProjectList(config.currentProject || null),
+        force,
+        refresh: () => runDashboardSnapshotWorker('projects', 'claude', config, { force })
       });
+      res.json({ ...snapshot.value, meta: snapshot.meta });
     } catch (error) {
       console.error('Error fetching projects:', error);
       res.status(500).json({ error: error.message });
@@ -42,6 +34,7 @@ module.exports = (config) => {
         return res.status(400).json({ error: 'Order must be an array' });
       }
       saveProjectOrder(config, order);
+      invalidateProjectSnapshots('claude');
       res.json({ success: true });
     } catch (error) {
       console.error('Error saving project order:', error);
@@ -96,6 +89,7 @@ module.exports = (config) => {
         'utf8'
       );
 
+      invalidateProjectSnapshots('claude');
       res.json({
         success: true,
         projectName,
@@ -113,6 +107,8 @@ module.exports = (config) => {
     try {
       const { projectName } = req.params;
       deleteProject(config, projectName);
+      invalidateProjectSnapshots('claude');
+      invalidateSessionSnapshots('claude', projectName);
       res.json({ success: true });
     } catch (error) {
       console.error('Error deleting project:', error);

package/src/server/api/sessions.js

@@ -3,10 +3,18 @@ const router = express.Router();
 const path = require('path');
 const fs = require('fs');
 const readline = require('readline');
-const { getSessionsForProject, deleteSession, forkSession, saveSessionOrder, parseRealProjectPath, searchSessions, getRecentSessions, searchSessionsAcrossProjects, hasActualMessages } = require('../services/sessions');
+const { deleteSession, forkSession, saveSessionOrder, parseRealProjectPath, searchSessions, getRecentSessions, searchSessionsAcrossProjects, hasActualMessages } = require('../services/sessions');
 const { loadAliases } = require('../services/alias');
 const { broadcastLog } = require('../websocket-server');
 const { NATIVE_PATHS } = require('../../config/paths');
+const {
+  defaultProjectInfo,
+  emptySessionList,
+  getSessionListSnapshot,
+  invalidateSessionSnapshots,
+  runSessionSnapshotWorker
+} = require('../services/session-snapshots');
+const { invalidateProjectSnapshots } = require('../services/project-snapshots');
 const CLAUDE_PROJECTS_DIR = NATIVE_PATHS.claude.projects;
 
 function resolveClaudeSessionFile(projectName, sessionId, fullPath) {
@@ -158,22 +166,16 @@ module.exports = (config) => {
   router.get('/:projectName', async (req, res) => {
     try {
       const { projectName } = req.params;
-      const result = await getSessionsForProject(config, projectName);
-      const aliases = loadAliases();
-
-      // Parse project path info
-      const { fullPath, projectName: displayName } = parseRealProjectPath(projectName);
-
-      res.json({
-        sessions: result.sessions,
-        totalSize: result.totalSize,
-        aliases,
-        projectInfo: {
-          name: projectName,
-          displayName,
-          fullPath
-        }
+      const force = req.query?.fresh === '1';
+      const snapshot = await getSessionListSnapshot('claude', projectName, {
+        fallbackValue: emptySessionList(projectName, {
+          aliases: loadAliases(),
+          projectInfo: defaultProjectInfo(projectName)
+        }),
+        force,
+        refresh: () => runSessionSnapshotWorker('claude', projectName, config, { force })
       });
+      res.json({ ...snapshot.value, meta: snapshot.meta });
     } catch (error) {
       console.error('Error fetching sessions:', error);
       res.status(500).json({ error: error.message });
@@ -185,6 +187,8 @@ module.exports = (config) => {
     try {
       const { projectName, sessionId } = req.params;
       const result = deleteSession(config, projectName, sessionId);
+      invalidateSessionSnapshots('claude', projectName);
+      invalidateProjectSnapshots('claude');
       res.json(result);
     } catch (error) {
       console.error('Error deleting session:', error);
@@ -228,6 +232,11 @@ module.exports = (config) => {
         }
       });
 
+      if (deletedSessionIds.length > 0) {
+        invalidateSessionSnapshots('claude', projectName);
+        invalidateProjectSnapshots('claude');
+      }
+
       res.json({
         success: failed.length === 0,
         requestedCount: uniqueSessionIds.length,
@@ -246,6 +255,8 @@ module.exports = (config) => {
     try {
       const { projectName, sessionId } = req.params;
       const result = forkSession(config, projectName, sessionId, normalizeForkOptions(req.body));
+      invalidateSessionSnapshots('claude', projectName);
+      invalidateProjectSnapshots('claude');
       res.json(result);
     } catch (error) {
       console.error('Error forking session:', error);
@@ -330,6 +341,10 @@ module.exports = (config) => {
         timestamp: Date.now()
       });
 
+      const snapshotSource = toolType === 'codex' || toolType === 'gemini' ? toolType : 'claude';
+      invalidateSessionSnapshots(snapshotSource, projectName);
+      invalidateProjectSnapshots(snapshotSource);
+
       res.json({
         success: true,
         sessionId: newSessionId,
@@ -352,6 +367,7 @@ module.exports = (config) => {
         return res.status(400).json({ error: 'order must be an array' });
       }
       saveSessionOrder(projectName, order);
+      invalidateSessionSnapshots('claude', projectName);
       res.json({ success: true });
     } catch (error) {
       console.error('Error saving session order:', error);

package/src/server/services/channel-balance.js

@@ -6,6 +6,11 @@ const path = require('path');
 const { URL } = require('url');
 const { PATHS } = require('../../config/paths');
 const { loadUIConfig } = require('./ui-config');
+const {
+  getSnapshot,
+  refreshSnapshot,
+  invalidateSnapshot
+} = require('./snapshot-cache');
 
 const CACHE_TTL_MS = 5 * 60 * 1000;
 const REQUEST_TIMEOUT_MS = 8000;
@@ -1489,6 +1494,14 @@ function buildCacheKey(source, channel) {
   ].join(':');
 }
 
+function buildBalanceSnapshotKey(source, channel) {
+  return `channel-balances:${buildCacheKey(source, channel)}`;
+}
+
+function makeFallbackBalanceSnapshot(currentTime = Date.now()) {
+  return makeHiddenSnapshot(null, { stale: true, updatedAt: nowIso(currentTime) });
+}
+
 async function refreshChannelBalanceSnapshot(source, channel, options = {}) {
   const force = options.force === true;
   const currentTime = options.now || Date.now();
@@ -1588,6 +1601,7 @@ function clearChannelBalanceCache(source, channel) {
   let strategyChanged = false;
 
   balanceCache.delete(exactKey);
+  invalidateSnapshot(`channel-balances:${exactKey}`);
   for (const key of Array.from(balanceCache.keys())) {
     if (key.startsWith(prefix)) {
       balanceCache.delete(key);
@@ -1665,19 +1679,45 @@ async function mapWithConcurrency(items, limit, worker) {
 async function getChannelBalances(source, options = {}) {
   const normalizedSource = validateSource(source);
   if (!isBalanceDisplayEnabled()) {
-    return { enabled: false, source: normalizedSource, balances: {} };
+    return {
+      enabled: false,
+      source: normalizedSource,
+      balances: {},
+      refreshing: false,
+      updatedAt: null,
+      stale: false
+    };
   }
 
   const channels = getEnabledBalanceChannels(normalizedSource);
+  const currentTime = options.now || Date.now();
   const entries = await mapWithConcurrency(channels, 4, async (channel) => {
-    const snapshot = await refreshChannelBalanceSnapshot(normalizedSource, channel, options);
-    return [channel.id, snapshot];
+    const snapshot = await getSnapshot(buildBalanceSnapshotKey(normalizedSource, channel), {
+      ttlMs: CACHE_TTL_MS,
+      fallbackValue: makeFallbackBalanceSnapshot(currentTime),
+      refresh: () => refreshChannelBalanceSnapshot(normalizedSource, channel, { ...options, force: true, now: Date.now() })
+    });
+    const value = {
+      ...snapshot.value,
+      stale: Boolean(snapshot.value?.stale || snapshot.meta.stale)
+    };
+    return [channel.id, value, snapshot.meta];
   });
 
+  const metas = entries.map((entry) => entry[2]).filter(Boolean);
+  const updatedAt = metas
+    .map(meta => meta.generatedAt)
+    .filter(Boolean)
+    .sort()
+    .pop() || null;
+
   return {
     enabled: true,
     source: normalizedSource,
-    balances: Object.fromEntries(entries.filter(([id]) => id))
+    balances: Object.fromEntries(entries.filter(([id]) => id).map(([id, snapshot]) => [id, snapshot])),
+    refreshing: metas.some(meta => meta.refreshing),
+    updatedAt,
+    stale: metas.some(meta => meta.stale)
   };
 }
 
@@ -1695,7 +1735,12 @@ async function refreshChannelBalance(source, channelId) {
     throw error;
   }
 
-  const balance = await refreshChannelBalanceSnapshot(normalizedSource, channel, { force: true });
+  const entry = await refreshSnapshot(
+    buildBalanceSnapshotKey(normalizedSource, channel),
+    () => refreshChannelBalanceSnapshot(normalizedSource, channel, { force: true }),
+    { bypassInflight: true }
+  );
+  const balance = entry.value;
   return {
     enabled: true,
     source: normalizedSource,
@@ -1707,6 +1752,7 @@ async function refreshChannelBalance(source, channelId) {
 function clearBalanceCache() {
   balanceCache.clear();
   balanceStrategyCache.clear();
+  invalidateSnapshot('channel-balances:');
   strategyCacheLoaded = false;
 }
 
@@ -1739,6 +1785,7 @@ module.exports = {
     build88CodeSubscriptionSnapshot,
     buildNewCliDashboardSnapshot,
     buildBalanceProbeStrategies,
+    buildBalanceSnapshotKey,
     getEnabledBalanceChannels,
     runBalanceStrategy,
     refreshChannelBalanceSnapshot,

package/src/server/services/codex-sessions.js

@@ -227,10 +227,14 @@ function normalizeSession(codexSession) {
  * 聚合项目列表
  * @returns {Array} 项目对象数组
  */
-function getProjects() {
-  const cached = globalCache.get(CODEX_PROJECTS_CACHE_KEY);
-  if (cached) {
-    return cached;
+function getProjects(options = {}) {
+  if (options.force) {
+    invalidateCodexSessionCaches();
+  } else {
+    const cached = globalCache.get(CODEX_PROJECTS_CACHE_KEY);
+    if (cached) {
+      return cached;
+    }
   }
 
   const sessions = getAllSessions();
@@ -302,11 +306,15 @@ function getProjects() {
  * @param {string} projectName - 项目名称
  * @returns {Array} 归一化的会话数组
  */
-function getSessionsByProject(projectName) {
+function getSessionsByProject(projectName, options = {}) {
   const cacheKey = getCodexSessionsCacheKey(projectName);
-  const cached = globalCache.get(cacheKey);
-  if (cached) {
-    return cached;
+  if (options.force) {
+    invalidateCodexSessionCaches({ projectName });
+  } else {
+    const cached = globalCache.get(cacheKey);
+    if (cached) {
+      return cached;
+    }
   }
 
   const sessions = getAllSessions();
@@ -975,9 +983,14 @@ function calculateProjectAndSessionCounts() {
 /**
  * 获取 Codex 项目与会话数量（用于仪表盘轻量统计）
  */
-function getProjectAndSessionCounts() {
+function getProjectAndSessionCounts(options = {}) {
   const now = Date.now();
-  if (countsCache.expiresAt > now) {
+  if (options.force) {
+    countsCache.expiresAt = 0;
+    scanFilesCache.expiresAt = 0;
+    sessionFileIndexCache.expiresAt = 0;
+  }
+  if (!options.force && countsCache.expiresAt > now) {
     return countsCache.value;
   }