AI API Profile

如果你想用 Reeve 自带的 AI 桥接对话（而不是只把 Reeve 当 MCP server 接到外部客户端），需要配 AI API Profile。

进入

主界面 → 设置 → AI API Profiles 卡片。

多 Profile 并存

可以同时配多个 Profile，对话页顶部切换：

• Profile A：Claude Sonnet 用日常对话
• Profile B：GPT-4o 用特定场景
• Profile C：DeepSeek 用成本敏感场景

API Key 加密存在 keyring，不写明文配置文件。

添加 Profile

右上 新建 Profile → 选提供商：

Anthropic 官方

字段	说明
Profile 名	自取，如 Claude Sonnet 4.6
API Key	sk-ant-xxx
Base URL	默认 https://api.anthropic.com，可改
默认模型	claude-sonnet-4-6 / claude-opus-4-7
Max Tokens	默认 8192

OpenAI 兼容

字段	说明
Profile 名	自取
Base URL	https://api.openai.com/v1 / https://api.deepseek.com/v1 / 等
API Key	sk-xxx
默认模型	gpt-4o / deepseek-chat 等

支持的兼容服务商：

• OpenAI
• DeepSeek
• Groq
• Kimi（月之暗面）
• 智谱 GLM
• 阿里通义
• 任意自定义 OpenAI 兼容端点

Claude Code / Codex 桌面客户端（实验）

如果本机已装 Claude Code CLI / Codex，可以让 Reeve 通过 IPC 调它们的会话引擎：

• 不消耗 API Key 配额（用 CC/Codex 的订阅）
• 但功能受 CC/Codex 限制
• 实验性，可能不稳

测试连接

Profile 卡片 测试 按钮：

• 发一个简短 prompt（reply "ok"）
• 验证 API Key / Base URL / 模型可用
• 返回延迟 + token 用量

粘贴 ai.profile 自动识别

如果你已经在其它工具（如 tauri-cc）有 ai.profile 格式的配置文件：

• 右上 导入 按钮 → 粘贴 JSON
• 自动识别 provider / model / key
• 回填字段

默认 Profile

设置某个 Profile 为默认 → 启动 AI 桥接 时自动选这个。

删除 Profile

卡片 删除 按钮：

• API Key 从 keyring 移除
• 历史对话保留（记录用过的 Profile 名）

API Key 安全

• AES-GCM 加密 + keyring 存储（同凭据库 DEK）
• 主密码锁定时无法读
• UI 显示永远是 sk-***（脱敏）
• 不会通过 MCP 协议泄漏给外部 AI 客户端（这是 Reeve 自己用的）

模型选择建议

用途	模型推荐
全功能运维助手	Claude Sonnet 4.6 / Opus 4.7
成本敏感日常	DeepSeek-Chat / Kimi
长上下文文档分析	Claude 1M / GPT-4o
快速回应	Groq + Llama

与外部 AI 客户端共存

Reeve 的 API Profile 仅给内置 AI 桥接用。外部客户端（Claude Code / Cursor 等）通过 MCP 接入 用各自的 API Key，互不影响。

故障排查

症状	排查
测试连接失败	检查 Base URL（结尾是否带 /v1）
模型回报 not found	默认模型字段写错；查提供商文档
中文乱码	确保 Base URL 用 HTTPS
工具调用模型不支持	换 Claude / GPT-4o 等支持 tool use 的

下一步

• AI 桥接对话
• MCP 接入八大客户端