🆕 新功能:figma_prepare_file 工具
功能说明
figma_prepare_file 是一个智能文件准备工具,用于在获取 Figma 数据之前确保文件已准备好。
主要特性:
- ✅ 自动缓存检查:检查文件是否已缓存且有效
- ✅ nodeId 验证:如果提供了 nodeId,会验证该节点是否存在于缓存中
- ✅ 智能刷新:如果缓存过期或 nodeId 不存在,自动重新拉取文件
- ✅ 缓存未启用提示:即使缓存未启用,也会提供明确的提示信息
使用方式
当用户提供 Figma URL 时,LLM 会自动:
- 首先调用
figma_prepare_file准备文件 - 然后调用
get_figma_data获取数据
示例流程:
用户提供 URL → figma_prepare_file (准备文件) → get_figma_data (获取数据)
工具参数
figmaUrl(必填): Figma 设计文件 URL- 支持格式:
https://www.figma.com/design/<fileKey>/...?node-id=<nodeId> - 自动解析 fileKey 和 nodeId
- 支持格式:
返回值说明
- 缓存已存在且有效:返回提示信息,不拉取数据
- 缓存不存在或过期:自动拉取并缓存文件
- nodeId 不存在:重新拉取文件并验证 nodeId
- 缓存未启用:返回警告信息,提示需要配置缓存