PiDeck 桌面工作台
在本地项目目录中统一管理 pi 和 DSH 编码 Agent 会话的桌面工作台，支持导入 Codex、Claude 会话，一站式浏览与恢复。
证据以 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 可用。
这个 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. / auth. / settings.）、供应商用量查询与本地用量统计、插件与 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.、auth.、settings. 并一键连接测试；供应商余额/额度查询与本地用量统计（热力图、每日/模型/项目维度）；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 有哪些优点和局限？
- 会话隔离设计清晰：每个 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？
方式一（预构建安装包）：从 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 服务。