pi Desktop: vanhemmat versiot ja versiohistoria

pi Desktop v0.7.7
修复
- 分屏会话：Windows 上从侧栏 Ctrl+点击，在旁边打开另一个会话时，原窗格不再被一起替换，左右窗格保持各自的会话
- 回复截断：长回复输出时切走再切回，不再只显示开头一部分；刷新历史时也会保留已经收到的完整内容（#130）
- 会话切换：消息、运行状态、模型与思考强度、排队消息等按会话分别保存，减少切换时内容和状态串到其他会话的问题；删除会话或草稿转为正式会话后，也会清理旧状态（#129）
- Windows MCP：启动命令不存在时明确提示缺失的命令，不再只显示连接关闭；修复可执行文件扩展名大小写导致的命令识别问题
- 依赖安全：更新 DOMPurify，修复已知安全问题（#131）
优化
- 代码高亮加载：语法和主题资源拆分为按需加载，不再全部打进同一个高亮资源包

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

pi Desktop v0.7.6
优化
- 上下文用量：输入框、运行面板和 Context 面板统一使用 pi SDK 返回的 token 用量与模型容量，不再按字符数估算已加载会话的占用；切换模型后会刷新容量，压缩后用量暂未确定时不再显示旧数字
修复
- Windows SDK 升级：设置里选择版本后点「升级并切换」没有反应、独立 SDK 始终安装不上；现在能正确启动系统 npm，安装失败后也可以重试（#125）
- 会话切换与新对话：切换会话后仍显示上一个会话的运行状态、发送被阻塞；创建新对话或运行中刷新历史时串入其他会话的内容；回到已回退的会话后丢失当前分支
- 完成通知：点击通知回到当前会话时，正在输出的回复不再停住；只读子会话点击「继续」也能正常退出预览状态
- 排队消息：已经处理的消息，切走再回来后不再重新显示为排队
- 思考强度：在新会话中调整强度不再误改后台运行中的会话；手动选择的强度不再被延迟返回的默认值覆盖
- 斜杠命令：恢复输入框的命令菜单，/compact 会真正压缩当前会话，而不是只显示完成提示
- 活动标题：Worker 退出后，活动列表里的会话标题仍能正确恢复
- WSL Git：打开 WSL 会话后能正确识别项目仓库，分支选择器正常列出分支
- 网页粘贴：从 GitHub 等网页复制日志到输入框时，不再插入多余空行

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

pi Desktop v0.7.5
新增
- 链接右键菜单与悬停预览：回复里的网页链接可以右键在外部浏览器打开或复制地址，鼠标停留片刻会弹出卡片，显示域名、网页标题、摘要和分享图；文件链接右键可以打开文件、在文件夹中显示或复制路径，悬停卡片显示文件名和完整路径。工作区内的文件在 Files 面板里预览并定位到引用的行，工作区外的文件用系统默认程序打开；Windows、WSL 路径以及带中文、空格的文件名都能识别
修复
- 冷启动后点开输入框的模型选择器，经常显示「无可用模型」：启动初期模型列表还没准备好时拿到的空结果不再被当成最终结果，会自动重试几次；等待期间显示「正在加载模型…」
- 新对话发送第一条消息时卡住不动（项目有未提交改动并开启 Dirty Repo Guard 时会多弹一次确认）；发送失败或取消后，已清空的输入和附件现在会恢复到输入框
- 从别的项目点进另一个项目的「新会话」，之前写好的草稿不显示，要再进一次才出现
- 新对话里删光文字后继续按退格，空行越删越多，后面输入的内容落到提示文字下方

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

pi Desktop v0.7.4
新增
- 我的 Chrome：Agent 可以直接操作你自己的 Chrome，用上你已有的登录状态和扩展。在「设置 → 浏览器」里加载 pi 扩展、粘贴配对码即可；Agent 的标签页开在单独的 pi 窗口里，不打扰你正在用的窗口，借用你已打开的标签页需要你确认，用完交还给你。遇到 Cloudflare 这类人机验证的网站，用自己的 Chrome 更容易通过。输入框工具菜单里可以三选一：关闭 / 内置浏览器 / 我的 Chrome；右侧浏览器面板会标明当前用的是哪个
- Agent 请你帮忙：遇到验证码、登录或需要你拍板的操作（付款、发帖、删除等），Agent 会在浏览器面板上方（用自己的 Chrome 时显示在输入框上方，并弹出 Chrome 通知）请你处理，你点「完成」或「允许 / 拒绝」后它接着做
- 站点笔记：Agent 在某个网站上摸索出的经验（比如某个按钮要先悬停才出现）会记下来，下次访问同一网站时自动带上；可在「设置 → 浏览器」查看和删除
- 浏览器新能力：能操作跨域 iframe 里的元素、看到一闪而过的提示消息、识别并应答页面弹窗（alert / confirm）；悬停才出现的菜单可以自动探测；整页截图、按截图坐标点击、下载文件、保存 PDF、模拟手机尺寸；查看网络请求和控制台；一次调用连续执行多步操作
优化
- 浏览器更省 token：长列表自动折叠成「… 还有 N 项」，操作后只返回页面变化的部分，文章可按纯文本读取。实测 Hacker News 首页的页面内容缩到原来的约 1/7，Wikipedia 长条目缩到约 1/3（纯文本模式约 1/4）；每次请求附带的浏览器工具说明从约 1600 token 降到约 1300。长会话里较早的页面状态不再反复发给模型（会话记录仍完整保留），超大页面可以整页存成文件再按需读取
- 工具调用折叠：折叠后的工具组只占一行，失败的调用以数量显示在这一行上，不再在下面列出好几行
- 扩展适配器：按常用扩展的当前版本重写：pi-goal-x 新增适配（目标的任务列表显示在输入框上方，设置页可改自主续跑、任务、审核模型等）；pi-cache-optimizer 的开关改为写入扩展真正读取的配置文件（之前只存在桌面本地、不生效）；pi-search 搜索模式改为当前的 auto / coding_docs 等，新增 API 协议、思考等级和 Context7 缓存时长；pi-image-gen 去掉已移除的审图开关；magic-context 覆盖全部 ctx_* 工具和命令；pi-subagents 可设置默认后台运行、子代理上下文和 worktree；/context 直接打开桌面 Context 面板；带参数的扩展命令（如 /image-gen generate …、/cache-optimizer status）不再被设置页拦截
- MCP 工具调用：时间线里显示为「服务器/工具 · 参数摘要」并带插头图标，不再是 mcp__服务器__工具 原名；展开可看调用参数和结果（JSON 自动格式化），输出过长被截断时给出完整输出文件并可直接打开；恢复旧会话、服务器未连接时也按同样方式显示
修复
- 新对话时打开底部终端，输入框会被顶到标题上面：现在输入框按聊天区居中
- 长回复进行中切换会话，回来后自己发的消息不见了；向上加载历史时正在输出的消息丢失；切换会话后残留上一个会话的历史
- 从托盘图标或系统通知无法恢复已最小化 / 隐藏的主窗口
- 回复里指向本地 Markdown 文件的链接现在在工作区预览中打开；引用来源可以点开，并高亮对应的行
- 「活动」里跨项目的会话标题显示不对、点了跳不过去
注意
- 「我的 Chrome」需要在 Chrome 里手动加载 pi 扩展（设置页有「打开扩展文件夹」按钮），开启后 Chrome 顶部会显示「正在调试此浏览器」，这是正常的

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

pi Desktop v0.7.3
新增
- 内置终端：按 Ctrl+`（或点状态栏右下角的终端图标）从聊天区下方拉出终端，可拖动调整高度；支持多标签，每个标签最多左右并排 4 栏，分隔线可拖动调宽，分栏时可用每栏的 ✕ 或 Ctrl+Shift+W（macOS 为 ⌘W）单独关闭一栏；收起后进程和输出都还在，已退出的终端按 Enter 原地重启。默认使用 pi 执行命令时用的同一个外壳（Windows 上为 Git Bash），PATH 里带上 pi 自带的工具；也可以从「+」菜单选择 PowerShell 7、Windows PowerShell、命令提示符、各个 WSL 发行版，或 zsh、fish 等。GPU 渲染、配色跟随主题，中文和 emoji 对齐；Ctrl+Shift+C / V 复制粘贴，有选区时 Ctrl+C 也是复制，Ctrl+Shift+F 查找，链接可点击；粘贴图片会存成文件并输入路径；选中的输出可以一键放进输入框。还有终端在运行时关闭窗口会先确认
- 用量页：「设置 → 用量」统计本机所有 pi 会话的 token 与费用（终端 pi 的会话和自定义 sessionDir 也算在内，复制进分叉会话的回复只计一次），可选今天、7 天、30 天、90 天、一年或全部：总费用、token、请求数、缓存命中率、日均与单次平均、有使用的天数、费用最高的一天；按天的输入 / 缓存 / 输出堆叠柱状图（悬停可看每一层的占比，图例可开关），日历热力图和按星期 × 小时的热力图，以及按模型、按项目、费用最高的会话排行，点击会话可直接打开。费用按模型条目里设置的价格计算
- 手机在外网也能连：电脑和手机加入同一个 Tailscale、ZeroTier 或 WireGuard 网络后，离开家里或办公室的局域网也能连接。二维码会带上组网地址（包括 macOS 上的 Tailscale）和 Tailscale 的 *.ts.net 域名；手机的主机列表可以手动添加地址；「设置 → 手机连接」会标注每个地址是局域网还是组网
- 手机查看改动：会话面板的「改动」查看整个工作区相对上次提交的改动，点回复下方的文件可查看本轮对它的改动；diff 带行号和增删底色。长按某一行开始选择，点其他行扩大范围后写批注，可以写多条，最后一起放进输入框，不会自动发送
- 手机端分支与分叉：会话面板的「分支」列出回退或改写后留下的各个分支（最后的提问和回复、轮数、从哪里分出），点一下就能切换；长按自己的消息选择「从这里分叉」，会在新会话里接着这条之前的内容继续
- 手机会话费用：会话面板显示本会话的累计费用和请求数
- 分支切换：状态栏左侧显示当前项目的分支、未提交改动和领先 / 落后数；点开可以搜索本地和远端分支、切换或新建分支（命令面板里也有「切换分支…」）。改动能带过去时直接带到新分支；会被覆盖时可以先暂存，回到原分支时提示恢复。项目里有会话在运行时会先确认
- 主题重做：外观设置改为预设卡片，新增内置 Claude 主题（浅色暖米白、深色暖炭灰，标题和回复用衬线体）。可单独设置侧栏、聊天区、你的消息、代码块、边框的颜色，标题 / 回复字体，聊天字号和行高，圆角和阴影；这些都是 CSS 变量，自定义 CSS 旁边列出了可用变量。主题字符串会带上这些新设置
- 背景图：「设置 → 外观 → 背景图」可以在窗口后面放一张图片，浅色深色分开或共用。图片可调强度、模糊、亮度、饱和度和暗角，以及适配方式；面板可选磨砂、液态玻璃或通透三种材质，并调整不透明度和模糊。默认聊天区和右侧栏几乎不透明，打开「透出整个界面」后背景会透过所有面板；还可以单独调整聊天区和右侧栏的不透明度、材质和模糊。菜单、弹窗和代码块始终保持不透明
- 手机 App 语言：默认英文、跟随系统语言，菜单里可以单独选「跟随系统 / English / 简体中文」；Android 13 及以上与系统的「应用语言」设置同步
优化
- 手机 App 发布：APK 改为在 CI 中构建并正式签名，安装包 pi-remote-0.7.3-android-arm64.apk 与桌面安装包一起附在本版 Release 中，并列入 SHA256SUMS
- README：重新整理，补充内置终端、分支、用量、主题与背景图、手机 App 的演示
修复
- CI：Windows 检出时，行尾差异不再导致构建产物检查失败；分栏的端到端测试与当前布局一致；Node 25 及以上版本可直接运行单元测试
- 依赖安全：升级了一批有安全修复的依赖
- 手机会话面板刚配对后偶尔为空：现在会等连接就绪并自动重试
- 手机端展开待办列表时会把对话往上推：现在列表浮在对话上层，按返回键可收起
注意
- 手机 App 需要卸载重装：手机 App 从调试签名改为正式签名，从 0.7.1 升级时需要先卸载旧版再安装新版，然后重新扫码配对；以后的版本可以直接覆盖升级
- 手机 App 和桌面端请同时升级到 0.7.3，查看改动、分支与分叉、会话费用等新功能需要两端版本一致
- 在外网使用需要两端都装好并登录同一个组网工具；pi 不提供中继服务器，也不支持直接连公网地址

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

pi Desktop v0.7.1
新增
- 手机远程控制（pi Remote，Android）：在「设置 → 手机连接」打开后，用手机 App 扫码配对，即可在同一局域网内查看和继续驱动电脑上的会话。连接全程端到端加密，不经过任何服务器；可给设备设为「可操作」或「只读」，随时解绑。安装包 pi-remote-0.7.1-android-arm64.apk 附在本版 Release 中
- 手机端会话：会话列表可按状态或项目分组，最近的会话分为今天、昨天、本周、更早；临时对话单独归为一组。时间线与桌面一致：思维链可展开、工具调用和文件改动、Markdown 与代码高亮、公式（原生排版，与桌面支持的写法相同）、Mermaid、pi-ui 图表，右侧刻度可拖动跳转
- 手机端输入：切换模型和思考等级（滑块），按会话开关工具与能力；可拍照、选图或选文件作为附件，也能从其他 App 分享内容进来；运行中发送即 steer，长按发送键排队 follow-up
- / 命令与 @ 文件：/ 按键打开命令面板（应用 · 提示词 · 扩展命令，Skills 单独折叠），行首输入 / 时自动联想，选中后只插入不发送；@ 按键打开当前项目的文件浮窗，支持逐级浏览、搜索、多选，插入为 @路径
- 手机端中断与回退：停止时排队中的消息自动放回输入框，也可以只撤回队列；长按消息可「回退到这条之前」，该轮及之后移出当前分支，原消息放回输入框，电脑端会同步刷新
- 会话面板：在对话页向左滑出侧面板，显示运行状态、上下文占用（按系统 / 用户 / 助手 / 工具分段）、轮次、工具调用、文件改动、待办和排队
- 提问与通知：扩展提问在手机上可直接作答（多题导航、单选自动下一题、稍后作答）；任务完成、失败或需要回答时发通知，点开直接进入该会话
- 其他：深色 / 浅色 / 跟随系统主题；已配对设备换了网络地址也能自动重连，无需重新扫码
修复
- 新建对话：新对话草稿正确显示保存的默认模型；新建后的第一条消息始终发到刚创建的会话
- 时间线：手动刷新后丢弃已结束的实时缓存；重试成功的回复不再显示「未完成」提示
注意
- 手机 App 目前只提供 Android（arm64）版本，使用调试签名，安装时系统可能提示来源未知；需要电脑和手机在同一局域网，Windows 首次使用需在防火墙中允许 pi Desktop 访问专用网络
- 手机和电脑需同时升级到本版，旧版 App 与新版桌面端的协议不兼容
- 本版通过 Linux 自动化检查与 Android 模拟器验证；真机和 Windows / macOS 实机检查未完成

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。
手机 App
pi-remote-0.7.1-android-arm64.apk SHA-256: 73a672e8a42fcb01cdf22406be42aa47086be4d3d893b332c7648eb84f87a44c

pi Desktop v0.7.0
新增
- pi 1.0 内核：内置 pi 升级到 1.0.2。桌面会话现在也能用上 pi 的 codemode、工具搜索和 MCP（之前 SDK 会话不会加载它们）
- MCP 设置页：添加、编辑、删除 MCP 服务器，支持从 Claude Desktop / Cursor / VS Code 的配置直接粘贴导入；可设置暴露方式（codemode / 按需加载 / 直接 / 隐藏）、全局或仅本项目启停；一键检查连接状态（工具数、错误原因），HTTP 服务器可在设置里完成 OAuth 登录和退出
- 模型编排：在「设置 → 模型编排」用画布搭建虚拟模型 router/<id>：可选分类模型（如 TypeSafe Jev）把会话分到不同分支，每个分支指定模型和思考等级；另有默认分支、「首次编辑后切到更便宜的模型」、「失败时换模型重试」。画布上方用一句话说明当前路由逻辑，未选模型的节点会直接标出
- 会话分栏：像 tmux 一样把多个会话放在一起看，最多 4 个：左右、上下、主窗格加侧栏、四宫格都可以。Ctrl+\ 向右拆、Ctrl+Shift+\ 向下拆，Ctrl+Alt+方向键在窗格间移动；拖分隔线会在 1/3、1/2、2/3 处吸附并显示比例；把会话拖到窗格边缘会预览新窗格的位置，拖窗格标题到另一个窗格中间可交换位置；较小的窗格显示状态卡片（运行状态、最后的问题和回复），太窄时自动切成标签
- 时间线刻度：对话右侧的刻度标出你的每条消息，悬停预览、点击或拖动跳转，Alt+↑/↓ 逐条切换；当前位置按你正在读的消息高亮
- 按轮次折叠历史：长对话默认只显示最近 10 轮（你的消息及其回复），向上滚动再加载；轮数可在「设置 → 外观」调整
- 内置浏览器（实验）：在「设置 → 右侧面板」打开「浏览器」栏目后，可在右侧栏浏览网页：多标签、地址栏（网址或搜索）、地址建议与历史、后退 / 前进 / 刷新、页内查找（Ctrl/⌘+F）、缩放、固定视口尺寸，还能展开到聊天区；登录状态保存在独立的浏览器配置里，可一键清除。下载可用 aria2 多线程（可选），工具栏有下载列表
- AI 操作浏览器：在「工具」菜单开启「浏览器操控」后，AI 可以读取和操作内置浏览器。工具与 Playwright MCP 一致（共 21 个：点击、输入、填表、拖拽、上传、滚动、查找、截图、存 PDF 等）；页面快照沿用 Playwright 格式，每次操作只返回变化部分；所有点击和键盘都是真实输入。默认只常驻 6 个常用工具，其余由 AI 按需加载，省 token
- 把网页交给 AI / 网页批注：浏览器工具栏可把截图、页面正文、选中文字、控制台和网络错误放进输入框；批注模式（Ctrl/⌘+Shift+A）下点选元素或框选区域写评论，完成后把带编号的截图和元素信息插入输入框，本地开发页面会附上组件名和源码位置
- 「工具」菜单：按会话开关附加能力（pi-ui 可视化、浏览器操控），新会话默认全部关闭，菜单标出每项每次请求增加的 token；底部是「缓存保活」快捷开关（关闭 / 运行时 / 空闲也保活）
- 运行时设置：新增「工具」区（默认启用哪些内置工具、codemode、工具搜索）、思考预算、按模型单独设置压缩预算
- 模型条目：分组为基本、能力、价格（输入 / 输出 / 缓存读取 / 缓存写入，美元每百万 token）、提示词缓存（缓存寿命、是否接受对话中途的系统消息）和高级（采样参数及按思考等级覆盖、图片输入上限、OpenAI 兼容接口的兼容项）
- 输入框改版：模型和思考等级改为向上展开的菜单，思考等级改成滑块，等级名在各语言下都用英文；todo 贴在输入框顶部；上下文用量改成发送按钮旁的小圆环
- 状态栏内存：右下角显示应用当前占用的内存
优化
- 能力开关不再打断缓存：开关能力时，对支持「对话中途系统消息」的模型只在对话后面追加一条更新，已缓存的提示词前缀保持不变
- 设置页：页面底色与卡片分层更清楚，次要文字和边框加深一档，统一输入框和分段选择样式；删掉设置项下方的英文键名、终端专用选项和重复说明，文案更短
- 模型页：内置供应商改为紧凑列表，已登录的排在前面；模型折叠时一行显示能力、上下文和价格
- 右侧栏：默认收起，可在设置里选择收起时保留图标栏
- 侧栏：项目标题旁的加号用来打开文件夹，原刷新按钮合并到右上角
- 其他：标签栏支持滚轮横向滚动，中键关闭标签；批注模式滚动更顺滑；工具调用按规则折叠；会话树改为分段筛选；深色模式下各分段选择的选中状态更清楚
修复
- token 估算：能力增加的 token 数计入工具定义，与实际请求一致
- 时间线刻度：从磁盘打开的旧会话也能正确跟随阅读位置；滚到底部时高亮最后一条
- 分栏：窗格始终铺满中间区域
- 内置浏览器：中键不再把剪贴板内容粘进地址栏；切换标签时地址栏草稿复位
- 界面：几处提示文字因缺少颜色定义显示为纯黑的问题
注意
- MCP、codemode、工具搜索和模型编排需要 pi 0.99 及以上（内置版本为 1.0.2）；WSL 运行模式暂不支持 MCP 管理
- 「浏览器操控」需先在「设置 → 右侧面板」开启「浏览器」栏目
- 「开关不打断缓存」取决于模型是否支持对话中途的系统消息；内置目录里的 Anthropic、OpenAI、GitHub Copilot 等多数模型支持，自定义模型可在模型条目的「提示词缓存」里开启
- 本版通过 Linux 自动化检查与真实 Electron 验证；Windows / macOS 实机检查未完成

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

pi Desktop v0.6.2
新增
- Mermaid 图表：回复中的 mermaid 代码块渲染为流程图、时序图等图表，颜色跟随浅色 / 深色主题；生成过程中先显示源码，语法有误时显示源码和错误原因，也可随时切换查看源码
- 扩展提问对话框：顶部题目导航显示作答状态并可直接跳题；单选后自动进入下一题，最后一题不会误触即提交；「其他」作为独立选项填写自定义答案；支持数字键选择、Enter 下一题或提交；「稍后作答」再继续时保留已填内容
修复
- LaTeX 公式：\[ … \] 与 \( … \) 写法的公式正常渲染，不再显示成方括号加公式源码
- 默认界面语言：首次启动按系统语言选择，非中文环境默认英文；已有用户的语言设置保持不变
- 英文界面残留中文：会话树、分叉对话框、行引用按钮、扩展对话框、MCP 与技能面板、工具卡片及内置适配器说明均已本地化
- 工具输出颜色码：会话树与 Context 预览不再显示 ANSI 颜色控制字符
- 连续提问串状态：扩展连续发起提问或输入请求时，新对话框不再带上一次的选择和输入
- 依赖安全：更新 Electron、HTML 清理及网络请求等依赖的安全修复版本，Pi SDK 版本保持不变
- 字体依赖：直接使用仓库内的字体和许可文件，移除多余字体包及其间接引入的 Next.js
- 发布检查：正式发布前执行依赖安全审计，严重漏洞或审计失败时不创建 Release
优化
- 扩展对话框：选择、确认、输入对话框支持键盘操作和自动聚焦，确认内容改为正文字号显示
- README：新增功能总览图、架构图和更多真实应用录屏，中英文同步
注意
- Mermaid 首次出现时按需加载，之后的图表即时显示
- 本版通过 Linux 自动化检查与真实 Electron 验证；Windows / macOS 实机检查未完成

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

pi Desktop v0.6.0
新增
- 结构化回复：支持图表、表格、指标、卡片、代码差异、决策树、测验和甘特图，可直接在对话中查看和交互
- 按项目覆盖适配器：内置、用户与项目适配器分层加载，支持不绑定插件的只读面板；项目切换时不会混入旧项目结果
- 模型思考等级：按模型能力绑定思考等级，支持 max
修复
- #100 返回设置后模型显示错误：按当前会话读取实际模型，并保留该会话已确认的模型信息，不再误显示全局默认模型
- #99 后台会话完成后显示旧内容：切回已完成会话时刷新历史，正确合并实时内容，保持工具结果和最终回复顺序，无需手动刷新
- #97 Intel Mac 下载错误安装包：应用内更新按处理器架构选择安装包，Intel 与 Apple Silicon 不再混用
- #94 删除会话后输入框偶发失去焦点：删除确认改为应用内对话框，避免 Windows 原生确认弹窗导致后续键盘输入失效
- #46 查看历史误触回退：会话树单击只定位对应消息，双击或明确操作才回退，查看与修改分开
- 会话身份错位：加载失败或被扩展取消时保留原会话；分叉、克隆等待期间切换会话，不会把结果分配给新选中的会话
- 会话删除与并发请求：删除已绑定会话后清理旧身份；删除离线会话不启动 Agent；同一冷会话的并发请求只创建一个 Worker
- 文件范围检查：拒绝跨盘、跨共享和经符号链接访问工作区外文件，保留合法预览、UTF-8 截断与图片大小限制
- 预览进程故障：进程终止时结束其全部待处理请求；无响应 Worker 的停止请求使用短等待期限
- Git 暂存与工作副本刷新：差异块异步写入，同一索引的操作按顺序执行；监听工作副本真实元数据目录
- WSL 模型隔离：WSL 预览失败时不会回退到宿主模型与认证信息
- 干净检出的测试：结构化回复测试样例随仓库提交，不再依赖本机未跟踪的文档
优化
- 启动与会话切换：延后 SDK 预热，独立进程读取模型和历史；会话列表增量读取，流式事件合并发送
- WSL 启动准备：代码同步、SDK 探测和会话列表异步处理，共用文件按发行版顺序写入
- 大型目录：目录先排序截断，再读取最多 2500 项元信息，减少主线程同步文件操作
- 设置与文档：调整模型、运行时设置和 Review 界面，更新双语 README、真实截图与一键截图流程
注意
- Review 已移除生成提交信息的入口
- 从 0.5.8 或更早版本升级的 Intel Mac 用户，请手动下载 x64 安装包；旧版本的应用内下载选择逻辑仍可能误选 arm64
- 本版仍不开放远程客户端或手机配对；子 Agent 详细视图依赖对应插件适配器提供进度与会话信息
- 本轮后端收尾通过 Linux 自动化检查与真实 Electron 验证；Windows/WSL 实机检查未完成，不代表跨平台完全验收
- WSL 下 pi-rewind 的跨盘 Git 快照耗时未在本轮处理；停止仍可能等待已在进行的启动任务

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

pi Desktop v0.5.8
新增
- 工作台状态底栏与通知收件箱：底部显示在跑会话、内存和更新；完成通知可回看，支持未读加粗与快捷聚焦最新通知
- 会话四态与子会话树：侧栏用工作中 / 等你 / 已完成 / 空闲区分会话，并按 Pi 父子关系折叠显示子会话
- 工作副本分组：已有 git 工作副本按仓库分组显示，便于从侧栏继续对应会话
- Files 预览与行评打回：大文件可先看前缀再按需加载；Git 中文路径正确解码；Review 行评可发给当前会话
- 设置搜索与快捷键：设置页可搜索分类；完成通知支持独立快捷键
修复
- 设置页无法打开：中英文设置文案缺逗号导致类型检查和前端启动失败
- 后台扩展问答清不掉：后台会话超时或取消后，弹窗和等待状态会正确关闭，不再挡住前台
- 跨项目继续会话错位：从侧栏右键继续其他项目的会话时，会同时切到该项目，Files 与 Git 不再留在旧项目
- 文件夹内搜索整树为空：在文件夹中搜索不再把祖先目录滤掉
- 新建文件点了没反应：Electron 不支持系统 prompt，已改为应用内对话框，并阻止经符号链接写出工作区
- 新会话 Review 发到旧对话：点了新会话后再发送行评，会先创建真实会话，而不是打到前台旧 Worker
- 已完成会话点开仍加粗：打开会话后清除未读完成标记
- 设置高级项打不开：会话进程高级设置的展开按钮不再被空分区样式藏掉
- 大文件与 HTML 预览：超限文本返回前缀而不是直接拒绝；完整 HTML 才允许脚本，且不同源隔离
优化
- 侧栏项目身份：Git 工作副本与最近项目按真实目录过滤，避免把已删除或可清理的检出算进当前仓库
- 语音按住说话：按住录音时不会叠两个麦克风流
注意
- 手机配对入口仍未开放，本版不包含遥控客户端
- 工作副本只识别本机已有 git 检出，不会自动创建隔离目录

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

pi Desktop v0.5.7
新增
- WSL 原生运行时：支持在指定 WSL 发行版内启动 Pi Worker、读取会话与资源并执行 Git / Preview；设置页可探测、切换和诊断发行版，Host / WSL 切换时会安全停止旧运行时
- 子 Agent 运行可视化：Composer、Timeline 与侧栏展示子 Agent 的运行进度、预览与结果，支持从父会话只读定位子会话，同时保持后台会话继续运行
- 侧栏项目固定顺序：可选择固定项目排列；默认仍保留最近使用顺序
修复
- #48 冷启动与首次点击卡顿：会话列表、历史消息和会话树解析移至独立 Preview utility process，Review Git 快照改为异步；大历史会话与大仓库加载不再阻塞 Electron Main
- #51 /skill 正文污染消息：模型仍接收完整 Skill 上下文，但 Timeline、历史、排队与输入恢复只显示原始 /skill:name 命令；Skill 读取改为“载入 Skill 上下文”语义，不再伪装成普通文件工具
- #82 内层滚轮被外层抢走：代码块、Markdown 代码、思考内容及 Context 展开消息拥有独立滚动边界，鼠标滚轮不再带动外层 Timeline / 面板
- #41 更新检查与系统代理：手动检查明确区分“有更新 / 已是最新 / 检查失败”，更新包下载统一使用 Electron 网络栈，遵循系统代理与 PAC
- #40 模型设置与当前 Pi SDK 不一致：默认模型和 Composer 只显示用户配置或已登录可用模型；用户供应商与 Pi SDK 只读目录分层展示，避免混淆
- 无 Worker 时设置无法保存：冷启动后未打开会话也可保存 Pi 默认模型和全局设置；Host、global / user SDK 与 WSL 均使用 SDK SettingsManager 的合并和锁语义
- 系统提示词预览误启动 Worker：Worker 未启动时改由隔离的 Preview utility 在内存中组装最终提示词；不占用 Session Worker 池，不创建会话、认证或模型文件，也不执行扩展、安装 package 或发起模型网络请求
- 多 Worker Extension UI 串话：问答弹窗按请求来源路由响应与取消；后台 Worker 不再覆盖前台弹窗，无法展示的后台交互会立即取消而非永久等待，Worker 退出和会话切换会清理悬挂请求
- 会话状态隔离：瞬时 Worker 状态查询失败不再误判 idle；切换会话、Home 或新会话时清除旧运行快照，停止按钮和运行标记不再跨会话复活
- 会话树旧数据回填：打开或切空会话时刷新请求代际，迟到的旧会话树不会覆盖当前视图
- 长输入光标不可见：Composer 超过最大高度后保持 caret 可见，并消除 MutationObserver / caret probe 的反馈循环
- 小窗口布局覆盖用户偏好：窄窗仅临时压缩左右面板，放大后恢复持久化宽度
优化
- 模型列表即时打开：应用启动后预热共享可用模型缓存；Composer、/model 与默认模型下拉立即显示缓存并后台刷新，失败时保留旧选项
- 大型会话列表性能：读取会话标题和工作区信息时只扫描 JSONL 头部，不再加载整个 transcript
- 项目切换体验：按工作区缓存会话列表，减少切换时清空、闪烁与排序跳动；新建或 Fork 后优先使用实时列表
- SDK 安装与切换安全性：user SDK 使用独立 generation 路径避免 ESM 旧模块缓存；验证失败可回滚到原 user generation，并同步刷新 Preview 与模型目录
注意
- WSL 模式需要目标发行版内可用的 Node.js 与 Pi SDK；切换发行版后会重启相关 Worker / Preview 进程
- “用户配置的供应商”仍只写 ~/.pi/agent/models.json；“当前 Pi SDK 供应商”是脱敏只读目录，不会回写 auth.json 或 models-store.json

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

pi Desktop v0.5.6
修复
- 模型管理页显示未登录模型：修复 0.5.5 将 Pi 支持的完整内置目录全部列出的问题；现在只显示 models.json 中用户明确配置的模型，以及当前 Pi SDK 明确认定为可用的模型
- 重复模型显示：用户配置与 SDK 可用列表存在同一 provider / model 时只显示一次，并以用户配置为准
优化
- 模型来源语义对齐：模型管理页现在与 Composer 一样使用 Pi 的可用模型判断，不再把目录缓存误当作登录状态
- 配置与缓存继续隔离：SDK 可用模型只作为展示和添加候选，保存时仍只写用户编辑的 models.json
注意
- models-store.json 是 Pi SDK 管理的动态目录缓存，不等同于登录状态；Desktop 不会直接编辑或按文件是否存在判断模型可用性
- models.json 中显式配置的 provider 与模型仍会全部显示，即使它们当前未登录

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

pi Desktop v0.5.5
修复
- #40 模型目录与 Pi CLI 不一致：设置页现在通过当前 Pi SDK 读取完整模型目录；即使 models.json 不存在、模型只保存在 models-store.json，或配置文件只有 overrides，供应商与模型仍会正常显示，无需复制或重命名文件
- 模型配置保存丢失高级字段：编辑基础字段后，不再删除 Pi 支持的 oauth、headers、compat、cost、modelOverrides，以及 thinkingLevelMap 中明确设置的 null；未来 SDK 新增且校验通过的字段也会原样保留
- 模型配置写入与重载诊断：损坏的原配置不会被草稿覆盖，非法配置不会落盘；写入成功但运行中的 Worker 重载失败时会单独报告，避免把部分成功误报为完整成功
优化
- Pi 0.83 运行时兼容：内置 @earendil-works/pi-coding-agent 升级至 0.83.0，模型切换、可用模型目录与配置重载统一使用 Pi 的 ModelRuntime，修复使用新版全局 / 用户 SDK 时的模型列表与刷新异常
- 模型目录与用户配置分离：设置页可浏览 SDK 完整目录，但只保存用户实际编辑的 models.json；缓存目录不会被反写进配置，重复模型也会自动去重
- 模型配置安全性：保存继续由 Main 进程负责 SDK 校验、同目录临时文件与原子替换；API key 不会出现在错误提示或测试快照中
注意
- 设置页中的 catalog-only 供应商和模型默认只读；需要自定义时请先添加供应商或把模型加入用户配置
- 模型管理页展示完整目录，Composer 仍只显示 Pi SDK 明确认定为可用的模型，两处列表用途不同

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

pi Desktop v0.5.4
修复
- 模型配置与 SDK 环境切换：供应商配置恢复可保存，并兼容当前与旧版 Pi SDK 的校验接口；独立 / 全局 SDK 切换会等待 Main 与 Worker 确认，失败时明确提示并回滚，不再出现假成功或无效操作
- 模型目录与当前会话模型：设置页从 active SDK 读取完整模型目录，Composer 只展示已登录或已配置的可用模型；当前会话切换以 Worker 实际状态为准，包含 / 的模型 ID 与新会话首条消息也能使用正确模型
- 设置页清空 Composer 草稿：打开设置再返回后，未发送文字与附件顺序仍保留；草稿按会话隔离，发送或手动清空后不会错误恢复
- 历史查看误报回退：单击历史节点只查看，双击、Enter 或明确按钮才执行回退；查看、回退和 Fork 不再混淆
- 启动语言与设置页文案：补强首屏语言恢复回归门禁，确保已保存语言仍在 React 挂载前生效；移除设置页标题前多余圆点和重复标题
- Windows 系统托盘：恢复 Tray 图标，支持左键显示并聚焦窗口，右键显示 / 隐藏窗口或退出应用
优化
- macOS 双架构安装包：Release 同时构建 Intel x64 与 Apple Silicon arm64 的 DMG / ZIP
- 模型选择可信度：无法确认当前鉴权状态时不再用完整模型目录冒充可用列表，避免选到未登录 Provider
- 发布门禁：修正 IPC schema、UI store 持久化与平台相关测试契约，并拆分过大的 UI store 壳状态，确保类型检查、单元测试、脚本契约与构建通过
- README 赞助入口：中英文 README 增加项目赞助二维码
注意
- 设置页的模型目录用于浏览和配置，可包含尚未登录的 Provider；Composer 模型选择器只显示 Pi SDK 明确认定为可用的模型
- macOS unsigned 构建仍可能被 Gatekeeper 拦截；签名与公证取决于 Release 环境是否配置 Apple 凭据

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

pi Desktop v0.5.3
修复
- 会话切换后 Composer 模型与上下文不刷新：切换 session 后立即把目标 session 绑定到 Worker，输入框显示的模型和上下文统计随当前会话更新，不再显示上一个会话的状态
- 对话前选的模型被默认设置覆盖：新会话建立时会同步 UI 中已选择的模型和思考等级，不再回退为设置页默认值
- 思考时长越用越大：assistant 流结束时记录真实 thinking 耗时，完成后显示固定秒数，每次打开应用不再继续累加
- Worker 未启动时无法切换模型/思考等级：未打开项目时选择模型或 thinking level 不再报 Worker not started 错误，选择会在开始会话后生效
- 右侧面板被拖到无法展开：本地持久化的右侧布局状态默认重置，避免宽度被拖到 0 后无法恢复
新增
- 右侧边栏支持拉满主对话区：带鱼屏用户可将右侧面板拖到更宽，方便查看文件、Review 与 Run 面板内容
- 仓库添加 MIT LICENSE：根目录加入 MIT 许可证文件，明确项目授权
优化
- 右侧面板拖拽保留安全间距：右栏拉到最大时与左侧边栏保留 120px 间距，避免拖拽手柄被完全盖住无法恢复
- 检查更新改为非阻塞并行：启动后后台检查 GitHub Release，结果通过 IPC 事件推送，不阻塞主窗口加载
- 设置页增加 GitHub 主页按钮：一键访问项目仓库

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

pi Desktop v0.5.2
新增
- 自定义浅色 / 深色主题：可分别配置两套主题，支持内置预设、手动调整主色、背景、文字、对比度与界面字体，并随系统主题自动切换
- 主题导入与导出：支持复制和导入 pi-theme-v1 字符串，也兼容 codex-theme-v1；导入前会展示预览与不支持字段数量，确认后一次性应用
- 高级自定义 CSS：可在外观设置中独立启用、停用或清空 CSS 覆盖，不影响结构化主题配置
优化
- 设置页信息架构：导航按应用、Agent 与资源重新分组，统一页面标题、表单控件、按钮、图标与字体层级，减少视觉噪声
- 主题启动体验：主题与自定义 CSS 在首帧前恢复，降低启动闪烁；浅色与深色配置互不覆盖
- 差异与状态颜色：Review 与 Timeline 共用语义化增删色，在默认主题和自定义主题下保持一致
注意
- 代码高亮仍由 Shiki 主题控制，不会跟随自定义界面主题；导入时会忽略 codeThemeId 和 semanticColors.skill 等暂不支持字段
- 若错误的自定义 CSS 导致界面不可用，可使用 --disable-custom-theme 启动应用，再进入设置修正或清空配置

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

pi Desktop v0.5.1
修复
- 流式输出时切换会话丢失刚发的消息：切出再切回后，最后一条已发送的用户消息不再消失。合并链路不再丢弃尚未落盘的乐观消息行，已流出的部分回答文本同样保留
- 会话结束后状态残留：流式中切走再切回、本轮在前台结束后，过期的「运行中」缓存不再复活——不再出现运行角标误亮、发送被误路由到 steering 队列导致消息无响应、以及发送后乐观显示缺失的问题

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

pi Desktop v0.5.0
新增
- #31 Composer @ 项目文件搜索：在消息开头或空白后输入 @，即可模糊搜索当前项目文件和目录；支持键盘、鼠标、目录继续补全、hidden 文件、.gitignore、symlink，以及空格 / Unicode / Windows 路径
修复
- 模型设置页国际化失效：模型供应商页面的标题、按钮、提示和校验信息恢复中英文翻译，不再直接显示 i18n key
- Global / User SDK 模型配置崩溃：模型配置校验与可用模型读取同时兼容内置 SDK 0.80.7 和新版 ModelRuntime API，不再出现读取 .create 的异常
- 聊天框模型选择被默认设置覆盖：设置页默认模型仅用于新会话，保存设置不再切换当前会话已选择的模型
- #30 模型配置保存后仍提示未保存：保存成功后会同步清除设置页脏状态；保存失败仍保留未保存提示
- #32 手动检查更新无法读取 GitHub Releases：更新请求改用 Electron Chromium 网络栈，兼容系统代理和 PAC；保留 token、超时及 latest 404 fallback 行为
- #33 macOS 提示应用已损坏：Apple 凭据齐全时自动签名、公证并执行 Gatekeeper 验证；凭据缺失时仍发布 unsigned DMG / ZIP，不再阻塞整次 Release
- 中文输入法 Enter 误发送：IME 组词期间的 Enter 不再触发补全或发送
- 流式 Markdown 表格延迟成型：流式尾部出现表格等块级语法时改用 Markdown 渲染
- 思考内容滚动串联：展开的思考内容拥有独立滚动区，鼠标滚轮不再带动整条 Timeline
- 窄窗启动后输入框高度异常：Composer 会在窗口、侧栏或中心列宽度变化后重新测量内容高度；程序化填充、清空和历史恢复也会自动复位，不再保留窄窗下的异常多行高度
优化
- 对话区宽度与思考可读性：侧栏收起后对话区按中心列自适应放宽；思考正文提升字号、行高和对比度
- 文件引用兼容性：项目文件以现有附件 chip 展示，发送保持 @path；含空格路径使用引号，避免引用被截断
注意
- macOS 构建若未配置 Apple Developer ID 与公证凭据，下载到的 unsigned 版本仍可能被 Gatekeeper 拦截；需要签名版本时请等待带签名资产或手动移除 quarantine

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

pi Desktop v0.4.20
修复
- #24 关闭扩展按钮无效：扩展启停规则改为以 Pi settings 资源根为基准，正确写入 -extensions/...，与 pi-coding-agent 的资源加载路径保持一致
- #25 macOS GUI 环境变量不完整：Finder / Dock 启动时同步 login shell 环境，provider key、代理及工具链变量会传递给 Worker 和后续子进程；保留启动器显式变量并过滤 Electron 控制变量
- #26 启动首屏语言错误：首次 React 渲染前恢复已保存语言，不再需要进入设置页后才切回中文；同时同步 HTML 文档语言
优化
- Pi 运行时兼容性：内置 @earendil-works/pi-coding-agent 更新至 0.80.7
- 主进程测试门禁：Vitest 纳入 src/main 单元测试，并补充扩展路径、login shell 环境与启动语言回归用例

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

pi Desktop v0.4.19
修复
- #19 历史会话模型被静默换成 Claude：会话保存的模型无法恢复时，SDK 会 fallback；现将 modelFallbackMessage 以 toast 明确提示，不再只写 Worker 日志
- 绑定后 Composer 模型展示：Worker 已绑定当前会话时，以 runtime 模型为准，JSONL / lastModel 不再盖住真实发送模型

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

pi Desktop v0.4.18
新增
- 软件内更新提醒与一键升级：启动后后台检查 GitHub Releases（不阻塞 UI；失败静默）；有更新时弹窗展示 Release 更新说明，支持 本次忽略 / 忽略本版本 / 更新（下载安装包并自动启动安装程序）
- Release 正文生成：CI 从 CHANGELOG 生成用户可读 Release body，禁止仅放 CHANGELOG 链接占位；应用内公告即该正文
- 侧栏代码预览高亮：内置更多语言的 Shiki 高亮（按需加载）；预览不再自动折叠长文件
修复
- #21 更新后会话列表为空：打包不再用 !**/doc/** 误删 yaml 运行时 dist/doc/directives.js，修复 session.list / Worker 初始化 MODULE_NOT_FOUND
- 更新检查竞态：检查结果可在 renderer 订阅前缓冲，挂载后通过 pending 拉取，避免漏弹窗
注意
- 从 0.4.15–0.4.17 受 #21 影响的安装包请升级到本版本；磁盘上会话文件一般仍在，升级后即可重新列出

安装包见本页 Assets。更新说明以本正文为准（应用内「发现新版本」弹窗会展示）。

完整更新日志：CHANGELOG.md
Release 说明：doc/RELEASE.md

完整更新日志：CHANGELOG.md
Release 说明：doc/RELEASE.md

完整更新日志：CHANGELOG.md
Release 说明：doc/RELEASE.md

完整更新日志：CHANGELOG.md
Release 说明：doc/RELEASE.md

完整更新日志：CHANGELOG.md
Release 说明：doc/RELEASE.md

完整更新日志：CHANGELOG.md
Release 说明：doc/RELEASE.md

Full Changelog：CHANGELOG.md

Full Changelog: https://github.com/justhil/pi-app/commits/v0.4.10
Full Changelog: https://github.com/justhil/pi-app/commits/v0.4.10

Full Changelog: https://github.com/justhil/pi-app/compare/v0.3.7...v0.3.8