配置分离原则
将配置按用途分离:基础配置(config.yaml)、敏感配置(.env)、Skill配置(skill.yaml)、环境配置(config.prod.yaml)。分离管理便于维护和安全。
版本管理
配置文件纳入版本控制,但敏感信息除外。使用.env.example作为模板,实际.env不提交。使用Git管理配置变更历史。
配置验证
启动时验证配置完整性。使用Pydantic验证配置格式:class Config(BaseModel): database: DatabaseConfig, model: ModelConfig。配置错误会阻止启动。
热更新配置
部分配置支持热更新,如日志级别、Skill参数。使用API更新:PUT /api/config/logging。无需重启即可生效,便于运维调试。