Skip to content

Latest commit

 

History

History
82 lines (55 loc) · 3.32 KB

README_zh.md

File metadata and controls

82 lines (55 loc) · 3.32 KB

RimMind-Actions ⚡

专为 RimWorld 1.6 & 1.7 打造的复合机制动作与战地应急自救系统

English | 简体中文

RimWorld 1.6 | 1.7 依赖: RimMind-Core 单元测试 License: MIT

为 AI 殖民者赋予战地急救、蓝图建造、农耕排程与自主战术执行能力。


📖 模块概览

RimMind-Actions 负责将大语言模型产生的高级战术与建设意图转化为稳健的多步骤游戏机制动作(Composite Mechanisms)。无论是面临战地重伤失血、突发险情,还是执行房间建造与农耕生产,殖民者都能自主发起并持续轮询复合动作直至完工。

核心特性

  • 10 大内置复合工具:
    • 生存与战地急救:actions.stabilize_rest、actions.emergency_flee、actions.eat_and_recreation、actions.triage_patient
    • 建筑与工程规划:actions.place_blueprint、actions.plan_room_project、actions.clear_area_for_build
    • 生产与农耕调度:actions.designated_harvest、actions.set_work_bill、actions.schedule_farming_cycle
  • ContinuousJobPoller 多阶段持续轮询:全程跟踪多步作业生命周期(包括 Blueprint_Build 蓝图转化为 Frame 建造框架后的持续运料与施工),直至实体建筑落成或任务取消。
  • ActionPermissionGuard 与 ResourceSafetyGuard 双重守卫:严格校验殖民者存活在图且未倒地(!Downed)、工作类型能力、危险逼近距离与殖民地物资保底红线。

🎮 实机特性展示

RimMind-Actions 实机展示 复合机制注册表与自主施工实机场景:在 F8 控制台检视全部 10 项已注册机制(pawn.draft、pawn.job、pawn.thought 等),同时殖民者在木制营房旁自主执行 place_blueprint(Bed, WoodLog) 蓝图建造任务。


🏛️ 依赖关系与设计原则

RimMind-Actions 严格单向依赖 RimMind-Core 公共 API:

flowchart LR
    Advisor["RimMind-Advisor / AI 规划器"] -->|发起高级意图| Actions["RimMind-Actions"]
    Actions -->|ActionPermissionGuard & ResourceSafetyGuard| Gate{"权限与资源安全?"}
    Gate -- 通过 --> Poller["ContinuousJobPoller 持续轮询与施工"]
    Gate -- 驳回 --> Fallback["安全取消并记录原因"]
    Actions -->|通过公共 API 注册| Core["RimMind-Core 工具注册表"]
Loading

🛠️ 安装与加载顺序

确保 RimMind-Core 位于 RimMind-Actions 之前:

1. Harmony
2. Core (RimWorld 原版)
3. RimMind-Core
4. RimMind-Actions

🧪 开发者测试指南

运行单元测试:

dotnet test RimMind-Actions/Tests/RimMindActions.Tests.csproj -c Release

📜 开源协议

本项目采用 MIT License 开源许可证。