Windows 上如何原生装好 oh-my-piomp 一键安装完整指南【免费下载链接】oh-my-pi⌥ Coding agent with the IDE wired in. Built by Stencil Labs.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-pi命令行 AI 工具在 Windows 上总是磕磕绊绊缺rg、缺bash最后只能绕道 WSL。oh-my-piomp把 IDE 能力直接接进终端的 AI 编码代理走的是另一条路Windows 原生安装一条 PowerShell 命令落地rg、grep、bash全部内嵌在进程里不依赖任何外部二进制。项目速览oh-my-pi 是什么、装完能干嘛技术栈TypeScript 前端 约 8 万行 Rust 原生核心Bun 运行时驱动60 模型供应商、31 个内建工具开箱即用官方承诺The same omp binary runs on macOS, Linux, and Windows — no WSL bridge原文见 README.md——同一套二进制跨平台Windows 原生运行本文带你走通从 0 到在 Windows 上跑起omp覆盖两条安装路、环境适配项和装完 5 分钟内的上手动作。首次启动时 omp 会自动继承磁盘上已有的 Cursor、Claude Code、GitHub Copilot 等规则与技能配置无需迁移脚本。选型先行我该走哪条安装路按你的身份直接对号入座操作细节在下一节展开新手 / 普通用户 → 预编译二进制一条irm ... | iex命令搞定自动校验 SHA-256、写入 PATH不需要任何前置工具链开发者 → Bun 源码安装bun install -g装最新版还能用-Ref锁版本或切分支适合要读源码、提 issue 的人已有 Bun 环境者 → 什么都不用选脚本默认策略是检测到 Bun 就走源码路否则走二进制无需手动指定逻辑见 scripts/install.ps1。 两条路都会自动探测 bash 并写配置区别只在产物形态单文件omp.exevs 全局 npm 包。Windows 一键安装手把手执行与验证信号方式一PowerShell 一行装预编译版推荐新手打开 PowerShell执行irm https://omp.sh/install.ps1 | iex脚本依次做三件事下载omp-windows-x64.exe并先校验 SHA-256 再落盘、把%LOCALAPPDATA%\omp写入用户级 PATH可用PI_INSTALL_DIR覆盖目录、自动探测 bash 并写入配置。成功信号终端出现[OK] Installed omp to ...与Run omp to get started!。注意PATH 是用户级生效必须重开一个终端再执行omp -v能打印版本号即安装成功。失败兜底报Checksum mismatch说明下载被截断直接重跑命令即可脚本不会用坏文件覆盖旧版本。方式二Bun 安装最新版适合开发者要求 Bun ≥ 1.3.14脚本会自动检测并补装bun install -g oh-my-pi/pi-coding-agent需要锁版本或切分支时加参数例如-Source -Ref v3.20.1源码安装需要 git装了 git-lfs 会自动git lfs pull拉大文件。成功信号终端出现[OK] Installed omp via bun重开终端后omp直接进入 TUI。失败兜底报Bun 1.3.14 or newer is required就升级 Bun或退回方式一。环境适配清单CPU 指令集与键位冲突怎么自动处理事项结论CPU 指令集AVX2自动处理。x64 分modernAVX2/baseline两档Windows 上通过IsProcessorFeaturePresent(40)检测Bun FFI不可用时回退 PowerShell老 CPU 无需手动干预要强制可设PI_NATIVE_VARIANTmodern|baseline终端键位冲突自动处理 手动兜底。Windows Terminal 会先截走CtrlV贴图片请改用AltVCtrlEnter被吞时用CtrlQ发送后续消息键位表见 docs/keybindings.md外部 shellbash自动处理。按序找C:\Program Files\Git\bin\bash.exe→ PATH 中任意bash.exeCygwin/MSYS2/WSL 均可写入~/.omp/agent/settings.json的shellPath找不到也不用慌——omp 回退内建 brush shell58 个常用命令ls、sed、sort、xargs、jq照样能跑PATH 与 Git 路径自动处理。内建 shell 的 PATH 在 Windows 上做大小写不敏感合并与去重并自动发现 Git for Windows 路径补全见 crates/pi-shell/src/windows.rs想装完整交互式 shell手动兜底。单独装 Git for Windows或在~/.omp/agent/settings.json手写{ shellPath: C:\\path\\to\\bash.exe }字段说明见 docs/settings.md开箱体验装完前 5 分钟能做的 3 件事直接在终端跑 Python 并出图eval提供持久 Python JS 双内核内核还能回调代理自己的read/search工具——读 CSV、画图表全程不离开单元格Windows 上零额外配置让 LSP 替你干活重命名符号走workspace/willRenameFiles桶文件与别名导入自动同步IDE 知道的事情代理都知道默认开启见lsp.enabled用内置 bash 热身bash工具里的 58 个内建命令全部进程内执行、零 fork/exec会话跨命令存活性能与 Linux 一致。排障速查表Windows 安装常见报错症状原因处置omp 不是内部或外部命令新终端未加载用户级 PATH重开终端确认%LOCALAPPDATA%\omp已在 PATHBun 1.3.14 or newer is requiredBun 版本过低升级 Bun或改用irm预编译方式No bash shell found - OMP will use its built-in shell未装 Git for Windows无需处理内建 shell 可用想要 PTY/shell 快照再装 GitChecksum mismatch for omp-windows-x64.exe下载不完整或损坏重跑安装命令脚本已跳过坏文件老 CPU 报原生模块加载失败AVX2 检测异常设PI_NATIVE_VARIANTbaseline后重启终端延伸阅读与一句话定论想深入原理读三篇就够docs/natives-architecture.md跨平台原生插件架构与 CPU 变体机制、docs/natives-shell-pty-process.md内建 shell 的会话模型与 Windows PATH 合并细节、scripts/install.ps1安装脚本全文含所有参数。一句话收束omp 在 Windows 上是真·原生——不借道 WSL、不凑外部工具链一条命令装完重开终端就能干活。【免费下载链接】oh-my-pi⌥ Coding agent with the IDE wired in. Built by Stencil Labs.项目地址: https://gitcode.com/GitHub_Trending/oh/oh-my-pi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考