PiDeck

English · LinuxDO 友链

一个用于管理多个 pi 编码 Agent 会话的桌面工作台。

PiDeck 是一个开源的桌面工作台，用于在本地项目目录中统一管理 pi Agent 会话，并支持导入 Codex、Claude 本地会话以便统一浏览和恢复。基于 Electron + TypeScript 构建，提供多项目工作区、AI 会话管理、Git 集成、内置终端、模型配置和插件扩展能力，让本地 AI 编码助手在多项目环境中保持统一、可追溯、可配置。

适合谁用： 希望在桌面端同时管理多个本地项目的 AI 编程助手会话、需要统一查看会话历史与 Git 状态、并希望以图形化方式管理 pi 配置的开发者。

PiDeck 不是 pi 的分支。它是一个轻量 Electron 外壳，通过启动多个 pi --mode rpc 进程，将项目管理、会话管理、对话界面、配置管理和工具编排整合到一个原生桌面应用中——所有 Agent 能力由 pi 原生提供。

📋 更新日志

最新版本 v0.6.5（2026-07-13）

v0.6.5 更新

• 🚀 Prompt 模板系统：全新模板管理、内置模板、/ picker 快速插入、变量占位符
• 🚀 Prompt/Skill 商店：集成 prompts.chat 和 Yao Open Prompts（121 个中文 Prompt）
• 🚀 Git Worktree 工作区：分支管理、会话按 worktree 分组
• 🚀 消息多选 & 分享：多选转发、复制文字/图片
• 🚀 内置浏览器预览：右侧抽屉浏览网页，支持多标签、全屏和移动端视口
• 🚀 会话管理器：右键项目打开、多选删除、来源筛选
• 🚀 外部编辑器集成：右键项目直接「打开方式」选择编辑器
• 🚀 xhigh 推理级别支持
• ✨ 公共 MonacoEditor 组件抽取、统一图标按钮、统一弹框尺寸
• 🐛 Windows 启动崩溃修复（0x80000003）
• 🐛 pi 压缩后进程重启断连修复、Extension RPC 生命周期修复
• 🐛 消息交错渲染、分片 text 竖排显示、思考状态动态读取、工作区会话加载修复
• 🔧 会话打开性能优化、IPC 裁剪、清理调试日志

查看完整更新日志 →

核心功能

截图

工作区与对话界面

Markdown 渲染 + 流式输出、活动轨迹、工具调用详情、回答级修改文件摘要、模型/思考等级/上下文/缓存状态栏、Git 分支选择器、操作按钮（New Session · Stop · Restart · Files · History · Terminal）。

配置管理

可视化编辑器：Models（Provider 卡片 + 模型网格 + 连接测试）、Auth（API Key 管理）、Settings（类型感知的键值编辑器）、源文件（原始 JSON 编辑）——保存后可按需重启 Agent 生效。

斜线命令与会话历史

内置斜线命令建议面板（带功能说明），配合右侧历史会话抽屉，快速浏览和恢复过往对话。

文件树与会话操作

项目文件树（含 Git 状态标识）、输入框 @ 文件引用建议、Files 面板顶部的本次会话修改列表、会话右键菜单（重命名 · 复制 · 导出 HTML · 删除 · 关闭 Agent）。

架构设计

PiDeck
├─ Electron 主进程
│  ├─ 管理项目记录
│  ├─ 启动 pi --mode rpc 进程
│  ├─ 管理 Agent 绑定的本地 pty 终端
│  ├─ 桥接文件、会话、Git 操作
│  ├─ 检查 GitHub Release 更新
│  └─ 暴露安全 IPC API
│
├─ Electron Preload
│  └─ 向 Renderer 暴露 window.piDesktop
│
├─ React Renderer
│  ├─ 项目和 Agent 列表
│  ├─ 聊天时间线（流式输出）
│  ├─ 文件 / 历史抽屉
│  ├─ 配置与 Skill 管理弹窗（配置管理 / Skills）
│  ├─ Agent 绑定的 Terminal Dock
│  ├─ 模型与上下文状态栏
│  ├─ 会话结束修改摘要与更新提示弹窗
│  └─ 设置 UI（基础设置 / 代理设置 / 开发设置）
│
└─ Pi 运行时
   ├─ 每个 Agent Tab 一个独立 pi RPC 进程
   ├─ 项目级 cwd 隔离
   └─ 使用 pi 原生会话 / 工具 / 模型 / 上下文

核心设计原则：一个 Agent Tab = 一个 pi RPC 进程，确保会话隔离，让 pi 继续负责其原生能力。

环境要求

• Node.js 20+
• npm
• 系统 PATH 中可访问 pi 命令
• 已完成 pi 的 Provider / 登录 / API Key 配置

验证 pi 是否可用：

pi --version
pi --mode rpc

下载安装

Windows、macOS、Linux 平台的预构建安装包在 GitHub Release 中发布：

👉 GitHub Releases

PiDeck 需要单独安装 pi CLI 并确保其加入系统 PATH。

快速开始（从源码运行）

git clone https://github.com/ayuayue/PiDeck.git
cd pi-desktop
npm install
npm run make-icon
npm run dev

开发命令

浏览器预览模式

直接打开 http://localhost:5173/ 进行布局和响应式调试。Renderer 在 window.piDesktop 不可用时自动降级为 mock 数据，无需 Electron 环境。但涉及 Agent、会话、文件操作等真实 IPC 功能仍需在 Electron 中验证。

项目结构

src/
├─ main/
│  ├─ fs/                 # 文件树服务
│  ├─ git/                # Git 分支服务
│  ├─ pi/                 # Pi 进程与 RPC 管理
│  ├─ projects/           # 项目记录持久化
│  ├─ sessions/           # Pi 会话扫描
│  ├─ settings/           # 应用设置持久化
│  ├─ terminal/           # Agent 绑定的 pty 终端
│  └─ index.ts            # Electron 主入口
│
├─ preload/
│  └─ index.ts            # 安全 IPC 桥接
│
├─ renderer/
│  └─ src/
│     ├─ App.tsx          # 主界面
│     ├─ components/      # 拆分后的 UI 组件
│     ├─ config/          # 配置弹窗子组件和配置工具
│     ├─ previewApi.ts    # 浏览器预览降级
│     ├─ styles.css       # 应用样式
│     └─ main.tsx         # React 入口
│
└─ shared/
   ├─ ipc.ts              # IPC 通道名称
   └─ types.ts            # 共享类型定义

更新日志

详细版本历史请查看 CHANGELOG.zh-CN.md（中文）或 CHANGELOG.md（英文）。

贡献者

感谢所有为 PiDeck 做出贡献的人！完整名单请查看 CONTRIBUTORS.md。

QQ 交流群

欢迎加入 PiDeck QQ 群进行交流、反馈和讨论：

1026218644

安全说明

本应用启动本地 pi 进程并通过 Electron IPC 暴露有限的文件操作。请仅运行你信任的源码。应用默认发送匿名、低频的 app_heartbeat 使用统计，用于了解版本分布、平台兼容性和活跃安装数量，可在设置中关闭；不会收集项目路径、代码、消息内容、会话内容或文件名，也不会上传文件。第三方统计服务会接收请求元数据。pi agent 子进程代理和桌面端模型拉取/测试代理可独立配置；系统浏览器打开的外部链接仍由系统浏览器网络设置决定。

License

MIT