gewuyou/GFramework
1
0
Fork 0
mirror of https://github.com/GeWuYou/GFramework.git synced 2026-05-09 01:54:30 +08:00
Code Issues Packages Projects Releases Wiki Activity
GFramework/tools/gframework-config-tool
History
GeWuYou 5185247c35 docs(config): 添加配置系统文档和分析器规则清单 
- 创建游戏内容配置系统详细文档，涵盖 YAML 配置、JSON Schema 结构、目录组织等
- 添加配置系统的当前能力说明，包括运行时查询、生成器支持等功能特性
- 完善 Schema 示例和 YAML 示例，提供完整的配置定义和数据样例
- 整理推荐接入模板，包含目录结构、csproj 配置、启动帮助器等最佳实践
- 补充运行时读取模板、生成查询辅助、Architecture 接入等高级使用方式
- 添加运行时校验行为说明，涵盖跨表引用、格式验证、约束检查等内容
- 提供开发期热重载功能文档，说明自动刷新运行时表的工作机制
- 创建 VS Code 工具使用指南，介绍浏览、编辑、校验等开发辅助功能
- 生成分析器规则清单文件，记录所有配置相关的诊断规则和严重级别
2026-04-17 08:47:10 +08:00
..
src
docs(config): 添加配置系统文档和分析器规则清单
2026-04-17 08:47:10 +08:00
test
docs(config): 添加配置系统文档和分析器规则清单
2026-04-17 08:47:10 +08:00
.gitignore
feat(config-tool): 添加配置验证工具和相关功能
2026-04-01 23:06:44 +08:00
.vscodeignore
feat(config-tool): 添加配置验证工具和相关功能
2026-04-01 23:06:44 +08:00
bun.lock
feat(config-tool): 添加配置验证工具和相关功能
2026-04-01 23:06:44 +08:00
LICENSE
feat(config-tool): 添加配置验证工具和相关功能
2026-04-01 23:06:44 +08:00
package.json
feat(config): 添加游戏内容配置系统和VS Code工具
2026-04-02 21:29:07 +08:00
package.nls.json
feat(config-tool): 添加 VS Code 扩展实现配置文件管理功能
2026-04-02 20:45:02 +08:00
package.nls.zh-cn.json
feat(config-tool): 添加 VS Code 扩展实现配置文件管理功能
2026-04-02 20:45:02 +08:00
README.md
feat(config): 添加游戏内容配置系统和VS Code工具
2026-04-02 21:29:07 +08:00

README.md

GFramework Config Tool

VS Code extension 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/
  • Localize extension UI text in English and Simplified Chinese, including the form preview, prompts, and notifications
  • Run lightweight schema validation for nested required fields, unknown nested fields, scalar types, scalar arrays, and arrays of objects
  • Open a lightweight form preview for nested object fields, object arrays, top-level scalar fields, and scalar arrays
  • Render existing YAML comments in the form preview and edit per-field YAML comments directly from the form
  • Jump from reference fields to the referenced schema, config domain, or direct config file when a reference value is present
  • Initialize empty config files from schema-derived example YAML
  • Batch edit one config domain across multiple files for top-level scalar and scalar-array fields
  • Surface schema metadata such as title, description, default, enum, and x-gframework-ref-table in the lightweight editors

Validation Coverage

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

  • required properties in nested objects
  • unknown properties in nested objects
  • scalar compatibility for integer, number, boolean, and string
  • scalar arrays with scalar item type checks
  • arrays of objects whose items use the same supported subset recursively
  • scalar enum constraints and scalar-array item enum constraints

Local Testing

cd tools/gframework-config-tool
bun install
bun run test

Packaging And Publishing

cd tools/gframework-config-tool
bun install
bun run package:vsix
VSCE_PAT=your_marketplace_pat bun run publish:marketplace

Current Constraints

  • Multi-root workspaces use the first workspace folder
  • Validation only covers a minimal subset of JSON Schema
  • Form preview supports object-array editing, but nested object arrays inside array items still fall back to raw YAML
  • Batch editing remains limited to top-level scalar fields and top-level scalar arrays

Workspace Settings

  • gframeworkConfig.configPath
  • gframeworkConfig.schemasPath