常見問題
關於邀請碼、計費、BYOK、資料隱私、匯入 / 匯出的高頻問題。
高頻問題按主題分組。沒找到的，先搜一下關鍵字，再不行去「問題排查」頁看常見症狀。
帳號與註冊
註冊需要邀請碼嗎？
不需要。目前開放註冊，在 /register 用電子郵件直接註冊，或用下方任一第三方登入。
能用國內郵箱註冊嗎？
可以。QQ / 163 / 阿里 / 騰訊企業郵箱都測試過。偶爾激活郵件會進垃圾箱，注意檢查。
一個郵箱能註冊多個賬號嗎？
不能。一個郵箱 = 一個賬號。如果你需要"開發 / 生產"兩套賬號，用 + 別名（你+dev@gmail.com）。
能用 Google / GitHub / 飛書 / 釘釘 登入嗎？
可以。Braidrun 共支援 14 種第三方登入：Google · GitHub · GitLab · Microsoft · Apple · Slack · LinkedIn · 微信 · 支付寶 · 飛書 · Lark · 釘釘 · Gitee，以及任意符合 OpenID Connect 標準的企業 SSO（例如 Keycloak / Authentik / Okta / Auth0）。登入頁只顯示目前環境已啟用的選項。
訂閱與計費
Free 和 Pro 最大的差別是什麼？
Free 只有 3 種基礎 step 類型（single / code / classifier），沒有調度 / Webhook / 斷點調試器 / 自動續跑。適合"體驗一下"。任何真實生產場景都要 Pro 以上。
套餐能月付 / 年付自由切換嗎？
可以。在賬號設置 → 賬單裡切換計費週期，下一計費週期生效。從月付切年付立即得折扣；從年付切月付等年付到期。
發票能開給公司嗎？
可以。中國區支持增值稅普票 / 專票。賬單頁填抬頭和稅號後，每次扣款自動生成。Enterprise 可對公轉賬 + 合同。
超出配額會發生什麼？
已有的工作流與執行繼續跑，新建會被拒（彈窗提示升級）。建議用 80% / 95% 預警提前處理。
BYOK / LLM 成本
一定要 BYOK 嗎？
Free / Pro 內置少量共享池 Key 額度夠小流量。真要上量建議 BYOK —— 額度更充足、成本更低（特別是大規模調用 DeepSeek 時）。
Braidrun 加價多少？
BYOK 下不加價。你 Provider 側實際付多少，就是你的真實成本。Braidrun 的收入來自訂閱費，不從 token 抽成。
我能看到工作流跑一次花了多少嗎？
能。執行詳情頁頂部顯示 tokens + cost（按 Provider 公開價目換算）。數據看板按日 / 周 / 月聚合。
如果 Provider 突然提價？
Provider 價目表變動會被平臺抓取並更新我們的 cost 估算。真實賬單永遠在 Provider 側結算。
數據隱私
我的數據會被用來訓練模型嗎？
不會。Braidrun 本身不訓練任何模型。BYOK 時數據去向由你選的 Provider 決定 —— OpenAI / Anthropic 的默認政策都是"不用於訓練"，你可以在他們控制檯裡進一步 opt-out。
憑據會被洩露嗎？
憑據在憑據中心 AES-256-GCM 加密落庫；運行時解密只在單個 step context 生效；不寫入日誌、不進 YAML 導出、不對其它 step 可見。DB dump 裡拿到的是密文。
我的工作流 YAML 是私密的嗎？
是。個人 workflow 只有你自己可見；團隊 workflow 只有團隊成員按角色可見；Braidrun 員工沒有後門查看生產環境的用戶工作流。Enterprise 私有化部署連這層都是客戶側內網自管。
數據存在哪？
SaaS 版存在香港 / 新加坡 / AWS Tokyo 區。Enterprise 私有化部署時完全在客戶側。具體可在"數據處理協議（DPA）"文檔裡看。
模板與導入導出
模板跟我自己的 workflow 是什麼關係？
複製一份到你的工作區，你的修改不會回傳到範本，範本更新也不會自動改動你的副本。但複製時會記錄「來自哪個範本的哪個版本」：範本發新版後，你可以先預覽變數差異，再一鍵升級 —— 升級前自動儲存版本快照，你自己選的模型設定會保留。步驟見 從模板實例化的「範本升級」一節。
能從 Dify / Langflow / n8n 導入嗎？
Dify workflow 支持一鍵導入（會自動轉 YAML 格式）。Langflow 和 n8n 暫不支持原生導入，但 AI 助手可以讀它們的 JSON 導出後幫你"翻譯"為 Braidrun YAML。
能把我的工作流導成別的格式嗎？
YAML 導出是最權威的 —— 這就是 Braidrun 的原生格式，在 CLI（braidrun-agent）裡也能直接跑。沒有單向轉去別家的功能。
執行與調度
執行失敗了，錢會退嗎？
Braidrun 不按次收費，所以無所謂退費。失敗發生的 LLM token 消耗會記在你 Provider 賬上（BYOK）—— 如果你覺得是平臺問題導致的失敗，可以提工單我們會協助找 Provider 要 credit。
cron 到點沒觸發怎麼排查？
先看調度詳情頁「下次觸發時間」—— 對不對？再看「最近一次觸發歷史」—— 是不是被 throttle 了。詳細步驟見 問題排查。
多實例部署時 cron 會被觸發兩次嗎？
不會。平台內部以分散式鎖定保證相同調度同一分鐘只會在一台機器上觸發，Auto-resume 時也有專用鎖定防止兩節點同時復活同一個執行。
服務重啟 / OOM 後我的工作流程會怎樣？
預設所有正在跑的執行被標記為 INTERRUPTED，需要你手動點"從某個步驟重啟"。這是預設行為，避免 Telegram / 廣告改價 / 發郵件等帶副作用的步驟被意外重複觸發。
如果你的工作流程是"純資料 pipeline"（只讀 API、純計算、寫入本地 artifact），可以 opt-in 自動恢復：工作流程 YAML 加 recovery.autoResumeOnRestart: true，每個可重跑的步驟加上 idempotent: true。详见 /docs/run/recovery。
協作與遷移
個人賬號怎麼升到團隊？
先升到 Team 套餐 → 創建 Team → 把你現有的工作流"移動到 Team"。歷史執行記錄一起遷。
團隊裡能看到誰改了什麼嗎？
能。每次工作流程 / 憑證 / 排程 / 核准的變更都會記入團隊稽核日誌,具備 Owner / Admin 角色的團隊成員可檢視。同時 workflow 版本歷史能看到每次儲存的作者。
我離職了，怎麼把資源交接？
- 把你是 Owner 的 Team 所有權轉移給接任者；
- 個人命名空間的憑據讓接任者重新在 Team 命名空間下建一份；
- 導出個人 workflow 給接任者；
- 最後註銷個人賬號。
開發者問題
有 REST API 嗎？能用程序驅動嗎？
有。三種鑑權方式：
- API Key（推薦 CI / 自動化） — 帳戶設定創建，格式 dyk_<id>_<secret>，按 scope 授權（WEBHOOK_TRIGGER / WORKFLOW_EXECUTE / EXECUTION_READ 等），可設過期時間
- 密碼登入 Bearer JWT — POST /api/auth/login 換 access (15 分鐘) + refresh (7 天) token；只在調試時用，CI 用 API Key
- Cookie（瀏覽器） — SPA 用 HttpOnly Cookie + CSRF；詳見帳號設定頁
工作流程內部需要回呼平台 API（例如透過內建模組建立公開連結）時無需手動管理 token —— 引擎自動注入短期 WF_API_TOKEN 環境變數。詳見開發者手冊。
支持 CLI 嗎？
支持。braidrun-agent CLI 可以在本地跑 YAML —— 和 web 端的工作流 YAML 100% 兼容。適合 CI 集成。
可以本地部署嗎？
Enterprise 套餐支援完整私有化部署。開源版自備 deployer/ 工具，支援 Vultr / AWS / Aliyun 多雲 provider，CLI + GUI 兩種模式，可完成 provision / scale / rolling-deploy / rollback / scale-controller 安裝。 Pro / Team 套裝目前僅限 Braidrun SaaS。
WebSocket 鑑權怎麼做？
用 POST /api/auth/ws-ticket 拿到 30 秒 TTL 單次 ticket，握手時帶 ?ticket=<value>。這套 ticket 流程在 2026-05 取代了舊的 Sec-WebSocket-Protocol: <JWT> 路徑（舊路徑作為降級方案保留）。前端 composables/useExecutionWebSocket.ts 已經封裝好了。
為什麼我的 POST 請求總報 403 csrf_token_mismatch？
從 2026-05-08 起平台預設開啟 HttpOnly Cookie + 雙重提交 CSRF 校驗。前端 SPA 必須：(1) 首次載入時 GET /api/auth/csrf 拿到 dy_csrf cookie；(2) 所有 POST/PUT/PATCH/DELETE 請求把 cookie 值 echo 到 X-CSRF-Token header；(3) axios 配 withCredentials: true。直接用 curl 測時：curl -c /tmp/jar https://host/api/auth/csrf 先拿 cookie，再帶 -b /tmp/jar 和 -H X-CSRF-Token: ...。
產品反饋
想讓你們加一個模板 / 一個 step 類型 / 一個集成
在賬號設置 → 「產品反饋」提交，會進我們的月度優先級評估。被採納的功能會在 changelog 裡顯眼致謝。
遇到 Bug
右下角"幫助"按鈕提 bug 工單，自動附上瀏覽器環境與最近一次 execution ID。我們通常 24 小時內響應。