PiDeck

English · LinuxDO 友链

一个用于管理多个 Pi和DSH编码 Agent 会话的开源桌面工作台。

国内 AtomGit 托管：https://atomgit.com/ayuayue/PiDeck

这是什么

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

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

PiDeck 不是 pi 的分支。它是一个轻量 Electron 外壳，通过启动多个 pi --mode rpc 进程，将项目管理、会话管理、对话界面、配置管理和工具编排整合到一个原生桌面应用中——所有 Agent 能力由 pi 原生提供，会话文件也由 pi 原生读写，PiDeck 不复刻、不劫持。除 pi 外，PiDeck 还深融合了 DSH（DeepSeek Harness） 后端，详见 DSH 后端。

❤️ 赞助商

Logo	简介
	88API Token聚合站 88API 是一站式多模型 API 聚合平台，平台由海外企业运营，稳定高效支持开票。平台提供 DeepSeek 官转和开源渠道，价格低至 5 折，完美适配PiDeck项目。一个 API Key 即可统一接入海内外多种模型，覆盖文本对话、图片、音频、音乐和视频生成接口，适用于 AI 编程、Agent 自动化、内容创作及应用开发。 立即注册 →

📑 目录

• PiDeck
  • 这是什么
  • 📑 目录
  • ✨ 核心亮点
  • 📋 更新日志
    • v0.7.6 更新亮点
  • 🧩 功能总览
    • 工作区与项目
    • 会话与对话
    • 文件 · Git · 终端
    • 模型与配置
    • 扩展与生态
    • 桌面与系统集成
  • 🐳 DSH 后端
  • 🏗️ 工作原理
  • 📦 下载安装
  • 🧰 快速开始（从源码运行）
  • ❓ 常见问题 FAQ
  • 🧑‍💻 开发指南
    • 浏览器预览模式
    • 项目结构
  • 🤝 参与贡献
  • 💬 社区交流
  • 🔒 安全与隐私
  • ☕ 赞助
  • License

✨ 核心亮点

• 🖥️ 多项目多会话并行 —— 一个窗口管理多个本地项目的全部 Agent 会话，项目间完全隔离。
• 🔌 三种会话后端 —— pi、DSH（DeepSeek Harness）、生图模式并存，同一项目下自由切换。
• 🧠 上下文感知输入 —— @ 文件引用、/ 斜线命令、! Shell 执行，全部在同一个输入框。
• 🗂️ 会话资产化 —— 历史浏览与恢复、Codex / Claude 会话导入、一键导出 HTML。
• 🛠️ 配置可视化 —— pi 的 models.json / auth.json / settings.json 免手写 JSON，连接测试一键直达。
• 📊 用量看得见 —— 供应商余额/额度查询 + 本地会话用量统计（热力图、每日/模型/项目维度）。
• 🧰 工作台全家桶 —— 文件树、Git 面板、内置终端、内置浏览器、草稿本，不用来回切窗口。
• 🐾 有温度的桌面集成 —— 桌面宠物、主题切换、系统托盘、飞书机器人、局域网 Web 访问。

📋 更新日志

最新版本 v0.7.6（2026-09-17）

v0.7.6 更新亮点

• 🚀 全局快捷键自定义
• 🚀 Ctrl/Cmd+P 命令面板
• 🚀 提示词商店官方模板与内置技能热更新
• 🚀 提示词商店新增 WB 增强提示词模板
• 🚀 项目级定时任务，管理改模态弹框
• 🚀 会话 Tab 栏「当前会话操作」
• 🚀 会话内文件路径链接右键菜单
• 🚀 侧栏与 Tab 菜单可直接复制 Agent ID
• 🚀 DSH 权限按钮与 pi 安全等级菜单统一（#214）
• 🚀 提问卡支持直接回车提交
• 🚀 导入 Cursor Agent 会话
• 🚀 官方安装包不再随 DSH runtime
• ✨ 生图会话不再因 base64 落盘撑爆渲染进程
• ✨ 渲染进程 OOM 分层治理
• ✨ 常驻缓存补字节预算
• ✨ 超大会话不再打不开 / 闪退

查看完整更新日志 →

🧩 功能总览

工作区与项目

会话与对话

文件 · Git · 终端

模型与配置

扩展与生态

桌面与系统集成

🐳 DSH 后端

除 pi 外，PiDeck 还深融合了 DSH（DeepSeek Harness，DeepSeek 官方 Agent Harness）：同一项目下 pi 与 DSH 会话并存、自由切换浏览，会话列表与头部均有 pi / DSH 徽标区分。

• 零端口深融合 —— DSH host 以 utilityProcess 内嵌引导运行，无 dsh web、无监听端口、无后台 HTTP，懒启动不拖慢应用打开速度。
• 完整会话能力 —— 历史分页浏览、fork（从锚点裁剪分叉，fork 点文案回填输入框）、/compact 压缩上下文；应用重启后自动恢复原会话。
• 审批与提问桥 —— DSH 的审批请求 / 提问通过桌面 Ask 弹窗应答，与 pi 会话体验一致。
• DSH 配置管理页 —— 设置页 DSH 分页：settings / credentials 可视化编辑（schema 驱动表单）、host 级模型目录、host 状态与重启。
• 技能目录与命令补全 —— 会话工具面板展示可调用的 DSH 技能（/name 直呼），Composer / 菜单实时枚举 host 注册的命令（含用户/插件注册）。
• 用量查询与导出 —— DSH 模型配置页同款供应商用量显示，凭据读取 DSH 官方凭据库；历史会话可导出为自包含 HTML。

启用方式： 在设置页的 DSH 分页完成配置后，新建会话时选择 DSH 后端即可。

🏗️ 工作原理

PiDeck
├─ Electron 主进程
│  ├─ 管理项目记录
│  ├─ 启动 pi --mode rpc 进程（每个会话一个独立进程）
│  ├─ 内嵌 DSH host（utilityProcess，无端口、无后台 HTTP）
│  ├─ 管理 Agent 绑定的本地 pty 终端
│  ├─ 桥接文件、会话、Git 操作
│  ├─ 检查应用与 Pi CLI 更新
│  └─ 暴露最小化、经校验的安全 IPC API
│
├─ Electron Preload
│  └─ 经 contextBridge 向 Renderer 暴露 window.piDesktop
│
├─ React Renderer
│  ├─ 项目 / 会话列表与会话时间线（流式输出）
│  ├─ 文件 / 历史 / Git / 浏览器抽屉
│  ├─ 配置管理 / 技能商店 / 提示词库
│  ├─ Agent 绑定的 Terminal Dock
│  ├─ 模型与上下文状态栏
│  └─ 设置 UI（常用 / 外观 / 代理 / Web 服务 / 桌面宠物 / 视觉桥 / 生图 等）
│
└─ Pi 运行时
   ├─ 每个 Agent 会话一个独立 pi RPC 进程
   ├─ 项目级 cwd 隔离
   └─ 使用 pi 原生会话 / 工具 / 模型 / 上下文

核心设计原则：一个 Agent 会话 = 一个 pi RPC 进程，确保会话隔离，让 pi 继续负责其原生能力；PiDeck 与 pi 之间只通过 stdio JSON-RPC 通信。DSH 后端以 utilityProcess 内嵌引导，同样不引入额外网络端口。

📦 下载安装

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

👉 GitHub Releases

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

环境要求：

• 系统 PATH 中可访问 pi 命令
• 已完成 pi 的 Provider / 登录 / API Key 配置

验证 pi 是否可用：

pi --version
pi --mode rpc

🧰 快速开始（从源码运行）

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

环境要求：Node.js 20+、npm。

❓ 常见问题 FAQ

Q：PiDeck 和 pi 是什么关系？会改动我的会话文件吗？

A：PiDeck 是 pi 的桌面外壳（不是分支）：Agent 行为、工具调用、会话读写、模型调用全部由 pi 原生完成，PiDeck 只负责窗口管理、进程生命周期、会话浏览、Git 面板、终端和设置这些「框架层」的事，两者通过 stdio JSON-RPC 通信。pi / DSH 会话仍由各自后端原生读写，PiDeck 不改变原有会话格式；导入的 Codex / Claude 会话会转换为 PiDeck 历史副本，不影响原文件。

Q：启动后提示找不到 pi？

A：PiDeck 依赖系统 `PA