zcode-pro 1.0.0 → 1.2.0

package/package.json

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

package/src/host/helper.mjs

@@ -17,7 +17,7 @@ import { reorderWorkspaceTasks, reorderGroupMembers } from './taskOrder.mjs';
 import { webdavRequest, webdavPutWithMkcol, webdavHttpText, parseWebdavListing, findCurl } from './webdav.mjs';
 import { resolveZcodeExecutable } from './paths.mjs';
 
-const VERSION = '1.0.0';
+const VERSION = '1.2.0';
 
 // 全局提示词固定在用户主目录：官方加载器按 HOME/USERPROFILE 拼 .zcode/AGENTS.md，
 // 不读 ZCODE_DATA_BASE_DIR（数据根迁走时全局指令仍在原位）。
@@ -339,6 +339,15 @@ export function startHelper({ port, token, dataRoot, state, agentsFile = default
         if (body && typeof body === 'object' && body.styles && typeof body.styles === 'object') {
           current.styles = applyStylesPartial(current.styles, body.styles);
         }
+        // 会话快捷切换的键位（设置 → 快捷键里修改）：键名固定，值限单个字母或数字
+        if (body && typeof body === 'object' && body.shortcuts && typeof body.shortcuts === 'object') {
+          const patch = {};
+          for (const k of ['switchLast', 'switchPrev', 'switchNext', 'switchRecent', 'switchAttention']) {
+            const v = body.shortcuts[k];
+            if (typeof v === 'string' && /^[a-z0-9]$/.test(v)) patch[k] = v;
+          }
+          current.shortcuts = { ...(current.shortcuts || {}), ...patch };
+        }
         if (body && typeof body === 'object' && body.titleGen && typeof body.titleGen === 'object') {
           current.titleGen = mergeTitleGenConfig({ ...current.titleGen, ...body.titleGen });
         }

package/src/inject/core.js

@@ -38,6 +38,16 @@ export async function getConfig(force = false) {
 }
 export function clearConfigCache() { configCache = { value: null, at: 0 }; }
 
+// 会话快捷切换的默认键位（按住 alt 再按）；settings 的“快捷键”标签页可改，
+// 配置存在 config.shortcuts，未写的项回退到这里
+export const DEFAULT_SHORTCUTS = {
+  switchLast: 'z',       // 立即切到上次会话
+  switchPrev: 'x',       // 弹窗中上移
+  switchNext: 'c',       // 弹窗中下移
+  switchRecent: 'e',     // 打开最近 10 条
+  switchAttention: 'r',  // 打开运行中 / 未查看
+};
+
 // —— ZCode 版本判断（按官方版本启用/停用功能）——
 // 版本来源：启动器从 app.asar 读出后写进 bootstrap（window.__ZCODEPRO__.zcodeVersion），
 // helper 的 /config 响应也附加同名字段。读不到时为空串，各判断保持旧行为。
@@ -190,7 +200,7 @@ const zh = {
   featureTaskOrder: '侧边栏会话拖动排序',
   featureTaskOrderDesc: '让置顶、项目与分组中的会话拖动后记住顺序，刷新后保持。',
   featureSessionSwitch: '会话快捷切换',
-  featureSessionSwitchDesc: 'alt+z 在当前与上次会话间来回切换；按住 alt 再按 x/c 弹出最近会话列表前后选择，松开 alt 切换（类 alt+tab）。',
+  featureSessionSwitchDesc: '{last} 在当前与上次会话间来回切换；按住 alt 再按 {prev}/{next} 弹出最近会话列表前后选择（初始 10 条，{next} 到底再加载 5 条），{recent} 直接打开最近 10 条，{attention} 打开运行中与运行完未查看的任务；方向键同样可选，Enter 或松开 alt 切换（类 alt+tab）',
   featureTitleLock: '重命名会话名锁定',
   featureTitleLockDesc: '手动重命名过的会话不再被自动标题覆盖：会话有新回答后界面可能改显自动标题，重启后又变回，本功能让侧栏始终显示重命名后的名字。',
   tabTitleGen: '任务名提示词',
@@ -218,7 +228,7 @@ const zh = {
   titleGenTestOk: '生成结果：',
   titleGenTestFailed: '生成失败',
   featureWsRunning: '折叠时任务运行中提示',
-  featureWsRunningDesc: '有会话在运行时，折叠的项目与“任务”“已置顶”等分区头显示与任务运行中同款的加载图标，全部结束后消失；3.16.1 之前每 60 秒会在后台短暂展开项目复核再收起。',
+  featureWsRunningDesc: '有会话在运行时，折叠的项目与“任务”“已置顶”等分区头显示与任务运行中同款的加载图标，全部结束后消失。',
   tabPerformance: '性能',
   perfDesc: 'ZCode 为每个打开过的项目常驻一个会话进程，应用自身不会回收，项目多了内存占用就高。开启后，长时间未使用且没有任务在跑的项目会被自动释放：会话记录不受影响，再次打开时自动恢复，仅首次回复有几秒等待。正在使用的项目、运行中的会话与后台命令、定时任务都不会被回收。后台命令检测依赖系统进程信息（Linux / macOS / Windows 各走系统自带工具），检测不可用时功能自动停用。',
   featureIdleReclaim: '空闲项目内存回收',
@@ -246,10 +256,44 @@ const zh = {
   userFontDesc: '会话中提问内容的字体；选“默认”时跟随界面字体。',
   assistantFontName: '回答字体',
   assistantFontDesc: '会话中回答正文的字体（代码块仍用等宽字体）；选“默认”时跟随界面字体。',
-  switcherHint: 'x / c 选择，松开 alt 切换，Esc 取消',
+  switcherHint: '{prev} / {next} 或 ↑ / ↓ 选择，Enter 或松开 alt 切换，Esc 取消',
   switcherCurrent: '当前',
   switcherEmpty: '暂无上次会话（切换过会话后可用）',
   switcherFailed: '未能切换到该会话（可能已删除）',
+  switcherMore: '还有 {n} 条 · 按 c 加载',
+  switcherRunning: '运行中',
+  switcherUnseen: '未查看',
+  switcherAttentionHint: '运行中 / 运行完未查看的任务 · {prev} / {next} 或 ↑ / ↓ 选择，Enter 或松开 alt 切换',
+  switcherAttentionEmpty: '暂无运行中或未查看的任务',
+  featureNewtabPanels: '新标签页插件面板入口',
+  featureNewtabPanelsDesc: '官方“新标签页”只列官方面板与推荐的官方插件，此功能把第三方市场插件（headroom、rtk 等）的面板卡片加进去，点击在侧边面板打开。',
+  ntpDescSuffix: '插件面板',
+  ntpNeedSession: '先打开一个任务会话，再从新标签页打开插件面板',
+  tabShortcuts: '快捷键',
+  hkTitle: '会话快捷切换',
+  hkAltZ: '在当前与上次使用的会话间来回切换',
+  hkAltX: '弹窗中上移高亮（更早的会话）',
+  hkAltC: '弹窗中下移高亮（更新的会话）；到底且还有更多时加载 5 条并选中新加载的第一条',
+  hkAltE: '打开最近 10 条任务列表',
+  hkAltR: '打开正在运行与运行完未查看的任务列表',
+  hkArrow: '弹窗打开时移动高亮（与 alt + {prev} / alt + {next} 同规则）',
+  hkEnter: '确认切换到高亮的会话',
+  hkEsc: '取消并关闭弹窗',
+  hkRelease: '移动过高亮时松开即切换；从未移动则弹窗保持打开，继续选择',
+  hkReleaseKey: '松开 alt',
+  hkModify: '修改',
+  hkRecording: '按下新键…',
+  hkInvalid: '快捷键只支持单个字母或数字',
+  hkConflict: 'alt+{k} 已用于“{name}”',
+  hkSaved: '快捷键已更新',
+  hkNameLast: '切换上次会话',
+  hkNamePrev: '上移高亮',
+  hkNameNext: '下移高亮',
+  hkNameRecent: '最近 10 条',
+  hkNameAttention: '运行中 / 未查看',
+  hkEditHint: '点击“修改”后按下新按键（字母或数字），Esc 取消',
+  hkReset: '重置为默认',
+  hkResetDone: '已恢复默认键位',
   featureFileActions: '文件菜单增强',
   featureFileActionsDesc: '在会话中文件链接的右键菜单里新增“默认应用打开”与“打开所在目录”。',
   featureImageCopy: '图片右键复制',
@@ -374,7 +418,7 @@ const zh = {
   headroomStoppedWarn: '代理已停止；指向 127.0.0.1 的供应商将无法连接',
   headroomBackend: '压缩设备',
   headroomBackendAuto: '自动 · 显卡优先',
-  headroomBackendCpu: 'CPU · 省电',
+  headroomBackendCpu: '省电 · CPU 优先',
   headroomBackendNative: '（原生值）',
   headroomBackendDesc: '自动：headroom 选最快设备（CUDA/MPS 显卡优先）；CPU：强制 CPU 压缩，省电且不占显存。也支持 headroom 原生值（onnx、pytorch_mps 等）。切换会重启代理立即生效。',
   headroomPower: '省电自动切换',
@@ -412,7 +456,7 @@ const zh = {
   aliasSaved: '别名已更新',
   aliasCleared: '已恢复真实名称',
   aliasHint: '磁盘目录名不变：终端、文件管理器与其他引用真实路径的界面仍显示原名。',
-  featureProjectMenuDescNew: '项目“更多”菜单中的切换文件夹、打开文件夹与复制路径。官方已支持修改项目名称（编辑项目），自定义别名已停用。',
+  featureProjectMenuDescNew: '项目“更多”菜单中的打开文件夹与复制路径。官方已支持修改项目名称（编辑项目），自定义别名已停用。',
   aliasMigrateTitle: '迁移项目别名',
   aliasMigrateDesc: '当前 ZCode 已支持修改项目名称（项目“更多”菜单 → 编辑项目），自定义别名功能已停用。可把已保存的别名写入官方项目名称，勾选要迁移的项目；迁移只改项目名称，磁盘目录不受影响。',
   aliasMigrateItemHint: '迁移后将作为项目名称保存（可随时在“编辑项目”中再改）。仅无标记的条目可勾选；已迁移、已并入、项目已删除、本机不存在（旧机器路径）以及项目已重命名的都不可勾选——要改这些项目的名字，直接用项目“更多”菜单里的“编辑项目”。',
@@ -581,7 +625,7 @@ const en = {
   featureTaskOrder: 'Sidebar session drag ordering',
   featureTaskOrderDesc: 'Makes session drags in Pinned, Projects and Groups persist across refreshes.',
   featureSessionSwitch: 'Session quick switch',
-  featureSessionSwitchDesc: 'alt+z toggles between the current and the last session; hold alt and press x/c to move the highlight across recently used sessions, release alt to switch (like alt+tab).',
+  featureSessionSwitchDesc: '{last} toggles between the current and the last session; hold alt and press {prev}/{next} to move the highlight across recently used sessions (10 shown initially, pressing {next} at the bottom loads 5 more), {recent} opens the last 10 directly, {attention} opens running / finished-but-unseen tasks; arrow keys also move the highlight, Enter or release alt to switch (like alt+tab)',
   featureTitleLock: 'Keep renamed session titles',
   featureTitleLockDesc: 'Sessions you renamed keep their custom title: after new replies the app may show an auto-generated title instead, which reverts after a restart; this keeps the renamed title in the sidebar.',
   tabTitleGen: 'Task name prompt',
@@ -609,7 +653,7 @@ const en = {
   titleGenTestOk: 'Result: ',
   titleGenTestFailed: 'Generation failed',
   featureWsRunning: 'Running indicator when collapsed',
-  featureWsRunningDesc: 'Shows the same spinning loader as running tasks on collapsed projects and on section headers (“Tasks”, “Pinned”) while any session is running; clears when they all finish. Before ZCode 3.16.1 the project is briefly re-expanded in the background every 60 s to re-check.',
+  featureWsRunningDesc: 'Shows the same spinning loader as running tasks on collapsed projects and on section headers (“Tasks”, “Pinned”) while any session is running; clears when they all finish.',
   tabPerformance: 'Performance',
   perfDesc: 'ZCode keeps a session process resident for every project you have opened and never reclaims it, so memory grows with projects. When enabled, projects unused for a while with nothing running release their memory automatically: sessions are untouched and reload when reopened, with a few seconds wait on the first reply. The project in use, running sessions, background commands and scheduled tasks are never reclaimed. Background-command detection reads system process info via built-in tools (Linux / macOS / Windows); when unavailable, the feature disables itself.',
   featureIdleReclaim: 'Idle project memory reclaim',
@@ -637,10 +681,44 @@ const en = {
   userFontDesc: 'Font of question text in conversations; "default" follows the UI font.',
   assistantFontName: 'Answer font',
   assistantFontDesc: 'Font of answer text in conversations (code blocks stay monospaced); "default" follows the UI font.',
-  switcherHint: 'x / c to choose, release alt to switch, Esc to cancel',
+  switcherHint: '{prev} / {next} or ↑ / ↓ to choose, Enter or release alt to switch, Esc to cancel',
   switcherCurrent: 'current',
   switcherEmpty: 'No previous session yet (available after you switch sessions)',
   switcherFailed: 'Failed to switch to that session (it may have been deleted)',
+  switcherMore: '{n} more · press c to load',
+  switcherRunning: 'running',
+  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',
+  tabShortcuts: 'Shortcuts',
+  hkTitle: 'Session quick switch',
+  hkAltZ: 'Toggle between the current and the last-used session',
+  hkAltX: 'Move the highlight up (earlier sessions) in the popup',
+  hkAltC: 'Move the highlight down (recent sessions); at the bottom it loads 5 more and highlights the first newly loaded entry',
+  hkAltE: 'Open the last 10 tasks',
+  hkAltR: 'Open running / finished-but-unseen tasks',
+  hkArrow: 'Move the highlight while the popup is open (same rules as alt + {prev} / alt + {next})',
+  hkEnter: 'Switch to the highlighted session',
+  hkEsc: 'Cancel and close the popup',
+  hkRelease: 'Releasing alt switches once the highlight has moved; otherwise the popup stays open for further selection',
+  hkReleaseKey: 'release alt',
+  hkModify: 'Change',
+  hkRecording: 'press a key…',
+  hkInvalid: 'Shortcuts accept a single letter or digit only',
+  hkConflict: 'alt+{k} is already used by "{name}"',
+  hkSaved: 'Shortcut updated',
+  hkNameLast: 'last session',
+  hkNamePrev: 'move up',
+  hkNameNext: 'move down',
+  hkNameRecent: 'last 10 tasks',
+  hkNameAttention: 'running / unseen',
+  hkEditHint: 'Click "Change", press a new key (letter or digit); Esc cancels',
+  hkReset: 'Reset to defaults',
+  hkResetDone: 'Shortcuts reset to defaults',
   featureFileActions: 'File menu actions',
   featureFileActionsDesc: 'Adds "Open with default app" and "Reveal in file manager" to the right-click menu of file links in chat.',
   featureImageCopy: 'Image right-click copy',
@@ -765,7 +843,7 @@ const en = {
   headroomStoppedWarn: 'Proxy stopped; providers pointing at 127.0.0.1 cannot connect.',
   headroomBackend: 'Compression device',
   headroomBackendAuto: 'Auto · GPU first',
-  headroomBackendCpu: 'CPU · power saving',
+  headroomBackendCpu: 'Power saving · CPU first',
   headroomBackendNative: ' (native)',
   headroomBackendDesc: 'Auto lets headroom pick the fastest device (CUDA/MPS); CPU forces CPU compression (power saving, no VRAM). Native headroom values (onnx, pytorch_mps, …) also work. Switching restarts the proxy to apply.',
   headroomPower: 'Power-save auto switch',
@@ -803,7 +881,7 @@ const en = {
   aliasSaved: 'Alias updated.',
   aliasCleared: 'Real name restored.',
   aliasHint: 'The directory name on disk is unchanged: terminals, file managers and other path-based UI still show the real name.',
-  featureProjectMenuDescNew: 'Switch folder, open folder and copy path in the project "More" menu. Renaming is built in since ZCode 3.16.1 ("Edit project"), so the custom alias is retired.',
+  featureProjectMenuDescNew: 'Open folder and copy path in the project "More" menu. Renaming is built in since ZCode 3.16.1 ("Edit project"), so the custom alias is retired.',
   aliasMigrateTitle: 'Migrate project aliases',
   aliasMigrateDesc: 'This ZCode supports renaming projects (project "More" menu → Edit project), so the custom alias feature is retired. Write your saved aliases into the official project names by picking the projects below; only the project name changes, folders on disk are untouched.',
   aliasMigrateItemHint: 'The alias becomes the project name (re-editable anytime via "Edit project"). Only unmarked entries can be checked; migrated, merged, deleted, not-on-this-machine and manually-renamed ones cannot — to rename those projects, use "Edit project" in the project "More" menu directly.',

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);
+}

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

@@ -0,0 +1,121 @@
+// 插件界面沙箱回收：宿主为每个插件交互卡片（识图卡片、压缩记录、评审面板等）
+// 保留一个沙箱，全局上限 64 个（主进程注册表与窗口页面管理器各一道闸），已卸下
+// 的名额默认要等 6 小时 TTL 才自动回收——多卡片会话很快把名额耗尽，之后所有新
+// 卡片报“插件界面数量已达上限”。本功能平时不动作，只在沙箱数量达到上限
+//（sandboxReclaimBudget，默认 60，8–64；留少量余量，避免新卡片抢名额时恰好撞上
+// 64 硬上限）时，调用官方桥 window.zcodePluginSandbox.disposeSandbox 释放最早
+// 创建的沙箱，把数量压回上限以下：被释放的卡片位置退回占位（可能显示已停止
+// 提示），重新打开所在会话即恢复，会话文本内容不受影响。
+//
+// 驱逐顺序：最早创建的优先，但可见的（正在查看的卡片）排最后——先在不可见
+// 沙箱里挑最早的；全部可见时才动最早创建的可见沙箱。
+//
+// 观察手段均为宿主稳定标识，不依赖压缩后的内部变量名：
+// 1) window 消息 zcode:plugin-sandbox-ports：沙箱端口建立时广播 {sandboxId, initId}；
+// 2) webview[data-zcode-retained-sandbox]：src 含 /instance/<sandboxId>/；
+// 3) 可见性：webview 所在页根 div[data-sandbox-page-root] 的 opacity——展示中的
+//    页根 opacity:1 且按卡片占位几何摆放；卡片切走/滚下后宿主把页根收进停靠区
+//   （[data-sandbox-page-parking] 下，opacity:0.001 + inert 或 display:none）。
+//    页根是固定定位、DOM 挂载点与视觉位置解耦，不能按父容器判断可见性。
+//
+// 窗口最小化/后台不改变布局尺寸，可见性判定不受影响（最小化期间不驱逐）。
+// 开关：features.sandboxReclaim（默认开）。
+import { getConfig } from '../core.js';
+
+const CHECK_MS = 30_000;       // 巡检周期
+const MIN_BUDGET = 8;
+const MAX_BUDGET = 64;
+const RETRY_COOLDOWN_MS = 10 * 60_000;  // 同一沙箱释放失败后的重试冷却
+
+const seen = new Map();     // sandboxId → { initId, firstSeen }
+const cooldown = new Map(); // sandboxId → 释放失败冷却截止时刻
+let disabledLogged = false;
+
+function onPortsMessage(e) {
+  const d = e.data;
+  if (!d || d.type !== 'zcode:plugin-sandbox-ports' || typeof d.sandboxId !== 'string') return;
+  // 端口广播≈沙箱创建时刻；页面刷新后宿主按幂等键复用同一沙箱并再次广播，
+  // 创建时刻随之刷新（视作新名额重新排队）
+  seen.set(d.sandboxId, { initId: Number(d.initId) || 0, firstSeen: Date.now() });
+}
+
+function extractSandboxId(wv) {
+  const m = /instance\/(sb-[0-9a-f]+)\//.exec(wv.getAttribute('src') || '');
+  return m ? m[1] : null;
+}
+
+// 展示中的页根 opacity:1 且按卡片占位几何摆放；停靠保活的页根 opacity:0.001 +
+// inert（或 display:none）。宿主用固定定位按占位几何摆放页根，DOM 挂载点不代表
+// 视觉位置（可见卡片的页根也可能挂在停靠容器下），因此按 opacity 与布局判定
+function isVisible(wv) {
+  const root = wv.closest('[data-sandbox-page-root]');
+  if (!root) return wv.getClientRects().length > 0;
+  if (!root.getClientRects().length) return false;
+  return Number(getComputedStyle(root).opacity) > 0.5;
+}
+
+async function tick() {
+  const cfg = await getConfig();
+  if ((cfg.features || {}).sandboxReclaim === false) {
+    seen.clear();
+    return;
+  }
+  // 沙箱桥只在宿主主窗口存在（guest 沙箱页与旧版宿主没有）：不在时静默跳过
+  const bridge = window.zcodePluginSandbox;
+  if (!bridge || typeof bridge.disposeSandbox !== 'function') {
+    if (!disabledLogged) {
+      disabledLogged = true;
+      console.info('[zcodepro] sandbox-reclaim: 当前窗口无 zcodePluginSandbox 桥，沙箱回收跳过');
+    }
+    return;
+  }
+  let budget = Number(cfg.sandboxReclaimBudget);
+  if (!Number.isFinite(budget)) budget = 60;
+  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]')) {
+    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 });
+  }
+
+  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];
+    const entry = seen.get(id);
+    try {
+      await bridge.disposeSandbox(id, entry && entry.initId);
+      console.info('[zcodepro] sandbox-reclaim: 沙箱满 ' + live.size + ' 个，已驱逐最早的 ' + id);
+    } catch (err) {
+      console.warn('[zcodepro] sandbox-reclaim: 释放失败 ' + id, err);
+    }
+    seen.delete(id);
+    live.delete(id);
+    cooldown.set(id, now + RETRY_COOLDOWN_MS);
+  }
+  if (cooldown.size > 256) {
+    for (const [k, v] of cooldown) {
+      if (v <= now) cooldown.delete(k);
+    }
+  }
+}
+
+export function startSandboxReclaim() {
+  window.addEventListener('message', onPortsMessage);
+  const loop = () => { tick().catch(() => { /* 单次巡检失败不影响后续 */ }); };
+  loop();
+  setInterval(loop, CHECK_MS);
+}