feat: complete ONI Agent project with full Mod API, Python toolchain, and development guide

- Implement all Mod API endpoints (buildings, research, geysers, alerts, critters, deconstruct, prioritize, research, schedule, wardrobe)
- Enhance Python tools with comprehensive CLI, analysis (O2/food/power/temp/water), and 7 blueprints (SPOM, toilet, ranch, farm, cooling, bedroom)
- Add utility scripts: auto_repair, auto_analyze, watch mode, setup
- Write Agent-Mod integration constraints and development guide
- Create skills directory with ONI agent skill definition
This commit is contained in:
root
2026-05-22 08:44:56 +08:00
commit 0e17e8a6ac
14 changed files with 1579 additions and 0 deletions

42
skills/oni_agent.md Normal file
View File

@ -0,0 +1,42 @@
# ONI Agent Skill
## 触发条件
- 用户提到《缺氧》/ Oxygen Not Included / ONI
- 用户询问游戏策略、建造方案、资源管理
- 用户希望 Mod 工具链执行操作
## 能力
1. 通过 `tools/oni_api.py` 查询游戏状态
2. 通过 `tools/oni_analyzer.py` 分析并生成建议
3. 通过 `tools/oni_builder.py` 执行蓝图建造
4. 通过 `scripts/auto_repair.sh` 诊断连接问题
5. 通过 `scripts/watch.sh` 持续监控
## 常用操作
```bash
# 检查连接
python3 tools/oni_api.py health
# 游戏总览
python3 tools/oni_api.py status
# 分析报告
python3 tools/oni_analyzer.py
# 查看蓝图
python3 tools/oni_builder.py list
# 建造 SPOM (SPOM = Self-Powered Oxygen Module)
# 偏移坐标 (origin_x, origin_y) 为模块左下角
python3 tools/oni_builder.py build spom 15 10
# 持续监控(每 60 秒刷新)
bash scripts/watch.sh 60
```
## 核心知识
- SPOM:电解制氧 + 氢气发电闭环
- 卫生间水循环:卫生间 → 净水器 → 卫生间
- 冷却系统:液冷机 + 蒸汽机 + 导热管
- 养殖模块:哈奇/滑鳞/飞鱼