更新日志

本次版本完整接入 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 继续使用手动更新。

本次版本新增可观察、可控制的受管后台进程，让 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 继续使用手动更新。

本次版本新增聊天字号与对话宽度设置，并重构 @ 文件引用候选，让大型非 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 继续使用手动更新。

本次版本修复 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 继续使用手动更新。

本次版本带来端到端本地文件体验：聊天可附加任意文件，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

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

新会话自动命名

• 使用当前会话选择的模型在后台生成标题，并实时更新侧边栏；标题请求独立于会话历史和上下文缓存。
• “设置 → 通用 → 会话”新增“自动命名新会话”开关，默认启用并完整支持中英文。
• 模型不可用或请求失败时使用本地标题兜底；统一清理引号、换行和末尾标点，并限制为 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 继续使用手动更新。

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

对话滚动体验

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

下载

• 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

本次版本为 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

本次版本重点简化模型配置和飞书 / 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 继续使用手动更新。

本次版本将内置 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 继续使用手动更新。

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

主要更新

• 新增增量会话索引，根据文件指纹复用未变化的会话元数据，并由文件监听器定向刷新受影响的会话。
• 会话首次打开优先加载最近 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 继续使用手动更新。

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

内置浏览器

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

本次版本重点引入跨平台开发工具管理，并补齐 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 当前使用手动更新。

新增

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

安全与可靠性

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

修复

• 模型请求失败时直接在对话中展示错误，不再静默渲染空白的助手回复；保留提供商的错误详情（例如 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 手动下载安装新版本。

首次发布

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