Figma 工作历史：跟踪设计变更并将其与 Codex MCP 结合使用

Snapside Figma 集成正式上线。

设计文件非常适合显示当前答案。他们在维护通往那里的道路方面效率较低。框架变宽，自动布局间隙改变，错误颜色变柔和，并且副本移动。几天后，团队可以看到最终的屏幕，但并不总是看到其背后的决策顺序。

Snapside 将版本级 Figma JSON 快照转换为设计人员和开发人员可以阅读的产品历史记录。

Figma 的工作历史是怎样的？

Figma 的工作历史不仅仅是缩略图库。它是通过将某个时间点的文件结构和值与下一个可用状态进行比较而创建的记录。

连接文件时，Snapside 会捕获基线并导入过去 30 天内的可访问版本。它按时间顺序对它们进行比较。当 Figma 提供版本 ID 和可检索的 JSON 状态时，可以包含命名版本和未命名版本。

Figma 官方版本历史记录端点提供用户可以访问的文件的版本。文件端点可以返回特定版本的文档树。 Snapside 将这些部分组合在一起，因此结果不仅仅表明“存在一个版本”，它还描述了发生了什么变化。

Snapside 记录了哪些设计变更？

Snapside 目前比较页面和顶级层的更改，包括：

• 添加和删除页面或图层
• 图层名称和顺序
• X/Y 位置、宽度和高度
• 自动布局间隙和四边填充
• 能见度
• 填充和描边
• 文本和字体相关的值

第一个状态被标记为设计快照。一旦存在先前的状态，以后的比较就会成为设计变更。这种区别可以防止初始导入看起来像是当时发生的工作。

说明性 Snapside 时间线和详细信息面板显示了 Figma 前后的帧宽度、自动布局间隙和错误填充值。

该屏幕是在 React 中使用虚构数据创建的。您的时间线显示您显式连接的文件的更改。

详细信息面板超出了诸如“5 个更改”之类的计数。如果支持，它会显示事件内的前后值，例如，框架从 320 像素更改为 360 像素，或者间隙从 16 像素更改为 24 像素。

可以跟踪未命名的自动保存版本吗？

是的。未命名的版本仍然可以包含有意义的设计更改。

大多数团队不会仔细命名每个版本。仅导入命名里程碑的系统可能会错过大部分真正的设计过程。因此，Snapside 使用每个版本的版本 ID 和 JSON 快照，然后比较相邻状态。

这不是逐个击键的协作日志。 Figma 记录了 FILE_UPDATE Webhook 在编辑不活动后 30 分钟内触发。 Snapside 时间线更好地理解为有意义的文件状态的历史记录，而不是实时光标提要。

Codex 如何通过 MCP 使用设计历史？

当实施开始时，设计历史的价值变得最为清晰。

假设设计者更新了结账错误状态：