常见问题
关于邀请码、计费、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 小时内响应。