$ cat ~/map/pideck.md
PiDeck
pi 编码 agent 的原生桌面 GUI——流式聊天、工具调用检查器、会话、内置扩展/技能/主题包管理器、git 集成，并提供中英双语界面。
tools✓ 10月16日
事实速查
- GitHub Stars
- ★ 106
- Forks
- 11
- 许可证
- MIT
- npm / 月
- —
- 最后推送
- 2026年9月13日
## 速览
pi 编码 agent 的原生桌面应用（Tauri 2，支持 Windows 11 与 macOS Apple Silicon/Intel）——流式对话与工具可视化、会话与工作区、模型切换、内置 Git、工作区 Dock 与 pi 包管理，集成在一个可视化工作台里。
## 要点
- $流式对话：实时看到 agent 思考、调用工具与流式返回结果，支持一键中止与自动会话恢复；会话可跨项目浏览、搜索、新建与重开，历史精确恢复到上次中断处。
- $模型与 provider 在界面里切换——provider、模型与 thinking 档位，并按会话展示用量；扩展可在应用内渲染自己的交互面板，旁边还有集成的工作区终端。
- $内置 Git：无需离开应用即可审查变更、按 hunk 暂存或取消暂存、浏览分支历史；Workspace Dock 提供项目文件树、在提示词中引用文件、内嵌浏览器标签页与并排终端。
- $包管理：浏览 pi.dev 目录，安装并管理用户级 Extensions、Skills、Prompts 与 Themes；自带 PiDeck、Vercel、Apple 三套主题，快捷键与右键菜单可自定义，界面支持英文与简体中文。
- $内置 pi SDK 与自带 Node 运行时（Windows 版还打包了 Git），可独立运行——无需全局 pi 可执行文件或 Node 环境；与 pi CLI 共享 ~/.pi/agent 的认证、模型设置与用户级包，以及各工作区的 .pi 目录。
- $安全边界：只加载 ~/.pi/agent 下的用户级包，打开工作区不会运行 <workspace>/.pi/extensions，并支持原地自动更新；安装包为早期访问构建——Windows 版尚无受认可的 Authenticode 签名，macOS 版可能仅为 ad-hoc 签名。
## 常见问题
Q 从哪里下载？
到 GitHub releases 页面获取安装包：Windows 11 x64 用 PiDeck_<version>_x64-setup.exe，macOS Apple Silicon 用 PiDeck_<version>_aarch64.dmg，Intel 用 PiDeck_<version>_x64.dmg。从源码构建需要 Node >=22.19.0、pnpm 9.15.0、Rust stable 与 Tauri 2 前置依赖。
Q 能和 pi CLI 同时使用吗？
能——两者共享 ~/.pi/agent（认证、模型设置、用户级包）与各工作区的 .pi 目录（会话与历史）。PiDeck 不加载 <workspace>/.pi 下的项目级包；建议 CLI 版本与 PiDeck 固定的 SDK 版本保持接近，并避免同时在两个应用里编辑同一会话。
## 参考链接
## 相关条目
最后更新: 2026年8月31日