zcode-pro 1.1.0 → 1.2.0

package/README.en.md

@@ -23,6 +23,7 @@ ZCode Pro enhances the ZCode desktop UI. No client files are modified; just laun
 | Idle project memory reclaim | Projects unused for a while with no running tasks release their memory automatically, and unused ones are reclaimed once after startup; sessions are untouched and reload when reopened (durations adjustable) |
 | Plugin card sandbox reclaim | 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 (cap adjustable) |
 | Sidebar menu in the top bar | Turns "New task / Search / Automations / Plugin store" into icon buttons in the top navigation bar: hover shows the name, highlighted while its view is open, shortcuts still work |
+| Plugin panels on the new tab page | 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 |
 | Collapsible Pinned section | The sidebar "Pinned" header collapses/expands its task list; the state is remembered |
 | File menu actions | Adds "Open with default app" and "Reveal in file manager" to file links in chat |
 | Copy image | Right-click an image in chat or the enlarged preview to copy it to the clipboard |

package/README.md

@@ -23,6 +23,7 @@ ZCode 桌面版界面增强工具。不修改客户端文件，通过 ZCode Pro
 | 空闲项目内存回收 | 长时间未使用且无任务运行的项目自动释放其占用的内存，启动后也会自动回收一次未使用的项目；会话记录不受影响，再次打开时自动恢复（时长可调） |
 | 插件界面沙箱回收 | 插件卡片沙箱数量达到上限时释放最早创建的（正在查看的排最后），避免 64 个名额耗尽后新卡片打不开；被释放的旧卡片重新打开所在会话即恢复（上限可调） |
 | 侧栏菜单并入顶栏 | “新建任务 / 搜索 / 自动化 / 插件市场”收成顶部导航栏的图标按钮：悬停显示名称，对应界面打开时高亮，快捷键照常可用 |
+| 新标签页插件面板入口 | 官方“新标签页”只列官方面板与推荐的官方插件；本功能把第三方市场插件（headroom、rtk 等）的面板卡片加进去，点击在侧边面板打开 |
 | 已置顶分区可折叠 | 侧边栏“已置顶”标题可点击折叠/展开其任务列表，状态记住 |
 | 文件菜单增强 | 会话中文件链接的右键菜单新增“默认应用打开”“打开所在目录” |
 | 复制图片 | 右键会话中的图片或放大的预览图，复制到剪贴板 |

package/dist/inject.js

@@ -255,6 +255,10 @@
     switcherUnseen: "\u672A\u67E5\u770B",
     switcherAttentionHint: "\u8FD0\u884C\u4E2D / \u8FD0\u884C\u5B8C\u672A\u67E5\u770B\u7684\u4EFB\u52A1 \xB7 {prev} / {next} \u6216 \u2191 / \u2193 \u9009\u62E9\uFF0CEnter \u6216\u677E\u5F00 alt \u5207\u6362",
     switcherAttentionEmpty: "\u6682\u65E0\u8FD0\u884C\u4E2D\u6216\u672A\u67E5\u770B\u7684\u4EFB\u52A1",
+    featureNewtabPanels: "\u65B0\u6807\u7B7E\u9875\u63D2\u4EF6\u9762\u677F\u5165\u53E3",
+    featureNewtabPanelsDesc: "\u5B98\u65B9\u201C\u65B0\u6807\u7B7E\u9875\u201D\u53EA\u5217\u5B98\u65B9\u9762\u677F\u4E0E\u63A8\u8350\u7684\u5B98\u65B9\u63D2\u4EF6\uFF0C\u6B64\u529F\u80FD\u628A\u7B2C\u4E09\u65B9\u5E02\u573A\u63D2\u4EF6\uFF08headroom\u3001rtk \u7B49\uFF09\u7684\u9762\u677F\u5361\u7247\u52A0\u8FDB\u53BB\uFF0C\u70B9\u51FB\u5728\u4FA7\u8FB9\u9762\u677F\u6253\u5F00\u3002",
+    ntpDescSuffix: "\u63D2\u4EF6\u9762\u677F",
+    ntpNeedSession: "\u5148\u6253\u5F00\u4E00\u4E2A\u4EFB\u52A1\u4F1A\u8BDD\uFF0C\u518D\u4ECE\u65B0\u6807\u7B7E\u9875\u6253\u5F00\u63D2\u4EF6\u9762\u677F",
     tabShortcuts: "\u5FEB\u6377\u952E",
     hkTitle: "\u4F1A\u8BDD\u5FEB\u6377\u5207\u6362",
     hkAltZ: "\u5728\u5F53\u524D\u4E0E\u4E0A\u6B21\u4F7F\u7528\u7684\u4F1A\u8BDD\u95F4\u6765\u56DE\u5207\u6362",
@@ -675,6 +679,10 @@
     switcherUnseen: "unseen",
     switcherAttentionHint: "Running / finished but unseen tasks \xB7 {prev} / {next} or \u2191 / \u2193 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, \u2026) 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",
@@ -2842,10 +2850,10 @@
   function startImageMenu() {
     if (typeof window === "undefined") return;
     if (typeof navigator.clipboard?.write !== "function" || typeof window.ClipboardItem === "undefined") return;
-    let enabled6 = true;
+    let enabled7 = true;
     const refresh = () => {
       void getConfig().then((c) => {
-        enabled6 = !(c.features && c.features.imageCopy === false);
+        enabled7 = !(c.features && c.features.imageCopy === false);
       });
     };
     refresh();
@@ -2854,7 +2862,7 @@
       const img = copyTargetOf(e.target, e.clientX, e.clientY);
       if (!img) return;
       e.preventDefault();
-      if (enabled6) showMenu(e.clientX, e.clientY, img);
+      if (enabled7) showMenu(e.clientX, e.clientY, img);
       refresh();
     }, true);
   }
@@ -4002,6 +4010,11 @@
               if (await setFeature("wsRunningSpin", next)) f.wsRunningSpin = next;
               refreshRows();
             }),
+            settingRow(L.featureNewtabPanels, L.featureNewtabPanelsDesc, f.newtabPanels !== false, async () => {
+              const next = !(f.newtabPanels !== false);
+              if (await setFeature("newtabPanels", next)) f.newtabPanels = next;
+              refreshRows();
+            }),
             (() => {
               const repoLink = h("span", {
                 class: "cursor-pointer underline-offset-4 hover:underline",
@@ -7417,6 +7430,191 @@
     window.addEventListener("blur", () => closePopup(false));
   }
 
+  // src/inject/features/newtab-panels.js
+  var GRID_HINTS = ["\u8FD0\u884C\u547D\u4EE4\u548C\u67E5\u770B\u8F93\u51FA", "Run commands and view output"];
+  var OFFICIAL_SUFFIX = "@zcode-plugins-official";
+  var OPEN_FN_MARK = "\u6253\u5F00\u63D2\u4EF6 UI";
+  var enabled3 = true;
+  var injectTimer = 0;
+  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 > 2e5) return;
+      visited++;
+      if (visit(f)) return true;
+      return walk(f.child) || walk(f.sibling);
+    };
+    walk(rootEl[key]);
+  }
+  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;
+  }
+  function findBridge() {
+    let holder = null;
+    const seen = /* @__PURE__ */ new Set();
+    const scan4 = (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") scan4(v);
+    };
+    eachFiber((f) => {
+      for (const h2 of [f.memoizedProps, f.memoizedState]) {
+        if (!h2 || typeof h2 !== "object") continue;
+        scan4(h2);
+        if (holder) return true;
+      }
+      return false;
+    });
+    return holder;
+  }
+  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;
+  }
+  var 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"/>'];
+  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((h2) => text.includes(h2)) ? 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;
+    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) {
+      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 || "") + " \xB7 " + 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);
+      }
+      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 {
+          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] \u6253\u5F00\u63D2\u4EF6\u9762\u677F\u5931\u8D25", e);
+          showToast(L.ntpNeedSession, "error");
+        }
+      });
+      grid.append(card);
+    }
+  }
+  function tryInject() {
+    if (!enabled3 || document.hidden) return;
+    const grid = findNewTabGrid();
+    if (!grid) return;
+    if (grid.dataset.zcodeproPanels && !grid.querySelector("[data-zcodepro-panel]")) {
+      delete grid.dataset.zcodeproPanels;
+    }
+    void injectPanels(grid);
+  }
+  function startNewtabPanels() {
+    ensureStyle();
+    const refreshEnabled = () => {
+      void getConfig().then((cfg) => {
+        enabled3 = cfg.features ? cfg.features.newtabPanels !== false : true;
+      }).catch(() => {
+      });
+    };
+    refreshEnabled();
+    window.addEventListener("zcodepro:config-changed", refreshEnabled);
+    const observer2 = new MutationObserver(() => {
+      if (injectTimer) return;
+      injectTimer = setTimeout(() => {
+        injectTimer = 0;
+        tryInject();
+      }, 300);
+    });
+    observer2.observe(document.body, { childList: true, subtree: true });
+    setInterval(tryInject, 5e3);
+  }
+
   // src/inject/features/title-lock.js
   var TASK_SEL2 = "[data-task-item-key]";
   var SCAN_DEBOUNCE_MS3 = 150;
@@ -7427,7 +7625,7 @@
   var MAP_REFRESH_MS = 6e4;
   var installed3 = false;
   var seenRows = /* @__PURE__ */ new WeakSet();
-  var enabled3 = true;
+  var enabled4 = true;
   var pinned = null;
   var resolved = false;
   var fetching = null;
@@ -7451,8 +7649,8 @@
       const res = await rpc("/pinned-titles");
       if (!res || !res.ok) return null;
       resolved = true;
-      enabled3 = res.enabled !== false;
-      if (!enabled3) {
+      enabled4 = res.enabled !== false;
+      if (!enabled4) {
         pinned = null;
         return null;
       }
@@ -7467,7 +7665,7 @@
     }
   }
   function isMismatch(item) {
-    if (!enabled3 || !pinned) return null;
+    if (!enabled4 || !pinned) return null;
     const key = item.getAttribute("data-task-item-key") || "";
     const want = pinned.get(sessIdOf(key));
     if (want === void 0) return null;
@@ -7485,7 +7683,7 @@
   }
   function scheduleEnforce(key, { immediate = false } = {}) {
     if (immediate) {
-      if (enabled3 && pinned) {
+      if (enabled4 && pinned) {
         const want = pinned.get(sessIdOf(key));
         if (want !== void 0) {
           for (const item of findRows(key)) {
@@ -7526,7 +7724,7 @@
     }
   }
   function scan3() {
-    if (!enabled3 || !pinned || pinned.size === 0) return;
+    if (!enabled4 || !pinned || pinned.size === 0) return;
     for (const item of document.querySelectorAll(TASK_SEL2)) {
       const key = isMismatch(item);
       if (!key) {
@@ -7572,7 +7770,7 @@
         return;
       }
       mapRefreshTimer = 0;
-      if (enabled3 && resolved) void fetchPinned().then((m) => {
+      if (enabled4 && resolved) void fetchPinned().then((m) => {
         if (m) scan3();
       });
     };
@@ -7618,7 +7816,7 @@
       renameCtx = null;
       return;
     }
-    if (!enabled3 || !pinned) return;
+    if (!enabled4 || !pinned) return;
     const want = pinned.get(sessIdOf(renameCtx.key));
     if (want === void 0) return;
     for (const el of document.querySelectorAll('[role="dialog"] input, [role="dialog"] textarea, [role="dialog"] [contenteditable="true"]')) {
@@ -7981,7 +8179,7 @@
   var SCAN_FALLBACK_MS5 = 5e3;
   var ROW_SEL = "[data-task-item-key]";
   var MENU_SEL = '[data-testid="task-new-button"], [data-testid="automations-open"], [data-testid="plugin-store-sidebar-open"], [data-testid="sidebar-search-open"], [data-slot="command"], [data-testid="desktop-top-nav-back"]';
-  var enabled4 = true;
+  var enabled5 = true;
   var rowEl = null;
   var origs = null;
   var syncTimer = 0;
@@ -8124,7 +8322,7 @@
     return scroll.getBoundingClientRect().width < NARROW_SIDEBAR_PX;
   }
   function sync() {
-    if (!enabled4) return;
+    if (!enabled5) return;
     const parts = findParts();
     if (!parts) {
       if (rowEl) rowEl.style.display = "none";
@@ -8186,8 +8384,8 @@
   }
   async function refreshConfig2() {
     const cfg = await getConfig(true).catch(() => null);
-    enabled4 = !cfg || !cfg.features || cfg.features.toolbarIcons !== false;
-    if (enabled4) sync();
+    enabled5 = !cfg || !cfg.features || cfg.features.toolbarIcons !== false;
+    if (enabled5) sync();
     else teardown();
   }
   function startToolbarIcons() {
@@ -8213,7 +8411,7 @@
   var STORE_KEY = "zcodepro:pinned-collapsed";
   var SYNC_DEBOUNCE_MS2 = 300;
   var SCAN_FALLBACK_MS6 = 5e3;
-  var enabled5 = true;
+  var enabled6 = true;
   var syncTimer2 = 0;
   function findPinnedHeader() {
     for (const h3 of document.querySelectorAll("h3")) {
@@ -8270,7 +8468,7 @@
     }
     h3.classList.add(HEAD_CLASS);
     h3.addEventListener("click", () => {
-      if (enabled5) toggle();
+      if (enabled6) toggle();
     });
     const btn = h("button", {
       type: "button",
@@ -8279,7 +8477,7 @@
       "aria-expanded": collapsed ? "false" : "true",
       onClick: (e) => {
         e.stopPropagation();
-        if (enabled5) toggle();
+        if (enabled6) toggle();
       }
     });
     btn.append(chevronSvg());
@@ -8287,7 +8485,7 @@
     return true;
   }
   function sync2() {
-    if (enabled5) apply2();
+    if (enabled6) apply2();
   }
   function scheduleSync2() {
     if (syncTimer2) return;
@@ -8316,8 +8514,8 @@
   }
   async function refreshConfig3() {
     const cfg = await getConfig(true).catch(() => null);
-    enabled5 = !cfg || !cfg.features || cfg.features.pinnedCollapse !== false;
-    if (enabled5) sync2();
+    enabled6 = !cfg || !cfg.features || cfg.features.pinnedCollapse !== false;
+    if (enabled6) sync2();
     else teardown2();
   }
   function startPinnedCollapse() {
@@ -8436,6 +8634,10 @@
         startToolbarIcons();
       } catch {
       }
+      try {
+        startNewtabPanels();
+      } catch {
+      }
       try {
         startPinnedCollapse();
       } catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zcode-pro",
-  "version": "1.1.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.1.0';
+const VERSION = '1.2.0';
 
 // 全局提示词固定在用户主目录：官方加载器按 HOME/USERPROFILE 拼 .zcode/AGENTS.md，
 // 不读 ZCODE_DATA_BASE_DIR（数据根迁走时全局指令仍在原位）。

package/src/inject/core.js

@@ -265,6 +265,10 @@ const zh = {
   switcherUnseen: '未查看',
   switcherAttentionHint: '运行中 / 运行完未查看的任务 · {prev} / {next} 或 ↑ / ↓ 选择，Enter 或松开 alt 切换',
   switcherAttentionEmpty: '暂无运行中或未查看的任务',
+  featureNewtabPanels: '新标签页插件面板入口',
+  featureNewtabPanelsDesc: '官方“新标签页”只列官方面板与推荐的官方插件，此功能把第三方市场插件（headroom、rtk 等）的面板卡片加进去，点击在侧边面板打开。',
+  ntpDescSuffix: '插件面板',
+  ntpNeedSession: '先打开一个任务会话，再从新标签页打开插件面板',
   tabShortcuts: '快捷键',
   hkTitle: '会话快捷切换',
   hkAltZ: '在当前与上次使用的会话间来回切换',
@@ -686,6 +690,10 @@ 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',
   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);
+}

package/src/inject/features/settings-dialog.js

@@ -360,6 +360,11 @@ export function openSettingsDialog() {
             if (await setFeature('wsRunningSpin', next)) f.wsRunningSpin = next;
             refreshRows();
           }),
+          settingRow(L.featureNewtabPanels, L.featureNewtabPanelsDesc, f.newtabPanels !== false, async () => {
+            const next = !(f.newtabPanels !== false);
+            if (await setFeature('newtabPanels', next)) f.newtabPanels = next;
+            refreshRows();
+          }),
           (() => {
             // 标题 = “自动更新 duanluan/zcode-plugins 插件”，仓库名可点击跳转仓库
             const repoLink = h('span', {

package/src/inject/index.js

@@ -10,6 +10,7 @@ import { startAliasWatcher } from './features/alias.js';
 import { startAliasMigrationWatcher } from './features/alias-migration.js';
 import { startTaskOrderWatcher } from './features/task-order.js';
 import { startSessionSwitch } from './features/session-switch.js';
+import { startNewtabPanels } from './features/newtab-panels.js';
 import { startTitleLock } from './features/title-lock.js';
 import { startTitleGen } from './features/title-gen.js';
 import { startWsRunningSpin } from './features/ws-running.js';
@@ -58,6 +59,7 @@ import { ensureStyle } from './ui.js';
     try { startWsRunningSpin(); } catch { /* ignore */ }
     try { startIdleReclaim(); } catch { /* ignore */ }
     try { startToolbarIcons(); } catch { /* ignore */ }
+    try { startNewtabPanels(); } catch { /* ignore */ }
     try { startPinnedCollapse(); } catch { /* ignore */ }
     try { startStyleAdjustments(); } catch { /* ignore */ }
     try { startSettingsEntry(); } catch { /* ignore */ }