Files
val-blog/ai-agent-living/docs/RESOURCE_MANIFEST.md
T

3.7 KiB
Raw Blame History

Resource Manifest - Godot AI Agent Project

Truth Gate 产物 | 版本:v1 | 日期:2026-04-13


Verified(已验证可用)

引擎与核心系统

  • Godot 4.x 2D 引擎

    • 来源:官方文档 https://docs.godotengine.org/
    • 验证方式:已创建并运行测试项目
    • 状态:稳定,支持 CanvasItem 渲染管线
  • GDScript 脚本系统

    • 来源:Godot 内置
    • 验证方式:已编写 val.gd、apartment.gd 等脚本
    • 状态:完整支持类、信号、状态机
  • WebSocketPeer 通信

    • 来源:Godot 内置 networking 模块
    • 验证方式:已实现 bridge_client.gd
    • 状态:官方支持,无需第三方库
  • AnimatedSprite2D + SpriteFrames

    • 来源:Godot 内置
    • 验证方式:已在 val.tscn 中配置
    • 状态:标准 2D 动画方案
  • NavigationAgent2D 寻路

    • 来源:Godot 内置 navigation 系统
    • 验证方式:已在 val.gd 中集成
    • 状态:支持 2D 自动避障寻路

开发环境

  • Python 3 + websockets 库

    • 来源:PyPI
    • 验证方式:bridge_server.py 已运行
    • 状态:稳定,支持异步 WebSocket 服务端
  • 本地 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 集成作为后续验证点