zcode-pro 1.2.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zcode-pro",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "ZCode Pro — 为 ZCode 桌面版增加界面增强（不修改客户端文件，通过 ZCode Pro 快捷方式启动即可），核心功能：项目自定义别名",
   "type": "module",
   "bin": {

package/src/host/helper.mjs

@@ -11,13 +11,13 @@ import { basename, delimiter, dirname, isAbsolute, join, resolve, sep } from 'no
 import { homedir, tmpdir, userInfo } from 'node:os';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { readSettings, writeSettingsAtomic, remapSettingsPaths, isProjectOpenInTabs } from './settings.mjs';
-import { taskIndexPath, probeTaskIndexWritable, remapTaskIndexPaths, taskIndexDriverAvailable, listOverriddenTitles, listTaskWorkspaceMap, setTaskTitleIfNotOverridden, setCustomSessionTitle, isTaskTitleOverridden, reconcileCustomTitles, getTaskProviderModel, listVirtualProjects } from './taskIndex.mjs';
+import { taskIndexPath, probeTaskIndexWritable, remapTaskIndexPaths, taskIndexDriverAvailable, listOverriddenTitles, listTaskWorkspaceMap, setTaskTitleIfNotOverridden, setCustomSessionTitle, isTaskTitleOverridden, reconcileCustomTitles, getTaskProviderModel, listVirtualProjects, countTasks } from './taskIndex.mjs';
 import { pickFolderSystem } from './pickFolder.mjs';
 import { reorderWorkspaceTasks, reorderGroupMembers } from './taskOrder.mjs';
 import { webdavRequest, webdavPutWithMkcol, webdavHttpText, parseWebdavListing, findCurl } from './webdav.mjs';
 import { resolveZcodeExecutable } from './paths.mjs';
 
-const VERSION = '1.2.0';
+const VERSION = '1.3.0';
 
 // 全局提示词固定在用户主目录：官方加载器按 HOME/USERPROFILE 拼 .zcode/AGENTS.md，
 // 不读 ZCODE_DATA_BASE_DIR（数据根迁走时全局指令仍在原位）。
@@ -348,6 +348,35 @@ export function startHelper({ port, token, dataRoot, state, agentsFile = default
           }
           current.shortcuts = { ...(current.shortcuts || {}), ...patch };
         }
+        // 状态栏统计（设置 → 样式 → 状态栏）：items（任务统计项）与
+        // turnItems（每轮统计项）两个清单各自整表覆盖，谁在请求里就更新谁；
+        // id 白名单 + 去重保序，未知项丢弃
+        if (body && typeof body === 'object' && body.statusBar && typeof body.statusBar === 'object') {
+          const next = { ...(current.statusBar || {}) };
+          if (Array.isArray(body.statusBar.items)) {
+            const valid = new Set(['ctx', 'questions', 'todayTokens', 'totalTokens', 'tasks']);
+            const seen = new Set();
+            const items = [];
+            for (const it of body.statusBar.items) {
+              if (!it || !valid.has(it.id) || seen.has(it.id)) continue;
+              seen.add(it.id);
+              items.push({ id: it.id, on: it.on !== false });
+            }
+            next.items = items;
+          }
+          if (Array.isArray(body.statusBar.turnItems)) {
+            const turnValid = new Set(['turnIn', 'turnOut', 'turnCache']);
+            const tseen = new Set();
+            const turnItems = [];
+            for (const it of body.statusBar.turnItems) {
+              if (!it || !turnValid.has(it.id) || tseen.has(it.id)) continue;
+              tseen.add(it.id);
+              turnItems.push({ id: it.id, on: it.on !== false });
+            }
+            next.turnItems = turnItems;
+          }
+          current.statusBar = next;
+        }
         if (body && typeof body === 'object' && body.titleGen && typeof body.titleGen === 'object') {
           current.titleGen = mergeTitleGenConfig({ ...current.titleGen, ...body.titleGen });
         }
@@ -611,7 +640,17 @@ export function startHelper({ port, token, dataRoot, state, agentsFile = default
       // —— zcode-vision 插件（图片视觉代理）：设置弹窗“视觉代理”标签页读写 ————
       if (req.method === 'GET' && url.pathname === '/vision') {
         const file = defaultVisionFile();
-        const parsed = readJsonFile(file);
+        let parsed = readJsonFile(file);
+        // 装了 zcode-pro 默认启用识图卡片（插件纯安装默认关，纯文本展示）：
+        // 只补从未写过的配置，用户显式设过 cardUi（含 false）不覆盖
+        if (parsed && typeof parsed === 'object' && !('cardUi' in parsed)) {
+          parsed = { ...parsed, cardUi: true };
+          try {
+            const tmp = file + '.tmp';
+            writeFileSync(tmp, JSON.stringify(parsed, null, 2) + '\n', 'utf-8');
+            renameSync(tmp, file);
+          } catch { /* 补写失败下次再试，不阻塞读取 */ }
+        }
         if (parsed === null && existsSync(file)) {
           json(res, 500, { ok: false, code: 'vision-read', error: 'zcode-vision.json 不是合法 JSON' });
           return;
@@ -628,8 +667,12 @@ export function startHelper({ port, token, dataRoot, state, agentsFile = default
         }
         try {
           const file = defaultVisionFile();
+          // 与磁盘旧配置合并（本块曾两次被并发改动覆盖回全量覆盖）：前端按自己
+          // 的字段重建整份配置，直接覆盖会丢插件新增、面板还不认识的键
+          //（cardSandboxBudget/cardUi/interceptMode 等）
+          const merged = { ...(readJsonFile(file) || {}), ...cfg };
           const tmp = file + '.tmp';
-          writeFileSync(tmp, JSON.stringify(cfg, null, 2) + '\n', 'utf-8');
+          writeFileSync(tmp, JSON.stringify(merged, null, 2) + '\n', 'utf-8');
           renameSync(tmp, file);
         } catch (err2) {
           json(res, 500, { ok: false, code: 'vision-write', error: '写入 zcode-vision.json 失败: ' + (err2?.message || err2) });
@@ -1135,6 +1178,21 @@ export function startHelper({ port, token, dataRoot, state, agentsFile = default
         return;
       }
       // —— zcode-plugins 市场更新：读状态（带 30 分钟节流的市场同步）与执行更新 ————
+      // —— 状态栏统计（status-bar.js）：聚合 ~/.zcode/cli/rollout 的模型调用记录 ————
+      // model-io-*.jsonl 每行一次模型调用，response.usage 有分项 token；成本字段
+      // 官方未落本地，成本类统计项由注入侧按“无数据自动隐藏”处理
+      if (req.method === 'GET' && url.pathname === '/stats/usage') {
+        const sessionId = url.searchParams.get('session') || '';
+        const { global, recentTurns } = collectUsageStats(sessionId);
+        // 任务总数 60 秒缓存：状态栏每 2 秒请求一次，不必每次开关 SQLite
+        if (Date.now() - tasksCountAt > 60_000) {
+          tasksCountAt = Date.now();
+          tasksCountCache = await countTasks(dataRoot);
+        }
+        global.tasks = tasksCountCache;
+        json(res, 200, { ok: true, global, recentTurns });
+        return;
+      }
       if (req.method === 'GET' && url.pathname === '/plugins/status') {
         await ensureZcodePluginsMarketplace();
         // 有更新任务在执行或排队时跳过这里的节流同步（任务本身会同步市场并刷新
@@ -1178,6 +1236,18 @@ export function startHelper({ port, token, dataRoot, state, agentsFile = default
         }
         rejectStarted(err);
       });
+      // 启动即补视觉配置缺省键：装了 zcode-pro ⇒ cardUi=true（识图卡片开，缺省
+      // 才补、显式设过不动，规则同 GET /vision），不必等用户打开视觉设置页
+      try {
+        const vFile = defaultVisionFile();
+        const vParsed = readJsonFile(vFile);
+        if (vParsed && typeof vParsed === 'object' && !('cardUi' in vParsed)) {
+          vParsed.cardUi = true;
+          const vTmp = vFile + '.tmp';
+          writeFileSync(vTmp, JSON.stringify(vParsed, null, 2) + '\n', 'utf-8');
+          renameSync(vTmp, vFile);
+        }
+      } catch { /* 无配置或不可写不影响启动 */ }
       server.listen(port, '127.0.0.1', () => resolveStarted(server));
     };
     tryListen();
@@ -1186,6 +1256,101 @@ export function startHelper({ port, token, dataRoot, state, agentsFile = default
 
 // 市场快照同步节流：helper 进程内 30 分钟最多主动 git pull 一次
 let lastMarketplaceSync = 0;
+let tasksCountAt = 0;
+let tasksCountCache = 0; // 任务总数缓存（/stats/usage 高频轮询，60 秒一刷）
+
+// —— 状态栏统计：rollout 模型调用记录聚合 ————
+// ~/.zcode/cli/rollout/model-io-*.jsonl 每行一次模型调用；usage 字段有两种键风格
+// （协议 camelCase 与原始 snake_case），两种都解析。文件小（个位数、每会话一个），
+// 按 mtime+size 缓存只重读变过的文件；聚合结果含按日分桶（本地时区）供“今日”用
+const usageFileCache = new Map(); // 文件名 → { mtime, size, recs: [{at, in, out, session, model}] }
+function rolloutRecords() {
+  const dir = join(homedir(), '.zcode', 'cli', 'rollout');
+  let names = [];
+  try { names = readdirSync(dir).filter((n) => n.startsWith('model-io-') && n.endsWith('.jsonl')); } catch { return []; }
+  const recs = [];
+  for (const name of names) {
+    const full = join(dir, name);
+    let st;
+    try { st = statSync(full); } catch { continue; }
+    const cached = usageFileCache.get(name);
+    if (cached && cached.mtime === st.mtimeMs && cached.size === st.size) {
+      recs.push(...cached.recs);
+      continue;
+    }
+    const parsed = [];
+    try {
+      for (const line of readFileSync(full, 'utf8').split('\n')) {
+        if (!line.trim()) continue;
+        let d;
+        try { d = JSON.parse(line); } catch { continue; }
+        const u = (d.response && d.response.usage) || d.usage;
+        if (!u) continue;
+        const num = (v) => Number(v) || 0;
+        // 两种键风格语义相反，必须分开处理：
+        // 协议格式（inputTokens）的总输入已含缓存读（官方 summary 证实）；
+        // 原始 API 格式（input_tokens，Anthropic 语义）三个字段分开、需相加
+        let input, cacheRead, cacheWrite;
+        if (u.inputTokens != null) {
+          input = num(u.inputTokens);
+          cacheRead = num(u.cacheReadTokens);
+          cacheWrite = num(u.cacheWriteTokens);
+        } else {
+          cacheRead = num(u.cache_read_input_tokens);
+          cacheWrite = num(u.cache_write_input_tokens);
+          input = num(u.input_tokens) + cacheRead + cacheWrite;
+        }
+        const output = num(u.outputTokens ?? u.output_tokens);
+        parsed.push({
+          at: d.completedAt || d.startedAt || '',
+          in: input, out: output,
+          cacheRead,
+          session: String(d.sessionId || ''),
+        });
+      }
+    } catch { /* 文件读失败跳过 */ }
+    usageFileCache.set(name, { mtime: st.mtimeMs, size: st.size, recs: parsed });
+    recs.push(...parsed);
+  }
+  return recs;
+}
+
+function collectUsageStats(sessionId) {
+  const recs = rolloutRecords();
+  const today = new Date();
+  const todayKey = `${today.getFullYear()}-${String(today.getMonth() + 1).padStart(2, '0')}-${String(today.getDate()).padStart(2, '0')}`;
+  const global = { todayTokens: 0, todayOut: 0, totalTokens: 0, totalOut: 0, tasks: 0, records: recs.length };
+  // 每轮用量按本地 HH:mm 分桶（回答末尾的显示时间与之匹配）；
+  // 本地记录只留最近几轮，注入侧只给能对上时间的回答显示
+  const byMinute = new Map();
+  for (const r of recs) {
+    const total = r.in + r.out;
+    global.totalTokens += total;
+    global.totalOut += r.out;
+    const day = String(r.at || '').slice(0, 10);
+    if (day === todayKey) { global.todayTokens += total; global.todayOut += r.out; }
+    // 每轮回答只统计主对话流的调用：起名等辅助请求是独立小上下文、
+    // 缓存从零开始，混进分钟桶会把命中率拉到个位数（全局统计仍全量计入）
+    if (total < 5000) continue;
+    // 指定会话时每轮桶只算该会话的调用——否则切到别的会话聊天后，
+    // 那些调用会被区间归属算进当前会话最后一行的头上
+    if (sessionId && r.session !== sessionId) continue;
+    const t = Date.parse(r.at);
+    if (!Number.isFinite(t)) continue;
+    const d = new Date(t);
+    // 键带日期（月-日 时:分）：注入侧按回答行的时间文本（今天/昨天/10-21 三种
+    // 形态）解析出同款键精确绑定，数值不随记录滚动移位
+    const hm = (d.getMonth() + 1) + '-' + d.getDate() + ' ' + String(d.getHours()).padStart(2, '0') + ':' + String(d.getMinutes()).padStart(2, '0');
+    const bucket = byMinute.get(hm) || { hm, in: 0, out: 0, cacheRead: 0, ts: t };
+    bucket.in += r.in;
+    bucket.out += r.out;
+    bucket.cacheRead += r.cacheRead;
+    bucket.ts = Math.max(bucket.ts, t);
+    byMinute.set(hm, bucket);
+  }
+  const recentTurns = [...byMinute.values()].sort((a, b) => b.ts - a.ts).slice(0, 60);
+  return { global, recentTurns };
+}
 
 function readJsonFile(p) {
   try {
@@ -1664,8 +1829,12 @@ export function mergeAliases(localRaw, remoteRaw) {
 function applyFeaturesPartial(base, partial) {
   const out = (base && typeof base === 'object') ? base : {};
   if (!partial || typeof partial !== 'object') return out;
-  for (const key of Object.keys(defaultConfig().features)) {
+  const known = new Set(Object.keys(defaultConfig().features));
+  for (const key of Object.keys(partial)) {
+    // 布尔特性一律可存（新特性未列入 defaultConfig 时不能被丢弃），
+    // 非布尔值只在已知键内接受
     if (typeof partial[key] === 'boolean') out[key] = partial[key];
+    else if (known.has(key)) out[key] = partial[key];
   }
   return out;
 }
@@ -2402,6 +2571,11 @@ export function validateVisionConfig(raw) {
     skipMinutes: clampInt(raw.skipMinutes, 1, 10080, 30),
     // 主模型能看图时是否也拦截识别（false = 跳过；flash 主模型始终不触发，见插件）
     forceIntercept: raw.forceIntercept !== false,
+    // 识图卡片展示：只在调用方显式给值时透传（面板开关用）；缺省不写键，
+    // 让 POST 的磁盘合并保留原值（zcode-pro 装机缺省 true 的补键逻辑见 GET /vision）
+    ...(raw.cardUi !== undefined ? { cardUi: raw.cardUi === true } : {}),
+    // interceptMode（tool/inject）同 cardUi：显式给值才透传，缺省保持磁盘原值
+    ...(raw.interceptMode !== undefined && ['tool', 'inject'].includes(raw.interceptMode) ? { interceptMode: raw.interceptMode } : {}),
   };
   const names = new Set();
   for (const p of raw.proxies) {

package/src/host/taskIndex.mjs

@@ -270,6 +270,24 @@ export async function listTaskStatuses(dataRoot, ids) {
 }
 
 // 已重命名会话的标题表：task_id → title（title_overridden = 1 且未删除）。
+// 状态栏统计用：任务总数（未删除的会话行）
+export async function countTasks(dataRoot) {
+  const dbFile = taskIndexPath(dataRoot);
+  if (!existsSync(dbFile)) return 0;
+  const driver = await loadDriver();
+  if (!driver) return 0;
+  const sql = 'SELECT COUNT(*) AS n FROM tasks WHERE deleted = 0';
+  try {
+    if (driver.kind === 'node') {
+      const db = new driver.DatabaseSync(dbFile, { readOnly: true });
+      try { return Number(db.prepare(sql).get()?.n) || 0; } finally { db.close(); }
+    }
+    return Number(runCli(dbFile, sql + ';').stdout.trim()) || 0;
+  } catch {
+    return 0;
+  }
+}
+
 // 只读单条 SELECT，不开事务；库不存在或没有 SQLite 支持时返回空表，
 // 调用方（会话名锁定）自然降级为不干预。
 export async function listOverriddenTitles(dataRoot) {

package/src/inject/core.js

@@ -48,6 +48,28 @@ export const DEFAULT_SHORTCUTS = {
   switchAttention: 'r',  // 打开运行中 / 未查看
 };
 
+// 状态栏任务统计项的两个组：会话级跟随当前会话，全局级始终显示；
+// 设置里两节各自排序，保存时归一化为会话组在前（状态栏两组间一道竖线）
+export const STATUS_SESSION_IDS = new Set(['ctx', 'sessionCost', 'questions']);
+export const STATUS_GLOBAL_IDS = new Set(['todayTokens', 'todayCost', 'totalTokens', 'totalCost', 'tasks']);
+
+// 状态栏统计项的默认清单（顺序即默认显示顺序）；设置 → 样式 → 状态栏里
+// 可调顺序与显隐，配置存在 config.statusBar.items（整表覆盖）
+// 每轮回答统计项（turn-usage.js）：回答末尾标注的三段，各自可显隐（顺序固定）
+export const DEFAULT_TURN_ITEMS = [
+  { id: 'turnIn', on: true },      // 输入
+  { id: 'turnOut', on: true },     // 输出
+  { id: 'turnCache', on: true },   // 缓存命中率
+];
+
+export const DEFAULT_STATUS_ITEMS = [
+  { id: 'ctx', on: true },            // 上下文占用
+  { id: 'questions', on: true },     // 提问次数
+  { id: 'todayTokens', on: true },    // 今日 token（今天的会话记录完整，数据准确）
+  { id: 'totalTokens', on: true },    // 累计 token（官方使用统计，全历史）
+  { id: 'tasks', on: true },         // 任务总数
+];
+
 // —— ZCode 版本判断（按官方版本启用/停用功能）——
 // 版本来源：启动器从 app.asar 读出后写进 bootstrap（window.__ZCODEPRO__.zcodeVersion），
 // helper 的 /config 响应也附加同名字段。读不到时为空串，各判断保持旧行为。
@@ -245,6 +267,11 @@ const zh = {
   tbPluginStore: '插件市场',
   featurePinnedCollapse: '已置顶分区可折叠',
   featurePinnedCollapseDesc: '侧边栏“已置顶”标题可点击折叠/展开其任务列表（与“项目”“分组”分区一致），状态记住。',
+  featureSandboxReclaim: '插件界面沙箱回收',
+  featureSandboxReclaimDesc: '插件卡片沙箱数量达到上限时自动释放最早创建的（正在查看的排最后），避免 64 个名额耗尽后新卡片打不开；被释放的旧卡片重新打开所在会话即恢复（预算可在配置文件 sandboxReclaimBudget 调整）。',
+  featurePluginCardRetry: '插件卡片自动重试',
+  featurePluginCardRetryDesc: '因名额上限加载失败的插件卡片自动点击“重新加载”，名额空出后自动恢复，无需手动蹲守。',
+  visionCardUi: '思考过程显示识图卡片',
   pinnedToggleAria: '折叠/展开已置顶',
   sidebarProjectSpacingName: '项目间距',
   sidebarProjectSpacingDesc: '侧边栏中相邻项目行之间的视觉间距（含行内留白）；设置后各分区（已置顶/项目/任务）之间的间距也统一为该值。',
@@ -269,6 +296,33 @@ const zh = {
   featureNewtabPanelsDesc: '官方“新标签页”只列官方面板与推荐的官方插件，此功能把第三方市场插件（headroom、rtk 等）的面板卡片加进去，点击在侧边面板打开。',
   ntpDescSuffix: '插件面板',
   ntpNeedSession: '先打开一个任务会话，再从新标签页打开插件面板',
+  featureStatusBarDesc: '主界面底部右下角显示统计项：上下文占用、会话/今日/累计 token、任务数等；各项的顺序与显隐在“样式 → 状态栏”里调整。',
+  tabStylesPane: '样式调整',
+  tabStatusPane: '状态栏',
+  sbItemCtx: '上下文占用',
+  sbItemQuestions: '提问次数',
+  sbMaster: '启用统计',
+  sbMasterDesc: '总开关：关闭后底部状态栏与每轮回答的用量标注一起停用。',
+  sbGroupSession: '会话统计（跟随当前会话）',
+  sbGroupGlobal: '总统计',
+  sbGroupTurn: '每轮统计（回答末尾）',
+  sbLabelIn: '输入',
+  sbLabelOut: '输出',
+  sbLabelCache: '缓存',
+  turnUsageTitle: '本轮 token',
+  sbLabelQuestions: '提问',
+  sbItemTodayTokens: '今日 token',
+  sbItemTasks: '任务总数',
+  sbLabelCtx: '上下文',
+  sbLabelTurns: '调用',
+  sbLabelToday: '今日',
+  sbLabelTasks: '任务',
+  sbItemTotalTokens: '累计 token',
+  sbLabelTotal: '累计',
+  sbMoveUp: '上移',
+  sbMoveDown: '下移',
+  sbVisible: '显示',
+  sbHidden: '隐藏',
   tabShortcuts: '快捷键',
   hkTitle: '会话快捷切换',
   hkAltZ: '在当前与上次使用的会话间来回切换',
@@ -670,6 +724,11 @@ const en = {
   tbPluginStore: 'Plugin store',
   featurePinnedCollapse: 'Collapsible Pinned section',
   featurePinnedCollapseDesc: 'The sidebar "Pinned" header collapses/expands its task list (like Projects and Groups); the state is remembered.',
+  featureSandboxReclaim: 'Plugin card sandbox reclaim',
+  featureSandboxReclaimDesc: 'Releases the oldest plugin-card sandboxes once the cap is hit (the one being viewed goes last), so new cards keep opening after the 64-slot pool fills up; released cards come back when their session is reopened (budget adjustable via sandboxReclaimBudget in the config file).',
+  featurePluginCardRetry: 'Plugin card auto-retry',
+  featurePluginCardRetryDesc: 'Auto-clicks "Reload" on cards that failed the slot cap; they recover as soon as a slot frees up.',
+  visionCardUi: 'Vision cards',
   pinnedToggleAria: 'Collapse/expand Pinned',
   sidebarProjectSpacingName: 'Project spacing',
   sidebarProjectSpacingDesc: 'Visual spacing between adjacent project rows in the sidebar (row padding included); when set, section gaps (Pinned/Projects/Tasks) follow the same value.',
@@ -694,6 +753,33 @@ const en = {
   featureNewtabPanelsDesc: "The built-in \"new tab page\" only lists built-in panels and recommended official plugins; this adds cards for third-party marketplace plugin panels (headroom, rtk, …) that open in the side pane.",
   ntpDescSuffix: 'plugin panel',
   ntpNeedSession: 'Open a task session first, then open plugin panels from the new tab page',
+  featureStatusBarDesc: 'Shows statistics at the bottom-right of the main view: context usage, session/today/total tokens, task count, etc.; reorder or hide each item under "Styles → Status bar".',
+  tabStylesPane: 'Styles',
+  tabStatusPane: 'Status bar',
+  sbItemCtx: 'Context usage',
+  sbItemQuestions: 'Questions asked',
+  sbMaster: 'Enable statistics',
+  sbMasterDesc: 'Master switch: turning this off disables both the status bar and per-turn labels.',
+  sbGroupSession: 'Session statistics (follows current session)',
+  sbGroupGlobal: 'Global statistics',
+  sbGroupTurn: 'Per-turn statistics (answer rows)',
+  sbLabelIn: 'in',
+  sbLabelOut: 'out',
+  sbLabelCache: 'cache',
+  turnUsageTitle: 'Turn tokens',
+  sbLabelQuestions: 'asks',
+  sbItemTodayTokens: 'Today tokens',
+  sbItemTasks: 'Tasks',
+  sbLabelCtx: 'ctx',
+  sbLabelTurns: 'calls',
+  sbLabelToday: 'today',
+  sbLabelTasks: 'tasks',
+  sbItemTotalTokens: 'Total tokens',
+  sbLabelTotal: 'total',
+  sbMoveUp: 'Up',
+  sbMoveDown: 'Down',
+  sbVisible: 'shown',
+  sbHidden: 'hidden',
   tabShortcuts: 'Shortcuts',
   hkTitle: 'Session quick switch',
   hkAltZ: 'Toggle between the current and the last-used session',

package/src/inject/features/plugin-card-retry.js

@@ -0,0 +1,48 @@
+// 插件卡片自动重试：宿主对插件交互卡片（沙箱）有全局 64 个名额，重度会话打开时
+// 注册洪峰会撞上限，一部分卡片显示"插件界面数量已达上限/加载失败"并带"重新加载"
+// 按钮。名额由宿主缓慢回收（或沙箱回收功能主动释放），空出后重试即成——但手动
+// 蹲守空窗不现实（真机实测：名额约一小时只腾出两个，每次腾出恰好能救一张卡）。
+// 本功能定期找出失败卡片的"重新加载"按钮自动点按：名额一空卡片自动复活。
+// 匹配规则：按钮文字恰为"重新加载"，且四层祖先内含"插件界面/已达上限/加载失败"
+// 字样，避免误点其他"重新加载"。
+// 开关：features.pluginCardRetry（默认开）。
+import { getConfig } from '../core.js';
+
+const SCAN_MS = 15_000;            // 巡检周期
+const CLICK_INTERVAL_MS = 30_000;  // 两次点按的最小间隔（全局节流）
+// 宿主两种失败文案（"插件界面加载失败""插件界面数量已达上限"）都含"插件界面"，
+// 只认这一个词足够精确，也避免误点其他"重新加载"按钮
+const MARKERS = ['插件界面'];
+
+let lastClickAt = 0; // 全局节流：按按钮元素记冷却会被宿主重建的新元素绕过
+
+function failedRetryButtons() {
+  const out = [];
+  for (const btn of document.querySelectorAll('button')) {
+    if ((btn.textContent || '').trim() !== '重新加载') continue;
+    let anc = btn;
+    for (let i = 0; i < 4 && anc.parentElement; i++) {
+      anc = anc.parentElement;
+      const ctx = anc.textContent || '';
+      if (MARKERS.some((m) => ctx.includes(m))) { out.push(btn); break; }
+    }
+  }
+  return out;
+}
+
+async function tick() {
+  const cfg = await getConfig();
+  if ((cfg.features || {}).pluginCardRetry === false) return;
+  const now = Date.now();
+  if (now - lastClickAt < CLICK_INTERVAL_MS) return;
+  for (const btn of failedRetryButtons()) {
+    lastClickAt = now;
+    btn.click();
+    // 一轮只点一个：名额通常一次只空一个，排队恢复，避免齐发再撞上限
+    break;
+  }
+}
+
+export function startPluginCardRetry() {
+  setInterval(() => { tick().catch(() => { /* 单次巡检失败不影响后续 */ }); }, SCAN_MS);
+}

package/src/inject/features/sandbox-reclaim.js

@@ -27,7 +27,29 @@ const MIN_BUDGET = 8;
 const MAX_BUDGET = 64;
 const RETRY_COOLDOWN_MS = 10 * 60_000;  // 同一沙箱释放失败后的重试冷却
 
+const SEEN_KEY = 'zcodepro:sbx-seen'; // 登记簿持久化键（localStorage，跨 zcode-pro 重载保留）
 const seen = new Map();     // sandboxId → { initId, firstSeen }
+function loadSeen() {
+  try {
+    const raw = JSON.parse(localStorage.getItem(SEEN_KEY) || '{}');
+    for (const [id, v] of Object.entries(raw)) {
+      if (id && v && Number.isFinite(v.firstSeen)) seen.set(id, { initId: v.initId, firstSeen: v.firstSeen });
+    }
+  } catch { /* 损坏则从零开始 */ }
+}
+let saveSeenTimer = null;
+function saveSeenSoon() {
+  // 防抖落盘：广播可能成串到达，逐条写 localStorage 没必要
+  if (saveSeenTimer) return;
+  saveSeenTimer = setTimeout(() => {
+    saveSeenTimer = null;
+    try {
+      const out = {};
+      for (const [id, v] of seen) out[id] = v;
+      localStorage.setItem(SEEN_KEY, JSON.stringify(out));
+    } catch { /* 写失败不影响运行 */ }
+  }, 2000);
+}
 const cooldown = new Map(); // sandboxId → 释放失败冷却截止时刻
 let disabledLogged = false;
 
@@ -37,6 +59,7 @@ function onPortsMessage(e) {
   // 端口广播≈沙箱创建时刻；页面刷新后宿主按幂等键复用同一沙箱并再次广播，
   // 创建时刻随之刷新（视作新名额重新排队）
   seen.set(d.sandboxId, { initId: Number(d.initId) || 0, firstSeen: Date.now() });
+  saveSeenSoon();
 }
 
 function extractSandboxId(wv) {
@@ -74,36 +97,41 @@ async function tick() {
   budget = Math.min(MAX_BUDGET, Math.max(MIN_BUDGET, budget));
 
   const now = Date.now();
-  const live = new Map(); // sandboxId → 是否可见
-  for (const wv of document.querySelectorAll('webview[data-zcode-retained-sandbox]')) {
+  // 存活计数以端口广播登记数（seen）为准：卡片滚出视口后宿主会把它收进停靠区并从
+  // 常驻 DOM 摘除（实测 DOM webview 数远小于宿主注册数），拿 DOM 数当触发条件
+  // 永远到不了预算、从不驱逐——名额就一直是满的。DOM 只用来标记"正在被看"：
+  const visible = new Set(); // 展示中的 sandboxId（驱逐时避开）
+  for (const wv of document.querySelectorAll('webview')) {
     const id = extractSandboxId(wv);
-    if (id) live.set(id, isVisible(wv));
-  }
-  // 端口广播登记过但 DOM 已无对应 webview 的条目（guest 已销毁）：清掉，防 Map 无限增长
-  for (const id of [...seen.keys()]) {
-    if (!live.has(id)) seen.delete(id);
-  }
-  // 重注入后端口广播没赶上（Map 为空）的兜底：首次观察到时按现在起算创建时刻
-  for (const id of live.keys()) {
-    if (!seen.has(id)) seen.set(id, { initId: undefined, firstSeen: now });
+    if (id) {
+      if (isVisible(wv)) visible.add(id);
+      // 漏听广播的名额（持久化损坏/清空过）：见到即补录，创建时刻从现在起算
+      if (!seen.has(id)) { seen.set(id, { initId: undefined, firstSeen: now }); saveSeenSoon(); }
+    }
   }
 
-  while (live.size > budget) {
-    // 驱逐顺序：不可见的按创建时间最早的 → 全可见时最早的可见沙箱
-    const candidates = [...live.entries()]
-      .filter(([id]) => (cooldown.get(id) || 0) <= now)
-      .sort((a, b) => (a[1] - b[1]) || ((seen.get(a[0]) || {}).firstSeen || 0) - ((seen.get(b[0]) || {}).firstSeen || 0));
-    if (!candidates.length) break;
-    const [id] = candidates[0];
+  while (seen.size > budget) {
+    // 驱逐顺序：不可见的按创建时间最早的 → 全都可见时最早的（保持原语义）
+    let pool = [...seen.keys()].filter((id) => (cooldown.get(id) || 0) <= now && !visible.has(id));
+    if (!pool.length) pool = [...seen.keys()].filter((id) => (cooldown.get(id) || 0) <= now);
+    pool.sort((a, b) => ((seen.get(a) || {}).firstSeen || 0) - ((seen.get(b) || {}).firstSeen || 0));
+    if (!pool.length) break;
+    const id = pool[0];
     const entry = seen.get(id);
     try {
       await bridge.disposeSandbox(id, entry && entry.initId);
-      console.info('[zcodepro] sandbox-reclaim: 沙箱满 ' + live.size + ' 个，已驱逐最早的 ' + id);
+      console.info('[zcodepro] sandbox-reclaim: 登记数 ' + seen.size + ' 超预算 ' + budget + '，已驱逐最早的 ' + id + (visible.has(id) ? '（可见，属兜底）' : ''));
     } catch (err) {
       console.warn('[zcodepro] sandbox-reclaim: 释放失败 ' + id, err);
+      // 失败也出账：死 id（如应用重启后的存量）不清会永远排最旧、堵住驱逐队列；
+      // 真活着的名额漏掉这一轮，下张卡创建时广播会重新入账
+      seen.delete(id);
+      continue;
     }
     seen.delete(id);
-    live.delete(id);
+    saveSeenSoon();
+    // 驱逐成功也设冷却：宿主侧真正释放是异步的，同轮连发多个 dispose 可能
+    // 在宿主来不及记账时重复命中；冷却让下一轮重新评估剩余数量
     cooldown.set(id, now + RETRY_COOLDOWN_MS);
   }
   if (cooldown.size > 256) {
@@ -114,6 +142,7 @@ async function tick() {
 }
 
 export function startSandboxReclaim() {
+  loadSeen();
   window.addEventListener('message', onPortsMessage);
   const loop = () => { tick().catch(() => { /* 单次巡检失败不影响后续 */ }); };
   loop();