justhil/pi-app

解決的問題

pi Desktop 為 pi 編碼代理提供圖形化使用者介面（GUI），免除必須透過終端與代理互動的需要。它透過加入視覺化差異檢視、可點擊的會話樹以導航聊天歷史，以及在代理仍在處理時排隊訊息的能力，解決常見的終端式限制。

如何運作

此應用作為現有 pi SDK 的桌面外殼運作。它與 CLI 版本共用相同的設定檔、模型登入資訊與擴充設定，皆位於 ~/.pi/agent 目錄中。為支援擴充功能，它使用相容性層與「適配器」（JSON 描述），將終端式使用者介面（TUI）轉譯為原生桌面視窗與時間軸卡片，無需對原始 npm 套件進行任何修改。

適用對象

使用 pi 編碼代理且偏好視覺化工作區而非終端介面的開發者，或希望以更直覺方式管理會話與檢視程式碼變更的開發者。

主要特色

• 串流時間軸：顯示 Markdown、程式碼區塊與行級差異，支援摺疊工具步驟。
• 會話樹：可點擊的介面，用於分支與回溯對話，支援透過 git 選擇性還原檔案。
• 作曲家：支援內嵌檔案附件、圖片貼上與拖曳檔案整合。
• 工作區預覽：多標籤檔案預覽，搭配行邊距原始碼檢視與可擴展的聊天欄。
• 擴充相容性：透過適配器將 TUI 元素轉換為原生 UI，完全支援 pi 套件生態系。
• 語音輸入：使用內建的 codex-asr 二進位檔進行本地語音指令轉錄。