oni-mcp-play-loop

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=false
• read_control domain=resources action=inventory limit=30
• read_control domain=resources action=food limit=20
• read_control domain=infrastructure action=power_summary
• read_control domain=infrastructure action=rooms
• colony_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 警报
• 蓝图/命令反复被阻塞
• 玩家给出新指示
• 下一步需要大范围挖掘、战斗、拆除、保存/读取、沙盒/调试或重大重设计
• 不确定性依赖文本地图没有表达的视觉判断

循环中的优先级

前期殖民地优先顺序：

1. 复制人安全：卡住、窒息、饥饿、危险温度。
2. 厕所和睡眠基础。
3. 食物和可收获物。
4. 机器前先确保稳定路径/地板。
5. 电力/研究必须在支撑和电线路径有效后再做。
6. 只有不会打开液体、真空、高温、菌泥或敌对空腔时才扩张。

报告格式

每轮后用简洁中文：

循环结果:
已执行:
观察到:
风险:
下一步:
状态: 已暂停 / 已继续

始终说明游戏当前是否暂停。如果循环因条件停止，说明具体停止条件。