讓畫布上要用 FLUX「自帶 BFL 金鑰」那幾顆的人，在畫布右上角的「設定」一個地方存、換、刪自己的 BFL 金鑰；元件上不再有貼金鑰的格子，還沒存就寫「先貼金鑰」，一按就帶到設定，存好之後元件自己變回「執行」。

#294　畫布設定：我的金鑰統一管理（元件上不再貼金鑰）

狀態: 等審查
誰在做: 負責人＋Claude
做到哪: 程式做完了，在 PR #301：只改前端，沒有動後端、沒有遷移、沒有升告知版本。10/03 那一版 CI 五個 job 全綠、本機瀏覽器驗收 31/31、錄影貼在展示頁。還沒有人審；而且 main 之後又動過，GitHub 現在顯示有衝突（只撞在平台地圖的產出檔和審查帳本這兩個自動產生的檔案），合併前要先 rebase。真的用 BFL 出圖、Safari／iPad 實機這兩件還沒驗。
卡在: 等審查：PR #301 10/03 送出後沒有人審。10/05 起審查請求一律先給宜芳、由她分派（#326），所以要宜芳指定審查者。另外 PR 跟 main 有衝突，要先 rebase、CI 重跑。
下一步: 宜芳指定一位審查者看 PR #301；負責人＋Claude 同時把 PR rebase 到最新 main（重產平台地圖、接上審查帳本），CI 重跑到綠。審過、合併（合併就上線）之後，宜芳用測試租戶照下面的驗收走一遍；需要真的 BFL 金鑰的那幾步請負責人自己貼。

提醒：① issue 本文的驗收清單框框還都沒打勾，但 10/03 的留言已經回報做完（只剩真的用 BFL 出圖、Safari／iPad 實機沒驗），以那則留言和 PR #301 為準。實作跟原文有兩處小差別：原文寫元件上「一行說明＋『到設定貼金鑰』」，實作是執行鈕那一格寫「先貼金鑰」；原文寫「每個登入的人都看得到設定」，實作改成「機構開了智慧元件才有」（見「還沒定的」第 1 題）。② 正式租戶的智慧元件還沒開（#242 交接寫明要跟點數帳本 #243 一起開），所以合併上線後，正式租戶的人畫布上暫時看不到「設定」，這是預期的；驗收請用測試租戶。③ PR #301 跟 main 有衝突，只撞在兩個自動產生的檔案，rebase 重產就好；但檔案元件 PR #317 也改同一批畫布檔案、告知 v26 的 PR #306 也改 ADR-0124 和平台地圖，誰先合、另外一支就要再整理一次衝突，排合併順序時一起看。④ 存好金鑰之後的那幾步（末四碼、換一把、刪掉、「先貼金鑰」自己變回「執行」）一定要一把真的 BFL 金鑰才走得到，因為存之前系統會先問 BFL；負責人裁過真實金鑰不代貼，所以那幾步請負責人自己貼，或先看展示頁的錄影。⑤ PR 一開始指定的審查者是照 #248 的舊分工，10/05 起改成先給宜芳分派（#326），這張現在就卡在「誰來審」。

這張要解決什麼

畫布上會用 FLUX「自帶 BFL 金鑰」那幾顆模型的人——機構管理者或一般成員都一樣，#290 上線後其實是一個人存一次金鑰、所有元件共用，但貼金鑰的格子長在元件上，看起來像每一顆元件都要貼一次；要換一把或刪掉，也得先找到一顆元件。負責人 10/03：「一個元件輸入一次會讓人抓狂」——要能在畫布右上角的「設定」一個地方管理自己的 BFL 金鑰（存、看末四碼、換、刪）；元件上還沒有金鑰時一按就被帶到那裡，存好不用重新整理就能執行

一步一步 16 步

機構管理者（前置，這張沒改）　在任一顆「生成圖片」或「草圖轉渲染」元件上按「開放哪些模型」，打開 Black Forest Labs 這一家
模型選單裡才會出現標「自帶 BFL 金鑰」的那幾顆。「開放哪些模型」照舊留在元件上、只有機構管理者看得到，沒有搬進設定
元件上的「開放哪些模型」（照 #290，沒動）
開放哪些模型（只有機構管理者有）
Black Forest Labs（自帶金鑰）
打開 → 展開說明 → 確定打開（兩段式）
任何登入的人　打開一張畫布，看右上角
機構有開智慧元件的話，搜尋、晝夜切換、登出旁邊多一顆「設定」，每個人都有；機構管理者與負責人另外還有「分享」。機構沒開智慧元件就沒有「設定」
畫布右上角工具列
搜尋（⌘K／Ctrl+K）
晝夜切換
登出
設定（新的；機構開了智慧元件才有，有的話每個人都有）
分享（只有機構管理者與負責人）
成員（還沒存過 BFL 金鑰）　放一顆「生成圖片」，模型選單選「klein 9B（自帶 BFL 金鑰）」
執行鈕那一格換成「先貼金鑰」，下面一行說明。元件上沒有貼金鑰的欄位，也沒有「換一把金鑰」「刪掉」
智慧元件：選了自帶金鑰、還沒存
描述
模型選單：klein 9B（自帶 BFL 金鑰）
先貼金鑰（取代「執行」；按了不會執行，是帶你去設定）
這一顆用你自己的 BFL 金鑰：在畫布設定存一次，所有畫布共用
成員　按「先貼金鑰」
右側抽屜打開「設定」，游標已經在金鑰欄，可以直接貼上。抽屜跟「分享」是同一個抽屜，只是換內容
右側抽屜：設定 → 我的金鑰（還沒存）
設定
✕ 收起設定（Esc）
我的金鑰
標「自帶 BFL 金鑰」的那幾顆用你自己的 Black Forest Labs 帳號：存一次，所有畫布共用；只有你自己按執行時會用到，費用由你直接付給 BFL
金鑰加密存在我們這邊，畫面上只看得到末四碼
貼上你的 BFL API key（密碼欄，游標在這裡）
存（沒貼東西時停用）
- 三步：到 dashboard.bfl.ai 註冊、開專案／API › Keys › Add Key 複製／API › Credits › Add Credits 儲值（費用付給 BFL）
成員　貼了一串不對的金鑰，按「存」
系統先拿去問 BFL，BFL 不認就什麼都不存，紅字講原因
設定 → 我的金鑰（被 BFL 拒絕）
貼上你的 BFL API key
存（按下去顯示「驗證中…」）
BFL 不接受這把金鑰：檢查是不是整串都貼上了，或到 BFL 後台再建一把
成員　貼上真的金鑰，按「存」或按 Enter（用中文輸入法選字時按的 Enter 不算）
BFL 認了就存起來。抽屜變成只顯示末四碼；元件上那一格不用重新整理就自己變回「執行」，下面一行改成「用你的 BFL 金鑰 …末四碼」
設定 → 我的金鑰（存好了）＋元件
BFL 金鑰 …abcd（只有末四碼）
刪掉（兩段式）
換一把
（元件上）執行
（元件上）用你的 BFL 金鑰 …abcd
成員　按 Esc 或抽屜的 ✕
抽屜收起，焦點回到剛剛按的那一顆（元件上那一格）；那顆元件已經被刪掉的話，焦點回到右上角「設定」
成員　按「執行」
用他自己的金鑰送 BFL，費用由他直接付給 BFL，平台不扣點。這一段是 #290 做的，這張沒改；真的用 BFL 出圖還沒驗過
成員　改從右上角「設定」打開抽屜
抽屜打開但不搶焦點（游標不會自己跳進金鑰欄）——只有從元件的「先貼金鑰」打開才會
成員（已經存過）　在設定裡按「換一把」
出現貼上欄＋「存」＋「取消」（Esc 也是取消）；新的那把一樣先問 BFL，存好之後舊的作廢
設定 → 我的金鑰（換一把）
貼上你的 BFL API key（游標在這裡）
存
取消
成員（已經存過）　在設定裡按「刪掉」
先跳出畫面裡的確認（不是瀏覽器彈窗），按「確定刪掉」才刪。刪完設定回到空白的貼上欄，元件上變回「先貼金鑰」；只刪自己的，別人的金鑰不受影響
刪掉金鑰的確認
刪掉你的 BFL 金鑰
刪掉之後，你用自帶金鑰的那幾顆都要重新貼才能執行；別人的金鑰不受影響。BFL 那邊的金鑰不會被撤銷，要停用請到 BFL 後台。
確定刪掉
機構管理者　抽屜開著時在「分享」與「設定」之間切來切去
同一個抽屜換內容。抽屜沒收起之前，分享裡選到一半的邀請、設定裡貼到一半的金鑰都還在；按 ✕ 收起就全部清掉。在分享頁把自己降級（不能再分享）時，抽屜換到設定、不整個收掉
右側抽屜：分享 ↔ 設定
右上角：設定
右上角：分享
抽屜裡同一時間只顯示其中一頁，另一頁藏著、內容保留
✕ 收起（清掉兩頁打到一半的東西）
同一張畫布上的另一個人　選同一顆自帶金鑰的模型
用的是他自己的金鑰：他沒存就看到「先貼金鑰」；看不到別人的末四碼
成員（金鑰存過、後來在 BFL 那邊被撤銷或用完餘額）　按「執行」
元件講下一步去哪裡：被拒時「BFL 不接受這把金鑰：到畫布右上角的『設定』換一把再試」；餘額不夠時指去 BFL 後台儲值。不會偷偷改走 Cloudflare 那條、也不改成扣點
智慧元件：執行失敗的提示
BFL 不接受這把金鑰：到畫布右上角的「設定」換一把再試
BFL 帳戶的餘額不夠：到 BFL 後台儲值之後再試（dashboard.bfl.ai › API › Credits）
審查者（宜芳分派）＋負責人＋Claude　PR #301 先 rebase 到最新 main、CI 重跑；審查者看過、核准後合併
合併就上線（前端自動部署）。這支沒有遷移、沒有升告知、沒有動後端，照 PR 說明不在 #248 規定合併前要先問負責人的四類裡
宜芳（或測試員）　上線後用測試租戶的兩個帳號照下面的驗收點一遍；需要真金鑰的步驟請負責人自己貼；錄影連結附在這張與 PR
全部對就關這張

已經定的 18 條

金鑰在畫布的設定裡統一管理，不要每個元件各貼一次負責人 2026-10-03（#294 本文）
設定這一版只放金鑰；「開放哪些模型」「逐家打開」照舊在元件上，只有機構管理者有負責人 2026-10-03 選「只放金鑰」（#294 本文）
還沒存金鑰就要用 FLUX，就帶到設定負責人 2026-10-03「若用戶尚未輸入金鑰就要使用 flux，就跳轉設定」（PR #301 Why）
#290 先合，畫布設定放下一個 PR 做（疊在 #290 上）#294 本文〈流程〉
只有 FLUX（BFL）的元件自帶金鑰，其他智慧元件照舊平台付；金鑰算貼的那個人的，同一張畫布上別人按執行用他自己的負責人 2026-10-02（#267）；ADR-0124 修訂（九）三
一個人、一家只有一把活的金鑰，所有畫布共用；可以換、可以刪（刪是撤銷）ADR-0124 修訂（九）三
存之前先問 BFL 驗一次，被拒就不存，講「BFL 不接受這把金鑰」ADR-0124 修訂（九）三；#294 驗收條件
金鑰不回到瀏覽器，畫面上只看得到末四碼；不進畫布內容、不進日誌與錯誤訊息ADR-0124 修訂（九）三；#267
沒有金鑰或金鑰被拒，不偷偷改走 Cloudflare 那條、也不改成扣點ADR-0124 修訂（九）一、六
設定跟「分享」用同一種面板；Esc 關面板、焦點回到打開它的那顆按鈕；中文組字中按 Enter 不送出#294 驗收條件
刪掉這種危險動作要兩段式，不用瀏覽器的 confirm 彈窗ADR-0066；#294 驗收條件（兩段式刪掉）
不改後端（金鑰的端點、表、加密都沿用 #290）、不動「開放哪些模型」、不加別家的金鑰#294 本文〈不做〉
測試先走 Cloudflare 那幾顆 FLUX，真的用 BFL 出圖延後再驗負責人 2026-10-03「API KEY 先暫時走 cloudflare」（PR #301 Notes）
真實帳號的 BFL 金鑰不代貼，要貼的時候由負責人自己貼負責人 2026-10-03（ADR-0124 修訂（九）開頭、八之 3）
錄影貼展示頁，連結附在這張與 PR#294 驗收條件
先做 Mac、PC、iPad，手機先不用，尤其是畫布；iPad 不能靠滑過傳遞資訊負責人 2026-09-29（設計系統文件 docs/ui/2026-09-06-farside-design-system.md §1 裝置範圍）
審查請求、通知一律先給宜芳，由她分派負責人 2026-10-05（#326〈分工〉最後一句）
合併 main 就是上線#248 規矩第 3 條

還沒定的 2 題

機構沒開智慧元件時，畫布右上角要不要也有「設定」？issue 原文寫「每個登入的人都看得到」，PR #301 改成「機構開了智慧元件才有」

照 PR：沒開就不顯示（現在設定裡只有金鑰，沒開的機構打開只會卡在「重新讀取」）
照 issue 原文：每個人都看得到，沒開的機構在裡面寫「這個機構還沒開智慧元件」

建議：PR 這樣改的理由是推前審查抓到的（沒開的機構後端會擋，畫出來是壞的），等設定裡有別的東西再一起放寬比較單純；但這跟需求原文不一樣，驗收時要有人點頭

誰裁：宜芳（驗收時確認；拿不定再問負責人）

真的用 BFL 出圖、Safari／iPad 實機這兩件還沒驗，什麼時候驗、誰驗？

合併前：負責人用自己的金鑰出一張圖＋用 iPad 點一遍
先合併：iPad 合併後由宜芳或測試員用實機點；BFL 出圖等產品改走 BFL 時再一起驗

建議：這支沒動送 BFL 的後端，BFL 出圖可以延後；iPad 在裝置範圍裡、而 PR 只在 Chromium 模擬過 Safari 的焦點行為，建議合併後盡快用實機點一次

誰裁：負責人

這張不做

不改後端：金鑰的端點、資料表、加密都沿用 #290
不動「開放哪些模型」「逐家打開」——照舊在元件上、只有機構管理者有
不加別家的金鑰（今天只有 BFL）
設定裡這一版只有「我的金鑰」，沒有其他畫布設定
沒有遷移、不升告知版本
這張不驗真的用 BFL 出圖（延後到產品改走 BFL 時）
手機版面（裝置範圍先做 Mac、PC、iPad）