> ## Documentation Index
> Fetch the complete documentation index at: https://vibex.peatboy.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# v0.1.0-rc.4

> 十套明暗主题、浮动的窗口边框、统一的运行时管理器、重做的模型选择器，以及终端与会话搜索的性能修复。

## 亮点

* **内置十套主题，明暗分开选择** — 外观不再只是一个浅色／深色开关。桌面端自带十套配色：浅色为 Vibex Light、Catppuccin Latte、Gruvbox Light、Solarized Light、GitHub Light，深色为 Vibex Dark、Catppuccin Mocha、Gruvbox Dark、Tokyo Night、Nord。浅色与深色各自独立选择，任意浅色都能搭配任意深色；你也可以把 JSON 主题文件放进运行时 home 目录的 `themes` 文件夹来扩充列表，文件里没写的颜色会按它实际所在的背景补齐。所有内置主题的正文与次要文字对比度都不低于 4.5:1（`04d582d`）。
* **窗口边框跟随你的系统** — 标题栏改为 38 像素浮层浮在界面之上，不再单独占一条，因此侧栏和各个面板一直延伸到窗口顶边，右侧栏也整体画成一块。标题栏按钮与你所在的平台一致：macOS 保留红黄绿交通灯，Windows 保留贴靠布局需要的区域，Linux 跟随 GTK 的装饰布局。窗口做不到的按钮不再显示，按按钮也不会误触发窗口拖动（`5a2f015`、`a72bf55`、`4035d0e`、`dd87a6f`、`18c8628`）。
* **运行时集中在一个管理器里** — 桌面端和移动端共用同一个运行时管理器，用来浏览、添加、切换、重命名和删除运行时；列表与所选运行时的详情放在同一面板，不再层层弹窗。切走时不再关闭内置运行时，本地终端和正在运行的 Agent 回合都能保留；地址填错什么都不会变，失败原因会记在对应的运行时上。列表还会在连接之前就告诉你，对方是另一台 Vibex 桌面端还是无界面的服务器（`3e72051`、`a33e67c`）。
* **重做的 Agent／模型供应商／模型选择器** — 在输入框里选模型现在是一个浮动菜单：顶部是 Agent 标签条，有 **已收藏的模型** 视图，每行都有星标，默认推理档位有标记，搜索会把最贴近的结果和你收藏的模型排在前面。同一窗口尺寸下菜单高度保持不变，输入或切换 Agent 时不会在指针底下跳来跳去，搜索框也更宽了（`973e015`、`6a6380a`）。
* **Agent 静默失败时现在会报错** — Agent 连接可能吞掉内部错误（比如 API key 被拒），然后什么都不回就结束回合：回答凭空消失、没有任何报错，消息却算作已发送。现在这种情况会以错误结束，并提示可以怎么处理；真正的停止、权限确认或确实有内容产生的回合不受影响（`dcd01d8`）。
* **搜索不再拖慢整个应用** — 以前打开会话搜索会为每个会话重建索引，而且对话框开着的时候每一帧都重跑整个扫描，繁忙会话会从约 58 fps 掉到 6-8 fps。现在索引只建一次并保持可用，扫描放到后台，再次打开对话框是瞬间完成的（`95d0a8a`）。
* **终端保持流畅** — 终端以前每次重绘都要把每个单元格重新构造成一个对象，而输出每一行、光标每闪一次都会重绘，所以连空闲终端都可能每秒卡住窗口两次。现在整个网格一次画完：同一帧在 debug 构建下从约 242 ms 降到约 3 ms（`eabe83b`）。
* **Android 安装包可以正常升级，体积也恢复正常** — 以前每个 Android 安装包的内部版本号都一样，凡是会检查版本的渠道，新 APK 都装不上旧版本。现在版本号由发布版本推导，`0.1.0-rc.4` 排在 `0.1.0-rc.3` 之后；无法编码的版本会让构建直接失败，而不是悄悄沿用旧号。发布构建还会先清掉早先 debug 构建遗留的库：曾涨到 429 MB 的安装包回到约 73 MB（`cb9809f`、`8de5d4e`）。
* **不再内置编辑器源码** — Vibex 过去为了构建界面工具包，要随仓库带上一份 95 MB 的 Zed 编辑器源码。这份副本已经移除，工具包改为使用正常发布的软件包，代码检出小了很多，构建也更容易复现。唯一看得见的变化是：依赖这份副本的**毛玻璃**（Frosted glass）效果已随之下线（`6ffcf7c`、`825bb97`、`9ecc107`）。

## 新功能

**运行时与远程**

* 桌面端和移动端都能在同一个窗口里浏览、添加、切换、重命名和删除运行时，列表与所选运行时的详情同处一个面板（`3e72051`）
* 切走时保持内置运行时继续运行；先连接成功再切换，地址错误则一切照旧；失败原因随每个运行时单独保留（`3e72051`）
* 运行时列表标明对方是 Vibex 桌面端还是无界面服务器，配对时即已知，并在每次连接时刷新（`a33e67c`）

**主题与外观**

* 十套内置浅色／深色配色任选并自由搭配；用只写想改颜色的 JSON 主题文件扩充列表（`04d582d`）
* 悬停和选中颜色改为取自主题自身的背景，暖色或带色调的主题不再配到中性灰的高亮（`04d582d`）
* 右侧栏（文件、Git、子 Agent 时间线）现在整体画成一块（`18c8628`）

**桌面端**

* 标题栏以 38 像素浮层浮在界面之上，每一列都为它留出空间，内容不会被压住（`5a2f015`）
* 标题栏按钮遵循各平台自己的规则，在 Linux 上遵循 GTK 的装饰布局；窗口做不到的操作不再显示，按下按钮也不会误触发窗口拖动（`a72bf55`）
* 用量页的范围开关改为滑动切换，控件描边更柔和（`37e8029`）
* 用量页的筛选器归到范围开关之后成组排列，每个直接显示它筛选的值（多选时显示 `+N`），不用再打开菜单才知道筛了什么（`2a03753`）
* 模型供应商编辑器改为回车保存而不关闭对话框，所有字段都会写入草稿，错误显示在出问题的字段下方（`69489d7`）
* MCP 与技能的配置导出移到各自页面，不必再绕进主导航到不了的高级页（`f7c3129`）
* 新增 **开发者** 设置分区：**帧率监视器** 开关在工作台上叠加实时帧率、帧耗时与资源占用（`a80f3fd`），浮层可拖动并记住位置（`b2aa073`），开启期间每秒记录一次采样到诊断数据（`8a30d6a`）
* 输入框的 Agent／模型供应商／模型选择器改为真正的浮动菜单：Agent 标签条、**已收藏的模型** 视图、每行的星标开关、标出默认推理档位，并带打开／关闭动画（`973e015`）
* 选择器搜索先按开头匹配、再按包含匹配、最后按供应商名称排序，已收藏的模型置顶；收藏可保存并重排列表；切换进行中锁定 Agent 行；关闭后焦点回到输入框（`973e015`）

**Agent 与 ACP**

* zcode 适配器从 0.17.2 升级到 0.37.1；审批提示现在会显示工具调用的可读说明和将要改动的文件，适配器固定使用 Node 运行（`d88327f`）
* Cursor 现在按模型参数逐个发布选项，不再把每种参数组合冻结成单独的模型 id：模型按名称列出，`fast`、`context` 和推理深度作为所选模型上的选项来设置（`8ab812f`）
* 推理深度在会话中仍可随时调整；布尔型的 thinking 开关归入会话选项，不再被当成一个深度档位；用旧变体 id 保存的模型（如 `claude-opus-5[thinking=true,context=300k]`）在确认 CLI 已使用新形态后，会自动收敛为模型名（`8ab812f`）

## 修复

**桌面端**

* 补齐此前悄悄缺失的图标：共 34 个图标路径画不出东西，其中 32 个从未注册（侧栏项目图标、文件与文件夹操作、文件类型图标、拖动手柄），另有 2 个指向了错误的目录（`2b37048`）
* 运行时按钮现在会显示自己的图标，点击后其面板保持打开（`de067b9`）
* 配对的手机会始终拿到自己的侧栏布局，而不是桌面端当时正在显示的远程运行时的布局（`444226b`）
* 折叠卡片或合并流程行之后，最后一行下方不再留下一条空白带、让视图停在那里（`3e59958`）
* macOS 的 Dock 图标大小现在与旁边的图标一致，点击 Dock 图标也能重新打开窗口（`a5af0ee`）
* 模型供应商编辑器里连接字段排在模型之前，与你填写时的顺序一致（`232e8b6`）
* 用量页工具栏和图表标题改用标准的小尺寸控件，不再局促（`c98f0f4`）
* 模型供应商与模型菜单在同一窗口尺寸下保持固定高度，输入或切换 Agent 时不再改变大小；列表在内部滚动，搜索框也拿回了宽度（`6a6380a`）
* 切换会话不再让对话跳动：时间线保留已测量的行高，并记住你正在看的那一轮，向上翻看的读者会停在原处（`5785cdb`）
* 侧栏未选中会话行更易读，与项目和工作区行保持一致（`fff3271`）

**Agent 与 ACP**

* 完全没有输出的回合现在会以错误结束，不再保存一条空回答；等待输入、被你停止或确实有内容产生的回合不受影响（`dcd01d8`）
* Cline 的地址固定为 `api.openai.com`：该端点由 Agent 自己掌握，配置里填的地址不再起作用，预览中会显示它实际调用的地址（`4285157`）

**移动端与构建**

* Android 构建现在会传入 NDK API 级别，构建、打包和打标签发布流程不再在链接环节失败（`50a03f9`）
* Android 版本号由发布版本推导，新构建可以覆盖安装旧版本；无法编码的版本、或预发布序号超过 99 时构建直接失败（`cb9809f`）
* 发布构建会先清掉早先 debug 构建遗留的库，安装包不再夹带 debug 库（`8de5d4e`）
* 滑开抽屉不再顺带滚动它展开的页面，滑动之后手指带起的惯性也不会传到抽屉列表里（`2609443`）
* 键盘收起后，点击仍然聚焦的输入框可以重新唤出键盘（Android 与 iOS 均如此）；点击输入框旁边的按钮不会弹出键盘，键盘已经在屏幕上时点击也不会重复唤起（`fe7f843`）

## 性能

* 会话搜索在对话框关闭后保留索引，扫描放在后台而不是绘制时进行，文本就地匹配（`95d0a8a`）
* 终端把整个网格作为单个元素绘制，指针输入也收敛为单个监听器（`eabe83b`）

## 内部、构建与文档

* 不再内置 Zed 源码：界面工具包改用已发布的软件包，其中一小段未发布的桥接代码移入本仓库；随包字体和移动端图标迁出旧副本；移动端平台层、键盘处理和 iOS 入口都重建在已发布的软件包之上（`6ffcf7c`）
* 界面工具包系列固定到某个具体修订，并在项目文档（spec）中写明该固定点何时可以前移（`825bb97`、`9ecc107`、`e1d56bc`）
* 构建与许可证检查适配了新的依赖和资源，重新生成软件物料清单（SBOM）、第三方声明与许可证策略，并更新发布打包、平台支持、UI 边界与许可证文档（`6ffcf7c`、`04d582d`、`a5af0ee`）
* 项目文档（spec）更新了窗口边框、用量工具栏、静默 Agent 回合、依赖来源、终端绘制与 Cursor 参数化模型选择器相关内容（`2a03753`、`dcd01d8`、`e1d56bc`、`eabe83b`、`8ab812f`）
* 移动端滚动监听器的一处代码检查失败不再影响 Rust 质量门禁和 CI（`45709c8`）
* Android 发布任务不再在构建开始前就中断：SDK 初始化动作仍在请求 Google 已停止发布的旧 `tools` 包，现已固定到去掉该包的版本（`b870998`）
* 工作区与打包输入的版本号统一升到 `0.1.0-rc.4`（`4dd6ce6`）

## 相关链接

* [在 GitHub 上查看完整差异](https://github.com/vibex-ai/vibex/compare/v0.1.0-rc.3...v0.1.0-rc.4)
* [上一版本：v0.1.0-rc.3](/docs/changelog/v0.1.0-rc.3)
* [返回更新日志](/docs/changelog)