@agimon-ai/po-core(Po 套件核心)

AgiFlow Po 多包体系的共享运行时与服务契约层,支撑从终端工具到 Po Web 驾驶舱的模块化扩展套件。

安装命令
pi install npm:@agimon-ai/po-core
挂接事件钩子与注册入口
主/子 Agent 生命周期与内核贡献选择(kernel contribution selection)保留 Pi 兼容宿主以加载第三方 Pi 扩展包与模型 Provider
注入式 po/* 运行时服务契约(platform / environment / home / storage / scope)子路径导出如 @agimon-ai/po-core/workspaceRegistry 与 web 浏览器契约

1. 是什么

@agimon-ai/po-core 是 AgiFlow 开源项目 Po(AgiFlow/po)的核心契约与运行时系统包 BUSL-1.1 协议)。

它是整个 @agimon-ai/po-* 套件(包括 po-ui、po-web-dashboard、po-logsink、po-sandbox、po-workflow、po-mcp、po-hashline 等 20 多个包)共用的服务底座。

2. 解决什么问题

当一个团队围绕 Pi 生态同时开发二十多个功能插件(Web 驾驶舱、安全、工作流、沙箱、日志汇、Leader 键 UI 等)时,如果每个扩展各自直接读写环境与配置文件,模块间就会耦合混乱、互相覆盖或重复初始化。

po-core 通过清晰的服务契约与依赖注入边界,把宿主能力、存储、环境配置和浏览器/服务传输契约统一起来,同时保留对第三方标准 Pi 扩展的兼容宿主。

3. 作用原理(事件钩子与工具注册层)

通过依赖注入的 po/* 服务契约与主/子系统生命周期管理协调套件内各模块,并在内核中管理贡献点选择与 Pi 扩展兼容加载。

  • Po 的发行宿主向运行时显式注入平台、环境变量、主目录、存储与作用域能力;各功能包声明依赖 po/* 服务而非直接读取全局环境变量或假设本地文件系统结构。
  • 服务提供者与契约分离:引入契约文件不会误激活实现,只有由内核选中的提供者才会负责初始化与资源清理。
  • 在终端侧由 @agimon-ai/po-ui 负责 Leader 键菜单和 TUI 组件,在网页侧由 @agimon-ai/po-web-dashboard / po-web-components / po-web-security 依托 web 契约构建 Po Web 驾驶舱,同时兼容层继续允许加载社区标准 Pi 扩展。

4. 怎么装与基本配置

  • po-core 主要作为 Po 体系或基于 Po 构建的扩展依赖使用;完整使用 Po 驾驶舱体验通常会配合 @agimon-ai/po、po-ui、po-web-dashboard 等套件包一起安装。
  • 需要注意:Po 套件采用 BUSL-1.1 源码可用许可(与 MIT 协议不同),商业二次分发或托管部署前请核对许可证限制。

5. 和同类怎么选

po-core 展示了一种不同于 Fork 改源码的路径:在 Pi 之上用“微内核契约 + 多包套件”重新组织一套企业级工程平台与 Web 驾驶舱。

与同类方案的选型对照

聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。

对比对象 机制差异 怎么选
@oh-my-pi/pi-coding-agent OMP 是把所有功能打进一个高性能单体 Fork(MIT 协议);Po 是拆成二十多个按契约协作的模块化 npm 包(BUSL-1.1 协议)并配完整 Web 驾驶舱。 个人/团队要 MIT 开源开箱即用选 OMP;想研究或基于服务契约体系组装模块化扩展与 Web 控制面可参考 Po 套件。
pi-webman(方向 09) pi-webman 是单包、零依赖、只服务于当前终端会话的独立 Web 驾驶舱;Po 的 Web 驾驶舱则建构在 po-core + po-web-* 整套体系之上。 只需要给原版 Pi 挂一个轻量网页看板选 pi-webman。

同方向对比包与顺序阅读

@oh-my-pi/pi-coding-agent

Stencil Labs(can1357)基于 Pi 分叉的高配发行版(omp):内置 ~8 万行 Rust 核心、31 个工具、14 个 LSP 操作与 28 个 DAP 调试操作。

阅读该包机制详评

openclaw

本地常驻的多通道 AI 网关,把 Discord、Slack、Telegram、WhatsApp 等 20+ 聊天平台接到 Pi 等可插拔 Agent 底座上。

阅读该包机制详评

10 二开形态

回到该演进方向总论,查看完整痛点拆解、通用安装注意事项与全部收录清单。

返回方向总论页

看完「@agimon-ai/po-core(Po 套件核心)」后的下一步

可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)

从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频

已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)

出口 1(配置单与实机演示制作中)

Coding Agent 实战交付课:如何可控地把想法做成线上产品

由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。

出口 2(实战交付课筹备中)