Pi GUI v0.32.0

本版摘要

• PI-Desktop 全新桌面外壳与统一顶栏：引入沉浸式连续拖拽顶栏与可折叠侧边栏，重构多会话导航与状态指示，提供现代桌面级体验。
• 对话流与 Composer 深度重构：优化聊天气泡、工具调用卡片与思考过程折叠展示，重构底部输入区（Composer），原生支持中文输入法平滑换行与发送。
• 独立右侧工作台与工具集成：支持内置浏览器、终端与辅助工具的独立分栏及全屏切换，任务进行中查阅资料与预览无需频繁切屏。
• 全局设计代币与浅色主题支持：建立完整的颜色、阴影与圆角设计代币系统，新增高品质浅色主题，并支持明暗模式与系统外观实时同步。
• 现代化设置中心与原生交互原语：重构外观、快捷键与常规设置，统一开关、分段控件与浮层交互规范，操作更清晰稳定。
• 轻量化与离线体验优化：多轮精简历史冗余构建产物与开发证据，优化离线设计预览与窗口拖拽性能，启动与交互响应更加迅捷。

What's Changed

• 测试与元数据修复：对象撤销测试改用进程内计算 + 修正 package.json 乱码 by @HYJ1817 in #48
• feat(ui): 依据 PI-Desktop 规范完成阶段 A 设计代币与阶段 B 设置中心重构 by @HYJ1817 in #49
• 阶段 C：重构主界面外壳、连续顶栏与项目会话侧栏 by @HYJ1817 in #50
• 重构阶段 D 对话流与 Composer by @HYJ1817 in #52
• 修正更新助手回归测试的 CI 就绪等待 by @HYJ1817 in #51
• 重构阶段 E：对齐 PI-Desktop 右侧工作台 by @HYJ1817 in #53
• 收敛阶段 F：PI-Desktop 浅色主题与视觉验收 by @HYJ1817 in #54
• 修复 PI-Desktop A–F 最终审计的交互与视觉问题 by @HYJ1817 in #55
• 清理历史 UI 证据并将仓库当前文件缩减至 114.6 MB by @HYJ1817 in #56
• 第三轮仓库精简：归档重复证据并降至90.31 MB by @HYJ1817 in #57
• 发布准备：v0.32.0 by @HYJ1817 in #58

Full Changelog: v0.31.0...v0.32.0

---

交付物

文件	说明
Pi-GUI-Setup-<版本>.exe	安装程序（单用户，不弹 UAC）。装在 %LOCALAPPDATA%\Programs\Pi GUI
Pi-GUI-<版本>-portable.zip	便携版，解压直接跑 Pi GUI.exe，不用装
SHA256SUMS.txt	上面两个文件的 SHA-256 校验和

下载后建议核一下（把 <版本> 换成实际版本号）：

certutil -hashfile Pi-GUI-Setup-<版本>.exe SHA256

与 SHA256SUMS.txt 里的值逐位比对。

卸载只删程序文件 —— %APPDATA%\Pi GUI 下的项目列表与窗口布局会保留。

Code signing policy

本项目正在申请 SignPath Foundation 的免费 OSS 代码签名
（签名服务由 SignPath.io 提供）。申请尚未通过，正式发版流程也还
没有接入签名 —— 所以当前下载到的产物仍然可能是未签名的，Windows 可能因此提示
「未知发布者」。

签名正式启用后，覆盖的会是本项目自己构建的 Windows 安装程序；随包分发的
Electron / Chromium 等上游开源二进制不会用本证书签名。

• Code signing policy（签名范围、角色、审批流程）：CODE_SIGNING_POLICY.md
• Privacy policy（联不联网、传什么数据）：PRIVACY.md

前置条件

界面本身不含 pi。本机要先装好 pi 并配好模型供应商：

npm i -g @earendil-works/pi-coding-agent   # 需要 Node >= 22.19.0
pi --version

否则界面能打开，但发出去的消息会报错。

Pi GUI v0.31.0

本版摘要

• Refined 设置中心：将常规设置、外观主题、快捷键列表与关于信息整合进中央工作区，提供一致、清晰的层级导航与详情视图，告别旧版弹窗层叠冲突。
• 会话级 Runtime 快捷控制：新增会话级 Runtime 模型选择与思考等级快捷菜单，支持快速筛选、切换与原生 Pi 回读确认，操作更加直观流畅。
• 稳定底部 Composer 交互：优化输入区交互与草稿保持机制，支持原生中文输入法多场景（确认 Enter、换行 Shift+Enter）准确响应，告别意外发送或快捷键丢失。
• 弹窗与异步响应防冲突：严格隔离 Modal 生命周期与异步任务，普通弹窗仅清理由其持有的动态节点，防止迟到的保存或诊断响应改写已切换的新页面。
• 项目首页与展示优化：精简与更新 README，突出本地桌面界面特色、离线优先原则与安装包/便携包下载入口。

What's Changed

• 完成 Refined 设置详情与 Runtime 体验 by @HYJ1817 in #45
• docs: 精简 README，改为产品展示式首页 by @HYJ1817 in #46
• 发布准备：v0.31.0 by @HYJ1817 in #47

Full Changelog: v0.30.1...v0.31.0

---

交付物

文件	说明
Pi-GUI-Setup-<版本>.exe	安装程序（单用户，不弹 UAC）。装在 %LOCALAPPDATA%\Programs\Pi GUI
Pi-GUI-<版本>-portable.zip	便携版，解压直接跑 Pi GUI.exe，不用装
SHA256SUMS.txt	上面两个文件的 SHA-256 校验和

下载后建议核一下（把 <版本> 换成实际版本号）：

certutil -hashfile Pi-GUI-Setup-<版本>.exe SHA256

与 SHA256SUMS.txt 里的值逐位比对。

卸载只删程序文件 —— %APPDATA%\Pi GUI 下的项目列表与窗口布局会保留。

Code signing policy

本项目正在申请 SignPath Foundation 的免费 OSS 代码签名
（签名服务由 SignPath.io 提供）。申请尚未通过，正式发版流程也还
没有接入签名 —— 所以当前下载到的产物仍然可能是未签名的，Windows 可能因此提示
「未知发布者」。

签名正式启用后，覆盖的会是本项目自己构建的 Windows 安装程序；随包分发的
Electron / Chromium 等上游开源二进制不会用本证书签名。

• Code signing policy（签名范围、角色、审批流程）：CODE_SIGNING_POLICY.md
• Privacy policy（联不联网、传什么数据）：PRIVACY.md

前置条件

界面本身不含 pi。本机要先装好 pi 并配好模型供应商：

npm i -g @earendil-works/pi-coding-agent   # 需要 Node >= 22.19.0
pi --version

否则界面能打开，但发出去的消息会报错。

Pi GUI v0.30.1

本版摘要

• Windows 安装版应用内更新：提供下载进度、SHA256 完整性校验和“重启以更新”；退出前检查活跃会话、Agent、审批、开发进程和浏览器活动，重启后读取实际运行版本。修复中文安装目录被误判为便携版的问题。
• 更新失败完整恢复：安装失败或版本验证不符时恢复更新前的完整程序文件集合，核验并移除失败安装新增的文件；无法证明恢复完整时明确要求人工恢复，保留备份和用户数据。便携版继续采用下载校验后手动替换流程。
• 停止与取消更可靠：修复 Stop 取消链路、并发会话隔离及迟到应答防护，避免停止过程错误释放任务屏障。
• 思考等级恢复：修复刷新或恢复会话后思考等级不可用的问题，读取失败时显示原因并允许重试，继续以原生 Pi 回读确认实际设置。
• 数据目录与迁移安全：完善独立程序的数据目录选择和迁移保护，保留已有便携目录；显式数据目录不被自动迁移覆盖，失败时保留可诊断状态。
• 面板恢复更稳定：修复 Changes、Specs 面板在刷新后的开启状态与滚动位置恢复；Browser 面板不自动重连。

What's Changed

• fix: 修复 Bug 8~11 稳定性问题（Stop 取消、思考等级恢复、数据目录与迁移安全、面板自动恢复） by @HYJ1817 in #42
• 补齐 Windows 应用内更新与安全重启，完善失败回滚完整性 by @HYJ1817 in #43
• 发布准备：v0.30.1 应用内更新与稳定性修复 by @HYJ1817 in #44

Full Changelog: v0.30.0...v0.30.1

---

交付物

文件	说明
Pi-GUI-Setup-<版本>.exe	安装程序（单用户，不弹 UAC）。装在 %LOCALAPPDATA%\Programs\Pi GUI
Pi-GUI-<版本>-portable.zip	便携版，解压直接跑 Pi GUI.exe，不用装
SHA256SUMS.txt	上面两个文件的 SHA-256 校验和

下载后建议核一下（把 <版本> 换成实际版本号）：

certutil -hashfile Pi-GUI-Setup-<版本>.exe SHA256

与 SHA256SUMS.txt 里的值逐位比对。

卸载只删程序文件 —— %APPDATA%\Pi GUI 下的项目列表与窗口布局会保留。

Code signing policy

本项目正在申请 SignPath Foundation 的免费 OSS 代码签名
（签名服务由 SignPath.io 提供）。申请尚未通过，正式发版流程也还
没有接入签名 —— 所以当前下载到的产物仍然可能是未签名的，Windows 可能因此提示
「未知发布者」。

签名正式启用后，覆盖的会是本项目自己构建的 Windows 安装程序；随包分发的
Electron / Chromium 等上游开源二进制不会用本证书签名。

• Code signing policy（签名范围、角色、审批流程）：CODE_SIGNING_POLICY.md
• Privacy policy（联不联网、传什么数据）：PRIVACY.md

前置条件

界面本身不含 pi。本机要先装好 pi 并配好模型供应商：

npm i -g @earendil-works/pi-coding-agent   # 需要 Node >= 22.19.0
pi --version

否则界面能打开，但发出去的消息会报错。

旧版本首次升级说明

如果旧版只有安装包、便携包或下载入口，没有“重启以更新”，请先手动安装本版一次。之后，可确认安装身份的 Windows 安装版可在应用内下载后重启更新；便携版仍需退出后手动替换。升级期间保留用户数据，请勿用清空用户数据目录的方式重装。

Pi GUI v0.30.0

本版摘要

• 协同画布与流程图编辑 (Z4)：新增可视化流程图画布与生产力工具箱，支持节点拓扑编辑、对齐与框选批量操作、高保真 SVG/PNG 导出，以及来自 Pi Agent 的实时协同建议队列与只读差异预览。
• 受控 Gen UI 与交互式可视化 (Z3-A)：支持在对话中直接渲染交互式折线图、柱状图与指标卡，具备严格数值校验、零基线几何防护与流式重绘替换保护。
• 并行会话输入法与草稿可靠性 (Z5-1)：彻底修复中文输入法（IME）候选词确认误触发发送的问题；支持未发送纯文本草稿跨会话安全隔离与刷新恢复，迟到 ACK 绝不清除新草稿。
• 统一模型思考等级合同 (Z5-2)：Classic 与 Runtime 统一采用原生 Pi 回读优先的推理等级策略，精确展示档位可用性与安全禁用原因，杜绝乐观虚假成功。
• 只读历史工具摘要与精准定位 (Z5-3 / Z5-3B)：浏览已关闭会话历史时同屏呈现脱敏的工具执行摘要（已记录完成、结果报错、状态未知），不泄露底层私有路径或参数；正文消息与工具行彻底隔离，历史搜索跳转零偏移。
• 上下文引用与右栏面板恢复 (Z1)：支持将日志概览一键引用至任务会话，并在切换会话及页面重载时精准恢复右侧 Changes、Specs、Browser 面板的开启状态与滚动位置。

What's Changed

• Z1：修复 Changes 滚动恢复与日志引用反馈 by @HYJ1817 in #29
• feat(z3): 受控 Gen UI 与交互式可视化 (Z3-A) by @HYJ1817 in #30
• Z4-2：生产化协同流程图编辑与安全存储 by @HYJ1817 in #31
• Z4-3：真实 Pi Agent 协同编辑链路（含两轮独立验收修复） by @HYJ1817 in #32
• Z4-4：协同流程图编辑体验增强与正式集成（自动布局 / 安全预览 / SVG-PNG 导出） by @HYJ1817 in #33
• Z4-5：协同流程图高级编辑（多选 / 批量拖动与删除 / 复制粘贴 / 对齐 / 大图限制评估） by @HYJ1817 in #34
• Z4-6A：协同编辑稳定性收口与真实环境验证 by @HYJ1817 in #35
• Z4-6B：协同编辑最终集成验收与打包窗口证明 by @HYJ1817 in #36
• Z5-1: 并行会话输入可靠性与草稿恢复 by @HYJ1817 in #37
• Z5-2：统一 Classic / Runtime 原生思考等级可用性合同 by @HYJ1817 in #38
• Z5-3：历史工具摘要后端与安全正文位置 by @HYJ1817 in #39
• Z5-3B：历史工具摘要 UI 集成与最终收尾 by @HYJ1817 in #40
• 发布准备：v0.30.0 by @HYJ1817 in #41

Full Changelog: v0.29.0...v0.30.0

---

交付物

文件	说明
Pi-GUI-Setup-<版本>.exe	安装程序（单用户，不弹 UAC）。装在 %LOCALAPPDATA%\Programs\Pi GUI
Pi-GUI-<版本>-portable.zip	便携版，解压直接跑 Pi GUI.exe，不用装
SHA256SUMS.txt	上面两个文件的 SHA-256 校验和

下载后建议核一下（把 <版本> 换成实际版本号）：

certutil -hashfile Pi-GUI-Setup-<版本>.exe SHA256

与 SHA256SUMS.txt 里的值逐位比对。

卸载只删程序文件 —— %APPDATA%\Pi GUI 下的项目列表与窗口布局会保留。

Code signing policy

本项目正在申请 SignPath Foundation 的免费 OSS 代码签名
（签名服务由 SignPath.io 提供）。申请尚未通过，正式发版流程也还
没有接入签名 —— 所以当前下载到的产物仍然可能是未签名的，Windows 可能因此提示
「未知发布者」。

签名正式启用后，覆盖的会是本项目自己构建的 Windows 安装程序；随包分发的
Electron / Chromium 等上游开源二进制不会用本证书签名。

• Code signing policy（签名范围、角色、审批流程）：CODE_SIGNING_POLICY.md
• Privacy policy（联不联网、传什么数据）：PRIVACY.md

前置条件

界面本身不含 pi。本机要先装好 pi 并配好模型供应商：

npm i -g @earendil-works/pi-coding-agent   # 需要 Node >= 22.19.0
pi --version

否则界面能打开，但发出去的消息会报错。

Pi GUI v0.29.0

本版摘要

• 候选修改采纳（实验性）：在 Windows 本地 NTFS 环境下，可先查看候选修改范围，再经明确确认写回来源工作区；不会自动提交或合并 Git，暂存内容保持不变。
• 冲突检查：来源或候选内容、文件身份发生变化，或检查材料不足时，拒绝采纳并保留候选结果供检查。
• 失败恢复（受限）：增加采纳事务记录及另行确认的恢复入口；遇到未知写入、外部改动或遗留锁时停止自动操作并保留材料，不保证多文件原子性或断电恢复。
• 候选恢复稳定性：修复恢复确认早期失败时的异常处理，保留原始错误及可核查的事务状态。
• 交付可靠性：改进测试结果持久保存与完整性校验，让独立打包与测试并行，补充离线桌面回归；不承诺固定的提速比例。
• 资格与已知限制：候选采纳仍为实验性，独立功能与安全验收及真实旧版原位置覆盖升级验证尚未完成；P33 原对象生产撤销资格未开放。候选 Worktree 不是操作系统沙箱，需本机已有 pi 和可用模型配置。安装、升级或卸载前请先停止任务并退出应用。

What's Changed

• 文档：收口代码规范与开发验收材料（G0-B） by @HYJ1817 in #23
• T4-C：候选修改安全采纳、冲突检测与失败恢复 by @HYJ1817 in #24
• G1：落地日常开发交付模板与文件规模报告 by @HYJ1817 in #25
• G2：持久化 CI 证据、观测性能并补充离线 Electron smoke by @HYJ1817 in #26
• G3：并行独立打包、评估文档轻量路径并准备合并保护 by @HYJ1817 in #27
• 发布准备：v0.29.0 by @HYJ1817 in #28

Full Changelog: v0.28.0...v0.29.0

---

交付物

文件	说明
Pi-GUI-Setup-<版本>.exe	安装程序（单用户，不弹 UAC）。装在 %LOCALAPPDATA%\Programs\Pi GUI
Pi-GUI-<版本>-portable.zip	便携版，解压直接跑 Pi GUI.exe，不用装
SHA256SUMS.txt	上面两个文件的 SHA-256 校验和

下载后建议核一下（把 <版本> 换成实际版本号）：

certutil -hashfile Pi-GUI-Setup-<版本>.exe SHA256

与 SHA256SUMS.txt 里的值逐位比对。

卸载只删程序文件 —— %APPDATA%\Pi GUI 下的项目列表与窗口布局会保留。

Code signing policy

本项目正在申请 SignPath Foundation 的免费 OSS 代码签名
（签名服务由 SignPath.io 提供）。申请尚未通过，正式发版流程也还
没有接入签名 —— 所以当前下载到的产物仍然可能是未签名的，Windows 可能因此提示
「未知发布者」。

签名正式启用后，覆盖的会是本项目自己构建的 Windows 安装程序；随包分发的
Electron / Chromium 等上游开源二进制不会用本证书签名。

• Code signing policy（签名范围、角色、审批流程）：CODE_SIGNING_POLICY.md
• Privacy policy（联不联网、传什么数据）：PRIVACY.md

前置条件

界面本身不含 pi。本机要先装好 pi 并配好模型供应商：

npm i -g @earendil-works/pi-coding-agent   # 需要 Node >= 22.19.0
pi --version

否则界面能打开，但发出去的消息会报错。

Pi GUI v0.28.0

本版摘要

• Specs 与分屏工作台：新增只读 Specs 项目文档系统，自动索引项目根目录 SPEC.md 及 specs/ 目录下 Markdown 文档；支持 Specs + Changes 以及 Browser + Changes 双面板分屏工作台，支持原生浏览器视图几何同步、比例拖拽与独立会话隔离。
• Diff 单行与区间评论：Changes 面板支持 Unified Diff 行级单行及多行（最多 20 行）区间审查意见添加、行内编辑与删除；采用项目/Worktree/会话严格隔离的持久化存储，支持应用重启后安全恢复及失效锚点明确标记。
• 审查意见驱动的修改任务预览：支持多选有效审查意见并预览结构化修改任务 Prompt；支持一键复制或填入当前会话输入框，不覆盖用户已有草稿，且不自动发送消息。
• 候选 Worktree 与真实修改预览（实验性）：基于选中的审查意见，经过只读预检与用户二次确认后，创建独立 Git 候选工作区并拉起隔离 Agent 执行；通过真实文件前后差异展示修改结果，且不自动写回、合并或替换来源工作区。
• 安全修复与发布流水线加固：全面升级 GitHub Actions CI 与 Release 工作流至 Node.js 24.22.1 LTS 安全版本，消除已知基础安全漏洞；保持产品最低运行环境要求 engines.node >= 22.19 不变。
• 兼容性与已知限制：候选 Worktree 依赖本地 Git worktree 机制，并非操作系统沙箱；修改任务与候选执行不包含自动采纳或合并功能（采纳能力尚未实现）；执行候选修改需在设置中配置可用模型，且不会绕过现有原生工具审批门禁。

What's Changed

• 增加 Specs 与 Changes 可选分屏工作台（T2-A） by @HYJ1817 in #14
• 增加 Browser 与 Changes 原生分屏工作台（T2-B） by @HYJ1817 in #15
• T3-A：Diff 行级评论与审查反馈 by @HYJ1817 in #16
• 文档：优化开发规则入口、测试策略与发布说明（G0-A） by @HYJ1817 in #17
• T3-B：Diff 行级评论持久化与安全恢复 by @HYJ1817 in #18
• T3-C：Diff 多行区间评论与审查反馈增强 by @HYJ1817 in #19
• T4-A：审查意见修改任务预览与安全确认 by @HYJ1817 in #20
• T4-B：隔离候选执行与真实 Diff 预览 by @HYJ1817 in #21
• 发布准备：Node 24.22.1 安全升级与 pi-GUI v0.28.0 by @HYJ1817 in #22

Full Changelog: v0.27.0...v0.28.0

---

交付物

文件	说明
Pi-GUI-Setup-<版本>.exe	安装程序（单用户，不弹 UAC）。装在 %LOCALAPPDATA%\Programs\Pi GUI
Pi-GUI-<版本>-portable.zip	便携版，解压直接跑 Pi GUI.exe，不用装
SHA256SUMS.txt	上面两个文件的 SHA-256 校验和

下载后建议核一下（把 <版本> 换成实际版本号）：

certutil -hashfile Pi-GUI-Setup-<版本>.exe SHA256

与 SHA256SUMS.txt 里的值逐位比对。

卸载只删程序文件 —— %APPDATA%\Pi GUI 下的项目列表与窗口布局会保留。

Code signing policy

本项目正在申请 SignPath Foundation 的免费 OSS 代码签名
（签名服务由 SignPath.io 提供）。申请尚未通过，正式发版流程也还
没有接入签名 —— 所以当前下载到的产物仍然可能是未签名的，Windows 可能因此提示
「未知发布者」。

签名正式启用后，覆盖的会是本项目自己构建的 Windows 安装程序；随包分发的
Electron / Chromium 等上游开源二进制不会用本证书签名。

• Code signing policy（签名范围、角色、审批流程）：CODE_SIGNING_POLICY.md
• Privacy policy（联不联网、传什么数据）：PRIVACY.md

前置条件

界面本身不含 pi。本机要先装好 pi 并配好模型供应商：

npm i -g @earendil-works/pi-coding-agent   # 需要 Node >= 22.19.0
pi --version

否则界面能打开，但发出去的消息会报错。

Pi GUI v0.27.0

本版摘要

• Windows 应用内更新：安装版用户可在设置中主动下载官方 Release、查看实时进度与速度，并在 SHA256 校验完成后选择「重启以更新」；失败可重试，选择「稍后」后下次启动仍会离线复核已验证安装包。
• 安全退出与恢复：更新前检查所有会话、Agent、工具、审批、命令和后台操作；仍在运行时拒绝强制升级。助手等待旧应用安全退出后安装，失败会恢复旧程序并保留用户数据。
• 运行形态隔离：只把注册表与真实 exe 均匹配的 NSIS 安装识别为安装版；便携版验证 ZIP 后仅允许手动替换，开发模式只检查更新，不启动安装包。
• 更新状态可恢复：启动时区分助手仍在等待、安装成功和安装失败；确认结果后消费待处理标记，避免误报未完成或每次启动重复提示。
• 下载与安装边界：主进程复核官方仓库、版本、文件名、大小及可信 SHA256，拒绝 Renderer 提供的执行路径或下载地址，并阻止重复下载与并发安装。

正式 NSIS 安装器尚未在独立 Windows 用户或虚拟机中完成“原安装位置覆盖升级”的人工验收；现有真实 NSIS 升级证据使用隔离夹具。发布 CI 仍会在一次性 Windows runner 上执行安装、启动和卸载验证，但这不替代上述验收。

What's Changed

• 修复会话审批竞态并恢复 CI 确定性 by @HYJ1817 in #10
• 修复 UI2 视觉套件的 CDP 启动偶发失败 by @HYJ1817 in #11
• Windows：增加应用内下载校验与安全重启更新 by @HYJ1817 in #12

Full Changelog: v0.26.2...v0.27.0

---

交付物

文件	说明
Pi-GUI-Setup-<版本>.exe	安装程序（单用户，不弹 UAC）。装在 %LOCALAPPDATA%\Programs\Pi GUI
Pi-GUI-<版本>-portable.zip	便携版，解压直接跑 Pi GUI.exe，不用装
SHA256SUMS.txt	上面两个文件的 SHA-256 校验和

下载后建议核一下（把 <版本> 换成实际版本号）：

certutil -hashfile Pi-GUI-Setup-<版本>.exe SHA256

与 SHA256SUMS.txt 里的值逐位比对。

卸载只删程序文件 —— %APPDATA%\Pi GUI 下的项目列表与窗口布局会保留。

Code signing policy

本项目正在申请 SignPath Foundation 的免费 OSS 代码签名
（签名服务由 SignPath.io 提供）。申请尚未通过，正式发版流程也还
没有接入签名 —— 所以当前下载到的产物仍然可能是未签名的，Windows 可能因此提示
「未知发布者」。

签名正式启用后，覆盖的会是本项目自己构建的 Windows 安装程序；随包分发的
Electron / Chromium 等上游开源二进制不会用本证书签名。

• Code signing policy（签名范围、角色、审批流程）：CODE_SIGNING_POLICY.md
• Privacy policy（联不联网、传什么数据）：PRIVACY.md

前置条件

界面本身不含 pi。本机要先装好 pi 并配好模型供应商：

npm i -g @earendil-works/pi-coding-agent   # 需要 Node >= 22.19.0
pi --version

否则界面能打开，但发出去的消息会报错。

Pi GUI v0.26.2

本版摘要

• Stop 停止确认：将 abort 应答与对应请求 ID 关联，防止迟到的旧应答解除新一轮停止屏障；停止未确认时继续阻止新任务进入运行时。
• 附件与文档：修复百分号文件名、同名上传覆盖风险和附件解析期间的发送拦截，保留 DOCX 制表符及换行。
• 草稿与历史：避免会话切换及异步发送清除新草稿，修复历史缓存失效和长历史截取方向，改善会话隔离。
• Runtime 状态与审批：按请求身份处理运行状态，统一审批提交状态，避免跨视图重复提交和迟到响应影响当前任务。
• 发布验证提速：正式发布复用相同提交已通过的完整 CI，继续执行安装卸载、产物与 SHA256 验证；CI 未完成或证明不一致时阻止发布。固定并核验官方 NSIS 安装器，避免 Chocolatey 下载故障阻断打包。

Stop 的隔离回归测试已完成；真实供应商验收因 HTTP 502 未通过，不能视为真实模型场景已验收。会话变更的生产恢复资格仍为 NO-GO，不开放 B Writer 或自动撤销，不放宽现有安全拒绝。真实模型长时间压力测试及 POSIX 真机等验证仍未完成。

Full Changelog: v0.26.1...v0.26.2

---

交付物

文件	说明
Pi-GUI-Setup-<版本>.exe	安装程序（单用户，不弹 UAC）。装在 %LOCALAPPDATA%\Programs\Pi GUI
Pi-GUI-<版本>-portable.zip	便携版，解压直接跑 Pi GUI.exe，不用装
SHA256SUMS.txt	上面两个文件的 SHA-256 校验和

下载后建议核一下（把 <版本> 换成实际版本号）：

certutil -hashfile Pi-GUI-Setup-<版本>.exe SHA256

与 SHA256SUMS.txt 里的值逐位比对。

卸载只删程序文件 —— %APPDATA%\Pi GUI 下的项目列表与窗口布局会保留。

Code signing policy

本项目正在申请 SignPath Foundation 的免费 OSS 代码签名
（签名服务由 SignPath.io 提供）。申请尚未通过，正式发版流程也还
没有接入签名 —— 所以当前下载到的产物仍然可能是未签名的，Windows 可能因此提示
「未知发布者」。

签名正式启用后，覆盖的会是本项目自己构建的 Windows 安装程序；随包分发的
Electron / Chromium 等上游开源二进制不会用本证书签名。

• Code signing policy（签名范围、角色、审批流程）：CODE_SIGNING_POLICY.md
• Privacy policy（联不联网、传什么数据）：PRIVACY.md

前置条件

界面本身不含 pi。本机要先装好 pi 并配好模型供应商：

npm i -g @earendil-works/pi-coding-agent   # 需要 Node >= 22.19.0
pi --version

否则界面能打开，但发出去的消息会报错。

Pi GUI v0.26.0

本版摘要

• 桌面界面更新：整合 UI-1 至 UI-5，统一明暗主题、侧栏层级、聊天排版和输入区比例，改善不同窗口宽度及应用缩放下的布局。
• 对话阅读体验：调整长消息、代码块、思考过程和工具调用的展示，保留真实执行状态、错误和用量信息。
• 输入与模型选择：完善 Composer、附件、模型与 Thinking 选择及 Slash 命令菜单，保留中文输入保护和发送屏障。
• 右侧工作区与反馈：统一 Browser、Changes、Processes、审批、设置等界面的展示与操作反馈，保留原生浏览器及既有审批边界。
• 诊断与日志：增加持久化日志管理及故障排查入口，保留敏感信息脱敏、断线恢复和日志安全补丁。
• Windows 动画回归修复：视觉测试显式覆盖普通动画与 reduced-motion，避免 Runner 的系统默认值造成误报，两种模式的原始断言完整保留。

会话变更的生产恢复资格仍为 NO-GO，不开放 B Writer 或自动撤销，不放宽现有安全拒绝。采集仅覆盖接管的 write/edit，不能宣称完整归因。真实模型长时间压力测试、POSIX 真机、完整 Windows 中文输入法及多显示器 DPI 场景仍未完成验证；隔离自动测试不等于这些场景已通过。

What's Changed

• docs: 引入基于风险与证据的 Agent 代码审查约束 by @HYJ1817 in #4
• 修复 UI-2C 动画测试对 Windows 系统媒体偏好的依赖 by @HYJ1817 in #5

Full Changelog: v0.25.0...v0.26.0

---

交付物

文件	说明
Pi-GUI-Setup-<版本>.exe	安装程序（单用户，不弹 UAC）。装在 %LOCALAPPDATA%\Programs\Pi GUI
Pi-GUI-<版本>-portable.zip	便携版，解压直接跑 Pi GUI.exe，不用装
SHA256SUMS.txt	上面两个文件的 SHA-256 校验和

下载后建议核一下（把 <版本> 换成实际版本号）：

certutil -hashfile Pi-GUI-Setup-<版本>.exe SHA256

与 SHA256SUMS.txt 里的值逐位比对。

卸载只删程序文件 —— %APPDATA%\Pi GUI 下的项目列表与窗口布局会保留。

Code signing policy

本项目正在申请 SignPath Foundation 的免费 OSS 代码签名
（签名服务由 SignPath.io 提供）。申请尚未通过，正式发版流程也还
没有接入签名 —— 所以当前下载到的产物仍然可能是未签名的，Windows 可能因此提示
「未知发布者」。

签名正式启用后，覆盖的会是本项目自己构建的 Windows 安装程序；随包分发的
Electron / Chromium 等上游开源二进制不会用本证书签名。

• Code signing policy（签名范围、角色、审批流程）：CODE_SIGNING_POLICY.md
• Privacy policy（联不联网、传什么数据）：PRIVACY.md

前置条件

界面本身不含 pi。本机要先装好 pi 并配好模型供应商：

npm i -g @earendil-works/pi-coding-agent   # 需要 Node >= 22.19.0
pi --version

否则界面能打开，但发出去的消息会报错。

Pi GUI v0.25.0

本版摘要

• 恢复资格与风险说明：会话变更界面补充逐次确认、资格状态和异常恢复说明；生产原文件写回继续关闭，不提供可执行的自动撤销。
• 异常恢复材料只读查看：补充持久恢复状态与材料校验，区分历史材料读取和当前写入授权；不确定状态不会自动重试。
• 会话与工作区身份核验：加强运行代际、Worktree 和历史身份隔离；会话切换及运行时重建后拒绝旧计划。
• Windows 打包资源校验：固定内置 Native Helper 来源和 SHA-256，覆盖 Source、Electron 与 SEA 的隔离 TEMP 验证，防止项目同名脚本替换内置资源。
• 兼容性与诊断修复：补充 Pi 1.2 只读捕获资格，修正 SEA 可选依赖警告被误判为崩溃的问题，并增加真实进程重启回归。

生产恢复资格结论仍为 NO-GO，Q1/Q2/Q3 风险未获批准；本次发版不开放 B Writer，不放宽现有安全拒绝。采集仅覆盖接管的 write/edit，不能宣称完整归因。当前平台的普通/特权配对资格、修正后 Classic 真实模型完整复测、跨后端的新恢复契约仍待完成；隔离测试不等于正式可写产品资格。长时间并行压力测试与 POSIX 真机仍未验证。

Full Changelog: v0.24.0...v0.25.0

---

交付物

文件	说明
Pi-GUI-Setup-<版本>.exe	安装程序（单用户，不弹 UAC）。装在 %LOCALAPPDATA%\Programs\Pi GUI
Pi-GUI-<版本>-portable.zip	便携版，解压直接跑 Pi GUI.exe，不用装
SHA256SUMS.txt	上面两个文件的 SHA-256 校验和

下载后建议核一下（把 <版本> 换成实际版本号）：

certutil -hashfile Pi-GUI-Setup-<版本>.exe SHA256

与 SHA256SUMS.txt 里的值逐位比对。

卸载只删程序文件 —— %APPDATA%\Pi GUI 下的项目列表与窗口布局会保留。

Code signing policy

本项目正在申请 SignPath Foundation 的免费 OSS 代码签名
（签名服务由 SignPath.io 提供）。申请尚未通过，正式发版流程也还
没有接入签名 —— 所以当前下载到的产物仍然可能是未签名的，Windows 可能因此提示
「未知发布者」。

签名正式启用后，覆盖的会是本项目自己构建的 Windows 安装程序；随包分发的
Electron / Chromium 等上游开源二进制不会用本证书签名。

• Code signing policy（签名范围、角色、审批流程）：CODE_SIGNING_POLICY.md
• Privacy policy（联不联网、传什么数据）：PRIVACY.md

前置条件

界面本身不含 pi。本机要先装好 pi 并配好模型供应商：

npm i -g @earendil-works/pi-coding-agent   # 需要 Node >= 22.19.0
pi --version

否则界面能打开，但发出去的消息会报错。