@autobest-ui/agent 1.0.0 → 1.0.2

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;
 });

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

@@ -1,54 +1,50 @@
-import assert from "node:assert/strict";
-import { spawnSync } from "node:child_process";
-import path from "node:path";
-import test from "node:test";
-import { fileURLToPath } from "node:url";
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+import test from 'node:test';
+import { fileURLToPath } from 'node:url';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
 
 const directory = path.dirname(fileURLToPath(import.meta.url));
 
-test("initializes and exposes the RAG tools over stdio", async () => {
-  const client = new Client({ name: "rag-mcp-bridge-test", version: "1.0.0" });
+test('initializes and exposes the RAG tools over stdio', async () => {
+  const client = new Client({ name: 'rag-mcp-bridge-test', version: '1.0.0' });
   const transport = new StdioClientTransport({
     command: process.execPath,
-    args: [path.join(directory, "index.js")],
-    cwd: path.resolve(directory, "../.."),
+    args: [path.join(directory, 'index.js')],
+    cwd: path.resolve(directory, '../..'),
     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'
     },
-    stderr: "pipe",
+    stderr: 'pipe'
   });
 
   try {
     await client.connect(transport);
 
-    assert.equal(client.getServerVersion()?.name, "rag-mcp-bridge");
-    assert.match(client.getInstructions() ?? "", /retrieve_knowledge/);
+    assert.equal(client.getServerVersion()?.name, 'rag-mcp-bridge');
+    assert.match(client.getInstructions() ?? '', /retrieve_knowledge/);
 
     const { tools } = await client.listTools();
     assert.deepEqual(
       tools.map(({ name }) => name),
-      ["add_prd_file", "update_spec_file", "retrieve_knowledge"],
-    );
-    assert.equal(
-      tools.find(({ name }) => name === "retrieve_knowledge")?.annotations
-        ?.readOnlyHint,
-      true,
+      ['add_prd_file', 'update_spec_file', 'retrieve_knowledge']
     );
+    assert.equal(tools.find(({ name }) => name === 'retrieve_knowledge')?.annotations?.readOnlyHint, true);
   } finally {
     await client.close();
   }
 });
 
-test("fails to start when RAG_API_BASE_URL is not configured", () => {
+test('fails to start when RAG_API_BASE_URL is not configured', () => {
   const environment = { ...process.env };
   delete environment.RAG_API_BASE_URL;
 
-  const result = spawnSync(process.execPath, [path.join(directory, "index.js")], {
-    cwd: path.resolve(directory, "../.."),
+  const result = spawnSync(process.execPath, [path.join(directory, 'index.js')], {
+    cwd: path.resolve(directory, '../..'),
     env: environment,
-    encoding: "utf8",
+    encoding: 'utf8'
   });
 
   assert.notEqual(result.status, 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autobest-ui/agent",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "private": false,
   "description": "Autobest Agent skills/plugins/mcp assets + sync cli",
   "files": [
@@ -19,22 +19,27 @@
     "autobest-agent-sync": "./bin/sync-assets.mjs",
     "autobest-azurepr-mcp": "./mcp/azurepr-mcp-bridge/index.js",
     "autobest-delivery-setup": "./plugins/autobest-delivery/scripts/setup.mjs",
-    "autobest-rag-mcp": "./mcp/rag-mcp-bridge/index.js"
+    "autobest-rag-mcp": "./mcp/rag-mcp-bridge/index.js",
+    "figma-mcp-bridge": "./mcp/figma-mcp-bridge/src/index.js",
+    "figma-plugin": "./plugins/figma-plugin/scripts/setup.mjs"
   },
   "scripts": {
     "mcp:azurepr": "node ./mcp/azurepr-mcp-bridge/index.js",
+    "mcp:figma": "node ./mcp/figma-mcp-bridge/src/index.js",
     "mcp:rag": "node ./mcp/rag-mcp-bridge/index.js",
     "test": "npm run test:skills && npm run test:mcp && npm run test:plugin",
     "test:skills": "node --test ./bin/sync-assets.test.mjs",
     "test:mcp:azurepr": "node --test ./mcp/azurepr-mcp-bridge/index.test.js",
+    "test:mcp:figma": "node --test ./mcp/figma-mcp-bridge/index.test.js",
     "test:mcp:rag": "node --test ./mcp/rag-mcp-bridge/index.test.js",
-    "test:mcp": "npm run test:mcp:azurepr && npm run test:mcp:rag",
-    "test:plugin": "node --test ./plugins/autobest-delivery/scripts/setup.test.mjs"
+    "test:mcp": "npm run test:mcp:azurepr && npm run test:mcp:figma && npm run test:mcp:rag",
+    "test:plugin": "node --test ./plugins/autobest-delivery/scripts/setup.test.mjs ./plugins/figma-plugin/scripts/setup.test.mjs"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.30.0",
     "diff": "9.0.0",
     "fs-extra": "11.3.0",
+    "ws": "8.18.3",
     "zod": "4.4.3"
   },
   "publishConfig": {

package/plugins/figma-plugin/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Magic Spells
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/plugins/figma-plugin/README.md

@@ -0,0 +1,25 @@
+# figma-plugin
+
+`figma-plugin` 是与 `figma-mcp-bridge` 配套的 Figma Development Plugin。它在 Figma 内运行，并通过本机 WebSocket 与 MCP 通信。
+
+## 安装
+
+```bash
+npx --yes --package=@autobest-ui/agent@latest figma-plugin
+```
+
+安装器会将插件文件同步到稳定目录：
+
+```text
+~/.autobest-agent/figma-plugins/figma-plugin
+```
+
+随后在 Figma 中执行 **Plugins -> Development -> Import plugin from manifest**，选择命令输出路径中的 `manifest.json`。再次执行安装命令会更新同一目录，无需重新导入。
+
+卸载本地文件：
+
+```bash
+npx --yes --package=@autobest-ui/agent@latest figma-plugin uninstall
+```
+
+卸载后，Figma Development Plugins 列表中的记录需要在 Figma 内移除。