$ cat ~/map/monopi.md
monopi
一条命令配好 Pi——扩展、主题、提示词与技能，堪称 Pi 的 oh-my-zsh。
templates✓ 10月16日
事实速查
- GitHub Stars
- ★ 159
- Forks
- 21
- 许可证
- MIT
- npm / 月
- —
- 最后推送
- 2026年10月9日
安装
npx @monopi/monopi## 速览
pi 的一键安装与配置套装——npx @monopi/monopi 一条命令装好默认扩展（worktree、scheduler、后台任务、诊断）、主题与技能，堪称 pi 界的 oh-my-zsh。
## 要点
- $一条命令安装完整默认套装：运行时包（extensions、background-tasks、diagnostics、subagents、web-remote）加内容包（themes、skills、agents）；--version 固定版本，--local 装进项目的 .pi/settings.json，--remove 一键从 pi 卸载全部 monopi 包。
- $默认开启的扩展包括 git-guard（agent 改动前自动建 git stash 检查点）、custom-footer（显示模型、token、成本与上下文窗口占比的状态栏）、diagnostics、tool-metadata、compact-header、external-editor、worktree（/worktree 的 create、cleanup、list）、scheduler（/remind、/loop cron、/schedule）、btw（/qq 旁路问答）、background-tasks（bg_task、/bg），以及带安全模式的 watchdog。
- $六套主题（monopi Dark、Cyberpunk、Nord、Catppuccin Mocha、Tokyo Night、Gruvbox Dark）与三个维护中的技能包；三种预设（Full Power、Clean、Subagents），provider 覆盖 Anthropic、OpenAI、Google Gemini、Groq、OpenRouter、xAI 与 Mistral。
- $npx @monopi/monopi 默认不装的选装包：@monopi/adaptive-routing、@monopi/provider-catalog、@monopi/provider-cursor、@monopi/provider-ollama 与 @monopi/analytics-extension——各自用 pi install npm:<name> 启用。
- $对直接集成 pi SDK 的包，以 pi 0.56.1 为最低支持基线；CI 同时对这一基线与固定的新版运行时（0.64.0）做冒烟检查。
- $终端里 emoji 渲染不佳时，纯文本图标模式可换成 ASCII 兜底：OH_PI_PLAIN_ICONS=1、pi --plain-icons，或在 settings.json 里设 plainIcons: true。
## 常见问题
Q 怎么把 monopi 卸掉？
npx @monopi/monopi --remove 会从 pi 中卸载全部 monopi 包；--version 0.2.13 则固定装某个版本而不是最新版。
Q 哪些部分默认不装？
adaptive-routing、provider-catalog、provider-cursor、provider-ollama 与 analytics-extension 保持选装，作为独立的可选包发布——想要哪个就用 pi install npm:<name> 装哪个。
## 参考链接
## 相关条目
最后更新: 2026年8月31日