v1.4.4

新增

• 完善 Skill 系统：全新 Skill 页面与路由，支持技能浏览、搜索、安装与创建；技能扫描器支持 YAML block scalar 多行描述解析；侧栏新增技能入口与键盘导航
• 导航历史与多窗口恢复：支持多窗口状态恢复、手势导航接入、Composer 输入状态管理、草稿持久化
• Rich Composer & @mention：富文本输入框，@mention 弹框智能搜索文件/空间/技能，粘贴后自动触发检测
• 空间自定义图标与配色：每个空间可独立设置图标与颜色，右键菜单一键配置；AppCall 建空间时直接指定
• 图片预览模态框：AttachmentChips 点击大图预览，ModalShell 支持 backdropOnly 模式
• PDF 直接读取：Read/Grep 工具支持 PDF 文本提取、目录、链接与大小限制，按页读取；PDF 缓存带 20 分钟 TTL 自动释放
• 允许保持系统唤醒：接电时 prevent-display-sleep 防合盖断网，电池时保持省电
• 自动化任务拖放排序：支持拖拽调整自动化任务顺序
• 发行版下载代理：改用 dl.finchwork.app 加速更新下载

优化

• Skills 路径重构：skills/ → .finch/skills/；新增 listUsableSkills 统一运行时入口；precedence 调整为 additional > project
• Composer 选择器重构：SpacePicker/ModelPicker/PermissionModePicker 统一使用 Button/Menu 组件，移除旧样式依赖
• i18n 补全：Skill、自动化、Mention 等场景完整中英文文案
• 表格渲染优化：宽度 772px/780px → 100%，底部阴影对齐
• CSS token 统一：Button/Kbd/ListRow/OptionCard/StepSlider/ConfirmDialog 等组件 token 对齐
• 代码块折叠优化：行数级判断，折叠态只渲染前 36 行
• pathUtils 路径缩略：侧栏空间路径显示格式化为 ~/…/aeolus/finch
• finch-tools 拆分：工具描述、行为规则、参数定义分文件管理
• Windows 路径适配：Windows 下 PermissionMode 规范化处理
• 过程小结引导：Agent 在多工具/循环任务中按 Plan/Found/Next 简洁同步进度

修复

• 修复中断后用户消息动态渲染丢失（内容关联 merge 策略）
• 修复 Linux 无边框窗口圆角、边框及红绿灯 hover/最小化最大化图标
• 修复 Linux CI 下 Bun 跨编译失败（改用 baseline 根治）
• 修复额度不足/限流/上游过载不再触发自动重连，避免 token 浪费
• 修复 deeplink 打开白屏 & 置顶/取消置顶不更新会话时间
• 修复中文输入法回车触发 Enter 快捷键
• 修复 Edit 工具跨轮丢失 Read 记录，改为从会话历史回放
• 修复 LRU 驱逐时未清理 timelineIndexes/staticVersions
• 修复 session fork 分支点匹配——优先文本精确匹配，跳过纯 thinking/toolCall chunk
• 修复 kimi-code 模型禁用 thinking，防止 thinking 内容混入正文
• 修复编辑首条消息不再清空 sessionId；AskUserQuestion 已跳过分支截断识别
• 修复会话标题包含 <finch-attachment-hint> 内部标签
• 修复表格宽度 772px/780px → 100% + table-wrapper 阴影底部对齐
• 修复侧栏懒挂载 ResizeObserver 导致布局异常
• 修复 MentionPopover 高度计算统一 & RichComposerInput 粘贴后触发检测
• 修复技能激活时清除旧会话高亮；键盘导航按空间展开状态
• 修复多窗口恢复未完成问题 & 决策确认
• 修复删除独立空间时记忆文件改名归档，避免遗留孤儿文件
• 修复 Welcome/Settings/Onboarding 中英文 locale 处理

v1.4.3

新增

• 自动化任务管理：全新自动化引擎，支持定时执行（小时/日/工作日/周/Cron）、模型选择、推理等级、执行历史记录；Schedule 工具集成；全链路 IPC + 前端 UI（TaskView/AutomationDialog/AutomationPanel）
• 网络设置面板：新增网络页，支持直连/系统代理/自定义代理配置与连通性测试；OAuth 登录优先系统浏览器，回退内嵌窗口；系统代理窗口获焦自动重检测
• 多语言国际化：会话区域、快捷鍵对话框、侧栏、Composer、设置页全面 i18n 中英文翻译
• 托盘菜单 & 状态角标：macOS 托盘菜单（新对话/设置/退出），运行/等待/未读状态动画角标
• 模型分级选择：支持 Quick 快速对话模型，defaultReasoningEffort 智能分配推理等级
• 新增模型：新增 Kimi 2.7, MiniMax 3.0, GLM 5.2, Fable 5
• 有趣的个性化功能：到设置页面里找找吧

优化

• 统一设计语言重构：Finch UI 重新设计，体验更一致了
• 空间选择器重构：SpaceMenu 拆分为 SpacePicker（UI）和 SpaceMenu（工具模式）
• 侧栏 UI 状态持久化：侧栏 tab/展开/收起/钉住等状态统一持久化到 workspace.json，支持跨窗口恢复
• 模型配置默认推理等级：Fable 5 默认 low，Opus 默认 medium，更合理默认值
• OAuth 兼容性：OAuth 登录走应用代理，成功/失败均显示返回 Finch 按钮
• 推流体验优化：减少系统资源占用，优化推流性能，提升响应速度

修复

• 修复 sideBar 状态持久化恢复失效（workspace.json 漏读 sidebarUiState）
• 修复紧凑模式左栏宽度恢复与展开收起动画
• 修复悬浮左栏遮盖内容与 z-index 层级
• 修复发送消息后侧栏会话时间未乐观更新
• 修复 batch-edit 格式下 edits[] 空 old_string 遮蔽 diff 内容
• 修复结束后复制工具条缺失
• 修复工具超时中断会话
• 修复系统语言识别与会话模型切换

v1.4.2

新增

• Windows 官方支持：新增 Windows x64/ia32 CI 构建及发布流程；Windows NSIS 安装器脚本、打包脚本及图标；Windows 任务栏集成（dev/prod 不同 AppUserModelId 及 setAppDetails）；Windows/Linux 窗口外壳优化
• 多窗口架构升级：多窗口 URI 智能路由，流事件广播给所有查看者；移除多窗口模式开关，⌘N / Ctrl+N 始终开新窗口；新窗口快捷键改为 Shift+⌘N / Shift+Ctrl+N
• 用量统计全面重构：用量统计与设置页统一布局；圆环颜色适配亮暗主题；localStorage 缓存与骨架图加载态；扩展额度查询供应商；配额接口 10 分钟缓存复用，429 失败时降级展示旧数据
• finch:// 深链接：支持通过 URI Scheme 跳转至指定会话；支持 URI Scheme Windows/Linux 单实例锁与冷启动深链接
• Grep 工具优化：新增 output_mode / offset 参数，按 mtime 排序结果
• Edit 工具读前写保护：防止 AI 在未读文件的情况下直接编辑
• 字体本地化：移除 Google Fonts CDN 依赖，内置托管
• 应用生命周期模块：新增非 macOS 系统托盘支持
• 记忆系统自动淘汰：记忆超容量时归档淘汰而非报错，蒸馏支持语义淘汰
• 模型排序：支持供应商与内置模型排序，自定义模型识别与排序优化

优化

• Windows/Linux 全平台兼容：P1 兼容性修复 — 标题栏/header缩进/应用菜单/路径展开/斜杠统一/Shell安全检测/快捷键符号/DockBadge防护/打包配置
• rg 解析策略重做：优先用 Finch 自备二进制，缺失则后台异步下载，系统 rg 兜底；启动时确保 ripgrep 在 PATH，杜绝 spawn 超时
• Grep fallback 全面修复：无 path 时默认补 . 避免卡 stdin；排除 node_modules/.git 避免扫巨型目录；显式传递 cwd 而非默认 pi 数据目录
• 模型管理页重构：改用 SettingsPage 布局组件，统一使用 SettingsDropdown 组件
• 跨平台工具函数提取：shared/platform.ts 及 platformCompat.ts；UI 组件替换硬编码平台检测
• Pi Agent 容错改进：二进制重建失败提示、ENOENT 友好提示、EPIPE 保护
• 用 unpdf 替换 pdf-parse：彻底移除 @napi-rs/canvas 依赖，减小打包体积
• 等宽字体回退：改用 system-ui，移除首页背景白色渐变

v1.4.1

新增

• Claude & OpenAI 模型全面接入：支持 Claude 订阅、Anthropic API 及 OpenAI API，在设置中选择接入方式即可切换使用，无需重启。
• OAuth 登录：支持通过 OAuth 授权登录云端服务，不再需要手动填写 API Key。
• 对话分支：在任意 AI 回复上点击分支按钮，从当前上下文开启新方向继续对话，原会话保持不变。
• 空间与目录关联：空间可绑定本地目录，AI 自动感知工作区上下文；目录空间与普通空间区分展示，避免重复关联。
• 后台任务管理：AI 可在后台执行长时间任务，完成后推送通知；关闭主窗口后任务照常运行。
• 后端推理（Thinking）展示：可查看 AI 的推理过程，流式实时输出，推理完成后自动折叠；支持按模型能力开启思维深度控制。
• 只读命令自动放行：ls、cat、grep 等只读操作不再弹出权限确认，减少不必要的打断。
• 附件支持升级：图片自动压缩并显示缩略图，PDF 支持本地文本抽取后直接传给 AI。
• WebFetch / WebSearch：支持网页抓取与搜索，AI 可主动获取最新信息辅助回答。
• ⌘⇧B 快捷键：随时快速展开或收起右侧工具栏。

优化

• 记忆能力提升：会话结束后自动提炼关键信息并写入记忆，跨会话保持上下文；记忆搜索按日期降序优先展示最近内容。
• 工作抽屉交互重做：工具调用、文件变更、命令执行按类型聚合展示，不同类别使用专属图标；任务完成后只保留文件数、行差、耗时等有效信息，信息密度大幅降低。
• 对话列表可读性提升：连续 AI 回复自动合并为一条展示，去除中间多余的工具条；隐藏 Thinking 时相邻回复同步合并，界面更清爽。
• 权限与提问卡片全面重构：统一卡片管理系统，窗口切换后不再消失；响应后立即关闭，不等整轮完成；拒绝权限时同轮所有卡片批量关闭。
• 会话状态指示器重做：运行中由呼吸圆点升级为旋转加载环，等待确认时显示脉冲发光；后台会话完成状态实时同步到侧边栏。
• 运行中实时显示 token 用量：对话进行中即可看到本次 turn 的 token 消耗，不再等回复结束才更新。
• 批量归档会话：标题栏菜单支持一键归档 7 天不活跃的会话，操作前显示确认弹窗防止误触。
• Thinking 块视觉优化：推理进行时自动滚底跟踪；去掉界面背景 grain 纹理，视觉更简洁。
• 内存性能优化：会话 timeline 启用 LRU 淘汰策略，后台轮询请求合并，大量会话场景下内存占用明显降低。
• Bash 环境修复：命令执行改为加载 shell profile，解决 Electron 启动时 PATH 缺失导致常用工具找不到的问题。

修复

• 连续发送消息不再丢失：修复快速连续发送多条消息时的队列竞态问题，所有消息均可按序送达并处理。
• 窗口切换后不再叠字：切到后台再切回，AI 回复内容不再出现重复渲染。
• 权限卡与提问卡窗口重开后可用：重新打开窗口后未完成的权限请求和提问卡片正常恢复，不再无法回答。
• 编辑消息后对话正常延续：修复编辑历史消息后分支数据错误，编辑后的对话完整保留上下文并正常继续。
• 侧边栏幽灵会话消失：修复 session 扫描将普通消息 ID 误注册为 session，导致侧边栏出现无标题空白会话的问题。
• Thinking 推理完成后折叠状态正确：修复推理结束后 thinking 块意外全部折叠的问题。
• 工具超时不再误中断等待：等待用户确认权限或提问期间暂停超时计时，响应后重启，不再因等待时间过长被强制中断。
• 背景会话完成状态同步：修复后台运行的会话完成后侧边栏状态不更新、持续显示运行中的问题。
• 新建会话不误清空间选择：修复新建 session 时错误重置当前已选工作空间的问题。
• 会话归档/删除日期解析修复：修复迁移会话时日期字段存储为无法解析的文本，导致部分旧会话无法删除或归档的问题。

v1.3.0

新增

• 完整记忆系统（测试版本）：session 结束时自动蒸馏对话为事实，分类写入 USER.md / MEMORY.md / lessons.md，支持信任评分与低分归档；提供记忆功能供 AI 调用。
• MCP app bridge：通过 AI 交互管理空间（罗列/创建/重命名/删除）、调整外观设置（主题/字体/思考过程显示）、查询版本与执行应用升级。
• 空间路由与工作目录关联：空间 bootstrap 时可选择关联目录，目录空间与普通空间区分展示，避免重复关联。
• 会话自动命名：AI 根据对话内容自动为无标题会话生成名称，内部工具调用不再暴露给用户。
• 对话压缩状态提示：上下文触发 SDK 自动压缩时，UI 显示压缩中动画、已压缩勾选标记与失败提示。
• 设置页增强：新增辅助模型下拉选择、memoryMode 三档配置，以及蒸馏次数与 token 用量统计面板。
• 工作区交互优化：文件名超长时中间截断、规则文件显示为"空间规则说明"并换用规则图标、文件行支持点击图标定位 Finder / 点击整行预览。
• 日志分组展示：日志列表最多展示最近 7 条，超出时引导打开 Finder 查看完整目录。
• 右侧工具栏重构：支持 docked / floating 两种模式，修复 float/docked 切换时的动画异常。
• 多窗口始终显示新对话入口，目录选择菜单自动过滤已作为空间的目录。
• 开发模式更新模拟器：HomeView 与「关于」页面均可直接模拟更新状态并联动 UpdateBanner。

优化

• 渲染层性能 P0：主滚动容器启用 scrollbar-gutter，静态对话轮启用 content-visibility，消息/代码块/表格容器启用 contain 优化，流式蒙版动画预占合成层，关闭 composer 拼写检查。
• SyntaxHighlighter 懒加载：流式输出阶段跳过高亮，完成后再渲染，大幅降低实时 CPU 占用。
• 推理过程实时统计：cache 和输出 token 在推理中实时更新，不再等到结束才显示。
• 记忆搜索改进：改为搜索日志文件（而非已注入内容），结果同分时按日期降序排列；session_search 直读 SDK 原始 JSONL，移除冗余双写。
• 记忆边界收紧：注入与写入保护手写文本段不被覆盖；spaceId 注入仅限当前活跃空间。
• 侧栏视觉统一：分区标题改为置顶风格，修复缩窄时文字换行与 icon 消失问题。
• 表格与消息体验：优化会话表格呈现并增加滚动渐变提示，对齐提问消息字号，稳定 RunningIndicator 宽度消除抖动。
• 更新通知重做：提升为全局固定显示，进度条与按钮样式更醒目。
• 放宽 save_profile 规则，为 lessons 增加容量限制防止无限膨胀。

修复

• 修复切换 session 时 Composer 不更新模型选择的问题。
• 修复键盘上下导航跳过空间会话的问题。
• 修复新窗口启动时 RightSidebar 自动收起功能失效。
• 修复 Composer 输入框在页面挤压时不自动增高。
• 修复推理中向上滚动吸底与底部指示器跳动。
• 修复会话回到底部按钮显示异常。
• 过滤 task-notification 文本块与系统消息，防止内部事件泄漏到用户界面。
• AGENTS.md 注入提示仅在实际加载成功时显示。
• 修复空间目录路径未规范化导致去重失败的问题。
• 修复侧边栏左内边距导致空间列表宽度异常的问题。
• 修复同步会话扩展目录到工作区的问题。
• 修复交付物识别与工具错误提示的若干问题。
• 修复多 provider token 计数合并逻辑。
• 修复 x64 交叉编译包内缺少 darwin-x64 native binary 的问题。

v1.2.1

新增

• 新增多窗口模式，支持新窗口直接开启新对话，并在多窗口间同步必要的工作区与设置状态。
• 设置改为独立窗口，支持多窗口场景下更稳定地打开、切换和保存配置。
• 工作区面板新增更多文件与站点信息展示能力，页面标题会异步补全。

优化

• 优化多窗口下的左侧会话栏与右侧工作栏布局策略：空间不足时优先收起左栏，尽量保留对话区和工作区。
• 优化窗口恢复、Dock 激活和新窗口状态恢复时的侧栏表现，减少页面被过度挤压的问题。
• 右侧工作栏偏好改为全局记忆，运行时开合按窗口独立判断，并在应用恢复时延续最后关闭窗口的状态。
• 优化输入框、会话列表、右栏面板和工具调用展示的交互细节与焦点样式。
• 优化流式对话渲染性能，降低历史消息与实时输出的重复渲染开销。

修复

• 修复新窗口可能继承上一窗口会话的问题。
• 修复多窗口模式下侧栏置顶和最近列表默认折叠的问题。
• 修复窗口恢复时安全对话宽度保护不生效的问题。
• 修复自定义模型、未启用供应商统计、Context Window 用量统计等模型设置相关问题。
• 修复工作区面板扫描、滚动布局和文件列表展示中的若干问题。

v1.2.0

新增

• 在线自动更新：接入 electron-updater，启动后静默检查 GitHub Release，发现新版本后台自动下载，用户决定何时重启安装。
• 首页更新提示气泡：首页右上角实时显示更新状态（发现新版本 / 下载进度 / 点击重启安装），品牌绿配色。
• 预发布通道：设置 → 关于 新增"接收预发布版本"开关，可提前体验 v1.x.x-beta 版本。
• 身份文件快照：重新孵化或覆盖前，FINCH / USER 身份文件自动备份至 ~/.finch/snapshots/，保留最近 20 份，防止意外丢失。
• 智谱 GLM Code Plan：新增内置供应商，支持 GLM-5.1 / GLM-5-Turbo / GLM-4.7 / GLM-4.5-Air，200k 上下文。
• Mermaid 图表渲染：代码块中 Mermaid 内容自动渲染为图表，支持源码 / 预览一键切换。
• HTML 文件 webview 预览：HTML 文件在工作区内直接渲染，不再展示源码。
• 工作区面板初始扫描：新建会话时自动扫描当前目录并展示文件结构，不再显示空白面板。
• HATCH 孵化流程重写：重新孵化前主动备份用户身份，孵化后自动恢复首页引导语，防止身份文件被整体覆写。
• 工具调用动画：运行中的工具调用显示限流滚动动画，超长路径自动截断美化展示。
• 发布脚本：新增 npm run release，自动打包并上传 GitHub Release，附带 changelog。

优化

• 启动速度：冷启动白屏时间大幅缩短，webview 提前预加载，打开时不再闪白屏。
• 包体积：PNG 资源全量压缩，安装包体积减少约 81%。
• Context Window 统计：改用 assistant 消息级别 usage 计算上下文大小，避免 result 事件累计值虚高。
• 更新状态管理：更新逻辑从设置弹窗抽离为独立 updateStore，后台每 4 小时自动检查，错误提示中文化。
• 工作区面板：右侧面板高度规则和列表展示统一重构，支持独立滚动，孤立文件分组展示优化。
• 会话列表排序：过滤 SDK metadata 行 mtime 干扰，排序结果稳定不跳动。
• 快照目录迁移：从 ~/.finch/.snapshots 迁移至 ~/.finch/snapshots/，自动转移旧数据。

修复

• 修复打包后 backdrop-filter blur 特效失效（browserslist 未配置导致标准属性被 Autoprefixer 剔除）。
• 修复 AskUserQuestion 选项标签被截断的问题（移除 description 副标题展示，label 保证完整可读）。
• 修复新建会话后工作区面板显示为空的问题。
• 修复工作区面板滚动区域、分组展示与布局三处异常。
• 修复重新孵化后首页未自动填入引导语。
• 修复搬家（更换主工作目录）后历史会话无法继续对话的问题。
• 修复推理进行中底部指示器位置抖动。
• 修复无会话时界面空状态提示缺失。

Finch 1.1.0

[1.1.0] - 2026-05-15

新功能

• Mermaid 图表渲染：CodeBlock 支持 Mermaid 图表实时渲染，可在预览与源码间切换；推理内容中内嵌 Mermaid 不再触发渲染
• HTML 文件预览：HTML 文件改为 webview 渲染，支持真实页面预览而非展示源码
• 附件持久化：附件文件现可跨会话持久化，会话视图同步改造
• 工作目录侧栏折叠：WorkSidebar 工作目录分区支持折叠并记忆折叠状态
• Markdown 预览：CodeBlock 支持 Markdown 预览与原始内容切换
• HATCH 孵化流程：重写 HATCH 孵化流程，与 user-profile 完整联动
• checkPathsExist 接口：desktopApi 补充 checkPathsExist 方法桩

性能优化

• 消除启动白屏：优化启动性能，消除应用启动时白屏闪烁
• webview 预加载：webview 在动画开始前提前加载，消除打开时的白屏

界面优化

• 外观设置重设计：新增字体大小调节、主题分段控件，主目录卡片全面重设计
• 设置窗口宽度限制：打开设置时强制窗口宽度不低于 960px，关闭后恢复限制
• 设置页装饰图：设置页装饰图随窗口宽度自适应缩放
• 首页提示文案：优化首页提示文案样式与目录按钮展示
• 模型设置页面：优化模型设置页面交互细节
• 主工作目录卡片：重设计主工作目录设置卡片样式
• 侧栏交互：优化侧栏交互体验

Bug 修复

• 历史会话继续对话：修复搬家后历史会话无法继续对话的问题
• 推理底部指示器：修复推理中底部指示器抖动问题
• 推理历史渲染：区分推理中断的历史渲染状态
• AskUserQuestion 文本长度：限制 AskUserQuestion 问题文本长度，避免提问过长
• 设置关闭通知：改用 useEffect 清理函数触发 notifySettingsClose，修复时序问题
• 会话输入与推理展示：优化会话输入与推理代码块展示

重构

• 通用组件收敛：将通用组件收敛到 ui 层，统一复用层级
• 设置组件复用：优化设置组件复用与模型配置交互
• 前端组件梳理：梳理前端组件结构，修复运行态交互问题

其他

• 安全依赖升级：升级 Electron ，修复 18 个 Dependabot 安全告警
• CN 服务商补充：补充各 CN 服务商 apiKeyUrl 并修正模型上下文长度
• 运行时数据文档：记录运行时数据和 session 存储位置在 ~/.finch

---