# RimWorld 知识库 - 绕过 Qoder IDE 使用指南

由于 Qoder IDE 中的 MCP 连接可能存在问题，我们提供了多种直接访问 RimWorld 知识库的方法。

## 🚀 方法 1：直接 Python 调用

最简单直接的方法：

```bash
# 直接查询
python direct_mcp_client.py -q "ThingDef是什么"

# 交互模式
python direct_mcp_client.py -i

# 查看帮助
python direct_mcp_client.py -h
```

### 优点：
- ✅ 最快速，无需额外依赖
- ✅ 支持交互模式
- ✅ 直接在命令行使用

## 🛠️ 方法 2：命令行工具

专业的命令行查询工具：

```bash
# 基本查询
python rimworld_query.py "ThingDef的定义"

# 保存结果到文件
python rimworld_query.py "Building类的方法" --output building_info.txt

# 显示原始结果（不格式化）
python rimworld_query.py "Pawn类" --raw

# 查看示例
python rimworld_query.py --list-examples
```

### 优点：
- ✅ 结果可保存到文件
- ✅ 支持原始输出格式
- ✅ 内置查询示例

## 📝 常用查询示例

```bash
# 查询类定义
"ThingDef的定义和用法"
"Building类有哪些方法"
"Pawn类的构造函数"

# 查询特定方法
"GenConstruct.CanPlaceBlueprintAt 方法"
"Building_Door 的开关逻辑"
"CompPower 的电力管理"

# 查询XML相关
"XML中的defName规则"
"如何定义新的ThingDef"
"建筑物的XML结构"
```

## 🔧 故障排除

### 如果出现导入错误：
```bash
# 确保在正确的目录
cd "C:\Steam\steamapps\common\RimWorld\Mods\3516260226\MCP"

# 检查 Python 环境
python -c "import mcp; print('MCP SDK 正常')"
```

### 如果查询结果为空：
- 尝试使用更具体的关键词
- 检查关键词拼写
- 使用英文类名或方法名

### 如果 Web 服务器无法启动：
- 检查端口是否被占用
- 尝试使用不同的端口号
- 确保没有其他程序占用该端口

## 💡 推荐使用场景

- **快速查询**: 使用方法 1 (direct_mcp_client.py)
- **批量处理**: 使用方法 2 (rimworld_query.py)
- **团队共享**: 使用方法 3 (web_api_server.py)
- **集成开发**: 使用 Web API 接口

## 🎯 性能优化

所有方法都已经过优化：
- 向量化处理限制在 10 个文件以内
- API 调用超时设置为 12-15 秒
- 支持本地缓存加速重复查询

现在您可以完全绕过 Qoder IDE，直接使用 RimWorld 知识库了！