[mrbbbaixue]

变更

• 源树与展平发布物走同一条读取路径：只要入口 metadata.xml 根节点写了 SchemaVersion，无需先构建；build/export 只负责合成单文件、解析变量与产出发布面。
• 读入口时校验 SchemaVersion（源根属性），缺失直接失败并清空 Output/；命令行删除 --schema-version=。
• 删除构建期修订标记 ContentRevision：Build 参数、CLI、发布 XSD 必填、build.sh、部署工作流传递一并移除；Tags/Commit 的 ${TIMESTAMP} 保留。
• 修复叶子存根 Source 被当成待内联正文追踪导致 URL 无限增长的问题；此前 Ubuntu CI 单元测试无进展 13 分钟后被取消，本地 Windows 因缓存路径长度限制掩盖了该问题。
• 保持完整注册键精确匹配与本地组合缓存兼容；删除兼容模式，统一语义与测试结构。
• 文档补充单入口读取说明、决策笔记与可视化预览（.agents/docs/visuals/metadata-authoring.html）。

验证

• Linux（WSL Ubuntu + .NET 10）：430 通过，10 秒完成（修复前 3 分钟无进展）。
• Windows dotnet test Metadata.sln：430 通过。
• 真实构建 Output/metadata.xml 根节点为 <Metadata SchemaVersion="1.0">，无修订属性、无 Include。
• MetadataClient.RefreshRootAsync 直读源树 Metadata/metadata.xml：Fresh，15 Mods / 3 Applications，26/26 叶子清单加载成功。
• node scripts/verify-docs.mjs 通过。

[cloudflare-workers-and-pages]

🚀 Deploying Preview to Cloudflare 🚀

Preview Deployments by commit

Status	Deployment URL	Commit	Updated (UTC)	See this deployment's details
Build: Failed ❌ View logs ↗		25f42b9	2026-11-01T16:32:42.791Z	View logs ↗

[mrbbbaixue]

第二步：Desktop仓库接入，并且实现Metadata缓存功能

[mrbbbaixue]

审查结论

能简化，但建议先修正确性问题，再合并。审查提交：25f42b91c1143444efee84ee537dd98663fbed4f。

需要修复

1. [P1] HTTP 文件去重不应忽略路径大小写

位置：MetadataFlattener.cs:445–446

Processing、Expanded 都使用 OrdinalIgnoreCase，把本地路径的比较规则带到了 HTTP URL。

已复现：入口分别 Include a.xml 和 A.xml，两份文件声明不同 Mod，结果只返回小写文件的 Mod；大写文件没有发请求。嵌套引用也可能被误判成循环。

建议：文件身份比较由源实现决定，不能在展平器里统一忽略大小写。

2. [P1] 60 秒超时没有覆盖正文读取

位置：HttpXmlSource.cs:189–192

Send 使用 ResponseHeadersRead，随后同步读取正文，没有独立超时或取消控制。此时 HttpClient.Timeout 只管到响应头，见 .NET 官方说明。

已启动实际 HTTP 服务验证：立即返回响应头，64 秒后发送 <Metadata/>，MetadataBuilder.Open 在 64.1 秒后成功返回，没有触发配置的 60 秒超时。正文持续停滞时，调用可能长期阻塞。

建议：请求与正文读取共用明确的超时预算，而不是只设置 HttpClient.Timeout。

3. [P2] 入口越界检查发生在读取之后

位置：MetadataBuilder.cs:182–194

OpenWithSource 先 LoadDocument，进入 Flatten 后才检查入口是否在 SourceRoot 内；本地分支也一样。

已复现：指定允许根为 /root/，打开 /outside.xml，程序先发一次 GET，再抛越界异常。这违反了“读取目标前拒绝”的契约，也是 LoadSource 委托新入口后引入的退化。

建议：路径规范化、确定源根和入口边界检查，都放在首次读取之前。

4. [P2] HTTP 入口仍然请求两次

位置：HttpXmlSource.cs:52–85

只有 Exists 写缓存；LoadDocument 自己读取后不写缓存，Exists 也不先查缓存。

已复现：Open 读取远端源树，入口 GET 次数为 2。不仅多一次网络开销，探测和展平还可能读到不同版本，与文档“同一 XML 只发一次 GET”不符。

建议：复用首次读取的入口文档；若保留正文缓存，让两个入口一致使用它。

最值得做的简化

范围	建议
OpenLocal / OpenWithSource	本地分支只负责还原 file:// 和创建源，之后共用同一条读取流程。发布物直接解析已读 XDocument，不要再次 LoadFromFile；源树也复用入口文档。
MetadataValidator / ValidateHard	把引用检查变成一份实现，ValidateHard 复用结果，仅保留文件存在性、显示名等构建专属检查。目前复制了登记索引和字段遍历，连 Trim 行为都已分叉。
EquivalenceBaselineTests	保留整树等价断言。删除已被全文比较覆盖的节点数、ID 集合、引用数量重复断言及辅助方法；保留构建期字段的差异检查。
PerformanceTests / ValidationTests	固定 500ms 的磁盘计时不适合作普通单测门槛。引用测试里的跨文件成功、缺失 Manifest 用例已有综合用例覆盖，可以删减。

次要缺口：新校验器漏查 Mod/Links/Link/Icon。已复现：引用不存在的图片 ID，FindMissingReferences 返回错误数仍为 0。旧 ValidateHard 也漏查，不是回归，但提取公共检查时应一起补齐，并且这条引用应检查图片登记。

另有网络层契约冲突：新 HttpXmlSource 直接创建 HttpClient，绕过仓库规定的 IMetadataTransfer。现有传输接口要求异步落盘，不能机械套用并仍宣称“纯内存不写盘”；需要明确处理这项取舍，避免留下两套互相矛盾的规则。

验证

• dotnet test Metadata.sln：372 通过，0 失败。
• 实际构建成功，检查发布物：无 Include / Includes。
• node scripts/verify-docs.mjs：通过。
• 上述大小写、越界、重复 GET、正文超时及链接图标遗漏均做了定向复现。
• 未修改原工作区；独立审查副本和临时产物已移入回收站。

[cloudflare-workers-and-pages]

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://feat-unified-metadata-reader-metadata.bakneko.workers.dev (commit b175dc1)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status	Deployment URL	Commit	Updated (UTC)	See this deployment's details
Build: Success ✅ Deployment: Success ✅ View logs ↗	https://e509648e-metadata.bakneko.workers.dev	b175dc1	2026-11-09T10:12:53.677Z	Visit the dashboard ↗
Build: Success ✅ Deployment: Success ✅ View logs ↗	https://a8888bf2-metadata.bakneko.workers.dev	ab6928e	2026-11-09T09:37:09.319Z	Visit the dashboard ↗
Build: Success ✅ Deployment: Success ✅ View logs ↗	https://212c7fc4-metadata.bakneko.workers.dev	584c730	2026-11-09T08:39:18.215Z	Visit the dashboard ↗
Build: Success ✅ Deployment: Success ✅ View logs ↗	https://c7a56f37-metadata.bakneko.workers.dev	000d880	2026-11-07T12:13:11.686Z	Visit the dashboard ↗
Build: Success ✅ Deployment: Success ✅ View logs ↗	https://4bf651f4-metadata.bakneko.workers.dev	1535580	2026-11-07T07:44:33.607Z	Visit the dashboard ↗
Build: Success ✅ Deployment: Success ✅ View logs ↗	https://69d04b43-metadata.bakneko.workers.dev	7f27be1	2026-11-07T05:07:08.424Z	Visit the dashboard ↗
Build: Success ✅ Deployment: Success ✅ View logs ↗	https://218c2414-metadata.bakneko.workers.dev	dcaa1d5	2026-11-07T03:21:27.580Z	Visit the dashboard ↗
Build: Success ✅ Deployment: Success ✅ View logs ↗	https://deb68d26-metadata.bakneko.workers.dev	4a7faa6	2026-11-07T03:13:10.861Z	Visit the dashboard ↗
Build: Success ✅ Deployment: Success ✅ View logs ↗	https://6c5d58f7-metadata.bakneko.workers.dev	dc94f47	2026-11-07T01:42:49.686Z	Visit the dashboard ↗

[mrbbbaixue]

审查后修复已推送 000d880：删除LocalId手写百分号格式拒绝，完整键scope:icon%raw与scope/icon%raw可原样匹配；删除OfflineSource无效disk参数及不可达远程raw-cache分支，保留本地Source安全边界。完整Metadata测试428/428通过；实际production根/引用与22/22独立清单、本地RisingStorm完整清单、无磁盘缓存Include组合读取和原仓库CLI Build全部通过。没有修改原始数据/XSD。