text-to-design-mcp 0.6.1 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +41 -10
  2. package/dist/index.js +41 -34
  3. package/package.json +3 -2
package/README.md CHANGED
@@ -98,23 +98,55 @@ pkill -f text-to-design-mcp
98
98
 
99
99
  ### 完整工具清单
100
100
 
101
+ **一个操作对应一个工具**,没有 op 分发;两个聚合入口(`jsd_manage_nodes` / `jsd_manage_components`)仅用于批量或一次改多组字段。所有写工具都支持 `ids`(缺省作用于当前选中);属性类工具(及 `jsd_set_*`)的 `recursive` 只作用于**后代**,不含目标节点自身(给一组图标容器刷色时容器不会被套上方框),要连容器自身一起改才传 `includeSelf=true`。
102
+
101
103
  | 工具 | 用途 |
102
104
  | --- | --- |
103
- | `jsd_ping` | 检查插件是否在线 |
105
+ | `jsd_ping` | 检查插件是否在线,并返回平台 capabilities |
104
106
  | `jsd_get_selection` | 读取画布当前选中的节点 |
107
+ | `jsd_find` | 按名称/类型/id 查找节点 |
105
108
  | `jsd_create_nodes` | 按描述创建节点(frame/rect/text 等,支持阴影/描边/渐变/文本样式) |
106
109
  | `jsd_create_svg` | 直接导入 SVG 字符串(保留 path/矢量数据,不经降级) |
107
110
  | `jsd_create_icon` | 按名称/别名模糊匹配插入 Lucide 内置图标,查无时返回候选名 |
108
111
  | `jsd_html_to_design` | 把 HTML 转成设计节点 |
109
- | `jsd_update_node` | 按 id 批量修改节点属性(位置/颜色/文字/圆角等,ids 缺省作用于当前选中;部分 id 失效时在文本里逐条点名) |
110
- | `jsd_find` | 按名称/类型/id 查找节点 |
111
- | `jsd_batch` | 批量编排器:一次请求顺序执行多个 jsd_* 步骤,双花括号占位符串起中间值 |
112
- | `jsd_manage_nodes` | 节点结构操作,op 含 select/remove/clone/group/ungroup/flatten/outline_stroke/reparent/repair(清理引擎残留失效节点) |
113
- | `jsd_manage_components` | 组件/实例操作,op 含 create_component(建空壳,子节点用 reparent 归入)/create_instance/detach_instance/import_component/swap_component/set_instance_properties/combine_as_variants/copy_overrides(复制源实例覆盖为快照,缓存)/apply_overrides(按快照批量套用,可 swapToSource)/sync_overrides(无状态一次性复制+套用) |
112
+ | `jsd_set_fill_color` | 填充(fills 整体替换)、混合模式、填充样式 |
113
+ | `jsd_set_stroke` | 描边列表/宽度(可四边分开)/对齐/端点/连接/虚线/描边样式 |
114
+ | `jsd_set_cornerRadius` | 圆角半径(四角可分开)与圆角平滑度 |
115
+ | `jsd_set_text` | 文本内容与排版(characters/fontSize/fontName/对齐/行高/字距/截断) |
116
+ | `jsd_move_node` | 位置 x/y 与旋转 |
117
+ | `jsd_resize_node` | 尺寸 width/height,可同时传 x/y 一步改尺寸并定位 |
118
+ | `jsd_set_layout` | FRAME auto-layout(layoutMode/间距/内边距/对齐/伸缩/约束) |
119
+ | `jsd_set_effects` | 阴影/模糊、溢出裁剪、布局网格、椭圆环形参数 |
120
+ | `jsd_set_visibility` | 不透明度、显示开关、锁定 |
121
+ | `jsd_rename_node` | 重命名 |
122
+ | `jsd_update_node` | 聚合:一次改多组字段,或改 pointCount/innerRadius 等长尾字段 |
123
+ | `jsd_select_nodes` | 设置画布当前选中 |
124
+ | `jsd_delete_node` | 删除节点(matchName 可再过滤;ids 缺省删当前选中) |
125
+ | `jsd_clone_node` | 复制节点(克隆 COMPONENT 得到 INSTANCE) |
126
+ | `jsd_group_nodes` | 编组(至少 2 个),可同时设置 auto-layout |
127
+ | `jsd_ungroup_nodes` | 解组 |
128
+ | `jsd_flatten_nodes` | 至少 2 个节点合并为单一矢量 |
129
+ | `jsd_outline_stroke` | 描边转轮廓矢量(几何被烘焙) |
130
+ | `jsd_reparent_nodes` | 移入父节点成为其子节点(parentId 建议显式传;跨父级移动保持绝对位置,内部自动换算,移入 auto-layout 容器时位置由布局接管) |
131
+ | `jsd_repair_nodes` | 清理引擎残留的损坏/失效节点 |
132
+ | `jsd_manage_nodes` | 聚合入口,op 含 select/remove/clone/group/ungroup/flatten/outline_stroke/reparent/repair;各 op 返回键不同(select→`selected` / remove→`removed` / ungroup→`ungrouped` / repair→`cleaned` 为 id 字符串数组;clone/group/flatten/outline_stroke→`created`;reparent→`moved`,同时附同义的 `updated`) |
133
+ | `jsd_create_component` | 建「空壳」组件:先 resize 再 reparent 归入子节点,最后删除原容器 |
134
+ | `jsd_create_instance` | 按 COMPONENT 生成实例 |
135
+ | `jsd_detach_instance` | 取消实例链接,得到可自由编辑的普通节点 |
136
+ | `jsd_import_component` | 按 key 从团队库导入组件 |
137
+ | `jsd_swap_component` | 换绑组件(丢弃目标既有覆盖) |
138
+ | `jsd_set_instance_properties` | 设置变体属性(属性名需与 variantGroupProperties 完全匹配) |
139
+ | `jsd_combine_as_variants` | 合并为变体集(仅 COMPONENT,实例不能直接合成)。⚠ 本引擎必然失败(平台缺陷),全败时返回可执行出口:改用「族名 / 状态」命名的多个独立主件 |
140
+ | `jsd_copy_overrides` | 复制源实例覆盖为快照,返回 snapshotId(缓存) |
141
+ | `jsd_apply_overrides` | 按 snapshotId 批量套用,可 swapToSource |
142
+ | `jsd_sync_overrides` | 无状态一次性「复制+套用」,适合 jsd_batch |
143
+ | `jsd_manage_components` | 聚合入口,op 含 create_component/create_instance/detach_instance/import_component/swap_component/set_instance_properties/combine_as_variants/copy_overrides/apply_overrides/sync_overrides |
144
+ | `jsd_batch` | 批量编排器:一次请求顺序执行多个 jsd_* 步骤,双花括号占位符串起中间值;步骤回显做摘要裁剪(节点只留 id/name/type/x/y,丢 vectorPaths 等大字段,超预算降级为 id 清单),占位符解析用完整数据;含图标的批次另配一次 `jsd_export` 目视验收;含删除/移父的批次自动复核同层几何漂移(结果 `warnings`,`checkDrift:false` 可关) |
114
145
  | `jsd_export` | 导出节点为 PNG/JPG/SVG/PDF(导出失败的 id 在文本里点名) |
115
146
  | `jsd_list_fonts` | 列出可用字体 |
147
+ | `jsd_list_styles` | 列出本地样式(PAINT/TEXT/EFFECT/GRID) |
116
148
  | `jsd_fill_image` | 用本地图片填充节点 |
117
- | `jsd_platform_op` | 平台特有能力通用通道(Figma 变量/本地样式等),先看 jsd_ping 的 capabilities |
149
+ | `jsd_platform_op` | 平台特有能力通用通道(Figma 变量等),先看 jsd_ping 的 capabilities |
118
150
 
119
151
  ### 配方 prompt(`prompts/list`)
120
152
 
@@ -123,9 +155,8 @@ pkill -f text-to-design-mcp
123
155
  | prompt | 用途 |
124
156
  | --- | --- |
125
157
  | `design-strategy` | 设计策略总纲:命名/层级/间距字号阶梯/出错回滚,附登录页示例结构树 |
126
- | `design-card` | 生成一张带标题的卡片(平铺创建 + reparent 归组 + 事后设布局) |
127
- | `text-replace-strategy` | 大改文案:clone 留底 → 语义分块 → 批量替换 → 逐块导小图复核 |
128
- | `variant-sync` | 把一个实例的样式/文案批量套用到多个同类实例(优先 sync_overrides / copy+apply,手工 jsd_update_node 兜底) |
158
+ | `text-replace-strategy` | 大改文案:jsd_clone_node 留底 → 语义分块 → jsd_set_text 批量替换 → 逐块导小图复核 |
159
+ | `variant-sync` | 把一个实例的样式/文案批量套用到多个同类实例(优先 jsd_sync_overrides / copy+apply,手工 jsd_set_* 兜底) |
129
160
  | `html-to-design` | HTML 转设计稿,含保真度取舍说明 |
130
161
  | `icon-grid` | 批量插入 Lucide 图标并排成自动布局网格 |
131
162
  | `script-ops` | 脚本化调用纪律:压缩工具往返与上下文占用 |
package/dist/index.js CHANGED
@@ -1,33 +1,37 @@
1
1
  #!/usr/bin/env node
2
- import{createRequire as e}from"node:module";import{appendFileSync as t,readFileSync as n,writeFileSync as r}from"node:fs";import{z as i}from"zod";import{createServer as a}from"node:http";import{WebSocket as o,WebSocketServer as s}from"ws";import{Client as c,StreamableHTTPClientTransport as l}from"@modelcontextprotocol/client";import{McpServer as u,ResourceTemplate as d,SUPPORTED_PROTOCOL_VERSIONS as f,createMcpHandler as p,fromJsonSchema as ee}from"@modelcontextprotocol/server";import{serveStdio as te}from"@modelcontextprotocol/server/stdio";import{spawn as ne}from"node:child_process";import{localhostHostValidation as m,localhostOriginValidation as h,toNodeHandler as g}from"@modelcontextprotocol/node";import{isTag as _}from"domhandler";import{parseDocument as re}from"htmlparser2";import ie from"fuse.js";var v=`0.6.1`,y=Number(process.env.TEXT_TO_DESIGN_MCP_PORT??47812),b=Number(process.env.TEXT_TO_DESIGN_MCP_HTTP_PORT??47820),x=`text-to-design-mcp-server`,S=v,ae=5e3,oe=5e3,se=6e4,ce=12e4,C={label:`即时设计`,runtime:`jsDesign`,toolPrefix:`jsd`};function le(e){let t=/^#([0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/i.exec(e.trim());if(t==null)return null;let n=t[1];(n.length===3||n.length===4)&&(n=[...n].map(e=>e+e).join(``));let r=e=>Number.parseInt(e,16)/255,i={r:r(n.slice(0,2)),g:r(n.slice(2,4)),b:r(n.slice(4,6))};return n.length===8&&(i.a=r(n.slice(6,8))),i}var ue=i.object({r:i.number().min(0).max(1,`颜色通道最大 1(0-255 的色值请先除以 255 归一化)`).describe(`红色通道,范围 0-1(0=无,1=满),如纯红为 1`),g:i.number().min(0).max(1,`颜色通道最大 1(0-255 的色值请先除以 255 归一化)`).describe(`绿色通道,范围 0-1`),b:i.number().min(0).max(1,`颜色通道最大 1(0-255 的色值请先除以 255 归一化)`).describe(`蓝色通道,范围 0-1`),a:i.number().min(0).max(1,`alpha 通道最大 1(0-255 请先归一化)`).optional().describe(`不透明度,范围 0-1(0=全透明,1=不透明),缺省按 1 处理`)}).strict(),de=`颜色需为 {r,g,b[,a]} 对象(通道 0-1,0-255 色值请先除以 255)或 hex 字符串(#RGB/#RGBA/#RRGGBB/#RRGGBBAA,如 "#ff0000")`,fe=i.unknown().superRefine((e,t)=>{if(typeof e==`string`){le(e)??t.addIssue({code:i.ZodIssueCode.custom,message:`无效 hex 颜色 "${e}"(${de})`});return}let n=ue.safeParse(e);if(!n.success)for(let e of n.error.issues)t.addIssue({code:i.ZodIssueCode.custom,path:e.path,message:e.message})}).transform(e=>typeof e==`string`?le(e)??{r:0,g:0,b:0}:e),pe=fe.describe(`颜色:{r,g,b} 对象(通道 0-1)或 hex 字符串,如 "#ff0000"(带透明度可用 8 位 hex,其 alpha 会转为 paint 级 opacity)`),w=fe.describe(`RGBA 颜色:{r,g,b,a} 对象(通道 0-1,a 缺省按 1)或 hex 字符串,如 "#ff0000"、"#ff000080"`),me=i.object({color:w.describe(`该停止点的颜色(带 alpha)`),position:i.number().min(0).max(1).describe(`停止点位置,范围 0-1(0=起点,1=终点)`)}).describe(`渐变停止点,如 {color:{r:1,g:0,b:0,a:1}, position:0}(起点红色)和 {color:{r:0,g:0,b:1,a:1}, position:1}(终点蓝色)`),he=i.tuple([i.tuple([i.number(),i.number(),i.number()]),i.tuple([i.number(),i.number(),i.number()])]).describe(`变换矩阵,如 [[1,0,0],[0,1,0]] 表示无变换(Identity)`),T=i.enum([`PASS_THROUGH`,`NORMAL`,`DARKEN`,`MULTIPLY`,`COLOR_BURN`,`LIGHTEN`,`SCREEN`,`COLOR_DODGE`,`OVERLAY`,`SOFT_LIGHT`,`HARD_LIGHT`,`DIFFERENCE`,`EXCLUSION`,`HUE`,`SATURATION`,`COLOR`,`LUMINOSITY`]).describe(`混合模式:PASS_THROUGH=穿透 | NORMAL=正常 | DARKEN=变暗 | MULTIPLY=正片叠底 | COLOR_BURN=颜色加深 | LIGHTEN=变亮 | SCREEN=滤色 | COLOR_DODGE=颜色减淡 | OVERLAY=叠加 | SOFT_LIGHT=柔光 | HARD_LIGHT=强光 | DIFFERENCE=差值 | EXCLUSION=排除 | HUE=色相 | SATURATION=饱和度 | COLOR=颜色 | LUMINOSITY=明度`),E=i.discriminatedUnion(`type`,[i.object({type:i.literal(`SOLID`).describe(`填充类型:纯色`),color:pe.describe(`纯色值,支持 {r,g,b} 对象(通道 0-1)或 hex 字符串,如 "#ff0000"`),opacity:i.number().min(0).max(1).optional().describe(`不透明度 0-1,缺省 1`),visible:i.boolean().optional().describe(`是否可见,缺省 true`),blendMode:T.optional().describe(`混合模式,缺省 NORMAL`)}).strict().describe(`纯色填充(SOLID):{color:{r,g,b}}`),i.object({type:i.literal(`GRADIENT_LINEAR`).describe(`填充类型:线性渐变`),gradientStops:i.array(me).describe(`渐变停止点数组(至少 2 个,定义颜色与位置)`),gradientTransform:he}).strict().describe(`线性渐变(GRADIENT_LINEAR):沿直线方向过渡`),i.object({type:i.literal(`GRADIENT_RADIAL`).describe(`填充类型:径向渐变`),gradientStops:i.array(me).describe(`渐变停止点数组(至少 2 个,定义颜色与位置)`),gradientTransform:he}).strict().describe(`径向渐变(GRADIENT_RADIAL):从中心向外辐射`),i.object({type:i.literal(`GRADIENT_ANGULAR`).describe(`填充类型:角度渐变`),gradientStops:i.array(me).describe(`渐变停止点数组(至少 2 个,定义颜色与位置)`),gradientTransform:he}).strict().describe(`角度渐变(GRADIENT_ANGULAR):沿圆周方向过渡`),i.object({type:i.literal(`IMAGE`).describe(`填充类型:图片填充`),imageHash:i.string().describe(`图片资源哈希(由 jsd_fill_image 等注入)`),scaleMode:i.enum([`FILL`,`FIT`,`CROP`,`TILE`]).optional().describe(`缩放模式:FILL=填充裁剪|FIT=完整适配|CROP=裁剪|TILE=平铺`)}).strict().describe(`图片填充(IMAGE):以 imageHash 引用图片`)]),D=i.discriminatedUnion(`type`,[i.object({type:i.literal(`DROP_SHADOW`).describe(`效果类型:外阴影(投影到节点外侧)`),color:w.describe(`阴影颜色(带 alpha 透明度)`),offset:i.object({x:i.number().describe(`水平偏移(px),正值向右`),y:i.number().describe(`垂直偏移(px),正值向下`)}).describe(`阴影偏移向量(px)`),radius:i.number().min(0).describe(`模糊半径(px),>=0`),spread:i.number().optional().describe(`扩散(px),正值扩大阴影、负值收缩,默认 0`),visible:i.boolean().optional().describe(`是否可见,默认 true`),blendMode:T.default(`NORMAL`).describe(`混合模式,默认 NORMAL`),showShadowBehindNode:i.boolean().optional().describe(`是否在节点后方显示阴影(即便节点不透明也透出)`)}).strict().describe(`外阴影(DROP_SHADOW):投影到节点外侧的阴影`),i.object({type:i.literal(`INNER_SHADOW`).describe(`效果类型:内阴影(投影到节点内侧)`),color:w.describe(`阴影颜色(带 alpha 透明度)`),offset:i.object({x:i.number().describe(`水平偏移(px),正值向右`),y:i.number().describe(`垂直偏移(px),正值向下`)}).describe(`阴影偏移向量(px)`),radius:i.number().min(0).describe(`模糊半径(px),>=0`),spread:i.number().optional().describe(`扩散(px),正值扩大、负值收缩,默认 0`),visible:i.boolean().optional().describe(`是否可见,默认 true`),blendMode:T.default(`NORMAL`).describe(`混合模式,默认 NORMAL`)}).strict().describe(`内阴影(INNER_SHADOW):投影到节点内侧的阴影`),i.object({type:i.literal(`LAYER_BLUR`).describe(`效果类型:图层模糊(模糊整个节点本身)`),radius:i.number().min(0).describe(`模糊半径(px),>=0`),visible:i.boolean().optional().describe(`是否可见,默认 true`)}).strict().describe(`图层模糊(LAYER_BLUR):模糊节点自身`),i.object({type:i.literal(`BACKGROUND_BLUR`).describe(`效果类型:背景模糊(模糊节点背后的内容)`),radius:i.number().min(0).describe(`模糊半径(px),>=0`),visible:i.boolean().optional().describe(`是否可见,默认 true`)}).strict().describe(`背景模糊(BACKGROUND_BLUR):模糊节点背后的内容`)]),O=i.enum([`MIN`,`MAX`,`STRETCH`,`CENTER`,`SCALE`]).describe(`约束类型:MIN=吸附左/上 | MAX=吸附右/下 | STRETCH=拉伸 | CENTER=居中 | SCALE=等比缩放`),k=i.object({pattern:i.enum([`ROWS`,`COLUMNS`,`GRID`]).describe(`网格类型:ROWS|COLUMNS|GRID`),alignment:i.enum([`MIN`,`MAX`,`CENTER`,`STRETCH`]).optional().describe(`对齐:MIN|MAX|CENTER|STRETCH`),sectionSize:i.number().optional().describe(`分节尺寸(px)`),count:i.number().int().positive().optional(),gutterSize:i.number().optional().describe(`沟槽尺寸(px)`),offset:i.number().optional().describe(`偏移(px)`),visible:i.boolean().optional(),color:w.optional()}).superRefine((e,t)=>{e.pattern===`GRID`&&e.sectionSize==null&&t.addIssue({code:i.ZodIssueCode.custom,message:`pattern 为 GRID 时,sectionSize 为必填项`,path:[`sectionSize`]})}),ge=i.object({data:i.string().describe(`SVG path data,如 "M0 0 L100 0 L100 100 Z"(M=移动到,L=画线到,Z=闭合)。仅支持 M/L/Q/C/Z 指令(SVG 子集,不支持 A 圆弧等);完整 SVG 请改用 jsd_create_svg`),windingRule:i.enum([`NONZERO`,`EVENODD`,`NONE`]).default(`NONZERO`).describe(`环绕规则:NONZERO|EVENODD|NONE,默认 NONZERO`)}),A=i.object({family:i.string().describe(`字体族,如 "PingFang SC"/"Inter"`),style:i.string().describe(`字型,如 "Regular"/"Bold"/"Medium"`)}),_e=i.union([i.object({value:i.number().describe(`行高数值(px)`),unit:i.literal(`PIXELS`).describe(`单位:PIXELS=固定像素`)}).describe(`固定行高:{value: 数值, unit: "PIXELS"},如 {value: 24, unit: "PIXELS"}`),i.object({value:i.number().describe(`行高数值(百分比)`),unit:i.literal(`PERCENT`).describe(`单位:PERCENT=百分比`)}).describe(`百分比行高:{value: 数值, unit: "PERCENT"},如 {value: 150, unit: "PERCENT"}`),i.object({unit:i.literal(`AUTO`).describe(`单位:AUTO=自动行高`)}).describe(`自动行高:{unit: "AUTO"},无需传 value`)]),ve=i.object({value:i.number(),unit:i.enum([`PIXELS`,`PERCENT`]).describe(`单位:PIXELS=像素 | PERCENT=百分比`)}),ye=i.object({id:i.string().optional().describe(`步骤唯一标识,供后续步骤以双花括号占位符(id.字段路径)引用本步结果;缺省自动命名 step1/step2/…`),tool:i.string().describe(`要执行的 jsd_* 工具名,如 jsd_create_nodes / jsd_find / jsd_update_node`),args:i.record(i.string(),i.unknown()).optional().describe(`该工具的完整入参;任意位置的字符串值里可放双花括号占位符(步骤id.字段路径)引用先前步骤结果`),continueOnError:i.boolean().optional().describe(`本步【执行】失败时是否继续后续步骤;仅对执行失败生效,id 重复/未知工具/引用解析失败一律中止`)}),be=i.object({calls:i.array(ye).min(1).max(50).describe(`按数组顺序执行的步骤列表`),stopOnError:i.boolean().optional().describe(`全局失败策略,默认 true=任一步执行失败即停止,false=配合单步走完全部`)}),xe=i.object({ok:i.boolean().describe(`全部步骤均执行且成功(executed 小于 total 即为中途停止)`),executed:i.number().int().min(0).describe(`实际产生结果的步骤数`),total:i.number().int().min(0).describe(`计划的步骤总数`),results:i.array(i.object({id:i.string(),tool:i.string(),ok:i.boolean(),data:i.unknown().optional().describe(`成功时该工具的 structuredContent`),error:i.string().optional().describe(`失败原因(人读文本)`)})).describe(`各步骤结果,顺序与入参一致;被中止而未执行的步骤不出现在此列表`)}),Se=i.object({ok:i.boolean(),data:i.unknown().optional()}),j={name:i.string().optional(),x:i.number().optional().describe(`X 坐标(px,相对父节点,缺省 0;根节点的摆放由 placement 控制)`),y:i.number().optional().describe(`Y 坐标(px,相对父节点,缺省 0;根节点的摆放由 placement 控制)`),width:i.number().optional().describe(`宽度(px)`),height:i.number().optional().describe(`高度(px)`),rotation:i.number().optional().describe(`旋转角度(deg,绕节点自身左上角原点,x/y 不变)`),opacity:i.number().optional().describe(`不透明度 0-1`),visible:i.boolean().optional(),locked:i.boolean().optional(),isMask:i.boolean().optional(),children:i.array(i.lazy(()=>N)).max(100).optional().describe(`子节点数组(递归嵌套,最多 100 个直接子节点;更大的结构建议分批创建后用 jsd_manage_nodes op=reparent 归组)。子节点 x/y 相对父节点,未传 x/y 会叠放在父节点原点(0,0)——非 auto-layout 容器需为每个子节点指定相对坐标`)},M={fills:i.array(E).optional().describe(`填充列表(Paint 数组)`),strokes:i.array(E).optional().describe(`描边列表(Paint 数组)`),strokeWeight:i.number().optional().describe(`描边宽度(px)`),strokeTopWeight:i.number().optional().describe(`描边顶部宽(px)`),strokeBottomWeight:i.number().optional().describe(`描边底部宽(px)`),strokeLeftWeight:i.number().optional().describe(`描边左侧宽(px)`),strokeRightWeight:i.number().optional().describe(`描边右侧宽(px)`),strokeAlign:i.enum([`CENTER`,`INSIDE`,`OUTSIDE`]).optional().describe(`描边对齐:CENTER|INSIDE|OUTSIDE`),strokeCap:i.enum([`NONE`,`ROUND`,`SQUARE`,`ARROW_LINES`,`ARROW_EQUILATERAL`]).optional().describe(`描边端点:NONE|ROUND|SQUARE|ARROW_LINES|ARROW_EQUILATERAL`),strokeJoin:i.enum([`MITER`,`BEVEL`,`ROUND`]).optional().describe(`描边连接:MITER|BEVEL|ROUND`),dashPattern:i.array(i.number()).optional().describe(`虚线段数组,如 [4,4]`),blendMode:T.optional(),effects:i.array(D).optional().describe(`效果列表(阴影/模糊,可多层叠加)`),constraints:i.object({horizontal:O.describe(`水平约束:MIN|MAX|STRETCH|CENTER|SCALE`),vertical:O.describe(`垂直约束:MIN|MAX|STRETCH|CENTER|SCALE`)}).optional().describe(`自动布局中的约束`),clipsContent:i.boolean().optional().describe(`是否裁剪溢出内容`),cornerSmoothing:i.number().optional().describe(`圆角平滑度 0-1`),layoutGrids:i.array(k).optional().describe(`布局网格(参考线)`)},Ce=i.object({type:i.literal(`FRAME`),...j,layoutMode:i.enum([`NONE`,`HORIZONTAL`,`VERTICAL`]).optional().describe(`自动布局方向:NONE=无布局,HORIZONTAL=水平排列,VERTICAL=垂直排列。传 itemSpacing/padding*/primaryAxis* 等布局属性前必须先设为 HORIZONTAL 或 VERTICAL`),itemSpacing:i.number().optional().describe(`自动布局项间距(px),需先设 layoutMode;primaryAxisAlignItems=SPACE_BETWEEN 时该项被忽略(子项均匀分布)`),paddingTop:i.number().optional().describe(`上内边距(px)`),paddingRight:i.number().optional().describe(`右内边距(px)`),paddingBottom:i.number().optional().describe(`下内边距(px)`),paddingLeft:i.number().optional().describe(`左内边距(px)`),primaryAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional().describe(`主轴尺寸模式:FIXED|AUTO`),counterAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional().describe(`交叉轴尺寸模式:FIXED|AUTO`),primaryAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`,`SPACE_BETWEEN`]).optional().describe(`主轴对齐:MIN|MAX|CENTER|SPACE_BETWEEN;设为 SPACE_BETWEEN 时 itemSpacing 被忽略(子项均匀分布)`),counterAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`]).optional().describe(`交叉轴对齐:MIN|MAX|CENTER`),layoutGrow:i.number().optional().describe(`自动布局内伸缩系数`),layoutAlign:i.enum([`MIN`,`CENTER`,`MAX`,`STRETCH`,`INHERIT`]).optional().describe(`自动布局内对齐:MIN|CENTER|MAX|STRETCH|INHERIT`),...M}).strict().superRefine((e,t)=>{(e.itemSpacing!=null||e.paddingTop!=null||e.paddingRight!=null||e.paddingBottom!=null||e.paddingLeft!=null||e.primaryAxisSizingMode!=null||e.counterAxisSizingMode!=null||e.primaryAxisAlignItems!=null||e.counterAxisAlignItems!=null)&&(e.layoutMode==null||e.layoutMode===`NONE`)&&t.addIssue({code:i.ZodIssueCode.custom,message:`传 itemSpacing/padding*/primaryAxis*/counterAxis* 等布局属性前,layoutMode 必须设为 HORIZONTAL 或 VERTICAL`,path:[`layoutMode`]})}).strict().describe(`FRAME=容器(可 auto-layout)。注意:未显式传 fills 时引擎默认白底,透明容器请显式传 fills:[{type:"SOLID",color:{r:0,g:0,b:0},opacity:0}]`),we=i.object({type:i.literal(`RECTANGLE`),...j,cornerRadius:i.number().optional().describe(`圆角半径(px),四角统一`),topLeftRadius:i.number().optional().describe(`左上圆角(px)`),topRightRadius:i.number().optional().describe(`右上圆角(px)`),bottomLeftRadius:i.number().optional().describe(`左下圆角(px)`),bottomRightRadius:i.number().optional().describe(`右下圆角(px)`),...M}).strict().describe(`RECTANGLE=矩形`),Te=i.object({type:i.literal(`ELLIPSE`),...j,cornerRadius:i.number().optional().describe(`圆角半径(px)`),arcData:i.object({startingAngle:i.number().describe(`起始角度(radians)`),endingAngle:i.number().describe(`结束角度(radians)`),innerRadius:i.number().describe(`内半径(0-1 ratio)`)}).optional().describe(`环形路径参数(弧线),可画圆环`),...M}).strict().describe(`ELLIPSE=椭圆(配合 arcData 可画环)`),Ee=i.object({type:i.literal(`LINE`),...j,...M}).strict().describe(`LINE=线段`),De=i.object({type:i.literal(`POLYGON`),...j,pointCount:i.number().describe(`多边形角点数,如 6=六边形`),cornerRadius:i.number().optional().describe(`圆角半径(px)`),topLeftRadius:i.number().optional().describe(`左上圆角(px)`),topRightRadius:i.number().optional().describe(`右上圆角(px)`),bottomLeftRadius:i.number().optional().describe(`左下圆角(px)`),bottomRightRadius:i.number().optional().describe(`右下圆角(px)`),...M}).strict().describe(`POLYGON=多边形(配合 pointCount)`),Oe=i.object({type:i.literal(`STAR`),...j,pointCount:i.number().describe(`星形角点数,如 5=五角星`),innerRadius:i.number().describe(`星形内半径比例(0-1,相对外半径),值越小角越尖锐`),cornerRadius:i.number().optional().describe(`圆角半径(px)`),topLeftRadius:i.number().optional().describe(`左上圆角(px)`),topRightRadius:i.number().optional().describe(`右上圆角(px)`),bottomLeftRadius:i.number().optional().describe(`左下圆角(px)`),bottomRightRadius:i.number().optional().describe(`右下圆角(px)`),...M}).strict().describe(`STAR=星形(配合 pointCount + innerRadius)`),ke=i.object({type:i.literal(`VECTOR`),...j,vectorPaths:i.array(ge).describe(`矢量路径数组,每项含 SVG path data(如 "M0 0 L100 100")`),...M}).strict().describe(`VECTOR=矢量(配合 vectorPaths 传 SVG path data)。注意:当前平台创建后 vectorPaths 偶发丢失/形变,短直线段建议改用 LINE+rotation 更稳定`),Ae=i.object({type:i.literal(`TEXT`),...j,characters:i.string().describe(`文本内容,如 "Hello World"。注意:个别 emoji 依赖客户端字体可能缺字(渲染为 ☒),上线前逐个目检`),fontSize:i.number().optional().describe(`字号(px),默认 16`),fontName:A.optional().describe(`字体:{family,style},如 {family:"PingFang SC",style:"Regular"};需精确匹配,建议先用 jsd_list_fonts 查可用字体(不可用时静默回退默认字体)`),textAlignHorizontal:i.enum([`LEFT`,`CENTER`,`RIGHT`,`JUSTIFIED`]).optional().describe(`水平对齐:LEFT|CENTER|RIGHT|JUSTIFIED`),textAlignVertical:i.enum([`TOP`,`CENTER`,`BOTTOM`]).optional().describe(`垂直对齐:TOP|CENTER|BOTTOM`),textAutoResize:i.enum([`NONE`,`WIDTH_AND_HEIGHT`,`HEIGHT`,`TRUNCATE`]).optional().describe(`文本自适应:NONE=固定尺寸|WIDTH_AND_HEIGHT=按内容撑开(缺省,此时显式 width/height 会被覆盖)|HEIGHT=固定宽自适应高|TRUNCATE=截断。要固定文本框尺寸必须设为 NONE`),textCase:i.enum([`ORIGINAL`,`UPPER`,`LOWER`,`TITLE`]).optional().describe(`文本大小写:ORIGINAL|UPPER|LOWER|TITLE`),textDecoration:i.enum([`NONE`,`UNDERLINE`,`STRIKETHROUGH`]).optional().describe(`文本装饰:NONE|UNDERLINE|STRIKETHROUGH`),lineHeight:_e.optional().describe(`行高:{value,unit},unit 为 PIXELS|PERCENT;或 {unit:"AUTO"}`),letterSpacing:ve.optional().describe(`字距:{value,unit},unit 为 PIXELS|PERCENT`),...M}).strict().describe(`TEXT=文本(配合 characters/fontSize/fontName 等)`),je=i.object({type:i.literal(`GROUP`),...j,children:i.array(i.lazy(()=>N)).min(2).max(100).describe(`子节点数组,至少 2 个;递归嵌套,最多 100 个直接子节点`),layoutMode:i.enum([`NONE`,`HORIZONTAL`,`VERTICAL`]).optional().describe(`自动布局方向:NONE=纯归组,HORIZONTAL=水平,VERTICAL=垂直。传 itemSpacing/padding* 等布局属性前必须先设为 HORIZONTAL 或 VERTICAL`),itemSpacing:i.number().optional().describe(`项间距(px),需先设 layoutMode;primaryAxisAlignItems=SPACE_BETWEEN 时该项被忽略(子项均匀分布)`),paddingTop:i.number().optional().describe(`上内边距(px)`),paddingRight:i.number().optional().describe(`右内边距(px)`),paddingBottom:i.number().optional().describe(`下内边距(px)`),paddingLeft:i.number().optional().describe(`左内边距(px)`),primaryAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional().describe(`主轴尺寸模式:FIXED|AUTO`),counterAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional().describe(`交叉轴尺寸模式:FIXED|AUTO`),primaryAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`,`SPACE_BETWEEN`]).optional().describe(`主轴对齐:MIN|MAX|CENTER|SPACE_BETWEEN;设为 SPACE_BETWEEN 时 itemSpacing 被忽略(子项均匀分布)`),counterAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`]).optional().describe(`交叉轴对齐`),...M}).strict().superRefine((e,t)=>{(e.itemSpacing!=null||e.paddingTop!=null||e.paddingRight!=null||e.paddingBottom!=null||e.paddingLeft!=null||e.primaryAxisSizingMode!=null||e.counterAxisSizingMode!=null||e.primaryAxisAlignItems!=null||e.counterAxisAlignItems!=null)&&(e.layoutMode==null||e.layoutMode===`NONE`)&&t.addIssue({code:i.ZodIssueCode.custom,message:`传 itemSpacing/padding*/primaryAxis*/counterAxis* 等布局属性前,layoutMode 必须设为 HORIZONTAL 或 VERTICAL`,path:[`layoutMode`]})}).describe(`GROUP=分组(内部用 Frame 实现)`),Me=i.object({type:i.literal(`BOOLEAN_OPERATION`),...j,booleanOperation:i.enum([`UNION`,`SUBTRACT`,`INTERSECT`,`EXCLUDE`]).describe(`布尔运算:UNION=合并,SUBTRACT=减去,INTERSECT=相交,EXCLUDE=排除`),children:i.array(i.lazy(()=>N)).min(2).describe(`要合并的子节点数组(至少 2 个)`),...M}).strict().describe(`BOOLEAN_OPERATION=布尔运算(合并子节点)`),N=i.discriminatedUnion(`type`,[Ce,we,Te,Ee,De,Oe,ke,Ae,je,Me]),Ne=i.object({mode:i.enum([`center`,`manual`,`absolute`]).optional().describe(`放置模式:center=把每个根节点各自移到视口中心(缺省;会忽略 ops 内根节点自身的 x/y,多个根节点会互相叠放)|manual=保留 ops 内根节点自身的 x/y(按坐标布局用这个)|absolute=把所有根节点统一放到下方 x/y(必填,多根会叠在同一坐标)。建议一次调用只建一个根节点,层级结构用 children 表达`),x:i.number().optional().describe(`absolute 模式下所有根节点的 X 坐标,与 mode="absolute" 配合使用`),y:i.number().optional().describe(`absolute 模式下所有根节点的 Y 坐标,与 mode="absolute" 配合使用`)}).superRefine((e,t)=>{e.mode===`absolute`&&(e.x==null||e.y==null)&&t.addIssue({code:i.ZodIssueCode.custom,message:`placement.mode 为 absolute 时,x 和 y 均为必填项`,path:e.x==null?[`x`]:[`y`]})}),Pe=i.object({ops:i.array(N).describe(`设计指令节点树;建议单一根节点(多个根节点会被 placement 统一摆放,可能互相叠放)`),placement:Ne.optional().describe(`放置方式,缺省 center 居中且忽略 ops 内根节点的 x/y。需要按坐标摆放时传 mode:"manual"(保留 ops 内 x/y)或 "absolute"(顶层统一坐标)`)}).strict(),Fe=i.object({svg:i.string().describe(`完整 SVG 字符串,如 <svg xmlns="http://www.w3.org/2000/svg" width="100" height="100"><path d="M0 0 L100 0 L100 100 Z" fill="#ff0000"/></svg>`),name:i.string().optional().describe(`生成的图层名,默认 svg-design`)}),Ie=i.object({html:i.string().describe(`HTML 片段,支持内联 style`),name:i.string().optional().describe(`生成的图层名,默认 html-design`)}),Le=i.object({icon:i.string().describe(`图标名/别名/语义描述,如 home、arrow-right、search、magnifier(搜索);支持模糊匹配与别名联想,查无返回候选提示`),size:i.number().optional().describe(`图标边长 px,默认 24`),color:i.string().optional().describe(`描边颜色(十六进制),默认 #000000`),strokeWidth:i.number().optional().describe(`描边宽度,默认 2`),name:i.string().optional().describe(`生成的图层名,默认 icon-<图标名>`)});i.object({}),i.object({depth:i.number().optional().describe(`序列化深度:0=仅自身,1=含直接子节点,2=含孙节点;缺省 2`)});var Re=i.object({x:i.number().optional().describe(`X 坐标(px,相对父节点;auto-layout 子节点的位置由父容器接管,修改可能被布局覆盖)`),y:i.number().optional().describe(`Y 坐标(px,相对父节点;auto-layout 子节点的位置由父容器接管,修改可能被布局覆盖)`),width:i.number().optional().describe(`宽度(px)`),height:i.number().optional().describe(`高度(px)`),rotation:i.number().optional().describe(`旋转角度(deg,绕节点自身左上角原点,x/y 不变)`),opacity:i.number().optional().describe(`不透明度 0-1`),visible:i.boolean().optional(),locked:i.boolean().optional()}),ze=i.object({strokes:i.array(E).optional().describe(`描边列表(Paint 数组;整体替换,非合并,需保留的描边要一并传入)`),strokeWeight:i.number().optional().describe(`描边宽度(px)`),strokeTopWeight:i.number().optional().describe(`描边顶部宽(px)`),strokeBottomWeight:i.number().optional().describe(`描边底部宽(px)`),strokeLeftWeight:i.number().optional().describe(`描边左侧宽(px)`),strokeRightWeight:i.number().optional().describe(`描边右侧宽(px)`),strokeAlign:i.enum([`CENTER`,`INSIDE`,`OUTSIDE`]).optional().describe(`描边对齐:CENTER|INSIDE|OUTSIDE`),strokeCap:i.enum([`NONE`,`ROUND`,`SQUARE`,`ARROW_LINES`,`ARROW_EQUILATERAL`]).optional().describe(`描边端点:NONE|ROUND|SQUARE|ARROW_LINES|ARROW_EQUILATERAL`),strokeJoin:i.enum([`MITER`,`BEVEL`,`ROUND`]).optional().describe(`描边连接:MITER|BEVEL|ROUND`),dashPattern:i.array(i.number()).optional().describe(`虚线段数组,如 [4,4]`)}),Be=i.object({cornerRadius:i.number().optional().describe(`圆角半径(px),四角统一;仅 FRAME/RECTANGLE/ELLIPSE/POLYGON/STAR/VECTOR/BOOLEAN_OPERATION 生效(LINE/TEXT 无圆角)`),topLeftRadius:i.number().optional().describe(`左上圆角(px),适用类型同 cornerRadius`),topRightRadius:i.number().optional().describe(`右上圆角(px),适用类型同 cornerRadius`),bottomLeftRadius:i.number().optional().describe(`左下圆角(px),适用类型同 cornerRadius`),bottomRightRadius:i.number().optional().describe(`右下圆角(px),适用类型同 cornerRadius`)}),Ve=i.object({characters:i.string().optional().describe(`文本内容(仅 TEXT 节点生效)`),fontSize:i.number().optional().describe(`字号(px)`),fontName:A.optional().describe(`字体:{family,style};需精确匹配,建议先用 jsd_list_fonts 查可用字体(不可用时静默回退默认字体)`),textAlignHorizontal:i.enum([`LEFT`,`CENTER`,`RIGHT`,`JUSTIFIED`]).optional().describe(`水平对齐:LEFT|CENTER|RIGHT|JUSTIFIED`),textAlignVertical:i.enum([`TOP`,`CENTER`,`BOTTOM`]).optional().describe(`垂直对齐:TOP|CENTER|BOTTOM`),textAutoResize:i.enum([`NONE`,`WIDTH_AND_HEIGHT`,`HEIGHT`,`TRUNCATE`]).optional().describe(`文本自适应:NONE=固定尺寸|WIDTH_AND_HEIGHT=按内容撑开(缺省,此时修改 width/height 会被覆盖)|HEIGHT=固定宽自适应高|TRUNCATE=截断。要固定文本框尺寸必须设为 NONE`),textCase:i.enum([`ORIGINAL`,`UPPER`,`LOWER`,`TITLE`]).optional().describe(`文本大小写:ORIGINAL|UPPER|LOWER|TITLE`),textDecoration:i.enum([`NONE`,`UNDERLINE`,`STRIKETHROUGH`]).optional().describe(`文本装饰:NONE|UNDERLINE|STRIKETHROUGH`),lineHeight:_e.optional().describe(`行高:{value,unit}`),letterSpacing:ve.optional().describe(`字距:{value,unit}`)}),He=i.object({layoutMode:i.enum([`NONE`,`HORIZONTAL`,`VERTICAL`]).optional().describe(`自动布局方向:NONE|HORIZONTAL|VERTICAL,仅 FRAME 节点生效。传 itemSpacing/padding*/primaryAxis* 等布局属性前必须先设为 HORIZONTAL 或 VERTICAL`),itemSpacing:i.number().optional().describe(`自动布局项间距(px);primaryAxisAlignItems=SPACE_BETWEEN 时该项被忽略(子项均匀分布)`),paddingTop:i.number().optional().describe(`上内边距(px)`),paddingRight:i.number().optional().describe(`右内边距(px)`),paddingBottom:i.number().optional().describe(`下内边距(px)`),paddingLeft:i.number().optional().describe(`左内边距(px)`),primaryAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional().describe(`主轴尺寸模式:FIXED|AUTO`),counterAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional().describe(`交叉轴尺寸模式:FIXED|AUTO`),primaryAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`,`SPACE_BETWEEN`]).optional().describe(`主轴对齐:MIN|MAX|CENTER|SPACE_BETWEEN;设为 SPACE_BETWEEN 时 itemSpacing 被忽略(子项均匀分布)`),counterAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`]).optional().describe(`交叉轴对齐:MIN|MAX|CENTER`),layoutGrow:i.number().optional().describe(`自动布局内伸缩系数`),layoutAlign:i.enum([`MIN`,`CENTER`,`MAX`,`STRETCH`,`INHERIT`]).optional().describe(`自动布局内对齐:MIN|CENTER|MAX|STRETCH|INHERIT`)}),Ue=i.object({fills:i.array(E).optional().describe(`填充列表(Paint 数组;整体替换,非合并,需保留的现有填充项要一并传入)`),blendMode:T.optional(),effects:i.array(D).optional().describe(`效果列表(阴影/模糊,可多层叠加;整体替换,非合并)`),constraints:i.object({horizontal:O.describe(`水平约束:MIN|MAX|STRETCH|CENTER|SCALE`),vertical:O.describe(`垂直约束:MIN|MAX|STRETCH|CENTER|SCALE`)}).optional().describe(`自动布局中的约束`),clipsContent:i.boolean().optional().describe(`是否裁剪溢出内容`),cornerSmoothing:i.number().optional().describe(`圆角平滑度 0-1`),layoutGrids:i.array(k).optional().describe(`布局网格(参考线)`),arcData:i.object({startingAngle:i.number().describe(`起始角度(radians)`),endingAngle:i.number().describe(`结束角度(radians)`),innerRadius:i.number().describe(`内半径(0-1 ratio)`)}).optional().describe(`环形路径参数(弧线),仅 ELLIPSE 节点生效`)}),We=i.object({name:i.string().optional(),pointCount:i.number().optional().describe(`多边形/星形角点数(仅 POLYGON/STAR 生效)`),innerRadius:i.number().optional().describe(`星形内半径比例(0-1,相对外半径;仅 STAR 生效)`),...Re.shape,...ze.shape,...Be.shape,...Ve.shape,...He.shape,...Ue.shape,textTruncation:i.enum([`DISABLED`,`ENDING`]).optional().describe(`文本截断(DISABLED=不截断,ENDING=末尾省略号截断),仅 Figma 生效`),maxLines:i.number().optional().describe(`文本最大行数,仅 Figma 生效`),fillStyleId:i.string().optional().describe(`填充样式 id(团队库样式;平台无此能力时被忽略)`),strokeStyleId:i.string().optional().describe(`描边样式 id(团队库样式;平台无此能力时被忽略)`),textStyleId:i.string().optional().describe(`文本样式 id(团队库样式;平台无此能力时被忽略)`),effectStyleId:i.string().optional().describe(`效果样式 id(团队库样式;平台无此能力时被忽略)`)}).strict().describe(`要修改的属性;各字段仅在匹配的节点类型上生效(如 pointCount 仅 POLYGON/STAR、layoutMode 仅 FRAME),不匹配的字段会被忽略并在结果中提示。只接受此处列出的键,写错键名会直接报错而不是静默忽略`),Ge=i.object({ids:i.array(i.string()).optional().describe(`要修改的节点 id 列表;缺省时作用于当前选中节点`),matchName:i.string().optional().describe(`按节点 name 过滤(精确等值匹配,非模糊/包含;可用 jsd_find 先复核名称),仅命中节点被修改`),recursive:i.boolean().optional().describe(`是否递归应用到子节点子树,默认 false;目标为大容器时慎用(会连坐修改全部后代)`),props:We.describe(`要修改的属性`)}).strict(),Ke=i.object({ids:i.array(i.string()).optional().describe(`按节点 id 精确查找,优先级最高`),name:i.string().optional().describe(`按名称模糊匹配(包含)`),type:i.string().optional().describe(`节点类型过滤,支持:SLICE/FRAME/GROUP/COMPONENT_SET/COMPONENT/INSTANCE/BOOLEAN_OPERATION/VECTOR/STAR/LINE/ELLIPSE/POLYGON/RECTANGLE/TEXT`),recursive:i.boolean().optional().describe(`是否递归查找(默认 true)`),depth:i.number().optional().describe(`序列化深度:0=仅自身,1=含直接子节点;缺省 1`)}),qe=[`create_component`,`create_instance`,`detach_instance`,`import_component`,`swap_component`,`set_instance_properties`,`combine_as_variants`,`copy_overrides`,`apply_overrides`,`sync_overrides`],Je=i.object({op:i.enum([`select`,`remove`,`clone`,`group`,`ungroup`,`flatten`,`outline_stroke`,`reparent`,`repair`],{error:e=>{let t=e.input,n=typeof t==`string`?t:``;return qe.includes(n)?`"${n}" 是组件/实例操作,应使用 jsd_manage_components;本工具仅支持:select|remove|clone|group|ungroup|flatten|outline_stroke|reparent|repair`:`无效 op${n===``?`(缺省)`:` "${n}"`},本工具支持:select|remove|clone|group|ungroup|flatten|outline_stroke|reparent|repair(组件/实例操作在 jsd_manage_components)`}}).describe(`节点结构操作类型:select 设当前选中 | remove 删除(matchName 可再过滤) | clone 复制(右下偏移) | group 编组(可带 layoutMode/itemSpacing/padding* 参数) | ungroup 解组 | flatten 合并为矢量(至少 2 节点) | outline_stroke 描边转轮廓 | reparent 移到 parentId 下(缺省当前选中第一个) | repair 清理已损坏节点`),ids:i.array(i.string()).optional().describe(`节点 id 列表;除 remove/repair 外全部 op 必填(remove 缺省用当前选中)`),matchName:i.string().optional().describe(`仅 remove:在 ids(或当前选中)范围内,仅删除 name 精确匹配的节点`),name:i.string().optional().describe(`仅 group:组名`),layoutMode:i.enum([`NONE`,`HORIZONTAL`,`VERTICAL`]).optional().describe(`仅 group。自动布局方向:NONE=纯归组,子节点仅叠加,HORIZONTAL=水平排列,VERTICAL=垂直排列`),itemSpacing:i.number().optional().describe(`仅 group。自动布局项间距(px);primaryAxisAlignItems=SPACE_BETWEEN 时该项被忽略(子项均匀分布)`),paddingTop:i.number().optional().describe(`仅 group。上内边距(px)`),paddingRight:i.number().optional().describe(`仅 group。右内边距(px)`),paddingBottom:i.number().optional().describe(`仅 group。下内边距(px)`),paddingLeft:i.number().optional().describe(`仅 group。左内边距(px)`),primaryAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional().describe(`仅 group。主轴尺寸模式:FIXED|AUTO`),counterAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional().describe(`仅 group。交叉轴尺寸模式:FIXED|AUTO`),primaryAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`,`SPACE_BETWEEN`]).optional().describe(`仅 group。主轴对齐:MIN|MAX|CENTER|SPACE_BETWEEN;设为 SPACE_BETWEEN 时 itemSpacing 被忽略(子项均匀分布)`),counterAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`]).optional().describe(`仅 group。交叉轴对齐:MIN|MAX|CENTER`),parentId:i.string().optional().describe(`仅 reparent:目标父节点 id,缺省用当前选中第一个节点。reparent 后节点坐标按新父相对系解释,通常需手动修正 x/y`),index:i.number().optional().describe(`仅 reparent:插入位置,缺省追加到末尾;置底用 0`)}).superRefine((e,t)=>{let n=n=>{t.addIssue({code:`custom`,path:[n],message:`op=${e.op} 缺少必填字段 ${n}`})},r=Array.isArray(e.ids)&&e.ids.length>0&&e.ids.every(e=>typeof e==`string`);switch(e.op){case`select`:case`clone`:case`group`:case`ungroup`:case`flatten`:case`outline_stroke`:case`reparent`:r||n(`ids`)}e.op===`flatten`&&r&&Array.isArray(e.ids)&&e.ids.length<2&&t.addIssue({code:`custom`,path:[`ids`],message:`op=flatten 至少需要 2 个节点 id`})}),Ye=i.object({op:i.enum([`create_component`,`create_instance`,`detach_instance`,`import_component`,`swap_component`,`set_instance_properties`,`combine_as_variants`,`copy_overrides`,`apply_overrides`,`sync_overrides`]).describe(`组件操作类型;注意 combine_as_variants/detach_instance 在当前即时设计引擎有内部崩溃,已内置多姿势/副本兜底,仍失败时详见 jsd_manage_components 工具描述`),ids:i.array(i.string()).optional().describe(`节点 id 列表;除 import_component 外全部 op 必填(create_component 为要固化的节点,其余为实例/组件节点)`),name:i.string().optional().describe(`名称;create_component/import_component/combine_as_variants 可选`),key:i.string().optional().describe(`团队库组件唯一标识 Key(仅 import_component 必填)`),componentId:i.string().optional().describe(`目标组件(COMPONENT)节点 id(仅 swap_component 必填)`),properties:i.record(i.string(),i.string()).optional().describe(`变体属性名→值,如 {"状态":"禁用"}(仅 set_instance_properties 必填);可调属性需从 jsd_find/jsd_get_selection 返回的 variantGroupProperties 获取,属性名必须完全匹配`),sourceId:i.string().optional().describe(`源实例(INSTANCE)节点 id;copy_overrides/apply_overrides/sync_overrides 必填`),swapToSource:i.boolean().optional().describe(`套用时是否把目标实例 swap 成源组件,默认 false(swap 会丢失目标既有覆盖,需显式开启)`)}).superRefine((e,t)=>{let n=n=>{t.addIssue({code:`custom`,path:[n],message:`op=${e.op} 缺少必填字段 ${n}`})},r=Array.isArray(e.ids)&&e.ids.length>0&&e.ids.every(e=>typeof e==`string`);switch(e.op){case`create_component`:case`create_instance`:case`detach_instance`:case`swap_component`:case`set_instance_properties`:case`combine_as_variants`:r||n(`ids`);break;case`import_component`:(typeof e.key!=`string`||e.key.length===0)&&n(`key`);break;case`copy_overrides`:(typeof e.sourceId!=`string`||e.sourceId.length===0)&&n(`sourceId`);break;case`apply_overrides`:r||n(`ids`),(typeof e.sourceId!=`string`||e.sourceId.length===0)&&n(`sourceId`);break;case`sync_overrides`:r||n(`ids`),(typeof e.sourceId!=`string`||e.sourceId.length===0)&&n(`sourceId`)}e.op===`swap_component`&&typeof e.componentId!=`string`&&n(`componentId`),e.op===`set_instance_properties`&&(e.properties==null||typeof e.properties!=`object`)&&n(`properties`)}),Xe=i.object({ids:i.array(i.string()).min(1).describe(`必填。要导出的节点 id 列表(数组);只导一个节点也要写成数组,如 ["123:456"]。字段名是 ids,不是 nodeId。`),format:i.enum([`PNG`,`JPG`,`SVG`,`PDF`]).optional().describe(`导出格式,默认 PNG`),scale:i.number().optional().describe(`缩放倍率(PNG/JPG),默认 1`),savePath:i.string().optional().describe(`落盘文件绝对路径,如 /tmp/icon.png`),includeDataUrl:i.boolean().optional().describe(`是否同时返回 base64 dataURL,默认 false`)});i.object({}),i.object({}),i.object({});var Ze=i.object({ids:i.array(i.string()).describe(`要填充图片的节点 id 列表`),sourcePath:i.string().describe(`本地图片文件绝对路径,如 /tmp/poster.png`)}),Qe=i.object({op:i.string().describe(`平台特有操作名(如 figma_variables_create)。先 jsd_ping 看 capabilities 与平台支持列表`),params:i.record(i.string(),i.unknown()).optional().describe(`操作参数,结构随 op 而定`)}),$e=i.enum([`SLICE`,`FRAME`,`GROUP`,`COMPONENT_SET`,`COMPONENT`,`INSTANCE`,`BOOLEAN_OPERATION`,`VECTOR`,`STAR`,`LINE`,`ELLIPSE`,`POLYGON`,`RECTANGLE`,`TEXT`]).describe(`节点类型:SLICE=切片 | FRAME=容器 | GROUP=分组 | COMPONENT_SET=组件集 | COMPONENT=组件 | INSTANCE=实例 | BOOLEAN_OPERATION=布尔运算 | VECTOR=矢量 | STAR=星形 | LINE=线段 | ELLIPSE=椭圆 | POLYGON=多边形 | RECTANGLE=矩形 | TEXT=文本`),et=i.enum([`jsdesign`,`figma`]),tt=i.enum([`styles`,`textTruncation`,`componentProperties`,`variables`,`getMainComponentAsync`,`platformOps`]),nt=i.object({type:i.enum([`BOOLEAN`,`VARIANT`,`TEXT`,`INSTANCE_SWAP`]),value:i.union([i.boolean(),i.string()]),preferredValues:i.array(i.object({type:i.enum([`COMPONENT`,`COMPONENT_SET`]),key:i.string()})).optional()}),P=i.lazy(()=>i.object({id:i.string(),name:i.string(),type:$e,x:i.number(),y:i.number(),width:i.number().optional(),height:i.number().optional(),rotation:i.number().optional(),opacity:i.number().optional(),visible:i.boolean().optional(),locked:i.boolean().optional(),parentId:i.string().optional(),fills:i.array(E).optional(),strokes:i.array(E).optional(),strokeWeight:i.number().optional(),strokeTopWeight:i.number().optional(),strokeBottomWeight:i.number().optional(),strokeLeftWeight:i.number().optional(),strokeRightWeight:i.number().optional(),strokeAlign:i.enum([`CENTER`,`INSIDE`,`OUTSIDE`]).optional(),strokeCap:i.enum([`NONE`,`ROUND`,`SQUARE`,`ARROW_LINES`,`ARROW_EQUILATERAL`]).optional(),strokeJoin:i.enum([`MITER`,`BEVEL`,`ROUND`]).optional(),dashPattern:i.array(i.number()).optional(),cornerSmoothing:i.number().optional(),blendMode:T.optional(),constraints:i.object({horizontal:O,vertical:O}).optional(),layoutGrids:i.array(k).optional(),clipsContent:i.boolean().optional(),arcData:i.object({startingAngle:i.number(),endingAngle:i.number(),innerRadius:i.number()}).optional(),effects:i.array(D).optional(),cornerRadius:i.number().optional(),topLeftRadius:i.number().optional(),topRightRadius:i.number().optional(),bottomLeftRadius:i.number().optional(),bottomRightRadius:i.number().optional(),pointCount:i.number().optional(),innerRadius:i.number().optional(),layoutMode:i.enum([`NONE`,`HORIZONTAL`,`VERTICAL`]).optional(),itemSpacing:i.number().optional(),paddingTop:i.number().optional(),paddingRight:i.number().optional(),paddingBottom:i.number().optional(),paddingLeft:i.number().optional(),primaryAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional(),counterAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional(),primaryAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`,`SPACE_BETWEEN`]).optional(),counterAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`]).optional(),layoutGrow:i.number().optional(),layoutAlign:i.enum([`MIN`,`CENTER`,`MAX`,`STRETCH`,`INHERIT`]).optional(),childCount:i.number().optional(),children:i.array(P).optional(),characters:i.string().optional(),fontSize:i.number().optional(),fontName:A.optional(),textAlignHorizontal:i.enum([`LEFT`,`CENTER`,`RIGHT`,`JUSTIFIED`]).optional(),textAlignVertical:i.enum([`TOP`,`CENTER`,`BOTTOM`]).optional(),textAutoResize:i.enum([`NONE`,`WIDTH_AND_HEIGHT`,`HEIGHT`,`TRUNCATE`]).optional(),textCase:i.enum([`ORIGINAL`,`UPPER`,`LOWER`,`TITLE`]).optional(),textDecoration:i.enum([`NONE`,`UNDERLINE`,`STRIKETHROUGH`]).optional(),lineHeight:_e.optional(),letterSpacing:ve.optional(),vectorPaths:i.array(ge).optional(),booleanOperation:i.enum([`UNION`,`SUBTRACT`,`INTERSECT`,`EXCLUDE`]).optional(),isMask:i.boolean().optional(),variantProperties:i.record(i.string(),i.string()).optional(),mainComponentId:i.string().optional(),variantGroupProperties:i.record(i.string(),i.array(i.string())).optional(),textTruncation:i.enum([`DISABLED`,`ENDING`]).optional(),maxLines:i.number().optional(),fillStyleId:i.string().optional(),strokeStyleId:i.string().optional(),textStyleId:i.string().optional(),effectStyleId:i.string().optional(),componentProperties:i.record(i.string(),nt).optional()})),F=i.object({created:i.union([P,i.array(P)])}),rt=i.object({updated:i.array(P),warnings:i.array(i.string()).optional()}),it=i.object({connected:i.boolean(),platform:et.optional(),capabilities:i.array(tt).optional().describe(`当前平台支持的能力列表(先查此字段再决定能否调用平台特有操作)`),error:i.string().optional()}),at=i.object({selection:i.array(P),pageName:i.string()}),ot=i.object({nodes:i.array(P),total:i.number()}),st=i.object({selected:i.array(i.string()).optional(),removed:i.array(i.string()).optional(),ungrouped:i.array(i.string()).optional(),moved:i.array(P).optional(),cleaned:i.array(i.string()).optional(),created:i.union([P,i.array(P)]).optional()}),ct=i.object({variantProperties:i.record(i.string(),i.string()).optional(),componentProperties:i.record(i.string(),nt).optional(),propsSummary:i.array(i.string()).optional()}),lt=i.object({instanceId:i.string(),instanceName:i.string(),ok:i.boolean(),message:i.string().optional()}),ut=i.object({created:i.union([P,i.array(P)]).optional(),swapped:i.array(P).optional(),updated:i.array(P).optional(),snapshotId:i.string().optional(),sourceName:i.string().optional(),captured:ct.optional(),applied:i.array(lt).optional(),source:ct.optional(),failed:i.array(i.object({id:i.string(),message:i.string()})).optional()}),dt=i.object({exports:i.array(i.object({id:i.string(),name:i.string(),format:i.enum([`PNG`,`JPG`,`SVG`,`PDF`]),mimeType:i.string(),size:i.number(),path:i.string().optional(),dataUrl:i.string().optional()}))}),ft=i.object({families:i.array(i.string()),count:i.number()});i.object({pageName:i.string(),nodes:i.array(i.object({id:i.string(),name:i.string(),type:$e,x:i.number(),y:i.number(),width:i.number().optional(),height:i.number().optional(),childCount:i.number().optional()})),count:i.number()}),i.object({styles:i.array(i.object({id:i.string(),name:i.string(),type:i.enum([`PAINT`,`TEXT`,`EFFECT`,`GRID`])})),count:i.number()});var pt={debug:0,info:1,warn:2,error:3},mt=process.env.TEXT_TO_DESIGN_MCP_LOG??`/tmp/text-to-design-mcp.log`,ht=pt,gt=process.env.TEXT_TO_DESIGN_MCP_LOG_LEVEL??`info`,_t=null;function vt(e){_t=e}function I(e,n){if(ht[e]>=ht[gt])try{t(mt,`${new Date().toISOString()} [${e.toUpperCase()}] [text-to-design-mcp] ${n}\n`)}catch{}try{_t?.(e,n)}catch{}}function L(e){I(`info`,e)}function R(e){I(`debug`,e)}function z(e){I(`warn`,e)}function B(e){I(`error`,e)}var yt=3e4,bt=class{pending=new Map;seq=0;binaryTarget=null;sendFn;constructor(e){this.sendFn=e}request(e,t,n={}){let r=n.timeout??yt,i=n.signal,a=`r${++this.seq}`,o=t&&typeof t==`object`&&`bytes`in t?t.bytes:null,s=o==null?{type:`request`,id:a,method:e,params:t}:{type:`request`,id:a,method:e,params:{...t,hasBinary:!0,bytes:void 0}};return new Promise((t,n)=>{let c=Date.now(),l={id:a,method:e,resolve:t,reject:n,timer:null,waitBinary:!1,binaryCount:0,buffers:[],startedAt:c};if(l.timer=setTimeout(()=>{this.pending.delete(a),this.detachAbort(l),z(`请求超时: ${a} ${e} 耗时=${Date.now()-c}ms`),n(Error(`请求超时: ${e}`))},r),i){if(i.aborted){clearTimeout(l.timer),n(Error(`请求已取消: ${e}`));return}l.abort={signal:i,listener:()=>{this.pending.delete(a)&&(this.detachAbort(l),L(`请求取消: ${a} ${e} 耗时=${Date.now()-c}ms`),n(Error(`请求已取消: ${e}`)))}},i.addEventListener(`abort`,l.abort.listener,{once:!0})}this.pending.set(a,l),L(`发出请求: ${a} ${e}${o==null?``:` +binary(${o.byteLength}B)`}`),this.sendFn(JSON.stringify(s),o==null?void 0:Buffer.from(o))})}detachAbort(e){e.abort&&=(e.abort.signal.removeEventListener(`abort`,e.abort.listener),void 0)}onText(e){let t;try{t=JSON.parse(e.toString())}catch{z(`WS 文本解析失败: ${e.toString().slice(0,100)}`);return}if(t.type===`request`){t.method===`ping`?(L(`收到 ping 请求: ${t.id} (自动回 pong)`),this.sendFn(JSON.stringify({type:`response`,id:t.id,ok:!0,data:{pong:!0}}))):L(`收到未知请求: ${t.id} ${t.method} (忽略)`);return}if(t.type!==`response`){L(`收到非响应消息: type=${t.type}`);return}let n=this.pending.get(t.id);if(!n){z(`未匹配响应: id=${t.id}(可能已超时或来源不明)`);return}if(t.hasBinary&&(t.binaryCount??1)>0){L(`二进制响应开始: id=${t.id} count=${t.binaryCount??1}`),n.waitBinary=!0,n.binaryCount=t.binaryCount??1,n.data=t.data,this.binaryTarget=n;return}this.pending.delete(t.id),clearTimeout(n.timer),this.detachAbort(n);let r=`响应: ${n.id} ${n.method} ok=${t.ok} 耗时=${Date.now()-n.startedAt}ms${t.ok?``:` error=${t.error??``}`}`;t.ok?L(r):B(r),t.ok?n.resolve(t.data):n.reject(Error(t.error??`plugin error`))}onBinary(e){if(!this.binaryTarget){L(`孤儿二进制帧 len=${e.byteLength}(无待组装响应)`);return}if(this.binaryTarget.buffers.push(e),L(`二进制帧: id=${this.binaryTarget.id} ${this.binaryTarget.buffers.length}/${this.binaryTarget.binaryCount}`),this.binaryTarget.buffers.length>=this.binaryTarget.binaryCount){let e=this.binaryTarget;this.binaryTarget=null;let t=e.buffers.reduce((e,t)=>e+t.byteLength,0);L(`二进制组装完成: id=${e.id} ${e.buffers.length} 帧 ${t}B 耗时=${Date.now()-e.startedAt}ms`),this.settle(e)}}rejectAll(e){for(let[,t]of this.pending)clearTimeout(t.timer),this.detachAbort(t),t.reject(e);this.pending.clear()}clear(){for(let[,e]of this.pending)clearTimeout(e.timer),this.detachAbort(e);this.pending.clear(),this.binaryTarget=null}settle(e){this.pending.delete(e.id),clearTimeout(e.timer),this.detachAbort(e),e.resolve(xt(e.data,e.buffers))}};function xt(e,t){let n=t.length===1?t[0]:t;if(!e||typeof e!=`object`)return n;let r=e;if(r.exports&&typeof r.exports==`object`){let e=r.exports,n={};return Object.entries(e).forEach(([e,r],i)=>{n[e]={...r,bytes:t[i]}}),{...r,exports:n}}return{...r,bytes:n}}var St=class{wss=null;http=null;client=null;heartbeat=null;_port=0;onMessage=null;onConnect=null;onDisconnect=null;get port(){return this._port}async start(e){if(this.http=a(),this.wss=new s({server:this.http}),this.wss.on(`error`,()=>{}),this.heartbeat=setInterval(()=>{this.client&&this.client.readyState===o.OPEN&&(this.client.send(JSON.stringify({type:`status`,state:`connected`,version:v})),R(`心跳: 下发状态确认`))},3e4),this.wss.on(`connection`,e=>{this.client=e,L(`插件已连接`);try{this.onConnect?.()}catch(e){L(`onConnect 回调异常: ${e instanceof Error?e.message:String(e)}`)}e.send(JSON.stringify({type:`status`,state:`connected`,version:v})),R(`已下发状态确认(status connected)`),e.on(`message`,(e,t)=>{let n=Buffer.isBuffer(e)?e:Buffer.from(e);R(`收到 WS 消息 len=${n.length} bin=${t}`),this.onMessage?.(n,t)}),e.on(`close`,()=>{this.client===e&&(this.client=null),L(`插件断开`),this.onDisconnect?.(Error(`plugin disconnected`))}),e.on(`error`,()=>{this.client===e&&(this.client=null),this.onDisconnect?.(Error(`plugin connection error`))})}),!await this.tryListen(e))throw this.http.close(),Error(`端口 ${e} 已被占用。已有 text-to-design-mcp 实例在运行?请检查残留进程后重试`);this._port=e}stop(){this.heartbeat&&clearInterval(this.heartbeat),this.heartbeat=null,this.wss?.close(),this.http?.close()}get isConnected(){return this.client!==null&&this.client.readyState===o.OPEN}send(e){this.client&&this.client.readyState===o.OPEN?(this.client.send(e),R(`发送 WS 消息 len=${e.length} bin=${typeof e!=`string`}`)):z(`发送失败: 无客户端连接(${e.length} 字节被丢弃)`)}sendPush(e){this.client&&this.client.readyState===o.OPEN&&this.client.send(e)}tryListen(e){return new Promise(t=>{let n=()=>{i(),t(!1)},r=()=>{i(),t(!0)},i=()=>{this.http?.off(`error`,n),this.http?.off(`listening`,r)};this.http?.once(`error`,n),this.http?.once(`listening`,r),this.http?.listen(e)})}},Ct=200,wt=class{transport=new St;pending;logRing=[];onConnectionChange=null;constructor(){this.pending=new bt((e,t)=>{this.transport.send(e),t&&this.transport.send(t)}),this.transport.onMessage=(e,t)=>{t?this.pending.onBinary(e):this.pending.onText(e)},this.transport.onConnect=()=>{this.replayLogs(),this.onConnectionChange?.(!0)},this.transport.onDisconnect=e=>{this.pending.rejectAll(e),this.onConnectionChange?.(!1)}}get port(){return this.transport.port}start(e){return this.transport.start(e)}stop(){this.pending.clear(),this.logRing=[],this.transport.stop()}get isConnected(){return this.transport.isConnected}request(e,t,n={}){return this.transport.isConnected?this.pending.request(e,t,n):(z(`请求被拒(插件未连接): ${e}`),Promise.reject(Error(`${C.runtime} 插件未连接。请先在${C.label}客户端中运行该插件。`)))}notifyLog(e,t){let n={type:`log`,level:e,line:t};if(!this.transport.isConnected){this.logRing.length>=Ct&&this.logRing.shift(),this.logRing.push(n);return}this.sendLogPush(n)}replayLogs(){if(this.logRing.length===0)return;let e=this.logRing;this.logRing=[],L(`回放离线日志 ${e.length} 条`);for(let t of e)this.sendLogPush(t)}sendLogPush(e){try{this.transport.sendPush(JSON.stringify(e))}catch{}}};async function Tt(){try{let e=await fetch(`http://127.0.0.1:${b}/health`,{signal:AbortSignal.timeout(800)});if(!e.ok)return null;let t=await e.json();return t.name&&t.version?{name:t.name,version:t.version}:null}catch{return null}}async function V(){let e=await Tt();if(e&&e.version!==S){L(`检测到旧版 daemon (${e.version} → ${S}),正在替换...`),await fetch(`http://127.0.0.1:${b}/shutdown`,{method:`POST`}).catch(()=>{});let t=Date.now()+2e3;for(;Date.now()<t&&(await H(250),await Tt()!==null););return{state:`none`}}let t=new c({name:`text-to-design-proxy`,version:S},{versionNegotiation:{mode:`auto`}});try{await t.connect(new l(new URL(`http://127.0.0.1:${b}/mcp`)));let{tools:e}=await t.listTools();return e.length===0||!e.every(e=>e.name.startsWith(`jsd_`))?(await t.close(),{state:`foreign`}):{state:`proxy`,client:t}}catch{return await t.close().catch(()=>{}),{state:`none`}}}function H(e){return new Promise(t=>setTimeout(t,e))}function Et(e){let t=e.properties;if(typeof t!=`object`||!t)return null;for(let e of Object.values(t))if(!(typeof e!=`object`||!e)){if(`const`in e&&e.const!=null)return String(e.const);if(Array.isArray(e.enum)&&e.enum.length>0)return String(e.enum[0])}return null}function Dt(e){let t=[e.oneOf,e.anyOf].find(e=>Array.isArray(e)&&e.length>0);return t==null?null:t.map((e,t)=>{let n=e??{},r=Et(n)??`分支#${t}`,i=Array.isArray(n.required)?n.required.filter(e=>e!==`op`):[];return i.length>0?`${r}(需 ${i.join(`, `)})`:`${r}(无必填)`}).join(` | `)}function Ot(e){if(typeof e!=`object`||!e||Array.isArray(e))return JSON.stringify(e)??String(e);let t=Object.keys(e);return t.length>0?`字段 [${t.join(`, `)}]`:`空对象 {}`}function kt(e){let t=ee(e)[`~standard`],n=Dt(e);return{"~standard":{...t,validate(e){let r=t.validate(e);if(!(`issues`in r))return r;let i=``;if(typeof e==`object`&&e&&!Array.isArray(e)){let t=e.op;typeof t==`string`&&(i=`, op='${t}'`)}let a=r.issues.map(e=>typeof e?.message==`string`?e.message:``).filter(Boolean).join(`; `).slice(0,300),o=n==null?``:`该工具按判别字段分发,可选值: ${n}。`;return{issues:[{message:`入参校验失败: 实际收到${Ot(e)}${i}。${o}请补齐对应必填字段后重试。原始校验: ${a}`}]}}}}}function At(){let e=ne(process.execPath,[...process.execArgv,...process.argv.slice(1)],{detached:!0,stdio:`ignore`,env:{...process.env,TEXT_TO_DESIGN_MCP_ROLE:`daemon`}});e.unref(),e.on(`error`,e=>{B(`拉起 daemon 失败: ${e.message}`)})}var jt=1500,Mt=2e4,Nt=2e3,Pt=2e4,Ft=15e3;function It(e){let t=e instanceof Error?e.message:String(e);return/fetch failed|ECONNREFUSED|ECONNRESET|EPIPE|socket hang up|terminated|closed/i.test(t)}async function Lt(e){let t=e,n=!1,r=null,a=new u({name:x,version:S},{supportedProtocolVersions:[`2026-07-28`,...f],...e.getInstructions()?{instructions:e.getInstructions()}:{}}),o=new Map,s=new Map,c=new Map,l=new Map,p=async e=>{try{return await e(t)}catch(r){if(n||!It(r))throw r;return z(`shim: 上游请求失败,触发重连后重放`),await _(),e(t)}};async function ne(){let{tools:e}=await p(e=>e.listTools()),t=new Set;for(let n of e){t.add(n.name);let e=JSON.stringify(n),r=o.get(n.name);if(r&&r.raw===e)continue;r?.handle.remove(),o.delete(n.name);let i=a.registerTool.bind(a)(n.name,{title:n.title,description:n.description,annotations:n.annotations,...n.inputSchema?{inputSchema:kt(n.inputSchema)}:{},...n.outputSchema?{outputSchema:ee(n.outputSchema)}:{}},async e=>p(t=>t.callTool({name:n.name,arguments:e??{}})));o.set(n.name,{handle:i,raw:e})}for(let[e,n]of[...o])t.has(e)||(n.handle.remove(),o.delete(e))}async function m(){let{prompts:e}=await p(e=>e.listPrompts()),t=new Set;for(let n of e){t.add(n.name);let e=JSON.stringify(n),r=s.get(n.name);if(r&&r.raw===e)continue;r?.handle.remove(),s.delete(n.name);let o={};for(let e of n.arguments??[])o[e.name]=i.string().describe(e.description??``);let c=a.registerPrompt(n.name,{title:n.title,description:n.description,argsSchema:i.object(o)},e=>p(t=>t.getPrompt({name:n.name,...e?{arguments:e}:{}})));s.set(n.name,{handle:c,raw:e})}for(let[e,n]of[...s])t.has(e)||(n.handle.remove(),s.delete(e))}async function h(){let[{resources:e},{resourceTemplates:t}]=await Promise.all([p(e=>e.listResources()),p(e=>e.listResourceTemplates())]),n=new Set;for(let t of e){let e=t.uri;n.add(e);let r=JSON.stringify(t),i=c.get(e);if(i&&i.raw===r)continue;i?.handle.remove(),c.delete(e);let o=a.registerResource(t.name,e,{title:t.title,description:t.description,mimeType:t.mimeType},async e=>p(t=>t.readResource({uri:e.href})));c.set(e,{handle:o,raw:r})}for(let[e,t]of[...c])n.has(e)||(t.handle.remove(),c.delete(e));let r=new Set;for(let e of t){let t=String(e.uriTemplate);r.add(t);let n=JSON.stringify(e),i=l.get(t);if(i&&i.raw===n)continue;i?.handle.remove(),l.delete(t);let o=a.registerResource(e.name,new d(t,{list:void 0}),{title:e.title,description:e.description,mimeType:e.mimeType},async(e,t)=>p(t=>t.readResource({uri:e.href})));l.set(t,{handle:o,raw:n})}for(let[e,t]of[...l])r.has(e)||(t.handle.remove(),l.delete(e))}let g=async()=>{let e=await Promise.allSettled([ne(),m(),h()]);for(let t of e)t.status===`rejected`&&z(`同步清单失败: ${String(t.reason).slice(0,120)}`)},_=()=>r||(r=(async()=>{let e=Date.now()+Mt,n=null;for(;Date.now()<e;){try{let e=await V();if(e.state===`proxy`){t=e.client,re(t),ae(),L(`shim: 上游已恢复`),await g();return}e.state===`none`&&At()}catch(e){n=e}await H(jt)}throw n??Error(`上游重连超时(${Mt}ms)`)})().finally(()=>{r=null}),r),re=e=>{e.onclose=()=>{n||(z(`shim: 上游断开,自动重连`),_().catch(()=>{}))},e.setNotificationHandler(`notifications/tools/list_changed`,async()=>ne().catch(()=>{})),e.setNotificationHandler(`notifications/prompts/list_changed`,async()=>m().catch(()=>{})),e.setNotificationHandler(`notifications/resources/list_changed`,async()=>h().catch(()=>{})),e.setNotificationHandler(`notifications/resources/updated`,async e=>{let t=e.params;t?.uri!=null&&await a.server.sendResourceUpdated({uri:t.uri}).catch(()=>{})})};re(t);let ie=te(async()=>(await g(),a)),v=Date.now()+Pt,y=null,b=()=>{n||(y=setTimeout(()=>{n||(g(),b())},Date.now()<v?Nt:Ft),y.unref())},ae=()=>{v=Date.now()+Pt};b(),L(`shim 模式: stdio → 动态同步,共享 daemon`),process.on(`SIGINT`,async()=>{n=!0,y&&clearTimeout(y),await ie.close(),await t.close().catch(()=>{}),process.exit(0)})}function Rt(e){return{content:[{type:`text`,text:typeof e==`string`?e:JSON.stringify(e,null,2)}]}}function zt(e){return e._def?.typeName}function Bt(e,t){return e._def?.[t]}function Vt(e,t){return e._def?.[t]}function U(e){switch(zt(e)){case`ZodObject`:{let t=e.shape;if(typeof t!=`function`)return;let n={};for(let[e,r]of Object.entries(t()))n[e]=U(r);return n}case`ZodArray`:return[];case`ZodBoolean`:return!1;case`ZodNumber`:return 0;case`ZodString`:return``;case`ZodLiteral`:return Vt(e,`value`);case`ZodEnum`:return Vt(e,`values`)?.[0];case`ZodOptional`:case`ZodDefault`:{let t=Bt(e,`innerType`);return t?U(t):void 0}case`ZodEffects`:{let t=Bt(e,`schema`);return t?U(t):void 0}case`ZodUnion`:{let t=Vt(e,`options`)??[],n=t.find(e=>zt(e)===`ZodArray`);return n?U(n):t[0]?U(t[0]):void 0}case`ZodLazy`:{let t=e._def?.getter;return t?U(t()):void 0}default:return}}function Ht(e,t){let n={content:[{type:`text`,text:`错误: ${e instanceof Error?e.message:String(e)}`}],isError:!0};return t?{...n,structuredContent:U(t)}:n}function Ut(e,t,n){if(t){let r=t.safeParse(e);return r.success?{content:[...n??[],...Rt(e).content],structuredContent:r.data}:{content:Rt(e).content,structuredContent:U(t),isError:!0}}return{content:[...n??[],...Rt(e).content],structuredContent:e}}var Wt=new Map;function Gt(e){return Wt.get(e)}function Kt(){return[...Wt.keys()].sort()}function W(e){return(t,n)=>{let r=t.registerTool.bind(t),i=async(t,r)=>{try{if(e.inputSchema!=null){let n=e.inputSchema.safeParse(t);if(!n.success){let t=n.error.issues.map(e=>`${e.path.join(`.`)||`(root)`}: ${e.message}`).join(`; `);throw Error(`参数校验失败(${e.name}): ${t}`)}t=n.data}let i={...r==null?{}:{signal:r},...e.timeout==null?{}:{timeout:e.timeout}},a;return a=e.run?await e.run(t,n,r??new AbortController().signal):await n.request(e.method,e.payload?e.payload(t):t,i),Ut(a,e.outputSchema,e.extraContent?e.extraContent(a,t):void 0)}catch(t){let n=t instanceof Error?t.message:String(t);return B(`工具 ${e.name} 执行失败: ${n.slice(0,200)}`),Ht(t,e.outputSchema)}};Wt.set(e.name,i);let a=r(e.name,{title:e.title,description:e.description,...e.inputSchema?{inputSchema:e.inputSchema}:{},outputSchema:e.outputSchema,...e.annotations?{annotations:e.annotations}:{}},async(...t)=>{let n=e.inputSchema!=null,r=t[0],a=t[1],o=n?r??{}:{},s=n?a:r,c=s?.mcpReq?.signal??s?.signal;return i(o,c)});return a.alwaysEnabled=e.alwaysEnabled??!1,a}}function qt(e,t){let n=e;for(let e of t.split(`.`)){let t=/^([\w$\u4e00-\u9fff-]*)((?:\[\d+\])*)$/.exec(e.trim());if(t==null)return{ok:!1};if(t[1]!==``){if(typeof n!=`object`||!n)return{ok:!1};n=n[t[1]]}if(t[2]!==``)for(let e of t[2].matchAll(/\[(\d+)\]/g)){if(!Array.isArray(n))return{ok:!1};n=n[Number(e[1])]}}return{ok:!0,value:n}}function Jt(e,t){let n=e.indexOf(`.`),r=n===-1?e:e.slice(0,n),i=n===-1?``:e.slice(n+1);if(!t.has(r)){let n=[...t.keys()].join(`, `)||`无`;throw Error(`占位符引用的步骤不存在或未成功:「${e}」(已完成: ${n})`)}let a=t.get(r);if(i===``)return a;let o=qt(a,i);if(!o.ok)throw Error(`无法解析占位符引用「${e}」:请核对步骤 ${r} 的返回结构`);return o.value}var Yt=/\{\{\s*([^{}]+?)\s*\}\}/g,Xt=/^\{\{\s*([^{}]+?)\s*\}\}$/;function Zt(e,t){if(typeof e==`string`){let n=Xt.exec(e.trim());return n==null?e.replace(Yt,(e,n)=>{let r=Jt(n,t);return typeof r==`string`?r:JSON.stringify(r)}):Jt(n[1],t)}if(Array.isArray(e))return e.map(e=>Zt(e,t));if(typeof e==`object`&&e){let n={};for(let[r,i]of Object.entries(e))n[r]=Zt(i,t);return n}return e}function Qt(e,t){return[W({name:`jsd_batch`,title:`批量编排执行`,description:`批量编排器:一次请求内顺序执行多个 jsd_* 步骤,前一步结果经双花括号占位符(内容为 步骤id.字段路径)注入后一步 args,中间 id 不回传模型,显著减少往返与上下文。
3
- 占位符独占一个参数值时保留原类型(数组可直接作 ids 用),嵌在字符串中按 JSON 文本展开;id 重复/未知工具/引用失败立即中止,工具执行失败默认也中止(stopOnError=false 或单步 continueOnError=true 可走完)。每步只回传 structuredContent。
4
- 常用取值路径速查(路径与各工具返回结构对应,写错会报「无法解析占位符引用」):jsd_create_nodes/create_instance/manage_nodes group 等 → {{id.created[0].id}}(created 为数组);jsd_create_svg/jsd_create_icon/manage_components create_component → {{id.created.id}}(created 为单对象);jsd_find → {{id.nodes[0].id}};jsd_update_node → {{id.updated[0].id}}。`,inputSchema:be,outputSchema:xe,annotations:{readOnlyHint:!1,destructiveHint:!0},timeout:ce,run:async(e,t,n)=>{let{calls:r,stopOnError:i}=e,a=new Map,o=[];for(let e=0;e<r.length;e++){let t=r[e],s=t.id==null||t.id.trim()===``?`step${e+1}`:t.id.trim(),c=e=>{o.push({id:s,tool:t.tool,ok:!1,error:e})};if(a.has(s)||o.some(e=>e.id===s)){c(`步骤 id "${s}" 重复`);break}let l=Gt(t.tool);if(l==null){c(`未知工具 ${t.tool},可用: ${Kt().join(`, `)}`);break}let u;try{u=Zt(t.args??{},a)}catch(e){c(e instanceof Error?e.message:String(e));break}let d=await l(u,n);if(d.isError===!0){if(c((d.content?.find(e=>e.type===`text`)?.text??`工具返回错误`).slice(0,300)),i!==!1&&t.continueOnError!==!0)break;continue}a.set(s,d.structuredContent),o.push({id:s,tool:t.tool,ok:!0,data:d.structuredContent})}return{ok:o.length===r.length&&o.every(e=>e.ok),executed:o.length,total:r.length,results:o}}})(e,t)]}var $t=new Set([`script`,`style`,`head`,`meta`,`link`,`title`,`noscript`]),en={white:`#ffffff`,black:`#000000`,red:`#ff0000`,green:`#008000`,blue:`#0000ff`,gray:`#808080`,grey:`#808080`,transparent:`none`},tn=`#f3f4f6`;function nn(e){let t={};if(!e)return t;for(let n of e.split(`;`)){let e=n.indexOf(`:`);if(e<0)continue;let r=n.slice(0,e).trim().toLowerCase(),i=n.slice(e+1).trim();r&&(t[r]=i)}return t}function G(e){if(e==null)return;let t=e.match(/^(-?[\d.]+)(px)?$/);return t?parseFloat(t[1]):void 0}function K(e,t){if(e==null||e===``)return t;let n=e.trim();return n===`transparent`?`none`:en[n.toLowerCase()]||(n.startsWith(`#`)||n.startsWith(`rgb`)?n:t)}function rn(e){let t=(e.margin??``).split(/\s+/).filter(Boolean).map(e=>G(e)??0),n=0,r=0,i=0,a=0;return t.length===1?n=r=i=a=t[0]:t.length===2?(n=i=t[0],r=a=t[1]):t.length===4&&(n=t[0],r=t[1],i=t[2],a=t[3]),n=G(e[`margin-top`])??n,r=G(e[`margin-right`])??r,i=G(e[`margin-bottom`])??i,a=G(e[`margin-left`])??a,{top:n,right:r,bottom:i,left:a}}function an(e){let t=(e.padding??``).split(/\s+/).filter(Boolean).map(e=>G(e)??0),n=0,r=0,i=0,a=0;return t.length===1?n=r=i=a=t[0]:t.length===2?(n=i=t[0],r=a=t[1]):t.length===4&&(n=t[0],r=t[1],i=t[2],a=t[3]),n=G(e[`padding-top`])??n,r=G(e[`padding-right`])??r,i=G(e[`padding-bottom`])??i,a=G(e[`padding-left`])??a,{top:n,right:r,bottom:i,left:a}}function on(e){let t={width:0,color:`#000000`},n=e.border;if(n&&n!==`none`&&n!==`0`){let e=n.match(/([\d.]+)(?:px)?(?:\s+[^ ]+)?\s+(.+)$/);if(e)return{width:parseFloat(e[1])||1,color:K(e[2])??`#000000`};let t=n.match(/([\d.]+)(?:px)?/);if(t)return{width:parseFloat(t[1]),color:`#000000`}}return e[`border-width`]&&e[`border-width`]!==`0`&&e[`border-width`]!==`none`?{width:G(e[`border-width`])??1,color:K(e[`border-color`])??`#000000`}:t}function q(e,t){return G(e[t])}function sn(e){return G(e[`font-size`])??16}function cn(e){let t=e[`font-weight`];return t===`bold`?700:G(t)??400}function ln(e,t){let n=e[`line-height`];return G(n)??(n!=null&&!n.endsWith(`px`)?parseFloat(n)*t:t*1.4)}function un(e){return(e.display??``).includes(`flex`)}function dn(e){return e[`flex-direction`]===`row`?`row`:`column`}function fn(e){return G(e.gap)??G(e[`row-gap`])??0}function pn(e){let t=e[`text-align`];return t===`center`?`center`:t===`right`?`right`:`left`}function mn(e,t){let n=0;for(let r of e)r.charCodeAt(0)>11904?n+=t:n+=t*.55;return n}function hn(e){return e.type===`text`?e.data:_(e)?e.tagName===`br`?`
5
- `:e.children.map(hn).join(``):``}function gn(e){return e.replace(/\s+/g,` `).trim()}function _n(e,t){let n=nn(e.attribs.style),r={tag:e.tagName,style:n,children:[],isText:!1,x:0,y:0,w:0,h:0};if(e.tagName===`img`)return r.w=q(n,`width`)??120,r.h=q(n,`height`)??120,r;for(let t of e.children){if(t.type===`text`){let e=gn(t.data);if(!e)continue;let i=r.children[r.children.length-1];i?.isText?i.text=(i.text??``)+e:r.children.push({tag:`#text`,text:e,style:vn(n),children:[],isText:!0,x:0,y:0,w:0,h:0});continue}_(t)&&($t.has(t.tagName)||t.tagName!==`br`&&r.children.push(_n(t,!1)))}if(t&&r.children.length===0){let t=gn(e.children.map(hn).join(``));t&&r.children.push({tag:`#text`,text:t,style:vn(n),children:[],isText:!0,x:0,y:0,w:0,h:0})}return r}function vn(e){let t={};for(let n of[`color`,`font-size`,`font-weight`,`font-family`,`line-height`,`text-align`,`letter-spacing`])e[n]!=null&&(t[n]=e[n]);return t}function yn(e,t){let n=e.style,r=an(n),i=rn(n),a=on(n),o=Math.max(0,t-r.left-r.right-a.width*2);if(e.tag===`img`)return e.w=q(n,`width`)??120,e.h=q(n,`height`)??120,{width:e.w+i.left+i.right,height:e.h+i.top+i.bottom};let s=o,c=0;if(e.isText){let t=sn(n),r=(e.text??``).split(`
6
- `).map(e=>e.trim()).filter(Boolean);e.w=Math.min(o,Math.max(...r.map(e=>mn(e,t)),t)),e.h=r.length*ln(n,t),c=e.h}else{let t=un(n),i=dn(n),o=fn(n),l=q(n,`width`),u=q(n,`height`);if(l!=null&&(s=Math.max(0,l-r.left-r.right-a.width*2)),t&&i===`row`){let t=0,n=0;for(let i of e.children){let e=yn(i,s-t);i.x=t+r.left+a.width,i.y=r.top+a.width,i.isText&&pn(i.style)!==`left`&&(i.w=s-t),t+=e.width,t+=o,n=Math.max(n,e.height)}c=n,e.w=t-(e.children.length?o:0)}else{let t=0,n=0;for(let i of e.children){let e=yn(i,s);i.x=r.left+a.width,i.y=t+r.top+a.width,i.isText&&pn(i.style)!==`left`&&(i.w=s),t+=e.height,t+=o,n=Math.max(n,e.width)}c=t-(e.children.length?o:0),e.w=n}e.w=l??e.w,e.h=u??c,c=u??c}let l=r.left+r.right+a.width*2,u=r.top+r.bottom+a.width*2;return q(n,`width`)??(e.w+=l),q(n,`height`)==null&&!e.isText&&(e.h+=u),{width:e.w+i.left+i.right,height:e.h+i.top+i.bottom}}function bn(e){let t=rn(e.style);e.x+=t.left,e.y+=t.top}function xn(e,t,n){let r=[];return Sn(e,r,0,0),`<svg xmlns="http://www.w3.org/2000/svg" width="${t}" height="${n}" viewBox="0 0 ${t} ${n}">${r.join(``)}</svg>`}function Sn(e,t,n,r){let i=e.style,a=n+e.x,o=r+e.y,s=e.w,c=e.h;if(e.isText){let n=sn(i),r=K(i.color,`#000000`),c=i[`font-family`]??`sans-serif`,l=cn(i),u=pn(i),d=u===`center`?`middle`:u===`right`?`end`:`start`,f=u===`center`?a+s/2:u===`right`?a+s:a,p=ln(i,n);(e.text??``).split(`
7
- `).filter(e=>e.trim()).forEach((e,i)=>{t.push(`<text x="${f.toFixed(1)}" y="${(o+p*i+n).toFixed(1)}" font-size="${n}" font-family="${c}" font-weight="${l}" fill="${r}" text-anchor="${d}">${Cn(e)}</text>`)});return}let l=K(i.background??i[`background-color`],e.tag===`img`?tn:void 0),u=on(i),d=G(i[`border-radius`])??0,f=l&&l!==`none`;if(e.tag===`img`||f||u.width>0){let e=[`x="${a.toFixed(1)}"`,`y="${o.toFixed(1)}"`,`width="${Math.max(0,s).toFixed(1)}"`,`height="${Math.max(0,c).toFixed(1)}"`];d>0&&e.push(`rx="${d}"`),f&&e.push(`fill="${l}"`),u.width>0&&e.push(`stroke="${u.color}" stroke-width="${u.width}"`),t.push(`<rect ${e.join(` `)} />`)}for(let n of e.children)bn(n),Sn(n,t,a,o)}function Cn(e){return e.replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`).replace(/"/g,`&quot;`)}function wn(e){let t=re(e,{decodeEntities:!0}).children.filter(e=>_(e)),n=t.find(e=>e.tagName===`body`)??t[0];if(!n)return`<svg xmlns="http://www.w3.org/2000/svg" width="1" height="1" viewBox="0 0 1 1"></svg>`;let r=_n(n,!0),i=nn(n.attribs.style),a=q(i,`width`),o=q(i,`height`),s=yn(r,a??800),c=a??Math.min(s.width,1600),l=o??s.height;return r.x=0,r.y=0,a??(r.w=c),o??(r.h=l),xn(r,c,l)}var Tn={"activity-square":`square-activity`,"alarm-check":`alarm-clock-check`,"alarm-minus":`alarm-clock-minus`,"alarm-plus":`alarm-clock-plus`,"alert-circle":`circle-alert`,"alert-octagon":`octagon-alert`,"alert-triangle":`triangle-alert`,"align-center":`text-align-center`,"align-justify":`text-align-justify`,"align-left":`text-align-start`,"align-right":`text-align-end`,angry:`face-angry`,annoyed:`face-expressionless`,"area-chart":`chart-area`,"arrow-down-01":`arrow-down-0-1`,"arrow-down-10":`arrow-down-1-0`,"arrow-down-az":`arrow-down-a-z`,"arrow-down-circle":`circle-arrow-down`,"arrow-down-left-from-circle":`circle-arrow-out-down-left`,"arrow-down-left-from-square":`square-arrow-out-down-left`,"arrow-down-left-square":`square-arrow-down-left`,"arrow-down-right-from-circle":`circle-arrow-out-down-right`,"arrow-down-right-from-square":`square-arrow-out-down-right`,"arrow-down-right-square":`square-arrow-down-right`,"arrow-down-square":`square-arrow-down`,"arrow-down-za":`arrow-down-z-a`,"arrow-left-circle":`circle-arrow-left`,"arrow-left-square":`square-arrow-left`,"arrow-right-circle":`circle-arrow-right`,"arrow-right-square":`square-arrow-right`,"arrow-up-01":`arrow-up-0-1`,"arrow-up-10":`arrow-up-1-0`,"arrow-up-az":`arrow-up-a-z`,"arrow-up-circle":`circle-arrow-up`,"arrow-up-left-from-circle":`circle-arrow-out-up-left`,"arrow-up-left-from-square":`square-arrow-out-up-left`,"arrow-up-left-square":`square-arrow-up-left`,"arrow-up-right-from-circle":`circle-arrow-out-up-right`,"arrow-up-right-from-square":`square-arrow-out-up-right`,"arrow-up-right-square":`square-arrow-up-right`,"arrow-up-square":`square-arrow-up`,"arrow-up-za":`arrow-up-z-a`,"asterisk-square":`square-asterisk`,"axis-3-d":`axis-3d`,"badge-help":`badge-question-mark`,"bar-chart":`chart-no-axes-column-increasing`,"bar-chart-2":`chart-no-axes-column`,"bar-chart-3":`chart-column`,"bar-chart-4":`chart-column-increasing`,"bar-chart-big":`chart-column-big`,"bar-chart-horizontal":`chart-bar`,"bar-chart-horizontal-big":`chart-bar-big`,"between-horizonal-end":`between-horizontal-end`,"between-horizonal-start":`between-horizontal-start`,"book-template":`book-dashed`,"box-select":`square-dashed`,"candlestick-chart":`chart-candlestick`,"check-circle":`circle-check-big`,"check-circle-2":`circle-check`,"check-square":`square-check-big`,"check-square-2":`square-check`,"chevron-down-circle":`circle-chevron-down`,"chevron-down-square":`square-chevron-down`,"chevron-left-circle":`circle-chevron-left`,"chevron-left-square":`square-chevron-left`,"chevron-right-circle":`circle-chevron-right`,"chevron-right-square":`square-chevron-right`,"chevron-up-circle":`circle-chevron-up`,"chevron-up-square":`square-chevron-up`,"circle-help":`circle-question-mark`,"circle-slashed":`circle-slash-2`,"clipboard-edit":`clipboard-pen`,"clipboard-signature":`clipboard-pen-line`,"code-2":`code-xml`,"code-square":`square-code`,columns:`columns-2`,"columns-settings":`columns-3-cog`,"contact-2":`contact-round`,"curly-braces":`braces`,"divide-circle":`circle-divide`,"divide-square":`square-divide`,"dot-square":`square-dot`,"download-cloud":`cloud-download`,edit:`square-pen`,"edit-2":`pen`,"edit-3":`pen-line`,"equal-square":`square-equal`,"file-audio":`file-headphone`,"file-audio-2":`file-headphone`,"file-axis-3-d":`file-axis-3d`,"file-badge-2":`file-badge`,"file-bar-chart":`file-chart-column-increasing`,"file-bar-chart-2":`file-chart-column`,"file-check-2":`file-check-corner`,"file-code-2":`file-code-corner`,"file-cog-2":`file-cog`,"file-edit":`file-pen`,"file-json":`file-braces`,"file-json-2":`file-braces-corner`,"file-key-2":`file-key`,"file-line-chart":`file-chart-line`,"file-lock-2":`file-lock`,"file-minus-2":`file-minus-corner`,"file-pie-chart":`file-chart-pie`,"file-plus-2":`file-plus-corner`,"file-question":`file-question-mark`,"file-search-2":`file-search-corner`,"file-signature":`file-pen-line`,"file-type-2":`file-type-corner`,"file-video":`file-play`,"file-video-2":`file-video-camera`,"file-volume-2":`file-signal`,"file-warning":`file-exclamation-point`,"file-x-2":`file-x-corner`,filter:`funnel`,"filter-x":`funnel-x`,fingerprint:`fingerprint-pattern`,"flip-horizontal":`square-centerline-dashed-horizontal`,"flip-vertical":`square-centerline-dashed-vertical`,"folder-cog-2":`folder-cog`,"folder-edit":`folder-pen`,"fork-knife":`utensils`,"fork-knife-crossed":`utensils-crossed`,"form-input":`rectangle-ellipsis`,frown:`face-slightly-frowning`,"function-square":`square-function`,"gantt-chart":`chart-no-axes-gantt`,"gantt-chart-square":`square-chart-gantt`,"gauge-circle":`circle-gauge`,"git-commit":`git-commit-horizontal`,"globe-2":`earth`,grab:`hand-grab`,grid:`grid-3x3`,"grid-2-x-2":`grid-2x2`,"grid-2-x-2-check":`grid-2x2-check`,"grid-2-x-2-plus":`grid-2x2-plus`,"grid-2-x-2-x":`grid-2x2-x`,"grid-3-x-3":`grid-3x3`,"help-circle":`circle-question-mark`,"helping-hand":`hand-helping`,history:`rotate-ccw-clock`,home:`house`,"ice-cream":`ice-cream-cone`,"ice-cream-2":`ice-cream-bowl`,indent:`list-indent-increase`,"indent-decrease":`list-indent-decrease`,"indent-increase":`list-indent-increase`,inspect:`square-mouse-pointer`,"kanban-square":`square-kanban`,"kanban-square-dashed":`square-dashed-kanban`,"laptop-2":`laptop-minimal`,laugh:`face-grinning`,"layers-3":`layers`,layout:`panels-top-left`,"letter-text":`text-initial`,"library-square":`square-library`,"line-chart":`chart-line`,"loader-2":`loader-circle`,"location-edit":`map-pin-pen`,"m-square":`square-m`,"mail-question":`mail-question-mark`,meh:`face-neutral`,"menu-square":`square-menu`,"message-circle-question":`message-circle-question-mark`,"mic-2":`mic-vocal`,"minus-circle":`circle-minus`,"minus-square":`square-minus`,"more-horizontal":`ellipsis`,"more-vertical":`ellipsis-vertical`,"mouse-pointer-square-dashed":`square-dashed-mouse-pointer`,"move-3-d":`move-3d`,outdent:`list-indent-decrease`,"paintbrush-2":`paintbrush-vertical`,palmtree:`tree-palm`,"panel-bottom-inactive":`panel-bottom-dashed`,"panel-left-inactive":`panel-left-dashed`,"panel-right-inactive":`panel-right-dashed`,"panel-top-inactive":`panel-top-dashed`,"panels-left-right":`columns-3`,"panels-top-bottom":`rows-3`,"parking-circle":`circle-parking`,"parking-circle-off":`circle-parking-off`,"parking-square":`square-parking`,"parking-square-off":`square-parking-off`,"pause-circle":`circle-pause`,"pause-octagon":`octagon-pause`,"pen-box":`square-pen`,"pen-square":`square-pen`,"percent-circle":`circle-percent`,"percent-diamond":`diamond-percent`,"percent-square":`square-percent`,"pi-square":`square-pi`,"pie-chart":`chart-pie`,"pilcrow-square":`square-pilcrow`,"play-circle":`circle-play`,"play-square":`square-play`,"plug-zap-2":`plug-zap`,"plus-circle":`circle-plus`,"plus-square":`square-plus`,podcast:`mic-signal`,"power-circle":`circle-power`,"power-square":`square-power`,"rotate-3-d":`rotate-3d`,rows:`rows-2`,"scale-3-d":`scale-3d`,"scatter-chart":`chart-scatter`,"school-2":`university`,"scissors-square":`square-scissors`,"scissors-square-dashed-bottom":`square-bottom-dashed-scissors`,"send-horizonal":`send-horizontal`,"shield-close":`shield-x`,"shield-question":`shield-question-mark`,sidebar:`panel-left`,"sidebar-close":`panel-left-close`,"sidebar-open":`panel-left-open`,"sigma-square":`square-sigma`,"slash-square":`square-slash`,sliders:`sliders-vertical`,smile:`face-slightly-smiling`,"smile-plus":`face-slightly-smiling-plus`,"sort-asc":`arrow-up-narrow-wide`,"sort-desc":`arrow-down-wide-narrow`,"split-square-horizontal":`square-split-horizontal`,"split-square-vertical":`square-split-vertical`,"square-gantt-chart":`square-chart-gantt`,stars:`sparkles`,"stop-circle":`circle-stop`,subtitles:`captions`,"table-config":`columns-3-cog`,"terminal-square":`square-terminal`,"test-tube-2":`test-tube-diagonal`,text:`text-align-start`,"text-select":`square-dashed-text`,"text-selection":`square-dashed-text`,train:`tram-front`,"tv-2":`tv-minimal`,unlock:`lock-open`,"unlock-keyhole":`lock-keyhole-open`,"upload-cloud":`cloud-upload`,"user-2":`user-round`,"user-check-2":`user-round-check`,"user-circle":`circle-user`,"user-circle-2":`circle-user-round`,"user-cog-2":`user-round-cog`,"user-minus-2":`user-round-minus`,"user-plus-2":`user-round-plus`,"user-square":`square-user`,"user-square-2":`square-user-round`,"user-x-2":`user-round-x`,"users-2":`users-round`,verified:`badge-check`,"wallet-2":`wallet-minimal`,"wand-2":`wand-sparkles`,waves:`waves-horizontal`,"wrap-text":`text-wrap`,"x-circle":`circle-x`,"x-octagon":`octagon-x`,"x-square":`square-x`},En=e(import.meta.url);function J(e){return e.toLowerCase().replace(/[^a-z0-9]/g,``)}var Dn=JSON.parse(n(En.resolve(`lucide-static/icon-nodes.json`),`utf8`)),On=JSON.parse(n(En.resolve(`lucide-static/tags.json`),`utf8`)),Y=new Map;for(let[e,t]of Object.entries(Dn))Y.set(e,{name:e,nodes:t,keywords:On[e]??[]});Y.size;var X=new Map;for(let[e,t]of Object.entries(On))t.forEach((t,n)=>{let r=X.get(t)??[];r.push({name:e,idx:n}),X.set(t,r)});var kn=new ie([...Y.values()],{keys:[{name:`name`,weight:1}],threshold:.45,ignoreLocation:!0,minMatchCharLength:2,includeScore:!0});function An(e,t){let n=0;for(;n<e.length&&n<t.length&&e[n]===t[n];)n++;return n}function jn(e){let t=e.trim().toLowerCase();if(!t)return null;if(Y.has(t))return Y.get(t);let n=Tn[t];if(n){let e=Y.get(n);if(e)return e}let r=J(t),i=kn.search(t,{limit:8}).filter(e=>e.score<=.05||e.score<=.3&&An(r,J(e.item.name))>=3);if(i.length)return i[0].item;let a=X.get(t);if(a?.length){let e=a.slice().sort((e,t)=>e.idx-t.idx||J(e.name).length-J(t.name).length)[0];return Y.get(e.name)??null}let o=kn.search(t,{limit:8}).filter(e=>An(r,J(e.item.name))>=2)[0];return o?o.item:null}function Mn(e,t=20){let n=e.trim();if(!n)return[];let r=new Map;Y.has(n)&&r.set(n,Y.get(n));let i=Tn[n];if(i&&!r.has(i)){let e=Y.get(i);e&&r.set(e.name,e)}for(let{name:e}of X.get(n)??[]){let n=Y.get(e);if(n&&r.set(n.name,n),r.size>=t)break}for(let e of kn.search(n,{limit:t}))r.set(e.item.name,e.item);return[...r.values()].slice(0,t)}function Nn(e,t=24,n=`#000000`,r=2){let i=e.nodes.map(([e,t])=>`<${e} ${Object.entries(t).map(([e,t])=>`${e}="${t}"`).join(` `)}/>`).join(`
2
+ import{createRequire as e}from"node:module";import{appendFileSync as t,readFileSync as n,writeFileSync as r}from"node:fs";import{z as i}from"zod";import{createServer as a}from"node:http";import{WebSocket as o,WebSocketServer as s}from"ws";import{Client as c,StreamableHTTPClientTransport as l}from"@modelcontextprotocol/client";import{McpServer as u,ResourceTemplate as d,SUPPORTED_PROTOCOL_VERSIONS as f,createMcpHandler as p,fromJsonSchema as m}from"@modelcontextprotocol/server";import{serveStdio as ee}from"@modelcontextprotocol/server/stdio";import{spawn as te}from"node:child_process";import{localhostHostValidation as ne,localhostOriginValidation as re,toNodeHandler as ie}from"@modelcontextprotocol/node";import{isTag as h}from"domhandler";import{parseDocument as ae}from"htmlparser2";import oe from"fuse.js";import{tmpdir as se}from"node:os";import{join as g}from"node:path";var _=`0.7.0`,ce=Number(process.env.TEXT_TO_DESIGN_MCP_PORT??47812),v=Number(process.env.TEXT_TO_DESIGN_MCP_HTTP_PORT??47820),le=`text-to-design-mcp-server`,y=_,ue=15e3,de=6e3,fe=5e3,pe=6e4,me=Number(process.env.TEXT_TO_DESIGN_MCP_MAX_INLINE_DATA_URL_BYTES??524288),he=12e4,ge={label:`即时设计`,runtime:`jsDesign`,toolPrefix:`jsd`};function _e(e){let t=/^#([0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/i.exec(e.trim());if(t==null)return null;let n=t[1];(n.length===3||n.length===4)&&(n=[...n].map(e=>e+e).join(``));let r=e=>Number.parseInt(e,16)/255,i={r:r(n.slice(0,2)),g:r(n.slice(2,4)),b:r(n.slice(4,6))};return n.length===8&&(i.a=r(n.slice(6,8))),i}var ve=i.object({r:i.number().min(0).max(1,`颜色通道最大 1(0-255 的色值请先除以 255 归一化)`).describe(`红色通道,范围 0-1(0=无,1=满),如纯红为 1`),g:i.number().min(0).max(1,`颜色通道最大 1(0-255 的色值请先除以 255 归一化)`).describe(`绿色通道,范围 0-1`),b:i.number().min(0).max(1,`颜色通道最大 1(0-255 的色值请先除以 255 归一化)`).describe(`蓝色通道,范围 0-1`),a:i.number().min(0).max(1,`alpha 通道最大 1(0-255 请先归一化)`).optional().describe(`不透明度,范围 0-1(0=全透明,1=不透明),缺省按 1 处理`)}).strict(),ye=`颜色需为 {r,g,b[,a]} 对象(通道 0-1,0-255 色值请先除以 255)或 hex 字符串(#RGB/#RGBA/#RRGGBB/#RRGGBBAA,如 "#ff0000")`,be=i.unknown().superRefine((e,t)=>{if(typeof e==`string`){_e(e)??t.addIssue({code:i.ZodIssueCode.custom,message:`无效 hex 颜色 "${e}"(${ye})`});return}let n=ve.safeParse(e);if(!n.success)for(let e of n.error.issues)t.addIssue({code:i.ZodIssueCode.custom,path:e.path,message:e.message})}),xe=be.describe(`颜色:{r,g,b} 对象(通道 0-1)或 hex 字符串,如 "#ff0000"(带透明度可用 8 位 hex,其 alpha 会转为 paint 级 opacity)`),Se=be.describe(`RGBA 颜色:{r,g,b,a} 对象(通道 0-1,a 缺省按 1)或 hex 字符串,如 "#ff0000"、"#ff000080"`),Ce=i.object({color:Se.describe(`该停止点的颜色(带 alpha)`),position:i.number().min(0).max(1).describe(`停止点位置,范围 0-1(0=起点,1=终点)`)}).describe(`渐变停止点,如 {color:{r:1,g:0,b:0,a:1}, position:0}(起点红色)和 {color:{r:0,g:0,b:1,a:1}, position:1}(终点蓝色)`),we=i.array(i.array(i.number()).length(3)).length(2).describe(`变换矩阵,如 [[1,0,0],[0,1,0]] 表示无变换(Identity)`),b=i.enum([`PASS_THROUGH`,`NORMAL`,`DARKEN`,`MULTIPLY`,`COLOR_BURN`,`LIGHTEN`,`SCREEN`,`COLOR_DODGE`,`OVERLAY`,`SOFT_LIGHT`,`HARD_LIGHT`,`DIFFERENCE`,`EXCLUSION`,`HUE`,`SATURATION`,`COLOR`,`LUMINOSITY`]).describe(`混合模式:PASS_THROUGH=穿透 | NORMAL=正常 | DARKEN=变暗 | MULTIPLY=正片叠底 | COLOR_BURN=颜色加深 | LIGHTEN=变亮 | SCREEN=滤色 | COLOR_DODGE=颜色减淡 | OVERLAY=叠加 | SOFT_LIGHT=柔光 | HARD_LIGHT=强光 | DIFFERENCE=差值 | EXCLUSION=排除 | HUE=色相 | SATURATION=饱和度 | COLOR=颜色 | LUMINOSITY=明度`),x=i.discriminatedUnion(`type`,[i.object({type:i.literal(`SOLID`).describe(`填充类型:纯色`),color:xe.describe(`纯色值,支持 {r,g,b} 对象(通道 0-1)或 hex 字符串,如 "#ff0000"`),opacity:i.number().min(0).max(1).optional().describe(`不透明度 0-1,缺省 1`),visible:i.boolean().optional().describe(`是否可见,缺省 true`),blendMode:b.optional().describe(`混合模式,缺省 NORMAL`)}).strict().describe(`纯色填充(SOLID):{color:{r,g,b}}`),i.object({type:i.literal(`GRADIENT_LINEAR`).describe(`填充类型:线性渐变`),gradientStops:i.array(Ce).describe(`渐变停止点数组(至少 2 个,定义颜色与位置)`),gradientTransform:we}).strict().describe(`线性渐变(GRADIENT_LINEAR):沿直线方向过渡`),i.object({type:i.literal(`GRADIENT_RADIAL`).describe(`填充类型:径向渐变`),gradientStops:i.array(Ce).describe(`渐变停止点数组(至少 2 个,定义颜色与位置)`),gradientTransform:we}).strict().describe(`径向渐变(GRADIENT_RADIAL):从中心向外辐射`),i.object({type:i.literal(`GRADIENT_ANGULAR`).describe(`填充类型:角度渐变`),gradientStops:i.array(Ce).describe(`渐变停止点数组(至少 2 个,定义颜色与位置)`),gradientTransform:we}).strict().describe(`角度渐变(GRADIENT_ANGULAR):沿圆周方向过渡`),i.object({type:i.literal(`IMAGE`).describe(`填充类型:图片填充`),imageHash:i.string().describe(`图片资源哈希(由 jsd_fill_image 等注入)`),scaleMode:i.enum([`FILL`,`FIT`,`CROP`,`TILE`]).optional().describe(`缩放模式:FILL=填充裁剪|FIT=完整适配|CROP=裁剪|TILE=平铺`)}).strict().describe(`图片填充(IMAGE):以 imageHash 引用图片`)]),Te=i.discriminatedUnion(`type`,[i.object({type:i.literal(`DROP_SHADOW`).describe(`效果类型:外阴影(投影到节点外侧)`),color:Se.describe(`阴影颜色(带 alpha 透明度)`),offset:i.object({x:i.number().describe(`水平偏移(px),正值向右`),y:i.number().describe(`垂直偏移(px),正值向下`)}).describe(`阴影偏移向量(px)`),radius:i.number().min(0).describe(`模糊半径(px),>=0`),spread:i.number().optional().describe(`扩散(px),正值扩大阴影、负值收缩,默认 0`),visible:i.boolean().optional().describe(`是否可见,默认 true`),blendMode:b.default(`NORMAL`).describe(`混合模式,默认 NORMAL`),showShadowBehindNode:i.boolean().optional().describe(`是否在节点后方显示阴影(即便节点不透明也透出)`)}).strict().describe(`外阴影(DROP_SHADOW):投影到节点外侧的阴影`),i.object({type:i.literal(`INNER_SHADOW`).describe(`效果类型:内阴影(投影到节点内侧)`),color:Se.describe(`阴影颜色(带 alpha 透明度)`),offset:i.object({x:i.number().describe(`水平偏移(px),正值向右`),y:i.number().describe(`垂直偏移(px),正值向下`)}).describe(`阴影偏移向量(px)`),radius:i.number().min(0).describe(`模糊半径(px),>=0`),spread:i.number().optional().describe(`扩散(px),正值扩大、负值收缩,默认 0`),visible:i.boolean().optional().describe(`是否可见,默认 true`),blendMode:b.default(`NORMAL`).describe(`混合模式,默认 NORMAL`)}).strict().describe(`内阴影(INNER_SHADOW):投影到节点内侧的阴影`),i.object({type:i.literal(`LAYER_BLUR`).describe(`效果类型:图层模糊(模糊整个节点本身)`),radius:i.number().min(0).describe(`模糊半径(px),>=0`),visible:i.boolean().optional().describe(`是否可见,默认 true`)}).strict().describe(`图层模糊(LAYER_BLUR):模糊节点自身`),i.object({type:i.literal(`BACKGROUND_BLUR`).describe(`效果类型:背景模糊(模糊节点背后的内容)`),radius:i.number().min(0).describe(`模糊半径(px),>=0`),visible:i.boolean().optional().describe(`是否可见,默认 true`)}).strict().describe(`背景模糊(BACKGROUND_BLUR):模糊节点背后的内容`)]),S=i.enum([`MIN`,`MAX`,`STRETCH`,`CENTER`,`SCALE`]).describe(`约束类型:MIN=吸附左/上 | MAX=吸附右/下 | STRETCH=拉伸 | CENTER=居中 | SCALE=等比缩放`),Ee=i.object({pattern:i.enum([`ROWS`,`COLUMNS`,`GRID`]).describe(`网格类型:ROWS|COLUMNS|GRID`),alignment:i.enum([`MIN`,`MAX`,`CENTER`,`STRETCH`]).optional().describe(`对齐:MIN|MAX|CENTER|STRETCH`),sectionSize:i.number().optional().describe(`分节尺寸(px)`),count:i.number().int().positive().optional(),gutterSize:i.number().optional().describe(`沟槽尺寸(px)`),offset:i.number().optional().describe(`偏移(px)`),visible:i.boolean().optional(),color:Se.optional()}).superRefine((e,t)=>{e.pattern===`GRID`&&e.sectionSize==null&&t.addIssue({code:i.ZodIssueCode.custom,message:`pattern 为 GRID 时,sectionSize 为必填项`,path:[`sectionSize`]})}),De=i.object({data:i.string().describe(`SVG path data,如 "M0 0 L100 0 L100 100 Z"(M=移动到,L=画线到,Z=闭合)。仅支持 M/L/Q/C/Z 指令(SVG 子集,不支持 A 圆弧等);完整 SVG 请改用 jsd_create_svg`),windingRule:i.enum([`NONZERO`,`EVENODD`,`NONE`]).default(`NONZERO`).describe(`环绕规则:NONZERO|EVENODD|NONE,默认 NONZERO`)}),Oe=i.object({family:i.string().describe(`字体族,如 "PingFang SC"/"Inter"`),style:i.string().describe(`字型,如 "Regular"/"Bold"/"Medium"`)}),ke=i.union([i.object({value:i.number().describe(`行高数值(px)`),unit:i.literal(`PIXELS`).describe(`单位:PIXELS=固定像素`)}).describe(`固定行高:{value: 数值, unit: "PIXELS"},如 {value: 24, unit: "PIXELS"}`),i.object({value:i.number().describe(`行高数值(百分比)`),unit:i.literal(`PERCENT`).describe(`单位:PERCENT=百分比`)}).describe(`百分比行高:{value: 数值, unit: "PERCENT"},如 {value: 150, unit: "PERCENT"}`),i.object({unit:i.literal(`AUTO`).describe(`单位:AUTO=自动行高`)}).describe(`自动行高:{unit: "AUTO"},无需传 value`)]),Ae=i.object({value:i.number(),unit:i.enum([`PIXELS`,`PERCENT`]).describe(`单位:PIXELS=像素 | PERCENT=百分比`)}),je=i.object({id:i.string().optional().describe(`步骤唯一标识,供后续步骤以双花括号占位符(id.字段路径)引用本步结果;缺省自动命名 step1/step2/…`),tool:i.string().describe(`要执行的 jsd_* 工具名,如 jsd_create_rectangle / jsd_find / jsd_set_fill_color`),args:i.record(i.string(),i.unknown()).optional().describe(`该工具的完整入参;任意位置的字符串值里可放双花括号占位符(步骤id.字段路径)引用先前步骤结果`),continueOnError:i.boolean().optional().describe(`本步【执行】失败时是否继续后续步骤;仅对执行失败生效,id 重复/未知工具/引用解析失败一律中止`)}),Me=i.object({calls:i.array(je).min(1).max(50).describe(`按数组顺序执行的步骤列表`),stopOnError:i.boolean().optional().describe(`全局失败策略,默认 true=任一步执行失败即停止,false=配合单步走完全部`),checkDrift:i.boolean().optional().describe(`是否自动复核同层几何漂移,默认 true。批次里含 remove/reparent/group/flatten/repair 时会:变更前记下受影响父层的子节点坐标,收尾再读一次比对,漂移写进结果 warnings(P25-B:引擎会把没碰到的兄弟静默挪走)。代价是每层多一次读数;不需要时传 false`)}),Ne=i.object({ok:i.boolean().describe(`全部步骤均执行且成功(executed 小于 total 即为中途停止)`),executed:i.number().int().min(0).describe(`实际产生结果的步骤数`),total:i.number().int().min(0).describe(`计划的步骤总数`),results:i.array(i.object({id:i.string(),tool:i.string(),ok:i.boolean(),data:i.unknown().optional().describe(`成功时该工具的 structuredContent(已做回显摘要裁剪,见工具描述)`),error:i.string().optional().describe(`失败原因(人读文本)`)})).describe(`各步骤结果,顺序与入参一致;被中止而未执行的步骤不出现在此列表`),echoTrimmed:i.boolean().optional(),warnings:i.array(i.string()).optional()}),Pe=i.object({ok:i.boolean(),data:i.unknown().optional()}),Fe=i.enum([`SLICE`,`FRAME`,`GROUP`,`COMPONENT_SET`,`COMPONENT`,`INSTANCE`,`BOOLEAN_OPERATION`,`VECTOR`,`STAR`,`LINE`,`ELLIPSE`,`POLYGON`,`RECTANGLE`,`TEXT`]).describe(`节点类型:SLICE=切片 | FRAME=容器 | GROUP=分组 | COMPONENT_SET=组件集 | COMPONENT=组件 | INSTANCE=实例 | BOOLEAN_OPERATION=布尔运算 | VECTOR=矢量 | STAR=星形 | LINE=线段 | ELLIPSE=椭圆 | POLYGON=多边形 | RECTANGLE=矩形 | TEXT=文本`),Ie=i.object({type:Fe.describe(`子节点类型`),name:i.string().optional(),x:i.number().optional().describe(`相对父节点的 X(px)`),y:i.number().optional().describe(`相对父节点的 Y(px)`),width:i.number().optional(),height:i.number().optional()}).catchall(i.unknown()),C={name:i.string().optional(),x:i.number().optional().describe(`X 坐标(px,相对父节点,缺省 0;根节点的摆放由 placement 控制)`),y:i.number().optional().describe(`Y 坐标(px,相对父节点,缺省 0;根节点的摆放由 placement 控制)`),width:i.number().optional().describe(`宽度(px)`),height:i.number().optional().describe(`高度(px)`),rotation:i.number().optional().describe(`旋转角度(deg,绕节点自身左上角原点,x/y 不变)`),opacity:i.number().optional().describe(`不透明度 0-1`),visible:i.boolean().optional(),locked:i.boolean().optional(),isMask:i.boolean().optional(),children:i.array(Ie).max(100).optional().describe(`子节点数组(递归嵌套,最多 100 个直接子节点;更大的结构建议分批创建后用 jsd_manage_nodes op=reparent 归组)。子节点可使用的字段与顶层 create 入参一致(fills/strokes/cornerRadius/effects 等均可用);x/y 相对父节点,未传 x/y 会叠放在父节点原点(0,0)——非 auto-layout 容器需为每个子节点指定相对坐标`)},w={fills:i.array(x).optional().describe(`填充列表(Paint 数组)。缺省时的引擎默认:FRAME 为白底;非 FRAME 图形若同时传了 strokes,则填充置空(纯描边,不再被引擎塞 #CCCCCC 灰底)——需要底色请显式传 fills`),strokes:i.array(x).optional().describe(`描边列表(Paint 数组)`),strokeWeight:i.number().optional().describe(`描边宽度(px)`),strokeTopWeight:i.number().optional().describe(`描边顶部宽(px)`),strokeBottomWeight:i.number().optional().describe(`描边底部宽(px)`),strokeLeftWeight:i.number().optional().describe(`描边左侧宽(px)`),strokeRightWeight:i.number().optional().describe(`描边右侧宽(px)`),strokeAlign:i.enum([`CENTER`,`INSIDE`,`OUTSIDE`]).optional().describe(`描边对齐:CENTER|INSIDE|OUTSIDE`),strokeCap:i.enum([`NONE`,`ROUND`,`SQUARE`,`ARROW_LINES`,`ARROW_EQUILATERAL`]).optional().describe(`描边端点:NONE|ROUND|SQUARE|ARROW_LINES|ARROW_EQUILATERAL`),strokeJoin:i.enum([`MITER`,`BEVEL`,`ROUND`]).optional().describe(`描边连接:MITER|BEVEL|ROUND`),dashPattern:i.array(i.number()).optional().describe(`虚线段数组,如 [4,4]`),blendMode:b.optional(),effects:i.array(Te).optional().describe(`效果列表(阴影/模糊,可多层叠加)`),constraints:i.object({horizontal:S.describe(`水平约束:MIN|MAX|STRETCH|CENTER|SCALE`),vertical:S.describe(`垂直约束:MIN|MAX|STRETCH|CENTER|SCALE`)}).optional().describe(`自动布局中的约束`),clipsContent:i.boolean().optional().describe(`是否裁剪溢出内容`),cornerSmoothing:i.number().optional().describe(`圆角平滑度 0-1`),layoutGrids:i.array(Ee).optional().describe(`布局网格(参考线)`)},Le={cornerRadius:i.number().optional().describe(`圆角半径(px),四角统一`),topLeftRadius:i.number().optional().describe(`左上圆角(px)`),topRightRadius:i.number().optional().describe(`右上圆角(px)`),bottomLeftRadius:i.number().optional().describe(`左下圆角(px)`),bottomRightRadius:i.number().optional().describe(`右下圆角(px)`)},Re=i.object({type:i.literal(`FRAME`),...C,layoutMode:i.enum([`NONE`,`HORIZONTAL`,`VERTICAL`]).optional().describe(`自动布局方向:NONE=无布局,HORIZONTAL=水平排列,VERTICAL=垂直排列。传 itemSpacing/padding*/primaryAxis* 等布局属性前必须先设为 HORIZONTAL 或 VERTICAL`),itemSpacing:i.number().optional().describe(`自动布局项间距(px),需先设 layoutMode;primaryAxisAlignItems=SPACE_BETWEEN 时该项被忽略(子项均匀分布)`),paddingTop:i.number().optional().describe(`上内边距(px)`),paddingRight:i.number().optional().describe(`右内边距(px)`),paddingBottom:i.number().optional().describe(`下内边距(px)`),paddingLeft:i.number().optional().describe(`左内边距(px)`),primaryAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional().describe(`主轴尺寸模式:FIXED|AUTO`),counterAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional().describe(`交叉轴尺寸模式:FIXED|AUTO`),primaryAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`,`SPACE_BETWEEN`]).optional().describe(`主轴对齐:MIN|MAX|CENTER|SPACE_BETWEEN;设为 SPACE_BETWEEN 时 itemSpacing 被忽略(子项均匀分布)`),counterAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`]).optional().describe(`交叉轴对齐:MIN|MAX|CENTER`),layoutGrow:i.number().optional().describe(`自动布局内伸缩系数`),layoutAlign:i.enum([`MIN`,`CENTER`,`MAX`,`STRETCH`,`INHERIT`]).optional().describe(`自动布局内对齐:MIN|CENTER|MAX|STRETCH|INHERIT`),...Le,...w}).strict().superRefine((e,t)=>{(e.itemSpacing!=null||e.paddingTop!=null||e.paddingRight!=null||e.paddingBottom!=null||e.paddingLeft!=null||e.primaryAxisSizingMode!=null||e.counterAxisSizingMode!=null||e.primaryAxisAlignItems!=null||e.counterAxisAlignItems!=null)&&(e.layoutMode==null||e.layoutMode===`NONE`)&&t.addIssue({code:i.ZodIssueCode.custom,message:`传 itemSpacing/padding*/primaryAxis*/counterAxis* 等布局属性前,layoutMode 必须设为 HORIZONTAL 或 VERTICAL`,path:[`layoutMode`]})}).strict().describe(`FRAME=容器(可 auto-layout)。注意:未显式传 fills 时引擎默认白底,透明容器请显式传 fills:[{type:"SOLID",color:{r:0,g:0,b:0},opacity:0}]`),ze=i.object({type:i.literal(`RECTANGLE`),...C,...Le,...w}).strict().describe(`RECTANGLE=矩形`),Be=i.object({type:i.literal(`ELLIPSE`),...C,cornerRadius:i.number().optional().describe(`圆角半径(px)`),arcData:i.object({startingAngle:i.number().describe(`起始角度(radians)`),endingAngle:i.number().describe(`结束角度(radians)`),innerRadius:i.number().describe(`内半径(0-1 ratio)`)}).optional().describe(`环形路径参数(弧线),可画圆环`),...w}).strict().describe(`ELLIPSE=椭圆(配合 arcData 可画环)`),Ve=i.object({type:i.literal(`LINE`),...C,...w}).strict().describe(`LINE=线段`),He=i.object({type:i.literal(`POLYGON`),...C,pointCount:i.number().describe(`多边形角点数,如 6=六边形`),cornerRadius:i.number().optional().describe(`圆角半径(px)`),topLeftRadius:i.number().optional().describe(`左上圆角(px)`),topRightRadius:i.number().optional().describe(`右上圆角(px)`),bottomLeftRadius:i.number().optional().describe(`左下圆角(px)`),bottomRightRadius:i.number().optional().describe(`右下圆角(px)`),...w}).strict().describe(`POLYGON=多边形(配合 pointCount)`),Ue=i.object({type:i.literal(`STAR`),...C,pointCount:i.number().describe(`星形角点数,如 5=五角星`),innerRadius:i.number().describe(`星形内半径比例(0-1,相对外半径),值越小角越尖锐`),cornerRadius:i.number().optional().describe(`圆角半径(px)`),topLeftRadius:i.number().optional().describe(`左上圆角(px)`),topRightRadius:i.number().optional().describe(`右上圆角(px)`),bottomLeftRadius:i.number().optional().describe(`左下圆角(px)`),bottomRightRadius:i.number().optional().describe(`右下圆角(px)`),...w}).strict().describe(`STAR=星形(配合 pointCount + innerRadius)`),We=i.object({type:i.literal(`VECTOR`),...C,vectorPaths:i.array(De).describe(`矢量路径数组,每项含 SVG path data(如 "M0 0 L100 100")`),...w}).strict().describe(`VECTOR=矢量(配合 vectorPaths 传 SVG path data)。注意:当前平台创建后 vectorPaths 偶发丢失/形变,短直线段建议改用 LINE+rotation 更稳定`),Ge=i.object({type:i.literal(`TEXT`),...C,characters:i.string().describe(`文本内容,如 "Hello World"。注意:个别 emoji 依赖客户端字体可能缺字(渲染为 ☒),上线前逐个目检`),fontSize:i.number().optional().describe(`字号(px),默认 16`),fontName:Oe.optional().describe(`字体:{family,style},如 {family:"PingFang SC",style:"Regular"};需精确匹配,建议先用 jsd_list_fonts 查可用字体(不可用时静默回退默认字体)`),textAlignHorizontal:i.enum([`LEFT`,`CENTER`,`RIGHT`,`JUSTIFIED`]).optional().describe(`水平对齐:LEFT|CENTER|RIGHT|JUSTIFIED`),textAlignVertical:i.enum([`TOP`,`CENTER`,`BOTTOM`]).optional().describe(`垂直对齐:TOP|CENTER|BOTTOM`),textAutoResize:i.enum([`NONE`,`WIDTH_AND_HEIGHT`,`HEIGHT`,`TRUNCATE`]).optional().describe(`文本自适应:NONE=固定尺寸|WIDTH_AND_HEIGHT=按内容撑开(缺省,此时显式 width/height 会被覆盖)|HEIGHT=固定宽自适应高|TRUNCATE=截断。要固定文本框尺寸必须设为 NONE`),textCase:i.enum([`ORIGINAL`,`UPPER`,`LOWER`,`TITLE`]).optional().describe(`文本大小写:ORIGINAL|UPPER|LOWER|TITLE`),textDecoration:i.enum([`NONE`,`UNDERLINE`,`STRIKETHROUGH`]).optional().describe(`文本装饰:NONE|UNDERLINE|STRIKETHROUGH`),lineHeight:ke.optional().describe(`行高:{value,unit},unit 为 PIXELS|PERCENT;或 {unit:"AUTO"}`),letterSpacing:Ae.optional().describe(`字距:{value,unit},unit 为 PIXELS|PERCENT`),...w}).strict().describe(`TEXT=文本(配合 characters/fontSize/fontName 等)`),Ke=i.object({type:i.literal(`GROUP`),...C,children:i.array(Ie).min(2).max(100).describe(`子节点数组,至少 2 个;递归嵌套,最多 100 个直接子节点`),layoutMode:i.enum([`NONE`,`HORIZONTAL`,`VERTICAL`]).optional().describe(`自动布局方向:NONE=纯归组,HORIZONTAL=水平,VERTICAL=垂直。传 itemSpacing/padding* 等布局属性前必须先设为 HORIZONTAL 或 VERTICAL`),itemSpacing:i.number().optional().describe(`项间距(px),需先设 layoutMode;primaryAxisAlignItems=SPACE_BETWEEN 时该项被忽略(子项均匀分布)`),paddingTop:i.number().optional().describe(`上内边距(px)`),paddingRight:i.number().optional().describe(`右内边距(px)`),paddingBottom:i.number().optional().describe(`下内边距(px)`),paddingLeft:i.number().optional().describe(`左内边距(px)`),primaryAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional().describe(`主轴尺寸模式:FIXED|AUTO`),counterAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional().describe(`交叉轴尺寸模式:FIXED|AUTO`),primaryAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`,`SPACE_BETWEEN`]).optional().describe(`主轴对齐:MIN|MAX|CENTER|SPACE_BETWEEN;设为 SPACE_BETWEEN 时 itemSpacing 被忽略(子项均匀分布)`),counterAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`]).optional().describe(`交叉轴对齐`),...w}).strict().superRefine((e,t)=>{(e.itemSpacing!=null||e.paddingTop!=null||e.paddingRight!=null||e.paddingBottom!=null||e.paddingLeft!=null||e.primaryAxisSizingMode!=null||e.counterAxisSizingMode!=null||e.primaryAxisAlignItems!=null||e.counterAxisAlignItems!=null)&&(e.layoutMode==null||e.layoutMode===`NONE`)&&t.addIssue({code:i.ZodIssueCode.custom,message:`传 itemSpacing/padding*/primaryAxis*/counterAxis* 等布局属性前,layoutMode 必须设为 HORIZONTAL 或 VERTICAL`,path:[`layoutMode`]})}).describe(`GROUP=分组(内部用 Frame 实现)`),qe=i.object({type:i.literal(`BOOLEAN_OPERATION`),...C,booleanOperation:i.enum([`UNION`,`SUBTRACT`,`INTERSECT`,`EXCLUDE`]).describe(`布尔运算:UNION=合并,SUBTRACT=减去,INTERSECT=相交,EXCLUDE=排除`),children:i.array(Ie).min(2).describe(`要合并的子节点数组(至少 2 个)`),...w}).strict().describe(`BOOLEAN_OPERATION=布尔运算(合并子节点)`),Je=i.discriminatedUnion(`type`,[Re,ze,Be,Ve,He,Ue,We,Ge,Ke,qe]),Ye=i.object({mode:i.enum([`center`,`manual`,`absolute`]).optional().describe(`放置模式:center=把每个根节点各自移到视口中心(缺省;会忽略 ops 内根节点自身的 x/y,多个根节点会互相叠放)|manual=保留 ops 内根节点自身的 x/y(按坐标布局用这个)|absolute=把所有根节点统一放到下方 x/y(必填,多根会叠在同一坐标)。建议一次调用只建一个根节点,层级结构用 children 表达`),x:i.number().optional().describe(`absolute 模式下所有根节点的 X 坐标,与 mode="absolute" 配合使用`),y:i.number().optional().describe(`absolute 模式下所有根节点的 Y 坐标,与 mode="absolute" 配合使用`)}).superRefine((e,t)=>{e.mode===`absolute`&&(e.x==null||e.y==null)&&t.addIssue({code:i.ZodIssueCode.custom,message:`placement.mode 为 absolute 时,x 和 y 均为必填项`,path:e.x==null?[`x`]:[`y`]})});i.object({ops:i.array(Je).describe(`设计指令节点树;建议单一根节点(多个根节点会被 placement 统一摆放,可能互相叠放)`),placement:Ye.optional().describe(`放置方式,缺省 center 居中且忽略 ops 内根节点的 x/y。需要按坐标摆放时传 mode:"manual"(保留 ops 内 x/y)或 "absolute"(顶层统一坐标)`)}).strict();var Xe=i.object({svg:i.string().describe(`完整 SVG 字符串,如 <svg xmlns="http://www.w3.org/2000/svg" width="100" height="100"><path d="M0 0 L100 0 L100 100 Z" fill="#ff0000"/></svg>`),name:i.string().optional().describe(`生成的图层名,默认 svg-design`)}),Ze=i.object({html:i.string().describe(`HTML 片段,支持内联 style`),name:i.string().optional().describe(`生成的图层名,默认 html-design`)}),Qe=i.object({icon:i.string().describe(`图标名/别名/语义描述,如 home、arrow-right、search、magnifier(搜索);支持模糊匹配与别名联想,查无返回候选提示`),size:i.number().optional().describe(`图标边长 px,默认 24`),color:i.string().optional().describe(`描边颜色(十六进制),默认 #000000`),strokeWidth:i.number().optional().describe(`描边宽度,默认 2`),name:i.string().optional().describe(`生成的图层名,默认 icon-<图标名>`)});i.object({}),i.object({depth:i.number().optional().describe(`序列化深度:0=仅自身,1=含直接子节点,2=含孙节点;缺省 2`)});var $e=i.object({ids:i.array(i.string()).optional().describe(`按节点 id 精确查找,优先级最高`),name:i.string().optional().describe(`按名称模糊匹配(包含)`),type:i.string().optional().describe(`节点类型过滤,支持:SLICE/FRAME/GROUP/COMPONENT_SET/COMPONENT/INSTANCE/BOOLEAN_OPERATION/VECTOR/STAR/LINE/ELLIPSE/POLYGON/RECTANGLE/TEXT`),recursive:i.boolean().optional().describe(`是否递归查找(默认 true)`),depth:i.number().optional().describe(`序列化深度:0=仅自身,1=含直接子节点;缺省 1`)}),et=[`create_component`,`create_instance`,`detach_instance`,`import_component`,`swap_component`,`set_instance_properties`,`combine_as_variants`,`copy_overrides`,`apply_overrides`,`sync_overrides`],tt=i.object({op:i.enum([`select`,`remove`,`clone`,`group`,`ungroup`,`flatten`,`outline_stroke`,`reparent`,`repair`],{error:e=>{let t=e.input,n=typeof t==`string`?t:``;return et.includes(n)?`"${n}" 是组件/实例操作,应使用 jsd_manage_components;本工具仅支持:select|remove|clone|group|ungroup|flatten|outline_stroke|reparent|repair`:`无效 op${n===``?`(缺省)`:` "${n}"`},本工具支持:select|remove|clone|group|ungroup|flatten|outline_stroke|reparent|repair(组件/实例操作在 jsd_manage_components)`}}).describe(`节点结构操作类型:select 设当前选中 | remove 删除(matchName 可再过滤) | clone 复制(右下偏移) | group 编组(可带 layoutMode/itemSpacing/padding* 参数) | ungroup 解组 | flatten 合并为矢量(至少 2 节点) | outline_stroke 描边转轮廓 | reparent 移到 parentId 下(缺省当前选中第一个) | repair 清理已损坏节点`),ids:i.array(i.string()).optional().describe(`节点 id 列表;除 remove/repair 外全部 op 必填(remove 缺省用当前选中)`),matchName:i.string().optional().describe(`仅 remove:在 ids(或当前选中)范围内,仅删除 name 精确匹配的节点`),name:i.string().optional().describe(`仅 group:组名`),layoutMode:i.enum([`NONE`,`HORIZONTAL`,`VERTICAL`]).optional().describe(`仅 group。自动布局方向:NONE=纯归组,子节点仅叠加,HORIZONTAL=水平排列,VERTICAL=垂直排列`),itemSpacing:i.number().optional().describe(`仅 group。自动布局项间距(px);primaryAxisAlignItems=SPACE_BETWEEN 时该项被忽略(子项均匀分布)`),paddingTop:i.number().optional().describe(`仅 group。上内边距(px)`),paddingRight:i.number().optional().describe(`仅 group。右内边距(px)`),paddingBottom:i.number().optional().describe(`仅 group。下内边距(px)`),paddingLeft:i.number().optional().describe(`仅 group。左内边距(px)`),primaryAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional().describe(`仅 group。主轴尺寸模式:FIXED|AUTO`),counterAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional().describe(`仅 group。交叉轴尺寸模式:FIXED|AUTO`),primaryAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`,`SPACE_BETWEEN`]).optional().describe(`仅 group。主轴对齐:MIN|MAX|CENTER|SPACE_BETWEEN;设为 SPACE_BETWEEN 时 itemSpacing 被忽略(子项均匀分布)`),counterAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`]).optional().describe(`仅 group。交叉轴对齐:MIN|MAX|CENTER`),parentId:i.string().optional().describe(`仅 reparent:目标父节点 id,缺省用当前选中第一个节点。跨父级移动保持节点绝对位置(内部自动换算成新父下的 x/y),无需手动修正;移入 auto-layout 容器时位置由布局接管`),index:i.number().optional().describe(`仅 reparent:插入位置 = children 下标(0 = 最底层,末位 = 最上层,即序列化里的 z);缺省追加到末尾(最上层)。节点已在该父级下时用它调层序;auto-layout 容器同样支持`)}).superRefine((e,t)=>{let n=n=>{t.addIssue({code:`custom`,path:[n],message:`op=${e.op} 缺少必填字段 ${n}`})},r=Array.isArray(e.ids)&&e.ids.length>0&&e.ids.every(e=>typeof e==`string`);switch(e.op){case`select`:case`clone`:case`group`:case`ungroup`:case`flatten`:case`outline_stroke`:case`reparent`:r||n(`ids`)}e.op===`flatten`&&r&&Array.isArray(e.ids)&&e.ids.length<2&&t.addIssue({code:`custom`,path:[`ids`],message:`op=flatten 至少需要 2 个节点 id`})}),nt=i.object({op:i.enum([`create_component`,`create_instance`,`detach_instance`,`import_component`,`swap_component`,`set_instance_properties`,`combine_as_variants`,`copy_overrides`,`apply_overrides`,`sync_overrides`]).describe(`组件操作类型;注意 combine_as_variants/detach_instance 在当前即时设计引擎有内部崩溃,已内置多姿势/副本兜底,仍失败时详见 jsd_manage_components 工具描述`),ids:i.array(i.string()).optional().describe(`节点 id 列表;除 import_component 外全部 op 必填(create_component 为要固化的节点,其余为实例/组件节点)`),name:i.string().optional().describe(`名称;create_component/import_component/combine_as_variants 可选`),key:i.string().optional().describe(`团队库组件唯一标识 Key(仅 import_component 必填)`),componentId:i.string().optional().describe(`目标组件(COMPONENT)节点 id(仅 swap_component 必填)`),properties:i.record(i.string(),i.string()).optional().describe(`变体属性名→值,如 {"状态":"禁用"}(仅 set_instance_properties 必填);可调属性需从 jsd_find/jsd_get_selection 返回的 variantGroupProperties 获取,属性名必须完全匹配`),sourceId:i.string().optional().describe(`源实例(INSTANCE)节点 id;copy_overrides/apply_overrides/sync_overrides 必填`),swapToSource:i.boolean().optional().describe(`套用时是否把目标实例 swap 成源组件,默认 false(swap 会丢失目标既有覆盖,需显式开启)`)}).superRefine((e,t)=>{let n=n=>{t.addIssue({code:`custom`,path:[n],message:`op=${e.op} 缺少必填字段 ${n}`})},r=Array.isArray(e.ids)&&e.ids.length>0&&e.ids.every(e=>typeof e==`string`);switch(e.op){case`create_component`:case`create_instance`:case`detach_instance`:case`swap_component`:case`set_instance_properties`:case`combine_as_variants`:r||n(`ids`);break;case`import_component`:(typeof e.key!=`string`||e.key.length===0)&&n(`key`);break;case`copy_overrides`:(typeof e.sourceId!=`string`||e.sourceId.length===0)&&n(`sourceId`);break;case`apply_overrides`:r||n(`ids`),(typeof e.sourceId!=`string`||e.sourceId.length===0)&&n(`sourceId`);break;case`sync_overrides`:r||n(`ids`),(typeof e.sourceId!=`string`||e.sourceId.length===0)&&n(`sourceId`)}e.op===`swap_component`&&typeof e.componentId!=`string`&&n(`componentId`),e.op===`set_instance_properties`&&(e.properties==null||typeof e.properties!=`object`)&&n(`properties`)}),rt=i.object({ids:i.array(i.string()).min(1).describe(`必填。要导出的节点 id 列表(数组);只导一个节点也要写成数组,如 ["123:456"]。字段名是 ids,不是 nodeId。`),format:i.enum([`PNG`,`JPG`,`SVG`,`PDF`]).optional().describe(`导出格式,默认 PNG`),scale:i.number().optional().describe(`缩放倍率(PNG/JPG),默认 1`),savePath:i.string().optional().describe(`落盘文件绝对路径,如 /tmp/icon.png`),includeDataUrl:i.boolean().optional().describe(`是否同时返回 base64 dataURL,默认 false`)});i.object({}),i.object({}),i.object({});var it=i.object({ids:i.array(i.string()).describe(`要填充图片的节点 id 列表`),sourcePath:i.string().describe(`本地图片文件绝对路径,如 /tmp/poster.png`)}),at=i.object({op:i.string().describe(`平台特有操作名(如 figma_variables_create)。先 jsd_ping 看 capabilities 与平台支持列表`),params:i.record(i.string(),i.unknown()).optional().describe(`操作参数,结构随 op 而定`)}),ot=i.enum([`jsdesign`,`figma`]),st=i.enum([`styles`,`textTruncation`,`componentProperties`,`variables`,`getMainComponentAsync`,`platformOps`]),ct=i.enum([`create`,`modify`,`structure`,`component`,`export`,`image`]),lt=i.object({type:i.enum([`BOOLEAN`,`VARIANT`,`TEXT`,`INSTANCE_SWAP`]),value:i.union([i.boolean(),i.string()]),preferredValues:i.array(i.object({type:i.enum([`COMPONENT`,`COMPONENT_SET`]),key:i.string()})).optional()}),T=i.lazy(()=>i.object({id:i.string(),name:i.string(),type:Fe,x:i.number(),y:i.number(),width:i.number().optional(),height:i.number().optional(),rotation:i.number().optional(),opacity:i.number().optional(),visible:i.boolean().optional(),locked:i.boolean().optional(),parentId:i.string().optional(),z:i.number().optional().describe(`在父级 children 里的下标 = 绘制顺序,0 = 最底层、数值越大越靠上;判断遮挡读它,不用记数组方向`),fills:i.array(x).optional(),strokes:i.array(x).optional(),strokeWeight:i.number().optional(),strokeTopWeight:i.number().optional(),strokeBottomWeight:i.number().optional(),strokeLeftWeight:i.number().optional(),strokeRightWeight:i.number().optional(),strokeAlign:i.enum([`CENTER`,`INSIDE`,`OUTSIDE`]).optional(),strokeCap:i.enum([`NONE`,`ROUND`,`SQUARE`,`ARROW_LINES`,`ARROW_EQUILATERAL`]).optional(),strokeJoin:i.enum([`MITER`,`BEVEL`,`ROUND`]).optional(),dashPattern:i.array(i.number()).optional(),cornerSmoothing:i.number().optional(),blendMode:b.optional(),constraints:i.object({horizontal:S,vertical:S}).optional(),layoutGrids:i.array(Ee).optional(),clipsContent:i.boolean().optional(),arcData:i.object({startingAngle:i.number(),endingAngle:i.number(),innerRadius:i.number()}).optional(),effects:i.array(Te).optional(),cornerRadius:i.number().optional(),topLeftRadius:i.number().optional(),topRightRadius:i.number().optional(),bottomLeftRadius:i.number().optional(),bottomRightRadius:i.number().optional(),pointCount:i.number().optional(),innerRadius:i.number().optional(),layoutMode:i.enum([`NONE`,`HORIZONTAL`,`VERTICAL`]).optional(),itemSpacing:i.number().optional(),paddingTop:i.number().optional(),paddingRight:i.number().optional(),paddingBottom:i.number().optional(),paddingLeft:i.number().optional(),primaryAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional(),counterAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional(),primaryAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`,`SPACE_BETWEEN`]).optional(),counterAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`]).optional(),layoutGrow:i.number().optional(),layoutAlign:i.enum([`MIN`,`CENTER`,`MAX`,`STRETCH`,`INHERIT`]).optional(),childCount:i.number().optional(),children:i.array(T).optional(),characters:i.string().optional(),fontSize:i.number().optional(),fontName:Oe.optional(),textAlignHorizontal:i.enum([`LEFT`,`CENTER`,`RIGHT`,`JUSTIFIED`]).optional(),textAlignVertical:i.enum([`TOP`,`CENTER`,`BOTTOM`]).optional(),textAutoResize:i.enum([`NONE`,`WIDTH_AND_HEIGHT`,`HEIGHT`,`TRUNCATE`]).optional(),textCase:i.enum([`ORIGINAL`,`UPPER`,`LOWER`,`TITLE`]).optional(),textDecoration:i.enum([`NONE`,`UNDERLINE`,`STRIKETHROUGH`]).optional(),lineHeight:ke.optional(),letterSpacing:Ae.optional(),vectorPaths:i.array(De).optional(),booleanOperation:i.enum([`UNION`,`SUBTRACT`,`INTERSECT`,`EXCLUDE`]).optional(),isMask:i.boolean().optional(),variantProperties:i.record(i.string(),i.string()).optional(),mainComponentId:i.string().optional(),variantGroupProperties:i.record(i.string(),i.array(i.string())).optional(),textTruncation:i.enum([`DISABLED`,`ENDING`]).optional(),maxLines:i.number().optional(),fillStyleId:i.string().optional(),strokeStyleId:i.string().optional(),textStyleId:i.string().optional(),effectStyleId:i.string().optional(),componentProperties:i.record(i.string(),lt).optional()})),E=i.object({created:i.union([T,i.array(T)])}),ut=i.object({updated:i.array(T),warnings:i.array(i.string()).optional()}),dt=i.object({connected:i.boolean(),platform:ot.optional(),capabilities:i.array(st).optional().describe(`当前平台支持的能力列表(先查此字段再决定能否调用平台特有操作)`),coreCapabilities:i.array(ct).optional().describe(`所有平台都具备的核心能力(create/modify/structure/component/export/image),不随平台变化`),error:i.string().optional()}),ft=i.object({selection:i.array(T),pageName:i.string()}),pt=i.object({nodes:i.array(T),total:i.number()}),mt=i.object({selected:i.array(i.string()).optional(),removed:i.array(i.string()).optional(),ungrouped:i.array(i.string()).optional(),moved:i.array(T).optional(),updated:i.array(T).optional(),cleaned:i.array(i.string()).optional(),created:i.union([T,i.array(T)]).optional()}),ht=i.object({variantProperties:i.record(i.string(),i.string()).optional(),componentProperties:i.record(i.string(),lt).optional(),propsSummary:i.array(i.string()).optional()}),gt=i.object({instanceId:i.string(),instanceName:i.string(),ok:i.boolean(),message:i.string().optional()}),_t=i.object({created:i.union([T,i.array(T)]).optional(),swapped:i.array(T).optional(),updated:i.array(T).optional(),snapshotId:i.string().optional(),sourceName:i.string().optional(),captured:ht.optional(),applied:i.array(gt).optional(),source:ht.optional(),failed:i.array(i.object({id:i.string(),message:i.string()})).optional()}),vt=i.object({exports:i.array(i.object({id:i.string(),name:i.string(),format:i.enum([`PNG`,`JPG`,`SVG`,`PDF`]),mimeType:i.string(),size:i.number(),path:i.string().optional(),dataUrl:i.string().optional()}))}),yt=i.object({families:i.array(i.string()),count:i.number()});i.object({pageName:i.string(),nodes:i.array(i.object({id:i.string(),name:i.string(),type:Fe,x:i.number(),y:i.number(),z:i.number().optional(),width:i.number().optional(),height:i.number().optional(),childCount:i.number().optional()})),count:i.number()}),i.object({styles:i.array(i.object({id:i.string(),name:i.string(),type:i.enum([`PAINT`,`TEXT`,`EFFECT`,`GRID`])})),count:i.number()});var D=i.object({x:i.number().optional().describe(`X 坐标(px,相对父节点;auto-layout 子节点的位置由父容器接管,修改可能被布局覆盖)`),y:i.number().optional().describe(`Y 坐标(px,相对父节点;auto-layout 子节点的位置由父容器接管,修改可能被布局覆盖)`),width:i.number().optional().describe(`宽度(px)`),height:i.number().optional().describe(`高度(px)`),rotation:i.number().optional().describe(`旋转角度(deg,绕节点自身左上角原点,x/y 不变)`),opacity:i.number().optional().describe(`不透明度 0-1`),visible:i.boolean().optional(),locked:i.boolean().optional()}),bt=i.object({width:i.number().min(0).optional().describe(`宽度(px)。横线(高度为 0 的 LINE)传 0;其他类型最低 0.01(引擎 resize 校验),低于会明确报错`),height:i.number().min(0).optional().describe(`高度(px)。竖线(宽度为 0 的 LINE)传 0;其他类型最低 0.01(引擎 resize 校验),低于会明确报错`)}),xt=i.object({pointCount:i.number().optional().describe(`多边形/星形角点数(仅 POLYGON/STAR 生效)`),innerRadius:i.number().optional().describe(`星形内半径比例(0-1,相对外半径;仅 STAR 生效)`)}),St=i.object({strokes:i.array(x).optional().describe(`描边列表(Paint 数组;整体替换,非合并,需保留的描边要一并传入)`),strokeWeight:i.number().optional().describe(`描边宽度(px)`),strokeTopWeight:i.number().optional().describe(`描边顶部宽(px)`),strokeBottomWeight:i.number().optional().describe(`描边底部宽(px)`),strokeLeftWeight:i.number().optional().describe(`描边左侧宽(px)`),strokeRightWeight:i.number().optional().describe(`描边右侧宽(px)`),strokeAlign:i.enum([`CENTER`,`INSIDE`,`OUTSIDE`]).optional().describe(`描边对齐:CENTER|INSIDE|OUTSIDE`),strokeCap:i.enum([`NONE`,`ROUND`,`SQUARE`,`ARROW_LINES`,`ARROW_EQUILATERAL`]).optional().describe(`描边端点:NONE|ROUND|SQUARE|ARROW_LINES|ARROW_EQUILATERAL`),strokeJoin:i.enum([`MITER`,`BEVEL`,`ROUND`]).optional().describe(`描边连接:MITER|BEVEL|ROUND`),dashPattern:i.array(i.number()).optional().describe(`虚线段数组,如 [4,4]`),strokeStyleId:i.string().optional().describe(`描边样式 id(团队库样式;平台无此能力时被忽略)`)}),O=i.object({cornerRadius:i.number().optional().describe(`圆角半径(px),四角统一;仅 FRAME/RECTANGLE/ELLIPSE/POLYGON/STAR/VECTOR/BOOLEAN_OPERATION 生效(LINE/TEXT 无圆角)`),topLeftRadius:i.number().optional().describe(`左上圆角(px),适用类型同 cornerRadius`),topRightRadius:i.number().optional().describe(`右上圆角(px),适用类型同 cornerRadius`),bottomLeftRadius:i.number().optional().describe(`左下圆角(px),适用类型同 cornerRadius`),bottomRightRadius:i.number().optional().describe(`右下圆角(px),适用类型同 cornerRadius`)}),Ct=i.object({characters:i.string().optional().describe(`文本内容(仅 TEXT 节点生效)`),fontSize:i.number().optional().describe(`字号(px)`),fontName:Oe.optional().describe(`字体:{family,style};需精确匹配,建议先用 jsd_list_fonts 查可用字体(不可用时静默回退默认字体)`),textAlignHorizontal:i.enum([`LEFT`,`CENTER`,`RIGHT`,`JUSTIFIED`]).optional().describe(`水平对齐:LEFT|CENTER|RIGHT|JUSTIFIED`),textAlignVertical:i.enum([`TOP`,`CENTER`,`BOTTOM`]).optional().describe(`垂直对齐:TOP|CENTER|BOTTOM`),textAutoResize:i.enum([`NONE`,`WIDTH_AND_HEIGHT`,`HEIGHT`,`TRUNCATE`]).optional().describe(`文本自适应:NONE=固定尺寸|WIDTH_AND_HEIGHT=按内容撑开(缺省,此时修改 width/height 会被覆盖)|HEIGHT=固定宽自适应高|TRUNCATE=截断。要固定文本框尺寸必须设为 NONE`),textCase:i.enum([`ORIGINAL`,`UPPER`,`LOWER`,`TITLE`]).optional().describe(`文本大小写:ORIGINAL|UPPER|LOWER|TITLE`),textDecoration:i.enum([`NONE`,`UNDERLINE`,`STRIKETHROUGH`]).optional().describe(`文本装饰:NONE|UNDERLINE|STRIKETHROUGH`),lineHeight:ke.optional().describe(`行高:{value,unit}`),letterSpacing:Ae.optional().describe(`字距:{value,unit}`),textStyleId:i.string().optional().describe(`文本样式 id(团队库样式;平台无此能力时被忽略)`),textTruncation:i.enum([`DISABLED`,`ENDING`]).optional().describe(`文本截断(DISABLED=不截断,ENDING=末尾省略号截断),仅 Figma 生效`),maxLines:i.number().optional().describe(`文本最大行数,仅 Figma 生效`)}),wt=i.object({layoutMode:i.enum([`NONE`,`HORIZONTAL`,`VERTICAL`]).optional().describe(`自动布局方向:NONE|HORIZONTAL|VERTICAL,仅 FRAME 节点生效。传 itemSpacing/padding*/primaryAxis* 等布局属性前必须先设为 HORIZONTAL 或 VERTICAL`),itemSpacing:i.number().optional().describe(`自动布局项间距(px);primaryAxisAlignItems=SPACE_BETWEEN 时该项被忽略(子项均匀分布)`),paddingTop:i.number().optional().describe(`上内边距(px)`),paddingRight:i.number().optional().describe(`右内边距(px)`),paddingBottom:i.number().optional().describe(`下内边距(px)`),paddingLeft:i.number().optional().describe(`左内边距(px)`),primaryAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional().describe(`主轴尺寸模式:FIXED|AUTO`),counterAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional().describe(`交叉轴尺寸模式:FIXED|AUTO`),primaryAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`,`SPACE_BETWEEN`]).optional().describe(`主轴对齐:MIN|MAX|CENTER|SPACE_BETWEEN;设为 SPACE_BETWEEN 时 itemSpacing 被忽略(子项均匀分布)`),counterAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`]).optional().describe(`交叉轴对齐:MIN|MAX|CENTER`),layoutGrow:i.number().optional().describe(`自动布局内伸缩系数`),layoutAlign:i.enum([`MIN`,`CENTER`,`MAX`,`STRETCH`,`INHERIT`]).optional().describe(`自动布局内对齐:MIN|CENTER|MAX|STRETCH|INHERIT`)}),k=i.object({fills:i.array(x).optional().describe(`填充列表(Paint 数组;整体替换,非合并,需保留的现有填充项要一并传入)`),fillStyleId:i.string().optional().describe(`填充样式 id(团队库样式;平台无此能力时被忽略)`),blendMode:b.optional(),effectStyleId:i.string().optional().describe(`效果样式 id(团队库样式;平台无此能力时被忽略)`),effects:i.array(Te).optional().describe(`效果列表(阴影/模糊,可多层叠加;整体替换,非合并)`),constraints:i.object({horizontal:S.describe(`水平约束:MIN|MAX|STRETCH|CENTER|SCALE`),vertical:S.describe(`垂直约束:MIN|MAX|STRETCH|CENTER|SCALE`)}).optional().describe(`自动布局中的约束`),clipsContent:i.boolean().optional().describe(`是否裁剪溢出内容`),cornerSmoothing:i.number().optional().describe(`圆角平滑度 0-1`),layoutGrids:i.array(Ee).optional().describe(`布局网格(参考线)`),arcData:i.object({startingAngle:i.number().describe(`起始角度(radians)`),endingAngle:i.number().describe(`结束角度(radians)`),innerRadius:i.number().describe(`内半径(0-1 ratio)`)}).optional().describe(`环形路径参数(弧线),仅 ELLIPSE 节点生效`)}),Tt={ids:i.array(i.string()).min(1).optional().describe(`目标节点 id 列表;缺省时作用于当前选中节点`),matchName:i.string().optional().describe(`按节点 name 精确过滤(精确等值,非模糊/包含),仅命中节点被修改`),recursive:i.boolean().optional().describe(`是否递归应用到子树,默认 false。recursive 只作用于**后代**,不含目标节点自身:给容器 FRAME 传它刷色,容器自己不会被改(容器自身加描边会渲染成方框)。目标是无子节点的叶子时,自身即整棵子树,仍会改。要把容器自己也算进去再传 includeSelf=true`),includeSelf:i.boolean().optional().describe(`仅 recursive=true 时有意义:是否连目标节点自身一起改,默认 false。传 true 且目标是容器时结果会带 warnings 点名「容器自身也被修改」`)},A=(e,t=1)=>i.array(i.string()).min(t).describe(e),Et=i.object({ids:A(`要设为当前选中的节点 id 列表`)}).strict(),Dt=i.object({ids:i.array(i.string()).optional().describe(`要删除的节点 id 列表;缺省时删除当前选中节点`),matchName:i.string().optional().describe(`在 ids(或当前选中)范围内,仅删除 name 精确匹配的节点`)}).strict(),Ot=i.object({ids:A(`要复制的节点 id 列表(新副本右下偏移放置)`)}).strict(),kt=i.object({ids:A(`要编组的节点 id 列表,至少 2 个`,2),name:i.string().optional().describe(`组名`),layoutMode:i.enum([`NONE`,`HORIZONTAL`,`VERTICAL`]).optional().describe(`自动布局方向:NONE=纯归组(子节点仅叠加,不排布),HORIZONTAL=水平排列,VERTICAL=垂直排列`),itemSpacing:i.number().optional().describe(`自动布局项间距(px);primaryAxisAlignItems=SPACE_BETWEEN 时该项被忽略(子项均匀分布)`),paddingTop:i.number().optional().describe(`上内边距(px)`),paddingRight:i.number().optional().describe(`右内边距(px)`),paddingBottom:i.number().optional().describe(`下内边距(px)`),paddingLeft:i.number().optional().describe(`左内边距(px)`),primaryAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional().describe(`主轴尺寸模式:FIXED|AUTO`),counterAxisSizingMode:i.enum([`FIXED`,`AUTO`]).optional().describe(`交叉轴尺寸模式:FIXED|AUTO`),primaryAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`,`SPACE_BETWEEN`]).optional().describe(`主轴对齐:MIN|MAX|CENTER|SPACE_BETWEEN;设为 SPACE_BETWEEN 时 itemSpacing 被忽略(子项均匀分布)`),counterAxisAlignItems:i.enum([`MIN`,`MAX`,`CENTER`]).optional().describe(`交叉轴对齐:MIN|MAX|CENTER`)}).strict(),At=i.object({ids:A(`要解组的节点 id 列表`)}).strict(),jt=i.object({ids:A(`要合并为单一矢量的节点 id 列表,至少 2 个`,2)}).strict(),Mt=i.object({ids:A(`要把描边转成轮廓矢量的节点 id 列表`)}).strict(),Nt=i.object({ids:A(`要移动的节点 id 列表`),parentId:i.string().optional().describe(`目标父节点 id。**强烈建议显式传**:只给 index 不给 parentId 时,缺省父级取「当前选中里第一个不是被移动节点的节点」——当前选中为空或不含父容器时该值不可靠(历史上因此报过「没有找到目标父节点」,或把节点误移进另一个被选中的节点下)。不传 parentId 的可用姿势:①先用 jsd_select_nodes 选中目标容器;②只给 index 且 ids 里含被调整节点本身 → 按被调整节点的原父级在此处调层序。跨父级移动**保持节点绝对位置**:内部按页面系记账并自动换算成新父下的 x/y,不要按「相对系重解释」手动摆回(那会把节点推走)。唯一例外是移入 auto-layout 容器 —— 位置由布局接管,要调排布改 itemSpacing / 对齐`),index:i.number().optional().describe(`目标在父节点 children 数组里的最终下标;缺省追加到末尾。语义 = 绘制顺序(也就是序列化里的 z):0 是最底层,末位是最上层。节点已在该父级下时,本参数用于调整层序(不传则原地不动);auto-layout 容器同样支持(内部临时关掉布局插入后恢复),若引擎没落位会明确报错`)}).strict(),Pt=i.object({ids:i.array(i.string()).optional().describe(`要清理的已损坏节点 id 列表;缺省时清理当前页全部损坏节点`)}).strict(),Ft=i.object({ids:A(`要固化为组件的节点 id 列表`),name:i.string().optional().describe(`组件名称`)}).strict(),It=i.object({ids:A(`要生成实例的组件(COMPONENT)节点 id 列表`)}).strict(),Lt=i.object({ids:A(`要取消实例链接的实例(INSTANCE)节点 id 列表`)}).strict(),Rt=i.object({key:i.string().describe(`团队库组件唯一标识 Key`),name:i.string().optional().describe(`导入后的节点名称`)}).strict(),zt=i.object({ids:A(`要换绑的实例(INSTANCE)节点 id 列表`),componentId:i.string().describe(`目标组件(COMPONENT)节点 id`)}).strict(),Bt=i.object({ids:A(`要设置变体属性的实例(INSTANCE)节点 id 列表`),properties:i.record(i.string(),i.string()).describe(`变体属性名→值,如 {"状态":"禁用"};可调属性需从 jsd_find / jsd_get_selection 返回的 variantGroupProperties 获取,属性名必须完全匹配`)}).strict(),Vt=i.object({ids:A(`要合并为变体集(分量)的组件(COMPONENT)节点 id 列表;实例不能直接合成,须先 jsd_detach_instance 或重建为组件`),name:i.string().optional().describe(`变体集名称`)}).strict(),Ht=i.object({sourceId:i.string().describe(`源实例(INSTANCE)节点 id,要复制其覆盖(变体/组件属性/可见样式文本)`)}).strict(),Ut={ids:A(`要套用覆盖快照的目标实例(INSTANCE)节点 id 列表`),sourceId:i.string().describe(`源实例 id,即先前 copy_overrides 返回的 snapshotId`),swapToSource:i.boolean().optional().describe(`套用时是否把目标实例 swap 成源组件,默认 false(swap 会丢失目标既有覆盖,需显式开启)`)},Wt=i.object(Ut).strict(),Gt=i.object(Ut).strict(),Kt={fills:k.shape.fills,fillStyleId:k.shape.fillStyleId,blendMode:k.shape.blendMode},qt={...St.shape},Jt={cornerRadius:O.shape.cornerRadius,topLeftRadius:O.shape.topLeftRadius,topRightRadius:O.shape.topRightRadius,bottomLeftRadius:O.shape.bottomLeftRadius,bottomRightRadius:O.shape.bottomRightRadius,cornerSmoothing:k.shape.cornerSmoothing},Yt={...Ct.shape},Xt={x:D.shape.x,y:D.shape.y,rotation:D.shape.rotation},Zt={...bt.shape,x:D.shape.x,y:D.shape.y},Qt={...wt.shape,constraints:k.shape.constraints},$t={effects:k.shape.effects,effectStyleId:k.shape.effectStyleId,clipsContent:k.shape.clipsContent,layoutGrids:k.shape.layoutGrids,arcData:k.shape.arcData},en={opacity:D.shape.opacity,visible:D.shape.visible,locked:D.shape.locked},tn={name:i.string().describe(`节点新名称`)},nn={...xt.shape};function j(e){return i.object({...Tt,...e}).strict()}var rn=j(Kt),an=j(qt),on=j(Jt),sn=j(Yt),cn=j(Xt),ln=j(Zt),un=j(Qt),dn=j($t),fn=j(en),pn=j(tn),mn=j(nn),hn={set_fill:Object.keys(Kt),set_stroke:Object.keys(qt),set_corner_radius:Object.keys(Jt),set_text:Object.keys(Yt),move:Object.keys(Xt),resize:Object.keys(Zt),set_layout:Object.keys(Qt),set_effects:Object.keys($t),set_visibility:Object.keys(en),rename:Object.keys(tn),set_shape:Object.keys(nn)};function M(e){return i.object({...Tt,props:i.object(e).strict()}).strict()}M(Kt),M(qt),M(Jt),M(Yt),M(Xt),M(Zt),M(Qt),M($t),M(en),M(tn),M(nn);var gn={debug:0,info:1,warn:2,error:3},_n=process.env.TEXT_TO_DESIGN_MCP_LOG??`/tmp/text-to-design-mcp.log`,vn=gn,yn=process.env.TEXT_TO_DESIGN_MCP_LOG_LEVEL??`info`,bn=null;function xn(e){bn=e}function N(e,n){if(vn[e]>=vn[yn])try{t(_n,`${new Date().toISOString()} [${e.toUpperCase()}] [text-to-design-mcp] ${n}\n`)}catch{}try{bn?.(e,n)}catch{}}function P(e){N(`info`,e)}function F(e){N(`debug`,e)}function I(e){N(`warn`,e)}function L(e){N(`error`,e)}var Sn=3e4,Cn=class{pending=new Map;seq=0;binaryTarget=null;sendFn;constructor(e){this.sendFn=e}request(e,t,n={}){let r=n.timeout??Sn,i=n.signal,a=`r${++this.seq}`,o=t&&typeof t==`object`&&`bytes`in t?t.bytes:null,s=o==null?{type:`request`,id:a,method:e,params:t}:{type:`request`,id:a,method:e,params:{...t,hasBinary:!0,bytes:void 0}};return new Promise((t,n)=>{let c=Date.now(),l={id:a,method:e,resolve:t,reject:n,timer:null,waitBinary:!1,binaryCount:0,buffers:[],startedAt:c};if(l.timer=setTimeout(()=>{this.pending.delete(a),this.detachAbort(l),I(`请求超时: ${a} ${e} 耗时=${Date.now()-c}ms`),n(Error(`请求超时: ${e}`))},r),i){if(i.aborted){clearTimeout(l.timer),n(Error(`请求已取消: ${e}`));return}l.abort={signal:i,listener:()=>{this.pending.delete(a)&&(this.detachAbort(l),P(`请求取消: ${a} ${e} 耗时=${Date.now()-c}ms`),n(Error(`请求已取消: ${e}`)))}},i.addEventListener(`abort`,l.abort.listener,{once:!0})}this.pending.set(a,l),P(`发出请求: ${a} ${e}${o==null?``:` +binary(${o.byteLength}B)`}`),this.sendFn(JSON.stringify(s),o==null?void 0:Buffer.from(o))})}detachAbort(e){e.abort&&=(e.abort.signal.removeEventListener(`abort`,e.abort.listener),void 0)}onText(e){let t;try{t=JSON.parse(e.toString())}catch(t){I(`WS 文本解析失败(${t instanceof Error?t.message:String(t)}): ${e.toString().slice(0,100)}`);return}if(t.type===`request`){t.method===`ping`?(P(`收到 ping 请求: ${t.id} (自动回 pong)`),this.sendFn(JSON.stringify({type:`response`,id:t.id,ok:!0,data:{pong:!0}}))):P(`收到未知请求: ${t.id} ${t.method} (忽略)`);return}if(t.type!==`response`){P(`收到非响应消息: type=${t.type}`);return}let n=this.pending.get(t.id);if(!n){I(`未匹配响应: id=${t.id}(可能已超时或来源不明)`);return}if(t.hasBinary&&(t.binaryCount??1)>0){if(P(`二进制响应开始: id=${t.id} count=${t.binaryCount??1}`),this.binaryTarget){let e=this.binaryTarget;this.binaryTarget=null,I(`二进制响应被覆盖: 旧 id=${e.id}(${e.buffers.length}/${e.binaryCount} 帧未收齐),新 id=${t.id}`)}n.waitBinary=!0,n.binaryCount=t.binaryCount??1,n.data=t.data,this.binaryTarget=n;return}this.pending.delete(t.id),clearTimeout(n.timer),this.detachAbort(n);let r=`响应: ${n.id} ${n.method} ok=${t.ok} 耗时=${Date.now()-n.startedAt}ms${t.ok?``:` error=${t.error??``}`}`;t.ok?P(r):L(r),t.ok?n.resolve(t.data):n.reject(Error(t.error??`plugin error`))}onBinary(e){if(!this.binaryTarget){I(`孤儿二进制帧 len=${e.byteLength}(无待组装响应,已丢弃)`);return}if(this.binaryTarget.buffers.push(e),P(`二进制帧: id=${this.binaryTarget.id} ${this.binaryTarget.buffers.length}/${this.binaryTarget.binaryCount}`),this.binaryTarget.buffers.length>=this.binaryTarget.binaryCount){let e=this.binaryTarget;this.binaryTarget=null;let t=e.buffers.reduce((e,t)=>e+t.byteLength,0);P(`二进制组装完成: id=${e.id} ${e.buffers.length} 帧 ${t}B 耗时=${Date.now()-e.startedAt}ms`),this.settle(e)}}rejectAll(e){for(let[,t]of this.pending)clearTimeout(t.timer),this.detachAbort(t),t.reject(e);this.pending.clear()}clear(){for(let[,e]of this.pending)clearTimeout(e.timer),this.detachAbort(e);this.pending.clear(),this.binaryTarget=null}settle(e){this.pending.delete(e.id),clearTimeout(e.timer),this.detachAbort(e),e.resolve(wn(e.data,e.buffers))}};function wn(e,t){let n=t.length===1?t[0]:t;if(!e||typeof e!=`object`)return n;let r=e;if(r.exports&&typeof r.exports==`object`){let e=r.exports,n={};return Object.entries(e).forEach(([e,r],i)=>{n[e]={...r,bytes:t[i]}}),{...r,exports:n}}return{...r,bytes:n}}var Tn=class{wss=null;http=null;client=null;heartbeat=null;_port=0;onMessage=null;onConnect=null;onDisconnect=null;get port(){return this._port}async start(e){if(this.http=a(),this.wss=new s({server:this.http}),this.wss.on(`error`,e=>{I(`WS server 错误: ${e instanceof Error?e.message:String(e)}`)}),this.heartbeat=setInterval(()=>{this.client&&this.client.readyState===o.OPEN&&(this.client.send(JSON.stringify({type:`status`,state:`connected`,version:_})),F(`心跳: 下发状态确认`))},3e4),this.wss.on(`connection`,e=>{this.client=e,P(`插件已连接`);try{this.onConnect?.()}catch(e){P(`onConnect 回调异常: ${e instanceof Error?e.message:String(e)}`)}e.send(JSON.stringify({type:`status`,state:`connected`,version:_})),F(`已下发状态确认(status connected)`),e.on(`message`,(e,t)=>{let n=Buffer.isBuffer(e)?e:Buffer.from(e);F(`收到 WS 消息 len=${n.length} bin=${t}`),this.onMessage?.(n,t)}),e.on(`close`,()=>{this.client===e&&(this.client=null),P(`插件断开`),this.onDisconnect?.(Error(`plugin disconnected`))}),e.on(`error`,()=>{this.client===e&&(this.client=null),this.onDisconnect?.(Error(`plugin connection error`))})}),!await this.tryListen(e))throw this.http.close(),Error(`端口 ${e} 已被占用。已有 text-to-design-mcp 实例在运行?请检查残留进程后重试`);this._port=e}stop(){this.heartbeat&&clearInterval(this.heartbeat),this.heartbeat=null,this.wss?.close(),this.http?.close()}get isConnected(){return this.client!==null&&this.client.readyState===o.OPEN}send(e){this.client&&this.client.readyState===o.OPEN?(this.client.send(e),F(`发送 WS 消息 len=${e.length} bin=${typeof e!=`string`}`)):I(`发送失败: 无客户端连接(${e.length} 字节被丢弃)`)}sendPush(e){this.client&&this.client.readyState===o.OPEN&&this.client.send(e)}tryListen(e){return new Promise(t=>{let n=()=>{i(),t(!1)},r=()=>{i(),t(!0)},i=()=>{this.http?.off(`error`,n),this.http?.off(`listening`,r)};this.http?.once(`error`,n),this.http?.once(`listening`,r),this.http?.listen(e)})}},En=200,Dn=class{transport=new Tn;pending;logRing=[];onConnectionChange=null;constructor(){this.pending=new Cn((e,t)=>{this.transport.send(e),t&&this.transport.send(t)}),this.transport.onMessage=(e,t)=>{t?this.pending.onBinary(e):this.pending.onText(e)},this.transport.onConnect=()=>{this.replayLogs(),this.onConnectionChange?.(!0)},this.transport.onDisconnect=e=>{this.pending.rejectAll(e),this.onConnectionChange?.(!1)}}get port(){return this.transport.port}start(e){return this.transport.start(e)}stop(){this.pending.clear(),this.logRing=[],this.transport.stop()}get isConnected(){return this.transport.isConnected}request(e,t,n={}){return this.transport.isConnected?this.pending.request(e,t,n):(I(`请求被拒(插件未连接): ${e}`),Promise.reject(Error(`${ge.runtime} 插件未连接。请先在${ge.label}客户端中运行该插件。`)))}notifyLog(e,t){let n={type:`log`,level:e,line:t};if(!this.transport.isConnected){this.logRing.length>=En&&this.logRing.shift(),this.logRing.push(n);return}this.sendLogPush(n)}replayLogs(){if(this.logRing.length===0)return;let e=this.logRing;this.logRing=[],P(`回放离线日志 ${e.length} 条`);for(let t of e)this.sendLogPush(t)}sendLogPush(e){try{this.transport.sendPush(JSON.stringify(e))}catch(e){I(`日志推送失败: ${e instanceof Error?e.message:String(e)}`)}}};async function R(){try{let e=await fetch(`http://127.0.0.1:${v}/health`,{signal:AbortSignal.timeout(800)});if(!e.ok)return null;let t=await e.json();return t.name&&t.version?{name:t.name,version:t.version}:null}catch{return null}}async function On(){let e=await R();if(e&&e.version!==y){P(`检测到旧版 daemon (${e.version} → ${y}),正在替换...`),await fetch(`http://127.0.0.1:${v}/shutdown`,{method:`POST`}).catch(()=>{});let t=Date.now()+de;for(;Date.now()<t&&(await kn(250),await R()!==null););return await R()===null?{state:`none`}:(P(`旧版 daemon 尚未释放端口,等待下一轮探测`),{state:`starting`})}let t=new c({name:`text-to-design-proxy`,version:y},{versionNegotiation:{mode:`auto`}});try{await t.connect(new l(new URL(`http://127.0.0.1:${v}/mcp`)));let{tools:e}=await t.listTools();return e.length===0||!e.every(e=>e.name.startsWith(`jsd_`))?(await t.close(),{state:`foreign`}):{state:`proxy`,client:t}}catch{return await t.close().catch(()=>{}),await R()===null?{state:`none`}:{state:`starting`}}}function kn(e){return new Promise(t=>setTimeout(t,e))}function An(e){let t=e.properties;if(typeof t!=`object`||!t)return null;for(let e of Object.values(t))if(!(typeof e!=`object`||!e)){if(`const`in e&&e.const!=null)return String(e.const);if(Array.isArray(e.enum)&&e.enum.length>0)return String(e.enum[0])}return null}function jn(e){let t=[e.oneOf,e.anyOf].find(e=>Array.isArray(e)&&e.length>0);return t==null?null:t.map((e,t)=>{let n=e??{},r=An(n)??`分支#${t}`,i=Array.isArray(n.required)?n.required.filter(e=>e!==`op`):[];return i.length>0?`${r}(需 ${i.join(`, `)})`:`${r}(无必填)`}).join(` | `)}function Mn(e){if(typeof e!=`object`||!e||Array.isArray(e))return JSON.stringify(e)??String(e);let t=Object.keys(e);return t.length>0?`字段 [${t.join(`, `)}]`:`空对象 {}`}function Nn(e,t){if(t.oneOf!=null||t.anyOf!=null)return null;let n=t.properties;if(typeof n!=`object`||!n||typeof e!=`object`||!e||Array.isArray(e))return null;let r=new Set(Object.keys(n)),i=Object.keys(e).filter(e=>!r.has(e));return i.length>0?i:null}function Pn(e){let t=m(e)[`~standard`],n=jn(e);return{"~standard":{...t,validate(r){let i=t.validate(r);if(!(`issues`in i))return i;let a=``;if(typeof r==`object`&&r&&!Array.isArray(r)){let e=r.op;typeof e==`string`&&(a=`, op='${e}'`)}let o=i.issues.map(e=>typeof e?.message==`string`?e.message:``).filter(Boolean).join(`; `).slice(0,300),s=n==null?``:`该工具按判别字段分发,可选值: ${n}。`,c=Nn(r,e);if(c!=null){let t=Object.keys(e.properties);return{issues:[{message:`入参校验失败: 字段 [${c.join(`, `)}] 不被该工具接受,请删掉后重试(其余字段本身合法)。该工具接受: [${t.join(`, `)}]。原始校验: ${o}`}]}}return{issues:[{message:`入参校验失败: 实际收到${Mn(r)}${a}。${s}请补齐对应必填字段后重试。原始校验: ${o}`}]}}}}}function Fn(){let e=te(process.execPath,[...process.execArgv,...process.argv.slice(1)],{detached:!0,stdio:`ignore`,env:{...process.env,TEXT_TO_DESIGN_MCP_ROLE:`daemon`}});e.unref(),e.on(`error`,e=>{L(`拉起 daemon 失败: ${e.message}`)})}var In=1500,Ln=2e4,Rn=2e3,zn=2e4,Bn=15e3;function Vn(e){let t=e instanceof Error?e.message:String(e);return/fetch failed|ECONNREFUSED|ECONNRESET|EPIPE|socket hang up|terminated|closed/i.test(t)}async function Hn(e){let t=e,n=!1,r=null,a=new u({name:le,version:y},{supportedProtocolVersions:[`2026-07-28`,...f],...e.getInstructions()?{instructions:e.getInstructions()}:{}}),o=new Map,s=new Map,c=new Map,l=new Map,p=async e=>{try{return await e(t)}catch(r){if(n||!Vn(r))throw r;return I(`shim: 上游请求失败,触发重连后重放`),await h(),e(t)}};async function te(){let{tools:e}=await p(e=>e.listTools()),t=new Set;for(let n of e){t.add(n.name);let e=JSON.stringify(n),r=o.get(n.name);if(r&&r.raw===e)continue;r?.handle.remove(),o.delete(n.name);let i=a.registerTool.bind(a);try{let t=i(n.name,{title:n.title,description:n.description,annotations:n.annotations,...n.inputSchema?{inputSchema:Pn(n.inputSchema)}:{},...n.outputSchema?{outputSchema:m(n.outputSchema)}:{}},async e=>p(t=>t.callTool({name:n.name,arguments:e??{}})));o.set(n.name,{handle:t,raw:e})}catch(e){I(`工具注册失败(${n.name}): ${e instanceof Error?e.message:String(e)}`)}}for(let[e,n]of[...o])t.has(e)||(n.handle.remove(),o.delete(e))}async function ne(){let{prompts:e}=await p(e=>e.listPrompts()),t=new Set;for(let n of e){t.add(n.name);let e=JSON.stringify(n),r=s.get(n.name);if(r&&r.raw===e)continue;r?.handle.remove(),s.delete(n.name);let o={};for(let e of n.arguments??[])o[e.name]=i.string().describe(e.description??``);let c=a.registerPrompt(n.name,{title:n.title,description:n.description,argsSchema:i.object(o)},e=>p(t=>t.getPrompt({name:n.name,...e?{arguments:e}:{}})));s.set(n.name,{handle:c,raw:e})}for(let[e,n]of[...s])t.has(e)||(n.handle.remove(),s.delete(e))}async function re(){let[{resources:e},{resourceTemplates:t}]=await Promise.all([p(e=>e.listResources()),p(e=>e.listResourceTemplates())]),n=new Set;for(let t of e){let e=t.uri;n.add(e);let r=JSON.stringify(t),i=c.get(e);if(i&&i.raw===r)continue;i?.handle.remove(),c.delete(e);let o=a.registerResource(t.name,e,{title:t.title,description:t.description,mimeType:t.mimeType},async e=>p(t=>t.readResource({uri:e.href})));c.set(e,{handle:o,raw:r})}for(let[e,t]of[...c])n.has(e)||(t.handle.remove(),c.delete(e));let r=new Set;for(let e of t){let t=String(e.uriTemplate);r.add(t);let n=JSON.stringify(e),i=l.get(t);if(i&&i.raw===n)continue;i?.handle.remove(),l.delete(t);let o=a.registerResource(e.name,new d(t,{list:void 0}),{title:e.title,description:e.description,mimeType:e.mimeType},async(e,t)=>p(t=>t.readResource({uri:e.href})));l.set(t,{handle:o,raw:n})}for(let[e,t]of[...l])r.has(e)||(t.handle.remove(),l.delete(e))}let ie=async()=>{let e=await Promise.allSettled([te(),ne(),re()]);for(let t of e)t.status===`rejected`&&I(`同步清单失败: ${String(t.reason).slice(0,120)}`)},h=()=>r||(r=(async()=>{let e=Date.now()+Ln,n=null;for(;Date.now()<e;){try{let e=await On();if(e.state===`proxy`){t=e.client,ae(t),ce(),P(`shim: 上游已恢复`),await ie();return}e.state===`none`&&Fn()}catch(e){n=e}await kn(In)}throw n??Error(`上游重连超时(${Ln}ms)`)})().finally(()=>{r=null}),r),ae=e=>{e.onclose=()=>{n||(I(`shim: 上游断开,自动重连`),h().catch(()=>{}))},e.setNotificationHandler(`notifications/tools/list_changed`,async()=>te().catch(()=>{})),e.setNotificationHandler(`notifications/prompts/list_changed`,async()=>ne().catch(()=>{})),e.setNotificationHandler(`notifications/resources/list_changed`,async()=>re().catch(()=>{})),e.setNotificationHandler(`notifications/resources/updated`,async e=>{let t=e.params;t?.uri!=null&&await a.server.sendResourceUpdated({uri:t.uri}).catch(()=>{})})};ae(t);let oe=ee(async()=>(await ie(),a)),se=Date.now()+zn,g=null,_=()=>{n||(g=setTimeout(()=>{n||(ie(),_())},Date.now()<se?Rn:Bn),g.unref())},ce=()=>{se=Date.now()+zn};_(),P(`shim 模式: stdio → 动态同步,共享 daemon`),process.on(`SIGINT`,async()=>{n=!0,g&&clearTimeout(g),await oe.close(),await t.close().catch(()=>{}),process.exit(0)})}function Un(e){return{content:[{type:`text`,text:typeof e==`string`?e:JSON.stringify(e,null,2)}]}}function Wn(e){return e._def?.typeName}function Gn(e,t){return e._def?.[t]}function Kn(e,t){return e._def?.[t]}function z(e){switch(Wn(e)){case`ZodObject`:{let t=e.shape;if(typeof t!=`function`)return;let n={};for(let[e,r]of Object.entries(t()))n[e]=z(r);return n}case`ZodArray`:return[];case`ZodBoolean`:return!1;case`ZodNumber`:return 0;case`ZodString`:return``;case`ZodLiteral`:return Kn(e,`value`);case`ZodEnum`:return Kn(e,`values`)?.[0];case`ZodOptional`:case`ZodDefault`:{let t=Gn(e,`innerType`);return t?z(t):void 0}case`ZodEffects`:{let t=Gn(e,`schema`);return t?z(t):void 0}case`ZodUnion`:{let t=Kn(e,`options`)??[],n=t.find(e=>Wn(e)===`ZodArray`);return n?z(n):t[0]?z(t[0]):void 0}case`ZodLazy`:{let t=e._def?.getter;return t?z(t()):void 0}default:return}}function qn(e,t,n){let r={content:[{type:`text`,text:`错误: ${e instanceof Error?e.message:String(e)}`}],isError:!0};return n!==void 0&&(r.followUp=n),t?{...r,structuredContent:z(t)}:r}function Jn(e,t,n,r){if(t){let i=t.safeParse(e);return i.success?{content:[...n??[],...Un(e).content],structuredContent:i.data,...r===void 0?{}:{followUp:r}}:{content:Un(e).content,structuredContent:z(t),isError:!0,...r===void 0?{}:{followUp:r}}}return{content:[...n??[],...Un(e).content],structuredContent:e,...r===void 0?{}:{followUp:r}}}var Yn=new Map;function Xn(e){return Yn.get(e)}function Zn(){return[...Yn.keys()].sort()}function B(e){return(t,n)=>{let r=t.registerTool.bind(t),i=async(t,r)=>{try{if(e.inputSchema!=null){let n=e.inputSchema.safeParse(t);if(!n.success){let t=n.error.issues.map(e=>`${e.path.join(`.`)||`(root)`}: ${e.message}`).join(`; `);throw Error(`参数校验失败(${e.name}): ${t}`)}t=n.data}let i={...r==null?{}:{signal:r},...e.timeout==null?{}:{timeout:e.timeout}},a;return a=e.run?await e.run(t,n,r??new AbortController().signal):await n.request(e.method,e.payload?e.payload(t):t,i),Jn(a,e.outputSchema,e.extraContent?e.extraContent(a,t):void 0,e.followUp)}catch(t){let n=t instanceof Error?t.message:String(t);return L(`工具 ${e.name} 执行失败: ${n.slice(0,200)}`),qn(t,e.outputSchema,e.followUp)}};Yn.set(e.name,i);let a=r(e.name,{title:e.title,description:e.description,...e.inputSchema?{inputSchema:e.inputSchema}:{},outputSchema:e.outputSchema,...e.annotations?{annotations:e.annotations}:{}},async(...t)=>{let n=e.inputSchema!=null,r=t[0],a=t[1],o=n?r??{}:{},s=n?a:r,c=s?.mcpReq?.signal??s?.signal;return i(o,c)});return a.alwaysEnabled=e.alwaysEnabled??!1,a}}var Qn=`(page)`,$n=8,er=200,tr=5;function nr(e,t){switch(e){case`jsd_delete_node`:case`jsd_reparent_nodes`:case`jsd_group_nodes`:case`jsd_ungroup_nodes`:case`jsd_flatten_nodes`:case`jsd_repair_nodes`:return!0;case`jsd_manage_nodes`:{let e=t.op;return e===`remove`||e===`reparent`||e===`group`||e===`ungroup`||e===`flatten`||e===`repair`}default:return!1}}function rr(e,t){return e===`jsd_reparent_nodes`||e===`jsd_manage_nodes`&&t.op===`reparent`}function ir(e,t){if(!(typeof e!=`object`||!e))for(let[n,r]of Object.entries(e)){if(n===`ids`&&Array.isArray(r)){for(let e of r)typeof e==`string`&&e!==``&&t.add(e);continue}(n===`parentId`||n===`nodeId`||n===`componentId`)&&typeof r==`string`&&r!==``&&t.add(r)}}function V(e){return Array.isArray(e)?e.filter(e=>typeof e==`object`&&!!e):[]}function ar(e){if(typeof e!=`object`||!e)return null;let t=e;return typeof t.id!=`string`||typeof t.x!=`number`||typeof t.y!=`number`?null:{id:t.id,name:typeof t.name==`string`?t.name:t.id,x:t.x,y:t.y}}async function or(e,t){let n=Xn(e);if(n==null)return null;let r=await n(t,void 0);if(r?.isError===!0)return null;let i=r?.structuredContent;return typeof i==`object`&&i?i:null}async function sr(e){let t=new Map;if(e===Qn){let e=await or(`jsd_get_page`,{});if(e==null)return null;for(let n of V(e.nodes).slice(0,er)){let e=ar(n);e!=null&&t.set(e.id,e)}return t}let n=await or(`jsd_find`,{ids:[e],depth:1});if(n==null)return null;let r=V(n.nodes)[0];if(r==null)return null;for(let e of V(r.children).slice(0,er)){let n=ar(e);n!=null&&t.set(n.id,n)}return t}var cr=class{before=new Map;dead=new Set;async observe(e,t){try{let n=new Set;if(ir(t,n),n.size===0)return;let r=await or(`jsd_find`,{ids:[...n],depth:0}),i=new Set,a=!1;for(let e of V(r?.nodes)){let t=typeof e.parentId==`string`?e.parentId:``;t===``?a=!0:i.add(t)}rr(e,t)&&typeof t.parentId==`string`&&i.add(t.parentId),a&&i.add(Qn);for(let e of i){if(this.before.has(e)||this.dead.has(e))continue;if(this.before.size>=$n){this.dead.add(e);continue}let t=await sr(e);if(t==null){this.dead.add(e);continue}this.before.set(e,t)}}catch{}}async verify(){let e=[];for(let[t,n]of this.before)try{let r=await sr(t);if(r==null)continue;let i=[];for(let[e,t]of n){let n=r.get(e);n!=null&&(n.x!==t.x||n.y!==t.y)&&i.push({from:t,to:n})}if(i.length===0)continue;let a=i.slice(0,tr).map(e=>`${e.from.name}(${e.from.id}) (${e.from.x},${e.from.y}) → (${e.to.x},${e.to.y})`),o=i.length>tr?` 等 ${i.length} 个节点`:``;e.push([`同层几何漂移(平台缺陷 P25-B):${t===Qn?`当前页顶层`:`父级 ${t}`} 内有未被本次操作触及的节点自行移位:${a.join(`、`)}${o}。`,`根因疑似删除/移父后引擎重算同层约束(无报错、回显正常),别当成样式问题排查。`,`处理:用 jsd_move_node 按上述原值回填,或先 jsd_find 复核该层全部节点 x/y。`].join(``))}catch{}return e}};function lr(e,t){let n=e;for(let e of t.split(`.`)){let t=/^([\w$\u4e00-\u9fff-]*)((?:\[\d+\])*)$/.exec(e.trim());if(t==null)return{ok:!1};if(t[1]!==``){if(typeof n!=`object`||!n)return{ok:!1};n=n[t[1]]}if(t[2]!==``)for(let e of t[2].matchAll(/\[(\d+)\]/g)){if(!Array.isArray(n))return{ok:!1};n=n[Number(e[1])]}}return{ok:!0,value:n}}function ur(e,t){let n=e.indexOf(`.`),r=n===-1?e:e.slice(0,n),i=n===-1?``:e.slice(n+1);if(!t.has(r)){let n=[...t.keys()].join(`, `)||`无`;throw Error(`占位符引用的步骤不存在或未成功:「${e}」(已完成: ${n})`)}let a=t.get(r);if(i===``)return a;let o=lr(a,i);if(!o.ok)throw Error(`无法解析占位符引用「${e}」:请核对步骤 ${r} 的返回结构`);return o.value}var dr=/\{\{\s*([^{}]+?)\s*\}\}/g,fr=/^\{\{\s*([^{}]+?)\s*\}\}$/,pr=[`id`,`name`,`type`,`x`,`y`,`width`,`height`,`z`,`parentId`],mr=new Set([`vectorPaths`,`constraints`,`absoluteBoundingBox`,`absoluteRenderBounds`]),hr=2e4;function gr(e){try{return JSON.stringify(e)?.length??0}catch{return 0}}function _r(e){if(Array.isArray(e))return e.map(_r);if(typeof e!=`object`||!e)return e;let t=e;if(typeof t.id==`string`&&typeof t.type==`string`&&typeof t.name==`string`){let e={};for(let n of pr)t[n]!==void 0&&(e[n]=t[n]);return e}let n={};for(let[e,r]of Object.entries(t))mr.has(e)||(n[e]=_r(r));return n}function vr(e,t){if(Array.isArray(e)){for(let n of e)vr(n,t);return}if(!(typeof e!=`object`||!e))for(let[n,r]of Object.entries(e)){if(n===`id`&&typeof r==`string`){t.push(r);continue}vr(r,t)}}function yr(e){let t=_r(e),n=gr(t);if(n<=hr)return{data:t,trimmed:n!==gr(e)};let r=[];return vr(t,r),{data:{echoOmitted:!0,note:`本步回显裁剪后仍 ${n} 字符,已省略明细;需要细节请把该工具单独调用一次`,ids:[...new Set(r)]},trimmed:!0}}function br(e,t){if(typeof e==`string`){let n=fr.exec(e.trim());return n==null?e.replace(dr,(e,n)=>{let r=ur(n,t);return typeof r==`string`?r:JSON.stringify(r)}):ur(n[1],t)}if(Array.isArray(e))return e.map(e=>br(e,t));if(typeof e==`object`&&e){let n={};for(let[r,i]of Object.entries(e))n[r]=br(i,t);return n}return e}function xr(e,t){return[B({name:`jsd_batch`,title:`批量编排执行`,description:`批量编排器:一次请求内顺序执行多个 jsd_* 步骤,前一步结果经双花括号占位符(内容为 步骤id.字段路径)注入后一步 args,中间 id 不回传模型,显著减少往返与上下文。
3
+ 占位符独占一个参数值时保留原类型(数组可直接作 ids 用),嵌在字符串中按 JSON 文本展开;id 重复/未知工具/引用失败立即中止,工具执行失败默认也中止(stopOnError=false 或单步 continueOnError=true 可走完)。
4
+ 回显已做摘要裁剪:节点对象只留 id/name/type/x/y/width/height/z/parentId,vectorPaths(单条 >10KB、16 位小数)与 constraints 等渲染无关字段整键丢弃;裁剪后仍超 20K 字符的步骤降级为 id 清单(结果里 echoTrimmed=true)。占位符解析不受影响(内部仍用完整数据)。含图标的批次(jsd_create_icon / jsd_clone_node / jsd_create_vector)务必配一次 jsd_export 目视验收,别只看回显。
5
+ 各工具返回键与占位符写法(键写错会报「无法解析占位符引用」并中止整批):
6
+ · created 为数组 → {{id.created[0].id}}:per-type create(jsd_create_rectangle / jsd_create_frame 等)、jsd_clone_node、jsd_outline_stroke、jsd_create_instance、jsd_detach_instance
7
+ · created 为单对象 → {{id.created.id}}:jsd_create_svg / jsd_create_icon / jsd_flatten_nodes / jsd_group_nodes / jsd_create_component / jsd_import_component / jsd_combine_as_variants
8
+ · jsd_find → {{id.nodes[0].id}};jsd_get_selection → {{id.selection[0].id}}
9
+ · 属性类 jsd_set_* → {{id.updated[0].id}};jsd_swap_component → {{id.swapped[0].id}}
10
+ · jsd_manage_nodes 各 op:select→selected[](id 字符串)、remove→removed[](id 字符串)、clone/group/flatten/outline_stroke→created[]、ungroup→ungrouped[](id 字符串)、reparent→moved[](与 updated[] 同义,两个键都回)、repair→cleaned[](id 字符串)—— id 字符串数组取 {{id.selected[0]}},节点数组取 {{id.created[0].id}}
11
+ · jsd_manage_components 各 op:create_component/create_instance/detach_instance/import_component/combine_as_variants→created(detach_instance 是数组,不是 updated)、swap_component→swapped[]、set_instance_properties→updated[]、copy_overrides→snapshotId、apply_overrides/sync_overrides→applied[]
12
+ · 拿不准某步的返回结构时,先单独调它一次看回显再拼进 batch —— 猜错会连带整批中止。
13
+ 结构变更复核(默认开,checkDrift=false 可关):批次里含 remove/reparent/group/ungroup/flatten/repair 时,变更前记下受影响父层(含 reparent 的目标父级与当前页顶层)的子节点坐标,收尾再读一次比对 —— 引擎在删改结构后会把**没碰到**的兄弟节点静默挪走(实测 (24,720)→(28,618):无报错、回显正常,渲染上像样式问题,极易走错排查方向)。漂移写进结果 warnings 并给出原值,照原值用 jsd_move_node 回填即可;覆盖面仅限本次操作触及的父层(协议没有整树读法,别的层漂移查不到)。`,inputSchema:Me,outputSchema:Ne,annotations:{readOnlyHint:!1,destructiveHint:!0},followUp:{type:`tool`,tool:`jsd_get_selection`,description:`编排执行后复核画布结果`},timeout:he,run:async(e,t,n)=>{let{calls:r,stopOnError:i,checkDrift:a}=e,o=new Map,s=[],c=!1,l=new cr,u=a!==!1;for(let e=0;e<r.length;e++){let t=r[e],a=t.id==null||t.id.trim()===``?`step${e+1}`:t.id.trim(),d=e=>{s.push({id:a,tool:t.tool,ok:!1,error:e})};if(o.has(a)||s.some(e=>e.id===a)){d(`步骤 id "${a}" 重复`);break}let f=Xn(t.tool);if(f==null){d(`未知工具 ${t.tool},可用: ${Zn().join(`, `)}`);break}let p;try{p=br(t.args??{},o)}catch(e){d(e instanceof Error?e.message:String(e));break}u&&nr(t.tool,p)&&await l.observe(t.tool,p);let m=await f(p,n);if(m.isError===!0){if(d((m.content?.find(e=>e.type===`text`)?.text??`工具返回错误`).slice(0,300)),i!==!1&&t.continueOnError!==!0)break;continue}let ee=yr(m.structuredContent);ee.trimmed&&(c=!0),o.set(a,m.structuredContent),s.push({id:a,tool:t.tool,ok:!0,data:ee.data})}let d=s.length===r.length,f=u?await l.verify():[];return{ok:d&&s.every(e=>e.ok),executed:s.length,total:r.length,results:s,...c?{echoTrimmed:!0}:{},...f.length>0?{warnings:f}:{}}}})(e,t)]}function H(e,t){return{method:`component_op`,outputSchema:_t,payload:t=>({op:e,...t}),...t}}function Sr(e,t){return[H(`create_component`,{name:`jsd_create_component`,title:`建组件`,description:`建「空壳」组件——不会固化传入节点,返回全新 100×100 空组件,原节点不动。正确流程:1) jsd_resize_node 把空壳改成目标尺寸 → 2) jsd_reparent_nodes 把原 Frame 的子节点移进空壳 → 3) jsd_delete_node 删原 Frame → 4) 需要填充/圆角/阴影时再 jsd_set_fill_color / jsd_set_cornerRadius / jsd_set_effects 补。顺序必须先 resize 后 reparent,否则子节点默认 SCALE 约束会被拉伸到错位(或先给子节点 constraints:{horizontal:"MIN",vertical:"MIN"})`,inputSchema:Ft,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_resize_node`,description:`把空壳组件调到目标尺寸`}}),H(`create_instance`,{name:`jsd_create_instance`,title:`生成组件实例`,description:`按 COMPONENT 节点生成实例并返回新 id。同类实例样式/文案批量套用用 jsd_sync_overrides,变体属性用 jsd_set_instance_properties`,inputSchema:It,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_set_instance_properties`,description:`设置实例的变体属性`}}),H(`detach_instance`,{name:`jsd_detach_instance`,title:`取消实例链接`,description:`把实例(INSTANCE)转成可自由编辑的普通节点,之后与组件不再联动。⚠ 已知平台缺陷(实测):引擎报错时已内置克隆副本兜底,仍失败按报错提示操作;需要可编辑副本也可用 jsd_create_rectangle / jsd_create_text 等手工重建`,inputSchema:Lt,annotations:{readOnlyHint:!1,destructiveHint:!0},followUp:{type:`tool`,tool:`jsd_set_fill_color`,description:`解链后自由编辑新节点样式`}}),H(`import_component`,{name:`jsd_import_component`,title:`从团队库导入组件`,description:`按 key 从团队库导入组件到当前页(与团队库等外部实体打交道,可能受库权限/网络影响)。key 需是团队库组件唯一标识,导入后再 jsd_create_instance 生成实例`,inputSchema:Rt,annotations:{readOnlyHint:!1,destructiveHint:!1,openWorldHint:!0},followUp:{type:`tool`,tool:`jsd_create_instance`,description:`为导入的组件生成实例`}}),H(`swap_component`,{name:`jsd_swap_component`,title:`换绑组件`,description:`把实例换绑到另一个组件(componentId 为 COMPONENT 节点 id),会丢弃目标实例既有覆盖(破坏性)。只想套样式不换绑用 jsd_apply_overrides 且 swapToSource=false`,inputSchema:zt,annotations:{readOnlyHint:!1,destructiveHint:!0},followUp:{type:`tool`,tool:`jsd_set_instance_properties`,description:`换绑后设置变体属性`}}),H(`set_instance_properties`,{name:`jsd_set_instance_properties`,title:`设置变体属性`,description:`设置实例的变体属性(如 {"状态":"禁用"})。可调属性与可选值需先 jsd_find / jsd_get_selection 读 variantGroupProperties,属性名必须完全匹配。componentProperties 仅 Figma 生效,jsDesign 自动降级为变体属性+可见样式`,inputSchema:Bt,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_sync_overrides`,description:`批量同步其他实例的覆盖`}}),H(`combine_as_variants`,{name:`jsd_combine_as_variants`,title:`合并为变体集`,description:`把多个组件合并为变体集(分量)。必须传 COMPONENT 节点,实例不能直接合成。⚠ 平台缺陷 P24(实测):本引擎版本必然失败(引擎内部把节点按 BOOLEAN_OPERATION 取属性 → get_booleanOperation: Value is not a string,与组件结构无关)。工具会依次尝试「克隆并入当前页 / 克隆移入当前页后合并 / 原节点直接合并(原组件会被卷入组件集)」三种姿势,全败时返回可执行出口 —— 别再重试、也别去改组件结构。变体集的替代做法:每个状态各做一个 COMPONENT,按「族名 / 状态」命名(如 Nav / Inbox、Nav / Me),调用方按名字取用;确需变体语义就手工在画布上合并。「一个主件 + 每屏改子节点颜色」这条捷径同样不通(实例子节点样式 override 不保证渲染生效)`,inputSchema:Vt,annotations:{readOnlyHint:!1,destructiveHint:!0},followUp:{type:`tool`,tool:`jsd_create_component`,description:`按「族名 / 状态」逐个建独立主件(变体集不可用时的替代方案)`}}),H(`copy_overrides`,{name:`jsd_copy_overrides`,title:`复制实例覆盖快照`,description:`把源实例的覆盖(变体/组件属性/可见样式文本)复制为快照并缓存,返回 snapshotId(=源实例 id)。要先审后套或多次套用同一快照时用它,随后 jsd_apply_overrides;一次性复制+套用用 jsd_sync_overrides`,inputSchema:Ht,annotations:{readOnlyHint:!0,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_apply_overrides`,description:`把快照套用到目标实例`}}),H(`apply_overrides`,{name:`jsd_apply_overrides`,title:`套用实例覆盖快照`,description:`按 sourceId(先前 jsd_copy_overrides 返回的 snapshotId)把快照批量套用到目标实例。缓存 miss 会报错,需先 copy;swapToSource=true 会把目标换绑成源组件(丢失目标既有覆盖,需显式开启)`,inputSchema:Wt,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_sync_overrides`,description:`继续同步其他实例的覆盖`}}),H(`sync_overrides`,{name:`jsd_sync_overrides`,title:`同步实例覆盖`,description:`无状态一次性「复制+套用」:sourceId 源实例,ids 全部目标实例。不写缓存,适合 jsd_batch 编排;需要多次套用同一快照时用 jsd_copy_overrides + jsd_apply_overrides`,inputSchema:Gt,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_get_selection`,description:`复核同步后的实例`}})].map(n=>B(n)(e,t))}var Cr=new Set([`script`,`style`,`head`,`meta`,`link`,`title`,`noscript`]),wr={white:`#ffffff`,black:`#000000`,red:`#ff0000`,green:`#008000`,blue:`#0000ff`,gray:`#808080`,grey:`#808080`,transparent:`none`},Tr=`#f3f4f6`;function Er(e){let t={};if(!e)return t;for(let n of e.split(`;`)){let e=n.indexOf(`:`);if(e<0)continue;let r=n.slice(0,e).trim().toLowerCase(),i=n.slice(e+1).trim();r&&(t[r]=i)}return t}function U(e){if(e==null)return;let t=e.match(/^(-?[\d.]+)(px)?$/);return t?parseFloat(t[1]):void 0}function Dr(e,t){if(e==null||e===``)return t;let n=e.trim();return n===`transparent`?`none`:wr[n.toLowerCase()]||(n.startsWith(`#`)||n.startsWith(`rgb`)?n:t)}function Or(e){let t=(e.margin??``).split(/\s+/).filter(Boolean).map(e=>U(e)??0),n=0,r=0,i=0,a=0;return t.length===1?n=r=i=a=t[0]:t.length===2?(n=i=t[0],r=a=t[1]):t.length===4&&(n=t[0],r=t[1],i=t[2],a=t[3]),n=U(e[`margin-top`])??n,r=U(e[`margin-right`])??r,i=U(e[`margin-bottom`])??i,a=U(e[`margin-left`])??a,{top:n,right:r,bottom:i,left:a}}function kr(e){let t=(e.padding??``).split(/\s+/).filter(Boolean).map(e=>U(e)??0),n=0,r=0,i=0,a=0;return t.length===1?n=r=i=a=t[0]:t.length===2?(n=i=t[0],r=a=t[1]):t.length===4&&(n=t[0],r=t[1],i=t[2],a=t[3]),n=U(e[`padding-top`])??n,r=U(e[`padding-right`])??r,i=U(e[`padding-bottom`])??i,a=U(e[`padding-left`])??a,{top:n,right:r,bottom:i,left:a}}function Ar(e){let t={width:0,color:`#000000`},n=e.border;if(n&&n!==`none`&&n!==`0`){let e=n.match(/([\d.]+)(?:px)?(?:\s+[^ ]+)?\s+(.+)$/);if(e)return{width:parseFloat(e[1])||1,color:Dr(e[2])??`#000000`};let t=n.match(/([\d.]+)(?:px)?/);if(t)return{width:parseFloat(t[1]),color:`#000000`}}return e[`border-width`]&&e[`border-width`]!==`0`&&e[`border-width`]!==`none`?{width:U(e[`border-width`])??1,color:Dr(e[`border-color`])??`#000000`}:t}function W(e,t){return U(e[t])}function jr(e){return U(e[`font-size`])??16}function Mr(e){let t=e[`font-weight`];return t===`bold`?700:U(t)??400}function Nr(e,t){let n=e[`line-height`];return U(n)??(n!=null&&!n.endsWith(`px`)?parseFloat(n)*t:t*1.4)}function Pr(e){return(e.display??``).includes(`flex`)}function Fr(e){return e[`flex-direction`]===`row`?`row`:`column`}function Ir(e){return U(e.gap)??U(e[`row-gap`])??0}function Lr(e){let t=e[`text-align`];return t===`center`?`center`:t===`right`?`right`:`left`}function Rr(e,t){let n=0;for(let r of e)r.charCodeAt(0)>11904?n+=t:n+=t*.55;return n}function zr(e){return e.type===`text`?e.data:h(e)?e.tagName===`br`?`
14
+ `:e.children.map(zr).join(``):``}function Br(e){return e.replace(/\s+/g,` `).trim()}function Vr(e,t){let n=Er(e.attribs.style),r={tag:e.tagName,style:n,children:[],isText:!1,x:0,y:0,w:0,h:0};if(e.tagName===`img`)return r.w=W(n,`width`)??120,r.h=W(n,`height`)??120,r;for(let t of e.children){if(t.type===`text`){let e=Br(t.data);if(!e)continue;let i=r.children[r.children.length-1];i?.isText?i.text=(i.text??``)+e:r.children.push({tag:`#text`,text:e,style:Hr(n),children:[],isText:!0,x:0,y:0,w:0,h:0});continue}h(t)&&(Cr.has(t.tagName)||t.tagName!==`br`&&r.children.push(Vr(t,!1)))}if(t&&r.children.length===0){let t=Br(e.children.map(zr).join(``));t&&r.children.push({tag:`#text`,text:t,style:Hr(n),children:[],isText:!0,x:0,y:0,w:0,h:0})}return r}function Hr(e){let t={};for(let n of[`color`,`font-size`,`font-weight`,`font-family`,`line-height`,`text-align`,`letter-spacing`])e[n]!=null&&(t[n]=e[n]);return t}function Ur(e,t){let n=e.style,r=kr(n),i=Or(n),a=Ar(n),o=Math.max(0,t-r.left-r.right-a.width*2);if(e.tag===`img`)return e.w=W(n,`width`)??120,e.h=W(n,`height`)??120,{width:e.w+i.left+i.right,height:e.h+i.top+i.bottom};let s=o,c=0;if(e.isText){let t=jr(n),r=(e.text??``).split(`
15
+ `).map(e=>e.trim()).filter(Boolean);e.w=Math.min(o,Math.max(...r.map(e=>Rr(e,t)),t)),e.h=r.length*Nr(n,t),c=e.h}else{let t=Pr(n),i=Fr(n),o=Ir(n),l=W(n,`width`),u=W(n,`height`);if(l!=null&&(s=Math.max(0,l-r.left-r.right-a.width*2)),t&&i===`row`){let t=0,n=0;for(let i of e.children){let e=Ur(i,s-t);i.x=t+r.left+a.width,i.y=r.top+a.width,i.isText&&Lr(i.style)!==`left`&&(i.w=s-t),t+=e.width,t+=o,n=Math.max(n,e.height)}c=n,e.w=t-(e.children.length?o:0)}else{let t=0,n=0;for(let i of e.children){let e=Ur(i,s);i.x=r.left+a.width,i.y=t+r.top+a.width,i.isText&&Lr(i.style)!==`left`&&(i.w=s),t+=e.height,t+=o,n=Math.max(n,e.width)}c=t-(e.children.length?o:0),e.w=n}e.w=l??e.w,e.h=u??c,c=u??c}let l=r.left+r.right+a.width*2,u=r.top+r.bottom+a.width*2;return W(n,`width`)??(e.w+=l),W(n,`height`)==null&&!e.isText&&(e.h+=u),{width:e.w+i.left+i.right,height:e.h+i.top+i.bottom}}function Wr(e){let t=Or(e.style);e.x+=t.left,e.y+=t.top}function Gr(e,t,n){let r=[];return Kr(e,r,0,0),`<svg xmlns="http://www.w3.org/2000/svg" width="${t}" height="${n}" viewBox="0 0 ${t} ${n}">${r.join(``)}</svg>`}function Kr(e,t,n,r){let i=e.style,a=n+e.x,o=r+e.y,s=e.w,c=e.h;if(e.isText){let n=jr(i),r=Dr(i.color,`#000000`),c=i[`font-family`]??`sans-serif`,l=Mr(i),u=Lr(i),d=u===`center`?`middle`:u===`right`?`end`:`start`,f=u===`center`?a+s/2:u===`right`?a+s:a,p=Nr(i,n);(e.text??``).split(`
16
+ `).filter(e=>e.trim()).forEach((e,i)=>{t.push(`<text x="${f.toFixed(1)}" y="${(o+p*i+n).toFixed(1)}" font-size="${n}" font-family="${c}" font-weight="${l}" fill="${r}" text-anchor="${d}">${qr(e)}</text>`)});return}let l=Dr(i.background??i[`background-color`],e.tag===`img`?Tr:void 0),u=Ar(i),d=U(i[`border-radius`])??0,f=l&&l!==`none`;if(e.tag===`img`||f||u.width>0){let e=[`x="${a.toFixed(1)}"`,`y="${o.toFixed(1)}"`,`width="${Math.max(0,s).toFixed(1)}"`,`height="${Math.max(0,c).toFixed(1)}"`];d>0&&e.push(`rx="${d}"`),f&&e.push(`fill="${l}"`),u.width>0&&e.push(`stroke="${u.color}" stroke-width="${u.width}"`),t.push(`<rect ${e.join(` `)} />`)}for(let n of e.children)Wr(n),Kr(n,t,a,o)}function qr(e){return e.replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`).replace(/"/g,`&quot;`)}function Jr(e){let t=ae(e,{decodeEntities:!0}).children.filter(e=>h(e)),n=t.find(e=>e.tagName===`body`)??t[0];if(!n)return`<svg xmlns="http://www.w3.org/2000/svg" width="1" height="1" viewBox="0 0 1 1"></svg>`;let r=Vr(n,!0),i=Er(n.attribs.style),a=W(i,`width`),o=W(i,`height`),s=Ur(r,a??800),c=a??Math.min(s.width,1600),l=o??s.height;return r.x=0,r.y=0,a??(r.w=c),o??(r.h=l),Gr(r,c,l)}var Yr={"activity-square":`square-activity`,"alarm-check":`alarm-clock-check`,"alarm-minus":`alarm-clock-minus`,"alarm-plus":`alarm-clock-plus`,"alert-circle":`circle-alert`,"alert-octagon":`octagon-alert`,"alert-triangle":`triangle-alert`,"align-center":`text-align-center`,"align-justify":`text-align-justify`,"align-left":`text-align-start`,"align-right":`text-align-end`,angry:`face-angry`,annoyed:`face-expressionless`,"area-chart":`chart-area`,"arrow-down-01":`arrow-down-0-1`,"arrow-down-10":`arrow-down-1-0`,"arrow-down-az":`arrow-down-a-z`,"arrow-down-circle":`circle-arrow-down`,"arrow-down-left-from-circle":`circle-arrow-out-down-left`,"arrow-down-left-from-square":`square-arrow-out-down-left`,"arrow-down-left-square":`square-arrow-down-left`,"arrow-down-right-from-circle":`circle-arrow-out-down-right`,"arrow-down-right-from-square":`square-arrow-out-down-right`,"arrow-down-right-square":`square-arrow-down-right`,"arrow-down-square":`square-arrow-down`,"arrow-down-za":`arrow-down-z-a`,"arrow-left-circle":`circle-arrow-left`,"arrow-left-square":`square-arrow-left`,"arrow-right-circle":`circle-arrow-right`,"arrow-right-square":`square-arrow-right`,"arrow-up-01":`arrow-up-0-1`,"arrow-up-10":`arrow-up-1-0`,"arrow-up-az":`arrow-up-a-z`,"arrow-up-circle":`circle-arrow-up`,"arrow-up-left-from-circle":`circle-arrow-out-up-left`,"arrow-up-left-from-square":`square-arrow-out-up-left`,"arrow-up-left-square":`square-arrow-up-left`,"arrow-up-right-from-circle":`circle-arrow-out-up-right`,"arrow-up-right-from-square":`square-arrow-out-up-right`,"arrow-up-right-square":`square-arrow-up-right`,"arrow-up-square":`square-arrow-up`,"arrow-up-za":`arrow-up-z-a`,"asterisk-square":`square-asterisk`,"axis-3-d":`axis-3d`,"badge-help":`badge-question-mark`,"bar-chart":`chart-no-axes-column-increasing`,"bar-chart-2":`chart-no-axes-column`,"bar-chart-3":`chart-column`,"bar-chart-4":`chart-column-increasing`,"bar-chart-big":`chart-column-big`,"bar-chart-horizontal":`chart-bar`,"bar-chart-horizontal-big":`chart-bar-big`,"between-horizonal-end":`between-horizontal-end`,"between-horizonal-start":`between-horizontal-start`,"book-template":`book-dashed`,"box-select":`square-dashed`,"candlestick-chart":`chart-candlestick`,"check-circle":`circle-check-big`,"check-circle-2":`circle-check`,"check-square":`square-check-big`,"check-square-2":`square-check`,"chevron-down-circle":`circle-chevron-down`,"chevron-down-square":`square-chevron-down`,"chevron-left-circle":`circle-chevron-left`,"chevron-left-square":`square-chevron-left`,"chevron-right-circle":`circle-chevron-right`,"chevron-right-square":`square-chevron-right`,"chevron-up-circle":`circle-chevron-up`,"chevron-up-square":`square-chevron-up`,"circle-help":`circle-question-mark`,"circle-slashed":`circle-slash-2`,"clipboard-edit":`clipboard-pen`,"clipboard-signature":`clipboard-pen-line`,"code-2":`code-xml`,"code-square":`square-code`,columns:`columns-2`,"columns-settings":`columns-3-cog`,"contact-2":`contact-round`,"curly-braces":`braces`,"divide-circle":`circle-divide`,"divide-square":`square-divide`,"dot-square":`square-dot`,"download-cloud":`cloud-download`,edit:`square-pen`,"edit-2":`pen`,"edit-3":`pen-line`,"equal-square":`square-equal`,"file-audio":`file-headphone`,"file-audio-2":`file-headphone`,"file-axis-3-d":`file-axis-3d`,"file-badge-2":`file-badge`,"file-bar-chart":`file-chart-column-increasing`,"file-bar-chart-2":`file-chart-column`,"file-check-2":`file-check-corner`,"file-code-2":`file-code-corner`,"file-cog-2":`file-cog`,"file-edit":`file-pen`,"file-json":`file-braces`,"file-json-2":`file-braces-corner`,"file-key-2":`file-key`,"file-line-chart":`file-chart-line`,"file-lock-2":`file-lock`,"file-minus-2":`file-minus-corner`,"file-pie-chart":`file-chart-pie`,"file-plus-2":`file-plus-corner`,"file-question":`file-question-mark`,"file-search-2":`file-search-corner`,"file-signature":`file-pen-line`,"file-type-2":`file-type-corner`,"file-video":`file-play`,"file-video-2":`file-video-camera`,"file-volume-2":`file-signal`,"file-warning":`file-exclamation-point`,"file-x-2":`file-x-corner`,filter:`funnel`,"filter-x":`funnel-x`,fingerprint:`fingerprint-pattern`,"flip-horizontal":`square-centerline-dashed-horizontal`,"flip-vertical":`square-centerline-dashed-vertical`,"folder-cog-2":`folder-cog`,"folder-edit":`folder-pen`,"fork-knife":`utensils`,"fork-knife-crossed":`utensils-crossed`,"form-input":`rectangle-ellipsis`,frown:`face-slightly-frowning`,"function-square":`square-function`,"gantt-chart":`chart-no-axes-gantt`,"gantt-chart-square":`square-chart-gantt`,"gauge-circle":`circle-gauge`,"git-commit":`git-commit-horizontal`,"globe-2":`earth`,grab:`hand-grab`,grid:`grid-3x3`,"grid-2-x-2":`grid-2x2`,"grid-2-x-2-check":`grid-2x2-check`,"grid-2-x-2-plus":`grid-2x2-plus`,"grid-2-x-2-x":`grid-2x2-x`,"grid-3-x-3":`grid-3x3`,"help-circle":`circle-question-mark`,"helping-hand":`hand-helping`,history:`rotate-ccw-clock`,home:`house`,"ice-cream":`ice-cream-cone`,"ice-cream-2":`ice-cream-bowl`,indent:`list-indent-increase`,"indent-decrease":`list-indent-decrease`,"indent-increase":`list-indent-increase`,inspect:`square-mouse-pointer`,"kanban-square":`square-kanban`,"kanban-square-dashed":`square-dashed-kanban`,"laptop-2":`laptop-minimal`,laugh:`face-grinning`,"layers-3":`layers`,layout:`panels-top-left`,"letter-text":`text-initial`,"library-square":`square-library`,"line-chart":`chart-line`,"loader-2":`loader-circle`,"location-edit":`map-pin-pen`,"m-square":`square-m`,"mail-question":`mail-question-mark`,meh:`face-neutral`,"menu-square":`square-menu`,"message-circle-question":`message-circle-question-mark`,"mic-2":`mic-vocal`,"minus-circle":`circle-minus`,"minus-square":`square-minus`,"more-horizontal":`ellipsis`,"more-vertical":`ellipsis-vertical`,"mouse-pointer-square-dashed":`square-dashed-mouse-pointer`,"move-3-d":`move-3d`,outdent:`list-indent-decrease`,"paintbrush-2":`paintbrush-vertical`,palmtree:`tree-palm`,"panel-bottom-inactive":`panel-bottom-dashed`,"panel-left-inactive":`panel-left-dashed`,"panel-right-inactive":`panel-right-dashed`,"panel-top-inactive":`panel-top-dashed`,"panels-left-right":`columns-3`,"panels-top-bottom":`rows-3`,"parking-circle":`circle-parking`,"parking-circle-off":`circle-parking-off`,"parking-square":`square-parking`,"parking-square-off":`square-parking-off`,"pause-circle":`circle-pause`,"pause-octagon":`octagon-pause`,"pen-box":`square-pen`,"pen-square":`square-pen`,"percent-circle":`circle-percent`,"percent-diamond":`diamond-percent`,"percent-square":`square-percent`,"pi-square":`square-pi`,"pie-chart":`chart-pie`,"pilcrow-square":`square-pilcrow`,"play-circle":`circle-play`,"play-square":`square-play`,"plug-zap-2":`plug-zap`,"plus-circle":`circle-plus`,"plus-square":`square-plus`,podcast:`mic-signal`,"power-circle":`circle-power`,"power-square":`square-power`,"rotate-3-d":`rotate-3d`,rows:`rows-2`,"scale-3-d":`scale-3d`,"scatter-chart":`chart-scatter`,"school-2":`university`,"scissors-square":`square-scissors`,"scissors-square-dashed-bottom":`square-bottom-dashed-scissors`,"send-horizonal":`send-horizontal`,"shield-close":`shield-x`,"shield-question":`shield-question-mark`,sidebar:`panel-left`,"sidebar-close":`panel-left-close`,"sidebar-open":`panel-left-open`,"sigma-square":`square-sigma`,"slash-square":`square-slash`,sliders:`sliders-vertical`,smile:`face-slightly-smiling`,"smile-plus":`face-slightly-smiling-plus`,"sort-asc":`arrow-up-narrow-wide`,"sort-desc":`arrow-down-wide-narrow`,"split-square-horizontal":`square-split-horizontal`,"split-square-vertical":`square-split-vertical`,"square-gantt-chart":`square-chart-gantt`,stars:`sparkles`,"stop-circle":`circle-stop`,subtitles:`captions`,"table-config":`columns-3-cog`,"terminal-square":`square-terminal`,"test-tube-2":`test-tube-diagonal`,text:`text-align-start`,"text-select":`square-dashed-text`,"text-selection":`square-dashed-text`,train:`tram-front`,"tv-2":`tv-minimal`,unlock:`lock-open`,"unlock-keyhole":`lock-keyhole-open`,"upload-cloud":`cloud-upload`,"user-2":`user-round`,"user-check-2":`user-round-check`,"user-circle":`circle-user`,"user-circle-2":`circle-user-round`,"user-cog-2":`user-round-cog`,"user-minus-2":`user-round-minus`,"user-plus-2":`user-round-plus`,"user-square":`square-user`,"user-square-2":`square-user-round`,"user-x-2":`user-round-x`,"users-2":`users-round`,verified:`badge-check`,"wallet-2":`wallet-minimal`,"wand-2":`wand-sparkles`,waves:`waves-horizontal`,"wrap-text":`text-wrap`,"x-circle":`circle-x`,"x-octagon":`octagon-x`,"x-square":`square-x`},Xr=e(import.meta.url);function G(e){return e.toLowerCase().replace(/[^a-z0-9]/g,``)}var Zr=JSON.parse(n(Xr.resolve(`lucide-static/icon-nodes.json`),`utf8`)),Qr=JSON.parse(n(Xr.resolve(`lucide-static/tags.json`),`utf8`)),K=new Map;for(let[e,t]of Object.entries(Zr))K.set(e,{name:e,nodes:t,keywords:Qr[e]??[]});K.size;var $r=new Map;for(let[e,t]of Object.entries(Qr))t.forEach((t,n)=>{let r=$r.get(t)??[];r.push({name:e,idx:n}),$r.set(t,r)});var ei=new oe([...K.values()],{keys:[{name:`name`,weight:1}],threshold:.45,ignoreLocation:!0,minMatchCharLength:2,includeScore:!0});function ti(e,t){let n=0;for(;n<e.length&&n<t.length&&e[n]===t[n];)n++;return n}function ni(e){let t=e.trim().toLowerCase();if(!t)return null;if(K.has(t))return K.get(t);let n=Yr[t];if(n){let e=K.get(n);if(e)return e}let r=G(t),i=ei.search(t,{limit:8}).filter(e=>e.score<=.05||e.score<=.3&&ti(r,G(e.item.name))>=3);if(i.length)return i[0].item;let a=$r.get(t);if(a?.length){let e=a.slice().sort((e,t)=>e.idx-t.idx||G(e.name).length-G(t.name).length)[0];return K.get(e.name)??null}let o=ei.search(t,{limit:8}).filter(e=>ti(r,G(e.item.name))>=2)[0];return o?o.item:null}function ri(e,t=20){let n=e.trim();if(!n)return[];let r=new Map;K.has(n)&&r.set(n,K.get(n));let i=Yr[n];if(i&&!r.has(i)){let e=K.get(i);e&&r.set(e.name,e)}for(let{name:e}of $r.get(n)??[]){let n=K.get(e);if(n&&r.set(n.name,n),r.size>=t)break}for(let e of ei.search(n,{limit:t}))r.set(e.item.name,e.item);return[...r.values()].slice(0,t)}function ii(e,t=24,n=`#000000`,r=2){let i=e.nodes.map(([e,t])=>`<${e} ${Object.entries(t).map(([e,t])=>`${e}="${t}"`).join(` `)}/>`).join(`
8
17
  `);return[`<svg xmlns="http://www.w3.org/2000/svg"`,` width="${t}" height="${t}" viewBox="0 0 24 24"`,` fill="none" stroke="${n}" stroke-width="${r}"`,` stroke-linecap="round" stroke-linejoin="round">`,` ${i}`,`</svg>`].join(`
9
- `)}function Pn(e,t){let n=W({name:`jsd_create_nodes`,title:`创建设计节点`,description:`在画布创建节点,可递归嵌套子节点。
10
- 必填 ops 为设计指令数组,如 {"ops":[{"type":"RECTANGLE","name":"矩形","width":100,"height":100}]};节点类型(FRAME/RECTANGLE/ELLIPSE/LINE/POLYGON/STAR/VECTOR/TEXT/GROUP/BOOLEAN_OPERATION)、填充描边、placement 放置方式等结构见 inputSchema 各字段说明。
11
- 放置规则:缺省整体居中且忽略 ops 内 x/y;要按坐标摆放传 placement.mode="manual"(保留 ops 内 x/y)或 "absolute"(顶层统一坐标)。建议一次调用只建一个根节点,层级用 children 表达,子节点 x/y 相对父节点。
12
- 整页/整屏等复杂结构:先取 design-strategy prompt 的「一层只建一层 + 归组后再布局」纪律再动手,别边建边改`,method:`execute`,inputSchema:Pe,outputSchema:F,annotations:{readOnlyHint:!1,destructiveHint:!1}}),r=W({name:`jsd_create_svg`,title:`导入 SVG`,description:`将 SVG 字符串直接导入画布为可编辑图层(createNodeFromSvg 原生解析,保留路径/渐变/描边)`,method:`create_svg`,inputSchema:Fe,outputSchema:F,annotations:{readOnlyHint:!1,destructiveHint:!1},payload:({svg:e,name:t})=>({svg:e,name:t??`svg-design`})}),i=W({name:`jsd_create_icon`,title:`插入内置图标`,description:`按名称/别名/语义模糊匹配并插入 Lucide 内置图标;查无时返回候选名。默认 24px 黑色描边 2px`,inputSchema:Le,outputSchema:F,annotations:{readOnlyHint:!1,destructiveHint:!1},run:async(e,t,n)=>{let{icon:r,size:i,color:a,strokeWidth:o,name:s}=e,c=jn(r);if(!c){let e=Mn(r,8),t=e.length?`,可尝试:${e.map(e=>e.name).join(`, `)}`:``;throw Error(`未知图标:${r}${t}`)}let l=Nn(c,i??24,a??`#000000`,o??2);return t.request(`create_svg`,{svg:l,name:s??`icon-${c.name}`},{signal:n})}}),a=W({name:`jsd_html_to_design`,title:`HTML 转设计节点`,description:`将 HTML 片段转成矢量图层(SVG 保真,忽略复杂样式);需要逐节点可编辑的结构时改用 jsd_create_nodes 手工搭建`,inputSchema:Ie,outputSchema:F,annotations:{readOnlyHint:!1,destructiveHint:!1},run:async(e,t,n)=>{let{html:r,name:i}=e,a=wn(r);return t.request(`create_svg`,{svg:a,name:i??`html-design`},{signal:n})}});return[n(e,t),r(e,t),i(e,t),a(e,t)]}function Fn(e,t){let n=W({name:`jsd_manage_nodes`,title:`节点结构操作`,description:`节点结构操作,按 op 分发:select 设当前选中 | remove 删除(matchName 可再过滤) | clone 复制(右下偏移;注意克隆 COMPONENT 得到的是 INSTANCE 而非可编辑副本) | group 编组(可带 layoutMode/itemSpacing/padding* 参数) | ungroup 解组 | flatten 合并为矢量(至少 2 节点) | outline_stroke 描边转轮廓 | reparent 移到 parentId 下(缺省当前选中第一个;reparent 后坐标按新父相对系解释,需手动修正 x/y) | repair 清理已损坏节点。
13
- 属性修改用 jsd_update_node;组件/实例操作(create_component/create_instance/变体合并等)用 jsd_manage_components,两工具 op 不通用。`,method:`node_op`,inputSchema:Je,outputSchema:st,annotations:{readOnlyHint:!1,destructiveHint:!0}}),r=W({name:`jsd_manage_components`,title:`组件与实例操作`,description:`组件/实例操作,按 op 分发:
14
- create_component 建「空壳」组件(不会固化传入节点,返回全新 100×100 空组件,原节点不动)。正确流程:1) resize 空壳到目标尺寸 → 2) reparent 原 Frame 的子节点进空壳 → 3) 删除原 Frame → 4) 需要填充/圆角/阴影时再 jsd_update_node 补。顺序必须先 resize 后 reparent,否则子节点默认 SCALE 约束会被拉伸到错位(或先给子节点 constraints:{horizontal:"MIN",vertical:"MIN"})。
15
- create_instance 生成实例 | import_component 按 key 从团队库导入 | swap_component 换绑组件 | set_instance_properties 设置变体属性(可选值看节点的 variantGroupProperties) | copy_overrides 把源实例的覆盖(变体/组件属性/可见样式文本)复制为快照并缓存,返回 snapshotId(=源实例 id) | apply_overrides 按 snapshotId 把快照批量套用到目标实例(可 swapToSource,缓存 miss 会报错,需先 copy) | sync_overrides 无状态一次性「复制+套用」(不写缓存,适合 jsd_batch)。
16
- ⚠ 已知平台缺陷(实测):combine_as_variants 引擎存在内部崩溃,工具会依次尝试「克隆并入当前页 / 克隆移入当前页后合并 / 原节点直接合并(原组件会被卷入组件集)」三种姿势,全部失败时汇总报错(请附报错上报);实例不能直接合成变体,必须传 COMPONENT 节点。detach_instance 引擎报错时已内置克隆副本兜底,仍失败按报错提示操作;需要可编辑副本时也可用 jsd_create_nodes 重建。
17
- componentProperties 仅 Figma 生效;jsDesign 自动降级为变体属性+可见样式。`,method:`component_op`,inputSchema:Ye,outputSchema:ut,annotations:{readOnlyHint:!1,destructiveHint:!0}});return[n(e,t),r(e,t)]}var In={pointCount:[`POLYGON`,`STAR`],innerRadius:[`STAR`],arcData:[`ELLIPSE`],characters:[`TEXT`],fontSize:[`TEXT`],fontName:[`TEXT`],textAlignHorizontal:[`TEXT`],textAlignVertical:[`TEXT`],textAutoResize:[`TEXT`],textCase:[`TEXT`],textDecoration:[`TEXT`],lineHeight:[`TEXT`],letterSpacing:[`TEXT`],textTruncation:[`TEXT`],maxLines:[`TEXT`],layoutMode:[`FRAME`],itemSpacing:[`FRAME`],paddingTop:[`FRAME`],paddingRight:[`FRAME`],paddingBottom:[`FRAME`],paddingLeft:[`FRAME`],primaryAxisSizingMode:[`FRAME`],counterAxisSizingMode:[`FRAME`],primaryAxisAlignItems:[`FRAME`],counterAxisAlignItems:[`FRAME`],cornerRadius:[`FRAME`,`RECTANGLE`,`ELLIPSE`,`POLYGON`,`STAR`,`VECTOR`,`BOOLEAN_OPERATION`],cornerSmoothing:[`FRAME`,`RECTANGLE`,`ELLIPSE`,`POLYGON`,`STAR`,`VECTOR`,`BOOLEAN_OPERATION`],topLeftRadius:[`FRAME`,`RECTANGLE`],topRightRadius:[`FRAME`,`RECTANGLE`],bottomLeftRadius:[`FRAME`,`RECTANGLE`],bottomRightRadius:[`FRAME`,`RECTANGLE`]};function Ln(e,t){let n=W({name:`jsd_update_node`,title:`修改节点属性`,description:`按 id 批量修改节点属性(位置/尺寸/填充/文本/效果等,字段见 inputSchema,写错键名会直接报错);ids 缺省作用于当前选中;与目标节点类型不匹配的属性会被忽略并在结果中点名。结构操作(分组/删除/移动)用 jsd_manage_nodes。
18
- ⚠ 已知平台缺陷(实测):对 INSTANCE 子文字节点(Instance:<实例id>;<原id>)改 fills/fontName 时,返回回显是新值但画布/导出渲染仍是组件原样式(引擎静默丢弃);characters 内容、形状节点 strokes、文字 visible 的覆盖正常。需要实例级文字颜色/字重差异时,用静态节点重建。`,method:`update_node`,inputSchema:Ge,outputSchema:rt,annotations:{readOnlyHint:!1,destructiveHint:!1},extraContent:(e,t)=>{let n=t.ids??[],r=e.updated??[],i=[];r.length>0&&i.push({type:`text`,text:`已更新 ${r.length} 个节点`});let a=e.warnings??[];for(let e of a)i.push({type:`text`,text:`⚠ ${e}`});let o=t.props??{},s=Object.keys(o).filter(e=>o[e]!==void 0);if(r.length>0&&s.length===0)i.push({type:`text`,text:`props 为空,本次未修改任何属性`});else if(r.length>0&&s.length>0){let e=s.filter(e=>{let t=In[e];return t!=null&&!r.some(e=>e.type!=null&&t.includes(e.type))});e.length>0&&i.push({type:`text`,text:`以下属性与目标节点类型不匹配,已被忽略:${e.map(e=>`${e}(仅适用于 ${In[e].join(`/`)})`).join(`、`)}`})}if(n.length>0){let e=new Set(r.map(e=>e.id)),t=n.filter(t=>!e.has(t));t.length>0&&i.push({type:`text`,text:`以下节点未更新(可能已失效/被连坐删除): ${t.join(`, `)}。可用 jsd_find 复核后重试`})}return i}}),r=W({name:`jsd_find`,title:`查找节点`,description:`在当前页面查找节点:ids 精确匹配优先,name 模糊,type 过滤;返回序列化节点列表(最多 100 条)。大区域查询先 depth:0 拿节点清单,再按 ids/name 定向小范围查,避免大响应被截断丢尾部节点 id`,method:`find`,inputSchema:Ke,outputSchema:ot,annotations:{readOnlyHint:!0}});return[n(e,t),r(e,t)]}function Rn(e,t){return[W({name:`jsd_platform_op`,title:`平台特有操作`,description:`执行平台特有能力(Figma 变量/本地样式/组件属性等)。CRITICAL: 不要凭空猜测 op 名与参数——必须先取 jsd_ping 的 capabilities 确认当前平台支持的操作名与入参结构(随平台而异),params 随 op 而定;平台不支持时返回错误`,method:`platform_op`,inputSchema:Qe,outputSchema:Se,annotations:{readOnlyHint:!1,openWorldHint:!0}})(e,t)]}function zn(e){return[e.registerPrompt(`html-to-design`,{title:`HTML 转设计稿`,description:`把一段 HTML 转为画布节点,含保真度取舍说明`,argsSchema:i.object({html:i.string().describe(`要转换的 HTML 片段`),name:i.string().optional().describe(`生成节点的名称,默认 html-design`)})},({html:e,name:t})=>({messages:[{role:`user`,content:{type:`text`,text:`请把下面的 HTML 转成设计稿。默认走 jsd_html_to_design(SVG 保真,忽略复杂样式);需要可编辑图层时才改用 jsd_create_nodes 手工映射(容器→FRAME、文本→TEXT、图形→VECTOR)后 reparent 归组。\n\nHTML:\n\`\`\`\n${String(e)}\n\`\`\`${t==null?``:`\n节点名:${String(t)}`}`}}]})),e.registerPrompt(`icon-grid`,{title:`图标网格`,description:`批量插入 Lucide 图标并排成自动布局网格`,argsSchema:i.object({icons:i.string().describe(`图标名列表,逗号分隔,如 house,search,settings`),size:i.string().optional().describe(`单个图标边长 px 数字字符串,默认 "24"`),gap:i.string().optional().describe(`图标间距 px 数字字符串,默认 "16"`)})},({icons:e,size:t,gap:n})=>({messages:[{role:`user`,content:{type:`text`,text:`请插入图标网格:1) jsd_create_nodes 建一个 FRAME 容器;2) 每个图标各调一次 jsd_create_icon(size=${Number(t)||24});3) jsd_manage_nodes op=reparent 把全部图标移入容器;4) jsd_update_node 给容器设 auto-layout(layoutMode=HORIZONTAL,itemSpacing=${Number(n)||16},counterAxisAlignItems=CENTER)。\n图标列表: ${String(e)}`}}]})),e.registerPrompt(`script-ops`,{title:`脚本化批量调用`,description:`把多步画布操作合并为一次 ops 数组或一段宿主脚本执行,减少工具往返与上下文占用`,argsSchema:i.object({task:i.string().optional().describe(`要完成的任务描述(可选,留空只返回脚本化调用纪律)`)})},({task:e})=>({messages:[{role:`user`,content:{type:`text`,text:Bn(e==null?void 0:String(e))}}]})),e.registerPrompt(`design-strategy`,{title:`设计策略总纲`,description:`画布创作的通用纪律:先摸底、一层只建一层、语义化命名、归组后再布局、间距与字号阶梯、出错回滚,附示例结构树`,argsSchema:i.object({screen:i.string().optional().describe(`要设计的界面名称,如「登录页」;留空只返回通用纪律`)})},({screen:e})=>({messages:[{role:`assistant`,content:{type:`text`,text:Vn(e==null?void 0:String(e))}}]})),e.registerPrompt(`text-replace-strategy`,{title:`文本批量替换策略`,description:`大改文案的安全流程:clone 留底 → 按语义分块 → jsd_update_node ids 批量替换 → 逐块导小图复核`,argsSchema:i.object({rootId:i.string().optional().describe(`根节点 id;留空取当前选中`)})},({rootId:e})=>({messages:[{role:`assistant`,content:{type:`text`,text:Hn(e==null?void 0:String(e))}}]})),e.registerPrompt(`variant-sync`,{title:`同类实例样式批量同步`,description:`把一个实例的样式/文案批量套用到多个同类实例(卡片组/列表项/表单组),变体属性走组件操作`,argsSchema:i.object({sourceId:i.string().optional().describe(`源实例 id;留空取当前选中`),targetType:i.string().optional().describe(`目标实例的类型过滤,如 INSTANCE;留空按名称匹配`)})},({sourceId:e,targetType:t})=>({messages:[{role:`assistant`,content:{type:`text`,text:Un(e==null?void 0:String(e),t==null?void 0:String(t))}}]}))].map(e=>Object.assign(e,{alwaysEnabled:!0}))}function Bn(e){return`${e==null?`请按以下「脚本化」纪律调用 text-to-design 工具:`:`请用「脚本化」方式完成下面的任务:\n${e}\n\n执行要求:`}
18
+ `)}var ai={FRAME:Re,RECTANGLE:ze,ELLIPSE:Be,LINE:Ve,POLYGON:He,STAR:Ue,VECTOR:We,TEXT:Ge,GROUP:Ke,BOOLEAN_OPERATION:qe};function oi(e){let t={...ai[e].shape};return delete t.type,i.object({...t,placement:Ye.optional()}).strict()}function q(e,t){return{method:`execute`,inputSchema:oi(e),outputSchema:E,payload:t=>{let{placement:n,...r}=t,i=[{type:e,...r}];return n===void 0?{ops:i}:{ops:i,placement:n}},annotations:{readOnlyHint:!1,destructiveHint:!1,...t.annotations},...t}}var J={type:`tool`,tool:`jsd_batch`,description:`一次建多个根节点或编排后续步骤(jsd_create_nodes 已并入 jsd_batch)`};function si(e,t){let n=[q(`FRAME`,{name:`jsd_create_frame`,title:`创建 Frame 容器`,description:`创建单个 FRAME 容器节点,入参只含 FRAME 字段:width/height 尺寸、layoutMode 自动布局(itemSpacing/padding*/主轴交叉轴尺寸对齐)与填充描边等视觉字段。本工具只建一个根 FRAME;层级结构用 children 递归嵌套,子节点 x/y 相对父节点。auto-layout 前必须设 layoutMode=HORIZONTAL 或 VERTICAL(否则布局字段被忽略)。未显式传 fills 时引擎默认白底,透明容器传 fills:[{type:"SOLID",color:{r:0,g:0,b:0},opacity:0}]。建多个根节点/复杂树用 jsd_batch 编排`,followUp:J}),q(`RECTANGLE`,{name:`jsd_create_rectangle`,title:`创建矩形`,description:`创建单个 RECTANGLE 矩形节点,入参只含矩形字段:width/height 尺寸、cornerRadius 四角圆角与填充描边等视觉字段。本工具只建一个根矩形;层级结构用 children 递归嵌套,子节点 x/y 相对父节点。建多个根节点/复杂树用 jsd_batch 编排`,followUp:J}),q(`TEXT`,{name:`jsd_create_text`,title:`创建文本`,description:`创建单个 TEXT 文本节点,入参只含文本字段:characters 必填内容、fontSize/fontName 字号字体、对齐/自适应/大小写/装饰/行高/字距与填充描边。本工具只建一个根文本;层级结构用 children 递归嵌套,子节点 x/y 相对父节点。字体需精确匹配,建议先 jsd_list_fonts 查可用字体(不可用时静默回退默认)。建多个根节点/复杂树用 jsd_batch 编排`,followUp:J}),q(`ELLIPSE`,{name:`jsd_create_ellipse`,title:`创建椭圆`,description:`创建单个 ELLIPSE 椭圆节点,width/height 尺寸、arcData 环形参数(可画环)与填充描边等视觉字段。本工具只建一个根椭圆;建多个根节点/复杂树用 jsd_batch 编排`,followUp:J}),q(`LINE`,{name:`jsd_create_line`,title:`创建线段`,description:`创建单个 LINE 线段节点,width/height 尺寸与描边等视觉字段。本工具只建一个根线段;短直线段建议 LINE+rotation 布局更稳定。横线/竖线可把一维传 0:引擎 resize 校验要求 >= 0.01,插件创建时把零轴抬到 0.01 过校验(视觉是直线,序列化回读该轴仍是 0);jsd_resize_node 改尺寸同样支持零轴。建多个根节点/复杂树用 jsd_batch 编排`,followUp:J}),q(`POLYGON`,{name:`jsd_create_polygon`,title:`创建多边形`,description:`创建单个 POLYGON 多边形节点,pointCount 角点数必填(如 6=六边形)、cornerRadius 圆角与填充描边等视觉字段。本工具只建一个根多边形;建多个根节点/复杂树用 jsd_batch 编排`,followUp:J}),q(`STAR`,{name:`jsd_create_star`,title:`创建星形`,description:`创建单个 STAR 星形节点,pointCount 角点数与 innerRadius 内半径比例必填(如 5 角、0.5)、cornerRadius 圆角与填充描边等视觉字段。本工具只建一个根星形;建多个根节点/复杂树用 jsd_batch 编排`,followUp:J}),q(`VECTOR`,{name:`jsd_create_vector`,title:`创建矢量`,description:`创建单个 VECTOR 矢量节点,vectorPaths 必填(每项含 SVG path data,如 "M0 0 L100 100")与填充描边等视觉字段。本工具只建一个根矢量。⚠ 已知平台缺陷:创建后 vectorPaths 偶发丢失/形变,短直线段建议改用 LINE+rotation 更稳定。建多个根节点/复杂树用 jsd_batch 编排`,followUp:J}),q(`GROUP`,{name:`jsd_create_group`,title:`创建编组`,description:`创建单个 GROUP 编组节点,children 必填且至少 2 个子节点(内部用 Frame 实现),可带 auto-layout 布局字段(layoutMode/itemSpacing/padding*)。本工具只建一个根编组;要固定坐标的根层级用 placement 控制。建多个根节点/复杂树用 jsd_batch 编排`,followUp:J}),q(`BOOLEAN_OPERATION`,{name:`jsd_create_boolean_operation`,title:`创建布尔运算节点`,description:`创建单个 BOOLEAN_OPERATION 布尔运算节点,booleanOperation 运算方式(UNION/SUBTRACT/INTERSECT/EXCLUDE)与 children 必填且至少 2 个合并子节点。本工具只建一个根布尔节点;建多个根节点/复杂树用 jsd_batch 编排`,followUp:J})],r=B({name:`jsd_create_svg`,title:`导入 SVG`,description:`将 SVG 字符串直接导入画布为可编辑图层(createNodeFromSvg 原生解析,保留路径/渐变/描边)。建多个根节点/复杂树用 jsd_batch 编排`,method:`create_svg`,inputSchema:Xe,outputSchema:E,annotations:{readOnlyHint:!1,destructiveHint:!1},payload:({svg:e,name:t})=>({svg:e,name:t??`svg-design`}),followUp:J}),i=B({name:`jsd_create_icon`,title:`插入内置图标`,description:`按名称/别名/语义模糊匹配并插入 Lucide 内置图标;查无时返回候选名。默认 24px 黑色描边 2px。建多个根节点/复杂树用 jsd_batch 编排`,inputSchema:Qe,outputSchema:E,annotations:{readOnlyHint:!1,destructiveHint:!1},run:async(e,t,n)=>{let{icon:r,size:i,color:a,strokeWidth:o,name:s}=e,c=ni(r);if(!c){let e=ri(r,8),t=e.length?`,可尝试:${e.map(e=>e.name).join(`, `)}`:``;throw Error(`未知图标:${r}${t}`)}let l=ii(c,i??24,a??`#000000`,o??2);return t.request(`create_svg`,{svg:l,name:s??`icon-${c.name}`},{signal:n})},followUp:J}),a=B({name:`jsd_html_to_design`,title:`HTML 转设计节点`,description:`将 HTML 片段转成矢量图层(SVG 保真,忽略复杂样式);需要逐节点可编辑的结构时改用 jsd_create_rectangle / jsd_create_text 等手工搭建后再 jsd_batch 编排`,inputSchema:Ze,outputSchema:E,annotations:{readOnlyHint:!1,destructiveHint:!1},run:async(e,t,n)=>{let{html:r,name:i}=e,a=Jr(r);return t.request(`create_svg`,{svg:a,name:i??`html-design`},{signal:n})},followUp:J});return[...n.map(n=>B(n)(e,t)),r(e,t),i(e,t),a(e,t)]}function ci(e,t){let n=B({name:`jsd_manage_nodes`,title:`节点结构操作(聚合)`,description:`按 op 分发的节点结构操作聚合入口:select|remove|clone|group|ungroup|flatten|outline_stroke|reparent|repair。单次单操作请优先用对应小工具:jsd_select_nodes / jsd_delete_node / jsd_clone_node / jsd_group_nodes / jsd_ungroup_nodes / jsd_flatten_nodes / jsd_outline_stroke / jsd_reparent_nodes / jsd_repair_nodes(描述含平台缺陷与正确流程)。属性修改用 jsd_set_* 系列(含 jsd_set_shape);组件/实例操作用 jsd_manage_components 或 jsd_create_component / jsd_sync_overrides 等,两工具 op 不通用。
19
+ 各 op 的返回键(在 jsd_batch 里用占位符引用时才不会写错,写错会中止整批):select→selected[](id 字符串)、remove→removed[](id 字符串)、clone/group/flatten/outline_stroke→created[]、ungroup→ungrouped[](id 字符串)、reparent→moved[](同时附 updated[],两者同一份数组)、repair→cleaned[](id 字符串)。id 字符串数组取 {{步骤id.selected[0]}},节点数组取 {{步骤id.created[0].id}}。`,method:`node_op`,inputSchema:tt,outputSchema:mt,annotations:{readOnlyHint:!1,destructiveHint:!0},followUp:{type:`tool`,tool:`jsd_set_layout`,description:`结构改完后设置容器自动布局`}}),r=B({name:`jsd_manage_components`,title:`组件与实例操作(聚合)`,description:`按 op 分发的组件/实例操作聚合入口:create_component|create_instance|detach_instance|import_component|swap_component|set_instance_properties|combine_as_variants|copy_overrides|apply_overrides|sync_overrides。单次单操作请优先用对应小工具:jsd_create_component / jsd_create_instance / jsd_detach_instance / jsd_import_component / jsd_swap_component / jsd_set_instance_properties / jsd_combine_as_variants / jsd_copy_overrides / jsd_apply_overrides / jsd_sync_overrides(描述含平台缺陷与正确流程)。节点结构操作用 jsd_manage_nodes,两工具 op 不通用`,method:`component_op`,inputSchema:nt,outputSchema:_t,annotations:{readOnlyHint:!1,destructiveHint:!0},followUp:{type:`tool`,tool:`jsd_set_instance_properties`,description:`组件/实例改完后设置变体属性`}});return[n(e,t),r(e,t)]}function li(e,t){return[B({name:`jsd_find`,title:`查找节点`,description:"在当前页面查找节点:ids 精确匹配优先,name 模糊,type 过滤;返回序列化节点列表(最多 100 条)。⚠ 每个节点带 `z` = 它在父级 children 里的下标 = **绘制顺序**(0 = 最底层,越大越靠上);判断遮挡/层序读 z 即可,children 数组顺序与 z 一致。大区域查询先 depth:0 拿节点清单,再按 ids/name 定向小范围查,避免大响应被截断丢尾部节点 id",method:`find`,inputSchema:$e,outputSchema:pt,annotations:{readOnlyHint:!0},followUp:{type:`tool`,tool:`jsd_select_nodes`,description:`把查到的节点设为当前选中,便于后续修改/删除`}})(e,t)]}function Y(e,t){return{method:`node_op`,outputSchema:mt,payload:t=>({op:e,...t}),...t}}function ui(e,t){return[Y(`select`,{name:`jsd_select_nodes`,title:`设置画布选中`,description:`把指定节点设为当前选中,后续不传 ids 的工具会作用于它们。只读类工具(jsd_get_selection/jsd_find)不用它——那些工具直接接受 ids`,inputSchema:Et,followUp:{type:`tool`,tool:`jsd_move_node`,description:`选中后移动/调整选中节点`}}),Y(`remove`,{name:`jsd_delete_node`,title:`删除节点`,description:`删除节点(破坏性,仅编辑器 undo 可回退)。ids 缺省删当前选中;matchName 可在范围内再按 name 精确过滤。多个删除动作建议用 jsd_batch 串起来`,inputSchema:Dt,annotations:{readOnlyHint:!1,destructiveHint:!0},followUp:{type:`tool`,tool:`jsd_find`,description:`删除后复核剩余节点`}}),Y(`clone`,{name:`jsd_clone_node`,title:`复制节点`,description:`复制节点,新副本右下偏移放置并返回新 id。注意:克隆 COMPONENT 得到的是 INSTANCE,不是可编辑副本;文本批量替换前先用它留安全底稿`,inputSchema:Ot,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_move_node`,description:`把副本移到目标位置`}}),Y(`group`,{name:`jsd_group_nodes`,title:`编组节点`,description:`把多个节点编组(内部用 Frame 实现),可同时设置 auto-layout(layoutMode/itemSpacing/padding*/主轴对齐);只归组不排布时 layoutMode=NONE。复杂结构建议先用 per-type create 工具(jsd_create_frame 等)平铺建好再编组`,inputSchema:kt,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_set_layout`,description:`编组后设置组内自动布局`}}),Y(`ungroup`,{name:`jsd_ungroup_nodes`,title:`解组节点`,description:`解散分组,子节点回到原父节点下(坐标变为相对新父,可能需要重新摆位)`,inputSchema:At,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_move_node`,description:`解组后调整子节点位置`}}),Y(`flatten`,{name:`jsd_flatten_nodes`,title:`合并为矢量`,description:`把至少 2 个节点合并为单一矢量(破坏性,原节点层级消失),常用于把文本/图标烘焙成不可编辑图形`,inputSchema:jt,annotations:{readOnlyHint:!1,destructiveHint:!0},followUp:{type:`tool`,tool:`jsd_set_fill_color`,description:`烘焙后设置合并图形的填充`}}),Y(`outline_stroke`,{name:`jsd_outline_stroke`,title:`描边转轮廓`,description:`把描边转成轮廓矢量(几何被烘焙,原描边属性不再可改)。改描边颜色/宽度请用 jsd_set_stroke`,inputSchema:Mt,annotations:{readOnlyHint:!1,destructiveHint:!0},followUp:{type:`tool`,tool:`jsd_set_stroke`,description:`调整新轮廓的描边`}}),Y(`reparent`,{name:`jsd_reparent_nodes`,title:`移动节点到父节点下`,description:`把节点移入 parentId 成为其子节点,可指定插入位置。⚠ **parentId 请显式传**:缺省值取「当前选中里第一个不是被移动节点的节点」——当前选中为空或不含父容器时该值不可靠(会报「没有找到目标父节点」,或把节点误移进另一个被选中的节点下)。需要依赖缺省时的两种姿势:①先 jsd_select_nodes 选中目标容器;②只调层序 → 传 index 且 ids 里含被调整节点本身,此时缺省父级 = 该节点的原父级。⚠ 层序语义:index 是 children 数组下标(0 = 最底层),children 顺序即绘制顺序(末位 = 最上层),序列化里对应字段是 z —— 判断遮挡读 z,调层序就用本工具 + index。节点已在该父级下时本工具只调层序,x/y 不变;auto-layout 容器同样支持(index 会在内部临时关掉布局插入再恢复),若引擎没落位会明确报错并提示改 itemSpacing / 对齐。⚠ **跨父级移动保持节点绝对位置**:内部按页面系记账(移动前取绝对原点,移动后换算成新父下的 x/y),不要再按「相对系重新解释」手动摆回 —— 那会把节点推走。唯一例外是移入 auto-layout 容器:位置由布局接管,写 x/y 无效,想调排布改 itemSpacing / 对齐。确需手工定位(按坐标排布等)时用 jsd_resize_node 传 x/y(可与 width/height 一次改完)或 jsd_move_node`,inputSchema:Nt,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_move_node`,description:`移动后按需微调新父下的 x/y(绝对位置已自动保持)`}}),Y(`repair`,{name:`jsd_repair_nodes`,title:`清理损坏节点`,description:`清理已损坏节点(破坏性)。ids 缺省时清理当前页全部损坏节点;批量删除后报「没找到 X 节点」时先复核 jsd_find 再修`,inputSchema:Pt,annotations:{readOnlyHint:!1,destructiveHint:!0},followUp:{type:`tool`,tool:`jsd_find`,description:`清理后复核页面节点状态`}})].map(n=>B(n)(e,t))}function di(e,t){return[B({name:`jsd_platform_op`,title:`平台特有操作`,description:`执行平台特有能力(Figma 变量/本地样式/组件属性等)。CRITICAL: 不要凭空猜测 op 名与参数——必须先取 jsd_ping 的 capabilities 确认当前平台支持的操作名与入参结构(随平台而异),params 随 op 而定;平台不支持时返回错误`,method:`platform_op`,inputSchema:at,outputSchema:Pe,annotations:{readOnlyHint:!1,openWorldHint:!0},followUp:{type:`tool`,tool:`jsd_get_selection`,description:`复核平台操作在画布上的效果`}})(e,t)]}function fi(e){return[e.registerPrompt(`html-to-design`,{title:`HTML 转设计稿`,description:`把一段 HTML 转为画布节点,含保真度取舍说明`,argsSchema:i.object({html:i.string().describe(`要转换的 HTML 片段`),name:i.string().optional().describe(`生成节点的名称,默认 html-design`)})},({html:e,name:t})=>({messages:[{role:`user`,content:{type:`text`,text:`请把下面的 HTML 转成设计稿。默认走 jsd_html_to_design(SVG 保真,忽略复杂样式);需要可编辑图层时才改用 per-type create 工具(jsd_create_frame 等)手工映射(容器→FRAME、文本→TEXT、图形→VECTOR)后 reparent 归组。\n\nHTML:\n\`\`\`\n${String(e)}\n\`\`\`${t==null?``:`\n节点名:${String(t)}`}`}}]})),e.registerPrompt(`icon-grid`,{title:`图标网格`,description:`批量插入 Lucide 图标并排成自动布局网格`,argsSchema:i.object({icons:i.string().describe(`图标名列表,逗号分隔,如 house,search,settings`),size:i.string().optional().describe(`单个图标边长 px 数字字符串,默认 "24"`),gap:i.string().optional().describe(`图标间距 px 数字字符串,默认 "16"`)})},({icons:e,size:t,gap:n})=>({messages:[{role:`user`,content:{type:`text`,text:`请插入图标网格:1) jsd_create_frame 建一个 FRAME 容器;2) 每个图标各调一次 jsd_create_icon(size=${Number(t)||24});3) jsd_reparent_nodes 把全部图标移入容器;4) jsd_set_layout 给容器设 auto-layout(layoutMode=HORIZONTAL,itemSpacing=${Number(n)||16},counterAxisAlignItems=CENTER)。\n图标列表: ${String(e)}`}}]})),e.registerPrompt(`script-ops`,{title:`脚本化批量调用`,description:`把多步画布操作合并为一次 ops 数组或一段宿主脚本执行,减少工具往返与上下文占用`,argsSchema:i.object({task:i.string().optional().describe(`要完成的任务描述(可选,留空只返回脚本化调用纪律)`)})},({task:e})=>({messages:[{role:`user`,content:{type:`text`,text:pi(e==null?void 0:String(e))}}]})),e.registerPrompt(`design-strategy`,{title:`设计策略总纲`,description:`画布创作的通用纪律:先摸底、一层只建一层、语义化命名、归组后再布局、间距与字号阶梯、出错回滚,附示例结构树`,argsSchema:i.object({screen:i.string().optional().describe(`要设计的界面名称,如「登录页」;留空只返回通用纪律`)})},({screen:e})=>({messages:[{role:`assistant`,content:{type:`text`,text:mi(e==null?void 0:String(e))}}]})),e.registerPrompt(`text-replace-strategy`,{title:`文本批量替换策略`,description:`大改文案的安全流程:jsd_clone_node 留底 → 按语义分块 → jsd_set_text ids 批量替换 → 逐块导小图复核`,argsSchema:i.object({rootId:i.string().optional().describe(`根节点 id;留空取当前选中`)})},({rootId:e})=>({messages:[{role:`assistant`,content:{type:`text`,text:hi(e==null?void 0:String(e))}}]})),e.registerPrompt(`variant-sync`,{title:`同类实例样式批量同步`,description:`把一个实例的样式/文案批量套用到多个同类实例(卡片组/列表项/表单组),变体属性走组件操作`,argsSchema:i.object({sourceId:i.string().optional().describe(`源实例 id;留空取当前选中`),targetType:i.string().optional().describe(`目标实例的类型过滤,如 INSTANCE;留空按名称匹配`)})},({sourceId:e,targetType:t})=>({messages:[{role:`assistant`,content:{type:`text`,text:gi(e==null?void 0:String(e),t==null?void 0:String(t))}}]}))].map(e=>Object.assign(e,{alwaysEnabled:!0}))}function pi(e){return`${e==null?`请按以下「脚本化」纪律调用 text-to-design 工具:`:`请用「脚本化」方式完成下面的任务:\n${e}\n\n执行要求:`}
19
20
  1) 多步流程一次成型:优先 jsd_batch 编排(create→reparent→update、find→批量修改、图标×N 等);宿主有代码执行工具时也可写一段脚本连续 await 多个 tools.jsd_*。
20
21
  2) 中间值只在管道内流动:上游结果用双花括号占位符(步骤id.字段路径)注入下游参数(脚本内用变量传递);每步只提取后续需要的字段,不回传完整序列化结果。
21
- 3) 收敛:最后只做一次 jsd_get_selection(depth=1) 总复核,不要每步都复核。`}function Vn(e){return`# 画布创作纪律
22
+ 3) 收敛:最后只做一次 jsd_get_selection(depth=1) 总复核,不要每步都复核。`}function mi(e){return`# 画布创作纪律
22
23
 
23
24
  1) 先摸底再动手:jsd_get_selection(depth=2) 看现状(名称/类型/尺寸/填充/子结构),已有节点用 jsd_find 精确定位,不要重复创建同名元素。
24
- 2) 一层只建一层:每个界面先建主容器 FRAME,再分区放内容。复杂结构用 jsd_create_nodes 一次平铺建完,不要用 children 深嵌套(易整体失败)。
25
+ 2) 一层只建一层:每个界面先建主容器 FRAME,再分区放内容。复杂结构用 jsd_batch 编排多个 per-type create 步骤一次建完,不要用 children 深嵌套(易整体失败)。
25
26
  3) 命名语义化:用「登录页 / Logo 容器 / 邮箱输入 / 主按钮」这类说明用途的名字,不用「矩形 1」「Frame 2」;同一批元素命名风格保持一致。
26
- 4) 归组后再布局:jsd_manage_nodes op=reparent 把文本等元素移入目标容器;auto-layout(layoutMode/itemSpacing/padding*/primaryAxisAlignItems 等)最后用 jsd_update_node 单独设,别在建节点时混着传。
27
+ 4) 归组后再布局:jsd_reparent_nodes 把文本等元素移入目标容器(**parentId 显式传容器 id**,别依赖「当前选中第一个」的缺省值;跨父级移动会保持节点绝对位置,不用手动摆回 x/y,移入 auto-layout 容器时位置交给布局);auto-layout(layoutMode/itemSpacing/padding*/primaryAxisAlignItems 等)最后用 jsd_set_layout 单独设,别在建节点时混着传。
27
28
  5) 间距与字号阶梯:主标题 > 正文标签 > 按钮文本 > 辅助说明;同级元素间距一致,用 itemSpacing 统一控制,不靠手调坐标凑。
28
29
  6) 视觉顺序:自上而下按阅读顺序排布,主操作按钮放在输入项之后,次要链接(忘记密码/注册)放最后。
29
- 7) 出错回滚:ok=false 或「没找到 X 节点」→ jsd_find 复核 id 是否已失效(可能被连坐删除),必要时 jsd_manage_nodes op=repair 清理后重试。
30
- 8) 收敛复核:整批做完只做一次 jsd_get_selection(depth=1),或 jsd_export({ids:[要看的节点id], scale:0.5}) 导小图看效果(ids 为必填数组);不要每步都读一遍。
30
+ 7) 层序与遮挡:序列化里每个节点都带 \`z\`(= 父级 children 下标 = 绘制顺序,0 = 最底层,越大越靠上),判断谁压谁直接读 z。要调层序用 jsd_reparent_nodes + index(= 目标 z);auto-layout 容器同样支持,若引擎没落位会明确报错,那就改 itemSpacing / 对齐。别靠「新建一个节点压上去」改遮挡。
31
+ 8) 样式落点:纯描边图形只传 strokes 就行(fills 会被自动置空,不会变灰块);批量刷色给 ids + recursive(recursive 只作用于后代,容器自己不会被套上方框,要给容器也上色才传 includeSelf=true);实例子节点(位于 INSTANCE 内)的样式覆盖不保证渲染生效 —— 命中时结果的 warnings 会直接给出主组件里对应子节点的 id,改主组件即所有实例继承,只要单实例不同就先 jsd_detach_instance。多状态组件只能用「多主件」实现:每个状态各做一个 COMPONENT 并按「族名 / 状态」命名(如 Nav / Inbox、Nav / Me),别指望变体集(jsd_combine_as_variants 在本引擎必然失败)或「一个主件 + 每屏改子节点颜色」(实例子节点样式 override 不生效)。
32
+ 9) 批量回显都做了摘要裁剪(jsd_batch 的节点只留 id/name/type/x/y):含图标/矢量克隆的批次要另配一次 jsd_export 目视验收,别拿回显当验收证据。
33
+ 10) 出错回滚:ok=false 或「没找到 X 节点」→ jsd_find 复核 id 是否已失效(可能被连坐删除),必要时 jsd_repair_nodes 清理后重试。含删除/移父的批次务必读结果 warnings —— 引擎会把没碰到的兄弟节点静默挪走(同层几何漂移),照 warnings 给的原值回填,别把它当样式问题排查。
34
+ 11) 收敛复核:整批做完只做一次 jsd_get_selection(depth=1),或 jsd_export({ids:[要看的节点id], scale:0.5}) 导小图看效果(ids 为必填数组);**关键视觉改动靠导图目检,回显不等于生效**,不要每步都读一遍。
31
35
 
32
36
  示例结构(登录页):
33
37
  - 登录页(FRAME)
@@ -39,17 +43,17 @@ componentProperties 仅 Figma 生效;jsDesign 自动降级为变体属性+可见
39
43
  - 主按钮(FRAME + TEXT)
40
44
  - 辅助链接(FRAME:忘记密码 TEXT + 注册 TEXT)
41
45
 
42
- ${e==null?`当前设计`:`「${e}」`}按这条链走;多步合并时优先用 jsd_batch 编排,中间 id 不回传模型。`}function Hn(e){return`# 文本批量替换
46
+ ${e==null?`当前设计`:`「${e}」`}按这条链走;多步合并时优先用 jsd_batch 编排,中间 id 不回传模型。`}function hi(e){return`# 文本批量替换
43
47
 
44
48
  ## 1. 摸底与分块
45
49
  - 对 ${e==null?`当前选中(先用 jsd_get_selection 拿到根 id)`:`节点 ${e}`} 先 jsd_get_selection 看结构,按语义把文本分成几块:表格按行或列、卡片按「同名字段一组」、表单按「标签 + 输入」一组、导航按菜单项一组。
46
- - 不按坐标硬切;语义相关的文本应同批处理,这样一次 jsd_update_node 就能覆盖一整块。
50
+ - 不按坐标硬切;语义相关的文本应同批处理,这样一次 jsd_set_text 就能覆盖一整块。
47
51
 
48
52
  ## 2. 先留安全副本
49
- - jsd_manage_nodes op=clone 复制一份原文案版本。确认改完没问题再删(或重命名为「原文案备份」留档)。
53
+ - jsd_clone_node 复制一份原文案版本。确认改完没问题再删(或 jsd_rename_node 重命名为「原文案备份」留档)。
50
54
 
51
55
  ## 3. 分块批量替换
52
- - 每块一次 jsd_update_node:ids 传该块全部文本节点 id,逐条改 characters;需要时连带 fontSize/lineHeight 一起调,避免改完溢出容器。
56
+ - 每块一次 jsd_set_text:ids 传该块全部文本节点 id,逐条改 characters;需要时连带 fontSize/lineHeight 一起调,避免改完溢出容器。
53
57
  - ids 来自上一步查询时,用 jsd_batch 的 {{步骤id.字段路径}} 占位符直接串起来,中间 id 不回传模型。
54
58
 
55
59
  ## 4. 逐块复核
@@ -57,7 +61,7 @@ ${e==null?`当前设计`:`「${e}」`}按这条链走;多步合并时优先用 j
57
61
  - 有问题先修当前块再继续下一块,不要把所有错误攒到最后。
58
62
 
59
63
  ## 5. 收尾
60
- - 全部完成后只做一次 jsd_get_selection(depth=1) 总复核,并清理临时副本。`}function Un(e,t){return`# 同类实例样式批量同步
64
+ - 全部完成后只做一次 jsd_get_selection(depth=1) 总复核,并清理临时副本。`}function gi(e,t){return`# 同类实例样式批量同步
61
65
 
62
66
  ## 适用场景
63
67
  把一个实例的样式/文案套用到多个同类实例(卡片组、列表项、表单组……),避免逐个手改。
@@ -66,15 +70,18 @@ ${e==null?`当前设计`:`「${e}」`}按这条链走;多步合并时优先用 j
66
70
  - 对 ${e==null?`当前选中(先 jsd_get_selection 确认)`:`节点 ${e}`} 用 jsd_get_selection(depth=2) 确认它是可复用的 INSTANCE,并记录源 id。
67
71
 
68
72
  ## 2. 定位目标实例
69
- - jsd_find(${t==null?`按名称匹配目标实例`:`type=${t} 过滤目标实例`}) 拿到全部目标实例 id;缺的实例用 jsd_manage_components op=create_instance 补建。
73
+ - jsd_find(${t==null?`按名称匹配目标实例`:`type=${t} 过滤目标实例`}) 拿到全部目标实例 id;缺的实例用 jsd_create_instance 补建。
70
74
 
71
75
  ## 3. 批量套用(优先引擎级)
72
- - 首选 jsd_manage_components op=sync_overrides:sourceId=源实例 id,ids=全部目标 id,一次完成「复制+套用」(自动同步变体/组件属性/可见样式文本,不动位置)。
73
- - 需要先审后套或多次套用同一快照时,用两段式:先 op=copy_overrides(sourceId) 拿到 snapshotId,再 op=apply_overrides(sourceId, ids) 批量套用(可加 swapToSource=true 把目标换绑成源组件)。
74
- - 引擎不支持时再退化为手工:jsd_update_node ids=[目标] 填字段 + jsd_manage_components op=set_instance_properties 设变体值。
76
+ - 首选 jsd_sync_overrides:sourceId=源实例 id,ids=全部目标 id,一次完成「复制+套用」(自动同步变体/组件属性/可见样式文本,不动位置)。
77
+ - 需要先审后套或多次套用同一快照时,用两段式:先 jsd_copy_overrides(sourceId) 拿到 snapshotId,再 jsd_apply_overrides(sourceId, ids) 批量套用(可加 swapToSource=true 把目标换绑成源组件)。
78
+ - 引擎不支持时再退化为手工:jsd_set_fill_color / jsd_set_text 等 ids=[目标] 填字段 + jsd_set_instance_properties 设变体值。
75
79
 
76
80
  ## 4. 复核
77
- - jsd_export({ids:[抽查节点id], scale=0.5}) 抽查一张,确认间距与层级没被撑乱;再 jsd_get_selection(depth=1) 总复核。`}function Wn(e,t){let i=W({name:`jsd_export`,title:`导出节点为图片`,description:`导出节点为 PNG/JPG/SVG/PDF;ids 为必填数组(单节点也写成 ids:["123:456"],不是 nodeId),savePath 落盘与 includeDataUrl 返回 base64 可并存。完整字段见 inputSchema。`,inputSchema:Xe,outputSchema:dt,annotations:{readOnlyHint:!1,destructiveHint:!1},timeout:se,run:async(e,t,n)=>{let{ids:i,format:a,scale:o,savePath:s,includeDataUrl:c}=e,l=(await t.request(`export`,{ids:i,format:a,scale:o},{signal:n,timeout:6e4})).exports??{},u=[];for(let[e,t]of Object.entries(l)){let n=t.bytes,i=t.mimeType,a={id:e,name:t.name,format:t.format,mimeType:i,size:n.byteLength};s&&(r(s,n),a.path=s),c&&(a.dataUrl=`data:${i};base64,${n.toString(`base64`)}`),u.push(a)}return{exports:u}},extraContent:(e,t)=>{let n=t.ids??[],r=e.exports??[],i=[];if(r.length>0&&i.push({type:`text`,text:`已导出 ${r.length} 个节点`}),n.length>0){let e=new Set(r.map(e=>e.id)),t=n.filter(t=>!e.has(t));t.length>0&&i.push({type:`text`,text:`导出失败(节点可能已失效): ${t.join(`, `)}。可用 jsd_find 复核`})}return i}}),a=W({name:`jsd_fill_image`,title:`本地图片填充节点`,description:`读取本地图片文件填充到指定节点(IMAGE fill)`,inputSchema:Ze,outputSchema:rt,annotations:{readOnlyHint:!1,destructiveHint:!1},timeout:se,run:async(e,t,r)=>{let{ids:i,sourcePath:a}=e,o;try{o=n(a)}catch(e){throw Error(`读取文件失败: ${e instanceof Error?e.message:String(e)}`)}return t.request(`fill_image`,{ids:i,bytes:new Uint8Array(o)},{signal:r,timeout:se})}}),o=W({name:`jsd_list_fonts`,title:`列出可用字体`,description:`列出当前环境可用字体族`,method:`list_fonts`,outputSchema:ft,annotations:{readOnlyHint:!0}});return[i(e,t),a(e,t),o(e,t)]}function Z(e,t){return{contents:[{uri:typeof e==`string`?e:e.href,mimeType:`application/json`,text:JSON.stringify(t,null,2)}]}}function Gn(e,t){return[e.registerResource(`canvas-selection`,`jsd://canvas/selection`,{title:`画布当前选中`,description:`当前选中节点的序列化树(含直接子节点),实时从插件读取;等价于 jsd_get_selection depth=2`,mimeType:`application/json`},async()=>Z(`jsd://canvas/selection`,await t.request(`get_selection`,{depth:2}))),e.registerResource(`fonts`,`jsd://fonts`,{title:`可用字体列表`,description:`当前环境可用的字体族列表,实时从插件读取`,mimeType:`application/json`},async()=>Z(`jsd://fonts`,await t.request(`list_fonts`,{}))),e.registerResource(`styles`,`jsd://styles`,{title:`本地样式列表`,description:`当前文档可复用的本地样式(PAINT/TEXT/EFFECT/GRID),含 id/name/type;按名应用样式前先读这里拿准确样式名`,mimeType:`application/json`},async()=>Z(`jsd://styles`,await t.request(`list_styles`,{}))),e.registerResource(`page`,`jsd://page`,{title:`当前页结构总览`,description:`当前页顶层节点的轻量摘要(名称/类型/位置/尺寸/子节点数),不递归;从头设计整页前先读这里看页面已有内容`,mimeType:`application/json`},async()=>Z(`jsd://page`,await t.request(`get_page`,{}))),e.registerResource(`node`,new d(`jsd://node/{id}`,{list:void 0}),{title:`节点详情`,description:`按 id 读取节点的序列化结构,如 jsd://node/12:3;等价于 jsd_find ids 精确查找`,mimeType:`application/json`},async(e,n)=>{let r=n.id,i=Array.isArray(r)?r[0]:r;if(!i)throw Error(`缺少节点 id: ${e.href}`);return Z(e,await t.request(`find`,{ids:[i]}))})]}function Kn(e,t){let n=W({name:`jsd_ping`,title:`检查 ${C.runtime} 插件连接`,description:`检查插件是否在线(需先启动 ${C.runtime} 插件并保持运行)`,outputSchema:it,annotations:{readOnlyHint:!0},alwaysEnabled:!0,timeout:oe,run:async()=>{try{let e=await t.request(`ping`,{},{timeout:oe});return{connected:!0,platform:e?.platform,capabilities:e?.capabilities}}catch(e){return{connected:!1,error:e instanceof Error?e.message:String(e)}}}}),r=W({name:`jsd_get_selection`,title:`读取画布选中`,description:`获取画布当前选中节点的序列化树(名称/类型/尺寸/位置/填充/子结构);depth 控制层级深度,默认 2`,method:`get_selection`,outputSchema:at,annotations:{readOnlyHint:!0}});return[n(e,t),r(e,t)]}var qn=[Kn,Pn,Ln,Fn,Wn,Qt,Rn,Gn,e=>zn(e)],Jn=`操作设计画布的工具集。调用纪律:
78
- - 复杂结构先用 jsd_create_nodes 平铺创建完整 ops 数组(children 深嵌套易失败),再 jsd_manage_nodes op=reparent 归组;auto-layout(layoutMode/itemSpacing/padding* 等)最后用 jsd_update_node 单独设置。
79
- - 跨工具多步流程用 jsd_batch 编排:双花括号占位符(步骤id.字段路径)引用上步结果,中间 id 不回传模型。
80
- - ok=false 或「没找到 X 节点」:先 jsd_find 复核 id 是否已失效(可能被连坐删除),必要时 jsd_manage_nodes op=repair 清理后重试。`,Q=new Set;function Yn(e,t){for(let n of e.handles)n.alwaysEnabled||(t?n.enable():n.disable())}function Xn(e){for(let t of Q){Yn(t,e);try{t.server.sendToolListChanged()}catch{}}L(`工具可用性同步: ${e?`上线`:`离线`}(会话数 ${Q.size})`)}function Zn(e){let t=new u({name:x,version:S},{supportedProtocolVersions:[`2026-07-28`,...f],instructions:Jn}),n=[];for(let r of qn)n.push(...r(t,e));let r={server:t,handles:n};Q.add(r),Yn(r,e.isConnected);let i=t.server,a=i.onclose;return i.onclose=()=>{Q.delete(r),a?.()},t}async function Qn(e){await e.start(y),L(`daemon: 插件 WS ws://localhost:${e.port}`);let t=p(()=>Zn(e)),n=g(t),r=m(),i=h(),o=null,s=n=>{L(`daemon 退出: ${n}`),t.close(),e.stop(),o?.close(),process.exit(0)};await new Promise((e,t)=>{o=a((e,t)=>{if(!r(e,t)||!i(e,t))return;let a=Date.now(),o=e.url??``;if(t.on(`finish`,()=>{let n=`HTTP ${e.method} ${o} → ${t.statusCode} (${Date.now()-a}ms)`;t.statusCode>=400?L(n):R(n)}),e.method===`GET`&&o===`/health`){t.writeHead(200,{"content-type":`application/json`}),t.end(JSON.stringify({name:x,version:S,pid:process.pid}));return}if(e.method===`POST`&&o===`/shutdown`){t.writeHead(200,{"content-type":`application/json`}),t.end(JSON.stringify({ok:!0})),setTimeout(()=>s(`收到 /shutdown 请求`),100);return}n(e,t)}),o.once(`error`,t),o.listen(b,`127.0.0.1`,()=>e())}),L(`daemon: MCP HTTP http://127.0.0.1:${b}/mcp`),L(`daemon 就绪,常驻运行(更新时由版本自检自动替换)`),process.on(`SIGINT`,()=>s(`SIGINT`))}async function $n(){let e=await V();if(e.state===`foreign`)B(`端口 ${b} 被非 text-to-design MCP 服务占用,请先释放`),process.exit(1);else if(e.state===`proxy`){await Lt(e.client);return}L(`未发现 daemon,自动拉起...`),At();let t=Date.now()+ae;for(;Date.now()<t;){await H(250);let e=await V();if(e.state===`proxy`){await Lt(e.client);return}e.state===`foreign`&&(B(`端口 ${b} 被非 text-to-design MCP 服务占用,请先释放`),process.exit(1))}B(`daemon 启动超时(${ae/1e3}s),请检查残留进程后重试`),process.exit(1)}var $=new wt;$.onConnectionChange=Xn,vt((e,t)=>$.notifyLog(e,t)),process.env.TEXT_TO_DESIGN_MCP_ROLE===`daemon`||process.argv.includes(`daemon`)?Qn($).catch(e=>{$.stop(),B(`daemon 启动失败: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}):$n().catch(e=>{B(`shim 启动失败: ${e instanceof Error?e.message:String(e)}`),process.exit(1)});export{};
81
+ - jsd_export({ids:[抽查节点id], scale=0.5}) 抽查一张,确认间距与层级没被撑乱;再 jsd_get_selection(depth=1) 总复核。`}var _i={pointCount:[`POLYGON`,`STAR`],innerRadius:[`STAR`],arcData:[`ELLIPSE`],characters:[`TEXT`],fontSize:[`TEXT`],fontName:[`TEXT`],textAlignHorizontal:[`TEXT`],textAlignVertical:[`TEXT`],textAutoResize:[`TEXT`],textCase:[`TEXT`],textDecoration:[`TEXT`],lineHeight:[`TEXT`],letterSpacing:[`TEXT`],textTruncation:[`TEXT`],maxLines:[`TEXT`],layoutMode:[`FRAME`],itemSpacing:[`FRAME`],paddingTop:[`FRAME`],paddingRight:[`FRAME`],paddingBottom:[`FRAME`],paddingLeft:[`FRAME`],primaryAxisSizingMode:[`FRAME`],counterAxisSizingMode:[`FRAME`],primaryAxisAlignItems:[`FRAME`],counterAxisAlignItems:[`FRAME`],cornerRadius:[`FRAME`,`RECTANGLE`,`ELLIPSE`,`POLYGON`,`STAR`,`VECTOR`,`BOOLEAN_OPERATION`],cornerSmoothing:[`FRAME`,`RECTANGLE`,`ELLIPSE`,`POLYGON`,`STAR`,`VECTOR`,`BOOLEAN_OPERATION`],topLeftRadius:[`FRAME`,`RECTANGLE`],topRightRadius:[`FRAME`,`RECTANGLE`],bottomLeftRadius:[`FRAME`,`RECTANGLE`],bottomRightRadius:[`FRAME`,`RECTANGLE`]};function vi(e,t,n=[]){let r=e,i=r?.updated??[],a=[];i.length>0&&a.push({type:`text`,text:`已更新 ${i.length} 个节点`});let o=r?.warnings??[];for(let e of o)a.push({type:`text`,text:`⚠ ${e}`});if(i.length===0&&t.length===0)a.push({type:`text`,text:`未传入任何属性,本次未修改`});else if(i.length>0&&t.length>0){let e=t.filter(e=>{let t=_i[e];return t!=null&&!i.some(e=>e.type!=null&&t.includes(e.type))});e.length>0&&a.push({type:`text`,text:`以下属性与目标节点类型不匹配,已被忽略:${e.map(e=>`${e}(仅适用于 ${_i[e].join(`/`)})`).join(`、`)}`})}if(n.length>0){let e=new Set(i.map(e=>e.id)),t=n.filter(t=>!e.has(t));t.length>0&&a.push({type:`text`,text:`以下节点未更新(可能已失效/被连坐删除): ${t.join(`, `)}。可用 jsd_find 复核后重试`})}return a}var yi=`⚠ recursive=true 只作用于**后代**,不含目标节点自身(给图标/容器传 recursive 刷色,容器自己不再被印上方框);无子节点的叶子自身即整棵子树,仍会改。要把容器自己也算上才显式传 includeSelf=true,那时结果会带 warnings 点名「容器自身也被修改」。`;function X(e){let t=hn[e.method],n=e=>t.filter(t=>e[t]!==void 0&&_i[t]!==void 0),r=e=>{let t=e.ids??[];return e.recursive===!0&&e.includeSelf!==!0?[]:t};return{name:e.name,title:e.title,description:e.description+yi,inputSchema:e.inputSchema,outputSchema:ut,annotations:e.annotations,method:e.method,payload:e=>{let{ids:t,matchName:n,recursive:r,includeSelf:i,...a}=e,o={props:a};return t!==void 0&&(o.ids=t),n!==void 0&&(o.matchName=n),r!==void 0&&(o.recursive=r),i!==void 0&&(o.includeSelf=i),o},...e.followUp===void 0?{}:{followUp:e.followUp},extraContent:(e,t)=>vi(e,n(t),r(t))}}var Z=`⚠ 对位于 INSTANCE 内的子节点改样式有平台风险:回显是新值,渲染却可能仍是组件原样式(实测 fills/fontName,其余样式同类风险);命中时本次结果会带 warnings 并给出主组件里对应子节点的 id —— 改它即所有实例继承,只要单个实例不同则先 jsd_detach_instance 再改`;function bi(e,t){return[X({name:`jsd_set_fill_color`,title:`设置填充`,description:`设置填充色/渐变(fills 为 Paint 数组,整体替换非合并,需保留的现有填充项要一并传入)、混合模式与团队库填充样式。${Z}`,method:`set_fill`,inputSchema:rn,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_set_stroke`,description:`接着设置描边`}}),X({name:`jsd_set_stroke`,title:`设置描边`,description:`设置描边列表、宽度(可四边分开)、对齐/端点/连接、虚线模式与团队库描边样式。strokes 整体替换非合并。把描边烘焙成矢量用 jsd_outline_stroke。`+Z,method:`set_stroke`,inputSchema:an,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_set_fill_color`,description:`接着设置填充`}}),X({name:`jsd_set_cornerRadius`,title:`设置圆角`,description:`设置圆角半径(corners 四角可分开)与圆角平滑度。仅 FRAME/RECTANGLE/ELLIPSE/POLYGON/STAR/VECTOR/BOOLEAN_OPERATION 生效,LINE/TEXT 无圆角。`+Z,method:`set_corner_radius`,inputSchema:on,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_set_effects`,description:`接着设置阴影/模糊效果`}}),X({name:`jsd_set_text`,title:`修改文本`,description:`修改文本内容与排版(仅 TEXT 节点生效):characters/fontSize/fontName/对齐/自适应/大小写/装饰/行高/字距,以及 Figma 的截断与最大行数。字体需精确匹配,建议先 jsd_list_fonts 查可用字体(不可用时静默回退默认)。${Z};characters 内容覆盖在实例内也是正常生效的`,method:`set_text`,inputSchema:sn,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_rename_node`,description:`给文本起个语义名称`}}),X({name:`jsd_move_node`,title:`移动节点`,description:`设置节点 x/y(相对父节点)与 rotation(绕左上角原点)。auto-layout 子节点的位置由父容器接管,修改可能被布局覆盖——那种情况请改 jsd_set_layout 的间距/对齐`,method:`move`,inputSchema:cn,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_resize_node`,description:`接着调整尺寸`}}),X({name:`jsd_resize_node`,title:`调整节点尺寸`,description:`设置节点 width/height,并可同时传 x/y 一步完成「改尺寸 + 定位」(按坐标排布、批量摆位时常用,避免分两次调用让中间态被引擎自动尺寸/约束改写;reparent 已自动保持绝对位置,不需要用本工具摆回)。TEXT 默认自适应(WIDTH_AND_HEIGHT)时会覆盖显式尺寸,要固定文本框先 jsd_set_text 设 textAutoResize=NONE。横线/竖线用 LINE:零轴会被兜到 0.01 过引擎校验(存回读仍是 0);其他类型低于 0.01 会明确报错(引擎 resize 下限)`,method:`resize`,inputSchema:ln,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_set_visibility`,description:`接着设置可见性/锁定`}}),X({name:`jsd_set_layout`,title:`设置自动布局`,description:`设置 FRAME 的 auto-layout:layoutMode 与 itemSpacing/padding*/主轴交叉轴尺寸和对齐/约束/伸缩可在同一次调用里一起传(引擎先应用 layoutMode 再应用间距)。建议建节点时不要混着传,归组并摆好后再单独设`,method:`set_layout`,inputSchema:un,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_reparent_nodes`,description:`把子节点移入容器完成排布`}}),X({name:`jsd_set_effects`,title:`设置效果与高级属性`,description:`设置阴影/模糊效果(可多层叠加,整体替换)、团队库效果样式、溢出裁剪、布局网格(参考线)与椭圆环形参数(仅 ELLIPSE)。`+Z,method:`set_effects`,inputSchema:dn,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_set_visibility`,description:`接着设置可见性/锁定`}}),X({name:`jsd_set_visibility`,title:`设置可见性与锁定`,description:`设置不透明度 opacity(0-1)、visible 显示开关与 locked 锁定。锁定后节点不能被选中或编辑`,method:`set_visibility`,inputSchema:fn,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_get_selection`,description:`复核改动后的画布选中`}}),X({name:`jsd_rename_node`,title:`重命名节点`,description:`重命名节点。命名建议说明用途(如「登录页/邮箱输入/主按钮」),不用「矩形 1」「Frame 2」;批量替换文案用 jsd_set_text`,method:`rename`,inputSchema:pn,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_set_text`,description:`接着改文本内容/排版`}}),X({name:`jsd_set_shape`,title:`设置多边形/星形形状`,description:`设置形状参数(承接原 jsd_update_node 的长尾字段):pointCount 多边形/星形角点数(仅 POLYGON/STAR 生效)、innerRadius 星形内半径比例(0-1,仅 STAR 生效)。改尺寸/圆角用 jsd_resize_node / jsd_set_cornerRadius`,method:`set_shape`,inputSchema:mn,annotations:{readOnlyHint:!1,destructiveHint:!1},followUp:{type:`tool`,tool:`jsd_set_fill_color`,description:`接着设置填充`}})].map(n=>B(n)(e,t))}function xi(e,t){let n=typeof t==`string`?t.toLowerCase():``;if(n===`png`||n===`svg`||n===`pdf`)return n;if(n===`jpg`||n===`jpeg`)return`jpg`;let r=(e??``).toLowerCase();return r.includes(`png`)?`png`:r.includes(`jpeg`)||r.includes(`jpg`)?`jpg`:r.includes(`svg`)?`svg`:r.includes(`pdf`)?`pdf`:`bin`}function Si(e,t){let i=B({name:`jsd_export`,title:`导出节点为图片`,description:`导出节点为 PNG/JPG/SVG/PDF;ids 为必填数组(单节点也写成 ids:["123:456"],不是 nodeId),savePath 落盘与 includeDataUrl 返回 base64 可并存。注意:单张图片超过内联上限(默认 512KB)时不返回 base64,自动落盘并返回路径引用,避免撑爆会话内存。完整字段见 inputSchema。`,inputSchema:rt,outputSchema:vt,annotations:{readOnlyHint:!1,destructiveHint:!1},timeout:pe,followUp:{type:`tool`,tool:`jsd_fill_image`,description:`导出后用该图片填充到节点`},run:async(e,t,n)=>{let{ids:i,format:a,scale:o,savePath:s,includeDataUrl:c}=e,l=(await t.request(`export`,{ids:i,format:a,scale:o},{signal:n,timeout:6e4})).exports??{},u=[],d=[];for(let[e,t]of Object.entries(l)){let n=t.bytes,i=t.mimeType,a={id:e,name:t.name,format:t.format,mimeType:i,size:n.byteLength};if(s&&(r(s,n),a.path=s),c){if(n.byteLength>me){let o=s??g(se(),`jsd-export-${e.replace(/[^a-zA-Z0-9_-]/g,`_`)}-${Date.now()}.${xi(i,t.format)}`);s||r(o,n),a.path=o,d.push(`${e}(实际 ${n.byteLength} 字节 > 上限 ${me} 字节)已落盘:${o}`)}else a.dataUrl=`data:${i};base64,${n.toString(`base64`)}`}u.push(a)}return{exports:u,dataUrlOverflow:d}},extraContent:(e,t)=>{let n=t.ids??[],r=e.exports??[],i=e.dataUrlOverflow??[],a=[];r.length>0&&a.push({type:`text`,text:`已导出 ${r.length} 个节点`});for(let e of i)a.push({type:`text`,text:`⚠️ 图片超过内联上限,未返回 base64,${e}。需要图片内容请读取该文件路径,或调小 scale 后重试。`});if(n.length>0){let e=new Set(r.map(e=>e.id)),t=n.filter(t=>!e.has(t));t.length>0&&a.push({type:`text`,text:`导出失败(节点可能已失效): ${t.join(`, `)}。可用 jsd_find 复核`})}return a}}),a=B({name:`jsd_fill_image`,title:`本地图片填充节点`,description:`读取本地图片文件填充到指定节点(IMAGE fill)`,inputSchema:it,outputSchema:ut,annotations:{readOnlyHint:!1,destructiveHint:!1},timeout:pe,followUp:{type:`tool`,tool:`jsd_get_selection`,description:`复核图片填充效果`},run:async(e,t,r)=>{let{ids:i,sourcePath:a}=e,o;try{o=n(a)}catch(e){throw Error(`读取文件失败: ${e instanceof Error?e.message:String(e)}`)}return t.request(`fill_image`,{ids:i,bytes:new Uint8Array(o)},{signal:r,timeout:pe})}}),o=B({name:`jsd_list_fonts`,title:`列出可用字体`,description:`列出当前环境可用字体族`,method:`list_fonts`,outputSchema:yt,annotations:{readOnlyHint:!0},followUp:{type:`tool`,tool:`jsd_set_text`,description:`用列出的字体设置文本`}});return[i(e,t),a(e,t),o(e,t)]}function Q(e,t){return{contents:[{uri:typeof e==`string`?e:e.href,mimeType:`application/json`,text:JSON.stringify(t,null,2)}]}}function Ci(e,t){return[e.registerResource(`canvas-selection`,`jsd://canvas/selection`,{title:`画布当前选中`,description:`当前选中节点的序列化树(含直接子节点),实时从插件读取;等价于 jsd_get_selection depth=2。⚠ 每个节点带 z = 在父级 children 里的下标 = 绘制顺序(0 = 最底层,越大越靠上)`,mimeType:`application/json`},async()=>Q(`jsd://canvas/selection`,await t.request(`get_selection`,{depth:2}))),e.registerResource(`fonts`,`jsd://fonts`,{title:`可用字体列表`,description:`当前环境可用的字体族列表,实时从插件读取`,mimeType:`application/json`},async()=>Q(`jsd://fonts`,await t.request(`list_fonts`,{}))),e.registerResource(`styles`,`jsd://styles`,{title:`本地样式列表`,description:`当前文档可复用的本地样式(PAINT/TEXT/EFFECT/GRID),含 id/name/type;按名应用样式前先读这里拿准确样式名`,mimeType:`application/json`},async()=>Q(`jsd://styles`,await t.request(`list_styles`,{}))),e.registerResource(`page`,`jsd://page`,{title:`当前页结构总览`,description:`当前页顶层节点的轻量摘要(名称/类型/位置/尺寸/子节点数),不递归;从头设计整页前先读这里看页面已有内容`,mimeType:`application/json`},async()=>Q(`jsd://page`,await t.request(`get_page`,{}))),e.registerResource(`node`,new d(`jsd://node/{id}`,{list:void 0}),{title:`节点详情`,description:`按 id 读取节点的序列化结构,如 jsd://node/12:3;等价于 jsd_find ids 精确查找`,mimeType:`application/json`},async(e,n)=>{let r=n.id,i=Array.isArray(r)?r[0]:r;if(!i)throw Error(`缺少节点 id: ${e.href}`);return Q(e,await t.request(`find`,{ids:[i]}))})]}function wi(e,t){let n=B({name:`jsd_ping`,title:`检查 ${ge.runtime} 插件连接`,description:`检查插件是否在线(需先启动 ${ge.runtime} 插件并保持运行)。返回两个能力表:coreCapabilities 为核心能力(create/modify/structure/component/export/image,两平台一致);capabilities 只列平台差异超集(如 variables/componentProperties/textTruncation),jsDesign 通常只有 styles`,outputSchema:dt,annotations:{readOnlyHint:!0},alwaysEnabled:!0,timeout:fe,followUp:{type:`tool`,tool:`jsd_get_selection`,description:`连接确认后读取当前选中`},run:async()=>{try{let e=await t.request(`ping`,{},{timeout:fe});return{connected:!0,platform:e?.platform,capabilities:e?.capabilities,coreCapabilities:e?.coreCapabilities}}catch(e){return{connected:!1,error:e instanceof Error?e.message:String(e)}}}}),r=B({name:`jsd_get_selection`,title:`读取画布选中`,description:`获取画布当前选中节点的序列化树(名称/类型/尺寸/位置/填充/子结构);depth 控制层级深度,默认 2。⚠ 每个节点带 z = 在父级 children 里的下标 = 绘制顺序(0 = 最底层,越大越靠上),判断遮挡读 z 即可`,method:`get_selection`,outputSchema:ft,annotations:{readOnlyHint:!0},followUp:{type:`tool`,tool:`jsd_find`,description:`在选中范围内继续精确查找节点`}});return[n(e,t),r(e,t)]}var Ti=[wi,si,li,ui,Sr,bi,ci,Si,xr,di,Ci,e=>fi(e)],Ei=`操作设计画布的工具集。一个操作对应一个 jsd_* 工具,无 op 分发;聚合入口 jsd_manage_nodes / jsd_manage_components 仅用于批量/混合结构操作。调用纪律:
82
+ - 建节点用 per-type 工具:jsd_create_frame / jsd_create_rectangle / jsd_create_text 等,每个工具只建一类节点;多根/复杂嵌套树用 jsd_batch 编排多个建节点步骤。建完再 jsd_reparent_nodes 归组(**parentId 显式传目标容器 id**;跨父级移动会保持节点绝对位置,内部自动换算新父下的 x/y,不用手动摆回,移入 auto-layout 容器时位置由布局接管);auto-layout(layoutMode/itemSpacing/padding* 等)最后用 jsd_set_layout 单独设置。
83
+ - 改属性用专责工具:填充 jsd_set_fill_color、描边 jsd_set_stroke、圆角 jsd_set_cornerRadius、文本 jsd_set_text、位置 jsd_move_node、尺寸 jsd_resize_node(可同时传 x/y)、布局 jsd_set_layout、效果 jsd_set_effects、显隐 jsd_set_visibility、改名 jsd_rename_node、形状 jsd_set_shape。
84
+ - 跨工具多步流程用 jsd_batch 编排:双花括号占位符(步骤id.字段路径)引用上步结果,中间 id 不回传模型;步骤回显已做摘要裁剪(节点只留 id/name/type/x/y),含图标/矢量的批次(jsd_create_icon / jsd_clone_node)另配一次 jsd_export 目视验收 —— 回显不等于生效。
85
+ - 批量刷样式用 ids 一次下发:recursive=true 只作用于**后代**,不含目标节点自身(给一组图标容器刷描边,容器自己不会被套上方框);要连容器自身一起改才传 includeSelf=true。
86
+ - 实例子节点(位于 INSTANCE 内)的样式覆盖平台不保证渲染生效,命中时结果 warnings 直接给出主组件里对应子节点的 id —— 改主组件即所有实例继承。
87
+ - ok=false 或「没找到 X 节点」:先 jsd_find 复核 id 是否已失效(可能被连坐删除),必要时 jsd_repair_nodes 清理后重试。`,Di=new Set;function Oi(e){for(let e of Di)try{e.sendToolListChanged()}catch{}P(`连接状态变化: ${e?`插件上线`:`插件离线`}(工具目录保持不变,会话数 ${Di.size})`)}function ki(e){let t=new u({name:le,version:y},{supportedProtocolVersions:[`2026-07-28`,...f],instructions:Ei});for(let n of Ti)n(t,e);Di.add(t);let n=t.server,r=n.onclose;return n.onclose=()=>{Di.delete(t),r?.()},t}async function Ai(e){await e.start(ce),P(`daemon: 插件 WS ws://localhost:${e.port}`);let t=p(()=>ki(e)),n=ie(t),r=ne(),i=re(),o=null,s=n=>{P(`daemon 退出: ${n}`),t.close(),e.stop(),o?.close(),process.exit(0)};await new Promise((e,t)=>{o=a((e,t)=>{if(!r(e,t)||!i(e,t))return;let a=Date.now(),o=e.url??``;if(t.on(`finish`,()=>{let n=`HTTP ${e.method} ${o} → ${t.statusCode} (${Date.now()-a}ms)`;t.statusCode>=400?P(n):F(n)}),e.method===`GET`&&o===`/health`){t.writeHead(200,{"content-type":`application/json`}),t.end(JSON.stringify({name:le,version:y,pid:process.pid}));return}if(e.method===`POST`&&o===`/shutdown`){t.writeHead(200,{"content-type":`application/json`}),t.end(JSON.stringify({ok:!0})),setTimeout(()=>s(`收到 /shutdown 请求`),100);return}n(e,t)}),o.once(`error`,t),o.listen(v,`127.0.0.1`,()=>e())}),P(`daemon: MCP HTTP http://127.0.0.1:${v}/mcp`),P(`daemon 就绪,常驻运行(更新时由版本自检自动替换)`),process.on(`SIGINT`,()=>s(`SIGINT`))}async function ji(){let e=await On();if(e.state===`foreign`)L(`端口 ${v} 被非 text-to-design MCP 服务占用,请先释放`),process.exit(1);else if(e.state===`proxy`){await Hn(e.client);return}e.state===`none`?(P(`未发现 daemon,自动拉起...`),Fn()):P(`daemon 正在启动,等待就绪...`);let t=Date.now()+ue;for(;Date.now()<t;){await kn(250);let e=await On();if(e.state===`proxy`){await Hn(e.client);return}e.state===`foreign`&&(L(`端口 ${v} 被非 text-to-design MCP 服务占用,请先释放`),process.exit(1))}L(`daemon 启动超时(${ue/1e3}s),请检查残留进程后重试`),process.exit(1)}var $=new Dn;$.onConnectionChange=Oi,xn((e,t)=>$.notifyLog(e,t)),process.env.TEXT_TO_DESIGN_MCP_ROLE===`daemon`||process.argv.includes(`daemon`)?Ai($).catch(e=>{$.stop(),L(`daemon 启动失败: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}):ji().catch(e=>{L(`shim 启动失败: ${e instanceof Error?e.message:String(e)}`),process.exit(1)});export{};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "text-to-design-mcp",
3
- "version": "0.6.1",
3
+ "version": "0.7.0",
4
4
  "description": "MCP server bridging AI clients to the jsDesign (即时设计) desktop plugin via a local WebSocket",
5
5
  "repository": {
6
6
  "type": "git",
@@ -41,6 +41,7 @@
41
41
  "build": "tsx scripts/gen-aliases.ts && vite build",
42
42
  "start": "node dist/index.js",
43
43
  "start:dev": "tsx src/index.ts",
44
- "typecheck": "tsc --noEmit"
44
+ "typecheck": "tsc --noEmit",
45
+ "check:schema": "node scripts/check-schema-draft07.mjs"
45
46
  }
46
47
  }