figma

Figma 集成（暂不可用）

此功能正在开发中，暂不可用。 请勿调用 mx_figma 工具。Figma 集成将在未来版本中启用。

通过 mx_figma 工具访问 Figma 工作区：浏览项目文件、读取设计结构、导出图片、管理评论、查看组件库/组件集/样式、获取设计变量（Design Token）。

前置条件

1. 安装插件: openclaw plugins install openclaw-morphixai
2. 获取 API Key: 访问 morphix.app/api-keys 生成 mk_xxxxxx 密钥
3. 配置环境变量: export MORPHIXAI_API_KEY="mk_your_key_here"
4. 链接账号: 访问 morphix.app/connections 链接 Figma 账号，或通过 mx_link 工具链接（app: figma）

核心操作

查看当前用户

mx_figma:
  action: get_me

浏览团队项目

mx_figma:
  action: list_team_projects
  team_id: "123456789"

列出项目中的文件

mx_figma:
  action: list_project_files
  project_id: "987654321"

获取文件结构

mx_figma:
  action: get_file
  file_key: "abc123DEF456"
  depth: 2  # 1=仅页面, 2=页面+Frame, 省略=完整树

file_key 从 Figma URL 中提取：figma.com/design/{file_key}/...

获取指定节点

mx_figma:
  action: get_file_nodes
  file_key: "abc123DEF456"
  node_ids: ["1:2", "3:4"]
  depth: 1

导出图片

mx_figma:
  action: export_images
  file_key: "abc123DEF456"
  node_ids: ["1:2"]
  format: "png"   # jpg / png / svg / pdf
  scale: 2        # 0.01–4, 默认 1

返回 node_id → 图片 URL 的映射。

评论操作

列出评论：

mx_figma:
  action: list_comments
  file_key: "abc123DEF456"

发表评论：

mx_figma:
  action: post_comment
  file_key: "abc123DEF456"
  message: "这个按钮的圆角需要改为 8px"

回复评论：

mx_figma:
  action: post_comment
  file_key: "abc123DEF456"
  message: "已修改，请确认"
  comment_id: "12345"

删除评论：

mx_figma:
  action: delete_comment
  file_key: "abc123DEF456"
  comment_id: "12345"

版本历史

mx_figma:
  action: list_versions
  file_key: "abc123DEF456"

组件

文件内组件：

mx_figma:
  action: get_file_components
  file_key: "abc123DEF456"

团队组件库：

mx_figma:
  action: get_team_components
  team_id: "123456789"
  page_size: 30

组件集（变体）

组件集是包含多个变体的容器，例如 Button 组件集包含 Primary、Secondary 等变体。