更新日志

v10.20.0 (2026-03-14)（最新版本）

集成 ClawHub 社区技能市场，大幅增强文件编辑可靠性和 Office 文档技能，补充消息新增附件支持。

新功能

• 🏪 ClawHub 社区技能市场：集成 ClawHub 社区技能市场，支持发现、预览和安装社区贡献的技能
• ✏️ 更智能的文件编辑：edit_file 工具新增行号定位、模糊匹配和 replace_all 模式，代码修改更可靠
• 📎 补充消息附件：Agent 执行过程中补充消息的附件现在会正确注入 AI 对话
• 📊 Excel 技能增强：新增 analyze 分析工具，新增 8 种修改操作，数据处理能力更全面
• 📝 Word 技能优化：支持 DXA 表格、页面配置和中文市场预设

问题修复

• 🔧 修复 Excel 解析中部分单元格显示为 [object Object] 的问题
• 🔧 修复补充消息附件未注入 AI 对话的问题
• 🔧 降低文件创建/追加/插入操作的风险等级为 safe

v10.19.3 (2026-03-12)

改进 Windows 语音识别失败的诊断能力——原生模块加载失败时，现在会捕获并显示真实的系统错误（如缺少 VC++ 运行时或 DLL 依赖），而非笼统的 "Could not find sherpa-onnx-node"。

问题修复

• 🔧 语音引擎诊断回退：Worker 通过 process.dlopen 直接加载原生模块，绕过第三方 addon.js 的静默错误吞噬机制，在加载失败的 Windows 机器上暴露真实系统错误
• 🔧 Worker 自身设置 PATH/LD_LIBRARY_PATH 作为二道保障，防止父进程环境变量传递失败

v10.19.2 (2026-03-12)

以三层防御机制彻底修复 Windows/Linux 打包版本中语音识别原生模块加载失败的问题。

问题修复

• 🔧 修复 Windows/Linux 语音识别失败——为 utilityProcess 增加 NODE_PATH 和绝对路径回退机制解决 asar 路径下模块解析失败，同时设置平台对应的动态库搜索路径（Windows PATH / Linux LD_LIBRARY_PATH）

v10.19.1 (2026-03-12)

修复非 macOS 平台语音识别原生库路径配置。

问题修复

• 🔧 修复 getSherpaLibPath 硬编码为 macOS 路径，新增 Windows PATH / Linux LD_LIBRARY_PATH 设置

v10.19.0 (2026-03-12)

企业微信 IM 适配器迁移至 WebSocket 长连接模式，提升消息投递可靠性。同时修复 Agent 工具守卫和 UI 竞态条件等问题。

新功能

• 🔌 企业微信长连接模式：企业微信 IM 适配器从 HTTP 回调模式迁移至 WebSocket 长连接，无需公网回调地址，部署更简单，消息投递更可靠

问题修复

• 🔧 放宽文件和记忆工具的 ptyId 校验，允许无活跃终端会话时使用
• 🔧 修复技能工具在无终端会话上下文时执行失败的问题
• 🔧 修复"AI 帮我配置"等自动触发任务因竞态条件不生效的问题

v10.18.1 (2026-03-12)

稳定性补丁：修复 MCP 工具路由错误、无 PTY 会话时终端工具崩溃，以及 think 模型重试时思考过程重复显示的问题。

问题修复

• 🔧 修复 MCP 工具调用被 skillSession 误路由导致"未知工具"错误
• 🔧 修复 Agent 终端工具在无活跃 PTY 会话时崩溃的问题
• 🔧 修复 think 模型请求重试时思考过程重复显示的 bug

v10.18.0 (2026-03-11)

提升 AI 服务商兼容性——支持按 Profile 选择 API 格式，新增 MiniMax 模型模板，飞书 IM 交互升级为卡片按钮。

新功能

• 🔌 API 格式选择：用户可为每个 AI Profile 选择 API 格式（自动 / OpenAI / Anthropic），兼容更多推理后端
• 🤖 MiniMax 模型模板：新增 MiniMax 模型默认配置模板，一键配置
• 💬 飞书交互式卡片：飞书 IM 中 ask_user 选项升级为交互式卡片按钮，替代纯文本展示

改进

• 🔍 优化 Agent 文件搜索和文档处理的引导提示
• 📖 补充飞书 card.action.trigger 回调订阅配置步骤文档

问题修复

• 🔧 修复 IM 平台思考过程与正文无法区分的问题，转为引用格式展示
• 🔧 修复网络重试时思考过程 <details> 块嵌套问题
• 🔧 移除 parallel_tool_calls 参数，更新智谱模板为 GLM-5

v10.16.0 (2026-03-10)

扩展企业 IM 能力——钉钉和企业微信新增多项资源支持，并支持从 Markdown 文件快速生成 Office 文档。

新功能

• 📄 Markdown 生成 Office 文档：Agent 可从本地 Markdown 文件直接生成 Word 和 Excel 文档
• 📌 钉钉资源扩展：钉钉技能新增多维表格（Bitable）、钉盘（Drive）、知识库（Wiki）资源支持
• 💼 企业微信会议：企业微信技能新增会议管理资源支持
• 📂 企业微信微盘与文档：企业微信技能新增微盘（云存储）和文档资源支持

问题修复

• 🔧 修复 exec 工具及 systemInfo.shell 在 Windows/Linux 下的跨平台兼容性问题
• 🔧 修复设置页模型选择弹窗误触关闭问题
• 🔧 知识库界面隐藏 L3 对话记录，减少界面干扰

v10.15.1 (2026-03-09)

这个补丁版本主要聚焦于会话管理界面的瘦身和交互流畅度提升，尤其修复了 Windows 下编辑输入卡顿的问题，并补强了与 vLLM 推理引擎的兼容性。

改进

• ⚡ 会话管理器重构：提取可复用 composable，并合并重复 CSS，进一步降低 SessionManager 复杂度，提升可维护性
• 🪟 Windows 编辑更流畅：将会话编辑弹窗拆分为独立子组件，修复 Windows 下输入卡顿问题

问题修复

• 🔧 vLLM 兼容性：调整 AI 消息格式校验逻辑，兼容 vLLM 推理引擎的请求格式

v10.15.0 (2026-03-09)

深度企业 IM 集成——新增钉钉和企业微信技能，日历、审批、考勤、通讯录等企业能力全面接入 Agent 工作流。

新功能

• 📌 钉钉技能：全面集成钉钉——日历事件、待办任务、考勤记录、通讯录查询、审批流程，均可通过 Agent 工具直接操作
• 💼 企业微信技能：全面集成企业微信——日历管理、审批流程、打卡记录、通讯录操作

改进

• 📖 更新 IM 文档，补充飞书、钉钉、企业微信深度对接说明

问题修复

• 🔧 修复钉钉待办列表查询 API 路径错误
• 🔧 修复钉钉参数校验顺序，优先校验参数再检查凭证，提升错误提示体验

v10.14.0 (2026-03-09)

全面集成飞书技能并支持 OAuth 用户授权，引入三文件身份体系实现更深度的 Agent 人格定制，以及 L3 对话向量化检索实现跨会话长期记忆。

新功能

• 🐦 飞书技能：全面集成飞书——多维表格/云文档/电子表格/日历/任务/云空间读写，支持创建多维表格应用；OAuth 用户授权让 Agent 以用户身份操作飞书 API
• 🧬 三文件身份体系：Agent 人格由三个工作区文件驱动——IDENTITY.md（我是谁）、SOUL.md（我怎么做）、USER.md（关于用户），替代旧的配置字符串方案
• 🧠 L3 对话向量化检索：历史对话自动向量化并通过语义搜索按需召回，实现跨会话长期记忆
• 🎂 诞生对话：首次启动时 Agent 自动发起认识对话，与用户互相了解
• 💭 思考过程折叠：推理模型的思考过程流式展开，生成结束后自动折叠
• 🖼️ 图片预览增强：输入框待发送图片支持点击预览；图片查看器支持 ESC 关闭和方向键导航
• 📝 助手标签页自定义标题：助手标签页标题显示用户自定义的 Agent 名字
• 📚 网站使用指南：新增 7 篇使用指南文档
• 💬 QQ 交流群入口：菜单和设置添加 QQ 交流群快捷入口

改进

• 🔧 统一动态导入为静态导入，消除 Vite 构建警告
• 🔧 终端专属提示词迁移到终端技能 content 中
• 🔧 MBTI 设置合并到灵魂 tab，优化布局
• 🔧 传感器卡片改用 CSS Grid 布局，统一尺寸
• 🔧 觉醒页重新设计，展示三文件身份体系

问题修复

• 🔧 修复推理模型去重逻辑覆盖 <details> 折叠格式的问题
• 🔧 修复网络错误重试竞态条件和任务失败状态显示
• 🔧 修正 talk_to_user 工具描述，避免模型在正常对话中误调用
• 🔧 修复技能工具执行后缺失 tool_result 步骤
• 🔧 飞书 OAuth 授权端点升级并添加 scope 声明，修复用户操作资源时 Unauthorized 错误
• 🔧 修复 soul_craft/user_craft 工具路由缺失及配置白名单遗漏

v10.13.1 (2026-03-06)

大幅优化 token 开销，精简系统提示和工具描述；新增自动更新镜像源和数据迁移框架，提升升级体验。

改进

• ⚡ 大幅优化 token 开销：重组系统提示结构、合并精简工具描述、压缩技能和关切摘要——显著降低每次请求的 token 消耗
• 🔄 自动更新镜像源：新增阿里云 OSS 镜像，自动测速选源，用户也可手动切换
• 🏗️ 数据迁移框架：引入版本化 migration 机制和 normalize 层，保障老用户平滑升级
• 📎 取消文件上传限制：移除格式限制，支持上传任意文件类型
• 🏷️ 视觉模型标记：模型选择下拉框标记哪些模型支持视觉能力
• 🖼️ ICO 图片支持：read_file 工具支持 ICO 格式，增强二进制文件检测
• ⚙️ 模型配置弹窗：AI 模型配置改为弹窗形式，优化表单体验

问题修复

• 🔧 修复非主流图片格式被两条处理管线同时跳过的问题
• 🔧 修复网络错误重试不足导致 Agent 误判任务完成
• 🔧 关切 vs TODO 判断规则集中化，防止误创建关切
• 🔧 前端支持格式列表与后端 detectFileType 完全对齐
• 🔧 上传文档的 AI 上下文中包含文件路径
• 🔧 前端文件上传支持 Excel 格式，拖放失败时给出 UI 提示

v10.13.0 (2026-03-04)

引入混合多模态路由，主模型自动切换视觉模型处理图片；大幅增强文档解析能力，支持 PDF 页面渲染、Word 嵌入图片提取和 HTML 转 Markdown。

新功能

• 🧠 混合多模态路由：检测到对话中有图片时，主模型自动路由到关联视觉模型，无需手动切换
• 📄 PDF 页面渲染：新增扫描版 PDF 渲染能力——预渲染前 5 页，检测含图页面交由视觉 AI 分析
• 🖼️ Word 图片提取：文档解析器支持从 Word（.docx）文件中提取嵌入图片，输出结构化 HTML
• 🔄 HTML 转 Markdown：文档解析管线新增 HTML 到 Markdown 的清洁转换，提升 AI 处理效果

改进

• 📎 文档上传图像分离：上传文档时将预览图和完整图分开处理，优化处理效率
• 📊 PDF 附件元信息：PDF 附件展示页数和预览页数信息
• 🐛 AI 调试控制台显示图片：AI 调试控制台展示图片内容信息，不再完全隐藏
• 💬 Toast 回复携带历史：桌面端主动通知回复时携带对话历史，Agent 能记住之前的上下文
• 🏗️ 统一主动上下文存储：合并 proactive context 存储路径，移除 IMService 中的重复机制
• 👁️ 统一视觉能力检查：将 hasVisionCapability 逻辑下沉到后端 ConfigService，移除前端脆弱的正则匹配

问题修复

• 🔧 修复 ParsedDocument 未保存文件路径，导致 Agent 在全盘搜索文件
• 🔧 修复图像映射信息缺失，导致文档引用页码错误
• 🔧 修复视觉模型误用 read_file 读取图片而非直接分析
• 🔧 修复图片上传被预压缩——改为发送原图并使用 detail:high，确保 AI 看清内容

v10.12.2 (2026-03-04)

优化文档上传处理逻辑，新增关切编辑功能，修复多个 Scheduler→Watch 迁移问题和附件展示缺陷。

新功能

• 📎 已上传文件展示：用户消息中展示已上传文件列表及附件元信息
• ✏️ 关切编辑面板：关切详情面板支持直接编辑，用户可便捷微调 Watch 配置

改进

• 📄 文档上传重构：改为 XML 格式输出文档信息，简化 Agent 对上传文档的引用方式
• 🌐 技能国际化：内置技能名称和描述支持中英文切换
• 🐟 品牌更新：更新 GitHub 仓库名引用和 Matrix 彩蛋 ASCII 艺术字为 "SailFish"
• 📸 更新界面截图：新增 AI 助手、技能市场、远程 Agent 展示截图

问题修复

• 🔧 修复 Scheduler→Watch 迁移在打包后因动态 import 失败（改用静态 import 注入）
• 🔧 修复 Scheduler→Watch 迁移后未清除旧任务数据和停止已废弃的 Scheduler
• 🔧 修复多 IM 平台同时连接时唤醒 Watch 选错平台
• 🔧 修复关切编辑按钮点击无效（structuredClone 无法克隆 Vue Proxy 对象）
• 🔧 修复附件标签样式——取消文件名截断，提升颜色可读性
• 🔧 修复工具调用参数畸形时任务静默结束，改为自动重试
• 🔧 修复类型定义和测试断言以匹配文档上传重构后的逻辑

v10.12.1 (2026-03-01)

全新应用 Logo 上线，覆盖所有平台和页面；独立助手模式新增旗鱼头像，对话界面更精致。

改进

• 🎨 全新应用 Logo：替换全平台（macOS、Windows、Linux）、欢迎页、网站及 favicon 的应用 Logo
• 🐟 助手头像：独立助手模式下 AI 消息左侧显示旗鱼 Logo 头像，对话体验更有品质感
• 🖼️ 欢迎页布局优化：调整欢迎页 Logo 尺寸和布局，视觉更协调

v10.12.0 (2026-02-28)

Agent 新增 TODO.md 和 CONTACTS.md 持久化文档管理，唤醒时自动注入用户近况摘要，Watch 待办提醒逻辑更智能。

新功能

• 📝 TODO.md 管理：Agent 可维护 TODO.md 文件，持久化追踪用户待办事项和截止日期
• 📇 CONTACTS.md 管理：Agent 可维护 CONTACTS.md 通讯录，记录用户联系人信息
• 🌅 唤醒近况摘要：唤醒模式注入用户近期活动摘要，让 Agent 了解用户最新动态

改进

• 📋 TODO/CONTACTS 机制优化：明确 TODO 文档追踪与 Watch 提醒的职责边界
• 🔕 隐藏内置唤醒关切：非 debug 模式下不再显示内置唤醒关切条目
• ⏰ 智能待办提醒：Watch 待办提醒根据任务时间跨度智能判断提醒时机
• 🌙 减少夜间打扰：优化唤醒 prompt，减少夜间无意义通知
• 🔧 CI/CD 文件名修正：更新 OSS 上传和网站下载链接，统一使用 "SailFish" 命名

问题修复

• 🔧 修复飞书连接断开时频繁通知用户，改为静默重连
• 🔧 修复 IM 消息中 exec 工具显示原始工具名而非实际执行命令

v10.11.3 (2026-02-28)

提升 AI 模型兼容性与健壮性，修复输出截断、token 超限、视觉降级等问题，新增 IM 过程消息开关。

新功能

• 📩 IM 过程消息开关：新增「发送过程消息」开关，关闭后仅发送最终结果和错误，减少 IM 通知打扰

改进

• 🏷️ 产品名称更新：构建配置中 productName 从 "SFTerm" 改为 "SailFish"

问题修复

• 🔧 修复视觉降级逻辑在向智谱 GLM-5 等纯文本模型发送图片时报错
• 🔧 修复 DeepSeek 等模型 max_tokens 超出模型限制的报错，优化上下文长度默认值
• 🔧 修复 LLM API 边界情况处理不当导致输出截断时任务假完成
• 🔧 修复编排器在输出截断时的崩溃问题（与 Agent 相同的问题）
• 🔧 修复 IM sendProcessMessages 开关 API 失败时回滚无效
• 🔧 修复 asking/needConfirm 流程中 flushTextBuffer 在静默模式下泄露中间文本
• 🔧 修复 IM 回复显示 talk_to_user 的上下文前缀
• 🔧 修复传感器串行启动导致 AppLifecycle 传感器不启动的问题
• 🔧 修复 daysTogether 计算未包含首次使用日
• 🔧 修复唤醒对话未持久化及 IM 重连时打招呼内容重复

v10.11.2 (2026-02-27)

修复 IM 消息路由、关切系统架构精简、后端服务初始化可靠性提升。

改进

• 🧹 移除关切共享状态：移除跨关切共享状态（sharedState）机制，简化 Watch 架构
• 💡 觉醒间隔提示：觉醒间隔输入框增加文字说明，提升配置体验

问题修复

• 🔧 修复 IM talk_to_user 主动消息和 IM 回复未正确路由到对应 tab 及上下文不连贯的问题
• 🔧 修复 event-bus 使用动态导入导致打包后模块找不到的问题，改为静态导入
• 🔧 修复后端服务初始化依赖 did-finish-load 事件可能导致的竞态条件
• 🔧 修复 updateContextKnowledgeAsync 中 toolArgs 值为 undefined 导致的 TypeError

v10.11.1 (2026-02-27)

提示词工程和 Agent 关系追踪的内部优化，修复觉醒模式和 Steam 版本的若干问题。

改进

• 🤝 羁绊系统：内部关系追踪机制，量化用户与 Agent 交互的深度
• 📝 提示词构建器重构：系统提示词采用 section 数组架构，规范 Markdown 格式输出
• 🌐 系统提示统一中文：移除冗余英文提示词，系统提示全面统一为中文

问题修复

• 🔧 修复觉醒模式心跳传感器启动时不自动开始的问题
• 🔧 修复 Steam 版本在快捷键和数据管理设置中显示 AI 相关选项
• 🔧 修复羁绊语气指导覆盖灵魂定义的问题，灵魂定义现在优先

v10.11.0 (2026-02-27)

快捷键全面开放自定义，传感器循环新增应用生命周期感知和通用探针，觉醒系统将「个性」升级为「灵魂」概念。

新功能

• ⌨️ 快捷键自定义：全新快捷键设置页面，支持自定义 AI 助手（⌘T）、本地终端（⌘⇧T）、SSH 终端、语音输入等快捷键
• 🔮 应用生命周期传感器：新增传感器类型，感知应用启动/关闭等生命周期事件，支持里程碑条件检查
• 🔬 命令探针和 HTTP 探针：通用探针传感器，可监控命令输出和 HTTP 端点状态

改进

• 🧠 觉醒「灵魂」系统：「个性」更名为「灵魂」，MBTI 选择迁移至觉醒面板
• 🎯 终端感知 UI 控制：AI 按钮和菜单根据当前终端状态动态调整可用性
• 🤝 IM 问候事件驱动：IM 问候改为事件触发，Agent 自主决定如何打招呼
• ⚡ 语音模型预加载：配置语音快捷键时自动预加载语音模型，确保即时可用
• 🎨 快捷键设置界面重设计：重新设计快捷键设置界面，居中布局更清爽

问题修复

• 🔧 修复 PTT 语音输入松开按键后仍持续录音的竞态条件
• 🔧 修复快捷键恢复默认后界面不刷新
• 🔧 修复旧版快捷键配置未能自动迁移到新默认值
• 🔧 修复 ESC 关闭觉醒面板时状态未同步到主界面

v10.10.0 (2026-02-26)

旗鱼从被动工具进化为主动助手 — 传感器循环与关切系统让 AI 能感知环境变化并自主行动，觉醒模式赋予 Agent 个性与主动对话能力，同时完成了 Agent 架构解耦、知识文档重构和 Office 样式主题等大量基础设施升级。

新功能

• 🧠 传感器循环与关切系统：完整的 Watch 系统，支持 4 种传感器（心跳、文件变化、日历、邮件）、8 个内置模板、有状态工作流、事件池分流层和 Webhook 触发
• 🌅 觉醒模式：AI 从被动工具进化为主动助手 — 个性驱动的主动对话、静默后台执行、Toast 推送通知、ECG 心跳动画
• 🤖 Anthropic 原生 API：Claude 模型改用 Anthropic 原生 API，不再依赖 OpenAI 兼容层
• 📊 Excel 样式主题：全新样式主题系统，支持预设/自定义样式和单元格级控制；Markdown 一键生成 Excel
• 📝 Word 主题扩展：主题系统扩展至表格、代码块和引用块；Markdown 有序列表转 Word 编号列表
• 📚 L2 知识文档重构：每个 contextId 对应一份结构化 Markdown 文档，取代旧版碎片化条目
• 🏗️ Agent 架构重构：TerminalAgent → SailFish，解耦终端依赖；新增独立 AI 助手标签页
• 🧩 Tab 独立渲染：每个标签页独立渲染，切换时不再销毁组件
• 🎭 个性技能：通过自然对话定义 Agent 个性
• 🛠️ 内置技能展示：设置页展示所有内置技能，支持启用/禁用
• 📦 共享类型系统：新建 shared/types/，消除前后端类型重复定义
• 🎤 按键说话：按住 Ctrl 键进行语音输入
• 🔍 历史搜索：支持按关键词和时间范围搜索 Agent 历史记录
• 📋 统一日志系统：基于 electron-log 的按日期落盘日志，支持动态调整日志级别
• 📁 Agent 工作区：专用工作区目录，文件读写自动跳过确认
• 🖼️ 图片读取：read_file 工具支持读取图片并注入 AI 视觉上下文
• 🔌 飞书 WebSocket：飞书适配器支持 WebSocket 连接管理与自动重连
• 🤖 AI 模板：新增 Claude、Gemini、Grok、Mistral、豆包、智谱、Kimi 预设模板

改进

• 🔀 命令执行拆分：execute_command 拆分为终端版（PTY）和助手版（exec），支持超时配置（最长 600 秒）
• 🌐 远程渠道：远程渠道改用助手标签页；WebChatService 后端直驱架构
• 📋 计划步骤上限：create_plan 步骤数上限从 10 提升至 50
• 🧠 记忆系统：移除自动观察提取，改用历史对话语义检索
• 🔔 关切提示注入：活跃关切列表摘要注入 Agent 提示词
• 📱 IM 工具：IM 工具在所有模式下可用，不再仅限远程渠道
• ⚙️ 设置页优化：底部设置项左右并列布局；记忆/知识库管理内嵌设置页；技能页简化为内置/扩展两组
• 🗑️ 定时任务废弃：旧定时任务自动迁移到关切系统；schedule_* 工具标记为废弃
• 🚫 NO_ACTION：Agent 可跳过不值得通知的批次传感器事件

问题修复

• 🔧 修复思考模型执行中插话导致立即「任务完成」
• 🔧 修复远程对话（IM/Web/Watch）正确标记为 assistant 模式
• 🔧 修复 IM 消息偶发重复发送，新增去重机制
• 🔧 修复 AI 超时重试机制失效
• 🔧 修复 Steam 版残留 AI 功能入口导致审核失败
• 🔧 修复心跳事件改为触发事件池排水，而非直接穿透
• 🔧 修复邮件传感器启动时补扫未读邮件，断线重连补漏
• 🔧 修复 did-finish-load 回调缺少 async 导致启动失败
• 🔧 修复单用户多渠道 IM 主动通知路由
• 🔧 修复终端中多余的 pwd 命令
• 🔧 修复 IM 文件发送工具在所有平台可用
• 🔧 修复 send_image_to_chat 工具兼容不支持视觉的 AI 模型

v10.9.0 (2026-02-21)

新功能

• ⚙️ 配置技能：邮箱与日历：配置管理技能新增邮箱和日历账户管理能力

改进

• 🎨 数据管理页面重构：重新设计数据管理设置页面，布局更清晰
• 🖌️ 主题排序优化：将蓝色主题调整为主题列表首位
• 🌐 浏览器技能增强：浏览器技能增加能力与限制提示，减少 AI 盲目重试
• 🔍 Agent 文件搜索优化：提示词引导 Agent 优先使用 file_search 而非 find/locate
• 💬 IM 配置引导优化：IM 引导设置提示中补充浏览器限制说明

问题修复

• 🔧 IM：修复断开连接时「连接已断开」提示出现两次
• 🔧 单实例锁仅在打包后启用，允许开发环境与正式版同时运行

v10.8.0 (2026-02-20)

新功能

• 🔗 深链 sailfish://：支持从官网技能示例通过 sailfish://run?task=... 调起应用执行任务
• 🛒 技能市场一键安装：从官网技能市场一键安装技能（深链调起）
• 📋 技能列表一键卸载：设置中「我的技能」支持一键卸载已安装技能
• 🎴 技能市场预览页：精选区域卡片点击后跳转到对应技能的预览页面
• 📊 统一连接状态面板：连接状态弹层左右并列展示 IM 渠道与 MCP 服务器状态

改进

• 🛒 技能市场：移除「推荐」分类，避免与精选推荐区块混淆

问题修复

• 🔧 macOS：Cmd+Q 第一次确认退出后立即退出应用，无需再次确认
• 🔧 连接状态弹层：修正远程渠道总数不显示的问题
• 🔧 技能/配置：允许 Agent 管理 MCP 服务器配置

v10.6.0 (2026-02-20)

新功能

• 🍎 系统托盘与单实例：新增系统托盘图标与单实例锁，应用可常驻后台且仅运行一个进程
• 🔒 托盘常驻：Cmd+W 隐藏窗口而非退出，服务在后台持续运行
• ⚙️ 配置管理技能：新增旗鱼配置管理技能（config），Agent 可通过自然语言查看与修改应用设置
• 🛒 技能市场（中文）：技能市场新增 12 个面向中文用户的技能

改进

• 🌐 官网：网站构建时自动从源码目录同步技能列表

问题修复

• 🔧 飞书：连接前预验证凭证，凭证错误时立即向用户返回明确错误信息
• 🔧 飞书：修复 SDK 连接错误处理及适配器连接状态管理
• 🔧 远程/IM：新建任务时创建标签页但不激活，避免抢焦点
• 🔧 知识库：修复清空主机记忆后每次启动重复清理孤儿数据的问题
• 🔧 AI 调试：修复调试面板复制按钮无效
• 🔧 CLI：自动探测本地主机并在无历史时显示空历史提示

v10.5.0 (2026-02-19)

新功能

• 🛒 技能市场：新增应用内技能市场，支持浏览、搜索、安装和更新社区共享的技能

v10.4.1 (2026-02-19)

新功能

• 🤖 IM 一键配置引导：各 IM 渠道新增「AI 帮我配置」按钮，一键启动 Agent 引导完成配置

改进

• 🧠 AI 自主管理上下文：Agent 自主管理对话上下文，替代程序自动压缩，提升多轮对话质量
• 🌳 浏览器表单增强：增强无障碍快照的必填字段检测和表单标签提取，改善复杂页面（如飞书）自动填表准确性
• 📊 统一日志系统：引入 5 级日志控制（debug/info/warn/error/silent），AI 设置面板可配置日志级别
• 🏗️ Agent 架构升级：会话持久化下沉至后端，Steps、上下文和生命周期统一由服务端管理，提升可靠性
• 🧹 记忆质量优化：优化记忆系统质量控制策略，提高召回相关性
• 🐚 IM CLI 命令：新增 im:status、im:connect、im:disconnect CLI 命令，支持无图形界面管理 IM

问题修复

• 🔧 修复飞书发送 MP4 视频文件报 400 错误
• 🔧 修复 createTabWithTask 任务不自动执行的时序问题
• 🔧 修复 Agent 调试模式开关未生效
• 🔧 修复恢复旧历史记录时 TaskMemory 为空的问题

v10.4.0 (2026-02-17)

新功能

• 🖥️ CLI 模式：新增纯 Node.js CLI 模式 — 无需 Electron 即可运行全部后端服务，适用于无图形界面服务器和自动化场景（npm run sft）
• 💼 企业微信集成：新增企业微信 IM 通道，支持基于回调的消息交互（Beta）
• 📖 各平台独立配置文档：IM 集成指南拆分为钉钉、飞书、Slack、Telegram、企业微信各自独立文档

改进

• 🔒 CLI 安全加固：根据代码审查修复 CLI 模块的安全和代码质量问题
• 🧪 CLI 测试升级：CLI 测试从冒烟测试升级为全面功能验证，覆盖全部 26 个命令
• 📝 文档更新：README 品牌标识从 SFTERM 更新为 SAILFISH，补充 Slack/Telegram 通道链接，简化个人使用授权描述，移除过时的 Roadmap

问题修复

• 🔧 全局统一品牌名称为 SailFish；Agent 上下文超限时先压缩再报错，而非直接失败

v10.3.0 (2026-02-17)

新功能

• 💬 Slack 和 Telegram 集成：新增 Slack 和 Telegram 作为 IM 渠道，支持通过更多消息平台与 Agent 交互
• 🌐 IM 模块国际化：IM 设置模块完整支持中英文国际化

改进

• 📖 双语 IM 集成指南：IM 集成文档拆分为中英双语版本，补充 Telegram 配置说明

问题修复

• 🔧 将 ws 可选原生依赖标记为 rollup external，修复构建兼容性问题
• 🔧 转义 @BotFather 中的 @ 符号，避免 vue-i18n 解析错误
• 🔧 修复帮助文档链接与重命名后的 messaging-integration 文件不匹配的问题
• 🔧 同步 vite-env.d.ts 类型声明并加固 IM 适配器防御性访问

v10.2.0 (2026-02-16)

新功能

• 🧠 观察日志模型：重构记忆系统为观察日志模型（Observation Ledger），实现结构化知识留存
• 🎛️ IM 执行模式配置：IM 设置页支持按通道配置 Agent 执行模式
• 📖 IM 配置指南：重构 IM 设置页说明区域，提供钉钉/飞书专属配置指南
• ⚡ 自由模式确认简化：简化自由模式二次确认流程，支持 IM 设置同步
• 🔑 飞书权限更新：更新飞书权限列表，允许设置页面复制文本

改进

• 🏗️ 设置页拆分：拆分远程访问为即时通讯和 Web 服务两个独立设置页
• 📝 README 品牌更新：更新 README 品牌介绍，突出远程 Agent 和 GUI 优势

问题修复

• 🔧 向量搜索改用 cosine 距离并降低预过滤阈值，改善知识检索效果
• 🔧 修复 BM25 索引使用加密内容导致记忆搜索失败的问题，改为使用原文索引
• 🔧 修复 Remote Agent 默认模式显示错误及按钮布局问题
• 🔧 为远程通道 AgentContext 补充缺失的 hostId
• 🔧 引入发送队列解决钉钉/飞书消息乱序竞态问题
• 🔧 修复 HostMemory 类型定义并增强设置恢复逻辑
• 🔧 修复 macOS Spotlight 搜索不支持通配符的问题
• 🔧 修复飞书通道 ask_user 工具重复发送消息的问题
• 🔧 优化飞书消息展示并修复消息乱序竞态

v10.1.0 (2026-02-16)

新功能

• 📨 IM 多媒体消息支持：支持接收飞书和钉钉的图片、语音、视频、文件消息，自动下载并本地存储
• 📤 文件与图片发送：Agent 支持通过 IM 通道发送文件和图片，支持主动通知推送
• 🎛️ 控制面板：设置改名为控制面板，改为全屏显示，修复子弹窗 ESC 事件拦截

改进

• 🎨 网关设置界面优化：调整 IM 集成与 Web 服务的显示顺序，移除不标准的 IM 图标及样式
• 🌐 官网定位调整：网站内容从「终端」定位调整为「AI Agent」定位
• 🔍 远程 Agent 诊断：为远程 Agent 消息显示问题添加诊断日志

问题修复

• 🔧 修复 Agent 的 read_file 工具尝试读取二进制媒体文件的问题
• 🔧 修复飞书图片/文件下载失败，正确处理 SDK 响应格式
• 🔧 检测并处理 shell 续行提示符（如 dquote>），防止终端卡住

v10.0.0 (2026-02-15)

新功能

• 🚀 远程 Agent 访问：全新 Gateway 服务，支持通过浏览器与 AI Agent 交互——从任何设备通过 Web UI 访问你的 Agent，支持 SSE 实时流式响应和 ask_user 确认交互
• 💬 钉钉集成：接入钉钉 Stream 模式，在钉钉中直接与 AI Agent 对话，支持私聊和群聊
• 💬 飞书集成：接入飞书 WebSocket 长连接，在飞书中与 AI Agent 对话，支持交互卡片式 Markdown 回复
• 🔄 跨通道实时同步：用 SSE 事件流替代轮询，实现 Web 和 IM 通道间的实时同步
• 📋 审计日志：新增桌面端同步和操作审计日志，追踪所有远程 Agent 交互记录
• 🤖 远程上下文感知：系统提示词自动注入远程交互通道信息，让 Agent 感知用户的访问方式

改进

• 🏗️ 统一远程会话架构：Web 和 IM 通道共享单一会话，简化状态管理
• 🎨 远程访问设置页优化：重新设计设置页面，改进命名和布局
• ⚡ 流式处理优化：优化助手结束处理逻辑，保留流式文本块
• 📝 IM 集成指南：新增钉钉和飞书配置的完整帮助文档
• 🐟 品牌升级：产品从「旗鱼终端 / SFTerm」正式更名为「旗鱼 / SailFish」

问题修复

• 🔧 修复 IM 消息重复发送、SDK 加载失败和自动连接体验问题
• 🔧 修复远程标签页关闭后自动重建，PTY 生命周期改由 Gateway 管理
• 🔧 修复 chat 页面 JS 语法错误，统一设置页面样式
• 🔧 移除定时器刷新机制，改为流式结束后一次性发送完整消息
• 🔧 补充 Gateway 服务停止时的清理逻辑，优化变量声明位置

v8.20.1 (2026-02-13)

新功能

• 🌐 官网 Agent 技能展示：合并 AI 功能卡片，新增内置 Agent 技能展示

改进

• 📝 Word XML 编辑：重写编辑工具为直接 XML 操作，保留原始文档格式
• 📝 Word 会话缓存：编辑操作改为会话式内存缓存，保存时才落盘

问题修复

• 🔧 修复浏览器双窗口和登录状态丢失问题，改用持久化上下文
• 🔧 修复浏览器因残留 SingletonLock 文件导致启动失败的问题
• 🔧 修复浏览器重启后 session cookies 未保留的问题
• 🔧 修复 Word HTML 段落解析，支持无缩进段落和落款前空行

v8.20.0 (2025-02-12)

新功能

• 🖼️ 图片上传：新增图片上传功能，支持多模态 AI 消息
• 🔍 图片预览增强：增强图片预览功能，支持缩放和拖拽
• 📸 浏览器自动快照：点击/导航/切标签后自动附带页面快照，操作提示改为可读描述
• 📄 官网更新日志：添加更新日志页面到官网，自动同步 CHANGELOG 内容

改进

• 📎 合并文档和图片上传按钮，优化 AI 面板界面
• 🔧 简化 Agent 工具显示，工具调用详情和技能加载信息仅在调试模式下展示

问题修复

• 🔧 修复 Word 表格样式，解决单元格行高过大的问题
• 🔧 模型选择改为标签页独立，修复跨终端串用和执行中切换无效的问题
• 🔧 移除官网更新日志导航链接的图标，保持风格统一

v8.19.5

新功能

• 📅 日历待办事项：新增 CalDAV 日历的待办事项/任务管理功能，自动检测不支持待办的服务商
• 🌐 浏览器快照：新增 browser_snapshot 工具，捕获页面无障碍树快照以更好地理解页面内容
• 📝 Word 样式管理：增强 Word 技能的样式管理和配置支持

改进

• 🔧 更新 TypeScript 配置以支持 ES2020
• 🔄 重构日历功能的参数命名和风险级别
• 🧹 移除 AI 助手的快捷指令

问题修复

• 🔧 修复日历连接输出信息格式
• 🔧 修复日历严格模式下的用户确认逻辑
• 🔧 修复浏览器快照中不可见元素的过滤问题
• 🔧 修复浏览器点击链接弹出新窗口时超时的问题
• 🔧 修复浏览器快照 ref 机制的多个问题
• 🔧 修复定时任务调度器提前触发导致重复执行的问题

v8.19.4

新功能

• 📝 Markdown 文件打开：本地文件名支持直接点击打开

改进

• 📝 更新定时任务描述以避免无限循环
• 📝 更新本地文件写入工具的描述和警告信息

v8.19.3

新功能

• 📊 Excel 文件读取：内置文件读取工具支持直接读取 Excel 文件（.xlsx, .xls）
• 🤖 AI 错误提示：增强错误处理，将错误信息转换为用户可以理解的提示

改进

• 📊 更新 Excel 读取功能的行数限制和文档说明
• 🔧 优化 AI 服务错误处理和连接超时配置
• 📄 读取文件工具会显示读取的文件名

问题修复

• 🔧 修复用户技能更新后，技能元数据会重复的问题
• 🔧 移除不必要的 onnxruntime-node 依赖

v8.19.2

问题修复

• 🔧 修正 Windows 版本粘贴中文路径的乱码问题

v8.19.1

问题修复

• 🔧 更新媒体设备权限处理器以支持剪贴板访问

v8.19.0

新功能

• 🛠️ 技能创建器：添加用户技能创建功能模块，方便用户创建自定义技能
• 📧 邮件证书支持：添加支持自签名证书的选项

改进

• 🚀 简化引导页：大幅简化启动引导页，只保留 API Key 设置功能
• 📧 邮件展示优化：优化邮件信息展示格式、地址处理和输出摘要格式
• 🧹 代码简化：移除反思机制相关代码，简化技能加载输出

问题修复

• 🔧 确保定时任务仅在新创建的 tab 中执行
• 🔧 确保旧邮件账户的 rejectUnauthorized 字段有默认值

v8.18.3

问题修复

• 🔧 修复 Windows 系统下首次运行引导程序中启用知识库后，密码输入框无法点击的问题

v8.18.2

新功能

• 🎨 默认主题：修改默认主题为蓝色主题
• 📊 任务数显示：定时任务管理器显示待关注任务数

问题修复

• 🔧 解决语音识别在 Windows 系统中无法使用的问题
• 🔧 解决中文 Windows 路径的乱码问题
• 🔧 修复 IPC 结构化克隆错误

v8.18.1

改进

• 📝 改进 schedule_create 工具描述，引导 AI 正确分离执行指令

v8.18.0

新功能

• ⏰ 定时任务：新增定时任务功能，支持 cron 表达式调度 Agent 执行

改进

• 📝 改进计划执行提示词，允许任务提前完成时归档计划

v8.17.3

问题修复

• 🔧 禁止使用写入本地文件工具创建 Word 文档，仅可创建纯文本
• 🔧 阻止 Esc 按键事件冒泡

新功能

• 🎤 添加语音识别错误处理和提示功能

v8.17.2

问题修复

• 🔧 解决 Windows 终端中文路径乱码问题
• 🔧 修正添加邮件账户变成空白的问题

改进

• 📦 清理不必要的文件以优化模型包

v8.17.1

改进

• 📦 添加构建前自动下载模型脚本

v8.17.0

语音识别

• 🎤 语音输入：全新语音识别功能，支持语音转文字输入
• 🗣️ 高质量模型：集成阿里 Fun-ASR 的 sherpa-onnx 模型，支持中英文识别
• ✍️ 标点恢复：自动添加标点符号，无需手动输入

v8.16.0

新功能

• 📅 日历管理：新增日历功能，支持日程查看和管理
• 🔧 技能卸载：技能管理支持卸载已安装的技能

v8.15.0

新功能

• 🎮 Steam 支持：新增 Steam 版本支持
• 🔀 下载源切换：支持切换软件下载源

AI 增强

• 🔄 并行工具执行：支持并行执行工具，提升任务处理效率
• 📝 上下文优化：优化对话历史上下文保留策略

v8.14.0

架构重构

• 🏗️ Agent 服务完全重构：采用面向对象方式重构 Agent 服务，提升代码可维护性
• 🔧 提示构建器类化：重构提示构建逻辑为类（PromptBuilder），精简提示信息和工具约束
• 🗑️ 代码精简：移除废弃的进度检测器和任务规划器相关代码

AI 增强

• 🕐 时间感知：AI 提示词中增加当前时间，增强 AI 对时间的判断力
• 🔄 网络重试机制：添加 AI 请求的网络错误自动重试机制
• ⏱️ 连接超时优化：增加 AI 请求连接超时至 60 秒以提升稳定性
• 🧠 思考内容展示：增强 AI 调试功能，添加思考内容展示

界面优化

• 🔀 功能合并：合并 AI 助手与 AI 对话功能，统一对话界面
• 📊 调试界面优化：优化调试界面，合并工具调用步骤为一个，更加直观
• 🖥️ 设置窗体：放大设置窗体，提升整体视觉效果
• ✨ 流式输出优化：优化流式输出样式和步骤创建逻辑

任务管理

• 💾 执行计划持久化：增加终端执行计划的持久化支持
• 🧹 历史记忆清理：增加任务历史记忆清理功能
• 📝 Markdown 渲染：在 Debug Console 中增加 Markdown 渲染功能

测试与质量

• 🧪 单元测试：添加单元测试和代码覆盖率报告功能

问题修复

• 修复工具调用的进度显示功能
• 修复任务记忆获取功能
• 修复流式对话内容不显示的问题
• 修复 ESC 键事件传播问题
• 解决会生成空白 plan 的问题

v8.13.0

用户技能系统

• 🧩 用户自定义技能：支持在 skills 目录中创建自定义 SKILL.md 文件
  • 兼容 Claude Skill L1+L2 标准
  • 渐进式加载机制，提升性能
  • 支持 YAML frontmatter 元数据（name、description、version、enabled）
  • 应用内技能管理，支持启用/禁用切换
• 🔧 ask_user 工具：新增 Agent 向用户提问的工具，用于获取更多信息

AI 增强

• 🔍 AI 调试控制台：新增 AI 交互调试界面
• 📏 上下文长度检查：自动监控对话上下文长度
• ⏱️ 请求超时处理：新增 AI 请求超时机制，提供友好的错误提示

界面改进

• 📝 输入框自适应：文本输入区域支持自适应高度

v8.12.0

Word 文档处理技能

• 📝 新增 word 技能，支持会话式 Word 文档创建和编辑
  • 创建新文档或打开现有文档
  • 添加段落、标题（1-6级）、列表、表格、图片、分页符
  • 插入目录（TOC）、超链接、书签、批注
  • 丰富的样式选项：字体、字号、加粗/斜体/下划线、颜色、高亮、对齐方式、首行缩进
  • 内置公文格式支持（中国政府公文样式）
  • 读取文档内容（转换为 Markdown 格式）
  • 导出为 PDF（需要 Microsoft Word 或 LibreOffice）
  • 自动备份机制

v8.9.3

新技能

• 🌐 浏览器自动化技能：新增基于 Playwright 的 browser 技能
  • 支持导航、截图、点击、输入、滚动等操作
  • 登录状态保存/恢复功能
• 📧 邮件管理技能：新增支持 IMAP/SMTP 的 email 技能
  • 读取、搜索、发送、删除邮件

Agent 工具增强

• edit_file - 精确文件编辑（搜索替换）
• file_search - 快速文件搜索（macOS Spotlight / Windows Everything）
• ask_user - 向用户提问获取更多信息
• send_input - 向终端发送文本输入
• wait - 等待指定时间
• check_terminal_status - 检查终端状态

v8.7.0

技能系统

• 🧩 全新可扩展技能架构，支持按需加载
• 📊 Excel 处理技能：首个内置技能，支持会话式 Excel 读写操作
• ⚙️ 升级至 Electron 37，提升性能和兼容性

v8.4.0

新功能

• 📎 @ 提及：输入框支持 @file 引用文件和 @docs 引用知识库文档
• 📋 AI 规则：自定义 AI 指令和偏好设置
• 💬 聊天历史：查看最近会话并继续之前的对话
• 🌐 字符编码：SSH 和本地终端支持 GBK、Big5、Shift_JIS 等编码
• 🔄 自动更新：应用内检查、下载和安装更新
• 📊 会话排序：按最近使用时间排序

改进

• 🤖 Embedding 模型升级至 bge-small-zh-v1.5
• 🧠 增强记忆冲突处理
• 🎨 新增 Ayu Mirage 主题和赞助者专属主题（Gold、Sakura、Rosé Pine）

v8.0.0

双栏文件管理器

• 📂 功能完整的双栏文件管理器
  • 左右双面板布局，支持本地和远程文件操作
  • 目录树导航
  • 文本文件预览
  • 路径编辑和面包屑导航
  • 快捷键支持（Ctrl/Cmd+A、ESC 等）
  • 右键菜单操作
• 🔖 文件书签：快速收藏常用目录

其他改进

• 📋 计划归档和清除支持
• 🎨 新主题：Solarized Light、GitHub Light
• 🖥️ 右键打开文件管理器、增强提示词解析、关闭确认

v7.7.0

• ⚡ 异步加载知识库，加快启动速度
• 🌍 AI 响应语言跟随界面语言
• 📖 添加英文 README

v7.6.0

• 🔀 拖拽排序会话
• 💡 欢迎页随机提示

v7.5.0

• 🔧 统一终端服务抽象
• 📊 智能进度检测
• 🛠️ 优化工具执行器和风险评估

v7.0.0

• 🏗️ 模块化 Agent 服务重构
• 🔍 知识库 BM25 关键词搜索
• 🔐 敏感配置加密存储

v6.0.0

• 🖥️ 屏幕内容服务，智能终端分析
• 📝 独立命令执行服务
• 🌐 改进国际化支持

v5.0.0

• 🤖 任务规划器优化
• 📊 实时 Token 用量监控
• 🧠 增强主机配置和环境记忆

v4.5.0

终端感知系统

• 全面状态检测：空闲、忙碌、等待输入、卡住
• 智能输入识别：密码、确认、选择、分页器、编辑器
• 输出模式分析：进度条、编译、测试、日志流
• 卡住检测和自动建议

智能命令处理

• 四级风险评估（安全/中等/危险/禁止）
• 问题命令自动修正
• 交互式命令自动转换（top → top -bn1）
• 持续命令定时执行

动态任务规划

• 任务复杂度分析
• 多种执行策略（默认/保守/激进/诊断）
• 动态计划调整、步骤重试、替代方案

v4.1.0

• 🧠 优化向量检索性能
• 📖 改进文档分块算法
• 🔍 为 Agent 添加 search_knowledge 工具

v4.0.0

本地知识库（RAG）

• 📚 全新离线知识库功能
• 🧠 内置本地 Embedding 模型（bge-small-zh-v1.5），完全离线运行
• 💾 基于 LanceDB 的高效向量存储
• 📄 支持 PDF、Word、TXT、Markdown 格式
• 📖 智能分块策略：固定长度、段落、语义
• 🔗 与 Agent 深度集成，自动文档检索

v3.0.0

MCP 协议支持

• 🔌 完整支持模型上下文协议（MCP）标准
• 🚀 支持 stdio 和 SSE 两种传输模式
• 🧩 自动聚合多个服务器的工具、资源和提示
• 📦 内置 Filesystem、GitHub、PostgreSQL 等模板
• 🎛️ 可视化 MCP 服务器管理界面

v2.2.0

• 📁 可视化 SFTP 文件浏览器
• 📤 文件上传、下载、删除、重命名支持
• 📊 实时传输进度显示
• 👁️ 文本文件预览

v2.1.0

• 🔍 智能终端状态检测
• 💡 操作提示
• 🛡️ 严格模式优化
• 🧹 统一 ANSI 转义序列处理
• ⏹️ 增强 Agent 中止处理

v2.0.0

• 🚀 AI Agent 模式，自动化任务执行
• 🔧 丰富工具集：命令执行、终端控制、文件操作、记忆
• ⚠️ 严格模式，危险命令确认
• ⏱️ 可配置命令超时
• 📜 Agent 任务历史

v1.0.0

• 🖥️ 跨平台终端功能
• 🔐 SSH 连接支持
• 💬 AI 聊天助手
• 📥 Xshell 会话导入