铸于 Rust · 智无所择 · 迁而无痕

Peri Code轻舟不扰,远山可渡

轻舟一叶,不扰清波,渡君至远山。以 Rust 铸就,十三兆之躯, 兼容尔之所习——不为炫技,唯愿助君成事。

Peri Code 手绘插画:终端、机器人与并行代理网络
往复循环 · 众佐并行 · 上下自续
13 MB
二进制
~50 MB
常驻内存
98%
缓存命中
14
核心之器
6
内置佐者
28
Hook 事件

诸器之能

01

核心引擎

从单 Agent 循环到多代理编排
🌀

RCRA Agent Loop

四阶段执行循环:Receive → Compact → Reason → Act,每轮压缩上下文,500 次循环上限。

🧠

Compact 上下文压缩

冻结系统提示词 + 边界标记机制,把窗口还给新信息,压缩后继续推理不断链。

🎛️

Ultracode 编排引擎

JavaScript ESM 脚本驱动的多代理编排:并行扇出、流水线、阶段、条件分支、验证关口、模型分层、收敛循环。

📊

Workflow 面板

/workflows 实时监控执行:三级树展示、journal 日志、断点续跑,观察和调试工作流。

🔌

ACP 协议

Agent Client Protocol 双传输层实现——AI 编程工具的通用语言,从 LSP 类比到协议分层。

👥

Multi-Agent 架构

子代理系统实现多智能体协作:Agent 定义、派发流程、Fork 模式与后台执行,并行不打架。

02

模型与上下文

任何模型,用对每一分钱
🌐

任何模型

DeepSeek、GLM、Qwen、Anthropic、OpenAI——不绑定任何一家,国产模型也能驱动 20 万行代码库。

🎚️

四档模型档位

fable / opus / sonnet / haiku 四档 Profile 独立配置 provider、模型与费用策略,各司其职。

🔄

会话中热切换

聊天中途随时切换模型,无需重启。贵的给推理,便宜的给搜索。

💾

缓存命中 98%

冻结系统提示词 + 边界标记,14 个提示词段落稳定复用,最大限度减少浪费的 token。

📚

上下文工程

缓存策略、自动压缩与渐进式信息加载——理解 Peri 如何管理窗口,用对模型、控制上下文。

🖼️

图片输入

截图直接粘贴给 Peri(Ctrl+V),让模型看到界面报错、设计稿、图表数据。

03

Agent 能力

工具、技能、子代理、自动化
🛠️

14 个核心工具

Read/Write/Edit、Glob/Grep、Bash、WebFetch/WebSearch、Agent 委派、TodoWrite……每个工具带别名自动解析。

🧩

Skills

可复用的专项能力模块,Peri 自动加载适合当前任务的 skill——探索、审查、重构、修 Bug 都是一句话。

🤖

6 种内置子代理

explorer / coder / verification / web-researcher / plan / general-purpose,各有权限边界与模型策略。

🔗

MCP

通过 Model Context Protocol 接入外部工具和服务——文件系统、数据库、API 全部打通。

⏱️

Hook 系统

Agent Loop → Hook Middleware → Claude Code Hook 三层管道,28 个生命周期事件驱动自动化。

🛡️

权限系统

从完全自动到逐条审批,四种权限模式保护你的代码和系统安全。

04

生态与自动化

兼容既有生态,开箱即用
🤝

Claude Code 生态兼容

Skills、Hooks、MCP、插件原样可用——你现有的配置直接迁移,零改写。

📦

AGM 包管理器

agm install 任何 skill 或 agent。一把锁文件,所有工具互通。

定时任务

自然语言注册重复任务:每天早上 9 点的日报、每周一的依赖更新。到点自动执行。

🎯

/goal 长任务

声明目标后持续自动推进——命令用法、验收标准、长会话节奏全覆盖,中途走开也没关系。

Superpowers 工作流

Peri + Superpowers 插件:结构化规划、工程化执行、自动化验证的完整工作流。

📐

OpenSpec 规格驱动

Spec-driven development——先定规格书再写代码,强制 RFC 2119 标准与验收条件。

十四器

Read / Write / Edit

文件操作:读文件、写文件、精确字符串替换——不依赖行号,因为行号在模型输出时经常不准。

Glob / Grep

文件搜索:按文件名模式匹配,按文件内容正则搜索,覆盖日常代码探索。

Bash

Shell 执行:超时控制、后台运行,跑测试、构建项目、操作 git。

folder_operations

目录操作:列出内容、创建目录、检查路径,支持深度扫描目录树。

WebFetch / WebSearch

网络工具:抓取网页为文本,搜索引擎查信息,支持指定结果数量。

Agent

子代理委派:把独立子任务派发给专用 agent 执行,支持后台运行。

AskUserQuestion / TodoWrite

交互与任务跟踪:结构化提问、维护多步任务清单。

SkillTool / DiscoverSkillsTool

技能系统:按名加载技能,按描述搜索可用技能。

用武之地

代码审查

干净上下文 + 证据要求 + 独立复核——审查纪律打包成 skill,一句话触发。

大规模迁移

Ultracode 并行扇出几十个 agent,探索、规划、实现、验证、汇总全自动。

代码库审计

多代理分片扫描整个仓库,模式识别与风险清单一次到位。

多维分析

同一问题从性能、安全、架构多角度并行分析,交叉验证结论。

近讯

研究

子 agent 全部成功而工作流失败:51 次运行记录中的失败分层

51 次真实运行数据拆解多 agent 工作流的失败分层,以及 1 小时+ 长任务如何设计才能避免空耗。

研究

多 agent 并发时的渲染开销:50% CPU 占用的一次归因分析

以性能诊断报告、修复 issue 与 7.6GB 运行日志三方印证,归因单 agent 正常、3 个并发时 CPU 占用 50% 的叠加成因与修复过程。

研究

国产模型驱动的大规模 AI 编码:经验与教训

用 DeepSeek 和 GLM-5.2 驱动 20 万行 Rust 代码库的实际体验——好用的地方、翻车的地方、怎么适配。

研究

工具输出与上下文预算:79,099 条消息中的 token 消耗分布

79K 条真实消息的 token 消耗分析:巨型搜索、冗余 Read、白搜各占多少上下文窗口,以及如何用提示词约束工具输出。

轻舟已备,待君启航

安装一令而就,无需更张;初启之顷,自有人导君配置模型。

curl -fsSL https://raw.githubusercontent.com/konghayao/peri/main/scripts/install.sh | bash观其全章