跳转到主要内容
打开 设置(cmd-,)可以修改桌面端的本地偏好。设置不会替代配置中心中的 Agent、供应商、MCP 或 Skill 配置。 页面顶部有 搜索设置 输入框,可以按名称或关键字直接跳到某一项。改动过的项旁边会出现 撤销更改。

分区

常规

自动更新只接受同通道的版本。RC 安装包只看 -rc.*,Stable 只看正式版本;通道不会互相回退。

外观

控制主题模式(跟随系统 / 浅色 / 深色)、窗口缩放(75%–200%)、界面字体 与 代码字体 的字号和字重、减少动效、失焦时暂停动画 和 高对比度。代码字体同时影响代码块、集成编辑器和终端。 主题 用三张预览卡片选择 跟随系统 / 浅色 / 深色,每张卡片都会用该模式解析出的配色画一个微缩工作台。浅色主题 与 深色主题 是各自独立的下拉框,收起状态和菜单里都显示色块与主题名。内置二十套:浅色为 Vibex Light、Catppuccin Latte、Gruvbox Light、Solarized Light、GitHub Light、Rosé Pine Dawn、Everforest Light、Ayu Light、One Light、Kanagawa Lotus,深色为 Vibex Dark、Catppuccin Mocha、Gruvbox Dark、Tokyo Night、Nord、Rosé Pine、Everforest Dark、Ayu Dark、Dracula、Kanagawa Wave。你也可以把只写想改颜色的 JSON 主题文件放进运行时 home 目录的 themes 文件夹来扩充列表;文件里没写的颜色会按它实际所在的背景补齐。 工作台背景 可以放一张自己的图:静态图、GIF 或 WebP 动图,支持 填充、适应 或 拉伸,并有一层可调遮罩。浅色外观下背景会当作玻璃处理,启动加载页始终不透明。图片按项目图标同样的方式导入,存放在运行时 home 下。 字体会从系统已安装的字体中列出,缺失时回退。

工作台

连接

SSH 和 WSL 远程运行时是测试版,默认关闭。在 设置 → 开发者 → SSH 远程运行时 打开后,这个分区才会出现。 打开后可以:
  • 添加 SSH 连接:从 SSH 配置发现主机,探测环境并开始配置。
  • 添加 WSL 运行时:选择本机 WSL2 发行版。
  • 初始化 SSH:为没有 sshd 的 Linux 主机生成一次性 bootstrap 命令。
  • 查看配置进度、诊断卡、日志和运行时兼容性。
  • 编辑或移除连接,卸载远端运行时。
完整步骤见SSH 与 WSL 远程运行时。

会话

控制会话内容宽度(窄屏 / 标准 / 全屏)、时间线条目显示(会话预览条、Agent 生成状态、推理显示方式、默认展开推理、命令卡片渲染、文件编辑卡片渲染),以及消息队列行为:
  • 队列发送 —— 自动或手动。
  • 消息发送按键 —— Enter 或 Cmd/Ctrl+Enter。
  • 自动继续 —— 让满足条件的回合自动推进;无法继续时会停下来等待你处理。默认开启。
  • Agent 通知 —— Agent 完成 / Agent 需要输入 / Agent 失败 三类通知开关;系统通知 总开关关闭时这三项不可用。
  • 已记住的运行时 / 自动继续默认项 —— 清除已记住的选择。
  • Agent 配置 —— 打开配置中心的 Agent 分区。

已归档会话

已归档会话保留完整时间线,并从侧栏移出。这个页面可以:
  • 设置 自动归档 的空闲窗口(关闭,或 1–14 天)。自动归档按项目/文件夹生效,只归档空闲、已结束且没有运行中回合的会话;置顶会话和委派子会话不归档。
  • 查看已归档会话列表,恢复 到侧栏,或 永久删除。
  • 全部删除 已归档会话。
归档是可逆的;删除不是。误归档可以在这里撤销。

终端

设置默认 shell 和新建终端的初始目录(Worktree / 项目 / 当前文件)。
  • 默认 shell 可以从系统检测到的 shell 中选择,也可以指定自定义路径。
  • 已打开的终端不会因为修改偏好而迁移。
  • 滚动缓冲区固定为 10000 行,不可配置。

浏览器

控制内嵌浏览器面板自己的标签页: 详见内嵌浏览器。

电脑操作

电脑操作默认关闭。这个页面负责:
  • 安装和检测桌面驱动。
  • 查看操作系统权限(辅助功能、屏幕录制)。
  • 设置审批策略(允许 / 询问 / 拒绝)和是否允许 Agent 操作 Vibex 自身窗口。
  • 打开电脑操作面板,选择 窗口 或 浮动 模式。
  • 设置单次桌面调用的超时。
  • 查看当前平台支持的能力和 Wayland 实验路径。
完整说明见电脑操作。

快捷键

所有可重绑定的快捷键、默认键位和分组见快捷键参考。在这里可以逐项修改,也可以 重置 单项或 全部重置 全部恢复默认。冲突的键位会被拒绝并提示 快捷键无效或已被占用。

数据与诊断

显示本地存储用量明细(数据库、会话、终端、附件、诊断、Agent 安装),并提供逐类清理入口:
这些清理操作是破坏性的,且不会回滚。执行前先阅读隐私与恢复。

开发者

  • 帧率监视器:在工作台显示帧率和重绘信息,用于诊断性能。
  • SSH 远程运行时:打开或关闭 SSH / WSL 连接分区。VIBEX_SSH_REMOTE_RUNTIME 环境变量会覆盖这个开关,并在界面上锁定它。

关于

显示当前版本与通道(预览 / ReleaseCandidate / Stable)、平台信息、许可证,并提供:
  • 软件更新 —— 更新状态与操作按钮(立即检查 / 下载更新 / 安装更新 / 立即重启 / 打开发行版 / 重试)。更新清单经过签名校验,校验失败不会安装。卡片还会列出 最新版本、发布时间 和 下载大小,并把该版本的发布说明渲染成 Markdown(Vibex 更新内容);没有更新时显示当前已安装版本的发布说明。
  • 环境摘要 —— 可复制的不敏感环境信息,报问题时附上它。
  • 源代码 / 更新日志 —— 跳转到仓库和发布说明。
报告问题时请附上版本、通道、平台和结构化错误码,不要附上完整日志。