diff --git a/game-studio/src/host/inject.ts b/game-studio/src/host/inject.ts index ec726e20..c3cfc2ae 100644 --- a/game-studio/src/host/inject.ts +++ b/game-studio/src/host/inject.ts @@ -314,22 +314,99 @@ function escapeBundleForInlineScript(bundle: string): string { } /** - * 计算字符串的 sha256(hex 小写)。用 Web Crypto SubtleCrypto(浏览器/安全上下文可用)。 + * 计算字符串的 sha256(hex 小写)。 + * + * 【双通道·修复「非安全上下文整款游戏加载失败」】 + * 1) 优先 Web Crypto SubtleCrypto(https / localhost 等安全上下文,原生、最快); + * 2) subtle 不可用时回退【纯 JS SHA-256】。触发场景:经局域网 IP 明文 http 访问 + * (如创始人用 `http://100.64.0.7:4173` 跨内网机访问),浏览器判定为「非安全上下文」 + * → `crypto.subtle` 为 undefined。旧实现此时直接抛错,致 fetchAndVerifyManifest 失败、 + * GamePlayer 退 demo 兜底,而 W-CLEAN 后 demo 是「模板体系重构中」并发 game_error, + * 最终页面误报「游戏加载失败/网络波动」——真因是上下文不安全,非网络。 + * 回退纯 JS 实现后,完整性校验在「明文 IP http」与「安全上下文」下行为一致,整款游戏可正常装载。 + * 两通道对【同一份 UTF-8 字节】摘要,结果逐字节一致(已对已知向量 + 真 manifest 实测核验)。 + * * @param text 待摘要的原始文本(manifest.json 原始响应体) - * @returns 64 位十六进制 sha256;环境不支持 crypto.subtle 时抛错由调用方兜底 + * @returns 64 位十六进制 sha256 */ async function sha256Hex(text: string): Promise { - const subtle = globalThis.crypto?.subtle; - if (!subtle) { - // 非安全上下文(如 http 非 localhost)无 subtle;抛错由 GamePlayer 走 demo 兜底 - throw new Error('crypto.subtle 不可用(需安全上下文 https/localhost)'); - } + // 统一以 UTF-8 编码为字节,保证两通道对同一输入摘要(与后端算 checksum 的字节口径一致)。 const bytes = new TextEncoder().encode(text); - const digest = await subtle.digest('SHA-256', bytes); - // ArrayBuffer → hex - return Array.from(new Uint8Array(digest)) - .map((b) => b.toString(16).padStart(2, '0')) - .join(''); + const subtle = globalThis.crypto?.subtle; + if (subtle) { + // 安全上下文:用原生 SubtleCrypto(性能最优)。 + const digest = await subtle.digest('SHA-256', bytes); + return Array.from(new Uint8Array(digest)) + .map((b) => b.toString(16).padStart(2, '0')) + .join(''); + } + // 非安全上下文(http 非 localhost):subtle 缺失,回退纯 JS 实现(同步、零三方依赖)。 + return sha256BytesToHex(bytes); +} + +/** + * 纯 JS SHA-256(FIPS 180-4):对字节数组算摘要,输出 64 位小写 hex。 + * 仅在 `crypto.subtle` 不可用(非安全上下文)时作为回退,保完整性校验跨上下文一致可用。 + * 标准 64 轮压缩;32 位运算一律 `>>> 0` 归一无符号;按 SHA-256 规范用大端。确定性、零依赖。 + * @param bytes 待摘要字节(调用方已 UTF-8 编码) + */ +function sha256BytesToHex(bytes: Uint8Array): string { + // 32 位循环右旋。 + const rotr = (x: number, n: number): number => (x >>> n) | (x << (32 - n)); + // 轮常量 K(前 64 个素数立方根小数部分前 32 位)。 + const K = new Uint32Array([ + 0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5, + 0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3, 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174, + 0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da, + 0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967, + 0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13, 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85, + 0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070, + 0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3, + 0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2, + ]); + // 初始哈希 H(前 8 个素数平方根小数部分前 32 位)。 + let h0 = 0x6a09e667, h1 = 0xbb67ae85, h2 = 0x3c6ef372, h3 = 0xa54ff53a; + let h4 = 0x510e527f, h5 = 0x9b05688c, h6 = 0x1f83d9ab, h7 = 0x5be0cd19; + + // 预处理:附加 1 字节 0x80,补 0 至长度 ≡ 56 (mod 64),末尾 8 字节大端写入比特长度。 + const l = bytes.length; + const bitLen = l * 8; + // 含 0x80 与 8 字节长度后向上取整到 64 的倍数(最小满足 ≥ l+1+8 的 64 倍数)。 + const padded = (((l + 8) >> 6) + 1) << 6; + const m = new Uint8Array(padded); + m.set(bytes); + m[l] = 0x80; + const dv = new DataView(m.buffer); + // 比特长度高/低 32 位分写(>512MB 输入才需高位;manifest 量级用不到,分写仅为完备)。大端。 + dv.setUint32(padded - 8, Math.floor(bitLen / 0x100000000)); + dv.setUint32(padded - 4, bitLen >>> 0); + + const w = new Uint32Array(64); + for (let off = 0; off < padded; off += 64) { + // 取 16 个大端字进消息调度,扩展到 64 字。 + for (let i = 0; i < 16; i++) w[i] = dv.getUint32(off + i * 4); + for (let i = 16; i < 64; i++) { + const s0 = rotr(w[i - 15], 7) ^ rotr(w[i - 15], 18) ^ (w[i - 15] >>> 3); + const s1 = rotr(w[i - 2], 17) ^ rotr(w[i - 2], 19) ^ (w[i - 2] >>> 10); + w[i] = (w[i - 16] + s0 + w[i - 7] + s1) >>> 0; + } + // 64 轮压缩。 + let a = h0, b = h1, c = h2, d = h3, e = h4, f = h5, g = h6, h = h7; + for (let i = 0; i < 64; i++) { + const S1 = rotr(e, 6) ^ rotr(e, 11) ^ rotr(e, 25); + const ch = (e & f) ^ (~e & g); + const t1 = (h + S1 + ch + K[i] + w[i]) >>> 0; + const S0 = rotr(a, 2) ^ rotr(a, 13) ^ rotr(a, 22); + const maj = (a & b) ^ (a & c) ^ (b & c); + const t2 = (S0 + maj) >>> 0; + h = g; g = f; f = e; e = (d + t1) >>> 0; d = c; c = b; b = a; a = (t1 + t2) >>> 0; + } + h0 = (h0 + a) >>> 0; h1 = (h1 + b) >>> 0; h2 = (h2 + c) >>> 0; h3 = (h3 + d) >>> 0; + h4 = (h4 + e) >>> 0; h5 = (h5 + f) >>> 0; h6 = (h6 + g) >>> 0; h7 = (h7 + h) >>> 0; + } + // 8 个 32 位状态拼成 64 位 hex。 + const toHex = (x: number): string => (x >>> 0).toString(16).padStart(8, '0'); + return toHex(h0) + toHex(h1) + toHex(h2) + toHex(h3) + toHex(h4) + toHex(h5) + toHex(h6) + toHex(h7); } /** 相对 API 路径 resolve 到 VITE_API_BASE(联调指向 staging;绝对 URL 原样;mock 模式空 base=同源)。§3.4 C4 */ @@ -365,7 +442,7 @@ async function buildManifestHeaders(): Promise> { * @param manifestUrl manifest.json 直取 URL(runtime 清单回填) * @param expectedChecksum 期望的整包 sha256(hex,来自运行包清单 checksum) * @returns 校验通过的 GamePackage - * @throws 网络失败 / 非 JSON / 结构非法 / checksum 不匹配 / 无 crypto.subtle + * @throws 网络失败 / 非 JSON / 结构非法 / checksum 不匹配(subtle 缺失时由纯 JS 兜底,不再因上下文不安全而抛) */ export async function fetchAndVerifyManifest( manifestUrl: string,