102 lines
2.3 KiB
Markdown
102 lines
2.3 KiB
Markdown
# 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 知识库了！ |