feat(metadata): 核心构建展平契约、Imaging 与消费端文档 - #8
Open
mrbbbaixue wants to merge 11 commits into
Open
Conversation
固化 grill-me 决策：XML 数据展平、资源外置、纯 managed 库、 Stage A/B 发布管线、硬失败校验；并约定测试框架改用 MSTest、移除 xunit。
- 纯 managed Stage A：展平 XML、变量、硬失败校验、SchemaVersion/ContentRevision - MetadataBuilder.Load 支持 path/URL；Build 仅本地 path - Stage B WebP 拆至独立项目；主库移除 SkiaSharp - 测试迁 MSTest；补齐 RA3BattleNet+Corona 示例数据 - 更新 README/build.sh/Worker 发布说明
嵌套展开时已带 Source 的 Manifest stub 原样上浮；测试断言指向 manifests/1.5.2.0.xml 且资源内含 File 表。
同步 PLAN.md 状态与 Stage B / Build(url) 实现偏差说明。
- 项目 Ra3.BattleNet.Metadata.Imaging（SkiaSharp） - build.sh 默认仅核心构建；--webp/--publish 才 Imaging - npm: build / build:webp / build:release；wrangler 使用 build.sh --webp - 移除 RUN_STAGE_B 控制面
错误信息与 PLAN 对齐 Imaging / --webp 命名，避免 Stage 黑话。
- README：Desktop 解析流程、模块属性清单、Load/Catalog 示例 - MetadataSchema + MetadataPublishSchema；构建期源树/发布物硬失败 - SchemaValidator + SchemaTests；AGENTS.md 贡献指引
Deploying with
|
| Status | Name | Latest Commit | Updated (UTC) |
|---|---|---|---|
| ❌ Deployment failed View logs |
metadata | c3c9bbf | Jul 25 2026, 05:20 AM |
同名资源跨 Mod 通过定义文件路径前缀隔离；作用域内短名解析后写入发布物。
Imaging 独立 CLI（不进主 NuGet）；核心 build --webp 进程调用； 主包仅 managed 解析/展平，Desktop 只引用主包。
Imaging convert 单图 stdout MD5；Build(convertImages) 展平后调用并改 Source/Hash； 主包不读图库依赖。
发布契约不变：展平后无 Base/InheritFrom；Desktop 仍只读完整实体。
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
摘要
将 Metadata 仓落地为可发布、可被 Desktop 消费的契约与管线：纯 managed 核心构建、可选 Imaging WebP、双 XSD 硬校验、MSTest，以及使用方/AGENTS 文档。
主要变更
metadata.xml，资源外置 + ID 引用；SchemaVersion/ContentRevision；硬失败校验MetadataBuilder.Build（本地 path）、Load（path/url）；主库无 SkiaSharpRa3.BattleNet.Metadata.Imaging；默认不转 WebP；build.sh --webp/npm run build:release；CFwrangler显式开启MetadataSchema.xsd（源树）+MetadataPublishSchema.xsd（发布物），构建期硬校验测试计划
dotnet test Metadata.sln全绿dotnet run --project Ra3.BattleNet.Metadata -- build --src=./Metadata --dst=./Outputnpm run build:release+ Pages 预览说明