120 lines
3.7 KiB
Markdown
120 lines
3.7 KiB
Markdown
# Resource Manifest - Godot AI Agent Project
|
||
> Truth Gate 产物 | 版本：v1 | 日期：2026-04-13
|
||
|
||
---
|
||
|
||
## Verified（已验证可用）
|
||
|
||
### 引擎与核心系统
|
||
- [x] **Godot 4.x 2D 引擎**
|
||
- 来源：官方文档 https://docs.godotengine.org/
|
||
- 验证方式：已创建并运行测试项目
|
||
- 状态：稳定，支持 CanvasItem 渲染管线
|
||
|
||
- [x] **GDScript 脚本系统**
|
||
- 来源：Godot 内置
|
||
- 验证方式：已编写 val.gd、apartment.gd 等脚本
|
||
- 状态：完整支持类、信号、状态机
|
||
|
||
- [x] **WebSocketPeer 通信**
|
||
- 来源：Godot 内置 networking 模块
|
||
- 验证方式：已实现 bridge_client.gd
|
||
- 状态：官方支持，无需第三方库
|
||
|
||
- [x] **AnimatedSprite2D + SpriteFrames**
|
||
- 来源：Godot 内置
|
||
- 验证方式：已在 val.tscn 中配置
|
||
- 状态：标准 2D 动画方案
|
||
|
||
- [x] **NavigationAgent2D 寻路**
|
||
- 来源：Godot 内置 navigation 系统
|
||
- 验证方式：已在 val.gd 中集成
|
||
- 状态：支持 2D 自动避障寻路
|
||
|
||
### 开发环境
|
||
- [x] **Python 3 + websockets 库**
|
||
- 来源：PyPI
|
||
- 验证方式：bridge_server.py 已运行
|
||
- 状态：稳定，支持异步 WebSocket 服务端
|
||
|
||
- [x] **本地 HTTP 代理 127.0.0.1:7897**
|
||
- 来源：ClashX 已配置
|
||
- 验证方式：已用于 Gmail API 调用
|
||
- 状态：可用
|
||
|
||
---
|
||
|
||
## Claimed（声称但未完全验证）
|
||
|
||
- [ ] **Godot 4.2 Mobile 渲染器稳定性**
|
||
- 声称者：项目配置
|
||
- 验证方法：需要在目标平台（macOS/Windows）长时间运行测试
|
||
- 风险：低，Mobile 渲染器是 Godot 推荐方案
|
||
|
||
- [ ] **WebSocket 高并发稳定性**
|
||
- 声称者：Python websockets 文档
|
||
- 验证方法：需要多客户端压力测试
|
||
- 风险：中低，当前单 Agent 场景负载极低
|
||
|
||
- [ ] **2.5D 伪 3D 视觉效果**
|
||
- 声称者：设计文档
|
||
- 验证方法：需要美术资源到位后验证
|
||
- 风险：中，依赖外部资源
|
||
|
||
---
|
||
|
||
## Assumed（待验证假设）
|
||
|
||
- [ ] **用户可同时运行 Godot 编辑器 + Python Bridge + OpenClaw Gateway**
|
||
- 风险：内存/CPU 占用
|
||
- 验证方案：在谷老板机器上实测
|
||
|
||
- [ ] **2D 精灵资源可由 AI 生成或找到免费素材**
|
||
- 风险：美术风格不一致
|
||
- 验证方案：尝试生成/寻找素材
|
||
|
||
- [ ] **Godot 项目可导出为独立应用**
|
||
- 风险：导出配置复杂度
|
||
- 验证方案：执行一次导出测试
|
||
|
||
---
|
||
|
||
## 信息缺口
|
||
|
||
1. **美术资源来源**：是否需要 AI 生成？购买？还是简化用几何图形？
|
||
2. **OpenClaw 集成深度**：当前 Bridge 是模拟逻辑，何时接入真实 Agent？
|
||
3. **目标平台优先级**：macOS 优先？还是跨平台同步？
|
||
4. **性能基准**：Val 角色的状态机性能要求？
|
||
|
||
---
|
||
|
||
## 依赖清单汇总
|
||
|
||
| 类别 | 项目 | 状态 | 备注 |
|
||
|------|------|------|------|
|
||
| 引擎 | Godot 4.2+ | ✅ verified | 已安装并运行 |
|
||
| 脚本 | GDScript | ✅ verified | 无需额外依赖 |
|
||
| 网络 | WebSocketPeer | ✅ verified | Godot 内置 |
|
||
| 后端 | Python 3.9+ | ✅ verified | 已运行 Bridge |
|
||
| 网络库 | websockets | ✅ verified | PyPI 安装 |
|
||
| 导航 | NavigationAgent2D | ✅ verified | Godot 内置 |
|
||
| 动画 | AnimatedSprite2D | ✅ verified | Godot 内置 |
|
||
| 美术 | 精灵资源 | ⚠️ assumed | 待补充 |
|
||
| 集成 | OpenClaw Agent | ⚠️ claimed | 当前模拟 |
|
||
|
||
---
|
||
|
||
## Truth Gate 结论建议
|
||
|
||
**技术栈可行性**：✅ 高
|
||
- 核心引擎、通信、动画系统均已验证
|
||
- 无高风险技术依赖
|
||
|
||
**关键风险**：
|
||
1. 美术资源（assumed → 需要验证）
|
||
2. OpenClaw 真实集成（claimed → 需要验证）
|
||
|
||
**建议**：
|
||
- **PASS** Truth Gate，进入设计阶段
|
||
- 标记美术资源和 OpenClaw 集成作为后续验证点
|