SuperAPI AI 工具集

js-design-mcp

设计与创作

查看项目

更新于 10-16 06:24

技能介绍

用途:通过 jishi-design MCP 服务器读取、导出和修改即时设计画布,适用于涉及即时设计画布或 jsDesign PluginAPI 的任务。

主要能力:list_plugin_clients 列出已连接的即时设计文档;get_page_nodes 列出当前页面顶层节点;get_selection 读取选中节点;get_node_children 读取单个节点子树;save_image 导出单个节点;download_icons 批量导出 SVG;execute_script 执行自定义查询、批量编辑或画布创建。所有工具支持可选 clientId 和 timeoutMs。

使用方式:先调用 list_plugin_clients,若无客户端连接,请用户打开九匠即时MCP插件并确认已连接;多个客户端时按 info.docName 选择并传入 clientId,否则默认第一个在线客户端。标准流程为用 get_page_nodes 发现顶层框架,再用 get_node_children(优先传 id)或 get_selection 深入,最后导出或修改。不要先拉取整棵大树,先用较浅 maxDepth 探测再深入。

读取完整性:get_selection 和 get_node_children 返回 { nodes, summary },需检查 summary.truncated;若被截断,应增大 maxDepth/maxNodes、按子节点 id 分别读取或缩小任务范围,不能把截断数据当作完整设计。

导出规则:PNG/JPG 默认 scale 2 或更高;优先使用绝对路径 savePath;多 SVG 图标用 download_icons,其返回 success 与 failed 数组;可见布局、样式、文本、资源或导出相关改动后,应导出受影响节点并检查图像再声称视觉正确。

修改规则:读取和导出用专用工具,execute_script 仅在专用工具无法完成时使用;修改前说明将改动什么;脚本保持小步,发现、结构、内容、资源、样式和验证通常分开调用。新建可见画布时默认使用自动布局和响应式调整,避免大量绝对 x/y 定位。

限制与注意事项:使用 execute_script 前需阅读 references/execute-script.md;按操作类型阅读对应 gotchas 文件(节点操作、自动布局尺寸、响应式审计、外部资源、样式、导出资源)。官方参考从 references/docs-overview.md 开始,概念与示例用 Markdown 文档,精确字段与重载用 typings。资料未提供收费、价格、平台支持范围等信息。