zcode-pro 1.1.0 → 1.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zcode-pro",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "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.1.0';
+const VERSION = '1.2.1';
 
 // 全局提示词固定在用户主目录：官方加载器按 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 {
@@ -2402,6 +2567,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: '侧边栏中相邻项目行之间的视觉间距（含行内留白）；设置后各分区（已置顶/项目/任务）之间的间距也统一为该值。',
@@ -265,6 +292,38 @@ const zh = {
   switcherUnseen: '未查看',
   switcherAttentionHint: '运行中 / 运行完未查看的任务 · {prev} / {next} 或 ↑ / ↓ 选择，Enter 或松开 alt 切换',
   switcherAttentionEmpty: '暂无运行中或未查看的任务',
+  featureNewtabPanels: '新标签页插件面板入口',
+  featureNewtabPanelsDesc: '官方“新标签页”只列官方面板与推荐的官方插件，此功能把第三方市场插件（headroom、rtk 等）的面板卡片加进去，点击在侧边面板打开。',
+  ntpDescSuffix: '插件面板',
+  ntpNeedSession: '先打开一个任务会话，再从新标签页打开插件面板',
+  featureStatusBar: '状态栏统计',
+  featureStatusBarDesc: '主界面底部右下角显示统计项：上下文占用、会话/今日/累计 token、任务数等；各项的顺序与显隐在“样式 → 状态栏”里调整。',
+  tabStylesPane: '样式调整',
+  tabStatusPane: '状态栏',
+  sbItemCtx: '上下文占用',
+  sbItemQuestions: '提问次数',
+  sbGroupSession: '会话统计（跟随当前会话）',
+  sbGroupGlobal: '总统计',
+  sbGroupTurn: '每轮统计（回答末尾）',
+  sbLabelIn: '输入',
+  sbLabelOut: '输出',
+  sbLabelCache: '缓存',
+  featureTurnUsage: '每轮回答 token 用量',
+  featureTurnUsageDesc: '在每条回答末尾操作按钮的时间后面显示该轮的输入/输出 token（本地记录只保留最近若干轮，对不上时间的旧回答不显示）。',
+  turnUsageTitle: '本轮 token',
+  sbLabelQuestions: '提问',
+  sbItemTodayTokens: '今日 token',
+  sbItemTasks: '任务总数',
+  sbLabelCtx: '上下文',
+  sbLabelTurns: '调用',
+  sbLabelToday: '今日',
+  sbLabelTasks: '任务',
+  sbItemTotalTokens: '累计 token',
+  sbLabelTotal: '累计',
+  sbMoveUp: '上移',
+  sbMoveDown: '下移',
+  sbVisible: '显示',
+  sbHidden: '隐藏',
   tabShortcuts: '快捷键',
   hkTitle: '会话快捷切换',
   hkAltZ: '在当前与上次使用的会话间来回切换',
@@ -666,6 +725,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.',
@@ -686,6 +750,38 @@ const en = {
   switcherUnseen: 'unseen',
   switcherAttentionHint: 'Running / finished but unseen tasks · {prev} / {next} or ↑ / ↓ to choose, Enter or release alt to switch',
   switcherAttentionEmpty: 'No running or unseen tasks',
+  featureNewtabPanels: 'Plugin panels on the new tab page',
+  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',
+  featureStatusBar: 'Status bar statistics',
+  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',
+  sbGroupSession: 'Session statistics (follows current session)',
+  sbGroupGlobal: 'Global statistics',
+  sbGroupTurn: 'Per-turn statistics (answer rows)',
+  sbLabelIn: 'in',
+  sbLabelOut: 'out',
+  sbLabelCache: 'cache',
+  featureTurnUsage: 'Per-turn token usage',
+  featureTurnUsageDesc: "Shows that turn's in/out tokens after the time in each answer's action row (local records keep only the most recent turns; older answers without a match stay unlabelled).",
+  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/newtab-panels.js

@@ -0,0 +1,224 @@
+// 新标签页插件面板入口：ZCode 3.16.1 的“新标签页”只列官方面板（文件/终端/
+// 辅助对话/浏览器/审查）与云端推荐的官方插件，第三方市场（duanluan/zcode-plugins
+// 等）的面板（headroom、rtk……）注册正常（listSurfaces 有返回）却没有任何入口。
+// 本功能检测新标签页的模块网格，把非官方市场的面板注入成同款卡片；点击走官方
+// openSidePane（App 层注入 Context Provider 的 handleOpenPluginUi，从 React
+// fiber 里按函数源码特征串挖出）在侧边面板打开 tab——与插件市场页“打开”同一条
+// 调用路径，不绕开官方逻辑。
+import { t, getConfig, isZhLocale } from '../core.js';
+import { ensureStyle, showToast } from '../ui.js';
+
+// 官方“新标签页”终端模块的描述片段（界面中英文），作为网格识别特征
+const GRID_HINTS = ['运行命令和查看输出', 'Run commands and view output'];
+// 官方市场的 pluginId 后缀：这些面板已有云端推荐入口，不注入
+const OFFICIAL_SUFFIX = '@zcode-plugins-official';
+// handleOpenPluginUi（useCallback 产物）源码里的 logger 字符串，压缩不改动
+// 字面量，以此从多个 Context Provider 中精确挑出打开面板的函数
+const OPEN_FN_MARK = '打开插件 UI';
+
+let enabled = true;
+let injectTimer = 0;
+
+// —— 从 React fiber 取应用内部对象（ws-running.js findServices 同款遍历） ——
+
+function eachFiber(visit) {
+  const rootEl = document.getElementById('root');
+  const key = rootEl && Object.keys(rootEl).find((k) => k.startsWith('__reactContainer$'));
+  if (!key) return;
+  let visited = 0;
+  const walk = (f) => {
+    if (!f || visited > 200000) return;
+    visited++;
+    if (visit(f)) return true;
+    return walk(f.child) || walk(f.sibling);
+  };
+  walk(rootEl[key]);
+}
+
+// Context Provider 的 value 里找打开插件面板的函数（特征：源码含 logger 字符串）
+function findOpenSidePane() {
+  let found = null;
+  eachFiber((f) => {
+    const et = f.elementType;
+    if (et && typeof et === 'object' && typeof et.$$typeof === 'symbol'
+      && String(et.$$typeof).includes('react.context')) {
+      const val = f.memoizedProps && f.memoizedProps.value;
+      if (typeof val === 'function' && val.toString().includes(OPEN_FN_MARK)) {
+        found = val;
+        return true;
+      }
+    }
+    return false;
+  });
+  return found;
+}
+
+// pluginUiBridgeService（listSurfaces 数据源）
+function findBridge() {
+  let holder = null;
+  const seen = new Set();
+  const scan = (o) => {
+    if (!o || typeof o !== 'object' || seen.has(o) || holder) return;
+    seen.add(o);
+    if (typeof o.pluginUiBridgeService === 'object' && o.pluginUiBridgeService) {
+      holder = o.pluginUiBridgeService;
+      return;
+    }
+    for (const v of Object.values(o)) if (v && typeof v === 'object') scan(v);
+  };
+  eachFiber((f) => {
+    for (const h of [f.memoizedProps, f.memoizedState]) {
+      if (!h || typeof h !== 'object') continue;
+      scan(h);
+      if (holder) return true;
+    }
+    return false;
+  });
+  return holder;
+}
+
+// —— 会话与面板清单 ——
+
+// 打开面板必须挂在某个会话上（availability: session）：优先当前选中会话，
+// 其次侧栏最新一行（新会话更可能已随启动拉起插件的 UI server，老会话的
+// server 目录里没有该插件时会卡在“正在加载插件界面”）；一个都没有返回 null
+function sessionScope() {
+  const rows = [...document.querySelectorAll('[data-task-item-key]')];
+  const cur = rows.find((e) => (e.className + '').includes('bg-selected')) || rows[rows.length - 1];
+  const key = cur ? cur.getAttribute('data-task-item-key') : '';
+  if (!key) return null;
+  const i = key.indexOf(':sess_');
+  return i > 0 ? { workspacePath: key.slice(0, i), sessionId: key.slice(i + 1) } : null;
+}
+
+async function thirdPartySurfaces(bridge, workspacePath) {
+  try {
+    const list = await bridge.listSurfaces({ workspacePath });
+    return (list || []).filter((s) => !String(s.pluginId || '').endsWith(OFFICIAL_SUFFIX));
+  } catch {
+    return [];
+  }
+}
+
+function surfaceTitle(s, locale) {
+  const title = s.title;
+  const pick = (obj) => {
+    const lang = (locale || '').split('-')[0];
+    return obj[locale] || (lang && obj[lang])
+      || Object.entries(obj).find(([k]) => k.toLowerCase().startsWith(lang || '\0'))?.[1]
+      || obj.en || Object.values(obj)[0] || '';
+  };
+  if (typeof title === 'string') return title;
+  if (title && typeof title === 'object') {
+    return pick(title) || s.pluginName || s.id;
+  }
+  return s.pluginName || s.id;
+}
+
+// —— 卡片注入 ——
+
+// 通用面板图标（lucide layout-dashboard 同款路径），替换模板卡片原图标
+const PANEL_ICON_PATHS = ['<rect width="7" height="9" x="3" y="3" rx="1"/><rect width="7" height="5" x="14" y="3" rx="1"/><rect width="7" height="9" x="14" y="12" rx="1"/><rect width="7" height="5" x="3" y="16" rx="1"/>'];
+
+// 找“新标签页”的模块网格：官方卡片按钮带 data-side-pane-open-tab-item
+// （3.16.1 实测标识），其父容器即网格；文本特征兜底校验（终端模块描述）
+function findNewTabGrid() {
+  const item = document.querySelector('[data-side-pane-open-tab-item]');
+  if (!item || item.offsetParent === null) return null;
+  const grid = item.parentElement;
+  if (!grid || grid === document.body) return null;
+  const text = grid.textContent || '';
+  return GRID_HINTS.some((h) => text.includes(h)) ? grid : null;
+}
+
+async function injectPanels(grid) {
+  if (grid.dataset.zcodeproPanels) return;
+  const template = grid.querySelector('[data-side-pane-open-tab-item]');
+  if (!template) return;
+  const scope = sessionScope();
+  if (!scope) return; // 没有任何会话时暂不注入，下次 DOM 变动再试
+  const bridge = findBridge();
+  if (!bridge) return;
+  const surfaces = await thirdPartySurfaces(bridge, scope.workspacePath);
+  if (!surfaces.length) { grid.dataset.zcodeproPanels = '1'; return; }
+  grid.dataset.zcodeproPanels = '1';
+  const L = t();
+  const locale = isZhLocale() ? 'zh-CN' : 'en-US';
+  for (const s of surfaces) {
+    // 官方卡片整卡即 button：克隆同款，去掉官方标识，挂我们的标识与点击
+    const card = template.cloneNode(true);
+    card.removeAttribute('data-side-pane-open-tab-item');
+    card.setAttribute('data-zcodepro-panel', s.id);
+    card.setAttribute('data-zcodepro-panel-name', s.pluginName || '');
+    const title = surfaceTitle(s, locale);
+    const desc = (s.pluginName || '') + ' · ' + L.ntpDescSuffix;
+    const titleEl = card.querySelector('span.font-semibold');
+    if (titleEl) titleEl.textContent = title;
+    const descEl = card.querySelector('span[title]');
+    if (descEl) { descEl.textContent = desc; descEl.setAttribute('title', desc); }
+    // 图标换通用面板图形（模板 svg 的描边样式保留）
+    const svg = card.querySelector('svg');
+    if (svg) {
+      svg.innerHTML = PANEL_ICON_PATHS[0];
+      svg.setAttribute('viewBox', '0 0 24 24');
+    }
+    card.addEventListener('click', (ev) => {
+      // 克隆卡片会冒泡到官方“新标签页”容器的点击处理（被当成再开一个新标签页），
+      // 这里拦下冒泡只走面板打开
+      ev.stopPropagation();
+      const sc = sessionScope();
+      const open = findOpenSidePane();
+      if (!sc || !open) {
+        showToast(L.ntpNeedSession, 'error');
+        return;
+      }
+      try {
+        // 字段与官方市场页 selectSurface 的请求一致；serverName（资源的 MCP
+        // server 归属）缺失会让沙箱准备一直停在“正在加载插件界面…”
+        open({
+          parentSessionId: sc.sessionId,
+          pluginId: s.pluginId,
+          surfaceId: s.id,
+          serverName: s.server,
+          resourceUri: s.resourceUri,
+          remoteSessionId: null,
+          title,
+          workspacePath: sc.workspacePath,
+        });
+      } catch (e) {
+        console.warn('[zcodepro] 打开插件面板失败', e);
+        showToast(L.ntpNeedSession, 'error');
+      }
+    });
+    grid.append(card);
+  }
+}
+
+function tryInject() {
+  if (!enabled || document.hidden) return;
+  const grid = findNewTabGrid();
+  if (!grid) return;
+  // React 重渲染可能冲掉注入的卡片：标记还在但卡片没了时清标记重注
+  if (grid.dataset.zcodeproPanels && !grid.querySelector('[data-zcodepro-panel]')) {
+    delete grid.dataset.zcodeproPanels;
+  }
+  void injectPanels(grid);
+}
+
+export function startNewtabPanels() {
+  ensureStyle();
+  const refreshEnabled = () => {
+    void getConfig().then((cfg) => {
+      enabled = cfg.features ? cfg.features.newtabPanels !== false : true;
+    }).catch(() => {});
+  };
+  refreshEnabled();
+  // 设置里开关变化即时生效（保存时会派发 config-changed）
+  window.addEventListener('zcodepro:config-changed', refreshEnabled);
+  const observer = new MutationObserver(() => {
+    if (injectTimer) return;
+    injectTimer = setTimeout(() => { injectTimer = 0; tryInject(); }, 300);
+  });
+  observer.observe(document.body, { childList: true, subtree: true });
+  setInterval(tryInject, 5000);
+}