$ cat ~/map/pi-desktop.md

Pi Desktop

开源 macOS 桌面客户端：经 JSONL RPC 驱动本地 pi，管理项目、流式对话与扩展。

tools✓ 10月15日

从源码构建：Node.js 22 或更高、package.json 声明版本的 pnpm、以及 Tauri 2 所需的 Rust 平台工具链；然后 pnpm install 与 pnpm desktop。浏览器预览用 pnpm dev。要让 agent 真正干活，需要一个配置好模型 provider 的本地 pi 安装。

## 速览

Pi coding agent 的开源 macOS 桌面客户端：经 JSONL RPC 驱动本地 pi 可执行文件、复用该安装的模型与登录，每个项目独享一个 pi 进程，配流式对话、命令浏览与扩展管理。

## 要点

• $应用经 JSONL RPC 连接本地 pi 可执行文件，直接使用该安装已配置的模型与登录；检测会查 PATH 及常见安装位置（含 Volta 与 Homebrew），也可以填入可执行文件的绝对路径。
• $每个项目运行自己的 pi 进程；项目内的会话经 new_session 与 switch_session 切换，回到项目会复用进程并恢复其会话，退出应用时这些子进程一并停止。
• $对话流式渲染 Markdown，带代码高亮、可展开的工具输出、编辑 diff、文件附件与停止/重试控制；项目侧可打开文件夹、新建与切换会话、按标题与消息全文搜索、置顶或重命名、导出 Markdown。
• $命令视图浏览 pi 内置命令、扩展命令、技能与提示词模板——可搜描述与来源、查看用法、把受支持的命令插入草稿；在命令详情里可用 /compact 压缩当前对话。
• $扩展可直接在应用内管理：浏览已装包、按热度或发布时间发现 npm 包、比对已装与最新版本、安装或卸载、启用或停用、单个或全部更新。
• $其余能力：按名称、provider 或 ID 搜索模型（含最近使用与思考档位）；用量视图显示上下文、token 合计与估算成本；首启引导带 Pi 环境检查；浅色、深色与系统主题，界面支持英文与简体中文。

## 常见问题

## 参考链接

• README（功能、截图、上手） ↗

最后更新: 2026年10月15日