Oh My Niu：Niubash 的主题与插件框架

为什么是 Oh My Niu

用惯了 Oh My Zsh / fish 插件管理器 / PowerShell 提示符框架的人，期待的不是某个具体主题， 而是一套模型：列插件、挑主题、source 一行，一切就位。 原生 shell 常缺这一层；oh-my-niu 给 niubash 补上，且刻意不把框架焊死在 shell 里。

核心特性

• 主题画廊 27 款主题（plugins/theme-* 目录与 themes/*.toml 资产层一一对应、集合一致）：Oh My Zsh 经典款、Powerlevel 风 p10 四款、Oh My Posh 风配色款与官方基础款。
• 主题即插件 每款主题是一个普通插件目录（plugin.toml + theme-*.plugin.niu），与功能插件同一加载面——没有特殊的「主题系统」。
• prompt-core 提示符 API 与 segment 注册表的拥有者，默认开启；git 提示符段按 bundle 契约解析为 niubash 原生 Vcs 段（面向 niubash 1.4.1+），分支/脏星/短 SHA 进程内渲染，零 git 子进程。
• Starship 接管模式 想用 Starship？加载 starship 插件、留空 NIU_THEME，由 Starship 经标准 Bash init 路径接管 PROMPT_COMMAND/PS1/PS2/PS0。
• 功能插件族 git、docker、kubectl、npm、jj、zoxide、direnv、dotenv、fzf、last-working-dir、thefuck、path-tools、extract、common-aliases、keybindings、command-not-found、winuxcmd-core（WinuxCmd 命令补全）……
• 2.0 新一方插件 command-timer（逐命令耗时与退出码）、auto-env（按目录自动 .venv）、dirmarks（目录书签）、git-fetch-reminder（上游分叉提醒）、env-sync（经 rclone 同步 shell 配置与 WPM 包清单）。
• 别名 / 补全 / 键位资产 aliases/ 五组 TOML（common/git/docker/kubectl/npm）；completions/ 174 个 TOML 补全定义（WinuxCmd 核心命令族 + git/docker/kubectl/npm/jj）；keybindings/ emacs 与 vi 预设。
• 环境包（envs） 一个小 TOML 声明装哪些 wpm 包、启用哪些插件、导出哪些变量：niu env use git 一键配好原生 Git 工具链（git + delta、GIT_PAGER、git-fetch-reminder）。

安装与快速上手

bundle 随 niubash 发行（离线基线，随 niu self-update 一并推进）， 启用只需 rc 三行。niu plugin 命令族管的是外部生态 （oh-my-bash、bash-it 等第三方源），与捆好的 oh-my-niu 是两条互不干扰的轨道。 入口 oh-my-niu.niu 可重入——source 两次是空操作， 全量重载加 --reload。

# ~/.niubashrc 三行启用：选插件、选主题、source 框架
NIU_PLUGINS=(prompt-core git docker zoxide)
NIU_THEME=minimal
source "$NIUBASH/oh-my-niu.niu"

日常操作

# 换主题：改 NIU_THEME 后重开终端，或当前会话全量重载
source "$NIUBASH/oh-my-niu.niu" --reload
# 捆绑基线随 niubash 版本推进
niu self-update
# 顶层健康检查（rc 块、PATH 一致性等）
niu doctor

换主题改 NIU_THEME 后重开终端即可；把配置改动写进 ~/.niubashrc（source 本身不落盘，插件不经用户显式命令不改写 rc）。 验证一切正常，让牛说话：

niu_moo "Bash, native on Windows."   # cowsay 风格对话泡

深入：主题画廊

画廊不是静态皮肤库——每款主题都是 plugins/theme-*/ 下的普通插件目录 （plugin.toml 元数据 + *.plugin.niu 行为），由 prompt-core 的 segment 注册表渲染；themes/*.toml 资产层 服务于 manifest 兼容与审阅。四组风格：

来源：oh-my-niu README「First-Party Plugins」插件表与 plugins/、 themes/ 目录（实测计数 2026-10-24：theme-* 目录与 themes/*.toml 均为 27、集合一致；上表四组合计 27）。

目录优先模型

行为本体在 plugins/<name>/；packs/、aliases/、 completions/、prompts/、keybindings/、 themes/ 是过渡期的 manifest 兼容与审阅元数据面（当前 niubash 发行工具仍认 manifest-first 布局）。新行为先进插件目录，再暴露 TOML 元数据供审阅、托管安装、更新与回滚—— 设计全文见仓内 docs/design.md（framework-first）。

catalog 指向官方上游

niu plugin 的三个内置 bash 生态源不绑 oh-my-niu—— origin 直指官方上游仓，上游资产一行不改原生运行（兼容性是被 rubash 引擎测出来的事实）：

来源：niubash crates/niubash-runtime/src/plugins/descriptors.rs（ManagerDescriptor origin 字段）· HIGHLIGHTS #13。

与 niu plugin 命令族的边界

bundle 契约：api = "niubash:[email protected]"、 min_niubash = "1.0.0"（2.0 线自旧 winuxsh: 前缀迁至 niubash:；旧 min_winuxsh 字段仍被接受，改名前的 ~/.oh-my-winuxsh 目录作为回退仍被发现）。发布档 oh-my-niu-<version>.zip 附 .sha256。

更新模型一句话：oh-my-niu 不是 niu plugin 的 source—— niu plugin update oh-my-niu 会报 unknown source（1.4.4 实测）， 这是有意设计：捆好的框架随 niubash 版本走（niu self-update 推进基线）， update/rollback 那 spec+lockfile 机制管的是外部第三方源。 旧的 niu plugin themes/doctor/review/search 内建面也已退役 （niubash#145）：主题选择就是 NIU_THEME，主题总览看上方画廊或 plugins/theme-*/ 目录，诊断走顶层 niu doctor （CLI 全录见 CLI 参考）。

实测数字

框架类项目没有微基准——这里的数字是结构台账与仓内实测计数（2026-10-19）：

更新动态

oh-my-niu 有自身 CHANGELOG。最新 3 版（changelogs.json，抓取 2026-10-19； 完整流水见 更新日志）：

• 2.0.0（日期未标） 更名 oh-my-winuxsh → oh-my-niu（对齐 niubash 1.0.0 品牌）；bundle/plugin API 前缀 winuxsh: → niubash:，环境前缀改 NIU_*； 新一方插件 command-timer / auto-env / dirmarks / git-fetch-reminder / env-sync； git 提示符段面向 niubash 1.4.1+ 解析为原生 Vcs 段（进程内渲染、零 git 子进程）。
• 1.0.1（2026-08-02） 首批源包（Git/Docker/kubectl/npm/zoxide/direnv/dotenv/fzf/last-working-dir/thefuck）； 框架入口点、目录优先官方插件、prompt-core 与 minimal/classic/pure/compact/cyberpunk/forest/ocean 七款主题插件；运行时 smoke 脚本；确定性发布打包（zip + sha256）。
• 1.0.0（2026-07-31） 建仓为官方插件 bundle：bundle 元数据（api = winuxsh:[email protected]、 min_winuxsh 0.8.3）、别名/补全/提示符预设/键位/主题资产与作者模板、 确定性发布打包与校验和。

相关链接