---
title: "更新记录 · Finch Agent"
description: "Finch 桌面应用的正式发布与更新记录。"
source: https://finchwork.app/zh/changelog
---

# Finch Changelog

记录 Finch 每一次更新

版本 1.6.0

## Finch 1.6.0

全局右侧面板与小程序导航栈上线，宿主渲染 Diff 与变更面板升级，Twemoji 统一渲染，模型生态接入 xAI、DeepSeek 视觉模型与 GLM 5.3。

2026年8月24日

# 1.6.0 更新日志

> 版本跨度：v1.5.4 → v1.6.0（552 个提交）

## 新增

### 右侧面板与小程序体系

-   **全局右侧 Panel**：新增全局右侧面板工作区，支持响应式宽度策略；右侧面板跨会话保活，浏览器/Webview 全局限流 20 个实例。
-   **Session 级 Webview Panel Host**：面板可挂在具体会话上，随会话恢复；支持打开文件预览、内置浏览器。
-   **小程序导航栈**：小程序页面内可打开子小程序、内置文件预览与浏览器（AppView 三层导航栈），面包屑多级回退；主小程序页面在子层级导航中保活，不再每次返回刷新。
-   **小程序新 API**：`ctx.ui.openDiff`（宿主渲染 Diff）、`ctx.ui.delivery`（交付）、`ctx.spaces`（空间列表）、工具栏动态更新（`setToolbar`/`updateToolbarItem`）、`window.finch.ui.toast/confirm`、`finch-file` 本地文件协议开放给 Webview。
-   **术语统一**：应用 UI 与文案中「小工具」统一改称「小程序」。
-   **Webview 体验**：消除小程序首次渲染浅色闪烁，主题注入完成前隐藏首帧；AppView 子层级接入窗口前进/后退历史。

### Diff / 变更面板

-   **宿主渲染 Diff 服务**：支持两个文件路径或 Git ref 多文件对比，patience 锚点 + LCS 回退算法，大文件对比性能与精度提升。
-   **变更面板**：diff 面板改名为「变更」，整合 write 文件，行号栏优化并标注修改次数；已删除文件以删除线+第三色标记；大文件 diff 性能增强。
-   **批注集成**：变更面板与文件预览支持选区快速批注，自动生成带路径和行号的批注 token。

### 消息与交互

-   **Twemoji 统一 emoji 渲染**：本地打包 473 个常用 emoji SVG（不依赖 CDN、离线可用），AI 回复、用户消息、侧栏标题、提问卡片等全 app 统一渲染，子集外回退系统字体。
-   **引用回复**：每轮 AI 回复新增引用按钮，轻量引用不再内联全文；悬浮卡片显示「针对：xxx」并可跳转到原回复。
-   **批注增强**：批注支持 `reminder` 字段（仅进模型 prompt 不外显），悬浮卡片超长内容截断，预览不泄漏内部 token。
-   **会话新能力**：`Session.read` 工具结构化读取会话内 LLM 回复轮次；会话菜单新增「在新窗口打开」；子会话卡片常驻展示并带运行状态标识。
-   **待发消息抽屉**：显示解析后的人类可读文本，不再泄漏注解内部载荷。

### 模型生态

-   **xAI**：新增 Finch 原生 xAI 设备码登录（OAuth），内置 Grok 精选模型。
-   **DeepSeek**：新增视觉模型（deepseek-v4-flash-vision-exp，1M 上下文），模型列表为支持视觉的模型显示视觉徽标。
-   **GLM 5.3**：新增模型条目；受限模型（GLM/Kimi/DeepSeek）思考档位只展示 low/high/max。
-   **自定义模型**：支持按 ID 筛选与批量选择；支持配置视觉能力；`finch://models/add` 深链一键添加。
-   **模型探测**：用 models.dev 本地缓存校正自动探测模型的名称与上下文长度；剔除标记为非文本输出的模型；上下文长度预设新增 372K 档位。
-   **OpenCode Zen Go**：内置 OpenAI 兼容服务商，放出 12 个模型。
-   **模型选择体验**：无显式模型时优先复用最近一次真实对话用过的模型；悬停用量图例高亮对应柱子。

### 其它

-   **繁体中文**：新增 zh-HK 繁体语言支持，校对主要界面文案。
-   **SQLite 应用存储**：新增 SQLite 应用存储基础设施（app.db），用量缓存等落地。
-   **MCP 2.0**：客户端升级官方 `@modelcontextprotocol/client` 2.0，支持协议版本协商回退。

## 优化

-   **性能**：agentStore / panelStore 持久化写入节流（流式输出期间主线程占用降低约 40%）；运行中 usage 快照节流；quicksearch 异步分片检索不再卡顿；长会话渐进渲染与首帧成本优化；低频状态动画改为跳变渲染。
-   **稳定**：运行轮恢复原地渲染消除 Timeline 撕裂；离底阅读时冻结流式输出避免抖动；运行状态细化（空 stop 视为网络错误、重连/过载直显、中断轮次标注未完成）。
-   **体验**：右侧面板按钮 Tooltip 显示快捷键；浏览器默认空状态引导；面板最大宽度提升至 2560；设置窗口加载速度优化。

## 修复

-   **多窗口**：修复多窗口用户消息同步、未读状态竞态、追问消息未同步渲染、Dock 角标未读同步。
-   **权限/交互**：修复切换会话时历史权限卡片闪现；切换 acceptCalls 时同步解除后端挂起权限请求；交互卡片响应与恢复。
-   **渲染**：修复会话恢复后历史消息空白、时间线日期显示异常、图片附件/base64 无法渲染、中文边界 URL 渲染异常、Windows 路径渲染为 blocked。
-   **输入**：修复重命名输入框中文输入法回车误触发提交；拖放目录改为 @ 提及输入。
-   **稳定性**：修复自动压缩期间消息队列抢跑、压缩重复提示循环、524 超长退避未自动重连、恢复窗口会话时间线为空。
-   **Grep**：修复 content 模式 context 行读取失败（相对路径按错误 cwd 解析）。
-   **模型**：修复 GLM 文本模型图片请求、OAuth 模型连接测试、临时刷新失败误删登录凭证、登录后 Provider 启用竞态。
-   **OAuth**：修复回调页多语言、弹窗窗口归属、取消授权保留终止页面、图标版本号参数不匹配被拒绝。
-   **其它**：修复重命名 IME 误触发、悬浮侧栏菜单误关闭、设置跳转子页面、MCP 客户端 1.3.x 提取失败、小程序预发布版本兼容判断、目录左省略段顺序错乱。

版本 1.5.4

## Finch 1.5.4

社区小程序搜索与界面自定义字体上线，长会话恢复与启动稳定性优化，多项交互和显示问题修复。

2026年8月12日

# 1.5.4 更新日志

## 新增

-   **社区小程序搜索**：工具箱支持直接搜索社区小程序，关键词匹配与展示优化，找工具更容易。
-   **界面自定义字体**：外观设置新增界面字体与代码字体自定义，界面可以更贴合个人偏好。
-   **模型菜单优化**：模型选择器键盘选中时同步显示用量卡，模型菜单选择体验更流畅。
-   **孵化体验**：孵化仪式起名后自动推荐并安装小程序，上手更顺滑。

## 优化

-   **长会话恢复**：分页优化长会话历史恢复，启动和切换长会话更流畅。
-   **启动稳定性**：优化长会话启动恢复诊断，自动压缩期间增加挂起无响应看门狗保护。
-   **IPC 架构收口**：主进程 IPC 全面迁移到类型化单一注册，为后续稳定性与扩展打基础。
-   **提高 Cache 命中率**：调整 prompt 的优先级，优化 Cache 命中率提高 0.4% 到 99.9%（DeepSeek 模型）。

## 修复

-   **中断交互**：长时间运行的 Bash 命令按 ESC 无法停止时，提供强制结束出口。
-   **消息错位**：修复运行中追加消息导致上一轮回复错位到新提问之后的问题。
-   **中文路径**：本地路径链接支持百分号编码还原，修复中文文件名打开报错的问题。
-   **深链显示**：修复 finch:// 深链在 Markdown 中被渲染成 \[blocked\] 的问题。
-   **时间线**：修复时间线图片裂图；Write/Edit 工具卡片不再内联展开，仅保留文件链接弹窗。
-   **会话标题**：用户手动改名的会话标题优先于 AI 自动改名，不再被覆盖。
-   **多窗口同步**：修复多窗口回复实时同步与未读状态丢失问题。
-   **会话视图**：修复会话视图跨空间串线；会话改名不再抢走窗口当前查看的会话。
-   **系统通知**：前台窗口下会话完成也会弹出系统通知。
-   **字体默认值**：界面字体与代码字体首次启动默认恢复为 Outfit / JetBrains Mono。

版本 1.5.3

## Finch 1.5.3

资料栏新增说明书与空间规则，小程序设置和快捷键体验升级，修复小程序、MCP 凭据及多项界面问题。

2026年8月9日

# 1.5.3 更新日志

## 新增

-   **资料栏说明书**：资料栏新增 Skill 说明书与空间规则展示，打开空间即可了解可用能力和协作约定。
-   **内置小程序说明书同步**：内置小程序的说明书会自动同步，信息保持最新。
-   **小程序设置体验升级**：统一小程序设置入口，支持多选字段、自动聚焦和回车保存，填写设置更顺手。
-   **会话阅读位置保留**：切换会话后会保留各自的滚动位置，可以从上次阅读处继续。
-   **快捷键增强**：模型菜单支持快捷键提示和直接追问；侧边栏切换与常驻模型快捷键也已补全。
-   **等待会话可代答**：小程序发起的等待会话支持代答，跨端协作更连贯。

## 优化

-   **提示交互统一**：侧边栏与 Composer 统一使用 Tooltip，提示位置和交互更一致。
-   **侧边栏性能优化**：优化大列表悬停表现，减少长会话列表操作时的卡顿。
-   **后台任务提示**：后台任务状态改用 HoverCard 展示，界面更简洁。
-   **对话活动保留**：手动停止对话后，活动记录不会自动折叠，便于回顾执行过程。

## 修复

-   **小程序兼容性**：兼容历史工具图片数据和新旧图标路径，升级后小程序显示更稳定。
-   **小程序设置安全性**：修复扩展密钥明文存储问题，并修复设置弹窗残留未保存编辑的问题。
-   **扩展图标显示**：修复首次启动时扩展图标缺失的问题。
-   **MCP 凭据引用**：重命名 MCP 服务后仍能保留已有凭据引用。
-   **自动压缩提示**：自动压缩过程中不再误显示上下文溢出提示。
-   **界面细节**：修复弹框中代码复制按钮显示、下拉触发器高度、提问卡宽度与快捷键弹窗遗漏等问题。

## 过往版本

1.  [1.5.22026-08-08](/zh/changelog/1.5.2)
2.  [1.5.12026-08-02](/zh/changelog/1.5.1)
3.  [1.5.02026-07-13](/zh/changelog/1.5.0)
4.  [1.4.42026-06-22](/zh/changelog/1.4.4)
5.  [1.4.32026-06-13](/zh/changelog/1.4.3)
6.  [1.4.22026-06-04](/zh/changelog/1.4.2)
7.  [1.4.12026-06-01](/zh/changelog/1.4.1)
8.  [1.3.02026-05-21](/zh/changelog/1.3.0)
9.  [1.2.12026-05-18](/zh/changelog/1.2.1)
10.  [1.2.02026-05-16](/zh/changelog/1.2.0)
11.  [1.1.02026-05-15](/zh/changelog/1.1.0)
12.  [1.0.02026-05-14](/zh/changelog/1.0.0)