Skip to content

v1.1.0

Latest

Choose a tag to compare

@Pactortester Pactortester released this 19 Jan 05:39

🆕 新功能:figma_prepare_file 工具

功能说明

figma_prepare_file 是一个智能文件准备工具,用于在获取 Figma 数据之前确保文件已准备好。

主要特性:

  • 自动缓存检查:检查文件是否已缓存且有效
  • nodeId 验证:如果提供了 nodeId,会验证该节点是否存在于缓存中
  • 智能刷新:如果缓存过期或 nodeId 不存在,自动重新拉取文件
  • 缓存未启用提示:即使缓存未启用,也会提供明确的提示信息

使用方式

当用户提供 Figma URL 时,LLM 会自动:

  1. 首先调用 figma_prepare_file 准备文件
  2. 然后调用 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
  • 缓存未启用:返回警告信息,提示需要配置缓存