text-to-design-mcp 0.6.0 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +41 -10
- package/dist/index.js +45 -3592
- package/package.json +12 -12
package/README.md
CHANGED
|
@@ -98,23 +98,55 @@ pkill -f text-to-design-mcp
|
|
|
98
98
|
|
|
99
99
|
### 完整工具清单
|
|
100
100
|
|
|
101
|
+
**一个操作对应一个工具**,没有 op 分发;两个聚合入口(`jsd_manage_nodes` / `jsd_manage_components`)仅用于批量或一次改多组字段。所有写工具都支持 `ids`(缺省作用于当前选中);属性类工具(及 `jsd_set_*`)的 `recursive` 只作用于**后代**,不含目标节点自身(给一组图标容器刷色时容器不会被套上方框),要连容器自身一起改才传 `includeSelf=true`。
|
|
102
|
+
|
|
101
103
|
| 工具 | 用途 |
|
|
102
104
|
| --- | --- |
|
|
103
|
-
| `jsd_ping` |
|
|
105
|
+
| `jsd_ping` | 检查插件是否在线,并返回平台 capabilities |
|
|
104
106
|
| `jsd_get_selection` | 读取画布当前选中的节点 |
|
|
107
|
+
| `jsd_find` | 按名称/类型/id 查找节点 |
|
|
105
108
|
| `jsd_create_nodes` | 按描述创建节点(frame/rect/text 等,支持阴影/描边/渐变/文本样式) |
|
|
106
109
|
| `jsd_create_svg` | 直接导入 SVG 字符串(保留 path/矢量数据,不经降级) |
|
|
107
110
|
| `jsd_create_icon` | 按名称/别名模糊匹配插入 Lucide 内置图标,查无时返回候选名 |
|
|
108
111
|
| `jsd_html_to_design` | 把 HTML 转成设计节点 |
|
|
109
|
-
| `
|
|
110
|
-
| `
|
|
111
|
-
| `
|
|
112
|
-
| `
|
|
113
|
-
| `
|
|
112
|
+
| `jsd_set_fill_color` | 填充(fills 整体替换)、混合模式、填充样式 |
|
|
113
|
+
| `jsd_set_stroke` | 描边列表/宽度(可四边分开)/对齐/端点/连接/虚线/描边样式 |
|
|
114
|
+
| `jsd_set_cornerRadius` | 圆角半径(四角可分开)与圆角平滑度 |
|
|
115
|
+
| `jsd_set_text` | 文本内容与排版(characters/fontSize/fontName/对齐/行高/字距/截断) |
|
|
116
|
+
| `jsd_move_node` | 位置 x/y 与旋转 |
|
|
117
|
+
| `jsd_resize_node` | 尺寸 width/height,可同时传 x/y 一步改尺寸并定位 |
|
|
118
|
+
| `jsd_set_layout` | FRAME auto-layout(layoutMode/间距/内边距/对齐/伸缩/约束) |
|
|
119
|
+
| `jsd_set_effects` | 阴影/模糊、溢出裁剪、布局网格、椭圆环形参数 |
|
|
120
|
+
| `jsd_set_visibility` | 不透明度、显示开关、锁定 |
|
|
121
|
+
| `jsd_rename_node` | 重命名 |
|
|
122
|
+
| `jsd_update_node` | 聚合:一次改多组字段,或改 pointCount/innerRadius 等长尾字段 |
|
|
123
|
+
| `jsd_select_nodes` | 设置画布当前选中 |
|
|
124
|
+
| `jsd_delete_node` | 删除节点(matchName 可再过滤;ids 缺省删当前选中) |
|
|
125
|
+
| `jsd_clone_node` | 复制节点(克隆 COMPONENT 得到 INSTANCE) |
|
|
126
|
+
| `jsd_group_nodes` | 编组(至少 2 个),可同时设置 auto-layout |
|
|
127
|
+
| `jsd_ungroup_nodes` | 解组 |
|
|
128
|
+
| `jsd_flatten_nodes` | 至少 2 个节点合并为单一矢量 |
|
|
129
|
+
| `jsd_outline_stroke` | 描边转轮廓矢量(几何被烘焙) |
|
|
130
|
+
| `jsd_reparent_nodes` | 移入父节点成为其子节点(parentId 建议显式传;跨父级移动保持绝对位置,内部自动换算,移入 auto-layout 容器时位置由布局接管) |
|
|
131
|
+
| `jsd_repair_nodes` | 清理引擎残留的损坏/失效节点 |
|
|
132
|
+
| `jsd_manage_nodes` | 聚合入口,op 含 select/remove/clone/group/ungroup/flatten/outline_stroke/reparent/repair;各 op 返回键不同(select→`selected` / remove→`removed` / ungroup→`ungrouped` / repair→`cleaned` 为 id 字符串数组;clone/group/flatten/outline_stroke→`created`;reparent→`moved`,同时附同义的 `updated`) |
|
|
133
|
+
| `jsd_create_component` | 建「空壳」组件:先 resize 再 reparent 归入子节点,最后删除原容器 |
|
|
134
|
+
| `jsd_create_instance` | 按 COMPONENT 生成实例 |
|
|
135
|
+
| `jsd_detach_instance` | 取消实例链接,得到可自由编辑的普通节点 |
|
|
136
|
+
| `jsd_import_component` | 按 key 从团队库导入组件 |
|
|
137
|
+
| `jsd_swap_component` | 换绑组件(丢弃目标既有覆盖) |
|
|
138
|
+
| `jsd_set_instance_properties` | 设置变体属性(属性名需与 variantGroupProperties 完全匹配) |
|
|
139
|
+
| `jsd_combine_as_variants` | 合并为变体集(仅 COMPONENT,实例不能直接合成)。⚠ 本引擎必然失败(平台缺陷),全败时返回可执行出口:改用「族名 / 状态」命名的多个独立主件 |
|
|
140
|
+
| `jsd_copy_overrides` | 复制源实例覆盖为快照,返回 snapshotId(缓存) |
|
|
141
|
+
| `jsd_apply_overrides` | 按 snapshotId 批量套用,可 swapToSource |
|
|
142
|
+
| `jsd_sync_overrides` | 无状态一次性「复制+套用」,适合 jsd_batch |
|
|
143
|
+
| `jsd_manage_components` | 聚合入口,op 含 create_component/create_instance/detach_instance/import_component/swap_component/set_instance_properties/combine_as_variants/copy_overrides/apply_overrides/sync_overrides |
|
|
144
|
+
| `jsd_batch` | 批量编排器:一次请求顺序执行多个 jsd_* 步骤,双花括号占位符串起中间值;步骤回显做摘要裁剪(节点只留 id/name/type/x/y,丢 vectorPaths 等大字段,超预算降级为 id 清单),占位符解析用完整数据;含图标的批次另配一次 `jsd_export` 目视验收;含删除/移父的批次自动复核同层几何漂移(结果 `warnings`,`checkDrift:false` 可关) |
|
|
114
145
|
| `jsd_export` | 导出节点为 PNG/JPG/SVG/PDF(导出失败的 id 在文本里点名) |
|
|
115
146
|
| `jsd_list_fonts` | 列出可用字体 |
|
|
147
|
+
| `jsd_list_styles` | 列出本地样式(PAINT/TEXT/EFFECT/GRID) |
|
|
116
148
|
| `jsd_fill_image` | 用本地图片填充节点 |
|
|
117
|
-
| `jsd_platform_op` | 平台特有能力通用通道(Figma
|
|
149
|
+
| `jsd_platform_op` | 平台特有能力通用通道(Figma 变量等),先看 jsd_ping 的 capabilities |
|
|
118
150
|
|
|
119
151
|
### 配方 prompt(`prompts/list`)
|
|
120
152
|
|
|
@@ -123,9 +155,8 @@ pkill -f text-to-design-mcp
|
|
|
123
155
|
| prompt | 用途 |
|
|
124
156
|
| --- | --- |
|
|
125
157
|
| `design-strategy` | 设计策略总纲:命名/层级/间距字号阶梯/出错回滚,附登录页示例结构树 |
|
|
126
|
-
| `
|
|
127
|
-
| `
|
|
128
|
-
| `variant-sync` | 把一个实例的样式/文案批量套用到多个同类实例(优先 sync_overrides / copy+apply,手工 jsd_update_node 兜底) |
|
|
158
|
+
| `text-replace-strategy` | 大改文案:jsd_clone_node 留底 → 语义分块 → jsd_set_text 批量替换 → 逐块导小图复核 |
|
|
159
|
+
| `variant-sync` | 把一个实例的样式/文案批量套用到多个同类实例(优先 jsd_sync_overrides / copy+apply,手工 jsd_set_* 兜底) |
|
|
129
160
|
| `html-to-design` | HTML 转设计稿,含保真度取舍说明 |
|
|
130
161
|
| `icon-grid` | 批量插入 Lucide 图标并排成自动布局网格 |
|
|
131
162
|
| `script-ops` | 脚本化调用纪律:压缩工具往返与上下文占用 |
|