面向个人开发者的 pi 桌面 GUI:在 Electron 里跑 pi SDK,复用 ~/.pi/agent 的认证、配置与会话 JSONL,用时间线、工具卡片、改动审查和扩展兼容层替代终端里那套 TUI 交互。
核心思想
1. 会话以 pi 为准
- 对话内容、工具调用记录、分支与压缩信息,都以 pi 写在 ~/.pi/agent/sessions/ 里的 JSONL 会话文件为准。
- 桌面端不另建一套「聊天记录数据库」来替代 pi;本地只存窗口布局、最近项目、扩展开关、适配器覆盖等应用偏好。
- 好处:终端 pi 与桌面 pi 可以接着同一条会话用;卸载桌面也不丢对话历史。
2. 配置与认证与终端共用
- 模型账号、settings.json、扩展包列表(packages)、项目下 .pi/ 资源,与你在终端用的 pi 同一套路径与规则。
- 桌面在 设置 → Pi 里改的项会写回全局 settings.json(与终端一致);Skills 开关等也落在全局配置里,而不是只在桌面私有文件里「假启用」。
3. 扩展:兼容层 + 适配器,而不是改插件源码
- 扩展在终端里常用 TUI(选择、确认、问卷、工具结果卡片、/命令 进配置)。桌面没有终端画布。
- 兼容层:在应用内部统一接收扩展的 UI 请求,转成 Electron 对话框、时间线卡片、设置表单。
- 适配器:每个扩展一份「在桌面上怎么显示、怎么配、哪些命令特殊处理」的说明(内置在应用里,高级用户可用 JSON 覆盖)。
- 原则:不动扩展 npm 包、不 fork pi;差异写在适配器说明和文档里。
- 给 AI 写适配器:见仓库 doc/(adapter-authoring-guide.md 可整份发给模型定制 adapter.json)。
Maelezo ya mchapishaji (Kichina)
pi Desktop ni nini?
Programu pi Desktop inachapishwa na pi-desktop. Ni programu ya bure ya Windows iliyo katika kundi la “Wasaidizi wa AI na LLM”. Imeandikwa kwa TypeScript.
Usakinishaji na mahitaji
Mchapishaji hutoa visakinishi vya EXE (NSIS) kwa Windows ya 64-bit. Inaweza kusakinishwa kwa mtumiaji wa sasa pekee, bila haki za msimamizi. Usakinishaji kimya unawezekana kwa swichi zilizoandikwa za kisakinishi.
Masasisho na historia ya matoleo
Toleo la sasa ni 0.7.7, lililotolewa 25 Oktoba 2026. Historia ya matoleo inarudi nyuma hadi 23 Juni 2026: matoleo 30, yote yakiwa na viungo vya faili rasmi. Sasisho la mwisho lina umri wa chini ya mwezi mmoja.
Umaarufu na aina za faili
Msimbo chanzo kwenye GitHub (justhil/pi-app) una nyota 383. Programu zinazofanana ni pamoja na Claude Code, Codex CLI na ChatGPT.
Maelezo ya mradi kwenye GitHub: “Desktop app for the pi coding agent: streaming timeline, Git review with hunk staging, session tree, native UI for pi extensions. Windows · macOS · Linux. pi 编程 Agent 桌面客户端”
Faida / Hasara
Faida
- Bure kutumia
- Usakinishaji kimya umeelezwa
- Inasakinishwa bila haki za msimamizi
- Imesasishwa ndani ya miezi miwili iliyopita
Hasara
- Hakuna toleo asili la ARM64
Kwa ufupi: pi Desktop ni zana ya bure ya kundi la “Wasaidizi wa AI na LLM” kwa kompyuta za 64-bit. Wasimamizi wa mifumo wanaweza kuisambaza bila maswali.
Je, ni salama kupakua pi Desktop?
- Faili inatolewa na github.com, kikoa cha mchapishaji mwenyewe
- Kiungo cha kupakua kinatumia HTTPS
- Hashi ya SHA256 imechapishwa, hivyo unaweza kuthibitisha faili:
ECD3B32C913CD7BCAA691DF71BFCC07CEC079029A7ABFCA408A0D7E9C3B85ABD· Fungua ripoti ya VirusTotal ya hashi hii - Kiungo bado hakijakaguliwa
- ExeAtlas haihifadhi, haifungi wala haibadilishi visakinishi
Mwongozo unaohusiana: Jinsi ya kukagua hashi ya SHA256 ya faili kwenye Windows
Matoleo ya karibuni
Matoleo yote 30 ›| Toleo | Tarehe | Ukubwa | Faili |
|---|---|---|---|
| 0.7.7Jipya zaidi | 25 Oktoba 2026 | — | 64-bit EXE (NSIS)64-bit EXE (NSIS) |
| 0.7.6 | 19 Oktoba 2026 | — | 64-bit EXE (NSIS)64-bit EXE (NSIS) |
| 0.7.5 | 11 Oktoba 2026 | — | 64-bit EXE (NSIS)64-bit EXE (NSIS) |
| 0.7.4 | 8 Oktoba 2026 | — | 64-bit EXE (NSIS)64-bit EXE (NSIS) |
| 0.7.3 | 6 Oktoba 2026 | — | 64-bit EXE (NSIS)64-bit EXE (NSIS) |
| 0.7.1 | 6 Oktoba 2026 | — | 64-bit EXE (NSIS)64-bit EXE (NSIS) |
| 0.7.0 | 4 Oktoba 2026 | — | 64-bit EXE (NSIS)64-bit EXE (NSIS) |
| 0.6.2 | 2 Oktoba 2026 | — | 64-bit EXE (NSIS)64-bit EXE (NSIS) |
Kusakinisha kwa mstari wa amri
Usakinishaji kimya ›winget install --id justhil.piDesktop -epi.Desktop-Setup-0.7.7-x64.exe /SMwongozo unaohusiana: Jinsi ya kutumia winget: sakinisha na sasisha programu
Taarifa
- Mchapishaji
- pi-desktop
- Kategoria
- Wasaidizi wa AI na LLM
- Leseni
- 免费软件
- Bei
- Bure
- Msimbo chanzo
- github.com/justhil/pi-app
- Imeandikwa kwa
- TypeScript
- Inahitaji
- Windows 11 / 10
- Usanifu
- 64-bit
- Kisakinishi
- EXE (NSIS)
- Toleo
- 0.7.7
- Ilitolewa
- 25 Oktoba 2026
- Iliongezwa kwenye orodha
- 2 Julai 2026
- Matoleo yaliyoorodheshwa
- 30
- Nyota za GitHub
- 383
- Forks za GitHub
- 38
- Tovuti
- github.com
- Kitambulisho cha winget
- justhil.piDesktop
Ukadiriaji na maoni
Bado hakuna maoni. Kuwa wa kwanza kuikadiria.
Mbadala wa pi Desktop
Ona zote ›-
Ya umilikielfu 67.1 ↓ -
Chanzo huriaelfu 16.6 ↓ -
Chanzo huriaelfu 17.1 ↓ -
Chanzo huria654 ↓ -
Chanzo huriaelfu 8.7 ↓ -
Chanzo huriaelfu 3.3 ↓ -
Chanzo huriaelfu 1.9 ↓ -
Chanzo huriaelfu 14 ↓
Maswali yanayoulizwa mara kwa mara
Je, pi Desktop ni bure?
Ndiyo. pi Desktop ni bure kutumia.
Je, ni salama kupakua pi Desktop?
Faili inapakuliwa kutoka github.com, ambayo ni ya mchapishaji mwenyewe; ExeAtlas haihifadhi wala haibadilishi faili. Linganisha hashi yake ya SHA256 na ile iliyoonyeshwa hapa, au fungua ripoti ya VirusTotal ya hashi hiyo.
Jinsi ya kusakinisha pi Desktop kwa winget?
Fungua PowerShell au Windows Terminal na uendeshe amri ya winget iliyoonyeshwa kwenye ukurasa huu. winget hupakua kisakinishi rasmi na kukagua hashi yake ya SHA256 kabla ya kukiendesha.
Je, pi Desktop inaweza kusakinishwa kimya?
Ndiyo. Ukurasa wa usakinishaji kimya unaonyesha amri kamili kwa kila kisakinishi.
Je, pi Desktop inafanya kazi kwenye ARM (Windows on Arm)?
Hakuna toleo la ARM64; Windows 11 on Arm inaweza kuendesha toleo la 64-bit kupitia uigaji (emulation).
Wapi pa kupakua toleo la zamani la pi Desktop?
Ukurasa wa matoleo unaorodhesha matoleo 30 yote pamoja na viungo vya faili rasmi za kisakinishi, kuanzia 23 Juni 2026.
Je, pi Desktop inaweza kutumika bila haki za msimamizi?
Ndiyo, kuna kisakinishi cha mtumiaji mmoja kisichohitaji haki za msimamizi.
Ni programu gani mbadala wa pi Desktop?
Claude Code, Codex CLI, ChatGPT, oh-my-pi na GPT4All. Ukurasa wa mbadala unazilinganisha.