@xiaou66/vite-plugin-vue-mcp-next 1.0.3 → 1.0.4

package/README.md

@@ -402,7 +402,7 @@ export function createMaskPlugin(options: { selectors: string[] }) {
 
 | 工具             | 输入                      | 输出                            | 说明                                                              |
 | ---------------- | ------------------------- | ------------------------------- | ----------------------------------------------------------------- |
-| `list_pages`     | 无                        | `entries`、`pages`、`cdpError?` | 返回 Vite HTML 入口、runtime 页面和 CDP target                    |
+| `list_pages`     | `includeDisconnected?`    | `entries`、`pages`、`cdpError?` | 返回 Vite HTML 入口、runtime 页面和 CDP target                    |
 | `reload_page`    | `pageId?`、`ignoreCache?` | `ok`、`source`、`ignoreCache?`  | 刷新目标页面；CDP 可用时使用无缓存刷新，Runtime Hook 只能普通刷新 |
 
 `list_pages` 的 `pages` 中可能出现两类页面：
@@ -410,6 +410,8 @@ export function createMaskPlugin(options: { selectors: string[] }) {
 - `runtime-*`：由页面注入 runtime bridge 后连接
 - `cdp:*`：由 CDP `/json/list` 发现
 
+runtime 页面会为同一个浏览器标签页维护稳定 client id。刷新或 HMR 重连后，新 `pageId` 会成为可操作目标，旧 `pageId` 会被标记为 `connected: false` 并在默认 `list_pages` 结果中隐藏；需要排查页面生命周期时可传 `includeDisconnected: true` 查看断开记录。断开的 runtime 记录保留 5 分钟后会被清理，同 URL 的不同标签页仍会保留为不同目标。
+
 `reload_page` 默认在 CDP 路径使用 `ignoreCache: true`，并等待 CDP `loadEventFired` 后返回，适合在测试前绕过浏览器 HTTP 缓存重新加载页面。未配置 CDP 时会退回 Runtime Hook，通过 `window.location.reload()` 触发普通刷新，并等待新的 runtime 页面重新接入；这条回退路径不能保证绕过 HTTP cache，也不会清理 `localStorage`、`sessionStorage`、`IndexedDB`、`CacheStorage` 或 Service Worker 缓存。
 
 ### DOM 工具

package/dist/index.cjs

@@ -231,24 +231,64 @@ function createRingBuffer(capacity) {
 }
 
 // src/context.ts
+var MINUTE_MS = 60 * 1e3;
+var DISCONNECTED_RUNTIME_TARGET_RETENTION_MS = 5 * MINUTE_MS;
+function shouldPruneDisconnectedRuntimeTarget(target, now) {
+  return target.source === "runtime" && !target.connected && typeof target.disconnectedAt === "number" && now - target.disconnectedAt > DISCONNECTED_RUNTIME_TARGET_RETENTION_MS;
+}
+function pruneDisconnectedRuntimeTargets(targets, now) {
+  for (const [pageId, target] of targets) {
+    if (shouldPruneDisconnectedRuntimeTarget(target, now)) {
+      targets.delete(pageId);
+    }
+  }
+}
+function markTargetDisconnected(target, now) {
+  return {
+    ...target,
+    connected: false,
+    disconnectedAt: target.disconnectedAt ?? now
+  };
+}
+function shouldListPageTarget(target, options) {
+  return options.includeDisconnected === true || target.source !== "runtime" || target.connected;
+}
+function disconnectPreviousRuntimeClientTarget(targets, target, now) {
+  if (target.source !== "runtime" || !target.runtimeClientId) {
+    return;
+  }
+  for (const [pageId, currentTarget] of targets) {
+    if (pageId === target.pageId || currentTarget.source !== "runtime" || currentTarget.runtimeClientId !== target.runtimeClientId || !currentTarget.connected) {
+      continue;
+    }
+    targets.set(pageId, markTargetDisconnected(currentTarget, now));
+  }
+}
 function createPageTargetRegistry() {
   const targets = /* @__PURE__ */ new Map();
   return {
-    upsert(target) {
+    upsert(target, now = Date.now()) {
+      pruneDisconnectedRuntimeTargets(targets, now);
+      disconnectPreviousRuntimeClientTarget(targets, target, now);
       targets.set(target.pageId, target);
     },
     get(pageId) {
       return targets.get(pageId);
     },
-    list() {
-      return [...targets.values()];
+    list(options = {}) {
+      const now = options.now ?? Date.now();
+      pruneDisconnectedRuntimeTargets(targets, now);
+      return [...targets.values()].filter(
+        (target) => shouldListPageTarget(target, options)
+      );
     },
-    disconnect(pageId) {
+    disconnect(pageId, now = Date.now()) {
+      pruneDisconnectedRuntimeTargets(targets, now);
       const target = targets.get(pageId);
       if (!target) {
         return;
       }
-      targets.set(pageId, { ...target, connected: false });
+      targets.set(pageId, markTargetDisconnected(target, now));
     }
   };
 }
@@ -701,9 +741,12 @@ function registerPageTools(server, ctx, vite) {
   server.registerTool(
     MCP_TOOL_NAMES.listPages,
     {
-      description: "List Vite page entries and connected runtime/CDP targets."
+      description: "List Vite page entries and connected runtime/CDP targets.",
+      inputSchema: {
+        includeDisconnected: import_zod5.z.boolean().optional()
+      }
     },
-    async () => {
+    async (input) => {
       const cdpResult = await listCdpPageTargets(ctx);
       for (const target of cdpResult.pages) {
         ctx.pages.upsert(target);
@@ -711,7 +754,9 @@ function registerPageTools(server, ctx, vite) {
       }
       return createToolResponse({
         entries: discoverHtmlEntries(vite),
-        pages: ctx.pages.list(),
+        pages: ctx.pages.list({
+          includeDisconnected: input.includeDisconnected
+        }),
         cdpError: cdpResult.error
       });
     }
@@ -2335,7 +2380,7 @@ function isRuntimePageTarget(payload) {
     return false;
   }
   const target = payload;
-  return target.source === "runtime" && typeof target.pageId === "string" && typeof target.url === "string" && typeof target.pathname === "string" && typeof target.connected === "boolean";
+  return target.source === "runtime" && typeof target.pageId === "string" && typeof target.url === "string" && typeof target.pathname === "string" && typeof target.connected === "boolean" && (target.runtimeClientId === void 0 || typeof target.runtimeClientId === "string");
 }
 function isConsoleRecord(payload) {
   if (!payload || typeof payload !== "object") {