系统
「设置 → 系统」管的是应用本身:升级、开机自启、网络代理、语言、数据与同步,以及上下文索引。
副标题:「管理应用升级、开机自启、网络代理与语言偏好。」
软件更新
显示当前版本,以及一个会随生命周期改名的按钮:
| 按钮文字 | 什么时候 |
|---|---|
| 检查更新 | 空闲,还不知道有没有新版 |
| 检查中... | 正在查(禁用) |
| 升级到 v{x} | 有新版且能原地安装(桌面端,或支持实时进度协议的服务器) |
| 查看 v{x} 发布 | 有新版但不能原地安装,点开 GitHub 的 Releases 页 |
| 升级中... | 正在装(禁用) |
| 重启以更新 | 下载完成,等你重启 |
它和工作区状态栏用的是同一套更新状态,所以打开这一页通常不会触发第二次检查——除非从来没查过,或上次查失败了。
进度与状态行:上次检查时间、「当前已经是最新版本」、下载进度(带字节计数和进度条)、「新版本已下载,重启以完成更新。」、「将在 {n} 秒后重启...」、「正在等待服务恢复...」。有新版时还会展开版本号、发布日期和发布说明。
Docker 部署下会多一条提醒:
现在升级的是正在运行的容器。容器一旦被重建即丢失——如需保留,请拉取或构建新版本镜像后重建容器。
错误
失败会显示「更新异常:{message}」,并按类型归类:发布源不可用、网络问题、下载失败、安装失败、权限不足(带路径)、目标写入失败、未知。
我要反馈
一条链接按钮,打开预填好的 GitHub Issue——正文自动带上你的版本和平台信息。这一行存在的原因很实际:原生「帮助」菜单只有 macOS 发布版才有。
开机自启(仅本机桌面端)
只在 Tauri 桌面外壳且没有连接远程工作区时出现——浏览器里没有,指向远端服务器的桌面窗口里也没有。
一个开关,默认关闭:「登录这台电脑后自动启动,无需每次手动打开。」
开关跟随操作系统报告的结果,不是你点下去的乐观值——Windows 可能拒绝写注册表启动项。读不到状态时这一行仍在,但变成不可操作,并提示「无法读取本机的开机自启状态:{message}」。
网络代理
开启后,后续网络请求将优先走该代理(包括 ACP 对话、Agent 安装、Git 远程操作等)。
-
启用系统代理 — 复选框,默认关闭。地址为空时拒绝打开,提示「启用代理时必须填写代理地址」。勾选即保存。
-
代理地址 — 支持
http(s)和socks5,示例http://127.0.0.1:7890。失焦保存。 -
不走代理的地址 — 失焦保存。规则:
多个地址用英文逗号
,分隔,不加空格。example.com匹配该域名,.example.com匹配它的所有子域名,也可以填 IP。本机地址localhost,127.0.0.1,::1始终直连,不用填。这个列表以环境变量NO_PROXY的形式传给子进程。
这一节自动保存,没有保存按钮。加载失败会在上方挂一条「加载失败:{message}」。
内置浏览器的标签页也用这个代理,但那一屏只能看不能改,并且有平台限制(macOS 14+、仅 http/socks5)。
语言
设置应用语言。跟随系统时,若系统语言不受支持将回退为英文。
一个下拉框,11 个选项:跟随系统,加英语、简体中文、繁體中文、日语、韩语、西班牙语、德语、法语、葡萄牙语、阿拉伯语。
改完立即生效,不用重启。
数据与同步
一张卡片,三个页签。副标题点明了分工:
「配置同步」在设备之间搬运设置;「备份」打包这台设备上的全部 Croli 数据。
三个页签的内容都会在打开页面时一起加载,默认停在「配置同步」。
配置同步
同步范围可以展开看,分两列:
| 包含 | 不包含 |
|---|---|
| 模型服务商(含 API 密钥) | 会话记录与历史 |
| 智能体设置 | 上传的文件与图片 |
| 自定义智能体 | 工作区项目与路径 |
| 快捷消息 | MCP 服务器(归各 CLI 自己管) |
| 任务模板 | 登录凭据与令牌 |
| 应用偏好(语言、外观、开关) |
配置文件一节有两个按钮:导出到文件 / 从文件导入。导出是单个 JSON 文件,可以拷到另一台设备。导入时按条目新增或更新——文件里没有的本地条目会保留,不会被清掉。
撤销导入是个弹出面板:每次导入和每次还原之前,Croli 都会先把这台设备当时的配置存一份,最近十份留着。每份快照旁边一个「撤销」按钮。
备份
把这台设备的 Croli 数据(数据库与上传文件)打包成一个归档文件。
- 包含会话内容 — 开关。同时打包各 CLI 的会话记录(Claude、Codex、Gemini 等),体积会大很多。
- 口令(可选) — 留空则生成未加密的归档;填了要再确认一遍,两次不一致会报错。
- 两条警告按情况出现:未加密时「该备份将以明文包含密钥(API key、token)。请妥善保管。」;加密时「将使用此口令加密。口令一旦丢失,备份将无法恢复。」
- 导出备份 带可取消的进度。SQLite 状态不理想时会附一份降级报告。
恢复
用备份归档中的内容替换这台设备当前的 Croli 数据。
选择备份文件 → 加密归档会要求输入口令并点解锁 → 显示预览(是否加密、是否兼容、创建时间、应用版本)。
会话内容是个下拉:不恢复 / 恢复到安全的旁路目录 / 恢复到 CLI 的原始位置。选后两者会扫描冲突,并提供「覆盖已存在的文件」开关。
两条警告:
- 恢复将替换当前全部 croli 数据(数据库与上传文件)。当前数据会先做快照以便回退。
- (桌面端)GitHub / 聊天 token 存于系统钥匙串,不包含在备份中;恢复后需重新填写。
恢复按钮有确认对话框,完成后弹出重启提示。已经暂存了一次恢复时,新的恢复会被挡住,此时出现「放弃已暂存的恢复」。
面板底部是恢复前快照:每次恢复前自动做一份,保留最近两份,每份旁边一个「回退到这份」加确认对话框。
连接远程工作区时,备份和恢复两个页签都会被一条提示替换掉:备份与恢复作用于运行 croli 的那台机器上的数据,你当前连着的是远程工作区——请直接在那台服务器上管理它的备份。
上下文
页面最底部还有一节「上下文」,只有一个开关:上下文索引 —「提高 Agent 获取信息质量和检索速度。」