名称： figma
描述： 专业的 Figma 设计分析与资源导出工具。用于提取设计数据、以多种格式导出资源、审计无障碍合规性、分析设计系统，并生成全面的设计文档。提供对 Figma 文件的只读分析，具备强大的导出和报告能力。

Figma 设计分析与导出

专业的 Figma 集成工具，用于设计系统分析、资源导出和全面的设计审计。

核心能力

1. 文件操作与分析

• 文件检查：获取任何 Figma 文件的完整 JSON 表示
• 组件提取：列出所有组件、样式和设计令牌
• 资源导出：批量导出画框、组件或特定节点为 PNG/SVG/PDF
• 版本管理：访问特定文件版本和分支信息

使用示例：
- “从此设计系统文件中导出所有组件”
- “获取这些特定画框的 JSON 数据”
- “显示此文件中使用的所有颜色和字体”

2. 设计系统管理

• 样式审计：分析颜色使用、字体一致性、间距模式
• 组件分析：识别未使用的组件，测量使用模式
• 品牌合规性：检查跨文件对品牌指南的遵循情况
• 设计令牌提取：从 Figma 样式生成 CSS/JSON 设计令牌

使用示例：
- “审计此设计系统的无障碍问题”
- “从这些 Figma 样式生成 CSS 自定义属性”
- “找出我们组件库中的所有不一致之处”

3. 批量资源导出

• 多格式导出：将资源导出为 PNG、SVG、PDF 或 WEBP
• 平台特定尺寸：为 iOS/Android 生成 @1x、@2x、@3x 资源
• 有序输出：按格式或平台自动组织文件夹
• 客户交付包：包含文档的完整可交付成果包

使用示例：
- “以 PNG 和 SVG 格式导出所有组件”
- “为移动应用开发生成完整的资源包”
- “创建包含所有营销资源的客户交付成果”

4. 无障碍与质量分析

• 对比度检查：验证是否符合 WCAG 颜色对比度要求
• 字体大小分析：确保可读的字体比例
• 交互元素尺寸检查：检查触摸目标要求
• 焦点状态验证：验证键盘导航模式

使用示例：
- “检查此设计是否符合 WCAG AA 标准”
- “分析移动可用性的触摸目标”
- “为此应用设计生成无障碍报告”

快速开始

身份验证设置

# 设置你的 Figma 访问令牌
export FIGMA_ACCESS_TOKEN="你的令牌"

# 或存储在 .env 文件中
echo "FIGMA_ACCESS_TOKEN=你的令牌" >> .env

基本操作

# 获取文件信息和结构
python scripts/figma_client.py get-file "你的文件密钥"

# 将画框导出为图像
python scripts/export_manager.py export-frames "文件密钥" --formats png,svg

# 分析设计系统一致性
python scripts/style_auditor.py audit-file "文件密钥" --generate-html

# 检查无障碍合规性
python scripts/accessibility_checker.py "文件密钥" --level AA --format html

工作流模式

设计系统审计工作流

1. 提取文件数据 → 获取组件、样式和结构
2. 分析一致性 → 检查样式变化和未使用元素
3. 生成报告 → 创建详细的发现和建议
4. 手动实施 → 使用发现指导设计改进

资源导出工作流

1. 识别导出目标 → 指定画框、组件或节点
2. 配置导出设置 → 设置格式、尺寸和命名约定
3. 批量处理 → 同时导出多个资源
4. 组织输出 → 为交接或实施构建文件结构

分析与文档工作流

1. 提取设计数据 → 拉取组件、样式和设计令牌
2. 审计合规性 → 检查无障碍性和品牌一致性
3. 生成文档 → 创建样式指南和组件规范
4. 导出可交付成果 → 为开发或客户交接打包资源

资源

scripts/

• figma_client.py - 包含所有 REST 端点的完整 Figma API 封装器
• export_manager.py - 支持多种格式和比例的专业资源导出工具
• style_auditor.py - 设计系统分析和品牌一致性检查工具
• accessibility_checker.py - 全面的 WCAG 合规性验证和报告工具

references/

• figma-api-reference.md - 完整的 API 文档和示例
• design-patterns.md - UI 模式和组件最佳实践
• accessibility-guidelines.md - WCAG 合规性要求
• export-formats.md - 资源导出选项和规范

assets/

• templates/design-system/ - 预构建的组件库模板
• templates/brand-kits/ - 标准品牌指南结构
• templates/wireframes/ - 常见布局模式和流程

集成示例

与开发工作流集成

# 为 CSS 生成设计令牌
python scripts/export_manager.py export-tokens "文件密钥" --format css

# 创建组件文档
python scripts/figma_client.py document-components "文件密钥" --output docs/

与品牌管理集成

# 审计设计中的品牌合规性
python scripts/style_auditor.py audit-file "文件密钥" --brand-colors "#FF0000,#00FF00,#0000FF"

# 提取当前品牌颜色进行分析
python scripts/figma_client.py extract-colors "文件密钥" --output brand-colors.json

与客户交付成果集成

# 生成客户演示资源
python scripts/export_manager.py client-package "文件密钥" --template presentation

# 创建开发交接资源
python scripts/export_manager.py dev-handoff "文件密钥" --include-specs

限制与范围

只读操作

此工具通过 REST API 提供对 Figma 文件的只读访问。它可以：
- ✅ 提取数据、组件和样式
- ✅ 以多种格式导出资源
- ✅ 分析和审计设计文件
- ✅ 生成全面的报告

无法执行的操作

• ❌ 修改现有文件（颜色、文本、组件）
• ❌ 创建新设计或组件
• ❌ 批量更新多个文件
• ❌ 实时协作功能

如需修改文件，你需要使用 Plugin API 开发Figma 插件。

技术特性

API 速率限制

内置速率限制和重试逻辑，以优雅地处理 Figma 的 API 限制。

错误处理

全面的错误处理，包含详细的日志记录和恢复建议。

多格式支持

以 PNG、SVG、PDF 和 WEBP 格式导出资源，并支持平台特定尺寸。