@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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/0xkahi-pi-qol/raw/index.md(查看排版版本)