| name | oni-mcp-environment-summary |
| description | 当用户要求快速总结 ONI 附近环境/资源、开局区域概览、周围资源、附近危险、扩张方向,或问“我周围有什么”时使用。指导 agent 使用低 token 的只读 MCP 工具,尤其是 read_control domain=world action=area_snapshot,并返回简洁、可执行的环境/资源摘要,不执行游戏动作。 |
ONI MCP 环境摘要
目的
快速总结当前视角、选区、打印舱附近,或用户提供坐标周围的情况。这个技能只读:不要挖掘、建造、清扫、收获或修改设置。
快速路径
用最少读取回答问题:
colony_control domain=snapshot action=get profile=brief includeAtmosphere=false
navigation_control action=get_view
read_control domain=world action=area_snapshot preset=utilities encoding=plain includeScreenshot=false
如果用户提供了 areaId 或坐标,把它们传给 read_control domain=world action=area_snapshot。
如果存在玩家编辑标记请求,或用户说“框选区域/标记区域/玩家规划”,先读取:
game_control domain=ui uiDomain=edit_mark action=list limit=5
read_control domain=world action=area_snapshot areaId=<request.areaId> preset=utilities encoding=plain
何时补充细节
只有快速路径不够时才添加:
read_control domain=world action=element_summary state=solid|liquid|gas:查看世界级质量/温度上下文。
read_control domain=resources action=inventory limit=30:查看已知库存/碎片资源。
read_control domain=resources action=food limit=20:查看食物数量和千卡。
colony_control domain=bio bioDomain=farming action=list_harvestables x1/y1/x2/y2 readyOnly=false limit=80:查看附近野生植物/食物。
read_control domain=world action=text_map profile=standard encoding=plain:当 read_control domain=world action=area_snapshot 范围太小时做更大地形扫描。
除非用户要求视觉确认,否则避免截图。
地图阅读规则
先读 maps.base 或 read_control domain=world action=text_map 的 base 视图:
sol:天然固体砖;候选挖掘/资源
tile:人工砖/地基
liq:液体;如果有元素细节,说明水/污染水/盐水等
oxy/po2/co2/hyd:氧气/污染氧/二氧化碳/氢气
bld:建筑
dup:复制人
itm:散落物/碎片
unk:未知/未揭示或世界外
再读 overlay:
maps.power:电线和用电/发电设备
maps.gas_conduits、maps.liquid_conduits:现有气管/液管路线
maps.logic:自动化
maps.solid_conveyor:运输轨道
使用文本地图坐标。不要从截图推断精确格子。
摘要格式
用这些标题返回简洁中文摘要:
周围环境摘要
地形/空间:
资源:
气体/液体:
可采集/食物:
危险/限制:
扩张方向:
建议下一步:
每个标题 1-3 条。只有坐标能帮助行动时才提坐标。
分诊启发
优先关注 ONI 前期真正重要的事项:
- 可呼吸空间和二氧化碳聚集
- 附近水源或麻烦液体
- 藻类/氧石/有机固体/金属矿可用性
- 野生食物/可收获物和种子机会
- 高温、真空、菌泥/污染氧、敌对小动物、不可达空腔
- 左/右/上/下扩张质量
- 打印舱附近空间是否能变成实验室/核心基地
不确定时,说明未知点并建议一次聚焦后续扫描,不要滥用大范围工具。
安全
允许:
- 只读工具
game_control domain=ui uiDomain=edit_mark action=list
read_control domain=world action=area_snapshot
read_control domain=world action=text_map
- 库存/农业读取工具
不允许:
- 任何
orders_control、building_control、dupes_control、game_control 写入或执行动作
- 任何其他会改变游戏状态的配置/写入/执行工具
如果用户在摘要后要求动作,切换到规划/建造控制技能,并在执行前 dry-run。