docker compose up --build npm run db:init npm run admin:create -- admin curl http://127.0.0.1:18900/health
环境变量
按 .env.example 注入数据库、服务 token、模型凭证、对象存储和告警配置。
数据库结构
npm run db:init 按 SQL 序号同步结构，迁移账本避免重复执行。
健康检查
/health 返回服务状态，/version 返回应用和契约版本。
密钥管理
生产禁止明文密钥写入仓库或示例配置。已落盘凭证应轮换。
审计保留期
BAILING_AUDIT_RETENTION_DAYS 默认 0，不自动删除。生产按合规要求显式设置保留天数。
执行器并发
参考执行器可用 BAILING_EXECUTOR_CONCURRENCY 配置本地 worker 数；任务互斥和同会话串行由中枢调度保证。
集中限速
MySQL 后端下，接入方、聊天入口、后台登录和工具调用限速共享运行期账本，多实例语义一致。
官网边界
开源部署默认不托管官网，只暴露控制台、公开组件和接口；官网由 www.bailinghub.com 独立承载。
任务追溯
控制台「任务」以 job_id 查看 trace，聚合任务状态、阶段事件、审批意图、消息和送达记录。
脱敏排障包
排障材料围绕单任务导出，保留 route 快照、调度租约和 trace 事件，敏感字段按控制台规则掩码。
配置体检
route、target、tool provider、channel、storage bucket 等配置有机器可读 schema，并在保存和巡检时暴露诊断。
送达失败边界
callback 和送达适配失败会写入 trace / delivery 账本。业务侧仍应保留按 job_id 查询结果的兜底路径。