深色模式
常见问题
安装与启动
Windows 提示"未知发布者"
Reeve 暂未加 EV 代码签名。SmartScreen 警告点 更多信息 → 仍要运行 即可。后续版本会加签名。
macOS 提示"已损坏，无法打开"
Gatekeeper 拦了。在终端：
bash
xattr -dr com.apple.quarantine /Applications/Reeve.appLinux 启动报缺 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）。
SSH 连接
连不上服务器
按顺序检查：
- 主机 / 端口是否正确（防火墙、安全组）
- 用户名 / 密码 / 私钥是否正确
- 服务器
/etc/ssh/sshd_config是否允许该认证方式 - 主机指纹是否一致（重装服务器需重置）
中文文件名 / 终端乱码
远端 locale 设 UTF-8：
bash
# 临时
export LANG=zh_CN.UTF-8
# 或 en_US.UTF-8
# 永久（写 ~/.bashrc）
echo 'export LANG=zh_CN.UTF-8' >> ~/.bashrcTOFU 主机指纹不一致
弹窗说"主机公钥与上次记录不一致"——可能：
- 你重装了服务器 → 重置主机指纹
- 真的有中间人攻击 → 别连，先排查网络
SFTP 上传超大文件慢
russh 单线程实现。≥ 几 GB 的文件建议用 rsync -P 或服务器侧 wget。
AI 与 MCP
Claude Code 找不到 Reeve 工具
按顺序检查：
- Reeve 主 App 在运行（最小化也可，但不能完全退出）
- 主密码已解锁（锁定时拒所有 MCP 调用）
- Claude Code 配置文件含
reeveMCP server - 配置里的
command路径指向当前 Reeve 安装目录的reeve-mcp.exe - 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 命令），不阻塞主线程。
MySQL 连不上 localhost
如果用 端口转发 隧道：
- 凭据 host 填
127.0.0.1:<隧道本地端口> - 不是远端真实 host
项目空间
.mcp.json 没被 Claude Code 发现
- 确保在项目目录里启动 Claude Code（cd 进去）
- Claude Code 重启
- 检查
.mcp.jsonJSON 语法
项目级技能不生效
- 文件在
<project>/.claude/skills/<name>/SKILL.md - frontmatter 含
name/triggers - 技能页 工具栏 测试触发 验证
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 欢迎。