深色模式
AI 桥接对话
Reeve 内置一个完整的对话页 —— 你可以不依赖外部 AI 客户端,直接在 Reeve 里跟 Claude / GPT 等对话,并让模型调用 Reeve 工具。
进入
主界面左侧导航 → AI 桥接(机器人图标)。
前置条件
- ✅ 至少添加一个 API Profile
- ✅ 至少添加一台 服务器
- ✅ 在 MCP 接入 页签发过 Token(或 AI 桥接页内置 Token 自动签发)
布局
┌────────────────────────────────────────────────┐
│ ⚙️ API Profile 切换 │ 模型选择 │ 新建对话 │
├────────────────────────────────────────────────┤
│ │
│ 对话内容(Markdown 渲染) │
│ │
│ ┌──────────────────────────────────────┐ │
│ │ 你:用 my-vps 查一下磁盘使用率 │ │
│ └──────────────────────────────────────┘ │
│ │
│ ┌──────────────────────────────────────┐ │
│ │ AI:[调用 disk_usage(server=my-vps)] │ │
│ │ 根目录已用 67%... │ │
│ └──────────────────────────────────────┘ │
│ │
├────────────────────────────────────────────────┤
│ 输入框 │ 发送 │ 上下文长度统计 │
└────────────────────────────────────────────────┘支持的模型
通过 API Profile 接入:
| 提供商 | 模型示例 | 说明 |
|---|---|---|
| Anthropic | Claude Sonnet 4.6 / Opus 4.7 | 官方 API |
| OpenAI 兼容 | GPT-4o / DeepSeek / Kimi / 智谱 / Groq | Base URL 可改 |
| 自定义 | 任意 OpenAI 兼容端点 | 自填 URL + API Key |
| Codex / Claude Code 桌面 | 走对应客户端 SDK | 实验性 |
工具调用
模型可以调用所有 MCP 工具:
元工具(任何档位放行)
list_servers/list_skills/list_runbooksrecall_experience
只读工具
system_info/disk_usage/service_statusport_check/tail_logsftp_list/sftp_readdb_query/redis_scan/redis_get
改动工具
ssh_exec/ssh_exec_script/ssh_exec_multisftp_write/db_execute/db_transactionredis_set/redis_del/redis_execinstall_with_secret
实时审批
如果服务器策略是 Approval 或 Allowlist,AI 工具调用时直接在对话流里弹审批小卡片:
┌─────────────────────────────────────┐
│ 🛡️ AI 想调用 ssh_exec │
│ 服务器: prod-web │
│ 命令: systemctl restart nginx │
│ │
│ [✅ 放行] [❌ 拒绝] [⏭️ 跳过] │
└─────────────────────────────────────┘5 分钟未决策自动拒绝。
危险拦截
危险命令(rm -rf / / DROP DATABASE 等)直接拒绝,不弹审批,对话中显示:
❌ 命令被永久黑名单拦截:rm -rf /
原因:matches lethal pattern "rm -rf /*"
写入审计:blocked自动脱敏
AI 看到的工具返回值经过脱敏规则:
[原始] mysql root password is: Sup3rS3cr3t!@#
[AI 看到] mysql root password is: [REDACTED:mysql_root_password]明文 AES-GCM 加密入 敏感库,你可以后续 Reveal / 转凭据。
技能自动评估
输入消息时,Reeve 会自动跑 evaluate_skills:
- 按你的话匹配 技能库
- 命中技能拼入 system prompt
- AI 自动遵循该技能的指引
例如你输入「nginx 重启失败」→ 自动匹配 nginx-status 技能 → AI 拿到正确排查步骤。
多会话管理
- 顶部 新建对话 按钮
- 左侧(项目模式下)会话列表
- 每个会话独立持久化为
<project>/.reeve/chats/<id>.json(项目模式)或全局位置(非项目模式) - 历史会话点击恢复
API Profile 切换
顶部 ⚙️ 齿轮 → 多 Profile 切换:
- Profile A:Claude Sonnet(日常对话)
- Profile B:GPT-4o(特定场景对比)
- Profile C:DeepSeek(成本优化)
每条对话标记用的 Profile,方便回顾。
内置 vs 外置 AI 客户端
| 场景 | 推荐 |
|---|---|
| 在 Reeve 里直接对话 + 工具调用 | 内置 AI 桥接 |
| 在 Claude Code / Cursor / Cline 里用 Reeve 工具 | MCP 接入 外置 |
| 既要外置 AI 编程能力又要 Reeve 工具 | 两者并行,互不冲突 |
安全特性
- 对话历史本地持久化,不上传任何服务器
- 上下文窗口管理:超过模型 limit 时警告而非自动截断
- API Key 保存到 keyring(不在本地配置文件)
- 工具调用走完整 AI policy 引擎(与外置客户端一致)
故障排查
| 症状 | 排查 |
|---|---|
| API 错误 | 检查 API Profile 的 Key 和 Base URL |
| 工具不被调用 | 模型可能不支持 tool use,换 Claude / GPT-4o |
| 审批没弹出 | 检查服务器策略档位是否 Approval / Allowlist |
| 响应慢 | 上下文太长,新建对话 |