@xiaou66/vite-plugin-vue-mcp-next 1.3.6 → 1.3.7

package/dist/{types-Ct73MnH0.d.cts → types-DA9dLKJ8.d.cts}

@@ -803,6 +803,47 @@ interface ConsoleRecord {
     /** 记录时间戳，用于还原日志与网络请求、用户操作之间的先后关系。 */
     readonly timestamp: number;
 }
+/**
+ * Runtime Console 参数 inspect 请求。
+ *
+ * 该请求只在 AI 明确需要查看对象内容时触发，预算参数用于限制页面主线程上的读取成本。
+ */
+interface RuntimeConsoleArgInspectRequest {
+    /** 并发隔离事件名，服务端用它等待对应 runtime 回调；直接测试 registry 时可省略。 */
+    readonly event?: string;
+    /** 来自 ConsoleArgReference 的临时对象引用 ID。 */
+    readonly argId: string;
+    /** 最大递归深度，默认由 runtime 侧的序列化工具兜底。 */
+    readonly maxDepth?: number;
+    /** 单个对象最多读取的 key 数量。 */
+    readonly maxKeys?: number;
+    /** 单个数组最多读取的元素数量。 */
+    readonly maxArrayItems?: number;
+    /** 单个字符串最多保留的长度。 */
+    readonly maxStringLength?: number;
+    /** 单次 inspect 最多访问的对象或数组节点数量。 */
+    readonly maxTotalNodes?: number;
+}
+/**
+ * Runtime Console 参数 inspect 结果。
+ *
+ * 引用过期或页面刷新时返回结构化错误，避免 MCP 客户端把空结果误解为对象为空。
+ */
+type RuntimeConsoleArgInspectResult = {
+    /** 表示 inspect 成功。 */
+    readonly ok: true;
+    /** 被读取的临时对象引用 ID。 */
+    readonly argId: string;
+    /** 有预算的对象快照，仍然不是原对象的无损拷贝。 */
+    readonly preview: unknown;
+} | {
+    /** 表示引用不可用或读取失败。 */
+    readonly ok: false;
+    /** 被请求的临时对象引用 ID。 */
+    readonly argId: string;
+    /** 给 AI 展示的失败原因。 */
+    readonly error: string;
+};
 /**
  * 页面网络请求的统一记录。
  *
@@ -946,6 +987,10 @@ interface VueRuntimeRpc {
     manageStorage(options: RuntimeStorageRequest): void | Promise<void>;
     /** 回传 Runtime 存储访问结果，使用事件名隔离并发 MCP 请求。 */
     onStorageUpdated(event: string, data: RuntimeStorageResult): void;
+    /** 按需读取 console 日志中的对象参数，避免日志采集阶段自动遍历复杂对象。 */
+    inspectConsoleArg(options: RuntimeConsoleArgInspectRequest): void | Promise<void>;
+    /** 回传 console 对象参数 inspect 结果。 */
+    onConsoleArgInspected(event: string, data: RuntimeConsoleArgInspectResult): void;
     /** 读取 Vue component inspector tree，用于 `get_component_tree` 工具。 */
     getInspectorTree(options: {
         event: string;

package/dist/{types-Ct73MnH0.d.ts → types-DA9dLKJ8.d.ts}

@@ -803,6 +803,47 @@ interface ConsoleRecord {
     /** 记录时间戳，用于还原日志与网络请求、用户操作之间的先后关系。 */
     readonly timestamp: number;
 }
+/**
+ * Runtime Console 参数 inspect 请求。
+ *
+ * 该请求只在 AI 明确需要查看对象内容时触发，预算参数用于限制页面主线程上的读取成本。
+ */
+interface RuntimeConsoleArgInspectRequest {
+    /** 并发隔离事件名，服务端用它等待对应 runtime 回调；直接测试 registry 时可省略。 */
+    readonly event?: string;
+    /** 来自 ConsoleArgReference 的临时对象引用 ID。 */
+    readonly argId: string;
+    /** 最大递归深度，默认由 runtime 侧的序列化工具兜底。 */
+    readonly maxDepth?: number;
+    /** 单个对象最多读取的 key 数量。 */
+    readonly maxKeys?: number;
+    /** 单个数组最多读取的元素数量。 */
+    readonly maxArrayItems?: number;
+    /** 单个字符串最多保留的长度。 */
+    readonly maxStringLength?: number;
+    /** 单次 inspect 最多访问的对象或数组节点数量。 */
+    readonly maxTotalNodes?: number;
+}
+/**
+ * Runtime Console 参数 inspect 结果。
+ *
+ * 引用过期或页面刷新时返回结构化错误，避免 MCP 客户端把空结果误解为对象为空。
+ */
+type RuntimeConsoleArgInspectResult = {
+    /** 表示 inspect 成功。 */
+    readonly ok: true;
+    /** 被读取的临时对象引用 ID。 */
+    readonly argId: string;
+    /** 有预算的对象快照，仍然不是原对象的无损拷贝。 */
+    readonly preview: unknown;
+} | {
+    /** 表示引用不可用或读取失败。 */
+    readonly ok: false;
+    /** 被请求的临时对象引用 ID。 */
+    readonly argId: string;
+    /** 给 AI 展示的失败原因。 */
+    readonly error: string;
+};
 /**
  * 页面网络请求的统一记录。
  *
@@ -946,6 +987,10 @@ interface VueRuntimeRpc {
     manageStorage(options: RuntimeStorageRequest): void | Promise<void>;
     /** 回传 Runtime 存储访问结果，使用事件名隔离并发 MCP 请求。 */
     onStorageUpdated(event: string, data: RuntimeStorageResult): void;
+    /** 按需读取 console 日志中的对象参数，避免日志采集阶段自动遍历复杂对象。 */
+    inspectConsoleArg(options: RuntimeConsoleArgInspectRequest): void | Promise<void>;
+    /** 回传 console 对象参数 inspect 结果。 */
+    onConsoleArgInspected(event: string, data: RuntimeConsoleArgInspectResult): void;
     /** 读取 Vue component inspector tree，用于 `get_component_tree` 工具。 */
     getInspectorTree(options: {
         event: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiaou66/vite-plugin-vue-mcp-next",
-  "version": "1.3.6",
+  "version": "1.3.7",
   "description": "Runtime DevTools MCP plugin for Vite and Vue development.",
   "type": "module",
   "private": false,

package/skills/vite-mcp-next/SKILL.md

@@ -1,4 +1,3 @@
-<!-- Generated by vite-plugin-vue-mcp-next. Safe to edit, but automatic updates only apply while this marker remains. -->
 ---
 name: vite-mcp-next
 description: Use when debugging Vite + Vue local pages with vite-plugin-vue-mcp-next MCP, including DOM, screenshots, console logs, network requests, Vue components, router, or Pinia state.
@@ -30,6 +29,7 @@ Do not use it for static code-only questions where reading files is enough.
 | Find elements by selector | `query_dom` |
 | Capture visual evidence | `take_screenshot` |
 | Read browser logs | `get_console_logs` |
+| Inspect one runtime console object argument | `inspect_console_arg` |
 | Reset old browser logs | `clear_console_logs` |
 | Inspect requests | `get_network_requests` |
 | Inspect one request deeply | `get_network_request_detail` |
@@ -50,7 +50,7 @@ Do not use it for static code-only questions where reading files is enough.
 2. If the user provides an `elementId` such as `src/App.vue:12:8`, call `get_element_context` before editing source.
 3. For layout or content questions, call `get_dom_tree` or `query_dom`.
 4. For visual verification, call `take_screenshot` and report whether `source` is `cdp` or `snapdom`.
-5. For browser errors, call `get_console_logs`.
+5. For browser errors, call `get_console_logs`; if a runtime Hook log contains an object argument with `argId`, call `inspect_console_arg` only when that object detail is needed.
 6. For API behavior, call `get_network_requests`, then `get_network_request_detail` for the relevant id.
 7. For storage questions, call `list_storage` first, then `get_storage_item`, `set_storage_item`, `delete_storage_item`, or `clear_storage` for the selected scope.
 8. For Vue-specific behavior, call `get_component_tree`, `get_component_state`, `get_router_info`, `get_pinia_tree`, or `get_pinia_state`.