--- title: "更新记录 · Finch Agent" description: "Finch 桌面应用的正式发布与更新记录。" source: https://finchwork.app/zh/changelog --- # Finch Changelog 记录 Finch 每一次更新 版本 1.6.2 ## Finch 1.6.2 会话头部整窗布局与面包屑、文字快速引用、Mermaid 内置渲染上线；小程序按能力并行激活并接入 MCP Resources/Prompts，Linux 桌面集成与 GPT-6 Astra 就绪，用量统计与 SQLite 存储更稳定。 2026年9月8日 # 1.6.2 更新日志 ## 新增 ### 会话与交互 - **会话头部整窗布局**：概览、小程序面板与会话菜单并入标题栏。 - **会话面包屑**：首级为 scope 下拉，可直接跳转新建对话或最近会话。 - **文字快速引用**：时间线回复中选中文字即可生成引用片段，悬浮预览与滚动定位更准确。 - **Mermaid 内置渲染**：图表支持全屏缩放与拖动，引擎按需加载，主包体积从 1199 kB 降到 572 kB。 - **表格全屏查看**：对话框四边统一留出安全边距，不再与系统按钮重叠。 - **面板标签右键菜单**：支持关闭、关闭其他、关闭右侧。 ### 小程序与扩展 - **能力并行激活**：小程序按 manifest 能力依赖并行启动，启动更快。 - **会话 Turn 取消**：小程序新增会话 Turn 取消接口。 - **AgentEvent 按项授权**：完整事件权限按 manifest + 持久化授权双重校验，更新新增权限时高亮提示。 - **MCP Resources 与 Prompts**：MCP 客户端新增资源与提示能力接入。 - **MCP 配置稳定化**：配置与业务密钥迁移至稳定数据目录，切换安装来源不再丢失。 - **Canvas 能力**：新增显示器变化事件 API，完善游戏 Canvas 运行时。 - **AppView 面包屑**：预览/Diff 回到导航栈，新增页面自有面包屑，深度上限 5。 - **文件选择器**：空间切换器合并到搜索/排序同一行，操作更顺手。 ### 平台与模型 - **Linux 桌面集成**：窗口改用 Finch logo 标题栏，支持 Wayland，无合成器环境自动回退，新增 rpm 打包目标。 - **新模型**：新增 GPT-6 Astra。 - **设置入口**：侧栏设置独立成按钮，关于页直达设置并新增「了解更多」链接。 ### 底层与稳定性 - **用量统计持久化**：模型用量写入本地缓存并兼容版本回退。 - **SQLite 迁移**：Space 与会话状态迁入 SQLite 存储，历史恢复更稳定。 ## 优化 - **启动提速**：工作区与模型启动状态与模块加载并行获取。 - **渲染架构重构**：重构 Renderer 分层与长会话运行时资源归属。 - **结构化日志**：补全主进程日志覆盖，便于诊断。 ## 修复 ### 追问与压缩 - 修复追问打断后旧任务继续运行、旧轮次内容残留的问题。 - 修复超大上下文反复压缩丢摘要、手动与自动压缩重复续跑的问题。 - 修复上下文超限未自动压缩、压缩失败后状态残留的问题。 - 修复压缩续跑误把跨会话参考材料当作任务执行的问题。 ### 后台任务与通知 - 修复后台任务结果显示到错误消息之后的问题。 - 修复后台通知跨工作错投、重连丢失与逐条触发回复的问题。 ### 会话与消息 - 修复会话语言切换后界面未动态更新的问题。 - 修复新建会话一直显示骨架加载、历史编辑定位与追加错乱的问题。 - 修复 Timeline 恢复空白、渐进渲染丢失与图片加载后尾部空白的问题。 - 修复 LaTeX 公式定界符渲染异常。 - 修复跳过交互后输入未清理、切换会话后回答残留的问题。 ### UI 与平台 - 修复弹窗叠加时 Escape 误关底层弹窗、内部弹窗被遮挡的问题；文本域默认撑满容器。 - 修复 Windows/Linux 会话布局与标题栏拖拽区域遮挡控制按钮的问题。 - 修复 diff 行间亚像素缝隙与时间线弹窗动画丢失的问题。 ### 模型与账户 - 修正 GPT 上下文窗口配置过大与 Kimi 配额耗尽提示的问题。 - 修复 Finch Cloud 用量分组、视觉能力与地址拼接的问题。 ### 小程序与 MCP - 修复小程序页面缺 cwd 回退、目录名与标识不一致时无法恢复安装的问题。 - 修复 MCP 工具列表截断、与小程序列表状态互相污染、恢复后未重新激活的问题。 - 修复今日用量重新打开后未刷新、重连/过载文案遮盖运行状态的问题。 版本 1.6.1 ## Finch 1.6.1 专业思考模式与 GLM 5.3 系列上线，小程序文件选择器和 HTML 预览能力升级，并全面优化会话、模型与桌面交互体验。 2026年8月31日 # 1.6.1 更新日志 ## 新增 ### 思考与模型 - **专业思考模式**：新增专业思考模式，为复杂任务提供更深度的推理链路。 - **GLM 5.3 系列**：启用 GLM 5.3，并新增 GLM 5.3 Flash 模型条目。 - **订阅模型展示**：模型菜单展示订阅模型并刷新访问权限；免费用户可看到锁定的 Finch 模型，状态更清晰。 - **模型选择体验优化**：无凭据模型不再被自动选中；模型登录与密钥状态分离展示，避免混淆。 ### 小程序与扩展 - **文件选择器**：小程序新增 `ctx.ui.pickFile`，改为 Finder 式钻取浏览；支持目录条目数显示、空状态区分、选中态高亮、底部当前路径等细节。 - **HTML 预览模式**：小程序支持选择 HTML 预览模式。 - **工具栏状态**：AppPanel 工具栏按钮支持 `checked` 切换态与禁用态联动。 - **小程序主题 token**：小程序可注入字号等主题 token，消除首次渲染浅色闪烁。 - **单实例 Webview 面板**：复用已打开的单实例 Webview 面板，减少重复创建。 ### 会话与交互 - **Session.suggest 工具**：Session 工具新增 `suggest`，可在本轮结束时给出下轮对话建议。 - **动态权限切换**：支持运行时动态切换 Session 权限模式。 - **Agent 错误恢复**：完善 Agent 错误恢复与重试交互，重试耗尽后可复用后续建议操作。 - **用量仪表盘重构**：用量统计页面重新设计，日期与展示更清晰。 ### 首页与外观 - **首页板块自定义**：首页板块支持自定义排序与显隐。 - **帮助与反馈菜单**：侧边栏主菜单新增帮助与反馈子菜单。 - **代码字号联动**：代码字号随显示档位调整。 - **托盘菜单配额**：恢复托盘菜单配额展示。 - **Home 背景皮肤**：新增 Home 背景皮肤支持。 ### 其它 - **通用技能来源**：新增 `~/.agents/skills` 通用技能来源开关。 - **Shiki 语法高亮**：DiffView 与文件预览接入 Shiki 语法高亮。 ## 优化 - **代码高亮性能**：重写代码高亮调度，大文件 / 大 HTML 前置扫描提速约 10 倍。 - **模型菜单细节**：统一常驻模型菜单布局，优化 provider 名称与星标对齐，微调最小宽度。 - **扩展构建**：扩展构建按缺失依赖判断安装并改用 `npm ci`，子模块同步更稳定。 - **首页布局保存**：首页布局保存后以后端返回状态为准，保存期间禁用按钮避免误触。 - **技能重扫**：技能重扫接入工作区序列化刷新链，避免旧快照覆盖 UI 状态。 - **构建与依赖**：bun 升级到 1.4.0 并锁定 CI 版本；构建号同步更新。 ## 修复 ### 输入与快捷键 - 修复输入长文本时光标不可见。 - 修复跨平台快捷键修饰键判断。 - 修复快捷键按键的主题背景样式。 ### 会话与消息 - 修复 AskUserQuestion 提问卡片被隐藏工具清理吞掉。 - 修复会话标题将 Composer 文件与批注 token 转为可读文案。 - 修复追问队首发送状态异常。 - 修复中断后后台进程残留。 - 修复批量工具结果导致上下文溢出。 - 修复会话最终结果延迟渲染。 - 修复老会话未同步视觉能力。 - 修复侧边栏 Tab 关闭按钮被裁切。 ### 文件与路径 - 修复聊天文件选择器继承旧空间目录。 - 修复文件路径复制出现换行。 - 修复路径续行被误识别为技能。 - 修复中文边界 URL 渲染与路径相关展示问题。 ### 面板与预览 - 修复单实例面板迁移后重复创建与 `finch:env` 竞态。 - 修复跨会话应用状态恢复。 - 修复隐藏工具调用夹在两段回复之间时合并渲染，消除多余空行。 - 修复可见工具调用之后的隐藏收尾调用也一并从渲染中剔除。 - 支持点击图片预览蒙层关闭。 ### 模型与账户 - 修复 GLM 文本模型图片请求相关逻辑。 - 修复订阅状态获取失败时仅展示免费模型。 - 修复欢迎语使用自定义助手名称。 - 修复临时刷新失败误删登录凭证。 - 区分中转站预算耗尽与请求限流。 - 修正推理强度档位中英文案映射（xhigh 极高 / max 最高）。 ### 系统与稳定性 - 修复小程序窗口导致 Windows 上设置保存全部静默失败。 - 修复首页 tab 排序拖拽的光标、键盘顺序与回弹问题。 - 修复持久化 Session 未读状态。 - 修复跨平台 Bash 任务通知串会话问题。 - 修复英文月份显示依赖 ICU 数据的问题，改用固定缩写。 - 修复输入框中文输入法回车误触发提交。 - 修复悬浮侧栏菜单误关闭。 版本 1.6.0 ## Finch 1.6.0 全局右侧面板与小程序导航栈上线，宿主渲染 Diff 与变更面板升级，Twemoji 统一渲染，模型生态接入 xAI、DeepSeek 视觉模型与 GLM 5.3。 2026年8月24日 # 1.6.0 更新日志 ## 新增 ### 右侧面板与小程序体系 - **全局右侧 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. [1.5.42026-08-12](/zh/changelog/1.5.4) 2. [1.5.32026-08-09](/zh/changelog/1.5.3) 3. [1.5.22026-08-08](/zh/changelog/1.5.2) 4. [1.5.12026-08-02](/zh/changelog/1.5.1) 5. [1.5.02026-07-13](/zh/changelog/1.5.0) 6. [1.4.42026-06-22](/zh/changelog/1.4.4) 7. [1.4.32026-06-13](/zh/changelog/1.4.3) 8. [1.4.22026-06-04](/zh/changelog/1.4.2) 9. [1.4.12026-06-01](/zh/changelog/1.4.1) 10. [1.3.02026-05-21](/zh/changelog/1.3.0) 11. [1.2.12026-05-18](/zh/changelog/1.2.1) 12. [1.2.02026-05-16](/zh/changelog/1.2.0) 13. [1.1.02026-05-15](/zh/changelog/1.1.0) 14. [1.0.02026-05-14](/zh/changelog/1.0.0)