pi Desktop

pi-desktop·justhil.piDesktop

面向个人开发者的 pi 桌面 GUI

面向个人开发者的 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)。

winget install --id justhil.piDesktop --exact --source winget

Latest 0.5.7·August 12, 2026

Release Notes

pi Desktop v0.5.7 新增

  • WSL 原生运行时:支持在指定 WSL 发行版内启动 Pi Worker、读取会话与资源并执行 Git / Preview;设置页可探测、切换和诊断发行版,Host / WSL 切换时会安全停止旧运行时
  • 子 Agent 运行可视化:Composer、Timeline 与侧栏展示子 Agent 的运行进度、预览与结果,支持从父会话只读定位子会话,同时保持后台会话继续运行
  • 侧栏项目固定顺序:可选择固定项目排列;默认仍保留最近使用顺序 修复
  • #48 冷启动与首次点击卡顿:会话列表、历史消息和会话树解析移至独立 Preview utility process,Review Git 快照改为异步;大历史会话与大仓库加载不再阻塞 Electron Main
  • #51 /skill 正文污染消息:模型仍接收完整 Skill 上下文,但 Timeline、历史、排队与输入恢复只显示原始 /skill:name 命令;Skill 读取改为“载入 Skill 上下文”语义,不再伪装成普通文件工具
  • #82 内层滚轮被外层抢走:代码块、Markdown 代码、思考内容及 Context 展开消息拥有独立滚动边界,鼠标滚轮不再带动外层 Timeline / 面板
  • #41 更新检查与系统代理:手动检查明确区分“有更新 / 已是最新 / 检查失败”,更新包下载统一使用 Electron 网络栈,遵循系统代理与 PAC
  • #40 模型设置与当前 Pi SDK 不一致:默认模型和 Composer 只显示用户配置或已登录可用模型;用户供应商与 Pi SDK 只读目录分层展示,避免混淆
  • 无 Worker 时设置无法保存:冷启动后未打开会话也可保存 Pi 默认模型和全局设置;Host、global / user SDK 与 WSL 均使用 SDK SettingsManager 的合并和锁语义
  • 系统提示词预览误启动 Worker:Worker 未启动时改由隔离的 Preview utility 在内存中组装最终提示词;不占用 Session Worker 池,不创建会话、认证或模型文件,也不执行扩展、安装 package 或发起模型网络请求
  • 多 Worker Extension UI 串话:问答弹窗按请求来源路由响应与取消;后台 Worker 不再覆盖前台弹窗,无法展示的后台交互会立即取消而非永久等待,Worker 退出和会话切换会清理悬挂请求
  • 会话状态隔离:瞬时 Worker 状态查询失败不再误判 idle;切换会话、Home 或新会话时清除旧运行快照,停止按钮和运行标记不再跨会话复活
  • 会话树旧数据回填:打开或切空会话时刷新请求代际,迟到的旧会话树不会覆盖当前视图
  • 长输入光标不可见:Composer 超过最大高度后保持 caret 可见,并消除 MutationObserver / caret probe 的反馈循环
  • 小窗口布局覆盖用户偏好:窄窗仅临时压缩左右面板,放大后恢复持久化宽度 优化
  • 模型列表即时打开:应用启动后预热共享可用模型缓存;Composer、/model 与默认模型下拉立即显示缓存并后台刷新,失败时保留旧选项
  • 大型会话列表性能:读取会话标题和工作区信息时只扫描 JSONL 头部,不再加载整个 transcript
  • 项目切换体验:按工作区缓存会话列表,减少切换时清空、闪烁与排序跳动;新建或 Fork 后优先使用实时列表
  • SDK 安装与切换安全性:user SDK 使用独立 generation 路径避免 ESM 旧模块缓存;验证失败可回滚到原 user generation,并同步刷新 Preview 与模型目录 注意
  • WSL 模式需要目标发行版内可用的 Node.js 与 Pi SDK;切换发行版后会重启相关 Worker / Preview 进程
  • “用户配置的供应商”仍只写 ~/.pi/agent/models.json;“当前 Pi SDK 供应商”是脱敏只读目录,不会回写 auth.json 或 models-store.json

安装包见本页 Assets。更新说明以本正文为准(应用内「发现新版本」弹窗会展示)。

Installer type: nullsoft

x64user7B5B1340CD6FB1CF592F9952A82DCF9D91F788D2FDC406877D412BCBC7449652
x64machine7B5B1340CD6FB1CF592F9952A82DCF9D91F788D2FDC406877D412BCBC7449652

Details

Homepage
https://github.com/justhil/pi-app
License
免费软件
Publisher
pi-desktop
Support
https://github.com/justhil/pi-app/issues

Tags

pipi-agent人工智能代码大语言模型智能体编程聊天机器人自主智能

Older versions (19)

0.5.6
x64userB329BA0EBCFFF8F5EA5043FF7F521365BB65794663C972AAE74293B68BCBC992
x64machineB329BA0EBCFFF8F5EA5043FF7F521365BB65794663C972AAE74293B68BCBC992
0.5.5
x64user1AA5045B9B99AFF43ED0DA47C5FF3C54D3B15BCAA5277833DA49E5EF1DE05235
x64machine1AA5045B9B99AFF43ED0DA47C5FF3C54D3B15BCAA5277833DA49E5EF1DE05235
0.5.4
x64user6F8B61F64B35764B6DB39723C182D9E720964D1D688DC911E21EF1CA33EBED07
x64machine6F8B61F64B35764B6DB39723C182D9E720964D1D688DC911E21EF1CA33EBED07
0.5.3
x64user9B9FBBFFDD457D3E6F968184A565020D1A6F911009B42B1D9DB24F7D5DEAC867
x64machine9B9FBBFFDD457D3E6F968184A565020D1A6F911009B42B1D9DB24F7D5DEAC867
0.5.2
x64user47CD350A083A2D1BF104B4B18070B8C8CA755EC9F4A4B6B3CA3A1FBD3F998390
x64machine47CD350A083A2D1BF104B4B18070B8C8CA755EC9F4A4B6B3CA3A1FBD3F998390
0.5.1
x64user44EA7298C5B5117F0F5B52C0DC51BB53FE470389329A3A7321FA58CC1A50CDE8
x64machine44EA7298C5B5117F0F5B52C0DC51BB53FE470389329A3A7321FA58CC1A50CDE8
0.5.0
x64userFCAF4EC42ED8165D2B41C276110A66A3C2CAA79F6736C78B749C1ADBAB6A9D20
x64machineFCAF4EC42ED8165D2B41C276110A66A3C2CAA79F6736C78B749C1ADBAB6A9D20
0.4.20
x64user3439E9758B85A67DC364D0C5AA821DFB839D649E5095E3F909DF46FFA45751D2
x64machine3439E9758B85A67DC364D0C5AA821DFB839D649E5095E3F909DF46FFA45751D2
0.4.19
x64user46A1C69D0F98E01D796277EE2E649C67042C6D4E6D09DB76005B449A510F0DFC
x64machine46A1C69D0F98E01D796277EE2E649C67042C6D4E6D09DB76005B449A510F0DFC
0.4.18
x64userD5BEA9587BCDFA7821FB484629457CC918EBF883B202BED380C3A33734DF033A
x64machineD5BEA9587BCDFA7821FB484629457CC918EBF883B202BED380C3A33734DF033A
0.4.17
x64user5182E22BCA5A521BA0A68036FDE9495ADB721A5E7D1F571F12EA925FE3E09C92
x64machine5182E22BCA5A521BA0A68036FDE9495ADB721A5E7D1F571F12EA925FE3E09C92
0.4.16
x64user1C908B2D305C0FA43C98B96D8CB08BDB19799AA9941F452C141B658A0B3309A6
x64machine1C908B2D305C0FA43C98B96D8CB08BDB19799AA9941F452C141B658A0B3309A6
0.4.15
x64userD7081C4E85477E50548C138158A3081DF542235AE0AECBCC158947CBDB6B8650
x64machineD7081C4E85477E50548C138158A3081DF542235AE0AECBCC158947CBDB6B8650
0.4.14
x64userB55AFF14B1CAE92AF543A4ED048790B76FE632CF26F3A86E7B2A74C29327905A
x64machineB55AFF14B1CAE92AF543A4ED048790B76FE632CF26F3A86E7B2A74C29327905A
0.4.13
x64user727BF94F0515A35FBC4DADFEA2CE2E64B88A957C5ECEB7AB6BBAF69A645D0344
x64machine727BF94F0515A35FBC4DADFEA2CE2E64B88A957C5ECEB7AB6BBAF69A645D0344
0.4.12
x64user3790006F5DE270496D5150B199B2BFA3CDDE0E50F9F72465ED8D8AB3D9FC0566
x64machine3790006F5DE270496D5150B199B2BFA3CDDE0E50F9F72465ED8D8AB3D9FC0566
0.4.11
x64user59A91895D8C7CB31D5436CE8C9D9EA7C228208FD36B1D77677369F665BCB9A18
x64machine59A91895D8C7CB31D5436CE8C9D9EA7C228208FD36B1D77677369F665BCB9A18
0.4.10
x64userDEB572759FE52189C3F8A8B226257394A2B3C6E80D9FA02EFEF6B503565A4D49
x64machineDEB572759FE52189C3F8A8B226257394A2B3C6E80D9FA02EFEF6B503565A4D49
0.3.8
x64user6143D629C956B0E252C65C6BE6FE2F2B98DD7864FC06F79275A442802871D0F9
x64machine6143D629C956B0E252C65C6BE6FE2F2B98DD7864FC06F79275A442802871D0F9