oniagent/SKILL.md

Oxygen Not Included (ONI) Agent

职责

协助玩家操作和管理游戏"缺氧"(Oxygen Not Included)，提供游戏知识、策略建议，并通过 Mod API 直接操控游戏。

通信方式

• Mod 在游戏内启动 HTTP 服务，暴露 RESTful API
• 通过 http://127.0.0.1:PORT 与游戏通信
• 端口在 oni-agent/config.json 中配置（默认 23876）

可用 API 端点

状态查询 (GET)

端点	返回内容
/api/state/game	周期、复制人数量、全局资源
/api/state/resources	所有主要资源存量
/api/state/duplicants	所有复制人状态
/api/state/buildings	所有建筑列表
/api/state/research	科技树进度
/api/state/geysers	喷泉状态
/api/state/alert	当前警报
/api/state/critters	小动物状态

操作 (POST)

端点	请求体
/api/action/dig	{x, y, width, height}
/api/action/build	{buildingId, x, y, rotation?}
/api/action/deconstruct	{buildingId, x, y}
/api/action/prioritize	{x, y, priority}
/api/action/research	{techId}
/api/action/schedule	{duplicantId, schedule}
/api/action/wardrobe	{duplicantId, equipment}

工具列表

工具	用途
tools/oni_api.py	与 Mod HTTP API 通信
tools/oni_analyzer.py	分析游戏状态、生成建议
tools/oni_builder.py	蓝图/建造规划
scripts/auto_repair.sh	诊断连接问题
scripts/auto_analyze.sh	一键拉取状态+分析
scripts/watch.sh	持续监控模式
scripts/setup.sh	环境初始化

使用方式

# 检查游戏连接
python3 tools/oni_api.py health

# 获取游戏状态概览
python3 tools/oni_api.py status

# 列出所有资源
python3 tools/oni_api.py resources

# 分析并生成建议
python3 tools/oni_analyzer.py

# 查看可用蓝图
python3 tools/oni_builder.py list

# 执行建造计划
python3 tools/oni_builder.py build spom 15 10

# 持续监控（每 60 秒）
bash scripts/watch.sh 60

# 诊断连接
bash scripts/auto_repair.sh

核心游戏知识

生存优先级

1. 氧气 — 电解器 > 藻类制氧（前期过渡）
2. 食物 — 浆果 > 烤肉 > 营养膏
3. 温度控制 — 液冷 + 蒸汽机
4. 电力 — 氢气发电 > 煤炭 > 手动
5. 水资源管理 — 净水器、污水过滤

常用布局

• SPOM (Self-Powered Oxygen Module): 电解制氧 + 氢气发电闭环
• 卫生间水循环: 卫生间 → 净水器 → 卫生间
• 冷却系统: 液冷 + 蒸汽机 + 导热管
• Ranch 模块: 养殖哈奇/滑鳞/飞鱼

关键事件预警

• 氧气不足 (< 500g/tile) → 增加制氧
• 温度超标 (> 40°C 或 < -10°C) → 增加温控
• 食物短缺 (< 5 周期余量) → 扩大种植/养殖
• 电力不足 → 增加发电或减少负载
• 污水满溢 → 增加净水/扩大存储