如何无账号使用PI-Desktop本地优先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 是一款无需注册账号的本地优先Local-firstAI 编程 Agent 桌面客户端项目、会话、设置全部保存在你自己的电脑上模型请求直连你配置的 API 或本地模型服务不经过任何强制中转也没有遥测。本文用 5 个步骤带你从零搭好一套完全由自己掌控的 AI 编程工作流。为什么无账号很重要市面上很多 AI 编程工具要么绑账号要么必须走官方云端。PI-Desktop 的设计哲学是不绑账号 · 不绑中转 · 不锁编辑器数据行为会话记录本地 JSONL 文件 SQLite 索引存在你的机器上设置保存在本机API 密钥保存在操作系统钥匙串/本机加密存储日志本地遥测Telemetry无模型请求直连你自己配置的 Provider 或本地端点也就是说它联网的唯一目的是调用你主动填写的那个模型服务如果你用 Ollama 之类的本地模型整个流程甚至可以完全离线。快速上手5步搭建本地AI编程工作流步骤1下载安装包支持 macOS / Windows / Linux从官方 Releases 页面下载对应平台的安装包即可无需任何账号体系平台架构安装包macOSApple Silicon / Intel.dmg/.zipWindowsx64NSIS 安装包 / 便携版.exeLinuxx64.AppImage/.deb/.rpm Linux 发行版需glibc ≥ 2.35如 Ubuntu 22.04、Debian 12、Fedora 36可用ldd --version检查。步骤2接入你自己的模型核心一步打开Settings → Model configuration模型配置选择服务商或自定义端点填入 Base URL 和 API Key 即可全程不经过第三方PI-Desktop 对模型来源完全开放模型只是可替换的零件OpenAI / Anthropic 等主流厂商填 API Key 直连OpenAI 兼容 APIOpenRouter、DeepSeek、Groq 等网关均可本地模型Ollama、LM Studio 等本地网关 —— 这是无账号离线编程的关键每个模型可独立配置上下文窗口、最大输出、推理Thinking等级多个服务商可以并存管理还能在输入框里随时切换模型不用重建会话服务商配置的完整字段说明见 docs/spec/03-runtime/12-provider-config-schema.md 和 docs/spec/03-runtime/11-provider-model-system.md。步骤3打开一个本地项目在侧边栏直接添加任意本地仓库或项目目录。项目、会话、文件、Diff 审查、Agent 执行过程全部集中在同一个工作区里不需要把代码上传到任何云平台。步骤4选择工作模式 Agent / Plan / Goal 同一个 Agent三种控制边界按需选择模式你确认什么适合场景Agent无额外确认日常快速改代码Plan先看冻结的实施计划再批准大型重构、高风险改动Goal只定义目标与验收条件只关心结果、不管过程无论哪种模式高权限操作写文件、跑命令都会经过 PI-Desktop 的权限层你可以随时检查 Diff 和命令输出。步骤5审查改动持续协作Agent 干活时你能看到完整过程长会话带消息导航改了什么、跑了什么命令、输出了什么都能在 Review 面板里逐一审查不用离开 PI-Desktop。你的数据存在哪本地数据目录一览 所有应用数据都集中在~/.pi-desktop/目录结构清晰、可备份、可迁移~/.pi-desktop/ ├── pi.sqlite # SQLite 索引数据库 ├── sessions/ # 每个会话一个 JSONL 文件人类可读 ├── secrets/ # 加密存储的密钥 ├── attachments/ # 内容寻址的附件文件 ├── plugins/ # 插件代码与注册表 └── logs/ # 本地日志会话内容是文件 索引的双层设计消息本体写在 JSONL 里可用任何文本工具打开SQLite 只负责索引和检索这让数据完全归你所有不只是口号。详细设计可阅读 docs/spec/03-runtime/04-data-storage.md。进阶玩法导入历史会话 插件扩展 带旧会话搬家如果你已经在使用 Claude Code、Codex、OpenCode 或 Pi打开Settings → Import就能把本地历史会话直接导入 PI-Desktop工作从零成本延续。插件生态不满足内置功能可以通过插件市场安装 Skills、MCP 服务器、Subagents 和完整插件扩展的是 Agent 能力和整个桌面工作台想动手写第一个插件参考 docs/plugin-development.md 和 examples/plugins/ 下的示例插件。⚠️ 提示插件拥有权限控制且与渲染进程隔离但仍属于你主动信任的代码请只安装信任的插件。常见问题 FAQ ❓Q用 PI-Desktop 必须注册账号吗不需要。没有任何强制账号也没有强制云端中转模型请求只发给你配置的服务。Q能完全离线用吗可以。接上 Ollama / LM Studio 等本地模型服务后请求只发往localhost工作流完全离线。QmacOS 提示应用已损坏打不开当前 macOS 发布默认为未签名构建。将PI-Desktop.app移入/Applications后执行xattr -r -d com.apple.quarantine /Applications/PI-Desktop.app再打开即可DMG 内附有说明文件。Q应用架构是怎样的界面层React 渲染进程、高权限能力层Rust Host Core源码在 crates/host-core/、Agent 运行时pi 侧车进程源码在 packages/agent-runtime/三层解耦渲染进程不启用 Node 集成架构说明见 docs/spec/02-architecture/01-architecture.md。可选从源码构建开发版 ️想体验最新代码或参与开发要求 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完整入门指引见 docs/guide/index.md 与仓库根目录的 README.md。写在最后PI-Desktop 证明了 AI 编程 Agent 不必依赖账号和云端模型随便换、项目留在本地、权限握在自己手里。按上面 5 步走完你就能拥有一个真正属于自己的 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何无账号使用PI-Desktop：本地优先AI编程工作流完整搭建教程
如何无账号使用PI-Desktop本地优先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 是一款无需注册账号的本地优先Local-firstAI 编程 Agent 桌面客户端项目、会话、设置全部保存在你自己的电脑上模型请求直连你配置的 API 或本地模型服务不经过任何强制中转也没有遥测。本文用 5 个步骤带你从零搭好一套完全由自己掌控的 AI 编程工作流。为什么无账号很重要市面上很多 AI 编程工具要么绑账号要么必须走官方云端。PI-Desktop 的设计哲学是不绑账号 · 不绑中转 · 不锁编辑器数据行为会话记录本地 JSONL 文件 SQLite 索引存在你的机器上设置保存在本机API 密钥保存在操作系统钥匙串/本机加密存储日志本地遥测Telemetry无模型请求直连你自己配置的 Provider 或本地端点也就是说它联网的唯一目的是调用你主动填写的那个模型服务如果你用 Ollama 之类的本地模型整个流程甚至可以完全离线。快速上手5步搭建本地AI编程工作流步骤1下载安装包支持 macOS / Windows / Linux从官方 Releases 页面下载对应平台的安装包即可无需任何账号体系平台架构安装包macOSApple Silicon / Intel.dmg/.zipWindowsx64NSIS 安装包 / 便携版.exeLinuxx64.AppImage/.deb/.rpm Linux 发行版需glibc ≥ 2.35如 Ubuntu 22.04、Debian 12、Fedora 36可用ldd --version检查。步骤2接入你自己的模型核心一步打开Settings → Model configuration模型配置选择服务商或自定义端点填入 Base URL 和 API Key 即可全程不经过第三方PI-Desktop 对模型来源完全开放模型只是可替换的零件OpenAI / Anthropic 等主流厂商填 API Key 直连OpenAI 兼容 APIOpenRouter、DeepSeek、Groq 等网关均可本地模型Ollama、LM Studio 等本地网关 —— 这是无账号离线编程的关键每个模型可独立配置上下文窗口、最大输出、推理Thinking等级多个服务商可以并存管理还能在输入框里随时切换模型不用重建会话服务商配置的完整字段说明见 docs/spec/03-runtime/12-provider-config-schema.md 和 docs/spec/03-runtime/11-provider-model-system.md。步骤3打开一个本地项目在侧边栏直接添加任意本地仓库或项目目录。项目、会话、文件、Diff 审查、Agent 执行过程全部集中在同一个工作区里不需要把代码上传到任何云平台。步骤4选择工作模式 Agent / Plan / Goal 同一个 Agent三种控制边界按需选择模式你确认什么适合场景Agent无额外确认日常快速改代码Plan先看冻结的实施计划再批准大型重构、高风险改动Goal只定义目标与验收条件只关心结果、不管过程无论哪种模式高权限操作写文件、跑命令都会经过 PI-Desktop 的权限层你可以随时检查 Diff 和命令输出。步骤5审查改动持续协作Agent 干活时你能看到完整过程长会话带消息导航改了什么、跑了什么命令、输出了什么都能在 Review 面板里逐一审查不用离开 PI-Desktop。你的数据存在哪本地数据目录一览 所有应用数据都集中在~/.pi-desktop/目录结构清晰、可备份、可迁移~/.pi-desktop/ ├── pi.sqlite # SQLite 索引数据库 ├── sessions/ # 每个会话一个 JSONL 文件人类可读 ├── secrets/ # 加密存储的密钥 ├── attachments/ # 内容寻址的附件文件 ├── plugins/ # 插件代码与注册表 └── logs/ # 本地日志会话内容是文件 索引的双层设计消息本体写在 JSONL 里可用任何文本工具打开SQLite 只负责索引和检索这让数据完全归你所有不只是口号。详细设计可阅读 docs/spec/03-runtime/04-data-storage.md。进阶玩法导入历史会话 插件扩展 带旧会话搬家如果你已经在使用 Claude Code、Codex、OpenCode 或 Pi打开Settings → Import就能把本地历史会话直接导入 PI-Desktop工作从零成本延续。插件生态不满足内置功能可以通过插件市场安装 Skills、MCP 服务器、Subagents 和完整插件扩展的是 Agent 能力和整个桌面工作台想动手写第一个插件参考 docs/plugin-development.md 和 examples/plugins/ 下的示例插件。⚠️ 提示插件拥有权限控制且与渲染进程隔离但仍属于你主动信任的代码请只安装信任的插件。常见问题 FAQ ❓Q用 PI-Desktop 必须注册账号吗不需要。没有任何强制账号也没有强制云端中转模型请求只发给你配置的服务。Q能完全离线用吗可以。接上 Ollama / LM Studio 等本地模型服务后请求只发往localhost工作流完全离线。QmacOS 提示应用已损坏打不开当前 macOS 发布默认为未签名构建。将PI-Desktop.app移入/Applications后执行xattr -r -d com.apple.quarantine /Applications/PI-Desktop.app再打开即可DMG 内附有说明文件。Q应用架构是怎样的界面层React 渲染进程、高权限能力层Rust Host Core源码在 crates/host-core/、Agent 运行时pi 侧车进程源码在 packages/agent-runtime/三层解耦渲染进程不启用 Node 集成架构说明见 docs/spec/02-architecture/01-architecture.md。可选从源码构建开发版 ️想体验最新代码或参与开发要求 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完整入门指引见 docs/guide/index.md 与仓库根目录的 README.md。写在最后PI-Desktop 证明了 AI 编程 Agent 不必依赖账号和云端模型随便换、项目留在本地、权限握在自己手里。按上面 5 步走完你就能拥有一个真正属于自己的 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考