docs/requirements/2025-10-11-18-50-multi-provider-config-loading.md

需求：实现多 Provider 配置加载策略

• 创建时间: 2025-10-11-18-50
• 状态: 开发中 (In Progress)

需求描述

为项目实现一个灵活且安全的配置加载机制，以适配本地开发和线上部署两种不同的环境。

背景

• 本地环境: 使用内部 Alipay Inference Provider，性能高且免费。配置通过 local.py 文件管理。
• 线上环境 (Hugging Face): 使用 Zenmux Provider，需要付费，但可在公网访问。配置通过 Hugging Face 的环境变量 secrets 进行管理。
• 安全与效率: local.py 文件应被 .gitignore 忽略，以防止本地敏感信息泄露。

设计目标

实现一个“优先本地，回退线上”的配置加载逻辑：

1. 应用启动时，首先尝试从 local.py 文件导入 API endpoint 和 API key。
2. 如果 local.py 文件不存在（例如在线上环境中），则回退至从系统的环境变量中读取这些配置。
3. 此设计旨在兼顾本地开发的效率与便利性、线上部署的安全性以及成本控制。

验证方式

1. 在本地创建 local.py 文件并填入虚拟的 API key 和 URL。启动应用，确认应用加载的是 local.py 中的配置。
2. 删除或重命名 local.py 文件。在终端中设置临时的环境变量。启动应用，确认应用加载的是环境变量中的配置。

验证结果

(暂无)