第三部分，上下文与 Sessions

AGENTS.md 与上下文文件

用 AGENTS.md、CLAUDE.md、SYSTEM.md 和 APPEND_SYSTEM.md 固化项目规则与系统提示。

基础 / 10 分钟 / 第 13 篇

加载顺序与作用

Pi 加载全局 ~/.pi/agent/AGENTS.md，并从父目录到当前目录读取 AGENTS.md 或 CLAUDE.md。它们适合保存构建命令、架构约束、测试标准和禁止事项。

.pi/SYSTEM.md 会替换默认系统提示，APPEND_SYSTEM.md 只追加内容。除非正在构建完全不同的代理，通常优先使用 AGENTS.md，避免破坏默认工具行为。

markdown
# Project Instructions

- 修改代码后运行 npm test。
- 不得提交 .env 或 API Key。
- dist 是生成物，不手工编辑。
- 数据库迁移必须附带回滚说明。

更新与禁用

修改上下文文件后重启 Pi 或运行 /reload。一次性不加载上下文可以使用 --no-context-files 或 -nc。

上下文文件是指令，不是安全边界。真正的权限控制必须由文件系统、容器和凭据策略实现。

官方文档图片

以下图片直接来自本页引用的官方资料，本站保存本地副本并保留逐图来源。

Using Pi Context Files

Interactive Mode
Interactive Mode官方图片来源

官方资料

本页由 xueai 根据 Pi 官方资料用中文重新组织和讲解。Pi 更新频繁，命令、包名和接口以官方最新文档为准。

Pi 源代码和官方文档采用 MIT License。Copyright (c) 2025 Mario Zechner。本站保留原版权与许可声明，完整文本见 MIT License。