Figma 整合指南

Figma 整合的功用

連接 Figma 後，Nakama 會在專屬面板中顯示你團隊的專案與檔案（附即時縮圖）。點按檔案會在瀏覽器中以全尺寸開啟 Figma；每個檔案的留言動態就在面板中──閱讀對話串、回覆、篩選出提及你的留言，並將任何留言轉為待辦事項。

新增應用程式（連接）

1. 在 Chrome 中開啟 Nakama 側邊欄。

2. 點按右側側欄底部的 + (Add) 按鈕以開啟 Marketplace。

3. 選擇 Figma 並點按 Connect。

4. Figma 登入頁面會以瀏覽器分頁開啟。登入並點按 Allow 以授權 Nakama。

5. 一次性設定：貼上你的 Figma 團隊網址（在 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（顯示為 Connected）並點按它以中斷連接。圖示會從側欄移除，已儲存的權杖也會從你的瀏覽器刪除。

在 Figma 中：你也可以在 Figma Settings → Connected apps 中撤銷存取權，藉此在 Figma 端撤銷它。

疑難排解

「That doesn't look like a team URL」：團隊網址必須包含 /team/<number>/──請在 figma.com 的檔案瀏覽器中開啟你的團隊並複製完整網址。

其他問題：請參閱 說明中心，或來信 help@rexplore.xyz。