PI-Desktop 安装与首次配置指南10 分钟在 macOS、Windows、Linux 跑通第一个 AI 编程任务【免费下载链接】PI-DesktopLocal-first AI coding agent desktop: Electron Rust host core pi Agent Harness user-installable plugins项目地址: https://gitcode.com/GitHub_Trending/pid/PI-DesktopPI-Desktop 是本地优先的 AI 编程 Agent 桌面客户端基于 Electron Rust host core pi Agent Harness 构建。从下载安装到发出第一条编码提示词全程约 10 分钟项目与会话留在本机API Key 存系统钥匙串无需账号。开装前自检条件验证方式Linux 需 glibc ≥ 2.35Ubuntu 22.04 / Debian 12 / Fedora 36终端执行ldd --version输出 ≥ 2.35macOS 确认芯片架构Apple Silicon 或 Intel“关于本机”里查看决定选 arm64 还是 x64 包模型 API 端点可访问保存 Provider 后模型列表能自动拉取即通30 秒选定你的安装包当前发布线为0.21.xEarly Preview到项目 Releases 页面取最新版按下表对号入座系统 / 架构推荐包备注macOS · Apple SiliconPI-Desktop-版本-arm64.dmgDeveloper ID 签名 Apple 公证macOS · IntelPI-Desktop-版本-x64.dmg另有.zipWindows · x64PI-Desktop-Setup-版本.exeNSIS 向导支持应用内更新Windows · 免安装PI-Desktop-Portable-版本.zip解压直接运行Linux · x64 / arm64.AppImage首选另有.deb/.rpm/.asarmacOS、Windows NSIS 版和 Linux AppImage 支持应用内下载安装新版便携 ZIP 版只弹提示需手动下载新 ZIP 替换旧目录。主线三步下载 → 安装 → 启动验证下载打开 Releases 页面下载与上表匹配的包。【成功判据】文件名中的版本号与架构arm64 / x64 / arm64-linux和你的系统一致。安装macOS 把PI-Desktop.app拖入/ApplicationsWindows 运行 NSIS 向导便携版直接解压Linux 双击 AppImage或执行apt install ./xxx.deb/dnf install ./xxx.rpm。【成功判据】桌面、开始菜单或应用列表中出现 PI-Desktop。启动验证双击启动 PI-Desktop。【成功判据】看到左侧项目/会话栏、中间会话区和底部输入框首次启动会弹出Get started新手清单先别关下一步就靠它。分平台坑点速查平台易踩坑一句话修复macOS个别未公证构建被 Gatekeeper 拦截提示已损坏xattr -r -d com.apple.quarantine /Applications/PI-Desktop.app后重试Windows怀疑缺 VC 运行库便携版任务栏图标异常宿主已静态链接 CRT直接启动即可图标异常时直接运行 ZIP 内的PI-Desktop.exeLinux旧系统 glibc 不够宿主进程加载失败、窗口闪退ldd --version确认 ≥ 2.35不达标只能升级发行版跑通第一个真实任务接入模型点击清单中的Add an AI provider深链到Settings → Model configuration选择 Service、填 Base URL 与 API key、勾选要用的模型点Save provider。API key 会写入系统钥匙串。验证模型列表能从服务端自动拉取、provider 保存成功即通过。打开项目回主界面点清单中的Open a project folder选任意本地仓库目录。验证侧边栏出现该项目本地文件与命令能力随之解锁。选工作模式输入框左下角切换——日常改码用Agent直接执行大型重构用Plan先出方案再执行只关心结果用Goal锁定验收标准。发送第一条提示词点清单中的Send your first message输入例如给这个项目写一个 README 的目录章节点Send。验证右侧 Work Panel 出现文件改动 diff 与命令输出。新手清单的规格与交互细节见 docs/spec/04-ux/05-onboarding.md。至此 PI-Desktop 已正式上线项目留在本机模型随时可换。下一步可以试试用Plan模式跑一次大型重构。想从源码构建开发版环境需 Node.js ≥ 22.19、pnpm ≥ 10 与稳定版 Rustgit clone https://gitcode.com/GitHub_Trending/pid/PI-Desktop cd PI-Desktop pnpm install cargo build -p host-core pnpm build:js pnpm dev各平台打包、签名与产物清单见 docs/spec/06-delivery/06-release-runbook.md。完成度自检☐ 下载并安装了与系统架构匹配的安装包☐Settings → Model configuration已接入至少一个 Provider 并保存☐ 已打开一个本地项目目录☐ 第一条提示词已发送Work Panel 中看到改动 diff 或命令输出【免费下载链接】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），仅供参考