Architecture
一张图看懂它在跑什么
三层结构:上为 pi 核心引擎,中为 agent 基础设施,下为业务 / 开发 / 延展。连接线随滚动绘制,节点逐个入场,每层的数字都来自实际盘点。
核心引擎Core Engine
pi engine v0.83
极简编码内核 · 4 类扩展物塑形 · MIT
内置工具 ×7
read · write · edit · bash · grep · find · ls
会话树与分支
/fork · /clone · /tree
上下文自动压缩
compaction · 结构化摘要
30+ 模型路由
思考 7 档 off → max
Agent 基础设施Infrastructure
Extensions + MCP~15 · ×2TypeScript 模块 + settings/mcp.json,支撑 pi
运行的基础设施
pi-dcp
pi-goal
pi-subagents
pi-extension-manager
pi-lens
pi-kimi-cron
session-cleaner
pi-powerline-footer
pi-sidebar-panel
pi-think-panel
pi-model-favorites
pi-ext-fan
pi-bailian-token-plan
pi-ext-tts-mimo
rpiv-profiles
lean-ctx
上下文压缩运行时
codebase-memory
代码知识图谱
Agent 团队 + 基础设施 Skills×20 · ~6~/.pi/agent/agents · ~/.pi/agent/skills
workhorse 牛马狗
干活主力
oldfox 老法师
把关与 review
Explore
探索
general-purpose
通用
rpiv 工作流角色 ×16
discover → research → design → plan → implement →
validate
基础设施技能~6
customize-pi
customize-lean-ctx
find-skills
full-output-enforcement
random-theme-osc
local-file-search
业务 / 开发 / 延展Business & Extension
Skills~77业务 · 开发 · 延展类技能
办公自动化办公自动化 ×22
im
doc
base
sheets
calendar
mail
minutes
approval
whiteboard
vc
wiki
task
+10 更多
车云业务工程xxx
xxx
cicd-fullchain
cicd-quick
k8s-troubleshoot
xxx-vault-qa
xxx-lbs-test-report
redis-vin-scanner
gitops-commit-check
friction-report
xxx-ds-query
xxx-kube-login
+3 更多
前端设计~13
anti-ui-slop
design-taste-frontend
design-taste-frontend-v1
high-end-visual-design
gpt-taste
brandkit
imagegen-frontend-web
imagegen-frontend-mobile
minimalist-ui
industrial-brutalist-ui
stitch-design-taste
image-to-code
redesign-existing-projects
开发工具链工具
github-usage
agent-browser
cmux
cmux-browser
markitdown
tavily-search
litellm
bailian-cli
repo-token
+2 更多
外部接入External
外部业务xxx 命名空间
CI/CD
K8s
制品库
密钥管理
Kafka
Redis
PostgreSQL
办公自动化
MCP 接入×2
chrome-devtools
anysearch
终端cmux 拓扑 · ghostty 同步
cmux
ghostty
Base vs Overlay
极简内核,被我叠加成什么样
左边是 pi 出厂的样子,右边是我叠加之后的日常。两边都是同一份 pi,差别全在扩展物。
pi 原生 BASE
- 内置工具7 个
- 扩展物4 类 · TypeScript 直载
- 会话JSONL 树形 + /fork
- 上下文自动压缩 compaction
- 模型订阅 6 家 · API key 30+ 家
- 刻意不做MCP / sub-agents / 权限弹窗
我的叠加 OVERLAY
- Skills85 个 · 24 通用 + 61 业务
- Agents20 个 · 含 16 个 rpiv 角色
- MCP4 个 · 上下文 / 图谱 / 浏览器 / 搜索
- Extensions~15 个
- 外部栈CI/CD · K8s · 密钥管理 · Kafka · 办公自动化
- 身份编排者 · APPEND_SYSTEM 五条
Capabilities
能力归类,五块拼图
从审美到工程,从办公自动化到车云,都是同一个技能库的切片。
设计与审美
×21把「不模板」写进规范:色板、排版、动效、图像方向,五个前端 skill 的综合。
办公自动化
×22办公自动化全家桶:从 IM 到审批,一条链路贯穿。
车云业务工程
xxx从代码提交到 K8s 部署的全链路,含 Kafka、密钥管理、VIN 扫描与报表。
工程效能
工具链上下文、代码理解、浏览器与终端自动化,把重复劳动交给工具。
智能体团队
×20一个编排者,加 19 个角色,跑在 rpiv 流水线上:先研究,再设计,后实现,最后验证。
The Team
一个干活的,一个把关的
编排者身份规定:研究必须派 sub-agent,不自己顺序执行,没有 review 不标完成。
牛马狗 workhorse
干活主力
职责写代码、调查、测试、部署,先读后写,最小改动,验证闭环
限权workhorse-gate:只动 $HOME
内文件,禁危险命令,禁改配置目录
定位高速执行
原则证据优先,错误自愈,修复不了就报告明确信息
老法师 oldfox
把关
职责审阅改动、架构判断、复杂决策兜底
定位深度推理 · 思考 max
方式把全部上下文交给它,给最强判断,再决定改还是不改
编排者身份
APPEND_SYSTEM- 研究必须派 sub-agent,不让主线程自己做长调研
- 禁止自己顺序执行,能并行就并行,能派就派
- 没有 review 不标完成,交付前必须过一遍把关
- 不许假设问题已知,问题要先调查取证
- 证据说话,结论要有出处
分析
派遣
验证
汇总
Snapshot
配置快照,一页看全
主题、铁律、技能库与监控,都是当前真实生效的配置。
默认配置
开箱即用 · 7 档思考深度
主题
high-contrast-dark · 51 色 token · 热重载 · ghostty
同步
Cron 监控
11 个任务目录 · b123xxxx 每 10 分钟检查
xxx 部署状态
Skill 库
~/.pi/agent/skills · 24 个通用
~/.agents/skills · 61 个业务
项目内 .pi/skills · 按需
~/.agents/skills · 61 个业务
项目内 .pi/skills · 按需
AGENTS.md 六条铁律
每次会话自动注入- 先想后写,想清楚再动手
- 简单优先,不引入不必要的复杂度
- 外科手术式改动,只改需要改的
- 目标驱动执行,每一步都有目的
- 用 grep 不用 bash,搜索走专用工具
- 搜索走 anysearch,联网查询统一入口
另有一份 APPEND_SYSTEM.md,规定编排者身份的行为边界。