> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Figma

> 通过你已连接的帐户进行协作式界面设计和检查。

# Figma

当你的工作流程需要 Figma 文件数据、节点详情、评论或库资源时，请使用此应用。在找到合适的文件或节点后，你可以添加评论或开发资源。

## 配置

| 选项 | 必填 | 描述 |
| - | - | - |
| 名称 | 否 | 工作流画布中此步骤的标签。 |
| Authentication | 是 | 此步骤要使用的已连接 Figma 帐户。 |
| Action | 是 | 要执行的 Figma 操作（例如 Get current user、Get file metadata、Get file json、Get file nodes）。 |
| Arguments | 是 | 由该操作的架构生成的逐操作表单字段。每个文本字段都有一个 **Insert Variable** 按钮，用于注入 `{{placeholder}}` 值。高级用法可使用 **Raw JSON** 选项卡。 |
| When the step fails | 否 | 控制此步骤失败时工作流应 **Terminate Workflow** 还是 **Continue**。 |

在配置此步骤之前，请通过登录流程在工作区的 **Integrations** 中连接 Figma。如果没有可用的活动连接，步骤会显示一个警告，并提供指向 **Integrations** 的链接，而不是帐户选择器。

## Arguments form

当你选择某个操作时，**Arguments** 部分会显示一个由该操作输入架构驱动的表单。引用现有记录的字段包含下拉选择器。

如果你更愿意手动编写完整的参数对象，请切换到 **Raw JSON** 选项卡。任一选项卡中的更改都会保持同步。

## Common actions

| 操作 | 描述 |
| - | - |
| **Get current user** | 获取已连接的 Figma 用户详情。 |
| **Get file metadata** | 获取 Figma 文件的元数据。 |
| **Get file json** | 获取 Figma 文件的简化设计数据。 |
| **Get file nodes** | 获取 Figma 文件中特定节点的 JSON。 |
| **Render node images** | 将选中的 Figma 节点渲染为图像。 |
| **Download images** | 从 Figma 文件中的节点下载图像。 |
| **Get comments** | 列出 Figma 文件中的评论。 |
| **Add comment** | 向 Figma 文件发布新评论。 |
| **Get dev resources** | 列出附加到 Figma 文件的开发资源。 |
| **Get team components** | 列出团队库中发布的组件。 |
| **Get file components** | 列出主 Figma 文件中发布的组件。 |
| **Get file styles** | 列出主 Figma 文件中发布的样式。 |
| **Get local variables** | 列出 Figma 文件中可用的变量。 |

删除记录等破坏性操作不在工作流操作选择器中提供。

## Output

此步骤会将 Figma 响应存储为步骤输出。响应的结构取决于所选操作。

在后续步骤中使用完整的输出引用：

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. 打开 **Integrations**，如果你还没有这样做，请先连接 Figma。
2. 在工作流中添加一个 **Figma** 步骤。
3. 在 **Authentication** 中选择一个已连接帐户。
4. 在 **Action** 中选择 **Get current user**。
5. 填写必填字段。使用 **Insert Variable** 引用前一步的输出，作为任何字段值。
6. 点击步骤标题中的 **Run** 来测试该操作，然后在 **Output** 中查看返回的负载。

## Use cases

### 审查设计文件

1. 获取文件元数据
2. 获取评论
3. 添加评论

### 检查选中的节点

1. 获取文件节点
2. 渲染节点图像
3. 下载图像

### 关联开发资源

1. 获取开发资源
2. 创建开发资源
3. 更新开发资源

## Notes

* 此步骤依赖于你工作区中已连接的 Figma 集成。
* 工作流操作选择器显示的是精选操作集。拥有 Figma 工具的代理可以使用更多操作。
* 登录屏幕可能会显示第三方授权品牌标识。

## Using Figma as an Agent Tool

你也可以在 **Agent Editor** 中将 Figma 添加为工具。打开代理，点击 **Add tool**，然后选择 **Figma**。在工具设置面板中，选择代理应使用的已连接帐户。代理会在相关于对话时调用 Figma 操作。

另请参见：[Integrations](https://docs.fetchhive.com/zh/workspace/integrations.md)、[Creating and Editing](https://docs.fetchhive.com/zh/workflows/creating-and-editing.md) 和 [Testing and Iteration](https://docs.fetchhive.com/zh/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.