SETUP.md

🚀 GDExtension + llama.cpp 快速开始指南

📋 当前状态

✅ 已完成:

• Python 3.13.9 已安装
• Git 已安装
• SCons 已安装
• godot-cpp 已克隆
• GDExtension项目结构已创建
• 核心C++代码已实现（占位版本）

⚠️ 缺少:

• C++编译器（MSVC或MinGW）

🎯 两种方案选择

方案A：安装编译环境（推荐完整开发）

选项1：Visual Studio 2022 Community（推荐）

1. 下载：https://visualstudio.microsoft.com/zh-hans/downloads/
2. 安装时选择"使用C++的桌面开发"工作负载
3. 大小：约7GB

选项2：w64devkit（轻量级，1分钟安装）

1. 下载：https://github.com/skeeto/w64devkit/releases （约90MB）
2. 解压到任意位置（如 C:\w64devkit）
3. 运行 w64devkit.exe 打开终端
4. 在该终端中执行编译命令

使用w64devkit快速编译：

# 在w64devkit终端中执行
cd /e/Godot/project-naughty/addons/llama_cpp
scons platform=windows target=template_debug

方案B：使用预编译DLL（最快测试）

如果只想快速测试集成效果，我可以：

1. 提供预编译的GDExtension DLL（需要在另一台有编译器的机器编译）
2. 或使用CI/CD自动编译（GitHub Actions）

📂 项目结构说明

addons/llama_cpp/
├── godot-cpp/              # Godot C++绑定库（已克隆）
├── src/
│   ├── llama_inference.h   # 推理类头文件
│   ├── llama_inference.cpp # 推理类实现
│   ├── register_types.h    # GDExtension注册
│   └── register_types.cpp  # GDExtension注册实现
├── bin/                    # 编译输出目录（将生成DLL）
├── SConstruct             # SCons构建脚本
└── llama_cpp.gdextension  # Godot配置文件

🔨 编译步骤（有编译器后执行）

1. 编译godot-cpp绑定库

cd E:\Godot\project-naughty\addons\llama_cpp\godot-cpp
scons platform=windows target=template_debug

预计时间：5-10分钟

2. 编译GDExtension

cd E:\Godot\project-naughty\addons\llama_cpp
scons platform=windows target=template_debug

预计时间：1-2分钟

3. 测试集成

在Godot中打开项目，运行测试场景。

🧪 当前功能

即使没有链接真正的llama.cpp，当前实现已经可以：

• ✅ 在Godot中加载LlamaInference节点
• ✅ 调用 load_model() 和 infer() 方法
• ✅ 返回测试JSON数据
• ✅ 验证GDExtension集成是否正常

📝 下一步计划

1. 立即可做（无需编译器）：

   • 创建Godot测试场景
   • 测试GDScript与GDExtension的接口设计
   • 准备模型文件和测试数据

2. 编译后：

   • 集成真正的llama.cpp库
   • 实现实际推理功能
   • 性能优化

3. 完整集成：

   • 下载/编译llama.cpp为DLL
   • 链接到GDExtension
   • 完整测试

💡 建议的行动方案

如果您想快速看到效果：

推荐下载 w64devkit（1分钟安装），然后编译20分钟即可测试。

如果您想长期开发：

推荐安装 Visual Studio 2022，功能更完整。

如果您想先验证设计：

即使不编译，我们也可以先创建Godot测试场景，验证接口设计是否合理。

🔗 相关资源

• godot-cpp文档：https://docs.godotengine.org/en/stable/tutorials/scripting/gdextension/gdextension_cpp_example.html
• llama.cpp：https://github.com/ggerganov/llama.cpp
• w64devkit：https://github.com/skeeto/w64devkit

---

您想选择哪个方案？

1. 安装w64devkit快速编译
2. 安装Visual Studio完整开发
3. 先创建Godot测试场景验证设计