配置文件放在哪里
项目级配置建议放在 .railwise/railwise.json。企业环境也可以通过全局配置、环境变量或远程配置模板统一下发，再由项目级配置覆盖差异项。
核心字段
- model：默认使用的模型，通常写成
provider/model-id。 - default_agent：启动后的默认业务智能体。
- enabled_providers：控制模型切换菜单中显示哪些 provider。
- provider.options：填写 baseURL、API Key 等接入参数。
安全建议
不要把真实 API Key 写进 Git 仓库、提示词模板或公开文档。企业统一 Key 建议放在模型代理层，桌面端或 CLI 只配置代理地址和必要的访问凭证。
排查方法
如果模型不可用，优先检查 provider 名称、baseURL、网络连通性、Key 权限和模型 ID。团队内建议保留一份“最小可运行配置”，用于快速判断问题来自配置还是业务模板。