pi-hub

给 Pi coding agent 用的扩展包集合。每个目录都是一个独立发布的 pi package，装上就能用。

包一览

包	做什么	入口
@masonchow/pi-hud	Claude Code statusline 风格的 HUD：模型、上下文水位、额度/花费、缓存命中率、subagent 消耗	/hud
@masonchow/pi-agent-formula	F1 进站顾问：红黄白打标；难度升档 / 质量升档 / 省耗降档；确认后才换模	/formula-config /formula-tires /boxbox
@masonchow/pi-claude-rules	按 Claude Code 语义消费 .claude/rules/，同一套规则库在 Pi 里表现一致	/rules
@masonchow/pi-deepseek-responses	官方 DeepSeek provider 透明切 /responses，保留 Pi function tools 并启用 DeepSeek 原生 web_search	自动生效

快速开始

pi install npm:@masonchow/pi-hud

重启 Pi 即生效。-l 只装到当前项目（写 .pi/settings.json，不动全局）：

pi install -l npm:@masonchow/pi-claude-rules

pi list 看已装的，pi remove npm:@masonchow/pi-hud 卸载。

各包的配置、环境变量、故障排查看各自 README。

适用范围

✅ Pi coding agent 0.81.1 及以上（pi-deepseek-responses 按 Pi 0.84.1 API 开发） ✅ Node.js 20+（pi-deepseek-responses 需要 Node.js 22.19+） ✅ TypeScript 源码直接发布，装完不需要构建步骤 ✅ 四个包互不依赖，按需单独安装

❌ 不是 Claude Code / Cursor / Codex 的扩展（pi-claude-rules 只是复用 Claude Code 的规则文件格式） ❌ 不 fork Pi core；provider-specific 行为通过 Pi extension API 实现

提问与反馈

用得不顺、想要新能力、发现 bug，都欢迎开 issue。开 issue 时带上：

• pi --version 与 Node 版本
• 哪个包、哪个命令
• 期望行为 vs 实际行为（有报错请贴完整栈）

本地开发

每个包统一 src/（src/index.ts 为扩展入口）+ tests/：

cd <pkg>
npm install
npm test          # node --test
npm run typecheck

装未发布的改动直接用本地路径：

pi install /absolute/path/to/pi-hub/<pkg>
pi -e /absolute/path/to/pi-hub/<pkg>    # 一次性加载，不写 settings

许可

MIT