Pi 配置
入口： 侧边栏 → 设置 → 依赖管理 → Pi
实验性功能，默认关闭
Pi 支持是实验功能，默认关闭。请先在 常规设置 → 实验功能 → Pi 支持 中开启，依赖管理、设置面板与对话窗口的 Pi 入口才会显示。开启后可能不稳定。
Pi（Pi coding agent）是 LoongCode 接入的又一个 AI 助手家族，采用原生 RPC 驱动 + LoongCode 托管 Bridge Extension 的接入路线。本页管理 Pi 的 Bridge 与 Package / Extension——注意：Pi 的 Package / Extension 与 LoongCode 的「插件」不是同一概念，插件设置页不会出现 Pi 页签，Pi 的相关扩展统一在本页管理。
若 Pi CLI 尚未安装，本页会提示先安装；Pi 的安装 / 检测 / 更新统一在依赖管理中完成。
LongCode Bridge
Bridge（loongcode-pi-bridge）由 LoongCode 自动部署和管理，不属于用户 Package，无需手动维护。它补齐 Pi 原生不具备的两项能力：
| 能力 | 状态 |
|---|---|
| 内置支持 | 已支持 |
| 权限拦截 | 已支持——Pi 任务中的权限确认由 Bridge 拦截并转成审批卡片 |
| AskUserQuestion | 已支持——Pi 的结构化提问经 Bridge 转成前端询问 |
受支持的 Package（能力适配）
Pi 的产品取向是保持核心精简，把权限确认、MCP、子智能体、规划、长期记忆等功能交给 Extension 或 Package 完成。为避免多个社区实现互相冲突，LoongCode 对每种能力只适配一个经过版本验证的实现：
| 能力 | 说明 |
|---|---|
| MCP | 经 pi-mcp-adapter 适配（用户级写 ~/.pi/agent/mcp.json，工作区级写 <项目>/.pi/mcp.json） |
| 子智能体 | 经受支持的 Pi Subagent Package 适配，运行态在对话中呈现生命周期卡片 |
| 钩子 | 经受支持的 Hook Package 适配 |
| 增强记忆 | 经 pi-hermes-memory 适配（持久记忆、会话搜索与后台学习，配置见记忆的 Pi 页签） |
每项能力显示安装 / 适配状态：
| 状态 | 含义 |
|---|---|
| 未安装 | 尚未安装对应实现，提供安装受支持版本按钮 |
| 已安装 | 已安装且版本在受支持范围内 |
| 已禁用 | Package 已安装，但其 Extension 资源已在 Pi 配置中禁用，提供启用受支持实现按钮 |
| 版本不兼容 | 已检测到对应 Package，但版本不在 LoongCode 的已测试范围内 |
| 等待 LongCode 支持包发布 | 已规划但支持包尚未发布 |
| 候选，等待跨平台验证 | 已有候选实现，待验证 |
LoongCode 会对每个受支持实现做 npm 兼容升级检测（对照 npm registry 的 dist-tags）：npm 存在更新版本但未测试时会提示「npm 有更新版本（未测试，等 LoongCode 更新）」；已是最新测试版本则显示确认。受支持版本的安装 / 启用由 LoongCode 代管，不要手动更换版本，否则可能落入不兼容状态。
全部 Package（通用安装）
本区块允许安装任意 npm、git、GitHub URL 或本地路径的 Pi Package / Extension。LoongCode 只管理其生命周期，不保证第三方配置兼容。
| 字段 | 说明 |
|---|---|
| Package source | 如 npm:package@version、git:github.com/user/repo@tag 或本地路径 |
| 作用域 | 用户（当前用户）或 当前项目（需有活动工作区） |
安全提示
Pi Package 与 Extension 以当前用户权限执行任意代码。安装前请确认来源可信。
与任务配置的关系
Pi 任务在选择器栏中选择 Pi 后：
- 模型：从你在模型供应商配置的供应商中选择（任务按
pi_provider/pi_model落库） - 思考深度：提供 Pi 的思考档位（含
default不指定档） - 执行授权：三档——审批（每步确认）/ 计划（先出计划再审批）/ 完全访问（全部放行）
Pi 任务支持会话分叉（文件级 fork，基于 Pi 原生 parentId 树），但暂不支持编辑历史消息重跑。