配置系统

Foya 配置分为启动配置、应用设置和项目级文件。不同配置有不同所有者和生命周期，不存在一个包含所有状态的单一配置文件。

启动配置

Kernel Config 包含：

桌面 Sidecar 使用默认本地配置。短生命周期 CLI 管理命令会禁用自动启动飞书和 Cron 等外部集成。

当前支持的核心变量：

变量	用途
`FOYA_PROVIDER_BASE_URL`	初始 OpenAI 兼容端点
`FOYA_PROVIDER_API_KEY`	初始 API Key
`FOYA_PROVIDER_MODEL`	初始 Model
`FOYA_PROVIDER_CONTEXT_WINDOW`	初始上下文窗口
`FOYA_LISTEN_ADDR`	TCP 服务监听地址；设置后进入持久服务模式
`FOYA_SOCKET_PATH`	本地 Unix Socket 路径
`FOYA_DATA_DIR`	数据目录
`FOYA_AUTH_TOKEN_SHA256`	远程 Bearer Token 的 SHA-256 摘要
`FOYA_AUTH_TOKEN_HASH_FILE`	保存 Token 摘要的文件
`FOYA_TLS_CERT_FILE`	TLS 证书链
`FOYA_TLS_KEY_FILE`	TLS 私钥
`FOYA_ALLOW_PLAINTEXT`	允许可信反向代理网络中的明文 TCP
`FOYA_AGENT_MAX_GLOBAL_CONCURRENCY`	Child 全局并发
`FOYA_AGENT_MAX_PER_ROOT`	单 Root 并发
`FOYA_AGENT_MAX_TREE_TOKENS`	Child Tree Token 上限
`FOYA_OTEL_ENABLED`	启用 OpenTelemetry
`FOYA_OTEL_TRACES_ENABLED`	总开关启用后是否导出 Trace，默认 true
`FOYA_OTEL_METRICS_ENABLED`	总开关启用后是否导出 Metrics，默认 false
`FOYA_OTEL_CAPTURE_CONTENT`	总开关启用后是否导出 Prompt 和结果，默认 false
`FOYA_OTEL_ENVIRONMENT`	部署环境标签
`OTEL_SERVICE_NAME`	OTel Service Name，默认 `foya`
`OTEL_EXPORTER_OTLP_*`	标准 OTLP Endpoint、Protocol、Header 和 TLS 配置

FOYA_OTEL_ENABLED 默认为 false；其余三个变量只是子开关，不会单独启用遥测。 Feishu CLI 读取的变量详见 CLI 参考。

环境 Provider 只用于没有 Connection Catalog 时建立初始连接。持久 Connection 创建后，Session 使用具体 Connection ID。

Foya 数据目录保存：

全局用户扩展位于 ~/.foya 或 ~/.agents，项目扩展位于项目目录。

常见解析顺序：

这些优先关系由各领域 Manager 定义，不应假设所有配置都使用同一覆盖规则。

大多数配置使用完整替换或原子临时文件 Rename。服务会在写入前验证：

客户端读取 Connection、MCP 和 Search 配置时不会返回明文凭证。

以下配置通常在下一次操作生效，无需重启：

OpenTelemetry Provider 在 Kernel 启动时创建，修改相关环境变量后需要重启。

Connection Catalog 更新会重建 Provider Client，并清除 Session 的内存 Context 预算基线。