xrk-www-compat

name	xrk-www-compat
description	编写或审查 core/*/www 静态页、校园 WebView 兼容、HttpResponse 前端解包时使用。浏览器环境 ≠ Node 26。

Core www 浏览器兼容（底层标准）

语义权威：core/system-Core/www/xrk/modules/web-compat.js
挂载：mountCoreWwwStatic（src/infrastructure/http/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	只内联同语义（psyche / xiaozhi 已如此）；禁止依赖 /shared 或跨应用 /xrk/...
经典 <script>	内联，注释写「对齐 web-compat.js」

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

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

www 目录名

• 必须：core/<core>/www/<应用名>/
• 保留根名（RESERVED_ROOT_SEGMENTS）：api、core、media、uploads、File、shared
• 产品静态用自有名（例：www/lsy-shared → /lsy-shared）
• 同名根路径：先挂占用，后挂 warn 跳过

审查

• 无裸 randomUUID / AbortSignal.timeout / 无降级 structuredClone
• 产品页未 import /shared 或 /xrk/modules/web-compat.js
• 未使用保留目录名 shared
• tests/framework/www-web-compat.test.mjs