From 0bcbf167fee52e486eddbbea40b4a93547aaf311 Mon Sep 17 00:00:00 2001
From: liruifengv <liruifeng1024@gmail.com>
Date: Tue, 26 May 2026 15:27:13 +0800
Subject: [PATCH] docs(changelog): sync 0.2.0 from apps/kimi-code/CHANGELOG.md
 (#61)

---
 docs/en/release-notes/changelog.md | 39 +++++++++++++++++++++++++++---
 docs/zh/release-notes/changelog.md | 39 +++++++++++++++++++++++++++---
 2 files changed, 72 insertions(+), 6 deletions(-)

diff --git a/docs/en/release-notes/changelog.md b/docs/en/release-notes/changelog.md
index f1b68dbe0..acd6387dd 100644
--- a/docs/en/release-notes/changelog.md
+++ b/docs/en/release-notes/changelog.md
@@ -1,5 +1,38 @@
 # Changelog
 
-::: info Note
-Detailed release notes will be published alongside the first official release.
-:::
+This page documents the changes in each Kimi Code CLI release.
+
+## 0.2.0
+
+### Features
+
+- Add a `/connect` command that configures a provider and model from a model catalog.
+- The `/connect` provider and model pickers now support type-to-search filtering, and long lists are paginated. The `/model` picker is also paginated when many models are configured.
+- Add `Ctrl-J` as an additional shortcut for inserting new lines in the TUI prompt.
+- Add wire record migration handling during session replay.
+- Migrate user skills from `~/.kimi/skills/` to `~/.kimi-code/skills/` during the first-launch migration; existing target skills are kept.
+- Emit session resume hint as a structured meta message in stream-json output format.
+
+### Bug Fixes
+
+- Report the macOS product version in OAuth device information instead of the Darwin kernel version.
+- Correct the `X-Msh-Platform` header value to `kimi_code_cli`.
+- Clarify the prompt-mode error when no model is configured by pointing users to the login flow.
+- Hide the empty current session from the sessions picker while keeping other empty sessions visible.
+- Stop mentioning OAuth credentials in the migration UI — they are never migrated, so the previous "needs /login" notice misread as a failure. OAuth-only installs no longer trigger the migration screen.
+- Surface API-provided error messages during feedback, usage, login, and model setup failures.
+- Persist model selections from the terminal UI to the default configuration, and honor the configured default thinking state for new sessions.
+- Retry compaction responses that do not contain a summary before updating conversation history.
+- Avoid CPU spikes from large streamed tool arguments and coalesce high-frequency streaming UI updates.
+- Resume sessions with a newer wire protocol version instead of failing. A warning is now shown in the TUI and records are replayed without migration.
+- Warn tmux users when extended key settings may prevent modified Enter shortcuts from working.
+- Let Kimi requests use the remaining context window for completion tokens by default while keeping explicit environment limits as hard caps.
+
+### Refactors
+
+- Flatten tool call data by inlining tool names and arguments at the top level, and limit legacy record migration so it only rewrites matching tool call payloads.
+- Move wire metadata handling into the record layer and keep persistence backends limited to storage operations.
+
+### Other
+
+- When no models are configured, `/model` and the welcome panel now point users to `/login` (for Kimi) and `/connect` (for other providers).
diff --git a/docs/zh/release-notes/changelog.md b/docs/zh/release-notes/changelog.md
index d169d59f4..6a014c5e1 100644
--- a/docs/zh/release-notes/changelog.md
+++ b/docs/zh/release-notes/changelog.md
@@ -1,5 +1,38 @@
 # 变更记录
 
-::: info 说明
-本页将随首个正式版本同步发布详细变更记录。
-:::
+本页记录 Kimi Code CLI 每个版本的变更内容。
+
+## 0.2.0
+
+### 新功能
+
+- 新增 `/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`（针对其他供应商）。