141 lines
5.1 KiB
Markdown
141 lines
5.1 KiB
Markdown
# 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 使用
|
||
|
||
**必须包含的公共接口**（根据现有代码引用）：
|
||
```csharp
|
||
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 # 样式配置（已重写）
|
||
```
|
||
|
||
---
|
||
|
||
## 编译命令
|
||
|
||
```powershell
|
||
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` 等现有类
|