Ⅰ · 补空缺
官方明确说不做的东西,社区原样补上。这类包最能说明「核心的哲学是产品决策,不是需求判断」。
MCP 255 · 子代理 354 · 计划 202 · 待办 79 · 权限 108 · 后台任务 26
pi package ecosystem · npm registry survey · 2026-09-18
pi 的 README 明确写下六条「不做」:不做 MCP、不做子代理、不做权限弹窗、不做计划模式、 不做内置待办、不做后台 bash。而在 npm 上的 pi 生态里, 下载量第一的包是一个 MCP 适配器,第二是一个子代理框架—— 被拒绝得最彻底的那两件事,恰是需求最硬的两件事。
keywords:pi-package 共 10,101 个包; 但 search API 的分页在第 21 页(offset 5,250)之后开始回绕,因此下文所有分布统计 均基于去重后的 5,250 个包(按相关度排序的前段,即偏头部样本)。 凡是「长尾」类结论,在这个偏头部样本上都只会被低估,不会被高估。 下载量为最近 30 天数据,采集时间 2026-09-18。01 命题
pi 对外只开两个面:事件面(36 个可挂钩的生命周期事件,能改行为)与 资源面(四类可打包资源,能加知识)。生态长成什么样,取决于哪个面更好用—— 数据给出的答案非常干脆。
四类资源里,扩展吃掉了近乎全部份额:每一百个包里有 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
claude、codex、model 这类词在描述里出现得太频繁(「兼容 Claude Code 的…」)。 这类数字应被视为「提及率」而非「同赛道竞争者的真实数量」。03 官方样例库
发布包里带 examples/extensions/:69 个单文件扩展 + 9 个目录式扩展,合计 14,474 行。 官方文档的示例表收录了其中 67 个,分 12 类——这份表格基本预告了社区后来会长出什么。
SKILL.md,而扩展是代码、一定会执行。04 npm 生态统计
样本 5,250 个包、30 天合计下载 9,490,887 次。数字看上去很大,但结构极度不均: 中位数只有 393 次/月,而第一名接近 100 万。
注意这是偏头部的样本:即便如此,仍有 76.0% 的包月下载在 1,000 次以下。 中位数 393、均值 1,808——均值是中位数的 4.6 倍,说明这个分布被极少数头部包撑着。
| 指标 | 数值 | 读法 |
|---|---|---|
| 版本仍为 0.x | 74.7% | 四分之三的包还没宣布过「1.0」 |
| 许可为 MIT | 88.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 Actions | 1,704 | 32.5% 的包由 CI 自动发布 |
publisher 为 GitHub Actions」的 1,704 个包, 意味着生态里有三分之一的包不是人手推上去的,而是仓库 tag 自动发布的。 这也解释了为什么包的绝对数量增长如此之快——发布成本已经接近零。05 头部图谱
下表的「月下载」为最近 30 天。前八名合计吃掉了样本 29.8% 的下载量。
| 包 | 月下载 | 它是什么 |
|---|---|---|
| pi-mcp-adapter | 986,905 | MCP 适配器 —— 给「不做 MCP」的 pi 接上 MCP |
| pi-subagents | 450,716 | 单代理委派与脚本化多代理工作流 |
| pi-web-access | 442,184 | 网页搜索、抓取、GitHub 克隆、PDF / YouTube 提取 |
| @companion-ai/feynman | 345,586 | 基于 pi 构建的「研究优先」CLI agent |
| @juicesharp/rpiv-ask-user-question | 195,047 | 结构化问卷:让模型能主动向你提问 |
| @juicesharp/rpiv-todo | 164,979 | 覆盖在终端上的实时待办列表 |
| pi-background-tasks | 135,592 | 持久化后台 shell 任务与只读委派 |
| billion-context | 103,404 | 上下文压缩代理:让 coding agent 连续跑几天 |
| pi-lens | 96,038 | LSP / lint / 格式化 / 类型检查的实时反馈 |
| pi-goal-x | 85,195 | 给 pi 加上 /goal:会话式目标规划 |
| bigpowers | 84,909 | 73 个 agent 技能打包 |
| context-mode | 73,763 | MCP 插件:宣称节省 98% 上下文窗口 |
The gaps · 官方拒绝 vs 生态补位
pi 的哲学是「这些功能你自己用扩展做」。生态听懂了,并且照着清单做了一遍—— 下面每一行的左侧是 README 里的原话,右侧是它在 npm 上的具体形态。 这不是打脸,而是一次成功的分工验证:核心越克制,补位的经济价值越高。
「不做」并不等于「不该有」——它等于「由扩展层决定要不要有」。 这套分工的代价是:核心永远保持小而锋利,而使用者必须自己知道要装什么。
06 本机快照
统计报告容易飘在半空。作为对照,这里给出本机(pi v0.85.1)的实际生态构成—— 它既没有装任何 npm 包,也不是官方示例的复刻。
web-tools — web_search / web_fetch,多后端降级(Tavily → Bing → 本地代理)memo — 外层事项备忘录,每轮注入系统提示current-time — 每轮把真实时间追加进系统提示secrets — 按扁平格式读取本地密钥deepseek-vision — 给不支持视觉的模型补上图像理解clash-verge — 查询与开关本机代理(含 550 行 JS 核心)herdr-agent-state — 第三方工具自动写入的状态上报器SKILL.md(不计 node_modules)。kwelldo-site 就是这个站点本身的操作手册。disabled-extensions/voice/ — 语音扩展已停用(含 STT/TTS 两个 Python 脚本)。.removed-skills/brave-search/ — 技能被移除后目录仍保留,作为备份。~/.agents/skills,并可通过设置挂载 ~/.claude/skills、~/.codex/skills 等。~/.claude/skills、~/.codex/skills、~/.config/opencode/skills 三处合计已有 173 个 SKILL.md,都可以直接挂给 pi 复用。SKILL.md 被别人读,谁就赢了。07 判读
基于以上数据,可以下的判断与不能下的判断。
pi- 开头,2,646 个发布者几乎没有命名约束,抢注与混淆难以避免。pi-skill)只有 107 个,但跨 harness 的技能标准正在扩散——这是唯一可能绕过 npm 的增长路径。尾 结论
一个愿意说「我不做」的核心,最终会被生态翻译成「我来做」。
10,101 个包、9.49M 月下载、78 个官方示例、36 个事件——这组数字里最值得记住的不是规模, 而是结构的可预测性:核心拒绝什么,生态就在哪里长出头部。 对使用者来说,这意味着装上 pi 只是开始,真正的选择在于你要不要 MCP、要不要子代理、要不要一道权限闸门—— 而这些选择,pi 一个都不替你做。