@refore-ai/html-to-figma-mcp 0.3.0 → 0.3.1

package/index.mjs

@@ -18,25 +18,49 @@ import { Server } from "socket.io";
 * 往这里加东西前先确认它满足这两条，否则放别处。
 */
 /**
-* 面向 agent / 外部读者的平台展示名：MCP 工具描述、npm README、prompt 文案。
-*
-* 与同目录 `platform.ts` 的 `PLATFORM_NAME` 不是一回事 —— 那份给插件 UI 用，jsdesign 显示
-* 「即时设计」，且末尾已按 `__PLATFORM__` 取过值，是单个字符串而非表。
+* 平台叫法的唯一登记处：`name` 是英文主名，`zhName` 是中文名，`otherNames` 是其余写法。
+* 下面几张表都从这里派生。
 */
-const MCP_PLATFORM_NAMES = {
-	figma: "Figma",
-	mastergo: "MasterGo",
-	jsdesign: "JSDesign",
-	"pixso-china": "Pixso",
-	"pixso-world": "Pixso"
+const PLATFORM_NAMING = {
+	figma: { name: "Figma" },
+	mastergo: { name: "MasterGo" },
+	jsdesign: {
+		name: "JSDesign",
+		zhName: "即时设计",
+		otherNames: ["js.design"]
+	},
+	"pixso-china": { name: "Pixso" },
+	"pixso-world": { name: "Pixso" }
 };
+function mapPlatforms(pick) {
+	return Object.fromEntries(Object.entries(PLATFORM_NAMING).map(([platform, naming]) => [platform, pick(naming)]));
+}
+mapPlatforms((naming) => naming.name);
+/**
+* 平台展示名：有中文名的写成「JSDesign(即时设计)」。
+*
+* 凡是被读的正文都用这份 —— agent 侧的工具描述与 instructions、npm README 里的说明文字。
+* 用户嘴里说的是中文名，只给英文名，读的人（和 agent）认不出说的是同一个平台。
+*/
+const MCP_PLATFORM_DISPLAY_NAMES = mapPlatforms((naming) => naming.zhName ? `${naming.name}(${naming.zhName})` : naming.name);
+/**
+* 平台的全部叫法，主名在前。路由用（server instructions 的触发词）：用户说哪个叫法都要落到
+* 同一台 MCP，检索语料里没有的那个叫法就等于没这台 MCP。
+*/
+const MCP_PLATFORM_ALL_NAMES = mapPlatforms((naming) => [
+	naming.name,
+	...naming.zhName ? [naming.zhName] : [],
+	...naming.otherNames ?? []
+]);
 //#endregion
 //#region src/platform.ts
 const MCP_PLATFORM = "figma";
 /** 从源 package.json 的 version 由 tsdown define 注入；测试环境未注入 → 兜底 '0.0.0-dev' */
-const MCP_SERVER_VERSION = "0.3.0";
-/** 面向 agent 的平台展示名（用于工具描述等） */
-const MCP_PLATFORM_NAME = MCP_PLATFORM_NAMES[MCP_PLATFORM];
+const MCP_SERVER_VERSION = "0.3.1";
+/** 面向 agent 的平台展示名（用于工具描述等），中文名一并带上 */
+const MCP_PLATFORM_NAME = MCP_PLATFORM_DISPLAY_NAMES[MCP_PLATFORM];
+/** 本平台的全部叫法，主名在前：路由用，不是展示用 */
+const MCP_PLATFORM_TRIGGER_NAMES = MCP_PLATFORM_ALL_NAMES[MCP_PLATFORM];
 /** 本 MCP server 的包名 / 日志前缀基名 */
 const MCP_SERVER_NAME = `html-to-${MCP_PLATFORM}-mcp`;
 /** stdout 归 MCP JSON-RPC 独占，本进程所有日志走 stderr */
@@ -664,7 +688,7 @@ actually open in the browser (no login state, no interaction state).
   the taskId immediately), keep walking the flow and capture state N+1 while the plugin imports
   (its task queue is serial), then wait_task(N) and verify state N — any failure costs at most one
   wasted capture instead of N.
-- Verification runs entirely on the Figma side (get_node_info + export_node_screenshot) against
+- Verification runs entirely on the ${MCP_PLATFORM_NAME} side (get_nodes + export_node_image) against
   the baseline you froze at capture time — the browser never needs to navigate back. Take a
   viewport screenshot of the page right when you capture it, as the comparison baseline. Check:
   visibleAreaRatio is 1 and the root size matches the viewport; the exported image has no large
@@ -1004,8 +1028,15 @@ function registerTools(server, hub, options = {}) {
 * 截断）；Codex 把它渲染进 tool_search 的来源清单并计入 BM25 检索语料（plugin 形态只保留
 * 前 1000 字节）。因此路由声明必须是第一句、全文不得超过 1000 字节（有测试锁定）；中文
 * 触发词是给 BM25 命中中文 query 用的——其余语料全是英文，纯中文搜索词否则一个都对不上。
+*
+* 中文触发词按 `triggerNames` 的每个叫法各写一遍，且写成「导入到X」的连写形态、当中不留
+* 空格，与用户的原句逐字一致：按空白切词的检索器会把「导入到 JSDesign」切成两个 token，
+* 连着写的 query 一个都对不上，语料里缺席的那个叫法就等于没这台 MCP。
 */
-const SERVER_INSTRUCTIONS = `Use this MCP whenever the user asks to import, convert or restore a web page, URL, or HTML into ${MCP_PLATFORM_NAME} (中文指令如「把网页/URL/HTML 导入到 ${MCP_PLATFORM_NAME}」，产品名「网页转设计」). A local HTML file the user hands you goes straight to import_html with source:"user-file" — no browser, no capture guide. For web pages, capturing is part of walking the flow, not a phase after it: call get_capture_guide BEFORE opening the first target page, then capture and import each page/state the moment you first reach it (submit with wait:false, keep walking while the plugin imports, then wait_task the previous submission). Never walk the whole flow to the end and only then start capturing — the second walk doubles the work and interaction states may not be reproducible on re-navigation.`;
+function buildServerInstructions(platformName, triggerNames) {
+	return `Use this MCP whenever the user asks to import, convert or restore a web page, URL, or HTML into ${platformName} (中文指令如「把网页/URL/HTML ${triggerNames.map((name) => `导入到${name}`).join("/")}」，产品名「网页转设计」). A local HTML file the user hands you goes straight to import_html with source:"user-file" — no browser, no capture guide. For web pages, capturing is part of walking the flow, not a phase after it: call get_capture_guide BEFORE opening the first target page, then capture and import each page/state the moment you first reach it (submit with wait:false, keep walking while the plugin imports, then wait_task the previous submission). Never walk the whole flow to the end and only then start capturing — the second walk doubles the work and interaction states may not be reproducible on re-navigation.`;
+}
+const SERVER_INSTRUCTIONS = buildServerInstructions(MCP_PLATFORM_NAME, MCP_PLATFORM_TRIGGER_NAMES);
 /** 工具面的组装只在这一处：本 MCP 自己的导入工具（含 dev 专属的 demo 导入）+ design-inspect 的组 + dev 组 */
 function createServer$1(hub, options = {}) {
 	const server = new McpServer({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@refore-ai/html-to-figma-mcp",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "module",
   "bin": {
     "html-to-figma-mcp": "index.mjs"