chore(release): prepare v0.2.1

apps/desktop/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pace/desktop",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "private": true,
   "license": "Apache-2.0",
   "description": "The GUI for the Pi coding agent.",

apps/desktop/src/entities/release/changelog.ts

@@ -14,6 +14,25 @@ export type ChangelogRelease = {
 
 // Ship release notes with the app so the history is also available offline.
 export const changelogReleases: readonly ChangelogRelease[] = [
+  {
+    version: "0.2.1",
+    date: "2026-10-07",
+    title: "Sending a prompt no longer crashes the window",
+    summary: "This release fixes a crash in 0.2.0 where sending a prompt could replace the whole window with “Something went wrong”, and keeps the model picker's flyout from staying open.",
+    url: "https://github.com/BubblePtr/pace/releases/tag/v0.2.1",
+    changes: [
+      {
+        kind: "fixed",
+        title: "No crash while a reply streams",
+        description: "Sending a prompt, or typing while a reply was streaming, could replace the window with “Something went wrong” (React error #185) under Pi 1.0's denser event stream. The open Session is now marked read as its results arrive instead of after each render, and chat step labels and text no longer update themselves on every event.",
+      },
+      {
+        kind: "fixed",
+        title: "Model picker flyout closes",
+        description: "Moving the pointer from a model row to Add Models no longer leaves the previous row highlighted with its options flyout open.",
+      },
+    ],
+  },
   {
     version: "0.2.0",
     date: "2026-10-07",

docs/changelog.md

@@ -4,7 +4,7 @@ Settings Dialog 的 Changelog 分类展示正式发布的用户可感知变化
 
 ## 内容来源
 
-唯一数据源是 `apps/desktop/src/entities/release/changelog.ts` 的 `changelogReleases`。内容随应用打包，因此断网也能阅读；不会在打开设置时请求 GitHub。当前构建收录 v0.0.1 至 v0.2.0，最新条目随 v0.2.0 发布。v0.2.0 的中文说明见 [发布说明](release/0.2.0.md)，涵盖内置 Pi 1.0.4（更省 token 的 codemode 与图片生成）、Azure provider 改名为 `azure` 及 Foundry 聊天模型、MCP 按服务器分别登录、codemode 暴露方式合并，以及安装版 OAuth token 过期后无法刷新的修复。v0.1.0 的中文说明见 [发布说明](release/0.1.0.md)，涵盖 MCP 设置、内置 Pi 0.99.1 与 codemode／tool_search／MCP、嵌套工具调用、Linux x64 安装包、每次编辑的行数、聊天文件链接，以及 squircle 圆角和动态图标调整；也是首个按语义化版本选号的版本。v0.0.16 的中文说明见 [发布说明](release/0.0.16.md)，涵盖技能与提示模板标签、工作区文件引用、worktree 基础分支选择、诊断信息复制，以及菜单排版、项目错误、provider 检查和会话恢复修复。v0.0.15 的中文说明见 [发布说明](release/0.0.15.md)，涵盖内置 Pi 0.87.1、按账号过滤可用模型、provider 连接检查、设置页刷新模型目录、按 provider 全选及模型选择器与设置页对齐。v0.0.14 的中文说明见 [发布说明](release/0.0.14.md)，涵盖内置 Pi 0.86.0、会话内上下文变更通知、About 页 Pi 版本、首页 Pi 品牌色、Draft→Live 单一 composer 及 Finder 启动下的包管理修复。v0.0.13 的中文说明见 [发布说明](release/0.0.13.md)，涵盖设置页列出全部 Pi provider、Radius 登录及 provider 卡片品牌标与过滤。v0.0.12 的中文说明见 [发布说明](release/0.0.12.md)，涵盖排队消息拖拽重排与 steer、会话自动命名、Browser 空白启动及中断 run 结清修复。v0.0.11 的中文说明见 [发布说明](release/0.0.11.md)，涵盖 Usage 成本驾驶舱、内置 Pi 0.85.1 及会话创建时的模型选择修复。v0.0.10 的中文说明见 [发布说明](release/0.0.10.md)，涵盖 Trajectory 子会话深链、子代理停止控制及 Dock 提示位置修复。v0.0.9 的中文说明见 [发布说明](release/0.0.9.md)，涵盖历史会话即时回放、根会话进程隔离及后台扩展免系统 Node。v0.0.8 的中文说明见 [发布说明](release/0.0.8.md)，涵盖工具图标恢复静态、失败工具单行摘要及输入框层级修复。v0.0.7 的中文说明见 [发布说明](release/0.0.7.md)，涵盖 Shell 动画图标、双栏 Header 对齐、Live Chat 抢占修复及系统 Node 支持后台扩展。v0.0.6 的中文说明见 [发布说明](release/0.0.6.md)，涵盖会话列表按最近提交排序、列表头部简化及投影状态和标题宽度修复。v0.0.5 涵盖聊天文件链接、工作区自动刷新、会话恢复提示及界面和日志修复。v0.0.4 根据 [正式发布记录](https://github.com/BubblePtr/pace/releases/tag/v0.0.4) 和 [v0.0.3 至 v0.0.4 的实际改动](https://github.com/BubblePtr/pace/compare/v0.0.3...v0.0.4) 整理，UTC 发布日期为 2026-09-10，涵盖 Packages 市场、资源管理及 Changes／Files 面板改进。
+唯一数据源是 `apps/desktop/src/entities/release/changelog.ts` 的 `changelogReleases`。内容随应用打包，因此断网也能阅读；不会在打开设置时请求 GitHub。当前构建收录 v0.0.1 至 v0.2.1，最新条目随 v0.2.1 发布。v0.2.1 的中文说明见 [发布说明](release/0.2.1.md)，修复 0.2.0 发消息后窗口崩溃（React error #185）和模型选择器飞出层不关闭。v0.2.0 的中文说明见 [发布说明](release/0.2.0.md)，涵盖内置 Pi 1.0.4（更省 token 的 codemode 与图片生成）、Azure provider 改名为 `azure` 及 Foundry 聊天模型、MCP 按服务器分别登录、codemode 暴露方式合并，以及安装版 OAuth token 过期后无法刷新的修复。v0.1.0 的中文说明见 [发布说明](release/0.1.0.md)，涵盖 MCP 设置、内置 Pi 0.99.1 与 codemode／tool_search／MCP、嵌套工具调用、Linux x64 安装包、每次编辑的行数、聊天文件链接，以及 squircle 圆角和动态图标调整；也是首个按语义化版本选号的版本。v0.0.16 的中文说明见 [发布说明](release/0.0.16.md)，涵盖技能与提示模板标签、工作区文件引用、worktree 基础分支选择、诊断信息复制，以及菜单排版、项目错误、provider 检查和会话恢复修复。v0.0.15 的中文说明见 [发布说明](release/0.0.15.md)，涵盖内置 Pi 0.87.1、按账号过滤可用模型、provider 连接检查、设置页刷新模型目录、按 provider 全选及模型选择器与设置页对齐。v0.0.14 的中文说明见 [发布说明](release/0.0.14.md)，涵盖内置 Pi 0.86.0、会话内上下文变更通知、About 页 Pi 版本、首页 Pi 品牌色、Draft→Live 单一 composer 及 Finder 启动下的包管理修复。v0.0.13 的中文说明见 [发布说明](release/0.0.13.md)，涵盖设置页列出全部 Pi provider、Radius 登录及 provider 卡片品牌标与过滤。v0.0.12 的中文说明见 [发布说明](release/0.0.12.md)，涵盖排队消息拖拽重排与 steer、会话自动命名、Browser 空白启动及中断 run 结清修复。v0.0.11 的中文说明见 [发布说明](release/0.0.11.md)，涵盖 Usage 成本驾驶舱、内置 Pi 0.85.1 及会话创建时的模型选择修复。v0.0.10 的中文说明见 [发布说明](release/0.0.10.md)，涵盖 Trajectory 子会话深链、子代理停止控制及 Dock 提示位置修复。v0.0.9 的中文说明见 [发布说明](release/0.0.9.md)，涵盖历史会话即时回放、根会话进程隔离及后台扩展免系统 Node。v0.0.8 的中文说明见 [发布说明](release/0.0.8.md)，涵盖工具图标恢复静态、失败工具单行摘要及输入框层级修复。v0.0.7 的中文说明见 [发布说明](release/0.0.7.md)，涵盖 Shell 动画图标、双栏 Header 对齐、Live Chat 抢占修复及系统 Node 支持后台扩展。v0.0.6 的中文说明见 [发布说明](release/0.0.6.md)，涵盖会话列表按最近提交排序、列表头部简化及投影状态和标题宽度修复。v0.0.5 涵盖聊天文件链接、工作区自动刷新、会话恢复提示及界面和日志修复。v0.0.4 根据 [正式发布记录](https://github.com/BubblePtr/pace/releases/tag/v0.0.4) 和 [v0.0.3 至 v0.0.4 的实际改动](https://github.com/BubblePtr/pace/compare/v0.0.3...v0.0.4) 整理，UTC 发布日期为 2026-09-10，涵盖 Packages 市场、资源管理及 Changes／Files 面板改进。
 
 页面文案沿用应用现有的英文界面。仅展示已发布功能，不把主干上的未发布变更或开发计划计入历史版本。每个版本附原始 GitHub Release 链接；桌面端通过已有 `browser_open_external` 通道打开系统浏览器，失败时在链接下提示重试。
 

docs/release/0.2.1.md

@@ -0,0 +1,23 @@
+# Pace 0.2.1
+
+发布日期：2026-10-07
+
+这是 0.2.0 的修复版本，只包含修复，按 [版本号规则](macos.md#怎么选版本号) 提升 patch。
+
+## 修复
+
+- 发消息后窗口崩溃：0.2.0 在首页发消息，或在回复流式输出时打字，整个窗口可能变成 “Something went wrong”（React error #185，更新深度超限）。原因是 Pi 1.0 的事件流更密，而渲染层每收到一条事件都会额外触发更新：正在查看的会话在渲染后再回写“已读”，步骤标签和文本组件也会在每次渲染时重复更新状态，React 连续嵌套更新的计数因此超过上限。现在正在查看的会话在事件到达时就直接记为已读，这些组件也不再每次渲染都更新状态，每条事件只提交一次。内置的 Astryx `Text` / `Heading` 通过补丁修正了同类问题（上游已在 0.6.x 修复）。
+- 模型选择器飞出层不关闭：指针从某一行移到底部的 **Add Models** 时，上一行不再保持高亮，选项飞出层会正常收起（[#442](https://github.com/BubblePtr/pace/issues/442)）。
+
+## 已知限制
+
+- 在聊天里输入 `/mcp login` 仍无法登录，请改用 Settings → MCP 的 **Sign in**。
+- 会话启动时的 MCP 连接问题暂不会在会话内提示，需到 Settings → MCP 查看（[#416](https://github.com/BubblePtr/pace/issues/416)）。
+
+## 安装与升级
+
+- macOS：支持 Apple Silicon Mac，要求 macOS 12 或更高版本。首次安装请下载 `Pace-0.2.1-arm64.dmg`。
+- Linux：支持 x64。推荐下载 `Pace-0.2.1-x64.AppImage`，加上可执行权限后运行；Debian / Ubuntu 也可以安装 `Pace-0.2.1-x64.deb`。详见 [Linux 打包与发布](linux.md)。
+- 已安装用户（macOS 与 Linux AppImage）可在 Settings → About & Updates 点击 **Check for updates**；下载完成后点击 **Restart to update**。如果 0.2.0 一发消息就崩溃，可以先在 Settings 里检查更新，不需要发消息。
+
+[完整变更](https://github.com/BubblePtr/pace/compare/v0.2.0...v0.2.1)

package.json

@@ -2,7 +2,7 @@
   "name": "pace",
   "private": true,
   "license": "Apache-2.0",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "type": "module",
   "workspaces": [
     "apps/*",