用途:为构建 Godot 项目的编码智能体提供“眼睛”,流程为捕获 → 预算化 WebP → 结构化视觉评分。它不是游戏 Autoload,也不是可导出的截图 API。
主要能力:capture.py 提供 doctor、list-windows、screen、region、window、asset、editor 子命令,输出 wrote=、bytes=、budget= 等信息。webp_encode.py 默认短边 512,--detail/--max-edge 切到长边 1568,不放大。asset_sheet.py 支持单资源或 ≤2×2 带标签接触表,并以 --project-root 解析 res://。ensure_gitignore.py 追加 .gdskills/。stage_editor_bridge.py 暂存临时插件、可选 --godot 启动、握手等待、编码与拆除。
使用方式:先安装依赖 pip install -r skills/godot-agent-vision/requirements-vision.txt(macOS 可选 pip install pyobjc-framework-Quartz),需显示会话与项目 venv。示例:python skills/godot-agent-vision/scripts/capture.py doctor;capture.py window --project-root . --title Godot;capture.py asset --project-root . --paths res://ui/icons --sheet;capture.py editor --project-root . --editor-mode 3d --godot "%GODOT_PATH%";排版/OCR 时加 --detail。默认输出 {project}/.gdskills/vision/YYYYMMDD-HHMMSS-<mode>.webp。捕获后读取 WebP,按 Taste Receptor Atlas(237 受体×0–2 分)评分并给出修复项,必要时重捕获。
适用场景:资源文件、桌面区域、Godot 窗口、整屏、编辑器 2D/3D 视口捕获与视觉质量审查。
限制:平台差异明显——Wayland 不做按标题静默抓取;Windows 独占全屏/BitBlt 可能黑帧;编辑器桥接须临时 staged 后拆除,勿提交 .gdskills/ 或 addons/_gdskills_agent_vision/。其他细节暂未提供。