niubash

它能跑真插件、真脚本、真 dotfiles，靠的不是移植 GNU 代码，而是把兼容性当工程对象： 每一个行为主张都要对 vendored GNU bash-5.3 源码给 file:line 坐标，每一处差异都要双向差分到字节级。

• 零 fork：三层执行模型——POSIX fork() 在 Win32 没有等价物，MSYS2/Cygwin 只能在 syscall 层伪造它。niu 的引擎 rubash 复刻 fork 的语义而非机制：子壳与命令替换在进程内完成，脚本可观察的一切与 GNU Bash 一致。命令替换类负载实测 13–62x 快于 GNU bash。
• 无 MSYS：argv 永不改写——Git Bash 的 MSYS 运行时会在 spawn 前启发式改写「看起来像路径」的参数；niu 没有 MSYS 运行时：参数进什么，命令就收什么，无咒语可念。
• 四大生态的路径方言全收——Windows 原生（D:\repo、D:/repo）、MSYS/Git Bash 形（/d/repo、/tmp、/usr/bin）、WSL 形（/mnt/d）、Cygwin 形（/cygdrive/d）全部接受且真折叠——既有脚本零修改。
• 兼容性是测出来的，不是宣称的——对 GNU Bash 自己的 83 套上游语料做 true-baseline 双向测量：83/83 通过、82 套逐字节一致；另外全网 2686 仓 / 9701 资产每夜巡检，6336 条真实资产判定原文入仓可回放。

路径方言实测矩阵随审计包附上（PATH-MATRIX.md，约 100 条 PS 原生 argv 探针逐格实跑）； 执行模型细读见 执行模型：零 fork 三层， 路径差异见 路径与 MSYS。

• 真·插件生态：上游 BASH 插件直接跑——oh-my-bash、bash-it、bash-completion、bash-preexec 源码一行不改原生运行；bash-completion 3796 行完整 source rc=0 曾是发布阻塞，如今是端到端门禁的一环。
• 为 agent 而设的旗标面——niu --encoded-command <base64> 给 agent/CI 一条免引号通道；niu --cwd-state <file> 让链式一次性调用共享目录记忆。
• AI agent 接入：$SHELL 即机制——niu 导出 $SHELL，遵循 POSIX 约定的 agent 从 niu 会话启动即用、零配置；安装器在探针路径布放 bash 启动器命中 Claude Code 的第一探针。
• 内联命令与编译进壳的补全——12 个高频文件命令内联执行，echo | cat 全程零进程；178 个 WinuxCmd applet 的真实旗标补全编译进 shell。
• wpm 联动：命令即包——rg / fd / bat / jq / node 一条 wpm install 到位；Windows 发行包预装 gawk、niu-git、ripgrep、fd。
• git 感知的快速提示符——默认提示符读 .git/HEAD 文件（微秒级）渲染分支与脏标记，不再每条提示符 spawn git 子进程（实测 113–362ms）。
• 输入管线做到字节级——多行粘贴自动误执行 186 次 → 0，257 行载荷 300s 超时 → 4.6s；ConPTY 粘贴丢字符、typeahead 吃键、控制台 read 三面逐项与 GNU 行为对齐。
• 控制台设备重定向：Git Bash 报错的地方 niu 照跑——echo >/dev/tty、exec 3<>/dev/tty、test -e /dev/tty 与 GNU 行为一致，同组命令在 Git Bash 的 MSYS 层报 Invalid argument；引擎把 CON 拆成 CONIN$/CONOUT$ 两端，git/ssh askpass 正依赖这条路。
• 跨平台到 CI 腿：三个发布平台，六个发布目标——Windows x64/ARM64、Linux x86_64/aarch64、macOS aarch64/x86_64 六目标每次发布冒烟四查；Android 双目标 incubating，OpenHarmony 仅 CI 编译检查。

AI 集成：agent 的高频调用面是一次性 -c，niu 为此做了三件事。其一，快路径：niu -c true 的冷启动地板从 105.6 ms 压到 26.3 ms（一次性快路径六连 PR；29 例行为电池零差异）。其二，免引号通道 --encoded-command：base64 载荷免掉跨进程引号转义，与 -c 同路径、同 BASH_EXECUTION_STRING 契约。其三，目录记忆 --cwd-state。会话级接入：从 niu 会话启动的 agent 直接拿到 niu 导出的 $SHELL。逐家 agent 见 AI Agent 接入目录；给 agent 的一键安装提示词见 给 AI 的门户；全部旗标语义见 CLI 与旗标参考。

插件系统：外部 bash 生态走「先装、后审、再信」：niu plugin add 克隆源（新源默认不受信），niu plugin trust 审阅校验和后放行，niu plugin enable 在 rc 尾部维护托管块——块外内容永不改写。声明式 spec（~/.niubash/plugins.toml）是唯一事实源，sync / restore / rollback 一族动词带 lockfile 锁定，镜像（niu plugin mirror）对国内网络友好。运行时信任层会复验 pin。

提示符：默认提示符是 Git Bash 骨架，但分支段读 .git/HEAD 文件而不是 fork git——「提示符永不 spawn」红线，实测冷 39 ms / 暖 p50 2.5 ms，对照 Git Bash 每提示符 __git_ps1 约 100–300 ms。PS1 / 主题声明照常接管，set -o vi 的编辑模式指示器保留。