omp-rig0.1.4

English | 简体中文 | 한국어

omp-rig 是 omp 编程智能体的插件。rig 是一组保存好的模型设置：所有模型角色（default、smol、slow、plan 等），外加 omp 可以使用的模型和提供商。从列表里选中一个 rig，这些设置会在正在运行的会话里一次性全部切换，不用重启，也不会改动你的 config.yml。关掉它，你自己的配置就原样回来。

[!TIP] /rig 是你唯一需要记住的命令。它会打开 rig 和 omp profile 的列表，在同一行显示每一项用到的模型，用方向键和 Enter 就能应用、编辑或保存。

快速开始

npx omp-rig install

它会替你运行 omp plugin install omp-rig@latest，所以需要先装好 omp；没有 omp 时安装会失败。也可以直接用 omp 安装，或者从 GitHub 安装：

omp plugin install omp-rig
omp plugin install github:amsminn/omp-rig

然后在 omp 里输入：

/rig

选择 + Save current setup as new rig，把你现在用的模型存成第一个 rig。以后改了角色，再存一个 rig，两者之间的切换就只是打开列表、按一次 Enter。如果想从零开始，+ Build new rig 会一步一步带你建好一个 rig。

工作原理

rig 会应用到三个作用域之一，越具体的越优先：session > project > global。

作用域	选择保存在哪里	持续范围
session（默认）	会话记录中的一个条目	当前会话，包括 /resume、重启和分支
project	项目目录下的 .omp/rig	在该项目中启动的每个会话
global	omp agent 目录下的 rig.active	当前 omp profile 的每个会话

rig 本身从不写进 config.yml。omp-rig 把它写入 omp 的运行时设置层，这一层叠在你的全局配置和项目配置之上，执行 /rig off 时再把它移除。rig 生效期间会遮住你的配置，但它不是你的配置：omp config get modelRoles 显示的仍然是你保存的值。

所有角色一次性替换。rig 没有列出的聊天角色会用 rig 的 default 模型，所以你的配置和上一个 rig 都不会有残留。图像、语音和网页角色保留原来配置的模型，除非 rig 明确设置了它们。

在做任何改动之前，omp-rig 会检查 rig 里的每个模型：能否解析、凭据是否可用、是否落在 rig 自己的模型池里。只要有一项不通过，就什么都不应用，并列出所有问题。

模型池按提供商强制执行：列表（Ctrl+P、/model）遵循 enabledModels，而子智能体只会被挡在 rig 之外的提供商门外。inferhub/* 这样的模式会被完整执行。inferhub/glm-5.3-flash 这种更窄的模式会在列表里隐藏其他 inferhub 模型，但子智能体按名称点名要其中某个模型时仍然能用到，/rig doctor 会就此给出警告。

在命令行设置的角色（--model、--smol、--slow、--plan，或对应的环境变量）优先于启动时应用的 rig。状态栏会把当前 rig 显示为 rig: <name>（或 profile: <name>），当你的角色和它不一致时会带上 *，比如在 /model 里另选了模型之后。

rig 存放在 ~/.omp/rigs/，所有 omp profile 共用。--profile、OMP_PROFILE、PI_CODING_AGENT_DIR 和 PI_CONFIG_DIR 都会被遵循。

Rig 文件

每个 rig 都是 ~/.omp/rigs/<name>.yml 下的一个 YAML 文件。它沿用 omp 自己的设置名，所以片段可以在 rig 和 config.yml 之间直接来回粘贴。

键	必填	含义
modelRoles	是	角色到 provider/model[:level] 的映射；必须设置 default
enabledModels	否	omp 可以列出和使用的模型模式；其他已认证的提供商会被屏蔽
disabledProviders	否	在所有路径上屏蔽的提供商，子智能体也包括在内
description	否	在列表中显示的一行说明

级别可以是 off、minimal、low、medium、high、xhigh、max 和 auto。名称必须匹配 ^[a-z0-9][a-z0-9._-]{0,63}$，list、off 这类命令词不能用作名称。出现任何其他键都会报错。

日常工作交给 Claude，硬骨头交给 Codex（~/.omp/rigs/cc.yml）：

description: Claude for everyday work, Codex for hard problems
modelRoles:
  default: anthropic/claude-sonnet-4-5:medium
  smol: anthropic/claude-haiku-4-5:low
  slow: openai/gpt-5.1-codex:xhigh
  plan: openai/gpt-5.1-codex:high
enabledModels: [anthropic/*, openai/*]

只用中国模型，通过 inferhub 提供商（~/.omp/rigs/cn.yml）：

description: Chinese models only (inferhub)
modelRoles:
  default: inferhub/glm-5.3-flash:high
  smol: inferhub/deepseek-v4.1-flash:low
enabledModels: [inferhub/*]
disabledProviders: [anthropic]

cn 生效时，Ctrl+P 和 /model 只提供 inferhub 模型，主会话和它的子智能体都无法调用 Anthropic，也无法调用模型池之外的任何其他提供商。

命令

命令	作用
/rig	打开 rig 列表
/rig <name> [--scope session|project|global]	应用一个 rig；想明确指定时用 rig:<name> 或 profile:<name>
/rig list	打开 rig 列表（没有 UI 时输出纯文本）
/rig show <name>	查看一个 rig 或 profile
/rig current	查看当前 rig、每个作用域的选择以及实际生效的角色
/rig diff	查看应用 rig 之后改动过的角色
/rig new [name]	一步步新建 rig，或把当前设置保存为 <name>
/rig edit <name>	在角色编辑器里或以 YAML 形式编辑 rig
/rig update <name>	用当前设置替换一个 rig
/rig rename <name> <new-name>	重命名 rig
/rig duplicate <name> <new-name>	复制 rig
/rig remove <name>	删除 rig
/rig off [--scope session|project|global]	在该作用域使用你自己的 omp 设置
/rig clear [--scope session|project|global]	清除该作用域的选择，让下一级作用域生效
/rig next	按字母顺序应用下一个 rig
/rig prev	应用上一个 rig
/rig doctor	对照你能用的模型检查每个 rig
/rig import <file> [name]	导入 rig 文件
/rig export <name> [file]	导出 rig 文件
/rig help	显示命令帮助

子命令、rig 名称和 --scope 的取值都有补全和行内提示，直接输入的命令在 print 和 RPC 模式下同样可用。

启动 omp 时就为会话应用一个 rig：

omp --rig cn

默认不绑定任何按键。想用快捷键轮换 rig，自己设一个即可：

omp plugin config set omp-rig cycleKey ctrl+alt+r

为什么选择 omp-rig？

• 所有角色，一次切换：rig 没写的角色会回落到它的 default 模型，你的配置和上一个 rig 都不会留下任何东西
• 不只管角色，还管模型池：把 omp 限定在你信得过的模型上，其他提供商一律屏蔽，子智能体也不例外
• 不用重启，不改配置：rig 放在设置之上的运行时层里，/rig off 立刻让你自己的设置回来
• 不会只应用一半：动手之前，每个模型都要通过匹配、凭据和模型池三项检查
• 作用域贴合你的工作方式：在一个会话里试用 rig，固定到某个项目，或者设成全局默认
• 你的 omp profile，一个 Enter 就到：现有 profile 会以 profile: 条目出现，不用离开会话就能借用它们的模型设置
• 在列表里管好一切：保存、新建、编辑、重命名、复制、导入、导出和删除 rig，都不用碰文件

---

资源

• omp：omp-rig 所接入的编程智能体
• Issues：问题反馈和功能请求
• 更新日志：每个版本的变更内容
• 许可证：MIT