text-to-design-mcp 0.8.3 → 0.10.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 +16 -5
- package/dist/index.js +170 -29
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -105,9 +105,10 @@ pkill -f text-to-design-mcp
|
|
|
105
105
|
| --- | --- |
|
|
106
106
|
| `jsd_ping` | 检查插件是否在线,返回三张能力表(核心能力 / 平台差异能力 / 平台特有 op 名单);回包被 daemon 缓存,后续可读 `jsd://platform/state` |
|
|
107
107
|
| `jsd_get_selection` | 读取画布当前选中的节点 |
|
|
108
|
+
| `jsd_get_page` | 读取当前页结构(顶层节点轻量摘要 + 文档级页面总览;等价 `jsd://page` 资源) |
|
|
108
109
|
| `jsd_find` | 按名称/类型/id 查找节点 |
|
|
109
110
|
| `jsd_create_nodes` | 按描述创建节点(frame/rect/text 等,支持阴影/描边/渐变/文本样式) |
|
|
110
|
-
| `jsd_create_svg` | 直接导入 SVG
|
|
111
|
+
| `jsd_create_svg` | 直接导入 SVG(保留 path/矢量数据,不经降级)。来源二选一:`svg` 内联字符串,或 `svgPath` 本地文件路径(**图表一律走这条**:脚本按 `chart-by-code` 配方算好、落盘,再传路径) |
|
|
111
112
|
| `jsd_create_icon` | 按名称/别名模糊匹配插入 Lucide 内置图标,查无时返回候选名 |
|
|
112
113
|
| `jsd_html_to_design` | 把 HTML 转成设计节点 |
|
|
113
114
|
| `jsd_set_fill_color` | 填充(fills 整体替换)、混合模式、填充样式 |
|
|
@@ -136,8 +137,8 @@ pkill -f text-to-design-mcp
|
|
|
136
137
|
| `jsd_detach_instance` | 取消实例链接,得到可自由编辑的普通节点 |
|
|
137
138
|
| `jsd_import_component` | 按 key 从团队库导入组件 |
|
|
138
139
|
| `jsd_swap_component` | 换绑组件(丢弃目标既有覆盖) |
|
|
139
|
-
| `jsd_set_instance_properties` |
|
|
140
|
-
| `jsd_combine_as_variants` | 合并为变体集(仅 COMPONENT,实例不能直接合成)
|
|
140
|
+
| `jsd_set_instance_properties` | 设置实例的变体/组件属性。属性名与可选值先读 `variantProperties`(本节点取值)与 `variantGroupProperties`(组件集上的可选值);**能传哪种值取决于本平台 `setProperties` 签名**:Figma 收 string/boolean/变量别名,MG 收 string/boolean,jsDesign 只收 string(登记在 `shared/src/dicts/platform-value-domain.ts` 的第四类表,由 `sync-guarantee` 双向断言守) |
|
|
141
|
+
| `jsd_combine_as_variants` | 合并为变体集(仅 COMPONENT,实例不能直接合成)。按能力位 `inPlaceVariants` 分流:声明的平台原位合并(首选,直接调);未声明的平台合成路径做不出来,改用「族名 / 状态」命名的多个独立主件 |
|
|
141
142
|
| `jsd_copy_overrides` | 复制源实例覆盖为快照,返回 snapshotId(缓存) |
|
|
142
143
|
| `jsd_apply_overrides` | 按 snapshotId 批量套用,可 swapToSource |
|
|
143
144
|
| `jsd_sync_overrides` | 无状态一次性「复制+套用」,适合 jsd_batch |
|
|
@@ -146,18 +147,28 @@ pkill -f text-to-design-mcp
|
|
|
146
147
|
| `jsd_export` | 导出节点为 PNG/JPG/SVG/PDF(导出失败的 id 在文本里点名) |
|
|
147
148
|
| `jsd_list_fonts` | 列出可用字体:families 与各族的可用字型 `fonts:[{family,styles}]`(写 fontName 前照这份取组合,family+style 需精确匹配,猜错会静默退回默认字重) |
|
|
148
149
|
| `jsd_fill_image` | 用本地图片填充节点 |
|
|
149
|
-
| `jsd_platform_op` | 平台特有能力的通用通道(Figma
|
|
150
|
+
| `jsd_platform_op` | 平台特有能力的通用通道(Figma 变量/本地样式/组件属性**定义与设值**;MasterGo 组件属性管理与**集合级变体管理**——建维度/加成分/改取值/删维度)。先读 `jsd_ping` 的 `platformOps` 名单再传 op 名;插件平台不适用(如即时设计)时由 daemon 直接拦截并给出替代路径,不发插件往返 |
|
|
150
151
|
|
|
151
152
|
### 配方 prompt(`prompts/list`)
|
|
152
153
|
|
|
153
154
|
带参数的操作引导词,让 AI 少猜流程细节;策略类以 assistant 身份下发,配方式以 user 身份下发。
|
|
154
155
|
|
|
156
|
+
**平台感知**:配方在**调用期**读当前平台(daemon 缓存的 ping 结果),只讲当前平台那一支 ——
|
|
157
|
+
Figma 用户不会再读到 jsDesign 的兜底细节;平台未探测时给「先 jsd_ping 读能力位」的保守说法。
|
|
158
|
+
平台事实与句子**不写在配方里**:数据在 `shared/src/dicts/platform-knowledge.ts`(三平台 ×
|
|
159
|
+
变量/组件/变体,含读路径、写入口、替代路径、证据行号),句子在 `mcp-server/src/tools/platform-facts.ts`
|
|
160
|
+
(工具描述走同一份句子)。改动理由与守卫见 `docs/design-decisions/0032-*.md`。
|
|
161
|
+
|
|
155
162
|
| prompt | 用途 |
|
|
156
163
|
| --- | --- |
|
|
157
164
|
| `design-strategy` | 设计策略总纲:命名/层级/间距字号阶梯/出错回滚,附登录页示例结构树 |
|
|
158
165
|
| `text-replace-strategy` | 大改文案:jsd_clone_node 留底 → 语义分块 → jsd_set_text 批量替换 → 逐块导小图复核 |
|
|
159
166
|
| `variant-sync` | 把一个实例的样式/文案批量套用到多个同类实例(优先 jsd_sync_overrides / copy+apply,手工 jsd_set_* 兜底) |
|
|
167
|
+
| `variable-binding` | 变量绑定与批量套用:按本平台变量面分流(读写都通 / typings 有 API 但未接 / 接不了),含批量绑定与回读复核 |
|
|
168
|
+
| `variant-set` | 变体集构建:按能力位 `inPlaceVariants` 分流(原位合并 / 多主件兜底);有集合级管理 op 的平台(见 `platformOps`)直接建维度、加成分、改取值,不靠改名字,含建后回读 |
|
|
169
|
+
| `component-property` | 组件属性的定义与设值:定义走 platform op、设值走 jsd_set_instance_properties,并给出本平台能收的值形态 |
|
|
160
170
|
| `html-to-design` | HTML 转设计稿,含保真度取舍说明 |
|
|
171
|
+
| `chart-by-code` | **画图的主路径**:自己写代码算几何 → 落盘 SVG → `jsd_create_svg(svgPath)` 导入,含零依赖可跑示例与引擎侧硬约束(不用 `A` 指令、**不指定图形库**、配色与字号取自画布既有变量/本地样式) |
|
|
161
172
|
| `icon-grid` | 批量插入 Lucide 图标并排成自动布局网格 |
|
|
162
173
|
| `script-ops` | 脚本化调用纪律:压缩工具往返与上下文占用 |
|
|
163
174
|
|
|
@@ -197,7 +208,7 @@ pkill -f text-to-design-mcp
|
|
|
197
208
|
- 看日志:`tail -f /tmp/text-to-design-mcp.log`(请求/响应耗时、HTTP 状态码、插件连接、二进制组装都会记)
|
|
198
209
|
- 要更细的连接日志,启动时设 `TEXT_TO_DESIGN_MCP_LOG_LEVEL=debug`(默认 info);该开关只减落盘量,面板推送不受限制
|
|
199
210
|
- 插件面板自带连接状态和日志:服务端日志实时推送,档位默认隐藏 debug,切「全部」可见帧级明细;插件离线期间的日志会先缓冲,上线后按顺序回放
|
|
200
|
-
-
|
|
211
|
+
- 面板还有可折叠的「能力」区块:核心能力、当前平台可用的差异能力、平台特有 op 名单 —— 数据与 MCP 侧 `capabilities` / `platformOps` 同源
|
|
201
212
|
|
|
202
213
|
### 构建与开发
|
|
203
214
|
|