$ cat ~/map/pi-extensions-zion.md

pi-extensions (zion-zion-zion)

中文的 pi 扩展合集：单个 npm 包一次装全，含 token 速度、Codex 额度与 Herdr 工具。

extensions✓ 9月15日

pi install npm:@zionzionzion/pi-extensions（用 pi update 更新；也可把单个 .ts 文件复制到 ~/.pi/agent/extensions/ 后执行 /reload——codex-usage 与 reload-all 两个目录型扩展须整目录复制，两个 .json 配置文件也需手动复制）

## 速览

一套以中文文档发布的 pi 扩展与 skill，打成单个 npm 包分发：token 速度底栏挂件、ChatGPT Codex 额度显示、/commits 与 /checkpoint Git 辅助、模型过滤，以及 Herdr 面板工具。

## 要点

• $单包分发：pi install npm:@zionzionzion/pi-extensions 一条命令装下全部扩展与 read-terminal skill，pi update 负责更新；npm 发版由 GitHub Actions 自动完成——只要版本号变化并入 main 就跑测试、npm publish 并打 v* 标签。
• $度量与模型列表类扩展：token-speed 以 pi-footer 挂件显示上一条回答的生成速度（tok/s），/speed 查看详细统计；codex-usage（目录型扩展，须整目录安装）在 /status 展示 ChatGPT Codex 的五小时与每周额度并在底栏常驻摘要，复用 pi 管理的 openai-codex OAuth；model-filter 在 /model 与 --list-models 中隐藏内置 provider 里用不到的历史模型（默认过滤 openai-codex 的 gpt-5.3 至 5.5）。
• $Git 辅助：/commits 以列表查看当前分支提交历史，选中后 git show --stat 查看详情；/checkpoint 自动生成提交信息并提交当前改动，绝不 push。
• $Herdr 专用工具：auto-hide-thinking、reload-all 与 read-terminal skill 都作用于 Herdr 的命名面板——auto-hide-thinking 以本面板自己的 hideThinkingBlock 为基准（settings.json 被所有面板共享，只能兜底），经 herdr pane send-keys 注入 Ctrl+T，整轮结束后同时收起 thinking 与完整工具块，注入的 Ctrl+T 会把两者一起恢复，在非 Herdr 环境及 print、RPC 模式下空操作；reload-all 把 Herdr 里所有空闲的 pi 窗口重载一遍，跳过忙碌或输入框里有草稿的窗口；read-terminal 按需读取另一个命名终端面板的屏幕与回滚缓冲区，纯读取、不写入。
• $全屏与键盘工具：scroll-to-last-prompt（仅 tuiMode fullscreen 生效）在每轮回复结束后把「我上一条消息」的第一行顶到屏幕顶部，它给 UserMessageComponent 渲染后的首行打标记而非扫描 OSC 133;A——助手不带工具调用的纯文本消息也带同样的前缀，只扫标记会定位错；手动上翻后，下次真正发送消息（alt+enter 排队的消息除外）时自动恢复跟随。steer-or-interrupt 把 Opt+Enter 映射为：无挂起工具时立刻中断当前回答并发送，有挂起工具时走内置 steering。
• $.ts 扩展 import 的 @earendil-works/pi-coding-agent、pi-tui 与 pi-ai 都是 pi 自带的官方包，无需额外安装；startup-sync.ts 会在启动时自动同步作者的 pi 配置仓库，但与本机备份脚本强耦合，README 明确标注为个人环境专用。
• $README 自己的安全提示：扩展与 skill 都以你的完整权限运行，只从可信来源安装。

## 常见问题

## 参考链接

• README ↗

最后更新: 2026年9月15日