From a4d7a4ff2a63c1d31542b6fb3ddb093a0fc4b223 Mon Sep 17 00:00:00 2001
From: liruifengv <liruifeng1024@gmail.com>
Date: Thu, 2 Jul 2026 11:34:17 +0800
Subject: [PATCH] docs(changelog): sync 0.22.0 from apps/kimi-code/CHANGELOG.md
 (#1288)

---
 docs/en/release-notes/changelog.md | 35 ++++++++++++++++++++++++++++++
 docs/zh/release-notes/changelog.md | 35 ++++++++++++++++++++++++++++++
 2 files changed, 70 insertions(+)

diff --git a/docs/en/release-notes/changelog.md b/docs/en/release-notes/changelog.md
index c0d2becd4..ba4409369 100644
--- a/docs/en/release-notes/changelog.md
+++ b/docs/en/release-notes/changelog.md
@@ -6,6 +6,41 @@ outline: 2
 
 This page documents the changes in each Kimi Code CLI release.
 
+## 0.22.0 (2026-07-02)
+
+### Features
+
+- Automatically compress oversized images before they reach the model, downsampling and re-encoding them to cut vision-token cost and avoid provider image-size errors.
+- Add model alias overrides, letting you set model metadata under `[models."<alias>".overrides]` to override provider catalog refresh results.
+
+### Bug Fixes
+
+- Fix plan, swarm, and goal modes being shared across sessions in the web UI; each session now keeps its own toggles.
+- Fix the transcript jumping to the top when scrolling up through history during streaming output.
+- Release pasted images and streaming timers once they are no longer shown, so memory stops growing in long sessions.
+- Fix the terminal being left in raw mode with a hidden cursor and disabled flow control after a crash or abrupt exit.
+- Fix an active workspace showing only its five most recent sessions on load, so it now keeps loading older sessions from the last 12 hours.
+- Fix the Thinking-by-default setting not taking effect, so new sessions correctly start with thinking enabled.
+- Fix spurious errors from the web question, approval, and task actions when the action was already complete, and add loading feedback so each click is acknowledged immediately.
+- Show draft pull requests with a distinct draft status instead of displaying them as open.
+- Hide the conversation outline when there is not enough room to expand its labels, so it no longer clips against the window edge.
+- Hide the unsupported Off option in the /model thinking switcher for always-on models that already expose multiple effort levels.
+
+### Polish
+
+- Refresh the web UI with a new design system, including updated colors, typography, spacing, light and dark palettes, restyled tooltips, and subtle enter/exit and expand/collapse animations.
+- Group consecutive tool calls into a collapsible stack with per-tool renderers, including diff line-count chips for edits and inline previews for image, video, and audio results.
+- Improve session search with a Cmd/Ctrl+K palette that filters by title, workspace, and last prompt with highlighted matches. Press Cmd+K or Ctrl+K to open it.
+- Show queued prompts inline below the running turn in the web chat, and split Stop into its own button so Send no longer interrupts.
+- Show the conversation outline as one entry per user query that expands into a labeled list on hover.
+- Replace the Explore and Native theme options with a single chat layout and a Blue or Black accent-color setting.
+- Add workspace sorting by manual order or last-edited time, plus collapse-all and expand-all controls, to the sidebar.
+- Show time, duration, connection, and stack details in web error and warning toasts.
+- Use one consistent modal dialog for confirmations in the web UI (archive session, delete workspace, delete provider, undo message, and mode toggles).
+- Reduce the default TUI transcript window to keep long sessions responsive.
+- Reduce the web composer's default height for a more compact empty state, and fix ArrowUp recalling the previous message while editing a multi-line draft; ArrowUp now recalls only from the very start of the text and is disabled in the expanded editor.
+- Remove the fade-out animation when undoing a message in the web chat.
+
 ## 0.21.1 (2026-07-01)
 
 ### Bug Fixes
diff --git a/docs/zh/release-notes/changelog.md b/docs/zh/release-notes/changelog.md
index 41b206821..317b219ef 100644
--- a/docs/zh/release-notes/changelog.md
+++ b/docs/zh/release-notes/changelog.md
@@ -6,6 +6,41 @@ outline: 2
 
 本页记录 Kimi Code CLI 每个版本的变更内容。
 
+## 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）
 
 ### 修复