/** * 《声命线》无头试玩仿真测试(docs/design/13-playtest-criteria.md §1 + §7)。 * * 方案: * - mock 浏览器环境:window/localStorage/navigator/fetch/AudioContext * (decodeAudioData 返回固定 duration 的假 buffer;fetch 直接读真实资产目录, * 缺失资产走引擎 console.error 静默路径); * - 使用**真实** engine/audio.js + settings.js(voice 链靠引擎 endTimer + * onComplete 推进,虚拟时钟驱动,不真实等待); * - 手势直接注入 game.onGesture(与 attachGestures 回调同路径); * - 虚拟时钟:patch setTimeout/clearTimeout/performance.now。 * * 运行:tools/node/bin/node web/storyline/test/playtest.mjs */ import fs from 'node:fs'; import path from 'node:path'; import url from 'node:url'; const GAME_DIR = path.resolve(path.dirname(url.fileURLToPath(import.meta.url)), '..'); const AUDIO_DIR = path.join(GAME_DIR, 'audio'); // ---------------------------------------------------------------- 断言收集 const realLog = console.log.bind(console); let passCount = 0; const failures = []; function assert(cond, msg) { if (cond) { passCount++; realLog(` ✓ ${msg}`); } else { failures.push(msg); realLog(` ✗ ${msg}`); } } // console 捕获(引擎/游戏的 warn/error 进日志,测试输出用 realLog) const consoleErrs = []; const consoleWarns = []; console.error = (...a) => { consoleErrs.push(a.join(' ')); }; console.warn = (...a) => { consoleWarns.push(a.join(' ')); }; console.log = () => {}; // 游戏逐手势 console.log,静默 // ---------------------------------------------------------------- 虚拟时钟 let now = 0; // 虚拟毫秒 let timerSeq = 1; const timers = new Map(); // id -> { fireAt, cb, args } const realSetImmediate = setImmediate; globalThis.setTimeout = (cb, ms = 0, ...args) => { const id = timerSeq++; timers.set(id, { fireAt: now + Math.max(0, Number(ms) || 0), cb, args }); return id; }; globalThis.clearTimeout = (id) => { timers.delete(id); }; Object.defineProperty(globalThis, 'performance', { value: { now: () => now }, configurable: true, }); /** 排空微任务(fetch/decode 的 promise 链)。 */ async function flush(rounds = 8) { for (let i = 0; i < rounds; i++) await new Promise((r) => realSetImmediate(r)); } /** * 推进虚拟时钟:逐个触发到期定时器,直到没有待触发定时器(= 游戏在等手势) * 或 cond() 满足。返回 'cond' | 'idle'。 */ async function advance(cond = null) { for (let n = 0; n < 50000; n++) { await flush(2); if (cond && cond()) return 'cond'; let nextId = -1; let nextAt = Infinity; for (const [id, t] of timers) if (t.fireAt < nextAt) { nextAt = t.fireAt; nextId = id; } if (nextId < 0) return 'idle'; now = nextAt; const t = timers.get(nextId); timers.delete(nextId); t.cb(...t.args); } throw new Error('虚拟时钟定时器超上限(疑似死循环)'); } const idle = () => advance(null); // ---------------------------------------------------------------- 浏览器 mock const winListeners = new Map(); globalThis.window = { addEventListener: (type, fn) => { if (!winListeners.has(type)) winListeners.set(type, []); winListeners.get(type).push(fn); }, AudioContext: null, // 下方赋值 }; function fireWindowEvent(type) { for (const fn of winListeners.get(type) || []) fn(); } const storageData = new Map(); globalThis.localStorage = { getItem: (k) => (storageData.has(k) ? storageData.get(k) : null), setItem: (k, v) => { storageData.set(k, String(v)); }, removeItem: (k) => { storageData.delete(k); }, }; const vibrateLog = []; Object.defineProperty(globalThis, 'navigator', { value: { vibrate: (...a) => { vibrateLog.push(a); return true; } }, configurable: true, }); class MockParam { constructor(v = 1) { this.value = v; } setValueAtTime() {} linearRampToValueAtTime() {} cancelScheduledValues() {} } class MockGainNode { constructor() { this.gain = new MockParam(); } connect() {} disconnect() {} } function fakeBuffer() { return { duration: 2.0, // 固定句长 2s(虚拟时钟推进语音链) numberOfChannels: 1, sampleRate: 44100, getChannelData: () => new Float32Array(16), }; } class MockAudioContext { constructor() { this.state = 'running'; this.currentTime = 0; this.destination = {}; } createGain() { return new MockGainNode(); } createDynamicsCompressor() { const n = new MockGainNode(); n.threshold = new MockParam(); n.ratio = new MockParam(); n.attack = new MockParam(); n.release = new MockParam(); return n; } createBufferSource() { return { buffer: null, loop: false, connect() {}, start() {}, stop() {} }; } createScriptProcessor() { return { connect() {}, disconnect() {}, onaudioprocess: null }; } decodeAudioData() { return Promise.resolve(fakeBuffer()); } resume() { this.state = 'running'; return Promise.resolve(); } } globalThis.window.AudioContext = MockAudioContext; // fetch:读真实资产目录;blockedAssets 中的片段强制 404(看门狗测试用) const requestedUrls = []; const blockedAssets = new Set(); globalThis.fetch = async (u) => { const s = String(u); requestedUrls.push(s); const blocked = [...blockedAssets].some((b) => s.includes(b)); const p = path.join(GAME_DIR, decodeURIComponent(s)); if (blocked || !fs.existsSync(p)) { return { ok: false, status: 404, arrayBuffer: async () => new ArrayBuffer(0) }; } const data = fs.readFileSync(p); return { ok: true, status: 200, arrayBuffer: async () => data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength), }; }; // ---------------------------------------------------------------- 加载引擎与游戏 const { WebAudioEngine } = await import('../../engine/audio.js'); const { settings } = await import('../../engine/settings.js'); const { StorylineGame } = await import('../game.js'); let gestureCount = 0; function makeRig() { const audio = new WebAudioEngine('audio/'); const playLog = []; const origPlay = audio.play.bind(audio); audio.play = (id, opts) => { playLog.push({ id, t: now }); return origPlay(id, opts); }; const game = new StorylineGame(audio, {}); return { audio, playLog, game }; } async function g(game, gesture) { gestureCount++; game.onGesture(gesture); await flush(); if (process.env.TRACE) { realLog(` [gesture ${gesture}] node=${game.nodeId} mode=${game.mode} playing=${game.voicePlaying} cur=${game.currentVoiceId} armed=${game.choiceArmed}`); } } const voicePlays = (playLog, id) => playLog.filter((e) => e.id === id).length; const urlHits = (frag) => requestedUrls.filter((u) => u.includes(frag)).length; // ================================================================ 主路径试玩 realLog('== 主路径试玩(关键路径 + 边界断言)=='); { const { audio, playLog, game } = makeRig(); // §7.1 解锁前 play 为 no-op audio.play('voice/n00_intro'); await flush(); assert(audio._voice === null && consoleWarns.some((w) => w.includes('尚未解锁')), '启动遮罩点按前无音频播放(play 为 no-op)'); await audio.unlock(); // 1. start() → BGM + n00 旁白 game.start(); await flush(); assert(playLog.some((e) => e.id === 'bgm/dark_drone'), '开局播放 bgm/dark_drone'); assert(game.nodeId === 'n00' && game.voicePlaying && game.currentVoiceId === 'voice/n00_intro', 'n00 旁白开始(voice 层有播放记录)'); // 长按快进(引擎内置):临时 1.7× 不变调,松手恢复 fireWindowEvent('soundgame:longpress'); assert(audio._voice && audio._voice.st.tempo === 1.7, '长按 → 旁白临时 1.7 倍速'); fireWindowEvent('soundgame:longpressend'); assert(audio._voice && audio._voice.st.tempo === 1.0, '松开 → 恢复 settings.speed'); // ② 单击跳过本句:n00_intro → skip_hint(链继续,不断) await g(game, 'tap'); assert(game.voicePlaying && game.currentVoiceId === 'voice/skip_hint', 'voice 播放中单击 = 跳过本句(skipVoice 续链到 skip_hint)'); await idle(); assert(!game.voicePlaying && game.nodeId === 'n00', 'n00 链播完,等待单击继续'); assert(voicePlays(playLog, 'voice/skip_hint') === 1, '③ 开场 skip_hint 提示播了一次'); // 切男声:下一句起用 male 目录 settings.set({ voice: 'male' }); await g(game, 'tap'); // → n01 await flush(); assert(urlHits('audio/voice/male/n01_wake.') > 0, 'settings.voice=male 后旁白走 male 目录'); // 双击重听当前节点 const beforeReplay = voicePlays(playLog, 'voice/n01_wake'); await g(game, 'doubletap'); assert(game.currentVoiceId === 'voice/n01_wake' && voicePlays(playLog, 'voice/n01_wake') === beforeReplay + 1, '语音播放中双击 = 重听当前节点(同一 voice id 重播)'); // 菜单:BGM 切 menu pad,返回剧情节点不丢、BGM 淡回 await g(game, 'down'); assert(game.mode === 'MENU', '下滑呼出菜单'); await flush(); assert(audio._bgm && audio._bgm.id === 'bgm/menu', '② 进菜单 BGM 切 bgm/menu'); await idle(); // voice/menu 播完 await g(game, 'tap'); // 关菜单 assert(game.mode === 'STORY' && game.nodeId === 'n01', '关菜单返回剧情,节点不丢(不重头)'); await flush(); assert(audio._bgm && audio._bgm.id === 'bgm/dark_drone', '② 关菜单 BGM 淡回 dark_drone'); await idle(); // 重播 n01 播完 // 上滑:帮助 + 进度,随后自动重播当前节点 await g(game, 'up'); assert(game.currentVoiceId === 'voice/help', '上滑播放操作说明'); await idle(); assert(voicePlays(playLog, 'voice/status1') === 1, '帮助后播当前进度(第一幕 status1)'); // settings.bgm = 0 → 立即静默;调回 → 补播最后状态 BGM settings.set({ bgm: 0 }); await flush(); assert(audio._bgm === null, 'settings.bgm=0 时无 bgm 层播放'); settings.set({ bgm: 1 }); await flush(); assert(audio._bgm && audio._bgm.id === 'bgm/dark_drone', 'bgm 调回后自动补播最后状态 BGM'); // → n02(抉择点)。n02_linwan 是角色音(林晚):male 目录无,平铺回退命中 settings.set({ speed: 1.7 }); requestedUrls.length = 0; await g(game, 'tap'); await flush(); assert(game.nodeId === 'n02', '进入 n02 抉择节点'); assert(audio._voice && audio._voice.st.tempo === 1.7, 'settings.speed=1.7 下一句起生效'); assert(urlHits('audio/voice/male/n02_linwan.') > 0 && urlHits('audio/voice/n02_linwan.ogg') > 0, '④ 角色音 n02_linwan 走平铺目录回退(不随性别设置变化)'); settings.set({ speed: 1.0 }); // 抉择提示 p1 播放中:单击不可跳;滑动缓存 pendingChoice await advance(() => game.currentVoiceId === 'voice/p1'); assert(game.promptPlaying, '抉择提示 p1 播放中(promptPlaying=true)'); await g(game, 'tap'); assert(game.currentVoiceId === 'voice/p1', '① 抉择提示播放中单击不可跳'); await g(game, 'right'); assert(game.pendingChoice === 'right', '提示音播放中右滑缓存 pendingChoice'); await idle(); assert(game.nodeId === 'n04', '链尾 pendingChoice 生效 → n04'); assert(!game.companion && !game.knowTrap && !game.betrayed, '剧情标记初始为 false'); // n04 → n05 → n06 → n07(无语音时单击维持原义:继续剧情) settings.set({ voice: 'female' }); // 切回女声,验证女性设置下角色音同样平铺 for (const next of ['n05', 'n06', 'n07']) { await idle(); await g(game, 'tap'); assert(game.nodeId === next, `单击继续剧情 → ${next}`); } await idle(); assert(game.choiceArmed, 'n07 提示播完 choiceArmed=true(等待抉择)'); await g(game, 'right'); // 装死 → n09 assert(game.nodeId === 'n09' && game.knowTrap === true, 'n09 右滑 → knowTrap === true'); requestedUrls.length = 0; await idle(); await g(game, 'tap'); // → n10 await idle(); await g(game, 'left'); // 闻声寻去 → n11 assert(game.nodeId === 'n11', 'n10 左滑 → n11'); await idle(); await g(game, 'left'); // 带上小满 → n12 assert(game.nodeId === 'n12' && game.companion === true, 'n11 左滑 → companion === true'); await idle(); await g(game, 'tap'); // → n15 断桥 await idle(); await g(game, 'left'); // 涵洞(带小满 → 虚拟节点解析 n16b) assert(game.nodeId === 'n16b', '虚拟节点 resolve:带小满时 v_culvert → n16b'); await idle(); await g(game, 'tap'); // → n18 await idle(); assert(urlHits('audio/voice/n18_dog.ogg') > 0 || urlHits('audio/voice/female/n18_dog.') > 0, 'n18 旁白正常加载'); await g(game, 'left'); // 交出坐标 → n19 assert(game.nodeId === 'n19' && game.betrayed === true, 'n18 左滑 → betrayed === true'); await idle(); await g(game, 'tap'); // → n20 await idle(); await g(game, 'left'); // 赎罪 → n21 assert(game.nodeId === 'n21', 'n20 左滑 → n21'); await idle(); await g(game, 'tap'); // → e2 结局:代价 assert(game.nodeId === 'e2', '到达结局节点 e2(4 结局之一)'); await idle(); assert(voicePlays(playLog, 'voice/e2_price') === 1, '结局语音 e2_price 播出'); assert(game.awaitingRestart === true, '结局链播完进入结算态(awaitingRestart)'); assert(audio._bgm && audio._bgm.id === 'bgm/dark_drone', '② 结局结算保持 dark_drone 不切(10 号文档 §2)'); // 结算态单击重开回 n00 await g(game, 'tap'); assert(game.nodeId === 'n00' && game.mode === 'STORY' && !game.companion && !game.knowTrap && !game.betrayed, '结算态单击重开回 n00,剧情标记重置'); await idle(); assert(voicePlays(playLog, 'voice/skip_hint') === 1, '③ 重开后 skip_hint 不重播(每局一次)'); assert(gestureCount <= 40, `关键路径手势预算 ≤40(实际 ${gestureCount})`); } // ================================================================ 看门狗路径 realLog('== 看门狗路径(屏蔽 voice/n05_signal)=='); { settings.set({ voice: 'female', speed: 1.0, bgm: 1.0 }); blockedAssets.add('n05_signal'); const errBefore = consoleErrs.length; const { audio, game } = makeRig(); await audio.unlock(); game.start(); await idle(); await g(game, 'tap'); // n01 await idle(); await g(game, 'tap'); // n02 await idle(); // n02_linwan + p1 播完 await g(game, 'right'); // → n04 await idle(); await g(game, 'tap'); // → n05(第一句 n05_signal 被屏蔽) await idle(); // 看门狗 30s 超时续链 → n05_bcast 播完 assert(consoleErrs.slice(errBefore).some((e) => e.includes('n05_signal')), '屏蔽资产仅 console.error,不抛异常'); assert(consoleWarns.some((w) => w.includes('看门狗')), '语音看门狗超时自动续链'); assert(game.nodeId === 'n05' && !game.voicePlaying, '缺失 voice 不卡死:n05 链走完'); await g(game, 'tap'); // n06 await idle(); await g(game, 'tap'); // n07(非抉择点 n06 之后继续剧情) await idle(); await g(game, 'right'); // n07 装死 → n09 await idle(); await g(game, 'tap'); // n10 await idle(); await g(game, 'right'); // n14 await idle(); await g(game, 'tap'); // n15 await idle(); await g(game, 'right'); // n17(无小满 → v_cable → n17) assert(game.nodeId === 'n17', '虚拟节点 resolve:无小满时 v_cable → n17'); await idle(); await g(game, 'tap'); // n18 await idle(); await g(game, 'right'); // n22 await idle(); await g(game, 'tap'); // n23 await idle(); await g(game, 'left'); // n23 开闸 → n24 await idle(); await g(game, 'tap'); // n24 播完单击 → e4 assert(game.nodeId === 'e4', '屏蔽资产后仍可推进到结局 e4'); await idle(); assert(game.awaitingRestart === true, '看门狗路径到达结算态'); blockedAssets.clear(); } // ================================================================ 资产引用校验 realLog('== 资产引用校验 =='); { const src = fs.readFileSync(path.join(GAME_DIR, 'game.js'), 'utf8'); const ids = [...new Set([...src.matchAll(/'((?:voice|sfx|bgm)\/[A-Za-z0-9_.-]+)'/g)].map((m) => m[1]))]; assert(ids.length > 0, `game.js 提取到 ${ids.length} 个资产 id`); const both = (rel) => ['.ogg', '.m4a'].every((ext) => fs.existsSync(path.join(AUDIO_DIR, rel + ext))); let missing = 0; for (const id of ids) { if (id.startsWith('voice/')) { const name = id.slice(6); const ok = both(`voice/male/${name}`) || both(`voice/female/${name}`) || both(`voice/${name}`); if (!ok) { missing++; realLog(` ✗ 资产缺失: ${id}`); } } else if (!both(id)) { missing++; realLog(` ✗ 资产缺失: ${id}`); } } assert(missing === 0, `全部 ${ids.length} 个引用 id 均有 ogg+m4a(含性别目录/平铺回退),零缺失`); // ③ skip_hint 双性别齐备 assert(both('voice/male/skip_hint') && both('voice/female/skip_hint'), 'voice/skip_hint 双性别 ogg+m4a 齐备'); // ④ 角色音只在平铺目录(不随性别设置变化,12 号文档 §4 回归) const charVoices = ['n02_linwan', 'n03_msg', 'n05_bcast', 'n07_dog', 'e1_child']; const flatOk = charVoices.every((n) => both(`voice/${n}`)); const notGendered = charVoices.every((n) => !fs.existsSync(path.join(AUDIO_DIR, `voice/male/${n}.ogg`)) && !fs.existsSync(path.join(AUDIO_DIR, `voice/female/${n}.ogg`))); assert(flatOk && notGendered, '④ 角色音(林晚/猎狗/小满等)仅存平铺目录,性别目录无副本'); } // ================================================================ 汇总 realLog(`\n通过 ${passCount} 条断言,失败 ${failures.length} 条`); if (failures.length > 0) { realLog('失败清单:'); for (const f of failures) realLog(` - ${f}`); process.exit(1); } realLog('全部断言通过。');