PI-Desktop 安装教程macOS、Windows、Linux 装好 AI 编程 Agent 并跑通第一个编码任务【免费下载链接】PI-DesktopLocal-first AI coding agent desktop: Electron Rust host core pi Agent Harness user-installable plugins项目地址: https://gitcode.com/GitHub_Trending/pid/PI-Desktop这篇教程带你把 PI-Desktop 装到当前这台电脑上并发出第一条会改代码的提示词。PI-Desktop 是本地优先的 AI 编程 Agent 桌面客户端项目、会话与凭据都留在本机。按顺序走完10 分钟左右就能看到 AI 完成第一个编码任务。它凭什么值得装这一节回答一个问题为什么值得花这 10 分钟。PI-Desktop 是本地优先的 AI 编程 Agent 桌面客户端项目、会话、设置、日志全部存在本机API 凭据写入系统钥匙串不要求账号也没有强制的云端中转模型可换可切OpenAI、Anthropic、任意 OpenAI 兼容 API 以及 Ollama / LM Studio 这类本地网关都能接。已经在用别的编码工具也不用清零它可以导入 Claude Code、Codex、OpenCode、Pi 的本地会话。装好后的主界面长这样左边是项目与会话栏中间是对话区底部是输入框。首次启动时还会显示一份 Get started 新手清单后文就按它一步步走。分系统装好它macOS、Windows、Linux 各自的包与命令这一节帮你回答四件事下哪个包、怎么装、启动成功的信号、卡住了怎么修。三个平台共用的前提是先到项目 Releases 页面拿到 0.20.x 线最新版本再按你的系统对号取包你的系统Releases 里的安装包装法macOSarm64 / x64PI-Desktop-版本-arm64.dmg、PI-Desktop-版本-x64.dmg也有.zip拖进 ApplicationsWindowsx64PI-Desktop-Setup-版本.exeNSIS或PI-Desktop-Portable-版本.zip跑安装向导或解压便携包Linuxx64 / arm64.AppImage、.deb、.rpm、.asar直接运行或走包管理器macOS 安装签名公证的 DMG 拖进 Applications 即可按芯片选包Apple Silicon 下PI-Desktop-版本-arm64.dmgIntel 下PI-Desktop-版本-x64.dmg.zip形态与 DMG 等价都能用。打开 DMG把PI-Desktop.app拖进 ApplicationsZIP 则解压出 app 后移入 Applications。官方包已用 Developer ID 签名并经 Apple 公证双击即开。启动后看到左侧项目/会话栏、中间会话区、底部输入框且界面出现 Get started 新手清单即算装好。常见故障个别非官方渠道拿到的构建没走公证首次打开被 Gatekeeper 拦下提示已损坏。在终端执行下面这条命令清掉隔离属性再重试xattr -r -d com.apple.quarantine /Applications/PI-Desktop.app升级DMG 与 ZIP 两种形态都支持应用内下载安装新版提示出现时点一下就行。Windows 安装NSIS 安装器或免安装 ZIP普通权限直接跑两种形态二选一NSIS 安装版PI-Desktop-Setup-版本.exe或便携版PI-Desktop-Portable-版本.zip。安装版走向导即可便携版解压后直接运行PI-Desktop.exe以普通用户权限工作不弹管理员授权适合 U 盘和受管控环境。不用补 VC 运行库内置的pi-desktop-host-core.exe已静态链接 MSVC CRT干净系统也能直接拉起本地服务。常见故障便携版任务栏图标显示异常。原因是你运行了解压目录之外的复制件。直接双击 ZIP 解压目录里的PI-Desktop.exe图标即恢复。升级NSIS 版支持应用内下载安装便携 ZIP 只负责提示新版本需要自行下载新 ZIP、解压后替换旧目录。Linux 安装AppImage 首选先确认 glibc 再动手四种形态按习惯选图省事直接.AppImage双击运行Ubuntu/Debian 用.debapt install ./xxx.debFedora/RHEL 系用.rpmdnf install ./xxx.rpm装在/opt/PI-Desktop.asar留给要用系统 Electron 二次打包的场景。硬性门槛Linux 包要求 glibc 2.35 及以上对应 Ubuntu 22.04、Debian 12、Fedora 36。先跑ldd --version看一眼输出版本低于 2.35内置的 Rust 宿主进程加载不了只能升级发行版没有绕法。启动信号与其他平台一致左侧项目/会话栏 中间会话区 底部输入框 Get started 新手清单。常见故障窗口启动即闪退或无响应九成是 glibc 不达标。执行ldd --version核对版本不达标就用发行版升级把 glibc 提到 2.35 以上。升级AppImage 支持应用内自动更新deb/rpm 安装后只在提示里给你下载链接更新由包管理器完成。装完就跑发出第一条提示词这一节用首次启动的四步清单把应用从空壳变成能改代码的状态。启动后主界面就是 Get started 清单四项按顺序点亮Add an AI provider点清单项深链进 Settings → Model configuration选 Provider填端点与 API Key——OpenAI、Anthropic、任意 OpenAI 兼容 API、Ollama / LM Studio 本地网关都在列。Key 写入系统钥匙串不落普通文件。Open a project folder点清单项选一个本地仓库目录。本地文件与命令能力随项目解锁不选项目Agent 就没有可读写的代码库。选工作模式输入框上方切换按任务挑——日常改码用 Agent直接执行大型重构用 Plan先出方案给你审复杂长任务用 Goal锁定目标与验收标准再放手让它跑。Send your first prompt输入一句真实需求比如给这个项目写一个 README 的目录章节按发送。文件改动的 diff 与命令输出都会出现在右侧 Work Panel顺手核对。四步走完第一个编码任务闭环。如果卡在某一步看下一节。卡住了先看这里如果卡在下面任何一种现象先按对应条目处理如果出现macOS 提示已损坏或无法打开原因是那份构建没走公证、带了隔离属性执行xattr -r -d com.apple.quarantine /Applications/PI-Desktop.app后重试。如果出现Linux 上窗口一启动就闪退或无响应原因是glibc 低于 2.35执行ldd --version核对版本不达标升级发行版没有绕法。如果出现Windows 上怀疑缺 VC 运行库原因是通常不缺——内置宿主进程已静态链接 MSVC CRT执行无操作直接启动即可。如果出现输入框提示 Open a project to reference files原因是还没有打开项目目录本地文件与命令能力未解锁执行侧边栏 Add project 选一个本地目录。如果出现便携版收到更新提示但一直没生效原因是Windows 便携 ZIP 不走应用内自动安装执行下载新版 ZIP解压后整体替换旧目录。想读源码从这里进环境要 Node.js 22.19 及以上、pnpm 10 及以上、稳定版 Rust 工具链。拿到源码跑一遍git clone https://gitcode.com/GitHub_Trending/pid/PI-Desktop cd PI-Desktop pnpm install cargo build -p host-core pnpm build:js pnpm dev打包、签名与三平台产物清单的完整流程见 release runbook。第一条提示词发出去、diff 出现在 Work Panel 的那一刻安装这件事就结束了。想再往前一步用 Plan 模式挑一次大型重构先看方案再放行。【免费下载链接】PI-DesktopLocal-first AI coding agent desktop: Electron Rust host core pi Agent Harness user-installable plugins项目地址: https://gitcode.com/GitHub_Trending/pid/PI-Desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考