Pi¶

T3 Code 可以使用您现有的 Pi 编码代理安装，同时保留 Pi 的模型、认证、扩展、技能、上下文文件和原生会话历史。

设置 Pi¶

1. 在运行 T3 Code 服务器的机器上安装 Pi。Pi 需要 Node.js 22.19 或更高版本；其平台安装程序可以在需要时安装 Node。T3 Code 支持 Pi 0.80.5 或更高版本。
2. 在终端中运行 pi，然后输入 /login 以连接您的模型提供商或配置其 API 密钥。
3. 打开 T3 Code 设置，启用 Pi，然后刷新提供商。

对于 npm 安装，请使用：

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

如果 pi 不在服务器的 PATH 中，请将 Pi 的二进制路径设置为可执行文件。对于需要自定义代理目录、端点或模型配置的安装，还可以使用提供商环境变量和启动参数。--provider 必须与 --model 配对使用。T3 Code 会拒绝改变 Pi 执行模式或选择会话的启动参数，因为 T3 掌控着这些进程生命周期部分。

在远程或无头服务器上，通过 SSH 连接到该机器并运行 pi，然后执行 /login。在您自己的计算机上打开授权 URL。如果回调无法到达服务器，请在提示时将最终的重定向 URL 或授权代码粘贴回 Pi。您还可以在 Pi 实例的设置中设置模型提供商的 API 密钥环境变量；将机密值标记为敏感。

使用 pi update 更新由安装程序管理的 Pi。如果另一个包管理器拥有该安装，请改用它进行更新。例如，Nix profile 安装使用 nix profile upgrade pi。

会保留什么¶

T3 Code 会发现 Pi 报告的模型，并展示其支持的思考级别。思考选择器会将已发现活动模型的已配置级别标记为默认值，而不会覆盖它。当未选择级别时，其他模型会保留 Pi 默认设置。在 Pi 定义中列出 serviceTiers（例如 [{ "id": "priority", "name": "Fast" }]）的模型会获得一个速度选择器，其中包含 Standard 以及这些层级。所选层级将作为请求的 service_tier 发送；Standard 不发送任何内容，并使用端点的默认值。线程使用 Pi 的原生会话文件，以便在同一 Pi 实例内进行恢复、回滚和分叉。分叉会将原生对话保留到目标工作区中的所选轮次。切换提供商时会使用可移植的对话上下文。扩展对话框会出现在 T3 Code 编写器中，线程详情上下文窗口会在响应流式传输期间及完成之后遵循 Pi 自身的用量报告。

Pi 技能会出现在编写器的 $ 菜单中。这包括 Pi 为当前工作区加载的用户技能和项目技能；选择其中一个会使用 Pi 的原生技能扩展。

Pi 会加载其正常的用户扩展，并且在 Pi 中信任该文件夹后加载项目扩展。阻塞式的 select、confirm、input 和 editor 对话框可在 T3 Code 中正常工作。通知会出现在工作日志中。扩展可以在编写器附近发布状态文本。终端标题和通用小部件在 T3 Code 中没有对应的功能。

权限模式¶

T3 Code 通过 Pi 的阻塞式工具钩子应用编写器权限模式：

• 受监督 会在执行命令、文件更改和扩展工具之前询问。只读工具可继续执行。
• 自动接受编辑 允许 Pi 的编辑和写入工具，但会在执行命令和扩展工具之前询问。
• 完全访问 允许工具在无需 T3 Code 审批提示的情况下运行。

Auto 选项不会为 Pi 显示，因为 Pi 没有提供 AI 审批审查器。在添加 Pi 支持之前已存储 Auto 的线程，其行为和显示都与 Supervised 一致。

更改模式会重启 Pi 提供商会话，并恢复相同的原生对话。该策略涵盖 Pi 工具调用；它不是操作系统沙箱，受信任的 Pi 扩展在工具调用之外运行的代码仍受 Pi 自身扩展信任模型的约束。

T3 Code 的 delegate_task 工具会在共享的 subagent UI 中创建持久的子线程。如果用户安装了 Pi 的示例 subagent 扩展，T3 Code 也会在该 UI 中显示其任务进度和结果。Pi 在无会话的情况下运行这些子线程，因此它们无法作为 T3 Code 线程打开或恢复。

故障排除¶

• 如果 Pi 不可用，请确认配置的二进制文件能在服务器机器上运行，然后在设置中刷新提供商。
• 如果没有模型出现，请直接打开 Pi，并确认其身份验证和模型配置。
• 如果发现无法完成，T3 Code 会使用 Pi default 模型保持 Pi 可用。启动一个线程，让交互式 Pi 会话处理任何启动提示。
• 如果 Pi 因文件夹不受信任而跳过项目设置、扩展、技能、提示、MCP 服务器或系统提示文件，则线程会在 Pi 会话的第一轮显示通知。在服务器机器上的该文件夹中运行配置的 Pi 二进制文件，并使用相同的提供商环境，包括 PI_CODING_AGENT_DIR（如果已设置）。使用 /trust 信任该文件夹或其父文件夹，然后使用同一工作树启动一个新线程。带有 --no-approve 的启动参数会不加载项目文件，且不会显示通知。
• 要在 Web 和桌面端查看上下文使用情况，请在 设置 → 外观 → 线程详情 中开启 上下文窗口。一旦 Pi 报告该线程的使用情况，它就会显示。某些模型提供商只在响应完成时报告使用情况，因此它可能要等到第一次回复后才会出现。