Pi
@astralyn/pi 是一个独立分布 上层 Pi用于您项目工作的终端编码代理。 它在当地运行,并支持TypeScript扩展,技能,即时模板,主题和pi包.
安装
Pi需要Node.js >=22.19.
npm install -g --ignore-scripts @astralyn/pi
运行 pi 在项目目录中。 认证、 解析和第一个会话, 请参看 快速启动。 。 。 .
概览
Pi通过公共扩展API提供交互和一发的编码工作流程,持续会话和上下文收缩,本土工具演示并定制. 内建执行默认使用Bash,在Windows上有一个可选的本地PowerShell工具. 已安装的软件包还包括捆绑的工作流程,主题,以及本地模型支持.
Alama.cpp集成、编码、MCP和工具搜索来自上游Pi 捆绑特性概览 用于运出地物目录和该分布图所维护的添加.
使用和自定义
- 使用 Pi 键 覆盖交互式命令、上下文文件、 CLI 使用和
-- 选项的终止分隔符.
- 窗口设置 覆盖了Git Bash和可选的PowerShell工具.
- 任务 覆盖本地 shell 和扩展自有任务执行, Ctrl+B 交接,以及
/tasks 以互动模式进行管理.
- 代理代表团 包括执行独立任务的轻量级授权,
/agent 模式和思维设置,以及任务集成.
- BTW 侧式问题 覆盖不输入已保存会话历史而重新使用主上下文的临时对话.
- 会议 财务报告和审定财务报表 压缩 涵盖节省的工作和背景管理.
- 扩展, (中文(简体) ), 技能, (中文(简体) ), 提示模板, (中文(简体) ), 主题,以及 Pi 软件包 封面定制.
- SDK 软件, (中文(简体) ), JSON 模式,以及 RPC 模式 包括方案使用.
文档
许可证
麻省理工学院
关于 @astralyn/pi 的常见问题
@astralyn/pi 是什么？
编码代理 CLI , 包含读取、 击打、 编辑、 写入工具和会话管理
如何安装 @astralyn/pi？
在项目目录运行 npm install @astralyn/pi，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 pi，可以用 npx pi 直接运行。
@astralyn/pi 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
@astralyn/pi 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。
@astralyn/pi 需要什么版本的 Node.js？
package.json 的 engines 字段要求 Node.js >=22.19.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
@astralyn/pi 可以商用吗？
@astralyn/pi 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
@astralyn/pi 的下载量有多少？
根据 npm 官方下载统计，@astralyn/pi 在 2026/10/07 – 2026/11/05 这 30 天内被下载 3,924 次，日均约 131 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@astralyn/pi 还在维护吗？
最新版本 1.5.2 发布于 2026/11/03（4 天前）；至今共发布 67 个版本，其中过去 12 个月发布了 67 个；首次发布于 2026/07/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。