WulaFallenEmpireRW/Tools/task_handoff.md

WulaLink 任务交接文档

当前状态：需要创建 AIIntelligenceCore.cs

背景

WulaLink 是一个 RimWorld Mod 中的 AI 对话系统，包含两个 UI：

1. 大 UI (Dialog_AIConversation) - 全屏对话窗口
2. 小 UI (Overlay_WulaLink) - 悬浮对话窗口

已完成的操作

1. ✅ 恢复了 Dialog_AIConversation.cs 为旧版自包含版本（从备份文件 Tools/using System;.cs 复制）
2. ✅ 删除了损坏的 AIIntelligenceCore.cs
3. ✅ 重写了 WulaLinkStyles.cs（颜色主题配置）

当前编译错误

error CS0246: 未能找到类型或命名空间名"AIIntelligenceCore"

以下文件引用了 AIIntelligenceCore：

• Overlay_WulaLink.cs (第13行, 第94行)
• Overlay_WulaLink_Notification.cs (第89行)
• Tool_ChangeExpression.cs (第24行)
• Tool_GetRecentNotifications.cs (第113行)

---

需要完成的任务

任务：创建 AIIntelligenceCore.cs

路径: Source/WulaFallenEmpire/EventSystem/AI/AIIntelligenceCore.cs

要求：

1. 必须是 WorldComponent，类名 AIIntelligenceCore
2. 提供 static Instance 属性供外部访问
3. 从 Dialog_AIConversation（备份文件 Tools/using System;.cs）提取 AI 核心逻辑
4. 暴露事件/回调供 UI 使用

必须包含的公共接口（根据现有代码引用）：

public class AIIntelligenceCore : WorldComponent
{
    // 静态实例
    public static AIIntelligenceCore Instance { get; private set; }
    
    // 事件回调
    public event Action<string> OnMessageReceived;
    public event Action<bool> OnThinkingStateChanged;
    public event Action<int> OnExpressionChanged;
    
    // 公共属性
    public int ExpressionId { get; }
    public bool IsThinking { get; }
    
    // 公共方法
    public void InitializeConversation(string eventDefName);
    public List<(string role, string message)> GetHistorySnapshot();
    public void SetExpression(int id);  // 供 Tool_ChangeExpression 调用
    public void SendMessage(string text);  // 供小 UI 调用
}

参考代码：

• 备份文件 Tools/using System;.cs 包含完整的 AI 逻辑（1549行）
• 核心方法包括：
  • RunPhasedRequestAsync() - 3阶段请求处理
  • ExecuteXmlToolsForPhase() - 工具执行
  • BuildToolContext() / BuildReplyHistory() - 上下文构建
  • ParseResponse() - 响应解析
  • GetSystemInstruction() / GetToolSystemInstruction() - 提示词生成

---

关键文件路径

C:\Steam\steamapps\common\RimWorld\Mods\3516260226\
├── Tools\
│   └── using System;.cs          # 旧版 Dialog_AIConversation 备份（包含完整 AI 逻辑）
└── Source\WulaFallenEmpire\EventSystem\AI\
    ├── AIIntelligenceCore.cs     # 【需要创建】
    ├── AIHistoryManager.cs       # 历史记录管理
    ├── AIMemoryManager.cs        # 记忆管理
    ├── SimpleAIClient.cs         # API 客户端
    ├── Tools\                    # AI 工具目录
    │   ├── Tool_SpawnResources.cs
    │   ├── Tool_SendReinforcement.cs
    │   └── ... (其他工具)
    └── UI\
        ├── Dialog_AIConversation.cs   # 大 UI（已恢复）
        ├── Overlay_WulaLink.cs        # 小 UI（需要修复引用）
        ├── Overlay_WulaLink_Notification.cs
        └── WulaLinkStyles.cs          # 样式配置（已重写）

---

编译命令

dotnet build C:\Steam\steamapps\common\RimWorld\Mods\3516260226\Source\WulaFallenEmpire\WulaFallenEmpire.csproj

---

架构说明

目标架构

┌─────────────────────────────────────┐
│         AIIntelligenceCore          │  ← WorldComponent (核心逻辑)
│  - 历史记录管理                      │
│  - AI 请求处理 (3阶段)               │
│  - 工具执行                          │
│  - 表情/状态管理                     │
└──────────────┬──────────────────────┘
               │ 事件回调
    ┌──────────┴──────────┐
    ▼                     ▼
┌─────────────┐    ┌──────────────┐
│ Dialog_AI   │    │ Overlay_     │
│ Conversation│    │ WulaLink     │
│ (大 UI)     │    │ (小 UI)      │
└─────────────┘    └──────────────┘

关键点

1. Dialog_AIConversation 目前是自包含的（既有 UI 也有 AI 逻辑）
2. Overlay_WulaLink 需要通过 AIIntelligenceCore 获取数据
3. 两个 UI 可以共享同一个 AIIntelligenceCore 实例

---

注意事项

1. 不要使用 PowerShell Get-Content 读取文件 - 会显示乱码，请使用 view_file 工具
2. 备份文件编码正常 - Tools/using System;.cs 可以正常读取
3. 命名空间：WulaFallenEmpire.EventSystem.AI
4. 依赖项：需要引用 SimpleAIClient、AIHistoryManager、AITool 等现有类