feat(0.1.14-P4/P5): UI 单点 + 引擎级测试(979)+ 顶栏天下风云

- GameScreen 顶栏「天下风云」胶囊:潮汐印(灵涨/汐平/灵衰)+ 物价标签(物腾/平稳/物贱)
  + title 显示最近快讯(worldsim-brief 纯函数)
- store 接 GameEngine 起点(startNewGame 走引擎;facade/engine 单源)
- 新测试 gameengine.test.ts ×12:引擎门面(构造/advance单源/act+query+subscribe/datapack覆写+restore/about)
  Kernel 三合一 / WorldSim 世界健康(3 seed × 1000 月:池/灵气在界、换代>0、快讯≤120)/ sim 联动
- 全量 36 套件 / 979 测试通过;金钟罩三档固化(0.1.14 正式);typecheck 0 error
- AGENTS 补「引擎系统」章节;版本 0.1.14
This commit is contained in:
2026-08-23 13:33:39 +08:00
parent 5dd5d6b558
commit 26bd61fba0
7 changed files with 272 additions and 4 deletions
+118
View File
@@ -0,0 +1,118 @@
import { describe, expect, it } from 'vitest'
import { GameEngine } from '../src/renderer/game/engine/GameEngine'
import { makeKernel } from '../src/renderer/game/engine/kernel/Kernel'
import { WorldSim } from '../src/renderer/game/engine/sim/WorldSim'
import { WORLDSIM } from '../src/renderer/game/engine/sim/worldsim-data'
describe('GameEngine 引擎门面', () => {
it('构造:内核注入世界 + 门面 + 数据包', () => {
const e = new GameEngine({ seed: 'engine-1' })
expect(e.world).toBeTruthy()
expect(e.facade).toBeTruthy()
expect(e.kernel.clock.subscriptionCount()).toBeGreaterThanOrEqual(10)
expect(e.status()).toBe('running')
})
it('advance 驱动内核时钟(确定单源)', () => {
const e = new GameEngine({ seed: 'engine-2' })
const y0 = e.view().year
const m0 = e.view().month
e.advance()
const crossed = e.view().month === 1 && e.view().year === y0 + 1
const normal = e.view().month === m0 + 1
expect(crossed || normal).toBe(true)
})
it('act/query/subscribe 全链路', () => {
const e = new GameEngine({ seed: 'engine-3' })
const events: string[] = []
const unsub = e.subscribe((ev) => events.push(ev.type))
expect(e.act('member.post', { memberId: 'x3', post: 'elder' })).toBe(true)
e.advance()
// 一次 advance 必然产生内核事件流(log/pending/paper 至少其一)
expect(events.length).toBeGreaterThan(0)
unsub()
const fam = e.query('family') as { year: number }
expect(fam.year).toBeGreaterThanOrEqual(1)
})
it('datapack 覆写生效 + restore 可回放', () => {
const e = new GameEngine({ seed: 'engine-4' })
e.datapack.override({
items: { ...e.datapack.current().items, lingcao: { ...e.datapack.current().items['lingcao'], basePrice: 250 } }
})
const snap = e.snapshot()
expect(snap.family.stones).toBeGreaterThanOrEqual(0)
e.restore(snap)
expect(e.status()).toBe('running')
})
it('about 元数据含 plugins(≥3)与版本 0.1.14', () => {
const e = new GameEngine({ seed: 'engine-5' })
const a = e.about()
expect(a.plugins).toBeGreaterThanOrEqual(3)
expect(a.version).toContain('0.1.14')
})
})
describe('Kernel 三合一', () => {
it('时钟/随机/总线协同(同 seed 同随机序列)', () => {
const k1 = makeKernel('kernel-a')
const k2 = makeKernel('kernel-a')
expect(k1.rng.next()).toBe(k2.rng.next())
expect(k1.clock).toBeTruthy()
expect(typeof k1.bus.onLog).toBe('function')
})
})
describe('WorldSim 世界健康(长跑)', () => {
it.each(['ws-1', 'ws-2', 'ws-3'].map((s) => [s] as const))('%s:1000 月市场池/灵气在界、世界不崩', (seed) => {
const e = new GameEngine({ seed })
for (let i = 0; i < 1000; i++) {
if (e.view().gameOver) break
e.advance()
}
const ws = e.view().worldSim as (Record<string, unknown> & {
marketPool: Record<string, number>
secretQi: Record<string, number>
tide: number
}) | undefined
expect(ws).toBeTruthy()
if (ws) {
for (const v of Object.values(ws.marketPool)) expect(v).toBeGreaterThan(0)
for (const v of Object.values(ws.secretQi ?? {})) expect(v).toBeGreaterThanOrEqual(0)
expect(ws.tide).toBeGreaterThan(0.5)
expect(ws.tide).toBeLessThan(1.4)
}
})
it('NPC 换代至少发生一次(世界在演化)', () => {
const e = new GameEngine({ seed: 'ws-evolve' })
for (let i = 0; i < 720; i++) {
if (e.view().gameOver) break
e.advance()
}
const ws = e.view().worldSim as { npcSuccessions?: number } | undefined
expect(ws?.npcSuccessions ?? 0).toBeGreaterThan(0)
})
it('快讯持有且裁剪符合 N(≤120', () => {
const e = new GameEngine({ seed: 'ws-news' })
for (let i = 0; i < 400; i++) {
if (e.view().gameOver) break
e.advance()
}
const ws = e.view().worldSim as { newsFeed?: unknown[] } | undefined
expect(ws?.newsFeed.length ?? 0).toBeLessThanOrEqual(WORLDSIM.newsKeep)
})
})
describe('Sim 与外层联动', () => {
it('tideMult 在界(0.5-1.4)且随年景变化', () => {
const e = new GameEngine({ seed: 'ws-tide-link' })
const sim = new WorldSim(e.world)
const before = sim.tideMult()
expect(before).toBeGreaterThanOrEqual(0.5)
expect(before).toBeLessThan(1.4)
})
})