Research Notes

OMP Windows 环境配置

3 min read

适用于 OMP（一款终端编码智能体）的简洁 Windows 配置方案，具备 IDE 级工具链集成：LSP、DAP、子智能体、计划模式、回溯记忆、行内编辑与规则系统。

1. 安装前置依赖

打开 PowerShell：

winget install Git.Git
winget install OpenJS.NodeJS.LTS

关闭并重新打开 PowerShell，然后检查：

git --version
node -v
npm -v

Windows 上安装 Git for Windows 至关重要，因为 OMP 需要一个 Bash 环境。安装程序会在以下路径查找 Git Bash：

C:\Program Files\Git\bin\bash.exe

2. 安装 OMP

使用此确切的 PowerShell 安装命令：

irm https://omp.sh/install.ps1 | iex

然后重启 PowerShell 并检查：

omp --version

默认行为：

  • 如果已安装 Bun，OMP 通过 bun install -g @oh-my-pi/pi-coding-agent 安装。
  • 如果未安装 Bun，OMP 会将 Windows 二进制文件下载至 %LOCALAPPDATA%\omp。
  • 安装程序会根据需要将 OMP 添加至用户 PATH。
  • 它会将 Bash shell 配置写入 %USERPROFILE%\.omp\agent\settings.json。

3. 在项目中运行 OMP

cd C:\dev\your-project
git status
omp

推荐的首次提问：

使用计划模式。检查此仓库并解释其架构。
请勿编辑文件。
告诉我为 <task> 可以做的最小安全的第一项改动。

如需执行实现：

目标：做出能够实现 <task> 的最小安全改动。
在编辑之前，检查相关文件并解释计划。
不要触及无关的文件。
编辑之后，运行最小范围的相关测试或检查。
总结已修改的文件、运行的命令以及存在的剩余风险。

4. 在 Windows 上使用 PyCharm

在 PyCharm 中：

  1. 打开项目文件夹。
  2. 在 PyCharm 中打开终端。
  3. 确保终端从项目根目录启动。
  4. 运行：
git status
omp

在 OMP 工作时保持 PyCharm 打开：

  • 使用 PyCharm 进行文件审查、搜索、调试、测试界面和 Git diff。
  • 在 PyCharm 终端中使用 OMP 进行智能仓库编辑。
  • 在接受更改前，查看 PyCharm 中的 Git diff。
  • 从 PyCharm 或同一终端运行最小相关的测试。

如果 OMP 提示缺少 Bash，请安装 Git for Windows 并重新运行：

irm https://omp.sh/install.ps1 | iex

手动设置 shell 配置路径：

%USERPROFILE%\.omp\agent\settings.json

示例：

{
  "shellPath": "C:\\Program Files\\Git\\bin\\bash.exe"
}

来源