配置
配置
VeADK 将配置与代码分离。模型密钥、数据库连接、服务地址会随环境变化,也不宜写入源码,因此统一由配置提供。同一份代码即可在本地、测试与生产间迁移,密钥也不会进入代码仓库。
配置分为三层,由静到动:
- 环境变量:启动时读取,最常用。存放模型密钥与连接信息,可通过系统环境变量、
.env或config.yaml提供。 - 内置默认值:常用项均有合理缺省,零配置即可运行。
- 运行时动态配置:部署后无需重启,热更新提示词、模型等设定。
优先级
同一项配置在多处出现时,按以下顺序取值(越靠前优先级越高):
- 系统环境变量
- 项目根目录下的
.env文件 config.yaml文件- 框架内置默认值
config.yaml 适合集中管理大部分配置,系统环境变量用于在特定环境临时覆盖个别项;未提供的项回落到内置默认值。
密钥应放入环境变量或 config.yaml,切勿硬编码到代码。.env 与 config.yaml 都应加入 .gitignore,避免提交到代码仓库。