pi package ecosystem · npm registry survey · 2026-09-18

核心说不做的,
生态都做了
what the core refused

pi 的 README 明确写下六条「不做」:不做 MCP、不做子代理、不做权限弹窗、不做计划模式、 不做内置待办、不做后台 bash。而在 npm 上的 pi 生态里, 下载量第一的包是一个 MCP 适配器,第二是一个子代理框架—— 被拒绝得最彻底的那两件事,恰是需求最硬的两件事。
10,101npm 包 · 带 pi-package 关键字
9.49M/月样本月下载合计
78官方示例 · 14,474 行
36可挂钩事件 · 9 类注册点
取样说明:npm registry 报告 keywords:pi-package 共 10,101 个包; 但 search API 的分页在第 21 页(offset 5,250)之后开始回绕,因此下文所有分布统计 均基于去重后的 5,250 个包(按相关度排序的前段,即偏头部样本)。 凡是「长尾」类结论,在这个偏头部样本上都只会被低估,不会被高估。 下载量为最近 30 天数据,采集时间 2026-09-18。

01 命题

生态的形状,由接口的形状决定

pi 对外只开两个面:事件面(36 个可挂钩的生命周期事件,能改行为)与 资源面(四类可打包资源,能加知识)。生态长成什么样,取决于哪个面更好用—— 数据给出的答案非常干脆。

pi-extension(改行为的扩展)2,585 · 49.2%
pi-skill(装技能)107 · 2.0%
pi-theme(换主题)45 · 0.9%
pi-prompt(提示模板)4 · 0.1%

四类资源里,扩展吃掉了近乎全部份额:每一百个包里有 49 个声明自己是扩展,只有 4 个是提示模板。 原因不难猜——扩展能拦截、能注册、能替换 UI,而提示模板只能往上下文里塞一段文字。 生态永远涌向表达力最强的那一面。

02 四个物种

生态里只长出了四种东西

把 5,250 个包按「它想解决什么」粗分类,噪声立刻收敛。以下为多标签统计(一个包可命中多类), 分类依据是包名、关键字与描述的词汇命中,仅用于看结构,不用于下判断。

Ⅰ · 补空缺

官方明确说不做的东西,社区原样补上。这类包最能说明「核心的哲学是产品决策,不是需求判断」。

MCP 255 · 子代理 354 · 计划 202 · 待办 79 · 权限 108 · 后台任务 26

Ⅱ · 换外观

状态栏、页脚、主题、选择器、编辑器。终端 UI 是 pi 全仓最重的一块,也是生态最爱改的一块。

界面/主题命中 895 个包 · 占比 17.0%

Ⅲ · 接外部

供应商、搜索引擎、抓取器、外部系统连接器。把 pi 从「能写代码」变成「能拿到资料、能连上系统」。

模型/供应商 1,331 · 搜索/抓取 503 · 协议/集成 288

Ⅳ · 固化工作流

把某种工程习惯写成代码:代码审查、LSP 反馈、技能包、规则文件、目标管理。

技能/提示 907 · 工程流程 538 · 记忆/上下文 822

注意读法:多标签统计里「模型 / 供应商」高达 25.4%,很大程度是因为 claude、codex、model 这类词在描述里出现得太频繁(「兼容 Claude Code 的…」)。 这类数字应被视为「提及率」而非「同赛道竞争者的真实数量」。

03 官方样例库

78 个示例,就是生态的种子

发布包里带 examples/extensions/:69 个单文件扩展 + 9 个目录式扩展,合计 14,474 行。 官方文档的示例表收录了其中 67 个,分 12 类——这份表格基本预告了社区后来会长出什么。

Events & Gates(拦截与把关)13
UI Components(界面组件)13
Tools(自定义工具)8
Commands(注册命令)7
Compaction & Sessions5
Remote & Sandbox5
Games / 其它零散6
Complex / Providers / Messages8

官方示例里最"不务正业"的三个

  • doom-overlay/ — 在浮层里跑 Doom。它同时演示了自定义 TUI 组件、键盘输入与浮层布局。
  • snake.ts / space-invaders.ts — 两个小游戏,用来说明「等待时可以干什么」。
  • 这三个不是玩具:能跑游戏意味着扩展拿到的 UI 能力是完整的。

预示了社区走向的几个

  • plan-mode/ — 官方不做计划模式,但给了完整实现。社区里 202 个包在做同一件事。
  • subagent/ — 同上。社区里 354 个包在做多智能体。
  • sandbox/ + gondolin/ — 官方不做沙箱,但提供了「把内置工具路由进微虚拟机」的范式。

资源面为什么弱

  • 技能依赖模型主动去读 SKILL.md,而扩展是代码、一定会执行。
  • 提示模板只有一段文字,没有状态、没有 UI、没有持久化。
  • 结果:pi-extension 2,585 个 vs pi-prompt 4 个,差三个数量级。

04 npm 生态统计

一个极度年轻、极度陡峭的分布

样本 5,250 个包、30 天合计下载 9,490,887 次。数字看上去很大,但结构极度不均: 中位数只有 393 次/月,而第一名接近 100 万。

4.1 · 下载分层

≥ 100,000 / 月8 包
10,000 – 99,99996 包
1,000 – 9,9991,112 包
100 – 9993,992 包
< 100 / 月42 包

注意这是偏头部的样本:即便如此,仍有 76.0% 的包月下载在 1,000 次以下。 中位数 393、均值 1,808——均值是中位数的 4.6 倍,说明这个分布被极少数头部包撑着。

4.2 · 集中度

Top 10 包31.7% 下载
Top 50 包46.4%
Top 100 包53.7%
Top 500 包73.2%
其余 4,750 个包26.8%

4.3 · 类别结构(多标签)

模型 / 供应商1,331 · 25.4%
技能 / 提示 / 规则907 · 17.3%
界面 / 主题895 · 17.0%
记忆 / 上下文822 · 15.7%
工程流程538 · 10.2%
搜索 / 网页抓取503 · 9.6%
多智能体 / 编排495 · 9.4%
任务 / 计划395 · 7.5%
协议 / 外部系统接入288 · 5.5%
安全 / 权限280 · 5.3%
未命中任何规则1,209 · 23.0%

4.4 · 成熟度与活跃度

指标数值读法
版本仍为 0.x74.7%四分之三的包还没宣布过「1.0」
许可为 MIT88.7%4,656 / 5,250;Apache-2.0 仅 185
带 repository 链接90.3%绝大多数包可追溯到源码仓
近 7 天内发布过23.3%1,221 个包仍在高频迭代
近 30 天内发布过68.2%3,581 个包;2026-09 单月 2,342 个
scoped 包(@scope/name)56.7%过半作者选择用命名空间隔离
名称以 pi- 开头76.7%4,029 个;命名高度同质
独立发布者2,646最多的一位发布 51 个包
publisher 字段为 GitHub Actions1,70432.5% 的包由 CI 自动发布
一个容易被忽略的细节:「publisher 为 GitHub Actions」的 1,704 个包, 意味着生态里有三分之一的包不是人手推上去的,而是仓库 tag 自动发布的。 这也解释了为什么包的绝对数量增长如此之快——发布成本已经接近零。

05 头部图谱

下载量最高的十二个包,说明了缺口在哪

下表的「月下载」为最近 30 天。前八名合计吃掉了样本 29.8% 的下载量。

包月下载它是什么
pi-mcp-adapter986,905MCP 适配器 —— 给「不做 MCP」的 pi 接上 MCP
pi-subagents450,716单代理委派与脚本化多代理工作流
pi-web-access442,184网页搜索、抓取、GitHub 克隆、PDF / YouTube 提取
@companion-ai/feynman345,586基于 pi 构建的「研究优先」CLI agent
@juicesharp/rpiv-ask-user-question195,047结构化问卷:让模型能主动向你提问
@juicesharp/rpiv-todo164,979覆盖在终端上的实时待办列表
pi-background-tasks135,592持久化后台 shell 任务与只读委派
billion-context103,404上下文压缩代理:让 coding agent 连续跑几天
pi-lens96,038LSP / lint / 格式化 / 类型检查的实时反馈
pi-goal-x85,195给 pi 加上 /goal:会话式目标规划
bigpowers84,90973 个 agent 技能打包
context-mode73,763MCP 插件:宣称节省 98% 上下文窗口

The gaps · 官方拒绝 vs 生态补位

六条「不做」,六处被填满

pi 的哲学是「这些功能你自己用扩展做」。生态听懂了,并且照着清单做了一遍—— 下面每一行的左侧是 README 里的原话,右侧是它在 npm 上的具体形态。 这不是打脸,而是一次成功的分工验证:核心越克制,补位的经济价值越高。

No MCP255 个包 · 月下载 1,472,203 · 头名 pi-mcp-adapter(986,905) · 全生态下载量第一
No sub-agents354 个包 · 月下载 975,860 · 头名 pi-subagents(450,716) · 第二名
No plan mode202 个包 · 月下载 425,545 · 头名 pi-goal-x(85,195)
No built-in to-dos79 个包 · 月下载 241,310 · 头名 rpiv-todo(164,979)
No permission popups108 个包 · 月下载 129,057 · 头名 pi-permission-system(40,684)
No background bash26 个包 · 月下载 158,707 · 头名 pi-background-tasks(135,592)

「不做」并不等于「不该有」——它等于「由扩展层决定要不要有」。 这套分工的代价是:核心永远保持小而锋利,而使用者必须自己知道要装什么。

06 本机快照

一台机器上的真实用量

统计报告容易飘在半空。作为对照,这里给出本机(pi v0.85.1)的实际生态构成—— 它既没有装任何 npm 包,也不是官方示例的复刻。

自研扩展 · 7 个 · 2,610 行

  • web-tools — web_search / web_fetch,多后端降级(Tavily → Bing → 本地代理)
  • memo — 外层事项备忘录,每轮注入系统提示
  • current-time — 每轮把真实时间追加进系统提示
  • secrets — 按扁平格式读取本地密钥
  • deepseek-vision — 给不支持视觉的模型补上图像理解
  • clash-verge — 查询与开关本机代理(含 550 行 JS 核心)
  • herdr-agent-state — 第三方工具自动写入的状态上报器

技能 · 26 个 · 10,134 行

  • 全部为目录式,各自带一份 SKILL.md(不计 node_modules)。
  • 体量最大的两项(browser-tools、cn-search)是带脚本的技能包,其余 24 个是纯文档型。
  • 其中 kwelldo-site 就是这个站点本身的操作手册。

两个「退出」记录

  • disabled-extensions/voice/ — 语音扩展已停用(含 STT/TTS 两个 Python 脚本)。
  • .removed-skills/brave-search/ — 技能被移除后目录仍保留,作为备份。
  • 官方在这两处都留了后备目录的约定——「移除」不等于「删除」。

跨 harness 的资源目录

  • pi 会额外扫描 ~/.agents/skills,并可通过设置挂载 ~/.claude/skills、~/.codex/skills 等。
  • 本机 ~/.claude/skills、~/.codex/skills、~/.config/opencode/skills 三处合计已有 173 个 SKILL.md,都可以直接挂给 pi 复用。
  • 生态的边界不在包管理器里,而在技能标准里:谁的 SKILL.md 被别人读,谁就赢了。

07 判读

三个结论,三个风险

基于以上数据,可以下的判断与不能下的判断。

成立的结论

  • 生态是官方哲学的补集。README 说不做的,正好是下载榜单上最重要的几项。
  • 表达力决定份额。扩展 2,585 vs 提示模板 4——能力越强的接口,生态越拥挤。
  • 热度真实,成熟度不足。68% 的包一个月内动过,但 75% 还没到 1.0,中位下载仅 393/月。

不能下的结论

  • 下载量 ≠ 使用量:CI、镜像、缓存都会计入。不要用月下载给工具排名。
  • 样本偏头部:真实长尾比本文所示的更极端,任何「占比」都只是下限。
  • 单月快照:这个生态 68% 的包在 30 天内发布过,几个月的滞后就会让本文的数字失效。

风险

  • 权限模型是最大的一条。装一个包等于给一段未知代码完整用户权限;官方文档明说没有沙箱。
  • 供应链集中度。三分之一由 CI 自动发布,且头部包拥有对 MCP / 代理编排这类「枢纽能力」的实际控制权。
  • 命名空间污染。76.7% 的包以 pi- 开头,2,646 个发布者几乎没有命名约束,抢注与混淆难以避免。

值得继续观察

  • 技能(pi-skill)只有 107 个,但跨 harness 的技能标准正在扩散——这是唯一可能绕过 npm 的增长路径。
  • 「上下文压缩」已经出现市值级玩家(billion-context 等),说明瓶颈正从能力转向续航。
  • 安全/权限类目前只有 280 个包命中、月下载 12.9 万,与风险体量严重不匹配。

尾 结论

一个愿意说「我不做」的核心,最终会被生态翻译成「我来做」。

10,101 个包、9.49M 月下载、78 个官方示例、36 个事件——这组数字里最值得记住的不是规模, 而是结构的可预测性:核心拒绝什么,生态就在哪里长出头部。 对使用者来说,这意味着装上 pi 只是开始,真正的选择在于你要不要 MCP、要不要子代理、要不要一道权限闸门—— 而这些选择,pi 一个都不替你做。