# 变更记录

> 本页记录 Kimi Code CLI 每个版本的变更内容。

- 网址：https://funcoding.ai/agents/kimi-code/release-notes/changelog/
- 来源：Kimi Code 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://moonshotai.github.io/kimi-code/zh/release-notes/changelog.html

---
本页记录 Kimi Code CLI 每个版本的变更内容。

## 2.1.1（2026-09-24）

### 优化

- 配置文件与工作区文件的监听默认恢复为开启。如需保持关闭，可将 `[watch] enabled` 设为 `false` 或设置 `KIMI_CODE_WATCH=0`，详见 [`watch`](https://funcoding.ai/agents/kimi-code/configuration/config-files/#watch)。

### 修复

- 回退 2.1.0 中部分过于严格的防御性改动。

## 2.1.0（2026-09-23）

### 新功能

- 新增实验性全屏模式开关，可在 `/settings` 的 TUI mode 设置中开启，或在 `~/.kimi-code/tui.toml` 中设置 `tui_mode = "fullscreen"`，重启 Kimi Code 后生效。
- 全屏模式下，点击折叠块即可展开或收起。
- 全屏界面新增可点击的 "Jump to bottom" 指示器。

### 优化

- 缩短 CLI 启动时间并降低内存占用。
- 默认关闭对配置文件和工作区文件的监听，如需开启可将 `[watch] enabled` 设为 `true` 或设置 `KIMI_CODE_WATCH=1`，详见 [`watch`](https://funcoding.ai/agents/kimi-code/configuration/config-files/#watch)。

### 修复

- 加强工作区安全限制：文件工具无法再通过符号链接访问工作目录外的文件，项目本地配置仅在工作区受信任后生效，后台 git 操作不再执行仓库 git 配置中的命令，并拒绝解析结果为 home 目录或文件系统根目录的附加目录。
- 修复了一些已知问题，并做了若干细节优化。更详细的变更记录见 [GitHub](https://github.com/MoonshotAI/kimi-code/blob/main/apps/kimi-code/CHANGELOG.md)。

## 2.0.2（2026-09-19）

### 优化

- 优化系统提示词：Agent 不再假设当前工作目录就是项目根目录。

### 修复

- 修复切换到上下文窗口更小的模型后 compaction 失败的问题。
- 修复恢复会话后新消息偶尔出现在对话中旧位置的问题。
- 修复 Agent 运行期间发送的消息有时在聊天中重复显示的问题。
- web：改进交互体验并修复已知问题。

## 2.0.1（2026-09-18）

### 优化

- 移除系统提示词中禁止访问工作目录以外所有文件的规则。
- 供应商可通过 `config.toml` 中的 [`api_key_env`](https://funcoding.ai/agents/kimi-code/configuration/providers/) 从指定的环境变量读取 API 密钥。
- 工作区文件监听不再无上限地扫描项目根目录，并新增 `[watch] enabled` 配置与 `KIMI_CODE_WATCH` 环境变量，可完全关闭文件监听，详见 [`watch`](https://funcoding.ai/agents/kimi-code/configuration/config-files/#watch)。
- 「必要时询问」权限模式下，无法静态分析的 bash 命令不再触发审批请求。
- `kimi install-app` 子命令更名为 `kimi install-desktop`，旧名称仍作为隐藏别名可用。

### 修复

- 修复了一些已知问题，并做了若干细节优化。更详细的变更记录见 [GitHub](https://github.com/MoonshotAI/kimi-code/blob/main/apps/kimi-code/CHANGELOG.md)。

## 2.0.0（2026-09-17）

### 新功能

- 新增 `/desktop` 斜杠命令（别名 `/install-desktop`）与 `kimi install-app` 子命令。
- Mermaid 代码块现在会在终端中渲染为图表；可在 `/settings` → Mermaid diagrams 中关闭，或在 tui.toml 的 `[markdown]` 配置段中设置 `mermaid = "off"`。

### 优化

- 内置浏览器插件更名为 "Kimi Browser Extension"，插件面板、插件市场与文档中的名称同步更新。

### 修复

- 修复了一些已知问题，并做了若干细节优化。更详细的变更记录见 [GitHub](https://github.com/MoonshotAI/kimi-code/blob/main/apps/kimi-code/CHANGELOG.md)。

## 0.43.1（2026-09-15）

### 新功能

- Linux X11 环境新增原生剪贴板支持，从终端界面复制内容不再依赖终端的 OSC 52 能力。

### 优化

- 减少同时运行大量 subagent 的会话中的事件循环卡顿与 GC 开销。

### 修复

- 修复在 subagent 运行时按 `Ctrl-C` 会直接退出整个 CLI 的问题，现在只会中断正在运行的 subagent。
- 修复大型 agent swarm 运行时渲染逐轮变慢的问题。
- 修复 subagent 运行结束后内存未释放的问题。
- 修复 tower 模式将新生成的 agent 误识别为历史会话 roster 条目的问题。
- 修复全局搜索在索引更新前仍会返回已删除会话的问题。
- 修复折行 markdown 表格中的链接颜色错误，以及 `@` 文件补全的排序问题。

## 0.43.0（2026-09-14）

### 新功能

- Web 版会话的 AI 标题功能默认开启：首轮对话后自动生成标题，并可在重命名输入框中重新生成。
- 会话选择器中可删除会话：在目标会话上按 `Ctrl-X`，再按 `y` 确认。
- `kimi upgrade`（别名 `kimi update`）新增 `-y, --yes` 选项，跳过确认提示直接安装更新。
- 新增 `loop_control.compaction_max_attempts` 配置项，可设置压缩请求失败后的最大总尝试次数（默认 5 次），详见 [`loop_control`](https://funcoding.ai/agents/kimi-code/configuration/config-files/#loop_control)。

### 优化

- 仅作用于 `/tmp` 或 `/temp` 路径的 `rm -rf` 命令不再弹出确认提示。
- 引导消息现在可以打断对后台任务的等待。
- 目标模式的时间预算不再计入会话关闭期间的时间，并取消 24 小时上限。
- 新增 `KIMI_CODE_PERMISSION_MODE_REMINDER` 环境变量：设为 `0` 后不再向模型上下文注入自动权限模式提醒。

### 修复

- 修复了一些已知问题，并做了若干细节优化。更详细的变更记录见 [GitHub](https://github.com/MoonshotAI/kimi-code/blob/main/apps/kimi-code/CHANGELOG.md)。

## 0.42.0（2026-09-09）

### 新功能

- Remote Control 由实验性转为正式，无需再设置 `KIMI_CODE_EXPERIMENTAL_REMOTE_CONTROL` 实验开关。详见 [Remote Control](https://funcoding.ai/agents/kimi-code/guides/remote-control/)。
- Web 版支持从会话行的右键菜单永久删除会话，删除前会要求确认。
- `/btw` 侧边聊天的 subagent 新增只读工具。
- Web 版输入框新增可排序的媒体预览栏，可在文本中按需引用图片和视频，排队与发送后预览仍然保留。
- 模型由 Kimi 提供时，支持在提示词附件与 `ReadMediaFile` 中使用 HEIC、HEIF 和 BMP 图片。

### 优化

- 消息记录中已完成的工具调用现折叠为标题加一行结果摘要：短输出完整展示，隐藏内容以 `N more lines`、`+N more` 计数并按 `Ctrl-O` 展开，页脚会在可用时提示。
- 符合条件的用户的默认思考强度升级为推荐级别。
- 子 Agent 模型池（`[secondary_model]`）现已始终开启，实验开关与 `KIMI_CODE_EXPERIMENTAL_SECONDARY_MODEL` 退出选项已移除。
- `Read` 新增可配置的字符上限，长行文件可续读，输出不再被反复截断。详见 [`read`](https://funcoding.ai/agents/kimi-code/configuration/config-files/#read)。
- minidb 会话索引读模型与全局搜索 worker 现已始终开启，实验开关由 `[database]` 配置段与 `KIMI_CODE_PERSISTENCE_MINIDB_READMODEL` / `KIMI_CODE_SEARCH_WORKER` 环境变量取代。详见 [`database`](https://funcoding.ai/agents/kimi-code/configuration/config-files/#database)。

### 修复

- 修复了一些已知问题，并做了若干细节优化。更详细的变更记录见 [GitHub](https://github.com/MoonshotAI/kimi-code/blob/main/apps/kimi-code/CHANGELOG.md)。

## 0.41.0（2026-09-04）

### 新功能

- Web 版新增 tower 多智能体协作模式（实验功能），可通过 `/tower` 命令或输入框加号菜单开启，`/tower <base-branch>` 可指定基准分支。
- Web 版新增划词标注：在消息、文件预览、diff 与每轮改动面板或终端中选中文字，即可添加评论或引用到对话。
- CLI 中新增会话评分提示，适时在输入框上方邀请为本次会话打分。

### 优化

- 自动权限模式不再拦截危险命令和无法静态分析的命令。
- 自动压缩前提醒模型关注上下文预算，压缩后指引其查阅会话事件日志获取精确细节。
- Web 版三档权限模式更名为「始终询问 / 必要时询问 / 完全自动」并更新描述；切换到「必要时询问」或「完全自动」权限模式后，提示该模式下文件可能被直接修改或删除。
- Web 版 Esc 不再关闭右侧详情面板。
- Web 版右侧面板中的 Bash 命令改为终端样式。
- 后台提问的回答直接送达 Agent，不再经输出文件中转。
- 子 Agent 的最终回复较短（200 字符以内）时不再被要求扩写。

### 修复

- 修复 `kimi -p` 在出错或收到终止信号退出时丢失会话记录的问题。
- 修复 `kimi -p` 忽略 `KIMI_DISABLE_TELEMETRY` 环境变量的问题。
- 修复 tower 模式（实验）在 config.toml 中通过 `[experimental] tower = true` 启用时不生效的问题；`/tower` 现可在非 git 仓库目录使用；启用失败时报错会指明具体原因。
- 修复后台提问在 Agent 回合结束即被取消的问题。
- 修复会话在新进程重开后无法按 agent id 恢复子 Agent 的问题；恢复的子 Agent 遵循当前权限模式。
- 修复一轮中多次编辑同一文件时，每轮改动预览出现从未真实存在的增删行且行数统计不准的问题；改动卡片现只展示精确统计。
- 修复设置中默认思考强度无法设为最高档（Max）的问题。
- 修复了一些已知问题，并做了若干细节优化。更详细的变更记录见 [GitHub](https://github.com/MoonshotAI/kimi-code/blob/main/apps/kimi-code/CHANGELOG.md)。

## 0.40.1（2026-09-02）

### 修复

- 修复 kimi-cli 迁移完成或关闭后仍重复弹出迁移提示的问题。

## 0.40.0（2026-09-02）

### 新功能

- Web 版设置新增「插件」面板：可浏览插件市场并安装、启停、移除插件。
- 支持在一条消息中同时激活多个技能。
- 新增 `kimi session list` 命令，可在命令行直接列出会话。
- Tower 模式（实验性）行为调整：agent 不再自行进入，需用 `/tower on` 或 `/tower <base-branch>` 显式开启。
- 子代理设置（`[secondary_model]`）功能由实验性转为正式。
- 新增危险命令护栏：Auto 模式直接拦截 shutdown、reboot、rm -rf 等危险命令，Manual 与 YOLO 模式执行前必定询问；可用 `[permission] dangerous_command_guard = false` 或 `KIMI_CODE_DANGEROUS_COMMAND_GUARD=false` 关闭。

### 优化

- 更新配置时完整保留 config.toml 的注释、键顺序与格式。
- Bash 工具的 cwd 参数不再限制在工作区内。
- 工作区信任弹窗默认选中「Trust this folder」。
- `kimi acp` 子命令不再识别 `KIMI_CODE_LEGACY_FLAG`，始终运行在默认 agent 引擎。
- Web 版 Diff 面板新增代码折行开关，并精简了面板头部。

### 修复

- 修复实验开关优先级：config.toml 中显式设为 `false` 的 `[experimental]` 条目现在稳定优先于 `KIMI_CODE_EXPERIMENTAL_FLAG` 总开关（单项 `KIMI_CODE_EXPERIMENTAL_` 变量仍覆盖两者）。
- 修复了一些已知问题，并做了若干细节优化。更详细的变更记录见 [GitHub](https://github.com/MoonshotAI/kimi-code/blob/main/apps/kimi-code/CHANGELOG.md)。

## 0.39.1（2026-08-28）

### 修复

- 修复在一个会话中切换权限模式会改动所有会话的问题，权限模式现按会话独立生效。
- 修复登录相关问题
- 修复点击输入框占位提示后，输入法或键盘首个字符被吞的问题
- 修复新会话中附件上传完成后仍显示"上传中"的问题
- 修复了一些已知问题，并做了若干细节优化。更详细的变更记录见 [GitHub](https://github.com/MoonshotAI/kimi-code/blob/main/apps/kimi-code/CHANGELOG.md)。

## 0.39.0（2026-08-27）

### 新功能

- 新增实验性远程控制功能：可远程访问本地的 web 会话，设置 `KIMI_CODE_EXPERIMENTAL_REMOTE_CONTROL=1` 后运行 `kimi rc`、`kimi web --remote-control` 或 `/remote-control` 启动。
- 新增实验性 tower 多 Agent 编排模式：设置 `KIMI_CODE_EXPERIMENTAL_TOWER=1` 后运行 `/tower on` 和 `/tower <objective>` 启动。
- subagent 与 swarm 工具新增可选 `fork` 参数，子 Agent 以调用方当前对话历史的快照启动；设置 `KIMI_CODE_EXPERIMENTAL_SUBAGENT_FORK=1` 或在 `config.toml` 的 `[experimental]` 下写 `subagent_fork = true` 启用。
- web: 运行卡片新增 "转到后台" 按钮，可把正在前台运行的 Bash 命令或子 Agent 转为后台运行。
- web: 移动端会话列表新增平铺/按工作区分组的切换标签。
- 内置插件市场新增 Tencent CloudBase 插件，通过 `/plugins` 安装。
- 新增 `[swarm] timeout_ms` 配置项（或环境变量 `KIMI_CODE_SWARM_TIMEOUT_MS`）。

### 优化

- web: 右侧边栏重构为多标签面板。
- web: 优化输入框交互，包括文件、文件夹和媒体附件的展示。
- web: 优化移动端 UI 样式。

### 修复

- 修复 Windows 上文件工具与 Shell 工作目录无法解析 Git Bash 路径（如 /c/Users、/tmp）的问题。
- 修复了一些已知问题，并做了若干细节优化。更详细的变更记录见 [GitHub](https://github.com/MoonshotAI/kimi-code/blob/main/apps/kimi-code/CHANGELOG.md)。

## 0.38.0（2026-08-20）

### 新功能

- 支持 kimi.ai 与 kimi.com 两种 OAuth 登录方式。
- 新增 WaitFor 工具：Agent 可以在当前轮次内等待后台任务完成，无需结束轮次后再次被唤起。
- 官方 Kimi Datasource 插件新增 13 个数据源：中国政府数据（NDA/NBS）与标准（GB/HB/DB/TT）、八个国际组织数据集（WHO、FAO、UNSD、ECB、Eurostat、UNICEF、OECD、FRED）、新华财经和财新。在 /plugins 的 Official 标签页中更新插件。
- web: 聊天头部的更多菜单新增置顶操作。

### 优化

- Edit 和 Write 现在要求先读取已存在的文件再进行修改。
<!-- - 子 Agent 默认不再派生自己的子 Agent；自定义 Agent 配置仍可显式允许。 -->
- 折叠过长的 `!` Shell 命令输出，避免刷屏；按 ctrl+o 可与工具输出一起展开或折叠。

### 修复

- 修复 config.toml 在存在语法错误或在应用外被编辑时条目丢失的问题。
- 修复了一些已知问题，并做了若干细节优化。更详细的变更记录见 [GitHub](https://github.com/MoonshotAI/kimi-code/blob/main/apps/kimi-code/CHANGELOG.md)。

## 0.37.2（2026-08-19）

### 优化

- web: 设置页新增 「实验室」标签页，上线「多标签侧边栏开关」功能；开启后侧边栏显示 Open / Done / Workspaces 标签页。
- 做了若干细节优化和内部改进。更详细的变更记录见 [GitHub](https://github.com/MoonshotAI/kimi-code/blob/main/apps/kimi-code/CHANGELOG.md)。

## 0.37.1（2026-08-18）

### 修复

- 修复粘贴的图片和视频无法发送给模型的问题。

## 0.37.0（2026-08-18）

### 新功能

- 支持在单条提示词中激活多个 skill：在空白后输入 `/` 即可插入 skill 标记。
- Windows 原生（单文件）CLI 现支持自动更新。
- web: 侧边栏新增 Open / Done / Workspaces 标签页，会话可标记为 Done。
- web: 新增会话管理页面。

### 优化

- Agent 忙碌时输入的 skill 斜杠命令现在会排队执行，不再直接拒绝。
- web: 聊天消息中 @提及的文件、文件夹和 skill 现在渲染为图标胶囊。
- web: 浏览器标签页标题现在显示当前工作区目录名。
- web: 搜索对话框现在支持搜索工作区，选中结果后会展开侧边栏并滚动定位到该条目。
- web: Subagent 面板更名为 "Background Agent"。
- 输入的 `/goal` 目标超过 4000 字符限制时现在会给出警告，且被拒绝时保留已输入的内容。

### 修复

- 修复 Gemini 工具调用会话后续请求失败的问题。
- web: 修复 macOS 上输入框中 Ctrl+K 误打开会话搜索的问题，会话搜索现仅响应 Cmd+K。
- web: 修复 Background Agent 面板显示数量和状态不对的问题。
- web: 修复把复制的文件夹粘贴进输入框会导致上传报连接错误的问题，现在文件夹会被直接跳过。
- 修复了一些已知问题，并做了若干细节优化。更详细的变更记录见 [GitHub](https://github.com/MoonshotAI/kimi-code/blob/main/apps/kimi-code/CHANGELOG.md)。

## 0.36.1（2026-08-14）

### 新功能

- web: AI 自动生成会话标题（实验性）。默认关闭，设置 `KIMI_CODE_EXPERIMENTAL_AUTO_SESSION_TITLE=1`（或实验总开关 `KIMI_CODE_EXPERIMENTAL_FLAG=1`）开启。

### 优化

- web: 优化输入框的 Plan、Goal、Swarm 开关，现收进了输入框旁的 + 号菜单。

### 修复

- 修复了一些已知问题，并做了若干细节优化。更详细的变更记录见 [GitHub](https://github.com/MoonshotAI/kimi-code/blob/main/apps/kimi-code/CHANGELOG.md)。

## 0.36.0（2026-08-13）

### 新功能

- 实验性的子 Agent 模型配置升级为模型池：现在可以在 `[secondary_model]` 中配置一组带描述的候选模型，由主 Agent 每次派生时按任务挑选。

  启动前设置 `KIMI_CODE_EXPERIMENTAL_SECONDARY_MODEL=1`（或实验总开关 `KIMI_CODE_EXPERIMENTAL_FLAG=1`）即可启用。

  推荐用法：

  - 极简用法：在 TUI 中运行 `/secondary-model` 选择，或在 `config.toml` 中写一行 `default_model`，让所有子 Agent 默认跑同一个模型；再加 `force = true` 可彻底固定该选择，主 Agent 无法改选。
  - 配置命名模型池，并为每个别名写一句适用场景的描述——描述会展示给主 Agent 作为挑选依据：

    ```toml
    [secondary_model]
    default_model = "kimi-code/kimi-for-coding-highspeed"
    [secondary_model.models]
    "kimi-code/kimi-for-coding-highspeed" = "快速、便宜，适合日常重构、代码解释和小改动。"
    "kimi-code/k3" = "擅长复杂推理与深度调试，难题选它。"
    ```

  详见 [子 Agent 模型池文档](https://funcoding.ai/agents/kimi-code/configuration/config-files/#subagent-%E6%A8%A1%E5%9E%8B%E6%B1%A0)。
- 新增实验性全屏 TUI 模式，设置 `KIMI_CODE_TUI_FULL_SCREEN=1` 环境变量即可启用。
- TUI 支持渲染 LaTeX 数学公式（`$…$` 与 `$$…$$`），消息中的公式会显示为 Unicode 公式。

### 修复

- 修复未信任工作区可在信任确认前植入同名 `fd`/`stty` 可执行文件的风险；信任提示现在展示项目 MCP 的启动目标，并默认拒绝信任。
- 修复在严格的 OpenAI 兼容供应商（如 DeepSeek）下，模型思考阶段打断轮次后，后续每轮请求都报 400 错误的问题。
- 修复 API 请求失败自动重试期间按 Ctrl+C 无反应的问题。
- 修复了一些已知问题，并做了若干细节优化。更详细的变更记录见 [GitHub](https://github.com/MoonshotAI/kimi-code/blob/main/apps/kimi-code/CHANGELOG.md)。

## 0.35.0（2026-08-12）

### 新功能

- 内置插件市场新增 Modern Web Guidance 插件，通过 `/plugins` 选择 Modern Web Guidance 安装。
- `/tasks` 面板现实时展示后台子 Agent 的工作进度。

### 修复

- 修复 coder 子 Agent 默认可继续派生子 Agent 的问题。
- 修复压缩后 token 数显示偏低的问题，现在与会话中看到的数字一致。
- 修复 Windows 上的两处二进制植入风险。
- 修复了一些已知问题，并做了若干细节优化。更详细的变更记录见 [GitHub](https://github.com/MoonshotAI/kimi-code/blob/main/apps/kimi-code/CHANGELOG.md)。

## 0.34.0（2026-08-06）

### 新功能

- web: 侧边栏会话列表新增平铺视图。
- Kimi Computer Use 插件新增 Windows x64 支持，通过 `/plugins` 安装。
- 会话空闲过久后恢复或发送消息时，现将会弹出缓存过期提醒。将 [cache_expiry_hint](https://funcoding.ai/agents/kimi-code/configuration/config-files/#tui-toml) 设为 `false` 可关闭。

### 优化

- web: 子 Agent 任务显示所用模型与思考等级。
- web: 模型请求失败时会话内保留失败卡片，可一键恢复。
- web: 自动重试期间工作状态显示重试进度（第 N/M 次）。
- 安装 Kimi WebBridge 后现在会显示浏览器扩展链接与激活步骤。

### 修复

- 修复无法读取 UTF-16 LE/BE 文本文件（有无 BOM 均可）的问题。
- web: 修复附件随技能命令发送时被丢弃的问题。
- web: 修复模型较多时模型选择器溢出屏幕的问题。
- web: 修复 Windows 上路径含空格时打开 Documents 文件夹而非目标文件的问题。
- web: 修复新会话以技能命令开始时思考等级被重置为默认值的问题。
- web: 修复手动取消的会话在侧边栏被错误标记的问题，现在仅在上一回合失败时显示。
- web: 修复重命名会话时输入法组合中 Enter、Esc 误触发的问题。
- web: 修复重命名时拖动选择文本会移动整个列表项的问题。
- web: 修复计划审批对话框展开时后台任务与待办标签跳到窗口顶部的问题。
- web: 修复变更文件摘要卡片 "show less" 按钮箭头方向错误。
- 修复 `kimi -p` 未等待后台任务与子 Agent 完成就退出的问题。
- `/feedback` 不再受当前模型限制，所有已登录用户可用；未登录用户显示注册页与 GitHub Issues 链接。
- 修复移除 MCP 服务会破坏进行中会话的问题：工具保留但调用返回移除提示。
- 修复服务器重启后丢失回合结束状态的问题，会话列表与恢复的会话现在能正确标记失败的回合。
- 修复恢复的会话将后台任务完成通知显示为原始协议文本而非状态卡片的问题。

## 0.33.0（2026-08-05）

### 新功能

- `/plugins` 市场新增 Kimi Computer Use 与 Kimi WebBridge 官方内置插件，安装时自动配置托管运行时，中断后可重试。
- web: 支持在设置中添加和管理自定义供应商。
- web: 侧边栏支持将会话置顶。
- web: 会话标题支持设置 emoji。
- web: 显示登录账号信息与套餐用量。
- 新增 `/bug` 命令作为 `/feedback` 的别名，输入 `/bug` 即可提交反馈。

### 优化

- 启动时询问是否信任当前文件夹。
- `/fork` 不再切换到分叉会话，当前会话与后台任务保持运行，分叉结果可在 `/sessions` 中查看。
- web: 深度优化界面 UI/UX 并修复已知问题。
- 交互式 TUI 启动时不再立即创建会话。
- 插件市场的合作伙伴标签页更名为 Curated，并说明其内容为 Kimi 合作伙伴提供的第三方插件。

### 修复

- 修复 macOS 上技能目录文件过多时所有工具调用失败（spawn EBADF）的问题。
- 修复 MCP OAuth 重新授权总是因 `Invalid redirect URI` 失败的问题，现会自动清理过期注册并重新发起。
- 修复首条请求未等待 MCP 初始化完成的问题，界面仍可立即打开。
- 修复 MCP 工具结果中 `structuredContent` 与 `_meta` 元数据被静默丢弃的问题，现已正确传递给模型。
- 修复 `/plugins` 中内置能力的可用性与安装状态显示，更新时保留旧版 WebBridge 技能备份，并避免 Computer Use 更新导致 MCP 服务重复或断连。

### 重构

- CLI 各界面（交互式 TUI、`kimi -p`、`kimi acp` 等）默认运行在 agent-core-v2 引擎上；设置 `KIMI_CODE_LEGACY_FLAG=1` 可回退旧引擎。

## 0.32.0（2026-08-04）

### 新功能

- 新增四个 hook 事件：`TurnStarted`、`UserPromptQueued`、`TaskStarted` 和 `SessionHeartbeat`。在 `config.toml` 的 `[[hooks]]` 下配置，详见 [Hooks](https://funcoding.ai/agents/kimi-code/customization/hooks/)。

### 优化

- `[loop_control]` 两个配置键改名：`max_retries_per_step` → `max_attempts_per_step`、`max_steps_per_run` → `max_steps_per_turn`；旧键不再生效，启动时会有改名警告，详见 [loop_control](https://funcoding.ai/agents/kimi-code/configuration/config-files/#loop-control)。
- 新增 `[token_counting]` 配置节：供应商不上报 token 用量时，可将上下文大小显示切换为本地估算，详见 [token_counting](https://funcoding.ai/agents/kimi-code/configuration/config-files/#token-counting)。

### 修复

- 修复部分 OpenAI 兼容网关返回含冒号的工具调用 ID 时，交互式提问无法提交答案的问题。
- 修复上下文自动压缩因请求过大反复重试直至失败的问题。
- models.dev 目录不可达时回退到内置快照，离线或网络受限时也能导入已知第三方供应商。
- 修复未配置模型时上下文窗口上限显示为 0 的问题，现回退到默认模型显示。
- web: 修复深色模式下单色控件显示异常，聊天输入框圆角与设计系统对齐。
- 修复 `/login` 已登录确认信息难以看清的问题，现以成功色显示。

## 0.31.1（2026-07-31）

### 优化

- 减少 TUI 频繁的全屏重绘。
- 按 Esc 中断回合时保留 Assistant 已生成的部分输出，并提醒模型上一回合是被主动中断的。
- web: 各设置页面的权限模式按从严到宽排序，并修复状态面板与移动端设置中 yolo/auto 风险颜色颠倒的问题。
- web: 代码块启用基于 Monaco 的高亮渲染，并修复回退渲染时行号重叠或错位的问题。

### 修复

- 修复启动 kimi web 时偶发的 “model is not configured” 错误。
- web: 修复新会话显示思考等级（如 Max）但首条消息实际未开启思考的问题。
- web: 修复新会话草稿状态下（发送首条消息前）@ 文件提及不可用的问题。
- web: 修复 Markdown 渲染器升级后聊天代码块以 UI 字体、错误字号渲染的问题，加载回退与高亮块对齐。

## 0.31.0（2026-07-30）

### 新功能

- TUI 支持 Markdown 定义的自定义 Agent。
- 新增 /secondary_model 斜杠命令，用于配置子 Agent 使用的辅助模型（实验性功能，需先在 /experiments 中开启）。
- 插件可贡献自定义 Agent，自动发现并可用于子 Agent 委派。
- 插件可贡献系统提示词，通过 `kimi.plugin.json` 中的 `systemPrompt` 或 `systemPromptPath` 声明。

### 修复

- 移除 TaskOutput 工具的阻塞式 `block`/`timeout` 等待。
- 修复会话元数据缓存早于 archived 标记时会话选择器缺少会话的问题。
- 修复部分请求未能正确传递请求头的问题。

## 0.30.0（2026-07-29）

### 新功能

- 新增可自定义的底部状态栏，可通过 `tui.toml` 中的 `[status_line]` 配置。

### 优化

- 安装会计入套餐额度的官方插件（如 Kimi Datasource）后，显示额度说明。
- 会话中使用的官方插件有可用更新时显示提示，可运行 /plugins 更新。
- 移除内置服务器文件上传的 50 MB 大小限制。

### 修复

- 修复账户额度或余额耗尽时静默重试约 3 分钟的问题，现在会立即报错。
- 修复工具调用反复无效时无限重试的问题，现在会终止当前回合。
- web: 修复代码块中行号乱码的问题。

## 0.29.2（2026-07-27）

### 修复

- 修复目标执行在单轮达到步数上限（`loop_control.max_steps_per_turn`）后暂停的问题。
- 修复目标运行期间发送的消息被拒绝的问题。
- 修复 /undo 无法一致恢复对话历史、待办列表、计划模式和任务通知的问题。
- web: 修复纯 HTTP 环境下复制选中聊天文本时，剪贴板被事件占位符覆盖的问题。

## 0.29.1（2026-07-24）

### 新功能

- 支持在 `config.toml` 与环境变量中配置全局默认的 MCP 服务器超时时间。
- 新增用于配置网页搜索与网页抓取服务的环境变量，无需 OAuth 登录。
- 新增实验性的子 Agent 辅助模型绑定，支持按 Agent 设置模型偏好及仅对子 Agent 生效的模型覆盖。

### 修复

- 修复部分 OpenAI 兼容端点（如新版 vLLM）以其他字段名返回 reasoning 导致思考内容丢失的问题。

## 0.29.0（2026-07-22）

### 新功能

- web: 支持 Markdown 文件定义 agent，声明 system prompt、名称、描述和工具权限。[查看文档](https://moonshotai.github.io/kimi-code/en/customization/agents.html#agent-file-format)
- web: 可通过 SYSTEM.md 永久覆盖主 agent 的系统提示。[查看文档](https://moonshotai.github.io/kimi-code/en/customization/agents.html#overriding-the-main-agent-s-system-prompt-with-system-md)
- web: 可通过 config.toml 在所有会话中统一启用/禁用工具。[查看文档](https://moonshotai.github.io/kimi-code/en/configuration/config-files.html#tools)
- 附加到提示词的视频现在会随提示词一起送达模型，无需额外的工具轮次。
- ACP 客户端现支持选择思考强度。
- 新增 Agent 循环与后台任务限制的环境变量覆盖：`KIMI_LOOP_MAX_STEPS_PER_TURN`、`KIMI_LOOP_MAX_RETRIES_PER_STEP` 和 `KIMI_CODE_BACKGROUND_MAX_RUNNING_TASKS`。

### 优化

- 从 models.dev 目录导入更多供应商。
- 提升 TUI 在长会话中的性能与恢复速度。
- 当 MCP 服务器的某个工具被调用时，若连接已断开可自动重连，并自动重试一次该调用。
- 移除代码预览与 Markdown 代码块语法高亮中的红色配色。
- 在更新提示中为第三方安装来源增加使用官方安装器的提醒。

### 修复

- 修复内容过滤响应后，会话卡住并报 "message must not be empty" 错误的问题。
- 修复被取消的模型请求被包装为可重试的供应商错误的问题。
- 修复为不支持的模型提供思考强度选项的问题。
- 修复环境变量覆盖值在环境变量设置期间被持久化到 config.toml 的问题。
- 将会话提示词缓存键发送给 OpenAI 与 OpenAI Responses 供应商。
- 修复当供应商没有文件上传通道时 `ReadMediaFile` 处理视频失败的问题。
- 修复恢复会话时目标模式续行提示词泄漏到对话记录中的问题。
- web: 在透明图片下方显示棋盘格画布。
- 移除定时任务工具描述中对不存在的 `kimi resume` 命令的引用。

## 0.28.1（2026-07-20）

### 新功能

- ACP 会话现支持使用已配置的非 OAuth 模型凭据启动，无需再在终端登录。

### 优化

- `kimi web` 服务器改为全程前台运行：`/web` 斜杠命令现在总是启动新服务器，`kimi web kill` 与 `kimi web ps` 子命令已移除，前台服务器按 Ctrl+C 即可停止。`kimi server kill` 保留为废弃回退，仅能停止 0.28.0 之前版本启动的服务器。

### 修复

- 修复权限模式切换对已在运行的子 Agent 不生效的问题。

## 0.28.0（2026-07-20）

### 新功能

- **破坏性变更：** 
  - `kimi server` 命令树已被废弃，请使用 `kimi web` 代替。
  - `kimi web` 现在在当前终端前台运行并打开浏览器，按 Ctrl+C 停止。

### 优化

- 思考强度仅持久化低于模型最高档（max）的等级。
- web: 模型切换器新增提示：切换模型或思考强度会使已有提示词缓存失效。

### 修复

- 修正 YOLO 与 Auto 权限模式的描述：YOLO 会自动批准工具操作，但 Agent 仍可能提问；Auto 完全自主，不会提问。
- 修复 web 后端在加载 AGENTS.md 和读取文件时忽略符号链接的问题。

## 0.27.0（2026-07-17）

### 新功能

- 新增 `/copy` 斜杠命令，可将上一条助手消息复制到剪贴板。
- 使用 API key 调用 Kimi 编程模型时，现在会自动拉取最新模型列表。

### 优化

- OAuth 连接失败时现在会显示底层网络原因（DNS、连接被拒、TLS、超时），不再是笼统的 `fetch failed`。

### 修复

- 修复打断模型回复后请求被反复拒绝的问题。
- 修复内置 URL 抓取工具的网络防护缺陷：恶意构造的域名与重定向链无法再访问回环地址或内网服务。
- web: 修复通过网络访问 web UI 时 LaTeX 公式渲染错乱重叠的问题。
- web: 修复重新打开会话时，排队消息会静默重发此前已上传文件的问题。
- web: 按模型分别记忆思考等级，修复模型不支持已存等级时选择器空白卡死的问题。
- web: 修复 Windows 下同一文件夹以不同路径写法打开时出现重复工作区分组的问题，现在统一归入单个分组。
- 修复 web 后端忽略以符号链接形式安装的 AGENTS.md 文件的问题。
- 修复 /btw 面板打开时，按 Esc 或 Ctrl+C 会取消 compaction 而不是关闭面板的问题。
- 修复纯空白思考内容在对话记录中渲染成空行的问题。
- 修复对同一会话重复执行 /export-debug-zip 或 kimi export 会覆盖上一份压缩包的问题；文件名现包含时间戳。

## 0.26.0（2026-07-16）Say hi to the BIIIG DAY!

### 优化

- 扩展 coder 子 Agent 的工具集：新增后台任务、待办列表、Plan 模式、Skill 调用与嵌套 Agent 能力，与主 Agent 对齐。
- `/model` 与 `/effort` 选择器现在会提示切换会使已有提示词缓存失效，并建议使用 `/new` 以避免额外 token 开销。
- web: 打开模型选择器时刷新所有供应商的模型目录，新上线的模型现在总能显示。
- 优化上下文用量显示的单位格式。

### 修复

- 修复恢复的会话没有新活动却被标记为刚更新、跳到会话列表顶部的问题。
- 修复上下文大小指示器低估模型实际上下文用量的问题。
- 修复经 Anthropic 协议接入的 Kimi 供应商模型错误显示思考强度选项的问题。
- 修复 OpenAI 兼容（chat completions）供应商上显式关闭思考不生效的问题。
- 用户停止任务时现在会向模型报告，其他停止原因也会保留在模型上下文中。
- 修复后台子 Agent 被手动停止后立即恢复时可能因竞争报 `"already running"` 错误的问题。
- Anthropic 兼容与 Kimi 的 preserved-thinking 端点现在原样回放空思考内容，不再替换为占位空格。
- 旧版迁移在多个 Kimi 主目录之间保持幂等，损坏或无法映射的会话现在会明确报告，不再静默跳过。
- web: 修复侧边栏调整宽度的拖拽手柄被聊天输入框背景遮挡的问题。

## 0.25.0（2026-07-16）

### 新功能

- web: 聊天支持附加任意类型文件，可直接将文件拖放到窗口任意位置；发送的文件、图片、视频都会以附件标签显示在消息气泡中。

### 优化

- web: 模型请求失败时展示完整诊断信息。
- 应用 Anthropic 官方 effort 配置，未知模型回退到 128k 输出上限。

### 修复

- 修复 Web 服务器 bearer token 校验可被百分号编码的 API 路径绕过、导致所有 API 路由可被未认证访问的问题。
- 修复会话文件系统 API 可跟随指向工作区外的符号链接、导致宿主机文件被越权访问的问题。
- web: 会话活动指示器现与 Agent 实际工作保持同步；修复会话激活竞争或 LLM 重试后流式内容重复的问题。
- 修复 Anthropic 兼容供应商中自定义命名模型新会话思考强度被错误关闭、且 ACP 客户端不显示思考强度控件的问题。
- Anthropic 兼容模型现在正确遵循 `adaptive_thinking = false`，请求中不再携带 effort 参数。
- web: 修复服务器绑定非回环地址时 CSP 阻止 Web UI 主题初始化脚本与内置字体加载的问题。
- 修复工作区目录通过符号链接给出时会话创建失败的问题。
- 修复剪贴板图片读取失败导致 CLI 意外退出的问题，现在会回退为粘贴文本。
- web: 修复已完成的后台子 Agent 在会话重新加载后丢失最终输出的问题。
- web: 修复开发构建中 Enter 键无法确认模态对话框的问题。
- web: 修复流式输出期间后台子 Agent 在 agents dock 面板中显示为两行相同记录的问题。
- 修复 CLI 意外退出时诊断日志缺少实际错误信息的问题。

## 0.24.2（2026-07-15）

### 新功能

- 新增内置 `/check-kimi-code-docs` Skill，自动基于官方文档回答 Kimi Code 产品问题并附来源链接。

### 优化

- 对齐 `kimi -p` 在各引擎的行为：`print_background_mode` 与 `print_max_turns` 生效，`/goal` 会运行到目标结束。
- `kimi -p` 默认在后台任务未完成时保持运行，等待与轮次实际上不设上限，并把完成结果反馈给主 Agent。如需恢复旧的一轮后退出，可设置 `print_background_mode = "exit"` 或 `"drain"`。
- `kimi -p` 后台任务和子 Agent 默认不再超时（交互模式不变）；如需恢复限制，可设置 `[background] bash_task_timeout_s` 或 `[subagent] timeout_ms`。
- 子 Agent 超时统一默认为 2 小时，可通过 `[subagent] timeout_ms` 或 `KIMI_SUBAGENT_TIMEOUT_MS` 覆盖。
- 每步 LLM 重试上限从 3 次提高到 10 次，供应商临时失败（429 / 过载）会在轮次失败前自动重试；可通过 `loop_control.max_retries_per_step` 调整。
- 工作区现在自动保持同步：新会话自动注册，缺失工作区启动时补全，已移除的不再重现。
- `kimi web` 现在会记录失败请求和关键操作，便于诊断服务问题。
- web: AgentSwarm 卡片在子 Agent 运行时保持展开。
- web: 最小化的计划审阅与问题卡片改用向上的 chevron 作为展开图标。

### 修复

- web: 修复 iOS 移动端布局问题，包括 composer、安全区和 toast。
- 修复新会话无法在旧版 CLI 中打开的问题。
- 修复子 Agent 完成时过早触发完成通知的问题。
- 修复 Web UI 显示错误 CLI 版本的问题。
- 修复 Gemini 模型的 tool call id 跨轮次冲突，导致 swarm 运行被合并到一张卡片的问题。
- web: 操作（如停止或归档会话）失败时现在会展示服务器错误详情。
- web: 修复标签页切换到后台后长响应卡住的问题。
- web: 修复纯 HTTP 下代码块复制按钮不可用的问题。
- web: 修复会话列表刷新失败时会话被清空的问题。
- web: 修复刷新页面后 AgentSwarm 成员列表丢失的问题。
- web: 修复首条消息为斜杠命令时会话标题不生成的问题。
- web: 修复重新加载会话后消息时间显示为会话创建时间的问题。
- 修复多个 `/goal` 模式问题，涉及预算与轮次上限、暂停与恢复、崩溃恢复、最终状态消息和无效的持久化目标记录。
- 修复被替换目标仍可能影响新目标预算的问题，并统一拒绝无效的子 Agent 目标。
- 修正目标无法暂停或恢复时显示的引导文案。

### 重构

- 将动态工具加载能力从 `select_tools` 重命名为 `dynamically_loaded_tools`，行为不变。

## 0.24.1（2026-07-14）

### 修复

- 修复 preserved-thinking 历史包含空推理步骤时，Kimi 会话卡住的问题。
- 修复模型供应商在会话启动后才就绪时，内置工具不可用的问题。
- 修复思考强度（thinking effort）路由问题：非 Kimi 供应商现在保留配置值，Kimi 模型会校验运行时选择，并在模型解析时安全回退。
- web: 对齐 Web 端与 CLI 的思考级别处理：所选级别原样提交，不再被静默降级；未选择或切换模型时回退到模型自身的默认级别；显式选择会保存为默认值并被新会话继承。
- 修复目标完成摘要丢失的问题；步骤中断事件中的无类型 LLM 错误不再显示内部错误码前缀。

### 优化

- web: 模型标签只显示级别名称（如 Max），不再显示 "thinking: max"。

## 0.24.0（2026-07-14）

### 新功能

- web: 新增会话导出功能，运行 `/export` 或在会话的更多菜单中选择「导出会话」，可将会话与故障排查日志打包为 ZIP 下载（上限 64 MiB）。
- 前台 `Bash` 命令超时时不再被终止，而是转入后台继续运行，完成后回报结果。在 `config.toml` 的 `[background]` 下设置 `bash_auto_background_on_timeout = false` 可恢复超时即终止的行为。

### 优化

- web: 优化 `/goal` 模式控件，新增动画条交互、预算感知进度条，以及符合设计系统的取消确认。
- 优化会话关闭流程：先请求后台任务停止并留出宽限时间，再强制停止仍未退出的任务。
- 重写重复工具调用提醒，引导 Agent 采取其他动作，而不是禁止调用。
- 优化 `TaskOutput` 的工具提示词，避免 Agent 阻塞等待后台任务。
- 请求供应商 registry（api.json）和模型目录时携带 kimi-code-cli 的 User-Agent，便于 registry 识别客户端版本。
- Skill 解析失败时输出警告，不再静默丢弃；并修复 Skill 扫描结果的报告遗漏。

### 修复

- 修复超大图片读取污染会话的问题；已因请求过大报错的会话现在会自动恢复。
- 修复会话 fork 丢失内容的问题：fork 出的会话现在保留媒体附件、plan 文件、后台任务输出和 cron 任务，fork 失败也不再留下残缺副本。
- web: 修复重新打开、重连或重新同步会话时的多处渲染异常，包括上下文用量指示器归零、User 消息气泡重复，以及多步轮次中的文本重复。
- web: 修复通过非 localhost 地址连接服务器时，已上传的图片无法显示的问题。
- web: 修复从 `/goal` 控件恢复被阻塞的目标后，目标无法继续运行的问题。
- web: 修复子 Agent 仍在运行时刷新页面，AgentSwarm 成员列表消失的问题。
- web: 修复会话目标活跃时刷新页面，目标卡片消失的问题。
- web: 修复工作区选择器菜单宽度过窄、无法容纳内容的问题。
- web: 修复子 Agent 的瞬时速率限制被暴露为会话错误的问题，现在会自动恢复。
- 修复 Windows 上 git 来自原生 MSYS2 工具链（ucrt64/clang64/clangarm64）时 Bash 自动检测失败的问题。
- 修复登录过程中供应商配置发生变更时，OAuth 登录在浏览器授权完成后卡住的问题。
- 修复 OAuth 托管模型在 token 刷新后持续返回 401 时误显示重新登录提示的问题，现在会展示供应商的实际拒绝原因。
- 修复未配置 `base_url` 的供应商被拒绝的问题：anthropic/openai 等协议供应商现在会像以前一样回退到官方默认端点。
- 修复会话启动后的首个轮次无法使用 MCP 工具的问题。
- 修复粘贴的媒体和图片在 `/skill` 与插件命令参数中被丢弃的问题，以及使用 `Ctrl-S` 引导时图片被丢弃的问题。
- 修复空推理块在跨供应商时被丢弃、导致多步工具调用中断的问题。
- 修复自动权限模式下 plan 退出被标记为「用户已审阅」的问题：现在正确标记为自动批准，Agent 不会再误将其当作用户开始执行的信号。
- 修复恢复会话时后台任务可能丢失、或被错误标记为丢失的问题。
- 修复服务器关闭后可能残留实例文件的问题。

### 重构

- `kimi web` 默认切换到重构后的 Agent 引擎。

## 0.23.6（2026-07-12）

### 优化

- web: 优化宽 Markdown 表格的显示，可超出阅读栏宽至 1040px，更宽时在表格内部横向滚动。
- web: 服务端访问令牌在关闭标签页或重启浏览器后最多保留 7 天，不再每次开新标签页都要求重新输入。
- web: 工作区选择器搜索框支持直接输入绝对路径添加工作区，输入时实时校验并给出补全建议。
- web: 切换到支持思考强度级别的模型时，自动启用默认思考强度。
- 导入自定义 registry 时识别 `support_efforts` 和 `default_effort` 字段，这些模型可设置思考强度（thinking effort）级别。
- 更新 `/plugins` 面板中打开的 WebBridge 安装页链接。
- 新增 `subagent.timeout_ms` 配置项（或 `KIMI_SUBAGENT_TIMEOUT_MS` 环境变量），控制单个子代理的超时时间，默认从 30 分钟提高到 2 小时。
- 新增 print 模式后台策略：设置 `[background].print_background_mode = "steer"` 后，`kimi -p` 在后台任务完成后保持运行，继续引导主 Agent 进入后续轮次。

### 修复

- web: 修复断线重连后会话卡在发送状态的问题，断线期间完成的轮次现在能正常结束加载状态并发送下一条消息。
- web: 修复启动或更新 web UI 后首次访问时，初始鉴权检查失败跳转到登录页的问题；现在停留在连接界面，显示连接错误并持续重试。
- 修复 `kimi -p` 在目标仍活跃或有定时任务待触发时主轮次结束即退出的问题，目标续跑与定时任务触发现在能正常执行对应轮次。
- 修复关闭问题提示时默认选中推荐选项的问题，现在视为用户选择不回答。
- web: 修复恢复或重新加载会话后，ReadMediaFile 结果显示为普通工具卡片而非图片的问题。
- web: 修复滚动浏览对话历史时聊天视图向下跳动的问题。
- web: 修复模型下拉菜单中其他提供商的同名模型被错误勾选的问题，现在按唯一的模型 id 匹配当前模型。
- web: 修复会话较多时侧边栏卡顿的问题，移除了渲染期间重复的会话列表扫描。

### 重构

- 将动态工具加载的模型能力名称从 `select_tools` 重命名为 `dynamically_loaded_tools`。

## 0.23.5（2026-07-10）

### 优化

- 优化 provider 429、过载等瞬时错误的重试可靠性，遵循服务端 Retry-After 等待时间，并在 `-p --output-format stream-json` 输出中展示重试事件。

### 修复

- 修复 AVIF、BMP、TIFF、ICO 等不支持的图片格式导致会话中断的问题，覆盖远程图片 URL、工具误标格式等所有入口。已卡住的会话会自动丢弃问题图片并重试，单张异常图片不再导致后续请求全部失败。
- web: 修复 “Turn finished” 桌面通知与完成提示音每轮触发两次的问题。
- web: 修复内部的图片压缩说明被当作用户消息文本显示的问题。

## 0.23.4（2026-07-10）

### 新功能

- web: 新增工具需要审批时的通知，并提升通知的可靠性。

### 优化

- web: 优化聊天界面，采用 Inter 字体、本地化标签与更紧凑的输入框和菜单样式。
- web: 优化会话侧边栏的布局、配色、图标与字体。
- `/usage` 和 `/status` 命令现显示 Extra Usage（加油包）余额。
- `/plugins` 面板的 Official 标签页新增 Kimi WebBridge 入口，可在浏览器中打开 WebBridge 安装页。

### 修复

- 控制图片较多会话的请求体积：超大体量的模型读取与粘贴图片（含 WebP）会自动压缩、缩小；HEIC/HEIF 图片会给出对应平台的转换命令，而非污染会话；HTTP 413 请求过大现可自动恢复——请求和 `/compact` 会用文本标记替换旧媒体后重试。相关限制可通过 `config.toml` 的 `[image]`（或 `KIMI_IMAGE_*` 环境变量）配置，且每个 core 独立保存设置，重新加载某客户端的配置不再影响其他客户端的图片压缩。
- 修复原工作目录已不存在的会话无法恢复的问题。
- 修复 prompt 模式目标未运行至完成的问题，并在发送 prompt 前校验并提示无效的目标命令。
- web: 修复新对话发送首条消息时偶发的 “another turn is active” 错误，并在发送过程中显示启动状态。

## 0.23.3（2026-07-08）

### 修复

- 修复当前账户无法使用某模型时错误显示“OAuth 登录已过期”的问题。

## 0.23.2（2026-07-08）

### 新功能

- 内置插件市场新增 Vercel 插件，运行 `/plugins` 并选择 Vercel Plugin 即可安装。

### 修复

- 修复 `kimi -p` 在轮次失败时仍以退出码 0 退出的问题。
- 修复自主目标会被模型上报的状态更新暂停的问题。
- 修复启动自主目标的轮次未计入其轮次预算的问题。
- 将图片降采样上限从 2000px 提高到 3000px，并修复 EXIF 旋转（竖拍）照片在压缩说明与媒体读取备注中宽高互换的问题，使区域回读坐标正确对应。
- web: 修复从后台返回后，WebSocket 重连完成但连接错误提示仍残留的问题。
- 修复 Windows 上每次运行 hook 时控制台窗口闪烁的问题。

### 优化

- web: 重新设计定时提醒界面。
- web: 在斜杠菜单中以 `/skill:<name>` 显示会话技能，便于与内置命令区分；直接输入技能名称仍然可用。
- web: 输入框的模型切换器在切换当前会话模型的同时，也会更新全局默认模型，使新会话继承该选择。
- web: 归档等确认对话框支持按 Enter 确认。
- 优化目标模式对阻塞与完成状态更新的指引。
- 渐进式工具加载（`select_tools`，实验功能）：压缩后丢弃已加载的工具 schema，由模型重新选择仍需要的工具，使压缩后上下文保持精简；凭记忆调用未再加载的工具会被拒绝，并提示先选择。仅在启用 `tool-select` 实验标志且模型支持 `select_tools` 时生效。

### 重构

- web: 在构建时编译图标，使打包后的 web UI 仅包含实际渲染的图标。

## 0.23.1（2026-07-07）

### 修复

- 修复 `kimi -p` 会丢弃启动较晚或运行时间较长的后台子 Agent、导致结果无法返回主 Agent 的问题。
- web: 修复后台标签页 WebSocket 失效后聊天流中断、必须刷新页面的问题，现在会自动恢复。
- 修复一些第三方模型如 Opus 4.8 错误回退到系列默认最大输出 token 数的问题，未收录的次要版本现在会沿用最近的已知较早版本的限制。
- 修复显式设置的 Anthropic `max_output_size` 被裁剪到内置上限的问题，现在会尊重用户配置。
- 修复工具输出中混入工具产生的 `<system>` 元数据的问题，失败的工具现在会显示其自身的错误信息。
- 修复目标完成或被阻塞时的更新行为，现在会从工具结果生成一条最终的、面向用户的结果摘要。
- 修复目标启动失败时未恢复权限模式、以及排队目标未等待新用户消息的问题。
- 修复目标 token 预算未计入模型补全 token 的问题，预算耗尽时现在会直接停止，不再执行额外的续跑步骤。
- 修复主 Agent 无法使用目标工具的问题，并为无效的目标控制调用返回清晰的提示信息。
- 修复交互模式下 `--skills-dir` 选项未生效的问题。
- web: 修复新会话页面上多个斜杠命令与 Skill 激活无效的问题：`/goal <objective>` 与斜杠 Skill 激活（如 `/pre-changelog`）之前毫无反应，`/btw [<question>]` 会打开一个空的侧聊。

### 优化

- Anthropic 供应商（Claude 与 Kimi 的 Anthropic 兼容模式）现在默认保留历史轮次的思考内容，与 Kimi 默认行为一致；可通过 `[thinking] keep = "off"` 或 `KIMI_MODEL_THINKING_KEEP=off` 关闭。
- 优化 `/permission`、`/auto`、`/yolo` 显示的权限模式描述，并在命令列表中调整 `/auto` 与 `/yolo` 的顺序。
- 长时间运行目标的运行时长预算提醒现在以小时为单位显示。
- 优化目标模式指引，使 Agent 在合理范围内跨轮次继续工作，避免过早结束目标。

### 重构

- 在会话 wire 日志中记录每次请求的追踪信息，以便在调试时还原模型请求。

## 0.23.0（2026-07-06）

### 新功能

- web: 在设置中新增「已归档会话」页面，可浏览并恢复已归档的会话，前往「设置 → 已归档」查看。
- 新增实验性的按需工具加载（`select_tools`）：开启 `tool-select` 标志后，支持的模型会按需加载 MCP 工具，而非每次请求都发送全部工具，以保留供应商的 prompt cache。默认关闭，且仅对声明了 `select_tools` 能力的模型生效。

### 修复

- 修复会话已存在于磁盘却在会话列表中缺失、或直接访问时返回 404 的问题，服务器现在会在启动时重建会话索引。
- 修复 Bash 与 Edit 工具卡片在结果流式返回或输出较短时发生高度塌陷、跳动或闪烁的问题，并在视觉上分离 Bash 命令与其输出。
- 修复斜杠命令菜单关闭后输入框向上移位的问题。
- 修复 Ctrl+E 的编辑审批预览未包含上下文行的问题，现与摘要面板一致。
- 修复添加额外工作区目录后，大型项目中 `@` 文件补全会遗漏深层嵌套文件的问题。
- web: 修复多处 web 布局与动画问题：折叠的侧边栏现在会正确隐藏，打开会话时聊天记录不再重复播放入场动画，工具组件展开或折叠时不再顶动对话内容。
- web: 修复定时提醒（cron）触发时被隐藏的问题，现在以通知卡片形式显示在聊天中。
- web: 修复重新打开会话后回复末尾仍然缺失的问题。
- web: 修复排队的媒体消息无法重新载入输入框的问题，并在撤销消息时保留附件。
- web: 修复窄窗口与手机上输入框工具栏控件被裁切的问题，context ring 在任意宽度下均保持可见。
- web: 修复字体大小设置，使聊天文本、输入框文本与侧边栏文本均跟随所选字号。
- web: 修复输入框输入光标几乎不可见、已完成待办的删除线过于暗淡的问题。
- web: 修复 Windows 上会话搜索快捷键显示不正确的问题。
- 修复 Google Gemini 模型的工具调用，包括 Gemini 3 跨轮次的 thinking signature 往返。

### 优化

- web: 将 swarm 底部栏替换为单个内联工具卡片，实时展示子 Agent 进度与汇总结果，并使 swarm 进度条在刷新后保持稳定。
- TUI 在 compaction 后显示摘要，可按 Ctrl+O 显示或隐藏。
- web: 将 AskUserQuestion 的回答渲染为可读的选项列表并高亮已选项，替代原始 JSON。
- web: 在会话创建前，于输入框中显示可用的 skills。
- web: 在移动端设置面板新增「已归档会话」入口，并在归档确认提示中说明可从设置中恢复。
- web: 在桌面通知中显示 Kimi 图标与更清晰的标题。
- web: 让 markdown diff 代码块与设计系统对齐：代码文本保持正常文本颜色，由符号与柔和的行背景标识变更，与 `~/diff` 面板一致。
- web: 避免聊天文本在换行处断字，并渲染代码时不使用字体连字。
- web: 移除工具调用卡片正文多余的左缩进，使展开内容与标题对齐。
- AskUserQuestion 的回答现在以问题文本与选项标签的形式回传给模型，而非位置 id，模型无需再将其映射回原选项；每次调用的问题文本须唯一，每个问题的选项标签须唯一，现有客户端仍以选项 id 作答，无需修改。
- Kimi 模型开启 Thinking 时默认跨轮次保留推理，可设置 `[thinking] keep = "off"` 关闭。

## 0.22.3（2026-07-04）

### 修复

- `kimi -p` 会在后台子 Agent 完成并返回结果后再退出，避免提前结束本轮。
- web: 修复 web 聊天中已上传视频无法播放的问题。
- 回退近期 TUI 对话渲染改动，恢复上游原始行为，修复相关渲染问题。

### 优化

- `kimi server run` 新增 `--dangerous-bypass-auth` 与 `--keep-alive` 选项，可在可信网络中跳过 token 校验运行服务器，并突破空闲超时保持存活。
- web: web 聊天中已上传的图片支持点击放大，点击消息中的图片即可在预览面板打开。

## 0.22.2（2026-07-03）

### 修复

- 修复在一轮对话于工具调用与其结果之间被打断后，后续用户消息被静默丢弃的问题。
- 修复模型输出重复的工具调用 id 时，请求被严格供应商拒绝的问题。
- 修复 Windows 上 `kimi upgrade` 在安装新版本时因 spawn 错误而失败的问题。
- 修复流式输出期间滚动历史中对话内容重复出现的问题。
- 修复压缩图片的提示词会把内部 `<system>` 压缩说明泄露到可见消息和会话标题中的问题。
- 修复 Windows 上自动后台更新会弹出控制台窗口的问题。

### 优化

- 优化 compaction 笔记：现在会记录剩余工作的后续计划（后续步骤、已确定的决策、可预见的障碍），而不仅是下一步，让 Agent 在自动压缩后更连贯地继续。
- 启动时从用户登录 shell 补充 PATH，使 shell 命令能找到用户自行安装的工具（如 Homebrew 的 `gh`），即使 kimi-code 启动时未继承完整的 profile PATH。
- 将语言匹配规则提升为系统提示词中的独立小节，使回复与推理在面对长篇英文工具输出时仍一致使用用户的语言，同时仓库产物仍遵循项目约定。
- TUI 新增一项偏好设置：当 bracketed paste 不可用时，避免快速多行粘贴被逐行提交。可在 `tui.toml` 中设置 `disable_paste_burst = true` 关闭该行为。
- 优化子 Agent 卡片，使其保持固定高度，并在紧凑的双行活动窗口内显示实时状态 spinner。
- `kimi -p` 运行时，若启用了 `background.keep_alive_on_exit`，退出前会等待后台子 Agent 完成。设置 `keep_alive_on_exit = true` 可让并发的后台子 Agent 执行完毕。

### 重构

- 在会话 wire 日志中记录模型响应 id，便于追踪单个模型请求。

## 0.22.1（2026-07-02）

### 修复

- 修复 TUI 渲染错误导致屏幕空白、输入框消失的问题。
- 修复当输入包含 CJK 或 emoji 文本时，将终端调到极窄宽度会导致 TUI 崩溃的问题。
- 修复打开多个会话后 web UI 变得卡顿的问题。
- 通过 `/new`、`/clear` 或切换会话开启新会话时，现在会完整清空屏幕。
- 修复 web tooltip 在触发元素被移除时仍停留在屏幕上的问题。
- 修复侧边栏会话行在悬停时标题与状态徽章发生位移的问题。
- 修复会话搜索框在会话标题或摘要较长时出现横向滚动条的问题。

### 优化

- 改进 compaction 交接摘要，使恢复会话更可靠：现在会保留最新意图、关键工具结果、决策、待解答问题以及需要复查的上下文。
- bash 模式新增 shell 命令历史：执行过的命令会保存到输入历史，在空的 `!` 提示符中按 Up 可浏览并回呼历史命令。
- 压缩超大图片时，会向模型说明原图与送达图片的信息，并保留原图，支持按裁剪区域或完整分辨率读取细节。
- 刷新 web UI 图标集，并统一消息复制与撤销按钮的悬停状态及 tooltip。
- web 侧边栏支持将已展开的工作区会话列表折叠回第一页。
- 精简 web UI 中冗余与不准确的 tooltip。
- web 输入框的发送按钮现在显示一个向上的箭头。

### 重构

- 移除实验性的 micro compaction 功能及其在实验面板中的开关。
- 移除 prompt 编辑器中重复的回车快捷键处理逻辑。

## 0.22.0（2026-07-02）

### 新功能

- 自动压缩超过模型限制的超大图片，在送达模型前降采样并重新编码，降低视觉 token 成本并避免供应商图片大小错误。
- 新增模型覆盖配置，在 `[models."<alias>".overrides]` 下配置模型元数据来覆盖供应商刷新结果。

### 修复

- 修复 web UI 中 plan、swarm 和 goal 模式在多个会话间共享的问题；现在每个会话各自保留独立的开关。
- 修复流式输出期间向上滚动历史记录时，transcript 会跳回顶部的问题。
- 在粘贴的图片与流式计时器不再显示后及时释放，避免长会话中内存持续增长。
- 修复崩溃或异常退出后终端停留在原始模式、光标隐藏且流控被禁用的问题。
- 修复活动工作区在加载时仅显示最近五个会话的问题；现在会从过去 12 小时内继续加载更早的会话。
- 修复默认开启 Thinking 的设置不生效的问题，新会话现在会正确以 Thinking 状态启动。
- 修复当操作已完成时，web 的 question、approval 和 task 操作会产生多余错误的问题，并新增加载反馈，使每次点击都立即得到确认。
- 草稿 pull request 现在显示独立的草稿状态，而不再被当作 open 展示。
- 当空间不足以展开标签时隐藏对话大纲，避免其被窗口边缘裁剪。
- 对于已提供多档思考强度的 always-on 模型，在 `/model` 思考切换器中隐藏不支持的 Off 选项。

### 优化

- 以全新设计系统刷新 web UI，包括更新的配色、字体与排版、间距、明暗调色板、重新设计的 tooltip，以及更细腻的进入/退出与展开/折叠动画。
- 将连续的工具调用归组为可折叠的堆栈，并为每个工具提供专属渲染：编辑显示 diff 行数标记，图片、视频和音频结果支持内联预览。
- 改进会话搜索，新增 Cmd/Ctrl+K 命令面板，可按标题、工作区和上一条 prompt 过滤并高亮匹配项。按 Cmd+K 或 Ctrl+K 打开。
- 在 web 聊天中将排队的 prompt 内联显示在当前轮次下方，并把 Stop 拆分为独立按钮，避免 Send 误中断。
- 对话大纲改为按每条用户提问显示为一项，悬停时展开为带标签的列表。
- 将 Explore 与 Native 主题选项替换为单一聊天布局，并提供 Blue 或 Black 强调色设置。
- 侧边栏新增工作区排序（按手动顺序或最后编辑时间），以及全部折叠/全部展开控件。
- web 错误与警告 toast 现在显示时间、耗时、连接与堆栈详情。
- web UI 的确认操作（归档会话、删除工作区、删除供应商、撤销消息、模式切换）统一使用一致的模态对话框。
- 缩小默认 TUI transcript 窗口，使长会话保持响应。
- 缩小 web 输入框的默认高度，使空状态更紧凑；并修复在多行草稿中编辑时 ArrowUp 会召回上一条消息的问题 —— 现在 ArrowUp 仅在文本最开头召回，且在展开的编辑器中禁用。
- 移除 web 聊天中撤销消息时的淡出动画。

## 0.21.1（2026-07-01）

### 修复

- 修复加密推理流式输出期间，首个响应文本出现前等待 spinner 消失、留下一段空白的问题。

## 0.21.0（2026-07-01）

### 新功能

- 插件现支持在清单的 `commands` 字段中声明斜杠命令，注册为 `<plugin>:<command>` 形式，调用时展开 `$ARGUMENTS`。
- web 聊天新增 Mermaid 图表渲染，助手回复中的 `mermaid` 代码块会渲染为图表。KaTeX 数学公式与 Mermaid 图表的解析移至 Web Workers 执行，提升流式渲染时的界面响应速度。

### 修复

- 修复格式异常的消息历史会在严格供应商（Anthropic）上永久卡死会话的问题。发送前会修复请求：关闭孤立的工具调用、丢弃空白或纯空白文本块；若供应商仍拒绝其结构，则按 wire 协议合规格式重建并重发一次。
- 强制退出无头运行（`kimi -p`），以免运行残留的引用句柄让已完成的运行一直存活到外部超时；同时为 prompt 清理加上时限，避免某个卡住的关闭步骤拖挂整个关闭流程。
- 修复在斜杠命令参数中输入 `@` 文件提及时无法打开的问题。
- 修复 web UI 中通过路径添加工作区时，daemon 拒绝路径会静默失败的问题；现在会显示错误，而不是生成一个无法使用的工作区。
- 修复同一文件夹被重复注册时，web 侧边栏显示重复工作区的问题。
- 修复 web 工作区重命名在页面刷新后不保留的问题。

### 优化

- 新增连按两次 Esc 打开撤销选择器的快捷键，空闲时连按两次 Esc 即可撤销。
- 在 shell 模式（`!`）下输入 `/` 时显示文件路径补全。
- web 设置中始终显示用量数据退出开关，并优化其标签与说明文案。

### 重构

- 重构对话压缩机制：
  - 仅保留最近的用户提示词与一条用户角色的摘要，丢弃助手与工具消息。
  - 发送前修复 `tool_use`/`tool_result` 的相邻关系，修复工具调用与其结果不相邻时严格供应商返回 HTTP 400 的问题。
  - 为严格供应商（Gemini/Vertex）合并连续的用户轮次，修复压缩后或在工具结果后立即插入引导轮次时出现的 HTTP 400（"roles must alternate"）问题。
  - micro-compaction 现在默认关闭。
- 重构 thinking effort 系统。
- 新增服务端键值存储 API，用于将 web UI 偏好持久化到用户数据目录。

## 0.20.3（2026-06-30）

### 修复

- 修复服务器返回 HTML 错误页面时，供应商错误消息在 TUI 中显示为空白行的问题。
- 修复 web 输入框被移动端 Safari 工具栏遮挡，以及输入框聚焦时页面自动放大的问题。

### 优化

- 在后台自动刷新供应商模型列表，而非仅在启动时刷新，新上架的模型无需重启即可显示。
- Glob 现改用 ripgrep，默认遵循 .gitignore，支持花括号模式，仅返回文件，并在部分目录不可读时保留已有结果并给出警告。

### 重构

- 将格式错误的工具调用参数的处理与 schema 验证 fallback 对齐。

## 0.20.2（2026-06-29）

### 新功能

- Kimi Code 现支持 Anthropic 兼容协议，并支持视频输入。
- web UI 新增完成提示音与问题通知，并在设置中分别提供完成通知、问题通知和提示音的开关。问题通知默认关闭，仅在用户主动开启后才会将问题文本发送到桌面。
- 新增 `KIMI_CODE_CUSTOM_HEADERS` 环境变量，用于自定义出站 LLM 请求头，并向非 Kimi 供应商发送 `User-Agent` 请求头。将 `KIMI_CODE_CUSTOM_HEADERS` 设为由换行分隔的 `Name: Value` 行。
- 会话列表 API 新增可选的 `exclude_empty` 参数，用于省略没有任何消息的会话。

### 修复

- 遇到供应商 413 上下文溢出时，先压缩再重试以恢复。
- 默认将压缩输出限制在 128k token，避免供应商 `max_tokens` 错误。
- 修复压缩忽略已配置最大输出长度的问题。
- 修复在输入框输入或切换斜杠面板时不必要的全屏重绘。
- 在 web UI 中将未发送的输入框附件限定在所属会话内，切换会话时不再将其泄漏到另一个会话的下一条消息中。
- 修复 web 输入框在新会话发送首条消息后偶尔残留已输入文本的问题。
- 修复撤销轮次后调试计时输出残留的问题。
- 修复运行提示被挤压到 Agent Swarm 进度条上的问题。

### 优化

- 将 web 询问用户问题卡片重做为分步向导，使多问题导航和最终的 Submit 操作更清晰。
- 在内置 web UI 中，现在仅在发送首条消息时才创建新会话，因此未选择工作区时点击 `+ New` 会打开输入框，而不是创建空会话。
- 在 web UI 中切换回某会话时恢复其滚动位置。
- 在 web UI 中切换会话时保持已打开的侧面板。
- 将 web 输入框的上下方向键输入历史限定在当前会话，不再跨会话共享。
- 在内置 web UI 中，`/new` 和 `/clear` 现在作为别名打开会话引导输入框并聚焦输入；文本输入框字号保持为 16px 即可避免 iOS 自动放大，无需再禁用视口缩放。
- 默认在 web 会话列表中隐藏未使用的 "New Session" 条目。
- 从 web UI 中移除 `/sessions` 斜杠命令，侧边栏已覆盖会话浏览功能。
- web 侧边栏每个工作区显示前五个会话，而非十个。
- 将 web 输入框附件按钮的加号图标替换为图片图标。

### 重构

- 将 Anthropic 兼容协议上的 Kimi Code 模型改走 beta Messages API。
- 升级 web Markdown 渲染器依赖（katex、markstream-vue、shiki），以修复问题并改进性能。
- 在轮次和 API 错误遥测中新增供应商类型与协议属性。

## 0.20.1（2026-06-26）

### 新功能

- 插件现支持在 `kimi.plugin.json` 中声明生命周期 hooks，在指定阶段运行脚本。详见[插件 Hooks](https://funcoding.ai/agents/kimi-code/customization/plugins/#%E6%8F%92%E4%BB%B6%E4%B8%AD%E7%9A%84-hooks)。
- `/feedback` 现支持附加诊断日志与代码库上下文。
- 新增 `kimi update` 命令，等价于 `kimi upgrade`，可用于升级到最新版本。
- `kimi web` 新增 `--allowed-host <host>` 选项，可将指定 Host 加入 DNS 重绑定白名单；403 错误会提示如何通过 `--allowed-host` 或 `KIMI_CODE_ALLOWED_HOSTS` 放行，例如 `kimi web --allowed-host example.com`。

### 修复

- 修复 Windows 上 kimi server 首次运行后无法启动的问题。
- 修复 `/web` 命令打开的 Web UI 不会自动登录的问题，现在终端会打印访问 token。
- chat-completions 供应商的 `max_tokens` 现在不超过剩余上下文窗口，避免上下文溢出与无效参数错误。

### 优化

- 优化默认系统提示词与内置工具描述，避免 Agent 阻塞后台任务，统一各 profile 的工具指引，并补充展示工具结果详情（fetched-page 模式、Grep 匹配总数）。
- 缓存已渲染消息行，提升长对话下终端的响应速度。
- transcript 仅保留最近轮次并折叠早期步骤，保持长会话响应流畅。
- Web 聊天输入框支持随内容自动增高，长消息可使用可展开编辑器。
- 折叠待办面板时显示隐藏待办的状态明细（已完成 / 进行中 / 待处理）。

## 0.20.0（2026-06-26）

### 新功能

- TUI 新增 shell 模式。在输入框中键入 `!` 即可启用。对于长时间运行的命令，按 `Ctrl+B` 可将其移至后台。例如，你可以运行 `!gh auth login` 登录 GitHub CLI，无需打开新的终端。
- CLI 新增 `--host` 选项，可通过 `kimi web --host` 将服务器暴露到互联网，并加固 token 鉴权、限流等安全措施。
- Web UI 支持渲染 LaTeX 行间公式（`$$…$$`）。

### 修复

- 修复 Linux 上由未处理的原生剪贴板错误导致的启动崩溃。
- 修复当 CLI 通过 npm/pnpm 安装或从源码运行时，`kimi web` 和 `/web` 在 Windows 上因 `spawn EFTYPE` 无法启动后台服务器守护进程的问题。官方单二进制安装脚本不受影响。
- 修复终端窗口在 Linux Wayland 上反复失去焦点、导致输入法（IME）输入失效的问题。
- 不再在 60 秒后自动关闭 web UI 中的问题，使其等待用户的回答。
- 修复 explore 子 Agent 在 git 命令超时或目录不是仓库时静默丢失 git 上下文的问题。
- 修复压缩期间按 `Ctrl-C` 的问题，现在会先清除待处理的编辑器草稿，而不是立即取消。
- 修复会话由 web 服务器托管时 MCP 服务器工作目录的问题。
- 修复内置 web UI 在重新同步期间重复重新加载会话快照的问题。
- 修复模型的 Skill 列表中被截断的 Skill 描述缺少省略号的问题。

### 优化

- 将 `/plugins` 重新设计为单个标签页面板：**Installed**（管理已安装插件——切换、移除、MCP、详情、重新加载）、**Official**（Kimi 维护的 marketplace 插件）、**Third-party**（来自其他发布者的 marketplace 插件）以及 **Custom**（直接从 GitHub URL、zip URL 或本地路径安装）。使用 `Tab` / `Shift-Tab` 切换标签页。
- 当 Agent 在 web 聊天中编辑或写入文件时，显示逐行 diff。
- 在 web UI 中退出 Plan 模式时，在计划审查卡片中显示计划正文和方案选项。
- 在子 Agent 的详情面板中显示其完整的累积进度，并以简洁的工具调用摘要替代原始 JSON。
- `/reload` 现在会刷新 Assistant 对插件 Skill 的视图，因此插件变更可在当前会话中生效，而无需启动新会话。
- 将静默的 AGENTS.md 截断替换为 TUI 状态栏和 web UI 中的可见警告。
- 在安装第三方插件前新增确认提示。
- 在 `/plugins` 的 Installed 标签页上显示更新徽章，现在按 `Enter` 安装可用更新，按 `I` 打开插件详情。
- 在 web 聊天的用户消息中新增复制按钮。
- 在预览被截断时保留完整的工具输出日志，并将后台任务完成通知链接到已保存的输出。
- 在服务器模式下，将会话标题变更同步到所有已连接的客户端。
- 在任务输出查看器中新增 `Ctrl+U` 和 `Ctrl+D` 作为向上翻页和向下翻页的快捷键。
- 在每轮步数上限错误中新增一条提示，指引用户查看 `loop_control.max_steps_per_turn` 配置项。
- 降低包含代码块的长 Assistant 消息的流式重绘开销。
- 按工作区分页加载 web 会话列表，使首屏不再预先获取全部会话。
- 避免 web 会话侧边栏在每个流式 token 上重新渲染，以提高渲染性能。
- 写入文件时自动创建缺失的父目录。
- 改进图片粘贴提示。

## 0.19.2（2026-06-24）

### 新功能

- 保持 web 侧边栏允许拖放工作区排序，排序结果在本地持久化；现在会话一旦收到新消息也会立即上浮到其分组顶部。
- 在模型选择器中新增 `Alt+S` 快捷键，仅切换当前会话的模型，而不保存为默认值。
- 新增 `Ctrl+T` 快捷键，用于展开和折叠被截断的待办列表。
- 新增 `-c` 作为 `--continue` 的简写。

### 修复

- 修复 web 应用中 YOLO 模式会自动批准计划审查和敏感文件访问的问题。
- 修复会话恢复时未重新对齐在历史中段被中断的工具调用的问题。
- 修复新会话首条消息之后，输入框的 `↑`/`↓` 输入历史回溯无效的问题。
- 修复偶发的陈旧行在较高内容收缩后留下重复输入框的问题。
- 修复内联图片在对话记录中被渲染为损坏的转义序列的问题。
- 修复嵌套在列表项中的代码块在 web 聊天的一轮生成结束后渲染为空白的问题。
- 修复 `Tab` 键意外打开文件补全列表的问题。
- 修复 web UI 通过普通 HTTP 提供时剪贴板复制操作失效的问题。
- 修复 web 问题提示缺少自由文本 Other 选项的问题。
- 修复 web 聊天停止操作，使过期的 prompt id 回退为取消当前会话。

### 优化

- 在受控内存中读取大型文本文件，并无需扫描整个文件即可读取尾部行。
- 在运行中的 Bash 工具卡片中显示命令，并允许在结果返回前使用 `Ctrl+O` 展开。
- 允许将 web 侧边栏和详情面板调整至可用视口宽度，并在窄窗口中保持其调整大小的手柄可达。
- 在 `Tab` 补全斜杠命令名称后显示子命令建议。
- 当剪贴板中检测到图片时显示一个短暂的底部提示，展示平台对应的粘贴快捷键。
- 在 web 侧边栏中跨页面重新加载持久化工作区分组的折叠状态。
- 在 web 侧边栏中新增用于本地开发的开发模式指示器。
- 优化加载提示的显示。

### 重构

- 将 web 应用的组件按功能子目录（chat/settings/dialogs/mobile）重组，并刷新组件路径注释。
- 将输入框的若干组件提取为可复用的 composable。
- 将纯轮次渲染辅助函数从对话面板中提取到独立模块。
- 将 beta 版对话大纲（目录）提取为独立组件。
- 将工作区分组渲染从侧边栏中提取为独立组件。

## 0.19.1（2026-06-23）

### 修复

- 修复 ACP 编辑器（如 Zed）无法启动新会话的问题。
- 修复 web 侧边栏的未读圆点在不同浏览器标签页之间失去同步的问题。
- 在会话被归档或移除时清空该会话的全部状态，使已归档会话不再留下孤立数据。

### 重构

- 整合 web 客户端 localStorage 访问，并将根状态 store 与应用 shell 拆分为职责单一的 composable。

## 0.19.0（2026-06-22）

### 新功能

- 新增添加额外工作区目录的能力：
  - 使用 `/add-dir <path>` 命令将额外工作目录添加到当前会话，或将其记住到项目中。
  - 使用 `kimi --add-dir <path>` 在启动时添加它们。
  - 项目级本地配置现在由 `.kimi-code/local.toml` 管理；我们建议将其添加到你的 `.gitignore` 中。
- 允许使用 `Ctrl+B` 将长时间运行的前台命令和子 Agent 移动到后台任务，并通过 `/tasks` 面板查看它们。

### 修复

- 现在会显示供应商安全策略拦截，而不是将其静默视为已完成轮次，并防止在过滤响应后上下文 token 计数降为零。
- 修复当恢复的会话历史包含空文本内容块时供应商请求失败的问题。
- 在读取媒体时从文件内容检测真实图片格式，因此文件名扩展名不匹配不再会生成模型 API 拒绝的 data URL。
- 修复 Windows 上命令会闪现空白控制台窗口的问题。
- 停止在 web 侧边栏中为已取消或失败的会话显示未读圆点。

### 优化

- 通过直接磁盘读取器和请求超时保护加快会话快照加载，同时保留之前的路径作为遗留回退。
- 在 web 聊天标题中显示更长的分支名称，并在悬停时显示完整名称。
- 保持 web 页面标题固定，而不是随会话或工作区名称变化。
- 优化文件提及体验。

### 重构

- 在格式嗅探失败时统一图片格式检测。
- 整合 web 客户端 localStorage 访问，并将外观/通知状态解耦到专用模块中。

## 0.18.0（2026-06-18）

### 新功能

- 在 web 侧边栏中新增会话筛选，可过滤标题和最近一条用户提示词。
- 在 web 聊天会话视图中新增向上滚动时懒加载更早消息的功能。
- 新增环境变量以限制 AgentSwarm 在初始 ramp 阶段的并发数，使大型 swarm 更不容易触发供应商的速率限制。

### 修复

- 修复 web 应用只加载最近 20 个会话的问题。
- 修复 web 斜杠 Skill 选择会立即发送的问题，并允许斜杠搜索按子串匹配。
- 修复在浏览较长的斜杠菜单时高亮斜杠命令可见的问题。
- 修复最后一个会话归档错误的显示失败的问题。
- 修复 web 登录斜杠命令的描述，使其与浏览器授权流程相匹配。

### 优化

- 重新设计 web OAuth 登录对话框，使步骤顺序不再含糊。
- 在 web 设置中现在可以显示当前版本。
- 允许较长的 web 斜杠命令名称和描述自动换行，避免溢出斜杠菜单。
- 在插件变更提示中，增加 `/reload` 提示。

## 0.17.1（2026-06-17）

### 修复

- 修复 `kimi web` 命令无法在后台启动的问题。
- 阻止后台本地服务器锁定启动时所在的目录。
- 防止点击背景时关闭 web 登录对话框。

### 优化

- 在 web 设置中按供应商对默认模型下拉框进行分组。

## 0.17.0（2026-06-17）

### 新功能

- 新增 Kimi Code Web 模式，可通过 `kimi web` 或 CLI 内的 `/web` 启动，在浏览器中的聊天界面继续会话。

### 修复

- 当 OAuth token 刷新在内部重试后失败时，显示底层连接错误，而不是提示登录。token 刷新失败不再在 agent 循环层级被重新重试。
- 在恢复会话时从持久化的循环事件中还原轮次计数器，避免恢复后的轮次重复使用历史中已存在的 turn id。

### 优化

- 当输出流太短而无法可靠测量时，跳过 debug TPS。

## 0.16.0（2026-06-16）

### 新功能

- 新增内置的 `kimi vis` 命令，可在浏览器中启动会话可视化工具，并指向本地会话。支持 `--port`/`--host`、`--no-open` 以及 `kimi vis <sessionId>` 深度链接。

### 修复

- 阻止 Anthropic 兼容供应商读取环境 Anthropic shell 凭证和自定义 header。
- 修复上下文仍超过阻塞阈值时的重复压缩处理问题。
- 防止会话关闭在停止后台任务时恢复 agent。
- 会话 replay 范围现在基于渲染后的 replay 记录构建，而非原始持久化记录。
- 在缓冲读取器被销毁时关闭被包装的输出流。

### 优化

- 将 `/btw` 侧面板的最大高度从终端的一半降低到三分之一。
- 优化队列面板样式。
- 新增可配置的横幅显示频率，并维护本地显示状态。

### 重构

- 移除冗余的 LLM 请求日志上下文传递。

## 0.15.0（2026-06-15）

### 新功能

- 新增全会话选择器视图，支持按名称搜索、分页浏览，以及为其他工作目录中的会话生成可复制的恢复命令。
- 新增对 legacy SSE MCP server 的支持，与 stdio 和 streamable HTTP 传输方式并存。

### 修复

- 修复中断的工具调用结果未被记录时，已恢复会话无法继续使用的问题。
- 停止将恢复版本标记写入持久化的 agent 元数据。
- 迁移后的配置文件中不再包含已废弃的 legacy loop、background、plan、yolo 或未知的实验性 flag。
- 修复 Xcode 26.5 MCP server 发出的 JSON Schema 类型与 Moonshot 不兼容的问题。

### 优化

- 通过换行、压缩或截断可能超出渲染宽度的行，使 TUI 组件保持在窄终端宽度内。
- 在调用较重要的工具前，提示 CLI 以用户当前语言显示一句简短的状态说明。
- 将同语言规则扩展到模型的推理过程，使思考内容跟随用户语言，同时保留代码和技术术语的原始形式。
- 读取媒体文件时优先使用文件头检测到的类型，再回退到媒体扩展名。
- 在 Ctrl-C 取消活跃流之前，优先清除草稿编辑器文本。
- 在工作区提示词中折叠隐藏目录，并说明如何查看它们。
- 在已加载 skill 的上下文块中包含 skill 的目录，以便 agent 在调用 skill 后能够定位其打包资源（脚本、模板）。
- 当前工作目录没有会话时，显示全会话切换提示。
- 明确压缩摘要必须在最终答案中输出。
- 明确 AGENTS.md 提示词指导，并标记被截断的指令文件。

### 重构

- 通过静态查找而非实例化临时 provider 来解析模型能力。
- 将 agent skill 访问与 session 特定的注册表实现解耦。
- 优化 npm 打包系统。

## 0.14.3（2026-06-14）

### 优化

- 在打开模型选择器前刷新供应商模型元数据。

## 0.14.2（2026-06-12）

### 修复

- 修复 iTerm2 中无休止的桌面通知问题，仅向支持进度序列的终端发送终端进度序列。
- 在恢复会话时正确显示已完成和已取消的压缩记录。
- 丢弃无效的 `config.toml` 配置节并发出警告，而不是启动失败。

### 优化

- 在命令仍在运行时流式输出前台 Bash 的 stdout 和 stderr。
- 允许 `--auto`、`--yolo` 和 `--plan` 与 `--session` 或 `--continue` 组合使用，将请求的模式应用到恢复的会话。
- 为子 Skill 名称添加父前缀，并在 TUI 中将子 Skill 暴露为点状斜杠命令。
- 在启动刷新期间同步自定义 registry provider 的新增、移除和轮换的 registry key。

## 0.14.1（2026-06-12）

### 修复

- 在会话关闭时取消活跃轮次，避免前台 shell 命令在 prompt 模式退出后继续运行。
- 会话关闭时默认停止后台任务。
- 防止重叠的交互式 Agent 请求使用错误的活跃 Agent。
- 修复 shell 进程超时或被终止时出现的过早流关闭错误。
- 将不支持的音频/视频降级为占位文本，并重新附加工具结果媒体，而不是静默丢弃它们。
- 将 OpenAI Responses 的系统提示词作为请求 instructions 发送。
- 在派生进程中透传已配置的执行环境覆盖项。
- 修复通过 IDE 客户端打开的 Windows 工作区中的 ACP 文件读取和编辑问题。
- 要求 AgentSwarm 工具调用在模型响应中单独运行。

### 优化

- 新增对动态 MCP server 更新、reference Skill、replay 时间戳和 Node 文件上传的运行时支持。
- 在从 Manual 模式启动 swarm 任务时新增 YOLO 选项。
- 优化内置 Skill。
- 在自动补全中通过别名查找斜杠命令 —— 输入 `/clear` 现在会提示 `new (clear)`。
- 在自动补全菜单中将过长的命令和 Skill 描述换行到第二行显示，而不是截断。
- 在启动时的欢迎面板下方显示提示横幅。

## 0.14.0（2026-06-10）

### 新功能

- 新增 `Interrupt` hook 事件，当用户中断某一轮次时（例如按 Esc）触发，让 hooks 可以观察到轮次正在停止，而不再卡在 working 状态。

### 修复

- 在使用 OpenAI 兼容的 Chat Completions 时保留工具输出的图像。

## 0.13.1（2026-06-10）

### 修复

- 阻止在活跃 turn 期间 fork 会话，并将 wire protocol 定义整合到共享的内部包中。
- 修复 Kimi Datasource，使其在当前 Kimi Code 环境中使用匹配的 OAuth 凭证和服务端点。
- 修复 goal 标记文本超出终端宽度的问题。

### 优化

- 在 Anthropic 供应商中新增对 Claude Fable 5 的支持。
- 新增交互式 undo 选择器和更清晰的 undo 限制提示消息。
- YOLO 模式在工作目录外写入或编辑文件时不再询问。
- 优化活跃 skill 提示词，使已加载的 skills 不再被表示为系统提醒。
- 收紧文件工具引导，使增量编辑通过 Edit 工具执行。

## 0.13.0（2026-06-10）

### 新功能

- 新增自定义颜色主题。在 `~/.kimi-code/themes/` 中以 JSON 文件定义自己的调色板，或使用内置的 `/custom-theme` Skill 命令生成。
- 新增 `/import-from-cc-codex` 命令，用于导入选定的 Claude Code 和 Codex 指令、Skills 以及 MCP 设置。
- 在 marketplace 中显示可用的 plugin 更新。

### 修复

- 修复 Windows 构建和开发启动可能因 package binary 解析到命令 shim 而失败的问题。
- 修复设备登录，在浏览器无法打开时保持 URL 和验证码可见。

### 优化

- 通过活跃状态细分和已用时间，更清晰地展示分组子 Agent 进度。
- 当排队消息超过终端宽度时，将其截断为单行并显示省略号。

## 0.12.1（2026-06-09）

### 修复

- 允许过时的实验性配置条目保留而不阻塞启动。
- 为 OpenAI 兼容的 Chat Completions 请求透传 xhigh reasoning effort。

## 0.12.0（2026-06-09）

### 新功能

- 新增 `/swarm` 命令，用于运行 Agent Swarm，支持实时进度展示和速率限制感知重试。
- goals、background questions 和 sub-skill discovery 不再需要实验性开关即可使用。
- 支持标准环境变量 `HTTP_PROXY` / `HTTPS_PROXY` / `ALL_PROXY` / `NO_PROXY`（包括 SOCKS 代理）用于所有出站流量。
- 支持 Homebrew 安装。
- 默认启用 micro compaction，可在 `/experiments` 中关闭。

### 修复

- 修复 ACP 斜杠 Skill 路由、bootstrap 上下文读取、文件与权限边界情况、子 Agent 事件处理以及过期文件编辑消息的问题。
- 修复 goal 恢复行为，通过从 Agent 记录中恢复 goal 状态。
- 修复子 Agent 的 thinking 文本和工具输出显示。
- 修复 Windows 上由不一致的路径分隔符导致的会话工作目录不匹配问题。
- 修复 `/mcp` 状态面板边框被多行 MCP server 错误破坏的问题，现在会折叠到单行显示。
- 检测通过 Scoop 安装的 Git Bash 以及 Windows 上的其他 Git shim。
- 在迁移失败时显示底层错误。
- 允许通过重复按 Ctrl-C 或 Ctrl-D 退出启动会话选择器。

### 优化

- 移除每轮自动压缩上限，让长对话可以继续压缩而不是提前失败。
- 改进 goal 模式的结果处理，包括后续消息、更安全的错误暂停和更清晰的 TUI 对话记录展示。
- 直接展示完整 plan 卡片，并移除 Plan 卡片键盘快捷键。
- 在审批提示中换行显示过长的单行 shell 命令，以便完整命令始终可见。
- 重构 TUI 中的文件引用补全。
- 当设置了 `KIMI_CODE_HOME` 时，从该路径加载 Kimi 特定的用户 Skills 和全局 Agent 指令。

## 0.11.0（2026-06-05）

### 新功能

- 新增由环境变量 `KIMI_CODE_EXPERIMENTAL_SUB_SKILL` 控制的实验性子 Skill 发现能力。随附 `sub-skill` 内置包（`sub-skill.review`、`sub-skill.consolidate`），用于盘点 Skill 并将其整理为分层分组。
- 新增以下环境变量：
  - `KIMI_MODEL_TEMPERATURE`、`KIMI_MODEL_TOP_P` —— 全局应用于任意 `kimi` 供应商的采样参数（不绑定到 `KIMI_MODEL_NAME`）。
  - `KIMI_MODEL_THINKING_KEEP` —— Moonshot 的 preserved-thinking 透传（`thinking.keep`），仅在开启 Thinking 时注入。
  - `KIMI_CODE_NO_AUTO_UPDATE`（旧别名 `KIMI_CLI_NO_AUTO_UPDATE`）—— 完全禁用更新预检（不检查、不后台安装、不提示）。
- 将内置 Skill 显示为直接斜杠命令，并将其分组排在外部 Skill 命令之前。

### 修复

- 修复斜杠命令自动补全，让光标位于已有文本之前时也能提交目标文本。
- 修复已排队目标在晋升尝试失败时会丢失或重复的问题。
- 修复编辑或粘贴已排队目标时的待处理目标队列处理。
- 在 YOLO 模式下启动目标前进行询问，方便用户切换到 Auto 来处理无人值守工作。
- 当响应在产生可见输出前被拦截时，显示简洁的供应商过滤错误。
- 输入无效子命令时显示 “unknown command” 而不是 “too many arguments”。
- 将 OpenAI Chat Completions 的 `xhigh` 和 `max` thinking effort 限制为 `high`，除非模型在 `v1/chat/completions` 上支持 `xhigh`。
- 在压缩长对话时保留 thinking effort。
- 当能力变化而模型 ID 未变化时刷新供应商模型元数据。

### 优化

- 让待处理目标的确认样式与目标生命周期消息使用相同的强调处理。
- 当没有活跃目标需要等待时立即启动待处理目标。
  支持在管理待处理目标时进行多行编辑。
- 为子 Agent 使用固定的 30 分钟超时，并在超时后显示简洁的恢复说明。
- 输入斜杠命令时高亮目标队列子命令。

## 0.10.1（2026-06-05）

### 修复

- 修复在 TUI 中启动目标时的崩溃问题。

## 0.10.0（2026-06-04）

### 新功能

- 用户现在可以为 Agent 准备多个目标，让它按顺序逐一处理。当前目标完成后，Agent 会自动从队列中取出下一个目标。使用 `/goal next <objective>` 将目标加入队列，使用 `/goal next manage` 交互式查看和修改队列。
- 新增内置的 `update-config` Skill —— 你现在可以让 Kimi 编辑它自己的配置文件。
- 新增持久化的实验性功能开关，以及一个 TUI 面板，确认后会通过重载当前会话来应用变更。
- 新增 `/reload` 以重载当前会话并应用更新后的配置文件，以及 `/reload-tui` 以仅重载 TUI 偏好设置。
- 新增 doctor 命令，用于校验 Kimi Code 的配置文件。

### 修复

- 将格式错误的 Responses 流速限错误规范化为供应商速率限制失败。
- 让托管的 OAuth 凭据始终限定在其配置的认证和 API 端点范围内。
- 阻止将活跃和已排队的目标带入派生会话。
- Windows 上若缺少 Git Bash，则在启动 CLI 会话前提前失败。
- 在展示前台更新提示前刷新更新目标，确保显示版本与安装版本一致。
- 将会话错误诊断指向 `/export-debug-zip` 命令。
- 设置终端标签页标题时不再重命名运行中的进程。

### 优化

- 启动时的更新检查一旦发现新版本，立即开始自动后台更新。
- 在启动期间将 CLI 进程标题设置为 `kimi-code`。
- 将编辑工具错误中的过期文件内容提示改为小写。

### 重构

- 确保 Nix 打包的 CLI 构建能够找到 ripgrep 和 fd。

### 其他

- 在 Windows 安装说明中补充 Git Bash 前置条件。

## 0.9.0（2026-06-03）

### 新功能

- 支持 `kimi acp` 子命令：kimi-code 现在可通过 stdio 使用 [Agent Client Protocol 0.23](https://agentclientprotocol.com/)，因此 IDE（Zed、JetBrains AI Chat、自定义客户端）可以直接驱动会话；覆盖矩阵、Zed 配置和破坏性预发布说明见 [kimi acp 子命令页面](https://funcoding.ai/agents/kimi-code/reference/kimi-acp/)。
- 新增 `/btw`，用于进行不会引导当前主轮次的侧通道对话，并允许 `/btw` 在输入问题前打开侧通道面板。

### 修复

- 修复 Windows 上外部编辑器（Ctrl+G），移除对 `/bin/sh` 的依赖，并为临时文件路径使用平台感知的 shell 引号处理。
- 使用新版 Chat Completions 模型所需的 OpenAI completion token 字段。
- 使用已配置的模型输出上限作为 completion token 上限。
- 修复适用于 OpenAI 兼容供应商的 goal budget 工具 schema。
- 在访问已保存的子 Agent 时再惰性恢复它们。

### 优化

- 统一 TUI 对话框和选择器的交互与视觉效果。
- 启动时记录已启用的实验性 flag。

### 重构

- 允许 SDK 运行时创建使用单独的 RPC client，同时保留本地 CLI 启动流程。

## 0.8.0（2026-06-02）

### 新功能

- 新增实验性 goal 模式，用于需要多轮处理的较长任务。在启动 Kimi 前设置 `KIMI_CODE_EXPERIMENTAL_GOAL_COMMAND=1` 即可开启。
  在终端界面中使用 `/goal <objective>` 让 Kimi 跨轮次持续专注于同一任务。例如：
  ```text
  /goal Fix the failing checkout test
  ```
  Kimi 会在终端界面中显示目标，并在工作过程中保持进度可见。使用 `/goal status`、`/goal pause`、`/goal resume`、`/goal cancel` 和 `/goal replace <objective>` 来管理该目标。该功能仍处于实验阶段，欢迎试用并反馈改进建议。
- 新增 `kimi provider` CLI 子命令，支持 `add`、`remove`、`list` 以及 `catalog list` / `catalog add` 操作，可在不启动终端界面的情况下导入和管理来自自定义 registry（api.json）或公开 models.dev 目录的供应商。
- 新增后台结构化提问，让 Agent 在等待用户回答时也能继续工作。
- 新增后台自动更新，可在 tui.toml 中关闭。
- 新增 `/undo` 斜杠命令，用于从对话历史中撤回上一条提示词，并在撤回时保持回放记录同步。
- 新增 `kimi upgrade` 命令，用于手动检查并升级 Kimi Code CLI。
- 新增审批生命周期 hook 事件，用于观察待处理和已完成的权限提示。
- 允许子 Agent 使用在其父 Agent 上注册的自定义工具。
- 支持用 glob 搜索显式的绝对路径（工作空间之外）。

### 修复

- 修复跨供应商回放时因不兼容的工具调用 ID 和未签名的 Claude thinking 历史导致失败的问题。
- 修复自定义 registry 供应商在重新导入时的处理问题，防止多供应商条目丢失，并移除过时的供应商及其模型别名和默认模型引用。
- 修复工具输出预览的渲染效果：去除尾部空行、为多行 Bash 命令标题附加省略号，并按视觉换行而非原始换行数裁切过长的单行输出。
- 修复斜杠激活的 skill 因缺少系统提示词包装器而未被模型识别的问题。
- 修复在过窄终端上 `/sessions` 选择器崩溃的问题，通过将每行渲染宽度限制在终端宽度内。
- 在括号展开前规范化 glob 模式，防止不正确的路径匹配。
- 防止退出 CLI 后仍出现修改过的键盘释放序列。
- 修复 Windows 上的 Git Bash 路径检测，额外搜索 `usr\bin\bash.exe` 路径，这是许多 Git for Windows 安装中 bash 所在的位置（这些安装中 `bin\bash.exe` 不存在）。

### 优化

- 在欢迎面板中展示 MCP server 摘要，并在 /mcp 命令输出中增加配置提示。
- 在欢迎界面及未配置模型时的提示中，将用户引导至 `/provider` 而非已移除的 `/connect` 命令。
- 将当前 todo 列表以 markdown 形式附加到压缩摘要中，再写入历史记录。
- 在页脚状态栏中显示完整模型名称，不再截断供应商前缀。
- 在长任务中提醒模型刷新 TodoList，并加强 TodoList 进度追踪引导。
- 将会话目录警告中的 chalk 具名颜色替换为主题感知的十六进制色值。

### 重构

- 将后台任务管理统一到 Agent 后台运行时中。

## 0.7.0（2026-06-02）

### 新功能

- 新增用于管理 AI 供应商的 `/provider` 命令，支持自定义 registry 导入，并引入标签页式模型选择器。该命令替代了已废弃的 `/connect`，请改用 `/provider`。
- 在终端界面中以独立样式渲染定时提醒，向 SDK 客户端暴露 cron 触发事件，并在报告 cron 触发时间时附带本地时区偏移。
- 新增 `KIMI_MODEL_ADAPTIVE_THINKING`（以及对应的 `adaptive_thinking` 模型别名字段），用于强制开启或关闭自适应 thinking（`thinking: { type: 'adaptive' }`），覆盖基于 Anthropic 模型名的版本推断。这样一来，背后由支持自适应能力的模型驱动、且使用自定义名称的兼容端点，即使模型名没有编码出可解析的 Claude 版本，也能选择启用该能力。

### 修复

- 清晰地报告被截断的压缩摘要，并在受支持的各供应商上应用有效的补全 token 额度。
- 修复 glob 模式的反斜杠转义，并在截断消息中包含匹配数量。

### 优化

- 明确 Kimi Platform API 密钥登录的标签和提示细节。
- 优化终端界面中的一处细微视觉交互。

## 0.6.0（2026-05-29）

### 新功能

- 新增 `KIMI_MODEL_*` 环境变量通道，让你无需编辑 `config.toml` 即可让 Kimi Code 使用指定模型（供应商类型、base URL、API 密钥、上下文大小、能力以及 thinking 设置）。
- 支持直接从 GitHub 仓库 URL 安装 plugin，并在 plugin 管理器中展示每次安装的来源和信任级别（kimi-official、curated、third-party）。

### 修复

- 在对话记录中显示后台 Agent 真实的最终状态，使丢失、失败和被终止的 Agent 不再显示为已完成；并在失败通知中包含用于恢复的 agent id 和恢复说明，让模型能够可靠地恢复。
- 在长对话中从供应商模型的 token 限制错误中恢复。
- 当模型响应流在传输中途被中断（`terminated` 错误）时自动重试，而不是让该轮次失败。
- 在各供应商的响应中一致地处理上下文溢出错误。
- 将失败的压缩重试按模型上下文窗口的固定一段进行退避。
- 修复原生自更新程序在安装命令实际失败时仍报告更新成功的问题。
- 将持久化的 hook 消息和被拦截的提示词消息投射到模型上下文中。
- 让被拦截的提示词 hook 的对话在后续的模型轮次中保持可用。
- 修复恢复不存在的会话时页脚泄漏到终端的问题。
- 修复当临时文件位于另一个文件系统上时 ripgrep 自动安装的问题。

### 优化

- 移除每轮 1000 步的默认上限。用户仍可在配置中设置 `max_steps_per_turn` 来强制使用自定义上限。
- 支持在 listSessions 中通过 sessionId 或 workDir 查询会话，并在从其他工作目录恢复会话时显示一条便捷的 cd 命令。
- 扩充页脚轮换提示，展示更多命令和快捷键，并更突出地呈现较新和重要的内容。
- 改进终端界面中的用量信息展示。
- 将 plugin 信任徽章限制为仅匹配 Kimi 托管的 plugin CDN URL 模式。
- 明确子 Agent 和后台任务的停止消息为用户主动发起。
- 将数据源 plugin 对齐到通用的双工具工作流。

### 重构

- 引入 `ModelProvider` 接口和 `SingleModelProvider`，将 `Agent` 与 `ProviderManager` 解耦。
- 将 `RuntimeConfig` 拆分为 `Kaos` 和 `ToolServices`，并相应更新所有引用。
- 精简 LLM 诊断日志，使用更少、更紧凑的字段。
- 将共享的工具服务类型定义迁移到工具支持层。

## 0.5.0（2026-05-28）

### 新功能

- 新增定时任务：
  你现在可以让 Agent 在指定时间提醒你、按重复的 cron 计划运行任务（例如每 5 分钟检查一次部署，或每个工作日上午 9 点生成一份日报），也可以让它在几分钟后自动回来继续之前的工作。
  定时任务使用标准的 5 字段 cron 语法。
- 新增 `/auto` 斜杠命令和 `--auto` CLI 参数，用于启用 auto 权限模式。
- 在 `Write` 和 `Edit` 的审批提示中显示文件内容与 diff，并通过 `Ctrl-E` 在专用的全屏查看器中打开。

### 修复

- 修复压缩流程在无可压缩消息时的边界情况处理，并改进重试逻辑。
- 修复官方数据源工具，保留完整的响应内容，并写入返回的结果文件。
- 修复迁移把旧版 `default_yolo` 键映射到已废弃的 `yolo` 字段、而非 `default_permission_mode` 的问题。

### 优化

- 在更新提示中新增可点击的变更记录链接。
- 用 `Ctrl-O` 展开 Bash 工具卡片时显示完整的 Bash 命令。卡片标题仍会将过长命令截断至 60 个字符，但展开后的视图现在会在输出上方显示完整的多行命令。
- 将写入终端窗口/标签页的会话标题从 80 个字符缩短到 32 个字符，避免较长的首条消息或粘贴内容把标签栏拉伸到难以阅读的宽度。
- 将嵌入式待办面板上限设为 5 行，并显示 `+N more` 指示器，避免较长的任务列表填满整个屏幕。
- 明确 plugin 管理器的键盘快捷键，并在原地显示 plugin 状态变化。
- 在 plugin 管理器的摘要中报告检测到的 plugin Skill。
- 将 `wire.jsonl` 中的大型 base64 媒体内容卸载到外部 blob 文件，减小 wire 体积，降低会话回放时的内存压力。同时为 `BlobStore` 增加内存级直读缓存，避免重复重建时产生多余的磁盘读取。
- 在 `AskUserQuestion` 对话框中对过长的问题、正文和选项文本进行换行显示，而不是用省略号截断。问题提示、正文描述、选项标签、选项描述以及提交标签页的复核条目现在会以悬挂缩进的方式分多行显示。

### 重构

- 重构终端界面的代码结构。

## 0.4.0（2026-05-27）

### 新功能

- 新增用户全局的 plugin 安装能力，包括交互式 plugin 管理、plugin 提供的 Skill，以及 plugin 自带的 MCP server。
- 在第二次粘贴时展开折叠的粘贴标记。
- 重做工具权限：cwd 之外的读取不再触发提示，会话级授权按完整调用精确匹配，基于路径的规则改为大小写不敏感。
- 新增 `/export-debug-zip` 斜杠命令，可直接在终端界面将当前会话导出为调试用 ZIP 归档。
- 新增 `/export-md` 斜杠命令，可将当前会话导出为 Markdown 文件。

### 修复

- 在启动时若 pull request 查询失败，避免终端界面崩溃。
- 修复在空 Thinking 增量产生孤立 Thinking 组件时，Thinking 旋转图标残留到轮次结束之后的问题。
- 派生会话后显示原始的会话恢复命令。
- 限制 plugin zip 安装：仅接受 manifest 位于归档根目录或单层包装目录的情况。
- 将带会话标签的日志条目独占地路由到会话 sink，不再同时写入全局 sink；并对所有携带 `agentId=main` 的会话日志行，统一省略主 Agent 中稳定不变的上下文键。

### 重构

- 重构终端界面中的会话恢复回放逻辑。
- 在常规轮次与压缩中，对瞬时 LLM 失败采用统一的重试分类。

### 其他

- 增强 `kimi export`，在 manifest 中记录更多诊断信息。

## 0.3.0（2026-05-26）

### 新功能

- `/logout` 现在会打开一个选择器，让你选择要登出的供应商，而不再总是登出当前模型所对应的供应商。当前供应商默认高亮，因此按 Enter 即可保持与此前一致的行为。该命令同时以 `/disconnect` 别名提供。
- `openai` 供应商现在开箱即用地支持 OpenAI 兼容的 reasoner 模型：自动识别响应中的 Thinking 字段（`reasoning_content` / `reasoning_details` / `reasoning`），并在历史包含 Thinking 时自动注入 `reasoning_effort`。DeepSeek、Qwen、One API 等网关服务无需再手工设置 `reasoning_key`，该字段仍可作为非标准网关的显式覆盖项。

### 修复

- 在流式输出或压缩上下文期间，阻止运行 `/model` 和 `/sessions` 斜杠命令。
- 在通过 `/connect` 配置 OpenAI 兼容模型时，保留模型目录中声明的 interleaved reasoning 字段。
- 修复 API 密钥输入对话框在空白状态下显示掩码点的问题。
- 修复 `~/.agents/` 下的用户 Skill 未被加载的问题。
- 恢复终端界面中运行中的子 Agent 的实时 token 显示。
- 在会话恢复时，若所有待办均已完成则隐藏待办面板。
- 在工具返回结果格式错误或缺失时，始终发出配对的工具结果，避免下一次请求因缺少 `tool_call_id` 而失败。
- 修复 Plan 模式下的会话重置：新会话在 Plan 评审被拒后不再失败，并能在初始化错误后继续接收事件。
- 在控制终端消失时及时退出。终端界面现在会处理 `SIGHUP` / `SIGTERM` 信号以及 stdout/stderr 的 `EIO` / `EPIPE` / `ENOTCONN` 错误，避免父 shell 或终端复用器异常退出后残留占用 CPU 核心的 `kimi` 进程。
- 避免本地补全上限过小，导致摘要生成前推理被截断。

### 重构

- 让 `AgentRecords` 直接持有 `Agent` 实例，并将恢复时的派发逻辑内联。

### 其他

- 改进 `Write` 工具的交互体验。

## 0.2.0（2026-05-26）

### 新功能

- 新增 `/connect` 命令，可从模型目录中配置供应商和模型。
- `/connect` 的供应商和模型选择器现支持键入即搜索过滤，长列表会自动分页；配置了较多模型时，`/model` 选择器同样支持分页。
- 在终端界面输入框中新增 `Ctrl-J` 作为插入换行的额外快捷键。
- 在会话回放过程中新增 wire 记录迁移处理。
- 在首次启动迁移期间，将用户 Skill 从 `~/.kimi/skills/` 迁移到 `~/.kimi-code/skills/`；已存在的目标 Skill 会被保留。
- 在 stream-json 输出格式中以结构化 meta 消息形式发出会话恢复提示。

### 修复

- 在 OAuth 设备信息中改为上报 macOS 产品版本，而不是 Darwin 内核版本。
- 将 `X-Msh-Platform` 请求头的取值修正为 `kimi_code_cli`。
- 在未配置模型时，澄清提示词模式下的错误提示，引导用户走登录流程。
- 在会话选择器中隐藏空的当前会话，同时保留其他空会话可见。
- 不再在迁移界面中提及 OAuth 凭据 —— 它们从不会被迁移，此前的 "needs /login" 提示会被误读为失败。仅使用 OAuth 的安装不再触发迁移界面。
- 在反馈、用量、登录和模型设置失败时，展示 API 返回的错误信息。
- 将终端界面中的模型选择持久化到默认配置，并在新会话中遵循已配置的默认 Thinking 状态。
- 在更新对话历史之前，对不包含摘要的压缩响应进行重试。
- 避免大体量流式工具参数导致的 CPU 峰值，并合并高频的流式 UI 更新。
- 在 wire 协议版本较新时改为继续恢复会话而不是失败。终端界面会显示一条警告，并在不进行迁移的情况下回放记录。
- 当 tmux 的扩展按键设置可能导致带修饰键的 Enter 快捷键无法工作时，向 tmux 用户发出提示。
- 默认让 Kimi 请求使用剩余的上下文窗口作为补全 token 的额度，同时将显式设置的环境变量上限作为硬上限保留。

### 重构

- 将工具调用数据扁平化，把工具名和参数内联到顶层，并限制旧版记录迁移仅重写匹配的工具调用数据。
- 将 wire 元数据处理移动到记录层，并将持久化后端的职责限制在存储操作上。

### 其他

- 当未配置模型时，`/model` 和欢迎面板现在会引导用户使用 `/login`（针对 Kimi）和 `/connect`（针对其他供应商）。
