源码系统概览
文章正文
pi 是一套极简、可扩展的 AI Agent 工具包源码，提供交互式 TUI、自动化打印、JSON 输出与 RPC 远程控制等多种使用模式。项目以扩展、技能、提示模板与主题包为核心组织方式，用户可以按自己的工作流定制 Agent，并打包为包分享。v1.0.0 首个正式版将 TUI 默认切换为全屏模式，codemode 减少约 40% 的 prompt tokens，兼顾轻量与强大。
源码简介
pi 源码是一个多包 TypeScript monorepo，包含核心框架、TUI 界面、AI 适配层、编码代理与测试夹具。扩展、技能、提示模板与主题均以独立包组织，可通过 npm 或 git 分享。项目文档覆盖交互使用、CLI 自动化、RPC 控制与扩展开发四类场景，上手路径完整。
核心框架保持轻量，交互、编码代理与 AI 适配以独立包分层，可按需组合安装。
仓库同时提供 npm 发布包与本地源码两种使用方式，文档覆盖交互、自动化与扩展开发。
适用场景
这套源码工程主要适用于以下场景。
- 日常自动化: 交互式 TUI 完成编码与运维任务
- 流水线集成: JSON 与打印模式接入 CI 脚本
- 远程控制: RPC 模式嵌入自有工具链
- 框架定制: 基于扩展与技能构建专属 Agent
技术栈与运行环境
压缩包大小: 8.5M
解压后大小: 22.1M
前端语言: TypeScript（TUI 与界面层）
后端语言: TypeScript（Node.js 运行环境）
接口语言: TypeScript（RPC 与 CLI 接口层）
工程基于 Node.js 运行环境，支持交互终端、CI 流水线与远程调用场景，跨平台可用。
功能亮点
pi AI智能体助手工具系统平台源码 当前版本为 v1.0.0，作者 earendil-works 团队 持续维护，最后更新于 2026 年，更新日志记录在仓库内。
- 多模式控制: 交互 TUI、打印、JSON 与 RPC 四类模式
- 扩展体系: extensions、skills、提示模板与主题包
- 全屏 TUI: v1.0 默认全屏提升沉浸使用体验
- 低 Token 开销: codemode 减少约 40% prompt tokens
- 包共享: 打包为 Pi 包通过 npm 或 git 分发
技术架构与部署指南
功能对比:
| 对比项 | 本项目 | Claude Code |
|---|---|---|
| 定位 | 可定制的极简 Agent 框架 | 闭源 Agent 客户端 |
| 扩展机制 | extensions/skills/主题包 | 内置功能为主 |
| 控制方式 | 交互/TUI/JSON/RPC 多模式 | CLI 交互为主 |
对比 pi 与 Claude Code 的区别，前者是完全开源可定制的最小 Agent 框架，后者为闭源商业客户端，前者的扩展自由度和控制模式更为多样。
它们在形态和设计上各有取舍，与 Claude Code 相比，核心区别集中在表格所列维度，选型时可按实际场景判断。
安装与部署提示
解压后安装依赖，通过 CLI 命令即可启动交互式 TUI，也可以在自动化脚本中使用打印或 JSON 模式。需要远程控制时启用 RPC 模式，扩展与技能按文档放入对应目录即可生效。
截图与演示说明
项目 README 提供界面演示图与使用流程说明，封面图为本站在原版基础上制作的项目宣传图。
启动 TUI 后即可看到全屏交互界面，输入任务即可观察 Agent 的思考与执行过程。
实际使用效果以官方演示素材为准，界面风格与交互细节可在本地构建后直接体验。
常见问题
问. pi 是什么类型的项目
pi 是一个极简、可扩展的 AI Agent 框架，可按自己的方式定制工作流并打包成扩展共享。
问. 与 Claude Code 有何区别
pi 完全开源并支持 extensions、skills、提示模板与主题自定义，还提供 JSON 与 RPC 控制模式。
问. 支持哪些使用模式
支持交互式 TUI、自动化打印模式、JSON 输出模式与 RPC 远程控制模式。
问. 如何安装部署这套源码
按下载说明解压后安装依赖，通过 CLI 启动即可，也可通过 npm 安装官方发布包。
问. 是否免费开源
是，项目以 MIT 协议开源，源码与文档免费提供。
问. 适合哪些用户
适合开发者、AI 工具链团队与希望深度定制 Agent 工作流的技术团队。
安全风险提示
安全审查未发现后门、加密混淆或硬编码凭据。项目为开源 AI Agent 工具包，代码中的 shell 执行集中于沙箱运行环境封装，凭据命中均为测试占位符。
下载说明
源码以 zip 压缩包形式提供，内含核心框架、界面、AI 适配层与完整文档。解压后按 README 安装依赖即可通过 CLI 或 TUI 使用，也可通过 npm 安装发布包。
GitHub项目开源地址 https://github.com/earendil-works/pi
