text-to-design-mcp 0.3.0 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -19
- package/dist/index.js +394 -418
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -18,29 +18,32 @@
|
|
|
18
18
|
|
|
19
19
|
**第一步:告诉 AI 工具**
|
|
20
20
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
```json
|
|
24
|
-
{
|
|
25
|
-
"mcp": {
|
|
26
|
-
"text-to-design": {
|
|
27
|
-
"type": "local",
|
|
28
|
-
"command": ["npx", "-y", "text-to-design-mcp@latest"],
|
|
29
|
-
"enabled": true
|
|
30
|
-
}
|
|
31
|
-
}
|
|
32
|
-
}
|
|
21
|
+
后台服务不用手动安装,注册命令统一为 `npx -y text-to-design-mcp@latest`,任意 AI 工具都会自动化拉取运行。把下面需求丢给 AI,它会自动注册并验证:
|
|
22
|
+
|
|
33
23
|
```
|
|
24
|
+
请帮我完成 text-to-design 安装,并按步骤汇报进度:
|
|
34
25
|
|
|
35
|
-
|
|
26
|
+
1. 注册 MCP 服务:用你工具原生的方式注册一个 stdio MCP server,
|
|
27
|
+
命令 npx -y text-to-design-mcp@latest(无需手动安装,npx 会自动拉取运行)。
|
|
36
28
|
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
29
|
+
2. 验证后台服务能启动:
|
|
30
|
+
timeout 5 npx -y text-to-design-mcp@latest
|
|
31
|
+
预期输出含 "[text-to-design-mcp] shim 模式" 或 "daemon 就绪"(首次会自动拉起常驻服务)。
|
|
32
|
+
|
|
33
|
+
3. 安装设计软件插件,下载并解压到用户目录:
|
|
34
|
+
cd ~ && npm pack text-to-design-ui
|
|
35
|
+
mkdir -p text-to-design-plugin
|
|
36
|
+
tar -xzf text-to-design-ui-*.tgz -C text-to-design-plugin --strip-components=1
|
|
37
|
+
|
|
38
|
+
4. 上述三步完成后,告知用户剩下两步需手动:
|
|
39
|
+
- 在即时设计里「插件 → 导入」,选择 ~/text-to-design-plugin/dist/manifest.json,
|
|
40
|
+
运行插件,面板显示「已连接」即就绪
|
|
41
|
+
- 重启 AI 会话,调用 jsd_ping 验证连通
|
|
42
|
+
|
|
43
|
+
5. 汇报完成情况。
|
|
44
|
+
```
|
|
42
45
|
|
|
43
|
-
|
|
46
|
+
若希望全局安装(装一次、不依赖联网拉取),可 `npm i -g text-to-design-mcp`,注册命令可简化为 `text-to-design-mcp`。
|
|
44
47
|
|
|
45
48
|
**第二步:安装设计软件插件**
|
|
46
49
|
|
package/dist/index.js
CHANGED
|
@@ -13,7 +13,7 @@ import { isTag } from "domhandler";
|
|
|
13
13
|
import { parseDocument } from "htmlparser2";
|
|
14
14
|
import Fuse from "fuse.js";
|
|
15
15
|
//#region package.json
|
|
16
|
-
var version = "0.
|
|
16
|
+
var version = "0.4.0";
|
|
17
17
|
//#endregion
|
|
18
18
|
//#region src/config.ts
|
|
19
19
|
var PORT = Number(process.env.TEXT_TO_DESIGN_MCP_PORT ?? 47812);
|
|
@@ -426,12 +426,171 @@ async function serveProxy(client) {
|
|
|
426
426
|
}
|
|
427
427
|
//#endregion
|
|
428
428
|
//#region ../shared/src/schemas.ts
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
434
|
-
var
|
|
429
|
+
var rgbSchema = z.object({
|
|
430
|
+
r: z.number().min(0).max(1),
|
|
431
|
+
g: z.number().min(0).max(1),
|
|
432
|
+
b: z.number().min(0).max(1)
|
|
433
|
+
});
|
|
434
|
+
var rgbaSchema = z.object({
|
|
435
|
+
r: z.number().min(0).max(1),
|
|
436
|
+
g: z.number().min(0).max(1),
|
|
437
|
+
b: z.number().min(0).max(1),
|
|
438
|
+
a: z.number().min(0).max(1)
|
|
439
|
+
});
|
|
440
|
+
var gradientStopSchema = z.object({
|
|
441
|
+
color: rgbaSchema,
|
|
442
|
+
position: z.number().min(0).max(1)
|
|
443
|
+
});
|
|
444
|
+
var transformSchema = z.tuple([z.tuple([
|
|
445
|
+
z.number(),
|
|
446
|
+
z.number(),
|
|
447
|
+
z.number()
|
|
448
|
+
]), z.tuple([
|
|
449
|
+
z.number(),
|
|
450
|
+
z.number(),
|
|
451
|
+
z.number()
|
|
452
|
+
])]);
|
|
453
|
+
var paintSchema = z.discriminatedUnion("type", [
|
|
454
|
+
z.object({
|
|
455
|
+
type: z.literal("SOLID"),
|
|
456
|
+
color: rgbSchema,
|
|
457
|
+
opacity: z.number().min(0).max(1).optional(),
|
|
458
|
+
visible: z.boolean().optional(),
|
|
459
|
+
blendMode: z.string().optional()
|
|
460
|
+
}),
|
|
461
|
+
z.object({
|
|
462
|
+
type: z.literal("GRADIENT_LINEAR"),
|
|
463
|
+
gradientStops: z.array(gradientStopSchema),
|
|
464
|
+
gradientTransform: transformSchema
|
|
465
|
+
}),
|
|
466
|
+
z.object({
|
|
467
|
+
type: z.literal("GRADIENT_RADIAL"),
|
|
468
|
+
gradientStops: z.array(gradientStopSchema),
|
|
469
|
+
gradientTransform: transformSchema
|
|
470
|
+
}),
|
|
471
|
+
z.object({
|
|
472
|
+
type: z.literal("GRADIENT_ANGULAR"),
|
|
473
|
+
gradientStops: z.array(gradientStopSchema),
|
|
474
|
+
gradientTransform: transformSchema
|
|
475
|
+
}),
|
|
476
|
+
z.object({
|
|
477
|
+
type: z.literal("IMAGE"),
|
|
478
|
+
imageHash: z.string(),
|
|
479
|
+
scaleMode: z.enum([
|
|
480
|
+
"FILL",
|
|
481
|
+
"FIT",
|
|
482
|
+
"CROP",
|
|
483
|
+
"TILE"
|
|
484
|
+
]).optional()
|
|
485
|
+
})
|
|
486
|
+
]);
|
|
487
|
+
var blendModeSchema = z.enum([
|
|
488
|
+
"PASS_THROUGH",
|
|
489
|
+
"NORMAL",
|
|
490
|
+
"DARKEN",
|
|
491
|
+
"MULTIPLY",
|
|
492
|
+
"LINEAR_BURN",
|
|
493
|
+
"COLOR_BURN",
|
|
494
|
+
"LIGHTEN",
|
|
495
|
+
"SCREEN",
|
|
496
|
+
"LINEAR_DODGE",
|
|
497
|
+
"COLOR_DODGE",
|
|
498
|
+
"OVERLAY",
|
|
499
|
+
"SOFT_LIGHT",
|
|
500
|
+
"HARD_LIGHT",
|
|
501
|
+
"DIFFERENCE",
|
|
502
|
+
"EXCLUSION",
|
|
503
|
+
"HUE",
|
|
504
|
+
"SATURATION",
|
|
505
|
+
"COLOR",
|
|
506
|
+
"LUMINOSITY"
|
|
507
|
+
]);
|
|
508
|
+
var effectSchema = z.discriminatedUnion("type", [
|
|
509
|
+
z.object({
|
|
510
|
+
type: z.literal("DROP_SHADOW"),
|
|
511
|
+
color: rgbaSchema,
|
|
512
|
+
offset: z.object({
|
|
513
|
+
x: z.number(),
|
|
514
|
+
y: z.number()
|
|
515
|
+
}),
|
|
516
|
+
radius: z.number().min(0),
|
|
517
|
+
spread: z.number().optional(),
|
|
518
|
+
visible: z.boolean().optional(),
|
|
519
|
+
blendMode: blendModeSchema.default("NORMAL"),
|
|
520
|
+
showShadowBehindNode: z.boolean().optional()
|
|
521
|
+
}),
|
|
522
|
+
z.object({
|
|
523
|
+
type: z.literal("INNER_SHADOW"),
|
|
524
|
+
color: rgbaSchema,
|
|
525
|
+
offset: z.object({
|
|
526
|
+
x: z.number(),
|
|
527
|
+
y: z.number()
|
|
528
|
+
}),
|
|
529
|
+
radius: z.number().min(0),
|
|
530
|
+
spread: z.number().optional(),
|
|
531
|
+
visible: z.boolean().optional(),
|
|
532
|
+
blendMode: blendModeSchema.default("NORMAL")
|
|
533
|
+
}),
|
|
534
|
+
z.object({
|
|
535
|
+
type: z.literal("LAYER_BLUR"),
|
|
536
|
+
radius: z.number().min(0),
|
|
537
|
+
visible: z.boolean().optional()
|
|
538
|
+
}),
|
|
539
|
+
z.object({
|
|
540
|
+
type: z.literal("BACKGROUND_BLUR"),
|
|
541
|
+
radius: z.number().min(0),
|
|
542
|
+
visible: z.boolean().optional()
|
|
543
|
+
})
|
|
544
|
+
]);
|
|
545
|
+
var constraintTypeSchema = z.enum([
|
|
546
|
+
"MIN",
|
|
547
|
+
"MAX",
|
|
548
|
+
"STRETCH",
|
|
549
|
+
"CENTER",
|
|
550
|
+
"SCALE"
|
|
551
|
+
]);
|
|
552
|
+
var layoutGridSchema = z.object({
|
|
553
|
+
pattern: z.enum([
|
|
554
|
+
"ROWS",
|
|
555
|
+
"COLUMNS",
|
|
556
|
+
"GRID"
|
|
557
|
+
]).describe("网格类型:ROWS|COLUMNS|GRID"),
|
|
558
|
+
alignment: z.enum([
|
|
559
|
+
"MIN",
|
|
560
|
+
"MAX",
|
|
561
|
+
"CENTER",
|
|
562
|
+
"STRETCH"
|
|
563
|
+
]).optional().describe("对齐:MIN|MAX|CENTER|STRETCH"),
|
|
564
|
+
sectionSize: z.number().optional().describe("分节尺寸(px)"),
|
|
565
|
+
count: z.number().int().positive().optional().describe("网格数"),
|
|
566
|
+
gutterSize: z.number().optional().describe("沟槽尺寸(px)"),
|
|
567
|
+
offset: z.number().optional().describe("偏移(px)"),
|
|
568
|
+
visible: z.boolean().optional().describe("是否可见"),
|
|
569
|
+
color: rgbaSchema.optional().describe("网格颜色")
|
|
570
|
+
});
|
|
571
|
+
var vectorPathSchema = z.object({
|
|
572
|
+
data: z.string().describe("SVG path data"),
|
|
573
|
+
windingRule: z.enum(["NONZERO", "EVENODD"]).optional().describe("环绕规则:NONZERO|EVENODD")
|
|
574
|
+
});
|
|
575
|
+
var fontNameSchema = z.object({
|
|
576
|
+
family: z.string(),
|
|
577
|
+
style: z.string()
|
|
578
|
+
});
|
|
579
|
+
var lineHeightSchema = z.union([
|
|
580
|
+
z.object({
|
|
581
|
+
value: z.number(),
|
|
582
|
+
unit: z.literal("PIXELS")
|
|
583
|
+
}),
|
|
584
|
+
z.object({
|
|
585
|
+
value: z.number(),
|
|
586
|
+
unit: z.literal("PERCENT")
|
|
587
|
+
}),
|
|
588
|
+
z.object({ unit: z.literal("AUTO") })
|
|
589
|
+
]);
|
|
590
|
+
var letterSpacingSchema = z.object({
|
|
591
|
+
value: z.number(),
|
|
592
|
+
unit: z.literal("PIXELS")
|
|
593
|
+
});
|
|
435
594
|
var nodeTypeSchema = z.enum([
|
|
436
595
|
"SLICE",
|
|
437
596
|
"FRAME",
|
|
@@ -448,29 +607,135 @@ var nodeTypeSchema = z.enum([
|
|
|
448
607
|
"RECTANGLE",
|
|
449
608
|
"TEXT"
|
|
450
609
|
]);
|
|
451
|
-
var
|
|
452
|
-
|
|
610
|
+
var transformPropsSchema = z.object({
|
|
611
|
+
x: z.number().optional().describe("X 坐标(px)"),
|
|
612
|
+
y: z.number().optional().describe("Y 坐标(px)"),
|
|
613
|
+
width: z.number().optional().describe("宽度(px)"),
|
|
614
|
+
height: z.number().optional().describe("高度(px)"),
|
|
615
|
+
rotation: z.number().optional().describe("旋转角度(deg)"),
|
|
616
|
+
opacity: z.number().optional().describe("不透明度 0-1"),
|
|
617
|
+
visible: z.boolean().optional().describe("是否可见"),
|
|
618
|
+
locked: z.boolean().optional().describe("锁定图层")
|
|
619
|
+
});
|
|
620
|
+
var strokePropsSchema = z.object({
|
|
621
|
+
strokes: z.array(paintSchema).optional().describe("描边列表(Paint 数组)"),
|
|
622
|
+
strokeWeight: z.number().optional().describe("描边宽度(px)"),
|
|
623
|
+
strokeTopWeight: z.number().optional().describe("描边顶部宽(px)"),
|
|
624
|
+
strokeBottomWeight: z.number().optional().describe("描边底部宽(px)"),
|
|
625
|
+
strokeLeftWeight: z.number().optional().describe("描边左侧宽(px)"),
|
|
626
|
+
strokeRightWeight: z.number().optional().describe("描边右侧宽(px)"),
|
|
627
|
+
strokeAlign: z.enum([
|
|
628
|
+
"CENTER",
|
|
629
|
+
"INSIDE",
|
|
630
|
+
"OUTSIDE"
|
|
631
|
+
]).optional().describe("描边对齐:CENTER|INSIDE|OUTSIDE"),
|
|
632
|
+
strokeCap: z.enum([
|
|
633
|
+
"NONE",
|
|
634
|
+
"ROUND",
|
|
635
|
+
"SQUARE",
|
|
636
|
+
"ARROW_LINES",
|
|
637
|
+
"ARROW_EQUILATERAL"
|
|
638
|
+
]).optional().describe("描边端点:NONE|ROUND|SQUARE|ARROW_LINES|ARROW_EQUILATERAL"),
|
|
639
|
+
strokeJoin: z.enum([
|
|
640
|
+
"MITER",
|
|
641
|
+
"BEVEL",
|
|
642
|
+
"ROUND"
|
|
643
|
+
]).optional().describe("描边连接:MITER|BEVEL|ROUND"),
|
|
644
|
+
dashPattern: z.array(z.number()).optional().describe("虚线段数组,如 [4,4]")
|
|
645
|
+
});
|
|
646
|
+
var cornerPropsSchema = z.object({
|
|
647
|
+
cornerRadius: z.number().optional().describe("圆角半径(px),四角统一"),
|
|
648
|
+
topLeftRadius: z.number().optional().describe("左上圆角(px)"),
|
|
649
|
+
topRightRadius: z.number().optional().describe("右上圆角(px)"),
|
|
650
|
+
bottomLeftRadius: z.number().optional().describe("左下圆角(px)"),
|
|
651
|
+
bottomRightRadius: z.number().optional().describe("右下圆角(px)")
|
|
652
|
+
});
|
|
653
|
+
var textPropsSchema = z.object({
|
|
654
|
+
characters: z.string().optional().describe("文本内容"),
|
|
655
|
+
fontSize: z.number().optional().describe("字号(px)"),
|
|
656
|
+
fontName: fontNameSchema.optional().describe("字体:{family,style}"),
|
|
657
|
+
textAlignHorizontal: z.enum([
|
|
658
|
+
"LEFT",
|
|
659
|
+
"CENTER",
|
|
660
|
+
"RIGHT",
|
|
661
|
+
"JUSTIFIED"
|
|
662
|
+
]).optional().describe("水平对齐:LEFT|CENTER|RIGHT|JUSTIFIED"),
|
|
663
|
+
textAlignVertical: z.enum([
|
|
664
|
+
"TOP",
|
|
665
|
+
"CENTER",
|
|
666
|
+
"BOTTOM"
|
|
667
|
+
]).optional().describe("垂直对齐:TOP|CENTER|BOTTOM"),
|
|
668
|
+
textAutoResize: z.enum([
|
|
669
|
+
"NONE",
|
|
670
|
+
"WIDTH_AND_HEIGHT",
|
|
671
|
+
"HEIGHT",
|
|
672
|
+
"TRUNCATE"
|
|
673
|
+
]).optional().describe("文本自适应:NONE|WIDTH_AND_HEIGHT|HEIGHT|TRUNCATE"),
|
|
674
|
+
textCase: z.enum([
|
|
675
|
+
"ORIGINAL",
|
|
676
|
+
"UPPER",
|
|
677
|
+
"LOWER",
|
|
678
|
+
"TITLE"
|
|
679
|
+
]).optional().describe("文本大小写:ORIGINAL|UPPER|LOWER|TITLE"),
|
|
680
|
+
textDecoration: z.enum([
|
|
681
|
+
"NONE",
|
|
682
|
+
"UNDERLINE",
|
|
683
|
+
"STRIKETHROUGH"
|
|
684
|
+
]).optional().describe("文本装饰:NONE|UNDERLINE|STRIKETHROUGH"),
|
|
685
|
+
lineHeight: lineHeightSchema.optional().describe("行高:{value,unit}"),
|
|
686
|
+
letterSpacing: letterSpacingSchema.optional().describe("字距:{value,unit}")
|
|
687
|
+
});
|
|
688
|
+
var autoLayoutPropsSchema = z.object({
|
|
689
|
+
layoutMode: z.enum([
|
|
690
|
+
"NONE",
|
|
691
|
+
"HORIZONTAL",
|
|
692
|
+
"VERTICAL"
|
|
693
|
+
]).optional().describe("自动布局方向:NONE|HORIZONTAL|VERTICAL"),
|
|
453
694
|
itemSpacing: z.number().optional().describe("自动布局项间距(px)"),
|
|
454
|
-
padding: z.number().optional().describe("自动布局内边距,四边统一(px)"),
|
|
455
695
|
paddingTop: z.number().optional().describe("上内边距(px)"),
|
|
456
696
|
paddingRight: z.number().optional().describe("右内边距(px)"),
|
|
457
697
|
paddingBottom: z.number().optional().describe("下内边距(px)"),
|
|
458
698
|
paddingLeft: z.number().optional().describe("左内边距(px)"),
|
|
459
|
-
primaryAxisSizingMode:
|
|
460
|
-
counterAxisSizingMode:
|
|
461
|
-
primaryAxisAlignItems:
|
|
699
|
+
primaryAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional().describe("主轴尺寸模式:FIXED|AUTO"),
|
|
700
|
+
counterAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional().describe("交叉轴尺寸模式:FIXED|AUTO"),
|
|
701
|
+
primaryAxisAlignItems: z.enum([
|
|
462
702
|
"MIN",
|
|
463
703
|
"MAX",
|
|
464
704
|
"CENTER",
|
|
465
705
|
"SPACE_BETWEEN"
|
|
466
706
|
]).optional().describe("主轴对齐:MIN|MAX|CENTER|SPACE_BETWEEN"),
|
|
467
|
-
counterAxisAlignItems:
|
|
707
|
+
counterAxisAlignItems: z.enum([
|
|
468
708
|
"MIN",
|
|
469
709
|
"MAX",
|
|
470
710
|
"CENTER"
|
|
471
|
-
]).optional().describe("交叉轴对齐:MIN|MAX|CENTER")
|
|
711
|
+
]).optional().describe("交叉轴对齐:MIN|MAX|CENTER"),
|
|
712
|
+
layoutGrow: z.number().optional().describe("自动布局内伸缩系数"),
|
|
713
|
+
layoutAlign: z.enum([
|
|
714
|
+
"MIN",
|
|
715
|
+
"CENTER",
|
|
716
|
+
"MAX",
|
|
717
|
+
"STRETCH",
|
|
718
|
+
"INHERIT"
|
|
719
|
+
]).optional().describe("自动布局内对齐:MIN|CENTER|MAX|STRETCH|INHERIT")
|
|
720
|
+
});
|
|
721
|
+
var visualPropsSchema = z.object({
|
|
722
|
+
fills: z.array(paintSchema).optional().describe("填充列表(Paint 数组)"),
|
|
723
|
+
blendMode: blendModeSchema.optional().describe("混合模式"),
|
|
724
|
+
effects: z.array(effectSchema).optional().describe("效果列表(阴影/模糊,可多层叠加)"),
|
|
725
|
+
constraints: z.object({
|
|
726
|
+
horizontal: constraintTypeSchema.describe("水平约束:MIN|MAX|STRETCH|CENTER|SCALE"),
|
|
727
|
+
vertical: constraintTypeSchema.describe("垂直约束:MIN|MAX|STRETCH|CENTER|SCALE")
|
|
728
|
+
}).optional().describe("自动布局中的约束"),
|
|
729
|
+
clipsContent: z.boolean().optional().describe("是否裁剪溢出内容"),
|
|
730
|
+
cornerSmoothing: z.number().optional().describe("圆角平滑度 0-1"),
|
|
731
|
+
layoutGrids: z.array(layoutGridSchema).optional().describe("布局网格(参考线)"),
|
|
732
|
+
arcData: z.object({
|
|
733
|
+
startingAngle: z.number().describe("起始角度(radians)"),
|
|
734
|
+
endingAngle: z.number().describe("结束角度(radians)"),
|
|
735
|
+
innerRadius: z.number().describe("内半径(0-1 ratio)")
|
|
736
|
+
}).optional().describe("环形路径参数(弧线)")
|
|
472
737
|
});
|
|
473
|
-
var serializedNodeSchema = z.object({
|
|
738
|
+
var serializedNodeSchema = z.lazy(() => z.object({
|
|
474
739
|
id: z.string(),
|
|
475
740
|
name: z.string(),
|
|
476
741
|
type: nodeTypeSchema,
|
|
@@ -480,17 +745,16 @@ var serializedNodeSchema = z.object({
|
|
|
480
745
|
height: z.number().optional(),
|
|
481
746
|
rotation: z.number().optional(),
|
|
482
747
|
opacity: z.number().optional(),
|
|
748
|
+
visible: z.boolean().optional(),
|
|
483
749
|
locked: z.boolean().optional(),
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
|
|
487
|
-
stops: z.array(z.object({
|
|
488
|
-
color: z.string(),
|
|
489
|
-
position: z.number()
|
|
490
|
-
}))
|
|
491
|
-
}).optional(),
|
|
492
|
-
stroke: z.string().optional(),
|
|
750
|
+
parentId: z.string().optional(),
|
|
751
|
+
fills: z.array(paintSchema).optional(),
|
|
752
|
+
strokes: z.array(paintSchema).optional(),
|
|
493
753
|
strokeWeight: z.number().optional(),
|
|
754
|
+
strokeTopWeight: z.number().optional(),
|
|
755
|
+
strokeBottomWeight: z.number().optional(),
|
|
756
|
+
strokeLeftWeight: z.number().optional(),
|
|
757
|
+
strokeRightWeight: z.number().optional(),
|
|
494
758
|
strokeAlign: z.enum([
|
|
495
759
|
"CENTER",
|
|
496
760
|
"INSIDE",
|
|
@@ -510,61 +774,49 @@ var serializedNodeSchema = z.object({
|
|
|
510
774
|
]).optional(),
|
|
511
775
|
dashPattern: z.array(z.number()).optional(),
|
|
512
776
|
cornerSmoothing: z.number().optional(),
|
|
513
|
-
blendMode:
|
|
777
|
+
blendMode: blendModeSchema.optional(),
|
|
514
778
|
constraints: z.object({
|
|
515
|
-
horizontal:
|
|
516
|
-
|
|
517
|
-
"MAX",
|
|
518
|
-
"STRETCH",
|
|
519
|
-
"CENTER",
|
|
520
|
-
"SCALE"
|
|
521
|
-
]),
|
|
522
|
-
vertical: z.enum([
|
|
523
|
-
"MIN",
|
|
524
|
-
"MAX",
|
|
525
|
-
"STRETCH",
|
|
526
|
-
"CENTER",
|
|
527
|
-
"SCALE"
|
|
528
|
-
])
|
|
779
|
+
horizontal: constraintTypeSchema,
|
|
780
|
+
vertical: constraintTypeSchema
|
|
529
781
|
}).optional(),
|
|
530
|
-
layoutGrids: z.array(
|
|
531
|
-
pattern: z.enum([
|
|
532
|
-
"ROWS",
|
|
533
|
-
"COLUMNS",
|
|
534
|
-
"GRID"
|
|
535
|
-
]),
|
|
536
|
-
alignment: z.enum([
|
|
537
|
-
"MIN",
|
|
538
|
-
"MAX",
|
|
539
|
-
"STRETCH",
|
|
540
|
-
"CENTER"
|
|
541
|
-
]).optional(),
|
|
542
|
-
gutterSize: z.number().optional(),
|
|
543
|
-
count: z.number().optional(),
|
|
544
|
-
sectionSize: z.number().optional(),
|
|
545
|
-
offset: z.number().optional(),
|
|
546
|
-
visible: z.boolean().optional(),
|
|
547
|
-
color: z.string().optional()
|
|
548
|
-
})).optional(),
|
|
782
|
+
layoutGrids: z.array(layoutGridSchema).optional(),
|
|
549
783
|
clipsContent: z.boolean().optional(),
|
|
550
784
|
arcData: z.object({
|
|
551
785
|
startingAngle: z.number(),
|
|
552
786
|
endingAngle: z.number(),
|
|
553
787
|
innerRadius: z.number()
|
|
554
788
|
}).optional(),
|
|
555
|
-
|
|
556
|
-
x: z.number(),
|
|
557
|
-
y: z.number(),
|
|
558
|
-
radius: z.number(),
|
|
559
|
-
color: z.string()
|
|
560
|
-
}).optional(),
|
|
789
|
+
effects: z.array(effectSchema).optional(),
|
|
561
790
|
cornerRadius: z.number().optional(),
|
|
562
|
-
|
|
563
|
-
|
|
564
|
-
|
|
565
|
-
|
|
791
|
+
topLeftRadius: z.number().optional(),
|
|
792
|
+
topRightRadius: z.number().optional(),
|
|
793
|
+
bottomLeftRadius: z.number().optional(),
|
|
794
|
+
bottomRightRadius: z.number().optional(),
|
|
566
795
|
pointCount: z.number().optional(),
|
|
567
|
-
|
|
796
|
+
innerRadius: z.number().optional(),
|
|
797
|
+
layoutMode: z.enum([
|
|
798
|
+
"NONE",
|
|
799
|
+
"HORIZONTAL",
|
|
800
|
+
"VERTICAL"
|
|
801
|
+
]).optional(),
|
|
802
|
+
itemSpacing: z.number().optional(),
|
|
803
|
+
paddingTop: z.number().optional(),
|
|
804
|
+
paddingRight: z.number().optional(),
|
|
805
|
+
paddingBottom: z.number().optional(),
|
|
806
|
+
paddingLeft: z.number().optional(),
|
|
807
|
+
primaryAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional(),
|
|
808
|
+
counterAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional(),
|
|
809
|
+
primaryAxisAlignItems: z.enum([
|
|
810
|
+
"MIN",
|
|
811
|
+
"MAX",
|
|
812
|
+
"CENTER",
|
|
813
|
+
"SPACE_BETWEEN"
|
|
814
|
+
]).optional(),
|
|
815
|
+
counterAxisAlignItems: z.enum([
|
|
816
|
+
"MIN",
|
|
817
|
+
"MAX",
|
|
818
|
+
"CENTER"
|
|
819
|
+
]).optional(),
|
|
568
820
|
layoutGrow: z.number().optional(),
|
|
569
821
|
layoutAlign: z.enum([
|
|
570
822
|
"MIN",
|
|
@@ -574,11 +826,16 @@ var serializedNodeSchema = z.object({
|
|
|
574
826
|
"INHERIT"
|
|
575
827
|
]).optional(),
|
|
576
828
|
childCount: z.number().optional(),
|
|
577
|
-
children: z.array(
|
|
829
|
+
children: z.array(serializedNodeSchema).optional(),
|
|
578
830
|
characters: z.string().optional(),
|
|
579
831
|
fontSize: z.number().optional(),
|
|
580
|
-
|
|
581
|
-
|
|
832
|
+
fontName: fontNameSchema.optional(),
|
|
833
|
+
textAlignHorizontal: z.enum([
|
|
834
|
+
"LEFT",
|
|
835
|
+
"CENTER",
|
|
836
|
+
"RIGHT",
|
|
837
|
+
"JUSTIFIED"
|
|
838
|
+
]).optional(),
|
|
582
839
|
textAlignVertical: z.enum([
|
|
583
840
|
"TOP",
|
|
584
841
|
"CENTER",
|
|
@@ -601,14 +858,20 @@ var serializedNodeSchema = z.object({
|
|
|
601
858
|
"UNDERLINE",
|
|
602
859
|
"STRIKETHROUGH"
|
|
603
860
|
]).optional(),
|
|
604
|
-
|
|
605
|
-
|
|
606
|
-
|
|
607
|
-
|
|
861
|
+
lineHeight: lineHeightSchema.optional(),
|
|
862
|
+
letterSpacing: letterSpacingSchema.optional(),
|
|
863
|
+
vectorPaths: z.array(vectorPathSchema).optional(),
|
|
864
|
+
booleanOperation: z.enum([
|
|
865
|
+
"UNION",
|
|
866
|
+
"SUBTRACT",
|
|
867
|
+
"INTERSECT",
|
|
868
|
+
"EXCLUDE"
|
|
869
|
+
]).optional(),
|
|
870
|
+
isMask: z.boolean().optional(),
|
|
608
871
|
variantProperties: z.record(z.string(), z.string()).optional(),
|
|
609
872
|
mainComponentId: z.string().optional(),
|
|
610
873
|
variantGroupProperties: z.record(z.string(), z.array(z.string())).optional()
|
|
611
|
-
});
|
|
874
|
+
}));
|
|
612
875
|
var createdResultSchema = z.object({ created: z.union([serializedNodeSchema, z.array(serializedNodeSchema)]) });
|
|
613
876
|
var updatedResultSchema = z.object({ updated: z.array(serializedNodeSchema) });
|
|
614
877
|
var pingResultSchema = z.object({
|
|
@@ -656,182 +919,21 @@ var listFontsResultSchema = z.object({
|
|
|
656
919
|
});
|
|
657
920
|
z.object({});
|
|
658
921
|
z.object({ depth: z.number().optional().describe("序列化深度,0 表示只含节点自身属性;缺省 2") });
|
|
659
|
-
var executeOpSchema = z.enum([
|
|
660
|
-
"frame",
|
|
661
|
-
"rect",
|
|
662
|
-
"ellipse",
|
|
663
|
-
"line",
|
|
664
|
-
"polygon",
|
|
665
|
-
"star",
|
|
666
|
-
"vector",
|
|
667
|
-
"boolean",
|
|
668
|
-
"text"
|
|
669
|
-
]);
|
|
670
922
|
var executeNodeSchema = z.lazy(() => z.object({
|
|
671
|
-
|
|
923
|
+
type: nodeTypeSchema.describe("节点类型:FRAME|RECTANGLE|ELLIPSE|LINE|POLYGON|STAR|VECTOR|BOOLEAN_OPERATION|TEXT"),
|
|
672
924
|
name: z.string().optional().describe("图层名"),
|
|
673
|
-
|
|
674
|
-
|
|
675
|
-
|
|
676
|
-
|
|
677
|
-
|
|
678
|
-
radius: z.number().optional().describe("圆角半径(px),四角统一"),
|
|
679
|
-
radiusTopLeft: z.number().optional().describe("左上圆角(px)"),
|
|
680
|
-
radiusTopRight: z.number().optional().describe("右上圆角(px)"),
|
|
681
|
-
radiusBottomLeft: z.number().optional().describe("左下圆角(px)"),
|
|
682
|
-
radiusBottomRight: z.number().optional().describe("右下圆角(px)"),
|
|
683
|
-
rotation: z.number().optional().describe("旋转角度(deg)"),
|
|
684
|
-
opacity: z.number().optional().describe("不透明度 0-1"),
|
|
685
|
-
locked: z.boolean().optional().describe("锁定图层"),
|
|
686
|
-
stroke: z.string().optional().describe("描边色,hex 或 rgba"),
|
|
687
|
-
strokeWeight: z.number().optional().describe("描边宽度(px)"),
|
|
688
|
-
strokeAlign: pre([
|
|
689
|
-
"CENTER",
|
|
690
|
-
"INSIDE",
|
|
691
|
-
"OUTSIDE"
|
|
692
|
-
]).optional().describe("描边对齐:CENTER|INSIDE|OUTSIDE"),
|
|
693
|
-
strokeCap: z.enum([
|
|
694
|
-
"NONE",
|
|
695
|
-
"ROUND",
|
|
696
|
-
"SQUARE",
|
|
697
|
-
"ARROW_LINES",
|
|
698
|
-
"ARROW_EQUILATERAL"
|
|
699
|
-
]).optional().describe("描边端点:NONE|ROUND|SQUARE|ARROW_LINES|ARROW_EQUILATERAL"),
|
|
700
|
-
strokeJoin: z.enum([
|
|
701
|
-
"MITER",
|
|
702
|
-
"BEVEL",
|
|
703
|
-
"ROUND"
|
|
704
|
-
]).optional().describe("描边连接:MITER|BEVEL|ROUND"),
|
|
705
|
-
dashPattern: z.array(z.number()).optional().describe("虚线段数组,如 [4,4]"),
|
|
706
|
-
cornerSmoothing: z.number().optional().describe("圆角平滑度 0-1"),
|
|
707
|
-
blendMode: z.string().optional().describe("混合模式,如 NORMAL"),
|
|
708
|
-
constraints: z.object({
|
|
709
|
-
horizontal: pre([
|
|
710
|
-
"MIN",
|
|
711
|
-
"MAX",
|
|
712
|
-
"STRETCH",
|
|
713
|
-
"CENTER",
|
|
714
|
-
"SCALE"
|
|
715
|
-
]).describe("水平约束:MIN|MAX|STRETCH|CENTER|SCALE"),
|
|
716
|
-
vertical: pre([
|
|
717
|
-
"MIN",
|
|
718
|
-
"MAX",
|
|
719
|
-
"STRETCH",
|
|
720
|
-
"CENTER",
|
|
721
|
-
"SCALE"
|
|
722
|
-
]).describe("垂直约束:MIN|MAX|STRETCH|CENTER|SCALE")
|
|
723
|
-
}).optional().describe("自动布局中的约束"),
|
|
724
|
-
layoutGrids: z.array(z.object({
|
|
725
|
-
pattern: z.enum([
|
|
726
|
-
"ROWS",
|
|
727
|
-
"COLUMNS",
|
|
728
|
-
"GRID"
|
|
729
|
-
]).describe("网格类型:ROWS|COLUMNS|GRID"),
|
|
730
|
-
alignment: z.enum([
|
|
731
|
-
"MIN",
|
|
732
|
-
"MAX",
|
|
733
|
-
"STRETCH",
|
|
734
|
-
"CENTER"
|
|
735
|
-
]).optional().describe("对齐:MIN|MAX|STRETCH|CENTER"),
|
|
736
|
-
gutterSize: z.number().optional().describe("沟槽尺寸(px)"),
|
|
737
|
-
count: z.number().optional().describe("网格数"),
|
|
738
|
-
sectionSize: z.number().optional().describe("分节尺寸(px)"),
|
|
739
|
-
offset: z.number().optional().describe("偏移(px)"),
|
|
740
|
-
visible: z.boolean().optional().describe("是否可见"),
|
|
741
|
-
color: z.string().optional().describe("网格颜色,hex"),
|
|
742
|
-
colorOpacity: z.number().optional().describe("网格颜色不透明度 0-1")
|
|
743
|
-
})).optional().describe("布局网格(参考线)"),
|
|
744
|
-
clipsContent: z.boolean().optional().describe("是否裁剪溢出内容"),
|
|
745
|
-
arcData: z.object({
|
|
746
|
-
startingAngle: z.number().describe("起始角度(deg)"),
|
|
747
|
-
endingAngle: z.number().describe("结束角度(deg)"),
|
|
748
|
-
innerRadius: z.number().describe("内半径(px)")
|
|
749
|
-
}).optional().describe("环形路径参数(弧线)"),
|
|
750
|
-
shadow: z.object({
|
|
751
|
-
color: z.string().optional().describe("阴影色,hex 或 rgba"),
|
|
752
|
-
x: z.number().optional().describe("水平偏移(px)"),
|
|
753
|
-
y: z.number().optional().describe("垂直偏移(px)"),
|
|
754
|
-
radius: z.number().optional().describe("模糊半径(px)"),
|
|
755
|
-
spread: z.number().optional().describe("扩散(px)")
|
|
756
|
-
}).optional().describe("投影"),
|
|
757
|
-
gradient: z.object({
|
|
758
|
-
stops: z.array(z.object({
|
|
759
|
-
color: z.string().describe("色标颜色"),
|
|
760
|
-
position: z.number().describe("位置 0-1")
|
|
761
|
-
})).optional().describe("渐变节点"),
|
|
762
|
-
angle: z.number().optional().describe("渐变角度(deg)")
|
|
763
|
-
}).optional().describe("线性渐变填充"),
|
|
764
|
-
pointCount: z.number().optional().describe("多边形/polygon op 的顶点数"),
|
|
765
|
-
innerRadius: z.number().optional().describe("多边形内半径(px)"),
|
|
766
|
-
booleanType: z.enum([
|
|
925
|
+
pointCount: z.number().optional().describe("多边形/星形角点数"),
|
|
926
|
+
innerRadius: z.number().optional().describe("星形内半径(px)"),
|
|
927
|
+
children: z.array(z.lazy(() => executeNodeSchema)).optional().describe("子节点数组(递归)"),
|
|
928
|
+
vectorPaths: z.array(vectorPathSchema).optional().describe("矢量路径数组"),
|
|
929
|
+
booleanOperation: z.enum([
|
|
767
930
|
"UNION",
|
|
768
931
|
"SUBTRACT",
|
|
769
932
|
"INTERSECT",
|
|
770
933
|
"EXCLUDE"
|
|
771
|
-
]).optional().describe("
|
|
772
|
-
|
|
773
|
-
|
|
774
|
-
z.object({
|
|
775
|
-
data: z.string(),
|
|
776
|
-
windingRule: z.enum([
|
|
777
|
-
"NONZERO",
|
|
778
|
-
"EVENODD",
|
|
779
|
-
"NONE"
|
|
780
|
-
]).optional()
|
|
781
|
-
}),
|
|
782
|
-
z.array(z.union([z.string(), z.object({
|
|
783
|
-
data: z.string(),
|
|
784
|
-
windingRule: z.enum([
|
|
785
|
-
"NONZERO",
|
|
786
|
-
"EVENODD",
|
|
787
|
-
"NONE"
|
|
788
|
-
]).optional()
|
|
789
|
-
})]))
|
|
790
|
-
]).optional().describe("矢量路径:SVG path data 字符串(或对象/数组)"),
|
|
791
|
-
fontSize: z.number().optional().describe("字号(px)"),
|
|
792
|
-
fontWeight: z.number().optional().describe("字重(如 400/700)"),
|
|
793
|
-
fontFamily: z.string().optional().describe("字体族"),
|
|
794
|
-
characters: z.string().optional().describe("文本内容"),
|
|
795
|
-
textAlign: pre([
|
|
796
|
-
"LEFT",
|
|
797
|
-
"CENTER",
|
|
798
|
-
"RIGHT"
|
|
799
|
-
]).optional().describe("水平对齐:LEFT|CENTER|RIGHT"),
|
|
800
|
-
textAlignVertical: pre([
|
|
801
|
-
"TOP",
|
|
802
|
-
"CENTER",
|
|
803
|
-
"BOTTOM"
|
|
804
|
-
]).optional().describe("垂直对齐:TOP|CENTER|BOTTOM"),
|
|
805
|
-
textAutoResize: z.enum([
|
|
806
|
-
"NONE",
|
|
807
|
-
"WIDTH_AND_HEIGHT",
|
|
808
|
-
"HEIGHT",
|
|
809
|
-
"TRUNCATE"
|
|
810
|
-
]).optional().describe("文本自适应:NONE|WIDTH_AND_HEIGHT|HEIGHT|TRUNCATE"),
|
|
811
|
-
textCase: pre([
|
|
812
|
-
"ORIGINAL",
|
|
813
|
-
"UPPER",
|
|
814
|
-
"LOWER",
|
|
815
|
-
"TITLE"
|
|
816
|
-
]).optional().describe("文本大小写:ORIGINAL|UPPER|LOWER|TITLE"),
|
|
817
|
-
textDecoration: pre([
|
|
818
|
-
"NONE",
|
|
819
|
-
"UNDERLINE",
|
|
820
|
-
"STRIKETHROUGH"
|
|
821
|
-
]).optional().describe("文本装饰:NONE|UNDERLINE|STRIKETHROUGH"),
|
|
822
|
-
lineHeight: z.number().optional().describe("行高(px)"),
|
|
823
|
-
letterSpacing: z.number().optional().describe("字间距(px)"),
|
|
824
|
-
layout: serializedLayoutSchema.optional().describe("自动布局参数"),
|
|
825
|
-
layoutGrow: z.number().optional().describe("自动布局内伸缩系数,>0 则自动填满剩余空间"),
|
|
826
|
-
layoutAlign: pre([
|
|
827
|
-
"MIN",
|
|
828
|
-
"CENTER",
|
|
829
|
-
"MAX",
|
|
830
|
-
"STRETCH",
|
|
831
|
-
"INHERIT"
|
|
832
|
-
]).optional().describe("自动布局内对齐:MIN|CENTER|MAX|STRETCH|INHERIT"),
|
|
833
|
-
children: z.array(z.lazy(() => executeNodeSchema)).optional().describe("子节点数组(递归)")
|
|
834
|
-
}));
|
|
934
|
+
]).optional().describe("布尔运算:UNION|SUBTRACT|INTERSECT|EXCLUDE"),
|
|
935
|
+
isMask: z.boolean().optional().describe("是否为蒙版")
|
|
936
|
+
}).and(transformPropsSchema).and(strokePropsSchema).and(cornerPropsSchema).and(textPropsSchema).and(autoLayoutPropsSchema).and(visualPropsSchema));
|
|
835
937
|
var placementSchema = z.object({
|
|
836
938
|
mode: z.enum([
|
|
837
939
|
"center",
|
|
@@ -854,174 +956,25 @@ var htmlToDesignSchema = z.object({
|
|
|
854
956
|
name: z.string().optional().describe("生成的图层名,默认 html-design")
|
|
855
957
|
});
|
|
856
958
|
var createIconSchema = z.object({
|
|
857
|
-
icon: z.string().describe("图标名/别名/语义描述,如 home、arrow-right、magnifier(搜索)
|
|
959
|
+
icon: z.string().describe("图标名/别名/语义描述,如 home、arrow-right、search、magnifier(搜索);支持模糊匹配与别名联想,查无返回候选提示"),
|
|
858
960
|
size: z.number().optional().describe("图标边长 px,默认 24"),
|
|
859
961
|
color: z.string().optional().describe("描边颜色(十六进制),默认 #000000"),
|
|
860
962
|
strokeWidth: z.number().optional().describe("描边宽度,默认 2"),
|
|
861
963
|
name: z.string().optional().describe("生成的图层名,默认 icon-<图标名>")
|
|
862
964
|
});
|
|
863
|
-
var
|
|
965
|
+
var updateNodePropsSchema = z.object({
|
|
864
966
|
name: z.string().optional().describe("图层名称"),
|
|
865
|
-
|
|
866
|
-
|
|
867
|
-
|
|
868
|
-
|
|
869
|
-
|
|
870
|
-
cornerRadius: z.number().optional().describe("四角统一圆角半径"),
|
|
871
|
-
radiusTopLeft: z.number().optional().describe("左上角圆角"),
|
|
872
|
-
radiusTopRight: z.number().optional().describe("右上角圆角"),
|
|
873
|
-
radiusBottomLeft: z.number().optional().describe("左下角圆角"),
|
|
874
|
-
radiusBottomRight: z.number().optional().describe("右下角圆角"),
|
|
875
|
-
visible: z.boolean().optional().describe("是否可见"),
|
|
876
|
-
rotation: z.number().optional().describe("旋转角度(度)"),
|
|
877
|
-
opacity: z.number().optional().describe("不透明度 0~1"),
|
|
878
|
-
locked: z.boolean().optional().describe("是否锁定"),
|
|
879
|
-
cornerSmoothing: z.number().optional().describe("圆角平滑度 0~1"),
|
|
880
|
-
blendMode: z.string().optional().describe("混合模式,如 MULTIPLY/SCREEN 等"),
|
|
881
|
-
clipsContent: z.boolean().optional().describe("frame 内容是否裁剪"),
|
|
882
|
-
constraints: z.object({
|
|
883
|
-
horizontal: pre([
|
|
884
|
-
"MIN",
|
|
885
|
-
"MAX",
|
|
886
|
-
"STRETCH",
|
|
887
|
-
"CENTER",
|
|
888
|
-
"SCALE"
|
|
889
|
-
]).describe("水平约束:MIN|MAX|STRETCH|CENTER|SCALE"),
|
|
890
|
-
vertical: pre([
|
|
891
|
-
"MIN",
|
|
892
|
-
"MAX",
|
|
893
|
-
"STRETCH",
|
|
894
|
-
"CENTER",
|
|
895
|
-
"SCALE"
|
|
896
|
-
]).describe("垂直约束:MIN|MAX|STRETCH|CENTER|SCALE")
|
|
897
|
-
}).optional().describe("响应式约束(图钉),如 {horizontal:MIN,vertical:TOP}"),
|
|
898
|
-
layoutGrids: z.array(z.object({
|
|
899
|
-
pattern: z.enum([
|
|
900
|
-
"ROWS",
|
|
901
|
-
"COLUMNS",
|
|
902
|
-
"GRID"
|
|
903
|
-
]).describe("网格类型:ROWS|COLUMNS|GRID"),
|
|
904
|
-
alignment: z.enum([
|
|
905
|
-
"MIN",
|
|
906
|
-
"MAX",
|
|
907
|
-
"STRETCH",
|
|
908
|
-
"CENTER"
|
|
909
|
-
]).optional().describe("对齐:MIN|MAX|STRETCH|CENTER"),
|
|
910
|
-
gutterSize: z.number().optional().describe("沟槽尺寸(px)"),
|
|
911
|
-
count: z.number().optional().describe("网格数"),
|
|
912
|
-
sectionSize: z.number().optional().describe("分节尺寸(px)"),
|
|
913
|
-
offset: z.number().optional().describe("偏移(px)"),
|
|
914
|
-
visible: z.boolean().optional().describe("是否可见"),
|
|
915
|
-
color: z.string().optional().describe("网格颜色,hex"),
|
|
916
|
-
colorOpacity: z.number().optional().describe("颜色不透明度 0-1")
|
|
917
|
-
})).optional().describe("网格参考线(网格布局)"),
|
|
918
|
-
arcData: z.object({
|
|
919
|
-
startingAngle: z.number().describe("起始角度(deg)"),
|
|
920
|
-
endingAngle: z.number().describe("结束角度(deg)"),
|
|
921
|
-
innerRadius: z.number().describe("内半径(px)")
|
|
922
|
-
}).optional().describe("椭圆/环形起止角度与内半径"),
|
|
923
|
-
characters: z.string().optional().describe("文本内容"),
|
|
924
|
-
fontSize: z.number().optional().describe("字号(px)"),
|
|
925
|
-
fontWeight: z.number().optional().describe("字重"),
|
|
926
|
-
fontFamily: z.string().optional().describe("字体族"),
|
|
927
|
-
textAlign: pre([
|
|
928
|
-
"LEFT",
|
|
929
|
-
"CENTER",
|
|
930
|
-
"RIGHT",
|
|
931
|
-
"JUSTIFIED"
|
|
932
|
-
]).optional().describe("文本对齐方式"),
|
|
933
|
-
textAlignVertical: pre([
|
|
934
|
-
"TOP",
|
|
935
|
-
"CENTER",
|
|
936
|
-
"BOTTOM"
|
|
937
|
-
]).optional().describe("文本垂直对齐"),
|
|
938
|
-
textAutoResize: z.enum([
|
|
939
|
-
"NONE",
|
|
940
|
-
"WIDTH_AND_HEIGHT",
|
|
941
|
-
"HEIGHT",
|
|
942
|
-
"TRUNCATE"
|
|
943
|
-
]).optional().describe("文本自动尺寸"),
|
|
944
|
-
textCase: pre([
|
|
945
|
-
"ORIGINAL",
|
|
946
|
-
"UPPER",
|
|
947
|
-
"LOWER",
|
|
948
|
-
"TITLE"
|
|
949
|
-
]).optional().describe("文本大小写"),
|
|
950
|
-
textDecoration: pre([
|
|
951
|
-
"NONE",
|
|
952
|
-
"UNDERLINE",
|
|
953
|
-
"STRIKETHROUGH"
|
|
954
|
-
]).optional().describe("文本装饰(下划线/删除线)"),
|
|
955
|
-
lineHeight: z.number().optional().describe("行高"),
|
|
956
|
-
letterSpacing: z.number().optional().describe("字距"),
|
|
957
|
-
stroke: z.string().optional().describe("描边颜色,如 #ffffff"),
|
|
958
|
-
strokeWeight: z.number().optional().describe("描边粗细"),
|
|
959
|
-
strokeAlign: pre([
|
|
960
|
-
"CENTER",
|
|
961
|
-
"INSIDE",
|
|
962
|
-
"OUTSIDE"
|
|
963
|
-
]).optional().describe("描边对齐"),
|
|
964
|
-
strokeCap: z.enum([
|
|
965
|
-
"NONE",
|
|
966
|
-
"ROUND",
|
|
967
|
-
"SQUARE",
|
|
968
|
-
"ARROW_LINES",
|
|
969
|
-
"ARROW_EQUILATERAL"
|
|
970
|
-
]).optional().describe("线帽/箭头"),
|
|
971
|
-
strokeJoin: z.enum([
|
|
972
|
-
"MITER",
|
|
973
|
-
"BEVEL",
|
|
974
|
-
"ROUND"
|
|
975
|
-
]).optional().describe("折角连接方式"),
|
|
976
|
-
dashPattern: z.array(z.number()).optional().describe("虚线模式,如 [4,4]"),
|
|
977
|
-
shadow: z.object({
|
|
978
|
-
color: z.string().optional().describe("阴影颜色"),
|
|
979
|
-
x: z.number().optional().describe("阴影 X 偏移"),
|
|
980
|
-
y: z.number().optional().describe("阴影 Y 偏移"),
|
|
981
|
-
radius: z.number().optional().describe("阴影模糊半径"),
|
|
982
|
-
spread: z.number().optional().describe("阴影扩展")
|
|
983
|
-
}).optional().describe("原生阴影(下拉阴影)"),
|
|
984
|
-
layoutMode: pre([
|
|
985
|
-
"NONE",
|
|
986
|
-
"HORIZONTAL",
|
|
987
|
-
"VERTICAL"
|
|
988
|
-
]).optional().describe("自动布局方向"),
|
|
989
|
-
primaryAxisSizingMode: pre(["FIXED", "AUTO"]).optional().describe("主轴尺寸模式(仅自动布局生效)"),
|
|
990
|
-
counterAxisSizingMode: pre(["FIXED", "AUTO"]).optional().describe("交叉轴尺寸模式(仅自动布局生效)"),
|
|
991
|
-
primaryAxisAlignItems: pre([
|
|
992
|
-
"MIN",
|
|
993
|
-
"MAX",
|
|
994
|
-
"CENTER",
|
|
995
|
-
"SPACE_BETWEEN"
|
|
996
|
-
]).optional().describe("主轴对齐方式(仅自动布局生效)"),
|
|
997
|
-
counterAxisAlignItems: pre([
|
|
998
|
-
"MIN",
|
|
999
|
-
"MAX",
|
|
1000
|
-
"CENTER"
|
|
1001
|
-
]).optional().describe("交叉轴对齐方式(仅自动布局生效)"),
|
|
1002
|
-
itemSpacing: z.number().optional().describe("自动布局项间距"),
|
|
1003
|
-
padding: z.number().optional().describe("自动布局内边距(四边统一)"),
|
|
1004
|
-
paddingTop: z.number().optional().describe("自动布局上内边距"),
|
|
1005
|
-
paddingRight: z.number().optional().describe("自动布局右内边距"),
|
|
1006
|
-
paddingBottom: z.number().optional().describe("自动布局下内边距"),
|
|
1007
|
-
paddingLeft: z.number().optional().describe("自动布局左内边距"),
|
|
1008
|
-
layoutGrow: z.number().optional().describe("子节点主轴填充 0=固定 1=填充(仅自动布局父容器内生效)"),
|
|
1009
|
-
layoutAlign: pre([
|
|
1010
|
-
"MIN",
|
|
1011
|
-
"CENTER",
|
|
1012
|
-
"MAX",
|
|
1013
|
-
"STRETCH",
|
|
1014
|
-
"INHERIT"
|
|
1015
|
-
]).optional().describe("子节点交叉轴对齐(仅自动布局父容器内生效)"),
|
|
1016
|
-
pointCount: z.number().optional().describe("多边形/星形角点数")
|
|
1017
|
-
});
|
|
1018
|
-
var updateSelectionSchema = z.object({
|
|
1019
|
-
ids: z.array(z.string()).optional().describe("指定节点 id,缺省用当前选中"),
|
|
967
|
+
pointCount: z.number().optional().describe("多边形/星形角点数"),
|
|
968
|
+
innerRadius: z.number().optional().describe("星形内半径(px)")
|
|
969
|
+
}).and(transformPropsSchema).and(strokePropsSchema).and(cornerPropsSchema).and(textPropsSchema).and(autoLayoutPropsSchema).and(visualPropsSchema);
|
|
970
|
+
var updateNodeSchema = z.object({
|
|
971
|
+
ids: z.array(z.string()).optional().describe("指定节点 id"),
|
|
1020
972
|
matchName: z.string().optional().describe("按节点 name 过滤,仅命中节点被修改"),
|
|
1021
973
|
recursive: z.boolean().optional().describe("是否递归应用到子节点,默认 false"),
|
|
1022
|
-
props:
|
|
974
|
+
props: updateNodePropsSchema.describe("要修改的属性")
|
|
1023
975
|
});
|
|
1024
976
|
var findSchema = z.object({
|
|
977
|
+
ids: z.array(z.string()).optional().describe("按节点 id 精确查找,优先级最高"),
|
|
1025
978
|
name: z.string().optional().describe("按名称模糊匹配(包含)"),
|
|
1026
979
|
type: z.string().optional().describe("节点类型,如 FRAME/RECTANGLE/TEXT/ELLIPSE/LINE/POLYGON/STAR/VECTOR"),
|
|
1027
980
|
recursive: z.boolean().optional().describe("是否递归查找(默认 true)"),
|
|
@@ -1044,7 +997,30 @@ var manageNodesSchema = z.discriminatedUnion("op", [
|
|
|
1044
997
|
z.object({
|
|
1045
998
|
op: z.literal("group"),
|
|
1046
999
|
ids: z.array(z.string()).describe("要编组的节点 id 列表"),
|
|
1047
|
-
name: z.string().optional().describe("组名")
|
|
1000
|
+
name: z.string().optional().describe("组名"),
|
|
1001
|
+
layoutMode: z.enum([
|
|
1002
|
+
"NONE",
|
|
1003
|
+
"HORIZONTAL",
|
|
1004
|
+
"VERTICAL"
|
|
1005
|
+
]).optional().describe("自动布局方向:NONE|HORIZONTAL|VERTICAL"),
|
|
1006
|
+
itemSpacing: z.number().optional().describe("自动布局项间距(px)"),
|
|
1007
|
+
paddingTop: z.number().optional().describe("上内边距(px)"),
|
|
1008
|
+
paddingRight: z.number().optional().describe("右内边距(px)"),
|
|
1009
|
+
paddingBottom: z.number().optional().describe("下内边距(px)"),
|
|
1010
|
+
paddingLeft: z.number().optional().describe("左内边距(px)"),
|
|
1011
|
+
primaryAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional().describe("主轴尺寸模式:FIXED|AUTO"),
|
|
1012
|
+
counterAxisSizingMode: z.enum(["FIXED", "AUTO"]).optional().describe("交叉轴尺寸模式:FIXED|AUTO"),
|
|
1013
|
+
primaryAxisAlignItems: z.enum([
|
|
1014
|
+
"MIN",
|
|
1015
|
+
"MAX",
|
|
1016
|
+
"CENTER",
|
|
1017
|
+
"SPACE_BETWEEN"
|
|
1018
|
+
]).optional().describe("主轴对齐:MIN|MAX|CENTER|SPACE_BETWEEN"),
|
|
1019
|
+
counterAxisAlignItems: z.enum([
|
|
1020
|
+
"MIN",
|
|
1021
|
+
"MAX",
|
|
1022
|
+
"CENTER"
|
|
1023
|
+
]).optional().describe("交叉轴对齐:MIN|MAX|CENTER")
|
|
1048
1024
|
}),
|
|
1049
1025
|
z.object({
|
|
1050
1026
|
op: z.literal("ungroup"),
|
|
@@ -1113,10 +1089,6 @@ var exportSchema = z.object({
|
|
|
1113
1089
|
savePath: z.string().optional().describe("落盘文件绝对路径,如 /tmp/icon.png"),
|
|
1114
1090
|
includeDataUrl: z.boolean().optional().describe("是否同时返回 base64 dataURL,默认 false")
|
|
1115
1091
|
});
|
|
1116
|
-
var fillImageSchema = z.object({
|
|
1117
|
-
ids: z.array(z.string()).describe("要填充图片的节点 id 列表"),
|
|
1118
|
-
sourcePath: z.string().describe("本地图片文件绝对路径,如 /tmp/poster.png")
|
|
1119
|
-
});
|
|
1120
1092
|
z.object({});
|
|
1121
1093
|
//#endregion
|
|
1122
1094
|
//#region src/core/response.ts
|
|
@@ -1961,7 +1933,7 @@ function iconToSvg(def, size = 24, color = "#000000", strokeWidth = 2) {
|
|
|
1961
1933
|
/** 创建类:声明式节点 / SVG 导入 / HTML 转设计 */
|
|
1962
1934
|
function registerCreateTools(server, bridge) {
|
|
1963
1935
|
server.registerTool("jsd_execute", {
|
|
1964
|
-
description: "在画布执行声明式设计指令:ops 为节点数组(每项含
|
|
1936
|
+
description: "在画布执行声明式设计指令:ops 为节点数组(每项含 type 与尺寸/位置/填充/文本/布局等属性,字段与枚举以 inputSchema 为准,枚举大写);placement 控制放置,缺省 center 居中。type 支持 FRAME|RECTANGLE|ELLIPSE|LINE|POLYGON|STAR|VECTOR|BOOLEAN_OPERATION|TEXT|GROUP,缺省 FRAME;type=VECTOR 用 vectorPaths 传 SVG path data;type=ELLIPSE 可用 arcData 画环形;type=GROUP 将子节点归为一组(内部用 Frame 实现,支持 auto-layout);type=FRAME 创建容器;type=BOOLEAN_OPERATION 用 booleanOperation 指定 UNION|SUBTRACT|INTERSECT|EXCLUDE 合并子节点。两者(GROUP/FRAME)均支持 auto-layout (layoutMode/itemSpacing/padding* 等)。",
|
|
1965
1937
|
inputSchema: executeSchema,
|
|
1966
1938
|
outputSchema: createdResultSchema
|
|
1967
1939
|
}, async ({ ops, placement }) => {
|
|
@@ -2030,7 +2002,7 @@ function registerCreateTools(server, bridge) {
|
|
|
2030
2002
|
/** 管理类:节点结构操作 + 组件/实例操作 */
|
|
2031
2003
|
function registerManageTools(server, bridge) {
|
|
2032
2004
|
server.registerTool("jsd_manage_nodes", {
|
|
2033
|
-
description: "对节点执行结构操作。按 op 分发:select 设置选中 / remove 删除 / clone 复制(右下偏移24px) / group 编组 / ungroup 取消编组 / flatten 合并为单个矢量 / outline_stroke 描边转矢量轮廓 / reparent 移动到目标父节点下 / repair
|
|
2005
|
+
description: "对节点执行结构操作。按 op 分发:select 设置选中 / remove 删除 / clone 复制(右下偏移24px) / group 编组(支持 auto-layout) / ungroup 取消编组 / flatten 合并为单个矢量 / outline_stroke 描边转矢量轮廓 / reparent 移动到目标父节点下 / repair 清理引擎残留失效节点。修改节点属性(位置/尺寸/填充/文本等)请用 jsd_update_node。",
|
|
2034
2006
|
inputSchema: manageNodesSchema,
|
|
2035
2007
|
outputSchema: manageNodesResultSchema
|
|
2036
2008
|
}, async (params) => {
|
|
@@ -2056,13 +2028,13 @@ function registerManageTools(server, bridge) {
|
|
|
2056
2028
|
//#region src/tools/modify.ts
|
|
2057
2029
|
/** 修改类:选中属性修改 + 节点查找 */
|
|
2058
2030
|
function registerModifyTools(server, bridge) {
|
|
2059
|
-
server.registerTool("
|
|
2060
|
-
description: "
|
|
2061
|
-
inputSchema:
|
|
2031
|
+
server.registerTool("jsd_update_node", {
|
|
2032
|
+
description: "按 id 修改节点属性(位置/尺寸/填充/文本/效果等)。ids 指定节点、matchName 按名过滤、recursive 递归子节点。props 为要修改的属性对象,字段/枚举以 inputSchema 为准。结构操作(分组/删除/移动等)请用 jsd_manage_nodes。",
|
|
2033
|
+
inputSchema: updateNodeSchema,
|
|
2062
2034
|
outputSchema: updatedResultSchema
|
|
2063
2035
|
}, async ({ ids, matchName, recursive, props }) => {
|
|
2064
2036
|
try {
|
|
2065
|
-
return structured(await bridge.request("
|
|
2037
|
+
return structured(await bridge.request("update_node", {
|
|
2066
2038
|
ids,
|
|
2067
2039
|
matchName,
|
|
2068
2040
|
recursive,
|
|
@@ -2073,7 +2045,7 @@ function registerModifyTools(server, bridge) {
|
|
|
2073
2045
|
}
|
|
2074
2046
|
});
|
|
2075
2047
|
server.registerTool("jsd_find", {
|
|
2076
|
-
description: "
|
|
2048
|
+
description: "在当前页面查找节点,可按 ids 精确查找(优先级最高)/名称模糊匹配/类型过滤,返回序列化节点列表(最多 100 条)",
|
|
2077
2049
|
inputSchema: findSchema,
|
|
2078
2050
|
outputSchema: findResultSchema
|
|
2079
2051
|
}, async (params) => {
|
|
@@ -2086,6 +2058,10 @@ function registerModifyTools(server, bridge) {
|
|
|
2086
2058
|
}
|
|
2087
2059
|
//#endregion
|
|
2088
2060
|
//#region src/tools/raw.ts
|
|
2061
|
+
var fillImageSchema = z.object({
|
|
2062
|
+
ids: z.array(z.string()).describe("要填充图片的节点 id 列表"),
|
|
2063
|
+
sourcePath: z.string().describe("本地图片文件绝对路径,如 /tmp/poster.png")
|
|
2064
|
+
});
|
|
2089
2065
|
/** 原始数据类:导出/填充图片/字体列表 */
|
|
2090
2066
|
function registerRawTools(server, bridge) {
|
|
2091
2067
|
server.registerTool("jsd_export", {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "text-to-design-mcp",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "MCP server bridging AI clients to the jsDesign (即时设计) desktop plugin via a local WebSocket",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -33,13 +33,13 @@
|
|
|
33
33
|
"fuse.js": "^7.5.0",
|
|
34
34
|
"htmlparser2": "^10.0.0",
|
|
35
35
|
"lucide-static": "^1.30.0",
|
|
36
|
-
"text-to-design-shared": "workspace:*",
|
|
37
36
|
"ws": "^8.21.1",
|
|
38
37
|
"zod": "^4.4.3"
|
|
39
38
|
},
|
|
40
39
|
"devDependencies": {
|
|
41
40
|
"@types/node": "^24.13.3",
|
|
42
41
|
"@types/ws": "^8.18.1",
|
|
42
|
+
"text-to-design-shared": "workspace:*",
|
|
43
43
|
"tsx": "^4.20.0",
|
|
44
44
|
"typescript": "^7.0.2",
|
|
45
45
|
"vite": "^8.2.0"
|