內建 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 繼續使用手動更新。