ayuayue/PiDeck

PiDeck – Pi 与 DSH 编码代理的桌面工作台

它是什么

• PiDeck 是一款开源桌面应用（基于 Electron + React/TypeScript 构建），作为 pi 编码助手 CLI 和 DSH（DeepSeek Harness） 的图形化外壳。它并不替代 pi；它仅以 rpc 模式启动 pi（或 DSH）进程，并提供一个统一界面来管理多个项目和多个代理会话。

适用人群

• 在本地使用 pi 或 DeepSeek 代理的开发者，希望有一个单一窗口可以：
  • 为多个代码库维护独立的工作区。
  • 浏览、搜索和导出对话历史。
  • 查看 Git 状态、编辑文件、运行终端以及配置模型，而无需离开界面。
  • 导入旧的 Codex/Claude 会话文件，并将其转换为 PiDeck 兼容的历史记录。

主要功能

领域	PiDeck 的功能
多项目工作区	添加、排序和切换本地项目文件夹；每个项目运行其独立的 pi RPC 进程。
会话管理	创建、重命名、复制、删除、导出（HTML）和重启会话；支持 pi 和 DSH 后端，以及一个与 OpenAI 兼容图像 API 通信的“图像生成”模式。
丰富的输入辅助	@ 文件引用、/ 命令面板、! shell 执行——全部来自单个聊天框。
文件与 Git 集成	带 Git 状态徽章的文件树、内置编辑器、外部编辑器快捷键、Git 分支选择器，以及与活动代理关联的终端坞。
模型与凭证界面	models.json、auth.json、settings.json 的可视化编辑器；一键连接测试；提供商级别的用量与余额显示；代理配置。
扩展与技能商店	启用/禁用内置扩展，浏览社区 技能 和 提示词 市场，安装中文提示词合集（XuePrompt）。
桌面端完善	系统托盘、主题切换、桌面宠物吉祥物、通知、飞书机器人同步、局域网可访问的 Web 界面、进程监视与日志查看器。
DSH 深度集成	嵌入式 DSH 主机作为 Electron 工具进程运行（无需额外端口）。提供完整的会话浏览、命令补全、用量统计和凭证编辑功能。

工作原理

• Electron 主进程为每个会话启动一个单独的 pi --mode rpc 进程和一个嵌入式 DSH 主机。通信通过 stdio JSON-RPC 进行，保持代理隔离。
• 预加载脚本通过 contextBridge 向 React 渲染进程暴露一个受限的 window.piDesktop API。
• 渲染进程（React）显示项目列表、聊天时间线、文件资源管理器、Git 面板、终端坞、设置等。
• 配置文件通过可视化界面直接编辑；更改在相应代理重启后生效。

开始使用

1. 安装 pi CLI，并确保它位于你的 PATH 中（pi --version）。
2. 从 GitHub Releases 页面下载相应的安装程序（Windows/macOS/Linux）。还提供单独的 PiDeck Dev 预发布渠道。
3. 运行应用，添加项目文件夹，并创建一个新的 pi 或 DSH 会话。
4. 使用侧面板编辑 models.json 等，或打开内置终端运行命令。

开发

• 需要 Node 20+ 和 npm。
• 典型工作流：npm install && npm run dev 启动带有热重载的 Electron 窗口。
• 构建命令（npm run dist:*）为每个平台生成安装程序；dist:*:dev 创建并行的开发渠道。

许可证与社区

• 采用 MIT 许可证，拥有活跃的中文社区（QQ/微信群）和 GitHub 上的公开问题跟踪器。

简而言之，PiDeck 是一个功能齐全的桌面 IDE 风格包装器，让你可以并排运行多个本地 AI 编码代理，保持对话有序，并与代码库和工具紧密集成。

---

仓库元数据

• 状态：实验性（v0.9.0，2026-10-14）
• 平台：Windows | macOS | Linux
• 核心技术：Electron 38, React 19, TypeScript
• 许可证：MIT

---

以上所有细节均直接取自项目 README。