text-to-design-mcp 0.8.3 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +13 -4
  2. package/dist/index.js +93 -24
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -136,8 +136,8 @@ pkill -f text-to-design-mcp
136
136
  | `jsd_detach_instance` | 取消实例链接,得到可自由编辑的普通节点 |
137
137
  | `jsd_import_component` | 按 key 从团队库导入组件 |
138
138
  | `jsd_swap_component` | 换绑组件(丢弃目标既有覆盖) |
139
- | `jsd_set_instance_properties` | 设置变体属性(属性名需与 variantGroupProperties 完全匹配) |
140
- | `jsd_combine_as_variants` | 合并为变体集(仅 COMPONENT,实例不能直接合成)。⚠ 本引擎必然失败(平台缺陷),全败时返回可执行出口:改用「族名 / 状态」命名的多个独立主件 |
139
+ | `jsd_set_instance_properties` | 设置实例的变体/组件属性。属性名与可选值先读 `variantProperties`(本节点取值)与 `variantGroupProperties`(组件集上的可选值);**能传哪种值取决于本平台 `setProperties` 签名**:Figma 收 string/boolean/变量别名,MG 收 string/boolean,jsDesign 只收 string(登记在 `shared/src/dicts/platform-value-domain.ts` 的第四类表,由 `sync-guarantee` 双向断言守) |
140
+ | `jsd_combine_as_variants` | 合并为变体集(仅 COMPONENT,实例不能直接合成)。按能力位 `inPlaceVariants` 分流:声明的平台原位合并(首选,直接调);未声明的平台合成路径做不出来,改用「族名 / 状态」命名的多个独立主件 |
141
141
  | `jsd_copy_overrides` | 复制源实例覆盖为快照,返回 snapshotId(缓存) |
142
142
  | `jsd_apply_overrides` | 按 snapshotId 批量套用,可 swapToSource |
143
143
  | `jsd_sync_overrides` | 无状态一次性「复制+套用」,适合 jsd_batch |
@@ -146,17 +146,26 @@ pkill -f text-to-design-mcp
146
146
  | `jsd_export` | 导出节点为 PNG/JPG/SVG/PDF(导出失败的 id 在文本里点名) |
147
147
  | `jsd_list_fonts` | 列出可用字体:families 与各族的可用字型 `fonts:[{family,styles}]`(写 fontName 前照这份取组合,family+style 需精确匹配,猜错会静默退回默认字重) |
148
148
  | `jsd_fill_image` | 用本地图片填充节点 |
149
- | `jsd_platform_op` | 平台特有能力的通用通道(Figma 变量/本地样式/组件属性**定义与设值**)。先读 `jsd_ping` 的 `platformOps` 名单再传 op 名;插件平台不适用(如即时设计)时由 daemon 直接拦截并给出替代路径,不发插件往返 |
149
+ | `jsd_platform_op` | 平台特有能力的通用通道(Figma 变量/本地样式/组件属性**定义与设值**;MasterGo 组件属性管理与**集合级变体管理**——建维度/加成分/改取值/删维度)。先读 `jsd_ping` 的 `platformOps` 名单再传 op 名;插件平台不适用(如即时设计)时由 daemon 直接拦截并给出替代路径,不发插件往返 |
150
150
 
151
151
  ### 配方 prompt(`prompts/list`)
152
152
 
153
153
  带参数的操作引导词,让 AI 少猜流程细节;策略类以 assistant 身份下发,配方式以 user 身份下发。
154
154
 
155
+ **平台感知**:配方在**调用期**读当前平台(daemon 缓存的 ping 结果),只讲当前平台那一支 ——
156
+ Figma 用户不会再读到 jsDesign 的兜底细节;平台未探测时给「先 jsd_ping 读能力位」的保守说法。
157
+ 平台事实与句子**不写在配方里**:数据在 `shared/src/dicts/platform-knowledge.ts`(三平台 ×
158
+ 变量/组件/变体,含读路径、写入口、替代路径、证据行号),句子在 `mcp-server/src/tools/platform-facts.ts`
159
+ (工具描述走同一份句子)。改动理由与守卫见 `docs/design-decisions/0032-*.md`。
160
+
155
161
  | prompt | 用途 |
156
162
  | --- | --- |
157
163
  | `design-strategy` | 设计策略总纲:命名/层级/间距字号阶梯/出错回滚,附登录页示例结构树 |
158
164
  | `text-replace-strategy` | 大改文案:jsd_clone_node 留底 → 语义分块 → jsd_set_text 批量替换 → 逐块导小图复核 |
159
165
  | `variant-sync` | 把一个实例的样式/文案批量套用到多个同类实例(优先 jsd_sync_overrides / copy+apply,手工 jsd_set_* 兜底) |
166
+ | `variable-binding` | 变量绑定与批量套用:按本平台变量面分流(读写都通 / typings 有 API 但未接 / 接不了),含批量绑定与回读复核 |
167
+ | `variant-set` | 变体集构建:按能力位 `inPlaceVariants` 分流(原位合并 / 多主件兜底);有集合级管理 op 的平台(见 `platformOps`)直接建维度、加成分、改取值,不靠改名字,含建后回读 |
168
+ | `component-property` | 组件属性的定义与设值:定义走 platform op、设值走 jsd_set_instance_properties,并给出本平台能收的值形态 |
160
169
  | `html-to-design` | HTML 转设计稿,含保真度取舍说明 |
161
170
  | `icon-grid` | 批量插入 Lucide 图标并排成自动布局网格 |
162
171
  | `script-ops` | 脚本化调用纪律:压缩工具往返与上下文占用 |
@@ -197,7 +206,7 @@ pkill -f text-to-design-mcp
197
206
  - 看日志:`tail -f /tmp/text-to-design-mcp.log`(请求/响应耗时、HTTP 状态码、插件连接、二进制组装都会记)
198
207
  - 要更细的连接日志,启动时设 `TEXT_TO_DESIGN_MCP_LOG_LEVEL=debug`(默认 info);该开关只减落盘量,面板推送不受限制
199
208
  - 插件面板自带连接状态和日志:服务端日志实时推送,档位默认隐藏 debug,切「全部」可见帧级明细;插件离线期间的日志会先缓冲,上线后按顺序回放
200
- - 面板还有可折叠的「能力」区块:核心能力(两平台一致)、当前平台可用的差异能力、平台特有 op 名单 —— 数据与 MCP 侧 `capabilities` / `platformOps` 同源
209
+ - 面板还有可折叠的「能力」区块:核心能力、当前平台可用的差异能力、平台特有 op 名单 —— 数据与 MCP 侧 `capabilities` / `platformOps` 同源
201
210
 
202
211
  ### 构建与开发
203
212