模型与 Provider
wesclaw 支持多种 LLM 模型来源，你可以灵活选择最适合自己的方案。
三种模型来源
| 来源 | 标识 | 说明 |
|---|---|---|
| WES 平台 | wes: | 使用 weisyn 平台额度，开箱即用 |
| 组织托管 | org: | 企业统一部署的模型池 |
| 自带 Key | byok: | 使用你自己的 API Key（BYOK） |
WES 平台额度
注册 weisyn 账号后自动获得 WES 额度。无需配置 API Key，直接使用平台提供的模型。余额不足时，wesclaw 会提示你充值或切换到自带 Key。
自带 Key（BYOK）
在设置中添加你的 API Key：
- 打开 设置 → 模型管理
- 点击 添加 Provider
- 选择 Provider 类型（OpenAI / Anthropic / DeepSeek 等）
- 填入 API Key 和 Base URL
- 保存后在模型选择器中即可使用
支持的 Provider 类型：
| Provider | 典型模型 | 特点 |
|---|---|---|
| OpenAI | GPT-4o、o1 | 全能型，视觉和工具调用 |
| Anthropic | Claude 4 Opus/Sonnet | 长上下文、精确推理 |
| DeepSeek | DeepSeek V4 | 性价比高，代码能力强 |
| 本地部署 | Ollama / vLLM | 数据不出本机 |
组织托管
企业部署时，管理员配置组织级 Provider 池。团队成员使用 org: 前缀的模型，费用由组织统一结算。
模型选择
在对话窗口底部的模型选择器中切换模型：
- 所有可用模型都会显示在选择器中
- 模型按来源标注（WES / BYOK / 组织）
- WES 欠费时，WES 模型会标记为不可用
欠费行为
当 WES 余额不足时：
| 场景 | 行为 |
|---|---|
| 有 BYOK 且选中 BYOK 模型 | 正常发送，无提示 |
| 有 BYOK 但选中 WES 模型 | 提示切换到 BYOK |
| 无 BYOK | 阻断发送，引导充值或配置 BYOK |
Fallback 机制
wesclaw 支持 Provider 自动 Fallback：
- 首选 Provider 请求失败（如 API 超时、余额不足）
- 引擎自动 Fallback 到次选 Provider
- 对话不中断，用户无感知
Fallback 的优先级由 ProviderStrategy 决定：
| 策略 | 行为 |
|---|---|
own_only | 仅使用自带 Key |
shared_only | 仅使用平台 Provider |
own_first | 优先自带 Key，Fallback 到平台 |
shared_first | 优先平台，Fallback 到自带 Key |
密钥安全
- API Key 经 AES-256-GCM 加密后存储
- 密钥文件与加密文件分离存储
- 子进程环境变量不包含 API Key
- 导出/分享时自动脱敏