AgentConfigurationEnvironment

环境变量加载

项目 Agent 启动时如何组合宿主 env 与项目 .env

环境变量加载

项目 agent 启动时,只会组合两层用户 env:

  1. 宿主显式传入的 new Agent({ env })
  2. 项目根目录 .env

常见场景

  • 你希望 city 或其他宿主统一注入共享密钥
  • 你希望某个项目用自己的 .env 覆盖宿主值

推荐做法

  • 共享密钥由宿主显式传给 Agent
  • 项目私有覆盖写到 .env
  • downcity.json 只保留结构化配置,不再写 ${VAR}

这样做的直接好处是:

  • env 来源更直接
  • 配置文件更稳定
  • 不会再出现“配置里字符串被偷偷替换”的隐式行为

修改后要做什么

通常需要重启 agent:

town agent restart

因为 agent 启动时会读取这份 env 快照,单纯改 .env 或宿主注入值不会自动刷新当前运行中的进程。