# 从 Pi 切入,看 Coding Agent 的演进图谱 (pi.kuhung.me) > 面向中文开发者的 Pi 编码代理生态资料站,由 kuhung (https://kuhung.me) 整理维护。按 10 个 Agent 发展方向组织,讲清每类扩展试图解决的问题、Pi 事件钩子与工具注册机制,以及首批 30 个代表包的选型取舍。 ## 口径与边界 - 所有包名均核实自 npm / GitHub / pi.dev/packages(核对日期 2026-11-22)。 - 方向页与包详情页正文仅保留长期稳定的架构与选型事实,不展示静态下载量快照。 - 首页生态监测台当前为结构占位,后续接入下载量将以「npm 官方下载量(非 Pi 内安装量)」为统计口径。 ## 底座入门页 - [3 分钟看懂 Pi:和 Claude Code / Codex 有什么不同](https://pi.kuhung.me/start/) ## 10 个方向栏目 - [01 接外部世界](https://pi.kuhung.me/directions/external-world/): Agent 从对话走向行动:MCP 协议化与浏览器/网络接入 - [02 子代理与编排](https://pi.kuhung.me/directions/subagents-orchestration/): 从单 Agent 到 Agent 团队:委派、并行与工作流编排 - [03 安全与权限](https://pi.kuhung.me/directions/security-permissions/): Agent 安全从口号变标配:拦截、权限策略、沙箱与供应链审查 - [04 记忆与上下文经济](https://pi.kuhung.me/directions/memory-context-economy/): 从短会话到长期记忆:压缩、输出隔离、缓存与跨会话记忆 - [05 计划、评审与人机交互](https://pi.kuhung.me/directions/planning-review-hitl/): 先问、先给计划、可批注评审后再动手写代码 - [06 代码智能](https://pi.kuhung.me/directions/code-intelligence/): IDE 能力接进终端:LSP 诊断、AST 结构分析、极速检索与调试 - [07 可观测与用量](https://pi.kuhung.me/directions/observability-usage/): Agent 从黑盒变可追踪、可计量;主流观测厂商直接下场 - [08 工作流与目标驱动](https://pi.kuhung.me/directions/workflows-goal-driven/): 从开放聊天到确定性交付:规格驱动、目标循环与独立验收 - [09 终端 UI 与体验](https://pi.kuhung.me/directions/terminal-ui-ux/): 交互面从纯文本流变成富渲染、折叠面板、原生微窗与 Web 驾驶舱 - [10 二开形态](https://pi.kuhung.me/directions/ecosystem-forks-infrastructure/): Pi 正在变成基础设施:发行版 Fork、SDK 嵌入、聊天网关与编辑器协议接入 ## 首批 30 个代表包详评 - [@onkernel/browser-loop](https://pi.kuhung.me/packages/onkernel-browser-loop/) (01 接外部世界): Kernel 官方浏览器工具框架与 Pi 扩展,按模型能力编译 GUI 动作并在云端浏览器执行。 - [pi-mcp-adapter](https://pi.kuhung.me/packages/pi-mcp-adapter/) (01 接外部世界): 用按需激活和结果裁剪接入外部 MCP 服务,避免工具定义撑爆上下文。 - [pi-web-access](https://pi.kuhung.me/packages/pi-web-access/) (01 接外部世界): 零配置起步的 Pi 联网套件:多引擎搜索回退、页面结构化抽取、PDF 与视频理解。 - [pi-subagents](https://pi.kuhung.me/packages/pi-subagents/) (02 子代理与编排): Pi 生态下载量最高的子代理扩展,支持单代理委派、角色预设、前后台运行与链式工作流。 - [@quintinshaw/pi-dynamic-workflows](https://pi.kuhung.me/packages/quintinshaw-pi-dynamic-workflows/) (02 子代理与编排): 让 Pi 把复杂请求写成可断点恢复的 JS 编排脚本,扇出至数十上百个隔离模型实例并行执行。 - [@tintinweb/pi-subagents](https://pi.kuhung.me/packages/tintinweb-pi-subagents/) (02 子代理与编排): 带实时 Fleet 面板、终端 Widget、运行中 Steering 与 Claude Code 兼容风格的子代理编排器。 - [cc-safety-net](https://pi.kuhung.me/packages/cc-safety-net/) (03 安全与权限): 在命令执行前做语义解析的安全护栏,阻断破坏性 Shell 指令和敏感密钥文件读取。 - [@gotgenes/pi-permission-system](https://pi.kuhung.me/packages/gotgenes-pi-permission-system/) (03 安全与权限): 为 Pi 提供集中式、确定性的权限门禁系统,统一接管工具、bash、MCP、技能与特殊操作鉴权。 - [pi-vetter](https://pi.kuhung.me/packages/pi-vetter/) (03 安全与权限): Pi 扩展包的安装与更新前供应链安全审查门禁,输出带证据链的 ALLOW / ASK / DENY 判定。 - [billion-context](https://pi.kuhung.me/packages/billion-context/) (04 记忆与上下文经济): 跨多编码 Agent 的上下文压缩插件与本地代理,支撑超长单会话并压低多轮 token 消耗。 - [context-mode](https://pi.kuhung.me/packages/context-mode/) (04 记忆与上下文经济): 完全本地运行的上下文省流插件:沙箱执行工具、SQLite FTS5 建索引,只把命中摘要送进上下文。 - [@mem0/pi-agent-plugin](https://pi.kuhung.me/packages/mem0-pi-agent-plugin/) (04 记忆与上下文经济): Mem0 官方发布的 Pi 扩展,提供跨会话、分作用域的自动化语义记忆捕获与检索。 - [@narumitw/pi-plan-mode](https://pi.kuhung.me/packages/narumitw-pi-plan-mode/) (05 计划、评审与人机交互): 在终端内复刻 Codex 风格只读 /plan 协作模式:安全探索、分屏预览计划、批准后可切新会话执行。 - [@plannotator/pi-extension](https://pi.kuhung.me/packages/plannotator-pi-extension/) (05 计划、评审与人机交互): 把计划审查、消息批注与代码 PR Diff 评审从终端搬进浏览器可视化界面的交互扩展。 - [@juicesharp/rpiv-ask-user-question](https://pi.kuhung.me/packages/juicesharp-rpiv-ask-user-question/) (05 计划、评审与人机交互): 向模型注册 ask_user_question 工具,把模棱两可的猜测变成终端底部 15 秒可选的结构化问卷。 - [@ff-labs/pi-fff](https://pi.kuhung.me/packages/ff-labs-pi-fff/) (06 代码智能): 用 Rust 原生 SIMD 引擎 FFF 替换 Pi 内置 find / grep 与 @ 自动补全,支持常驻预索引和访问频率排序。 - [pi-agent-ide](https://pi.kuhung.me/packages/pi-agent-ide/) (06 代码智能): 把受保护事务编辑、LSP、AST 搜索、终端进程管理、DAP 调试与可观测能力打包为一体的 Agent IDE 扩展。 - [pi-lens](https://pi.kuhung.me/packages/pi-lens/) (06 代码智能): 在每次写入与回合结束时自动运行 LSP、Linter、类型检查与结构分析,并把阻塞错误直接回注模型。 - [@datadog/pi-plugin](https://pi.kuhung.me/packages/datadog-pi-plugin/) (07 可观测与用量): Datadog 官方 Pi 插件,通过预配置 Datadog MCP Server 让 Agent 在终端里直接查线上日志、指标与 Trace。 - [@langchain/langsmith-pi-extension](https://pi.kuhung.me/packages/langchain-langsmith-pi-extension/) (07 可观测与用量): LangChain 官方出品的 Pi 链路追踪扩展,把会话轮次、模型请求、工具调用与 token 用量自动上报至 LangSmith。 - [@narumitw/pi-usage](https://pi.kuhung.me/packages/narumitw-pi-usage/) (07 可观测与用量): 在 Pi 内部查看各模型服务商订阅配额、重置倒计时、API 余额与 Codex Fast 模式开关的用量面板。 - [@dietrichgebert/ponytail](https://pi.kuhung.me/packages/dietrichgebert-ponytail/) (08 工作流与目标驱动): 约束编码 Agent 少写冗余代码的资深工作流扩展:压缩代码体积、控制 token 消耗并守住高风险逻辑测试率。 - [@opengsd/gsd-core](https://pi.kuhung.me/packages/opengsd-gsd-core/) (08 工作流与目标驱动): 规格驱动(Spec-driven)与上下文工程框架,用五步阶段循环和干净上下文并行执行器对抗长对话退化。 - [pi-goal-x](https://pi.kuhung.me/packages/pi-goal-x/) (08 工作流与目标驱动): 为 Pi 带来 /goal 与 /sisyphus 目标循环:持久化拆解子任务、跨会话断点续跑,并可选独立完成审计员验收。 - [glimpseui](https://pi.kuhung.me/packages/glimpseui/) (09 终端 UI 与体验): 用系统原生 WebView 替代 Electron 或完整浏览器,为脚本和 Agent 提供可双向 JSON 通信的轻量微 UI 窗口。 - [@heyhuynhgiabuu/pi-pretty](https://pi.kuhung.me/packages/heyhuynhgiabuu-pi-pretty/) (09 终端 UI 与体验): 留守终端内部的全面视觉增强扩展:Shiki 语法高亮、树形 ls、内联图片预览、折叠工具输出与内嵌 FFF 检索。 - [pi-webman](https://pi.kuhung.me/packages/pi-webman/) (09 终端 UI 与体验): 零运行时依赖的 Pi 本地 Web 驾驶舱,为终端里正在运行的会话提供实时 SSE 对话流、遥测仪表盘与命令遥控。 - [@agimon-ai/po-core](https://pi.kuhung.me/packages/agimon-ai-po-core/) (10 二开形态): AgiFlow Po 多包体系的共享运行时与服务契约层,支撑从终端工具到 Po Web 驾驶舱的模块化扩展套件。 - [@oh-my-pi/pi-coding-agent](https://pi.kuhung.me/packages/oh-my-pi/) (10 二开形态): Stencil Labs(can1357)基于 Pi 分叉的高配发行版(omp):内置 ~8 万行 Rust 核心、31 个工具、14 个 LSP 操作与 28 个 DAP 调试操作。 - [openclaw](https://pi.kuhung.me/packages/openclaw/) (10 二开形态): 本地常驻的多通道 AI 网关,把 Discord、Slack、Telegram、WhatsApp 等 20+ 聊天平台接到 Pi 等可插拔 Agent 底座上。 ## 已上线延伸文章 - [Pi 入门笔记:比 Codex 更自由,但也更折腾](https://kuhung.me/posts/getting-started-with-pi-cli-practical-multi-model-coding-workflows/) (kuhung 博客实操) - [Pi Agent 1.0 与 1.1 深度解析:MCP 接入、Codemode 沙箱与选型指南](https://vibe-coding-101.kuhung.me/tips/pi-agent-guide/) (Vibe Coding 入门专题) - [Pi 1.0 与 1.1:一个靠说「不」出名的工具,开始说「是」了](https://kuhung.me/posts/pi-1-0-and-1-1-key-updates-notes/) (kuhung 博客演进观察)