GeWuYou e8d0ea2daf feat(game): 添加游戏内容配置系统和VS Code扩展
- 引入基于YAML和JSON Schema的静态内容配置系统
- 实现运行时只读查询和Source Generator支持
- 提供VS Code扩展用于配置浏览、验证和轻量编辑
- 支持开发期热重载和跨表引用校验功能
- 包含完整的文档说明和工具链集成
2026-03-31 22:44:58 +08:00

1.2 KiB

GFramework Config Tools

Minimal VS Code extension scaffold for the GFramework AI-First config workflow.

Current MVP

  • Browse config files from the workspace config/ directory
  • Open raw YAML files
  • Open matching schema files from schemas/
  • Run lightweight schema validation for required fields, unknown top-level fields, scalar types, and scalar array items
  • Open a lightweight form preview for top-level scalar fields

Validation Coverage

The extension currently validates the repository's minimal config-schema subset:

  • required top-level properties
  • unknown top-level properties
  • scalar compatibility for integer, number, boolean, and string
  • top-level scalar arrays with scalar item type checks

Nested objects and complex arrays should still be reviewed in raw YAML.

Local Testing

cd tools/vscode-config-extension
node --test ./test/*.test.js

Current Constraints

  • Multi-root workspaces use the first workspace folder
  • Validation only covers a minimal subset of JSON Schema
  • Form editing currently supports top-level scalar fields only
  • Arrays and nested objects should still be edited in raw YAML

Workspace Settings

  • gframeworkConfig.configPath
  • gframeworkConfig.schemasPath