更新日誌

記錄 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 / 飛書訊息渠道、托盤與通知、崩潰恢復與診斷匯出。