| 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。
审查