教程

安装 Pi 编程智能体，通过订阅或 API key 完成认证，并完成第一个高效会话。

最后更新: 2026年7月27日

Pi 的工作原理：智能体循环、内置工具、上下文文件、模型提供商、会话与 TUI。

最后更新: 2026年7月27日

Pi 扩展的真实工作机制：TypeScript 模块、ExtensionAPI、事件、自定义工具，以及一个最小可运行示例。

最后更新: 2026年7月27日

Pi coding agent 如何存储、列出、恢复、分叉、压缩并导出会话 —— 覆盖磁盘上的 JSONL 树结构、斜杠命令（/resume、/tree、/fork、/clone）、CLI 参数（--session、--fork、--no-session），以及 ~/.pi/agent/sessions/ 下的检索。

最后更新: 2026年8月7日

Pi TUI 主题如何被选用（settings.json、/settings、--theme 参数）、主题文件放在哪里（~/.pi/agent/themes、.pi/themes、打包）、51 个必填色值 token 各自控制什么，以及如何编写并打包自己的主题。

最后更新: 2026年8月7日

把一个 Pi 扩展从本地 TypeScript 文件（通过 pi -e 测试）变成可版本化的 npm 或 git 包 —— 覆盖 pi.extensions 这个 package.json 字段、dependencies 与 devDependencies 在运行期的区别、npm link、pi install link:、npm publish、git URL、扩展 API 表面（ExtensionAPI、registerTool、on('tool_call')），以及项目级扩展的信任模型。

最后更新: 2026年8月7日

如何为 pi 编码代理新增可调用的工具：扩展侧用 pi.registerTool（TypeScript 模块）、Node.js 应用嵌入 SDK 时用 defineTool + customTools，并附权限、输出截断、Google 兼容枚举等注意事项。

最后更新: 2026年8月11日

Pi 编码代理所有内建斜杠命令的参考指南——/login、/resume、/tree、/fork、/clone、/compact、/share 等各自做什么，以及扩展、技能和 prompt 模板如何注册自己的 /commands 与内建并存。

最后更新: 2026年8月11日

Pi 编码代理如何在 40+ 内建 provider 之间路由请求及对应模型目录：OAuth 与 API key 两种认证流、/model 命令与 Ctrl+P 切换、models.json 自定义模型与 modelOverrides、pricing tiers 与 constrained sampling、以及用 PI_PROVIDER/PI_MODEL 环境变量读取当前激活模型。

最后更新: 2026年8月12日

如何为 pi 编码 agent 做贡献：自动关闭与 lgtm 闸门、议题质量门槛、AGENTS.md 中的 agent 规则、提交前 npm run check + ./test.sh、lockstep 版本号策略与发布流程。

最后更新: 2026年8月14日

pi 编码 agent 的压缩与分支摘要机制：自动触发公式、/compact 与 /tree 斜杠命令、结构化摘要 schema、CompactionEntry 与 BranchSummaryEntry 形状、session_before_compact 与 session_before_tree 扩展事件，以及相关设置项。

最后更新: 2026年8月17日

如何从任意宿主语言无头驱动 pi 编码 agent：-p / --print 做一次性脚本、--mode json 把事件流输出到 stdout、--mode rpc 做 stdio 上的有状态多回合 JSON-RPC——覆盖帧规则、命令集、信任处理、环境变量与 CI 集成。

最后更新: 2026年8月18日

Pi 编码 agent 的全部安装路径——npm 全局安装（带 --ignore-scripts）、Bun、Windows 上的 npm，以及 v0.84.3 引入的 PowerShell 工具——再加上 pi update / pi update --self --force、v0.84.3 实验性的 installer-managed 阶段式更新、版本固定、npmCommand 包装器，以及 defaultTools 配置。

最后更新: 2026年8月24日

Pi 如何为委派工作 spawn 子 pi 进程——官方 subagent 扩展的三种模式（single / parallel / chain）、从 ~/.pi/agent/agents/ 发现 agent、项目级与用户级信任边界、agentScope 与 confirmProjectAgents 设置、流式输出、用量统计、Ctrl+C 中止传播，以及第三方项目（pi-flows、pi-tmux-orchestrator、dsh-pi-agent、pi-goal-list-loop-audit）如何基于同一套原语做扩展。

最后更新: 2026年8月27日