配置总览
1分钟内可阅读完
加载与装配
服务通过 -c 读取 YAML，字段层级以 mapstructure tag 为准。LocalConfig.Init 初始化框架配置，IndependentCfg 承载业务私有配置。当前模板 make run 指向 config/app-dev-local.yaml。
services.service_code 是启动必需项，不能把所有配置段都理解为可缺省关闭。其他段的零值、默认值与 enable 判断由各初始化函数决定；复制完整 YAML 前应明确实际使用的能力。
已发布参考
| 配置段 | 文档 | 用途 |
|---|---|---|
| services | 基础服务 | 服务标识、监听与集成 |
| security | 认证鉴权 | 身份与权限策略 |
| database | 关系数据 | MySQL/PostgreSQL 与 ent |
| cachebox | 缓存服务 | memory/Redis |
| observables | 可观测性 | 指标与链路 |
| objstore | 对象存储 | 存储客户端 |
| frontend | 前端托管 | 静态页面 |
| automations | 流程编排 | 工作流接入 |
| aiconnector | 智能连接 | MCP Server |
| independent | 应用私有 | 业务依赖 |
服务注册、日志调试与事件配置的独立页面仍为草稿，具体字段请参考源码配置样例，不以草稿作为已验证指南。
错误与组合行为
启用数据库时字段校验或 Ping 失败使 Init 返回错误；Admin 无可用数据库时可能记录日志并继续装配，不能把两者混为一谈。业务 ent 自动建表错误会返回；Admin lion schema 创建错误当前记录 warning，需检查日志与实际功能。
框架 Init 未提供全局资源回滚。详细启动顺序和释放边界见启动与部署检查。MCP 实际注册判断 aiconnector.mcp_server.enable，顶层 enable 不能作为单独关闭 MCP 的保证。
生产配置明确设置密钥、凭据、监听地址和权限范围，私密配置不提交到仓库。按Admin 启用和MCP 实践验证组合行为。