暂存

MCP/使用指南.md

@@ -0,0 +1,102 @@
+# 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 知识库了！