Reeve

深色模式

常见问题 ​

安装与启动 ​

Windows 提示"未知发布者" ​

Reeve 暂未加 EV 代码签名。SmartScreen 警告点 更多信息 → 仍要运行 即可。后续版本会加签名。

macOS 提示"已损坏，无法打开" ​

Gatekeeper 拦了。在终端：

bash
xattr -dr com.apple.quarantine /Applications/Reeve.app

Linux 启动报缺 WebKitGTK ​

bash
# Ubuntu / Debian
sudo apt install libwebkit2gtk-4.1-0 libsoup-3.0-0

# Fedora
sudo dnf install webkit2gtk4.1 libsoup3

启动后一片空白 ​

清缓存重启：

bash
# Windows
Remove-Item -Recurse -Force $env:APPDATA\com.agilefr.reeve\webview-cache

# macOS
rm -rf ~/Library/Caches/com.agilefr.reeve

# Linux
rm -rf ~/.cache/com.agilefr.reeve

凭据与主密码 ​

主密码忘了 ​

没有恢复机制——这是设计。重置凭据库（凭据加密）后所有 SSH/DB 凭据丢失，需要重新添加。

Reveal 一直失败 ​

主密码可能锁了。先解锁（输入主密码或回到 UnlockScreen）。

复制后剪贴板里是空的 ​

10 秒自清生效了。重新 Reveal。

凭据数据库存在哪里 ​

<app data>/com.agilefr.reeve/reeve.db，AES-256-GCM 加密。DEK 在 OS keyring（macOS Keychain / Windows Credential Manager / Linux Secret Service）。

突然报"解密失败（密钥不匹配或密文损坏）" ​

原本好好的，某天打开终端弹这句——钥匙串里的主密钥已经不是当初加密时那把了，旧密文再也解不开。Reeve 发现钥匙串里没有条目时会按"首次启动"重新生成一把，所以界面一切正常，只在用到凭据时才暴露。重装 Reeve、重启电脑都不会有任何改善，别白折腾。

常见成因（都发生在 Reeve 之外）：

  • 系统清理 / 优化软件清空了 Windows 凭据管理器里的保存项
  • 重装系统，或更换 / 重置了系统登录账户（DPAPI 主密钥失效，凭据读不出来）
  • 把 reeve.db 直接拷到另一台电脑或另一个账户下使用——密文搬得走，钥匙搬不走
  • 手动删掉过钥匙串里 com.agilefr.reeve 的条目

怎么恢复（二选一）：

  1. 有 .reevebak 备份 → 设置 → 备份 / 还原 导入，一次全部恢复。备份包用的是你自己设的备份密码，与本机主密钥无关，可跨电脑。
  2. 没有备份 → 逐条重新录入。服务器密码、密钥库、AI API Key、通知渠道、备份存储密码、证书 / DNS 账号、敏感库条目，凡是加密存的都要重来；重新保存时会用当前主密钥重新加密，立刻可用。

两个别做：别再删钥匙串里 Reeve 的条目（那是现在唯一还能用的钥匙），别再拿旧电脑的 reeve.db 覆盖过来。换电脑请走备份 / 还原。

自查：设置 → 主密码 → 检查凭据可用性，会逐条试解并列出需要重录的项。有解不开的条目时，启动后也会自动弹出这个说明。

SSH 连接 ​

连不上服务器 ​

按顺序检查：

  1. 主机 / 端口是否正确（防火墙、安全组）
  2. 用户名 / 密码 / 私钥是否正确
  3. 服务器 /etc/ssh/sshd_config 是否允许该认证方式
  4. 主机指纹是否一致（重装服务器需重置）

中文文件名 / 终端乱码 ​

远端 locale 设 UTF-8：

bash
# 临时
export LANG=zh_CN.UTF-8
# 或 en_US.UTF-8

# 永久（写 ~/.bashrc）
echo 'export LANG=zh_CN.UTF-8' >> ~/.bashrc

TOFU 主机指纹不一致 ​

弹窗说"主机公钥与上次记录不一致"——可能：

  1. 你重装了服务器 → 重置主机指纹
  2. 真的有中间人攻击 → 别连，先排查网络

SFTP 上传超大文件慢 ​

russh 单线程实现。≥ 几 GB 的文件建议用 rsync -P 或服务器侧 wget。

AI 与 MCP ​

Claude Code 找不到 Reeve 工具 ​

按顺序检查：

  1. Reeve 主 App 在运行（最小化也可，但不能完全退出）
  2. 主密码已解锁（锁定时拒所有 MCP 调用）
  3. Claude Code 配置文件含 reeve MCP server
  4. 配置里的 command 路径指向当前 Reeve 安装目录的 reeve-mcp.exe
  5. Token 没被删除

重新接入：MCP 接入 页删 Token + 重新生成。

AI 一直说"权限不足" ​

服务器档位可能是 Disabled / Readonly：

  • 看 AI 五档策略 确认档位含义
  • 改服务器档位
  • 或加 sudo 白名单 / 危险黑名单调整

审批弹窗没出现 ​

档位可能是 Trusted（自动放行）：

  • 改成 Approval / Allowlist
  • 含 sudo 永远强制审批

AI 看到 [REDACTED:xxx] 反复尝试 ​

提示 AI："这是 Reeve 的出口脱敏，你看到的是正常的，真值在我的本地敏感库里。请继续。"

或者：在 AI 系统 prompt 里说明 Reeve 脱敏机制。

工具调用超时 ​

可能是审批队列堆积（审批 页看一下）。或网络问题导致 SSH 命令超时。

多个 AI 客户端共用一个 Token 吗 ​

不推荐。每个客户端 / 每个用途单独签发 Token，方便单独撤销。

数据库与 Redis ​

db_query 返回了 LIMIT 100 ​

默认行数限制。在工具参数加 limit：

db_query(server="my-db", sql="SELECT * FROM users", limit=1000)

但不建议太大，避免 LLM 上下文爆炸。

Redis KEYS * 警告 ​

KEYS 在生产 Redis 上性能危险。Reeve 推荐用 redis_scan（SCAN 命令），不阻塞主线程。

报 1045 Access denied，@ 后面是服务器的公网 IP ​

形如 Access denied for user 'app'@'1.2.3.4'，1.2.3.4 正是数据库所在服务器自己的公网 IP。

原因：连接的归属选了这台服务器，Reeve 默认经它的 SSH 隧道连接，主机是站在服务器上解析的。主机填了服务器自己的公网 IP，连接就从服务器绕到公网再连回自己，数据库看到的来源成了公网 IP，只授权了本机访问的账号就会被拒。

解决：编辑连接，主机改成 127.0.0.1，端口填数据库实际监听的端口，保持隧道开关打开。详见经服务器 SSH 隧道连接。

报「连接被对端断开」或「隧道目标连不上」 ​

经隧道连接时出现 expected to read 4 bytes, got 0 bytes at EOF 这类报错，最常见的原因是端口填错了：SSH 是通的，但服务器上那个端口没有服务在监听。

在服务器终端里查数据库实际监听的地址和端口：

bash
ss -tlnp | grep -E 'mysql|postgres|redis|mongo|:3306|:5432|:6379'

按查到的端口编辑连接即可。数据库跑在 Docker 里时，填宿主机映射出来的端口，并确认容器正在运行。

v2.5.0 之后发布的版本会直接报「隧道目标连不上：服务器上连不上 127.0.0.1:xxxx」，不再笼统地说连接被断开。

主机填 127.0.0.1 却连不上 ​

先看隧道开关：

  • 开着隧道：127.0.0.1 指的是那台服务器本身，数据库要在服务器上监听这个端口
  • 关着隧道（或归属选了「本机 / 本地」）：127.0.0.1 指的是你这台电脑，连的是你电脑上的数据库

要连服务器上只监听本机的数据库，归属选那台服务器并打开隧道。如果是自己在 端口转发 页建的隧道，则归属选「本机 / 本地」、主机填 127.0.0.1、端口填隧道的本地端口。

知识库（技能 / 经验 / Runbook） ​

我配的技能不生效 ​

  1. 在技能页新建 user 技能（与内置 builtin 两级合并）
  2. frontmatter 含 name / triggers，触发词够精准
  3. 工具栏 测试触发 验证能否命中

「项目空间」已下线

如果你看过旧文档里「打开目录 = 项目空间」「.mcp.json / 项目级技能」的说法——那套机制已经下线。现在技能 / 经验 / Runbook / 聊天历史全存 Reeve 全局库，与目录无关；外置客户端接入改走 MCP 接入中心。

Runbook 卡住不前进 ​

查 审批 队列有没有等待中。

性能 ​

Reeve 启动慢 ​

首次启动 Argon2id 派生 KEK 需 1-2 秒。后续启动同样的时间（设计如此，防爆破）。

大批量执行慢 ​

并行模式不够大 → 在批量执行页改 "并行度" 或换 Rolling 模式。

终端卡顿 ​

xterm.js 在巨量输出时（如 cat 大文件）会卡。用 tail -100 / head -100 限制输出。

其它 ​

数据可以同步到云端吗 ​

Reeve 当前不内置同步。手动备份 <app data>/com.agilefr.reeve/ 即可，注意加密。

多人团队怎么共用 ​

每人独立安装 Reeve，独立配凭据。.claude/skills/ 和 .reeve/runbooks/ 可以 git 提交团队共享。

跟 SecureCRT / Termius 比怎么样 ​

  • 优势：开源、本地、内置 MCP、有 AI 安全策略
  • 短板：暂没 Telnet / Serial / Mosh、没移动端、没 Cloud Sync

怎么贡献 / 反馈 ​

详见仓库 README。Issues / PR 欢迎。

还没解决？ ​

  • 翻一下 安全模型 看是不是某层策略导致
  • 查 审计 看决策记录
  • 看 <app data>/com.agilefr.reeve/logs/ 应用日志
  • 到仓库提 Issue（附日志、复现步骤）

最后更新:

若依科技工作室 · 承接后台管理 / 桌面软件 / 全栈 / 小程序定制开发 · 技术服务咨询

© 2026 抓蛙师（若依科技工作室）| 项目咨询：198 6657 9313 / 微信 QQ 770492966