Skip to content

AI 桥接对话

Reeve 内置一个完整的对话页 —— 你可以不依赖外部 AI 客户端,直接在 Reeve 里跟 Claude / GPT 等对话,并让模型调用 Reeve 工具。

进入

主界面左侧导航 → AI 桥接(机器人图标)。

前置条件

  1. ✅ 至少添加一个 API Profile
  2. ✅ 至少添加一台 服务器
  3. ✅ 在 MCP 接入 页签发过 Token(或 AI 桥接页内置 Token 自动签发)

布局

┌────────────────────────────────────────────────┐
│  ⚙️ API Profile 切换 │ 模型选择 │ 新建对话      │
├────────────────────────────────────────────────┤
│                                                │
│  对话内容(Markdown 渲染)                      │
│                                                │
│  ┌──────────────────────────────────────┐      │
│  │ 你:用 my-vps 查一下磁盘使用率        │      │
│  └──────────────────────────────────────┘      │
│                                                │
│  ┌──────────────────────────────────────┐      │
│  │ AI:[调用 disk_usage(server=my-vps)] │      │
│  │     根目录已用 67%...                 │      │
│  └──────────────────────────────────────┘      │
│                                                │
├────────────────────────────────────────────────┤
│  输入框 │ 发送 │ 上下文长度统计               │
└────────────────────────────────────────────────┘

支持的模型

通过 API Profile 接入:

提供商模型示例说明
AnthropicClaude Sonnet 4.6 / Opus 4.7官方 API
OpenAI 兼容GPT-4o / DeepSeek / Kimi / 智谱 / GroqBase URL 可改
自定义任意 OpenAI 兼容端点自填 URL + API Key
Codex / Claude Code 桌面走对应客户端 SDK实验性

工具调用

模型可以调用所有 MCP 工具

元工具(任何档位放行)

  • list_servers / list_skills / list_runbooks
  • recall_experience

只读工具

  • system_info / disk_usage / service_status
  • port_check / tail_log
  • sftp_list / sftp_read
  • db_query / redis_scan / redis_get

改动工具

  • ssh_exec / ssh_exec_script / ssh_exec_multi
  • sftp_write / db_execute / db_transaction
  • redis_set / redis_del / redis_exec
  • install_with_secret

实时审批

如果服务器策略是 ApprovalAllowlist,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
响应慢上下文太长,新建对话

下一步

受控的远程运维助手 — 让 AI 安全地帮你管服务器