深色模式
自动更新
Reeve 内置 tauri-plugin-updater，启动时检测新版本并提示更新。增量更新签名验证，安全可靠。
进入
主界面 → 设置 → 自动更新 卡片。
检查频率
| 选项 | 行为 |
|---|---|
| 启动时 | 每次启动都检查（默认） |
| 每天 | 启动后每 24 小时检查 |
| 关闭 | 不自动检查；手动 立即检查 触发 |
更新流程
- 启动 → 拉取
versions.json（gitee.com / 自定义 CDN） - 对比当前版本 → 发现新版
- 弹窗提示："Reeve x.y.z 可用，是否更新？"
- 用户点 更新：
- 下载新版安装包
- 签名验证（minisign 公钥在
tauri.conf.json） - 清理上一版 sidecar 进程（避免文件锁）
- 启动安装程序
- Reeve 退出
- 安装完成后用户手动启动
签名验证
每个发布包都有 minisign 签名（.sig 文件）：
- 公钥嵌入 Reeve 二进制（编译时配
tauri.conf.json） - 下载后用公钥验签
- 验签失败 → 拒绝安装 + 告警
- 防止中间人推送恶意更新包
手动检查
设置卡片 立即检查 按钮：
- 立即拉
versions.json - 显示当前版本 vs 最新版本
- 有新版本则弹更新窗
离线模式
未来计划：
- 关闭"启动时检查"
- 手动下载安装包覆盖安装
- 配置 / 凭据 / 审计 / 项目数据全部保留
暂时跳过某个版本
更新弹窗 跳过此版本 按钮：
- 记录被跳过的版本号
- 下次同版本不再提示
- 更高版本仍会提示
退回旧版
未官方支持，但你可以：
- 从 GitHub / Gitee 拿旧版安装包
- 手动覆盖安装
- 数据库 schema 向前兼容（旧版可读新数据库，但可能丢新功能字段）
不推荐回退（可能丢失新功能 + 数据），生产使用建议先备份数据目录。
数据保留
更新 / 覆盖安装时保留：
<app data>/com.agilefr.reeve/reeve.db<app data>/com.agilefr.reeve/mcp-rpc.json<app data>/com.agilefr.reeve/redaction.yaml- OS keyring 里的 DEK / Wrapped DEK
- 项目空间
.reeve/完全独立保留
只覆盖：
- 应用二进制 + sidecar
- 内置技能 SKILL.md（项目级 / 用户级技能不动）
故障排查
| 症状 | 排查 |
|---|---|
| 一直检查不到新版 | 网络问题；试手动从 下载页 拉 |
| 验签失败 | 公钥可能损坏；从官方渠道重下载 |
| 安装提示"文件被占用" | sidecar 没清理干净；手动 kill reeve-mcp.exe |
| 安装后启动失败 | 凭据库可能损坏；查 <app data>/logs/ |