Pi 知识库
Pi 保持极简 core:加载项目 instructions、保存可分享 session trees,并通过 extensions 添加其他 harness 内置的能力。因此必须更明确地区分 installed capability、trusted environment 与 reviewed organizational knowledge。

MAP
Pi 提供 primitives:明确 extension、约束环境、审核结果。
Pi 保持极简 core:加载项目 instructions、保存可分享 session trees,并通过 extensions 添加其他 harness 内置的能力。因此必须更明确地区分 installed capability、trusted environment 与 reviewed organizational knowledge。
项目 instructions 与 prompt policy
Conversation branches 与 history
安装的 procedure 或 executable capability
Reviewed shared claim
01 · Pi 知识库
minimal core with extensions, Skills, prompts, themes, and packages
Pi 保持极简 core:加载项目 instructions、保存可分享 session trees,并通过 extensions 添加其他 harness 内置的能力。因此必须更明确地区分 installed capability、trusted environment 与 reviewed organizational knowledge。
| Layer | Owns | Boundary |
|---|---|---|
| AGENTS.md / SYSTEM.md | 项目 instructions 与 prompt policy | Execution guidance,不是变化的业务事实 |
| Session tree | Conversation branches 与 history | 有用 provenance,不是 accepted decision |
| Skill / extension / package | 安装的 procedure 或 executable capability | 需要 version 与 trust review |
| Busabase record | Reviewed shared claim | 由 owner 控制的组织记忆 |
02 · Pi 知识库
AGENTS.md and SYSTEM.md context
Pi 提供 primitives:明确 extension、约束环境、审核结果。
Pi 有意不内置 MCP、subagents、permission popups 或 plan mode。
Extension 可增加 tools、events、UI、context injection 或 custom controls;安装代码属于 trust boundary。
Summary 保存 context,但不能替代 source-of-truth evidence。
官方提到 containerization 与 project trust;这些 controls 不验证 claim。
03 · Pi 知识库
JSONL session trees and extension-controlled compaction
Pi 知识库: minimal core with extensions, Skills, prompts, themes, and packages; AGENTS.md and SYSTEM.md context; JSONL session trees and extension-controlled compaction.
AGENTS.md / SYSTEM.md项目 instructions 与 prompt policy. Execution guidance,不是变化的业务事实Session treeConversation branches 与 history. 有用 provenance,不是 accepted decisionSkill / extension / package安装的 procedure 或 executable capability. 需要 version 与 trust reviewBusabase recordReviewed shared claim. 由 owner 控制的组织记忆EVIDENCE
Pi 知识库: inspect the execution boundary
MINIMAL CORE: Pi 有意不内置 MCP、subagents、permission popups 或 plan mode。 EXTENSION: Extension 可增加 tools、events、UI、context injection 或 custom controls;安装代码属于 trust boundary。 COMPACTION: Summary 保存 context,但不能替代 source-of-truth evidence。 CONTAINER: 官方提到 containerization 与 project trust;这些 controls 不验证 claim。
pi_1AGENTS.md / SYSTEM.md: 项目 instructions 与 prompt policy; Execution guidance,不是变化的业务事实pi_2Session tree: Conversation branches 与 history; 有用 provenance,不是 accepted decisionpi_3Skill / extension / package: 安装的 procedure 或 executable capability; 需要 version 与 trust reviewpi_4Busabase record: Reviewed shared claim; 由 owner 控制的组织记忆ACCEPTANCE
Pi 知识库: execution is not acceptance
Pi 提供 primitives:明确 extension、约束环境、审核结果。
Pi 有意不内置 MCP、subagents、permission popups 或 plan mode。
Extension 可增加 tools、events、UI、context injection 或 custom controls;安装代码属于 trust boundary。
Summary 保存 context,但不能替代 source-of-truth evidence。
官方提到 containerization 与 project trust;这些 controls 不验证 claim。
PLACEMENT
Pi 知识库: keep context with its owner
AGENTS.md / SYSTEM.md owns 项目 instructions 与 prompt policy. Session tree owns Conversation branches 与 history. Skill / extension / package owns 安装的 procedure 或 executable capability. Busabase record owns Reviewed shared claim.
| Layer | Owns | Boundary |
|---|---|---|
| AGENTS.md / SYSTEM.md | 项目 instructions 与 prompt policy | Execution guidance,不是变化的业务事实 |
| Session tree | Conversation branches 与 history | 有用 provenance,不是 accepted decision |
| Skill / extension / package | 安装的 procedure 或 executable capability | 需要 version 与 trust review |
| Busabase record | Reviewed shared claim | 由 owner 控制的组织记忆 |
FRESHNESS
Pi 知识库: record what can change
MINIMAL CORE: Pi 有意不内置 MCP、subagents、permission popups 或 plan mode。 EXTENSION: Extension 可增加 tools、events、UI、context injection 或 custom controls;安装代码属于 trust boundary。 COMPACTION: Summary 保存 context,但不能替代 source-of-truth evidence。 CONTAINER: 官方提到 containerization 与 project trust;这些 controls 不验证 claim。
source_versionhttps://pi.devruntime_factminimal core with extensions, Skills, prompts, themes, and packages | AGENTS.md and SYSTEM.md context | JSONL session trees and extension-controlled compactionreview_ownerAccountable human reviewernext_reviewA stated recheck boundaryFAQ
Pi 知识库: practical questions
Pi 提供 primitives:明确 extension、约束环境、审核结果。
Pi 内置 MCP client 吗?
没有。官方把 MCP 视为通过 extension 或 package 添加的能力,不能把第三方支持写成 native behavior。
AGENTS.md 能保存变化状态吗?
能,但它不是 mutable cross-system facts 的合适 owner。项目 instructions 留在这里,业务状态单独审核。
分享 session 等于 approval record 吗?
不等于。它是 provenance;reviewer 还需要 bounded claim 与 source evidence。
Extension 默认提供 governance 吗?
它可以实现 controls,但存在并不证明 outcome 已审核或仍有效。
NEXT
Pi 提供 primitives:明确 extension、约束环境、审核结果。
Pi 保持极简 core:加载项目 instructions、保存可分享 session trees,并通过 extensions 添加其他 harness 内置的能力。因此必须更明确地区分 installed capability、trusted environment 与 reviewed organizational knowledge。
