设置：外观、终端与更新

#界面外观

打开 设置 → 界面外观。

• ① 顶部页签：界面语言（简体中文、English 或跟随系统）、界面主题、任务状态动效、界面缩放（80% 到 150%）。
• ② 点击任意主题卡片立即生效，当前主题右下角有对勾。主题有浅色和深色两类，深色包括「墨翠」「冰川青」「鸢尾紫」等，手机端也可选择相同主题；本手册截图使用的是「晴空」。
• 任务状态动效 可选「静止」，用描边和状态色提示运行与待确认；没有手动选择且系统开启「减少动态效果」时默认使用静止。

#消息翻译

在 设置 → 界面外观 的 界面语言 页签下方，可以设置对话里翻译按钮的行为。

• ① 翻译目标语言：默认简体中文，另支持繁体中文、英语、日语、韩语、法语、德语和西班牙语。它和界面语言互不影响。
• ② 翻译模型：默认 沿用消息模型，也可以指定任一已安装并启用的 Agent 和模型。翻译单独执行，不会写进原来的对话，也不会增加任务轮数。

更换语言或模型后，已经翻译过的内容不会自动重译。翻译按钮的用法见 继续对话与补充要求。

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

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

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

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

#默认终端

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

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. 自动下载更新（③）：检查到新版本后在后台静默下载，完成后提醒你。不会自动安装或重启，由你决定何时安装。

#问题反馈

遇到问题或有改进建议时，打开 设置 → 问题反馈（在软件更新下方）。

1. 在 问题描述 中写下操作步骤、期望结果和实际遇到的问题，最多 5000 字。
2. 需要时添加图片：点击附件按钮选择、按 ⌘ + V（Windows 为 Ctrl + V）粘贴截图，或直接拖入。最多 5 张，单张不超过 5 MB，支持 PNG、JPEG、GIF 和 WebP，提交前可以预览和移除。
3. 点击 提交反馈。

提交只发送你填写的描述、所选图片、应用版本和操作系统，不读取会话或项目内容；请不要在描述或截图里包含密码、密钥等敏感信息。提交失败时内容保留，重试不会重复提交同一条反馈；切换到其他设置分类再回来，草稿仍在。通过浏览器访问 Caravel 时只显示提示，需要在桌面应用中提交。

#运行环境与服务日志

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

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

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

#其他设置页

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

#窗口与后台运行

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

正式版会向自有服务上报随机安装标识、版本、系统/架构及必要事件时间，用于安装与活跃统计，不包含账号、会话或代码。统计独立于自动更新开关，网络失败不影响使用。