更新日志

记录 Pi Agent Desktop 每个版本的重要变化。完整的发布说明与资产请见 GitHub Releases。

v0.4.1 最新版本

内置 Pi Coding Agent 1.2.0,新增 Windows PowerShell 支持与模型配置恢复,改善工具、渠道和启动体验。

Windows PowerShell 支持

在 Windows 上使用 PowerShell 5.1 或 7 执行 Agent 命令。可选择新会话的默认 Shell,已有会话保留原有选择。

查看使用方法

模型配置恢复

models.json 无效时显示需要修正的字段。在修复并重新加载配置前暂停发送,避免请求发往非预期端点。

查看使用方法

一致的工具权限

MCP 别名、工具搜索与 Codemode 嵌套调用遵循一致的权限检查。升级后,已有会话和渠道的授权范围保持不变。

查看使用方法

更可靠的渠道回复

附件与对应回合准确关联。已取消或由扩展接管的消息不再影响后续 Desktop 回合,也不会重复发送上一轮助手回复。

查看使用方法

稳定性改进

  • 改善 PowerShell 对中文、Emoji、多行脚本、引号及交错输出的处理,完善取消、超时、退出状态和进程树清理。
  • 设置及渠道、终端、Markdown 的可选依赖按需加载。修复设置首次打开白屏;加载时支持关闭按钮、Esc、点击遮罩退出,并正确管理键盘焦点。
  • Windows 文件临时被占用时,会重试保存配置。安装流程纳入 Herdr 解压修复,并完善修复与回退检查、资源完整性和 SBOM 校验。
  • 适配 Pi 1.2.0 工具元数据,恢复界面工具列表,并避免暴露扩展内部路径。工具不可用或路径变化时,会同步更新其可选状态。

说明

  • 在 Windows 上,打开「设置 → 通用 → Agent 默认 Shell」,选择 PowerShell 或 Bash。新会话默认使用 PowerShell;此设置只影响之后创建的会话。
  • 已有会话保留原有 Shell 和工具授权。更改默认值不会为「无工具」会话新增命令执行权限。Bash 与 PowerShell 使用当前用户的本机权限运行,不构成安全沙箱。
  • 请拆分过长的 PowerShell 命令。超过 Windows 长度限制的命令会在执行前明确报错,不会被静默截断后执行。
  • Pi 1.2.0 会将未通过结构校验的 models.json 整体视为无效,所有自定义提供商与模型覆盖配置均不生效。Desktop 会暂停桌面及渠道会话的发送。
  • 打开「设置 → 模型」并修正提示的字段。其余无法在界面中编辑的字段,请手动修改 ~/.pi/agent/models.json。支持行注释与尾逗号。
  • 重新加载磁盘上的配置,再重新加载会话后发送消息。恢复后检查已选模型及 Auto 路由。
  • OpenRouter 根据当前账号权限刷新模型目录。Desktop 与 Pi CLI 共享 ~/.pi/agent/ 下的缓存;切换账号或离线启动后,请联网刷新,替换过期或来自其他账号的目录。
  • Windows 安装包仍为未签名 Beta,Linux AppImage 继续使用手动更新。
在 GitHub 查看完整更新日志
v0.4.0

内置 Pi Coding Agent 1.1.0,新增 MCP 服务、Auto 自动路由、图片生成、决策模型与持久化工具执行历史。

Auto 自动路由

配置快模型和强模型,Auto 按思考级别或任务复杂度为每次新提问选择模型,并显示实际作答的模型。

查看使用方法

MCP 服务管理

通过 stdio 或 Streamable HTTP 连接本地与远程工具。在设置中导入配置、通过 OAuth 登录、测试连接并预览资源。

查看使用方法

图片生成与决策模型

通过 Codemode 生成图片、分类内容、进行是非判断或评分。生成的图片在重新打开会话后仍可查看。

查看使用方法

工具权限与执行历史

按会话分支查看直接与嵌套调用的执行树。检查状态、耗时、输入和完整结果,重开或压缩会话后仍可查阅。

查看使用方法

模型高级配置

  • 打开「设置 → 模型 → 模型高级配置」,调整自动上下文压缩、回复预留 Token、最近内容保留量及按模型覆盖的参数。
  • 配置 Agent 和服务商的重试次数、等待时间、请求超时,以及自动、SSE、WebSocket 或缓存 WebSocket 传输方式。
  • 模型编辑支持按思考级别配置采样参数、设置图片与请求输入限制,以及按模型 ID 覆盖配置。支持的模型可选择 Max 推理级别。
  • 高级设置与 Pi CLI 共享。重新加载现有会话后生效;已信任项目的设置可覆盖全局值。保存时会检测外部修改,减少配置冲突。

稳定性改进

  • Pi Coding Agent 从 0.87.1 升级至 1.1.0,完善 API Key、订阅与 OAuth 配置向导、凭据替换流程及 Azure 旧配置迁移。
  • 主动停止的回合重开后仍保留停止状态,不再触发完成提示音或通知。改善会话切换、草稿保留、滚动与流式回复的稳定性。
  • 修复 Windows MCP 子进程启动、环境传递及含空格或中文的路径问题,同时改善 Herdr 关闭与运行时清理。

说明

  • 可按思考级别路由,或添加决策模型判断任务复杂度。决策请求会增加耗时和用量;判断失败时,Auto 使用强模型。
  • 保存 MCP 配置不等于授权工具。请在当前会话的工具菜单中授权;嵌套调用也遵守同样的权限。
  • OpenAI 决策接口需要 API Key,ChatGPT 订阅登录不提供此能力。通过 API Key 添加 TypeSafe / Jev 服务商,即可使用 jev-latest。
  • 服务商详情页可测试图片和决策模型,测试可能产生费用。调用支持取消,并在会话历史中保留输入、结果、状态和用量。
  • Desktop 的工具权限与执行记录保存在应用数据目录。完整备份时,除 ~/.pi/agent/ 外,还需保留其中的 tool-executions 日志和内容文件。
  • Windows 安装包仍为未签名 Beta,Linux AppImage 继续使用手动更新。
在 GitHub 查看完整更新日志
v0.3.0

本次版本将 Herdr 扩展到 Windows x64,升级内置 Pi Coding Agent 至 0.87.1,并更新模型支持、依赖安全与跨平台验证。

Windows x64 Herdr

  • Windows x64 安装包现已内置经过完整性校验的 Herdr v0.8.2,可在“开发工具”中安装、修复或卸载,并使用 Attach 或 Managed 模式连接。
  • Windows 支持 Herdr Fleet 与 Agent 控制、实时 ANSI 终端观察和显式键盘接管。
  • 终端子进程由原生 Job Object 管理,应用或终端异常退出时会执行有界清理。
  • Herdr 现支持 macOS arm64 / x64、Linux x64 与 Windows x64;Windows ARM64、Windows Server 和 32 位 Windows 暂不支持。

Pi 0.87.1、模型与缓存

  • 内置 Pi Coding Agent 从 0.85.0 升级到 0.87.1,并适配会话、模型提供商和工具调用相关的运行时变化。
  • 新增 Claude Opus 5.5、GPT-6 Sol、GPT-6 Luna 和 Grok 4.7 模型支持。
  • “设置 → 通用 → 会话”新增“提示缓存预热”,可选择关闭、长时间运行工具时预热或空闲时也预热;设置与 Pi CLI 共享,可能消耗模型用量。

安全与可靠性

  • 升级存在安全风险的依赖,并补充 Windows Herdr 原生集成、终端生命周期和打包资源的回归测试。
  • 继续验证各平台安装包、Windows Job Object、Herdr runtime 完整性和打包后工具链。

下载

  • macOS Apple Silicon: Pi-Agent-Desktop-0.3.0-arm64.dmg
  • macOS Intel: Pi-Agent-Desktop-0.3.0-x64.dmg
  • Windows x64(未签名 Beta): Pi-Agent-Desktop-Unsigned-Beta-Setup-0.3.0.exe
  • Linux x64: Pi-Agent-Desktop-0.3.0-x86_64.AppImage

说明

  • 内置 Pi Coding Agent 运行时现为 0.87.1。
  • Windows 安装包仍为未签名 Beta,Linux AppImage 继续使用手动更新。
  • Herdr 与受管进程提供生命周期控制,并不是安全沙箱。
v0.2.3

本次版本改进原生菜单与应用界面的语言一致性,默认收起 Windows / Linux 顶部菜单栏,并修复列表内数学公式导致后续 Markdown 内容显示异常的问题。

原生菜单与跨平台界面

  • 原生应用菜单跟随界面语言设置,文件、编辑、视图、窗口、帮助及其子菜单完整支持英文、简体中文和繁体中文。
  • Windows / Linux 默认收起顶部菜单栏,减少菜单栏与应用界面的视觉割裂;菜单功能和快捷键保持不变,按 Alt 可临时显示。
  • macOS 保留系统顶部菜单栏,菜单文案会随应用语言切换;设置页面布局保持不变。

Markdown 数学公式

  • 修复列表内单行块级数学公式展开后丢失缩进的问题,让公式继续属于原列表项。
  • 避免公式后的标题、表格、粗体文字等内容被误解析为数学公式,并覆盖有序列表、无序列表、嵌套列表、引用和不同换行格式。

下载

  • macOS Apple Silicon: Pi-Agent-Desktop-0.2.3-arm64.dmg
  • macOS Intel: Pi-Agent-Desktop-0.2.3-x64.dmg
  • Windows x64(未签名 Beta): Pi-Agent-Desktop-Unsigned-Beta-Setup-0.2.3.exe
  • Linux x64: Pi-Agent-Desktop-0.2.3-x86_64.AppImage

说明

  • 内置 Pi Coding Agent 运行时仍为 0.85.0。
  • Herdr 平台支持、Windows Unsigned Beta 和手动 Linux 更新保持不变。
v0.2.2

本次版本新增繁体中文界面与独立的模型回复宽度,升级内置 Pi Coding Agent 至 0.85.0,并改进 Herdr Agent 支持和 Windows Git Bash 兼容性。

语言与对话布局

  • 新增繁体中文(zh-TW)界面,覆盖设置、模型、会话、浏览器、开发工具与 Herdr;台湾、香港、澳门及 zh-Hant 系统语言默认使用繁体中文。
  • 原生对话框、文件右键菜单、浏览器确认提示和托盘文案会同步应用语言,避免系统级提示与主界面语言不一致。
  • “设置 → 通用 → 会话”新增独立“模型回复宽度”,可选择“舒适宽度”或“填满对话列”;后者让回复气泡、段落、表格和代码块使用完整阅读空间。
  • 模型回复宽度与外层“对话宽度”分别控制,默认保持舒适宽度;打开右侧面板时会随可用空间收缩。

Runtime、Herdr 与 Windows 工具

  • 内置 Pi Coding Agent 及相关运行时升级至 0.85.0,补齐桌面端所需的 pi-server 依赖和兼容性检查。
  • Herdr 新增 agy Agent 的发现与启动支持,并继续沿用固定目录发现与受控启动流程。
  • 修复 Git for Windows 安装在自定义目录或带版本号的 PortableGit 目录时,健康的 Git Bash 被误判为不可用的问题。

下载

  • macOS Apple Silicon: Pi-Agent-Desktop-0.2.2-arm64.dmg
  • macOS Intel: Pi-Agent-Desktop-0.2.2-x64.dmg
  • Windows x64(未签名 Beta): Pi-Agent-Desktop-Unsigned-Beta-Setup-0.2.2.exe
  • Linux x64: Pi-Agent-Desktop-0.2.2-x86_64.AppImage

说明

  • 内置 Pi Coding Agent 运行时现为 0.85.0。
  • Herdr 支持 macOS arm64 / x64 与 Linux x64,Windows 上仍不可用;新增 agy 支持不会自动安装该 CLI。
  • Windows 安装包仍为未签名 Beta,Linux AppImage 继续使用手动更新。
v0.2.1

本次版本重点修复正式包在 GUI 精简 PATH 下无法启动已安装 Herdr Agent CLI 的问题,并改进截图附件、通知消息和 Mermaid 展示。

Herdr Agent CLI 启动与诊断

  • 为 11 个可启动 Agent 增加固定目录 catalog,覆盖 Homebrew、MacPorts、 ~/.local/bin、Agent 官方目录、npm / Bun / uv / WinGet 与受支持版本管理器的常见位置。
  • Managed Herdr 使用 Agent-only launcher overlay,并补充已验证的 Agent 与运行时目录;从 Finder 启动且系统 PATH 很窄时也能找到常见 Agent CLI。
  • herdr_agent_start 不再因 Desktop 本地未发现 CLI 而提前拒绝;完成安全校验后由目标 Herdr Session 返回最终启动结果,Attach 模式不会替外部 Session 下结论。
  • Herdr 诊断新增 detected、 missing-locally、 ambiguous和来源信息;失败结果保留稳定错误码,同时避免暴露路径或终端内容。

附件与内容展示

  • 大截图和 Retina PNG 进入草稿前会按最长边 2048 像素、目标约 512 KiB 自动缩放并转为 JPEG,草稿图片解码预算提升至 4 MiB。
  • 多行通知、显式换行与无空格长文本现在可以完整换行,不再被固定高度压缩成单行省略号。
  • Mermaid 代码块在响应流结束后默认显示渲染结果,同时保留 Source 切换和渲染失败回退。

安全与可靠性

  • Agent CLI 发现只检查固定 allowlist 目录与 canonical command,不运行 --version、登录 shell、shell profile,也不会联网安装或递归扫描用户目录。
  • launcher overlay 只包含允许的 Agent command,不会把完整用户 bin 目录放到系统 PATH 之前;Attach 模式不会修改外部 Herdr 环境。
  • Windows NSIS 历史未签名安装器的特定访问冲突仅在目标目录仍为空时有界重试,其他错误继续立即 fail-closed。

下载

  • macOS Apple Silicon: Pi-Agent-Desktop-0.2.1-arm64.dmg
  • macOS Intel: Pi-Agent-Desktop-0.2.1-x64.dmg
  • Windows x64(未签名 Beta): Pi-Agent-Desktop-Unsigned-Beta-Setup-0.2.1.exe
  • Linux x64: Pi-Agent-Desktop-0.2.1-x86_64.AppImage

说明

  • 内置 Pi Coding Agent 运行时仍为 0.84.0。
  • missing-locally 只表示 Desktop 未在受支持目录中发现 CLI,不代表 Attach 或未来 Remote Session 一定无法启动。
  • Herdr 平台支持、Windows Unsigned Beta 和手动 Linux 更新保持不变。
v0.2.0

本次版本完整接入 Herdr v0.8.2 / protocol 20:Pi 可以在原主对话中管理本机 Agent 舰队,用户通过标题栏状态列表和右侧终端观察、排查或接管。

Herdr 对话式控制与舰队界面

  • 新增 24 个语义化 herdr_* 工具,覆盖 Fleet 查询、workspace / tab / pane 管理、Agent 启动与提示、状态解释、进程诊断、按键和输出等待。
  • 主对话直接控制 Herdr Agent;标题栏右侧按 workspace、tab、pane 和 Agent 层级展示舰队状态,初始页与激活会话保持一致。
  • 右侧新增 xterm.js Herdr 终端,支持 ANSI 输出、自动适配、只读观察、显式键盘接管、输入限流、断线恢复和有界缓冲;关闭视图不会关闭 pane 或 Agent。
  • Attach 模式连接用户手动启动的 Herdr;Managed 模式由 Pi Desktop 启动、监控、有限重启并在禁用、切换模式、卸载或退出时关闭私有 server。
  • macOS / Linux 安装包内置经摘要校验的 Herdr v0.8.2,安装、更新、修复和卸载统一进入“开发工具”;Managed 模式无需单独联网下载。
  • 可启动 pi、 claude、 codex、 gemini、 omp、 opencode、 copilot、 kimi、 droid、 grok和 qwen.

安全、可靠性与对话体验

  • 适配器固定兼容 Herdr >=0.8.2 <0.9.0、protocol 20 和 schema 1;未知协议、schema 漂移、不安全 endpoint、超限响应或非法标识符均 fail-closed。
  • Unix socket 会在每次请求前校验真实文件、当前用户所有权和权限;prompt、pane 输出、等待、终端帧和输入队列均设严格上限并经过脱敏。
  • Managed 只管理 Pi Desktop 自己启动的 Session server,不接管或终止外部 Herdr;Pi Session 与 Herdr Session 相互独立。
  • 关闭 workspace、pane 或 Agent 必须经过本机确认;Herdr v0.8.2 不支持仅停止 Agent,因此关闭 Agent 会明确关闭其所在 pane。
  • Skill 调用消息改为折叠显示清晰命令,避免在对话中暴露或重复显示 Skill 正文。

下载

  • macOS Apple Silicon: Pi-Agent-Desktop-0.2.0-arm64.dmg
  • macOS Intel: Pi-Agent-Desktop-0.2.0-x64.dmg
  • Windows x64(未签名 Beta): Pi-Agent-Desktop-Unsigned-Beta-Setup-0.2.0.exe
  • Linux x64: Pi-Agent-Desktop-0.2.0-x86_64.AppImage

说明

  • 内置 Pi Coding Agent 运行时仍为 0.84.0。
  • Herdr 当前支持 macOS arm64 / x64 与 Linux x64;Windows 可继续使用其他功能,但 Herdr 暂不可用并会 fail-closed。
  • Herdr 与受管进程提供生命周期控制,并不是容器或安全沙箱;子进程拥有与 Agent Bash 相同的本机文件、网络和环境权限。
  • Windows 安装包为未签名 Beta,可能出现“未知发布者”或 SmartScreen 提示;Linux AppImage 继续使用手动更新。
v0.1.14

本次版本新增可观察、可控制的受管后台进程,让 Agent 能在应用管理的生命周期内持续运行开发服务器、watcher、mock API 和其他项目任务。

受管后台进程

  • 新增 process_start、 process_list、 process_read、 process_wait、 process_write、 process_stop和 process_restart 工具;普通短命令继续使用 Bash。
  • 右侧 Processes 面板集中展示 owner、状态、readiness、脱敏日志、loopback endpoint 与退出原因,并支持 stdin、停止、强制停止、重启、复制和导出日志。
  • 支持通过日志 cursor 观察慢启动任务并自动识别 localhost 地址,可直接管理 Vite、React、Storybook、Flask、Spring Boot、mock API 与 watch build 等工作流。
  • 受管 localhost 服务可与内置 Browser 联调,进程能力和 Browser 授权彼此独立。

跨平台、安全与可靠性

  • macOS / Linux 使用 POSIX process group 管理完整进程树;Windows 11 x64 使用 Rust helper 与 Windows Job Object,并验证 helper 路径、版本、架构和完整性。
  • 功能默认关闭;启用时校验平台架构、项目 trust、会话工作目录、owner identity、crash reaper 和资源策略,不满足条件时 fail-closed。
  • 进程按 Agent 会话隔离;日志采用有界缓冲、游标读取和敏感信息脱敏,stdin 不持久化,常见 LAN bind 需要确认。
  • Host 或应用异常退出时,crash reaper 会在限定时间内清理进程树;用户停止的进程不会被 Agent 自动绕过。
  • Windows 发布流程新增 Rust helper 可复现构建、PE 安全检查、CycloneDX SBOM 与打包产物完整性门禁。

下载

  • macOS Apple Silicon: Pi-Agent-Desktop-0.1.14-arm64.dmg
  • macOS Intel: Pi-Agent-Desktop-0.1.14-x64.dmg
  • Windows x64(未签名 Beta): Pi-Agent-Desktop-Unsigned-Beta-Setup-0.1.14.exe
  • Linux x64: Pi-Agent-Desktop-0.1.14-x86_64.AppImage

说明

  • 内置 Pi Coding Agent 运行时仍为 0.84.0。
  • 受管进程支持 macOS、Linux 和 Windows 11 x64,暂不支持 Windows ARM64、Windows Server 与 32 位 Windows;它提供生命周期控制,并不是容器或安全沙箱。
  • Windows 安装包为未签名 Beta,可能出现“未知发布者”或 SmartScreen 提示;Linux AppImage 继续使用手动更新。
v0.1.13

本次版本新增聊天字号与对话宽度设置,并重构 @ 文件引用候选,让大型非 Git 工作区中的文件浏览和搜索更完整、更可靠。

聊天外观

  • “设置 → 通用 → 会话”新增聊天字号和对话宽度;字号提供小、标准、大、特大四档,修改立即生效并跨重启保存。
  • 舒适宽度保持 760px,扩展宽度随窗口自适应且最大为 960px。
  • 统一消息、过程详情和输入框的内容边界,修复宽屏与最小窗口下对话气泡和输入区对齐不一致的问题。

@ 文件引用

  • 文件候选改为按需浏览和受管 fd 搜索,直接浏览与搜索候选上限均为 300,避免大型目录中的前置内容耗尽配额。
  • 以用户主目录为工作区时默认隐藏 Windows AppData 或 macOS Library ,显式输入目录名称时仍可访问。
  • 搜索工具不可用、超时或失败时会显示明确的降级状态,同时保留当前目录候选,避免卡死或静默返回误导结果。

下载

  • macOS Apple Silicon: Pi-Agent-Desktop-0.1.13-arm64.dmg
  • macOS Intel: Pi-Agent-Desktop-0.1.13-x64.dmg
  • Windows x64(未签名 Beta): Pi-Agent-Desktop-Unsigned-Beta-Setup-0.1.13.exe
  • Linux x64: Pi-Agent-Desktop-0.1.13-x86_64.AppImage

说明

  • 内置 Pi Coding Agent 运行时仍为 0.84.0。
  • Windows 安装包为未签名 Beta,可能出现“未知发布者”或 SmartScreen 提示;Linux AppImage 继续使用手动更新。
v0.1.12

本次版本修复 Windows 下切换主工作区与 linked worktree 后,项目历史会话从侧边栏消失且无法恢复的问题。

Windows Worktree 会话修复

  • 主工作区和 linked worktree 统一使用 Git 报告的顶层路径,消除会话文件与 Git 输出之间的斜杠差异。
  • 会话侧边栏和应用外壳使用 Windows 感知的路径比较,统一处理分隔符、盘符与路径大小写及尾部分隔符。
  • 继续保留仓库子目录的独立项目身份和子模块语义,不会把所有目录错误合并为同一个项目。
  • 在沙箱 Renderer 不提供 process 时,通过 preload 平台信息正确识别 Windows。

下载

  • macOS Apple Silicon: Pi-Agent-Desktop-0.1.12-arm64.dmg
  • macOS Intel: Pi-Agent-Desktop-0.1.12-x64.dmg
  • Windows x64(未签名 Beta): Pi-Agent-Desktop-Unsigned-Beta-Setup-0.1.12.exe
  • Linux x64: Pi-Agent-Desktop-0.1.12-x86_64.AppImage

说明

  • 内置 Pi Coding Agent 运行时仍为 0.84.0。
  • Windows 安装包为未签名 Beta,可能出现“未知发布者”或 SmartScreen 提示;Linux AppImage 继续使用手动更新。
v0.1.11

本次版本带来端到端本地文件体验:聊天可附加任意文件,Markdown 自动识别本地路径,并为文件链接提供丰富的系统右键操作。

附件与本地文件

  • 拖放、粘贴和附件按钮均可添加任意文件;非图片显示为文件卡片,支持纯附件发送及流式回复期间加入 Steer / Follow-up 队列。
  • Markdown 自动识别 Windows、POSIX 和 UNC 本地路径并保留 file: 链接;绝对路径可在系统文件管理器中定位,仓库相对路径仍在应用内打开。
  • 文件链接右键菜单支持打开文件、默认应用、打开方式、另存为、复制路径、复制文本内容和在文件夹中显示;Windows 会读取真实文件关联。
  • 附件发送使用稳定快照,失败内容会合并回最新草稿;文件引用统一校验绝对路径、去重并限制数量。

对话体验与安全

  • 思考块展开/折叠状态会跨会话切换保留,新思考块沿用最近选择,并按会话隔离和限制容量。
  • 向上滚轮或按下 ArrowUp、 PageUp、 Home 会立即解除滚动跟随。
  • 过滤思考或工具调用之间的空文本段,避免出现空白助手气泡。
  • Main 负责解析真实路径、校验文件类型与工作目录,并限制可复制文件内容的大小和文本类型。

下载

  • macOS Apple Silicon: Pi-Agent-Desktop-0.1.11-arm64.dmg
  • macOS Intel: Pi-Agent-Desktop-0.1.11-x64.dmg
  • Windows x64(未签名 Beta): Pi-Agent-Desktop-Unsigned-Beta-Setup-0.1.11.exe
  • Linux x64: Pi-Agent-Desktop-0.1.11-x86_64.AppImage
v0.1.10

本次版本为新会话加入自动命名:首条有效消息发送后在后台生成简短标题,同时保证正常回复不被阻塞、手动名称永远优先。

新会话自动命名

  • 使用当前会话选择的模型在后台生成标题,并实时更新侧边栏;标题请求独立于会话历史和上下文缓存。
  • “设置 → 通用 → 会话”新增“自动命名新会话”开关,默认启用并完整支持中英文。
  • 模型不可用或请求失败时使用本地标题兜底;统一清理引号、换行和末尾标点,并限制为 40 个字符。
  • 自动标题生成期间手动重命名也不会被覆盖;斜杠命令、空白、单字符和纯图片消息不会触发命名。
  • 收紧工作目录与模型运行时处理,修复模型服务初始化失败时未执行本地兜底的问题。

下载

  • macOS Apple Silicon: Pi-Agent-Desktop-0.1.10-arm64.dmg
  • macOS Intel: Pi-Agent-Desktop-0.1.10-x64.dmg
  • Windows x64(未签名 Beta): Pi-Agent-Desktop-Unsigned-Beta-Setup-0.1.10.exe
  • Linux x64: Pi-Agent-Desktop-0.1.10-x86_64.AppImage

说明

  • 内置 Pi Coding Agent 运行时仍为 0.84.0。
  • Windows 安装包为未签名 Beta,可能出现“未知发布者”或 SmartScreen 提示;Linux AppImage 继续使用手动更新。
v0.1.9

本次版本改善长对话中的滚动控制:离开最新内容时显示“滚动到底部”按钮,回到末尾后重新启用流式输出自动跟随。

对话滚动体验

  • 新增浮动“滚动到底部”按钮,并显示运行状态,提供中英文文案和减少动态效果支持。
  • 排除运行时尾部占位区对“接近底部”判断的干扰,避免按钮错误显示或隐藏。
  • 在回合和会话切换之间保持滚动磁吸状态,同时确保用户主动向上滚动可以解除自动跟随。
  • 图片延迟加载或过程详情展开改变内容高度后,会及时更新按钮与自动跟随状态。

下载

  • macOS Apple Silicon: Pi-Agent-Desktop-0.1.9-arm64.dmg
  • macOS Intel: Pi-Agent-Desktop-0.1.9-x64.dmg
  • Windows x64(未签名 Beta): Pi-Agent-Desktop-Unsigned-Beta-Setup-0.1.9.exe
  • Linux x64: Pi-Agent-Desktop-0.1.9-x86_64.AppImage
v0.1.8

本次版本为 API Key 服务商加入 Base URL,并集中加强模型刷新、界面本地化、主题一致性、渠道权限同步和桌面运行可靠性。

模型、界面与渠道

  • API Key 服务商可以设置 Base URL 以覆盖默认请求端点;模型目录刷新的服务初始化与最终整理阶段都受到超时保护。
  • 补齐会话侧边栏、应用导航、文件浏览与预览、Skills、Plugins 和 Agent 通知的中英文界面。
  • 统一错误页、Word 预览、模型连接状态和用户消息气泡的主题,并在离线环境中使用内置字体。
  • 渠道账号默认工具权限会同步到已绑定会话;权限按 Pi Session 生效,共用会话的多个渠道入口保持一致。
  • 加强共享浏览器、桌面 IPC、文件访问、更新流程、崩溃恢复和长时间运行时的安全性、性能与故障恢复。

下载

  • macOS Apple Silicon: Pi-Agent-Desktop-0.1.8-arm64.dmg
  • macOS Intel: Pi-Agent-Desktop-0.1.8-x64.dmg
  • Windows x64(未签名 Beta): Pi-Agent-Desktop-Unsigned-Beta-Setup-0.1.8.exe
  • Linux x64: Pi-Agent-Desktop-0.1.8-x86_64.AppImage
v0.1.7

本次版本重点简化模型配置和飞书 / Lark 接入流程:可以按服务商控制模型显示范围,并通过官方扫码流程创建和连接新机器人。

模型选择与中文设置

  • 已连接的订阅账号和 API Key 服务商可以选择哪些模型显示在模型选择器中。
  • 支持按模型名称或 ID 搜索、逐个启用,并按服务商全部启用或全部停用,同时显示已启用数量。
  • 模型选择会持久化到 Pi 设置,兼容已有思考等级配置,且不会改变当前会话正在使用的模型。
  • 防止保存没有有效模型的配置,避免模型选择器进入不可用状态。
  • 模型服务商、登录、连接测试、自定义模型、上下文窗口、费用和思考等级等设置现已完整支持中文。

飞书 / Lark 扫码创建机器人

  • 新增“扫码创建(推荐)”接入方式,可选择飞书中国区或 Lark,并使用官方授权流程创建新的 Pi Desktop 机器人。
  • 授权后自动配置消息、资源、卡片、事件和机器人菜单权限,保存凭据、验证机器人身份并启动连接。
  • App Secret 只在 Agent Host 中处理并通过系统加密保存,不会进入界面。
  • 默认仅允许扫码者发送私聊;群聊、命令和 Agent 工具保持关闭,需要后续显式启用。
  • 已有自建应用仍可通过 App ID 和 App Secret 接入。

安全与验证

  • 加强渠道凭据保存、重新加载、明文泄漏检查和错误信息脱敏。
  • 增加飞书扫码注册与渠道登录生命周期测试,并完善跨平台发布包静态验证和 Windows 原生剪贴板资源检查。

下载

  • macOS Apple Silicon: Pi-Agent-Desktop-0.1.7-arm64.dmg
  • macOS Intel: Pi-Agent-Desktop-0.1.7-x64.dmg
  • Windows x64: Pi-Agent-Desktop-Setup-0.1.7.exe
  • Linux x64: Pi-Agent-Desktop-0.1.7-x86_64.AppImage

说明

  • 内置 Pi Coding Agent 运行时仍为 0.84.0。
  • Windows 安装包目前未签名,首次运行可能出现 SmartScreen 提示;Linux AppImage 继续使用手动更新。
v0.1.6

本次版本将内置 Pi Coding Agent 升级至 0.84.0,并重点增强内容渲染、模型目录、凭据同步和 Skill 安装稳定性。

Pi 0.84 与内容渲染

  • 将 Pi Coding Agent 及相关运行时升级至 0.84.0,并完成 OAuth、模型和扩展接口适配。
  • Agent 回复新增 Mermaid 图表和 LaTeX(KaTeX)公式渲染。
  • Markdown 文件完善代码高亮、Mermaid 与 KaTeX 渲染。

模型与身份认证

  • 会话启动优先使用本地缓存的模型目录,并可从模型选择器手动刷新远程目录。
  • 模型刷新支持超时、取消、离线状态与部分 Provider 失败提示;刷新失败时继续保留缓存模型。
  • API Key 设置或删除、OAuth 登录或退出后,会同步刷新 Agent Host 的模型状态;同步失败时显示明确警告。

Skill 安装与稳定性

  • 正常安装继续使用 npm 默认并发与缓存;遇到网络、超时或 cache lock 故障时,自动使用临时隔离缓存重试一次。
  • 改进安装超时、扩展加载诊断和错误信息脱敏,便于排查问题且避免暴露敏感内容。
  • 修复 Linux ASAR 依赖冲突、Windows ASAR 路径校验和 macOS Intel 构建验证,并加强生产包完整性检查。

下载

  • macOS Apple Silicon: Pi-Agent-Desktop-0.1.6-arm64.dmg
  • macOS Intel: Pi-Agent-Desktop-0.1.6-x64.dmg
  • Windows x64: Pi-Agent-Desktop-Setup-0.1.6.exe
  • Linux x64: Pi-Agent-Desktop-0.1.6-x86_64.AppImage

说明

  • Windows 安装包目前未签名,首次运行可能出现 SmartScreen 提示;Linux AppImage 继续使用手动更新。
v0.1.5

本次版本重点优化会话列表、会话切换和超长对话的加载性能,在保留完整本地历史的同时减少重复扫描、传输与渲染。

主要更新

  • 新增增量会话索引,根据文件指纹复用未变化的会话元数据,并由文件监听器定向刷新受影响的会话。
  • 会话首次打开优先加载最近 20 个对话轮次;向上滚动或点击按钮即可继续加载更早消息。
  • 超大文本、思考内容、工具调用参数和图片使用延迟内容机制,先显示预览,需要时再加载完整内容。
  • 增加有边界的会话内容缓存和路径缓存,改善会话切换、滚动和持续输出时的响应速度。
  • 压缩摘要与分支摘要默认折叠显示,并新增会话性能埋点、基准测试及分页、缓存、索引测试。

下载

  • macOS Apple Silicon: Pi-Agent-Desktop-0.1.5-arm64.dmg
  • macOS Intel: Pi-Agent-Desktop-0.1.5-x64.dmg
  • Windows x64: Pi-Agent-Desktop-Setup-0.1.5.exe
  • Linux x64: Pi-Agent-Desktop-0.1.5-x86_64.AppImage

说明

  • 分页和延迟加载不会删除或截断保存在本机的完整会话历史。
  • Windows 安装包目前未签名,首次运行可能出现 SmartScreen 提示;Linux AppImage 继续使用手动更新。
v0.1.4

本次版本新增用户与 Agent 共享的内置浏览器,把真实 Chromium 页面、浏览授权和网络策略整合进桌面工作台。

内置浏览器

  • 在主界面右侧通过 Main-owned WebContentsView 打开真实网页,支持多标签页、临时或持久 Profile、登录态、上传、下载和代理。
  • Agent 可在独立的 Browser read / interact 授权下导航、读取结构化页面、截图、点击、输入和等待;Coding 权限不会隐式授予浏览器权限。
  • 用户与 Agent 操作同一个页面并可随时接管;提交、上传、下载、权限请求和外部协议继续经过本地策略或确认。
  • 设置页可管理全局和会话级浏览器权限;高级浏览器模式整合可信输入、网络检查和确认后的写请求重放。
  • 远程网页运行在沙箱化 Browser View 中,不获得应用 preload、Node.js 或主 Renderer bridge。

下载

  • macOS Apple Silicon: Pi-Agent-Desktop-0.1.4-arm64.dmg
  • macOS Intel: Pi-Agent-Desktop-0.1.4-x64.dmg
  • Windows x64: Pi-Agent-Desktop-Setup-0.1.4.exe
  • Linux x64: Pi-Agent-Desktop-0.1.4-x86_64.AppImage
v0.1.3

本次版本重点引入跨平台开发工具管理,并补齐 Linux 官方发布包,让技能、插件和 Agent 脚本在不同用户环境中获得更稳定、一致的运行体验。

主要更新

  • 新增统一的“开发工具”设置,按 JavaScript、Python、CLI 基础工具分类,以左侧列表、右侧详情的方式管理工具状态、来源和版本。
  • 优先发现并验证用户已安装的 Node.js、npm / npx、Python、uv / uvx、Git / Bash、Bun、jq 等工具,覆盖 macOS 从 Finder 启动时 PATH 不完整、Windows 常见安装位置等场景。
  • 用户确认后可安装应用私有的 Node.js LTS、CPython、uv、PortableGit、Bun 和 jq;不会修改系统 PATH、Shell 配置或注册表。
  • 内置并校验目标平台专用的 ripgrep 与 fd,为 Agent 提供稳定、高性能的文件搜索能力。
  • 技能与插件统一使用解析后的绝对 Node / npm 路径;插件的 npm 操作移入隔离 Worker,缺失工具时返回结构化安装引导。
  • 新增工具下载、安装、修复、移除、取消、缓存查看和诊断能力,并加强重定向白名单、校验和、启动验证、回滚与日志脱敏。
  • 更新中英文 README 和应用截图。

平台与下载

  • 新增 Linux x64 AppImage 正式发布,并与 macOS Apple Silicon / Intel、Windows x64 一起纳入完整 CI、产物启动 E2E 和发布校验。
  • macOS Apple Silicon: Pi-Agent-Desktop-0.1.3-arm64.dmg
  • macOS Intel: Pi-Agent-Desktop-0.1.3-x64.dmg
  • Windows x64: Pi-Agent-Desktop-Setup-0.1.3.exe
  • Linux x64: Pi-Agent-Desktop-0.1.3-x86_64.AppImage

说明

  • 应用私有工具按需安装,并且只在用户确认后执行;文件保存在 Pi Agent Desktop 的应用数据目录。
  • Windows 安装包目前未签名,首次运行可能出现 SmartScreen 提示。
  • Linux AppImage 当前使用手动更新。
v0.1.2

新增

  • 为 Windows x64 新增应用内更新,可直接在应用中检查、下载和安装新版本。
  • Windows 更新无需代码签名证书,并使用完整的 NSIS 安装程序代替 Web Installer。

安全与可靠性

  • 安装前根据 GitHub Release 元数据和 SHA-512 校验和验证更新包。
  • 加强 Windows 更新配置检查,确保未签名构建不会包含无效的 publisherName.
  • CI 增加安装程序、更新元数据与 blockmap 一致性验证;macOS 继续执行代码签名、Apple 公证和产物完整性验证。
v0.1.1

修复

  • 模型请求失败时直接在对话中展示错误,不再静默渲染空白的助手回复;保留提供商的错误详情(例如 API key 无效),提供商未返回详情时给出可操作的回退提示。
  • 会话分组与重新加载后仍保留失败的助手消息,同时继续隐藏无害的空响应。
  • 为提供商失败、缺失错误详情以及正常的空助手消息补充回归测试。

变更

  • 分支推送仅运行测试与完整质量门,不再打包临时安装包。 main 现在运行测试和完整的质量控制,无需打包临时安装程序。
  • Pull Request 与手动触发的 workflow 继续提供临时构建产物。
  • tag 发布的桌面版本在签名并公证的 macOS 产物之外,新增 Windows x64 NSIS 安装程序、blockmap 与更新元数据。
  • 加强 macOS 与 Windows 软件包的发布资产校验。
  • 更新中英文发布文档,并忽略本地 temp/ 目录。

平台说明

  • macOS 发布包已签名并公证;稳定版应用内更新使用 release workflow 生成的 GitHub Release 元数据。
  • Windows 安装程序为正式发布资产,但当前未配置 Authenticode 签名,安装时可能出现未知发布者或 SmartScreen 提示。
  • Windows 应用内更新保持禁用,请从 GitHub Releases 手动下载安装新版本。
v0.1.0

首次发布

  • 首个正式发布版本,提供 macOS Apple Silicon(arm64)与 Intel(x64)的签名公证安装包(DMG / ZIP)。
  • 包含完整的 Agent 工作台:会话管理、项目文件体验、模型与扩展管理、微信 / Telegram / 飞书消息渠道、托盘与通知、崩溃恢复与诊断导出。