文档/kaya/更新日志

21/21

Release Notes#

v2.4.4（2026-09-28）#

🐛 修复

切回标签页时屏幕一片空白：在后台跑了一段时间的日志型标签页（持续输出日志的程序，如 tail -f、npm start、部署脚本等），切回去时偶尔整屏空白、只剩左上角一个光标，要上滚才能找回输出。原因是窗口宽度变化时 kaya 会清屏等程序重绘，而日志程序不会重绘。现在只对会重绘的程序（vim、htop 等全屏应用，以及已识别的 coding agent）清屏，普通日志输出随宽度自动折行，与系统终端行为一致。
kimi code 重启会话后「运行中 agent」消失：用 kimi -r <会话ID> 恢复会话后，该终端里的 kimi code 不再被识别——侧栏卡片消失，等待确认 / 空闲等状态提醒全部静默。原因是重启后进程名从 kimi 变成了 kimi-code，不在识别名单里。现在 kaya 内置识别 agent 官方二进制的进程别名，重启后照常识别，agent 卡片的「命令名」一栏也会显示这些内置别名。

v2.4.3（2026-09-26）#

🚀 改进

任务状态实时感知,不再停在「排队中」:任务其实已经交代给 agent(比如 AI 直接往对方终端里派了活)之后再补建的待办条目,以前会一直显示「排队中」,和实际状态脱节。现在 kaya 一看到目标 agent 开始忙活,就立即把条目转为「执行中」并接管后续验收——对方干完闲下来后照常核查结果、通过即核销。同一个 agent 同时开着多个实例时 kaya 分不清该跟哪一个,这种条目会保持待执行、不自动接管,交由你手动派发。

🐛 修复

点标签页容易误触关闭:标签上的 × 关闭按钮此前一直显示,而且实际可点区域比看到的字形大不少——点标签切换时手稍微偏右就会弹出关闭确认框(只剩一个标签时甚至弹出「退出 kaya」)。现在 × 只在鼠标悬停标签、标签处于激活状态、或键盘焦点落在它上面时才显示,与主流浏览器和编辑器一致。

v2.4.2（2026-09-26）#

🐛 修复

工具使用中回复短消息,AI 的工具调用突然全部失败:在 AI 正在读终端、查任务等工具密集的对话里,你只回一句很短的话(比如「1」「继续」),接下来的工具调用会全部报红色「tool not found」错误卡片,并反复重试直到回合结束。原因是快速决策层把这类短回复误判为闲聊、临时撤掉了本回合的工具,而空白的失败反馈又让 AI 误以为只是暂时异常、不停重试。现在这类对话不再被误判,工具调用正常执行;万一工具确实不可用,AI 也会收到明确说明、直接改用文字回答,不再盲目重试。

v2.4.1（2026-09-25）#

✨ 新功能

kaya 升级为编程 agent 的总指挥:它不再只是替你传话——会把你的目标拆成可验收的任务、按自己的工作规范（小步快跑 / 改动带测试 / 验收要证据 / 失败先归因）指导 agent 干活，并全程跟踪进度。你也可以在 ~/.kaya/methodology.md 写入自己的编程规范让它遵循（规范内容会随对话发给模型，请勿写入机密）。
目标不明，先问你:需求没说清楚（缺目标或验收标准）时，kaya 会先在对话里向你质疑、确认，澄清后才创建任务——不会把含糊的任务派给 agent，避免方向跑偏白忙一场。
新增「指令确认」双模式（设置 → 模型）：默认询问模式，任务派发前逐次问你；切到自动模式后，时机成熟 kaya 直接派发排队任务，不再逐次打断你（终端写入的授权卡体系不受影响）。

🚀 改进

验收失败先归因，不再硬重试:To Do List 任务验收没通过时，kaya 会先读屏归因（任务不清 / 派发走样 / agent 卡住 / 环境问题），失败条目上直接显示归因和补救建议；自动模式下会带着归因自动重试一次（「任务不清」除外——这种情况它会直接告诉你缺什么信息，你补充后它重建清晰的任务再排队）。

🐛 修复

任务还在跑，却被误标「失败」:agent 仍在执行、侧栏显示「运行中」时，队列条目可能被误标红失败；现在验收只在 agent 真正空闲后发起，执行期间不再误烧验收次数、不再误判。

v2.4.0（2026-09-24）#

✨ 新功能

kaya 更懂你的编程 agent 了:派活之前先看对方状态:kaya 现在实时掌握每个运行中 agent 的情况——在忙、空闲、还是在等你确认、正在做什么、在哪个目录、为哪个项目干活。给 agent 转发 / 派发指令前它会先评估:目标在忙时提示「指令将排在当前工作之后」;目标已经在执行相同指令时直接告诉你,不再重复转达;60 秒内一模一样的重复指令会给出提醒,而不是默默重发。
问「它做到哪了」,有凭有据:kaya 会记住每个 agent 的最近动态;需要更多细节时,它还能按需深读该 agent 的终端记录再回答——读取内容同样经过脱敏管线。

🚀 改进

发给 agent 的指令必达:指令写入后 kaya 会读屏确认它真的被提交了;遇到长文本被当成粘贴、回车被吞导致指令滞留在输入行的情况,会自动补发一次回车。
opencode 卡片信息更全:运行中的 opencode 卡片现在显示模式(构建 / 计划)、模型与思考变体(此前只有状态与目录)。

🐛 修复

kimi code 2.x 被误判「空闲」引发反复打扰:swarm / goal 运行期间 kimi code 画面长时间静止,旧版会大约每分钟误判一次「任务已完成」并发起一次汇报回合;现在 kaya 能识别 goal 活跃标识与工作中的动画,只在真正闲下来时才汇报。顺带修复了 swarm 模式下卡片模型 / 权限信息丢失的问题。
重新绑定模型后,卡片模型名可能一直停留在旧值:claude code 等 agent 重新绑定或解除绑定模型后,侧栏卡片上显示的模型名不会更新,重启应用才恢复;现在模型库的变更会自动刷新显示。

v2.3.9（2026-09-23）#

🚀 改进

To Do List 决策链闭环:agent 自己干完的,kaya 看得见:kaya 现在会持续留意每个运行中 agent 的活动。目标 agent 闲下来时,kaya 先对照屏幕证据核查队列里的任务——发现它已经自行完成,直接标完成并告知你,不再重复派发;发现它正在做,也不会再催。
点「派发」不再卡在授权上:此前目标 tab 没授权终端写入时,点「派发」只收到一条拒绝提示;现在 kaya 会顺带弹出授权卡,你点「允许」后任务自动派出。在飞书等 IM 渠道里批准的授权,桌面侧也能即时识别,不会出现「明明授权了却派不出去」。
To Do List 条目更清爽:每条任务一行显示状态图标与目标 agent,操作(派发 / 重试 / 删除)收进悬浮操作栏,失败原因随行展示。

🐛 修复

在授权卡上点得比回合收尾快,之后可能被「意外重派」:授权卡弹出后、回合收尾前点「允许 / 拒绝」,kaya 会错误地记下一笔「待派发」,此后该 tab 任何一次无关的授权批准都可能把旧任务再次派出;现在只有授权卡仍在等待决策时才会登记。
授权卡弹出瞬间任务被删掉,点「允许」毫无反应:极小的时间窗口内任务被删除或已完成,批准会落在一个不存在的任务上;现在批准前会重新确认任务仍在等待执行。

v2.3.8（2026-09-22）#

✨ 新功能

快速决策层(默认开启):简单问题秒回,看护不再刷屏:kaya 新增一道毫秒级的「快速决策层」——闲聊、一句话问答这类不需要工具的提问走轻量回合,响应更快、更省额度;coding 模式的自动看护在打扰你之前先判断「这件事值不值得说」,刚汇报过的重复空闲、agent「正在运行」的瞬时状态都不再发起播报回合。决策请求的接收方与你对话用的是同一个模型、同一条脱敏管线,不新增任何数据去向。可在 设置 → 模型 关闭,立即生效。

🚀 改进

coding 模式更安静:每个看护回合收尾时不再固定再生一轮检查回合,只在你确实错过了提醒时才补发;通知频率整体明显下降。
AI 读终端更省额度:终端画面没有新内容时,重复读取只回一行提示、不再整屏重发;此前读到大段输出被截断后,现在用更大的读取窗口即可回读更早的历史。

v2.3.7（2026-09-21）#

✨ 新功能

跨 Agent ToDoList:任务交给哪个 agent、什么时候跑,都由你说了算:Chat 输入框上方新增 To Do List 区(默认收起,点一下展开)。AI 发现后续任务需要另一个 agent 接手时,会把任务连同上下文写进这个清单——换会话、重启应用都不丢;目标 agent 空下来时,AI 会先问你「现在执行吗」,你点头才真正派发。跑完 kaya 自动验收:通过就删掉这条;失败会留着并说明原因,你可以一键重试或让 AI 协助处理。
待办清单原样保留:你熟悉的任务清单(勾选、文件夹、归档)没有任何变化,与新的 To Do List 互不影响。

🚀 改进

项目标签按窗格区分:同一标签页里并排开的两个 agent(比如同目录的两个 kimi code)现在可以各挂各的项目标签,不再被迫同名。

🐛 修复

agent 退出后,清单里的任务「派发 / 重试」毫无动静:运行中的 agent 关闭或断线重连后,任务还记着旧的实例位置,点重试看似没反应;现在实例一消失就自动解除绑定,并在目标 agent 没在运行时明确提示。
在对话里确认「现在执行」后任务没有下文:此前确认恰好赶在另一个对话回合进行时会被静默吞掉、过一会儿又问一遍;现在会先记下你的确认,当前回合一结束就自动派发。

v2.3.6（2026-09-20）#

✨ 新功能

Slack 接入:在 Slack 里直接用 kaya:IM 渠道新增 Slack 平台(与飞书同款体验)——在 Slack 里给机器人发消息,由本机 kaya 的 LLM 流式回复;触发终端写入 / 配置修改授权时,Slack 里直接收到带「批准 / 拒绝」按钮的卡片,与桌面授权互认。配置方式:在 api.slack.com 建 app、开 Socket Mode、订阅消息事件后,把两个 token 填进「设置 → IM 渠道」(token 只存本机系统钥匙串),配合用户 ID 准入名单使用。
远程控制(浏览器)同步 agent 状态:浏览器端的远程控制页现在能看到每个运行中 agent 的状态行(模型 / 思考档位 / 权限模式 / context 用量)与所在目录,与桌面侧栏卡片一致。

🐛 修复

Slack 授权卡片连点两下会重复生效:快速双击「批准 / 拒绝」会重复发确认消息、并可能多补一轮对话,已修复——同一卡片的同一按钮只生效一次。
镜像入口的平台名说错:设置里切换了 IM 平台后,顶栏镜像按钮的提示文案可能还说成另一个平台,已改为始终以正在运行的渠道为准。
长回复中途被打断时,IM 里的消息收尾不完整:超长内容被平台拒收导致只剩一条「已中断」,已修复为正文(截断)+ 中断标记一起收尾。

v2.3.5（2026-09-20）#

✨ 新功能

侧栏卡片新增状态行:模型 / 思考档位 / 权限模式 / context 用量:运行中 agent 的卡片上一眼看清它当前跑的什么模型、什么思考档位、什么权限模式、上下文还剩多少(kimi code 四项全有;claude code 显示权限模式;codex 显示模型;opencode 暂不支持)。宽度不够时只保留关键段,鼠标悬停可看完整内容。
终端满屏时 agent 状态栏依然常驻:此前终端满屏(⛶ / ⌘⇧F)会把侧栏一起隐藏;现在它以可开合的面板常驻窗口左缘,宽度可拖拽调整。
Chat 面板可收成窄栏:对话面板右缘新增 ‹/› 把手——点 ‹ 收起对话、终端占满全宽,点 › 展开回来。
更多「待决策」界面能被识别:kimi code 的问答面板、codex 的补丁审批 / 权限请求 / 目录信任确认、claude code 的计划审批、opencode 的问答面板与权限二次确认等,kaya 都能识别为「等待你决策」,并在侧栏卡片上直接给出选项按钮,点一下就作答。

🚀 改进

侧栏宽度自由调整:无论是对话旁的內联侧栏还是终端满屏时的常驻面板,展开后都可以拖拽右缘把手调宽。
权限模式文案更直白:显示为「总是询问 / 按需询问 / 从不询问」等,不再是看不懂的内部代号。
卡片更清爽:标签页副标题行只在标签被重命名过时显示,默认不再重复占位。

🐛 修复

kimi code 2.x 的状态栏识别修正:此前卡片状态行的模型与 context 用量不显示、权限模式永远显示「默认」、切换模式后不更新——已按 kimi code 2.x 的实际界面全部修正。
任务清单的「标记完成」勾选框被悬浮操作栏盖住:面板较窄时 hover 任务行无法勾选完成,已修复。
顶栏模型切换器按钮尺寸:此前比周围图标按钮大一圈,已对齐。

v2.3.4（2026-09-19）#

✨ 新功能

任务队列:把任务排队派给忙碌的 agent:一个 agent 干着活、后续步骤需要另一个 agent 配合时,把任务排进队列——目标 agent 忙完自动接手,干完由 kaya 再跑一轮验收, pass / fail 都会通知你,中途需要你授权写入时会明确提示。任务面板新增「队列」标签页,可随时查看状态、手动派发、重试或删除;队列内容只存在本机,重启不丢。
待办清单支持归档:暂时不做的任务可以归档收进面板底部的折叠区,随时恢复;归档的任务不会出现在 AI 看到的清单里,也不占序号。
给运行中的 agent 标注项目:每个终端标签页可以编辑一个「项目」标签(点侧栏卡片上的项目行直接改),多项目并行时一眼认出「这个 agent 在为哪个项目干活」,@ 唤起列表里也能按项目名搜到。
点击侧栏 agent 卡片,自动汇报运行状况:点一下运行中 agent 的状态卡片,kaya 会读一眼它的终端画面,简要告诉你它现在干到哪了、是否在等你确认——不用切过去逐行看。

🚀 改进

更省内存、重连更快:终端历史(scrollback)改为分块流式加载,大日志不再整文件一次性读入,内存峰值显著下降;附带修掉了若干只增不减的内部缓存,长时间使用后内存占用更平稳。
@ 唤起列表过滤更聪明:输入短字符(如 @u)时优先按名称 / 项目标签精确匹配,不再被一堆同目录的 agent 淹没;没命中时再回到宽松的宽匹配。

🐛 修复

队列边界场景健壮性:目标 agent 中途退出、验收连续失败、应用重启等边界情况下,队列任务都能正确定局(回到队列或标记失败),不会滞留为「执行中」或重复派发。
终端启动失败自愈更彻底:终端创建失败、历史重放卡死等异常路径现在都会完整清理内部状态,重连后画面正常,不再出现 pane 空白且无提示的情况。

v2.3.3（2026-09-18）#

✨ 新功能

审计会话可展开事件时间线：审计页点任一会话卡片，可展开逐事件详情——用户输入（含脱敏计数）、AI 每个回合、每次工具调用的决策与执行结果（退出码 + 输出），错误标红、超长输出自动折叠。「那次对话 AI 到底做了什么」现在完整可查。
出错了可以一键重试：对话因网络超时、provider 错误等失败时，错误提示上新增「重试」按钮，按你刚才发送的原文重发，不用重新输入。

🐛 修复

新建标签页偶尔永久空白：「+」或 ⌘T 新建的标签页在窗口尺寸等特殊时序下可能一直空白且无提示；现在会自动重试创建，实在失败则明确显示「已断连」并提供重连入口。
调整窗口或分屏后 AI 重复自动回合：拖动窗口大小、开合分屏会被误判为「对方开始工作了」，触发重复的自动对话轮次；现在 resize 不再干扰忙碌/空闲判断。
开新会话后旧标签页的自动回合「复活」：/new 开新会话后，旧标签页的等待事件可能错误地在新会话里再起回合，或出现 unknown tab_id 报错；现在开新会话会干净切断旧绑定。
修复终端折行回显中敏感信息可能不被脱敏的问题（隐私）：在终端输入的超宽行（如长卡号）被 shell 折行重绘时，脱敏规则可能识别不到被折散的片段。影响面：折行重绘场景下终端读取内容中的卡号类信息。建议所有用户升级。
Esc 停止不稳定：焦点不在输入框时 Esc 无法停止 AI 回复；现在流式回复期间任何位置按 Esc 都能停止，并立即显示「已停止本次回复」反馈。同时修复 Esc 在任务面板、标签页重命名、输入法选字、顶部菜单打开时被误当作「停止回复」的问题。
关闭分屏窗格的确认文案：实际只关窗格时，确认框不再提示「关闭 Tab」，文案与行为一致。
无效 Shell 路径保存后终端断连：设置里保存一个不存在的 shell 路径会导致终端 Disconnected 且难以察觉；现在保存前即校验（存在 / 是文件 / 可执行，Windows 相应放宽），非法路径给出明确提示、不会落盘。
安装失败时错误网页糊满设置界面：网络封锁场景下安装 Agent 失败，会把整页 HTML 错误内容直接显示在界面上；现在错误日志默认折叠、超长行截断。
模型端点开关三处问题：三个端点全关时的报错没说清「至少启用一个」；关掉 OpenAI 端点后 Agents 面板无感知；关闭端点会丢掉已填配置。现在分别给出专门提示、面板显示「端点已停用」并禁用绑定、停用保留配置可原样恢复。
设置项语义标注：即时生效项（语言、滚动历史）标注「即时生效」，与需要点「保存」的项区分开。
Windows：设置页显示的 Shell 与实际终端不一致：Windows 上设置页曾显示失效的 /bin/zsh 而实际终端跑 PowerShell；现在启动时自动调和为实际值，「跟随系统默认」的语义不受影响。
审计评估结果看不到：审计页跑完评估后结果渲染在会话列表下方，视口内没有任何变化；现在评估完成自动滚动到结果。

🚀 改进

内置 Agent 知识库更新：Claude Code / Kimi Code / OpenCode 官方文档快照更新至最新（kimi-code 的 goal 指南已随官方文档下线移除）。
手册与文案对齐：模型配置的入口统一表述为「设置 → 模型」；API Key 存放口径统一为「本机系统钥匙串，仅随请求发给你配置的模型端点」；产品手册中过时的配置路径（「通用 → LLM 小节」）全部改为现行流程（顶栏模型切换器 + 设置 → 模型）。

v2.3.2（2026-09-16）#

✨ 新功能

远程访问（云中继）：不在电脑前也能推进任务——从浏览器远程查看和操作这台设备上的 kaya，对话、运行中的 Agent 状态、授权审批都与桌面实时同步。开启方式：设置 → 远程访问，打开开关（需登录 yunhou 账号并有有效订阅），然后在浏览器登录 yunhou 官网打开「远程控制」页即可访问。隐私边界：默认关闭、显式开启，关闭即断连；对话内容经服务器中转时仅内存透传、不落盘；API 密钥不经中转，仍由本机直连模型服务商；全程 TLS 加密。可自定义设备名区分多台设备，面板实时显示连接状态与最近活动。

🐛 修复

运行中 Agent 状态栏窄窗口两处修复：小窗口下侧栏变成浮层抽屉盖住大半对话区时，点击抽屉外的遮罩即可关闭，不再没有脱困路径；同时窄窗口下重启应用不再把侧栏恢复成盖屏抽屉，只有窗口足够宽时才还原展开状态。

🚀 改进

内置 Agent 知识库更新：随版本内置的 Claude Code 官方文档快照更新至最新，问答「某个 Agent 怎么用」类问题的答案更准确。

v2.3.1（2026-09-16）#

✨ 新功能

对话里用 @ 直接点名运行中的 Agent：在对话输入框敲 @ 会列出当前正在运行的编程 Agent（可继续输入过滤），选中即绑定为当前会话的转发目标，@实例ID 会带入输入框，你能直接看到消息将发给谁——之后的消息直接转给该 Agent，无需先打开 /agents 手动绑定。与侧栏卡片、/agents 是同一条绑定通道。

🐛 修复

修复多轮工具调用后报「400 reasoning_content」错误中断的问题：使用默认开启思考的模型（如 DeepSeek、Kimi、MiniMax 的新版本）时，即使思考链显示开关处于关闭状态，长任务在多轮工具调用后可能反复报错中断；现在思考链内容会正常随对话保存并回传给模型，开关关闭时界面仍不显示思考块。受此影响的旧会话可开新会话恢复。

🚀 改进

内置 Agent 知识库更新：随版本内置的 Claude Code / Kimi Code / OpenCode 官方文档快照更新至最新，问答「某个 Agent 怎么用」类问题的答案更准确。

v2.3.0（2026-09-15）#

✨ 新功能

运行中 Agent 状态栏（coding 模式专属）：对话面板左缘新增可开合的侧栏，总览所有正在运行的编程 Agent —— 每张卡片显示实例编号（如 kimi-code #2，编号全局递增）、当前状态（等待你决策 / 空闲 / 运行中）与所在标签页、工作目录。点卡片一次完成「切到对应标签页 + 绑定为当前对话的转发目标 + 聚焦输入框」，之后直接在对话里对它下达指令；「等待你决策」的卡片上会直接列出对方的选项按钮，点一下就作答，不用切标签页。侧栏与对话区按固定比例分宽，窗口太窄时自动变成浮层抽屉，不再挤压对话区。
改了名的 Agent 也能识别：如果你把编程 Agent 的 CLI 命令改了名（比如用 myclaude 替代 claude），在 Agents 面板该 Agent 卡片的「命令名」一栏补上这些名字（逗号分隔），安装检测、前台运行识别、启动命令会同时认原名与自定义名 —— 不再误报「未安装」，对话端代发指令、/agents 绑定、等待/空闲通知等全链路对改名 Agent 照常工作。

🚀 改进

内置模型「上游拒绝 (502)」自愈与分类指引：遇到上游模型拒绝请求时，kaya 会先自动压缩早期对话历史并重试一次（仅影响 AI 的上下文，你看到的聊天记录不变），多数上下文超长的场景无需手动处理即可恢复；仍然失败时，错误卡片会按具体原因给出指引（上下文超长 / 内容审核 / 额度不足），并附「开新会话」按钮一键重开（内容审核与额度不足类不适用，不显示该按钮）。
内置 Agent 知识库更新：随版本内置的 Claude Code / Kimi Code / OpenCode 官方文档快照更新至最新，问答「某个 Agent 怎么用」类问题的答案更准确。

🐛 修复

修复最终回复偶现一整段工具调用标记文本的问题：个别情况下 AI 的最终回复里会混入一段 <|DSML|…> 工具调用标记并伴随告警横幅；现在这类变体标记能被正确识别并恢复执行，不再原样显示。

v2.2.5（2026-09-13）#

🐛 修复

聊天首屏空白、切换终端标签页后空白的问题自动恢复：此前打开对话或切回某个终端标签页时，内容其实已经生成但屏幕一直空白，滚动一下才出现。本版加入了自愈兜底，出现这类空白时会自动重绘，无需再手动滚动触发。
Agents 面板模型列表布局修复：修复供应商条目里提示文字把模型名称、「使用中」徽标和「使用」按钮挤压重叠、列表底部被裁切的问题，提示文字现在会整齐地显示在条目下方。
本地构建的安装包补全安装引导：自行构建的 dmg 安装窗口现在也有「拖到 Applications」的箭头引导，与正式发布版本一致。

v2.2.4（2026-09-13）#

✨ 新功能

模型库可为 OpenAI 端点声明协议能力：Codex 官方只支持 Responses 协议，而 Kimi Code / OpenCode 使用对话补全协议。现在「设置 → 模型列表」的 OpenAI 端点新增「协议能力」选项（对话补全 / Responses / 两者），Codex 卡片只允许绑定声明了 Responses 的条目，缺声明时按钮会禁用并给出修改入口；已有绑定不受影响，只显示提醒。DeepSeek / Kimi Coding Plan / OpenAI 官方预设已预填「两者」。
Agents 面板新增「解除使用」：绑定后随时可让某个 Agent 退出该模型（回到它自己的默认行为），只影响这一个 Agent —— 条目本身与其它 Agent 完全不受影响；没有绑定时不产生任何变化。

🚀 改进

Codex 配置面板显示启动命令：kaya 为 Codex 写的模型配置只在 codex --profile kaya 下加载（与 ChatGPT 桌面版共存的隔离设计），面板现在直接显示这条命令，并说明手动裸跑 codex 看不到这里配置的模型。
DeepSeek 预设更新：模型名统一为官方现行的 deepseek-flash，并注明 DeepSeek 官方已支持 Responses 协议 —— 在模型库的 OpenAI 栏填 deepseek-flash 即可直连 Codex。
Agent 安装状态更真实：当某个 Agent 装在非默认的 Node 版本下、在终端里其实用不了它时，Agents 面板会明确提示，并提供「安装到当前环境」一键修复（只有你点按钮才会执行，不会自动改动）。

🐛 修复

Codex「配好模型却找不到模型」根因修复：修复探测 Codex 模型目录时大输出导致进程卡死、生成失败被静默忽略的问题；生成失败现在会留下可排查的警告，已生成的过期目录会在下次启动或改库时自动重建。
「对话补全」条目在 Kimi Code / OpenCode 上点「使用」不再失败：此前这类条目按钮可点、保存时报「没有 OpenAI 端点」；绑定与自动同步现在使用同一套解析，回退规则一致。
「解除使用」的状态与提示修正：解绑局部失败不再误报为解绑失败；条目没有可用 OpenAI 端点时给出的提示可实际执行（先启用并填写端点）；一次解绑涉及的其它 Agent 卡片会同步刷新状态。

v2.2.3（2026-09-12）#

🐛 修复

终端卡死、切屏后空白的问题彻底修复：此前在 OpenCode 等编程 Agent 中粘贴内容后可能输入无响应，切换焦点后窗格变成空白、只能关闭重开。根因修复后，即使同类异常再次出现，受影响终端也会自动恢复，不再拖垮窗格和 kaya 的终端读取能力。

🚀 改进

飞书 / 企业微信不再刷屏工具调用消息：此前 AI 助手每调用一次工具（执行命令、读取终端等）就会发一条独立消息，一轮最多二十多条、全部堆在回复下方。现在只保留失败或被安全策略拦截的调用提示（一行说明哪个工具没成功），正常调用不再打扰。

v2.2.2（2026-09-11）#

🐛 修复

聚焦 / 切屏后终端卡死、屏幕永久空白(含 OpenCode)彻底修复：v2.2.1 只补住了其中一个原因,本版把叠加的三条路径全部修掉 —— 隐藏中的终端窗格不再被按接近 0 的宽度重新计算、清屏与窗口尺寸通知改为严格同步、聚焦切换时终端不再被动画挤压出中间尺寸;正在运行的编程 Agent 不会再因收到异常尺寸而卡死或空白。
Windows：clear / cls 现在能正常清屏:此前为保护滚动历史把 Windows 清屏序列的一部分丢弃后,可视区会残留旧内容、看起来「清了又没清」。现在清屏命令可视区一定清干净,滚动历史仍完整保留。
Windows：终端里 Ctrl+Alt+方向键 不再冒出乱码:该组合是应用自己的窗格导航快捷键,此前方向键转义序列会同时漏进终端。
Windows / git-bash：补全终端初始化:在 git-bash 下启动的终端现在也有独立命令历史、空闲/目录标记与工作目录跟随 —— 之前缺少工作目录标记会导致每次回车后都提示「目录不存在,已回退到主目录」。
Windows：更可靠地识别正在运行的编程 Agent：修复通过 npm 安装的 CLI(如 Kimi Code)在 Windows 上不被识别、导致「发送到 Agent」「等待确认」与 /agents 绑定失效的问题;同时修复默认 Node 安装布局下 Agent 的更新 / 卸载不可用。
Windows：命令通配符正常展开:修复在 bash / git-bash 下运行命令时 * 等通配符被静默当成字面量、不再展开的问题。
Windows：配置项较多时保存密钥不再报错(系统凭据存储有大小上限),同时避免一次偶发读取失败误清掉其它已保存的密钥。
Windows：修正全局命令历史与命令扩展名解析：不再创建无人使用的 .zsh_history,也不再因反斜杠路径而误判文件扩展名(该解析用于判断 ~/.kaya 下文件重定向是否允许,属安全加固,建议尽快升级)。

🚀 改进

Agent 列表精简：移除 CC Switch 与 Reasonix 两个条目,只保留 Claude Code / Kimi Code / OpenCode / Codex 四个协同 CLI;升级后旧版残留的相关文档快照也会被清理。

v2.2.1（2026-09-11）#

✨ 新功能

模型配置只配一次，Chat 和编程 Agent 共用：设置页「模型列表」就是编程 Agent 的供应商库 —— 同一份配置，在**「设置 → 模型列表」**里统一维护（新增 / 修改 / 删除都在那里，Agents 面板只负责把条目绑定给某个 Agent）。同一条配置可以同时带「对话」「Anthropic」「OpenAI」三种端点，Claude Code 取 Anthropic 那栏，Kimi Code / OpenCode / Codex 取 OpenAI 那栏（未填时回退用「对话」那栏），对话侧优先「对话」那栏（未填时回退「OpenAI」那栏），配一次两边都能用。API Key 统一存在系统钥匙串里，不再明文写在配置文件中，旧版按 agent 分开保存的配置会在升级后首次启动时自动迁移合并。
代理行为可预期：kaya 自身发起的网络请求（对话、账号、更新检查、联网搜索、渠道连接等）不再跟随系统代理设置，默认一律直连 —— 系统里配了全局代理也不会影响 kaya 的本地使用体验。两处例外：① 飞书 / 企业微信的消息收发由第三方 SDK 发起，仍会读取 HTTP_PROXY / HTTPS_PROXY 环境变量（从终端启动且 shell 带这些变量时才会命中，双击启动通常不受影响）；② 界面内由系统 WebView 发起的请求（如审计页的模型评估）跟随 WebView 自身的网络设置。

🚀 改进

模型只在「设置 → 模型列表」里配，Agent 面板只负责选用：以前模型的端点、模型名、API Key 可以在设置页和 Agents 面板两处分别编辑，两处都能写进 Agent 的配置文件，容易配出互相打架的两份。现在模型（包括「对话」「Anthropic」「OpenAI」三种端点）统一在一处管理：在「设置 → 模型列表」里新增或修改条目，再到 Agents 面板点「使用」把它绑定给某个 Agent。Agents 面板不再有「添加 / 编辑 / 删除」，列表为空时会给一个「去模型列表添加模型」的入口。
模型配置不会再被别的路径偷偷改掉：AI 助手在排查配置时仍能查看 Agent 的配置文件，但不能再改其中的模型名、接口地址或密钥 —— 这类修改一律被拒绝，并会提示你去模型库操作。

🐛 修复

聚焦时正在运行的编程 Agent 不再卡死 / 花屏：修复在聚焦模式（右上角 ⛶ 按钮或 ⌘⇧F / Ctrl+Shift+F）隐藏终端时，终端面板并未真正从布局中移除、而被按接近 0 的宽度重新计算 —— 正在运行的编程 Agent（实测 OpenCode）会因此反复收到极小的窗口尺寸变更通知，导致自身卡死、终端花屏，严重时整个应用无响应、标签与窗格都点不动。现在聚焦时终端会正确隐藏，Agent 不再收到异常尺寸通知。
删除模型条目会一并删除它的 API Key（确认框中有提示）；删除当前正在使用的模型后会自动切换回内置模型，不会残留一个用不了的选中项。
编辑模型条目时保存不再误删 API Key：此前在密钥刚打开编辑、还没读取完成的瞬间点保存，可能把已保存的 Key 静默删掉。
升级迁移更稳：迁移后重复启动不会出现重复条目；旧格式（按 agent 分桶）的配置无论带不带版本号都能正确迁移。
修改或删除模型配置后，正在使用它的编程 Agent 会真正跟着变：此前只有点「使用」的那一刻配置才会写进 Agent，之后在模型库里改端点、换 API Key、清空 Key 或删除条目，Agent 侧都停在原样——改了 Key 不生效，删掉条目后 Agent 还在用被删的模型和那串已经删掉的密钥（明文留在 Agent 的配置文件里）。现在：
- 修改条目后，正在使用它的 Agent（Claude Code / Kimi Code / OpenCode / Codex）自动更新，不需要再点一次「使用」；把 API Key 清空，Agent 配置里遗留的那串密钥也会一并清除。
- 删除条目后，与本条目处于绑定关系的 Agent 会退出 kaya 的配置、回到它自己的默认行为，不再继续使用被删的模型与密钥，配置文件里也不会再残留明文密钥。
- 没在用的 Agent 完全不受影响；你在这些配置文件里的其它字段、其它供应商配置一律保留。
- 面板上的「使用中」现在反映真实的绑定关系（值恰好相同但并未在用的条目不显示为「使用中」）；如果某个 Agent 的配置文件被别的工具改过 —— 端点值变了，或者里面的 API Key 被改掉、删掉 —— 条目会提示「配置文件已被外部修改」，点「使用」即可重新应用（此前这种情况既没有提示，按钮也点不动）。
- kaya 只接管自己写过的配置：如果你自己手写过某个 Agent 的配置文件（即使端点与库里某条恰好相同），kaya 不会把它当作「使用中」，之后删除条目时也不会改动它 —— 你手写的端点、模型名和密钥都保持原样。
- 某个 Agent 的配置文件损坏时只影响它自己：其余 Agent 的配置照常更新，出错的那个下次操作时会自动重试。
- 从更早版本升级残留的 Codex 痕迹也会清干净：早期版本曾直接改写 Codex 的官方配置文件，现在删除条目时会把那些痕迹一并摘掉，不会留下指向已删除内容的无效设置。
- 升级后，此前用「使用」配好过的 Agent 会被自动识别并纳入管理，无需重新配置（识别的依据是配置文件当前的值在库里有唯一对应的一条；值已被改过、或对应条目已被删掉的不会被认领）。
- 一个例外：kaya 没能认领这份配置时（配置里没有 kaya 写过的标记 —— 例如 2026-09-09 之前 kaya 写过 Claude Code 的配置、之后再没点过「使用」，那份文件里还没有识别用的标记；或配置文件里的端点值与库里任何条目都对不上；或对应条目在认领发生之前就已经被删掉），那份 Agent 配置文件里遗留的 kaya 设置与明文密钥不会被自动清理 —— 对该 Agent 重新点一次「使用」即可收敛，或手动恢复同目录下的 .bak。（v2.2.0 及更早的版本没有绑定记录，升级后的首次识别只能靠配置值与库条目唯一匹配。）
- 请注意：删除条目不会把 Agent 配置恢复成 kaya 接管之前的旧值（那些值在应用时已被覆盖，无法还原）——需要旧配置请手动恢复同目录下的 .bak 备份。

v2.2.0（2026-09-09）#

✨ 新功能

模型供应商集中管理：Agents 管理中心的供应商配置升级为全局库——一条 API key 只需配置一次，即可同时给 Claude Code / Kimi Code / OpenCode / Codex 多家编程 agent 使用；预设表新增 Kimi Coding Plan、MiniMax 等，旧版按 agent 分开保存的配置会自动迁移合并。
新增 Codex 支持：Agents 面板现在可以检测、安装、启动 OpenAI Codex，并像其他 agent 一样集中配置模型供应商。注意：Codex 目前仅支持 responses 协议的端点，仅提供 chat 协议的端点（如 DeepSeek 直连）暂时无法搭配使用（Codex 官方限制）。

🐛 修复

kaya 的 Codex 配置不再影响 ChatGPT 桌面 app：此前 kaya 写入的 Codex 配置与 ChatGPT 桌面 app 共享同一文件，可能导致 app 的模型请求被发往错误端点、官方功能无法使用。现在 kaya 的配置完全隔离在独立的 profile 中，与 app 互不干扰，旧配置会自动迁移清理。
Codex 自定义模型可用性：修复配置自定义模型后启动必现「Model metadata not found」警告、且 /model 选择器中找不到已配置模型的问题，现在自定义模型正常出现在选择器中。
Claude Code 自定义模型三连修复：修复配置自定义模型后启动时出现 unrecognized-model 提示、在 /model 中选择 Opus/Sonnet/Haiku 档位会把内置模型名发往第三方端点导致报错、以及选择器列表找不到已配置模型三个问题。
agent 检测更准：修复部分机器上 agent 面板偶发显示「版本未知」、以及命令行工具只安装在 nvm 非默认版本时被误报「未安装」的问题。

v2.1.17（2026-09-08）#

🚀 改进

对话界面更清爽：coding 监控、授权确认、定时任务等自动回合的横幅现在只显示一句事实（例如「kimi-code 正在等待你的确认：Run this command?」），不再把完整的 AI 内部指令逐字展示；发给 AI 的指令内容不变。
错误提示说人话：命令被安全策略拦截时，提示从内部代码改为可读说明（悬停仍可查看原始代码）；连接超时、工具调用上限等横幅不再附带英文技术细节，只保留可行动的指引；授权卡片不再显示没有行动价值的进程号。
定时任务审批卡更易读：摘要直接显示任务内容，不再是一串 UUID；批准或拒绝后，卡片保留你决策那一刻的摘要，即使期间任务被改名或删除也不会退化成乱码。
中文界面细节：system 角色标签显示为「系统」，三条提示横幅的标点恢复为规范全角。

🐛 修复

飞书/企微远程编程时 AI 找不到命令：此前安装版 app 里，远程回合执行命令的环境与桌面对话不一致，brew / nvm / cargo 等工具会报 command not found；现在远程回合与桌面对话使用完全相同的环境。Windows 端同时修复：自定义 npm 目录安装的命令行工具不可见、定制终端启动丢失 PATH 条目两个问题。
自动回合与远程回复进一步避让：coding 模式的自动回合在触发前先检查远程是否有进行中的回复，触发后被拒会静默撤回，不再出现「正在让 AI 继续…」的假横幅；若干边缘时序下对话状态被误重置、回复漏记录的问题一并修复。

v2.1.16（2026-09-06）#

🚀 改进

订阅到期后的引导更友好：订阅或试用到期后，内置模型的提示不再只让你去续费——现在会明确告诉你也可以切换为自有模型（BYOK）继续对话，并新增「使用自有模型」按钮：已配置过自有模型可一键切换，没配置过则直接打开模型设置页。任务提炼等入口的提示同样对齐；登录、订阅类报错不再显示内部技术字段。
渠道连接更透明：飞书/企微渠道面板新增「最近收到消息 x 分钟前 / 从未」与陌生人消息拦截提示；远程发来的通知标题不再出现乱码占位符。

🐛 修复

启动即崩溃（严重）：v2.1.16 初版安装后无法打开，启动瞬间闪退，影响全部用户。本次重发已修复，请所有已下载 v2.1.16 的用户重新安装。
订阅在远程渠道运行期间到期、取消或登出后，渠道不再继续运行：现在会自动停止渠道、关闭远程编程总开关并提示，续费后自动重连。建议尽快升级。
飞书「发了消息没反应」的多个静默场景：富文本消息现在能提取文字后正常回复；暂不支持的文件/表情/合并转发等消息类型会明确回复「暂不支持」而不是沉默；只@机器人没带内容的空消息会收到引导提示；超长命令输出被截断时现在会真正告知。
远程编程卡片偶发定格或重复：修复快速连发消息时「思考中…」卡片可能永久定格、或同一回合出现两张卡片的问题；被中断的回合会正确显示「已中断」；授权卡片重复点击或重复投递只生效一次，发出超过一小时的授权卡片会被拒绝并提示。
桌面自动回合可能打断飞书正在进行中的回复：Coding 模式下桌面端的自动回合与远程消息回合现在会正确避让，不再互相打断。
渠道偶发启动后停不掉、状态不可见：修复快速重复启动可能产生孤儿连接的问题；手动停止渠道现在同时关闭「启用」开关，重启后不会再被静默拉起；渠道意外断开后会自动退避重连。
AI 的「思考草稿」混入回复正文：部分模型会把思考过程直接混在回复里，显示在对话和飞书中；现在送达前会自动剥除（开启思考模式时归入「思考过程」区域），历史记录中已有的污染内容也会自动清洗。
macOS 全屏后「上半屏显示、下半屏全黑」：在部分 macOS 版本（如 macOS Tahoe 26.6 Beta）搭配外接显示器时，首次打开 app 恢复全屏后窗口可能只渲染上半屏（上游 WebKit 问题，退出全屏再进入可恢复）。现在全屏切换后会自动校验并纠正画面；若您仍遇到，日志已记录现场信息，欢迎反馈帮助我们彻底修复。
Coding / 镜像开关状态可能与实际不一致：开关操作失败时现在会回滚界面状态并提示，不再「显示开着、实际没开」。

v2.1.15（2026-09-05）#

🐛 修复

飞书「能收不能回」：Mac 合盖睡眠再唤醒后，kaya 发给飞书的回复可能长时间发不出去（最长约两小时才自行恢复），期间飞书消息仍能正常收到。现在 token 失效会自动强制刷新并重发，唤醒瞬间网络未就绪的发送失败也会自动重试一次。
终端上滚后敲命令不再停在原地：此前运行 ps aux 等长输出后向上翻看历史，再敲键盘时光标画面不会跳回最新位置；现在与 iTerm 行为一致，任何输入都会先滚回底部。
设置弹窗标签竖排逐字换行：设置标签页增多后，「通用」等标签标题会被压成一个字一行竖排显示；现在标签保持单行，放不下时横向滚动。
跨屏拖动窗口后终端列宽失配：在 Retina 屏与普通分辨率外接屏之间拖动窗口（或切换 Windows 缩放比例）后，终端可能出现右侧空隙或差一列的问题，现在会自动重新适配。
标签页重命名输入框偶发退出编辑：系统繁忙时双击重命名标签页，输入框可能刚打开就因焦点被后台终端抢回而意外退出编辑（改名丢失）；现在切换标签页不会再从输入框中抢走焦点。

v2.1.14（2026-09-05）#

✨ 新功能

自带密钥（BYOK）服务商扩容：自定义模型的服务商预设从 5 个增加到 11 个，新增 Kimi（Moonshot）、GLM（智谱）、MiniMax、Qwen（DashScope）、SiliconFlow、OpenCode Zen，默认模型均按各厂商当前在役版本核定；支持思考模式的模型会自动带上正确的推理参数。
使用情况统计：用于了解产品整体使用情况（活跃天数、使用时长、平台与版本分布），登录后默认开启，可随时在「设置 → 账户」关闭。统计内容不含任何对话内容、文件内容或个人身份信息，未登录时完全不上报。

🚀 改进

本地存储空间写满时，不再弹容易错过的临时提示，改为在对话中显示醒目横幅，并给出可操作指引（点顶部「+」开新会话即可释放空间，历史对话仍完整保留在本地审计日志中）。

v2.1.13（2026-09-03）#

✨ 新功能

聊天里管理定时任务：直接在对话中让 AI 查询、新增、删除、启停你的定时任务（例如「帮我加一个每天早上九点总结终端输出的任务」）。涉及改动的操作会弹出一次性授权卡，你确认后才生效。
定时任务次数上限：创建任务时可设置最多运行次数（例如「每分钟一次，跑 10 次」），跑满后自动停用并保留记录；设置表单新增可选次数输入，列表中显示运行进度。

v2.1.12（2026-09-02）#

✨ 新功能

定时任务：在「设置 → 定时任务」中创建自动化任务，让 kaya 每隔 N 分钟或每天固定时间自动以你的名义发起一轮 AI 对话（例如每十分钟检查一次构建状态、每天早上九点总结终端输出）。任务只在 app 运行时触发。
标签页重命名：双击标签页标题即可重命名，便于区分多个并行会话；重名会被拒绝并提示，名称重启后保留。

🐛 修复

修复关闭当前聚焦的终端窗格后键盘输入「断流」（焦点丢失到页面背景）的问题，现在焦点会自动落到相邻窗格。

v2.1.11（2026-09-01）#

🌐 弱网与断网兜底全面加强

网络变慢或断连时，AI 对话握手自动重试，并尊重服务端的限流退避提示，弱网下对话成功率明显提升。
弱网扫码登录失败后自动退避重试，不再一次失败就只能重新扫码；网络恢复前显示「网络异常，后台重试中」状态，可手动立即重试。
飞书/企微渠道：发送增加超时保护、连接断开自动带抖动退避重连、异常退出有日志可查；长时间挂起不再出现。
agent 安装/更新/卸载增加超时保护，npm 卡死时不再永远停在「安装中」；网络搜索限流时自动按提示退避重试。
审计评估增加超时保护，网络半开时不再永远显示「评估中」。

🐛 修复

修复重启后飞书/企微镜像开关显示开启、实际却收不到消息的问题；顶栏镜像图标改为三态（未运行/未绑定置灰可点击引导，已绑定为正常开关）。
修复编程 agent 后台任务仍在运行时误报「任务完成」的问题；完成通知附带任务最后的实际输出摘要，措辞改为「似乎已完成」。
安装包（dmg）安装窗口增加拖拽指引背景图。

v2.1.10（2026-08-31）#

🔒 安全更新

收紧 AI 执行 shell 命令的策略边界，修复多处策略绕过风险（涉及文件读取、命令执行、下载校验等路径）。
加强「向编程 agent 发送输入」的安全校验：拒绝夹带终端控制序列与不可见 Unicode 字符的输入，提交动作执行前复核目标状态。
收紧 agent 配置写入边界：可让编程 agent 执行任意命令或提升权限的配置项一律禁止修改。
输出脱敏新增 8 类常见密钥格式识别（JWT、Slack、npm、PyPI、SendGrid、DigitalOcean、Shopify、Twilio 等）。
建议所有用户尽快升级。

🚀 性能与资源

终端输出传输改为高效编码，大输出场景下界面响应明显更流畅。
后台监控空闲时自动降频：没有运行中的编程 agent 时，CPU 占用显著下降。
会话历史增加内存上限，长时间使用的内存占用大幅降低。
终端日志写入开销减少；审计日志自动保留 90 天，不再无限堆积。

🐛 修复

修复个别内部错误会导致聊天永久卡在「生成中」的问题，现在会正常报错并恢复。
修复飞书/企微渠道在异常情况下可能长时间无响应的问题。
修复加载较慢的 shell 配置（nvm/conda 等）偶发导致终端环境变量丢失的问题。
修复本地存储写满时聊天记录静默丢失的问题，现在会明确提示。
agent 安装过程的输出先做脱敏再显示，避免安装脚本输出中可能夹带的凭据短暂暴露。

v2.1.9（2026-08-30）#

🐛 修复

修复 Windows 上分屏快捷键（Ctrl+Shift+D / Ctrl+Shift+S）导致终端窗格「假死」（无法输入、无法关闭）的问题。

v2.1.8（2026-08-29）#

✨ 新功能

模型配置升级为一级公民：支持保存多个模型配置（profile），顶栏新增模型切换器，内置模型与多个自备模型一键切换；每个自备模型的 API key 独立存储，旧配置自动迁移。

🐛 修复

修复向 kimi-code 发送指令时偶发「只打字不执行」的问题。
修复飞书/企微渠道在登录状态恢复后不会自动重连、长期离线的问题。
修复未登录/未付费时 coding 模式反复弹错提示刷屏的问题。
修复个别情况下钥匙串里已有有效登录态、界面却长时间显示未登录的问题。

v2.1.7（2026-08-28）#

✨ 新功能

Agents 面板支持卸载已安装的编程 agent（带确认，仅限 kaya 管理的安装）。
IM 渠道增强：编程 agent 等待确认 / 完成时，事件会注入 IM 会话让 AI 感知并处理，不再只是单向通知。

🐛 修复（Windows 真机反馈）

修复中文 Windows（PowerShell 5.1）上读取 UTF-8 文件出现乱码的问题。
修复 npm 自定义全局目录时，agent「安装完成」却检测不到、终端也找不到的问题；装完检测不到时会明确提示如何修复。
改进 coding 模式对编程 agent 的感知：新启动的 agent 能被及时发现，状态报告更准确，偶发误报减少。

v2.1.6（2026-08-27）#

✨ 新功能 — Windows 桌面首版（x64）

kaya 正式支持 Windows：PowerShell 7 优先、Windows PowerShell 5.1 兜底，git-bash 用户自动沿用原 shell。
终端体验与 macOS 对齐：每个标签页独立会话、历史记录、命令行环境加载用户配置。
快捷键按平台映射：Windows 使用 Ctrl+Shift 系（对应 macOS 的 ⌘ 系）。
Agents 检测/安装 Windows 适配：自动发现 npm 安装路径，npm 直连失败自动切换国内镜像重试。
coding 模式在 Windows 完整可用：前台编程 agent 识别、授权卡片、交互等待通知全部恢复。
发布 Windows 安装包（msi / nsis），应用内更新引导优先 nsis。

🐛 修复

修复中文 Windows 上命令输出 GBK 乱码。
修复 Windows 上执行命令时闪现控制台窗口。
修复 kaya 运行期间新装的 Node/npm 需要重启才能识别的问题。
飞书/企微渠道连接错误在 Windows 上可见可查（Settings → AppLog），渠道面板实时显示最近连接错误。
内置模型网络抖动自动重试、登录过期自动续期，错误提示更清晰。
claude-code 新增 DeepSeek（Anthropic 兼容）供应商预设，一键配置。

⚠️ 已知限制（Windows 首版）

个别 PowerShell 写法会被安全策略误拒（保守拒绝，不影响正常命令）。
后台「孙进程」在少数场景下可能无法随命令结束清理。

v2.1.5（2026-08-26）#

✨ 新功能

两级功能门禁：登录即可免费使用自备模型（BYOK）聊天；付费订阅解锁内置模型、coding 模式与 IM 渠道。未登录/未付费时的界面引导更友好。

🐛 修复

修复飞书卡片批准授权后，偶发需要手动再发一句话才继续执行的问题。
修复付款后渠道启动按钮/升级提示不自动刷新的问题。

v2.1.4（2026-08-25）#

🐛 修复

macOS 启动时钥匙串密码弹窗从 3~5 次降为最多 2 次（密钥存储合并；旧版本回滚需在 Settings 重新录入 API key）。
修复向 kimi-code 发送指令时偶发回车被吞、指令滞留输入框的问题。

v2.1.3（2026-08-25）#

🐛 修复

修复使用 Moonshot/Kimi 等 OpenAI 兼容模型时，长会话中间歇出现「tool_call_id is not found」400 报错的问题。

v2.1.2（2026-08-24）#

🚀 改进

大幅提升模型上下文缓存命中率：连续对话的响应更快、token 消耗更低。

🐛 修复

修复个别情况下会话裁剪导致 Kimi 报「tool_call_id is not found」的问题。
修复多步工具调用时系统指令可能丢失、agent 行为异常的问题。
修复渠道手动启动后重启应用不会自动连接的问题；镜像开关与设置页状态保持一致。

v2.1.1（2026-08-23）#

🐛 修复

修复飞书/企微渠道偶发显示「运行中」但实际收不到消息的问题（增加连接看门狗与超时，自动重连）。
修复镜像开启时，桌面正在进行的对话可能被误中断、消息串会话的问题。
修复关闭/重启渠道时偶发中止桌面正在进行回答的问题。
修复渠道 allowlist 输入框无法正常换行的问题。
修复渠道组件日志可能写入系统日志的问题，敏感信息不再外泄。

v2.1.0（2026-08-23）#

✨ 新功能 — IM 渠道

飞书接入：把飞书机器人连到本机 kaya，直接在飞书里聊天、让 AI 干活——无需公网 IP。
企业微信接入（本版本入口暂置灰「即将支持」）。
桌面 ↔ IM 双向镜像：桌面对话实时推送到 IM，IM 里的回复也实时出现在桌面。
授权卡片：需要批准的操作（如向编程 agent 发送输入）以卡片形式推送到 IM，一键批准/拒绝，批准后自动继续执行。
agent 状态主动通知：编程 agent 等待确认 / 完成 / 上线 / 退出时主动推送到 IM。
飞书扫码即连：一键创建飞书应用，扫码自动完成配置。
Settings 新增「IM 渠道」面板；准入名单默认拒绝陌生人，凭据只存系统钥匙串。

v2.0.5（2026-08-21）#

✨ 新功能

聊天里直接安装/更新编程 agent：对 AI 说「帮我装 claude-code」即可完成，与 Agents 面板共用同一引擎；安装/更新完成有全局提示。

v2.0.4（2026-08-21）#

✨ 新功能

coding 模式监控闭环：编程 agent「开工了 / 干完了 / 上线了 / 退出了」都会及时感知并汇报，长时间运行不再漏报。
支持识别 opencode / reasonix 的确认菜单。

🐛 修复

修复长指令偶发被重复发送给编程 agent 的问题。
修复安装/更新 agent 时选错 Node 环境导致失败的问题。
修复分屏窗格中运行的 agent 事件被静默丢弃的问题。

v2.0.3（2026-08-21）#

🐛 修复

修复更新 agent 时选错 npm、装错位置或权限不足的问题（现在自动选择与该 agent 匹配的 npm）。
修复使用 nvm 时包装进错误 Node 版本的问题。
安装/更新失败时保留输出尾部日志，并在卡片中提供「在终端安装/更新」兜底入口；失败原因不再只有退出码。

v2.0.2（2026-08-20）#

✨ 新功能

任务清单支持分组过滤（全部 / 未分组 / 各文件夹）。
任务按「进行中 > 未开始 > 已完成」排序展示。
任务标题支持两行折行，操作按钮改为悬浮显示（不再挤压标题，且对键盘/读屏用户可访问）。

v2.0.1（2026-08-20）#

✨ 新功能

kaya 可直接回答 claude-code / kimi-code / opencode / reasonix 等编程 agent 的用法问题（内置官方文档，本地查询）。
coding 模式掌握各 agent 的原生命令：说「模式设置成 auto」会自动转译为对应命令执行。
任务清单新增「进行中」状态；支持文件夹整理任务。

🐛 修复

修复 ⌘W / 关闭标签页时偶发弹出两个确认框的问题。
修复真新装用户启动后没有任何标签页的问题。
修复升级/续费入口偶发 404 的问题。

v2.0.0（2026-08-19）#

✨ 新功能 — 产品定位升级为「AI 编程 Agent 总控台」

任务面板：聊天中识别的任务进入顶部任务面板，可查看 / 编辑 / 整理。
Agents 管理中心：一站式安装、更新、配置编程 agent（Claude Code / Kimi Code / OpenCode 等），支持后台静默安装与一键写入模型配置。
coding 模式：监控终端里运行的编程 agent，等待确认 / 跑完时主动汇报；授权后可代你向 agent 发送指令。
交互确认直达聊天：agent 弹出审批菜单时聊天内通知，直接输入序号即可应答，无需切回终端。
Chat slash 命令：/agents 绑定会话到运行中的 agent、/new 新对话、/sessions 历史会话、/help 帮助；未知命令自动转发给已绑定的 agent。
综合菜单与顶栏 icon 化，界面更简洁。
新增国际版（GitHub 登录 + PayPal 支付）。

🐛 修复

修复聊天输出时不自动跟随滚动、长会话视口卡顶部的问题。
修复终端内联界面的编程 agent（kimi/claude）此前完全无法被监控感知的问题。
多项驾驶链路体验修复：授权后自动继续、监控回合不再刷整屏、杜绝「只打字不提交」等。

v1.2.6（2026-08-13）#

🐛 修复

修复 DeepSeek 偶发把工具调用标记当文本输出、工具未执行的问题。
修复松开按键顺序不当时终端持续自动输入的问题。

v1.2.5（2026-08-13）#

✨ 新功能

终端多窗格分屏（iTerm2 风格）：⌘D 左右分屏、⌘⇧D 上下分屏，⌘⌥方向键 移动焦点，拖拽调整比例，每个窗格独立会话。
聚焦模式 ⌘⇧F：临时放大当前窗格，退出恢复分屏。
vim 长按移动修复：长按 hjkl 连续移动，行为与 iTerm2 一致。

🐛 修复

修复点击外部链接无反应的问题。
修复分屏后滚动出现乱码行的问题。

历史版本#

v1.0.0 – v1.2.4 的早期记录待补全。

← 上一章术语表