PiDeck
English · LinuxDO 友链
一个用于管理多个 Pi和DSH编码 Agent 会话的开源桌面工作台（pi desktop workbench）。
PiDeck = pi desktop：把 pi 编码 Agent 装进桌面应用。如果你在 GitHub 搜索「pi desktop」「pi 客户端」「pi GUI」，找的正是它。
国内 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 后端），并作为通用 ACP（Agent Client Protocol）客户端接入各家编码 Agent CLI（详见 ACP 后端）。
📑 目录
✨ 核心亮点
- 🖥️ 多项目多会话并行 —— 一个窗口管理多个本地项目的全部 Agent 会话，项目间完全隔离。
- 🔌 四种会话后端 —— pi、DSH（DeepSeek Harness）、ACP（通用客户端，内置 15 个外部 CLI 预设）、生图 / 生视频并存，同一项目下自由切换。
- 🧠 上下文感知输入 ——
@ 文件引用、/ 斜线命令、! Shell 执行，全部在同一个输入框。
- 🗂️ 会话资产化 —— 历史浏览与恢复、Codex / Claude 会话导入、一键导出 HTML。
- 🛠️ 配置可视化 —— pi 的
models.json / auth.json / settings.json 免手写 JSON，连接测试一键直达。
- 📊 用量看得见 —— 供应商余额/额度查询 + 本地会话用量统计（热力图、每日/模型/项目维度）。
- 🧰 工作台全家桶 —— 文件树、Git 面板、内置终端、内置浏览器、草稿本，不用来回切窗口。
- 🐾 有温度的桌面集成 —— 桌面宠物、主题切换、系统托盘、飞书机器人、局域网 Web 访问。
📋 更新日志
最新版本 v0.12.0（2026-11-11）
v0.12.0 更新亮点
- 🚀 远端工作区成为产品级能力
- 🚀 关联会话（父 / 子对话）
- 🚀 提问卡浮在时间线之上
- 🚀 Pi 配置管理统一环境切换
- 🚀 WSL 目标跟随开发设置
- 🚀 远端主机重绑向导
- 🚀 远端文件进中央编辑器
- 🚀 Office / WPS 与表格、视频预览
- 🚀 macOS 正式签名与公证，支持应用内更新
- 🚀 安全分享导出
- 🚀 侧栏分组树与项目排序
- ✨ 会话代码块自动换行开关
- ✨ Web 端智能体面板与输入框命令
- ✨ 重发 / 编辑 / 删除的即时反馈
- ✨ 会话 Tab 富提示只跟随悬停
查看完整更新日志 →
🧩 功能总览
工作区与项目
| 功能 | 说明 |
|---|
| 多项目工作区 | 添加、搜索和切换本地项目目录，同时运行多个 pi Agent，项目间完全隔离。项目分组的「⋯ → 项目排序」可选手动拖拽、最近活动、创建时间或标题，记住所选方式并始终优先展示置顶项目；没有创建时间记录的旧项目排在已记录项目之后，保留原有相对顺序。 |
| 内置 Chat | 项目列表顶部固定 Chat 入口，写入应用用户目录，适合无需绑定代码项目的通用对话。 |
| 会话引导页 | 新建会话时预选模型与思考档位，支持 @ 文件引用，开箱即聊。 |
| 信任确认系统 | 桌面端拦截 pi 的信任确认；不信任的项目仍可打开，有 Agent 运行时禁止删除项目。 |
会话与对话
| 功能 | 说明 |
|---|
| 三种 Agent 后端（pi / DSH / ACP） | 同一项目下可创建 pi、DSH 或 ACP 会话并自由切换浏览，详见下方 DSH 后端 与 ACP 后端。 |
| 生图模式 | 独立生图后端（OpenAI 兼容 /images/generations，支持 OpenAI / 火山方舟 / SiliconFlow 等），在会话中一键切换生图。 |
| 计划模式 (Plan Mode) | Composer 工具栏切换计划模式，Agent 先生成计划，逐条确认后执行，取消后返回选单。 |
| Ask 并行问询 | 在后台创建独立问询会话并行提问，可携带主会话上下文，答案一键引用回主输入框。 |
| 活动轨迹 | 思考、工具调用和回答片段按流程聚合展示，工具详情可展开复制，状态和退出码清晰标识。 |
| 回答级修改摘要 | 每轮回答完成后在下方展示本轮修改文件名与行数，Files 面板保留本次会话总览。 |
| 待办条 | Composer 上方常驻 Agent 任务列表，待处理 / 进行中 / 已完成进度一目了然。 |
| 消息编辑/删除 | AI 回答和用户消息均支持复制、编辑和删除，编辑后回填到输入框重新发送。 |
| 会话管理 | 新建、重命名、复制、导出 HTML、删除历史会话、重启与重新加载、关闭 Agent——侧栏或右键菜单即可完成。 |
| 会话导入 | 项目右键导入 Codex 和 Claude 本地会话，转换为 PiDeck 历史会话后继续浏览和恢复。 |
| 刻度定位轴 | 会话右缘刻度轴映射时间线位置，长会话点击即可跳转到对应消息。 |
| 内容行宽限制 | 可拖拽的内容宽度滑块，默认不限宽，适应长行代码阅读或紧凑布局。 |
文件 · Git · 终端
| 功能 | 说明 |
|---|
| 文件抽屉 | 项目文件树（含 Git 状态标识）、内置文件编辑器；Files 面板保留本次会话修改文件列表。 |
| 外部编辑器集成 | 「在编辑器中打开 / 在资源管理器中显示」自动检测系统文件管理器，支持 JetBrains 系列编辑器目录扫描。 |
| Git 集成 | 实时显示当前分支，本地 + 远程分支选择器、分支数量徽章、分支切换和新建分支。 |
| 内置终端 Dock | 当前 Agent 绑定独立终端 tab，支持 PowerShell/cmd/sh fallback、多 tab、主题切换、拖拽高度、右键复制选区和关闭确认。 |
模型与配置
| 功能 | 说明 |
|---|
| 可视化配置管理 | 编辑器管理 pi 的 models.json、auth.json、settings.json：Provider 卡片 + 模型网格 + 类型感知键值编辑 + 源文件原始 JSON，保存后按需重启 Agent 生效。 |
| 连接测试 | Provider 卡片一键测试连接，模型验证不再把配置回退误判为成功。 |
| 模型能力自适应 | 兼容 pi 0.84.3：上下文窗口 / maxTokens / 思考档位按端点返回自适应，模型目录自动刷新（后台检测到新版本即拉取，设置里可关闭，也可手动检查），新模型不再不可见。 |
| 用量查询 | 供应商余额/额度查询（内置 OpenRouter、Moonshot-Kimi、通用 OpenAI 兼容网关模板，支持多账号与独立端点），卡片直接显示用量，支持自定义探针配置。 |
| 用量统计 | 基于用量统计插件的本地统计：累计概览、活跃热力图、每日用量、模型与项目维度。 |
| 代理设置 | pi agent 子进程代理与桌面端代理独立配置，模型拉取与连接测试可走桌面端代理。 |
扩展与生态
| 功能 | 说明 |
|---|
| 配置、Skill 与 Extension 管理 | 可视化管理全局 Skills 与 Extensions，支持启用/禁用内置扩展，区分全局与项目级配置。 |
| Prompt & Skill 商店 | prompts.chat 国际商店 + skills.sh 社区技能商店，在线搜索、浏览详情、一键安装到本地。 |
| 内置智能体 | 翻译官、PiDeck 小助手（功能/使用/开发/FAQ）、问题诊断助手（诊断报告/日志/Issue）、插件开发助手（宿主插件从脚手架到发布），在「智能体」页一键使用或绑定会话。 |
| 中文提示词精选 | 内置 XuePrompt 数据库（4000+ 中文提示词），分类/搜索/分页浏览，一键导入本地模板。 |
| 内置扩展 | 内置 pi-deck-retry-no-body（空响应自动重试）、图片生成技能模板等开箱即用的扩展。 |
| 视觉桥 | 给不支持看图的模型「装眼睛」：图片先由视觉模型转成文字描述再进入会话，模型/接口/Key 均可在设置中配置。 |
This is the beginning of the README. Read the rest at the original. Read the full README ↗
