北辰 Pi 是一款专为 Windows 用户设计的图形化桌面客户端,旨在将强大的 Pi 编程代理封装进一个轻量、透明且可控的环境中。它拒绝臃肿的聊天壳,专注于让本地或云端模型安静、高效地执行代码编写、工具调用及长任务处理,同时确保每一枚 Token 的去向都清晰可查、结果可复现。
核心设计理念
- 本地优先与隐私安全:支持无密钥本地模型(如 Ollama、LM Studio),所有记忆、会话和文件均保留在本地
%USERPROFILE%\.pi\agent 目录下,无遥测、无强制云服务。 - 透明可控:提供实时的 Token/s 速率、上下文占用圆环及完整的思考过程展示。不隐藏日志,不伪造压缩,让用户清楚知道模型“想”了什么、“做”了什么。
- 明确边界:区分 ChatGPT(问答/创意)与 Codex(项目/执行)两种工作模式,通过独立的工作目录和 RPC 进程隔离任务,确保环境纯净。
关键功能亮点
1. 双模工作流:ChatGPT vs Codex
- ChatGPT 模式:适合日常问答、写作与分析,不加载文件修改工具,保护项目安全。
- Codex 模式:专为开发设计,内置
read, edit, powershell, grep 等工具,可读取项目上下文、执行命令并交付完整功能。
2. 极致的上下文与性能控制
- 五档性能模式:从日常的 CODEX 到极限优化的 GHOST PAYLOAD,用户可精细控制推理强度、进度显示及上下文策略。
- Quantum Collapse:回合后自动将思考过程压缩为短摘要,保留推理线索但节省后续上下文。
- Ghost Payload:直接剔除已完成回合的思考块,最小化载荷,适合超长任务。
- 实时 Token 仪表:底部状态行提供上下文圆环、累计费用、缓存命中率及实时速率图表,点击即可展开详细统计。
3. 灵活的模型接入
- 多服务商支持:原生支持 OpenAI, Anthropic, GitHub Copilot, xAI 等订阅服务及 API Key。
- 自定义 API:一键接入任何兼容 OpenAI/Anthropic 协议的本地或私有网关(如 vLLM, DeepSeek),支持加密存储凭据。
- 自由切换思考强度:根据模型能力动态调整推理等级(Off 到 Max),即时生效无需重启。
4. 沉浸式视觉体验
- 七套主题:包括极简 Codex、水墨、武林剑客、温柔猫娘、奶油治愈、星夜玻璃及赛博科技,满足从极客到文艺的不同审美。
- 自绘 UI 组件:摒弃原生下拉框,采用应用自绘的圆角子菜单,支持平滑的主题切换与中英文实时转换。
快速开始
- 下载:从 Release 页面获取
Beichen-Pi-Setup-1.8.1-x64.exe(安装版)或便携版。 - 安装/运行:
- 安装版:适合长期使用,创建快捷方式。
- 便携版:双击即运行,首次启动稍慢(需解压运行时)。
- 注意:由于未购买商业签名证书,Windows SmartScreen 可能会提示“未知发布者”,请核对 SHA-256 后允许运行。
- 配置模型:
- 启动后进入“设置 → 模型与接入”。
- 选择“会员订阅”进行 OAuth 登录,或输入 API Key。
- 若使用本地模型,添加自定义 API 指向
http://127.0.0.1:11434/v1 等地址。
- 开始任务:
- 点击左侧“新任务”创建会话。
- 在顶部切换 ChatGPT/Codex 模式。
- 在输入区下方选择模型与推理强度,开始对话或项目执行。
系统要求
- 操作系统:Windows 10 / 11 (x64)
- 内存:建议 8 GB 以上
- 磁盘:至少 500 MB 可用空间
- 网络:使用云模型时需联网;本地模型可完全离线
最佳实践
- 工作目录管理:为每个项目设置独立的工作目录,切换目录会自动重启该窗口的 Pi RPC,确保工具执行环境正确。
- 会话备份:定期备份
%USERPROFILE%\.pi\agent\sessions 目录,但请勿上传 auth.json 等凭据文件。 - 性能调优:对于长代码生成任务,尝试使用 Quantum Collapse 模式以平衡推理质量与上下文长度;对于简单查询,使用 CODEX 模式以节省费用。