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

Peri Code轻舟不扰,远山可渡

轻舟一叶,不扰清波,渡君至远山。以 Rust 铸就,运行于终端, 接入既有工具与配置——不为炫技,唯愿助君成事。

Peri Code 手绘插画:终端、机器人与并行代理网络
往复循环 · 众佐并行 · 上下自续
Rust
核心实现
TUI
终端交互
ACP
客户端边界
MCP
外部工具
Skills
任务能力
Hooks
生命周期扩展

诸器之能

01

核心引擎

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

RCRA Agent Loop

Receive → Compact → Reason → Act 四阶段负责收消息、管理上下文、推理并执行工具。

🧠

Compact 上下文压缩

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

🎛️

Ultracode 编排引擎

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

📊

Workflow 面板

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

🔌

ACP 协议

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

👥

Multi-Agent 架构

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

02

模型与上下文

配置 Provider,管理有限的上下文预算
🌐

多 Provider

支持 Anthropic 与 OpenAI-compatible 接口;实际可用模型和能力由你配置的服务决定。

🎚️

四档模型档位

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

🔄

会话中热切换

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

💾

稳定缓存前缀

会话创建时冻结项目指引、Skills 摘要和系统提示词,减少无意义的前缀漂移。

📚

上下文工程

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

🖼️

图片输入

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

03

Agent 能力

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

任务工具

文件、搜索、终端、网络、子代理和任务跟踪按会话配置装配;扩展工具按需发现。

🧩

Skills

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

🤖

专用子代理

探索、规划、实现、验证和研究任务可以进入独立上下文,并带各自的权限与模型策略。

🔗

MCP

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

⏱️

Hook 系统

在会话和工具生命周期执行脚本、评估或外部调用;具体事件以当前 Hook 文档为准。

🛡️

权限系统

四种审批模式控制工具执行前是否询问;真正的隔离仍由操作系统、容器和凭据策略提供。

04

生态与自动化

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

Claude Code 生态接入

可读取 Claude Code 风格的 Skills、Hooks、MCP 与插件配置;兼容范围和限制按各功能页说明。

📦

AGM 包管理器

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

定时任务

在 TUI 进程运行期间按 UTC 调度重复任务;当前任务保存在内存中,重启后不会恢复。

🎯

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 将探索、规划、实现、验证和汇总组织为显式工作流,并可并行处理独立切片。

代码库审计

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

多维分析

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

近讯

工程

Minimal Agent

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

工程

Meta Harness 的能力闭包

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

工程

MCPP Skills

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

工程

MCPP Caching

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

轻舟已备,待君启航

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

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