Pi Desktop v1.4.4

📥 下载地址 (Download)

🪟 Windows (不支持 Win7)

• 标准安装版（推荐，支持在线自动更新）：Windows 64位安装包 (.exe)

Tip

Windows v1.4.3 用户升级说明：
由于 v1.4.3 初版热更新机制受 Windows 权限限制，请下载上方本次发布的安装包（.exe）覆盖安装一次。本次安装包已切换为免提权的用户目录安装，从当前版本（v1.4.4）起，后续所有更新均全面支持应用内一键秒级热更新，无需再手动下载安装包！

🍏 macOS (macOS 11.0+)

• Apple M芯片（M1 / M2 / M3 / M4 系列）：Apple M芯片 DMG 安装镜像
• Intel芯片（老款 Intel 处理器 Mac）：Intel芯片 DMG 安装镜像

Tip

macOS 首次打开若提示“已损坏，无法打开”：
由于开源预览版未接入 Apple 开发者证书签名公证，首次拖入「应用程序」后若被系统 Gatekeeper 拦截，请打开系统终端（Terminal）执行以下命令解除隔离：

sudo xattr -rd com.apple.quarantine "/Applications/Pi Desktop.app"

---

跨平台增量热更新在线闭环、子进程静默运行、安装权限优化与更新弹窗布局重构

本版本基于 v1.4.3，核心引入双端在线增量热更新（Hot Update）体验闭环与鲁棒性加固、子进程静默无弹窗运行、安装包权限与结构优化、更新弹窗布局重构与 Release Notes 智能清洗。从本版本开始，用户无需频繁下载几十兆的完整安装包，检测到新版本后应用内即可一键秒级下载极小的增量补丁（~3.9MB）并自动平滑重启生效！

核心特性与改进

• 跨平台在线增量热更新（Hot Update）闭环与加固：
  • 增量补丁自适应识别与操作：更新就绪后自动检测 .patch.zip 补丁类型，动态展示补丁专属文案与『重启并应用更新』操作，支持一键秒级更新；
  • Windows 终端静默调用层：在 Windows 11 下通过 WScript.Shell 隐式调用批处理，彻底阻断系统默认终端（Windows Terminal）的黑框弹窗拦截；
  • 子进程控制台黑框消除：为 Git 及各类执行命令子进程注入 windowsHide 与 CREATE_NO_WINDOW 标志，杜绝任何闪烁与黑框干扰；
  • 批处理稳定性重构：采用稳健的 ping 延时机制与平铺式批处理结构，精准等待旧进程 PID 完全释放后再覆盖核心资源，杜绝语法解析异常；
  • 安装路径权限优化：NSIS 安装器默认切换为当前用户目录安装（perMachine: false），免除写入 Program Files 的管理员提权限制；并增加 UAC 写入权限检测与补丁调试日志兜底；
  • 重启生命周期保护：主进程在退出中状态下忽略二次唤起请求，避免进程更新替换时的单例锁竞争。
• 更新交互弹窗重构与 Release Notes 智能清洗：
  • 更新弹窗排版与防折行：弹窗宽度拓宽至 560px，底部操作栏采用左右分流结构（『跳过此版本』靠左，其余靠右），强制单行不折行；
  • 文件资产卡片化：替换生硬的文件名输入框，升级为具备专属图标与『增量补丁』高亮徽标的资产展示卡片；
  • Release Notes 智能清洗：自动剥离 GitHub 网页专用的下载专区与安装包列表，弹窗内直观呈现纯粹的版本新特性与变更日志；
  • 版本欢迎弹窗体验优化：大幅提升版本升级成功后的欢迎说明弹窗滚动视口高度并引入沉浸式卡片容器，清晰直观。
• 开发与离线测试支持：
  • 新增本地 Mock 更新测试服务脚本，支持在开发阶段离线走查全流程在线更新与版本跨越提醒。

验证情况

• TypeScript 严格类型检查 100% 通过（pnpm typecheck）。
• 全量单元测试 100% 通过（98 个测试套件，768 项单元测试全部通过）。
• SDK 契约测试 100% 通过（pnpm test:contract）。
• 中英文字典 key 100% 对齐（i18n-parity.test.ts 通过）。
• Windows 11 & macOS 增量热更新全流程实机验证通过。

安装与升级提示

Pi Desktop 需要 Node.js 22.19.0 或更新版本，并要求通过 npm 全局安装兼容版本的 pi：

npm i -g @earendil-works/pi-coding-agent

• 全新安装：根据操作系统与芯片类型下载上方 DMG 或 EXE 安装包；
• 后续更新：从 v1.4.4 开始，检测到新版本时将在应用内自动优先下载极小增量补丁包，一键秒级更新重启生效！

本软件可免费用于个人和非商业用途；商业使用需事先获得书面授权，详见 LICENSE。

Full Changelog: v1.4.3...v1.4.4

Pi Desktop v1.4.3

📥 下载地址 (Download)

🪟 Windows (不支持 Win7)

• 标准安装版（推荐，支持在线自动更新）：Windows 64位安装包 (.exe)

🍏 macOS (macOS 11.0+)

• Apple M芯片（M1 / M2 / M3 / M4 系列）：Apple M芯片 DMG 安装镜像
• Intel芯片（老款 Intel 处理器 Mac）：Intel芯片 DMG 安装镜像

Tip

macOS 首次打开若提示“已损坏，无法打开”：
由于开源预览版未接入 Apple 开发者证书签名公证，首次拖入「应用程序」后若被系统 Gatekeeper 拦截，请打开系统终端（Terminal）执行以下命令解除隔离：

sudo xattr -rd com.apple.quarantine "/Applications/Pi Desktop.app"

---

Companion 伴侣扩展生态、沉浸式 Extension UI 停靠弹窗、计划模式协同与导航定位增强

本版本基于 v1.4.2，核心引入内置伴侣扩展机制（Companion Extensions）与沉浸式交互 UI 弹窗（Docked Extension UI），提供免 npm 依赖的 ask-question 伴侣扩展一键启用体验，并在对话提问时提供智能交互引导；升级 ctx.ui 交互弹窗为输入框吸附停靠卡片，支持 1-9 数字键极速应答；深度完善计划模式（Plan Mode）生态联动与退出清理；优化消息导航轨动态跟踪贴底定位；修复代理环境下开发启动白屏问题并全面更新产品巡览图文。

核心特性与改进

• 内置伴侣扩展机制与智能交互引导（Companion Extensions）：
  • 免依赖内置扩展：打包自带 ask-question.ts 伴侣扩展（通过 Electron 资源目录分发），支持在「扩展」页面一键安装至 ~/.pi/agent/extensions/，免除手动 npm 依赖安装；
  • 智能提问检测与交互提示：当助手输出包含编号列表的提问时，聊天区域自动展示智能选择提示条，引导一键开启伴侣扩展或跳转管理；
  • RPC 模式绑定：扩展绑定时声明 rpc 模式，确保扩展能够识别桌面 UI 环境并调起原生交互组件。
• 沉浸式交互 UI 对话框（Docked Extension UI）：
  • 吸附停靠不挡视线：将原居中模态遮罩改为吸附在输入框上方的自适应悬浮卡片，彻底避免遮挡聊天历史与上下文；
  • 键盘极速操作：支持 1-9 数字键键盘快捷选择，自动清洗选项多余序号前缀，提供丝滑的操作反馈与响应式布局。
• 计划模式（Plan Mode）生态与生命周期协同：
  • 依赖按需检测：开启计划模式时自动检测社区扩展（@narumitw/pi-plan-mode），未安装时弹窗引导一键安装，避免静默失效；
  • 生命周期同步退出：关闭输入框 Plan 开关或输入 /plan exit 时，自动向运行时派发退出指令，即时清理 Plan 部件与状态；
  • 指令分发优化：支持 /plan <prompt> 直接带参数派发，修复编辑历史 /plan 消息时输入框被意外清空的问题，防止重复添加模式前缀。
• 对话导航与开发体验优化：
  • 消息导航轨贴底与动态追踪：末尾锚点点击自动平滑滚动至会话最底部，完整展现长回复；普通跳转支持逐帧动态跟踪懒加载高度膨胀并平稳回正；
  • 开发服务白屏修复：明确绑定 127.0.0.1 并为 Chromium 注入代理绕过参数，解决 macOS 及系统代理环境下因 localhost 无法连接导致的启动白屏；
  • 全套产品巡览与图文更新：README 补充消息导航轨、历史轮次折叠与耗时统计、会话分支树（Fork Tree）等特性介绍，并全面刷新截图资产。

验证情况

• TypeScript 严格类型检查 100% 通过（pnpm typecheck）。
• 全量单元测试 100% 通过（96 个测试套件，760 项单元测试全部通过）。
• SDK 契约测试 100% 通过（pnpm test:contract）。
• 中英文字典 key 100% 对齐（i18n-parity.test.ts 通过）。

安装与升级提示

Pi Desktop 需要 Node.js 22.19.0 或更新版本，并要求通过 npm 全局安装兼容版本的 pi：

npm i -g @earendil-works/pi-coding-agent

• 全新安装：根据操作系统与芯片类型下载上方 DMG 或 EXE 安装包；
• 后续更新：检测到新版本时将在应用内自动优先下载极小增量补丁包，一键秒级更新重启生效！

本软件可免费用于个人和非商业用途；商业使用需事先获得书面授权，详见 LICENSE。

Full Changelog: v1.4.2...v1.4.3

Pi Desktop v1.4.2

📥 下载地址 (Download)

🪟 Windows (不支持 Win7)

• 标准安装版（推荐，支持在线自动更新）：Windows 64位安装包 (.exe)

🍏 macOS (macOS 11.0+)

• Apple M芯片（M1 / M2 / M3 / M4 系列）：Apple M芯片 DMG 安装镜像
• Intel芯片（老款 Intel 处理器 Mac）：Intel芯片 DMG 安装镜像

Tip

macOS 首次打开若提示“已损坏，无法打开”：
由于开源预览版未接入 Apple 开发者证书签名公证，首次拖入「应用程序」后若被系统 Gatekeeper 拦截，请打开系统终端（Terminal）执行以下命令解除隔离：

sudo xattr -rd com.apple.quarantine "/Applications/Pi Desktop.app"

---

轻量级 3.9MB 增量补丁秒级热更新、Asar 依赖体积剪枝与双语文档优化

本版本基于 v1.4.1，核心实现轻量级 Asar 增量补丁秒级自动更新（Lightweight Asar Patch Auto-Update），将日常版本迭代下载体积由全量 ~176MB 大幅骤减至 ~3.9MB，实现客户端秒级下载与丝滑原地重启；并完成双语 README 结构优化与 macOS 首次启动隔离放行引导。

核心特性与改进

• 轻量级 Asar 增量补丁秒级热更新（Lightweight Patch Auto-Update）：
  • 依赖深度剪枝：将前端纯渲染依赖移至 devDependencies（已由 Vite 编译内联），消除打包时冗余的 299MB node_modules，app.asar 体积由 253MB 直降至 17MB（缩减 93%）；
  • 3.9MB 极小补丁：CI 发布流程自动打包提取纯代码与主进程资产生成 Pi.Desktop-${version}-patch.zip，压缩后仅 3.92MB（相比 176MB 全量包缩小约 45 倍）；
  • 客户端智能首选：客户端更新检查默认优先匹配 *-patch.zip 增量补丁，下载后自动解压验证内含 patch-metadata.json 的 SHA-256 完整性；
  • macOS 本地重签名：原地替换 Resources/app.asar 后自动执行 Ad-hoc 代码重签名（codesign --force --deep --sign -），确保替换后系统安全机制（Gatekeeper / AMFI）正常放行并自动重启；
  • Windows 句柄等待替换：通过独立的后台批处理重试脚本等待旧进程完全释放句柄后静默替换并拉起新版；
  • 可靠全量兜底：若增量补丁解压失败或暂存异常，平滑回退至全量安装包流程，确保更新体验 100% 可靠。
• 文档与发版体验优化：
  • 默认 README.md 调整为中文主导，英文版本归档至 README.en.md；
  • 补充 macOS Gatekeeper 隔离放行一键执行命令，降低新用户首次打开门槛。

验证情况

• TypeScript 严格类型检查 100% 通过（pnpm typecheck）。
• 全量单元测试 100% 通过（91 个测试套件，740 项单元测试全部通过，含补丁选择与全量回退用例）。
• Playwright Electron 端到端全量测试通过（包含检查更新 -> 下载 3.9MB 补丁 -> 自动解压校验 -> 暂存配置落盘 -> 重启安装对话框全流程）。
• 打包应用 Smoke 测试通过（1.9s 快速启动并成功连接 SDK）。

安装与升级提示

Pi Desktop 需要 Node.js 22.19.0 或更新版本，并要求通过 npm 全局安装兼容版本的 pi：

npm i -g @earendil-works/pi-coding-agent

• 全新安装：根据操作系统与芯片类型下载上方 DMG 或 EXE 安装包；
• 后续更新：从本版本起，后续新版本检测到更新时将在应用内自动优先下载 ~3.9MB 极小增量补丁包，一键秒级更新重启生效！

本软件可免费用于个人和非商业用途；商业使用需事先获得书面授权，详见 LICENSE。

Full Changelog: v1.4.1...v1.4.2

Pi Desktop v1.4.1

📥 下载地址 (Download)

🪟 Windows (不支持 Win7)

• 标准安装版（推荐，支持在线自动静默更新）：Windows 64位安装包 (.exe)

🍏 macOS (macOS 11.0+)

• Apple M芯片（M1 / M2 / M3 / M4 系列）：Apple M芯片 DMG 安装镜像
• Intel芯片（老款 Intel 处理器 Mac）：Intel芯片 DMG 安装镜像

---

应用内原地自动无感更新、版本跳跃更新日志、双平台架构精简与多轮长会话贴底优化

本版本基于 v1.4.0，引入桌面应用原地静默无感自动更新与版本跳跃变更日志弹窗，全面精简构建架构并专注于 macOS 与 Windows 双平台体验，优化长会话连续提问滚动贴底与历史折叠稳定性，并修复开发模式系统通知图标冲突。

核心特性与改进

• 应用内原地自动无感更新与自动重启（In-Place Auto-Update）：
  • macOS 端更新包下载完成后支持原子解压替换自身并自动拉起，自动清除 macOS Gatekeeper quarantine 隔离属性，无需每次版本升级都手动重新下载并拖入应用程序目录；
  • Windows 端支持静默安装与无感重启；
  • 安装引导对话框内嵌完整可滚动的 Markdown 变更日志展示；
  • 设置页新增「跳过此版本」管理与自动下载更新开关；下载遭遇网络波动时自动指数退避重试并伴有实时 Toast 状态提醒。
• 版本跳跃说明弹窗（Version Jump / What's New）：
  • 应用更新后首次启动自动弹出「新版更新日志」浮层，清晰展示当前版本的核心特性，点击关闭后自动记为已读不再打扰。
• 架构收敛：专注 macOS 与 Windows 双平台（Streamlined Architecture）：
  • 彻底清理维护成本较高的 Linux 构建、打包与运行分支，精简 CI/CD 工作流与单测/E2E 运行矩阵；
  • Windows 构建产物移除便携版（Portable），统一收敛为单一标准的 NSIS 安装包，确保安装与原地更新行为完全一致。
• 连续提问滚动贴底防跳顶与长会话折叠优化（Chat Stick-to-Bottom）：
  • 用户提交新 Prompt 瞬间立即锁定底部并重置滚动位置，彻底解决连续快速提问时由于布局测量与高度抖动引发的向上跳顶现象；
  • 引入 isTurnCompleted 精准判定历史轮次完成态，防止长会话流式启动瞬间上一轮因消息事件循环微小间隙发生意外解折叠，保证列表高度绝对平稳。
• 本地开发模式专属 Bundle ID 与通知图标修复（macOS Dev Bundle）：
  • 为本地开发生成的 .dev/Electron.app 注入专属 CFBundleIdentifier: io.github.zth0828.pidesktop.dev 并向 LaunchServices 注册，彻底解决本地开发态系统通知回退显示本机微信开发者工具等其他 Electron 应用图标的 Bug。
• 文档与发版导航完善：
  • README 补充 macOS Gatekeeper、Windows SmartScreen 排错与隐私说明；
  • 发布说明头部提供结构化、可直达的双平台安装包下载链接。

验证情况

• TypeScript 严格类型检查 100% 通过（pnpm typecheck）。
• 全量单元测试 100% 通过（91 个测试套件，738 项单元测试全部通过）。
• Playwright Electron 端到端全量测试 100% 通过（237 个 E2E 用例全部通过，6 个平台条件性跳过）。
• 中英文字典 key 100% 对齐（i18n-parity.test.ts 通过）。

安装与升级提示

Pi Desktop 需要 Node.js 22.19.0 或更新版本，并要求通过 npm 全局安装兼容版本的 pi：

npm i -g @earendil-works/pi-coding-agent

• macOS：打开 DMG 后将 Pi Desktop 拖入「应用程序」文件夹即可。本版本已内置原地自动无感更新，后续新版本可在应用内一键静默自动升级。
• Windows：运行 Setup 安装包完成安装，Windows SmartScreen 如提示安全警告请选择“仍要运行”，后续版本同样支持应用内自动更新。

本软件可免费用于个人和非商业用途；商业使用需事先获得书面授权，详见 LICENSE。

Full Changelog: v1.4.0...v1.4.1

Pi Desktop v1.4.0

长会话导航轨折叠、上下文压缩防丢保护、运行态吸顶任务卡与窗格拆分自适应

本版本基于 v1.3.1，引入长会话消息导航轨折叠与分组跳转抽屉，彻底解决密集提问下的右侧圆点堆叠；增加上下文压缩期间的消息队列保护与重试机制，杜绝压缩时发消息丢失；新增吸顶运行态任务卡片与命令面板联动，重构多窗格拆分布局与窄屏工具栏自适应，并优化首包等待呼吸光标与轮内重试倒计时。

核心特性与改进

• 消息导航轨多轮折叠与抽屉面板（Message Nav Rail Folding）（致谢社区共创 @xiluyu）：
  • 当单会话提问超过 10 条时，导航轨自动将中间连续圆点折叠为三点图标（...），始终保留首尾圆点与当前激活位置附近的定位点；
  • 点击折叠点即可展开轻量浮层抽屉面板，完整列出隐藏的消息标题，支持点击直接平滑跳转；支持按键 Escape、点击面板外或跳转后自动防抖收起；
  • 引入原生平滑滚动与布局绘制前对齐（useLayoutEffect），彻底杜绝折叠切换与快速跳转时的页面跳动与闪烁。
• 上下文压缩期间 Prompt 保护队列与重试（Compaction Prompt Queue）（致谢社区共创 @xiluyu 与核心联动）：
  • 彻底解决用户在 /compact 上下文压缩或历史快照同步期间发送消息被 pi 底层拒绝、导致输入被吞的问题；
  • 引入前端 FIFO 暂存缓冲队列，在压缩完成后自动重放投递；遭遇 IPC 竞态时自动重试，确保长对话压缩期间发送消息绝对不丢、不报错。
• 吸顶运行态任务卡片与 Workbench 命令行联动（Running Tasks Card）：
  • 在输入框上方吸顶展示当前前台与后台正在执行的 Bash 命令或多工具调用任务；
  • 支持一键展开/折叠任务运行详情，并支持直接点击“在侧边栏查看”无缝联动打开 Workbench 命令行抽屉。
• 多窗格分栏拆分自适应与窄屏优化（Adaptive Panes & Narrow Toolbar）：
  • 彻底解决拖拽分栏高亮覆盖层在鼠标释放时偶尔粘连卡住的问题；
  • 发送按钮与底部工具栏在超窄分栏模式下智能自适应紧凑布局，防止按钮被挤压变形。
• 流式即时响应与轮内重试倒计时（Instant Streaming Cursor & Retry Indicator）：
  • 点击发送后到模型吐出首个 Token 的等待期内，直接显示呼吸闪烁光标（▍），消除首包等待的空白迟滞感；
  • 遭遇模型 429 限流或服务错误触发退避重试时，在当前回合内直接显示实时倒计时指示器（如“重试中 1/3，12 秒后重试…”）。
• 输入框高度自适应重构与多图粘贴：
  • 重构富文本高度计算与布局生命周期同步，长文本发送后立即自适应回弹收起；
  • 支持剪贴板多图同时粘贴并保留草稿缓存，优化图片卡片与文件附件的排版展示。
• 窗口生命周期与环境探测增强：
  • 新增主窗口关闭动作设置项：支持配置关闭主窗口时是直接退出应用还是最小化到系统托盘；
  • Windows 环境下动态扫描注册表自动识别 Node.js 全局运行环境。

社区共创致谢

特别感谢社区贡献者 @xiluyu 为本项目提交并贡献的消息导航轨折叠交互与上下文压缩保护队列！

验证情况

• TypeScript 严格类型检查 100% 通过（pnpm typecheck）。
• 全量单元测试 100% 通过（91 个测试套件，730 个单元测试全部通过）。
• Playwright Electron 端到端全量测试 100% 通过（38 个测试套件，243 个 E2E 用例覆盖）。
• 中英文字典 key 100% 对齐（i18n-parity.test.ts 通过）。

安装提示

Pi Desktop 需要 Node.js 22.19.0 或更新版本，并要求通过 npm 全局安装兼容版本的 pi：

npm i -g @earendil-works/pi-coding-agent

Windows 和 Linux 安装包尚未进行商业代码签名，Windows SmartScreen 可能显示安全提示。请只从本仓库 GitHub Releases 下载，并在运行前核对 SHA-256。

没有 Apple Developer ID 凭据时，macOS 产物使用完整的 ad-hoc 签名。打开 DMG 后双击 Install Pi Desktop.command；如果浏览器 quarantine 阻止双击，请在终端中运行该安装器。安装器只处理 Pi Desktop 自身，不会关闭全局 Gatekeeper。

本软件可免费用于个人和非商业用途；商业使用需事先获得书面授权，详见 LICENSE。

Full Changelog: v1.3.1...v1.4.0

Pi Desktop v1.3.1

消除流式页面抽搐、主进程通信超时放宽与全链路国际化

本版本基于 v1.3.0，彻底消除流式输出时的消息列表频繁重新挂载与抖动，解决长任务与慢速本地模型下的主进程通信超时中断问题，并全面补齐系统托盘、运行时底层错误码与动态错误模板的双语国际化。

修复与改进

• 流式响应页面抽搐与视口重挂载消除（Stream Flickering Fix）：
  • 将 LazyMessageItem 提取至模块顶层独立组件并使用 React.memo 记忆化，阻断 ChatPane 在 50ms 流式 flush 期间重新创建组件引用；
  • 调整可见性机制为“单向粘性可见”（进入过视口的消息保持挂载），杜绝消息在 64px 占位框与真实内容高度之间高频伸缩导致的自动滚动撕扯与列表抽搐。
• 主进程通信解耦与超时保护（Prompt IPC Non-Blocking & Timeout Relaxation）：
  • 将 piRuntime.prompt 调整为在收到 pi SDK 的 preflightResult(true) 时立即返回成功，不再长时间同步阻塞等待整个长回合结束，彻底避免本地慢速模型或复杂长任务触发 30s 通信超时；
  • 在前端通信通道中为 piRuntime.prompt (120s)、piRuntime.compact (120s)、piRuntime.navigateTree (120s) 和 piRuntime.executeBash (300s) 配置充足的超时冗余。
• 预检异常底层错误精准透传（Preflight Error Propagation）：
  • 优化提示词预检失败处理逻辑，允许 session.prompt().catch 完整捕获并向界面透传如“无可用模型”或“缺少 API Key”等详细原因，防止被通用错误码遮蔽。
• 全项目国际化与错误转译补齐（Comprehensive i18n & Error Translation）：
  • 在错误转译层中补齐 30+ 项主进程与运行时固定错误码的双语映射；
  • 新增对模型未找到（model not found）、自定义供应商不存在（custom provider not found）、ID 重复以及更新下载失败等动态模板的参数化本地化转译；
  • 关闭错误信息插值 HTML 转义，保证模型 ID 中的斜杠正确显示；
  • 系统托盘菜单（显示主窗口 / 退出）支持跟随应用设置动态本地化，并在设置页切换语言时即时热刷新；
  • 修复聊天界面与评审面板中遗留的硬编码无障碍 aria-label。

验证情况

• TypeScript 严格类型检查 100% 通过（pnpm typecheck）。
• 全量单元测试 100% 通过（84 个测试套件，668 个单元测试全部通过）。
• Playwright Electron 端到端全量测试 100% 通过（38 个 spec，221 个 E2E 测试全部通过，8 个 Windows 专测在 macOS 环境按设计跳过）。
• 中英文字典 key 100% 对齐（i18n-parity.test.ts 通过）。

安装提示

Pi Desktop 需要 Node.js 22.19.0 或更新版本，并要求通过 npm 全局安装兼容版本的 pi：

npm i -g @earendil-works/pi-coding-agent

Windows 和 Linux 安装包尚未进行商业代码签名，Windows SmartScreen 可能显示安全提示。请只从本仓库 GitHub Releases 下载，并在运行前核对 SHA-256。

没有 Apple Developer ID 凭据时，macOS 产物使用完整的 ad-hoc 签名。打开 DMG 后双击 Install Pi Desktop.command；如果浏览器 quarantine 阻止双击，请在终端中运行该安装器。安装器只处理 Pi Desktop 自身，不会关闭全局 Gatekeeper。

本软件可免费用于个人和非商业用途；商业使用需事先获得书面授权，详见 LICENSE。

Full Changelog: v1.3.0...v1.3.1

Pi Desktop v1.3.0

富文本内联文件胶囊、动态代理穿透、长会话视口渲染与工作台多维拖拽布局

本版本基于 v1.2.1，带来基于 ContentEditable 的内联文件胶囊编辑器、终端子进程动态代理穿透、长会话按需视口渲染优化、输入历史浏览与草稿保护、工作台全量命令历史与分栏拖拽把手、侧边栏自由缩放、会话管理全局折叠与回到底部等多项功能特性与跨平台体验优化。

新功能

• 富文本内联文件胶囊编辑器（Inline File Capsules & Rich Composer）：
  • 聊天输入框重构为基于 ContentEditable 的富文本实体编辑器，文件引用在光标所在位置直接渲染为带专属文件图标与删除按钮的内联胶囊（Capsule Badge）；
  • 支持自然句子中混排文件引用、原子级 Backspace 一键删除胶囊、拖拽工作区文件在光标处插入；
  • 支持分步 Escape 撤销暂存与保持输入光标及焦点；
  • 对话历史气泡中全面统一展示带真实类型图标的内联文件卡片；
  • 双向序列化为原生 @file 提示词文本，保持与 pi 原生 CLI 及 Playwright E2E 自动化完全兼容。
• 终端子进程动态代理穿透（Subprocess Proxy Penetration）：
  • 内存同步缓存当前生效的代理配置；
  • 通用 adapter 执行用户命令及 agent 执行 bash 工具子进程时，完整穿透代理环境变量（HTTP_PROXY / HTTPS_PROXY / ALL_PROXY / NO_PROXY），解决开发服务与终端工具的网络隔离问题。
• 输入历史浏览与草稿保护（Composer History Traversal）：
  • 输入框支持方向键（↑ / ↓）遍历历史发送记录；
  • 具备严格的现场草稿保护机制，遍历回退到底部时完整恢复未发送的草稿输入。
• 上下文高阈值预警条与一键压缩（Context Warning Bar）：
  • 输入框上方集成模型上下文容量预警条，当会话 token 占用达到阈值时展示百分比指示并提供一键 Compact 压缩入口。
• 工作台会话命令历史与分栏拖拽布局（Workbench Splitters & Command History）：
  • 命令面板汇总并展示当前会话全量执行过的命令历史清单；
  • 工作区文件树与代码审查变更列表引入可拖拽调整宽度的分隔条（Draggable Splitter），支持双击重置并具备无障碍支持。
• 侧边栏自由拖拽调整（Resizable Sidebar）：
  • 侧边栏支持边缘自由拖拽调整宽度，支持双击把手恢复默认尺寸；
  • 修复 macOS 下折叠状态时的界面布局对齐。
• 全会话管理折叠与回到底部（Sessions Page Polish）：
  • 会话管理页支持项目分组独立折叠/展开，顶部常驻全局一键全部展开/折叠控件；
  • 新增浮动一键直达底部按钮，优化页面切换时的无感知静默刷新。
• 窗口居中初始摆放与对称审查面板扩展（Centered Window & Symmetric Expansion）：
  • 新建主窗口在主显示器工作区精确几何居中；
  • 展开或关闭 docked 工作台/审查面板时，原生窗口以窗口中心向两侧对称缩放，不再单向向右偏移。
• 代码审查与工具卡片导航联动（Direct Navigation to Review）：
  • 工具卡片与回合文件改动清单支持一键直达评审面板并自动聚焦选中目标文件；
  • 精简已完成工具卡，增强命令展示清晰度与回合折叠状态栏。

性能优化

• 长会话按需视口渲染（Long Session Viewport Virtualization）：
  • 当会话消息数超过 40 条时，自动启用基于估算高度的视口按需渲染，显著降低长会话 DOM 节点数与渲染耗时；
  • 严格保持消息 DOM 锚点 ID，保证导航 rail 与跳转完全正常；
  • 审查面板命令清单引入 50 项增量懒加载。

稳定性与跨平台修复

• 跨平台窗口与系统托盘对齐：统一应用名 Pi Desktop，优化 Windows/Linux 窗口图标与托盘图标缩放。
• Windows 环境兼容性：支持 Windows 下通过 node 入口拉起 vite dev；解决 pnpm dev 启动问题；使用专用 dev AUMI 让任务栏正确展示窗口图标；避免 npm install 时的 Node DEP0190 告警。
• 后台通知与窗口聚焦：后台会话完成后在同一窗口弹窗提示；无窗口承载时点击通知自动唤起会话；优化多平台窗口聚焦激活。
• 聊天生命周期与流式恢复：修复会话切换与发消息 IPC 的竞争时序（awaitingRun）；修复流式中断时的错误捕获与 assistant 异常信息回显；条件化展示 cache write（大于 0 时才显示）。
• 更新检查镜像前缀规整：规整更新源 mirror 前缀去除多余斜杠。
• 审查面板 Write 工具完整 Diff 生成：针对 write 工具创建的文件生成完整的全部新增（Full Addition）Diff，并提供工作区 Diff 兜底。
• 文件拖拽去重：防止向输入框拖拽同名或重复文件。
• 导航 Rail 底部高亮精度修复：对齐底部激活容差，在小数与视口缩放时稳定高亮最新消息圆点。

验证情况

• TypeScript 严格类型检查 100% 通过（pnpm typecheck）。
• 全量单元测试 100% 通过（84 个测试套件，667 个单元测试全部通过，1 个跨平台专测按平台环境跳过）。
• pi 原生 SDK 契约测试 100% 通过（3 个契约测试全部通过）。
• Playwright Electron 端到端全量测试 100% 通过（38 个 spec，221 个 E2E 测试全部通过，8 个跨平台专测按平台环境跳过）。
• Vite 构建与 electron-builder smoke package 验证通过。
• 发布产物附带按平台生成的 SHA256SUMS-<platform>.txt。

安装提示

Pi Desktop 需要 Node.js 22.19.0 或更新版本，并要求通过 npm 全局安装兼容版本的 pi：

npm i -g @earendil-works/pi-coding-agent

Windows 和 Linux 安装包尚未进行商业代码签名，Windows SmartScreen 可能显示安全提示。请只从本仓库 GitHub Releases 下载，并在运行前核对 SHA-256。

没有 Apple Developer ID 凭据时，macOS 产物使用完整的 ad-hoc 签名。打开 DMG 后双击 Install Pi Desktop.command；如果浏览器 quarantine 阻止双击，请在终端中运行该安装器。安装器只处理 Pi Desktop 自身，不会关闭全局 Gatekeeper。

本软件可免费用于个人和非商业用途；商业使用需事先获得书面授权，详见 LICENSE。

Full Changelog: v1.2.1...v1.3.0

Pi Desktop v1.2.1

会话置顶管理、模型上下文滑块与预设、Material 图标体系与跨平台稳定性增强

本版本基于 v1.2.0，带来会话置顶（Pin / Unpin）与所属项目来源展示、模型上下文窗口（Context Window）滑块调节与自适应预设、Material Icon Theme 风格文件图标与胶囊式附件卡片、统一国际化错误格式化，以及新建会话生命周期与跨平台打包等多项稳定性增强。

新功能

• 会话置顶与跨项目管理（Session Pinning）：
  • 支持在侧边栏及全局会话管理页面中一键置顶/取消置顶会话；
  • 侧边栏顶部新增专属「置顶会话」独立分组，优先展示且常驻图钉标识；
  • 置顶会话支持双行布局清晰展示所属项目文件夹名称（跨平台路径解析 getProjectName）；
  • 引入固定 indicator slot 保证活动中与普通状态下的文字与图标垂直对齐；
  • 重构项目分组头部交互，统一单文件夹折叠/展开指示图标。
• 模型上下文窗口（Context Window）动态调节与自适应预设：
  • 模型切换弹层深度集成上下文窗口调节滑块与用量指示器；
  • 智能匹配当前模型的上下文限制并提供自适应推荐预设档位（200k / 256k / 272k / 400k / 500k / 1M 等）；
  • 自动压缩阈值调整与低配警示提示；
  • 通过 host-api 与 pi session adapter 实时动态调整模型上下文窗口限制。
• Material Icon Theme 文件图标与胶囊式附件卡片：
  • 引入专用 Material Icon Theme 风格矢量文件图标，覆盖主流编程语言、文档、配置文件与多媒体；
  • 聊天输入框与消息历史中的文件附件全面升级为高颜值胶囊卡片（Capsule Card）与类型角标；
  • 工作区资源管理器、文件标签页及变更审查视图全面对齐高辨识度图标展示。
• 统一错误格式化与国际化本地化（Error i18n）：
  • 封装 formatErrorMessage 统一处理后端运行时错误代码映射、IPC 超时格式化与工作区路径安全提示；
  • 补齐 zh / en 错误文案键值，实现 100% 翻译覆盖；
  • 全面应用至聊天错误横幅、运行时错误通知、会话加载状态及会话搜索对话框。

稳定性与跨平台修复

• 新建会话生命周期与状态隔离：
  • 修复从已有会话切换至内存新建会话时的窗口绑定残留问题，避免后续发消息误报「session not started」；
  • 阻断旧会话 running 状态向新建会话扩散，确保新建会话处于干净的空闲态；
  • 将会话切换与新建操作纳入慢任务 90 秒超时豁免，前端替换等待延长至 30 秒，避免冷启动误报超时。
• 键盘循环导航（Wrap-around Navigation）：
  • 文件引用（@）与斜杠命令（/）弹窗在列表及树形模式下均支持方向键首尾循环选中。
• 跨平台窗口与打包规范：
  • 跨平台统一固定应用名 Pi Desktop，解决 Linux 下 WM_CLASS 匹配问题；
  • 非 macOS 平台动态挂载窗口图标，优化 Linux 托盘图标缩放；
  • 规范 electron-builder Linux 桌面配置层级结构。

验证情况

• 本地通过 TypeScript 严格类型检查、全量单元测试（78 个测试套件，626 个单元测试 100% 通过）。
• pi 原生 SDK 契约测试 100% 通过。
• Playwright Electron 端到端全量测试（219 个 E2E 测试 100% 通过，8 个跨平台专测按平台环境跳过）。
• Vite 构建与 electron-builder smoke test 验证通过。
• 发布产物附带按平台生成的 SHA256SUMS-<platform>.txt。

安装提示

Pi Desktop 需要 Node.js 22.19.0 或更新版本，并要求通过 npm 全局安装兼容版本的 pi：

npm i -g @earendil-works/pi-coding-agent

Windows 和 Linux 安装包尚未进行商业代码签名，Windows SmartScreen 可能显示安全提示。请只从本仓库 GitHub Releases 下载，并在运行前核对 SHA-256。

没有 Apple Developer ID 凭据时，macOS 产物使用完整的 ad-hoc 签名。打开 DMG 后双击 Install Pi Desktop.command；如果浏览器 quarantine 阻止双击，请在终端中运行该安装器。安装器只处理 Pi Desktop 自身，不会关闭全局 Gatekeeper。

本软件可免费用于个人和非商业用途；商业使用需事先获得书面授权，详见 LICENSE。

Full Changelog: v1.2.0...v1.2.1

Pi Desktop v1.2.0

输入框交互重构、@工作区目录树、应用与 pi 更新卡片解耦及安全增强

本版本基于 v1.1.0，带来输入框（Chat Input）全面架构重构、斜杠命令（Slash Commands）上下文补全与拦截确认、@ 工作区目录树导航穿梭、阶梯式 Escape 快捷撤销、应用与 pi 版本更新卡片独立解耦（含内置 Markdown 发版说明预览）、多镜像断点续传加速、Windows 设备路径防护与 Bash 代理环境无缝注入。

新功能

• 斜杠命令（Slash Commands）交互与补全系统增强：
  • 支持上下文斜杠触发、Space 空格补全与 Enter 直接执行；
  • 拦截未知或无效的斜杠命令并弹出确认对话框，防止手滑将命令当做普通提示词误发给模型；
  • 壳内建命令（/new、/session、/settings、/compact 等）就地分发与清空输入框；
  • 斜杠命令面板底部新增清晰的快捷键操作指引与一键关闭按钮；
  • 修复长命令列表滚动被遮挡问题，支持键盘上下导航时高亮项自适应滚入可视区域。
• @ 文件引用与工作区目录树：
  • 输入 @ 即时呼出完整工作区目录树层级视图；
  • 支持左右方向键（ArrowLeft/ArrowRight）进行目录层级穿梭与 Tab 键快速展开/折叠目录；
  • 未匹配的文件引用在发送前弹出拦截确认框；
  • 精准区分引用文件与附件，支持图片及多种文档引用。
• 阶梯式 Escape 撤销与全局快捷键：
  • 支持阶梯式 Esc 撤销（优先关闭补全弹窗/确认弹窗 → 逐个移除待发暂存 Skill/附件/模式 → 清除输入）；
  • 全局模态框、抽屉（Drawer）与各类浮层支持 Esc 一键关闭。
• 打字机动态问候语：
  • 聊天初始页面新增多语言轮播打字机问候语与呼吸光标动效。
• 应用更新与 pi 升级卡片分离解耦：
  • 设置页将 Pi Desktop 自身更新与全局 pi CLI 升级拆分为独立卡片；
  • 应用更新支持内嵌 Markdown 渲染的 Release Notes 预览与官方 Logo 标识；
  • 在最新版本时提供即时的「已是最新」动画与视觉反馈；
  • 点击通知 Toast 中的「前往下载」平滑滚动定位至设置页对应卡片。
• 多通道镜像加速与下载断点续传：
  • 内置 GitHub 官方、自定义镜像与 npmmirror 多通道自动故障切换与兜底；
  • 支持 HTTP Range 断点续传、Linux 资产命名自适应与 24 小时免打扰静默检测周期。
• 会话管理与卡片视觉：
  • 会话信息弹层升级为现代化卡片式布局（现代排版、多维度统计与中英双语对齐）；
  • 内存中空会话提供直观的「未保存」状态指示。

安全与稳定性优化

• 路径安全与跨平台防护：
  • 强制拒绝 Windows 设备路径（\\.\、\\?\、COM1 等）注入；
  • 工作区文件安全预览采用回合作用域权限授权（Turn-scoped preview grants）。
• 环境代理注入与 Bash 执行：
  • 桌面应用配置的代理环境变量（HTTP_PROXY、HTTPS_PROXY、ALL_PROXY、NO_PROXY）无缝注入本地 Bash 执行环境；
  • 强化会话原子写盘与 JSONL 损坏容错机制。
• 运行时资源回收：
  • 主进程引入 pending dispose 扫尾与超时兜底，杜绝僵死 runtime 进程残留。
• 输入层架构解耦：
  • 将庞大的 ChatInput 组件彻底解耦为模块化 hooks（useSlashCommands、useFileMentions、useAttachments 等）与独立子组件。

验证情况

• 本地通过 TypeScript 严格类型检查、全量单元测试（75 个测试套件，595 个单元测试 100% 通过）。
• pi 原生 SDK 契约测试 100% 通过。
• Playwright Electron 端到端全量测试（38 个测试套件，215 个 E2E 测试 100% 通过）。
• CI 在 macOS、Windows、Linux 上分别执行类型检查、单元测试、Vite 构建与安装包 smoke test，全绿。
• 发布产物附带按平台生成的 SHA256SUMS-<platform>.txt。

安装提示

Pi Desktop 需要 Node.js 22.19.0 或更新版本，并要求通过 npm 全局安装兼容版本的 pi：

npm i -g @earendil-works/pi-coding-agent

Windows 和 Linux 安装包尚未进行商业代码签名，Windows SmartScreen 可能显示安全提示。请只从本仓库 GitHub Releases 下载，并在运行前核对 SHA-256。

没有 Apple Developer ID 凭据时，macOS 产物使用完整的 ad-hoc 签名。打开 DMG 后双击 Install Pi Desktop.command；如果浏览器 quarantine 阻止双击，请在终端中运行该安装器。安装器只处理 Pi Desktop 自身，不会关闭全局 Gatekeeper。

本软件可免费用于个人和非商业用途；商业使用需事先获得书面授权，详见 LICENSE。

Full Changelog: v1.1.0...v1.2.0

Pi Desktop v1.1.0

Skills 技能管理、多模态视觉识别、官方模型目录规格与设置页重构

本版本基于 v1.0.0，带来技能（Skills）元数据解析与调用模式管理、多模态视觉能力自动识别与逐模型开关、模型元数据接入 pi 官方内置规格目录、自定义供应商浮层弹窗与并发协议探测、项目级会话导出管理、设置页排版视觉重构以及全局错误恢复自救能力。

新功能

• Skills 技能系统与元数据卡片：
  • 技能预览弹窗升级为结构化元数据卡片（支持解析 YAML Frontmatter 中的作者、版本、描述、许可证与调用模式）；
  • 支持直接在技能卡片中切换模型调用模式（Inline 内联 / Invocable 模型自主调用），带有批量优化横幅与可观测性状态徽标；
  • 对话标题自动解析并剥离 skill 标签与 XML 信封。
• 多模态视觉识别与逐模型开关：
  • 模型管理页自动识别主流最新多模态视觉模型（GPT-4o / GPT-5、Claude 3.7 Sonnet / Opus、Gemini 2.0 / 2.5 Flash & Pro 等），并标注独立图像能力标识；
  • 支持在模型管理列表中为单个模型手动开关图像多模态输入（image 模态声明）。
• 模型元数据接入 pi 官方内置规格目录：
  • 模型上下文窗口（Context Window）、最大输出 Token 与官方定价全面接入 pi 内置静态规格目录，自动纠正网关返回的陈旧错值与全 0 价格占位；
  • 模型行右侧新增独立能力胶囊列（Vision / Reasoning / Context），长模型 ID 与描述自适应排版。
• 自定义供应商浮层弹窗与并发协议探测：
  • 新增与编辑供应商表单升级为大尺寸浮层对话框（Dialog），支持自定义供应商名称与基本信息就地编辑；
  • 支持 openai-completions、openai-responses 与 anthropic-messages 协议并发探测，自动解析网关支持的端点类型与缓存上报能力。
• 项目级会话导出管理：
  • 会话管理页按项目聚合归类展示导出的 Markdown / JSONL 会话记录，呈现 Top 5 最近导出记录并支持一键定位目录；
  • 页面激活与窗口重新聚焦时自动校验导出文件的磁盘存在性。

修复与体验优化

• 设置页排版与视觉重构：
  • 修复标题与副标题负边距导致的文字碰撞紧贴，优化说明文案行高与间距；
  • 可用工具行重构为垂直堆叠布局，7 个工具胶囊自然整齐排列，彻底杜绝小屏幕或长说明下的锯齿阶梯状错位；
  • 核心工具（read/bash/edit/write）启用专用锁定高亮状态（opacity: 1 + 锁图标 + 悬浮提示），消除灰显禁用误导；
  • 默认思考深度分段控制器等宽居中（消除单字胶囊变形），数字输入框精简居中；
  • 项目信任增加专属虚线空状态卡片容器，上下文压缩增加清晰的注脚推荐分隔。
• 网络代理与网关穿透：
  • 模型目录请求强制走桌面代理，自动携带 pi UA 请求头以通过中转站白名单，避免 HTML 错误页导致解析崩溃；
  • 允许 text/plain 响应头下携带的合法 JSON 数据，增强非 200 状态码的可读错误描述。
• 会话容错与多窗口稳定性：
  • 会话切换引入互斥锁（Session Mutex），容错损坏的 JSONL 文件，避免并发切换冲突；
  • 跨窗口打开同一会话时主动复用并聚焦持有窗口，杜绝双持有状态冲突；
  • 会话切换时自动清空 Usage 统计快照，避免上一会话的 Token 数据残留。
• 全局错误治理：
  • 统一错误交互层——支持可关闭的顶部启动 Banner 与跨区域全局错误 Banner；
  • 模型不可用（503 / 401 / Wrong-Model）时提供结构化提示并引导就地切换模型自救。

验证情况

• 本地通过 TypeScript 严格类型检查、i18n 双语 parity 检查、全量单元测试（74 个测试套件，575 个单元测试 100% 通过）。
• CI 在 macOS、Windows、Linux 上分别执行类型检查、单元测试、Vite 构建与安装包 smoke test，全绿。
• 发布产物附带按平台生成的 SHA256SUMS-<platform>.txt。

安装提示

Pi Desktop 需要 Node.js 22.19.0 或更新版本，并要求通过 npm 全局安装兼容版本的 pi：

npm i -g @earendil-works/pi-coding-agent

Windows 和 Linux 安装包尚未进行商业代码签名，Windows SmartScreen 可能显示安全提示。请只从本仓库 GitHub Releases 下载，并在运行前核对 SHA-256。

没有 Apple Developer ID 凭据时，macOS 产物使用完整的 ad-hoc 签名。打开 DMG 后双击 Install Pi Desktop.command；如果浏览器 quarantine 阻止双击，请在终端中运行该安装器。安装器只处理 Pi Desktop 自身，不会关闭全局 Gatekeeper。

本软件可免费用于个人和非商业用途；商业使用需事先获得书面授权，详见 LICENSE。

Full Changelog: v1.0.0...v1.1.0