validpilot-oss 1.1.0

package/tools/browser_highlight.json

@@ -0,0 +1,18 @@
+{
+  "name": "browser_highlight",
+  "description": "高亮页面上的指定元素，便于人类观察和调试。元素会显示红色边框和阴影效果，持续到页面刷新。",
+  "arguments": {
+    "type": "object",
+    "properties": {
+      "selector": {
+        "type": "string",
+        "description": "要高亮的元素选择器"
+      },
+      "color": {
+        "type": "string",
+        "description": "高亮颜色，支持CSS颜色值，默认为红色(red)"
+      }
+    },
+    "required": ["selector"]
+  }
+}

package/tools/browser_hover.json

@@ -0,0 +1,14 @@
+{
+  "name": "browser_hover",
+  "description": "鼠标悬浮到指定元素上，用于触发 hover 效果、tooltip、下拉菜单等",
+  "arguments": {
+    "type": "object",
+    "properties": {
+      "selector": {
+        "type": "string",
+        "description": "目标元素的 CSS 选择器"
+      }
+    },
+    "required": ["selector"]
+  }
+}

package/tools/browser_instrument.json

@@ -0,0 +1,10 @@
+{
+  "name": "browser_instrument",
+  "description": "向当前页面注入运行时调试探针，捕获 fetch/XHR、console error/warn、全局错误、点击、输入、路由和 storage 变化。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "headless": { "type": "boolean", "description": "无浏览器时是否以 headless 模式打开，默认 false" }
+    }
+  }
+}

package/tools/browser_links.json

@@ -0,0 +1,21 @@
+{
+  "name": "browser_links",
+  "description": "提取当前页面所有导航链接和按钮，并按类型分类（导航菜单、首页、登录、注册、管理、设置、用户、搜索、退出、帮助等）。支持SPA应用的按钮提取（不仅是a标签），支持关键词筛选和外部链接过滤。返回链接总数、按钮数、分类统计和可视区域信息。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "filter": {
+        "type": "string",
+        "description": "筛选关键词，只返回URL/文本包含该关键词的链接或按钮（支持SPA按钮文本筛选）"
+      },
+      "includeExternal": {
+        "type": "boolean",
+        "description": "是否包含外部链接，默认false"
+      },
+      "maxLinks": {
+        "type": "number",
+        "description": "最大返回链接数，默认100"
+      }
+    }
+  }
+}

package/tools/browser_locator_suggest.json

@@ -0,0 +1,16 @@
+{
+  "name": "browser_locator_suggest",
+  "description": "基于已有 selector 命中的元素或 target 文本查找可见元素，按可访问属性生成更稳定的推荐选择器、评分、风险和 fallback 列表。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "selector": { "type": "string", "description": "已有选择器，命中元素后基于其属性生成推荐" },
+      "target": { "type": "string", "description": "无 selector 时按可见文本查找目标元素" },
+      "sessionName": { "type": "string", "description": "浏览器会话名称" }
+    },
+    "anyOf": [
+      { "required": ["selector"] },
+      { "required": ["target"] }
+    ]
+  }
+}

package/tools/browser_locator_validate.json

@@ -0,0 +1,12 @@
+{
+  "name": "browser_locator_validate",
+  "description": "验证选择器稳定性，统计匹配数量、可见数量，并按 role/label/placeholder/data-testid/text/id/css/xpath 等规则输出分数、风险、警告和建议。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "selector": { "type": "string", "description": "要验证的 Playwright/CSS/text/role 选择器" },
+      "sessionName": { "type": "string", "description": "浏览器会话名称" }
+    },
+    "required": ["selector"]
+  }
+}

package/tools/browser_network.json

@@ -0,0 +1,16 @@
+{
+  "name": "browser_network",
+  "description": "获取真实浏览器运行过程中采集到的网络请求记录，支持按 URL、方法、状态码和 checkpoint 过滤。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "contains": { "type": "string", "description": "URL 过滤关键字，兼容旧参数" },
+      "urlContains": { "type": "string", "description": "URL 过滤关键字" },
+      "method": { "type": "string", "description": "HTTP 方法，如 GET/POST/PUT" },
+      "statusMin": { "type": "number", "description": "只返回状态码大于等于该值的记录" },
+      "statusMax": { "type": "number", "description": "只返回状态码小于等于该值的记录" },
+      "since": { "type": "string", "description": "ISO 时间戳，只返回该时间之后的记录" },
+      "currentOnly": { "type": "boolean", "description": "是否只返回当前 checkpoint 之后的记录，默认 true" }
+    }
+  }
+}

package/tools/browser_network_detail.json

@@ -0,0 +1,17 @@
+{
+  "name": "browser_network_detail",
+  "description": "查看本轮网络请求详情，包括请求头、响应头、请求体、响应体摘要、耗时和失败原因。输出自动脱敏。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "contains": { "type": "string", "description": "URL 过滤关键字，兼容旧参数" },
+      "urlContains": { "type": "string", "description": "URL 过滤关键字" },
+      "method": { "type": "string", "description": "HTTP 方法，如 GET/POST/PUT" },
+      "statusMin": { "type": "number", "description": "只返回状态码大于等于该值的记录" },
+      "statusMax": { "type": "number", "description": "只返回状态码小于等于该值的记录" },
+      "since": { "type": "string", "description": "ISO 时间戳，只返回该时间之后的记录" },
+      "currentOnly": { "type": "boolean", "description": "是否只返回当前 checkpoint 之后的记录，默认 true" },
+      "limit": { "type": "number", "description": "最多返回记录条数，默认 50" }
+    }
+  }
+}

package/tools/browser_open.json

@@ -0,0 +1,12 @@
+{
+  "name": "browser_open",
+  "description": "打开真实可视化浏览器并导航到目标 URL",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "url": { "type": "string", "description": "要打开的页面 URL" },
+      "headless": { "type": "boolean", "description": "是否无头模式，默认 false，建议可视化验证使用 false" }
+    },
+    "required": ["url"]
+  }
+}

package/tools/browser_performance_check.json

@@ -0,0 +1,25 @@
+{
+  "name": "browser_performance_check",
+  "description": "采集当前页面 navigation、paint、resource、long task、CLS/LCP 和慢请求指标，并按 budgets 输出性能预算结果。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "budgets": {
+        "type": "object",
+        "description": "预算阈值，支持 domContentLoaded、load、fcp、lcp、cls、longTaskCount、resourceCount、slowRequestMs",
+        "properties": {
+          "domContentLoaded": { "type": "number" },
+          "load": { "type": "number" },
+          "fcp": { "type": "number" },
+          "lcp": { "type": "number" },
+          "cls": { "type": "number" },
+          "longTaskCount": { "type": "number" },
+          "resourceCount": { "type": "number" },
+          "slowRequestMs": { "type": "number" }
+        }
+      },
+      "slowRequestMs": { "type": "number", "description": "慢请求阈值毫秒，默认 1000；可覆盖 budgets.slowRequestMs" },
+      "sessionName": { "type": "string", "description": "浏览器会话名称，默认当前活跃会话" }
+    }
+  }
+}

package/tools/browser_press_key.json

@@ -0,0 +1,18 @@
+{
+  "name": "browser_press_key",
+  "description": "在当前页面或指定元素上按下键盘按键，支持单个按键或组合键",
+  "arguments": {
+    "type": "object",
+    "properties": {
+      "key": {
+        "type": "string",
+        "description": "按键名称，如 Enter、Escape、Tab、ArrowDown、Backspace、a、Control+c 等"
+      },
+      "selector": {
+        "type": "string",
+        "description": "可选，在指定元素上按键（先聚焦再按键）"
+      }
+    },
+    "required": ["key"]
+  }
+}

package/tools/browser_quick_fix.json

@@ -0,0 +1,29 @@
+{
+  "name": "browser_quick_fix",
+  "description": "快速修复验证闭环。自动尝试常见修复策略（等待加载、滚动到元素、强制可见、移除遮挡、注入JS等），每步验证是否修复成功。返回修复尝试记录、最终状态、建议的下一步操作。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "selector": {
+        "type": "string",
+        "description": "目标元素选择器（必填）"
+      },
+      "problem": {
+        "type": "string",
+        "description": "问题描述：not_found（元素未找到）、not_visible（不可见）、not_interactable（不可交互）、click_failed（点击失败）、type_failed（输入失败）、js_error（JS错误）",
+        "enum": ["not_found", "not_visible", "not_interactable", "click_failed", "type_failed", "js_error"]
+      },
+      "maxAttempts": {
+        "type": "number",
+        "description": "最大修复尝试次数，默认5"
+      },
+      "waitStrategy": {
+        "type": "string",
+        "description": "等待策略：smart（智能等待）、fixed（固定等待）、none（不等待）",
+        "enum": ["smart", "fixed", "none"],
+        "default": "smart"
+      }
+    },
+    "required": ["selector"]
+  }
+}

package/tools/browser_screenshot.json

@@ -0,0 +1,15 @@
+{
+  "name": "browser_screenshot",
+  "description": "对真实浏览器当前页面截图并保存到 MCP 服务目录。默认遮挡密码、token、apiKey 等敏感输入框。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "name": { "type": "string", "description": "截图文件名，不含扩展名" },
+      "redactSelectors": {
+        "type": "array",
+        "description": "需要额外遮挡的 CSS 选择器列表",
+        "items": { "type": "string" }
+      }
+    }
+  }
+}

package/tools/browser_scroll.json

@@ -0,0 +1,31 @@
+{
+  "name": "browser_scroll",
+  "description": "滚动页面或元素到指定位置，支持 scrollIntoView 和像素滚动",
+  "arguments": {
+    "type": "object",
+    "properties": {
+      "selector": {
+        "type": "string",
+        "description": "要滚动到的目标元素选择器，与 scrollIntoView 配合使用"
+      },
+      "scrollIntoView": {
+        "type": "boolean",
+        "description": "是否滚动到 selector 指定的元素，默认 true（指定 selector 时）"
+      },
+      "x": {
+        "type": "number",
+        "description": "横向滚动像素值（不指定 selector 时使用）"
+      },
+      "y": {
+        "type": "number",
+        "description": "纵向滚动像素值（不指定 selector 时使用）"
+      },
+      "behavior": {
+        "type": "string",
+        "enum": ["auto", "smooth"],
+        "description": "滚动行为，默认 auto"
+      }
+    },
+    "required": []
+  }
+}

package/tools/browser_select.json

@@ -0,0 +1,26 @@
+{
+  "name": "browser_select",
+  "description": "在下拉框(select元素)中选择选项，支持按value值、按label文本、按索引选择。",
+  "arguments": {
+    "type": "object",
+    "properties": {
+      "selector": {
+        "type": "string",
+        "description": "select元素的选择器"
+      },
+      "value": {
+        "type": "string",
+        "description": "要选择的option的value值"
+      },
+      "label": {
+        "type": "string",
+        "description": "要选择的option的显示文本"
+      },
+      "index": {
+        "type": "number",
+        "description": "要选择的option的索引（从0开始）"
+      }
+    },
+    "required": ["selector"]
+  }
+}

package/tools/browser_session_close.json

@@ -0,0 +1,12 @@
+{
+  "name": "browser_session_close",
+  "description": "关闭并删除指定浏览器会话。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "name": { "type": "string", "description": "要关闭的会话名称" },
+      "sessionName": { "type": "string", "description": "会话名称别名" }
+    },
+    "required": ["name"]
+  }
+}

package/tools/browser_session_create.json

@@ -0,0 +1,17 @@
+{
+  "name": "browser_session_create",
+  "description": "创建或复用一个命名浏览器会话。每个会话拥有独立浏览器上下文、cookie、localStorage、console、network、errors 和 events。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "name": { "type": "string", "description": "会话名称，如 free-user、pro-user" },
+      "sessionName": { "type": "string", "description": "会话名称别名" },
+      "url": { "type": "string", "description": "创建后打开的 URL" },
+      "headless": { "type": "boolean", "description": "是否无头模式，默认 false" },
+      "extensionPath": { "type": "string", "description": "要加载的 Chrome 扩展目录路径。提供后使用持久化上下文并强制 headless=false" },
+      "loadExtensionPath": { "type": "string", "description": "extensionPath 的别名，要加载的 Chrome 扩展目录路径" },
+      "timeout": { "type": "number", "description": "导航超时时间，默认 30000ms" }
+    },
+    "required": ["name"]
+  }
+}

package/tools/browser_session_switch.json

@@ -0,0 +1,12 @@
+{
+  "name": "browser_session_switch",
+  "description": "切换当前活跃浏览器会话。后续未指定 sessionName 的浏览器工具会作用于该会话。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "name": { "type": "string", "description": "要切换到的会话名称" },
+      "sessionName": { "type": "string", "description": "会话名称别名" }
+    },
+    "required": ["name"]
+  }
+}

package/tools/browser_sessions.json

@@ -0,0 +1,8 @@
+{
+  "name": "browser_sessions",
+  "description": "列出当前所有浏览器会话，显示活跃会话、URL、创建时间、最后使用时间和 trace 状态。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {}
+  }
+}

package/tools/browser_snapshot.json

@@ -0,0 +1,8 @@
+{
+  "name": "browser_snapshot",
+  "description": "获取当前真实浏览器页面的 URL、标题、可见文本、表单元素与按钮快照",
+  "inputSchema": {
+    "type": "object",
+    "properties": {}
+  }
+}

package/tools/browser_step.json

@@ -0,0 +1,18 @@
+{
+  "name": "browser_step",
+  "description": "记录当前验证步骤证据：截图、DOM 简要快照、本轮统一错误摘要。用于形成可追溯证据链。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "label": { "type": "string", "description": "步骤名称，如 login-after-submit" },
+      "screenshot": { "type": "boolean", "description": "是否截图，默认 true" },
+      "snapshot": { "type": "boolean", "description": "是否采集 DOM 简要快照，默认 true" },
+      "includeWarnings": { "type": "boolean", "description": "错误摘要是否包含 warning" },
+      "redactSelectors": {
+        "type": "array",
+        "description": "截图中额外遮挡的 CSS 选择器",
+        "items": { "type": "string" }
+      }
+    }
+  }
+}

package/tools/browser_storage.json

@@ -0,0 +1,10 @@
+{
+  "name": "browser_storage",
+  "description": "查看当前页面 localStorage、sessionStorage 或 cookie，辅助定位登录态和状态问题",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "scope": { "type": "string", "description": "localStorage、sessionStorage、cookies 或 all，默认 all" }
+    }
+  }
+}

package/tools/browser_trace_start.json

@@ -0,0 +1,14 @@
+{
+  "name": "browser_trace_start",
+  "description": "开始录制 Playwright Trace，用于生成可回放的浏览器调试证据包。建议在 browser_flow 前调用。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "name": { "type": "string", "description": "Trace 名称，不含扩展名" },
+      "screenshots": { "type": "boolean", "description": "是否记录每步截图，默认 true" },
+      "snapshots": { "type": "boolean", "description": "是否记录 DOM 快照，默认 true" },
+      "sources": { "type": "boolean", "description": "是否记录源码，默认 false" },
+      "headless": { "type": "boolean", "description": "无浏览器时是否以 headless 模式打开，默认 false" }
+    }
+  }
+}

package/tools/browser_trace_stop.json

@@ -0,0 +1,10 @@
+{
+  "name": "browser_trace_stop",
+  "description": "停止 Playwright Trace 录制并保存 trace.zip，可用 Playwright Trace Viewer 回放。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "name": { "type": "string", "description": "保存的 Trace 文件名，不含扩展名；默认使用 start 时的名称" }
+    }
+  }
+}

package/tools/browser_traverse_menu.json

@@ -0,0 +1,25 @@
+{
+  "name": "browser_traverse_menu",
+  "description": "自动遍历页面的导航菜单，逐级点击一级/二级/三级菜单项，每步检查控制台错误、页面错误和网络错误，验证每个功能链路是否正常。自动发现标准nav容器、侧边栏、UI框架菜单（Ant Design/Element UI等），未找到时降级扫描全页面链接。返回每个点击项的访问状态、URL变化、页面标题和错误信息。适用于功能回归测试和页面健康检查。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "maxDepth": {
+        "type": "number",
+        "description": "最大遍历深度（1=仅一级，2=含二级，3=含三级），默认3"
+      },
+      "maxItems": {
+        "type": "number",
+        "description": "最大点击次数，防止无限遍历，默认30"
+      },
+      "waitMs": {
+        "type": "number",
+        "description": "每次点击后的等待时间（毫秒），默认500"
+      },
+      "includeSubMenus": {
+        "type": "boolean",
+        "description": "是否自动展开并点击子菜单，默认true"
+      }
+    }
+  }
+}

package/tools/browser_type.json

@@ -0,0 +1,12 @@
+{
+  "name": "browser_type",
+  "description": "在真实浏览器中向指定 CSS 选择器输入文本",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "selector": { "type": "string", "description": "CSS 选择器" },
+      "text": { "type": "string", "description": "要输入的文本" }
+    },
+    "required": ["selector", "text"]
+  }
+}

package/tools/browser_verify_fix.json

@@ -0,0 +1,39 @@
+{
+  "name": "browser_verify_fix",
+  "description": "修复验证闭环工具。记录修复前状态（错误数、元素状态），执行修复操作（browser_click/type/wait等），验证修复后状态，对比前后差异，确认修复是否生效。返回 before/after 对比、fixStatus、verificationResult、nextAction。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "selector": {
+        "type": "string",
+        "description": "目标元素选择器（必填）"
+      },
+      "fixAction": {
+        "type": "string",
+        "description": "修复动作类型：click（点击）、type（输入）、wait（等待）、scroll（滚动）、quick_fix（自动修复）、none（仅验证不修复）",
+        "enum": ["click", "type", "wait", "scroll", "quick_fix", "none"],
+        "default": "quick_fix"
+      },
+      "fixValue": {
+        "type": "string",
+        "description": "修复动作值（type时为输入文本，wait时为毫秒数，scroll时为距离）"
+      },
+      "verificationCriteria": {
+        "type": "object",
+        "description": "验证标准",
+        "properties": {
+          "noNewErrors": { "type": "boolean", "description": "要求无新错误，默认true" },
+          "elementVisible": { "type": "boolean", "description": "要求元素可见" },
+          "elementInteractable": { "type": "boolean", "description": "要求元素可交互" },
+          "textContains": { "type": "string", "description": "要求页面包含文本" },
+          "urlChanged": { "type": "boolean", "description": "要求URL发生变化" }
+        }
+      },
+      "timeout": {
+        "type": "number",
+        "description": "验证超时时间（毫秒），默认10000"
+      }
+    },
+    "required": ["selector"]
+  }
+}

package/tools/browser_visual_baseline.json

@@ -0,0 +1,19 @@
+{
+  "name": "browser_visual_baseline",
+  "description": "为当前页面或指定元素创建视觉回归基线 PNG，默认全页截图并遮挡密码、token、apiKey 等敏感输入。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "name": { "type": "string", "description": "基线名称，不含扩展名" },
+      "selector": { "type": "string", "description": "可选 CSS 选择器；指定后只截取该元素" },
+      "fullPage": { "type": "boolean", "description": "是否全页截图，默认 true；selector 存在时忽略" },
+      "maskSelectors": {
+        "type": "array",
+        "description": "截图前额外遮挡/脱敏的 CSS 选择器列表",
+        "items": { "type": "string" }
+      },
+      "sessionName": { "type": "string", "description": "浏览器会话名称，默认当前活跃会话" }
+    },
+    "required": ["name"]
+  }
+}

package/tools/browser_visual_compare.json

@@ -0,0 +1,20 @@
+{
+  "name": "browser_visual_compare",
+  "description": "截取当前页面 actual PNG，与同名视觉基线对比并生成 diff PNG，返回 diffPixels、diffRatio、passed 和产物路径。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "name": { "type": "string", "description": "要对比的基线名称，不含扩展名" },
+      "selector": { "type": "string", "description": "可选 CSS 选择器；需与基线截图范围一致" },
+      "fullPage": { "type": "boolean", "description": "是否全页截图，默认 true；selector 存在时忽略" },
+      "maskSelectors": {
+        "type": "array",
+        "description": "截图前额外遮挡/脱敏的 CSS 选择器列表，用于忽略动态区域",
+        "items": { "type": "string" }
+      },
+      "maxDiffPixelRatio": { "type": "number", "description": "允许的最大差异像素比例，默认 0.01" },
+      "sessionName": { "type": "string", "description": "浏览器会话名称，默认当前活跃会话" }
+    },
+    "required": ["name"]
+  }
+}

package/tools/browser_visual_report.json

@@ -0,0 +1,8 @@
+{
+  "name": "browser_visual_report",
+  "description": "列出视觉回归基线、actual、diff 产物和最近比较结果。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {}
+  }
+}

package/tools/browser_wait.json

@@ -0,0 +1,18 @@
+{
+  "name": "browser_wait",
+  "description": "等待真实浏览器达到指定状态：元素出现/隐藏、文本出现、URL 包含、加载状态或固定时间。用于稳定异步流程。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "selector": { "type": "string", "description": "要等待的 CSS 选择器" },
+      "state": { "type": "string", "description": "选择器状态：attached/detached/visible/hidden，默认 visible" },
+      "text": { "type": "string", "description": "要等待出现的页面文本" },
+      "exact": { "type": "boolean", "description": "文本是否精确匹配，默认 false" },
+      "nth": { "type": "number", "description": "当文本匹配多个元素时选择第几个，默认 0" },
+      "urlContains": { "type": "string", "description": "等待当前 URL 包含该字符串" },
+      "loadState": { "type": "string", "description": "等待加载状态：load/domcontentloaded/networkidle" },
+      "ms": { "type": "number", "description": "固定等待毫秒数" },
+      "timeout": { "type": "number", "description": "超时时间，默认 10000ms" }
+    }
+  }
+}

package/tools/debug_investigate.json

@@ -0,0 +1,17 @@
+{
+  "name": "debug_investigate",
+  "description": "输入问题症状，自动汇总本轮 errors、events、network_detail、DOM 可见错误、storage、artifacts，并输出假设、证据链和下一步修复/复测建议。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "symptom": { "type": "string", "description": "问题现象，例如：点击 AI 要点后 403" },
+      "expected": { "type": "string", "description": "期望结果，例如：生成 AI 要点" },
+      "focus": { "type": "string", "description": "关注的 URL/API 关键字，例如 /api/ai/summarize" },
+      "urlContains": { "type": "string", "description": "focus 的别名，按 URL 过滤网络和事件" },
+      "statusMin": { "type": "number", "description": "只关注状态码大于等于该值的网络记录" },
+      "limit": { "type": "number", "description": "网络和事件最多返回条数，默认 20/50" },
+      "includeStorage": { "type": "boolean", "description": "是否包含 storage 脱敏快照，默认 true" },
+      "includeArtifacts": { "type": "boolean", "description": "是否包含 artifacts 列表，默认 true" }
+    }
+  }
+}

package/tools/error_fix_suggestion.json

@@ -0,0 +1,13 @@
+{
+  "name": "error_fix_suggestion",
+  "description": "基于 errorSummary 和 contextFiles 返回最多 3 个最小修复建议；不自动改码。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "errorSummary": { "description": "错误摘要，可为字符串或对象" },
+      "contextFiles": { "type": "array", "items": { "type": "string" } },
+      "file": { "type": "string" }
+    },
+    "required": ["errorSummary"]
+  }
+}

package/tools/error_summary_md.json

@@ -0,0 +1,11 @@
+{
+  "name": "error_summary_md",
+  "description": "将错误聚合结果输出为 500 字以内 Markdown 摘要，不包含完整日志、重复堆栈或完整响应体。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "evidence": { "type": "object" },
+      "limit": { "type": "number" }
+    }
+  }
+}