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

# Finch Changelog

记录 Finch 每一次更新

版本 1.7.2

## Finch 1.7.2

长会话压缩能力升级——代理可在运行中主动压缩，压缩过程与 token 占用可见，归档会话支持空间回收；小程序平台新增立即追问 API 与后台子任务入口，模型供应商支持自定义请求头；同时修复网络重连后重复执行工具、压缩期间队列错序、中文路径图片预览与平台稳定性等问题。

2026年10月1日

# 1.7.2 更新日志

## 新增

### 长会话与压缩

-   **代理可主动压缩**：Session 工具新增 `compact` 动作，运行中也能在工具边界发起一次压缩并继续执行，不必等到上下文越线。
-   **压缩过程可见**：压缩中的进度圈会转动并平滑收尾；压缩边界卡片补齐 token 数字与摘要，压缩前后各占多少上下文一目了然。
-   **归档会话空间回收**：归档会话支持存储统计与空间回收，长期积累的会话数据可以安全释放。
-   **长会话压测**：新增长会话压缩压测 CLI（通过 `npm run` 调用，支持场景套件、JSON 输出与断言分级），用于本地回归长会话场景。

### 小程序（Mini Tool）平台

-   **立即追问 API**：小程序会话 API 新增 `ctx.sessions.promoteTurn`，可将自己排队的消息提升到队首，走的是界面「立即追问」的协作式中断路径；配套 `ctx.api.supports()` 检测，便于小程序兼容旧宿主。
-   **会话标题**：小程序会话信息新增标题字段，小程序可以直接展示会话名称。
-   **工具条布局**：小程序工具条改为横向滚动，并新增仅图标模式，窄窗口下不再挤压输入区。
-   **后台子任务入口**：小程序视图接入与主会话一致的后台子任务菜单，可直接进入自己创建的后台会话，未读与运行状态角标沿用同一套。

### 模型与供应商

-   **自定义请求头**：模型供应商支持配置自定义请求头，便于接入需要额外鉴权头的网关或自建服务。
-   **模型目录更新**：更新内置模型目录与权威 Catalog，新增 GPT-6.1 Sol；会话模型选择会被固化，重新打开历史会话时恢复当时的模型。

### 诊断

-   **主进程网络控制台**：新增网络控制台，排查代理与请求问题不必再翻日志；同时补充数据库性能诊断日志。

## 优化

-   **长会话打开更快**：分支与条目合并为一次 pi 往返；首屏只读取分支尾部窗口，更早的轮次按需回退。
-   **会话文件压缩更省资源**：会话日志的落盘压缩改为逐行流式处理，压缩大文件时不再一次性读入内存。
-   **长代码块不再卡输入**：聊天代码高亮改为异步分片执行。
-   **图片预览补出格式**：全屏预览标题栏按 MIME、扩展名与文件魔数补出图片格式芯片，识别不出就不显示。
-   **额度口径统一**：设置页、模型菜单与托盘的订阅额度展示统一，额度重置时间与套餐展示更清楚；未获取额度时不再显示空卡片。
-   **未登录也可浏览模型**：未登录状态下展示 Finch 全部可用模型，登录后再按个人权限收敛。
-   **MCP 展示**：优化 MCP 服务卡片与服务能力清单，切换弹窗的高度与空状态对齐；连接器全空时收敛为居中的图标、单行引导和添加按钮。
-   **小程序权限说明**：权限声明与增量审核文案更清楚，首次授权不再被误判为「权限升级」。
-   **待发送消息置顶**：队列消息支持置顶，操作提示与满额提示更明确。
-   **Bash 回收**：Bash Shell 按运行归属回收，并新增会话级强杀入口。
-   **存储分层**：按用途拆分配置、可重建缓存与运行状态；模型配置与模型设置、会话展示状态与可清理缓存、窗口尺寸与会话恢复状态、自动化任务及执行记录、日志设置与小程序状态、工作区上下文、未读会话与用量历史等旧数据在启动时自动迁移，独立 CLI 同步跟进。上一版遗留文件按既定名单清理。

## 修复

### 会话、时间线与压缩

-   修复网络波动重连后**重复执行工具**的问题：相同参数的调用直接复用重连前已成功的结果，时间线上重复的工具卡折叠为一张并标注 ×N，同时消除重复召集多智能体等副作用。
-   修复压缩期间的队列问题：追问抢跑、队列消息错序、压缩续跑未结束时队列被提前派发，以及压缩状态收尾泄漏。
-   修复 Unicode 行分隔符（U+2028 / U+2029）导致会话历史 IPC 吞帧。
-   修复模型超时后会话时间线空白。
-   修复助手正文中的链接解析：加粗网址、紧跟其后的标记不再被误吞。
-   修复中文路径下的图片预览与相对链接：Markdown 链接里的非 ASCII 字符被重复编码，主进程取不到文件；同时修复相对链接跨会话串台。
-   修复附件读取失败后占用输入框、首页发送后残留草稿附件。

### 队列、追问与输入

-   修复追问链路的四个问题：贴底滚动短暂失效、回复完成时页面向下回弹、追问消费后待发送按钮仍保持加载、编辑提交误发送队列消息。
-   调整权限卡的等待策略：询问模式下不再倒计时自动拒绝，等多久都能批准；行动模式保留两分钟倒计时与超时拒绝。

### 模型、账户与小程序

-   修复自定义模型被误判为「不支持思考」、内置 Provider 与远端目录不同步、本地与远端供应商合并、切换某个模型后消息无法发送，以及模型设置中的 OAuth 登录操作。
-   修复 Finch Cloud 账户与订阅状态不同步、退出后仍显示额度、短生命周期凭据被立即刷新、托盘与设置页额度不一致。
-   修复小程序子会话完成后误显示未读、归档会话仍显示未读、面板重复拉取列表、全屏页重复显示层级、面包屑首层缺失，以及已卸载的捆绑小程序被自动回装。

### 平台稳定性

-   修复强退会话会重启 pi 运行时、开发态主进程可能重复启动、退出清理后应用无法关闭。
-   修复大型工作区文件搜索结果不完整、Workspace 拆分后仍依赖旧数据文件、Space「更多」状态经常失效，以及展开一个空间时其它已展开空间被收起。
-   修复 Shell 命令中的引号与美元符号被提前展开。

版本 1.7.0 – 1.7.1

## Finch 1.7.0 – 1.7.1

MCP 工具箱与小程序协作能力上线，侧边聊天、子任务批次入口与归档管理更新落地；模型价格倍率、可选执行 Shell 与工作区 AGENTS.md 规则链就位，同时修复草稿丢失、模型切换、MCP 凭据迁移与平台稳定性等一系列问题。1.7.1 是 1.7.0 的热修复版本。

2026年9月18日

# 1.7.0 – 1.7.1 更新日志

## 新增

### MCP 与小程序

-   **MCP 工具箱**：工具箱新增 MCP 标签页，可添加、编辑和管理自建 MCP 服务，并在需要时完成授权。
-   **更清晰的 MCP 状态**：统一服务状态徽标、错误提示和授权图标；添加服务的表单与列表交互更易理解。
-   **小程序协作能力**：小程序可感知全局等待状态，并支持代答；新增模型目录读取、按条切换模型及创建会话时指定模型等能力。
-   **共享协作基础**：为小程序提供 owner 隔离的共享产物、文档、任务和交接记录能力，支持构建可追溯的多智能体工作流。

### 会话与协作

-   **子任务批次入口**：子任务会话标题栏可查看同批任务，并通过下拉菜单快速切换。
-   **侧边聊天**：右侧面板可打开独立的侧边聊天，沿用当前工作区上下文，不干扰主会话的流式输出和交互。
-   **归档管理更新**：设置中的归档页完成重新设计，自动化面板也可查看已归档的执行会话。
-   **快速引用**：选中文本后的浮动操作收敛为简洁的快速引用入口。

### 模型、权限与平台

-   **模型价格倍率**：模型菜单中可显示价格倍率，方便比较不同模型的成本；补充 xAI 品牌图标及登录流程展示。
-   **更灵活的行动模式**：统一命令门禁决策；已声明的临时目录清理、项目 `.temp` 临时脚本和复合命令可按实际风险更顺畅地执行，高风险操作仍会明确提示。
-   **可选执行 Shell**：在 macOS、Linux 与 Windows 上均可配置用于命令执行的 Shell；Windows 支持 Git Bash、CMD 和 PowerShell。
-   **工作区规则链**：会自动按 Git 仓库层级加载 `AGENTS.md` 规则，为项目内协作提供更准确的上下文。

## 优化

-   **启动与数据迁移**：会话、Space、用量、OAuth、扩展及工作区数据迁移统一在启动阶段完成，旧版本数据升级更可靠。
-   **状态持久化**：工作区布局、侧栏偏好、编辑器草稿、设置和会话状态按领域拆分存储，重启和切换页面时恢复更稳定。
-   **权限说明**：权限卡片突出高风险操作，并改用更直白的提示文案；等待超时会明确告知模型原因，避免与用户拒绝混淆。
-   **隐私友好的使用统计**：匿名统计调整为启动与本地日活跃上报，减少不必要的事件采集。
-   **界面细节**：优化选项卡片悬停和内边距、时间线次要信息、助手气泡和工具调用卡片的视觉层级。
-   **Markdown 链接操作**：链接支持右键菜单；图片语法指向非图片文件时会自动降级为可打开的文件链接。

## 修复

### 会话、草稿与时间线

-   修复切换或重启后 Composer 草稿、附件丢失，以及删除附件后草稿目录残留的问题。
-   修复编辑重发请求失联后无法继续发送、压缩后历史消息无法编辑或创建分支的问题。
-   修复发送消息后视口被历史阅读位置拉走、长会话编辑卡顿、超长标题无法完整查看的问题。
-   修复工具调用摘要字段不完整导致会话视图崩溃、建议行直发清空草稿、子任务标题或完成汇总缺失的问题。
-   修复中文输入法确认候选词时误提交批注、模型设置输入框误触提交，以及侧栏重命名时拖选文字会带动分组的问题。

### 模型、账户与小程序

-   修复会话内切换模型后仍使用旧 Provider、专业模式缺少思考档位时未按模型建议回退的问题。
-   修复 xAI 登录卡在获取授权码、Finch Cloud 账号卡片持续加载、未登录时模型数量和开关显示异常的问题。
-   修复模型用量重复计数、价格倍率为 0 时徽标不显示，以及模型重复工具调用可能形成循环的问题。
-   修复小程序面板在后台会话中打开时错位、按钮文字截断、历史安装的小程序 MCP 授权图标异常的问题。

### MCP、扩展与平台稳定性

-   修复同一扩展包被安装成两份、被新安装替代后旧目录残留，以及 MCP 凭据迁移未完成就激活的问题。
-   修复 Windows 首次运行时缺少 `ripgrep` 导致 Grep 失败，并将 `git worktree remove` 纳入危险操作识别。
-   修复开发版应用名称丢失 Dev 后缀、开发版检查更新报错，以及深链和 OAuth 授权在不同构建版本间相互干扰的问题。
-   修复亮色主题下侧栏异常变深、等待弹窗后模型菜单错位、未读红点点击后侧栏不跟随等界面问题。

版本 1.6.3

## Finch 1.6.3

小程序新增外观设置能力并接入远端 Provider 目录快照；模型菜单按来源分组，侧边栏改用汉堡图标，补充 142 个本地 Twemoji 资源；修复会话压缩、模型目录刷新、小程序并发更新与自定义皮肤取色等一系列问题。

2026年9月10日

# 1.6.3 更新日志

## 新增

### 小程序与扩展

-   **外观设置能力**：小程序新增 `ctx.appearance`，可在获得 `permissions.appearance` 授权后设置主题、自定义皮肤、字号、字体和首页背景；授权卡片及三语文案同步完善。

### 模型与 Provider

-   **远端 Provider 目录快照**：支持获取远端 Provider 目录快照，模型目录状态更可靠。

## 优化

-   **模型菜单整理**：按模型来源分组，统一来源卡片圆角、常驻模型提示与空状态布局；补充模型切换来源诊断。
-   **侧边栏与主题细节**：侧边栏菜单改用汉堡图标，压缩时间与说明文字，优化亮色主题激活行及加载动效。
-   **表情资源覆盖**：补充动物、食物、自然与运动物品等 142 个常用 Twemoji 本地资源。
-   **日志维护**：按日期清理过期日志并限制单文件大小，详细日志保留期调整为七天。

## 修复

### 会话与压缩

-   修复切换会话时流式内容回退、尾部闪烁、旧压缩边界残留与后续建议丢失的问题。
-   修复轮次折叠后压缩边界消失、旧操作误清理压缩状态、压缩续跑时队列消息提前显示的问题。
-   修复首页发送后切页时序、容器新建会话后再次打开最新会话时 open-identity 缓存失效的问题。
-   修复首条图文消息附件恢复错误、异常状态重复展示操作建议，以及运行状态未展示重试详情的问题。
-   修复创建会话时主题闪白，以及 Space 会话列表展开状态未写入数据库的问题。

### 模型与 Finch Plan

-   修复 Finch Plan 模型目录刷新失败、刷新时误触发自动切换、订阅状态更新延迟，以及网络波动导致退出登录的问题。
-   修复新会话未恢复上次模型、切换模型后默认值未更新、模型失效时跨服务商切换异常与模型拖拽无效落点的问题。
-   修复用量额度排序、Finch Plan 额度卡片标题重复、日志占用未持续更新的问题。
-   修复云模型中断后错误终态被覆盖的问题。

### 小程序、渲染与平台

-   修复小程序并发更新状态相互覆盖、权限警告显示异常的问题。
-   修复相对文件链接被渲染为 blocked、Windows 本地图片无法显示的问题。
-   修复 `✌️` 等文本默认呈现表情未被正确渲染为 Twemoji 的问题。

### 外观

-   修正自定义皮肤 `--text-inverse` 派生算法：不再直接取反 RGB，改为按主题基底混入白色或黑色，避免饱和深色在强调色背景上出现偏色发灰。

## 过往版本

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