Configuration

配置参考

Botler 的本地机密信息放在未纳入版本控制的 backend/.env；可提交的 backend/config.yaml 使用 ${ENV_VAR} 引用环境变量。请从 backend/.env.example 与 backend/config.example.yaml 开始配置，切勿把真实 Token、密钥或生产地址提交到仓库。

必要配置

类别	示例项	说明
GitLab	GITLAB_BOT_TOKEN	Bot 的 PAT，至少有 api 与 write_repository scope
Webhook	WEBHOOK_SECRET	用高熵随机值校验 GitLab webhook
执行引擎	ANTHROPIC_API_KEY 等	按选择的 Claude、Hermes 或 DSH 引擎填写
会话安全	SESSION_SECRET	用于签名 Web 会话，生产环境必须独立随机生成

常用运行配置

• worker.engine：选择默认执行引擎；可设置备用引擎，在主引擎不可用时降级。
• worker.precheck_enabled：任务开始前检查 Git 凭据、工作区与磁盘容量。
• worker.precheck_disk_min_free_mb：预检需要的最小可用空间，默认 2048 MiB。
• retention：任务日志、通知记录和归档日志的保留策略。

修改配置后应通过设置页面或受控部署流程生效，并确认健康检查正常。机密轮换、权限最小化和审计要求见运维与安全。