oniagent/skills/oni_agent.md

name, description, version

name	description	version
oni_agent	Oxygen Not Included 完全游戏操控 — REST API + CLI 工具链，含分阶段目标/材料系统/可达性/建筑数据库	2.1.0

ONI Agent Skill — 缺氧 AI 完全操控

通过 tools/oni_api.py CLI + Mod HTTP API 完全控制游戏。每次决策前必须先 pause，所有操作自动拉视角到坐标。

一、坐标系与格子

• (0,0)=左下角，x→右，y→上，典型地图 256×384
• 建筑坐标=左下角锚点
• 通过 cell <x> <y> 查看格子：element / massKg / temperatureC / isSolid / isLiquid / isGas / isDiggable / hasBuilding / hasDuplicant
• explore <x> <y> <w> <h> AI友好区域摘要
• 可达性：复制人只能在开放空间移动，固体阻挡需挖掘，液体/气体不阻挡
• 梯子(Ladder)提供垂直移动，砖块(Tile)提供地面

二、材料系统

建筑需要特定类别材料：

• BuildableRaw = SandStone, Granite, IgneousRock, Obsidian (挖掘获得)
• Metal = Cuprite, IronOre, GoldAmalgam, Wolframite (挖掘→精炼)
• RefinedMetal = Copper, Iron, Gold, Steel (精炼生产)
• Plastic = Polypropylene (聚合压机制造)
• Glass = Glass (窑炉烧制)
• Farmable = Dirt (挖掘/堆肥)

AI 必须检查世界库存中哪些元素满足建筑的材料类别，选择存量最多的。

三、分阶段目标

Phase 1 (Cycle 1-20): 生存基础

• 氧气: OxygenDiffuser(藻类) 或 Electrolyzer(水→O₂+H₂)
• 电力: ManualGenerator → [研究PowerRegulation] → CoalGenerator
• 食物: PlanterBox×3-5 种 Mealwood (消耗Dirt)
• 卫生: Outhouse + WashBasin → [研究Plumbing] → Lavatory循环
• 科研: ResearchStation → FarmingTech先 → PowerRegulation → Plumbing
• 执行: dig 挖空间 → build IDs 建造 → research_select ID 研究

Phase 2 (Cycle 20-100): 自持系统

• SPOM: Electrolyzer+H₂发电机 → 无限O₂+部分电 (oni_builder.py build spom)
• 厕所循环: Lavatory→WaterPurifier→Lavatory (oni_builder.py build toilet_loop)
• 电力升级: 变压器(Transformer)防过载 + CoalGenerator
• 隔热: InsulationTile 包围基地
• 养殖: RanchStation + Incubator (哈奇哈奇产煤+食物)

Phase 3 (Cycle 100+): 自动化

• 液冷模块 Aquatuner+SteamTurbine
• 石油/天然气发电
• 喷泉开发
• 太空探索

四、关键建筑ID速查

ID	尺寸	材料	耗电	用途
ManualGenerator	2×2	Metal	-400W	人力发电
CoalGenerator	2×2	Metal	-600W	燃煤发电
HydrogenGenerator	2×2	Metal	-800W	燃氢发电
Electrolyzer	2×2	Metal	+120W	水→O₂+H₂
GasPump	1×2	Metal	+240W	抽气
WaterPurifier	2×2	Metal	+120W	污水净化
PlanterBox	1×1	BuildableRaw	0	种植
StorageLocker	1×1	BuildableRaw	0	储存
RationBox	2×2	BuildableRaw	0	储食
Tile	1×1	BuildableRaw	0	地板
InsulationTile	1×1	BuildableRaw	0	隔热墙
Ladder	1×1	BuildableRaw	0	梯子
PneumaticDoor	1×2	Metal	0	门
Battery	1×1	Metal	0	电池
Transformer	2×1	Metal	0	变压器
ResearchStation	2×2	BuildableRaw	+60W	初级科研
SteamTurbine	4×2	Metal	-850W	热删除+发电
Aquatuner	1×2	RefinedMetal	+1200W	液冷
Cot	1×1	BuildableRaw	0	床

五、标准操作流程

1. pause "原因"              ← 必须暂停
2. status / resources / events  ← 感知
3. explore / cell             ← 验证坐标
4. dig → build / deconstruct  ← 执行（自动拉视角）
5. events                     ← 检查结果
6. unpause 1                  ← 恢复

紧急响应: O₂<500→emergency_o2 | 食物<200k→建农场 | CO₂多→fix_co2 | 电力过载→fix_overload

六、工具速查

# 监控
oni_api.py status | resources | buildings | duplicants | rooms
oni_api.py events [since] | explore x y w h
oni_api.py cell x y | cells x y w h | slice axis idx start end
oni_api.py gas x y r
oni_api.py registry buildings|elements|techs [filter]

# 操作（自动拉视角）
oni_api.py pause "reason" [speed] | unpause [speed]
oni_api.py speed 1|2|3
oni_api.py dig x y w h | build id x y | deconstruct x y
oni_api.py prioritize x y 1-9 | research_select id | batch file
oni_api.py mop x y | harvest x y
oni_api.py camera x y [zoom] | save [name] | load name

# 分析
oni_analyzer.py | oni_commander.py diagnose
oni_commander.py emergency_o2 | fix_co2 | fix_overload | expand_base cx cy w h
oni_builder.py build spom/toilet_loop/bedroom/farm_mealwood/cooling/ranch_hatch x y