xrk-www-compat

name	xrk-www-compat
description	编写或审查 core/*/www 静态页、校园 WebView 兼容、HttpResponse 前端解包时使用。浏览器环境 ≠ Node 26。含普通静态与前端工程（sign.json）挂载。

Core www 浏览器兼容 + 挂载

语义权威：core/system-Core/www/xrk/modules/web-compat.js
挂载权威：docs/www-mount.md · www-app-resolve.js / mount-core-www.js
响应形状：skill xrk-http-api · HttpResponse.success

一层边界

环境	超时 / ID / 克隆	HttpResponse
Node（core/*/http、src/）	AbortSignal.timeout；xrk-node-runtime	只写响应
浏览器 www/	abortTimeout / randomId / deepClone	unwrapSuccess 或读顶层

用法（强制，与 Core 一致）

场景	做法
/xrk 控制台	import { … } from './web-compat.js'（utils.js 再导出）
其它产品 Core	只内联同语义；禁止依赖 /shared 或跨应用 /xrk/...
经典 <script>	内联，注释写「对齐 web-compat.js」

导出	浏览器勿裸用
randomId	crypto.randomUUID()
unwrapSuccess	默认 json.data.字段
abortTimeout	AbortSignal.timeout
deepClone	无降级 structuredClone

新能力：先改 web-compat.js，再同步各产品内联份。

www 两类 + 前端工程两种

	判定	行为
普通静态	无 sign	URL=/${文件夹名}，挂目录本体
前端工程①	enabled: false	只 build、不启进程，挂 dist
前端工程②	enabled: true	启进程 + 反代

详见 docs/www-mount.md。Vite base = proxy.mount。

审查

• 无裸 randomUUID / AbortSignal.timeout / 无降级 structuredClone
• 产品页未 import /shared 或 /xrk/modules/web-compat.js
• 未使用保留目录名 shared
• 有 sign.json 的工程：URL 与 proxy.mount / Vite base 一致
• tests/framework/www-web-compat.test.mjs · mount-core-www.test.mjs