设置：外观、终端与更新

#界面外观

打开 设置 → 界面外观。

• ① 顶部页签：界面语言（简体中文、English 或跟随系统）、界面主题、任务状态动效、界面缩放（80% 到 150%）。
• ② 点击任意主题卡片立即生效，当前主题右下角有对勾。主题有浅色和深色两类，本手册截图使用的是「晴空」。

#功能管理：决定侧栏显示什么

打开 设置 → 功能管理，用开关决定左侧菜单显示哪些功能，按住左侧的拖动点可以调整顺序。

① 例如 会话台、副本库 默认关闭，在这里打开后才会出现在侧栏。

关闭某个菜单只是把入口藏起来，已有数据不受影响，随时可以再打开。设置 入口始终显示。

#默认终端

打开 设置 → 默认终端，选择工作区「打开终端」和任务「在终端中接管」时使用的终端程序。

1. 点击已安装的终端即可选中（①），选择立即保存。

2. 没有安装的终端显示为灰色并标注 未安装（②），不能选择。

3. 列表中没有你用的终端时，选择 自定义命令…（③），在下方输入启动命令。命令中可以使用两个占位符：{dir} 代表任务目录（已带引号），{cmd} 代表恢复会话的命令（如 claude --resume xxx）。例如：

   alacritty --working-directory {dir} -e zsh -lc {cmd}
   

   macOS 通过 sh -c 执行这条命令，Windows 通过 cmd.exe /C 执行。

#软件更新

打开 设置 → 环境维护，默认显示 软件更新 页签。

1. 点击 检查更新（①）。发现新版本时会显示版本说明，点击 立即更新并重启 即可在应用内下载并安装，过程中显示下载进度；也可以点击 查看发布页。
2. 启动时自动检查更新（②）：每次启动在后台检查，发现新版本会提示。
3. 发现新版本自动下载安装（③）：启动时检查到新版本后自动下载、安装并重启，不需要手动点击。

#运行环境与服务日志

运行环境 页签列出工作区隔离副本的存放目录、Hook 回调端口和本地数据库位置，排查问题时可以对照查看。

服务日志 页签记录应用启动、飞书连接、浏览器访问等后台服务的输出，遇到「飞书连不上」、页面加载出错等问题时先来这里看。

• ① 刷新 读取最新日志；打开目录 在访达（Windows 为资源管理器）中打开日志所在文件夹，方便把日志文件发给别人排查；清空 删除当前日志内容。
• ② 日志内容。应用上次异常退出时，下次启动会把崩溃原因写入这里。

#其他设置页

页面	用来做什么	详见
Agent	安装 Agent、默认 Agent、运行权限、运行方式	安装并登录 Agent、运行方式
技能管理	管理 Agent 的技能、MCP 和插件	技能、MCP 与插件
网页访问	在本机浏览器或局域网手机上使用 Caravel	网页与手机访问
远程控制	通过飞书接收通知、派发和验收任务	飞书远程控制

#窗口与后台运行

• 关闭窗口不会退出：点击主窗口的关闭按钮后，Caravel 转入后台继续运行，正在执行的任务不受影响。要彻底退出，请使用菜单栏（Windows 为任务栏通知区域）托盘图标里的退出。
• 托盘图标：显示运行中和待确认的任务数，可以打开主窗口、剪贴板、快捷待办，或退出 Caravel。
• 独立窗口：编辑器、数据库、小应用、剪贴板、快捷输入和提醒都可以在单独的窗口中打开。
• 出错时：页面加载或显示出错时会提供重试和重新加载按钮；重新加载可能丢失尚未保存的输入。错误详情写入服务日志，可以在 环境维护 中查看。