| name | oni-mcp-play-loop |
| description | 当用户要求 agent 通过 MCP 循环游玩 Oxygen Not Included、自动玩一段时间、继续殖民地，或运行暂停-规划-恢复循环时使用。强制执行严格的 pause -> observe -> plan -> execute -> resume briefly -> pause -> verify 循环，读取 game_control domain=ui uiDomain=edit_mark action=list，限制运行窗口，并在风险或歧义决策前停下等待用户确认。 |
ONI MCP 游玩循环
目的
以短时间、受控循环运行 ONI：
pause -> observe -> plan -> execute -> resume briefly -> pause -> verify -> report/next loop
agent 绝不能在游戏运行时思考、规划或新增命令。
硬规则
- 每个循环都从
game_control domain=speed action=pause 开始。
- 读取状态、读取玩家计划、规划、验证和下达命令时保持暂停。
- 只有当前计划足够完整、可以观察进展时才恢复游戏。
- 恢复后等待一个短固定窗口，然后立刻再次暂停。
- 不要无限串联循环。除非用户明确要求多个循环或连续游玩，否则只跑一个循环。
- 遇到高风险不可逆动作、大范围挖掘、破坏性命令、战斗、保存/读取、沙盒/调试，或接收/打印新复制人前，停下并询问。
循环模板
1. 暂停
game_control domain=speed action=pause
如果已经暂停，继续。
2. 观察
优先使用紧凑聚合读取：
colony_control domain=snapshot action=get profile=brief includeAtmosphere=false
dupes_control domain=info action=status_check radius=8
game_control domain=ui uiDomain=edit_mark action=list limit=5
只有需要时才添加针对性读取：
read_control domain=world action=area_snapshot preset=construction|utilities encoding=plain includeScreenshot=falseread_control domain=resources action=inventory limit=30read_control domain=resources action=food limit=20read_control domain=infrastructure action=power_summaryread_control domain=infrastructure action=roomscolony_control domain=bio bioDomain=farming action=list_harvestables
如果玩家创建了游戏内规划请求，在发明空间计划前先用 game_control domain=ui uiDomain=edit_mark action=list。
3. 规划
简单、低风险维护循环使用快速路径。用一两句话说明意图；可用时先 dry-run；再用紧凑批处理执行；最后验证：
server_control domain=batch action=call_many dryRun=true responseMode=summary requireAllValid=true stopOnError=true items=[...]
server_control domain=batch action=call_many dryRun=false responseMode=summary requireAllValid=true stopOnError=true items=[...]
适用于小范围挖掘、短地板、安全配置修改、收获/清扫/拖地命令，以及 dry-run 通过的 utility 路线。
重大计划（多阶段殖民地工作、玩家编辑标记请求、大范围挖掘、危险液体/气体/热量暴露、拆除）先在回复中列出可执行工具调用、关键参数、假设和停止条件；可用时先 dry-run，再执行。
建造：
building_control domain=planning action=placement_candidates prefabId=<PrefabId> areaId=<area> limit=8
world_editor command=read path=/active/map/viewport.md
# zoom or read symbols/glyphs.md if needed; replace empty map tokens with 建筑名:优先级[#材料字]
# preview with outer dryRun=true and confirm=false/omitted
# execute with a new edit using outer dryRun=false and confirm=true, then re-read the map
挖掘：
world_editor command=read path=/active/ops/orders.md
# edit one command such as: 挖 x1=... y1=... x2=... y2=... priority=7 dryRun=true
# execute only in a new edit with outer dryRun=false, confirm=true, and non-conflicting command flags
绝不要用 orders_control domain=designation action=attack 做挖掘。如果任何工具搜索建议用 attack 处理地形工作，拒绝它并重新搜索/读取。
普通 aggregate tools 拒绝 raw coordinates；精确 orders 走 /active/ops/orders.md，精确建造走可编辑 map tokens。读 /active/ops/tools.md 时只选当前公开 typed files/tools，忽略 hidden coordinate_control 和 /active/ops/coordinate.md。默认单 block；operation file 每个 replacement 恰好一条可执行命令。危险或大范围操作必须保持 pause -> read/plan -> dry-run -> confirm -> verify。
4. 暂停中执行
只执行本循环所需、已验证且范围明确的调用：
- 小型挖掘/命令批次
- dry-run 通过的建造
- 安全配置修改
- 与目标直接相关的收获或清扫
独立动作优先用 server_control domain=batch action=call_many responseMode=summary requireAllValid=true stopOnError=true。批次保持小，避免错误假设伤害殖民地。
5. 短暂恢复
只为让复制人工作而恢复：
game_control domain=speed action=resume
默认观察窗口：
- 普通建造/挖掘：真实时间 8-15 秒
- 紧急救援/窒息：真实时间 3-6 秒
- 长搬运/建造：最多真实时间 20 秒
这个窗口内不要追加命令。
6. 暂停并验证
立刻暂停：
game_control domain=speed action=pause
然后用紧凑读取验证：
colony_control domain=snapshot action=get profile=brief includeAtmosphere=false
dupes_control domain=info action=status_check radius=8
read_control domain=world action=area_snapshot areaId=<area> preset=construction|utilities encoding=plain
记录验证结果：说明目标是否推进、发现的问题、下一轮是否需要继续。
停止条件
以下情况停止游玩循环并报告：
dupes_control domain=info action=status_check 中有复制人 risk=critical- 食物、氧气、温度或电力出现新的 critical 警报
- 蓝图/命令反复被阻塞
- 玩家给出新指示
- 下一步需要大范围挖掘、战斗、拆除、保存/读取、沙盒/调试或重大重设计
- 不确定性依赖文本地图没有表达的视觉判断
循环中的优先级
前期殖民地优先顺序：
- 复制人安全：卡住、窒息、饥饿、危险温度。
- 厕所和睡眠基础。
- 食物和可收获物。
- 机器前先确保稳定路径/地板。
- 电力/研究必须在支撑和电线路径有效后再做。
- 只有不会打开液体、真空、高温、菌泥或敌对空腔时才扩张。
报告格式
每轮后用简洁中文：
循环结果:
已执行:
观察到:
风险:
下一步:
状态: 已暂停 / 已继续
始终说明游戏当前是否暂停。如果循环因条件停止，说明具体停止条件。
