Figma 集成指南
Figma 集成的功能
连接 Figma 后,Nakama 会在专属面板中显示你团队的项目和文件(含实时缩略图)。点击某个文件,会在浏览器的 Figma 中以全尺寸打开;每个文件的评论流就在面板内——阅读话题、回复、筛选出提及你的评论,并将任意评论转为待办事项。
添加应用(连接)
1. 在 Chrome 中打开 Nakama 侧边栏。
2. 点击右侧导航栏底部的 + (Add) 按钮,打开 Marketplace。
3. 选择 Figma 并点击 Connect。
4. Figma 登录页面会作为浏览器标签页打开。登录后点击 Allow 授权 Nakama。
5. 一次性设置:粘贴你的 Figma 团队 URL(在 figma.com 打开你的团队并复制地址栏内容)——Figma API 没有“列出我的团队”功能,因此 Nakama 仅需询问一次。
6. Figma 图标会出现在 Nakama 导航栏中,面板随即打开并显示你的项目。
使用应用
浏览项目。面板标题是一个项目选择器——从下拉菜单中切换项目。
打开文件。每个文件都会显示其缩略图、名称和最后修改时间。点击它,文件便会在浏览器标签页的 Figma 中打开——Nakama 绝不会尝试在面板内运行 Figma。
跟进评论。点击文件上的评论按钮查看其评论流:话题分组呈现,未解决的优先显示,并提供 @me 筛选器以查看提及你的评论。评论流打开时,新评论会持续涌入。
回复与操作。直接在面板中撰写回复;将鼠标悬停在评论上即可将其添加到你的 Todo 列表。将文件卡片拖到 Slack 或 Telegram 上即可共享其链接。
权限与数据处理
Nakama 请求 Figma 的 files:read(项目、文件、评论)和 file_comments:write(发布回复)权限。你的 Figma 令牌仅存储在你浏览器的本地扩展存储中,绝不存储在 Nakama 的服务器上;应用密钥仅在服务器端保留,且仅用于 OAuth 交换。
移除应用(断开连接)
在 Nakama 中:点击导航栏中的 + (Add) 打开 Marketplace,找到 Figma(显示为已连接)并点击它即可断开连接。图标将从导航栏移除,存储的令牌也会从你的浏览器中删除。
在 Figma 中:你也可以在 Figma Settings → Connected apps 中撤销访问权限,从而在 Figma 一侧撤销它。
问题排查
提示“That doesn't look like a team URL”:团队 URL 必须包含 /team/<number>/——请在 figma.com 的文件浏览器中打开你的团队,并复制完整地址。
其他问题:请查阅 帮助中心,或发送邮件至 help@rexplore.xyz。