评论管理:
  - list_comments    列出评论
  - post_comment     发表/回复评论
  - delete_comment   删除评论
# .
组件库管理:
  - get_file_components       文件内组件
  - get_team_components       团队组件库
  - get_file_component_sets   文件内组件集（变体）
  - get_team_component_sets   团队组件集
  - get_file_styles           文件样式
  - get_team_styles           团队样式库
# .
设计变量（Design Token）:
  - get_local_variables       文件本地变量
  - get_published_variables   发布的跨文件变量
  - 变量类型: COLOR / FLOAT / STRING / BOOLEAN
  - 多模式值: valuesByMode
# .
批量操作:
  - 批量图片导出
  - 批量节点信息获取
  - 设计系统全量检查
  - 开发资产批量获取

# 设计系统检查脚本
class FigmaDesignSystemChecker:
    """Figma设计系统检查器"""
# .
    def __init__(self, file_key, team_id=None):
        self.file_key = file_key
        self.team_id = team_id
        self.report = {
            "file_key": file_key,
            "components": [],
            "component_sets": [],
            "styles": [],
            "variables": [],
            "issues": []
        }
# .
    def run_full_check(self):
        """执行全量检查"""
        self._check_components()
        self._check_component_sets()
        self._check_styles()
        self._check_variables()
        if self.team_id:
            self._check_team_library()
        return self.report
# .
    def _check_components(self):
        """检查文件组件"""
        # mx_figma: get_file_components, file_key: self.file_key
        self.report["components"] = [
            {"id": "C001", "name": "Button", "type": "COMPONENT"},
            {"id": "C002", "name": "Input", "type": "COMPONENT"},
            {"id": "C003", "name": "Card", "type": "COMPONENT"},
        ]
# .
    def _check_component_sets(self):
        """检查组件变体"""
        # mx_figma: get_file_component_sets, file_key: self.file_key
        self.report["component_sets"] = [
            {"name": "Button", "variants": ["Primary", "Secondary", "Ghost"]},
            {"name": "Input", "variants": ["Default", "Error", "Disabled"]},
        ]
# .
    def _check_styles(self):
        """检查文件样式"""
        # mx_figma: get_file_styles, file_key: self.file_key
        self.report["styles"] = [
            {"name": "Primary/Background", "type": "FILL"},
            {"name": "Primary/Text", "type": "TEXT"},
            {"name": "Spacing/Base", "type": "EFFECT"},
        ]
# .
    def _check_variables(self):
        """检查设计变量"""
        # mx_figma: get_local_variables, file_key: self.file_key
        self.report["variables"] = [
            {"name": "color/primary", "type": "COLOR", "value": "#1a1a2e"},
            {"name": "color/accent", "type": "COLOR", "value": "#e94560"},
            {"name": "spacing/base", "type": "FLOAT", "value": 4},
            {"name": "radius/md", "type": "FLOAT", "value": 8},
        ]
# .
    def _check_team_library(self):
        """检查团队组件库"""
        # mx_figma: get_team_components, team_id: self.team_id
        self.report["team_library"] = {
            "total_components": 150,
            "total_styles": 45
        }
# .
# 执行检查
checker = FigmaDesignSystemChecker("abc123DEF456", "123456789")
report = checker.run_full_check()
print(f"组件: {len(report['components'])}个")
print(f"组件集: {len(report['component_sets'])}个")
print(f"样式: {len(report['styles'])}个")
print(f"变量: {len(report['variables'])}个")

# 开发资产获取全流程
1. mx_figma: get_file, file_key: "未指定", depth: 2
   → 获取页面和 Frame 结构
# .
2. mx_figma: get_file_nodes, file_key: "未指定", node_ids: ["target_node"]
   → 获取指定节点详细属性
# .
3. mx_figma: get_file_components, file_key: "未指定"
   → 获取可复用组件列表
# .
4. mx_figma: get_file_component_sets, file_key: "未指定"
   → 获取组件变体（Primary/Secondary 等）
# .
5. mx_figma: get_local_variables, file_key: "未指定"
   → 获取颜色/间距/字体等设计 Token
# .
6. mx_figma: export_images, file_key: "未指定", node_ids: ["icon1","icon2",.], format: "svg"
   → 批量导出图标资源

# 批量导出脚本
class BatchAssetExporter:
    """批量资产导出器"""
# .
    def __init__(self, file_key):
        self.file_key = file_key
        self.exported = []
# .
    def export_all_icons(self, icon_node_ids, format="svg", scale=1):
        """批量导出所有图标"""
        # mx_figma: export_images 支持多节点
        result = {
            "format": format,
            "scale": scale,
            "exports": {}
        }
        for node_id in icon_node_ids:
            result["exports"][node_id] = f"https://files.example.com/{node_id}.{format}"
            self.exported.append({"node_id": node_id, "url": result["exports"][node_id]})
        return result
# .
    def export_design_tokens(self):
        """导出设计变量为 Token 文件"""
        # mx_figma: get_local_variables
        variables = {
            "color": {
                "primary": "#1a1a2e",
                "secondary": "#16213e",
                "accent": "#e94560"
            },
            "spacing": {"base": 4, "scale": [4, 8, 12, 16, 24, 32]},
            "radius": {"sm": 4, "md": 8, "lg": 12},
            "typography": {
                "heading": "Playfair Display",
                "body": "IBM Plex Sans"
            }
        }
        return variables
# .
    def export_component_specs(self):
        """导出组件规格"""
        # mx_figma: get_file_components + get_file_component_sets
        specs = [
            {"name": "Button", "variants": ["Primary", "Secondary", "Ghost"],
             "props": {"size": ["sm", "md", "lg"], "disabled": "boolean"}},
            {"name": "Input", "variants": ["Default", "Error", "Disabled"],
             "props": {"placeholder": "string", "type": ["text", "email", "password"]}},
        ]
        return specs
# .
# 批量导出
exporter = BatchAssetExporter("abc123DEF456")
icons = exporter.export_all_icons(["1:2", "3:4", "5:6", "7:8"], format="svg")
tokens = exporter.export_design_tokens()
components = exporter.export_component_specs()
print(f"已导出 {len(icons['exports'])} 个图标")

# 设计走查工作流
# .
# 1. 查看文件结构
mx_figma:
  action: get_file
  file_key: "未指定"
  depth: 2
# .
# 2. 查看指定页面详情
mx_figma:
  action: get_file_nodes
  file_key: "未指定"
  node_ids: ["page_id"]
# .
# 3. 查看现有评论
mx_figma:
  action: list_comments
  file_key: "未指定"
# .
# 4. 添加走查反馈
mx_figma:
  action: post_comment
  file_key: "未指定"
  message: "这个按钮的圆角需要改为 8px，与设计系统一致"
# .
# 5. 回复设计师的疑问
mx_figma:
  action: post_comment
  file_key: "未指定"
  message: "已确认，圆角统一为 8px，间距基准为 4px"
  comment_id: "12345"
# .
# 6. 删除已解决的评论
mx_figma:
  action: delete_comment
  file_key: "未指定"
  comment_id: "12345"

# 依赖说明
skill-platform plugins install skill-platform-morphixai
# .
# 配置 API Key
export MORPHIXAI_API_KEY="${API_KEY:?请设置环境变量}"
# .
# 链接 Figma 账号
# 访问 morphix.app/connections

# 一键检查设计系统
1. mx_figma: get_file_components, file_key: "未指定"
2. mx_figma: get_file_component_sets, file_key: "未指定"
3. mx_figma: get_file_styles, file_key: "未指定"
4. mx_figma: get_local_variables, file_key: "未指定"
5. mx_figma: get_team_components, team_id: "未指定"

# 批量导出图标
mx_figma:
  action: export_images
  file_key: "未指定"
  node_ids: ["1:2", "3:4", "5:6", "7:8", "9:10"]
  format: "svg"
  scale: 1

变量类型说明:
  COLOR   → 颜色变量 (#RRGGBB)
  FLOAT   → 数值变量 (间距/圆角/字号)
  STRING  → 字符串变量 (字体名称)
  BOOLEAN → 布尔变量 (显示/隐藏)
# .
变量模式:
  valuesByMode → 各模式下的不同值
  例: 颜色变量在 light/dark 模式下有不同值

团队组件库查询:
  get_team_components
    team_id: "123456789"
    page_size: 30   # 分页大小
# .
  get_team_component_sets
    team_id: "123456789"
# .
  get_team_styles
    team_id: "123456789"

专业版检查清单:
[ ] 设计系统全量检查已完成
[ ] 设计变量已提取为 Token 文件
[ ] 组件库已盘点（文件+团队）
[ ] 图标资产已批量导出
[ ] 评论管理流程已建立
[ ] 团队组件库已同步
[ ] 免费版功能正常可用
[ ] 组件变体已验证一致性

{
  "success": true,
  "data": {
    "result": "Figma设计集成-专业版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "figma design pro"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}