earendil-works/pi:一款可完全自定义的轻量智能体运行框架 | 2026/11/22

行业背景

当前智能体开发工具普遍存在功能冗余问题,默认内置大量未经过场景验证的子代理、自动规划等模块,开发者无法按需裁剪,只能被动适配工具预设的工作流,大量无关代码占用运行资源,也大幅提升了二次定制的门槛。

多数面向开发者的智能体框架强制要求使用者遵循固定的开发范式,自定义扩展需要修改核心源码,不同开发者产出的定制能力无法快速复用,生态内容的分发和共享成本居高不下。

现有工具的运行模式大多局限于交互式终端场景,无法直接对接自动化流水线、远程调用接口或第三方应用,跨场景适配需要额外封装大量适配层代码,拖慢了智能体相关应用的落地效率。

项目概述

该项目由 earendil-works 团队主导开发,核心定位为极简、可扩展的智能体运行承载框架,所有默认配置仅保留最基础的核心能力,不强制绑定任何额外的高阶功能。

项目所有能力均围绕自定义适配展开,开发者可以根据自身实际工作流调整框架的全部组成部分,不需要反过来适配工具的预设逻辑,所有扩展能力都可以打包为标准格式的分发包,通过通用的代码分发渠道共享给其他使用者。

技术架构深度分析

该项目采用分层模块化的架构设计,整体分为核心运行层、扩展适配层、输出对接层三个独立层级,层与层之间通过标准化接口通信,不存在跨层级的直接依赖。

核心运行层设计

核心运行层仅保留智能体最基础的生命周期管理能力,包括大模型调用调度、会话上下文维护、基础输入输出路由三个核心模块,总代码量控制在极小规模,没有内置任何额外的功能实现。这种设计的优势在于核心层运行稳定性极高,几乎不会出现逻辑冲突问题,同时资源占用远高于同类型的全功能框架,在低配置的运行环境下也可以流畅启动。

扩展适配层设计

扩展适配层完全独立于核心运行层,所有自定义能力都通过该层的标准接口接入,框架本身不对扩展的实现逻辑做任何限制。扩展接口按照能力类型划分为扩展组件、技能集、提示词模板、主题样式四个独立的分类,不同分类的扩展之间也可以通过标准接口互相调用,开发者不需要修改核心层代码就可以叠加任意数量的自定义能力。

输出对接层设计

输出对接层同时封装了多种不同的输出协议,所有协议的实现都独立互不干扰,使用者可以在启动时指定需要启用的输出模式,不需要为未使用的协议占用运行资源。这种设计让同一个框架实例可以同时适配本地交互、自动化脚本、远程服务调用、第三方应用集成等完全不同的使用场景,不需要针对不同场景单独编译不同版本的程序。

整个架构没有采用其他同类项目常用的插件沙箱限制机制,所有扩展都运行在和核心层相同的权限域下,大幅降低了扩展开发的门槛,同时扩展包可以直接打包所有依赖,不需要使用者手动处理版本冲突问题,最终产出的扩展包可以直接通过通用代码分发渠道分享安装。

核心功能详解

全维度自定义能力

框架支持从底层运行逻辑到上层展示样式的全链路自定义,覆盖扩展组件、技能集、提示词模板、主题样式四个不同的能力维度。开发者可以根据自身的工作习惯调整任意环节的默认行为,不需要迁就工具预设的操作逻辑。所有自定义内容都可以独立迭代,互不干扰,不会因为框架版本升级出现自定义逻辑失效的问题。

极简默认核心

框架出厂默认配置中不包含子代理、自动规划等非必需的高阶功能,仅保留最基础的智能体运行能力。所有高阶能力都由使用者根据自身需求手动添加,不会出现多余功能占用运行资源的情况。如果使用者需要对应能力,既可以自行开发实现,也可以直接安装社区共享的对应扩展包,不需要从零搭建整套逻辑。

多运行模式支持

框架内置四种完全独立的运行模式,分别对应不同的使用场景。交互式模式面向本地手动操作场景,提供完整的终端交互体验,方便开发者直接和智能体对话完成各类任务。打印模式和JSON模式面向自动化流水线场景,可以直接输出标准化格式的运行结果,方便接入各类自动化脚本完成后续处理。RPC远程调用模式面向服务化部署场景,支持其他设备通过远程过程调用协议控制框架运行,适配分布式部署需求。

TypeScript 官方 SDK

框架提供原生的 TypeScript 软件开发工具包,所有接口都有完整的类型定义,不需要额外编写类型声明文件。开发者可以基于该SDK直接在自己的TypeScript项目中嵌入智能体运行能力,不需要单独启动独立进程做跨进程通信。SDK封装了所有底层的通信和调度逻辑,开发者只需要调用对应接口就可以完成会话创建、任务提交、结果获取等全流程操作。

标准扩展包分发机制

所有自定义开发的扩展能力都可以打包为标准格式的Pi包,包结构遵循通用的前端包管理规范。打包后的扩展包可以直接通过通用代码分发渠道发布共享,其他使用者只需要执行一条安装命令就可以完成扩展的导入和启用,不需要手动复制配置文件或者修改代码。扩展包支持完整的版本管理机制,可以跟踪不同版本的变更内容,按需升级或者回滚。

依赖固定安装机制

官方提供的一键安装脚本会自动锁定所有直接和间接依赖的版本,不会出现依赖自动升级导致的兼容性问题。框架内置的更新命令只会在用户主动触发时才执行版本升级,所有版本变更都可以追溯,避免自动更新带来的运行环境异常。Windows平台也提供了对应的原生安装脚本,不需要额外配置运行环境就可以完成部署。

Pi是一款极简且高度可扩展的智能体运行承载框架,核心层仅保留最基础的智能体运行能力,不强制绑定多余的高阶功能。支持通过扩展组件、技能集、提示词模板等维度自定义适配不同工作流,所有自定义内容都可打包为标准扩展包共享,同时提供交互式、自动化输出、RPC远程调用、TypeScript SDK等多种运行模式,适配各类智能体开发和集成场景。

项目地址:https://github.com/badlogic/pi-mono
⭐ Stars:123192
🔍 来源:GitHub

AI agent toolkit: unified LLM API, agent loop, TUI, coding agent CLI

手机扫描二维码访问

微信扫一扫支付
微信logo微信扫一扫,打赏作者吧~
不喜欢1

本文链接:https://5x10.cn/post/1029.html

猜你喜欢

网友评论