Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -174,6 +174,9 @@ jobs:
--exclude='docs/' \
--exclude='*.csproj' \
--exclude='*.sln' \
--exclude='.coderabbit.yaml' \
--exclude='.pre-commit-config.yaml' \
--exclude='INTRODUCTION.txt' \
--exclude='.gitignore' \
--exclude='.gitattributes' \
--exclude='*.md' \
Expand Down
59 changes: 58 additions & 1 deletion About/About.xml
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,64 @@
<li>1.6</li>
<li>1.7</li>
</supportedVersions>
<description>AI-powered pawn advisor. Reads each colonist's state, personality, and available work, then selects the most character-appropriate next action via LLM. [v2.0 BREAKING CHANGES]</description>
<description>[h1]RimMind - Advisor (v2.0)[/h1]
Autonomous colonist advisor, player approval workflow, and 3-round execution feedback engine. Analyzes colonist thoughts, personality traits, and macro colony crises to formulate character-consistent action proposals or execute low-risk tasks autonomously.

[b]v2.0 Clean Architecture &amp; RimWorld 1.6 / 1.7 Dual-Version Support:[/b]
[list]
[*][b]RimWorld 1.6 &amp; 1.7 (Waylith / .NET 10) Ready[/b]: Native multi-target compilation supporting both RimWorld 1.6 (.NET Framework 4.8) and RimWorld 1.7 (.NET 10 / Harmony 2.x &amp; 3.x).
[*][b]v2.0 5-Domain Autonomy &amp; Cabinet Proposals[/b]: Fine-grained per-domain autonomy policies, multi-colonist Cabinet Meeting crisis proposals, and smooth Mini-Pill HUD auto-collapse. Note: v1.x saves are not compatible with v2.0.
[*][b]3-Round Execution Feedback Loop[/b]: Tracks tool execution outcomes and player approval/rejection history across up to 3 feedback cycles so the AI learns your command preferences.
[/list]

[h2]What Is RimMind[/h2]
RimMind is an enterprise-grade, AI-powered RimWorld mod suite. Integrated with Large Language Models (LLM), it transforms colonists into self-reflecting agents with distinct personalities, three-tier memories, natural spoken dialogues, autonomous mechanisms, and dynamic storytelling.

[h2]Sub-mod List &amp; Dependency Relationships[/h2]
[table]
[tr][th]Mod[/th][th]Responsibility[/th][th]Dependencies[/th][th]GitHub[/th][/tr]
[tr][td]RimMind-Core[/td][td]LLM runtime, 4-Zone context engine, async queue, ToolCall registry &amp; F8 Hub[/td][td]Harmony[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Core]Link[/url][/td][/tr]
[tr][td]RimMind-Actions[/td][td]Composite ToolCall mechanisms, battlefield triage &amp; autonomous construction[/td][td]Core[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Actions]Link[/url][/td][/tr]
[tr][td][b]RimMind-Advisor[/b][/td][td]Colonist self-reflective advice cards, 5-domain autonomy &amp; player approval[/td][td]Core, Actions[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Advisor]Link[/url][/td][/tr]
[tr][td]RimMind-Dialogue[/td][td]Contextual spoken dialogue via express_dialogue ToolCall &amp; speech bubbles[/td][td]Core[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Dialogue]Link[/url][/td][/tr]
[tr][td]RimMind-Memory[/td][td]3-Tier cognitive memory hierarchy, work aggregation &amp; temporal decay[/td][td]Core[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Memory]Link[/url][/td][/tr]
[tr][td]RimMind-Personality[/td][td]Big-Five psychological profiles, dawn monologues &amp; dynamic mood thoughts[/td][td]Core[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Personality]Link[/url][/td][/tr]
[tr][td]RimMind-Storyteller[/td][td]AI Story Director, dramatic tension curve, chained arcs &amp; Storyteller Altar[/td][td]Core, Memory[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Storyteller]Link[/url][/td][/tr]
[tr][td]RimMind-Extension-ModelService[/td][td]Multi-provider routing, Anthropic KV cache, local gateways &amp; load balancing[/td][td]Core[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Extension-ModelService]Link[/url][/td][/tr]
[tr][td]RimMind-Bridge-RimChat[/td][td]RimChat compatibility bridge: dialogue/action mutual exclusion &amp; context sync[/td][td]Core, RimChat[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Bridge-RimChat]Link[/url][/td][/tr]
[tr][td]RimMind-Bridge-RimTalk[/td][td]RimTalk compatibility bridge: bubble harmonization &amp; bidirectional context[/td][td]Core, RimTalk[/td][td][url=https://github.com/RimWorld-RimMind-Mod/RimWorld-RimMind-Mod-Bridge-RimTalk]Link[/url][/td][/tr]
[/table]
[code]Core ──┬── Actions ── Advisor
├── Dialogue
├── Memory ── Storyteller
├── Personality
├── Extension-ModelService
├── Bridge-RimChat
└── Bridge-RimTalk[/code]

[h2]Core Features[/h2]
[list]
[*][b]5-Domain Autonomy Governance[/b] - Configure [i]Disabled[/i], [i]RequireApproval[/i], or [i]FullAutonomous[/i] across 5 operational domains: [i]EmergencySurvival, ResourceMarking, WorktableBills, BlueprintPlacement, HighRiskOperations[/i].
[*][b]Interactive Approval Cards &amp; Mini-Pill Collapse[/b] - Proposals appear in a clean, zoomable floating HUD card with colonist reasoning, urgency badges, and [b][Approve][/b] / [b][Reject][/b] controls, collapsing into an unobtrusive mini-pill when idle.
[*][b]ColonyMacroPerceiver &amp; Cabinet Meetings[/b] - Detects colony-wide food shortages, medical emergencies, defense gaps, and mood crises, convening multi-colonist Cabinet Proposals with executable action plans.
[*][b]Thought-Driven Decision Pipeline[/b] - Receives psychological Thought events from [code]RimMind-Personality[/code] and [code]RimMind-Dialogue[/code] via Core's loose-coupled event bus, turning inner monologues into concrete actions.
[*][b]Pawn Lifecycle Safety[/b] - Automatically cancels pending proposals and cleans up state if a colonist is downed, kidnapped, or killed.
[/list]

[h2]Advisor Decision Workflow[/h2]
[list]
[*][b]1. State &amp; Thought Perception[/b] - Synthesizes pawn mood, skills, health, nearby work candidates, and macro colony alerts.
[*][b]2. LLM ToolCall Reasoning[/b] - Selects character-appropriate mechanisms from [code]RimMind-Core[/code] and [code]RimMind-Actions[/code].
[*][b]3. Risk &amp; Policy Resolution[/b] - [code]AdvisorToolRiskResolver[/code] checks domain autonomy rules to either execute immediately or queue for player approval.
[*][b]4. Execution &amp; 3-Round Feedback[/b] - Monitors completion and injects outcome feedback into subsequent advisor cycles.
[/list]

[h2]Frequently Asked Questions[/h2]
[b]Q: Will the AI perform dangerous actions without my permission?[/b]
A: No. High-risk operations default to [i]RequireApproval[/i], presenting a floating proposal card so you stay in full command.

[b]Q: Does Advisor work better with Personality and Memory?[/b]
A: Yes! [code]RimMind-Personality[/code] supplies Big-Five psychological traits and inner thoughts, while [code]RimMind-Memory[/code] provides long-term historical context for deeply consistent roleplay decisions.</description>
<modDependencies>
<li>
<packageId>brrainz.harmony</packageId>
Expand Down
2 changes: 2 additions & 0 deletions Languages/ChineseSimplified/Keyed/RimMind_Advisor.xml
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,8 @@
<RimMind.Advisor.Settings.EnableRiskApproval.Desc>开启后,达到风险等级阈值的动作会被自动拦截,需玩家批准后才执行。</RimMind.Advisor.Settings.EnableRiskApproval.Desc>
<RimMind.Advisor.Settings.AutoBlockRiskLevel>自动拦截风险等级阈值:{0}</RimMind.Advisor.Settings.AutoBlockRiskLevel>
<RimMind.Advisor.Settings.AutoBlockRiskLevel.Desc>达到此风险等级的动作会被自动拦截,需玩家批准后才执行。</RimMind.Advisor.Settings.AutoBlockRiskLevel.Desc>
<RimMind.Advisor.Settings.Section.ColonistFilter>殖民者独立托管开关</RimMind.Advisor.Settings.Section.ColonistFilter>
<RimMind.Advisor.Settings.ColonistFilter.Tip>取消勾选即可忽略该殖民者,AI 顾问将不会自动为其分配行动。</RimMind.Advisor.Settings.ColonistFilter.Tip>
<!-- CompAIAdvisor.cs -->
<!-- Gizmo -->
<RimMind.Advisor.UI.Gizmo.Enabled>AI顾问:开启</RimMind.Advisor.UI.Gizmo.Enabled>
Expand Down
2 changes: 2 additions & 0 deletions Languages/English/Keyed/RimMind_Advisor.xml
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,8 @@
<RimMind.Advisor.Settings.EnableRiskApproval.Desc>When enabled, actions at or above the risk threshold are automatically blocked and require player approval.</RimMind.Advisor.Settings.EnableRiskApproval.Desc>
<RimMind.Advisor.Settings.AutoBlockRiskLevel>Auto-block risk level threshold: {0}</RimMind.Advisor.Settings.AutoBlockRiskLevel>
<RimMind.Advisor.Settings.AutoBlockRiskLevel.Desc>Actions at or above this risk level are automatically blocked and require player approval.</RimMind.Advisor.Settings.AutoBlockRiskLevel.Desc>
<RimMind.Advisor.Settings.Section.ColonistFilter>Per-Colonist AI Advisor Control</RimMind.Advisor.Settings.Section.ColonistFilter>
<RimMind.Advisor.Settings.ColonistFilter.Tip>Uncheck to ignore this colonist so AI Advisor will not automatically assign actions to them.</RimMind.Advisor.Settings.ColonistFilter.Tip>
<!-- CompAIAdvisor.cs -->
<!-- Gizmo -->
<RimMind.Advisor.UI.Gizmo.Enabled>AI Advisor: On</RimMind.Advisor.UI.Gizmo.Enabled>
Expand Down
7 changes: 5 additions & 2 deletions Source/Advisor/AdvisorCycleCoordinator.cs
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@
}

_lastRequestTick = -9999;
RimMindAPI.ClearModCooldown(AdvisorRequestIds.RequestModId);

Check warning on line 101 in Source/Advisor/AdvisorCycleCoordinator.cs

View workflow job for this annotation

GitHub Actions / test / test

'RimMindAPI.ClearModCooldown(string)' is obsolete: 'Use RimMindAPI.Request.ClearModCooldown instead.'
Log.Message($"[RimMind-Advisor] ForceRequest: Core-layer cooldown cleared ({AdvisorRequestIds.RequestModId}), sending request...");
RequestAdvice(Settings);
}
Expand Down Expand Up @@ -153,8 +153,11 @@

if (toolCalls == null || toolCalls.Count == 0)
{
RimMindErrors.Warn(
$"[RimMind-Advisor] No actionable response for {_pawn.Name.ToStringShort} (no tool_calls, content unparseable)");
if (!isFeedbackResponse)
{
RimMindErrors.Warn(
$"[RimMind-Advisor] No actionable response for {_pawn.Name.ToStringShort} (no tool_calls, content unparseable)");
}
CompleteRequestCycle(taskDriver, requestCycle);
return;
}
Expand Down
Loading
Loading