text-to-design-mcp 0.6.0 → 0.6.1

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 (2) hide show
  1. package/dist/index.js +26 -3580
  2. package/package.json +11 -12
package/dist/index.js CHANGED
@@ -1,3213 +1,24 @@
1
1
  #!/usr/bin/env node
2
- import { createRequire } from "node:module";
3
- import { appendFileSync, readFileSync, writeFileSync } from "node:fs";
4
- import { z } from "zod";
5
- import { createServer } from "node:http";
6
- import { WebSocket, WebSocketServer } from "ws";
7
- import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
8
- import { McpServer, ResourceTemplate, SUPPORTED_PROTOCOL_VERSIONS, createMcpHandler, fromJsonSchema } from "@modelcontextprotocol/server";
9
- import { serveStdio } from "@modelcontextprotocol/server/stdio";
10
- import { spawn } from "node:child_process";
11
- import { localhostHostValidation, localhostOriginValidation, toNodeHandler } from "@modelcontextprotocol/node";
12
- import { isTag } from "domhandler";
13
- import { parseDocument } from "htmlparser2";
14
- import Fuse from "fuse.js";
15
- //#region package.json
16
- var version = "0.6.0";
17
- //#endregion
18
- //#region src/config.ts
19
- var PORT = Number(process.env.TEXT_TO_DESIGN_MCP_PORT ?? 47812);
20
- var HTTP_PORT = Number(process.env.TEXT_TO_DESIGN_MCP_HTTP_PORT ?? 47820);
21
- var SERVER_NAME = "text-to-design-mcp-server";
22
- var SERVER_VERSION = version;
23
- var DAEMON_WAIT_MS = 5e3;
24
- /** 工具超时分级:ping 短平快;导出/图片填充是大 IO(大图/大文件),放宽到 60s */
25
- var PING_TIMEOUT_MS = 5e3;
26
- var LONG_IO_TIMEOUT_MS = 6e4;
27
- /** jsd_batch 整批上限:每步仍受自身 timeout 约束,此处只封顶整次编排 */
28
- var BATCH_TIMEOUT_MS = 12e4;
29
- /** 设计客户端厂商:当前即时设计,扩展其他客户端(如 Figma)时替换此配置即可 */
30
- var CLIENT = {
31
- label: "即时设计",
32
- runtime: "jsDesign",
33
- toolPrefix: "jsd"
34
- };
35
- //#endregion
36
- //#region ../shared/src/schemas.ts
37
- var rgbSchema = z.object({
38
- r: z.number().min(0).max(1, "颜色通道最大 1(0-255 的色值请先除以 255 归一化)").describe("红色通道,范围 0-1(0=无,1=满),如纯红为 1"),
39
- g: z.number().min(0).max(1, "颜色通道最大 1(0-255 的色值请先除以 255 归一化)").describe("绿色通道,范围 0-1"),
40
- b: z.number().min(0).max(1, "颜色通道最大 1(0-255 的色值请先除以 255 归一化)").describe("蓝色通道,范围 0-1")
41
- }).strict();
42
- var rgbaSchema = z.object({
43
- r: z.number().min(0).max(1, "颜色通道最大 1(0-255 请先归一化)"),
44
- g: z.number().min(0).max(1, "颜色通道最大 1(0-255 请先归一化)"),
45
- b: z.number().min(0).max(1, "颜色通道最大 1(0-255 请先归一化)"),
46
- a: z.number().min(0).max(1, "alpha 通道最大 1(0-255 请先归一化)")
47
- }).strict();
48
- var gradientStopSchema = z.object({
49
- color: rgbaSchema,
50
- position: z.number().min(0).max(1)
51
- }).describe("渐变停止点,如 {color:{r:1,g:0,b:0,a:1}, position:0}(起点红色)和 {color:{r:0,g:0,b:1,a:1}, position:1}(终点蓝色)");
52
- var transformSchema = z.tuple([z.tuple([
53
- z.number(),
54
- z.number(),
55
- z.number()
56
- ]), z.tuple([
57
- z.number(),
58
- z.number(),
59
- z.number()
60
- ])]).describe("变换矩阵,如 [[1,0,0],[0,1,0]] 表示无变换(Identity)");
61
- var blendModeSchema = z.enum([
62
- "PASS_THROUGH",
63
- "NORMAL",
64
- "DARKEN",
65
- "MULTIPLY",
66
- "COLOR_BURN",
67
- "LIGHTEN",
68
- "SCREEN",
69
- "COLOR_DODGE",
70
- "OVERLAY",
71
- "SOFT_LIGHT",
72
- "HARD_LIGHT",
73
- "DIFFERENCE",
74
- "EXCLUSION",
75
- "HUE",
76
- "SATURATION",
77
- "COLOR",
78
- "LUMINOSITY"
79
- ]);
80
- var paintSchema = z.discriminatedUnion("type", [
81
- z.object({
82
- type: z.literal("SOLID"),
83
- color: rgbSchema,
84
- opacity: z.number().min(0).max(1).optional(),
85
- visible: z.boolean().optional(),
86
- blendMode: blendModeSchema.optional()
87
- }).strict(),
88
- z.object({
89
- type: z.literal("GRADIENT_LINEAR"),
90
- gradientStops: z.array(gradientStopSchema),
91
- gradientTransform: transformSchema
92
- }).strict(),
93
- z.object({
94
- type: z.literal("GRADIENT_RADIAL"),
95
- gradientStops: z.array(gradientStopSchema),
96
- gradientTransform: transformSchema
97
- }).strict(),
98
- z.object({
99
- type: z.literal("GRADIENT_ANGULAR"),
100
- gradientStops: z.array(gradientStopSchema),
101
- gradientTransform: transformSchema
102
- }).strict(),
103
- z.object({
104
- type: z.literal("IMAGE"),
105
- imageHash: z.string(),
106
- scaleMode: z.enum([
107
- "FILL",
108
- "FIT",
109
- "CROP",
110
- "TILE"
111
- ]).optional()
112
- }).strict()
113
- ]);
114
- var effectSchema = z.discriminatedUnion("type", [
115
- z.object({
116
- type: z.literal("DROP_SHADOW"),
117
- color: rgbaSchema,
118
- offset: z.object({
119
- x: z.number(),
120
- y: z.number()
121
- }),
122
- radius: z.number().min(0),
123
- spread: z.number().optional(),
124
- visible: z.boolean().optional(),
125
- blendMode: blendModeSchema.default("NORMAL"),
126
- showShadowBehindNode: z.boolean().optional()
127
- }).strict(),
128
- z.object({
129
- type: z.literal("INNER_SHADOW"),
130
- color: rgbaSchema,
131
- offset: z.object({
132
- x: z.number(),
133
- y: z.number()
134
- }),
135
- radius: z.number().min(0),
136
- spread: z.number().optional(),
137
- visible: z.boolean().optional(),
138
- blendMode: blendModeSchema.default("NORMAL")
139
- }).strict(),
140
- z.object({
141
- type: z.literal("LAYER_BLUR"),
142
- radius: z.number().min(0),
143
- visible: z.boolean().optional()
144
- }).strict(),
145
- z.object({
146
- type: z.literal("BACKGROUND_BLUR"),
147
- radius: z.number().min(0),
148
- visible: z.boolean().optional()
149
- }).strict()
150
- ]);
151
- var constraintTypeSchema = z.enum([
152
- "MIN",
153
- "MAX",
154
- "STRETCH",
155
- "CENTER",
156
- "SCALE"
157
- ]);
158
- var layoutGridSchema = z.object({
159
- pattern: z.enum([
160
- "ROWS",
161
- "COLUMNS",
162
- "GRID"
163
- ]).describe("网格类型:ROWS|COLUMNS|GRID"),
164
- alignment: z.enum([
165
- "MIN",
166
- "MAX",
167
- "CENTER",
168
- "STRETCH"
169
- ]).optional().describe("对齐:MIN|MAX|CENTER|STRETCH"),
170
- sectionSize: z.number().optional().describe("分节尺寸(px)"),
171
- count: z.number().int().positive().optional().describe("网格数"),
172
- gutterSize: z.number().optional().describe("沟槽尺寸(px)"),
173
- offset: z.number().optional().describe("偏移(px)"),
174
- visible: z.boolean().optional().describe("是否可见"),
175
- color: rgbaSchema.optional().describe("网格颜色")
176
- }).superRefine((val, ctx) => {
177
- if (val.pattern === "GRID" && val.sectionSize == null) ctx.addIssue({
178
- code: z.ZodIssueCode.custom,
179
- message: "pattern 为 GRID 时,sectionSize 为必填项",
180
- path: ["sectionSize"]
181
- });
182
- });
183
- var vectorPathSchema = z.object({
184
- data: z.string().describe("SVG path data,如 \"M0 0 L100 0 L100 100 Z\"(M=移动到,L=画线到,Z=闭合)"),
185
- windingRule: z.enum([
186
- "NONZERO",
187
- "EVENODD",
188
- "NONE"
189
- ]).default("NONZERO").describe("环绕规则:NONZERO|EVENODD|NONE,默认 NONZERO")
190
- });
191
- var fontNameSchema = z.object({
192
- family: z.string(),
193
- style: z.string()
194
- });
195
- var lineHeightSchema = z.union([
196
- z.object({
197
- value: z.number(),
198
- unit: z.literal("PIXELS")
199
- }).describe("固定行高:{value: 数值, unit: \"PIXELS\"},如 {value: 24, unit: \"PIXELS\"}"),
200
- z.object({
201
- value: z.number(),
202
- unit: z.literal("PERCENT")
203
- }).describe("百分比行高:{value: 数值, unit: \"PERCENT\"},如 {value: 150, unit: \"PERCENT\"}"),
204
- z.object({ unit: z.literal("AUTO") }).describe("自动行高:{unit: \"AUTO\"},无需传 value")
205
- ]);
206
- var letterSpacingSchema = z.object({
207
- value: z.number(),
208
- unit: z.enum(["PIXELS", "PERCENT"])
209
- });
210
- var nodeTypeSchema = z.enum([
211
- "SLICE",
212
- "FRAME",
213
- "GROUP",
214
- "COMPONENT_SET",
215
- "COMPONENT",
216
- "INSTANCE",
217
- "BOOLEAN_OPERATION",
218
- "VECTOR",
219
- "STAR",
220
- "LINE",
221
- "ELLIPSE",
222
- "POLYGON",
223
- "RECTANGLE",
224
- "TEXT"
225
- ]);
226
- var transformPropsSchema = z.object({
227
- x: z.number().optional().describe("X 坐标(px)"),
228
- y: z.number().optional().describe("Y 坐标(px)"),
229
- width: z.number().optional().describe("宽度(px)"),
230
- height: z.number().optional().describe("高度(px)"),
231
- rotation: z.number().optional().describe("旋转角度(deg)"),
232
- opacity: z.number().optional().describe("不透明度 0-1"),
233
- visible: z.boolean().optional().describe("是否可见"),
234
- locked: z.boolean().optional().describe("锁定图层")
235
- });
236
- var strokePropsSchema = z.object({
237
- strokes: z.array(paintSchema).optional().describe("描边列表(Paint 数组)"),
238
- strokeWeight: z.number().optional().describe("描边宽度(px)"),
239
- strokeTopWeight: z.number().optional().describe("描边顶部宽(px)"),
240
- strokeBottomWeight: z.number().optional().describe("描边底部宽(px)"),
241
- strokeLeftWeight: z.number().optional().describe("描边左侧宽(px)"),
242
- strokeRightWeight: z.number().optional().describe("描边右侧宽(px)"),
243
- strokeAlign: z.enum([
244
- "CENTER",
245
- "INSIDE",
246
- "OUTSIDE"
247
- ]).optional().describe("描边对齐:CENTER|INSIDE|OUTSIDE"),
248
- strokeCap: z.enum([
249
- "NONE",
250
- "ROUND",
251
- "SQUARE",
252
- "ARROW_LINES",
253
- "ARROW_EQUILATERAL"
254
- ]).optional().describe("描边端点:NONE|ROUND|SQUARE|ARROW_LINES|ARROW_EQUILATERAL"),
255
- strokeJoin: z.enum([
256
- "MITER",
257
- "BEVEL",
258
- "ROUND"
259
- ]).optional().describe("描边连接:MITER|BEVEL|ROUND"),
260
- dashPattern: z.array(z.number()).optional().describe("虚线段数组,如 [4,4]")
261
- });
262
- var cornerPropsSchema = z.object({
263
- cornerRadius: z.number().optional().describe("圆角半径(px),四角统一"),
264
- topLeftRadius: z.number().optional().describe("左上圆角(px)"),
265
- topRightRadius: z.number().optional().describe("右上圆角(px)"),
266
- bottomLeftRadius: z.number().optional().describe("左下圆角(px)"),
267
- bottomRightRadius: z.number().optional().describe("右下圆角(px)")
268
- });
269
- var textPropsSchema = z.object({
270
- characters: z.string().optional().describe("文本内容"),
271
- fontSize: z.number().optional().describe("字号(px)"),
272
- fontName: fontNameSchema.optional().describe("字体:{family,style}"),
273
- textAlignHorizontal: z.enum([
274
- "LEFT",
275
- "CENTER",
276
- "RIGHT",
277
- "JUSTIFIED"
278
- ]).optional().describe("水平对齐:LEFT|CENTER|RIGHT|JUSTIFIED"),
279
- textAlignVertical: z.enum([
280
- "TOP",
281
- "CENTER",
282
- "BOTTOM"
283
- ]).optional().describe("垂直对齐:TOP|CENTER|BOTTOM"),
284
- textAutoResize: z.enum([
285
- "NONE",
286
- "WIDTH_AND_HEIGHT",
287
- "HEIGHT",
288
- "TRUNCATE"
289
- ]).optional().describe("文本自适应:NONE|WIDTH_AND_HEIGHT|HEIGHT|TRUNCATE"),
290
- textCase: z.enum([
291
- "ORIGINAL",
292
- "UPPER",
293
- "LOWER",
294
- "TITLE"
295
- ]).optional().describe("文本大小写:ORIGINAL|UPPER|LOWER|TITLE"),
296
- textDecoration: z.enum([
297
- "NONE",
298
- "UNDERLINE",
299
- "STRIKETHROUGH"
300
- ]).optional().describe("文本装饰:NONE|UNDERLINE|STRIKETHROUGH"),
301
- lineHeight: lineHeightSchema.optional().describe("行高:{value,unit}"),
302
- letterSpacing: letterSpacingSchema.optional().describe("字距:{value,unit}")
303
- });
304
- var autoLayoutPropsSchema = z.object({
305
- layoutMode: z.enum([
306
- "NONE",
307
- "HORIZONTAL",
308
- "VERTICAL"
309
- ]).optional().describe("自动布局方向:NONE|HORIZONTAL|VERTICAL。传 itemSpacing/padding*/primaryAxis* 等布局属性前必须先设为 HORIZONTAL 或 VERTICAL"),
310
- itemSpacing: z.number().optional().describe("自动布局项间距(px);primaryAxisAlignItems=SPACE_BETWEEN 时该项被忽略(子项均匀分布)"),
311
- paddingTop: z.number().optional().describe("上内边距(px)"),
312
- paddingRight: z.number().optional().describe("右内边距(px)"),
313
- paddingBottom: z.number().optional().describe("下内边距(px)"),
314
- paddingLeft: z.number().optional().describe("左内边距(px)"),
315
- primaryAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional().describe("主轴尺寸模式:FIXED|AUTO"),
316
- counterAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional().describe("交叉轴尺寸模式:FIXED|AUTO"),
317
- primaryAxisAlignItems: z.enum([
318
- "MIN",
319
- "MAX",
320
- "CENTER",
321
- "SPACE_BETWEEN"
322
- ]).optional().describe("主轴对齐:MIN|MAX|CENTER|SPACE_BETWEEN;设为 SPACE_BETWEEN 时 itemSpacing 被忽略(子项均匀分布)"),
323
- counterAxisAlignItems: z.enum([
324
- "MIN",
325
- "MAX",
326
- "CENTER"
327
- ]).optional().describe("交叉轴对齐:MIN|MAX|CENTER"),
328
- layoutGrow: z.number().optional().describe("自动布局内伸缩系数"),
329
- layoutAlign: z.enum([
330
- "MIN",
331
- "CENTER",
332
- "MAX",
333
- "STRETCH",
334
- "INHERIT"
335
- ]).optional().describe("自动布局内对齐:MIN|CENTER|MAX|STRETCH|INHERIT")
336
- });
337
- var visualPropsSchema = z.object({
338
- fills: z.array(paintSchema).optional().describe("填充列表(Paint 数组)"),
339
- blendMode: blendModeSchema.optional().describe("混合模式"),
340
- effects: z.array(effectSchema).optional().describe("效果列表(阴影/模糊,可多层叠加)"),
341
- constraints: z.object({
342
- horizontal: constraintTypeSchema.describe("水平约束:MIN|MAX|STRETCH|CENTER|SCALE"),
343
- vertical: constraintTypeSchema.describe("垂直约束:MIN|MAX|STRETCH|CENTER|SCALE")
344
- }).optional().describe("自动布局中的约束"),
345
- clipsContent: z.boolean().optional().describe("是否裁剪溢出内容"),
346
- cornerSmoothing: z.number().optional().describe("圆角平滑度 0-1"),
347
- layoutGrids: z.array(layoutGridSchema).optional().describe("布局网格(参考线)"),
348
- arcData: z.object({
349
- startingAngle: z.number().describe("起始角度(radians)"),
350
- endingAngle: z.number().describe("结束角度(radians)"),
351
- innerRadius: z.number().describe("内半径(0-1 ratio)")
352
- }).optional().describe("环形路径参数(弧线)")
353
- });
354
- var serializedNodeSchema = z.lazy(() => z.object({
355
- id: z.string(),
356
- name: z.string(),
357
- type: nodeTypeSchema,
358
- x: z.number(),
359
- y: z.number(),
360
- width: z.number().optional(),
361
- height: z.number().optional(),
362
- rotation: z.number().optional(),
363
- opacity: z.number().optional(),
364
- visible: z.boolean().optional(),
365
- locked: z.boolean().optional(),
366
- parentId: z.string().optional(),
367
- fills: z.array(paintSchema).optional(),
368
- strokes: z.array(paintSchema).optional(),
369
- strokeWeight: z.number().optional(),
370
- strokeTopWeight: z.number().optional(),
371
- strokeBottomWeight: z.number().optional(),
372
- strokeLeftWeight: z.number().optional(),
373
- strokeRightWeight: z.number().optional(),
374
- strokeAlign: z.enum([
375
- "CENTER",
376
- "INSIDE",
377
- "OUTSIDE"
378
- ]).optional(),
379
- strokeCap: z.enum([
380
- "NONE",
381
- "ROUND",
382
- "SQUARE",
383
- "ARROW_LINES",
384
- "ARROW_EQUILATERAL"
385
- ]).optional(),
386
- strokeJoin: z.enum([
387
- "MITER",
388
- "BEVEL",
389
- "ROUND"
390
- ]).optional(),
391
- dashPattern: z.array(z.number()).optional(),
392
- cornerSmoothing: z.number().optional(),
393
- blendMode: blendModeSchema.optional(),
394
- constraints: z.object({
395
- horizontal: constraintTypeSchema,
396
- vertical: constraintTypeSchema
397
- }).optional(),
398
- layoutGrids: z.array(layoutGridSchema).optional(),
399
- clipsContent: z.boolean().optional(),
400
- arcData: z.object({
401
- startingAngle: z.number(),
402
- endingAngle: z.number(),
403
- innerRadius: z.number()
404
- }).optional(),
405
- effects: z.array(effectSchema).optional(),
406
- cornerRadius: z.number().optional(),
407
- topLeftRadius: z.number().optional(),
408
- topRightRadius: z.number().optional(),
409
- bottomLeftRadius: z.number().optional(),
410
- bottomRightRadius: z.number().optional(),
411
- pointCount: z.number().optional(),
412
- innerRadius: z.number().optional(),
413
- layoutMode: z.enum([
414
- "NONE",
415
- "HORIZONTAL",
416
- "VERTICAL"
417
- ]).optional(),
418
- itemSpacing: z.number().optional(),
419
- paddingTop: z.number().optional(),
420
- paddingRight: z.number().optional(),
421
- paddingBottom: z.number().optional(),
422
- paddingLeft: z.number().optional(),
423
- primaryAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional(),
424
- counterAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional(),
425
- primaryAxisAlignItems: z.enum([
426
- "MIN",
427
- "MAX",
428
- "CENTER",
429
- "SPACE_BETWEEN"
430
- ]).optional(),
431
- counterAxisAlignItems: z.enum([
432
- "MIN",
433
- "MAX",
434
- "CENTER"
435
- ]).optional(),
436
- layoutGrow: z.number().optional(),
437
- layoutAlign: z.enum([
438
- "MIN",
439
- "CENTER",
440
- "MAX",
441
- "STRETCH",
442
- "INHERIT"
443
- ]).optional(),
444
- childCount: z.number().optional(),
445
- children: z.array(serializedNodeSchema).optional(),
446
- characters: z.string().optional(),
447
- fontSize: z.number().optional(),
448
- fontName: fontNameSchema.optional(),
449
- textAlignHorizontal: z.enum([
450
- "LEFT",
451
- "CENTER",
452
- "RIGHT",
453
- "JUSTIFIED"
454
- ]).optional(),
455
- textAlignVertical: z.enum([
456
- "TOP",
457
- "CENTER",
458
- "BOTTOM"
459
- ]).optional(),
460
- textAutoResize: z.enum([
461
- "NONE",
462
- "WIDTH_AND_HEIGHT",
463
- "HEIGHT",
464
- "TRUNCATE"
465
- ]).optional(),
466
- textCase: z.enum([
467
- "ORIGINAL",
468
- "UPPER",
469
- "LOWER",
470
- "TITLE"
471
- ]).optional(),
472
- textDecoration: z.enum([
473
- "NONE",
474
- "UNDERLINE",
475
- "STRIKETHROUGH"
476
- ]).optional(),
477
- lineHeight: lineHeightSchema.optional(),
478
- letterSpacing: letterSpacingSchema.optional(),
479
- vectorPaths: z.array(vectorPathSchema).optional(),
480
- booleanOperation: z.enum([
481
- "UNION",
482
- "SUBTRACT",
483
- "INTERSECT",
484
- "EXCLUDE"
485
- ]).optional(),
486
- isMask: z.boolean().optional(),
487
- variantProperties: z.record(z.string(), z.string()).optional(),
488
- mainComponentId: z.string().optional(),
489
- variantGroupProperties: z.record(z.string(), z.array(z.string())).optional(),
490
- textTruncation: z.enum(["DISABLED", "ENDING"]).optional(),
491
- maxLines: z.number().optional(),
492
- fillStyleId: z.string().optional(),
493
- strokeStyleId: z.string().optional(),
494
- textStyleId: z.string().optional(),
495
- effectStyleId: z.string().optional(),
496
- componentProperties: z.record(z.string(), componentPropertyValueSchema).optional()
497
- }));
498
- var createdResultSchema = z.object({ created: z.union([serializedNodeSchema, z.array(serializedNodeSchema)]) });
499
- var updatedResultSchema = z.object({ updated: z.array(serializedNodeSchema) });
500
- /** 平台枚举:当前支持即时设计/Figma,未来新增平台在此加值 */
501
- var pluginPlatformSchema = z.enum(["jsdesign", "figma"]);
502
- /** 平台能力枚举:adapter 声明当前平台支持哪些超集能力(供 ping/capabilities 上报) */
503
- var hostCapabilitySchema = z.enum([
504
- "styles",
505
- "textTruncation",
506
- "componentProperties",
507
- "variables",
508
- "getMainComponentAsync",
509
- "platformOps"
510
- ]);
511
- /** 实例组件属性值(Figma ComponentPropertyValue 的线格式,preferredValues 对齐 InstanceSwapPreferredValue) */
512
- var componentPropertyValueSchema = z.object({
513
- type: z.enum([
514
- "BOOLEAN",
515
- "VARIANT",
516
- "TEXT",
517
- "INSTANCE_SWAP"
518
- ]),
519
- value: z.union([z.boolean(), z.string()]),
520
- preferredValues: z.array(z.object({
521
- type: z.enum(["COMPONENT", "COMPONENT_SET"]),
522
- key: z.string()
523
- })).optional()
524
- });
525
- var pingResultSchema = z.object({
526
- connected: z.boolean(),
527
- platform: pluginPlatformSchema.optional().describe("当前连接的插件平台"),
528
- capabilities: z.array(hostCapabilitySchema).optional().describe("当前平台支持的能力列表(先查此字段再决定能否调用平台特有操作)"),
529
- error: z.string().optional()
530
- });
531
- var getSelectionResultSchema = z.object({
532
- selection: z.array(serializedNodeSchema),
533
- pageName: z.string()
534
- });
535
- var findResultSchema = z.object({
536
- nodes: z.array(serializedNodeSchema),
537
- total: z.number()
538
- });
539
- var manageNodesResultSchema = z.object({
540
- selected: z.array(z.string()).optional(),
541
- removed: z.array(z.string()).optional(),
542
- ungrouped: z.array(z.string()).optional(),
543
- moved: z.array(serializedNodeSchema).optional(),
544
- cleaned: z.array(z.string()).optional(),
545
- created: z.union([serializedNodeSchema, z.array(serializedNodeSchema)]).optional()
546
- });
547
- /** 实例覆盖摘要(只回传键名,不回传大体积值) */
548
- var overrideSummarySchema = z.object({
549
- variantProperties: z.record(z.string(), z.string()).optional(),
550
- componentProperties: z.record(z.string(), componentPropertyValueSchema).optional(),
551
- propsSummary: z.array(z.string()).optional()
552
- });
553
- /** 单实例套用结果 */
554
- var applyOverrideItemSchema = z.object({
555
- instanceId: z.string(),
556
- instanceName: z.string(),
557
- ok: z.boolean(),
558
- message: z.string().optional()
559
- });
560
- var manageComponentsResultSchema = z.object({
561
- created: z.union([serializedNodeSchema, z.array(serializedNodeSchema)]).optional(),
562
- swapped: z.array(serializedNodeSchema).optional(),
563
- updated: z.array(serializedNodeSchema).optional(),
564
- /** copy_overrides 返回的快照标识(=源实例 id) */
565
- snapshotId: z.string().optional(),
566
- sourceName: z.string().optional(),
567
- /** copy_overrides 返回的复制摘要 */
568
- captured: overrideSummarySchema.optional(),
569
- /** apply/sync 返回的逐条套用结果 */
570
- applied: z.array(applyOverrideItemSchema).optional(),
571
- /** apply/sync 返回的已套用摘要 */
572
- source: overrideSummarySchema.optional()
573
- });
574
- var exportResultSchema = z.object({ exports: z.array(z.object({
575
- id: z.string(),
576
- name: z.string(),
577
- format: z.enum([
578
- "PNG",
579
- "JPG",
580
- "SVG",
581
- "PDF"
582
- ]),
583
- mimeType: z.string(),
584
- size: z.number(),
585
- path: z.string().optional(),
586
- dataUrl: z.string().optional()
587
- })) });
588
- var listFontsResultSchema = z.object({
589
- families: z.array(z.string()),
590
- count: z.number()
591
- });
592
- z.object({
593
- pageName: z.string(),
594
- nodes: z.array(z.object({
595
- id: z.string(),
596
- name: z.string(),
597
- type: nodeTypeSchema,
598
- x: z.number(),
599
- y: z.number(),
600
- width: z.number().optional(),
601
- height: z.number().optional(),
602
- childCount: z.number().optional()
603
- })),
604
- count: z.number()
605
- });
606
- z.object({
607
- styles: z.array(z.object({
608
- id: z.string(),
609
- name: z.string(),
610
- type: z.enum([
611
- "PAINT",
612
- "TEXT",
613
- "EFFECT",
614
- "GRID"
615
- ])
616
- })),
617
- count: z.number()
618
- });
619
- z.object({});
620
- z.object({ depth: z.number().optional().describe("序列化深度:0=仅自身,1=含直接子节点,2=含孙节点;缺省 2") });
621
- var baseNodeFields = {
622
- name: z.string().optional().describe("图层名"),
623
- x: z.number().optional().describe("X 坐标(px)"),
624
- y: z.number().optional().describe("Y 坐标(px)"),
625
- width: z.number().optional().describe("宽度(px)"),
626
- height: z.number().optional().describe("高度(px)"),
627
- rotation: z.number().optional().describe("旋转角度(deg)"),
628
- opacity: z.number().optional().describe("不透明度 0-1"),
629
- visible: z.boolean().optional().describe("是否可见"),
630
- locked: z.boolean().optional().describe("锁定图层"),
631
- isMask: z.boolean().optional().describe("是否为蒙版"),
632
- children: z.array(z.lazy(() => executeNodeSchema)).max(100).optional().describe("子节点数组(GROUP/BOOLEAN_OPERATION 使用,递归嵌套,最多 100 个直接子节点;更大的结构建议分批创建后用 jsd_manage_nodes op=reparent 归组)")
633
- };
634
- var visualFields = {
635
- fills: z.array(paintSchema).optional().describe("填充列表(Paint 数组)"),
636
- strokes: z.array(paintSchema).optional().describe("描边列表(Paint 数组)"),
637
- strokeWeight: z.number().optional().describe("描边宽度(px)"),
638
- strokeTopWeight: z.number().optional().describe("描边顶部宽(px)"),
639
- strokeBottomWeight: z.number().optional().describe("描边底部宽(px)"),
640
- strokeLeftWeight: z.number().optional().describe("描边左侧宽(px)"),
641
- strokeRightWeight: z.number().optional().describe("描边右侧宽(px)"),
642
- strokeAlign: z.enum([
643
- "CENTER",
644
- "INSIDE",
645
- "OUTSIDE"
646
- ]).optional().describe("描边对齐:CENTER|INSIDE|OUTSIDE"),
647
- strokeCap: z.enum([
648
- "NONE",
649
- "ROUND",
650
- "SQUARE",
651
- "ARROW_LINES",
652
- "ARROW_EQUILATERAL"
653
- ]).optional().describe("描边端点:NONE|ROUND|SQUARE|ARROW_LINES|ARROW_EQUILATERAL"),
654
- strokeJoin: z.enum([
655
- "MITER",
656
- "BEVEL",
657
- "ROUND"
658
- ]).optional().describe("描边连接:MITER|BEVEL|ROUND"),
659
- dashPattern: z.array(z.number()).optional().describe("虚线段数组,如 [4,4]"),
660
- blendMode: blendModeSchema.optional().describe("混合模式"),
661
- effects: z.array(effectSchema).optional().describe("效果列表(阴影/模糊,可多层叠加)"),
662
- constraints: z.object({
663
- horizontal: constraintTypeSchema.describe("水平约束:MIN|MAX|STRETCH|CENTER|SCALE"),
664
- vertical: constraintTypeSchema.describe("垂直约束:MIN|MAX|STRETCH|CENTER|SCALE")
665
- }).optional().describe("自动布局中的约束"),
666
- clipsContent: z.boolean().optional().describe("是否裁剪溢出内容"),
667
- cornerSmoothing: z.number().optional().describe("圆角平滑度 0-1"),
668
- layoutGrids: z.array(layoutGridSchema).optional().describe("布局网格(参考线)")
669
- };
670
- var frameNodeSchema = z.object({
671
- type: z.literal("FRAME"),
672
- ...baseNodeFields,
673
- layoutMode: z.enum([
674
- "NONE",
675
- "HORIZONTAL",
676
- "VERTICAL"
677
- ]).optional().describe("自动布局方向:NONE=无布局,HORIZONTAL=水平排列,VERTICAL=垂直排列。传 itemSpacing/padding*/primaryAxis* 等布局属性前必须先设为 HORIZONTAL 或 VERTICAL"),
678
- itemSpacing: z.number().optional().describe("自动布局项间距(px),需先设 layoutMode;primaryAxisAlignItems=SPACE_BETWEEN 时该项被忽略(子项均匀分布)"),
679
- paddingTop: z.number().optional().describe("上内边距(px)"),
680
- paddingRight: z.number().optional().describe("右内边距(px)"),
681
- paddingBottom: z.number().optional().describe("下内边距(px)"),
682
- paddingLeft: z.number().optional().describe("左内边距(px)"),
683
- primaryAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional().describe("主轴尺寸模式:FIXED|AUTO"),
684
- counterAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional().describe("交叉轴尺寸模式:FIXED|AUTO"),
685
- primaryAxisAlignItems: z.enum([
686
- "MIN",
687
- "MAX",
688
- "CENTER",
689
- "SPACE_BETWEEN"
690
- ]).optional().describe("主轴对齐:MIN|MAX|CENTER|SPACE_BETWEEN;设为 SPACE_BETWEEN 时 itemSpacing 被忽略(子项均匀分布)"),
691
- counterAxisAlignItems: z.enum([
692
- "MIN",
693
- "MAX",
694
- "CENTER"
695
- ]).optional().describe("交叉轴对齐:MIN|MAX|CENTER"),
696
- layoutGrow: z.number().optional().describe("自动布局内伸缩系数"),
697
- layoutAlign: z.enum([
698
- "MIN",
699
- "CENTER",
700
- "MAX",
701
- "STRETCH",
702
- "INHERIT"
703
- ]).optional().describe("自动布局内对齐:MIN|CENTER|MAX|STRETCH|INHERIT"),
704
- ...visualFields
705
- }).superRefine((val, ctx) => {
706
- if ((val.itemSpacing != null || val.paddingTop != null || val.paddingRight != null || val.paddingBottom != null || val.paddingLeft != null || val.primaryAxisSizingMode != null || val.counterAxisSizingMode != null || val.primaryAxisAlignItems != null || val.counterAxisAlignItems != null) && (val.layoutMode == null || val.layoutMode === "NONE")) ctx.addIssue({
707
- code: z.ZodIssueCode.custom,
708
- message: "传 itemSpacing/padding*/primaryAxis*/counterAxis* 等布局属性前,layoutMode 必须设为 HORIZONTAL 或 VERTICAL",
709
- path: ["layoutMode"]
710
- });
711
- }).describe("FRAME=容器(可 auto-layout)");
712
- var rectangleNodeSchema = z.object({
713
- type: z.literal("RECTANGLE"),
714
- ...baseNodeFields,
715
- cornerRadius: z.number().optional().describe("圆角半径(px),四角统一"),
716
- topLeftRadius: z.number().optional().describe("左上圆角(px)"),
717
- topRightRadius: z.number().optional().describe("右上圆角(px)"),
718
- bottomLeftRadius: z.number().optional().describe("左下圆角(px)"),
719
- bottomRightRadius: z.number().optional().describe("右下圆角(px)"),
720
- ...visualFields
721
- }).describe("RECTANGLE=矩形");
722
- var ellipseNodeSchema = z.object({
723
- type: z.literal("ELLIPSE"),
724
- ...baseNodeFields,
725
- cornerRadius: z.number().optional().describe("圆角半径(px)"),
726
- arcData: z.object({
727
- startingAngle: z.number().describe("起始角度(radians)"),
728
- endingAngle: z.number().describe("结束角度(radians)"),
729
- innerRadius: z.number().describe("内半径(0-1 ratio)")
730
- }).optional().describe("环形路径参数(弧线),可画圆环"),
731
- ...visualFields
732
- }).describe("ELLIPSE=椭圆(配合 arcData 可画环)");
733
- var lineNodeSchema = z.object({
734
- type: z.literal("LINE"),
735
- ...baseNodeFields,
736
- ...visualFields
737
- }).describe("LINE=线段");
738
- var polygonNodeSchema = z.object({
739
- type: z.literal("POLYGON"),
740
- ...baseNodeFields,
741
- pointCount: z.number().describe("多边形角点数,如 6=六边形"),
742
- cornerRadius: z.number().optional().describe("圆角半径(px)"),
743
- topLeftRadius: z.number().optional().describe("左上圆角(px)"),
744
- topRightRadius: z.number().optional().describe("右上圆角(px)"),
745
- bottomLeftRadius: z.number().optional().describe("左下圆角(px)"),
746
- bottomRightRadius: z.number().optional().describe("右下圆角(px)"),
747
- ...visualFields
748
- }).describe("POLYGON=多边形(配合 pointCount)");
749
- var starNodeSchema = z.object({
750
- type: z.literal("STAR"),
751
- ...baseNodeFields,
752
- pointCount: z.number().describe("星形角点数,如 5=五角星"),
753
- innerRadius: z.number().describe("星形内半径(px),值越小角越尖锐"),
754
- cornerRadius: z.number().optional().describe("圆角半径(px)"),
755
- topLeftRadius: z.number().optional().describe("左上圆角(px)"),
756
- topRightRadius: z.number().optional().describe("右上圆角(px)"),
757
- bottomLeftRadius: z.number().optional().describe("左下圆角(px)"),
758
- bottomRightRadius: z.number().optional().describe("右下圆角(px)"),
759
- ...visualFields
760
- }).describe("STAR=星形(配合 pointCount + innerRadius)");
761
- var vectorNodeSchema = z.object({
762
- type: z.literal("VECTOR"),
763
- ...baseNodeFields,
764
- vectorPaths: z.array(vectorPathSchema).describe("矢量路径数组,每项含 SVG path data(如 \"M0 0 L100 100\")"),
765
- ...visualFields
766
- }).describe("VECTOR=矢量(配合 vectorPaths 传 SVG path data)");
767
- var textNodeSchema = z.object({
768
- type: z.literal("TEXT"),
769
- ...baseNodeFields,
770
- characters: z.string().describe("文本内容,如 \"Hello World\""),
771
- fontSize: z.number().optional().describe("字号(px),默认 16"),
772
- fontName: fontNameSchema.optional().describe("字体:{family,style},如 {family:\"PingFang SC\",style:\"Regular\"}"),
773
- textAlignHorizontal: z.enum([
774
- "LEFT",
775
- "CENTER",
776
- "RIGHT",
777
- "JUSTIFIED"
778
- ]).optional().describe("水平对齐:LEFT|CENTER|RIGHT|JUSTIFIED"),
779
- textAlignVertical: z.enum([
780
- "TOP",
781
- "CENTER",
782
- "BOTTOM"
783
- ]).optional().describe("垂直对齐:TOP|CENTER|BOTTOM"),
784
- textAutoResize: z.enum([
785
- "NONE",
786
- "WIDTH_AND_HEIGHT",
787
- "HEIGHT",
788
- "TRUNCATE"
789
- ]).optional().describe("文本自适应:NONE|WIDTH_AND_HEIGHT|HEIGHT|TRUNCATE"),
790
- textCase: z.enum([
791
- "ORIGINAL",
792
- "UPPER",
793
- "LOWER",
794
- "TITLE"
795
- ]).optional().describe("文本大小写:ORIGINAL|UPPER|LOWER|TITLE"),
796
- textDecoration: z.enum([
797
- "NONE",
798
- "UNDERLINE",
799
- "STRIKETHROUGH"
800
- ]).optional().describe("文本装饰:NONE|UNDERLINE|STRIKETHROUGH"),
801
- lineHeight: lineHeightSchema.optional().describe("行高:{value,unit},unit 为 PIXELS|PERCENT;或 {unit:\"AUTO\"}"),
802
- letterSpacing: letterSpacingSchema.optional().describe("字距:{value,unit},unit 为 PIXELS|PERCENT"),
803
- ...visualFields
804
- }).describe("TEXT=文本(配合 characters/fontSize/fontName 等)");
805
- var groupNodeSchema = z.object({
806
- type: z.literal("GROUP"),
807
- ...baseNodeFields,
808
- layoutMode: z.enum([
809
- "NONE",
810
- "HORIZONTAL",
811
- "VERTICAL"
812
- ]).optional().describe("自动布局方向:NONE=纯归组,HORIZONTAL=水平,VERTICAL=垂直。传 itemSpacing/padding* 等布局属性前必须先设为 HORIZONTAL 或 VERTICAL"),
813
- itemSpacing: z.number().optional().describe("项间距(px),需先设 layoutMode;primaryAxisAlignItems=SPACE_BETWEEN 时该项被忽略(子项均匀分布)"),
814
- paddingTop: z.number().optional().describe("上内边距(px)"),
815
- paddingRight: z.number().optional().describe("右内边距(px)"),
816
- paddingBottom: z.number().optional().describe("下内边距(px)"),
817
- paddingLeft: z.number().optional().describe("左内边距(px)"),
818
- primaryAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional().describe("主轴尺寸模式:FIXED|AUTO"),
819
- counterAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional().describe("交叉轴尺寸模式:FIXED|AUTO"),
820
- primaryAxisAlignItems: z.enum([
821
- "MIN",
822
- "MAX",
823
- "CENTER",
824
- "SPACE_BETWEEN"
825
- ]).optional().describe("主轴对齐:MIN|MAX|CENTER|SPACE_BETWEEN;设为 SPACE_BETWEEN 时 itemSpacing 被忽略(子项均匀分布)"),
826
- counterAxisAlignItems: z.enum([
827
- "MIN",
828
- "MAX",
829
- "CENTER"
830
- ]).optional().describe("交叉轴对齐"),
831
- ...visualFields
832
- }).superRefine((val, ctx) => {
833
- if ((val.itemSpacing != null || val.paddingTop != null || val.paddingRight != null || val.paddingBottom != null || val.paddingLeft != null || val.primaryAxisSizingMode != null || val.counterAxisSizingMode != null || val.primaryAxisAlignItems != null || val.counterAxisAlignItems != null) && (val.layoutMode == null || val.layoutMode === "NONE")) ctx.addIssue({
834
- code: z.ZodIssueCode.custom,
835
- message: "传 itemSpacing/padding*/primaryAxis*/counterAxis* 等布局属性前,layoutMode 必须设为 HORIZONTAL 或 VERTICAL",
836
- path: ["layoutMode"]
837
- });
838
- }).describe("GROUP=分组(内部用 Frame 实现)");
839
- var booleanOperationNodeSchema = z.object({
840
- type: z.literal("BOOLEAN_OPERATION"),
841
- ...baseNodeFields,
842
- booleanOperation: z.enum([
843
- "UNION",
844
- "SUBTRACT",
845
- "INTERSECT",
846
- "EXCLUDE"
847
- ]).describe("布尔运算:UNION=合并,SUBTRACT=减去,INTERSECT=相交,EXCLUDE=排除"),
848
- children: z.array(z.lazy(() => executeNodeSchema)).min(2).describe("要合并的子节点数组(至少 2 个)"),
849
- ...visualFields
850
- }).describe("BOOLEAN_OPERATION=布尔运算(合并子节点)");
851
- var executeNodeSchema = z.discriminatedUnion("type", [
852
- frameNodeSchema,
853
- rectangleNodeSchema,
854
- ellipseNodeSchema,
855
- lineNodeSchema,
856
- polygonNodeSchema,
857
- starNodeSchema,
858
- vectorNodeSchema,
859
- textNodeSchema,
860
- groupNodeSchema,
861
- booleanOperationNodeSchema
862
- ]);
863
- var placementSchema = z.object({
864
- mode: z.enum([
865
- "center",
866
- "manual",
867
- "absolute"
868
- ]).optional().describe("放置模式:center=居中画布/manual=保持节点原始坐标/absolute=使用 x/y 指定坐标(选 absolute 必须传 x 和 y)"),
869
- x: z.number().optional().describe("absolute 模式下的绝对 X 坐标,与 mode=\"absolute\" 配合使用"),
870
- y: z.number().optional().describe("absolute 模式下的绝对 Y 坐标,与 mode=\"absolute\" 配合使用")
871
- }).superRefine((val, ctx) => {
872
- if (val.mode === "absolute" && (val.x == null || val.y == null)) ctx.addIssue({
873
- code: z.ZodIssueCode.custom,
874
- message: "placement.mode 为 absolute 时,x 和 y 均为必填项",
875
- path: val.x == null ? ["x"] : ["y"]
876
- });
877
- });
878
- var executeSchema = z.object({
879
- ops: z.array(executeNodeSchema).describe("设计指令节点树"),
880
- placement: placementSchema.optional().describe("放置方式,缺省 center 居中。选 absolute 模式必须传 x 和 y 坐标")
881
- });
882
- var createSvgSchema = z.object({
883
- svg: z.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>"),
884
- name: z.string().optional().describe("生成的图层名,默认 svg-design")
885
- });
886
- var htmlToDesignSchema = z.object({
887
- html: z.string().describe("HTML 片段,支持内联 style"),
888
- name: z.string().optional().describe("生成的图层名,默认 html-design")
889
- });
890
- var createIconSchema = z.object({
891
- icon: z.string().describe("图标名/别名/语义描述,如 home、arrow-right、search、magnifier(搜索);支持模糊匹配与别名联想,查无返回候选提示"),
892
- size: z.number().optional().describe("图标边长 px,默认 24"),
893
- color: z.string().optional().describe("描边颜色(十六进制),默认 #000000"),
894
- strokeWidth: z.number().optional().describe("描边宽度,默认 2"),
895
- name: z.string().optional().describe("生成的图层名,默认 icon-<图标名>")
896
- });
897
- var updateNodePropsSchema = z.object({
898
- name: z.string().optional().describe("图层名称"),
899
- pointCount: z.number().optional().describe("多边形/星形角点数"),
900
- innerRadius: z.number().optional().describe("星形内半径(px)")
901
- }).and(transformPropsSchema).and(strokePropsSchema).and(cornerPropsSchema).and(textPropsSchema).and(autoLayoutPropsSchema).and(visualPropsSchema).and(z.object({
902
- textTruncation: z.enum(["DISABLED", "ENDING"]).optional().describe("文本截断(DISABLED=不截断,ENDING=末尾省略号截断),仅 Figma 生效"),
903
- maxLines: z.number().optional().describe("文本最大行数,仅 Figma 生效"),
904
- fillStyleId: z.string().optional().describe("填充样式 id(团队库样式)"),
905
- strokeStyleId: z.string().optional().describe("描边样式 id(团队库样式)"),
906
- textStyleId: z.string().optional().describe("文本样式 id(团队库样式)"),
907
- effectStyleId: z.string().optional().describe("效果样式 id(团队库样式)")
908
- }));
909
- var updateNodeSchema = z.object({
910
- ids: z.array(z.string()).optional().describe("指定节点 id"),
911
- matchName: z.string().optional().describe("按节点 name 过滤,仅命中节点被修改"),
912
- recursive: z.boolean().optional().describe("是否递归应用到子节点,默认 false"),
913
- props: updateNodePropsSchema.describe("要修改的属性")
914
- });
915
- var findSchema = z.object({
916
- ids: z.array(z.string()).optional().describe("按节点 id 精确查找,优先级最高"),
917
- name: z.string().optional().describe("按名称模糊匹配(包含)"),
918
- type: z.string().optional().describe("节点类型过滤,支持:SLICE/FRAME/GROUP/COMPONENT_SET/COMPONENT/INSTANCE/BOOLEAN_OPERATION/VECTOR/STAR/LINE/ELLIPSE/POLYGON/RECTANGLE/TEXT"),
919
- recursive: z.boolean().optional().describe("是否递归查找(默认 true)"),
920
- depth: z.number().optional().describe("序列化深度:0=仅自身,1=含直接子节点;缺省 1")
921
- });
922
- /**
923
- * 节点结构操作入参:扁平结构 + 运行时按 op 精查(与 manageComponentsSchema 同范式)。
924
- * 不用 discriminatedUnion 生成 oneOf——根级 oneOf 有两个问题:
925
- * 1) 调用方漏传 op 时,JSON-Schema 校验把每个分支的缺失字段全列一遍(oneOf 复读机式报错);
926
- * 2) 部分客户端对「根级 oneOf 工具」的出参序列化存在缺陷,实参会在到达服务端前被丢弃
927
- * (实测 7/7 复现,扁平对象工具无此现象)。扁平化后两点同时规避。
928
- */
929
- var manageNodesSchema = z.object({
930
- op: z.enum([
931
- "select",
932
- "remove",
933
- "clone",
934
- "group",
935
- "ungroup",
936
- "flatten",
937
- "outline_stroke",
938
- "reparent",
939
- "repair"
940
- ]).describe("节点结构操作类型:select 设当前选中 | remove 删除(matchName 可再过滤) | clone 复制(右下偏移) | group 编组(可带 layoutMode/itemSpacing/padding* 参数) | ungroup 解组 | flatten 合并为矢量(至少 2 节点) | outline_stroke 描边转轮廓 | reparent 移到 parentId 下(缺省当前选中第一个) | repair 清理已损坏节点"),
941
- ids: z.array(z.string()).optional().describe("节点 id 列表;除 remove/repair 外全部 op 必填(remove 缺省用当前选中)"),
942
- matchName: z.string().optional().describe("仅 remove:在 ids(或当前选中)范围内,仅删除 name 精确匹配的节点"),
943
- name: z.string().optional().describe("仅 group:组名"),
944
- layoutMode: z.enum([
945
- "NONE",
946
- "HORIZONTAL",
947
- "VERTICAL"
948
- ]).optional().describe("仅 group。自动布局方向:NONE=纯归组,子节点仅叠加,HORIZONTAL=水平排列,VERTICAL=垂直排列"),
949
- itemSpacing: z.number().optional().describe("仅 group。自动布局项间距(px);primaryAxisAlignItems=SPACE_BETWEEN 时该项被忽略(子项均匀分布)"),
950
- paddingTop: z.number().optional().describe("仅 group。上内边距(px)"),
951
- paddingRight: z.number().optional().describe("仅 group。右内边距(px)"),
952
- paddingBottom: z.number().optional().describe("仅 group。下内边距(px)"),
953
- paddingLeft: z.number().optional().describe("仅 group。左内边距(px)"),
954
- primaryAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional().describe("仅 group。主轴尺寸模式:FIXED|AUTO"),
955
- counterAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional().describe("仅 group。交叉轴尺寸模式:FIXED|AUTO"),
956
- primaryAxisAlignItems: z.enum([
957
- "MIN",
958
- "MAX",
959
- "CENTER",
960
- "SPACE_BETWEEN"
961
- ]).optional().describe("仅 group。主轴对齐:MIN|MAX|CENTER|SPACE_BETWEEN;设为 SPACE_BETWEEN 时 itemSpacing 被忽略(子项均匀分布)"),
962
- counterAxisAlignItems: z.enum([
963
- "MIN",
964
- "MAX",
965
- "CENTER"
966
- ]).optional().describe("仅 group。交叉轴对齐:MIN|MAX|CENTER"),
967
- parentId: z.string().optional().describe("仅 reparent:目标父节点 id,缺省用当前选中第一个节点"),
968
- index: z.number().optional().describe("仅 reparent:插入位置,缺省追加到末尾")
969
- }).superRefine((v, ctx) => {
970
- const missing = (field) => {
971
- ctx.addIssue({
972
- code: "custom",
973
- path: [field],
974
- message: `op=${v.op} 缺少必填字段 ${field}`
975
- });
976
- };
977
- const hasIds = Array.isArray(v.ids) && v.ids.length > 0 && v.ids.every((x) => typeof x === "string");
978
- switch (v.op) {
979
- case "select":
980
- case "clone":
981
- case "group":
982
- case "ungroup":
983
- case "flatten":
984
- case "outline_stroke":
985
- case "reparent": if (!hasIds) missing("ids");
986
- }
987
- if (v.op === "flatten" && hasIds && Array.isArray(v.ids) && v.ids.length < 2) ctx.addIssue({
988
- code: "custom",
989
- path: ["ids"],
990
- message: "op=flatten 至少需要 2 个节点 id"
991
- });
992
- });
993
- /**
994
- * 组件操作入参:扁平结构 + 运行时按 op 精查。
995
- * 不用 discriminatedUnion 生成 oneOf——调用方漏传 op 时,JSON-Schema 校验会把
996
- * 每个分支的缺失字段全列一遍(oneOf 复读机式报错);扁平化后缺 op 只有一行错,
997
- * op 合法但缺字段时由 superRefine 给出中文定位。
998
- */
999
- var manageComponentsSchema = z.object({
1000
- op: z.enum([
1001
- "create_component",
1002
- "create_instance",
1003
- "detach_instance",
1004
- "import_component",
1005
- "swap_component",
1006
- "set_instance_properties",
1007
- "combine_as_variants",
1008
- "copy_overrides",
1009
- "apply_overrides",
1010
- "sync_overrides"
1011
- ]).describe("组件操作类型"),
1012
- ids: z.array(z.string()).optional().describe("节点 id 列表;除 import_component 外全部 op 必填(create_component 为要固化的节点,其余为实例/组件节点)"),
1013
- name: z.string().optional().describe("名称;create_component/import_component/combine_as_variants 可选"),
1014
- key: z.string().optional().describe("团队库组件唯一标识 Key(仅 import_component 必填)"),
1015
- componentId: z.string().optional().describe("目标组件(COMPONENT)节点 id(仅 swap_component 必填)"),
1016
- properties: z.record(z.string(), z.string()).optional().describe("变体属性名→值,如 {\"状态\":\"禁用\"}(仅 set_instance_properties 必填);可调属性需从 jsd_find/jsd_get_selection 返回的 variantGroupProperties 获取,属性名必须完全匹配"),
1017
- sourceId: z.string().optional().describe("源实例(INSTANCE)节点 id;copy_overrides/apply_overrides/sync_overrides 必填"),
1018
- swapToSource: z.boolean().optional().describe("套用时是否把目标实例 swap 成源组件,默认 false(swap 会丢失目标既有覆盖,需显式开启)")
1019
- }).superRefine((v, ctx) => {
1020
- const missing = (field) => {
1021
- ctx.addIssue({
1022
- code: "custom",
1023
- path: [field],
1024
- message: `op=${v.op} 缺少必填字段 ${field}`
1025
- });
1026
- };
1027
- const hasIds = Array.isArray(v.ids) && v.ids.length > 0 && v.ids.every((x) => typeof x === "string");
1028
- switch (v.op) {
1029
- case "create_component":
1030
- case "create_instance":
1031
- case "detach_instance":
1032
- case "swap_component":
1033
- case "set_instance_properties":
1034
- case "combine_as_variants":
1035
- if (!hasIds) missing("ids");
1036
- break;
1037
- case "import_component":
1038
- if (typeof v.key !== "string" || v.key.length === 0) missing("key");
1039
- break;
1040
- case "copy_overrides":
1041
- if (typeof v.sourceId !== "string" || v.sourceId.length === 0) missing("sourceId");
1042
- break;
1043
- case "apply_overrides":
1044
- if (!hasIds) missing("ids");
1045
- if (typeof v.sourceId !== "string" || v.sourceId.length === 0) missing("sourceId");
1046
- break;
1047
- case "sync_overrides":
1048
- if (!hasIds) missing("ids");
1049
- if (typeof v.sourceId !== "string" || v.sourceId.length === 0) missing("sourceId");
1050
- }
1051
- if (v.op === "swap_component" && typeof v.componentId !== "string") missing("componentId");
1052
- if (v.op === "set_instance_properties" && (v.properties == null || typeof v.properties !== "object")) missing("properties");
1053
- });
1054
- var exportSchema = z.object({
1055
- ids: z.array(z.string()).describe("要导出的节点 id 列表"),
1056
- format: z.enum([
1057
- "PNG",
1058
- "JPG",
1059
- "SVG",
1060
- "PDF"
1061
- ]).optional().describe("导出格式,默认 PNG"),
1062
- scale: z.number().optional().describe("缩放倍率(PNG/JPG),默认 1"),
1063
- savePath: z.string().optional().describe("落盘文件绝对路径,如 /tmp/icon.png"),
1064
- includeDataUrl: z.boolean().optional().describe("是否同时返回 base64 dataURL,默认 false")
1065
- });
1066
- z.object({});
1067
- z.object({});
1068
- z.object({});
1069
- /** 图片填充入参:server 读本地文件,经二进制通道传给插件 */
1070
- var fillImageSchema = z.object({
1071
- ids: z.array(z.string()).describe("要填充图片的节点 id 列表"),
1072
- sourcePath: z.string().describe("本地图片文件绝对路径,如 /tmp/poster.png")
1073
- });
1074
- /** 平台特有操作(platform_op)入参:通用通道,op 名由 ping.capabilities 告知 */
1075
- var platformOpParamsSchema = z.object({
1076
- op: z.string().describe("平台特有操作名(如 figma_variables_create)。先 jsd_ping 看 capabilities 与平台支持列表"),
1077
- params: z.record(z.string(), z.unknown()).optional().describe("操作参数,结构随 op 而定")
1078
- });
1079
- var batchCallSchema = z.object({
1080
- id: z.string().optional().describe("步骤唯一标识,供后续步骤以双花括号占位符(id.字段路径)引用本步结果;缺省自动命名 step1/step2/…"),
1081
- tool: z.string().describe("要执行的 jsd_* 工具名,如 jsd_create_nodes / jsd_find / jsd_update_node"),
1082
- args: z.record(z.string(), z.unknown()).optional().describe("该工具的完整入参;任意位置的字符串值里可放双花括号占位符(步骤id.字段路径)引用先前步骤结果"),
1083
- continueOnError: z.boolean().optional().describe("本步【执行】失败时是否继续后续步骤;仅对执行失败生效,id 重复/未知工具/引用解析失败一律中止")
1084
- });
1085
- /** 与 manageComponentsSchema 同思路:扁平结构,schema 保持简单,语义约束由运行时给出 */
1086
- var batchSchema = z.object({
1087
- calls: z.array(batchCallSchema).min(1).max(50).describe("按数组顺序执行的步骤列表"),
1088
- stopOnError: z.boolean().optional().describe("全局失败策略,默认 true=任一步执行失败即停止,false=配合单步走完全部")
1089
- });
1090
- var batchResultSchema = z.object({
1091
- ok: z.boolean().describe("全部步骤均执行且成功(executed 小于 total 即为中途停止)"),
1092
- executed: z.number().int().min(0).describe("实际产生结果的步骤数"),
1093
- total: z.number().int().min(0).describe("计划的步骤总数"),
1094
- results: z.array(z.object({
1095
- id: z.string(),
1096
- tool: z.string(),
1097
- ok: z.boolean(),
1098
- data: z.unknown().optional().describe("成功时该工具的 structuredContent"),
1099
- error: z.string().optional().describe("失败原因(人读文本)")
1100
- })).describe("各步骤结果,顺序与入参一致;被中止而未执行的步骤不出现在此列表")
1101
- });
1102
- /** 平台特有操作结果:plugin 统一回 {ok, data},data 结构随 op 而定 */
1103
- var platformOpResultSchema = z.object({
1104
- ok: z.boolean(),
1105
- data: z.unknown().optional()
1106
- });
1107
- //#endregion
1108
- //#region ../shared/src/index.ts
1109
- var LOG_LEVEL_ORDER = {
1110
- debug: 0,
1111
- info: 1,
1112
- warn: 2,
1113
- error: 3
1114
- };
1115
- //#endregion
1116
- //#region src/logger.ts
1117
- var FILE = process.env.TEXT_TO_DESIGN_MCP_LOG ?? "/tmp/text-to-design-mcp.log";
1118
- var LEVEL_ORDER = LOG_LEVEL_ORDER;
1119
- /** 落盘门槛(默认 info)。只约束日志文件:面板推送全量下发,由 UI 档位过滤消化噪音 */
1120
- var LEVEL = process.env.TEXT_TO_DESIGN_MCP_LOG_LEVEL ?? "info";
1121
- var sink = null;
1122
- /** 注册/卸载日志发射钩子(传 null 卸载);logger 保持零本地依赖,由入口组装。
1123
- * 不变式:sink 实现内部不得再调用 log*(否则形成递归)。当前唯一实现走
1124
- * Bridge.notifyLog → Transport.sendPush(无日志发送通道),满足该约束 */
1125
- function setLogSink(fn) {
1126
- sink = fn;
1127
- }
1128
- /** 落盘 + 外发(daemon detached + stdio ignored,stderr 不可见,必须落盘) */
1129
- function write(level, line) {
1130
- if (LEVEL_ORDER[level] >= LEVEL_ORDER[LEVEL]) try {
1131
- appendFileSync(FILE, `${(/* @__PURE__ */ new Date()).toISOString()} [${level.toUpperCase()}] [text-to-design-mcp] ${line}\n`);
1132
- } catch {}
1133
- try {
1134
- sink?.(level, line);
1135
- } catch {}
1136
- }
1137
- function log(line) {
1138
- write("info", line);
1139
- }
1140
- function debug(line) {
1141
- write("debug", line);
1142
- }
1143
- function warn(line) {
1144
- write("warn", line);
1145
- }
1146
- function error(line) {
1147
- write("error", line);
1148
- }
1149
- //#endregion
1150
- //#region src/pending.ts
1151
- var DEFAULT_TIMEOUT = 3e4;
1152
- /** 请求关联:发出发送、pending 表、响应/二进制帧组装、超时与整体拒绝 */
1153
- var PendingManager = class {
1154
- pending = /* @__PURE__ */ new Map();
1155
- seq = 0;
1156
- binaryTarget = null;
1157
- sendFn;
1158
- constructor(send) {
1159
- this.sendFn = send;
1160
- }
1161
- request(method, params, opts = {}) {
1162
- const timeout = opts.timeout ?? DEFAULT_TIMEOUT;
1163
- const signal = opts.signal;
1164
- const id = `r${++this.seq}`;
1165
- const binary = params && typeof params === "object" && "bytes" in params ? params.bytes : null;
1166
- const payload = binary != null ? {
1167
- type: "request",
1168
- id,
1169
- method,
1170
- params: {
1171
- ...params,
1172
- hasBinary: true,
1173
- bytes: void 0
1174
- }
1175
- } : {
1176
- type: "request",
1177
- id,
1178
- method,
1179
- params
1180
- };
1181
- return new Promise((resolve, reject) => {
1182
- const startedAt = Date.now();
1183
- const entry = {
1184
- id,
1185
- method,
1186
- resolve,
1187
- reject,
1188
- timer: null,
1189
- waitBinary: false,
1190
- binaryCount: 0,
1191
- buffers: [],
1192
- startedAt
1193
- };
1194
- entry.timer = setTimeout(() => {
1195
- this.pending.delete(id);
1196
- this.detachAbort(entry);
1197
- warn(`请求超时: ${id} ${method} 耗时=${Date.now() - startedAt}ms`);
1198
- reject(/* @__PURE__ */ new Error(`请求超时: ${method}`));
1199
- }, timeout);
1200
- if (signal) {
1201
- if (signal.aborted) {
1202
- clearTimeout(entry.timer);
1203
- reject(/* @__PURE__ */ new Error(`请求已取消: ${method}`));
1204
- return;
1205
- }
1206
- entry.abort = {
1207
- signal,
1208
- listener: () => {
1209
- if (this.pending.delete(id)) {
1210
- this.detachAbort(entry);
1211
- log(`请求取消: ${id} ${method} 耗时=${Date.now() - startedAt}ms`);
1212
- reject(/* @__PURE__ */ new Error(`请求已取消: ${method}`));
1213
- }
1214
- }
1215
- };
1216
- signal.addEventListener("abort", entry.abort.listener, { once: true });
1217
- }
1218
- this.pending.set(id, entry);
1219
- log(`发出请求: ${id} ${method}${binary != null ? ` +binary(${binary.byteLength}B)` : ""}`);
1220
- this.sendFn(JSON.stringify(payload), binary != null ? Buffer.from(binary) : void 0);
1221
- });
1222
- }
1223
- /** 结束时统一摘除 abort 监听,防泄漏 */
1224
- detachAbort(entry) {
1225
- if (entry.abort) {
1226
- entry.abort.signal.removeEventListener("abort", entry.abort.listener);
1227
- entry.abort = void 0;
1228
- }
1229
- }
1230
- onText(raw) {
1231
- let msg;
1232
- try {
1233
- msg = JSON.parse(raw.toString());
1234
- } catch {
1235
- warn(`WS 文本解析失败: ${raw.toString().slice(0, 100)}`);
1236
- return;
1237
- }
1238
- if (msg.type === "request") {
1239
- if (msg.method === "ping") {
1240
- log(`收到 ping 请求: ${msg.id} (自动回 pong)`);
1241
- this.sendFn(JSON.stringify({
1242
- type: "response",
1243
- id: msg.id,
1244
- ok: true,
1245
- data: { pong: true }
1246
- }));
1247
- } else log(`收到未知请求: ${msg.id} ${msg.method} (忽略)`);
1248
- return;
1249
- }
1250
- if (msg.type !== "response") {
1251
- log(`收到非响应消息: type=${msg.type}`);
1252
- return;
1253
- }
1254
- const pending = this.pending.get(msg.id);
1255
- if (!pending) {
1256
- warn(`未匹配响应: id=${msg.id}(可能已超时或来源不明)`);
1257
- return;
1258
- }
1259
- if (msg.hasBinary && (msg.binaryCount ?? 1) > 0) {
1260
- log(`二进制响应开始: id=${msg.id} count=${msg.binaryCount ?? 1}`);
1261
- pending.waitBinary = true;
1262
- pending.binaryCount = msg.binaryCount ?? 1;
1263
- pending.data = msg.data;
1264
- this.binaryTarget = pending;
1265
- return;
1266
- }
1267
- this.pending.delete(msg.id);
1268
- clearTimeout(pending.timer);
1269
- this.detachAbort(pending);
1270
- const doneLine = `响应: ${pending.id} ${pending.method} ok=${msg.ok} 耗时=${Date.now() - pending.startedAt}ms${msg.ok ? "" : ` error=${msg.error ?? ""}`}`;
1271
- if (msg.ok) log(doneLine);
1272
- else error(doneLine);
1273
- if (msg.ok) pending.resolve(msg.data);
1274
- else pending.reject(new Error(msg.error ?? "plugin error"));
1275
- }
1276
- onBinary(raw) {
1277
- if (!this.binaryTarget) {
1278
- log(`孤儿二进制帧 len=${raw.byteLength}(无待组装响应)`);
1279
- return;
1280
- }
1281
- this.binaryTarget.buffers.push(raw);
1282
- log(`二进制帧: id=${this.binaryTarget.id} ${this.binaryTarget.buffers.length}/${this.binaryTarget.binaryCount}`);
1283
- if (this.binaryTarget.buffers.length >= this.binaryTarget.binaryCount) {
1284
- const target = this.binaryTarget;
1285
- this.binaryTarget = null;
1286
- const total = target.buffers.reduce((s, b) => s + b.byteLength, 0);
1287
- log(`二进制组装完成: id=${target.id} ${target.buffers.length} 帧 ${total}B 耗时=${Date.now() - target.startedAt}ms`);
1288
- this.settle(target);
1289
- }
1290
- }
1291
- rejectAll(err) {
1292
- for (const [, p] of this.pending) {
1293
- clearTimeout(p.timer);
1294
- this.detachAbort(p);
1295
- p.reject(err);
1296
- }
1297
- this.pending.clear();
1298
- }
1299
- clear() {
1300
- for (const [, p] of this.pending) {
1301
- clearTimeout(p.timer);
1302
- this.detachAbort(p);
1303
- }
1304
- this.pending.clear();
1305
- this.binaryTarget = null;
1306
- }
1307
- settle(pending) {
1308
- this.pending.delete(pending.id);
1309
- clearTimeout(pending.timer);
1310
- this.detachAbort(pending);
1311
- pending.resolve(mergeBytes(pending.data, pending.buffers));
1312
- }
1313
- };
1314
- /** 把二进制帧回填进 meta 结构(按帧序与插入序一一对应),兜底返回裸 Buffer */
1315
- function mergeBytes(data, buffers) {
1316
- const single = buffers.length === 1 ? buffers[0] : buffers;
1317
- if (!data || typeof data !== "object") return single;
1318
- const d = data;
1319
- if (d.exports && typeof d.exports === "object") {
1320
- const exports_ = d.exports;
1321
- const out = {};
1322
- Object.entries(exports_).forEach(([k, e], i) => {
1323
- out[k] = {
1324
- ...e,
1325
- bytes: buffers[i]
1326
- };
1327
- });
1328
- return {
1329
- ...d,
1330
- exports: out
1331
- };
1332
- }
1333
- return {
1334
- ...d,
1335
- bytes: single
1336
- };
1337
- }
1338
- //#endregion
1339
- //#region src/transport.ts
1340
- /** WSS/HTTP 生命周期(固定端口,被占即失败),消息透传上层 */
1341
- var Transport = class {
1342
- wss = null;
1343
- http = null;
1344
- client = null;
1345
- heartbeat = null;
1346
- _port = 0;
1347
- onMessage = null;
1348
- /** 插件 WS 连上时触发(每次新连接一次) */
1349
- onConnect = null;
1350
- onDisconnect = null;
1351
- get port() {
1352
- return this._port;
1353
- }
1354
- async start(port) {
1355
- this.http = createServer();
1356
- this.wss = new WebSocketServer({ server: this.http });
1357
- this.wss.on("error", () => {});
1358
- this.heartbeat = setInterval(() => {
1359
- if (this.client && this.client.readyState === WebSocket.OPEN) {
1360
- this.client.send(JSON.stringify({
1361
- type: "status",
1362
- state: "connected",
1363
- version
1364
- }));
1365
- debug("心跳: 下发状态确认");
1366
- }
1367
- }, 3e4);
1368
- this.wss.on("connection", (ws) => {
1369
- this.client = ws;
1370
- log("插件已连接");
1371
- try {
1372
- this.onConnect?.();
1373
- } catch (e) {
1374
- log(`onConnect 回调异常: ${e instanceof Error ? e.message : String(e)}`);
1375
- }
1376
- ws.send(JSON.stringify({
1377
- type: "status",
1378
- state: "connected",
1379
- version
1380
- }));
1381
- debug("已下发状态确认(status connected)");
1382
- ws.on("message", (raw, isBinary) => {
1383
- const buf = Buffer.isBuffer(raw) ? raw : Buffer.from(raw);
1384
- debug(`收到 WS 消息 len=${buf.length} bin=${isBinary}`);
1385
- this.onMessage?.(buf, isBinary);
1386
- });
1387
- ws.on("close", () => {
1388
- if (this.client === ws) this.client = null;
1389
- log("插件断开");
1390
- this.onDisconnect?.(/* @__PURE__ */ new Error("plugin disconnected"));
1391
- });
1392
- ws.on("error", () => {
1393
- if (this.client === ws) this.client = null;
1394
- this.onDisconnect?.(/* @__PURE__ */ new Error("plugin connection error"));
1395
- });
1396
- });
1397
- if (!await this.tryListen(port)) {
1398
- this.http.close();
1399
- throw new Error(`端口 ${port} 已被占用。已有 text-to-design-mcp 实例在运行?请检查残留进程后重试`);
1400
- }
1401
- this._port = port;
1402
- }
1403
- stop() {
1404
- if (this.heartbeat) clearInterval(this.heartbeat);
1405
- this.heartbeat = null;
1406
- this.wss?.close();
1407
- this.http?.close();
1408
- }
1409
- get isConnected() {
1410
- return this.client !== null && this.client.readyState === WebSocket.OPEN;
1411
- }
1412
- send(data) {
1413
- if (this.client && this.client.readyState === WebSocket.OPEN) {
1414
- this.client.send(data);
1415
- debug(`发送 WS 消息 len=${data.length} bin=${typeof data !== "string"}`);
1416
- } else warn(`发送失败: 无客户端连接(${data.length} 字节被丢弃)`);
1417
- }
1418
- /** 日志/状态推送专用通道:不打印自身日志——否则「推送一条日志 → send 再打一条 debug →
1419
- * 又推送一条」会形成自激链;调用方已判定在线,静默失败由 logger 的 try/catch 兜住 */
1420
- sendPush(frame) {
1421
- if (this.client && this.client.readyState === WebSocket.OPEN) this.client.send(frame);
1422
- }
1423
- tryListen(p) {
1424
- return new Promise((resolve) => {
1425
- const onError = () => {
1426
- cleanup();
1427
- resolve(false);
1428
- };
1429
- const onListening = () => {
1430
- cleanup();
1431
- resolve(true);
1432
- };
1433
- const cleanup = () => {
1434
- this.http?.off("error", onError);
1435
- this.http?.off("listening", onListening);
1436
- };
1437
- this.http?.once("error", onError);
1438
- this.http?.once("listening", onListening);
1439
- this.http?.listen(p);
1440
- });
1441
- }
1442
- };
1443
- //#endregion
1444
- //#region src/bridge.ts
1445
- /** 离线日志环形缓冲容量:插件不在线期间先入队,上线按入队顺序回放一次 */
1446
- var OFFLINE_LOG_RING = 200;
1447
- /** 门面:组合传输层与请求关联层,对外 API 不变 */
1448
- var Bridge = class {
1449
- transport = new Transport();
1450
- pending;
1451
- /** 离线期间攒下的日志(旧→新),上线回放后清空 */
1452
- logRing = [];
1453
- /** 插件连接状态变化(true=已连上,false=断开),供工具可用性联动 */
1454
- onConnectionChange = null;
1455
- constructor() {
1456
- this.pending = new PendingManager((text, binary) => {
1457
- this.transport.send(text);
1458
- if (binary) this.transport.send(binary);
1459
- });
1460
- this.transport.onMessage = (raw, isBinary) => {
1461
- if (isBinary) this.pending.onBinary(raw);
1462
- else this.pending.onText(raw);
1463
- };
1464
- this.transport.onConnect = () => {
1465
- this.replayLogs();
1466
- this.onConnectionChange?.(true);
1467
- };
1468
- this.transport.onDisconnect = (err) => {
1469
- this.pending.rejectAll(err);
1470
- this.onConnectionChange?.(false);
1471
- };
1472
- }
1473
- get port() {
1474
- return this.transport.port;
1475
- }
1476
- start(port) {
1477
- return this.transport.start(port);
1478
- }
1479
- stop() {
1480
- this.pending.clear();
1481
- this.logRing = [];
1482
- this.transport.stop();
1483
- }
1484
- get isConnected() {
1485
- return this.transport.isConnected;
1486
- }
1487
- request(method, params, opts = {}) {
1488
- if (!this.transport.isConnected) {
1489
- warn(`请求被拒(插件未连接): ${method}`);
1490
- return Promise.reject(/* @__PURE__ */ new Error(`${CLIENT.runtime} 插件未连接。请先在${CLIENT.label}客户端中运行该插件。`));
1491
- }
1492
- return this.pending.request(method, params, opts);
1493
- }
1494
- /** 把一条 daemon 日志发给插件 UI:在线直推,离线进环形缓冲待上线回放 */
1495
- notifyLog(level, line) {
1496
- const push = {
1497
- type: "log",
1498
- level,
1499
- line
1500
- };
1501
- if (!this.transport.isConnected) {
1502
- if (this.logRing.length >= OFFLINE_LOG_RING) this.logRing.shift();
1503
- this.logRing.push(push);
1504
- return;
1505
- }
1506
- this.sendLogPush(push);
1507
- }
1508
- /** 上线回放:按入队顺序补发离线日志(只补一次,发送失败不重试) */
1509
- replayLogs() {
1510
- if (this.logRing.length === 0) return;
1511
- const batch = this.logRing;
1512
- this.logRing = [];
1513
- log(`回放离线日志 ${batch.length} 条`);
1514
- for (const push of batch) this.sendLogPush(push);
1515
- }
1516
- sendLogPush(push) {
1517
- try {
1518
- this.transport.sendPush(JSON.stringify(push));
1519
- } catch {}
1520
- }
1521
- };
1522
- //#endregion
1523
- //#region src/daemon/probe.ts
1524
- /** GET daemon /health;无 /health 端点(旧版/外来服务/未启动)或失败 → null */
1525
- async function fetchDaemonHealth() {
1526
- try {
1527
- const res = await fetch(`http://127.0.0.1:${HTTP_PORT}/health`, { signal: AbortSignal.timeout(800) });
1528
- if (!res.ok) return null;
1529
- const body = await res.json();
1530
- return body.name && body.version ? {
1531
- name: body.name,
1532
- version: body.version
1533
- } : null;
1534
- } catch {
1535
- return null;
1536
- }
1537
- }
1538
- /**
1539
- * 探测 47820:已有 text-to-design daemon → 返回代理客户端;外来 MCP 服务 → 'foreign';无 → 'none'
1540
- */
1541
- async function probeUpstream() {
1542
- const health = await fetchDaemonHealth();
1543
- if (health && health.version !== SERVER_VERSION) {
1544
- log(`检测到旧版 daemon (${health.version} → ${SERVER_VERSION}),正在替换...`);
1545
- await fetch(`http://127.0.0.1:${HTTP_PORT}/shutdown`, { method: "POST" }).catch(() => {});
1546
- const deadline = Date.now() + 2e3;
1547
- while (Date.now() < deadline) {
1548
- await delay(250);
1549
- if (await fetchDaemonHealth() === null) break;
1550
- }
1551
- return { state: "none" };
1552
- }
1553
- const client = new Client({
1554
- name: "text-to-design-proxy",
1555
- version: SERVER_VERSION
1556
- }, { versionNegotiation: { mode: "auto" } });
1557
- try {
1558
- await client.connect(new StreamableHTTPClientTransport(new URL(`http://127.0.0.1:${HTTP_PORT}/mcp`)));
1559
- const { tools } = await client.listTools();
1560
- if (tools.length === 0 || !tools.every((t) => t.name.startsWith("jsd_"))) {
1561
- await client.close();
1562
- return { state: "foreign" };
1563
- }
1564
- return {
1565
- state: "proxy",
1566
- client
1567
- };
1568
- } catch {
1569
- await client.close().catch(() => {});
1570
- return { state: "none" };
1571
- }
1572
- }
1573
- function delay(ms) {
1574
- return new Promise((resolve) => setTimeout(resolve, ms));
1575
- }
1576
- //#endregion
1577
- //#region src/daemon/friendly-schema.ts
1578
- /** 从单个分支的 properties 中找判别字面量(op 的 const/enum[0]) */
1579
- function branchDiscriminator(branch) {
1580
- const props = branch.properties;
1581
- if (props == null || typeof props !== "object") return null;
1582
- for (const schema of Object.values(props)) {
1583
- if (schema == null || typeof schema !== "object") continue;
1584
- if ("const" in schema && schema.const != null) return String(schema.const);
1585
- if (Array.isArray(schema.enum) && schema.enum.length > 0) return String(schema.enum[0]);
1586
- }
1587
- return null;
1588
- }
1589
- /**
1590
- * 把联合 schema 的各分支压成一行清单:
1591
- * "select(需 ids) | remove(需 ids) | repair(无必填)"。
1592
- * 非联合 schema 或解析不出分支时返回 null,由上层退回原始报错。
1593
- */
1594
- function describeUnionBranches(schema) {
1595
- const branches = [schema.oneOf, schema.anyOf].find((v) => Array.isArray(v) && v.length > 0);
1596
- if (branches == null) return null;
1597
- return branches.map((raw, i) => {
1598
- const branch = raw ?? {};
1599
- const label = branchDiscriminator(branch) ?? `分支#${i}`;
1600
- const required = Array.isArray(branch.required) ? branch.required.filter((k) => k !== "op") : [];
1601
- return required.length > 0 ? `${label}(需 ${required.join(", ")})` : `${label}(无必填)`;
1602
- }).join(" | ");
1603
- }
1604
- /** 尽量读出入参顶层字段名,便于回显"到底发了什么" */
1605
- function receivedKeys(value) {
1606
- if (value == null || typeof value !== "object" || Array.isArray(value)) return JSON.stringify(value) ?? String(value);
1607
- const keys = Object.keys(value);
1608
- return keys.length > 0 ? `字段 [${keys.join(", ")}]` : "空对象 {}";
1609
- }
1610
- /** 包装 fromJsonSchema 的产物:校验行为不变,失败信息改写为人话 */
1611
- function friendlyInputSchema(schema) {
1612
- const face = fromJsonSchema(schema)["~standard"];
1613
- const branchHint = describeUnionBranches(schema);
1614
- return { "~standard": {
1615
- ...face,
1616
- validate(value) {
1617
- const result = face.validate(value);
1618
- if (!("issues" in result)) return result;
1619
- let knownOp = "";
1620
- if (value != null && typeof value === "object" && !Array.isArray(value)) {
1621
- const op = value.op;
1622
- if (typeof op === "string") knownOp = `, op='${op}'`;
1623
- }
1624
- const detail = result.issues.map((issue) => typeof issue?.message === "string" ? issue.message : "").filter(Boolean).join("; ").slice(0, 300);
1625
- const hint = branchHint != null ? `该工具按判别字段分发,可选值: ${branchHint}。` : "";
1626
- return { issues: [{ message: `入参校验失败: 实际收到${receivedKeys(value)}${knownOp}。${hint}请补齐对应必填字段后重试。原始校验: ${detail}` }] };
1627
- }
1628
- } };
1629
- }
1630
- //#endregion
1631
- //#region src/daemon/spawn.ts
1632
- /** detached 拉起 daemon(独立常驻,不受本会话生命周期影响) */
1633
- function spawnDaemon() {
1634
- const child = spawn(process.execPath, [...process.execArgv, ...process.argv.slice(1)], {
1635
- detached: true,
1636
- stdio: "ignore",
1637
- env: {
1638
- ...process.env,
1639
- TEXT_TO_DESIGN_MCP_ROLE: "daemon"
1640
- }
1641
- });
1642
- child.unref();
1643
- child.on("error", (e) => {
1644
- error(`拉起 daemon 失败: ${e.message}`);
1645
- });
1646
- }
1647
- //#endregion
1648
- //#region src/daemon/proxy.ts
1649
- var RECONNECT_DELAY_MS = 1500;
1650
- /** 重连总预算:超时后放弃本次恢复,把错误交还客户端 */
1651
- var RECONNECT_BUDGET_MS = 2e4;
1652
- /** 目录同步节奏:启动/重连后的快速档尽快收敛,稳态转入慢速档省流 */
1653
- var POLL_FAST_MS = 2e3;
1654
- var POLL_FAST_WINDOW_MS = 2e4;
1655
- var POLL_SLOW_MS = 15e3;
1656
- /** stateless HTTP 无常驻连接,上游死亡只会表现为「下一次请求失败」;
1657
- * onclose 不可依赖,必须同时识别这类传输层错误 */
1658
- function isTransportError(e) {
1659
- const msg = e instanceof Error ? e.message : String(e);
1660
- return /fetch failed|ECONNREFUSED|ECONNRESET|EPIPE|socket hang up|terminated|closed/i.test(msg);
1661
- }
1662
- /**
1663
- * shim 模式:stdio 与 daemon 之间的 MCP 代理(McpServer 动态重注册)。
1664
- *
1665
- * 本地注册表只承担「目录」职责,工具调用始终实时转发 daemon;目录新鲜度
1666
- * 由四重机制保证(按到达顺序):
1667
- * ① 下游握手时全量同步 ② 上游 listChanged 通知触发(若可达)
1668
- * ③ 重连成功后补偿同步 ④ 3s 周期轮询兜底(stateless 下通知不可达时的
1669
- * 最终保障)。registerTool/remove 自带下游 listChanged 广播,
1670
- * 规范客户端会自动刷新工具清单。
1671
- */
1672
- async function serveProxy(initialClient) {
1673
- let upstream = initialClient;
1674
- let shuttingDown = false;
1675
- let reconnectPromise = null;
1676
- const mcp = new McpServer({
1677
- name: SERVER_NAME,
1678
- version: SERVER_VERSION
1679
- }, {
1680
- supportedProtocolVersions: ["2026-07-28", ...SUPPORTED_PROTOCOL_VERSIONS],
1681
- ...initialClient.getInstructions() ? { instructions: initialClient.getInstructions() } : {}
1682
- });
1683
- const toolHandles = /* @__PURE__ */ new Map();
1684
- const promptHandles = /* @__PURE__ */ new Map();
1685
- const resourceHandles = /* @__PURE__ */ new Map();
1686
- const templateHandles = /* @__PURE__ */ new Map();
1687
- /** 统一出口:传输层错误 → 触发重连并重放一次;恢复后仍失败才交给下游 */
1688
- const withUpstream = async (fn) => {
1689
- try {
1690
- return await fn(upstream);
1691
- } catch (e) {
1692
- if (shuttingDown || !isTransportError(e)) throw e;
1693
- warn("shim: 上游请求失败,触发重连后重放");
1694
- await ensureReconnect();
1695
- return fn(upstream);
1696
- }
1697
- };
1698
- async function syncTools() {
1699
- const { tools } = await withUpstream((c) => c.listTools());
1700
- const seen = /* @__PURE__ */ new Set();
1701
- for (const t of tools) {
1702
- seen.add(t.name);
1703
- const raw = JSON.stringify(t);
1704
- const known = toolHandles.get(t.name);
1705
- if (known && known.raw === raw) continue;
1706
- known?.handle.remove();
1707
- toolHandles.delete(t.name);
1708
- const handle = mcp.registerTool.bind(mcp)(t.name, {
1709
- title: t.title,
1710
- description: t.description,
1711
- annotations: t.annotations,
1712
- ...t.inputSchema ? { inputSchema: friendlyInputSchema(t.inputSchema) } : {},
1713
- ...t.outputSchema ? { outputSchema: fromJsonSchema(t.outputSchema) } : {}
1714
- }, async (args) => withUpstream((c) => c.callTool({
1715
- name: t.name,
1716
- arguments: args ?? {}
1717
- })));
1718
- toolHandles.set(t.name, {
1719
- handle,
1720
- raw
1721
- });
1722
- }
1723
- for (const [name, entry] of [...toolHandles]) if (!seen.has(name)) {
1724
- entry.handle.remove();
1725
- toolHandles.delete(name);
1726
- }
1727
- }
1728
- async function syncPrompts() {
1729
- const { prompts } = await withUpstream((c) => c.listPrompts());
1730
- const seen = /* @__PURE__ */ new Set();
1731
- for (const p of prompts) {
1732
- seen.add(p.name);
1733
- const raw = JSON.stringify(p);
1734
- const known = promptHandles.get(p.name);
1735
- if (known && known.raw === raw) continue;
1736
- known?.handle.remove();
1737
- promptHandles.delete(p.name);
1738
- const shape = {};
1739
- for (const arg of p.arguments ?? []) shape[arg.name] = z.string().describe(arg.description ?? "");
1740
- const handle = mcp.registerPrompt(p.name, {
1741
- title: p.title,
1742
- description: p.description,
1743
- argsSchema: z.object(shape)
1744
- }, (args) => withUpstream((c) => c.getPrompt({
1745
- name: p.name,
1746
- ...args ? { arguments: args } : {}
1747
- })));
1748
- promptHandles.set(p.name, {
1749
- handle,
1750
- raw
1751
- });
1752
- }
1753
- for (const [name, entry] of [...promptHandles]) if (!seen.has(name)) {
1754
- entry.handle.remove();
1755
- promptHandles.delete(name);
1756
- }
1757
- }
1758
- async function syncResources() {
1759
- const [{ resources }, { resourceTemplates }] = await Promise.all([withUpstream((c) => c.listResources()), withUpstream((c) => c.listResourceTemplates())]);
1760
- const seenStatic = /* @__PURE__ */ new Set();
1761
- for (const r of resources) {
1762
- const uri = r.uri;
1763
- seenStatic.add(uri);
1764
- const raw = JSON.stringify(r);
1765
- const known = resourceHandles.get(uri);
1766
- if (known && known.raw === raw) continue;
1767
- known?.handle.remove();
1768
- resourceHandles.delete(uri);
1769
- const handle = mcp.registerResource(r.name, uri, {
1770
- title: r.title,
1771
- description: r.description,
1772
- mimeType: r.mimeType
1773
- }, async (u) => withUpstream((c) => c.readResource({ uri: u.href })));
1774
- resourceHandles.set(uri, {
1775
- handle,
1776
- raw
1777
- });
1778
- }
1779
- for (const [key, entry] of [...resourceHandles]) if (!seenStatic.has(key)) {
1780
- entry.handle.remove();
1781
- resourceHandles.delete(key);
1782
- }
1783
- const seenTpl = /* @__PURE__ */ new Set();
1784
- for (const t of resourceTemplates) {
1785
- const tpl = String(t.uriTemplate);
1786
- seenTpl.add(tpl);
1787
- const raw = JSON.stringify(t);
1788
- const known = templateHandles.get(tpl);
1789
- if (known && known.raw === raw) continue;
1790
- known?.handle.remove();
1791
- templateHandles.delete(tpl);
1792
- const handle = mcp.registerResource(t.name, new ResourceTemplate(tpl, { list: void 0 }), {
1793
- title: t.title,
1794
- description: t.description,
1795
- mimeType: t.mimeType
1796
- }, async (u, vars) => {
1797
- return withUpstream((c) => c.readResource({ uri: u.href }));
1798
- });
1799
- templateHandles.set(tpl, {
1800
- handle,
1801
- raw
1802
- });
1803
- }
1804
- for (const [key, entry] of [...templateHandles]) if (!seenTpl.has(key)) {
1805
- entry.handle.remove();
1806
- templateHandles.delete(key);
1807
- }
1808
- }
1809
- const resyncAll = async () => {
1810
- const results = await Promise.allSettled([
1811
- syncTools(),
1812
- syncPrompts(),
1813
- syncResources()
1814
- ]);
1815
- for (const r of results) if (r.status === "rejected") warn(`同步清单失败: ${String(r.reason).slice(0, 120)}`);
1816
- };
1817
- const ensureReconnect = () => {
1818
- if (reconnectPromise) return reconnectPromise;
1819
- reconnectPromise = (async () => {
1820
- const deadline = Date.now() + RECONNECT_BUDGET_MS;
1821
- let lastError = null;
1822
- while (Date.now() < deadline) {
1823
- try {
1824
- const p = await probeUpstream();
1825
- if (p.state === "proxy") {
1826
- upstream = p.client;
1827
- wireUpstream(upstream);
1828
- enterFastPoll();
1829
- log("shim: 上游已恢复");
1830
- await resyncAll();
1831
- return;
1832
- }
1833
- if (p.state === "none") spawnDaemon();
1834
- } catch (e) {
1835
- lastError = e;
1836
- }
1837
- await delay(RECONNECT_DELAY_MS);
1838
- }
1839
- throw lastError ?? /* @__PURE__ */ new Error(`上游重连超时(${RECONNECT_BUDGET_MS}ms)`);
1840
- })().finally(() => {
1841
- reconnectPromise = null;
1842
- });
1843
- return reconnectPromise;
1844
- };
1845
- const wireUpstream = (client) => {
1846
- client.onclose = () => {
1847
- if (shuttingDown) return;
1848
- warn("shim: 上游断开,自动重连");
1849
- ensureReconnect().catch(() => {});
1850
- };
1851
- client.setNotificationHandler("notifications/tools/list_changed", async () => syncTools().catch(() => {}));
1852
- client.setNotificationHandler("notifications/prompts/list_changed", async () => syncPrompts().catch(() => {}));
1853
- client.setNotificationHandler("notifications/resources/list_changed", async () => syncResources().catch(() => {}));
1854
- client.setNotificationHandler("notifications/resources/updated", async (notification) => {
1855
- const params = notification.params;
1856
- if (params?.uri != null) await mcp.server.sendResourceUpdated({ uri: params.uri }).catch(() => {});
1857
- });
1858
- };
1859
- wireUpstream(upstream);
1860
- const stdioHandle = serveStdio(async () => {
1861
- await resyncAll();
1862
- return mcp;
1863
- });
1864
- let fastUntil = Date.now() + POLL_FAST_WINDOW_MS;
1865
- let pollTimer = null;
1866
- const schedulePoll = () => {
1867
- if (shuttingDown) return;
1868
- pollTimer = setTimeout(() => {
1869
- if (shuttingDown) return;
1870
- resyncAll();
1871
- schedulePoll();
1872
- }, Date.now() < fastUntil ? POLL_FAST_MS : POLL_SLOW_MS);
1873
- pollTimer.unref();
1874
- };
1875
- const enterFastPoll = () => {
1876
- fastUntil = Date.now() + POLL_FAST_WINDOW_MS;
1877
- };
1878
- schedulePoll();
1879
- log("shim 模式: stdio → 动态同步,共享 daemon");
1880
- process.on("SIGINT", async () => {
1881
- shuttingDown = true;
1882
- if (pollTimer) clearTimeout(pollTimer);
1883
- await stdioHandle.close();
1884
- await upstream.close().catch(() => {});
1885
- process.exit(0);
1886
- });
1887
- }
1888
- //#endregion
1889
- //#region src/core/response.ts
1890
- function text$1(content) {
1891
- return { content: [{
1892
- type: "text",
1893
- text: typeof content === "string" ? content : JSON.stringify(content, null, 2)
1894
- }] };
1895
- }
1896
- function typeName(schema) {
1897
- return schema._def?.typeName;
1898
- }
1899
- function innerOf(schema, key) {
1900
- return schema._def?.[key];
1901
- }
1902
- function valueOf(schema, key) {
1903
- return schema._def?.[key];
1904
- }
1905
- /** 从 zod schema 推导"空形状",保证失败/畸形结果也能通过 outputSchema 校验 */
1906
- function emptyFor(schema) {
1907
- switch (typeName(schema)) {
1908
- case "ZodObject": {
1909
- const shapeFn = schema.shape;
1910
- if (typeof shapeFn !== "function") return void 0;
1911
- const out = {};
1912
- for (const [k, v] of Object.entries(shapeFn())) out[k] = emptyFor(v);
1913
- return out;
1914
- }
1915
- case "ZodArray": return [];
1916
- case "ZodBoolean": return false;
1917
- case "ZodNumber": return 0;
1918
- case "ZodString": return "";
1919
- case "ZodLiteral": return valueOf(schema, "value");
1920
- case "ZodEnum": return valueOf(schema, "values")?.[0];
1921
- case "ZodOptional":
1922
- case "ZodDefault": {
1923
- const inner = innerOf(schema, "innerType");
1924
- return inner ? emptyFor(inner) : void 0;
1925
- }
1926
- case "ZodEffects": {
1927
- const inner = innerOf(schema, "schema");
1928
- return inner ? emptyFor(inner) : void 0;
1929
- }
1930
- case "ZodUnion": {
1931
- const opts = valueOf(schema, "options") ?? [];
1932
- const arr = opts.find((o) => typeName(o) === "ZodArray");
1933
- return arr ? emptyFor(arr) : opts[0] ? emptyFor(opts[0]) : void 0;
1934
- }
1935
- case "ZodLazy": {
1936
- const getter = schema._def?.getter;
1937
- return getter ? emptyFor(getter()) : void 0;
1938
- }
1939
- default: return;
1940
- }
1941
- }
1942
- /** 错误返回:人读文本 + schema-valid 结构化空结果 + isError,避免"no structured content" */
1943
- function err(e, schema) {
1944
- const base = {
1945
- content: [{
1946
- type: "text",
1947
- text: `错误: ${e instanceof Error ? e.message : String(e)}`
1948
- }],
1949
- isError: true
1950
- };
1951
- return schema ? {
1952
- ...base,
1953
- structuredContent: emptyFor(schema)
1954
- } : base;
1955
- }
1956
- /** 返回类型:人读文本 + 结构化数据(与 outputSchema 对应)。
1957
- * extra 为成功时的附加文本块(置于 JSON 文本之前),用于进度/汇总/逐条失败提示,
1958
- * 与参考实现(set_multiple_text_contents 多段 content)对齐。 */
1959
- function structured(data, schema, extra) {
1960
- if (schema) {
1961
- const parsed = schema.safeParse(data);
1962
- if (parsed.success) return {
1963
- content: [...extra ?? [], ...text$1(data).content],
1964
- structuredContent: parsed.data
1965
- };
1966
- return {
1967
- content: text$1(data).content,
1968
- structuredContent: emptyFor(schema),
1969
- isError: true
1970
- };
1971
- }
1972
- return {
1973
- content: [...extra ?? [], ...text$1(data).content],
1974
- structuredContent: data
1975
- };
1976
- }
1977
- //#endregion
1978
- //#region src/core/registry.ts
1979
- /** 工具名 → 执行体(daemon 单进程多会话共享;重复注册以后者为准,行为一致) */
1980
- var executors = /* @__PURE__ */ new Map();
1981
- /** 按名查找执行体;未注册工具返回 undefined */
1982
- function lookupExecutor(name) {
1983
- return executors.get(name);
1984
- }
1985
- /** 全部已注册工具名(排序;jsd_batch 报错提示用) */
1986
- function executorNames() {
1987
- return [...executors.keys()].sort();
1988
- }
1989
- /**
1990
- * 声明式工具工厂:统一 try/catch → structured/err 兜底、超时分级、
1991
- * annotations、客户端取消(signal)传播。返回注册函数,产出工具句柄
1992
- * (供插件离线时动态 disable)。
1993
- */
1994
- function bridgeTool(def) {
1995
- return (server, bridge) => {
1996
- const register = server.registerTool.bind(server);
1997
- const executeTool = async (args, signal) => {
1998
- try {
1999
- if (def.inputSchema != null) {
2000
- const parsed = def.inputSchema.safeParse(args);
2001
- if (!parsed.success) {
2002
- const detail = parsed.error.issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ");
2003
- throw new Error(`参数校验失败(${def.name}): ${detail}`);
2004
- }
2005
- args = parsed.data;
2006
- }
2007
- const opts = {
2008
- ...signal != null ? { signal } : {},
2009
- ...def.timeout != null ? { timeout: def.timeout } : {}
2010
- };
2011
- let data;
2012
- if (def.run) data = await def.run(args, bridge, signal ?? new AbortController().signal);
2013
- else data = await bridge.request(def.method, def.payload ? def.payload(args) : args, opts);
2014
- return structured(data, def.outputSchema, def.extraContent ? def.extraContent(data, args) : void 0);
2015
- } catch (e) {
2016
- const msg = e instanceof Error ? e.message : String(e);
2017
- error(`工具 ${def.name} 执行失败: ${msg.slice(0, 200)}`);
2018
- return err(e, def.outputSchema);
2019
- }
2020
- };
2021
- executors.set(def.name, executeTool);
2022
- const handle = register(def.name, {
2023
- title: def.title,
2024
- description: def.description,
2025
- ...def.inputSchema ? { inputSchema: def.inputSchema } : {},
2026
- outputSchema: def.outputSchema,
2027
- ...def.annotations ? { annotations: def.annotations } : {}
2028
- }, async (...cbArgs) => {
2029
- const hasInput = def.inputSchema != null;
2030
- const first = cbArgs[0];
2031
- const second = cbArgs[1];
2032
- const args = hasInput ? first ?? {} : {};
2033
- const ctx = hasInput ? second : first;
2034
- const signal = ctx?.mcpReq?.signal ?? ctx?.signal;
2035
- return executeTool(args, signal);
2036
- });
2037
- handle.alwaysEnabled = def.alwaysEnabled ?? false;
2038
- return handle;
2039
- };
2040
- }
2041
- //#endregion
2042
- //#region src/tools/batch.ts
2043
- /** 按点分路径(含 a[0].b 下标段)从步骤结果根对象取值;任一段不可达视为失败 */
2044
- function getPath(root, path) {
2045
- let cur = root;
2046
- for (const part of path.split(".")) {
2047
- const m = /^([\w$\u4e00-\u9fff-]*)((?:\[\d+\])*)$/.exec(part.trim());
2048
- if (m == null) return { ok: false };
2049
- if (m[1] !== "") {
2050
- if (cur == null || typeof cur !== "object") return { ok: false };
2051
- cur = cur[m[1]];
2052
- }
2053
- if (m[2] !== "") for (const idx of m[2].matchAll(/\[(\d+)\]/g)) {
2054
- if (!Array.isArray(cur)) return { ok: false };
2055
- cur = cur[Number(idx[1])];
2056
- }
2057
- }
2058
- return {
2059
- ok: true,
2060
- value: cur
2061
- };
2062
- }
2063
- /** 解析单个引用表达式 'stepId.a.b[0]';步骤不存在/路径不可达时抛错(附可用步骤) */
2064
- function resolveRef(expr, steps) {
2065
- const dot = expr.indexOf(".");
2066
- const id = dot === -1 ? expr : expr.slice(0, dot);
2067
- const path = dot === -1 ? "" : expr.slice(dot + 1);
2068
- if (!steps.has(id)) {
2069
- const known = [...steps.keys()].join(", ") || "无";
2070
- throw new Error(`占位符引用的步骤不存在或未成功:「${expr}」(已完成: ${known})`);
2071
- }
2072
- const root = steps.get(id);
2073
- if (path === "") return root;
2074
- const r = getPath(root, path);
2075
- if (!r.ok) throw new Error(`无法解析占位符引用「${expr}」:请核对步骤 ${id} 的返回结构`);
2076
- return r.value;
2077
- }
2078
- var REF_RE = /\{\{\s*([^{}]+?)\s*\}\}/g;
2079
- var WHOLE_REF_RE = /^\{\{\s*([^{}]+?)\s*\}\}$/;
2080
- /** 深度遍历入参:引用占位符独占整值时保留原类型;内嵌于长字符串时以 JSON 文本展开 */
2081
- function resolveRefs(value, steps) {
2082
- if (typeof value === "string") {
2083
- const whole = WHOLE_REF_RE.exec(value.trim());
2084
- if (whole != null) return resolveRef(whole[1], steps);
2085
- return value.replace(REF_RE, (_, expr) => {
2086
- const v = resolveRef(expr, steps);
2087
- return typeof v === "string" ? v : JSON.stringify(v);
2088
- });
2089
- }
2090
- if (Array.isArray(value)) return value.map((v) => resolveRefs(v, steps));
2091
- if (value != null && typeof value === "object") {
2092
- const out = {};
2093
- for (const [k, v] of Object.entries(value)) out[k] = resolveRefs(v, steps);
2094
- return out;
2095
- }
2096
- return value;
2097
- }
2098
- /** 编排类:服务端顺序执行多步 jsd_* 工具,中间值经占位符注入、不回传模型 */
2099
- function registerBatchTools(server, bridge) {
2100
- return [bridgeTool({
2101
- name: "jsd_batch",
2102
- title: "批量编排执行",
2103
- description: `批量编排器:一次请求内顺序执行多个 jsd_* 步骤,前一步结果经双花括号占位符(内容为 步骤id.字段路径)注入后一步 args,中间 id 不回传模型,显著减少往返与上下文。
2104
- 占位符独占一个参数值时保留原类型(数组可直接作 ids 用),嵌在字符串中按 JSON 文本展开;id 重复/未知工具/引用失败立即中止,工具执行失败默认也中止(stopOnError=false 或单步 continueOnError=true 可走完)。每步只回传 structuredContent。`,
2105
- inputSchema: batchSchema,
2106
- outputSchema: batchResultSchema,
2107
- annotations: {
2108
- readOnlyHint: false,
2109
- destructiveHint: true
2110
- },
2111
- timeout: BATCH_TIMEOUT_MS,
2112
- run: async (args, _bridge, signal) => {
2113
- const { calls, stopOnError } = args;
2114
- const steps = /* @__PURE__ */ new Map();
2115
- const results = [];
2116
- for (let i = 0; i < calls.length; i++) {
2117
- const call = calls[i];
2118
- const id = call.id == null || call.id.trim() === "" ? `step${i + 1}` : call.id.trim();
2119
- const fail = (msg) => {
2120
- results.push({
2121
- id,
2122
- tool: call.tool,
2123
- ok: false,
2124
- error: msg
2125
- });
2126
- };
2127
- if (steps.has(id) || results.some((r) => r.id === id)) {
2128
- fail(`步骤 id "${id}" 重复`);
2129
- break;
2130
- }
2131
- const executor = lookupExecutor(call.tool);
2132
- if (executor == null) {
2133
- fail(`未知工具 ${call.tool},可用: ${executorNames().join(", ")}`);
2134
- break;
2135
- }
2136
- let resolvedArgs;
2137
- try {
2138
- resolvedArgs = resolveRefs(call.args ?? {}, steps);
2139
- } catch (e) {
2140
- fail(e instanceof Error ? e.message : String(e));
2141
- break;
2142
- }
2143
- const out = await executor(resolvedArgs, signal);
2144
- if (out.isError === true) {
2145
- fail((out.content?.find((c) => c.type === "text")?.text ?? "工具返回错误").slice(0, 300));
2146
- if (!(stopOnError === false || call.continueOnError === true)) break;
2147
- continue;
2148
- }
2149
- steps.set(id, out.structuredContent);
2150
- results.push({
2151
- id,
2152
- tool: call.tool,
2153
- ok: true,
2154
- data: out.structuredContent
2155
- });
2156
- }
2157
- return {
2158
- ok: results.length === calls.length && results.every((r) => r.ok),
2159
- executed: results.length,
2160
- total: calls.length,
2161
- results
2162
- };
2163
- }
2164
- })(server, bridge)];
2165
- }
2166
- //#endregion
2167
- //#region src/htmlToDesign.ts
2168
- var SKIP_TAGS = /* @__PURE__ */ new Set([
2169
- "script",
2170
- "style",
2171
- "head",
2172
- "meta",
2173
- "link",
2174
- "title",
2175
- "noscript"
2176
- ]);
2177
- var COLORS = {
2178
- white: "#ffffff",
2179
- black: "#000000",
2180
- red: "#ff0000",
2181
- green: "#008000",
2182
- blue: "#0000ff",
2183
- gray: "#808080",
2184
- grey: "#808080",
2185
- transparent: "none"
2186
- };
2187
- var FALLBACK_BG = "#f3f4f6";
2188
- function parseStyle(attr) {
2189
- const out = {};
2190
- if (!attr) return out;
2191
- for (const part of attr.split(";")) {
2192
- const i = part.indexOf(":");
2193
- if (i < 0) continue;
2194
- const key = part.slice(0, i).trim().toLowerCase();
2195
- const val = part.slice(i + 1).trim();
2196
- if (key) out[key] = val;
2197
- }
2198
- return out;
2199
- }
2200
- function num(value) {
2201
- if (value == null) return void 0;
2202
- const m = value.match(/^(-?[\d.]+)(px)?$/);
2203
- return m ? parseFloat(m[1]) : void 0;
2204
- }
2205
- function color(value, fallback) {
2206
- if (value == null || value === "") return fallback;
2207
- const v = value.trim();
2208
- if (v === "transparent") return "none";
2209
- const named = COLORS[v.toLowerCase()];
2210
- if (named) return named;
2211
- if (v.startsWith("#") || v.startsWith("rgb")) return v;
2212
- return fallback;
2213
- }
2214
- function parseMargin(style) {
2215
- const parts = (style.margin ?? "").split(/\s+/).filter(Boolean).map((p) => num(p) ?? 0);
2216
- let top = 0, right = 0, bottom = 0, left = 0;
2217
- if (parts.length === 1) top = right = bottom = left = parts[0];
2218
- else if (parts.length === 2) {
2219
- top = bottom = parts[0];
2220
- right = left = parts[1];
2221
- } else if (parts.length === 4) {
2222
- top = parts[0];
2223
- right = parts[1];
2224
- bottom = parts[2];
2225
- left = parts[3];
2226
- }
2227
- top = num(style["margin-top"]) ?? top;
2228
- right = num(style["margin-right"]) ?? right;
2229
- bottom = num(style["margin-bottom"]) ?? bottom;
2230
- left = num(style["margin-left"]) ?? left;
2231
- return {
2232
- top,
2233
- right,
2234
- bottom,
2235
- left
2236
- };
2237
- }
2238
- function parsePadding(style) {
2239
- const parts = (style.padding ?? "").split(/\s+/).filter(Boolean).map((p) => num(p) ?? 0);
2240
- let top = 0, right = 0, bottom = 0, left = 0;
2241
- if (parts.length === 1) top = right = bottom = left = parts[0];
2242
- else if (parts.length === 2) {
2243
- top = bottom = parts[0];
2244
- right = left = parts[1];
2245
- } else if (parts.length === 4) {
2246
- top = parts[0];
2247
- right = parts[1];
2248
- bottom = parts[2];
2249
- left = parts[3];
2250
- }
2251
- top = num(style["padding-top"]) ?? top;
2252
- right = num(style["padding-right"]) ?? right;
2253
- bottom = num(style["padding-bottom"]) ?? bottom;
2254
- left = num(style["padding-left"]) ?? left;
2255
- return {
2256
- top,
2257
- right,
2258
- bottom,
2259
- left
2260
- };
2261
- }
2262
- function parseBorder(style) {
2263
- const none = {
2264
- width: 0,
2265
- color: "#000000"
2266
- };
2267
- const s = style.border;
2268
- if (s && s !== "none" && s !== "0") {
2269
- const m = s.match(/([\d.]+)(?:px)?(?:\s+[^ ]+)?\s+(.+)$/);
2270
- if (m) return {
2271
- width: parseFloat(m[1]) || 1,
2272
- color: color(m[2]) ?? "#000000"
2273
- };
2274
- const m2 = s.match(/([\d.]+)(?:px)?/);
2275
- if (m2) return {
2276
- width: parseFloat(m2[1]),
2277
- color: "#000000"
2278
- };
2279
- }
2280
- if (style["border-width"] && style["border-width"] !== "0" && style["border-width"] !== "none") return {
2281
- width: num(style["border-width"]) ?? 1,
2282
- color: color(style["border-color"]) ?? "#000000"
2283
- };
2284
- return none;
2285
- }
2286
- function px(style, key) {
2287
- return num(style[key]);
2288
- }
2289
- function fontSize(style) {
2290
- return num(style["font-size"]) ?? 16;
2291
- }
2292
- function fontWeight(style) {
2293
- const w = style["font-weight"];
2294
- if (w === "bold") return 700;
2295
- return num(w) ?? 400;
2296
- }
2297
- function lineHeight(style, fs) {
2298
- const lh = style["line-height"];
2299
- const n = num(lh);
2300
- if (n != null) return n;
2301
- if (lh != null && !lh.endsWith("px")) return parseFloat(lh) * fs;
2302
- return fs * 1.4;
2303
- }
2304
- function displayFlex(style) {
2305
- return (style.display ?? "").includes("flex");
2306
- }
2307
- function flexDirection(style) {
2308
- return style["flex-direction"] === "row" ? "row" : "column";
2309
- }
2310
- function gapValue(style) {
2311
- return num(style.gap) ?? num(style["row-gap"]) ?? 0;
2312
- }
2313
- function textAlign(style) {
2314
- const a = style["text-align"];
2315
- if (a === "center") return "center";
2316
- if (a === "right") return "right";
2317
- return "left";
2318
- }
2319
- function estTextWidth(text, fs) {
2320
- let w = 0;
2321
- for (const ch of text) if (ch.charCodeAt(0) > 11904) w += fs;
2322
- else w += fs * .55;
2323
- return w;
2324
- }
2325
- function collectText(node) {
2326
- if (node.type === "text") return node.data;
2327
- if (isTag(node)) {
2328
- if (node.tagName === "br") return "\n";
2329
- return node.children.map(collectText).join("");
2330
- }
2331
- return "";
2332
- }
2333
- function trimCollapse(text) {
2334
- return text.replace(/\s+/g, " ").trim();
2335
- }
2336
- function parseBox(parent, root) {
2337
- const style = parseStyle(parent.attribs.style);
2338
- const box = {
2339
- tag: parent.tagName,
2340
- style,
2341
- children: [],
2342
- isText: false,
2343
- x: 0,
2344
- y: 0,
2345
- w: 0,
2346
- h: 0
2347
- };
2348
- if (parent.tagName === "img") {
2349
- box.w = px(style, "width") ?? 120;
2350
- box.h = px(style, "height") ?? 120;
2351
- return box;
2352
- }
2353
- for (const child of parent.children) {
2354
- if (child.type === "text") {
2355
- const t = trimCollapse(child.data);
2356
- if (!t) continue;
2357
- const last = box.children[box.children.length - 1];
2358
- if (last?.isText) last.text = (last.text ?? "") + t;
2359
- else box.children.push({
2360
- tag: "#text",
2361
- text: t,
2362
- style: inheritTextStyle(style),
2363
- children: [],
2364
- isText: true,
2365
- x: 0,
2366
- y: 0,
2367
- w: 0,
2368
- h: 0
2369
- });
2370
- continue;
2371
- }
2372
- if (!isTag(child)) continue;
2373
- if (SKIP_TAGS.has(child.tagName)) continue;
2374
- if (child.tagName === "br") continue;
2375
- box.children.push(parseBox(child, false));
2376
- }
2377
- if (root && box.children.length === 0) {
2378
- const t = trimCollapse(parent.children.map(collectText).join(""));
2379
- if (t) box.children.push({
2380
- tag: "#text",
2381
- text: t,
2382
- style: inheritTextStyle(style),
2383
- children: [],
2384
- isText: true,
2385
- x: 0,
2386
- y: 0,
2387
- w: 0,
2388
- h: 0
2389
- });
2390
- }
2391
- return box;
2392
- }
2393
- function inheritTextStyle(parent) {
2394
- const out = {};
2395
- for (const k of [
2396
- "color",
2397
- "font-size",
2398
- "font-weight",
2399
- "font-family",
2400
- "line-height",
2401
- "text-align",
2402
- "letter-spacing"
2403
- ]) if (parent[k] != null) out[k] = parent[k];
2404
- return out;
2405
- }
2406
- function layout$1(box, maxWidth) {
2407
- const style = box.style;
2408
- const pad = parsePadding(style);
2409
- const margin = parseMargin(style);
2410
- const border = parseBorder(style);
2411
- const innerW = Math.max(0, maxWidth - pad.left - pad.right - border.width * 2);
2412
- if (box.tag === "img") {
2413
- box.w = px(style, "width") ?? 120;
2414
- box.h = px(style, "height") ?? 120;
2415
- return {
2416
- width: box.w + margin.left + margin.right,
2417
- height: box.h + margin.top + margin.bottom
2418
- };
2419
- }
2420
- let contentW = innerW;
2421
- let contentH = 0;
2422
- if (box.isText) {
2423
- const fs = fontSize(style);
2424
- const lines = (box.text ?? "").split("\n").map((l) => l.trim()).filter(Boolean);
2425
- box.w = Math.min(innerW, Math.max(...lines.map((l) => estTextWidth(l, fs)), fs));
2426
- box.h = lines.length * lineHeight(style, fs);
2427
- contentH = box.h;
2428
- } else {
2429
- const flex = displayFlex(style);
2430
- const direction = flexDirection(style);
2431
- const gap = gapValue(style);
2432
- const explicitW = px(style, "width");
2433
- const explicitH = px(style, "height");
2434
- if (explicitW != null) contentW = Math.max(0, explicitW - pad.left - pad.right - border.width * 2);
2435
- if (flex && direction === "row") {
2436
- let x = 0;
2437
- let rowH = 0;
2438
- for (const child of box.children) {
2439
- const r = layout$1(child, contentW - x);
2440
- child.x = x + pad.left + border.width;
2441
- child.y = pad.top + border.width;
2442
- if (child.isText && textAlign(child.style) !== "left") child.w = contentW - x;
2443
- x += r.width;
2444
- x += gap;
2445
- rowH = Math.max(rowH, r.height);
2446
- }
2447
- contentH = rowH;
2448
- box.w = x - (box.children.length ? gap : 0);
2449
- } else {
2450
- let y = 0;
2451
- let maxW = 0;
2452
- for (const child of box.children) {
2453
- const r = layout$1(child, contentW);
2454
- child.x = pad.left + border.width;
2455
- child.y = y + pad.top + border.width;
2456
- if (child.isText && textAlign(child.style) !== "left") child.w = contentW;
2457
- y += r.height;
2458
- y += gap;
2459
- maxW = Math.max(maxW, r.width);
2460
- }
2461
- contentH = y - (box.children.length ? gap : 0);
2462
- box.w = maxW;
2463
- }
2464
- box.w = explicitW ?? box.w;
2465
- box.h = explicitH ?? contentH;
2466
- contentH = explicitH ?? contentH;
2467
- }
2468
- const padW = pad.left + pad.right + border.width * 2;
2469
- const padH = pad.top + pad.bottom + border.width * 2;
2470
- if (px(style, "width") == null) box.w += padW;
2471
- if (px(style, "height") == null && !box.isText) box.h += padH;
2472
- return {
2473
- width: box.w + margin.left + margin.right,
2474
- height: box.h + margin.top + margin.bottom
2475
- };
2476
- }
2477
- function applyMarginOffset(box) {
2478
- const margin = parseMargin(box.style);
2479
- box.x += margin.left;
2480
- box.y += margin.top;
2481
- }
2482
- function emitSvg(box, rootWidth, rootHeight) {
2483
- const parts = [];
2484
- emit(box, parts, 0, 0);
2485
- return `<svg xmlns="http://www.w3.org/2000/svg" width="${rootWidth}" height="${rootHeight}" viewBox="0 0 ${rootWidth} ${rootHeight}">${parts.join("")}</svg>`;
2486
- }
2487
- function emit(box, parts, ox, oy) {
2488
- const style = box.style;
2489
- const x = ox + box.x;
2490
- const y = oy + box.y;
2491
- const w = box.w;
2492
- const h = box.h;
2493
- if (box.isText) {
2494
- const fs = fontSize(style);
2495
- const fill = color(style.color, "#000000");
2496
- const family = style["font-family"] ?? "sans-serif";
2497
- const weight = fontWeight(style);
2498
- const align = textAlign(style);
2499
- const anchor = align === "center" ? "middle" : align === "right" ? "end" : "start";
2500
- const tx = align === "center" ? x + w / 2 : align === "right" ? x + w : x;
2501
- const lineH = lineHeight(style, fs);
2502
- (box.text ?? "").split("\n").filter((l) => l.trim()).forEach((line, i) => {
2503
- parts.push(`<text x="${tx.toFixed(1)}" y="${(y + lineH * i + fs).toFixed(1)}" font-size="${fs}" font-family="${family}" font-weight="${weight}" fill="${fill}" text-anchor="${anchor}">${escapeXml(line)}</text>`);
2504
- });
2505
- return;
2506
- }
2507
- const bg = color(style.background ?? style["background-color"], box.tag === "img" ? FALLBACK_BG : void 0);
2508
- const border = parseBorder(style);
2509
- const radius = num(style["border-radius"]) ?? 0;
2510
- const visible = bg && bg !== "none";
2511
- if (box.tag === "img" || visible || border.width > 0) {
2512
- const attrs = [
2513
- `x="${x.toFixed(1)}"`,
2514
- `y="${y.toFixed(1)}"`,
2515
- `width="${Math.max(0, w).toFixed(1)}"`,
2516
- `height="${Math.max(0, h).toFixed(1)}"`
2517
- ];
2518
- if (radius > 0) attrs.push(`rx="${radius}"`);
2519
- if (visible) attrs.push(`fill="${bg}"`);
2520
- if (border.width > 0) attrs.push(`stroke="${border.color}" stroke-width="${border.width}"`);
2521
- parts.push(`<rect ${attrs.join(" ")} />`);
2522
- }
2523
- for (const child of box.children) {
2524
- applyMarginOffset(child);
2525
- emit(child, parts, x, y);
2526
- }
2527
- }
2528
- function escapeXml(s) {
2529
- return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
2530
- }
2531
- function htmlToSvg(html) {
2532
- const rootEls = parseDocument(html, { decodeEntities: true }).children.filter((n) => isTag(n));
2533
- const bodyEl = rootEls.find((el) => el.tagName === "body") ?? rootEls[0];
2534
- if (!bodyEl) return `<svg xmlns="http://www.w3.org/2000/svg" width="1" height="1" viewBox="0 0 1 1"></svg>`;
2535
- const root = parseBox(bodyEl, true);
2536
- const rootStyle = parseStyle(bodyEl.attribs.style);
2537
- const explicitW = px(rootStyle, "width");
2538
- const explicitH = px(rootStyle, "height");
2539
- const l = layout$1(root, explicitW ?? 800);
2540
- const width = explicitW ?? Math.min(l.width, 1600);
2541
- const height = explicitH ?? l.height;
2542
- root.x = 0;
2543
- root.y = 0;
2544
- if (explicitW == null) root.w = width;
2545
- if (explicitH == null) root.h = height;
2546
- return emitSvg(root, width, height);
2547
- }
2548
- //#endregion
2549
- //#region src/icons.ts
2550
- var ALIAS_MAP = {
2551
- "activity-square": "square-activity",
2552
- "alarm-check": "alarm-clock-check",
2553
- "alarm-minus": "alarm-clock-minus",
2554
- "alarm-plus": "alarm-clock-plus",
2555
- "alert-circle": "circle-alert",
2556
- "alert-octagon": "octagon-alert",
2557
- "alert-triangle": "triangle-alert",
2558
- "align-center": "text-align-center",
2559
- "align-justify": "text-align-justify",
2560
- "align-left": "text-align-start",
2561
- "align-right": "text-align-end",
2562
- angry: "face-angry",
2563
- annoyed: "face-expressionless",
2564
- "area-chart": "chart-area",
2565
- "arrow-down-01": "arrow-down-0-1",
2566
- "arrow-down-10": "arrow-down-1-0",
2567
- "arrow-down-az": "arrow-down-a-z",
2568
- "arrow-down-circle": "circle-arrow-down",
2569
- "arrow-down-left-from-circle": "circle-arrow-out-down-left",
2570
- "arrow-down-left-from-square": "square-arrow-out-down-left",
2571
- "arrow-down-left-square": "square-arrow-down-left",
2572
- "arrow-down-right-from-circle": "circle-arrow-out-down-right",
2573
- "arrow-down-right-from-square": "square-arrow-out-down-right",
2574
- "arrow-down-right-square": "square-arrow-down-right",
2575
- "arrow-down-square": "square-arrow-down",
2576
- "arrow-down-za": "arrow-down-z-a",
2577
- "arrow-left-circle": "circle-arrow-left",
2578
- "arrow-left-square": "square-arrow-left",
2579
- "arrow-right-circle": "circle-arrow-right",
2580
- "arrow-right-square": "square-arrow-right",
2581
- "arrow-up-01": "arrow-up-0-1",
2582
- "arrow-up-10": "arrow-up-1-0",
2583
- "arrow-up-az": "arrow-up-a-z",
2584
- "arrow-up-circle": "circle-arrow-up",
2585
- "arrow-up-left-from-circle": "circle-arrow-out-up-left",
2586
- "arrow-up-left-from-square": "square-arrow-out-up-left",
2587
- "arrow-up-left-square": "square-arrow-up-left",
2588
- "arrow-up-right-from-circle": "circle-arrow-out-up-right",
2589
- "arrow-up-right-from-square": "square-arrow-out-up-right",
2590
- "arrow-up-right-square": "square-arrow-up-right",
2591
- "arrow-up-square": "square-arrow-up",
2592
- "arrow-up-za": "arrow-up-z-a",
2593
- "asterisk-square": "square-asterisk",
2594
- "axis-3-d": "axis-3d",
2595
- "badge-help": "badge-question-mark",
2596
- "bar-chart": "chart-no-axes-column-increasing",
2597
- "bar-chart-2": "chart-no-axes-column",
2598
- "bar-chart-3": "chart-column",
2599
- "bar-chart-4": "chart-column-increasing",
2600
- "bar-chart-big": "chart-column-big",
2601
- "bar-chart-horizontal": "chart-bar",
2602
- "bar-chart-horizontal-big": "chart-bar-big",
2603
- "between-horizonal-end": "between-horizontal-end",
2604
- "between-horizonal-start": "between-horizontal-start",
2605
- "book-template": "book-dashed",
2606
- "box-select": "square-dashed",
2607
- "candlestick-chart": "chart-candlestick",
2608
- "check-circle": "circle-check-big",
2609
- "check-circle-2": "circle-check",
2610
- "check-square": "square-check-big",
2611
- "check-square-2": "square-check",
2612
- "chevron-down-circle": "circle-chevron-down",
2613
- "chevron-down-square": "square-chevron-down",
2614
- "chevron-left-circle": "circle-chevron-left",
2615
- "chevron-left-square": "square-chevron-left",
2616
- "chevron-right-circle": "circle-chevron-right",
2617
- "chevron-right-square": "square-chevron-right",
2618
- "chevron-up-circle": "circle-chevron-up",
2619
- "chevron-up-square": "square-chevron-up",
2620
- "circle-help": "circle-question-mark",
2621
- "circle-slashed": "circle-slash-2",
2622
- "clipboard-edit": "clipboard-pen",
2623
- "clipboard-signature": "clipboard-pen-line",
2624
- "code-2": "code-xml",
2625
- "code-square": "square-code",
2626
- columns: "columns-2",
2627
- "columns-settings": "columns-3-cog",
2628
- "contact-2": "contact-round",
2629
- "curly-braces": "braces",
2630
- "divide-circle": "circle-divide",
2631
- "divide-square": "square-divide",
2632
- "dot-square": "square-dot",
2633
- "download-cloud": "cloud-download",
2634
- edit: "square-pen",
2635
- "edit-2": "pen",
2636
- "edit-3": "pen-line",
2637
- "equal-square": "square-equal",
2638
- "file-audio": "file-headphone",
2639
- "file-audio-2": "file-headphone",
2640
- "file-axis-3-d": "file-axis-3d",
2641
- "file-badge-2": "file-badge",
2642
- "file-bar-chart": "file-chart-column-increasing",
2643
- "file-bar-chart-2": "file-chart-column",
2644
- "file-check-2": "file-check-corner",
2645
- "file-code-2": "file-code-corner",
2646
- "file-cog-2": "file-cog",
2647
- "file-edit": "file-pen",
2648
- "file-json": "file-braces",
2649
- "file-json-2": "file-braces-corner",
2650
- "file-key-2": "file-key",
2651
- "file-line-chart": "file-chart-line",
2652
- "file-lock-2": "file-lock",
2653
- "file-minus-2": "file-minus-corner",
2654
- "file-pie-chart": "file-chart-pie",
2655
- "file-plus-2": "file-plus-corner",
2656
- "file-question": "file-question-mark",
2657
- "file-search-2": "file-search-corner",
2658
- "file-signature": "file-pen-line",
2659
- "file-type-2": "file-type-corner",
2660
- "file-video": "file-play",
2661
- "file-video-2": "file-video-camera",
2662
- "file-volume-2": "file-signal",
2663
- "file-warning": "file-exclamation-point",
2664
- "file-x-2": "file-x-corner",
2665
- filter: "funnel",
2666
- "filter-x": "funnel-x",
2667
- fingerprint: "fingerprint-pattern",
2668
- "flip-horizontal": "square-centerline-dashed-horizontal",
2669
- "flip-vertical": "square-centerline-dashed-vertical",
2670
- "folder-cog-2": "folder-cog",
2671
- "folder-edit": "folder-pen",
2672
- "fork-knife": "utensils",
2673
- "fork-knife-crossed": "utensils-crossed",
2674
- "form-input": "rectangle-ellipsis",
2675
- frown: "face-slightly-frowning",
2676
- "function-square": "square-function",
2677
- "gantt-chart": "chart-no-axes-gantt",
2678
- "gantt-chart-square": "square-chart-gantt",
2679
- "gauge-circle": "circle-gauge",
2680
- "git-commit": "git-commit-horizontal",
2681
- "globe-2": "earth",
2682
- grab: "hand-grab",
2683
- grid: "grid-3x3",
2684
- "grid-2-x-2": "grid-2x2",
2685
- "grid-2-x-2-check": "grid-2x2-check",
2686
- "grid-2-x-2-plus": "grid-2x2-plus",
2687
- "grid-2-x-2-x": "grid-2x2-x",
2688
- "grid-3-x-3": "grid-3x3",
2689
- "help-circle": "circle-question-mark",
2690
- "helping-hand": "hand-helping",
2691
- history: "rotate-ccw-clock",
2692
- home: "house",
2693
- "ice-cream": "ice-cream-cone",
2694
- "ice-cream-2": "ice-cream-bowl",
2695
- indent: "list-indent-increase",
2696
- "indent-decrease": "list-indent-decrease",
2697
- "indent-increase": "list-indent-increase",
2698
- inspect: "square-mouse-pointer",
2699
- "kanban-square": "square-kanban",
2700
- "kanban-square-dashed": "square-dashed-kanban",
2701
- "laptop-2": "laptop-minimal",
2702
- laugh: "face-grinning",
2703
- "layers-3": "layers",
2704
- layout: "panels-top-left",
2705
- "letter-text": "text-initial",
2706
- "library-square": "square-library",
2707
- "line-chart": "chart-line",
2708
- "loader-2": "loader-circle",
2709
- "location-edit": "map-pin-pen",
2710
- "m-square": "square-m",
2711
- "mail-question": "mail-question-mark",
2712
- meh: "face-neutral",
2713
- "menu-square": "square-menu",
2714
- "message-circle-question": "message-circle-question-mark",
2715
- "mic-2": "mic-vocal",
2716
- "minus-circle": "circle-minus",
2717
- "minus-square": "square-minus",
2718
- "more-horizontal": "ellipsis",
2719
- "more-vertical": "ellipsis-vertical",
2720
- "mouse-pointer-square-dashed": "square-dashed-mouse-pointer",
2721
- "move-3-d": "move-3d",
2722
- outdent: "list-indent-decrease",
2723
- "paintbrush-2": "paintbrush-vertical",
2724
- palmtree: "tree-palm",
2725
- "panel-bottom-inactive": "panel-bottom-dashed",
2726
- "panel-left-inactive": "panel-left-dashed",
2727
- "panel-right-inactive": "panel-right-dashed",
2728
- "panel-top-inactive": "panel-top-dashed",
2729
- "panels-left-right": "columns-3",
2730
- "panels-top-bottom": "rows-3",
2731
- "parking-circle": "circle-parking",
2732
- "parking-circle-off": "circle-parking-off",
2733
- "parking-square": "square-parking",
2734
- "parking-square-off": "square-parking-off",
2735
- "pause-circle": "circle-pause",
2736
- "pause-octagon": "octagon-pause",
2737
- "pen-box": "square-pen",
2738
- "pen-square": "square-pen",
2739
- "percent-circle": "circle-percent",
2740
- "percent-diamond": "diamond-percent",
2741
- "percent-square": "square-percent",
2742
- "pi-square": "square-pi",
2743
- "pie-chart": "chart-pie",
2744
- "pilcrow-square": "square-pilcrow",
2745
- "play-circle": "circle-play",
2746
- "play-square": "square-play",
2747
- "plug-zap-2": "plug-zap",
2748
- "plus-circle": "circle-plus",
2749
- "plus-square": "square-plus",
2750
- podcast: "mic-signal",
2751
- "power-circle": "circle-power",
2752
- "power-square": "square-power",
2753
- "rotate-3-d": "rotate-3d",
2754
- rows: "rows-2",
2755
- "scale-3-d": "scale-3d",
2756
- "scatter-chart": "chart-scatter",
2757
- "school-2": "university",
2758
- "scissors-square": "square-scissors",
2759
- "scissors-square-dashed-bottom": "square-bottom-dashed-scissors",
2760
- "send-horizonal": "send-horizontal",
2761
- "shield-close": "shield-x",
2762
- "shield-question": "shield-question-mark",
2763
- sidebar: "panel-left",
2764
- "sidebar-close": "panel-left-close",
2765
- "sidebar-open": "panel-left-open",
2766
- "sigma-square": "square-sigma",
2767
- "slash-square": "square-slash",
2768
- sliders: "sliders-vertical",
2769
- smile: "face-slightly-smiling",
2770
- "smile-plus": "face-slightly-smiling-plus",
2771
- "sort-asc": "arrow-up-narrow-wide",
2772
- "sort-desc": "arrow-down-wide-narrow",
2773
- "split-square-horizontal": "square-split-horizontal",
2774
- "split-square-vertical": "square-split-vertical",
2775
- "square-gantt-chart": "square-chart-gantt",
2776
- stars: "sparkles",
2777
- "stop-circle": "circle-stop",
2778
- subtitles: "captions",
2779
- "table-config": "columns-3-cog",
2780
- "terminal-square": "square-terminal",
2781
- "test-tube-2": "test-tube-diagonal",
2782
- text: "text-align-start",
2783
- "text-select": "square-dashed-text",
2784
- "text-selection": "square-dashed-text",
2785
- train: "tram-front",
2786
- "tv-2": "tv-minimal",
2787
- unlock: "lock-open",
2788
- "unlock-keyhole": "lock-keyhole-open",
2789
- "upload-cloud": "cloud-upload",
2790
- "user-2": "user-round",
2791
- "user-check-2": "user-round-check",
2792
- "user-circle": "circle-user",
2793
- "user-circle-2": "circle-user-round",
2794
- "user-cog-2": "user-round-cog",
2795
- "user-minus-2": "user-round-minus",
2796
- "user-plus-2": "user-round-plus",
2797
- "user-square": "square-user",
2798
- "user-square-2": "square-user-round",
2799
- "user-x-2": "user-round-x",
2800
- "users-2": "users-round",
2801
- verified: "badge-check",
2802
- "wallet-2": "wallet-minimal",
2803
- "wand-2": "wand-sparkles",
2804
- waves: "waves-horizontal",
2805
- "wrap-text": "text-wrap",
2806
- "x-circle": "circle-x",
2807
- "x-octagon": "octagon-x",
2808
- "x-square": "square-x"
2809
- };
2810
- var require = createRequire(import.meta.url);
2811
- /** 归一化:小写 + 去非字母数字(home 带不带连字符等价) */
2812
- function norm(s) {
2813
- return s.toLowerCase().replace(/[^a-z0-9]/g, "");
2814
- }
2815
- var NODES = JSON.parse(readFileSync(require.resolve("lucide-static/icon-nodes.json"), "utf8"));
2816
- var TAGS = JSON.parse(readFileSync(require.resolve("lucide-static/tags.json"), "utf8"));
2817
- /** 废弃名 → 正式名,由 scripts/gen-aliases.ts 从 lucide-static/icons/ 自动生成 */
2818
- var ICONS = /* @__PURE__ */ new Map();
2819
- for (const [name, nodes] of Object.entries(NODES)) ICONS.set(name, {
2820
- name,
2821
- nodes,
2822
- keywords: TAGS[name] ?? []
2823
- });
2824
- ICONS.size;
2825
- /** tag 精确反向索引:仅收录 icon 自己列出的 tag */
2826
- var BY_TAG = /* @__PURE__ */ new Map();
2827
- for (const [name, tags] of Object.entries(TAGS)) tags.forEach((tag, idx) => {
2828
- const list = BY_TAG.get(tag) ?? [];
2829
- list.push({
2830
- name,
2831
- idx
2832
- });
2833
- BY_TAG.set(tag, list);
2834
- });
2835
- var fuseName = new Fuse([...ICONS.values()], {
2836
- keys: [{
2837
- name: "name",
2838
- weight: 1
2839
- }],
2840
- threshold: .45,
2841
- ignoreLocation: true,
2842
- minMatchCharLength: 2,
2843
- includeScore: true
2844
- });
2845
- /** 公共前缀长度(用于 Fuse 命中可信度门槛) */
2846
- function commonPrefix(a, b) {
2847
- let i = 0;
2848
- while (i < a.length && i < b.length && a[i] === b[i]) i++;
2849
- return i;
2850
- }
2851
- /**
2852
- * 意图解析。只依赖数据 + Fuse:
2853
- * 1. canonical 精确
2854
- * 2. 别名表精确(旧名 home→house、alert-circle→circle-alert,由 Lucide 废弃文件生成)
2855
- * 3. Fuse name 场(前缀/拼写模糊天然吸收),可信门槛:极近(score≤0.05)或共享≥3 前导
2856
- * 4. tag 精确翻牌(处理 magnifier→search 这类"词只在 tag 里")
2857
- * 5. Fuse 宽松兜底(拼写失误,要求更宽松共享门槛)
2858
- * 落空返回 null。
2859
- */
2860
- function findIcon(raw) {
2861
- const q = raw.trim().toLowerCase();
2862
- if (!q) return null;
2863
- if (ICONS.has(q)) return ICONS.get(q);
2864
- const aliased = ALIAS_MAP[q];
2865
- if (aliased) {
2866
- const def = ICONS.get(aliased);
2867
- if (def) return def;
2868
- }
2869
- const qn = norm(q);
2870
- const nameHits = fuseName.search(q, { limit: 8 }).filter((r) => r.score <= .05 || r.score <= .3 && commonPrefix(qn, norm(r.item.name)) >= 3);
2871
- if (nameHits.length) return nameHits[0].item;
2872
- const tagHits = BY_TAG.get(q);
2873
- if (tagHits?.length) {
2874
- const best = tagHits.slice().sort((a, b) => a.idx - b.idx || norm(a.name).length - norm(b.name).length)[0];
2875
- return ICONS.get(best.name) ?? null;
2876
- }
2877
- const loose = fuseName.search(q, { limit: 8 }).filter((r) => commonPrefix(qn, norm(r.item.name)) >= 2)[0];
2878
- return loose ? loose.item : null;
2879
- }
2880
- /** 按相关度返回候选,仅供错误提示 */
2881
- function suggestIcons(raw, limit = 20) {
2882
- const q = raw.trim();
2883
- if (!q) return [];
2884
- const out = /* @__PURE__ */ new Map();
2885
- if (ICONS.has(q)) out.set(q, ICONS.get(q));
2886
- const aliased = ALIAS_MAP[q];
2887
- if (aliased && !out.has(aliased)) {
2888
- const d = ICONS.get(aliased);
2889
- if (d) out.set(d.name, d);
2890
- }
2891
- for (const { name } of BY_TAG.get(q) ?? []) {
2892
- const d = ICONS.get(name);
2893
- if (d) out.set(d.name, d);
2894
- if (out.size >= limit) break;
2895
- }
2896
- for (const r of fuseName.search(q, { limit })) out.set(r.item.name, r.item);
2897
- return [...out.values()].slice(0, limit);
2898
- }
2899
- /**
2900
- * 生成完整 SVG。保留 Lucide 默认 stroke 风格:
2901
- * viewBox 0 0 24 24, fill=none, stroke=color, stroke-width=strokeWidth,round 端点。
2902
- * 允许 LLM 传 size/color/strokeWidth 调整样式。
2903
- */
2904
- function iconToSvg(def, size = 24, color = "#000000", strokeWidth = 2) {
2905
- const body = def.nodes.map(([el, attrs]) => {
2906
- return `<${el} ${Object.entries(attrs).map(([k, v]) => `${k}="${v}"`).join(" ")}/>`;
2907
- }).join("\n ");
2908
- return [
2909
- `<svg xmlns="http://www.w3.org/2000/svg"`,
2910
- ` width="${size}" height="${size}" viewBox="0 0 24 24"`,
2911
- ` fill="none" stroke="${color}" stroke-width="${strokeWidth}"`,
2912
- ` stroke-linecap="round" stroke-linejoin="round">`,
2913
- ` ${body}`,
2914
- `</svg>`
2915
- ].join("\n");
2916
- }
2917
- //#endregion
2918
- //#region src/tools/create.ts
2919
- /** 创建类:声明式节点 / SVG 导入 / 图标 / HTML 转设计 */
2920
- function registerCreateTools(server, bridge) {
2921
- const createNodes = bridgeTool({
2922
- name: "jsd_create_nodes",
2923
- title: "创建设计节点",
2924
- description: `在画布创建节点,可递归嵌套子节点。
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(`
8
+ `);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:`在画布创建节点,可递归嵌套子节点。
2925
10
  必填 ops 为设计指令数组,如 {"ops":[{"type":"RECTANGLE","name":"矩形","width":100,"height":100}]};节点类型(FRAME/RECTANGLE/ELLIPSE/LINE/POLYGON/STAR/VECTOR/TEXT/GROUP/BOOLEAN_OPERATION)、填充描边、placement 放置方式等结构见 inputSchema 各字段说明。
2926
- 整页/整屏等复杂结构:先取 design-strategy prompt 的「一层只建一层 + 归组后再布局」纪律再动手,别边建边改`,
2927
- method: "execute",
2928
- inputSchema: executeSchema,
2929
- outputSchema: createdResultSchema,
2930
- annotations: {
2931
- readOnlyHint: false,
2932
- destructiveHint: false
2933
- }
2934
- });
2935
- const createSvg = bridgeTool({
2936
- name: "jsd_create_svg",
2937
- title: "导入 SVG",
2938
- description: "将 SVG 字符串直接导入画布为可编辑图层(createNodeFromSvg 原生解析,保留路径/渐变/描边)",
2939
- method: "create_svg",
2940
- inputSchema: createSvgSchema,
2941
- outputSchema: createdResultSchema,
2942
- annotations: {
2943
- readOnlyHint: false,
2944
- destructiveHint: false
2945
- },
2946
- payload: ({ svg, name }) => ({
2947
- svg,
2948
- name: name ?? "svg-design"
2949
- })
2950
- });
2951
- const createIcon = bridgeTool({
2952
- name: "jsd_create_icon",
2953
- title: "插入内置图标",
2954
- description: "按名称/别名/语义模糊匹配并插入 Lucide 内置图标;查无时返回候选名。默认 24px 黑色描边 2px",
2955
- inputSchema: createIconSchema,
2956
- outputSchema: createdResultSchema,
2957
- annotations: {
2958
- readOnlyHint: false,
2959
- destructiveHint: false
2960
- },
2961
- run: async (args, bridge_, signal) => {
2962
- const { icon, size, color, strokeWidth, name } = args;
2963
- const def = findIcon(icon);
2964
- if (!def) {
2965
- const suggests = suggestIcons(icon, 8);
2966
- const hint = suggests.length ? `,可尝试:${suggests.map((s) => s.name).join(", ")}` : "";
2967
- throw new Error(`未知图标:${icon}${hint}`);
2968
- }
2969
- const svg = iconToSvg(def, size ?? 24, color ?? "#000000", strokeWidth ?? 2);
2970
- return bridge_.request("create_svg", {
2971
- svg,
2972
- name: name ?? `icon-${def.name}`
2973
- }, { signal });
2974
- }
2975
- });
2976
- const htmlToDesign = bridgeTool({
2977
- name: "jsd_html_to_design",
2978
- title: "HTML 转设计节点",
2979
- description: `将 HTML 片段转成矢量图层(SVG 保真,忽略复杂样式);需要逐节点可编辑的结构时改用 jsd_create_nodes 手工搭建`,
2980
- inputSchema: htmlToDesignSchema,
2981
- outputSchema: createdResultSchema,
2982
- annotations: {
2983
- readOnlyHint: false,
2984
- destructiveHint: false
2985
- },
2986
- run: async (args, bridge_, signal) => {
2987
- const { html, name } = args;
2988
- const svg = htmlToSvg(html);
2989
- return bridge_.request("create_svg", {
2990
- svg,
2991
- name: name ?? "html-design"
2992
- }, { signal });
2993
- }
2994
- });
2995
- return [
2996
- createNodes(server, bridge),
2997
- createSvg(server, bridge),
2998
- createIcon(server, bridge),
2999
- htmlToDesign(server, bridge)
3000
- ];
3001
- }
3002
- //#endregion
3003
- //#region src/tools/manage.ts
3004
- /** 管理类:节点结构操作 + 组件/实例操作 */
3005
- function registerManageTools(server, bridge) {
3006
- const manageNodes = bridgeTool({
3007
- name: "jsd_manage_nodes",
3008
- title: "节点结构操作",
3009
- description: `节点结构操作,按 op 分发:select 设当前选中 | remove 删除(matchName 可再过滤) | clone 复制(右下偏移) | group 编组(可带 layoutMode/itemSpacing/padding* 参数) | ungroup 解组 | flatten 合并为矢量(至少 2 节点) | outline_stroke 描边转轮廓 | reparent 移到 parentId 下(缺省当前选中第一个) | repair 清理已损坏节点。
3010
- 属性修改用 jsd_update_node。`,
3011
- method: "node_op",
3012
- inputSchema: manageNodesSchema,
3013
- outputSchema: manageNodesResultSchema,
3014
- annotations: {
3015
- readOnlyHint: false,
3016
- destructiveHint: true
3017
- }
3018
- });
3019
- const manageComponents = bridgeTool({
3020
- name: "jsd_manage_components",
3021
- title: "组件与实例操作",
3022
- description: `组件/实例操作,按 op 分发:create_component 建空壳组件(子节点需再 reparent 归入) | create_instance 生成实例 | detach_instance 解绑为 Frame | import_component 按 key 从团队库导入 | swap_component 换绑组件 | set_instance_properties 设置变体属性(可选值看节点的 variantGroupProperties) | combine_as_variants 合并为组件集(基于副本,原组件保留) | copy_overrides 把源实例的覆盖(变体/组件属性/可见样式文本)复制为快照并缓存,返回 snapshotId(=源实例 id) | apply_overrides 按 snapshotId 把快照批量套用到目标实例(可 swapToSource,缓存 miss 会报错,需先 copy) | sync_overrides 无状态一次性「复制+套用」(不写缓存,适合 jsd_batch)。
3023
- componentProperties 仅 Figma 生效;jsDesign 自动降级为变体属性+可见样式。`,
3024
- method: "component_op",
3025
- inputSchema: manageComponentsSchema,
3026
- outputSchema: manageComponentsResultSchema,
3027
- annotations: {
3028
- readOnlyHint: false,
3029
- destructiveHint: true
3030
- }
3031
- });
3032
- return [manageNodes(server, bridge), manageComponents(server, bridge)];
3033
- }
3034
- //#endregion
3035
- //#region src/tools/modify.ts
3036
- /** 修改类:选中属性修改 + 节点查找 */
3037
- function registerModifyTools(server, bridge) {
3038
- const updateNode = bridgeTool({
3039
- name: "jsd_update_node",
3040
- title: "修改节点属性",
3041
- description: `按 id 批量修改节点属性(位置/尺寸/填充/文本/效果等,字段见 inputSchema);ids 缺省作用于当前选中。结构操作(分组/删除/移动)用 jsd_manage_nodes。`,
3042
- method: "update_node",
3043
- inputSchema: updateNodeSchema,
3044
- outputSchema: updatedResultSchema,
3045
- annotations: {
3046
- readOnlyHint: false,
3047
- destructiveHint: false
3048
- },
3049
- extraContent: (data, args) => {
3050
- const ids = args.ids ?? [];
3051
- const updated = data.updated ?? [];
3052
- const blocks = [];
3053
- if (updated.length > 0) blocks.push({
3054
- type: "text",
3055
- text: `已更新 ${updated.length} 个节点`
3056
- });
3057
- if (ids.length > 0) {
3058
- const got = new Set(updated.map((n) => n.id));
3059
- const missing = ids.filter((id) => !got.has(id));
3060
- if (missing.length > 0) blocks.push({
3061
- type: "text",
3062
- text: `以下节点未更新(可能已失效/被连坐删除): ${missing.join(", ")}。可用 jsd_find 复核后重试`
3063
- });
3064
- }
3065
- return blocks;
3066
- }
3067
- });
3068
- const find = bridgeTool({
3069
- name: "jsd_find",
3070
- title: "查找节点",
3071
- description: "在当前页面查找节点:ids 精确匹配优先,name 模糊,type 过滤;返回序列化节点列表(最多 100 条)",
3072
- method: "find",
3073
- inputSchema: findSchema,
3074
- outputSchema: findResultSchema,
3075
- annotations: { readOnlyHint: true }
3076
- });
3077
- return [updateNode(server, bridge), find(server, bridge)];
3078
- }
3079
- //#endregion
3080
- //#region src/tools/platform.ts
3081
- /** 平台特有操作:通用通道,op 名与参数由 ping.capabilities + op.description 引导 */
3082
- function registerPlatformTools(server, bridge) {
3083
- return [bridgeTool({
3084
- name: "jsd_platform_op",
3085
- title: "平台特有操作",
3086
- description: `执行平台特有能力(Figma 变量/本地样式/组件属性等)。CRITICAL: 不要凭空猜测 op 名与参数——必须先取 jsd_ping 的 capabilities 确认当前平台支持的操作名与入参结构(随平台而异),params 随 op 而定;平台不支持时返回错误`,
3087
- method: "platform_op",
3088
- inputSchema: platformOpParamsSchema,
3089
- outputSchema: platformOpResultSchema,
3090
- annotations: {
3091
- readOnlyHint: false,
3092
- openWorldHint: true
3093
- }
3094
- })(server, bridge)];
3095
- }
3096
- //#endregion
3097
- //#region src/tools/prompts.ts
3098
- /** 高频配方 prompt:可复用的操作引导词(只收工具 description 覆盖不到的流程级内容) */
3099
- function registerPrompts(server) {
3100
- return [
3101
- server.registerPrompt("design-card", {
3102
- title: "设计卡片",
3103
- description: "在画布生成一张带标题的卡片,严格遵循「平铺创建 + reparent 归组 + 事后设布局」纪律",
3104
- argsSchema: z.object({
3105
- title: z.string().describe("卡片主标题文案"),
3106
- subtitle: z.string().optional().describe("副标题文案(可选)"),
3107
- width: z.string().optional().describe("卡宽 px 的数字字符串,默认 \"320\"(MCP prompt 参数均为字符串)"),
3108
- height: z.string().optional().describe("卡高 px 的数字字符串,默认 \"200\"")
3109
- })
3110
- }, ({ title, subtitle, width, height }) => ({ messages: [{
3111
- role: "user",
3112
- content: {
3113
- type: "text",
3114
- text: cardRecipe(String(title), subtitle == null ? void 0 : String(subtitle), Number(width) || 320, Number(height) || 200)
3115
- }
3116
- }] })),
3117
- server.registerPrompt("html-to-design", {
3118
- title: "HTML 转设计稿",
3119
- description: "把一段 HTML 转为画布节点,含保真度取舍说明",
3120
- argsSchema: z.object({
3121
- html: z.string().describe("要转换的 HTML 片段"),
3122
- name: z.string().optional().describe("生成节点的名称,默认 html-design")
3123
- })
3124
- }, ({ html, name }) => ({ messages: [{
3125
- role: "user",
3126
- content: {
3127
- type: "text",
3128
- text: `请把下面的 HTML 转成设计稿。默认走 jsd_html_to_design(SVG 保真,忽略复杂样式);需要可编辑图层时才改用 jsd_create_nodes 手工映射(容器→FRAME、文本→TEXT、图形→VECTOR)后 reparent 归组。\n\nHTML:\n\`\`\`\n${String(html)}\n\`\`\`${name == null ? "" : `\n节点名:${String(name)}`}`
3129
- }
3130
- }] })),
3131
- server.registerPrompt("icon-grid", {
3132
- title: "图标网格",
3133
- description: "批量插入 Lucide 图标并排成自动布局网格",
3134
- argsSchema: z.object({
3135
- icons: z.string().describe("图标名列表,逗号分隔,如 house,search,settings"),
3136
- size: z.string().optional().describe("单个图标边长 px 数字字符串,默认 \"24\""),
3137
- gap: z.string().optional().describe("图标间距 px 数字字符串,默认 \"16\"")
3138
- })
3139
- }, ({ icons, size, gap }) => ({ messages: [{
3140
- role: "user",
3141
- content: {
3142
- type: "text",
3143
- text: `请插入图标网格:1) jsd_create_nodes 建一个 FRAME 容器;2) 每个图标各调一次 jsd_create_icon(size=${Number(size) || 24});3) jsd_manage_nodes op=reparent 把全部图标移入容器;4) jsd_update_node 给容器设 auto-layout(layoutMode=HORIZONTAL,itemSpacing=${Number(gap) || 16},counterAxisAlignItems=CENTER)。\n图标列表: ${String(icons)}`
3144
- }
3145
- }] })),
3146
- server.registerPrompt("script-ops", {
3147
- title: "脚本化批量调用",
3148
- description: "把多步画布操作合并为一次 ops 数组或一段宿主脚本执行,减少工具往返与上下文占用",
3149
- argsSchema: z.object({ task: z.string().optional().describe("要完成的任务描述(可选,留空只返回脚本化调用纪律)") })
3150
- }, ({ task }) => ({ messages: [{
3151
- role: "user",
3152
- content: {
3153
- type: "text",
3154
- text: scriptRecipe(task == null ? void 0 : String(task))
3155
- }
3156
- }] })),
3157
- server.registerPrompt("design-strategy", {
3158
- title: "设计策略总纲",
3159
- description: "画布创作的通用纪律:先摸底、一层只建一层、语义化命名、归组后再布局、间距与字号阶梯、出错回滚,附示例结构树",
3160
- argsSchema: z.object({ screen: z.string().optional().describe("要设计的界面名称,如「登录页」;留空只返回通用纪律") })
3161
- }, ({ screen }) => ({ messages: [{
3162
- role: "assistant",
3163
- content: {
3164
- type: "text",
3165
- text: designStrategyRecipe(screen == null ? void 0 : String(screen))
3166
- }
3167
- }] })),
3168
- server.registerPrompt("text-replace-strategy", {
3169
- title: "文本批量替换策略",
3170
- description: "大改文案的安全流程:clone 留底 → 按语义分块 → jsd_update_node ids 批量替换 → 逐块导小图复核",
3171
- argsSchema: z.object({ rootId: z.string().optional().describe("根节点 id;留空取当前选中") })
3172
- }, ({ rootId }) => ({ messages: [{
3173
- role: "assistant",
3174
- content: {
3175
- type: "text",
3176
- text: textReplaceRecipe(rootId == null ? void 0 : String(rootId))
3177
- }
3178
- }] })),
3179
- server.registerPrompt("variant-sync", {
3180
- title: "同类实例样式批量同步",
3181
- description: "把一个实例的样式/文案批量套用到多个同类实例(卡片组/列表项/表单组),变体属性走组件操作",
3182
- argsSchema: z.object({
3183
- sourceId: z.string().optional().describe("源实例 id;留空取当前选中"),
3184
- targetType: z.string().optional().describe("目标实例的类型过滤,如 INSTANCE;留空按名称匹配")
3185
- })
3186
- }, ({ sourceId, targetType }) => ({ messages: [{
3187
- role: "assistant",
3188
- content: {
3189
- type: "text",
3190
- text: variantSyncRecipe(sourceId == null ? void 0 : String(sourceId), targetType == null ? void 0 : String(targetType))
3191
- }
3192
- }] }))
3193
- ].map((handle) => Object.assign(handle, { alwaysEnabled: true }));
3194
- }
3195
- function cardRecipe(title, subtitle, width, height) {
3196
- return `请在画布中心创建一张 ${width}x${height} 的卡片:
3197
- 1) jsd_create_nodes 一次平铺创建 FRAME 底板(圆角 12、浅色填充)与${subtitle == null ? `1 个 TEXT 主标题「${title}」` : `1 个 TEXT 主标题「${title}」和 1 个 TEXT 副标题「${subtitle}」`};
3198
- 2) jsd_manage_nodes op=reparent 把文本移入 Frame;
3199
- 3) jsd_update_node 给 Frame 设 auto-layout(VERTICAL,itemSpacing=8,padding=24,counterAxisAlignItems=CENTER),主标题 fontSize 加大。`;
3200
- }
3201
- /** 脚本化调用配方:压缩工具往返次数与上下文占用 */
3202
- function scriptRecipe(task) {
3203
- return `${task == null ? "请按以下「脚本化」纪律调用 text-to-design 工具:" : `请用「脚本化」方式完成下面的任务:\n${task}\n\n执行要求:`}
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执行要求:`}
3204
19
  1) 多步流程一次成型:优先 jsd_batch 编排(create→reparent→update、find→批量修改、图标×N 等);宿主有代码执行工具时也可写一段脚本连续 await 多个 tools.jsd_*。
3205
20
  2) 中间值只在管道内流动:上游结果用双花括号占位符(步骤id.字段路径)注入下游参数(脚本内用变量传递);每步只提取后续需要的字段,不回传完整序列化结果。
3206
- 3) 收敛:最后只做一次 jsd_get_selection(depth=1) 总复核,不要每步都复核。`;
3207
- }
3208
- /** 设计策略总纲:把 server.ts 里 INSTRUCTIONS 的三条纪律展开成可照着走的完整流程 */
3209
- function designStrategyRecipe(screen) {
3210
- return `# 画布创作纪律
21
+ 3) 收敛:最后只做一次 jsd_get_selection(depth=1) 总复核,不要每步都复核。`}function Vn(e){return`# 画布创作纪律
3211
22
 
3212
23
  1) 先摸底再动手:jsd_get_selection(depth=2) 看现状(名称/类型/尺寸/填充/子结构),已有节点用 jsd_find 精确定位,不要重复创建同名元素。
3213
24
  2) 一层只建一层:每个界面先建主容器 FRAME,再分区放内容。复杂结构用 jsd_create_nodes 一次平铺建完,不要用 children 深嵌套(易整体失败)。
@@ -3216,7 +27,7 @@ function designStrategyRecipe(screen) {
3216
27
  5) 间距与字号阶梯:主标题 > 正文标签 > 按钮文本 > 辅助说明;同级元素间距一致,用 itemSpacing 统一控制,不靠手调坐标凑。
3217
28
  6) 视觉顺序:自上而下按阅读顺序排布,主操作按钮放在输入项之后,次要链接(忘记密码/注册)放最后。
3218
29
  7) 出错回滚:ok=false 或「没找到 X 节点」→ jsd_find 复核 id 是否已失效(可能被连坐删除),必要时 jsd_manage_nodes op=repair 清理后重试。
3219
- 8) 收敛复核:整批做完只做一次 jsd_get_selection(depth=1),或 jsd_export 导小图(scale=0.5)看效果;不要每步都读一遍。
30
+ 8) 收敛复核:整批做完只做一次 jsd_get_selection(depth=1),或 jsd_export({ids:[要看的节点id], scale:0.5}) 导小图看效果(ids 为必填数组);不要每步都读一遍。
3220
31
 
3221
32
  示例结构(登录页):
3222
33
  - 登录页(FRAME)
@@ -3228,14 +39,10 @@ function designStrategyRecipe(screen) {
3228
39
  - 主按钮(FRAME + TEXT)
3229
40
  - 辅助链接(FRAME:忘记密码 TEXT + 注册 TEXT)
3230
41
 
3231
- ${screen == null ? "当前设计" : `「${screen}」`}按这条链走;多步合并时优先用 jsd_batch 编排,中间 id 不回传模型。`;
3232
- }
3233
- /** 文本批量替换策略:安全副本 + 语义分块 + 逐块复核,避免一次性全改后无法回退 */
3234
- function textReplaceRecipe(rootId) {
3235
- return `# 文本批量替换
42
+ ${e==null?`当前设计`:`「${e}」`}按这条链走;多步合并时优先用 jsd_batch 编排,中间 id 不回传模型。`}function Hn(e){return`# 文本批量替换
3236
43
 
3237
44
  ## 1. 摸底与分块
3238
- - 对 ${rootId == null ? "当前选中(先用 jsd_get_selection 拿到根 id)" : `节点 ${rootId}`} 先 jsd_get_selection 看结构,按语义把文本分成几块:表格按行或列、卡片按「同名字段一组」、表单按「标签 + 输入」一组、导航按菜单项一组。
45
+ - 对 ${e==null?`当前选中(先用 jsd_get_selection 拿到根 id)`:`节点 ${e}`} 先 jsd_get_selection 看结构,按语义把文本分成几块:表格按行或列、卡片按「同名字段一组」、表单按「标签 + 输入」一组、导航按菜单项一组。
3239
46
  - 不按坐标硬切;语义相关的文本应同批处理,这样一次 jsd_update_node 就能覆盖一整块。
3240
47
 
3241
48
  ## 2. 先留安全副本
@@ -3246,24 +53,20 @@ function textReplaceRecipe(rootId) {
3246
53
  - ids 来自上一步查询时,用 jsd_batch 的 {{步骤id.字段路径}} 占位符直接串起来,中间 id 不回传模型。
3247
54
 
3248
55
  ## 4. 逐块复核
3249
- - 每替换完一块,jsd_export 导出该块(scale=0.5)看一眼:文字是否溢出容器、层级有没有乱、间距有没有被撑开。
56
+ - 每替换完一块,jsd_export({ids:[该块节点id], scale:0.5}) 导出看一眼:文字是否溢出容器、层级有没有乱、间距有没有被撑开。
3250
57
  - 有问题先修当前块再继续下一块,不要把所有错误攒到最后。
3251
58
 
3252
59
  ## 5. 收尾
3253
- - 全部完成后只做一次 jsd_get_selection(depth=1) 总复核,并清理临时副本。`;
3254
- }
3255
- /** 同类实例样式批量同步:取源实例属性 → 定位目标 → 批量套用,变体属性走组件操作 */
3256
- function variantSyncRecipe(sourceId, targetType) {
3257
- return `# 同类实例样式批量同步
60
+ - 全部完成后只做一次 jsd_get_selection(depth=1) 总复核,并清理临时副本。`}function Un(e,t){return`# 同类实例样式批量同步
3258
61
 
3259
62
  ## 适用场景
3260
63
  把一个实例的样式/文案套用到多个同类实例(卡片组、列表项、表单组……),避免逐个手改。
3261
64
 
3262
65
  ## 1. 取源实例属性
3263
- - 对 ${sourceId == null ? "当前选中(先 jsd_get_selection 确认)" : `节点 ${sourceId}`} 用 jsd_get_selection(depth=2) 确认它是可复用的 INSTANCE,并记录源 id。
66
+ - 对 ${e==null?`当前选中(先 jsd_get_selection 确认)`:`节点 ${e}`} 用 jsd_get_selection(depth=2) 确认它是可复用的 INSTANCE,并记录源 id。
3264
67
 
3265
68
  ## 2. 定位目标实例
3266
- - jsd_find(${targetType == null ? "按名称匹配目标实例" : `type=${targetType} 过滤目标实例`}) 拿到全部目标实例 id;缺的实例用 jsd_manage_components op=create_instance 补建。
69
+ - jsd_find(${t==null?`按名称匹配目标实例`:`type=${t} 过滤目标实例`}) 拿到全部目标实例 id;缺的实例用 jsd_manage_components op=create_instance 补建。
3267
70
 
3268
71
  ## 3. 批量套用(优先引擎级)
3269
72
  - 首选 jsd_manage_components op=sync_overrides:sourceId=源实例 id,ids=全部目标 id,一次完成「复制+套用」(自动同步变体/组件属性/可见样式文本,不动位置)。
@@ -3271,364 +74,7 @@ function variantSyncRecipe(sourceId, targetType) {
3271
74
  - 引擎不支持时再退化为手工:jsd_update_node ids=[目标] 填字段 + jsd_manage_components op=set_instance_properties 设变体值。
3272
75
 
3273
76
  ## 4. 复核
3274
- - jsd_export(scale=0.5) 抽查一张,确认间距与层级没被撑乱;再 jsd_get_selection(depth=1) 总复核。`;
3275
- }
3276
- //#endregion
3277
- //#region src/tools/raw.ts
3278
- /** 原始数据类:导出/填充图片/字体列表 */
3279
- function registerRawTools(server, bridge) {
3280
- const exportTool = bridgeTool({
3281
- name: "jsd_export",
3282
- title: "导出节点为图片",
3283
- description: `导出节点为 PNG/JPG/SVG/PDF;savePath 落盘与 includeDataUrl 返回 base64 可并存,参数见 inputSchema。`,
3284
- inputSchema: exportSchema,
3285
- outputSchema: exportResultSchema,
3286
- annotations: {
3287
- readOnlyHint: false,
3288
- destructiveHint: false
3289
- },
3290
- timeout: LONG_IO_TIMEOUT_MS,
3291
- run: async (args, bridge_, signal) => {
3292
- const { ids, format, scale, savePath, includeDataUrl } = args;
3293
- const exportsMap = (await bridge_.request("export", {
3294
- ids,
3295
- format,
3296
- scale
3297
- }, {
3298
- signal,
3299
- timeout: 6e4
3300
- })).exports ?? {};
3301
- const results = [];
3302
- for (const [nid, item] of Object.entries(exportsMap)) {
3303
- const bytes = item.bytes;
3304
- const mimeType = item.mimeType;
3305
- const out = {
3306
- id: nid,
3307
- name: item.name,
3308
- format: item.format,
3309
- mimeType,
3310
- size: bytes.byteLength
3311
- };
3312
- if (savePath) {
3313
- writeFileSync(savePath, bytes);
3314
- out.path = savePath;
3315
- }
3316
- if (includeDataUrl) out.dataUrl = `data:${mimeType};base64,${bytes.toString("base64")}`;
3317
- results.push(out);
3318
- }
3319
- return { exports: results };
3320
- },
3321
- extraContent: (data, args) => {
3322
- const ids = args.ids ?? [];
3323
- const exports = data.exports ?? [];
3324
- const blocks = [];
3325
- if (exports.length > 0) blocks.push({
3326
- type: "text",
3327
- text: `已导出 ${exports.length} 个节点`
3328
- });
3329
- if (ids.length > 0) {
3330
- const got = new Set(exports.map((e) => e.id));
3331
- const missing = ids.filter((id) => !got.has(id));
3332
- if (missing.length > 0) blocks.push({
3333
- type: "text",
3334
- text: `导出失败(节点可能已失效): ${missing.join(", ")}。可用 jsd_find 复核`
3335
- });
3336
- }
3337
- return blocks;
3338
- }
3339
- });
3340
- const fillImage = bridgeTool({
3341
- name: "jsd_fill_image",
3342
- title: "本地图片填充节点",
3343
- description: "读取本地图片文件填充到指定节点(IMAGE fill)",
3344
- inputSchema: fillImageSchema,
3345
- outputSchema: updatedResultSchema,
3346
- annotations: {
3347
- readOnlyHint: false,
3348
- destructiveHint: false
3349
- },
3350
- timeout: LONG_IO_TIMEOUT_MS,
3351
- run: async (args, bridge_, signal) => {
3352
- const { ids, sourcePath } = args;
3353
- let bytes;
3354
- try {
3355
- bytes = readFileSync(sourcePath);
3356
- } catch (e) {
3357
- throw new Error(`读取文件失败: ${e instanceof Error ? e.message : String(e)}`);
3358
- }
3359
- return bridge_.request("fill_image", {
3360
- ids,
3361
- bytes: new Uint8Array(bytes)
3362
- }, {
3363
- signal,
3364
- timeout: LONG_IO_TIMEOUT_MS
3365
- });
3366
- }
3367
- });
3368
- const listFonts = bridgeTool({
3369
- name: "jsd_list_fonts",
3370
- title: "列出可用字体",
3371
- description: "列出当前环境可用字体族",
3372
- method: "list_fonts",
3373
- outputSchema: listFontsResultSchema,
3374
- annotations: { readOnlyHint: true }
3375
- });
3376
- return [
3377
- exportTool(server, bridge),
3378
- fillImage(server, bridge),
3379
- listFonts(server, bridge)
3380
- ];
3381
- }
3382
- //#endregion
3383
- //#region src/tools/resources.ts
3384
- function jsonContents(uri, data) {
3385
- return { contents: [{
3386
- uri: typeof uri === "string" ? uri : uri.href,
3387
- mimeType: "application/json",
3388
- text: JSON.stringify(data, null, 2)
3389
- }] };
3390
- }
3391
- /**
3392
- * 只读资源:把画布状态暴露为 MCP resources(模型可直接读取为上下文)。
3393
- * 均为按需实时读取(插件离线时随连接门控自动隐藏)。
3394
- */
3395
- function registerResources(server, bridge) {
3396
- return [
3397
- server.registerResource("canvas-selection", "jsd://canvas/selection", {
3398
- title: "画布当前选中",
3399
- description: "当前选中节点的序列化树(含直接子节点),实时从插件读取;等价于 jsd_get_selection depth=2",
3400
- mimeType: "application/json"
3401
- }, async () => {
3402
- return jsonContents("jsd://canvas/selection", await bridge.request("get_selection", { depth: 2 }));
3403
- }),
3404
- server.registerResource("fonts", "jsd://fonts", {
3405
- title: "可用字体列表",
3406
- description: "当前环境可用的字体族列表,实时从插件读取",
3407
- mimeType: "application/json"
3408
- }, async () => {
3409
- return jsonContents("jsd://fonts", await bridge.request("list_fonts", {}));
3410
- }),
3411
- server.registerResource("styles", "jsd://styles", {
3412
- title: "本地样式列表",
3413
- description: "当前文档可复用的本地样式(PAINT/TEXT/EFFECT/GRID),含 id/name/type;按名应用样式前先读这里拿准确样式名",
3414
- mimeType: "application/json"
3415
- }, async () => {
3416
- return jsonContents("jsd://styles", await bridge.request("list_styles", {}));
3417
- }),
3418
- server.registerResource("page", "jsd://page", {
3419
- title: "当前页结构总览",
3420
- description: "当前页顶层节点的轻量摘要(名称/类型/位置/尺寸/子节点数),不递归;从头设计整页前先读这里看页面已有内容",
3421
- mimeType: "application/json"
3422
- }, async () => {
3423
- return jsonContents("jsd://page", await bridge.request("get_page", {}));
3424
- }),
3425
- server.registerResource("node", new ResourceTemplate("jsd://node/{id}", { list: void 0 }), {
3426
- title: "节点详情",
3427
- description: "按 id 读取节点的序列化结构,如 jsd://node/12:3;等价于 jsd_find ids 精确查找",
3428
- mimeType: "application/json"
3429
- }, async (uri, vars) => {
3430
- const rawId = vars.id;
3431
- const id = Array.isArray(rawId) ? rawId[0] : rawId;
3432
- if (!id) throw new Error(`缺少节点 id: ${uri.href}`);
3433
- return jsonContents(uri, await bridge.request("find", { ids: [id] }));
3434
- })
3435
- ];
3436
- }
3437
- //#endregion
3438
- //#region src/tools/session.ts
3439
- /** 会话类:连接探测 + 选中读取 */
3440
- function registerSessionTools(server, bridge) {
3441
- const ping = bridgeTool({
3442
- name: "jsd_ping",
3443
- title: `检查 ${CLIENT.runtime} 插件连接`,
3444
- description: `检查插件是否在线(需先启动 ${CLIENT.runtime} 插件并保持运行)`,
3445
- outputSchema: pingResultSchema,
3446
- annotations: { readOnlyHint: true },
3447
- alwaysEnabled: true,
3448
- timeout: PING_TIMEOUT_MS,
3449
- run: async () => {
3450
- try {
3451
- const data = await bridge.request("ping", {}, { timeout: PING_TIMEOUT_MS });
3452
- return {
3453
- connected: true,
3454
- platform: data?.platform,
3455
- capabilities: data?.capabilities
3456
- };
3457
- } catch (e) {
3458
- return {
3459
- connected: false,
3460
- error: e instanceof Error ? e.message : String(e)
3461
- };
3462
- }
3463
- }
3464
- });
3465
- const getSelection = bridgeTool({
3466
- name: "jsd_get_selection",
3467
- title: "读取画布选中",
3468
- description: `获取画布当前选中节点的序列化树(名称/类型/尺寸/位置/填充/子结构);depth 控制层级深度,默认 2`,
3469
- method: "get_selection",
3470
- outputSchema: getSelectionResultSchema,
3471
- annotations: { readOnlyHint: true }
3472
- });
3473
- return [ping(server, bridge), getSelection(server, bridge)];
3474
- }
3475
- //#endregion
3476
- //#region src/tools/index.ts
3477
- var toolRegistrars = [
3478
- registerSessionTools,
3479
- registerCreateTools,
3480
- registerModifyTools,
3481
- registerManageTools,
3482
- registerRawTools,
3483
- registerBatchTools,
3484
- registerPlatformTools,
3485
- registerResources,
3486
- (server) => registerPrompts(server)
3487
- ];
3488
- //#endregion
3489
- //#region src/server.ts
3490
- /** initialize 时下发给客户端模型的使用纪律(与 AGENTS.md 保持同源) */
3491
- var INSTRUCTIONS = `操作设计画布的工具集。调用纪律:
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=`操作设计画布的工具集。调用纪律:
3492
78
  - 复杂结构先用 jsd_create_nodes 平铺创建完整 ops 数组(children 深嵌套易失败),再 jsd_manage_nodes op=reparent 归组;auto-layout(layoutMode/itemSpacing/padding* 等)最后用 jsd_update_node 单独设置。
3493
79
  - 跨工具多步流程用 jsd_batch 编排:双花括号占位符(步骤id.字段路径)引用上步结果,中间 id 不回传模型。
3494
- - ok=false 或「没找到 X 节点」:先 jsd_find 复核 id 是否已失效(可能被连坐删除),必要时 jsd_manage_nodes op=repair 清理后重试。`;
3495
- /** 存活中的 MCP 会话(daemon 常驻,多个 AI 会话共享同一 Bridge) */
3496
- var liveSessions = /* @__PURE__ */ new Set();
3497
- function applyAvailability(session, connected) {
3498
- for (const handle of session.handles) {
3499
- if (handle.alwaysEnabled) continue;
3500
- if (connected) handle.enable();
3501
- else handle.disable();
3502
- }
3503
- }
3504
- /** 插件连接变化时,同步所有会话的工具可用性并广播 listChanged */
3505
- function syncToolAvailability(connected) {
3506
- for (const session of liveSessions) {
3507
- applyAvailability(session, connected);
3508
- try {
3509
- session.server.sendToolListChanged();
3510
- } catch {}
3511
- }
3512
- log(`工具可用性同步: ${connected ? "上线" : "离线"}(会话数 ${liveSessions.size})`);
3513
- }
3514
- /** 装配 McpServer:注册全部工具(工具实现分散在 tools/*,此处只做编排) */
3515
- function buildServer(bridge) {
3516
- const server = new McpServer({
3517
- name: SERVER_NAME,
3518
- version: SERVER_VERSION
3519
- }, {
3520
- supportedProtocolVersions: ["2026-07-28", ...SUPPORTED_PROTOCOL_VERSIONS],
3521
- instructions: INSTRUCTIONS
3522
- });
3523
- const handles = [];
3524
- for (const register of toolRegistrars) handles.push(...register(server, bridge));
3525
- const session = {
3526
- server,
3527
- handles
3528
- };
3529
- liveSessions.add(session);
3530
- applyAvailability(session, bridge.isConnected);
3531
- const inner = server.server;
3532
- const prevOnClose = inner.onclose;
3533
- inner.onclose = () => {
3534
- liveSessions.delete(session);
3535
- prevOnClose?.();
3536
- };
3537
- return server;
3538
- }
3539
- //#endregion
3540
- //#region src/daemon/run.ts
3541
- /** daemon 模式:WS 桥(插件) + HTTP MCP(各会话 shim 连接),无 stdio,常驻 */
3542
- async function runDaemon(bridge) {
3543
- await bridge.start(PORT);
3544
- log(`daemon: 插件 WS ws://localhost:${bridge.port}`);
3545
- const handler = createMcpHandler(() => buildServer(bridge));
3546
- const nodeHandler = toNodeHandler(handler);
3547
- const validateHost = localhostHostValidation();
3548
- const validateOrigin = localhostOriginValidation();
3549
- let httpServer = null;
3550
- const shutdown = (reason) => {
3551
- log(`daemon 退出: ${reason}`);
3552
- handler.close();
3553
- bridge.stop();
3554
- httpServer?.close();
3555
- process.exit(0);
3556
- };
3557
- await new Promise((resolve, reject) => {
3558
- httpServer = createServer((req, res) => {
3559
- if (!validateHost(req, res) || !validateOrigin(req, res)) return;
3560
- const start = Date.now();
3561
- const url = req.url ?? "";
3562
- res.on("finish", () => {
3563
- const line = `HTTP ${req.method} ${url} → ${res.statusCode} (${Date.now() - start}ms)`;
3564
- if (res.statusCode >= 400) log(line);
3565
- else debug(line);
3566
- });
3567
- if (req.method === "GET" && url === "/health") {
3568
- res.writeHead(200, { "content-type": "application/json" });
3569
- res.end(JSON.stringify({
3570
- name: SERVER_NAME,
3571
- version: SERVER_VERSION,
3572
- pid: process.pid
3573
- }));
3574
- return;
3575
- }
3576
- if (req.method === "POST" && url === "/shutdown") {
3577
- res.writeHead(200, { "content-type": "application/json" });
3578
- res.end(JSON.stringify({ ok: true }));
3579
- setTimeout(() => shutdown("收到 /shutdown 请求"), 100);
3580
- return;
3581
- }
3582
- nodeHandler(req, res);
3583
- });
3584
- httpServer.once("error", reject);
3585
- httpServer.listen(HTTP_PORT, "127.0.0.1", () => resolve());
3586
- });
3587
- log(`daemon: MCP HTTP http://127.0.0.1:${HTTP_PORT}/mcp`);
3588
- log("daemon 就绪,常驻运行(更新时由版本自检自动替换)");
3589
- process.on("SIGINT", () => shutdown("SIGINT"));
3590
- }
3591
- /** shim 模式:探测 daemon;无则拉起并等待就绪 */
3592
- async function runShim() {
3593
- const probe = await probeUpstream();
3594
- if (probe.state === "foreign") {
3595
- error(`端口 ${HTTP_PORT} 被非 text-to-design MCP 服务占用,请先释放`);
3596
- process.exit(1);
3597
- } else if (probe.state === "proxy") {
3598
- await serveProxy(probe.client);
3599
- return;
3600
- }
3601
- log("未发现 daemon,自动拉起...");
3602
- spawnDaemon();
3603
- const deadline = Date.now() + DAEMON_WAIT_MS;
3604
- while (Date.now() < deadline) {
3605
- await delay(250);
3606
- const retry = await probeUpstream();
3607
- if (retry.state === "proxy") {
3608
- await serveProxy(retry.client);
3609
- return;
3610
- }
3611
- if (retry.state === "foreign") {
3612
- error(`端口 ${HTTP_PORT} 被非 text-to-design MCP 服务占用,请先释放`);
3613
- process.exit(1);
3614
- }
3615
- }
3616
- error(`daemon 启动超时(${DAEMON_WAIT_MS / 1e3}s),请检查残留进程后重试`);
3617
- process.exit(1);
3618
- }
3619
- //#endregion
3620
- //#region src/index.ts
3621
- var bridge = new Bridge();
3622
- bridge.onConnectionChange = syncToolAvailability;
3623
- setLogSink((level, line) => bridge.notifyLog(level, line));
3624
- if (process.env.TEXT_TO_DESIGN_MCP_ROLE === "daemon" || process.argv.includes("daemon")) runDaemon(bridge).catch((e) => {
3625
- bridge.stop();
3626
- error(`daemon 启动失败: ${e instanceof Error ? e.message : String(e)}`);
3627
- process.exit(1);
3628
- });
3629
- else runShim().catch((e) => {
3630
- error(`shim 启动失败: ${e instanceof Error ? e.message : String(e)}`);
3631
- process.exit(1);
3632
- });
3633
- //#endregion
3634
- export {};
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{};