@0xkahi/pi-qol

pi 终端 AI 助手的质量改善扩展包

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:@0xkahi/pi-qol。
它的用途是:pi 终端 AI 助手的质量改善扩展包
完整的 Skill 内容见:https://321skill.com/skills/0xkahi-pi-qol/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'帮我切换到 GPT-4 模型',pi-qol 的 model_select 会弹出交互式选择器,你可以直接搜索并选择模型,完成后自动切换。或者:'给这个会话起个名字',auto_session_name 会在后台异步生成标题,几秒后底部栏会自动更新为类似'修复登录页样式'的简洁标题。

介绍

这个 Skill 解决了 pi 终端 AI 助手在日常使用中的几个痛点:会话命名繁琐、模型切换效率低、状态信息不直观。开发者经常需要手动为每个会话输入标题,或频繁在命令行中切换模型,而内置的底部栏信息有限,无法快速查看 token 消耗、成本等关键指标,影响开发流畅度。

使用方式很简单,你只需要先通过 pi install 命令安装这个 npm 包,然后在 pi 的配置文件中注册扩展。之后,auto_session_name 功能会在用户发送第一条消息后自动在后台生成简洁的会话标题,完全非阻塞,不打断你的工作流。model_select 功能可通过 /select-model 命令调出交互式模型选择器,支持模糊搜索、收藏夹分组、提供者过滤,并可通过 Tab 键双向导航,配合 pi-vim-keys 插件还能使用快捷键。custom_footer 功能会替换 pi 内置的底部栏,用三行布局显示当前目录(含 git 分支)、累计 token 用量、缓存命中率、会话成本(或订阅进度条),以及当前模型名称。

它非常适合需要频繁切换模型、关注 API 调用成本、或希望提升终端界面信息密度的开发者和团队。尤其是那些已经使用 pi 作为主要 AI 编码助手的用户,可以显著减少重复操作,让注意力更集中在代码本身。对于管理多个 AI 编码代理或进行多项目并行开发的场景,这个扩展的模型选择器和会话命名功能尤为实用。

建议在项目目录下创建 .pi/extensions/pi-qol/config.json 来覆盖全局配置,以便不同项目使用不同的模型偏好或底部栏样式。需要注意的是,custom_footer 与 pi 内置底部栏相比,省略了 (auto) 压缩后缀,因为扩展无法获取该状态的实时数据。另外,部分功能(如订阅进度条)需要配置 OAuth 凭据,否则对应的区域会自动隐藏。

常见问题

如何配置常用模型列表?

在 config.json 的 model_select 字段中设置 favorites 和 groups 即可,支持按提供者、分组标签进行筛选。

custom_footer 能显示订阅进度吗?

可以,但仅支持 Anthropic 和 OpenAI Codex 的 OAuth 订阅,需要配置对应凭据,且数据缓存 60 秒刷新一次。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/0xkahi-pi-qol/raw/index.md 读取 @0xkahi/pi-qol 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。