macOS安装PI-Desktop完全指南dmg/zip双格式与未签名构建的打开方法【免费下载链接】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 是一款本地优先Local-first的 AI 编程智能体桌面应用采用 Electron Rust 宿主内核架构支持用户自装插件。本文带你完成 macOS 安装 PI-Desktop 的全过程如何按芯片选择 dmg/zip 安装包以及如何安全打开默认未签名unsigned构建时 macOS 提示已损坏的应用。第1步选对架构下载正确的 macOS 安装包PI-Desktop 为 macOS 提供arm64Apple Silicon与x64Intel两条独立发布通道每个版本都会同时发布 dmg 与 zip 两种格式。安装 PI-Desktop 前先确认你的芯片类型点击屏幕左上角 →关于本机看到Apple M1/M2/M3/M4芯片 → 选arm64包看到Intel处理器 → 选x64包安装包命名规则非常直观从文件名即可识别架构详见 docs/adr/0191-label-both-macos-release-architectures.md芯片磁盘镜像压缩包Apple SiliconPI-Desktop-版本-arm64.dmgPI-Desktop-版本-arm64-mac.zipIntelPI-Desktop-版本-x64.dmgPI-Desktop-版本-x64-mac.zipdmg 还是 zip选哪个两者内容基本一致都包含PI-Desktop.app。dmg 是图形化安装盘适合大多数用户zip 则额外附带一个可双击的一键启动辅助脚本更适合不习惯打开终端的用户。第2步两种安装方式拖一拖或解一解方式一DMG 拖拽安装推荐双击 dmg 文件macOS 会弹出安装窗口背景上写着 Move the app to Applications to get started详见安装脚本 scripts/release-macos.sh将PI-Desktop.app拖入 Applications 文件夹若窗口中出现If app wont open, read this.txt应用无法打开时阅读此文件把它拖到桌面备用——它就是你打开未签名构建的钥匙右键点击磁盘图标选择推出安装完成。方式二ZIP 解压安装双击 zip 文件自动解压你会得到三样东西PI-Desktop.app、PI-Desktop-macOS-opening-help.txt文字说明和 PI-Desktop-macOS-open.command可执行辅助脚本把PI-Desktop.app拖入Applications必须移动不能留在原地。⚠️ 无论哪种方式辅助脚本只识别两个标准位置/Applications/PI-Desktop.app或~/Applications/PI-Desktop.app。请先移动应用再运行它。第3步提示已损坏时如何打开未签名构建默认的 tagged-release 工作流发布的是未签名 macOS 产物。从网上下载的 app 会被 macOS 打上com.apple.quarantine隔离扩展属性Gatekeeper 检查失败时就会弹出应用已损坏应移到废纸篓的提示。这并不是你的电脑或应用真的坏了而是 macOS 对未签名应用的正常拦截。有三种官方支持的解锁方法按推荐顺序排列方法A双击一键辅助脚本ZIP 用户首选将应用移入 Applications 后双击PI-Desktop-macOS-open.command即可。这个脚本的设计非常克制设计决策见 docs/adr/0204-unsigned-macos-first-launch-helper.md只查找/Applications/和~/Applications/两个固定路径不接受任意路径参数用plutil校验 bundle identifier 必须是com.pi-desktop.app拒绝操作其他应用只递归删除com.apple.quarantine这一个属性保留其余所有扩展属性从不用 sudo成功后直接帮你启动 PI-Desktop。方法B阅读 DMG 附带的说明文件DMG 用户将If app wont open, read this.txt拖到桌面后打开阅读该指引由 docs/adr/0232-macos-dmg-text-only-opening-guidance.md 定义里面给出了与下方方法C相同的终端命令。方法C终端一行命令通用兜底打开终端Terminal执行xattr -r -d com.apple.quarantine /Applications/PI-Desktop.app然后再次打开 PI-Desktop。这条命令只移除 Apple 的隔离属性作用范围精确到 PI-Desktop.app 本身——完整说明见 README.md 的 macOS unsigned-build notes 小节。✅签名构建无需任何操作正式发布时通过sign_macos: true手动触发的构建会用 Developer ID 完成签名、公证与装订双击即用。安装完成第一次打开 PI-Desktop成功启动后按 README.md 的路径走完从安装到第一个补丁Settings → Model configuration配置模型提供方与凭据从侧边栏添加本地项目目录选择 Agent / Plan / Goal 模式开始对话。常见问题 FAQQ1为什么默认构建不签名为了让贡献者和发布运维在没有 Developer ID 凭证的情况下也能构建打包决策背景见 docs/adr/0145-native-macos-intel-release-lane.md。签名构建是常规 Gatekeeper 启动路径辅助脚本只是可信未签名产物的显式兜底两者不互相替代。Q2这个 xattr 命令安全吗它只删除隔离标记这一个扩展属性不动文件本体、不提升权限、不碰其他应用。官方反复强调仅对来自可信 PI-Desktop 发布渠道的应用使用切勿对来路不明的 app 执行。Q3应用更新怎么弄打包版应用会检查 GitHub Releases 并在应用内提示新版本macOS 采用通知跳转方式打开发布页下载安装包而非静默覆盖。Q4我是 Intel 老机器能装吗可以。每个 tag 版本都会同时构建 arm64 与 x64 两条原生通道含 Rust 宿主内核的同架构配套Intel 用户下载-x64后缀的安装包即可。【免费下载链接】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），仅供参考 macOS安装PI-Desktop完全指南：dmg/zip双格式与未签名构建的打开方法
macOS安装PI-Desktop完全指南dmg/zip双格式与未签名构建的打开方法【免费下载链接】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 是一款本地优先Local-first的 AI 编程智能体桌面应用采用 Electron Rust 宿主内核架构支持用户自装插件。本文带你完成 macOS 安装 PI-Desktop 的全过程如何按芯片选择 dmg/zip 安装包以及如何安全打开默认未签名unsigned构建时 macOS 提示已损坏的应用。第1步选对架构下载正确的 macOS 安装包PI-Desktop 为 macOS 提供arm64Apple Silicon与x64Intel两条独立发布通道每个版本都会同时发布 dmg 与 zip 两种格式。安装 PI-Desktop 前先确认你的芯片类型点击屏幕左上角 →关于本机看到Apple M1/M2/M3/M4芯片 → 选arm64包看到Intel处理器 → 选x64包安装包命名规则非常直观从文件名即可识别架构详见 docs/adr/0191-label-both-macos-release-architectures.md芯片磁盘镜像压缩包Apple SiliconPI-Desktop-版本-arm64.dmgPI-Desktop-版本-arm64-mac.zipIntelPI-Desktop-版本-x64.dmgPI-Desktop-版本-x64-mac.zipdmg 还是 zip选哪个两者内容基本一致都包含PI-Desktop.app。dmg 是图形化安装盘适合大多数用户zip 则额外附带一个可双击的一键启动辅助脚本更适合不习惯打开终端的用户。第2步两种安装方式拖一拖或解一解方式一DMG 拖拽安装推荐双击 dmg 文件macOS 会弹出安装窗口背景上写着 Move the app to Applications to get started详见安装脚本 scripts/release-macos.sh将PI-Desktop.app拖入 Applications 文件夹若窗口中出现If app wont open, read this.txt应用无法打开时阅读此文件把它拖到桌面备用——它就是你打开未签名构建的钥匙右键点击磁盘图标选择推出安装完成。方式二ZIP 解压安装双击 zip 文件自动解压你会得到三样东西PI-Desktop.app、PI-Desktop-macOS-opening-help.txt文字说明和 PI-Desktop-macOS-open.command可执行辅助脚本把PI-Desktop.app拖入Applications必须移动不能留在原地。⚠️ 无论哪种方式辅助脚本只识别两个标准位置/Applications/PI-Desktop.app或~/Applications/PI-Desktop.app。请先移动应用再运行它。第3步提示已损坏时如何打开未签名构建默认的 tagged-release 工作流发布的是未签名 macOS 产物。从网上下载的 app 会被 macOS 打上com.apple.quarantine隔离扩展属性Gatekeeper 检查失败时就会弹出应用已损坏应移到废纸篓的提示。这并不是你的电脑或应用真的坏了而是 macOS 对未签名应用的正常拦截。有三种官方支持的解锁方法按推荐顺序排列方法A双击一键辅助脚本ZIP 用户首选将应用移入 Applications 后双击PI-Desktop-macOS-open.command即可。这个脚本的设计非常克制设计决策见 docs/adr/0204-unsigned-macos-first-launch-helper.md只查找/Applications/和~/Applications/两个固定路径不接受任意路径参数用plutil校验 bundle identifier 必须是com.pi-desktop.app拒绝操作其他应用只递归删除com.apple.quarantine这一个属性保留其余所有扩展属性从不用 sudo成功后直接帮你启动 PI-Desktop。方法B阅读 DMG 附带的说明文件DMG 用户将If app wont open, read this.txt拖到桌面后打开阅读该指引由 docs/adr/0232-macos-dmg-text-only-opening-guidance.md 定义里面给出了与下方方法C相同的终端命令。方法C终端一行命令通用兜底打开终端Terminal执行xattr -r -d com.apple.quarantine /Applications/PI-Desktop.app然后再次打开 PI-Desktop。这条命令只移除 Apple 的隔离属性作用范围精确到 PI-Desktop.app 本身——完整说明见 README.md 的 macOS unsigned-build notes 小节。✅签名构建无需任何操作正式发布时通过sign_macos: true手动触发的构建会用 Developer ID 完成签名、公证与装订双击即用。安装完成第一次打开 PI-Desktop成功启动后按 README.md 的路径走完从安装到第一个补丁Settings → Model configuration配置模型提供方与凭据从侧边栏添加本地项目目录选择 Agent / Plan / Goal 模式开始对话。常见问题 FAQQ1为什么默认构建不签名为了让贡献者和发布运维在没有 Developer ID 凭证的情况下也能构建打包决策背景见 docs/adr/0145-native-macos-intel-release-lane.md。签名构建是常规 Gatekeeper 启动路径辅助脚本只是可信未签名产物的显式兜底两者不互相替代。Q2这个 xattr 命令安全吗它只删除隔离标记这一个扩展属性不动文件本体、不提升权限、不碰其他应用。官方反复强调仅对来自可信 PI-Desktop 发布渠道的应用使用切勿对来路不明的 app 执行。Q3应用更新怎么弄打包版应用会检查 GitHub Releases 并在应用内提示新版本macOS 采用通知跳转方式打开发布页下载安装包而非静默覆盖。Q4我是 Intel 老机器能装吗可以。每个 tag 版本都会同时构建 arm64 与 x64 两条原生通道含 Rust 宿主内核的同架构配套Intel 用户下载-x64后缀的安装包即可。【免费下载链接】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），仅供参考