这里不只拆解内部模块，也记录一次任务为什么会失败、怎样恢复，以及工程判断如何落到可验证结果。
从这里开始
RCRA 中断恢复
说明用户取消或进程退出后，对话、工具调用和工作流日志分别保留什么，并给出继续执行前可核对的依据。
主题地图
按问题进入
核心执行
模型请求、执行循环与提示词怎样形成一次可重复的 Agent 回合。
2026-08-16
系统提示词
说明 Peri 如何组合会话级 base prompt、request-time middleware contribution 与 Provider cache seam。
2026-08-16
RCRA Loop
说明 Peri 的 RCRA 循环如何消费消息、投影视图、请求模型、原子提交工具交换，并在 Receive 收口退出。
2026-08-16
Hook 与 Middleware
说明 MiddlewareChain 如何承载运行期能力，Hook 如何映射生命周期节点，以及规则执行、失败放行和配置顺序边界。
2026-08-22
Meta Harness 的能力闭包
说明段落覆盖、middleware 卸载与内置 SubAgent 策略如何在会话创建时形成一致的能力边界。
状态与事件
会话历史、压缩恢复与事件身份怎样跨轮次保持一致。
代表文章已在页首展示 · RCRA 中断恢复
2026-08-16
并发工具调用
说明同一回合的多个工具如何并发执行并成组提交记录，以及事件乱序、失败、中断和持久化窗口的边界。
2026-08-16
Compact 多轮稳定
说明 Compact 标记与投影指令如何跨轮次和会话重建模型视图，并列出版本不匹配、持久化失败与 Provider 差异的降级边界。
协作与协议
协议边界、子代理与工作流怎样组织多个执行者。
2026-07-28
Multi Agent
说明 Peri 如何在主会话之外运行标准、Fork 和后台子代理，并梳理上下文、工具、事件与取消边界。
2026-08-16
Dynamic Workflow
说明 Dynamic Workflow 在子代理执行体之上生成并运行编排脚本，以及 journal 恢复、失败处理和可重放范围。
2026-08-16
ACP 协议层
从 peri-acp 源码说明会话、请求与事件分层，以及统一事件身份、序列化契约和多客户端接入边界。
界面
终端界面怎样保持可观察、可验证。
2026-08-13
流式 Markdown 渲染
说明增量 Markdown 缓存如何处理块结构翻转、尾部不稳定内容和终端宽度变化，并用全量解析结果验证一致性。
Agent 模式
从最小装配开始构建 Agent，并通过工具搜索扩展任务执行能力。
2026-08-22
Minimal Agent
以 example/minimal 为起点，说明如何关闭默认 middleware、接入工具来源，并通过 ToolSearch 完成工具发现与任务执行。
扩展能力
外部协议和共享能力怎样接入 Agent，同时保持边界清晰。
2026-08-16
MCP 支持
从配置合并到工具执行，了解 Peri 如何接入 MCP server、延迟发现工具，并处理连接失败与 OAuth 授权。
2026-08-22
MCPP Caching
复用远程 MCP 的工具与资源发现结果，减少重复列表请求；本文说明缓存如何接入连接生命周期，以及何时必须回源。
2026-08-22
MCPP Skills
让 MCP server 直接提供远程 Skill，避免维护工作区副本；本文说明 Skill 的发现、校验、注册和连接断开边界。
2026-08-22
MCP 2026-07-28
了解新版 MCP 握手和可选订阅如何接入 Peri：新版发现、变化通知、缓存失效与 legacy 兼容路径分别怎样工作。
存算分离
会话存储、执行生命周期与宿主环境各自独立：重启不恢复执行、归属按机器与路径确定、核心可嵌入宿主运行时。
2026-10-16
重启不恢复执行
说明 v4 撤销持久执行恢复后重启 Peri 会发生什么：历史消息与冻结上下文照常加载，模型请求、工具调用、子代理、审批与待发输入不会复活。
2026-10-16
会话归属三层模型
说明 Peri 怎样用机器身份与路径确定会话归属：归属键是机器加路径，机器身份来自本地文件而不是硬件指纹，并给出可见入口与不保证的部分。
2026-10-16
嵌入与 WASM 契约
说明 Peri 的 TypeScript SDK 在嵌入形态下给什么、不替谁管什么：transport 必须由宿主注入，关闭走有界重放，网络、DNS、定时器与容量全在宿主侧。