diff --git a/README.md b/README.md
index e1b078c..aa93617 100644
--- a/README.md
+++ b/README.md
@@ -7,17 +7,17 @@
 
 ```
 AI Agent (Claude/GPT/任何支持 Tool Use 的模型)
-    ↕ HTTP API (RESTful JSON, 端口 23876)  +  CLI 工具链
-ONI Mod (C# Harmony)  ←→  Python Tools
+    ↕ Python CLI (tools/oni_api.py) + HTTP API (RESTful JSON, 端口 23876)
+ONI Mod (C# Harmony)  ←→  Python Toolchain
     ↕
-Oxygen Not Included (游戏)
+Oxygen Not Included (游戏进程)
 ```
 
 ## 快速开始
 
 ### 1. 安装 Mod
 
-将 `mod/` 下的 3 个文件放入游戏的 Mod 目录：
+编译后将 `mod/` 下的 `mod.yaml` + `mod_info.yaml` + 编译产出的 `ONIAgentBridge.dll` 放入游戏 Mod 目录：
 
 ```
 Windows: %USERPROFILE%\Documents\Klei\OxygenNotIncluded\mods\local\ONIAgentBridge\
diff --git a/SKILL.md b/SKILL.md
index 76e257d..5a647be 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -53,15 +53,14 @@ hasBuilding: 有建筑 | hasDuplicant: 有复制人
 
 | 材料类别 | 包含元素 | 如何获得 |
 |----------|---------|---------|
-| **BuildableRaw** | SandStone, Granite, IgneousRock, SedimentaryRock, Obsidian, MaficRock | 挖掘 | 
-| **RawMineral** | 同上（BuildableRaw的子集） | 挖掘 |
+| **RawMineral** | SandStone, Granite, IgneousRock, SedimentaryRock, Obsidian, MaficRock | 挖掘 |
 | **Metal** | Cuprite(铜矿), IronOre(铁矿), GoldAmalgam(金汞齐), Wolframite(钨矿), Cobaltite(钴矿) | 挖掘 → 精炼 |
 | **RefinedMetal** | Copper(铜), Iron(铁), Gold(金), Steel(钢), Tungsten(钨) | 在精炼炉/金属精炼器中生产 |
 | **Plastic** | Polypropylene(塑料) | 聚合压机制造 |
 | **Glass** | Glass(玻璃) | 窑炉烧制砂→熔融玻璃→冷却 |
 | **BuildingFiber** | Reed Fiber(芦苇纤维) | 种植芦苇→收获 |
 | **Transparent** | Diamond(钻石), Glass(玻璃) | 挖掘或制造 |
-| **Farmable** | Dirt(泥土) | 挖掘或堆肥 |
+| **Farmable** | Dirt | 挖掘或堆肥 |
 
 **AI 必须理解**：造建筑时，需要查看世界库存中**有哪些元素满足该类别**。
 例如 `ManualGenerator` 需要 Material=`['Metal']`，世界库存中有 Cuprite(铜矿) 和 IronOre(铁矿)，AI 应选择存量最多的。
@@ -90,7 +89,7 @@ hasBuilding: 有建筑 | hasDuplicant: 有复制人
 **检查清单：**
 ```
 □ 手动发电机(ManualGenerator) ×1 — 提供电力
-□ 电池(Battery) ×1 — 储电
+□ 电池(Battery) ×1 — 储电(10kJ)
 □ 氧气扩散器(OxygenDiffuser) ×1 — 用藻类产氧（如有）
 □ 或电解器(Electrolyzer) + 水泵 — 用水产氧
 □ 厕所(Outhouse/Lavatory) ×1-2 — 控制污染
@@ -224,7 +223,7 @@ python tools/oni_api.py unpause 1
 | Ladder | 1×1 | BuildableRaw | 0 | 梯子 |
 | FirePole | 1×1 | Metal | 0 | 火棒 |
 | PneumaticDoor | 1×2 | Metal | 0 | 气压门 |
-| Battery | 1×1 | Metal | 0 | 电池(1000J) |
+| Battery | 1×1 | Metal | 0 | 电池(10kJ) |
 | Transformer | 2×1 | Metal | 0 | 变压器 |
 | ResearchStation | 2×2 | BuildableRaw | +60W | 初级研究 |
 | SuperComputer | 2×2 | Plastic | +120W | 高级研究 |
diff --git a/docs/AI_KNOWLEDGE_BASE.md b/docs/AI_KNOWLEDGE_BASE.md
index bd663ff..5e1cdde 100644
--- a/docs/AI_KNOWLEDGE_BASE.md
+++ b/docs/AI_KNOWLEDGE_BASE.md
@@ -110,7 +110,7 @@ AI Agent 查询用参考手册。所有 buildingId 可通过 `/api/registry/buil
 
 | 类别 | 包含元素 | 来源 |
 |------|---------|------|
-| BuildableRaw | SandStone, Granite, IgneousRock, SedimentaryRock, Obsidian, MaficRock | 挖掘 |
+| RawMineral | SandStone, Granite, IgneousRock, SedimentaryRock, Obsidian, MaficRock | 挖掘 |
 | Metal | Cuprite, IronOre, GoldAmalgam, Wolframite, Cobaltite | 挖掘 |
 | RefinedMetal | Copper, Iron, Gold, Steel, Tungsten | 精炼 |
 | Plastic | Polypropylene | 聚合压机制造 |
diff --git a/skills/oni_agent.md b/skills/oni_agent.md
index 67809ed..0eb094c 100644
--- a/skills/oni_agent.md
+++ b/skills/oni_agent.md
@@ -93,18 +93,22 @@ AI 必须检查世界库存中哪些元素满足建筑的材料类别，选择
 
 ```bash
 # 监控
-oni_api.py status | resources | events | events N
-oni_api.py explore x y w h | cell x y | cells x y w h | gas x y r
-oni_api.py registry buildings [filter]
+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 "r" | unpause [speed]
+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 camera x y [zoom] | save [name]
+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
-oni_builder.py build spom/toilet_loop/bedroom x y
+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
 ```