【免费下载链接】PiDeckPiDeck 是一个开源的桌面工作台用于在本地项目目录中统一管理 PI | DSH Agent 会话并支持导入 Codex、Claude 本地会话以便统一浏览和恢复。支持多项目工作区、会话历史、Git 集成、内置终端、模型配置和插件管理基于 Electron 构建。项目地址https://gitcode.com/gh_mirrors/pide/PiDeck点击查看免费下载PiDeck 是一个基于 Electron 的开源桌面工作台用于在本地项目目录中统一管理 PI / DSH Agent 会话并支持导入 Codex、Claude 本地会话。启动 PiDeck 后如果弹出「未检测到 Pi CLI」先别慌——这不一定代表你没装 pi。本文带你快速定位 PiDeck 找不到 pi 的 5 个常见原因并给出一份可直接照做的完整排障清单。PiDeck 和 pi 是什么关系为什么启动时要检测 pi一句话PiDeck 是 pi 的桌面外壳不是 pi 本身。Agent 的对话、工具调用、会话读写、模型调用全部由本机pi进程原生完成PiDeck 只负责窗口管理、会话浏览、Git 面板、终端和设置这些框架层能力两者通过 stdio JSON-RPC 通信。所以每次启动PiDeck 的主进程都会先定位到你机器上的 pi 可执行文件找不到就会在「检测环境」里提示未检测到 Pi CLI——桌面端通过系统 PATH 和常见包管理器路径自动查找 pi 命令。PiDeck 检测 pi 的方式按来源优先级目录表扫描官方安装器落点~/.pi/agent/bin、各包管理器全局目录npm / nvm / pnpm / bun / yarn / mise / volta、PiDeck 自己的便携副本目录自定义路径你在设置里添加过的customPiPath与备选池piCustomPathsPATH 目录GUI 进程继承到的 PATH登录 shell 反查作为兜底交互式执行一次where pi/which pi。理解这套机制下面 5 个坑就都好解释了。坑一终端里 pi 正常PiDeck 却「未检测到」这是新手踩得最多的一个坑。典型现场终端里pi --version正常输出版本号点 PiDeck 的「检测环境」却提示「未检测到 Pi CLI」错误详情写着pi: 不是内部或外部命令也不是可运行的程序或批处理文件。原因官方安装脚本curl -fsSL https://pi.dev/install.sh | sh只把 PATH 写进当前 shell 的配置文件bash 写~/.bashrc否则写~/.profile只有交互式终端会加载它。而 PiDeck 从桌面会话启动继承的是桌面 PATH里面没有~/.pi/agent/bin——于是终端看得见、GUI 看不见。这个成因链在项目文档里有完整复盘docs/pi-install-detection.md。两种解法任选其一从终端再找一次在「未检测到 Pi CLI」对话框点「从终端再找一次」PiDeck 会启动一次交互式登录 shell 反查 pi 路径成功后点「重新检测」即可手动指定路径在终端执行where piWindows或which -a piLinux / macOS把输出的绝对路径粘贴到设置 → 开发设置 → Pi 命令来源 → 自定义 pi 路径。粘贴后会自动归一化并校验校验通过立即切换为当前使用。坑二装了两份 piPiDeck 用的是错的那份如果机器上同时存在官方安装器装的~/.pi/agent/bin/pi和 npm 全局装的 pinvm 目录下PiDeck 只会选中第一个命中的候选——不一定是你终端用的那份。后果不只是显示错了终端pi update升级的是 managed 安装PiDeck 的「更新 Pi」升级的可能是 npm 那份两边版本会漂移。怎么查、怎么切打开设置 → 开发设置 → Pi CLI区块。「Pi 命令来源」列表会列出所有发现的安装每行带版本、路径、来源标签managed官方安装 /package-manager包管理器全局 /portablePiDeck 便携副本 /custom自定义 /pathPATH 发现和状态徽章当前使用 / 终端默认 / 较新 / 较旧。点一行 切换为当前使用PiDeck 会把它写进settings.customPiPath作为唯一生效指针无需手动改系统环境。 判断依据路径里出现.nvm/、.bun/、pi-runtime/pi-global这类目录说明来自不同安装通道务必在列表里确认当前使用是不是你终端里那份。坑三压根没装 pi先补 Node → npm → pi 三步如果终端里pi --version本身就报错那是真的没装。PiDeck 的检测面板会给出Node → npm → pi三步引导一步步做完即可步骤说明PiDeck 能帮你做的事1. Node.jspi 是 Node CLI先要有 Node一键下载安装便携 Node约 30 MB装进 PiDeck 数据目录不需要管理员权限不影响系统环境2. npmnpm 随 Node 一起安装检测到系统 Node 后自动完成检测3. pi安装 Pi CLI用 npm 安装到 PiDeck 数据目录不需要提权网络慢可勾选「使用国内镜像源」两个防呆设计值得知道引导安装只装进 PiDeck 自己的数据目录userData/pi-runtime/不写系统环境——所以装完后终端里直接敲pi可能仍找不到这是设计如此如果你本机其实已经装过 pi只是检测没扫到点击安装时主进程会拦住并显示「本机已经装好 Pi已跳过安装不会再多装一份」并列出已有路径——不会再误装第二份。坑四检测有短缓存装完不点「重新检测」会装上了也看不到PiDeck 对检测做了多层缓存以提速安装列表约 10 秒进程内缓存登录 shell 反查有约 60 秒负缓存WSL 探测也有负缓存 TTL详见 PiLocator.ts 的注释。这意味着刚装完 pi、刚改完 PATH立即点「重新检测」仍可能读到旧结果此时点对话框里的「重置检测标记」PiDeck 会清掉标记并在重启后强制重新检测引导流程全部完成pi 步骤变绿 ✓后直接点「完成重启应用」最稳妥让新环境对所有会话生效。另外如果你的 pi 装在WSL 发行版内宿主扫描目录里的 pi 不代表你在用的那份需要在「Pi 来源」里选择WSL — 使用 WSL 发行版中的 Pi并指定发行版与用户名再点重新检测。坑五pi 版本太旧部分能力会被拦截找到 pi≠pi 够新。不同能力有各自的最低版本门槛项目文档 docs/pi-install-detection.md 有完整依据能力pi 最低版本pi update --self自更新0.70.3RPC 直接执行 bash0.14.0bash 流式输出事件0.82.0版本低于门槛时PiDeck 不会替你猜命令另装一份而是提示用原安装方式手动升级后重新检测。先看「Pi CLI」状态行的版本号再决定下一步能少走很多弯路。完整排障清单照着做一遍遇到「未检测到 Pi CLI」按顺序过一遍终端执行pi --version确认 pi 本身可用在「检测环境」对话框展开「检测错误详情」把报错原文抄下来spawn pi ENOENT、不是可运行的程序等都能直接判断原因终端pi正常但 PiDeck 看不到 → 点「从终端再找一次」或在设置 → 开发设置 → Pi 命令来源里手动粘贴路径装了两份 pi → 在「Pi 命令来源」列表里点选你要用的那份确认当前使用徽章位置刚装完 / 刚改过环境 → 点「重新检测」仍不行点「重置检测标记」后重启应用pi 装在 WSL → 「Pi 来源」选 WSL 并填对发行版与用户名版本号低于能力门槛 → 用原安装方式升级 pi 后重新检测都试过仍失败 → 设置页导出日志把检测错误详情、pi 版本与路径一起反馈「反馈」面板的示例文案就是为你这种场景准备的点击检测环境后提示未检测到 Pi但命令行里pi --version正常。官方 FAQ 对「启动后提示找不到 pi」的原始回答是先在终端执行pi --version确认可用若不可用请先安装 pi CLI 并配置好 Provider / API Key再启动 PiDeck见 README.md。相关文档与源码docs/pi-install-detection.mdpi 安装检测与多安装选择的完整设计说明成因链、目录表、更新通道分派README.md「启动后提示找不到 pi」FAQ 原文src/main/pi/PiLocator.tspi 定位器主逻辑目录扫描、managed 安装校验、登录 shell 反查、WSL 探测src/main/pi/piInstallGuard.ts安装防护——检测到任何一份 pi 就跳过引导安装防止重复安装src/renderer/src/components/app/PiCommandSourcePanel.tsx设置页「Pi 命令来源」面板列表 / 添加 / 切换src/renderer/src/components/overlays/EnvironmentGuidePanel.tsxNode → npm → pi 三步环境引导面板。 记住核心原则PiDeck 依赖系统 PATH 中的pi命令。让 PiDeck看见你终端里的 pi重新检测 / 从终端再找一次 / 手动指定路径90% 的找不到 pi都能解决。赞分享【免费下载链接】PiDeckPiDeck 是一个开源的桌面工作台用于在本地项目目录中统一管理 PI | DSH Agent 会话并支持导入 Codex、Claude 本地会话以便统一浏览和恢复。支持多项目工作区、会话历史、Git 集成、内置终端、模型配置和插件管理基于 Electron 构建。项目地址https://gitcode.com/gh_mirrors/pide/PiDeck点击查看免费下载相关推荐装完不触发、MCP 连不上claude-skills 实操中高频踩的 5 个坑附排查清单装完不触发、MCP 连不上claude skills 实操中高频踩的 5 个坑附排查清单 装一个技能包、 /plugin install 一条命令敲下去、AI 技能AI 插件开发工具De-Vanced打不开、闪退、找不到补丁常见问题排查完整清单De Vanced打不开、闪退、找不到补丁常见问题排查完整清单 De Vanced 是迁移到 Morphe 的开源补丁集合覆盖 Facebook、Twitc3分钟上手FF14终极启动器XIVLauncher一次搞定登录、更新与插件生态3分钟上手FF14终极启动器XIVLauncher一次搞定登录、更新与插件生态 晚上8点你终于忙完一天满怀期待地打开游戏想进艾欧泽亚放松一会儿。原版启动器创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考