@autobest-ui/agent 1.0.1 → 1.0.2

package/mcp/figma-mcp-bridge/src/tools/nodes.js

@@ -5,7 +5,8 @@
 
 export const nodesTool = {
   name: 'figma_get_nodes',
-  description: 'Get detailed information about specific Figma nodes by their IDs. Returns node properties including type, position, size, fills, strokes, auto-layout (including layoutWrap and counterAxisSpacing), clipsContent, node-level boundVariables, explicitVariableModes, and more.',
+  description:
+    'Get detailed information about specific Figma nodes by their IDs. Returns node properties including type, position, size, fills, strokes, auto-layout (including layoutWrap and counterAxisSpacing), clipsContent, node-level boundVariables, explicitVariableModes, and more.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -22,15 +23,21 @@ export const nodesTool = {
 export async function handleGetNodes(bridge, args) {
   if (!bridge.isConnected()) {
     return {
-      content: [{
-        type: 'text',
-        text: JSON.stringify({
-          error: {
-            code: 'NOT_CONNECTED',
-            message: 'Figma plugin is not connected. Please open Figma and run the Autobest Figma Plugin.'
-          }
-        }, null, 2)
-      }],
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(
+            {
+              error: {
+                code: 'NOT_CONNECTED',
+                message: 'Figma plugin is not connected. Please open Figma and run the Autobest Figma Plugin.'
+              }
+            },
+            null,
+            2
+          )
+        }
+      ],
       isError: true
     };
   }
@@ -39,15 +46,21 @@ export async function handleGetNodes(bridge, args) {
 
   if (!nodeIds || !Array.isArray(nodeIds) || nodeIds.length === 0) {
     return {
-      content: [{
-        type: 'text',
-        text: JSON.stringify({
-          error: {
-            code: 'INVALID_PARAMS',
-            message: 'nodeIds must be a non-empty array of node IDs'
-          }
-        }, null, 2)
-      }],
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(
+            {
+              error: {
+                code: 'INVALID_PARAMS',
+                message: 'nodeIds must be a non-empty array of node IDs'
+              }
+            },
+            null,
+            2
+          )
+        }
+      ],
       isError: true
     };
   }
@@ -56,22 +69,30 @@ export async function handleGetNodes(bridge, args) {
     const result = await bridge.sendCommand('get_nodes', { nodeIds, depth });
 
     return {
-      content: [{
-        type: 'text',
-        text: JSON.stringify(result, null, 2)
-      }]
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(result, null, 2)
+        }
+      ]
     };
   } catch (error) {
     return {
-      content: [{
-        type: 'text',
-        text: JSON.stringify({
-          error: {
-            code: error.code || 'UNKNOWN_ERROR',
-            message: error.message
-          }
-        }, null, 2)
-      }],
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(
+            {
+              error: {
+                code: error.code || 'UNKNOWN_ERROR',
+                message: error.message
+              }
+            },
+            null,
+            2
+          )
+        }
+      ],
       isError: true
     };
   }

package/mcp/figma-mcp-bridge/src/tools/pages.js

@@ -5,7 +5,8 @@
 
 export const pagesTool = {
   name: 'figma_list_pages',
-  description: 'List all pages in the current Figma document. Returns page IDs, names, and indicates which page is currently active.',
+  description:
+    'List all pages in the current Figma document. Returns page IDs, names, and indicates which page is currently active.',
   inputSchema: {
     type: 'object',
     properties: {},
@@ -16,15 +17,21 @@ export const pagesTool = {
 export async function handleListPages(bridge) {
   if (!bridge.isConnected()) {
     return {
-      content: [{
-        type: 'text',
-        text: JSON.stringify({
-          error: {
-            code: 'NOT_CONNECTED',
-            message: 'Figma plugin is not connected. Please open Figma and run the Autobest Figma Plugin.'
-          }
-        }, null, 2)
-      }],
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(
+            {
+              error: {
+                code: 'NOT_CONNECTED',
+                message: 'Figma plugin is not connected. Please open Figma and run the Autobest Figma Plugin.'
+              }
+            },
+            null,
+            2
+          )
+        }
+      ],
       isError: true
     };
   }
@@ -33,22 +40,30 @@ export async function handleListPages(bridge) {
     const result = await bridge.sendCommand('list_pages', {});
 
     return {
-      content: [{
-        type: 'text',
-        text: JSON.stringify(result, null, 2)
-      }]
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(result, null, 2)
+        }
+      ]
     };
   } catch (error) {
     return {
-      content: [{
-        type: 'text',
-        text: JSON.stringify({
-          error: {
-            code: error.code || 'UNKNOWN_ERROR',
-            message: error.message
-          }
-        }, null, 2)
-      }],
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(
+            {
+              error: {
+                code: error.code || 'UNKNOWN_ERROR',
+                message: error.message
+              }
+            },
+            null,
+            2
+          )
+        }
+      ],
       isError: true
     };
   }

package/mcp/rag-mcp-bridge/README.md

@@ -7,7 +7,7 @@
 先启动 PRD Knowledge HTTP API。直接在终端验证时，必须在同一条命令中提供 API 根地址：
 
 ```bash
-RAG_API_BASE_URL="http://127.0.0.1:3000/api/knowledge" \
+RAG_API_BASE_URL="http://192.168.1.12:3000/api/knowledge" \
 npx --yes \
   --package=@autobest-ui/agent@latest \
   autobest-rag-mcp
@@ -26,7 +26,7 @@ tool_timeout_sec = 120
 enabled = true
 
 [mcp_servers.rag-mcp-bridge.env]
-RAG_API_BASE_URL = "http://127.0.0.1:3000/api/knowledge"
+RAG_API_BASE_URL = "http://192.168.1.12:3000/api/knowledge"
 RAG_MCP_HTTP_TIMEOUT_MS = "120000"
 ```
 

package/mcp/rag-mcp-bridge/config.toml.example

@@ -7,6 +7,6 @@ enabled = true
 
 [mcp_servers.rag-mcp-bridge.env]
 # 必填：按实际部署地址修改，MCP 服务本身不提供默认地址。
-RAG_API_BASE_URL = "http://127.0.0.1:3000/api/knowledge"
+RAG_API_BASE_URL = "http://192.168.1.12:3000/api/knowledge"
 # 可选：单次 HTTP 请求超时，单位为毫秒。
 RAG_MCP_HTTP_TIMEOUT_MS = "120000"

package/mcp/rag-mcp-bridge/index.js

@@ -10,40 +10,37 @@
  * Database access, Markdown parsing, embeddings, and RAG stay in Express.
  */
 
-import { readdir, stat } from "node:fs/promises";
-import path from "node:path";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
+import { readdir, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
 
 const DEFAULT_HTTP_TIMEOUT_MS = 120_000;
 
 function apiBaseUrlFromEnvironment() {
   const configuredUrl = process.env.RAG_API_BASE_URL?.trim();
   if (!configuredUrl) {
-    throw new Error(
-      "RAG_API_BASE_URL is required; configure it in the MCP server environment",
-    );
+    throw new Error('RAG_API_BASE_URL is required; configure it in the MCP server environment');
   }
 
   let url;
   try {
     url = new URL(configuredUrl);
   } catch {
-    throw new Error("RAG_API_BASE_URL must be a valid URL");
+    throw new Error('RAG_API_BASE_URL must be a valid URL');
   }
-  if (url.protocol !== "http:" && url.protocol !== "https:") {
-    throw new Error("RAG_API_BASE_URL must use http or https");
+  if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+    throw new Error('RAG_API_BASE_URL must use http or https');
   }
-  return url.toString().replace(/\/$/, "");
+  return url.toString().replace(/\/$/, '');
 }
 
 function httpTimeoutFromEnvironment() {
-  const configuredTimeout =
-    process.env.RAG_MCP_HTTP_TIMEOUT_MS ?? String(DEFAULT_HTTP_TIMEOUT_MS);
+  const configuredTimeout = process.env.RAG_MCP_HTTP_TIMEOUT_MS ?? String(DEFAULT_HTTP_TIMEOUT_MS);
   const timeout = Number(configuredTimeout);
   if (!Number.isSafeInteger(timeout) || timeout <= 0) {
-    throw new Error("RAG_MCP_HTTP_TIMEOUT_MS must be a positive integer");
+    throw new Error('RAG_MCP_HTTP_TIMEOUT_MS must be a positive integer');
   }
   return timeout;
 }
@@ -52,31 +49,18 @@ const API_BASE_URL = apiBaseUrlFromEnvironment();
 const HTTP_TIMEOUT_MS = httpTimeoutFromEnvironment();
 
 const pathsSchema = z
-  .union([
-    z.string().min(1),
-    z.array(z.string().min(1)).min(1),
-  ])
-  .describe("单个Markdown文件、Markdown文件数组或文件夹的绝对路径");
+  .union([z.string().min(1), z.array(z.string().min(1)).min(1)])
+  .describe('单个Markdown文件、Markdown文件数组或文件夹的绝对路径');
 const platformSchema = z
-  .enum(["app", "california-web", "shared"])
-  .describe("知识所属平台；必须明确指定，防止APP与加州网站需求串库");
-const moduleSchema = z
-  .string()
-  .min(1)
-  .optional()
-  .describe("可选业务模块标识，例如vehicle-selector");
+  .enum(['app', 'california-web', 'shared'])
+  .describe('知识所属平台；必须明确指定，防止APP与加州网站需求串库');
+const moduleSchema = z.string().min(1).optional().describe('可选业务模块标识，例如vehicle-selector');
 const pageSchema = z
   .string()
   .min(1)
   .optional()
-  .describe(
-    "业务页面键，例如home、pl、pn、pd、name-search；录入多个文件时不要传，由后端按文件名分别推断",
-  );
-const docKeySchema = z
-  .string()
-  .min(1)
-  .optional()
-  .describe("需要限定到单一文档时传knowledge_doc.doc_key绝对路径");
+  .describe('业务页面键，例如home、pl、pn、pd、name-search；录入多个文件时不要传，由后端按文件名分别推断');
+const docKeySchema = z.string().min(1).optional().describe('需要限定到单一文档时传knowledge_doc.doc_key绝对路径');
 
 /** Recursively collects Markdown files from a directory in stable order. */
 async function scanMarkdownDirectory(directoryPath) {
@@ -88,7 +72,7 @@ async function scanMarkdownDirectory(directoryPath) {
     const entryPath = path.join(directoryPath, entry.name);
     if (entry.isDirectory()) {
       markdownFiles.push(...(await scanMarkdownDirectory(entryPath)));
-    } else if (entry.isFile() && path.extname(entry.name).toLowerCase() === ".md") {
+    } else if (entry.isFile() && path.extname(entry.name).toLowerCase() === '.md') {
       markdownFiles.push(path.resolve(entryPath));
     }
   }
@@ -101,8 +85,8 @@ async function expandMarkdownPaths(pathsInput) {
   const markdownFiles = [];
 
   for (const input of inputs) {
-    if (typeof input !== "string" || !input.trim()) {
-      throw new Error("paths中的每一项都必须是非空字符串");
+    if (typeof input !== 'string' || !input.trim()) {
+      throw new Error('paths中的每一项都必须是非空字符串');
     }
     if (!path.isAbsolute(input.trim())) {
       throw new Error(`必须使用绝对路径: ${input}`);
@@ -112,21 +96,16 @@ async function expandMarkdownPaths(pathsInput) {
     const pathStat = await stat(absolutePath);
     if (pathStat.isDirectory()) {
       markdownFiles.push(...(await scanMarkdownDirectory(absolutePath)));
-    } else if (
-      pathStat.isFile() &&
-      path.extname(absolutePath).toLowerCase() === ".md"
-    ) {
+    } else if (pathStat.isFile() && path.extname(absolutePath).toLowerCase() === '.md') {
       markdownFiles.push(absolutePath);
     } else {
       throw new Error(`路径不是Markdown文件或文件夹: ${absolutePath}`);
     }
   }
 
-  const uniquePaths = [...new Set(markdownFiles)].sort((left, right) =>
-    left.localeCompare(right),
-  );
+  const uniquePaths = [...new Set(markdownFiles)].sort((left, right) => left.localeCompare(right));
   if (uniquePaths.length === 0) {
-    throw new Error("指定路径中没有找到任何.md文件");
+    throw new Error('指定路径中没有找到任何.md文件');
   }
   return uniquePaths;
 }
@@ -134,10 +113,10 @@ async function expandMarkdownPaths(pathsInput) {
 /** Posts JSON to Express and returns its parsed response body. */
 async function postJson(endpoint, body) {
   const response = await fetch(`${API_BASE_URL}${endpoint}`, {
-    method: "POST",
-    headers: { "content-type": "application/json" },
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
     body: JSON.stringify(body),
-    signal: AbortSignal.timeout(HTTP_TIMEOUT_MS),
+    signal: AbortSignal.timeout(HTTP_TIMEOUT_MS)
   });
   const responseText = await response.text();
   let responseBody;
@@ -148,10 +127,7 @@ async function postJson(endpoint, body) {
   }
 
   if (!response.ok) {
-    const details =
-      typeof responseBody === "string"
-        ? responseBody
-        : JSON.stringify(responseBody);
+    const details = typeof responseBody === 'string' ? responseBody : JSON.stringify(responseBody);
     throw new Error(`Express后端返回HTTP ${response.status}: ${details}`);
   }
   return responseBody;
@@ -161,12 +137,12 @@ async function postJson(endpoint, body) {
 async function getJson(endpoint, query) {
   const url = new URL(`${API_BASE_URL}${endpoint}`);
   for (const [name, value] of Object.entries(query)) {
-    if (value === undefined || value === null || value === "") continue;
+    if (value === undefined || value === null || value === '') continue;
     url.searchParams.set(name, value);
   }
   const response = await fetch(url, {
-    method: "GET",
-    signal: AbortSignal.timeout(HTTP_TIMEOUT_MS),
+    method: 'GET',
+    signal: AbortSignal.timeout(HTTP_TIMEOUT_MS)
   });
   const responseText = await response.text();
   let responseBody;
@@ -176,10 +152,7 @@ async function getJson(endpoint, query) {
     responseBody = responseText;
   }
   if (!response.ok) {
-    const details =
-      typeof responseBody === "string"
-        ? responseBody
-        : JSON.stringify(responseBody);
+    const details = typeof responseBody === 'string' ? responseBody : JSON.stringify(responseBody);
     throw new Error(`Express后端返回HTTP ${response.status}: ${details}`);
   }
   return responseBody;
@@ -189,10 +162,10 @@ function toolSuccess(payload) {
   return {
     content: [
       {
-        type: "text",
-        text: JSON.stringify(payload, null, 2),
-      },
-    ],
+        type: 'text',
+        text: JSON.stringify(payload, null, 2)
+      }
+    ]
   };
 }
 
@@ -200,154 +173,136 @@ function toolError(error) {
   const message = error instanceof Error ? error.message : String(error);
   return {
     isError: true,
-    content: [{ type: "text", text: message }],
+    content: [{ type: 'text', text: message }]
   };
 }
 
 const server = new McpServer(
-  { name: "rag-mcp-bridge", version: "1.0.0" },
+  { name: 'rag-mcp-bridge', version: '1.0.0' },
   {
     instructions:
-      "Use retrieve_knowledge before implementing requirement-sensitive code. " +
-      "Every tool call requires an explicit platform: app, california-web, or shared. " +
-      "add_prd_file and update_spec_file accept one file, an array of files, or a directory. " +
-      "Only call update_spec_file after the PR is merged and leader review confirms the spec is effective.",
-  },
+      'Use retrieve_knowledge before implementing requirement-sensitive code. ' +
+      'Every tool call requires an explicit platform: app, california-web, or shared. ' +
+      'add_prd_file and update_spec_file accept one file, an array of files, or a directory. ' +
+      'Only call update_spec_file after the PR is merged and leader review confirms the spec is effective.'
+  }
 );
 
 server.registerTool(
-  "add_prd_file",
+  'add_prd_file',
   {
-    title: "录入或更新PRD基线",
+    title: '录入或更新PRD基线',
     description:
-      "录入/更新PRD基线。paths支持单个md绝对路径、md绝对路径数组或文件夹绝对路径；文件夹会递归扫描全部.md文件。后端负责解析截图并将旧文档标记为作废。",
+      '录入/更新PRD基线。paths支持单个md绝对路径、md绝对路径数组或文件夹绝对路径；文件夹会递归扫描全部.md文件。后端负责解析截图并将旧文档标记为作废。',
     inputSchema: {
       paths: pathsSchema,
       platform: platformSchema,
       module: moduleSchema,
-      page: pageSchema,
+      page: pageSchema
     },
     annotations: {
       readOnlyHint: false,
       destructiveHint: false,
       idempotentHint: false,
-      openWorldHint: false,
-    },
+      openWorldHint: false
+    }
   },
   async ({ paths, platform, module, page }) => {
     try {
       const expandedPaths = await expandMarkdownPaths(paths);
       return toolSuccess(
-        await postJson("/add-prd", {
+        await postJson('/add-prd', {
           paths: expandedPaths,
           platform,
           module,
-          page,
-        }),
+          page
+        })
       );
     } catch (error) {
       return toolError(error);
     }
-  },
+  }
 );
 
 server.registerTool(
-  "update_spec_file",
+  'update_spec_file',
   {
-    title: "录入迭代变更Spec",
+    title: '录入迭代变更Spec',
     description:
-      "仅在PR合并且leader review确认生效后调用。paths支持单个spec.md绝对路径、路径数组或文件夹；只需传改动spec。sprintVersion必须递增，数值越大需求越新。",
+      '仅在PR合并且leader review确认生效后调用。paths支持单个spec.md绝对路径、路径数组或文件夹；只需传改动spec。sprintVersion必须递增，数值越大需求越新。',
     inputSchema: {
       paths: pathsSchema,
       sprintVersion: z.number().int().positive(),
       iterationTag: z.string().min(1),
       platform: platformSchema,
       module: moduleSchema,
-      page: pageSchema,
+      page: pageSchema
     },
     annotations: {
       readOnlyHint: false,
       destructiveHint: false,
       idempotentHint: false,
-      openWorldHint: false,
-    },
+      openWorldHint: false
+    }
   },
   async ({ paths, sprintVersion, iterationTag, platform, module, page }) => {
     try {
       const expandedPaths = await expandMarkdownPaths(paths);
       return toolSuccess(
-        await postJson("/add-spec", {
+        await postJson('/add-spec', {
           paths: expandedPaths,
           sprintVersion,
           iterationTag,
           platform,
           module,
-          page,
-        }),
+          page
+        })
       );
     } catch (error) {
       return toolError(error);
     }
-  },
+  }
 );
 
 server.registerTool(
-  "retrieve_knowledge",
+  'retrieve_knowledge',
   {
-    title: "检索PRD与迭代Spec",
+    title: '检索PRD与迭代Spec',
     description:
-      "Codex编写需求相关代码前调用。后端执行向量+BM25-RRF混合检索并按sprint_version业务排序。enableStruct=true时才生成结构化PRD；includeImages=true时才保留图片并替换为数据库图片URL，两者默认均为false。",
+      'Codex编写需求相关代码前调用。后端执行向量+BM25-RRF混合检索并按sprint_version业务排序。enableStruct=true时才生成结构化PRD；includeImages=true时才保留图片并替换为数据库图片URL，两者默认均为false。',
     inputSchema: {
       query: z.string().min(1),
       platform: platformSchema,
-      module: moduleSchema.describe(
-        "可选业务模块硬过滤，例如vehicle-selector",
-      ),
-      page: pageSchema.describe(
-        "可选页面硬过滤，例如首页传home；不传时后端会从明确的查询词自动推断",
-      ),
+      module: moduleSchema.describe('可选业务模块硬过滤，例如vehicle-selector'),
+      page: pageSchema.describe('可选页面硬过滤，例如首页传home；不传时后端会从明确的查询词自动推断'),
       docKey: docKeySchema,
-      enableStruct: z
-        .boolean()
-        .default(false)
-        .describe("是否调用LLM生成structuredPrd，默认false"),
-      includeImages: z
-        .boolean()
-        .default(false)
-        .describe("是否返回可供UI显示的数据库图片URL，默认false"),
+      enableStruct: z.boolean().default(false).describe('是否调用LLM生成structuredPrd，默认false'),
+      includeImages: z.boolean().default(false).describe('是否返回可供UI显示的数据库图片URL，默认false')
     },
     annotations: {
       readOnlyHint: true,
       destructiveHint: false,
       idempotentHint: true,
-      openWorldHint: false,
-    },
+      openWorldHint: false
+    }
   },
-  async ({
-    query,
-    platform,
-    module,
-    page,
-    docKey,
-    enableStruct = false,
-    includeImages = false,
-  }) => {
+  async ({ query, platform, module, page, docKey, enableStruct = false, includeImages = false }) => {
     try {
       return toolSuccess(
-        await getJson("/search", {
+        await getJson('/search', {
           query: query.trim(),
           platform,
           module,
           page,
           docKey,
           enableStruct: String(enableStruct === true),
-          includeImages: String(includeImages === true),
-        }),
+          includeImages: String(includeImages === true)
+        })
       );
     } catch (error) {
       return toolError(error);
     }
-  },
+  }
 );
 
 async function main() {
@@ -355,7 +310,7 @@ async function main() {
   await server.connect(transport);
 }
 
-main().catch((error) => {
-  console.error("Failed to start rag-mcp-bridge:", error);
+main().catch(error => {
+  console.error('Failed to start rag-mcp-bridge:', error);
   process.exitCode = 1;
 });