Provider 配置
WesCraft 支持灵活的 AI 模型 Provider 配置，你可以使用平台提供的模型，也可以接入自己的 API Key（BYOK）。
Provider 策略
WesCraft 基于 wesgine 引擎的 Provider 四模式体系，根据部署场景选择不同策略：
| 策略 | 说明 | 适用场景 |
|---|---|---|
own_only | 仅使用个人配置的 Provider | 个人版默认，数据完全自主 |
shared_only | 仅使用平台共享 Provider | 企业统一管理 |
own_first | 优先用个人的，不可用时回退到共享 | 个人为主、平台兜底 |
shared_first | 优先用共享的，不可用时回退到个人 | 成本优化 |
个人版默认 own_only——所有请求使用你自己配置的 API Key，数据不经过平台。
BYOK（Bring Your Own Key）配置
添加 Provider
- 打开「设置 → AI 模型」
- 点击「添加 Provider」
- 填写以下信息：
- 名称：自定义名称，如
my-openai - 类型：OpenAI / Azure OpenAI / Anthropic / DeepSeek / 本地部署等
- Base URL：API 地址
- API Key：通过 SecretRef 安全存储
- 模型列表：声明该 Provider 提供的模型
- 名称：自定义名称，如
支持的 Provider 类型
- OpenAI：GPT 系列
- Azure OpenAI：Azure 部署的 OpenAI 模型
- Anthropic：Claude 系列
- DeepSeek：DeepSeek 系列
- Ollama / vLLM：本地部署的开源模型
SecretRef 密钥管理
API Key 通过 SecretRef 机制安全存储，支持三种来源：
| 来源 | 说明 | 适用场景 |
|---|---|---|
inline | 加密存储在本地数据库 | 个人版默认 |
env | 从环境变量读取 | CI/CD 或服务端部署 |
live | 运行时动态获取 | 平台托管的 WES/Org 模型 |
inline 方式的密钥经 AES-256-GCM 加密后存储，密钥文件与数据库分离，拷走数据库不带密钥则 Provider 失效。
模型选择与切换
在对话中切换模型
- 对话输入框底部的模型选择器显示所有可用模型
- 按来源标注：平台模型 / BYOK 模型
- 切换模型即时生效，下一条消息使用新模型
模型能力声明
配置 Provider 时建议声明每个模型的能力：
- ContextWindow：上下文窗口大小（必填，影响压缩策略）
- SupportsVision：是否支持图片理解
- MaxOutputTokens：最大输出 token 数
提示：如果使用 weisyn 平台的 catalog，模型能力会自动补齐，无需手动配置。
本地部署模型
对于 Ollama、vLLM 等本地部署的模型：
- 确保模型服务在本地运行
- 在 Provider 配置中填写本地地址（如
http://localhost:11434） - 手动声明
ContextWindow（本地模型不在 catalog 中） - 建议使用
own_only策略，避免数据外传
相关文档
- 快速开始 →
quickstart.md - 设置 →
settings.md - AI 交互模式 →
ai-interaction.md - 数据安全 →
data-security.md