PiDeck 桌面工作台
在本地项目目录中统一管理 pi 和 DSH 编码 Agent 会话的桌面工作台，支持导入 Codex、Claude 会话，一站式浏览与恢复。
- Star 数
- ★ 1.1k
- 最近更新
- 今天
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 48/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 同时参与多个本地项目的开发者，希望在一个桌面窗口中按项目隔离地运行和切换多个 pi Agent 会话。
- 不适合
- 对稳定性要求高的生产环境团队（当前为实验性 beta）
- 只使用 DeepSeek 以外模型且不想额外配置供应商的用户
- 源码审查
- 48/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
PiDeck（GitHub: ayuayue/PiDeck，MIT 许可，当前版本 v0.7.4-beta，状态为 experimental）是一个基于 Electron 38 + TypeScript + React 19 构建的开源桌面工作台。它的核心设计是「一个 Agent 会话 = 一个 pi RPC 进程」：Electron 主进程为每个会话启动独立的 pi --mode rpc 子进程，通过 stdio JSON-RPC 通信，会话文件仍由 pi 原生读写，PiDeck 不复刻、不劫持。除 pi 外，它还通过 utilityProcess 内嵌融合了 DSH（DeepSeek Harness）后端，实现零端口、无后台 HTTP 的会话能力，并支持将 Codex、Claude（v0.7.4 起含 ZCode）本地会话导入为 PiDeck 历史副本继续浏览和恢复。功能上提供多项目工作区、会话历史管理、文件树与 Git 面板、内置终端 Dock、可视化模型配置（models.json / auth.json / settings.json）、供应商用量查询与本地用量统计、插件与 Skill 商店、桌面宠物和局域网 Web 访问。适合需要在桌面端同时管理多个本地项目 AI 编码助手会话的开发者。
PiDeck 是一个 Electron 外壳（不是 pi 的分支），运行流程为：用户添加本地项目目录后，主进程为每个 Agent 会话启动一个独立 pi --mode rpc 进程（项目级 cwd 隔离），PiDeck 与 pi 仅通过 stdio JSON-RPC 通信。具体功能包括：多项目工作区管理与项目隔离；会话新建、重命名、复制、导出 HTML、删除、重启与关闭；导入 Codex 和 Claude 本地会话并转换为 PiDeck 历史副本；DSH 后端支持历史分页、fork、/compact 上下文压缩、审批与提问桥；Composer 输入框支持 @ 文件引用、/ 斜线命令、! Shell 执行、计划模式和 Ask 并行问询；文件抽屉（含 Git 状态标识）与内置文件编辑器；GitService 提供分支显示、切换与新建分支；node-pty 内置终端多 tab Dock；可视化编辑 pi 的 models.json、auth.json、settings.json 并一键连接测试；供应商余额/额度查询与本地用量统计（热力图、每日/模型/项目维度）；Prompt & Skill 商店（prompts.chat、skills.sh）与 4000+ 中文提示词库（XuePrompt）；生图模式（OpenAI 兼容 /images/generations）；系统托盘、桌面宠物、飞书机器人、局域网 Web 服务和视觉桥等桌面集成。
- 同时参与多个本地项目的开发者，希望在一个桌面窗口中按项目隔离地运行和切换多个 pi Agent 会话。
- 此前使用 Codex 或 Claude CLI 的用户，想把散落的本地历史会话导入到统一界面中浏览和恢复。
- 需要会话历史可追溯的工程师，利用会话导出 HTML、刻度定位轴和回答级修改摘要来复盘 Agent 做了什么改动。
- 频繁切换模型供应商的团队，用可视化编辑器管理 models./auth.，并通过连接测试和余额查询避免手写 JSON 和排查配置错误。
- 希望在 IDE 之外获得工作台体验的用户，使用内置文件树、Git 面板、终端 Dock 和内置浏览器，减少窗口切换。
- 需要在飞书群同步 Agent 状态、或让局域网内其他设备通过 Web 访问会话的远程协作场景。
如何安装或部署这个 Agent？
方式一（预构建安装包）：从 GitHub Releases（https://github.com/ayuayue/PiDeck/releases）下载 Windows（NSIS/portable/zip）、macOS（DMG/zip，需手动安装）或 Linux（AppImage/deb/tar.gz）安装包。前提：系统 PATH 中需可访问 pi 命令（用 pi --version 验证），且已完成 pi 的 Provider / 登录 / API Key 配置。方式二（源码运行）：git clone https://github.com/ayuayue/PiDeck.git && cd PiDeck && npm install && npm run make-icon && npm run dev，需要 Node.js 20+ 和 npm。使用 DSH 后端需在设置页 DSH 分页完成配置。
如何使用这个 Agent？
- 启动 PiDeck，确认
pi --version可用；2. 在工作区添加本地项目目录（可搜索、拖动排序）；3. 新建会话时预选模型与思考档位，或选择 DSH / 生图后端；4. 在 Composer 中使用@引用文件、/调用命令、!执行 Shell，开启计划模式可先确认计划再执行；5. 通过侧栏管理会话（重命名/导出 HTML/导入 Codex 或 Claude 会话），Files 面板查看本次会话修改的文件，Git 面板查看分支与状态；6. 在设置页可视化编辑 pi 配置、测试连接、查看用量统计；7. 可选启用系统托盘、桌面宠物、飞书机器人或局域网 Web 服务。
这个 Agent 有哪些优点和局限？
- 会话隔离设计清晰：每个 Agent 会话对应一个独立 pi RPC 进程，会话文件由 pi 原生读写，不改变原有格式，降低数据被劫持的风险。
- 功能覆盖完整工作流：文件树、Git 面板、内置终端、可视化配置编辑、用量统计、会话导出 HTML 集成在单一应用中，减少窗口切换。
- 多后端并存：pi、DSH（DeepSeek Harness）和生图模式在同一项目下可自由切换，DSH 以 utilityProcess 内嵌运行，无额外端口和后台 HTTP。
- 跨平台预构建安装包齐全（Windows/macOS/Linux），且支持导入 Codex / Claude / ZCode 既有会话，迁移成本低。
- 硬依赖 pi CLI：必须在系统 PATH 中安装并配置好 pi（含 Provider/API Key），否则无法使用核心 Agent 能力。
- 项目状态为 experimental、版本 0.7.4-beta，仍处于早期阶段，可能存在稳定性风险。
- macOS 自动更新受限：更新需打开 GitHub Release 手动安装（Windows/Linux 才使用包内 updater）。
- DSH 后端锁定 DeepSeek 系模型；生图模式需单独配置生图供应商。
- 默认发送匿名 app_heartbeat 使用统计（可在设置关闭），对隐私敏感用户需要主动配置。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| PiDeck 桌面工作台 当前 | 48 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 1.1k | 今天 | TypeScript | — |
| Lime - 全能型桌面 AI 代理 | 44 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 1.5k | 1 天前 | TypeScript | — |
| CodePilot 多模型 AI 助手桌面客户端 | 47 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 6.5k | 1 个月前 | TypeScript | OpenAI API · Claude API |
| iPolloWork | 44 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 7.1k | 1 天前 | TypeScript | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据以 README 声明为主：声称'最小化、经验证的安全 IPC'与 contextBridge 隔离，但提供的源文件中没有主进程/IPC 代码可证实，最低权限只给 1；信任确认系统、更新重启确认均有文字描述但无代码佐证，用户确认 1；数据流方面对 app_heartbeat 心跳披露较完整（可关闭、不收集代码/路径），给 2；'不收集敏感数据'是无代码支撑的声明，给 1；依赖为宽泛 semver 范围、未见锁文件或审计证据，给 1；应用会派生 pi 进程、内嵌终端、局域网 Web 服务、飞书机器人，外部影响面大且仅有文字披露，给 1；回滚仅见 macOS 手动安装与导入会话保留原文件，无明确回滚机制，给 1；作者未经验证、有 contributors 与 MIT 署名，给 1。
README、package. 与徽章版本（0.7.4-beta）一致，架构描述自洽，自洽性 2；依赖 pi CLI 在 PATH、@deepseek-ai/dsh 系列为 rc 版本且含 file: 本地包，可用性风险有据，给 1；失败信息仅 FAQ 覆盖'找不到 pi'等少数场景，无错误码/日志规范文档，给 1。
目标用户（管理多项目 AI 编码会话的开发者）和使用场景描述清晰，给 2；自标 experimental、明确'不是 pi 的 fork'划定了部分边界，但能力上限、会话规模限制等未说明，给 1；斜杠命令、@引用等触发方式有描述但无精确定义，给 1；支持三平台、Node 20+、PATH 要求、代理设置均明确，环境适配 2。
README 结构完整（目录、特性表、架构图、FAQ、安全章节），信息架构 2；源码安装与验证步骤具体（npm install/dev、pi --version），安装说明 2；package 名为 pi-desktop 而产品名 PiDeck，命名不一致，给 1；FAQ 覆盖常见问题但无独立示例文档，给 2；除 experimental 徽章外无专门已知限制章节，给 1；LICENSE 文件完整 MIT，给 3；README 含 changelog 摘要并指向 CHANGELOG.md（文件未在证据中），版本化 2；维护路径为 GitHub Issues 与 QQ 群，无治理/发布节奏承诺，给 1。
会话 HTML 导出、历史浏览、文件变更摘要等输出可用性描述充分，给 2；相对手工管理 pi 会话有明显边际价值（统一工作台、多后端切换），给 2；MIT 免费、本地运行，成本收益合理，但引入大量 rc 依赖增加维护成本，未给满分。
多数关键声明（安全 IPC、不收集数据、隔离）无法在提供的文件中溯源到代码，给 1；package. 与 README 的版本、平台、脚本互相印证，但核心功能仅有两个边缘测试文件佐证，跨源印证 1；README 宣传语气与事实混合，未明确区分事实与推断，给 1。
- 本评估为静态审查、置信度低：所有安全声明（最小化 IPC、不收集数据、进程隔离）均未经代码或运行验证。
- 应用具有较大外部影响面：派生本地 agent 进程、内嵌终端、可开启局域网 Web 服务、绑定飞书机器人，启用前应逐一确认网络与文件访问范围。
- 默认开启匿名心跳遥测（可关闭），对遥测敏感的用户应在设置中主动关闭。
- 依赖中含多个 0.1.1-rc 版本的 @deepseek-ai/dsh 包与 file: 本地包，稳定性与供应链风险需自行评估。
- Deps 采用宽泛 semver 范围且证据中无锁文件，构建可复现性未知。
- 产品状态为 experimental，且要求外部 pi CLI 存在于 PATH，首次使用前请先验证 pi 可用。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
这一版的主线是「把细节看清楚」：轨迹检查器整体重做，每一轮真正装载的系统提示词、token 与耗时都能查到；对话里的图片终于能直接显示、放大、复制与另存；智能体从弹窗变成可管理的市场，划词翻译与输入预测这类一次性调用收进同一套侧车。性能也补了一轮：冷启动的会话扫描从 3994ms 降到 105ms，首屏少加载 0.86MB，安装包小 6.3MB。 🚀 新功能 - 轨迹检查器重做：按轮折叠，长会话不再拖慢界面 — 15,000 条记录的会话以前就是 15,000 个 DOM 节点，每次 token flush（约 20 次/秒）都可能重扫整个会话文件（38.8MB 单次约 117ms）。现在账本只挂尾部 3 轮、单轮最多 120 步，向上滚动再放 3 轮；概览从「一条记录一个按钮」改为按泳道 + 像素桶聚合，同一桶显示 ×N。刷新改为事件驱动（会话 / 运行代次 / 回合运行状态变化才重取），仅在会话活动时每 5 秒兜底一次。默认折叠除最后一轮之外的所有轮次，轮头直接给出「N 步 · N 工具」、token 合计与耗时，同一轮里连续工具调用超过 8 条压成一行；工具栏可一键全部折叠 / 展开，切会话自动重置。右侧导轨现在覆盖全部提问，点一条还没加载的刻度会沿已加载边界连续补页（最多 7 次请求）再跳转。 …在 GitHub 查看 ↗ -
发布说明摘录
这一版的主线是「找得到、看得清、接得上」：会话与文件都能按正文和拼音检索，微信成为第二个 IM 渠道，ACP 工具对正式渠道开放，同时同步 pi 1.3.0 与 DSH 0.2.1；0.9.0 的 macOS 签名缺陷也在本版本修复。 🚀 新功能 - 微信（ilink）接入：手机上的第二个 IM 渠道 — 设置 → 外部连接可扫码登录微信，把微信消息接进 PiDeck 会话：按模型优先级链逐条尝试，某个模型调用失败自动换下一个；回复前先亮「正在输入」，发出前剥掉思考段只保留最终答案。会话在侧栏带微信 / 飞书渠道标，并按首批消息自动命名；两个渠道都能各自选择会话后端（pi / DSH），换后端时自动换绑一个新会话，避免两套历史混在一条记录里。出站 client_id 改为逐条唯一，第二条回复不会再被幂等去重吃掉。 …在 GitHub 查看 ↗ -
发布说明摘录
这是一次大版本功能更新：PiDeck 从 pi / DSH 工作台进一步扩展为支持 ACP 工具与独立宿主插件的桌面工作台，同时升级远程访问、终端和原生会话管理体验。 🚀 新功能 - ACP 协议后端：接入更多 AI 编程工具 — 同一工作台可创建由外部 ACP CLI 驱动的会话，内置 Gemini CLI、Claude Agent、Codex CLI、Kimi CLI、Qwen Code、OpenCode、Cursor Agent、CodeBuddy 与 MiniMax Code 九种启动预设；支持工具检测、适用工具的一键安装/卸载、工具级环境变量和会话图片。设置 → ACP 工具显式开启，重启后生效，不改变已有 pi / DSH 会话；设置页同时标注该功能为实验性——尚未经过完整的使用测试，遇到问题可从「问题反馈」入口反馈。 - 独立 PiDeck 宿主插件系统 — 不依赖 pi 进程的本地 HTML / CSS / JS 插件，可注册弹框或工作区页面式面板、侧栏入口与命令面板动作，按授权读取当前项目会话、定位消息并保存私有状态；主题与语言跟随应用。支持从文件夹或 .pideck-plugin 文件安装，设置页可生成脚手架，开发指南与官网同步；授权绑定逐文件内容指纹，插件内容变化必须重新确认。 …在 GitHub 查看 ↗