让 Codex、Claude Code、Cursor 等 Agent 直接读取和操作本机运行中的 **Command: Modern Operations（CMO）**想定。
平台支持：仅限 Windows。
下载 v0.5.0 · 快速上手 · 各框架安装 · CMO Lua API
CMO Agent Bridge 将推演和想定制作中常用的 Lua API 整理成结构化 MCP 工具。Agent 可以读取战场态势、创建任务、分配兵力、规划航路和加油，也可以协助制作单位、天气与事件。 所有通信都留在本机，CMO 侧只需运行一个很短的轮询事件。
Agent 也可以直接读取 CMO 已有的 Logs\YYYY-MM-DD_HH.mm.ss.txt 消息日志。这个读取不经过 Lua，
不会改写日志目录，想定暂停时仍然可用，可用于接收剧本消息、事件结果和排查意外暂停。
进入一个想定后，Agent 会先读取想定介绍和当前玩家方的 briefing，确认战役目标、已知情报、 ROE、时间限制与胜负标准，再开始态势评估和部署；其他阵营的简报不会被读取。
大型想定会分三层读取兵力：先建立轻量单位目录，再读取 CMO 原生概览，最后只对可能投入行动的 单位深读战备、载荷和库存。这样既能看清数百个单位的整体编成，也不会把时间和上下文浪费在无关 单位的完整字段上。
当前版本是 v0.5.0 预览版。 已在 Windows、CMO Build 1868 上验证；第一次接入建议使用 想定副本。
以
LIVE_PLAYER模式连接当前想定。先汇总我方空中态势和已知威胁，再给出 CAP 调整建议， 暂时不要修改想定。
在现有两个 CAP 区中间创建一个新任务区，把所有 J-36 分配过去；完成后读回任务和分配结果。
以
SCENARIO_AUTHOR模式，为这个想定添加一个进入区域后触发的增援事件，并检查触发器、 条件和动作是否关联正确。
它适合三类工作：
| 场景 | 可以完成的工作 |
|---|---|
| 推演 | 态势评估、任务规划、兵力分配、条令与 WRA、EMCON、航路、加油、交战和时间倍率 |
| 想定制作 | 阵营、单位、任务、天气、时间线、事件、Special Action、计分和部分库存设置 |
| 测试与裁决 | 受控注入、想定检查、故障诊断和裁决记录 |
下面以 Steam 默认安装路径和 PowerShell 为例。完整的升级、卸载和自定义路径说明见 安装文档。
bridge 由 uv 管理，在 PowerShell 中执行：
winget install --id astral-sh.uv -e
uv --version需要 uv 0.11.26 或更高版本；如果已安装但版本较旧，运行
winget upgrade --id astral-sh.uv -e。uvx 会为 bridge 准备独立的 Python 3.12 环境和运行依赖。
如果没有可用的 codex CLI，下载并运行 Desktop 安装脚本：
$installer = Join-Path $env:TEMP "install-codex-desktop.ps1"
Invoke-WebRequest `
-UseBasicParsing `
-Uri "https://github.com/Nuclear2/cmo-agent-bridge/releases/download/v0.5.0/install-codex-desktop.ps1" `
-OutFile $installer
powershell.exe -NoProfile -ExecutionPolicy Bypass -File $installer脚本会把本地插件源加入 Plugins → Personal，不需要 Codex CLI。完全退出并重启 Desktop，
然后在 Personal 中打开 cmo-agent-bridge 并点击安装。插件运行 MCP 时仍需要第 1 步安装的
uv / uvx。
codex plugin marketplace add Nuclear2/cmo-agent-bridge --ref stable
codex plugin add cmo-agent-bridge@cmo-tools第二条命令也可以改为在 Codex 中打开 /plugins，从 CMO Tools 安装
cmo-agent-bridge。远程自建 marketplace 不会自动出现在官方插件目录中，必须先执行第一条命令。
stable 只会在 Release 完整发布后推进；Codex 启动时会自动检查更新，也可以运行
codex plugin marketplace upgrade cmo-tools 立即刷新。
claude plugin marketplace add Nuclear2/cmo-agent-bridge@stable
claude plugin install cmo-agent-bridge@cmo-tools --scope userClaude Code 默认关闭第三方 marketplace 的自动更新。安装后可在 /plugin → Marketplaces →
cmo-tools 中启用 auto-update；也可以手动运行
claude plugin update cmo-agent-bridge@cmo-tools --scope user。执行 /reload-plugins 或新建会话
即可载入。Codex 和 Claude 的 plugin 都同时包含 MCP 配置和完整的 operate-cmo Skill。
OpenCode、Cursor、Qoder 和通用 MCP 客户端的配置见各框架安装。这些
框架必须同时注册本地 stdio MCP Server，并安装完整的 operate-cmo Skill；MCP 协议本身不会
携带 Skill。
重启 Agent 并新建任务，然后直接告诉它：
调用
cmo_bridge_diagnose检查当前安装；如果还没准备好，用D:\Program Files (x86)\Steam\steamapps\common\Command - Modern Operations作为game_root调用cmo_bridge_prepare。
cmo_bridge_prepare 会部署与插件版本匹配的 Lua runtime，并让当前 MCP 会话里的普通工具立即
可用，不需要再次重启。CMO 安装在其他位置时，把提示中的路径换成实际路径即可。CLI 只作为
安装与故障排查时的备用入口。
插件仍固定使用同版本 wheel：
$wheel = "https://github.com/Nuclear2/cmo-agent-bridge/releases/download/v0.5.0/cmo_agent_bridge-0.5.0-py3-none-any.whl"升级已有安装时，先用旧/当前版本确认 cmo_queue_status 中 queued=0、active=0，并让 worker
完成 pending journal 收敛，再升级 plugin/wheel 和运行 prepare。新版 prepare 会在改写 Lua
runtime 前再次检查；若返回 STATE_CONFLICT，不要手工删除 journal，先回到产生该状态的版本完成
恢复。详见升级门槛。
这一步由想定作者做一次。打开想定编辑器，新建一个启用且可重复执行的 event：
- 添加 Regular Time trigger，间隔设为 1 秒；
- 添加 Lua Script action，内容为：
return ScenEdit_RunScript('CMOAgentBridge/inbox/request.lua')- 把 trigger 和 action 关联到该 event，然后保存想定。
事件随想定保存后，普通推演模式也可以直接使用 bridge。Regular Time 会在想定时间流动时处理请求。
如果想定已经暂停，Agent 可以用 cmo_simulation_pulse(handshake=true) 以 1x 短暂释放时间，完成
首次握手后自动重新暂停并恢复原倍率，不需要玩家手动配合。已建立 session binding 后，也可以在
暂停期间先排入普通写操作，再用同一工具等待队列中的未完成请求生效。
保持 CMO 和目标想定打开，告诉 Agent：
先调用
cmo_time_get_state。如果想定正在运行，直接调用cmo_bridge_status；如果已经暂停，调用cmo_simulation_pulse并设置handshake=true。告诉我当前 CMO build、runtime tag 和想定 lineage。
返回成功结果，说明 CMO 侧已经接通。暂停时的 handshake pulse 会短暂推进想定并自动复停；如果
仍然超时，检查轮询 event 是否启用且允许重复。如果 Agent 中没有出现 cmo_* 工具，检查插件与
uvx 后重启 Agent 并新建任务。
开局或阶段性重评估时，Agent 默认按下面的顺序读取己方兵力：
cmo_unit_catalog快速建立 GUID、名称和单位类型目录；cmo_unit_overview分页读取 CMO 自己生成的原生概览，先看编成、位置和粗略状态；cmo_unit_operational_status_batch及现有的战备、载荷、库存工具，只深读与当前决策有关的单位。
旧的 cmo_unit_list 仍为兼容保留，但不会再作为大型想定战前评估的默认入口。Lua-backed 读取按顺序
执行，不并发堆叠；如果某次读取卡住或超时，Agent 会先检查 CMO 是否暂停，再决定使用已有快照、短暂
释放时间刷新，或修复轮询，而不是原样重试。
v0.2.0 会把普通写操作先持久化到本地 FIFO 队列，工具立即返回
QueuedOperationReceipt。用回执中的 request_id 调用 cmo_request_get 或
cmo_request_wait 取得最终结果；cmo_request_wait 自己超时不会取消请求。
CMO 暂停时，已经提交的写操作会一直保留，恢复时间流动后按提交顺序执行。此时仍可在本机使用
cmo_request_get、cmo_request_list、cmo_queue_status，并用 cmo_request_cancel 取消尚未进入
执行阶段的 queued 请求。已经 active 的请求不能撤销，关闭 Agent 或 MCP 也不会取消它；下次启动
会继续核对和恢复。若 CMO 进程或想定已经变化，bridge 会拒绝或隔离旧请求，不会把它带到新想定。
互不依赖的修改可以连续提交，由队列保持顺序。后一步需要前一步返回的 GUID（例如先创建任务、
再分配单位）时，必须先等待创建请求 completed 并从结果中取到 GUID。读取工具仍然同步依赖 CMO
轮询；handshake pulse 只负责连接状态检查。暂停期间若还需要刷新其他态势，应先用
cmo_time_set 以 1x 运行，完成读取后再暂停。需要让已排队请求立即生效时，先用
cmo_request_list 确认队列，再把当前所有 queued 或 active 请求的 request_id 一并交给
cmo_simulation_pulse。如果遗漏任何非终态请求，pulse 会在释放时间前拒绝执行，避免意外推进
未选中的 FIFO 工作。
原生消息日志是另一条完全只读的主机侧路径。建立想定 session 和玩家阵营后，Agent 会先调用
cmo_message_log_status，再用
cmo_message_log_read(side_name=<己方精确名称>, start="now") 从当前文件尾建立游标，以后只读取新增的
己方消息；这在 CMO 暂停时也有效。只有丢失游标或首次接手时需要追溯已发生消息的显式恢复才使用
start="recent"，因为同一个 CMO 进程的日志文件可能包含之前加载过的想定内容。bridge 不会调用
SetScenarioMessageLogPath，也不会接管或搬走游戏自己的日志。
三个时间控制工具由 Windows 主机侧组织：
cmo_time_get_state读取暂停/运行状态和当前倍率；cmo_time_set幂等地暂停、恢复或选择倍率；rate_code从0到5分别表示 1x、2x、5x、 15x，以及两档粗粒度火焰模式。最高档按五秒粗粒度推进，实际速度取决于机器性能，不是固定倍率；cmo_simulation_pulse只用于已经暂停的想定。它以 1x 短暂放行，等待已列出的全部非终态 durable request 和/或握手完成，然后重新暂停并恢复原倍率；超时不会取消或重复提交请求。
cmo_time_get_state 和 cmo_time_set 的 UI 状态读取/操作不依赖 Lua 轮询；pulse 的暂停与释放动作
也在主机侧完成，但要让握手或队列请求进入终态，想定中的 Regular Time 轮询事件仍必须
正常工作。
CMO 不需要预先切到前台。时间控制使用语义 Windows UI Automation，不注入全局键盘、鼠标或 屏幕坐标。CMO/WPF 在按钮调用时仍可能短暂切到前台；bridge 会尽力恢复调用前的前台窗口， 但不承诺全程无感。多实例、无法访问的 UI 或阻塞主窗口的 modal 对话框都会使工具拒绝操作。
正常推演默认保持当前倍率，普通命令直接入队或执行，不必暂停，也不必例行降到 1x。只有想定开局 制定全局计划、阶段目标完成后的重新部署或其他复杂规划，才应由 Agent 评估后暂停；有一定时效风险 但不需要完整停表时，可以临时降到 1x，完成后恢复原倍率。pulse 仍会让想定时间短暂前进，bridge 不支持在完全冻结的游戏时间内执行 Regular Time 轮询，也不提供“零时间单步”。
Skill 会根据工作内容采用不同的信息范围：
| 模式 | 信息范围 | 适用工作 |
|---|---|---|
LIVE_PLAYER |
己方状态和己方观察到的 contacts | 正常推演、部署、交战与保障 |
SCENARIO_AUTHOR |
完整想定状态 | 制作或修改想定、事件、兵力与计分 |
UMPIRE |
获准裁决范围内的完整状态 | 测试、注入、诊断和裁决 |
日常推演使用 LIVE_PLAYER；制作想定或进行测试裁决时，再切换到相应模式。这样既能让 Agent
充分利用编辑器能力，也能保留正常推演中的情报不确定性。
Agent ── stdio / MCP ──> cmo-bridge ── 本机文件桥 ──> CMO Lua 事件
└── 只读 ──> CMO 原生 Logs
- MCP Server 提供有类型的
cmo_*工具，负责主机准备、诊断、时间控制、原生消息日志、持久写队列以及读取和修改 CMO 状态； - operate-cmo Skill 提供态势评估、作战规划、执行检查和想定制作流程；
- CLI 用于安装运行时、诊断连接和人工测试；
submit只持久化请求，request-wait才会在 没有 MCP server 时启动一个前台 worker； - Plugin 为 Codex 和 Claude Code 打包 MCP 配置与 Skill，其他框架可以直接注册标准
stdioMCP Server。
bridge 以本地 stdio 进程运行。Agent、Python 进程和 CMO Lua 运行时通过本机文件交换请求与
结果；本地 SQLite 保存 session binding 和持久 FIFO 写队列，支持暂停等待与重启恢复。
- 当前版本：
v0.5.0 Preview - 已验证环境：Windows 10/11、CMO Build 1868
- Python：3.12，由
uv隔离管理 - 许可证：MIT
这是一个非官方社区项目，与 WarfareSims、Matrix Games、Slitherine 或 CMO 的开发商、发行商
没有隶属关系。Agent 的操作会直接修改当前想定，首次使用前请保存副本；脚本执行等详细注意事项见
安全说明。
插件和 Skill 中的 CMO 图标取自游戏随附的 Command.ico；相关权利归原权利人所有，不受本项目
MIT 许可证覆盖。