Provider 与模型
接入模型 Provider,并理解 Provider 配置与模型选择在系统中的位置。
KCode 把模型接入和模型选择作为独立的一层,而不是散落在每个页面或每次请求里。这样做的目标是让 Provider、鉴权信息和模型选择可以被统一管理,而不是跟某个具体 Session 强绑定。
什么时候应该先检查 Provider
如果本地服务已经跑起来,但无法正常发起模型请求,优先检查:
- 你是否已经接入至少一个 Provider。
- 当前模型是否和该 Provider 匹配。
- 当前运行环境里是否存在必要的鉴权信息。
为什么 Provider 和模型要分开理解
对外使用时,最好把它拆成两步:
- 接入哪个 Provider。
- 当前会话选择哪个模型。
这样你在排查问题时会更清楚,到底是账号和鉴权问题,还是模型选择问题。
KCode 里 Provider 层负责什么
仓库内部有独立的 domains/provider,用于描述:
- Provider 列表
- 鉴权信息
- 模型选择
- 运行时 Provider 配置映射
这说明 Provider 更接近运行时能力配置,而不是项目目录的一部分。
使用建议
- 先接入一个稳定可用的 Provider,再开始试不同模型。
- 把模型切换看成运行参数,而不是项目结构的一部分。
- 团队共享使用方式时,优先记录 Provider 与模型约定,而不是只保存某次 prompt。