凭据托管与密钥路由机制（Key Source Routing）
在 Nimi 中，所有涉及第三方云端 AI 模型供应商的 API 密钥与认证凭据，均由本地 Runtime 统一安全托管。应用代码仅需持有安全的连接器引用（connectorRef），无需也不应在前端业务代码中直接硬编码或传递任何明文密钥。
请求链路中的凭据路由流程
- 会话校验：应用发起 AI 生成请求，Runtime 通过宿主会话验证应用身份与调用权限；
- 连接器解析：根据该应用在 AIConfig 中绑定的
connectorRef，从受保护的本地存储中解析出对应的目标服务商凭据； - 驱动封装与外发：Runtime 的执行驱动（Driver）将用户提示词与密钥组装为符合服务商规范的安全请求并外发；
- 结果剥离与返回：收到云端回复后，系统将服务商专有的 Header、原始凭据及敏感路由信息彻底剥离，仅将纯净的内容数据流返回给前端应用。
这种由 Runtime 集中托管并按符号透明路由的设计，不仅杜绝了密钥在客户端意外暴露的风险，也让应用在切换底层模型服务商时无需改动任何代码。
连接器的配置与凭据维护
- 配置入口：用户在 Nimi Home 的「云服务」设置中录入或修改各个服务商的 API 密钥。在应用的 AI 设置中，只需下拉选择对应的连接器即可完成绑定。
- 凭据轮换与失效恢复：若 API 密钥过期、重置或额度耗尽，只需在「云服务」中更新对应连接器的密钥，后续准入的请求即可使用更新后的凭据，无需逐一修改 App 的连接器引用；已有任务仍遵循提交时捕获的执行上下文。