GlossTrainer 是面向 Windows x64 单机游戏的游戏内工具项目。每个游戏的界面、功能适配与验证代码放在独立目录；公共构建、安装和发布工具保留在项目根目录。
使用 C++20、Dear ImGui 和 MinHook，提供支持 亮色 / 暗色主题的界面、可自定义快捷键、配置持久化和日志。可在设置中修改。游戏接口与兼容范围以各模块文档为准。
| 模块 | 说明 |
|---|---|
| BlackMythWukong | 《黑神话：悟空》的功能、安装、使用及适配说明 |
| PhantomBladeZero | 《影之刃零》内置修改器测试版，含原生调用、状态读回与亮暗 UI，部分功能待验证 |
- 作者：小莫（By: 小莫）。
- 当前版本号：各游戏独立维护，见对应模块 README；运行中的版本号显示在修改器“关于”页。
- 最新版本号：在“关于”页检查更新，或查看按游戏区分的 GitHub Releases。检查失败仅显示“检查更新失败”，不限制使用。
- 主 LICENSE：GNU GPL v3。
- 开源地址：GlossMod / GlossTrainer。
- 赞助作者：sponsor.aoe.top。
- 申请制作游戏修改器：GlossMod 委托制作。
发行包默认提供中文 README.md，另附英文 readme_en.md；两份说明均包含安装方法、功能、版本与作者信息及完整许可证。
- 游戏目录：源码、游戏适配、回归测试和专属
docs/文档；黑神话文档目录。 Scripts/：构建辅助、清单式安装 / 卸载、发行包生成和校验。.github/workflows/：Windows x64 构建、回归与 GitHub Releases 发布。docs/：跨游戏共用的发布流程等维护文档。licenses/：第三方依赖许可。
需要 Windows、Visual Studio 2022 C++ 桌面工具、Windows SDK 及 xmake。在仓库根目录配置，再构建相应模块：
xmake f -y -p windows -a x64 -m release --game=<模块名>
xmake build <模块名>输出位于 build/release/；Debug 使用 -m debug。安装方式与依赖见各模块文档。
VS Code 的 C/C++ 扩展使用仓库内的 .vscode/c_cpp_properties.json 读取 xmake 编译参数。首次配置或切换构建模式、依赖后，在仓库根目录生成本机数据库：
xmake project -k compile_commands .vscode安装 XMake 扩展后，其默认设置会在 xmake.lua 变化时自动更新数据库，也可执行 XMake: UpdateIntellisense 手动更新。compile_commands.json 含本机路径，不提交到 Git。
正式 <游戏ID>/vX.Y.Z 标签（例如 BlackMythWukong/v1.0.0）只触发对应游戏的 Debug / Release 构建、回归、打包和 Releases 发布。每个游戏独立版本；包名、校验文件、候选产物和输出目录均按游戏隔离。手动运行 workflow 时指定游戏 ID，仅构建验证。注册表、迁移规则和本地打包方式见 发布说明。
更新检查按游戏通道筛选公开 GitHub Releases，不使用仓库全局 Latest，也不自动下载安装。成功确认有新版后要求玩家自行下载；检查失败不限制使用，仅显示“检查更新失败”。
第三方许可位于 licenses，分发时请保留。各模块的运行要求、使用说明和验证范围以模块 README 为准。