Skip to content

工程

这里不只拆解内部模块,也记录一次任务为什么会失败、怎样恢复,以及工程判断如何落到可验证结果。

RCRA 中断恢复

说明用户取消或进程退出后,对话、工具调用和工作流日志分别保留什么,并给出继续执行前可核对的依据。

按问题进入

01核心执行模型请求、执行循环与提示词怎样形成一次可重复的 Agent 回合。4 篇02状态与事件会话历史、压缩恢复与事件身份怎样跨轮次保持一致。3 篇03协作与协议协议边界、子代理与工作流怎样组织多个执行者。3 篇04界面终端界面怎样保持可观察、可验证。1 篇05Agent 模式从最小装配开始构建 Agent,并通过工具搜索扩展任务执行能力。1 篇06扩展能力外部协议和共享能力怎样接入 Agent,同时保持边界清晰。4 篇
01

核心执行

模型请求、执行循环与提示词怎样形成一次可重复的 Agent 回合。

Hook 与 Middleware

说明 MiddlewareChain 如何承载运行期能力,Hook 如何映射生命周期节点,以及规则执行、失败放行和配置顺序边界。

Meta Harness 的能力闭包

说明段落覆盖、middleware 卸载与内置 SubAgent 策略如何在会话创建时形成一致的能力边界。

02

状态与事件

会话历史、压缩恢复与事件身份怎样跨轮次保持一致。

并发工具调用

说明同一回合的多个工具如何并发执行并成组提交记录,以及事件乱序、失败、中断和持久化窗口的边界。

Compact 多轮稳定

说明 Compact 标记与投影指令如何跨轮次和会话重建模型视图,并列出版本不匹配、持久化失败与 Provider 差异的降级边界。

03

协作与协议

协议边界、子代理与工作流怎样组织多个执行者。

Multi Agent

说明 Peri 如何在主会话之外运行标准、Fork 和后台子代理,并梳理上下文、工具、事件与取消边界。

Dynamic Workflow

说明 Dynamic Workflow 在子代理执行体之上生成并运行编排脚本,以及 journal 恢复、失败处理和可重放范围。

ACP 协议层

从 peri-acp 源码说明会话、请求与事件分层,以及统一事件身份、序列化契约和多客户端接入边界。

04

界面

终端界面怎样保持可观察、可验证。

流式 Markdown 渲染

说明增量 Markdown 缓存如何处理块结构翻转、尾部不稳定内容和终端宽度变化,并用全量解析结果验证一致性。

05

Agent 模式

从最小装配开始构建 Agent,并通过工具搜索扩展任务执行能力。

Minimal Agent

以 example/minimal 为起点,说明如何关闭默认 middleware、接入工具来源,并通过 ToolSearch 完成工具发现与任务执行。

06

扩展能力

外部协议和共享能力怎样接入 Agent,同时保持边界清晰。

MCP 支持

从配置合并到工具执行,了解 Peri 如何接入 MCP server、延迟发现工具,并处理连接失败与 OAuth 授权。

MCPP Caching

复用远程 MCP 的工具与资源发现结果,减少重复列表请求;本文说明缓存如何接入连接生命周期,以及何时必须回源。

MCPP Skills

让 MCP server 直接提供远程 Skill,避免维护工作区副本;本文说明 Skill 的发现、校验、注册和连接断开边界。

MCP 2026-07-28

了解新版 MCP 握手和可选订阅如何接入 Peri:新版发现、变化通知、缓存失效与 legacy 兼容路径分别怎样工作。