From fdd8a5cbb8d8f8a5645fb298dcf1fd884b16dd88 Mon Sep 17 00:00:00 2001 From: daniel wang Date: Wed, 28 Oct 2026 17:23:32 +0800 Subject: [PATCH] =?UTF-8?q?=E9=A6=96=E9=A0=81=E9=80=9F=E5=BA=A6=E3=80=81?= =?UTF-8?q?=E8=BC=89=E5=85=A5=E7=95=AB=E9=9D=A2=E3=80=81=E6=9C=AC=E5=91=BD?= =?UTF-8?q?=E5=8D=80=E8=88=87=E5=80=99=E9=81=B8=E4=BA=BA=E9=A1=9E=E5=9E=8B?= =?UTF-8?q?=E3=80=81=E5=AE=8C=E6=88=90=E5=BA=A6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 速度與載入 - 3D 小鎮依實際每秒張數自動降畫質;偵測到軟體繪圖直接用最低畫質;shader 背景編譯 - three.js 與一局卡牌的畫面用到才下載(首頁主程式 1.19 MB → 0.34 MB) - 伺服器壓縮 API 回應(劇本清單 1.4 MB → 56 KB);網頁 pnpm start 用正式版 - index.html 內嵌載入畫面,顯示 3D 小鎮的搭建進度 首頁與頁面 - 拿掉首頁頁尾(致敬字樣、資料、美術連結);資料來源改放遊戲內設定選單 - 資料檢視器、美術總覽、頭像對照、部件檢查只在 pnpm dev 打得開 選戰卡牌(docs/25) - 本命區:雙方各一(總統兩個縣市),牌 ×1.2,失守聲勢 −2,攻下對手的聲勢 +2、對手少一個行動;新牌「回鄉造勢」 - 六種候選人類型:依中選會選舉紀錄或出身決定,各有技能、弱點、專屬開局牌;每日一戰也套用 - 下一站、物資行比較常出現適合你類型的牌與幕僚,牌面標出來 - 完成度:全台制霸、六種類型、類型逆風挑戰、成就;結果頁挑戰下一級逆風、攻下一塊地盤、Enter 再來一局 Co-Authored-By: Claude Opus 5.5 --- backend/apps/server/package.json | 1 + backend/apps/server/src/app.ts | 3 + backend/apps/server/src/people-routes.ts | 4 +- backend/apps/server/src/rogue-routes.ts | 41 +++- backend/apps/server/test/archetype.test.ts | 29 +++ backend/apps/sim/src/rogue-balance.ts | 27 +-- backend/docs/14-legal-and-ethics.md | 2 +- backend/docs/25-gameplay-v3.md | 173 ++++++++++++++++ backend/docs/README.md | 9 +- backend/packages/content/src/actions-more.ts | 6 +- .../protocol/data/avatar-catalog.json | 2 +- .../protocol/src/avatar/catalog.generated.ts | 2 +- backend/packages/protocol/src/rogue.ts | 25 +++ backend/packages/rogue/src/archetypes.ts | 121 ++++++++++++ backend/packages/rogue/src/cards.ts | 34 +++- backend/packages/rogue/src/data.ts | 3 + backend/packages/rogue/src/index.ts | 1 + backend/packages/rogue/src/mechanics.ts | 35 +++- backend/packages/rogue/src/rival.ts | 17 +- backend/packages/rogue/src/route.ts | 46 ++++- backend/packages/rogue/src/rules.ts | 45 ++++- backend/packages/rogue/src/scenes.ts | 10 +- backend/packages/rogue/src/state.ts | 14 +- backend/packages/rogue/src/view.ts | 31 ++- backend/packages/rogue/test/identity.test.ts | 186 ++++++++++++++++++ backend/packages/rogue/test/rules.test.ts | 4 +- backend/pnpm-lock.yaml | 23 +++ web/README.md | 3 + web/index.html | 48 ++++- web/package.json | 1 + web/src/App.tsx | 31 +-- web/src/game/art/avatar/pixel.tsx | 2 +- web/src/game/counties.ts | 25 +++ web/src/game/home/HomeScreen.tsx | 3 - web/src/game/home/home.css | 3 - web/src/game/hud/SettingsMenu.tsx | 1 + web/src/game/people/PeopleFilters.tsx | 26 +-- web/src/game/rogue/Collection.tsx | 2 + web/src/game/rogue/Completion.tsx | 103 ++++++++++ web/src/game/rogue/RogueScreen.tsx | 7 +- web/src/game/rogue/RogueStart.tsx | 5 +- web/src/game/rogue/brief.tsx | 4 + web/src/game/rogue/cards.tsx | 7 +- web/src/game/rogue/completion.css | 26 +++ web/src/game/rogue/finale.tsx | 68 ++++++- web/src/game/rogue/parts.tsx | 41 +++- web/src/game/rogue/progress.ts | 54 ++++- web/src/game/rogue/rogue.css | 11 ++ web/src/game/screens.css | 1 + web/src/game/start/HeroDiorama.tsx | 99 +++++++--- web/src/game/start/hero3d.ts | 165 ++++++++++++---- web/src/splash.ts | 44 +++++ web/test/rogue-progress.test.ts | 36 +++- 53 files changed, 1522 insertions(+), 188 deletions(-) create mode 100644 backend/apps/server/test/archetype.test.ts create mode 100644 backend/docs/25-gameplay-v3.md create mode 100644 backend/packages/rogue/src/archetypes.ts create mode 100644 backend/packages/rogue/test/identity.test.ts create mode 100644 web/src/game/counties.ts create mode 100644 web/src/game/rogue/Completion.tsx create mode 100644 web/src/game/rogue/completion.css create mode 100644 web/src/splash.ts diff --git a/backend/apps/server/package.json b/backend/apps/server/package.json index f302302..d402297 100644 --- a/backend/apps/server/package.json +++ b/backend/apps/server/package.json @@ -16,6 +16,7 @@ "@election2026/protocol": "workspace:*", "@election2026/rogue": "workspace:*", "@election2026/scenarios": "workspace:*", + "@fastify/compress": "^9.3.0", "@fastify/rate-limit": "^11.2.1", "fastify": "^5.12.7", "zod": "^4.6.7" diff --git a/backend/apps/server/src/app.ts b/backend/apps/server/src/app.ts index ae4b8af..bef4050 100644 --- a/backend/apps/server/src/app.ts +++ b/backend/apps/server/src/app.ts @@ -1,6 +1,7 @@ import { readFile } from "node:fs/promises"; import { join } from "node:path"; import { fileURLToPath } from "node:url"; +import compress from "@fastify/compress"; import rateLimit from "@fastify/rate-limit"; import { CONTENT, candidateStats, personName, withCustomCandidate } from "@election2026/content"; import { loadScenarioRegistry, type ScenarioRegistry } from "@election2026/scenarios"; @@ -109,6 +110,8 @@ export async function buildApp(options: AppOptions = {}): Promise void = () export interface RecordAbilities { abilities: CareerAbilities; basis: string; + /** 換算前的數字(類型同級時比誰超過門檻比較多,docs/25) */ + raw?: { maxVotes: number; wins: number; years: number }; } /** 全國性的劇本(總統選舉)用這個縣市代碼 */ @@ -126,7 +128,7 @@ export function recordAbilities(people: readonly PersonRecord[], name: string, c integrity: 0, }; const basis = `參選 ${runs.length} 次、當選 ${wins.length} 次、單次最高 ${maxVotes.toLocaleString("en-US")} 票${firstWin ? `、${firstWin} 年第一次當選` : ""}(中選會歷屆選舉紀錄,${before.slice(0, 4)} 年以前)`; - return { abilities, basis }; + return { abilities, basis, raw: { maxVotes, wins: wins.length, years } }; } /** 「2022 臺北市第3選區 直轄市議員(平地原住民)」「2024 全國 副總統」「2024 全國 不分區立法委員」 */ diff --git a/backend/apps/server/src/rogue-routes.ts b/backend/apps/server/src/rogue-routes.ts index c00b55f..59d8d0a 100644 --- a/backend/apps/server/src/rogue-routes.ts +++ b/backend/apps/server/src/rogue-routes.ts @@ -1,7 +1,7 @@ import { randomInt, randomUUID } from "node:crypto"; -import { CUSTOM_ID, CustomCandidateError } from "@election2026/content"; +import { CUSTOM_ID, CustomCandidateError, candidateStats } from "@election2026/content"; import type { World } from "@election2026/engine"; -import { CreateRogueRequest, RogueChooseRequest, RoguePlayRequest, RogueUltimateRequest, type CareerAbilities, type CustomCandidate, type RogueView, originAbilities, partyKind } from "@election2026/protocol"; +import { CreateRogueRequest, ORIGINS, RogueChooseRequest, RoguePlayRequest, RogueUltimateRequest, type Background, type CareerAbilities, type CustomCandidate, type RogueArchetype, type RogueView, originAbilities, partyKind } from "@election2026/protocol"; import { ADVISOR_BY_ID, CAREER_STAGES, @@ -45,6 +45,24 @@ interface RogueContext { const RUN_ID = /^[0-9a-f-]{36}$/; +/** 資歷同級時比「超過門檻多少」:單次最高得票 / 30 萬、當選次數 / 3、從政年資 / 12(和換算等級的門檻一樣) */ +const RAW_SCALE = { media: (r: RawRecord) => r.maxVotes / 300_000, organization: (r: RawRecord) => r.wins / 3, eloquence: (r: RawRecord) => r.years / 12 } as const; +type RawRecord = { maxVotes: number; wins: number; years: number }; + +/** + * 真實候選人的類型(docs/25):資歷三項(媒體、組織、口才)取最突出的;同級時比實際數字超過門檻多少(再同就依媒體、組織、口才)。 + * 資歷都是 0:競選經費很多(同場比,能力值財力 8 以上)是財務型,不然是黑馬型。只用中選會選舉紀錄與劇本的真實政治獻金。 + */ +export function realArchetype(record: { abilities: CareerAbilities; basis: string; raw?: RawRecord } | null, wealth: number): { archetype: RogueArchetype; basis: string } { + const a = record?.abilities; + const basis = record?.basis ?? "沒有更早的選舉紀錄"; + const keys = ["media", "organization", "eloquence"] as const; + const score = (k: (typeof keys)[number]) => (a?.[k] ?? 0) * 100 + (record?.raw ? RAW_SCALE[k](record.raw) : 0); + const top = keys.reduce((best, k) => (score(k) > score(best) ? k : best), keys[0]); + if (!a || a[top] === 0) return wealth >= 8 ? { archetype: "finance", basis: `${basis};競選經費多(劇本的真實政治獻金)` } : { archetype: "newcomer", basis }; + return { archetype: top, basis }; +} + /** 每日一戰:同一天同一個種子 */ const dailySeed = (date: string): number => { let h = 2166136261; @@ -140,12 +158,21 @@ export function registerRogue(app: FastifyInstance, ctx: RogueContext): void { // 帶過來的牌只能是一般的牌(不能帶狀態牌),幕僚要存在 const bad = carry && (carry.advisors.some((a) => !ADVISOR_BY_ID.has(a)) || carry.cards.some((c) => (CARD_BY_ID.get(c.id)?.rarity ?? "status") === "status")); if (bad) return ctx.fail(reply, 400, "帶過來的幕僚或牌不正確"); - // 玩真實候選人(不是每日一戰):依那場選舉之前的公開紀錄給一點開局能力 + // 玩真實候選人:依那場選舉之前的公開紀錄給一點開局能力(每日一戰不給),並決定類型(每日一戰也套用,大家同一個人、同一個類型) let record: { abilities: CareerAbilities; basis: string } | null = null; - if (!custom && !local && !daily && !abilities && ctx.realAbilities) { + let identity: { archetype: RogueArchetype; basis: string } | null = null; + if (!custom && !local) { const world = await ctx.world(scenarioId); const you = (await setup).you; - if (world) record = await ctx.realAbilities(you.name, world.scenario.region.countyCode, world.scenario.electionDate); + if (world) { + if (ctx.realAbilities) record = await ctx.realAbilities(you.name, world.scenario.region.countyCode, world.scenario.electionDate); + const cand = world.scenario.candidates.find((c) => c.id === candidateId); + identity = realArchetype(record, cand ? candidateStats(world.scenario, cand).wealth : 0); + } + } else if (custom) { + // 自創角色:出身對應的能力就是類型 + const ability = ORIGINS[custom.background as Background]?.ability; + if (ability) identity = { archetype: ability, basis: `出身:${custom.background}` }; } const state = createRun(await setup, randomUUID(), runSeed, { weeks: local ? (local.kind === "village" ? VILLAGE_WEEKS : COUNCIL_WEEKS) : undefined, @@ -157,7 +184,9 @@ export function registerRogue(app: FastifyInstance, ctx: RogueContext): void { // 每日一戰大家條件一樣:不帶政策島、能力、政策(建築 id 和等級由 createRun 再檢查一次) // 自創角色沒帶能力(自由選戰):依捏人物點數、出身、黨的資源算起始能力(18 第 53 項) abilities: daily ? null : (abilities ?? record?.abilities ?? (custom ? originAbilities(custom) : null)), - abilitiesBasis: record?.basis ?? null, + abilitiesBasis: daily ? null : (record?.basis ?? null), + archetype: identity?.archetype ?? null, + archetypeBasis: identity?.basis ?? null, // 自創角色的出身與政黨:專屬起始牌、黨的資源(每日一戰大家條件一樣,不套用) origin: custom && !daily ? { background: custom.background, party: custom.party, kind: partyKind(custom.party) } : null, perks: daily ? [] : perks, diff --git a/backend/apps/server/test/archetype.test.ts b/backend/apps/server/test/archetype.test.ts new file mode 100644 index 0000000..bb63e37 --- /dev/null +++ b/backend/apps/server/test/archetype.test.ts @@ -0,0 +1,29 @@ +import { describe, expect, it } from "vitest"; +import { realArchetype } from "../src/rogue-routes.ts"; + +/** 真實候選人的類型(docs/25):只看中選會選舉紀錄與劇本的真實政治獻金 */ +const rec = (media: number, organization: number, eloquence: number) => ({ abilities: { media, organization, eloquence, finance: 0, integrity: 0 }, basis: "參選 3 次" }); + +describe("真實候選人的類型", () => { + it("取資歷最突出的一項;同分依媒體、組織、口才", () => { + expect(realArchetype(rec(2, 1, 0), 5).archetype).toBe("media"); + expect(realArchetype(rec(1, 2, 2), 5).archetype).toBe("organization"); + expect(realArchetype(rec(0, 0, 1), 5).archetype).toBe("eloquence"); + expect(realArchetype(rec(1, 1, 1), 5).archetype).toBe("media"); + }); + + it("同級時比實際數字超過門檻多少", () => { + // 蔣萬安 2022 年以前:單次最高 11 萬票、當選 2 次、年資 4 年 → 三項都是 1 級,當選次數最接近下一個門檻 + expect(realArchetype({ ...rec(1, 1, 1), raw: { maxVotes: 112_784, wins: 2, years: 4 } }, 9).archetype).toBe("organization"); + expect(realArchetype({ ...rec(1, 1, 1), raw: { maxVotes: 280_000, wins: 1, years: 4 } }, 5).archetype).toBe("media"); + }); + + it("資歷都是 0:經費多是財務型,不然是黑馬型;有資歷就照資歷,經費多也一樣", () => { + expect(realArchetype(null, 3)).toEqual({ archetype: "newcomer", basis: "沒有更早的選舉紀錄" }); + expect(realArchetype(rec(0, 0, 0), 3).archetype).toBe("newcomer"); + expect(realArchetype(null, 9).archetype).toBe("finance"); + expect(realArchetype(rec(0, 0, 0), 9).basis).toContain("政治獻金"); + expect(realArchetype(rec(1, 1, 0), 9).archetype).toBe("media"); + expect(realArchetype(rec(2, 0, 0), 9).archetype).toBe("media"); + }); +}); diff --git a/backend/apps/sim/src/rogue-balance.ts b/backend/apps/sim/src/rogue-balance.ts index 3a33f6c..5aba202 100644 --- a/backend/apps/sim/src/rogue-balance.ts +++ b/backend/apps/sim/src/rogue-balance.ts @@ -4,11 +4,13 @@ * 每位主要候選人各讓幾種模擬玩家打很多局: * - 打得好(greedy)要比亂打(random)、不理對手(naive)多拿好幾個百分點 → 技術有差 * - 只拿某一派牌的玩家(地面、空戰、攻擊)勝率不能差太多 → 沒有一招通吃 + * - --archetypes all:每種候選人類型(docs/25)各跑一次,「打得好」的勝率差距要在 ±5 個百分點內 */ import { mkdir, readFile, writeFile } from "node:fs/promises"; import { join } from "node:path"; import { parseArgs } from "node:util"; -import { TRAIT_LABELS, runBot, type BotName } from "@election2026/rogue"; +import type { RogueArchetype } from "@election2026/protocol"; +import { ARCHETYPES, TRAIT_LABELS, runBot, type BotName } from "@election2026/rogue"; import { DEFAULT_PACKS_ROOT } from "@election2026/pack-loader"; import { buildSetup, type TopologyLike } from "@election2026/rogue/setup"; import { loadWorld } from "./world.ts"; @@ -29,9 +31,11 @@ const mean = (xs: number[]) => xs.reduce((a, b) => a + b, 0) / (xs.length || 1); async function main(): Promise { const { values } = parseArgs({ - options: { scenario: { type: "string", default: "taoyuan-2022-mayor-even" }, seeds: { type: "string", default: "200" }, ascension: { type: "string", default: "0" }, even: { type: "boolean", default: false }, bots: { type: "string" } }, + options: { scenario: { type: "string", default: "taoyuan-2022-mayor-even" }, seeds: { type: "string", default: "200" }, ascension: { type: "string", default: "0" }, even: { type: "boolean", default: false }, bots: { type: "string" }, archetypes: { type: "string" } }, }); const ascension = Number(values.ascension); + // 不指定類型就是舊的玩法(沒有類型);all 是六種都跑 + const archetypes: (RogueArchetype | null)[] = !values.archetypes ? [null] : values.archetypes === "all" ? (Object.keys(ARCHETYPES) as RogueArchetype[]) : (values.archetypes.split(",") as RogueArchetype[]); const started = Date.now(); const world = await loadWorld(values.scenario); const topology = JSON.parse(await readFile(join(DEFAULT_PACKS_ROOT, world.scenario.packId, "topology.json"), "utf-8")) as TopologyLike; @@ -46,15 +50,16 @@ async function main(): Promise { const voters = setup.towns.reduce((a, t) => a + t.voters, 0); lines.push(`## 玩 ${setup.you.name}(對手 ${setup.rival.name})`, ""); lines.push(`預計投票 ${Math.round(voters).toLocaleString()} 人;各區特色:${setup.towns.map((t) => `${t.name}${t.traits.length ? `(${t.traits.map((x) => TRAIT_LABELS[x]).join("、")})` : ""}`).join("、")}`, ""); - lines.push("| 玩家 | 平均得票率 | 平均差距 | 勝率 |", "|---|---:|---:|---:|"); - for (const bot of bots) { - const runs = seeds.map((seed) => runBot(setup, seed, bot.id, { ascension }).result!); - const share = mean(runs.map((r) => r.youShare)); - const margin = mean(runs.map((r) => r.youShare - r.rivalShare)); - const win = mean(runs.map((r) => (r.won ? 1 : 0))); - lines.push(`| ${bot.label} | ${pct(share, 2)} | ${margin >= 0 ? "+" : ""}${(margin * 100).toFixed(2)} | ${pct(win, 0)} |`); - json.push({ candidate: cand.name, bot: bot.id, ascension, share, margin, win }); - } + lines.push("| 類型 | 玩家 | 平均得票率 | 平均差距 | 勝率 |", "|---|---|---:|---:|---:|"); + for (const archetype of archetypes) + for (const bot of bots) { + const runs = seeds.map((seed) => runBot(setup, seed, bot.id, { ascension, archetype }).result!); + const share = mean(runs.map((r) => r.youShare)); + const margin = mean(runs.map((r) => r.youShare - r.rivalShare)); + const win = mean(runs.map((r) => (r.won ? 1 : 0))); + lines.push(`| ${archetype ? ARCHETYPES[archetype].name : "(無)"} | ${bot.label} | ${pct(share, 2)} | ${margin >= 0 ? "+" : ""}${(margin * 100).toFixed(2)} | ${pct(win, 0)} |`); + json.push({ candidate: cand.name, archetype, bot: bot.id, ascension, share, margin, win }); + } lines.push(""); console.log(`${cand.name} 完成`); } diff --git a/backend/docs/14-legal-and-ethics.md b/backend/docs/14-legal-and-ethics.md index 5f24c56..b04a011 100644 --- a/backend/docs/14-legal-and-ethics.md +++ b/backend/docs/14-legal-and-ethics.md @@ -29,7 +29,7 @@ | 能力分數 | 用客觀資歷(歷次參選、得票、任職)計算,每項附算法與出處(docs/23)。資料管線另有一套 AI 評分(rubric-v1.md),目前沒有接進遊戲 | | 負面事實 | 只收錄有確定判決或官方正式認定的事項 | | 黑色行動 | 是**玩家的選擇**,不是對真人的描述。AI 控制的真實人物不使用奧步;栽贓、檢舉類新聞不點名真人犯罪 | -| 模擬新聞與民調 | 新聞台用諧音惡搞的台名(中夭、三粒、鄉民直播台),不用真實媒體的台標與商標。畫面上不標「遊戲模擬」(使用者 2026-10-26 決定,docs/18 第 41 項);只在首頁底部寫資料來源、分享圖卡角落寫「選舉小鎮・選戰遊戲」 | +| 模擬新聞與民調 | 新聞台用諧音惡搞的台名(中夭、三粒、鄉民直播台),不用真實媒體的台標與商標。畫面上不標「遊戲模擬」(使用者 2026-10-26 決定,docs/18 第 41 項);資料來源寫在遊戲內的設定選單(政府資料開放授權條款要標示來源)、分享圖卡角落寫「選舉小鎮・選戰遊戲」 | | 引述 | 不捏造真實人物的發言當成真實引述。角色台詞以遊戲角色的口吻呈現,並與真實新聞明顯區隔 | | 表態事件 | 事件都是虛構的一般情境,不寫真人說過的話。AI 控制的真實人物隨機表態只影響數字、**不上新聞**,避免替真人捏造立場;玩家自己操作的角色表態才會出現在模擬新聞 | | AI 生成插圖 | 只用在一般場景(市場、宮廟、記者會…)與不具名的小人;不生成真人肖像、不出現政黨標誌與文字 | diff --git a/backend/docs/25-gameplay-v3.md b/backend/docs/25-gameplay-v3.md new file mode 100644 index 0000000..693ec5a --- /dev/null +++ b/backend/docs/25-gameplay-v3.md @@ -0,0 +1,173 @@ +# 25 選戰卡牌第三版:讓人一場接一場(玩法規格) + +> 2026-10-28。使用者要「把遊戲改得非常好玩、一場玩過一場、不中斷、更豐富」,並提出「每個候選人要有本命區、本命技能, +> 搭配某些卡片」;之後又要求「增加遊戲的黏著度以及可完成度,不然好像隨完即丟」。本文件是給實作用的規格:每一節寫現況(附程式位置與數據)、要加什麼、怎麼改、怎麼驗收。 +> 所有數字都是起始值,一律用 `apps/sim` 的 `rogue-balance`、`career-balance` 跑過再定案。 + +## 實作狀態(2026-10-28) + +| 節 | 狀態 | 實際做法 | +|---|---|---| +| 1a 本命區 | 完成 | `rogue/src/archetypes.ts` 的 `homeTowns`;雙方都有。你的牌 ×1.2、失守聲勢 −2;攻下對手的本命區聲勢 +2、對手下週少一個行動(`rivalStun`);對手在自己本命區 ×1.2。新牌「回鄉造勢」(`homecoming`,只能打在本命區) | +| 1b 類型與技能 | 完成(數字已依模擬調過) | 六種類型照規格,調整:黑馬型每點聲勢 +12%(規格 +16% 太強)、財務型每週 +150 萬、地面牌 −5%。真實候選人:資歷三項取最高,同級比實際數字超過門檻多少;資歷都是 0 才看經費(多 → 財務型,少 → 黑馬型)。2022 縣市長 42 位主要候選人:組織 20、媒體 9、資深 7、財務 5、黑馬 1。每日一戰也套用。對手的類型還沒做 | +| 1c 接上流派 | 完成 | 下一站、物資行裡和類型搭配的牌、幕僚權重 ×1.5,牌面標「適合你的類型」 | +| 7 再來一局 | 部分 | 結果頁:贏了就有「挑戰逆風 N+1 級」(已解鎖就出現,不只剛解鎖那次)、Enter 直接再來、「攻下一塊地盤」(隨機挑還沒打下的縣市開新局)。出牌不等伺服器、快速模式還沒做 | +| 8 跨局進度 | 部分 | 完成度:全台制霸(22 縣市+總統大選)、六種類型、類型逆風挑戰(每種類型 0–10 級)、成就;大廳一條、圖鑑完整面板(`web/src/game/rogue/Completion.tsx`、`progress.ts`)。聲望解鎖新牌還沒做 | +| 2、3、4、5、6 | 還沒做 | 流派核心牌、對手規則與精英站、隨機行事曆、局中小勝利、難度重調 | + +模擬(`node apps/sim/src/rogue-balance.ts --archetypes all`,桃園 2022 勢均力敵,每種 80 局):「打得好」六種類型都 100% 勝,平均差距 +7.8~+12 個百分點; +標準難度對會打的人太簡單的問題(第 6 節)還在,目前靠「贏了直接挑戰下一級逆風」與類型逆風挑戰讓會打的人往上爬。 + +## 0. 現況診斷 + +| 問題 | 證據 | +|---|---| +| 最佳解太明顯 | `rogue-balance`:標準難度「看預估挑最划算的」勝率 100%(雙方),平均贏 7.9 個百分點;逆風 6 才降到 85%/77%。前端把每張手牌打在每一區的票數都算好(`view.ts previewsFor`) | +| 流派沒有身分感 | 只拿某一派牌,差距都在 2.3 個百分點內;67 張牌裡單區加票 16 張、全市加票 12 張,改規則的能力牌只有 2 張(媒體訓練、蹲點研究) | +| 選誰都一樣 | 真實候選人只有 `recordAbilities`(`apps/server/src/people-routes.ts`)算出的 0–2 級媒體/組織/口才,財務、清廉固定 0;效果是口才每級 +4%、組織每級盾 +10%、媒體每級爆紅 +3%;每日一戰完全不套用。出身專屬牌只給自創角色。沒有本命區 | +| 每局行程一樣 | `scenes.ts`:`DEBATE_WEEK = 3`、`POLL_WEEK = 4`、`CRISIS_WEEK = 6`;`rival.ts`:`BIG_RALLY_WEEK = 7` | +| 對手單薄 | 7 種意圖;三種風格只是倍率(`STYLE_WEIGHTS`、組織戰盾 ×1.4、空戰廣告 ×1.2) | +| 局中回饋小 | 翻轉一區只有聲勢 +1(`mechanics.ts`),插旗每週 20 萬 | +| 跨局目標分散 | 政績點、小鎮幣、聲望、政策島、成就、逆風、生涯同時存在 | + +## 1. 候選人特色:本命區+類型技能(第一優先) + +參考:《殺戮尖塔》每個角色的起始遺物與專屬牌、《小丑牌》每副牌的開局規則、《怪物火車》的氏族。 +目標:選不同候選人,第一週就打得不一樣。 + +### 1a 本命區 + +- **怎麼決定**(只用客觀資料,附依據文字):開局時(`rogue/src/setup.ts`)對每一區算 `lean.you − 全縣市平均 lean.you`, + 只看選舉人數至少佔全市 3% 的區,取最大的 1 區(縣市長、立委)或 2 個縣市(總統)。自創角色在政治生涯用家鄉那一區(里長、議員關就是自己的里那一塊)。 + 對手用同樣的算法也有本命區(規則對稱)。 +- **資料**:`TownSetup.home?: "you" | "rival"` → `TownState.home`;`protocol/src/rogue.ts` 的 `RogueTown` 加 `home`;`RunOptions.homeBasis`(「這區你的底盤比全市平均高 X 個百分點」)。 +- **效果**(常數放 `state.ts`): + - `HOME_MULT = 1.2`:你的牌打在你的本命區 +20%(在 `cards.ts` 的加成鏈裡,跟 `POLICY_HOME` 同一段寫法,畫面上一樣逐項跳出「本命區 ×1.2」)。 + - 代價與高潮:本命區的旗被翻走,你的聲勢 −2(一般是對手 +1);你翻走**對手**的本命區,你的聲勢 +2,且對手下週少一個行動。 + - 每個人開局牌組多一張「回鄉造勢」(新牌 `homecoming`;插圖先共用農會總幹事的 `homecoming`,之後用 `art/` 腳本補專屬插圖):1 體力,只能打在本命區,+2,600(以全市 100 萬人為基準,照 `scale` 縮放)、聲勢 +1。 +- **畫面**:選人畫面在小地圖上標本命區並寫依據;局內地圖本命區加一個家的圖示;對手的本命區也標出來(變成目標)。 + +### 1b 類型與技能 + +- **怎麼決定**: + - 真實候選人:用 `recordAbilities` 已經算好的媒體、組織、口才三項,取最高的一項當類型;同分依 媒體 → 組織 → 口才;全部 0 → 黑馬型。 + `candidateStats(...).wealth ≥ 8` 且三項都不到 2 級 → 財務型(財力來自劇本的真實政治獻金,`content/src/candidates.ts`)。 + - 自創角色:出身對應的能力(`protocol/src/origins.ts` 的 `ORIGINS`)就是類型,五種都可能。 + - **每日一戰也要套用**(目前 `rogue-routes.ts:159` 每日一戰把能力設成 null):同一天大家玩同一個人、同一個類型,仍然公平。 +- **資料**:`RunOptions.archetype: "media" | "organization" | "eloquence" | "finance" | "integrity" | "newcomer"`; + 技能用現有的 `powers` 機制實作(`powers: ["arch_media"]` 這類),畫面上和「媒體訓練」一樣常駐顯示。舊的每級小加成保留給政治生涯練等用。 +- **技能表**(強項要「改規則」而不是小 %;弱點一律是中性的機制,不寫對真人的評價,見第 9 節): + +| 類型 | 依據 | 技能(強項) | 弱點 | 開局專屬牌(取代 1 張掃街) | +|---|---|---|---|---| +| 媒體型 | 單次最高得票多 | 空戰牌(media、online、tv)+15%;每週第一次爆紅成功,下一張空戰牌再 ×2 | 對手的批評 +20% | 臉書直播(`live`) | +| 組織型 | 當選次數多 | 每週開始,本命區自動有一座樁腳(盾 = 佈樁基礎值);佈樁牌每週第一張不花體力 | 空戰牌 −15% | 志工大隊(`volunteers`) | +| 資深型 | 從政年資長 | 記者會類(press)+20%;辯論多一張論點;「記者追問」不花體力 | 年輕人多的區 −15% | 政策白皮書(`whitepaper`) | +| 財務型 | 政治獻金多 | 每週資金 +100 萬;物資行八折;新牌「地毯式廣告」可以把錢換成票 | 地面牌 −10% | 募款餐會(`dinner`)多一張 | +| 清廉型 | 自創角色出身(醫師) | 黑函危機損失減半;「記者追問」不會被塞進牌組 | 每週資金 −20% | 巡迴義診(`origin_clinic`) | +| 黑馬型 | 沒有當選紀錄、小黨 | 聲勢每點 +16%(一般 +8%);每翻轉一區多抽 1 張 | 起始資金 −30% | 徒步掃街(`walkx`) | + +- **對手也有類型**(同一套算法,用對手的選舉紀錄):對手的類型決定 `rivalStyle`(媒體型 → air、組織型 → ground、其他 → balanced),並影響第 3 節的對手規則抽籤。 + +### 1c 接上流派 + +- 「拜會地方」三選一時,和類型相同派系的牌權重 ×1.5(`route.ts` 產生牌的地方)。 +- 牌組裡同一派系的牌到 4 張以上,該派系的核心牌(第 2 節)開始會出現在獎勵裡。 + +## 2. 流派與爆分 + +參考:《小丑牌》的小丑牌(乘數疊乘數)、《怪物火車》的兩條主線交叉。 +目標:組成形的單一流派,比混著打多 5–10 個百分點;各流派最好的打法彼此差 ±3 個百分點以內。 + +每派加 2 張核心牌(稀有)+1 位改規則的幕僚(`data.ts`、`advisors.ts`)。能力牌(power)打出後整局有效,沿用現有 `powers`。 + +| 派系 | 核心牌 1 | 核心牌 2 | 幕僚 | +|---|---|---|---| +| 地面 | 「走透透」能力:同一週每多打一張地面牌,之後的地面牌 +8%(疊加,週末歸零) | 「挨家挨戶」:這週在幾個不同的區出過牌,就 +幾倍的基礎票 | 「鐵腿」:一週在 3 個以上不同的區出牌,週末聲勢 +2 | +| 組織 | 「樁腳網」能力:週末每座還在的樁腳,在那區把盾剩下的一成轉成你的票 | 「全面動員令+」改成插旗的區每區 +票(現有 `mobilize` 加強) | 「派系協調人」:樁腳擋下對手的票,一半轉成你的 | +| 空戰 | 「聲量滾雪球」能力:每打一張空戰牌,聲量 +1(整局不歸零,上限 15);空戰牌 +4% × 聲量 | 「懶人包」:全市 +票,聲量每點多 5% | 「懶人包小編」:爆紅成功後,那張牌回到手上(每週一次) | +| 攻防 | 「反將一軍」:這週擋下的批評,一半變成你的票 | 「沙盤推演」能力:每週多看到對手下週的一個意圖 | 「危機變轉機」:每擋下一次攻擊,聲勢 +1 | +| 資金 | 「地毯式廣告」:花掉手上所有錢,每 100 萬換全市 +票 | 「小額募款」:資金 +,你插旗的區越多募越多 | 「精算師」:週末每 100 萬存款 +3%(錢滾錢,上限 1,000 萬) | + +- 新牌的插圖:`web/public/cards` 現有的 88 張都已經有牌或幕僚在用。先共用主題相近的(例如挨家挨戶用 `door_to_door`、懶人包用 `line_groups`),再用 `art/cards.tsv` 加題材、`art/regen-grokcli.sh` 補專屬插圖。 +- 新牌、新幕僚加進圖鑑(`view.ts catalog`)。 + +## 3. 對手規則與精英站 + +參考:《小丑牌》的 Boss 盲注(每關一條規則)、《殺戮尖塔》的精英怪。 + +- **對手規則**:開局從規則池抽 1 條(逆風 5 起抽 2 條),選人後、第 1 週前用一張卡片亮出來,局內常駐顯示(`rival.ts`;`RunState.rivalRules: string[]`)。 + 對手的類型決定池子的權重。起始規則池: + +| 規則 | 效果 | +|---|---| +| 名嘴加持 | 對手的批評 ×1.5;被你澄清時,對手聲勢 −1 | +| 地方大老 | 對手插旗的區,你要多領先 4 個百分點才翻得動 | +| 大打空戰 | 對手每週多一個電視或網路行動 | +| 鐵票區 | 對手本命區的盾 ×2 | +| 網路謠言 | 每週隨機一區你的票被拉走一點;打探成功可以停掉一週 | +| 地毯式掃街 | 對手的掃街會擴散到隔壁區兩成 | +| 後發制人 | 現有的風格改成規則:前期弱、每週成長多 | +| 形象牌 | 對手不受黑函影響,但辯論輸了損失加倍 | + +- **精英站**:`route.ts` 的下一站多一種「地方派系談判」(`StopKind` 加 `elite`):給一個這週的目標(例如「這週在某區 +X 票」), + 下週結算時達成給稀有幕僚或升級兩張牌,沒達成聲勢 −1。第 3、5 週各有一次機會出現。 +- **看得到前方**:下一站的面板灰色顯示「下下週」會出現的兩扇門(`prepareRoute` 先抽好兩週),讓玩家規劃。 + +## 4. 每局行程隨機 + +- 開局用種子排行事曆,存在 `RunState.schedule`(`rules.ts createRun`):辯論在第 3–5 週、民調在第 4–5 週、黑函在第 5–6 週,不重疊;對手大型造勢第 7 週、選前之夜最後一週不變。 +- 另外依縣市特色抽 0–2 個「地方事件週」(`setup.ts` 已有區的特色):宮廟多 → 遶境週(宮廟牌 ×2、造勢會被搶);客家庄 → 義民祭;人口密集 → 捷運通車剪綵;長輩多 → 重陽敬老。 +- 畫面上方加一條行事曆,事件週事先看得到。 +- `scenes.ts sceneFor` 改讀 `s.schedule`,不再用 `DEBATE_WEEK` 等常數判斷(常數保留當預設值給新手教學)。 + +## 5. 局中的小勝利 + +- **翻區**:每翻轉一區,立刻抽 1 張牌(每週最多 2 次),聲勢照舊 +1;翻走對手本命區見 1a。 +- **民調週**:領先 → 三選一稀有牌;落後 → 現有的「悲情催票」再加下週體力 +1。 +- **結果頁**:最大的字是「贏/差 N 票」,下面標出「最關鍵的一區」(差距最小、被翻最多次的區)。 + +## 6. 決策要有張力 + +- **預估**:手牌上的數字只算基礎值與看得到的加成;爆紅、擴散、組合拳改成「+?」圖示,機率牌顯示範圍。新手教學維持完整預估。 +- **難度重調**(`rival.ts` 的 `RIVAL_POWER`、`intentsThisWeek`;`mechanics.ts` 的插旗門檻): + 標準難度目標:「打得好」75–85%、「隨手玩」35–45%(目前 100%/53%)。 + 方向:對手每週行動從第 4 週起 +1、意圖數字略大,讓「擋對手」和「自己拉票」搶同一份體力。 +- 重調後重跑逆風 0、3、6、10 與生涯的平衡表,寫回 docs/22、23。 + +## 7. 不中斷、再來一局 + +- **結果頁**(`web/src/game/rogue/finale.tsx`):主要按鈕「再來一局(逆風 +1)」,同劇本、同候選人;次要按鈕「換一場」(隨機挑一場沒打過的);Enter 鍵直接再來。 +- **出牌不等伺服器**(`RogueScreen.tsx`):先用預估值更新畫面和跳字,伺服器回來再校正(不同時只修正數字,不重播動畫)。 +- **快速模式**(設定):動畫時間減半;開票夜按住任一鍵快轉。 +- 目標一局 15–20 分鐘:前端記錄每週花的時間,寫進 `progress.ts` 的統計。 + +## 8. 跨局進度收斂 + +參考:《殺戮尖塔》用勝場解鎖新牌、《小丑牌》每副牌各自的賭注等級、《黑帝斯》輸了也有收穫。 + +- **一種主要進度**:每局(不論輸贏)依表現給「聲望」,聲望解鎖第 2 節的核心牌與新幕僚(一開始鎖住,圖鑑顯示怎麼拿)。小鎮幣只買外觀(維持 docs/24),政績點只給政策島。 +- **逆風分類型記**:`progress.ts` 的最高逆風改成依類型記(媒體型逆風 4、組織型逆風 2…),選人畫面顯示。 +- 輸了也給:本局用到的流派累積「熟練度」,滿了解鎖該派的第 2 張核心牌。 + +## 9. 真實人物的界線(docs/14) + +- 本命區、類型只用客觀資料(選民模型底盤、中選會選舉紀錄、政治獻金),每一項附依據文字(沿用 `abilitiesBasis`)。 +- 類型名稱、弱點都是中性的機制描述(媒體型、組織型…;「空戰牌 −15%」),不寫「金權」「奧步」這類評價。 +- 規則對所有政黨、所有候選人一樣;AI 控制的真實人物照舊不用奧步。 + +## 10. 實作順序與驗收 + +| 步驟 | 內容 | 主要檔案 | 驗收 | +|---|---|---|---| +| 1 | 本命區、類型技能、回鄉造勢、每日一戰套用類型 | `rogue/src/setup.ts`、`state.ts`、`cards.ts`、`rules.ts`、`view.ts`、`data.ts`;`protocol/src/rogue.ts`;`apps/server/src/rogue-routes.ts`;`web/src/game/rogue/RogueStart.tsx`、`RogueScreen.tsx` | 新測試:本命區算法、每種類型的技能;`bots.ts` 加依類型的模擬;各類型「打得好」勝率差 ±5 個百分點內 | +| 2 | 流派核心牌與幕僚、獎勵權重 | `data.ts`、`advisors.ts`、`route.ts`、圖鑑 | 單一流派 greedy 比混打多 5–10 個百分點;流派之間 ±3 | +| 3 | 對手規則、精英站、隨機行事曆 | `rival.ts`、`route.ts`、`scenes.ts`、`state.ts` | 每條規則有測試;同一個種子重播結果相同 | +| 4 | 翻區、民調獎勵;結果頁再來一局 | `mechanics.ts`、`scenes.ts`、`web/.../finale.tsx` | 瀏覽器實測:結果頁一鍵開新局 | +| 5 | 難度重調、預估顯示 | `rival.ts`、`mechanics.ts`、`view.ts`、前端手牌 | 標準難度 greedy 75–85%、casual 35–45% | +| 6 | 出牌不等伺服器、快速模式 | `web/src/game/rogue/RogueScreen.tsx`、設定 | 網路延遲 300 ms 時出牌沒有停頓感 | +| 7 | 跨局進度收斂 | `web/src/game/rogue/progress.ts`、`Collection.tsx` | 舊進度能讀、不歸零 | + +- **存檔**:`RunState` 加欄位後 `SAVE_VERSION` 升到 3,`migrateRun`(`scenes.ts`)把舊存檔補上預設值(沒有本命區、類型 newcomer、行事曆用舊的固定週次)。 + `backend/data/runs/` 有進行中的局,不要直接拒讀舊版。 +- 每一步:更新 `packages/rogue/test`、跑 `apps/sim` 的 `rogue-balance`、`career-balance`,結果寫回 docs/22、23。 diff --git a/backend/docs/README.md b/backend/docs/README.md index d6f3732..8b71190 100644 --- a/backend/docs/README.md +++ b/backend/docs/README.md @@ -53,6 +53,7 @@ backend/packages ──► backend/apps/server(Fastify,REST /api)──► | 檔案 | 內容 | |---|---| | `setup.ts`、`local.ts` | 開局:用選民模型算各區(或各里)底盤與地區特色;`local.ts` 是里長、議員關 | +| `archetypes.ts` | 候選人特色(docs/25):本命區算法、六種類型的技能/弱點/專屬牌(類型由伺服器依中選會紀錄或出身決定) | | `rules.ts` | `createRun`、`endWeek`、`choose`、`ultimate`,以及從 `cards.ts` 轉出的 `playCard`:每個動作回傳新的狀態 | | `state.ts` | `RunState`、`TOTAL_WEEKS = 8`、存檔版本 `SAVE_VERSION` 與 `migrateRun` | | `data.ts`、`cards.ts` | 牌的資料與效果 | @@ -91,9 +92,12 @@ backend/packages ──► backend/apps/server(Fastify,REST /api)──► | `creator`、`shop`、`art` | 捏人物、服裝店、頭像繪製(部件目錄,docs/24) | | `people` | 歷屆參選人 | | `board3d`、`stage`、`news`、`audio`、`ui`、`hud` | 3D 棋盤、地圖、新聞台、音樂音效、共用元件、設定 | -| `../viewer`、`../map` | 資料檢視器(開發用) | +| `../viewer`、`../map` | 資料檢視器(開發用:資料檢視器、美術總覽、頭像對照、部件檢查只有 `pnpm dev` 打得開,正式版不打包) | -玩家進度沒有帳號,存在瀏覽器 `localStorage`(鍵都以 `tongsuan.` 開頭:卡牌進度、生涯、政策島、外觀與小鎮幣、自創角色、小遊戲紀錄、設定)。 +玩家進度沒有帳號,存在瀏覽器 `localStorage`(鍵都以 `tongsuan.` 開頭:卡牌進度與完成度、生涯、政策島、外觀與小鎮幣、自創角色、小遊戲紀錄、設定)。 + +載入:`index.html` 內嵌載入畫面(不等任何下載),首頁等 3D 小鎮搭好才淡出(`src/splash.ts`);three.js 和一局卡牌的畫面用到才下載; +3D 小鎮依實際每秒張數自動降畫質,偵測到沒有顯示卡(軟體繪圖)直接用最低畫質。正式版用 `pnpm start`(建置後 `vite preview`),比 `pnpm dev` 小三倍以上;API 回應由伺服器壓縮(`@fastify/compress`)。 素材:`web/public/assets/` 是 CC0/OFL 素材(逐檔記在 `LICENSES.md`);`web/public/cards/` 是卡牌插圖,用 `art/` 裡的腳本產生;頭像部件是原創 SVG,放在 `backend/packages/protocol/art/avatar/`,`pnpm avatar:build` 轉成程式碼。 @@ -147,5 +151,6 @@ cd backend/data/pipeline && .venv/bin/pytest && .venv/bin/ruff check src tests | [22-rogue-v2.md](22-rogue-v2.md) | 選戰卡牌:玩法、機制、平衡 | | [23-career-and-meta.md](23-career-and-meta.md) | 政治生涯、政策島、小遊戲、歷屆參選人與資歷分數 | | [24-avatar-shop-plan.md](24-avatar-shop-plan.md) | 紙娃娃部件目錄、畫風、服裝店;附開放真錢前的法規整理 | +| [25-gameplay-v3.md](25-gameplay-v3.md) | 選戰卡牌第三版:本命區、類型技能、完成度(已做);流派、對手規則、隨機行事曆、難度(規格) | | [rubric-v1.md](rubric-v1.md) | AI 評分規則(由評分管線產生) | | [appendix-1994-original.md](appendix-1994-original.md) | 1994 年原作《臺灣模擬選戰》的拆解紀錄 | diff --git a/backend/packages/content/src/actions-more.ts b/backend/packages/content/src/actions-more.ts index ba97643..846222b 100644 --- a/backend/packages/content/src/actions-more.ts +++ b/backend/packages/content/src/actions-more.ts @@ -539,7 +539,7 @@ export const MORE_ACTIONS: readonly ActionDef[] = [ id: "impersonate", name: "冒名騷擾(午夜拜票)", category: "dark", - description: "半夜冒用對手的名義打電話、傳簡訊騷擾選民,讓人討厭對手。原作的「午夜拜票」。", + description: "半夜冒用對手的名義打電話、傳簡訊騷擾選民,讓人討厭對手。", slots: ["midnight"], actors: ["team"], target: "opponent", @@ -554,7 +554,7 @@ export const MORE_ACTIONS: readonly ActionDef[] = [ id: "frame_vote_buying", name: "栽贓買票", category: "dark", - description: "安排人用對手的名義買票,讓對手被懷疑。原作的「為敵買票」。知情的人很多,被揭穿就全毀。", + description: "安排人用對手的名義買票,讓對手被懷疑。知情的人很多,被揭穿就全毀。", slots: ["midnight"], actors: ["team"], target: "town", @@ -567,7 +567,7 @@ export const MORE_ACTIONS: readonly ActionDef[] = [ id: "staged_attack", name: "苦肉計", category: "dark", - description: "自導自演受害事件,博取同情、拉高熱度。被揭穿就全毀。原作的「假槍擊」。", + description: "自導自演受害事件,博取同情、拉高熱度。被揭穿就全毀。", slots: ["weekdayEvening", "weekendEvening"], actors: ["candidate"], target: "city", diff --git a/backend/packages/protocol/data/avatar-catalog.json b/backend/packages/protocol/data/avatar-catalog.json index 048bbf3..44aa62e 100644 --- a/backend/packages/protocol/data/avatar-catalog.json +++ b/backend/packages/protocol/data/avatar-catalog.json @@ -14,7 +14,7 @@ { "id": "pixel", "name": "復刻像素", - "note": "致敬 1994 年原作:縮成小點陣、16 色、方塊放大" + "note": "縮成小點陣、16 色、方塊放大" }, { "id": "sticker", diff --git a/backend/packages/protocol/src/avatar/catalog.generated.ts b/backend/packages/protocol/src/avatar/catalog.generated.ts index 6289fd8..b347aeb 100644 --- a/backend/packages/protocol/src/avatar/catalog.generated.ts +++ b/backend/packages/protocol/src/avatar/catalog.generated.ts @@ -17,7 +17,7 @@ export const AVATAR_CATALOG: AvatarCatalog = { { "id": "pixel", "name": "復刻像素", - "note": "致敬 1994 年原作:縮成小點陣、16 色、方塊放大" + "note": "縮成小點陣、16 色、方塊放大" }, { "id": "sticker", diff --git a/backend/packages/protocol/src/rogue.ts b/backend/packages/protocol/src/rogue.ts index 4a0e41d..5a940db 100644 --- a/backend/packages/protocol/src/rogue.ts +++ b/backend/packages/protocol/src/rogue.ts @@ -11,6 +11,10 @@ export type RogueTrait = z.infer; export const RogueOwner = z.enum(["you", "rival"]).nullable(); +/** 候選人類型(docs/25):真實候選人依中選會選舉紀錄、自創角色依出身;決定技能與弱點 */ +export const RogueArchetype = z.enum(["media", "organization", "eloquence", "finance", "integrity", "newcomer"]); +export type RogueArchetype = z.infer; + export const RogueTown = z.object({ code: z.string(), name: z.string(), @@ -34,6 +38,8 @@ export const RogueTown = z.object({ played: z.array(z.object({ id: z.string(), name: z.string(), art: z.string() })), /** 插旗:已表態的票裡領先 8 個百分點以上 */ flag: RogueOwner, + /** 本命區(docs/25):你的(牌 ×1.2)或對手的(翻過來聲勢大增);舊存檔沒有 */ + home: RogueOwner.default(null), }); export type RogueTown = z.infer; @@ -246,6 +252,8 @@ export const RogueOffer = z.object({ /** 商店價格與是否已賣出 */ price: z.number().int().nullable(), sold: z.boolean(), + /** 和你的候選人類型搭配(docs/25):比較常出現,牌面標「適合你的類型」 */ + fit: z.boolean().default(false), }); export type RogueOffer = z.infer; @@ -358,6 +366,21 @@ export const RogueView = z.object({ others: z.array(CandidatePublic), /** 雙方的代表色(政黨色;同一個顏色或教學關卡用別的顏色區分) */ colors: z.object({ you: z.string(), rival: z.string() }), + /** 你的候選人特色(docs/25):類型、技能、弱點與依據;新手教學、舊存檔是 null */ + identity: z + .object({ + archetype: RogueArchetype, + name: z.string(), + skill: z.string(), + weakness: z.string(), + /** 類型的依據(選舉紀錄或出身) */ + basis: z.string().nullable(), + /** 本命區與依據 */ + home: z.string(), + rivalHome: z.string(), + }) + .nullable() + .default(null), /** 對手性格 */ rivalTrait: z.object({ name: z.string(), text: z.string() }), towns: z.array(RogueTown), @@ -425,6 +448,8 @@ export const RogueCatalog = z.object({ feats: z.array(z.object({ id: z.string(), name: z.string(), text: z.string() })), ascension: z.array(z.string()), events: z.array(RogueEvent), + /** 候選人類型(docs/25):名稱、技能、弱點(完成度的類型挑戰用) */ + archetypes: z.array(z.object({ id: RogueArchetype, name: z.string(), skill: z.string(), weakness: z.string() })).default([]), }); export type RogueCatalog = z.infer; diff --git a/backend/packages/rogue/src/archetypes.ts b/backend/packages/rogue/src/archetypes.ts new file mode 100644 index 0000000..819a741 --- /dev/null +++ b/backend/packages/rogue/src/archetypes.ts @@ -0,0 +1,121 @@ +import type { RogueArchetype } from "@election2026/protocol"; +import type { TownSetup } from "./state.ts"; + +/** + * 候選人特色(docs/25 第 1 節):本命區+類型技能,讓選不同的人第一週就打得不一樣。 + * 類型只從客觀資料來(中選會選舉紀錄、政治獻金、自創角色的出身);名稱與弱點都是中性的機制描述,不評價真人(docs/14)。 + */ +export interface ArchetypeDef { + name: string; + /** 強項:改規則的技能 */ + skill: string; + /** 弱點:中性的機制 */ + weakness: string; + /** 開局專屬牌 */ + card: string; + /** 專屬牌取代開局牌組的哪一張(null 是多加一張) */ + replaces: string | null; + /** 搭配的牌(標籤)與幕僚流派:下一站、物資行比較常出現(docs/25 第 1c 節) */ + tags: string[]; + school: "ground" | "air" | "org" | "money" | "defend"; +} + +export const ARCHETYPES: Record = { + media: { + name: "媒體型", + skill: "空戰牌(電視、網路、直播)+15%;每週第一次爆紅,下一張空戰牌效果加倍", + weakness: "對手的批評 +20%", + card: "live", + replaces: "canvass", + tags: ["media"], + school: "air", + }, + organization: { + name: "組織型", + skill: "每週開始,本命區自動有一座樁腳;每週第一張佈樁牌不花體力", + weakness: "空戰牌 −15%", + card: "volunteers", + replaces: "canvass", + tags: ["org", "defend"], + school: "org", + }, + eloquence: { + name: "資深型", + skill: "記者會、座談類的牌 +20%;辯論多一張論點;回應記者追問不花體力", + weakness: "年輕人多的區 −15%", + card: "whitepaper", + replaces: "canvass", + tags: ["press"], + school: "defend", + }, + finance: { + name: "財務型", + skill: "每週資金 +150 萬;競選物資行八折", + weakness: "地面牌 −5%", + card: "dinner", + replaces: null, + tags: ["money"], + school: "money", + }, + integrity: { + name: "清廉型", + skill: "黑函危機損失減半;記者追問不會被塞進牌組", + weakness: "每週收入 −20%", + card: "origin_clinic", + replaces: "canvass", + tags: ["ground"], + school: "ground", + }, + newcomer: { + name: "黑馬型", + skill: "每一點聲勢 +12%(一般 +8%);每翻轉一區多抽 1 張牌", + weakness: "起始資金 −30%", + card: "walk", + replaces: "canvass", + tags: ["ground"], + school: "ground", + }, +}; + +/** 下一站、物資行裡和類型搭配的牌、幕僚,出現的權重 */ +export const AFFINITY_WEIGHT = 1.5; + +/** 本命區的牌效果 */ +export const HOME_MULT = 1.2; +/** 對手打在自己本命區的行動 */ +export const RIVAL_HOME_MULT = 1.2; +/** 本命區被翻走:你的聲勢少多少 */ +export const HOME_LOST_MOMENTUM = 2; +/** 翻走對手的本命區:你的聲勢多多少(一般翻區 +1) */ +export const HOME_TAKEN_MOMENTUM = 2; +/** 本命區只看選舉人數至少佔全區這個比例的區 */ +const HOME_MIN_SHARE = 0.03; + +/** + * 本命區:底盤比全區平均高最多的區(只看夠大的區)。總統選舉(區是縣市、20 個以上)取 2 個。 + * 回傳區代碼;exclude 是已經被另一方挑走的區 + */ +export function homeTowns(towns: readonly TownSetup[], side: "you" | "rival", exclude: ReadonlySet = new Set()): string[] { + const voters = towns.reduce((a, t) => a + t.voters, 0) || 1; + const mean = towns.reduce((a, t) => a + t.lean[side] * t.voters, 0) / voters; + const n = towns.length >= 20 ? 2 : 1; + return towns + .filter((t) => t.voters >= voters * HOME_MIN_SHARE && !exclude.has(t.code)) + .map((t) => ({ code: t.code, d: t.lean[side] - mean })) + .sort((a, b) => b.d - a.d) + .slice(0, n) + .map((x) => x.code); +} + +/** 本命區的依據文字:「這區你的底盤比全區平均高 6.2 個百分點」 */ +export function homeBasis(towns: readonly TownSetup[], side: "you" | "rival", codes: readonly string[]): string { + const voters = towns.reduce((a, t) => a + t.voters, 0) || 1; + const mean = towns.reduce((a, t) => a + t.lean[side] * t.voters, 0) / voters; + return codes + .map((code) => { + const t = towns.find((x) => x.code === code); + return t ? `${t.name}(底盤比全區平均高 ${((t.lean[side] - mean) * 100).toFixed(1)} 個百分點)` : null; + }) + .filter(Boolean) + .join("、"); +} diff --git a/backend/packages/rogue/src/cards.ts b/backend/packages/rogue/src/cards.ts index 25e4877..2ea949b 100644 --- a/backend/packages/rogue/src/cards.ts +++ b/backend/packages/rogue/src/cards.ts @@ -1,7 +1,8 @@ import { ADVISOR_BY_ID } from "./advisors.ts"; +import { HOME_MULT } from "./archetypes.ts"; import { POWERS, TRAIT_LABELS, cardDef, hasKeyword, type CardDef } from "./data.ts"; import { BUILDING_BY_ID, POLICY_HOME, POLICY_HOME_STEP, policyTargetOf } from "./meta.ts"; -import { addMomentum, asc, cityVotes, drawCards, eventMult, eventOf, has, loseVotes, moveVotes, spread, updateFlags } from "./mechanics.ts"; +import { addMomentum, addStatus, asc, cityVotes, drawCards, eventMult, eventOf, has, isArch, loseVotes, moveVotes, spread, updateFlags } from "./mechanics.ts"; import { addTally, cloneState, newCard, rand, type CardInst, type Intent, type RunState, type TownState } from "./state.ts"; /** 組合拳:同一週同一區打出第 n 種不同的牌,這張牌的加成 */ @@ -17,6 +18,9 @@ export const defOf = (c: CardInst): CardDef => cardDef(c.id, c.up)!; export function cardCost(s: RunState, card: CardDef): { energy: number; money: number } { if ((card.id === "reporter" || card.id === "storm") && has(s, "crisis_team")) return { energy: 0, money: 0 }; + // 資深型:回應記者追問不花體力;組織型:每週第一張佈樁牌不花體力 + if ((card.id === "reporter" || card.id === "storm") && isArch(s, "eloquence")) return { energy: 0, money: 0 }; + if (card.effect.kind === "shield" && isArch(s, "organization") && !(s.weekCards ?? []).some((id) => cardDef(id)?.effect.kind === "shield")) return { energy: 0, money: card.money }; const freeOnline = has(s, "social_editor") && card.tags.includes("online") && s.onlinePlayed === 0; const ads = has(s, "ad_planner") && (card.id === "tv" || card.id === "online"); return { energy: freeOnline ? 0 : card.cost, money: Math.round(card.money * (ads ? 0.7 : 1)) }; @@ -99,13 +103,24 @@ export function boost(s: RunState, card: CardDef, town: TownState | null): Boost if (card.tags.includes("press") && ability("eloquence")) apply(1 + 0.04 * ability("eloquence"), `口才 ${ability("eloquence")} 級`); if (card.tags.includes("ground") && ability("organization")) apply(1 + 0.03 * ability("organization"), `組織 ${ability("organization")} 級`); if (card.tags.includes("media") && ability("media")) apply(1 + 0.05 * ability("media"), `媒體 ${ability("media")} 級`); + // 本命區與候選人類型(docs/25) + if (town?.home === "you") apply(HOME_MULT, `本命區 ×${HOME_MULT}`); + const air = card.tags.includes("media"); + if (isArch(s, "media") && air) apply(1.15, "媒體型 ×1.15"); + if (isArch(s, "media") && air && s.viral?.boost) apply(2, "爆紅加持 ×2"); + if (isArch(s, "organization") && air) apply(0.85, "組織型(空戰)×0.85"); + if (isArch(s, "eloquence") && card.tags.includes("press")) apply(1.2, "資深型 ×1.2"); + if (isArch(s, "eloquence") && town?.traits.includes("young")) apply(0.85, "資深型(年輕人多)×0.85"); + if (isArch(s, "finance") && card.tags.includes("ground")) apply(0.95, "財務型(地面)×0.95"); const ev = eventMult(s, card.tags); apply(ev, `${eventOf(s).title} ×${ev}`); if (s.week === s.totalWeeks && card.tags.includes("rally")) apply(EVE_RALLY, `選前之夜 ×${EVE_RALLY}`); if (has(s, "opener") && s.playedThisWeek === 0) apply(1.5, "開場哥 ×1.5"); if (has(s, "night_owl") && s.energy === 0 && (s.paying ?? 0) > 0) apply(1.5, "夜貓子 ×1.5"); if (asc(s, 8)) apply(0.92, "逆風 ×0.92"); - if (s.momentum > 0) apply(1 + MOMENTUM_STEP * s.momentum, `聲勢 +${Math.round(MOMENTUM_STEP * s.momentum * 100)}%`); + // 黑馬型:每一點聲勢的效果是一般的 1.5 倍 + const step = MOMENTUM_STEP * (isArch(s, "newcomer") ? 1.5 : 1); + if (s.momentum > 0) apply(1 + step * s.momentum, `聲勢 +${Math.round(step * s.momentum * 100)}%`); return { mult, notes }; } @@ -206,6 +221,10 @@ function resolve(s: RunState, card: CardDef, town: TownState | null, intent: Int const mult = expect ? chance * e.hit + (1 - chance) * e.miss : hit ? e.hit : e.miss; out.notes.push(...b.notes, expect ? `${Math.round(chance * 100)}% 機率 ×${e.hit}(預估取平均)` : hit ? (e.hit > 1 ? "爆紅!" : "失言!") : ""); gainCity(s, card, e.base * b.mult * mult, undefined, out, hit ? `${card.name}${e.hit > 1 ? "爆紅" : "失言"}` : card.name); + if (hit && e.hit > 1 && isArch(s, "media") && !s.viral?.used) { + s.viral = { used: true, boost: true }; + out.notes.push("媒體型:下一張空戰牌效果加倍"); + } break; } case "counter": { @@ -264,10 +283,7 @@ function resolve(s: RunState, card: CardDef, town: TownState | null, intent: Int s.money += amount; out.notes.push(`資金 +${amount} 萬`); out.log.push({ side: "you", text: `${card.name}:資金 +${amount} 萬`, town: null, votes: 0 }); - if (e.curse) { - s.discard.push(newCard(s, e.curse)); - out.notes.push("塞了一張「人情包袱」"); - } + if (e.curse && addStatus(s, e.curse)) out.notes.push("塞了一張「人情包袱」"); break; } case "base": { @@ -340,6 +356,7 @@ export function playCard(state: RunState, uid: string, target: string | null, ex if (card.target === "town") { town = s.towns.find((t) => t.code === target) ?? null; if (!town) return { error: "先選一區" }; + if (card.homeOnly && town.home !== "you") return { error: "只能打在你的本命區" }; } else if (card.target === "intent") { intent = counterable(s).find((i) => i.id === target) ?? null; if (!intent) return { error: "選一個對手在某一區的行動" }; @@ -356,7 +373,10 @@ export function playCard(state: RunState, uid: string, target: string | null, ex s.paying = cost.energy; const out: Played = { log: [], notes: [] }; s.log = out.log; + // 媒體型的爆紅加持:打出這張之前就有的,用在這張空戰牌上就消耗掉 + const boosted = s.viral?.boost === true; resolve(s, card, town, intent, expect, out); + if (boosted && card.tags.includes("media") && s.viral) s.viral.boost = false; const mark = town ?? (intent?.town ? s.towns.find((t) => t.code === intent!.town)! : null); if (mark && !mark.played.includes(card.id)) { mark.played.push(card.id); @@ -364,7 +384,7 @@ export function playCard(state: RunState, uid: string, target: string | null, ex } if (card.draw) drawCards(s, card.draw); // 政策卡的財源:記者追問、資金、全市流失一點票 - if (card.side?.curse) s.discard.push(newCard(s, card.side.curse)); + if (card.side?.curse) addStatus(s, card.side.curse); if (card.side?.money) { s.money = Math.max(0, s.money + card.side.money); out.log.push({ side: "you", text: `${card.name}:招商資金 +${card.side.money} 萬`, town: null, votes: 0 }); diff --git a/backend/packages/rogue/src/data.ts b/backend/packages/rogue/src/data.ts index 35ec695..e99cc29 100644 --- a/backend/packages/rogue/src/data.ts +++ b/backend/packages/rogue/src/data.ts @@ -74,6 +74,8 @@ export interface CardDef { draw?: number; /** 每週只能打一次(加體力的牌,避免一週無限循環) */ oncePerWeek?: boolean; + /** 只能打在你的本命區(docs/25) */ + homeOnly?: boolean; /** 打出後的附帶效果(政策卡的財源):塞一張狀態牌、資金增減、全市流失一點票 */ side?: { curse?: string; money?: number; backlash?: number }; /** 「+」版:沒寫的部分照原版,效果數字 ×1.35 */ @@ -105,6 +107,7 @@ export const CARDS: readonly CardDef[] = [ { id: "temple", name: "宮廟參拜", art: "temple_visit", cost: 1, money: 0, rarity: "basic", tags: ["ground", "temple"], target: "town", effect: { kind: "gain", base: 1260 }, bonus: [{ trait: "temples", mult: 2 }], text: "該區 +{n};宮廟多 ×2" }, { id: "stake", name: "拜託里長佈樁", art: "recruit_machine", cost: 1, money: 0, rarity: "basic", tags: ["org", "defend"], target: "town", effect: { kind: "shield", base: 2880, gain: 580 }, text: "該區樁腳 {n},擋對手這週在這區的行動" }, { id: "dinner", name: "募款餐會", art: "fundraiser_dinner", cost: 1, money: 0, rarity: "basic", tags: ["money"], target: "none", effect: { kind: "money", base: 300, perMomentum: 30 }, text: "資金 +{m} 萬;聲勢越高募越多" }, + { id: "homecoming", name: "回鄉造勢", art: "homecoming", cost: 1, money: 0, rarity: "basic", tags: ["ground", "rally"], target: "town", homeOnly: true, effect: { kind: "rally", base: 2600, momentum: 1 }, text: "只能打在你的本命區;該區 +{n},聲勢 +1" }, { id: "rally", name: "造勢晚會", art: "rally", cost: 2, money: 200, rarity: "basic", tags: ["ground", "rally"], target: "town", effect: { kind: "rally", base: 3450, momentum: 2, spill: 0.25 }, plus: { effect: { kind: "rally", base: 4140, momentum: 3, spill: 0.3 } }, text: "該區 +{n}、隔壁區兩成半,聲勢 +2" }, // ── 地面戰 ── diff --git a/backend/packages/rogue/src/index.ts b/backend/packages/rogue/src/index.ts index ed7b1ba..8cfdf0d 100644 --- a/backend/packages/rogue/src/index.ts +++ b/backend/packages/rogue/src/index.ts @@ -1,6 +1,7 @@ export * from "./state.ts"; export * from "./data.ts"; export * from "./advisors.ts"; +export * from "./archetypes.ts"; export * from "./content.ts"; export * from "./mechanics.ts"; export * from "./rules.ts"; diff --git a/backend/packages/rogue/src/mechanics.ts b/backend/packages/rogue/src/mechanics.ts index 972d332..63a6142 100644 --- a/backend/packages/rogue/src/mechanics.ts +++ b/backend/packages/rogue/src/mechanics.ts @@ -1,8 +1,19 @@ +import type { RogueArchetype } from "@election2026/protocol"; +import { HOME_LOST_MOMENTUM, HOME_TAKEN_MOMENTUM } from "./archetypes.ts"; import { EVENT_BY_ID, EVENTS, type EventDef } from "./data.ts"; -import { FLAG_LEAD, HAND_MAX, MOMENTUM_MAX, shuffle, townLead, type Owner, type RunState, type TownState } from "./state.ts"; +import { FLAG_LEAD, HAND_MAX, MOMENTUM_MAX, newCard, shuffle, townLead, type Owner, type RunState, type TownState } from "./state.ts"; /** 規則與對手 AI 共用的小工具:幕僚、每週事件、逆風難度、搬票、抽牌、插旗 */ export const has = (s: RunState, advisor: string): boolean => s.advisors.includes(advisor); +/** 你的候選人類型是不是 a(docs/25) */ +export const isArch = (s: RunState, a: RogueArchetype): boolean => s.options.archetype === a; + +/** 塞一張狀態牌進棄牌堆(記者追問、人情包袱…);清廉型不會被塞記者追問。回傳有沒有塞 */ +export function addStatus(s: RunState, id: string): boolean { + if ((id === "reporter" || id === "storm") && isArch(s, "integrity")) return false; + s.discard.push(newCard(s, id)); + return true; +} export const momentumMax = (s: RunState): number => MOMENTUM_MAX + (has(s, "rally_king") ? 2 : 0); export const eventOf = (s: RunState): EventDef => EVENT_BY_ID.get(s.event) ?? EVENTS[0]!; /** 逆風難度達到第 n 級 */ @@ -110,11 +121,29 @@ export function updateFlags(s: RunState): { gained: TownState[]; lost: TownState addMomentum(s, 1); s.stats.flips += gained.length; s.lastWeek.flips += gained.length; - for (const t of gained) s.log.push({ side: "you", text: `翻轉!你在${t.name}插旗,聲勢 +1`, town: t.code, votes: 0 }); + for (const t of gained) { + if (t.home === "rival") { + // 翻走對手的本命區:聲勢再多一點,對手下週少一個行動 + addMomentum(s, HOME_TAKEN_MOMENTUM - 1); + s.rivalStun = (s.rivalStun ?? 0) + 1; + s.log.push({ side: "you", text: `攻下${s.setup.rival.name}的本命區${t.name}!聲勢 +${HOME_TAKEN_MOMENTUM},對手下週少一個行動`, town: t.code, votes: 0 }); + } else s.log.push({ side: "you", text: `翻轉!你在${t.name}插旗,聲勢 +1`, town: t.code, votes: 0 }); + } + // 黑馬型:每翻轉一區多抽 1 張(出牌時才抽,週末結算翻的不抽) + if (isArch(s, "newcomer") && s.phase === "plan") { + drawCards(s, gained.length); + s.log.push({ side: "you", text: `黑馬氣勢:抽 ${gained.length} 張牌`, town: null, votes: 0 }); + } } if (lost.length) { addRivalMomentum(s, 1); - for (const t of lost) s.log.push({ side: "rival", text: `${s.setup.rival.name}在${t.name}翻盤插旗`, town: t.code, votes: 0 }); + for (const t of lost) { + s.log.push({ side: "rival", text: `${s.setup.rival.name}在${t.name}翻盤插旗`, town: t.code, votes: 0 }); + if (t.home === "you") { + addMomentum(s, -HOME_LOST_MOMENTUM); + s.log.push({ side: "rival", text: `你的本命區${t.name}失守:聲勢 −${HOME_LOST_MOMENTUM}`, town: t.code, votes: 0 }); + } + } } return { gained, lost }; } diff --git a/backend/packages/rogue/src/rival.ts b/backend/packages/rogue/src/rival.ts index f43a15b..9eeb800 100644 --- a/backend/packages/rogue/src/rival.ts +++ b/backend/packages/rogue/src/rival.ts @@ -1,7 +1,8 @@ import type { RogueIntentKind } from "@election2026/protocol"; +import { RIVAL_HOME_MULT } from "./archetypes.ts"; import { INTENT_BASE, INTENT_LABELS, INTENT_TAGS } from "./data.ts"; -import { addRivalMomentum, asc, cityVotes, eventMult, eventOf, has, loseVotes, moveVotes, spread } from "./mechanics.ts"; -import { newCard, pickWeighted, round10, type Intent, type RivalStyle, type RunState, type TownState } from "./state.ts"; +import { addRivalMomentum, addStatus, asc, cityVotes, eventMult, eventOf, has, isArch, loseVotes, moveVotes, spread } from "./mechanics.ts"; +import { pickWeighted, round10, type Intent, type RivalStyle, type RunState, type TownState } from "./state.ts"; /** * 對手 AI(docs/21、22):每週一開始就把要做的事亮在地圖上(像《殺戮尖塔》的敵人意圖),週末才執行。 @@ -69,7 +70,10 @@ function chooseTown(s: RunState, kind: RogueIntentKind, used: ReadonlySet { if ((count.get(kind) ?? 0) >= (LIMITS[kind] ?? 9)) return false; @@ -157,8 +163,7 @@ export function executeIntent(s: RunState, i: Intent): void { } const lost = cityVotes(s, -amount); s.log.push({ side: "rival", text: `${name}${label}`, town: null, votes: Math.round(lost) }); - s.discard.push(newCard(s, "reporter")); - s.log.push({ side: "system", text: "記者追問塞進你的牌組", town: null, votes: 0 }); + if (addStatus(s, "reporter")) s.log.push({ side: "system", text: "記者追問塞進你的牌組", town: null, votes: 0 }); s.lastWeek.attacked = true; return; } diff --git a/backend/packages/rogue/src/route.ts b/backend/packages/rogue/src/route.ts index 461a20f..d2422a5 100644 --- a/backend/packages/rogue/src/route.ts +++ b/backend/packages/rogue/src/route.ts @@ -1,9 +1,10 @@ import { ENCOUNTERS } from "@election2026/content"; import type { EncounterDef } from "@election2026/engine"; -import { ADVISORS } from "./advisors.ts"; +import { ADVISORS, type AdvisorDef } from "./advisors.ts"; +import { AFFINITY_WEIGHT, ARCHETYPES } from "./archetypes.ts"; import { STOP_EVENTS, STOP_EVENT_BY_ID } from "./content.ts"; import { REWARD_CARDS, cardDef, upgradable } from "./data.ts"; -import { addMomentum, asc, cityVotes, has, moveVotes } from "./mechanics.ts"; +import { addMomentum, asc, cityVotes, has, isArch, moveVotes } from "./mechanics.ts"; import { applyOutcome, choiceBlocked, rollChoice } from "./scenes.ts"; import type { MiniGameKind } from "@election2026/protocol"; import { MAX_ADVISORS, gainCard, newCard, pickWeighted, rand, shuffle, type RunState, type ShopItem, type Stop, type StopKind } from "./state.ts"; @@ -69,6 +70,35 @@ export function makeRoute(s: RunState): StopKind[] { return shuffle(s, out); } +/** 和你的類型搭配(docs/25 第 1c 節):比較常出現 */ +const affinity = (s: RunState, tags: readonly string[]): number => { + const arch = s.options.archetype ? ARCHETYPES[s.options.archetype] : null; + return arch && arch.tags.some((t) => tags.includes(t)) ? AFFINITY_WEIGHT : 1; +}; +const advisorAffinity = (s: RunState, a: AdvisorDef): number => { + const arch = s.options.archetype ? ARCHETYPES[s.options.archetype] : null; + return arch && arch.school === a.school ? AFFINITY_WEIGHT : 1; +}; + +/** 幕僚選項:不重複,和類型同一派的比較常出現 */ +function advisorOptions(s: RunState, n: number): string[] { + const out: string[] = []; + const pool = ADVISORS.filter((a) => !has(s, a.id)); + while (out.length < n) { + const a = pickWeighted( + s, + pool.filter((x) => !out.includes(x.id)), + (x) => advisorAffinity(s, x), + ); + if (!a) break; + out.push(a.id); + } + return out; +} + +/** 物資行的價格:財務型八折 */ +const price = (s: RunState, base: number): number => Math.round(base * (isArch(s, "finance") ? 0.8 : 1)); + function cardOptions(s: RunState, n: number): string[] { const options: string[] = []; const pool = REWARD_CARDS.filter((c) => c.effect.kind !== "kneel" || s.week >= s.totalWeeks - 3); @@ -76,7 +106,7 @@ function cardOptions(s: RunState, n: number): string[] { const c = pickWeighted( s, pool.filter((x) => !options.includes(x.id)), - (x) => (x.rarity === "rare" ? 1 : 3), + (x) => (x.rarity === "rare" ? 1 : 3) * affinity(s, x.tags), ); if (!c) break; options.push(c.id); @@ -94,15 +124,15 @@ function makeStop(s: RunState, kind: StopKind): Stop { case "card": return { kind, options: cardOptions(s, optionCount(s)) }; case "advisor": - return { kind, options: shuffle(s, ADVISORS.filter((a) => !has(s, a.id))).slice(0, optionCount(s)).map((a) => a.id) }; + return { kind, options: advisorOptions(s, optionCount(s)) }; case "upgrade": case "remove": return { kind }; case "shop": { - const items: ShopItem[] = cardOptions(s, 3).map((id) => ({ kind: "card", id, price: cardDef(id)!.rarity === "rare" ? PRICES.rare : PRICES.common, sold: false })); - const advisor = advisorOpen(s) ? shuffle(s, ADVISORS.filter((a) => !has(s, a.id)))[0] : undefined; - if (advisor) items.push({ kind: "advisor", id: advisor.id, price: PRICES.advisor, sold: false }); - items.push({ kind: "remove", id: "remove", price: PRICES.remove, sold: false }); + const items: ShopItem[] = cardOptions(s, 3).map((id) => ({ kind: "card", id, price: price(s, cardDef(id)!.rarity === "rare" ? PRICES.rare : PRICES.common), sold: false })); + const advisor = advisorOpen(s) ? advisorOptions(s, 1)[0] : undefined; + if (advisor) items.push({ kind: "advisor", id: advisor, price: price(s, PRICES.advisor), sold: false }); + items.push({ kind: "remove", id: "remove", price: price(s, PRICES.remove), sold: false }); return { kind, items }; } case "encounter": { diff --git a/backend/packages/rogue/src/rules.ts b/backend/packages/rogue/src/rules.ts index 4cd5f5b..30be135 100644 --- a/backend/packages/rogue/src/rules.ts +++ b/backend/packages/rogue/src/rules.ts @@ -1,10 +1,11 @@ import type { MiniGameKind, RogueResult } from "@election2026/protocol"; import { ADVISOR_BY_ID } from "./advisors.ts"; +import { ARCHETYPES, homeBasis, homeTowns } from "./archetypes.ts"; import type { IslandPerk, PolicySpec } from "@election2026/protocol"; import { MINOR_REPORTER_MULT, ORIGINS, PARTY_LEAN_SHIFT, type Background } from "@election2026/protocol"; import { CARD_BY_ID, cardDef, EVENTS, findCard, hasKeyword, REPORTER_PENALTY, STARTER_DECK, upgradable } from "./data.ts"; import { perkLevels, policyCardId, policySlots } from "./meta.ts"; -import { asc, cityVotes, drawCards, eventOf, flagOwner, has, moveVotes, updateFlags } from "./mechanics.ts"; +import { asc, cityVotes, drawCards, eventOf, flagOwner, has, isArch, moveVotes, updateFlags } from "./mechanics.ts"; import { featsOf } from "./feats.ts"; import { announceBigRally, applyRivalShields, executeIntent, planIntents } from "./rival.ts"; import { pickRoute, pickStop, prepareRoute } from "./route.ts"; @@ -39,6 +40,9 @@ export { blockedReason, cardCost, comboBonus, COMBO_MAX, COMBO_STEP, counterable export { committedShares } from "./scenes.ts"; export { SKIP_MONEY } from "./route.ts"; +/** 組織型本命區每週自動的樁腳(和「拜託里長佈樁」的基礎值一樣) */ +const STAKE_SHIELD = 2880; + /** 開票時,每一點聲勢讓還沒表態的人有 1.5% 投給該陣營 */ export const MOMENTUM_TURNOUT = 0.015; /** 逆風 10 級:開局落後幾個百分點 */ @@ -75,6 +79,7 @@ function startWeek(s: RunState): void { s.energy = Math.max(0, s.energyMax + s.energyNext); s.energyNext = 0; s.buffs = []; + if (s.viral) s.viral.used = false; s.playedThisWeek = 0; s.onlinePlayed = 0; s.weekCards = []; @@ -91,6 +96,14 @@ function startWeek(s: RunState): void { announceBigRally(s); s.intents = planIntents(s); applyRivalShields(s); + // 組織型:本命區每週自動有一座樁腳(和「拜託里長佈樁」一樣大) + if (isArch(s, "organization")) { + for (const t of s.towns.filter((x) => x.home === "you")) { + const shield = STAKE_SHIELD * s.scale * (1 + 0.1 * (s.options.abilities?.organization ?? 0)); + t.shield += shield; + s.log.push({ side: "you", text: `組織型:本命區${t.name}的樁腳自動到位`, town: t.code, votes: 0 }); + } + } s.scene = sceneFor(s, prev); // 記者堵麥不擋出牌:變成這週要處理的事件,結束這週前回答就好;辯論、黑函是大場面,先處理 s.phase = s.scene && s.scene.kind !== "press" ? "scene" : "plan"; @@ -110,6 +123,20 @@ export interface CreateOptions extends Partial> { /** 政治生涯一共幾關(里長 → 議員 → 立委 → 縣市長 → 總統) */ export const CAREER_STAGES = 5; +/** 開局牌組:基本牌組,類型的專屬牌(取代一張掃街或多一張),有本命區就多一張回鄉造勢,逆風 5 起多一張人情包袱 */ +function starterDeck(options: RunOptions, home: boolean): string[] { + const deck = [...STARTER_DECK]; + const arch = options.archetype ? ARCHETYPES[options.archetype] : null; + if (arch) { + const at = arch.replaces ? deck.indexOf(arch.replaces) : -1; + if (at >= 0) deck[at] = arch.card; + else deck.push(arch.card); + } + if (home) deck.push("homecoming"); + if (options.ascension >= 5) deck.push("favor"); + return deck; +} + export function createRun(setup: RogueSetup, runId: string, seed: number, opts: CreateOptions = {}): RunState { const options: RunOptions = { ascension: Math.max(0, Math.min(10, Math.round(opts.ascension ?? 0))), @@ -123,11 +150,16 @@ export function createRun(setup: RogueSetup, runId: string, seed: number, opts: perks: perkLevels(opts.perks ?? []), origin: opts.origin ?? null, ...(opts.noUltimate ? { noUltimate: true } : {}), + archetype: opts.tutorial ? null : (opts.archetype ?? null), + archetypeBasis: opts.archetypeBasis ?? null, }; const voters = setup.towns.reduce((a, t) => a + t.voters, 0); const meanVoters = voters / (setup.towns.length || 1); const gap = options.ascension >= 10 ? ASC10_GAP / 2 : 0; const { towns, ...rest } = setup; + // 本命區(docs/25):雙方各自底盤最強的區;新手教學沒有 + const youHome = options.tutorial ? [] : homeTowns(towns, "you"); + const rivalHome = options.tutorial ? [] : homeTowns(towns, "rival", new Set(youHome)); const s: RunState = { version: SAVE_VERSION, runId, @@ -142,7 +174,7 @@ export function createRun(setup: RogueSetup, runId: string, seed: number, opts: energy: BASE_ENERGY, energyMax: BASE_ENERGY, energyNext: 0, - money: Math.round(setup.money * (options.ascension >= 2 ? 0.6 : 1)), + money: Math.round(setup.money * (options.ascension >= 2 ? 0.6 : 1) * (options.archetype === "newcomer" ? 0.7 : 1)), momentum: 0, rivalMomentum: options.ascension >= 7 ? 2 : 0, leverage: 0, @@ -169,6 +201,7 @@ export function createRun(setup: RogueSetup, runId: string, seed: number, opts: reach: townReach(t.voters, meanVoters), flag: null, was: null, + home: youHome.includes(t.code) ? "you" : rivalHome.includes(t.code) ? "rival" : null, }; }), draw: [], @@ -194,11 +227,12 @@ export function createRun(setup: RogueSetup, runId: string, seed: number, opts: seen: [], crisisDone: false, startGap: 0, + ...(youHome.length ? { homeBasis: { you: homeBasis(towns, "you", youHome), rival: homeBasis(towns, "rival", rivalHome) } } : {}), stats: emptyStats(), result: null, }; for (const t of s.towns) t.flag = t.was = flagOwner(t); - const deck = opts.deck ?? [...STARTER_DECK, ...(options.ascension >= 5 ? ["favor"] : [])]; + const deck = opts.deck ?? starterDeck(options, youHome.length > 0); const cards = deck.map((id): CardInst => newCard(s, id)); s.draw = opts.deck ? cards : shuffle(s, cards); // 政治生涯:帶過來的牌放在最上面(第一週就抽到)、幕僚、資金(伺服器已經檢查過 id) @@ -337,8 +371,9 @@ export function endWeek(state: RunState): RunState | { error: string } { (has(s, "tycoon") ? 150 : 0) + flags * FLAG_INCOME + (has(s, "cfo") ? 60 * s.energy : 0) + - 15 * (s.options.abilities?.finance ?? 0), - ); + 15 * (s.options.abilities?.finance ?? 0) + + (isArch(s, "finance") ? 150 : 0), + ) * (isArch(s, "integrity") ? 0.8 : 1); s.money += income; s.log.push({ side: "system", text: `本週收入 ${income} 萬${flags ? `(含 ${flags} 面旗的小額捐款)` : ""}`, town: null, votes: 0 }); s.lastFocus = s.towns diff --git a/backend/packages/rogue/src/scenes.ts b/backend/packages/rogue/src/scenes.ts index a1ee353..e17fe3c 100644 --- a/backend/packages/rogue/src/scenes.ts +++ b/backend/packages/rogue/src/scenes.ts @@ -15,7 +15,7 @@ import { type PressTrigger, } from "./content.ts"; import { findCard, upgradable } from "./data.ts"; -import { addMomentum, addRivalMomentum, asc, cityVotes, has, loseVotes, spread } from "./mechanics.ts"; +import { addMomentum, addRivalMomentum, addStatus, asc, cityVotes, has, isArch, loseVotes, spread } from "./mechanics.ts"; import { MAX_ADVISORS, addTally, gainCard, newCard, pickWeighted, rand, shuffle, totals, type DebateArg, type DebateMove, type RunState, type Scene } from "./state.ts"; /** @@ -66,7 +66,7 @@ export function applyOutcome(s: RunState, o: Outcome, when: "now" | "between"): if (when === "now") s.hand.push(card); else gainCard(s, card); } - for (const id of o.status ?? []) s.discard.push(newCard(s, id)); + for (const id of o.status ?? []) addStatus(s, id); if (o.upgrade) { const pool = [...s.draw, ...s.discard, ...s.hand].filter((c) => upgradable(c.id, c.up)); if (pool.length) { @@ -154,7 +154,7 @@ function debateScene(s: RunState): Scene { // 抽論點:三種各一張,其餘照牌組的組成加權;口才 3 級以上多一張;財源扎實的政策各一張 const deck = [...s.draw, ...s.discard, ...s.hand].map((c) => findCard(c.id)).filter((c) => !!c); const weight = (m: DebateMove) => 1 + deck.filter((c) => c.tags.some((t) => ARG_TAGS[m].includes(t))).length; - const size = DEBATE_HAND + ((s.options.abilities?.eloquence ?? 0) >= 3 ? 1 : 0); + const size = DEBATE_HAND + ((s.options.abilities?.eloquence ?? 0) >= 3 ? 1 : 0) + (isArch(s, "eloquence") ? 1 : 0); const used = { policy: 0, emotion: 0, question: 0 }; const hand: DebateArg[] = policies.filter((p) => !p.debt).map((p) => ({ kind: "policy", text: DEBATE_POLICY_ARG.replace("{policy}", p.name), policy: p.name })); const add = (kind: DebateMove) => { @@ -211,7 +211,7 @@ function publishPoll(s: RunState): void { } function crisisScene(s: RunState): Scene { - const amount = CRISIS_BASE * s.scale * (asc(s, 9) ? 2 : 1) * (has(s, "lawyer") ? 0.5 : 1) * (1 - 0.12 * (s.options.abilities?.integrity ?? 0)); + const amount = CRISIS_BASE * s.scale * (asc(s, 9) ? 2 : 1) * (has(s, "lawyer") ? 0.5 : 1) * (1 - 0.12 * (s.options.abilities?.integrity ?? 0)) * (isArch(s, "integrity") ? 0.5 : 1); s.crisisDone = true; return { kind: "crisis", amount }; } @@ -323,7 +323,7 @@ function resolveSceneInner(s: RunState, pick: number): string | null { const lost = factor > 0 ? cityVotes(s, -scene.amount * factor) : 0; s.stats.crisisLoss = Math.max(0, -lost / s.scale); s.log.push({ side: lost < 0 ? "rival" : "you", text: `${choice.label}:${factor === 0 ? "黑函沒有造成損失" : `損失剩 ${Math.round(factor * 100)}%`}`, town: null, votes: Math.round(lost) }); - for (const id of status) s.discard.push(newCard(s, id)); + for (const id of status) addStatus(s, id); close(); return null; } diff --git a/backend/packages/rogue/src/state.ts b/backend/packages/rogue/src/state.ts index 6ce5486..c47b895 100644 --- a/backend/packages/rogue/src/state.ts +++ b/backend/packages/rogue/src/state.ts @@ -1,4 +1,4 @@ -import type { CandidatePublic, CareerAbilities, MiniGameKind, PartyKind, RogueIntentKind, RogueLog, RogueResult, RogueTrait } from "@election2026/protocol"; +import type { CandidatePublic, CareerAbilities, MiniGameKind, PartyKind, RogueArchetype, RogueIntentKind, RogueLog, RogueResult, RogueTrait } from "@election2026/protocol"; /** 一區的起始資料:真實人口、投票率、各陣營的底盤(由選民模型算出,見 setup.ts) */ export interface TownSetup { @@ -66,6 +66,10 @@ export interface RunOptions { origin?: RunOrigin | null; /** 關掉大絕招(只給模擬對照用) */ noUltimate?: boolean; + /** 候選人類型(docs/25):決定技能與弱點;新手教學、舊存檔沒有 */ + archetype?: RogueArchetype | null; + /** 類型的依據(選舉紀錄或出身) */ + archetypeBasis?: string | null; } export interface RunOrigin { @@ -96,6 +100,8 @@ export interface TownState { flag: Owner; /** 上一個插旗的人(從對手手上拿過來才算翻轉,中間掉成沒人插旗也算) */ was: Owner; + /** 本命區(docs/25):誰的本命區;舊存檔沒有 */ + home?: Owner; } export interface CardInst { @@ -260,6 +266,12 @@ export interface RunState { ult?: { charge: number; used: number; max: number }; /** 開局時全市已表態的票裡你領先幾個百分點(以小搏大的成就用) */ startGap: number; + /** 本命區的依據文字(雙方) */ + homeBasis?: { you: string; rival: string }; + /** 媒體型:這週爆紅過了(每週一次)、下一張空戰牌加倍 */ + viral?: { used: boolean; boost: boolean }; + /** 你翻走對手的本命區:對手下週少幾個行動 */ + rivalStun?: number; stats: RunStats; result: RogueResult | null; } diff --git a/backend/packages/rogue/src/view.ts b/backend/packages/rogue/src/view.ts index 718a4f8..88ead1a 100644 --- a/backend/packages/rogue/src/view.ts +++ b/backend/packages/rogue/src/view.ts @@ -1,5 +1,6 @@ import type { RogueCard, RogueCatalog, RogueChoice, RogueDeckCard, RogueOffer, RoguePreview, RogueScene, RogueStop, RogueView } from "@election2026/protocol"; import { ADVISOR_BY_ID, ADVISORS } from "./advisors.ts"; +import { ARCHETYPES } from "./archetypes.ts"; import { blockedReason, cardCost, counterable, attackable, defOf, playCard } from "./cards.ts"; import { CRISIS_CHOICES, DEBATE_MOVES, PRESS_BY_ID, STOP_EVENT_BY_ID, type Choice } from "./content.ts"; import { ORIGINS } from "@election2026/protocol"; @@ -118,21 +119,28 @@ function deckCard(s: RunState, c: CardInst, pile: RogueDeckCard["pile"]): RogueD }; } +/** 和你的類型搭配的牌、幕僚(docs/25 第 1c 節) */ +const fitsCard = (s: RunState | null, tags: readonly string[]): boolean => { + const arch = s?.options.archetype ? ARCHETYPES[s.options.archetype] : null; + return !!arch && arch.tags.some((t) => tags.includes(t)); +}; + export function cardOffer(s: RunState | null, id: string, extra: Partial = {}): RogueOffer { const card = findCard(id)!; - return { kind: "card", id, name: card.name, art: card.art, rarity: card.rarity, tags: [...card.tags], keywords: keywordLabels(card), cost: card.cost, money: card.money, ...face(s, card), price: null, sold: false, ...extra }; + return { kind: "card", id, name: card.name, art: card.art, rarity: card.rarity, tags: [...card.tags], keywords: keywordLabels(card), cost: card.cost, money: card.money, ...face(s, card), price: null, sold: false, fit: fitsCard(s, card.tags), ...extra }; } -function advisorOffer(id: string, extra: Partial = {}): RogueOffer { +function advisorOffer(s: RunState | null, id: string, extra: Partial = {}): RogueOffer { const a = ADVISOR_BY_ID.get(id)!; - return { kind: "advisor", id, name: a.name, text: a.text, art: a.art, rarity: "advisor", tags: [], keywords: [], cost: null, money: null, value: null, price: null, sold: false, ...extra }; + const fit = !!s?.options.archetype && ARCHETYPES[s.options.archetype].school === a.school; + return { kind: "advisor", id, name: a.name, text: a.text, art: a.art, rarity: "advisor", tags: [], keywords: [], cost: null, money: null, value: null, price: null, sold: false, fit, ...extra }; } function shopOffer(s: RunState, item: ShopItem): RogueOffer { const extra = { price: item.price, sold: item.sold }; if (item.kind === "card") return cardOffer(s, item.id, extra); - if (item.kind === "advisor") return advisorOffer(item.id, extra); - return { kind: "remove", id: "remove", name: "刪牌服務", text: "從牌組拿掉一張牌", art: "rest", rarity: "service", tags: ["status"], keywords: [], cost: null, money: null, value: null, ...extra }; + if (item.kind === "advisor") return advisorOffer(s, item.id, extra); + return { kind: "remove", id: "remove", name: "刪牌服務", text: "從牌組拿掉一張牌", art: "rest", rarity: "service", tags: ["status"], keywords: [], cost: null, money: null, value: null, fit: false, ...extra }; } const choiceView = (s: RunState, c: Choice): RogueChoice => ({ label: c.label, hint: c.hint, blocked: choiceBlocked(s, c), risky: !!c.roll }); @@ -184,7 +192,7 @@ function stopViewOf(s: RunState, stop: Stop): RogueStop { case "card": return { kind: "card", options: stop.options.map((id) => cardOffer(s, id)) }; case "advisor": - return { kind: "advisor", options: stop.options.map((id) => advisorOffer(id)) }; + return { kind: "advisor", options: stop.options.map((id) => advisorOffer(s, id)) }; case "upgrade": case "remove": return { kind: stop.kind }; @@ -261,6 +269,14 @@ function colorsOf(s: RunState): RogueView["colors"] { return { you, rival }; } + +/** 你的候選人特色:類型、技能、弱點、本命區(docs/25);新手教學、舊存檔是 null */ +function identityOf(s: RunState): RogueView["identity"] { + const arch = s.options.archetype; + if (!arch) return null; + const def = ARCHETYPES[arch]; + return { archetype: arch, name: def.name, skill: def.skill, weakness: def.weakness, basis: s.options.archetypeBasis ?? null, home: s.homeBasis?.you ?? "", rivalHome: s.homeBasis?.rival ?? "" }; +} export function toView(s: RunState): RogueView { const ev = eventOf(s); const big = s.nextBig; @@ -291,6 +307,7 @@ export function toView(s: RunState): RogueView { rival: s.setup.rival, others: s.setup.others, colors: colorsOf(s), + identity: identityOf(s), rivalTrait: RIVAL_TRAITS[s.setup.rivalStyle], towns: s.towns.map((t) => ({ code: t.code, @@ -307,6 +324,7 @@ export function toView(s: RunState): RogueView { office: t.office > 0, played: t.played.map((id) => ({ id, name: s.policyNames?.[id] ?? findCard(id)?.name ?? id, art: findCard(id)?.art ?? id })), flag: t.flag, + home: t.home ?? null, })), intents: s.intents.map((i) => ({ id: i.id, kind: i.kind, label: intentLabel(s, i), town: i.town, amount: Math.round(i.amount), cut: i.cut, big: !!i.big })), nextBig: big && big.town ? { week: BIG_RALLY_WEEK, town: big.town, label: intentLabel(s, big), amount: Math.round(big.amount) } : null, @@ -387,6 +405,7 @@ export function catalog(): RogueCatalog { feats: FEATS.map((f) => ({ ...f })), ascension: [...ASCENSION], events: EVENTS.map((e) => ({ id: e.id, title: e.title, text: e.text, how: "每週開始時隨機發生,多打幾週就會遇到" })), + archetypes: (Object.keys(ARCHETYPES) as (keyof typeof ARCHETYPES)[]).map((id) => ({ id, name: ARCHETYPES[id].name, skill: ARCHETYPES[id].skill, weakness: ARCHETYPES[id].weakness })), }; } diff --git a/backend/packages/rogue/test/identity.test.ts b/backend/packages/rogue/test/identity.test.ts new file mode 100644 index 0000000..a55c280 --- /dev/null +++ b/backend/packages/rogue/test/identity.test.ts @@ -0,0 +1,186 @@ +import { describe, expect, it } from "vitest"; +import { ARCHETYPES, HOME_MULT, homeTowns } from "../src/archetypes.ts"; +import { cardDef, STARTER_DECK } from "../src/data.ts"; +import { updateFlags } from "../src/mechanics.ts"; +import { planIntents } from "../src/rival.ts"; +import { createRun, endWeek, playCard } from "../src/rules.ts"; +import { FLAG_LEAD, type RogueSetup, type RunState, type TownState } from "../src/state.ts"; +import { toView } from "../src/view.ts"; +import { SETUP, must, toPlan } from "./fixtures.ts"; + +/** 本命區與候選人類型(docs/25 第 1 節) */ + +/** 甲區是你的票倉、乙區是對手的票倉,其他兩區平均 */ +const LEANED: RogueSetup = { + ...SETUP, + towns: [ + { ...SETUP.towns[0]!, lean: { you: 0.55, rival: 0.35, others: 0.1 } }, + { ...SETUP.towns[1]!, lean: { you: 0.35, rival: 0.55, others: 0.1 } }, + { ...SETUP.towns[2]!, lean: { you: 0.6, rival: 0.3, others: 0.1 } }, + { ...SETUP.towns[3]!, lean: { you: 0.45, rival: 0.45, others: 0.1 } }, + ], +}; + +const ok = (r: ReturnType): RunState => { + if ("error" in r) throw new Error(r.error); + return r.state; +}; + +/** 指定手牌,清掉對手的意圖與樁腳,方便算數字 */ +function withHand(s: RunState, ids: string[]): RunState { + const copy = structuredClone(s); + return { ...copy, phase: "plan", scene: null, towns: copy.towns.map((t) => ({ ...t, shield: 0, rivalShield: 0 })), hand: ids.map((id, i) => ({ uid: `t${i}`, id })), intents: [], energy: 9, money: 5000, momentum: 0 }; +} + +const town = (s: RunState, code: string): TownState => s.towns.find((t) => t.code === code)!; + +/** 讓 side 在這區領先 12 個百分點(超過插旗門檻),原本是另一方插旗 */ +function takeLead(t: TownState, side: "you" | "rival"): void { + const other = side === "you" ? "rival" : "you"; + t.was = other; + const lead = FLAG_LEAD + 0.04; + t[side] = (t[other] + lead * (t[other] + t.others)) / (1 - lead); +} +const deckIds = (s: RunState): string[] => [...s.draw, ...s.hand, ...s.discard].map((c) => c.id).sort(); + +describe("本命區", () => { + it("底盤比全區平均高最多、而且夠大的區;對手用同樣的算法,不會挑到同一區", () => { + // 丙區的底盤最高,但只佔 7%(夠大);甲區次高但人多 + expect(homeTowns(LEANED.towns, "you")).toEqual(["C"]); + expect(homeTowns(LEANED.towns, "rival")).toEqual(["B"]); + // 太小的區不算:丙區只剩全區 2% + const tiny = { ...LEANED, towns: LEANED.towns.map((t) => (t.code === "C" ? { ...t, voters: 14_000 } : t)) }; + expect(homeTowns(tiny.towns, "you")).toEqual(["A"]); + const s = createRun(LEANED, "r", 1); + expect(town(s, "C").home).toBe("you"); + expect(town(s, "B").home).toBe("rival"); + expect(s.towns.filter((t) => t.home).length).toBe(2); + expect(toView(s).identity).toBeNull(); // 沒有類型就沒有特色面板 + expect(toView(s).towns.find((t) => t.code === "C")!.home).toBe("you"); + }); + + it("你的牌打在本命區 ×1.2;回鄉造勢只能打在本命區,開局就在牌組裡", () => { + const s = createRun(LEANED, "r", 1); + expect(deckIds(s)).toContain("homecoming"); + const h = withHand(s, ["canvass", "canvass"]); + const home = ok(playCard(h, "t0", "C")); + const plain = ok(playCard({ ...h, towns: h.towns.map((t) => ({ ...t, home: null })) }, "t0", "C")); + expect(town(home, "C").you - town(h, "C").you).toBeCloseTo((town(plain, "C").you - town(h, "C").you) * HOME_MULT); + const hc = withHand(s, ["homecoming"]); + expect("error" in playCard(hc, "t0", "A")).toBe(true); + const back = ok(playCard(hc, "t0", "C")); + expect(back.momentum).toBe(1); + expect(town(back, "C").you).toBeGreaterThan(town(hc, "C").you); + }); + + it("翻走對手的本命區:聲勢 +2、對手下週少一個行動;本命區失守:聲勢 −2", () => { + const s = withHand(createRun(LEANED, "r", 1), []); + // 乙區(對手本命區)原本對手插旗:把你的票拉到領先 + takeLead(town(s, "B"), "you"); + updateFlags(s); + expect(s.momentum).toBe(2); + expect(s.rivalStun).toBe(1); + const fewer = planIntents({ ...s, week: 3 }); + const normal = planIntents({ ...s, week: 3, rivalStun: 0 }); + expect(fewer.length).toBe(normal.length - 1); + // 丙區(你的本命區)被翻走 + const lost = withHand(createRun(LEANED, "r", 1), []); + lost.momentum = 3; + takeLead(town(lost, "C"), "rival"); + updateFlags(lost); + expect(lost.momentum).toBe(1); + }); + + it("新手教學沒有本命區、沒有回鄉造勢", () => { + const s = createRun(LEANED, "r", 1, { tutorial: true, archetype: "media" }); + expect(s.towns.every((t) => !t.home)).toBe(true); + expect(deckIds(s)).not.toContain("homecoming"); + expect(s.options.archetype).toBeNull(); + }); +}); + +describe("候選人類型", () => { + it("每種類型:專屬開局牌取代一張掃街(財務型多一張募款餐會),畫面有技能、弱點與依據", () => { + for (const [id, def] of Object.entries(ARCHETYPES)) { + const s = createRun(LEANED, "r", 1, { archetype: id as keyof typeof ARCHETYPES, archetypeBasis: "測試" }); + const deck = deckIds(s); + const expected = [...STARTER_DECK]; + if (def.replaces) expected[expected.indexOf(def.replaces)] = def.card; + else expected.push(def.card); + expected.push("homecoming"); + expect(deck).toEqual(expected.sort()); + expect(cardDef(def.card)).toBeDefined(); + const view = toView(s).identity!; + expect(view).toMatchObject({ archetype: id, name: def.name, skill: def.skill, weakness: def.weakness, basis: "測試" }); + expect(view.home).toContain("丙區"); + } + }); + + it("同一個種子、同一個類型,開局一模一樣", () => { + expect(createRun(LEANED, "r", 7, { archetype: "media" })).toEqual(createRun(LEANED, "r", 7, { archetype: "media" })); + }); + + it("媒體型:空戰牌 ×1.15;爆紅之後下一張空戰牌加倍;被批評 +20%", () => { + const plain = withHand(createRun(LEANED, "r", 1), ["tv"]); + const media = withHand(createRun(LEANED, "r", 1, { archetype: "media" }), ["tv", "tv"]); + const gain = (a: RunState, b: RunState) => b.towns.reduce((x, t, i) => x + t.you - a.towns[i]!.you, 0); + const base = gain(plain, ok(playCard(plain, "t0", null))); + expect(gain(media, ok(playCard(media, "t0", null)))).toBeCloseTo(base * 1.15, 0); + const boosted = { ...media, viral: { used: true, boost: true } }; + const one = ok(playCard(boosted, "t0", null)); + expect(gain(boosted, one)).toBeCloseTo(base * 1.15 * 2, 0); + expect(one.viral!.boost).toBe(false); // 用過就沒了 + const s = { ...createRun(LEANED, "r", 1, { archetype: "media" }), week: 3 }; + const n = { ...createRun(LEANED, "r", 1), week: 3 }; + const attack = (x: RunState) => planIntents({ ...x, rng: 99 }).find((i) => i.kind === "attack"); + const a = attack(s); + const b = attack(n); + if (a && b) expect(a.amount / b.amount).toBeCloseTo(1.2, 1); + }); + + it("組織型:本命區每週自動有樁腳;每週第一張佈樁不花體力;空戰牌 ×0.85", () => { + const s = createRun(LEANED, "r", 1, { archetype: "organization" }); + expect(town(s, "C").shield).toBeGreaterThan(0); + const h = withHand(s, ["stake", "stake"]); + const one = ok(playCard(h, "t0", "A")); + expect(one.energy).toBe(9); + const two = ok(playCard(one, "t1", "A")); + expect(two.energy).toBe(8); + }); + + it("資深型:辯論多一張論點、回應記者追問不花體力;年輕人多的區 ×0.85", () => { + const s = withHand(createRun(LEANED, "r", 1, { archetype: "eloquence" }), ["reporter", "canvass"]); + expect(ok(playCard(s, "t0", null)).energy).toBe(9); + const plain = withHand(createRun(LEANED, "r", 1), ["canvass"]); + const young = (x: RunState) => town(ok(playCard(x, x.hand.find((c) => c.id === "canvass")!.uid, "A")), "A").you - town(x, "A").you; + expect(young(s)).toBeCloseTo(young(plain) * 0.85); + }); + + it("財務型:每週多 150 萬;清廉型:收入 −20%、記者追問不會被塞進牌組", () => { + const income = (arch?: "finance" | "integrity") => { + const s = toPlan(createRun(LEANED, "r", 1, arch ? { archetype: arch } : {})); + const after = must(endWeek({ ...s, intents: [] })); + return after.money - s.money; + }; + const base = income(); + expect(income("finance") - base).toBe(150); + expect(income("integrity")).toBe(Math.round(base * 0.8)); + const clean = withHand(createRun(LEANED, "r", 1, { archetype: "integrity" }), []); + const attacked = must(endWeek({ ...clean, intents: [{ id: "x", kind: "attack", town: null, amount: 500, cut: 1 }] })); + expect([...attacked.draw, ...attacked.discard, ...attacked.hand].some((c) => c.id === "reporter")).toBe(false); + }); + + it("黑馬型:起始資金 −30%、每點聲勢 +12%、翻區多抽一張", () => { + expect(createRun(LEANED, "r", 1, { archetype: "newcomer" }).money).toBe(Math.round(createRun(LEANED, "r", 1).money * 0.7)); + const gain = (arch?: "newcomer") => { + const s = { ...withHand(createRun(LEANED, "r", 1, arch ? { archetype: arch } : {}), ["canvass"]), momentum: 2 }; + return town(ok(playCard(s, "t0", "D")), "D").you - town(s, "D").you; + }; + expect(gain("newcomer") / gain()).toBeCloseTo(1.24 / 1.16, 2); + const s = withHand(createRun(LEANED, "r", 1, { archetype: "newcomer" }), []); + s.draw = [{ uid: "x1", id: "canvass" }]; + takeLead(town(s, "B"), "you"); + updateFlags(s); + expect(s.hand.map((c) => c.id)).toEqual(["canvass"]); + }); +}); diff --git a/backend/packages/rogue/test/rules.test.ts b/backend/packages/rogue/test/rules.test.ts index 132c4fc..5092326 100644 --- a/backend/packages/rogue/test/rules.test.ts +++ b/backend/packages/rogue/test/rules.test.ts @@ -17,10 +17,10 @@ const cardBase = (id: string, up = false): number => { }; const effect = (id: string) => CARD_BY_ID.get(id)!.effect as unknown as Record; -/** 指定手牌、換掉對手意圖(連同對手已經生效的樁腳),方便算數字 */ +/** 指定手牌、換掉對手意圖(連同對手已經生效的樁腳),方便算數字;本命區清掉(另外在 identity.test.ts 測) */ function withHand(s: RunState, ids: string[], intents: Intent[] = []): RunState { const copy = structuredClone(s); - return { ...copy, phase: "plan", scene: null, towns: copy.towns.map((t) => ({ ...t, shield: 0, rivalShield: 0 })), hand: ids.map((id, i) => ({ uid: `t${i}`, id })), intents, energy: 9, money: 5000, momentum: 0 }; + return { ...copy, phase: "plan", scene: null, towns: copy.towns.map((t) => ({ ...t, shield: 0, rivalShield: 0, home: null })), hand: ids.map((id, i) => ({ uid: `t${i}`, id })), intents, energy: 9, money: 5000, momentum: 0 }; } const ok = (r: ReturnType): RunState => { diff --git a/backend/pnpm-lock.yaml b/backend/pnpm-lock.yaml index 1b8cb5c..1a72e5e 100644 --- a/backend/pnpm-lock.yaml +++ b/backend/pnpm-lock.yaml @@ -41,6 +41,9 @@ importers: '@election2026/scenarios': specifier: workspace:* version: link:../../packages/scenarios + '@fastify/compress': + specifier: ^9.3.0 + version: 9.3.0 '@fastify/rate-limit': specifier: ^11.2.1 version: 11.2.1 @@ -151,9 +154,15 @@ packages: '@bokuweb/zstd-wasm@0.0.27': resolution: {integrity: sha512-GDm2uOTK3ESjnYmSeLQifJnBsRCWajKLvN32D2ZcQaaCIJI/Hse9s74f7APXjHit95S10UImsRGkTsbwHmrtmg==} + '@fastify/accept-negotiator@2.1.2': + resolution: {integrity: sha512-LV7MZqTwXTEt3GxBT6BU8ACztWnv++hSkMEsP3usIHiI0tA4F5EO4THhDCOr5J/ginM9DCnLCmZ6u3JLA9x8Iw==} + '@fastify/ajv-compiler@4.0.7': resolution: {integrity: sha512-VP0yIfwlc1ohj733keYDqyHm1VWeP9VQxYomunhr90jkC4aNNibbkrRiaNgPgqj1ORxUenILR4qzA/ppYBNAtQ==} + '@fastify/compress@9.3.0': + resolution: {integrity: sha512-vvm+933zsfsnw7nKsy2GWyix54k7aq3j+9EkwfH6ncngt+DUt5tgVQ/uH07/JrbOWXt1mjADjZ5MbKKwu1xhmA==} + '@fastify/deepmerge@3.2.4': resolution: {integrity: sha512-kc8GQq5gX9RRhw0rov3DMrN8wS8yRlxJRdDzsYwwdBV/wazuVgc/1K7CKL90tlvu3RlHan6Y0R0aE3nJtBz2eQ==} @@ -1209,6 +1218,10 @@ packages: mgrs@1.0.0: resolution: {integrity: sha512-awNbTOqCxK1DBGjalK3xqWIstBZgN6fxsMSiXLs9/spqWkF2pAhb2rrYCFSsr1/tT7PhcDGjZndG8SWYn0byYA==} + mime-db@1.54.0: + resolution: {integrity: sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==} + engines: {node: '>= 0.6'} + mimic-response@3.1.0: resolution: {integrity: sha512-z0yWI+4FDrrweS8Zmt4Ej5HdJmky15+L2e6Wgn3+iK5fWzb6T3fhNFq2+MeTRb064c6Wr4N/wv0DzQTjNzHNGQ==} engines: {node: '>=10'} @@ -1692,12 +1705,20 @@ snapshots: '@bokuweb/zstd-wasm@0.0.27': {} + '@fastify/accept-negotiator@2.1.2': {} + '@fastify/ajv-compiler@4.0.7': dependencies: ajv: 8.20.0 ajv-formats: 3.0.1(ajv@8.20.0) fast-uri: 4.2.3 + '@fastify/compress@9.3.0': + dependencies: + '@fastify/accept-negotiator': 2.1.2 + fastify-plugin: 6.0.1 + mime-db: 1.54.0 + '@fastify/deepmerge@3.2.4': {} '@fastify/error@4.2.1': {} @@ -2737,6 +2758,8 @@ snapshots: mgrs@1.0.0: {} + mime-db@1.54.0: {} + mimic-response@3.1.0: optional: true diff --git a/web/README.md b/web/README.md index aa055c0..3614c65 100644 --- a/web/README.md +++ b/web/README.md @@ -6,6 +6,9 @@ 以及開發用的資料檢視器(`#/viewer`)、美術總覽(`#/art`、`#/faces`)、頭像部件檢查(`#/avatar-check`)。 開發時要先啟動後端 API(`pnpm --filter @election2026/server start`,見後端 README);`/api` 由 Vite 轉給 `127.0.0.1:8787`。 +開發用的頁面(`#/viewer`、`#/art`、`#/faces`、`#/avatar-check`)只有 `pnpm dev` 打得開,正式版不打包。 + +正式玩(第一次連線快很多):`pnpm start`=建置後用 `vite preview` 在 5173 提供,`/api` 一樣轉給後端。 ## 開發 diff --git a/web/index.html b/web/index.html index 4267700..3e41eb1 100644 --- a/web/index.html +++ b/web/index.html @@ -6,9 +6,55 @@ 選舉小鎮 - + + + +
+
選舉小鎮
+ +

載入中…

+
diff --git a/web/package.json b/web/package.json index 03dd50e..5f14adc 100644 --- a/web/package.json +++ b/web/package.json @@ -7,6 +7,7 @@ "scripts": { "dev": "vite", "build": "tsc -p tsconfig.json && vite build", + "start": "vite build && vite preview --port 5173 --strictPort", "test": "vitest run", "typecheck": "tsc -p tsconfig.json", "sync-fixtures": "node scripts/sync-fixtures.mjs" diff --git a/web/src/App.tsx b/web/src/App.tsx index a1b8036..e33c6db 100644 --- a/web/src/App.tsx +++ b/web/src/App.tsx @@ -1,15 +1,13 @@ import { lazy, Suspense, useEffect, useState } from "react"; import { HomeScreen } from "./game/home/HomeScreen.tsx"; -import { RogueScreen } from "./game/rogue/RogueScreen.tsx"; +import { releaseSplashIfFree } from "./splash.ts"; import "./game/game.css"; import "./game/art/art.css"; import "./game/screens.css"; import "./theme/campaign.css"; -// 首頁和選戰卡牌一開始就載入;捏人物、圖鑑、政治生涯、資料檢視器等用到才下載,手機開首頁比較快 -const DataViewer = lazy(() => import("./viewer/DataViewer.tsx").then((m) => ({ default: m.DataViewer }))); -const ArtGallery = lazy(() => import("./game/art/ArtGallery.tsx").then((m) => ({ default: m.ArtGallery }))); -const FaceGallery = lazy(() => import("./game/art/FaceGallery.tsx").then((m) => ({ default: m.FaceGallery }))); +// 首頁一開始就載入;一局卡牌(含 3D 棋盤與 three.js)、捏人物、圖鑑、政治生涯等用到才下載,手機開首頁比較快 +const RogueScreen = lazy(() => import("./game/rogue/RogueScreen.tsx").then((m) => ({ default: m.RogueScreen }))); const CreatorScreen = lazy(() => import("./game/creator/CreatorScreen.tsx").then((m) => ({ default: m.CreatorScreen }))); const RogueCollection = lazy(() => import("./game/rogue/Collection.tsx").then((m) => ({ default: m.RogueCollection }))); const RogueCareer = lazy(() => import("./game/rogue/Career.tsx").then((m) => ({ default: m.RogueCareer }))); @@ -18,7 +16,16 @@ const MiniGameLobby = lazy(() => import("./game/minigames/MiniGameLobby.tsx").th const PeopleScreen = lazy(() => import("./game/people/PeopleScreen.tsx").then((m) => ({ default: m.PeopleScreen }))); const TermPreview = lazy(() => import("./game/career/term/TermPreview.tsx").then((m) => ({ default: m.TermPreview }))); const ShopScreen = lazy(() => import("./game/shop/ShopScreen.tsx").then((m) => ({ default: m.ShopScreen }))); -const AvatarCheck = lazy(() => import("./game/art/AvatarCheck.tsx").then((m) => ({ default: m.AvatarCheck }))); + +/** 開發用的頁面:只有 pnpm dev 打得開,正式版不打包(玩家看不到) */ +const DEV_PAGES = import.meta.env.DEV + ? { + "#/avatar-check": lazy(() => import("./game/art/AvatarCheck.tsx").then((m) => ({ default: m.AvatarCheck }))), + "#/viewer": lazy(() => import("./viewer/DataViewer.tsx").then((m) => ({ default: m.DataViewer }))), + "#/art": lazy(() => import("./game/art/ArtGallery.tsx").then((m) => ({ default: m.ArtGallery }))), + "#/faces": lazy(() => import("./game/art/FaceGallery.tsx").then((m) => ({ default: m.FaceGallery }))), + } + : null; function useHash(): string { const [hash, setHash] = useState(location.hash); @@ -32,22 +39,24 @@ function useHash(): string { /** * 簡單的 hash 路由:#/ 首頁(選戰卡牌)、#/rogue 選戰卡牌大廳、#/rogue/:id 一局、#/rogue/career 政治生涯、#/rogue/collection 圖鑑與成就、 - * #/create 捏人物、#/shop 服裝店(小鎮幣買外觀)、#/avatar-check 頭像部件檢查頁、#/viewer 資料檢視器、#/island 政策島(#/island/workshop 政策工坊)、#/minigames 小遊戲大廳(#/minigames/<遊戲> 進遊戲)、#/term 任期小遊戲試玩、#/people 歷屆參選人與客觀資歷分數。經典模式(十週行程版)2026-10-26 依使用者要求刪除,舊網址回首頁。 + * #/create 捏人物、#/shop 服裝店(小鎮幣買外觀)、#/island 政策島(#/island/workshop 政策工坊)、#/minigames 小遊戲大廳(#/minigames/<遊戲> 進遊戲)、#/term 任期小遊戲試玩、#/people 歷屆參選人與客觀資歷分數。 + * 開發用(只有 pnpm dev):#/avatar-check 頭像部件檢查、#/viewer 資料檢視器、#/art 美術總覽、#/faces 頭像對照。經典模式(十週行程版)2026-10-26 依使用者要求刪除,舊網址回首頁。 */ export function App() { const hash = useHash(); + // 子元件的 effect 先跑:首頁的主視覺會先擋住載入畫面,其他畫面這裡就淡出 + useEffect(() => releaseSplashIfFree(), [hash]); return 讀取中…}>{route(hash)}; } function route(hash: string) { - if (hash.startsWith("#/avatar-check")) return ; + if (DEV_PAGES) { + for (const [prefix, Page] of Object.entries(DEV_PAGES)) if (hash.startsWith(prefix)) return ; + } if (hash.startsWith("#/shop")) { const q = new URLSearchParams(hash.split("?")[1] ?? ""); return ; } - if (hash.startsWith("#/viewer")) return ; - if (hash.startsWith("#/art")) return ; - if (hash.startsWith("#/faces")) return ; if (hash.startsWith("#/island")) return ; if (hash.startsWith("#/minigames")) return ; if (hash.startsWith("#/term")) return ; diff --git a/web/src/game/art/avatar/pixel.tsx b/web/src/game/art/avatar/pixel.tsx index 77f4620..9bd086a 100644 --- a/web/src/game/art/avatar/pixel.tsx +++ b/web/src/game/art/avatar/pixel.tsx @@ -1,7 +1,7 @@ import { useEffect, useReducer, useRef, type ReactNode } from "react"; /** - * 復刻像素風(致敬 1994 年原作的 72×90、16 色頭像):把畫好的頭像縮成小點陣、 + * 復刻像素風(72×90、16 色的老派電腦遊戲頭像):把畫好的頭像縮成小點陣、 * 套 16 色(從這張頭像自己的顏色挑)、外圍描一圈深色邊,再用方塊放大畫回來(每種顏色一條 path,任何大小都銳利)。 * 同一個頭像只算一次(快取);瀏覽器不讓讀畫布時退回一般畫法。 */ diff --git a/web/src/game/counties.ts b/web/src/game/counties.ts new file mode 100644 index 0000000..050704b --- /dev/null +++ b/web/src/game/counties.ts @@ -0,0 +1,25 @@ +/** 目前的 22 個縣市(舊縣市的紀錄已對到改制後的代碼,例如臺北縣 → 新北市);前 6 個是直轄市 */ +export const COUNTIES: readonly [string, string][] = [ + ["63000", "臺北市"], + ["65000", "新北市"], + ["68000", "桃園市"], + ["66000", "臺中市"], + ["67000", "臺南市"], + ["64000", "高雄市"], + ["10017", "基隆市"], + ["10018", "新竹市"], + ["10020", "嘉義市"], + ["10002", "宜蘭縣"], + ["10004", "新竹縣"], + ["10005", "苗栗縣"], + ["10007", "彰化縣"], + ["10008", "南投縣"], + ["10009", "雲林縣"], + ["10010", "嘉義縣"], + ["10013", "屏東縣"], + ["10014", "臺東縣"], + ["10015", "花蓮縣"], + ["10016", "澎湖縣"], + ["09020", "金門縣"], + ["09007", "連江縣"], +]; diff --git a/web/src/game/home/HomeScreen.tsx b/web/src/game/home/HomeScreen.tsx index f9ff17b..7e207f8 100644 --- a/web/src/game/home/HomeScreen.tsx +++ b/web/src/game/home/HomeScreen.tsx @@ -47,9 +47,6 @@ export function HomeScreen() { ))} -

- 地圖和開局底盤來自內政部、中選會公開資料・向 1994 年《臺灣模擬選戰》致敬・資料・美術 -

); diff --git a/web/src/game/home/home.css b/web/src/game/home/home.css index 7aae5ee..7a8f4fd 100644 --- a/web/src/game/home/home.css +++ b/web/src/game/home/home.css @@ -56,8 +56,6 @@ .home-dock-ic { width: 50px; height: 50px; display: grid; place-items: center; border-radius: 50%; background: #fffaf0; color: #111419; border: 3px solid #111419; box-shadow: 3px 3px 0 #111419; } .home-dock a:active { transform: scale(0.95); } @media (hover: hover) and (pointer: fine) { .home-dock a:hover { transform: translateY(-4px); } .home-dock a:hover .home-dock-ic { background: var(--signal); } } -.home-legal { margin: 0; font-size: 11px; color: rgb(255 255 255 / 0.6); } -.home-legal a { color: inherit; } /* 示範手牌 */ .home-hand { @@ -119,7 +117,6 @@ .home-dock { justify-content: space-between; gap: 4px; } .home-dock a { width: 52px; } .home-dock-ic { width: 44px; height: 44px; } - .home-legal { display: none; } .home .hero3d-game { display: none; } .home-hand { display: none; } } diff --git a/web/src/game/hud/SettingsMenu.tsx b/web/src/game/hud/SettingsMenu.tsx index 356ad9d..096fcae 100644 --- a/web/src/game/hud/SettingsMenu.tsx +++ b/web/src/game/hud/SettingsMenu.tsx @@ -53,6 +53,7 @@ export function SettingsMenu() { ))} +

地圖與開局底盤:內政部、中選會公開資料(政府資料開放授權條款)

)} diff --git a/web/src/game/people/PeopleFilters.tsx b/web/src/game/people/PeopleFilters.tsx index 106e98f..be0b329 100644 --- a/web/src/game/people/PeopleFilters.tsx +++ b/web/src/game/people/PeopleFilters.tsx @@ -2,32 +2,8 @@ import type { ElectionOffice } from "@election2026/protocol"; import { ChevronDown, RotateCcw, Search, X } from "lucide-react"; import { useEffect, useRef, type ReactNode } from "react"; import { sfx } from "../audio/sfx.ts"; +import { COUNTIES } from "../counties.ts"; -/** 目前的 22 個縣市(舊縣市的紀錄已對到改制後的代碼,例如臺北縣 → 新北市);前 6 個是直轄市 */ -export const COUNTIES: readonly [string, string][] = [ - ["63000", "臺北市"], - ["65000", "新北市"], - ["68000", "桃園市"], - ["66000", "臺中市"], - ["67000", "臺南市"], - ["64000", "高雄市"], - ["10017", "基隆市"], - ["10018", "新竹市"], - ["10020", "嘉義市"], - ["10002", "宜蘭縣"], - ["10004", "新竹縣"], - ["10005", "苗栗縣"], - ["10007", "彰化縣"], - ["10008", "南投縣"], - ["10009", "雲林縣"], - ["10010", "嘉義縣"], - ["10013", "屏東縣"], - ["10014", "臺東縣"], - ["10015", "花蓮縣"], - ["10016", "澎湖縣"], - ["09020", "金門縣"], - ["09007", "連江縣"], -]; const COUNTY_GROUPS: readonly [string, readonly [string, string][]][] = [ ["直轄市", COUNTIES.slice(0, 6)], ["其他縣市", COUNTIES.slice(6)], diff --git a/web/src/game/rogue/Collection.tsx b/web/src/game/rogue/Collection.tsx index d255c58..c6fd2be 100644 --- a/web/src/game/rogue/Collection.tsx +++ b/web/src/game/rogue/Collection.tsx @@ -19,6 +19,7 @@ import { rogueApi } from "../api.ts"; import { sfx } from "../audio/sfx.ts"; import { GameScene, SceneStat } from "../ui/GameScene.tsx"; import { AdvisorFace, OfferFace, cardKind } from "./cards.tsx"; +import { CompletionPanel } from "./Completion.tsx"; import { loadProgress, type Progress } from "./progress.ts"; import "./collection.css"; @@ -437,6 +438,7 @@ export function RogueCollection() { })} + {catalog && }
diff --git a/web/src/game/rogue/Completion.tsx b/web/src/game/rogue/Completion.tsx new file mode 100644 index 0000000..11d9833 --- /dev/null +++ b/web/src/game/rogue/Completion.tsx @@ -0,0 +1,103 @@ +import type { RogueCatalog } from "@election2026/protocol"; +import { MapPin, Medal, Trophy } from "lucide-react"; +import type { CSSProperties } from "react"; +import { completion, TERRITORIES, type Progress } from "./progress.ts"; +import "./completion.css"; + +/** + * 完成度(docs/25):全台制霸、六種類型、類型逆風挑戰、成就。 + * 大廳放精簡的一條(點了去圖鑑),圖鑑放完整的制霸地圖與類型挑戰表。 + */ + +const pct = (x: number) => `${Math.round(x * 100)}%`; + +/** 大廳:一條進度+四個數字,點了去圖鑑的完成度 */ +export function CompletionStrip({ progress, catalog }: { progress: Progress; catalog: RogueCatalog | null }) { + const { parts, percent } = completion(progress, catalog?.feats.length ?? 0); + return ( + + + 完成度 {pct(percent)} + + + + + {parts.map((p) => `${p.label} ${p.done}/${p.total}`).join("・")} + + ); +} + +/** 圖鑑:完成度總覽、全台制霸地圖、類型逆風挑戰表 */ +export function CompletionPanel({ progress, catalog }: { progress: Progress; catalog: RogueCatalog }) { + const { parts, percent } = completion(progress, catalog.feats.length); + const conquered = progress.conquered ?? {}; + const best = progress.typeBest ?? {}; + const levels = catalog.ascension.length; // 逆風 0–10 + return ( +
+
+

+ 完成度 {pct(percent)} +

+
    + {parts.map((p) => ( +
  • + {p.label} + + + + + {p.done}/{p.total} + +
  • + ))} +
+
+
+
+

+ 全台制霸 + 每個縣市(縣市長、立委都算)和總統大選,打贏一次就插上旗 +

+
    + {TERRITORIES.map(([code, name]) => ( +
  • + {name} +
  • + ))} +
+
+
+

+ 類型逆風挑戰 + 每種類型各自記:用這種類型的候選人贏下第幾級逆風 +

+ + + + + {Array.from({ length: levels }, (_, i) => ( + + ))} + + + + {catalog.archetypes.map((a) => ( + + + {Array.from({ length: levels }, (_, i) => ( + + ))} + +
類型 + {i} +
+ {a.name} + + ))} +
+
+
+
+ ); +} diff --git a/web/src/game/rogue/RogueScreen.tsx b/web/src/game/rogue/RogueScreen.tsx index b7dfca2..0330a4c 100644 --- a/web/src/game/rogue/RogueScreen.tsx +++ b/web/src/game/rogue/RogueScreen.tsx @@ -1,5 +1,5 @@ import type { MiniGameKind, RogueArea, RogueLog, RogueView } from "@election2026/protocol"; -import { AlertTriangle, Flag, List, Map as MapIcon, PanelRightClose, PanelRightOpen, ThumbsUp } from "lucide-react"; +import { AlertTriangle, Flag, House, List, Map as MapIcon, PanelRightClose, PanelRightOpen, ThumbsUp } from "lucide-react"; import { useCallback, useEffect, useMemo, useRef, useState } from "react"; import type { Topology } from "topojson-specification"; import { api, rogueApi } from "../api.ts"; @@ -22,10 +22,9 @@ import { DeckDrawer, HelpModal } from "./overlays.tsx"; import { AdvisorRow, EVENT_UID, Hand, IntentList, RogueHud, TownList } from "./parts.tsx"; import { UltimateButton, UltimateOverlay } from "./Ultimate.tsx"; import { WeekEnd } from "./weekend.tsx"; -import { markSeen } from "./progress.ts"; +import { LAST_RUN_KEY, markSeen } from "./progress.ts"; import "./rogue.css"; -export const LAST_RUN_KEY = "tongsuan.rogue.last"; const HELPED_KEY = "tongsuan.rogue.helped"; const WIDE_KEY = "tongsuan.rogue.wide"; @@ -352,6 +351,7 @@ export function RogueScreen({ runId }: { runId: string }) { }), ); const markers: StageMarker[] = [ + ...view.towns.filter((t) => t.home).map((t) => ({ key: `home-${t.code}`, townCode: t.code, icon: House, color: t.home === "you" ? view.colors.you : view.colors.rival, label: `${t.home === "you" ? "你" : view.rival.name}的本命區:${t.name}` })), ...view.towns.filter((t) => t.flag).map((t) => ({ key: `flag-${t.code}`, townCode: t.code, icon: Flag, color: t.flag === "you" ? view.colors.you : view.colors.rival, label: `${t.flag === "you" ? "你" : view.rival.name}插旗:${t.name}` })), ...view.intents .filter((i) => i.town) @@ -605,6 +605,7 @@ function TutorialMap({ view, best, onSelect }: { view: RogueView; best: Readonly disabled={!onSelect} > {t.flag && } + {t.home && } {t.name} {t.voters.toLocaleString("en-US")} 人 {intents.map((i) => { diff --git a/web/src/game/rogue/RogueStart.tsx b/web/src/game/rogue/RogueStart.tsx index 1d7ecfe..dbb3207 100644 --- a/web/src/game/rogue/RogueStart.tsx +++ b/web/src/game/rogue/RogueStart.tsx @@ -17,12 +17,13 @@ import { sfx } from "../audio/sfx.ts"; import { slotColor } from "../format.ts"; import { dailyPick, + LAST_RUN_KEY, loadProgress, todayKey, type Progress, } from "./progress.ts"; import { perksForRun, policiesForRun } from "../island/store.ts"; -import { LAST_RUN_KEY } from "./RogueScreen.tsx"; +import { CompletionStrip } from "./Completion.tsx"; import "./rogue.css"; import "./rogue-start.css"; @@ -342,6 +343,8 @@ export function TitleMenu() { )} + {/* 完成度:玩過才出現(全台制霸、類型挑戰、成就),點了去圖鑑 */} + {progress.runs > 0 && } {error &&

{error}

} {/* 放到 body 最上層:不被首頁 3D 小鎮上的手牌、按鈕蓋住 */} {freeOpen && diff --git a/web/src/game/rogue/brief.tsx b/web/src/game/rogue/brief.tsx index a019215..ad2659c 100644 --- a/web/src/game/rogue/brief.tsx +++ b/web/src/game/rogue/brief.tsx @@ -46,6 +46,10 @@ export function briefNews(view: RogueView, last: readonly RogueLog[] | null) { ...(view.seats > 1 ? [`這區選 ${view.seats} 席:贏過最後一席的${view.rival.name}就當選${view.threshold ? `(2022 年最後一席得票率 ${(view.threshold * 100).toFixed(1)}%)` : ""}`] : []), + // 候選人特色(docs/25):第一週介紹類型、技能、本命區 + ...(view.week === 1 && view.identity + ? [`你是${view.identity.name}:${view.identity.skill};弱點:${view.identity.weakness}${view.identity.home ? `。本命區:${view.identity.home}` : ""}`] + : []), // 玩真實候選人:開局能力依公開選舉紀錄換算(只在第一週說) ...(view.week === 1 && view.options.abilitiesBasis && view.options.abilities ? [`資歷加成:${abilityText(view.options.abilities)};依據:${view.options.abilitiesBasis}`] : []), // 後期提醒:對手行動變多,開票日聲勢高的一方帶出比較多未表態的票 diff --git a/web/src/game/rogue/cards.tsx b/web/src/game/rogue/cards.tsx index ae7e244..1e3b984 100644 --- a/web/src/game/rogue/cards.tsx +++ b/web/src/game/rogue/cards.tsx @@ -82,8 +82,11 @@ export function AdvisorFace({ advisor, compact = false }: { advisor: Pick; + if (offer.kind === "advisor") return ; return ( ); diff --git a/web/src/game/rogue/completion.css b/web/src/game/rogue/completion.css new file mode 100644 index 0000000..d8c868e --- /dev/null +++ b/web/src/game/rogue/completion.css @@ -0,0 +1,26 @@ +/* 完成度(docs/25):大廳的精簡一條、圖鑑的制霸地圖與類型挑戰表 */ +.cmp-bar { position: relative; display: block; height: 8px; border-radius: 999px; background: color-mix(in srgb, var(--ink) 12%, transparent); overflow: hidden; } +.cmp-bar i { position: absolute; inset: 0 auto 0 0; width: calc(var(--p, 0) * 100%); border-radius: inherit; background: var(--stamp); } + +.cmp-strip { display: grid; gap: 4px; padding: 10px 14px; border: 2px solid var(--ink); border-radius: 14px; background: var(--surface); color: var(--ink); text-decoration: none; box-shadow: 3px 3px 0 var(--shadow-ink); } +.cmp-strip-head { display: inline-flex; align-items: center; gap: 6px; font-weight: 800; } +.cmp-strip-head b { font-family: var(--font-num); font-size: 18px; } +.cmp-strip small { color: var(--muted); font-size: 12px; } + +.cmp { display: grid; gap: 14px; padding: 16px; margin-bottom: 16px; border: 3px solid var(--ink); border-radius: 18px; background: var(--surface); box-shadow: 4px 4px 0 var(--shadow-ink); } +.cmp-head { display: grid; gap: 10px; } +.cmp-head h2 { display: flex; align-items: center; gap: 8px; margin: 0; font-family: var(--font-serif); } +.cmp-parts { list-style: none; margin: 0; padding: 0; display: grid; grid-template-columns: repeat(auto-fit, minmax(170px, 1fr)); gap: 10px; } +.cmp-parts li { display: grid; gap: 4px; font-size: 13px; } +.cmp-parts small { color: var(--muted); font-family: var(--font-num); } +.cmp-body { display: grid; grid-template-columns: repeat(auto-fit, minmax(300px, 1fr)); gap: 18px; } +.cmp-body h3 { display: flex; flex-wrap: wrap; align-items: baseline; gap: 6px; margin: 0 0 8px; font-size: 16px; } +.cmp-body h3 small { flex-basis: 100%; color: var(--muted); font-size: 12px; font-weight: 400; } +.cmp-map { list-style: none; margin: 0; padding: 0; display: grid; grid-template-columns: repeat(auto-fill, minmax(76px, 1fr)); gap: 6px; } +.cmp-map li { padding: 6px 4px; border-radius: 10px; border: 2px dashed color-mix(in srgb, var(--ink) 30%, transparent); text-align: center; font-size: 13px; color: var(--muted); } +.cmp-map li.is-won { border: 2px solid var(--ink); background: var(--stamp); color: #fff; font-weight: 800; } +.cmp-ladder { border-collapse: separate; border-spacing: 3px; font-size: 12px; } +.cmp-ladder th { font-weight: 700; color: var(--muted); } +.cmp-ladder tbody th { padding-right: 6px; text-align: left; color: var(--ink); white-space: nowrap; } +.cmp-ladder td { width: 18px; height: 18px; border-radius: 4px; background: color-mix(in srgb, var(--ink) 10%, transparent); } +.cmp-ladder td.is-won { background: var(--signal); box-shadow: inset 0 0 0 2px var(--ink); } diff --git a/web/src/game/rogue/finale.tsx b/web/src/game/rogue/finale.tsx index bc743f3..8e1bcbd 100644 --- a/web/src/game/rogue/finale.tsx +++ b/web/src/game/rogue/finale.tsx @@ -1,7 +1,7 @@ import type { RogueResult, RogueView } from "@election2026/protocol"; -import { ArrowRight, Coins, Flame, Home, Landmark, RotateCcw, Share2, SkipForward, Swords, Trophy } from "lucide-react"; +import { ArrowRight, Coins, Flame, Home, Landmark, MapPin, Medal, RotateCcw, Share2, SkipForward, Swords, Trophy } from "lucide-react"; import { useEffect, useMemo, useRef, useState, type ReactNode } from "react"; -import { rogueApi } from "../api.ts"; +import { api, rogueApi } from "../api.ts"; import { CandidateBadge } from "../art/Badge.tsx"; import { BallotStamp } from "../art/BallotStamp.tsx"; import { setMusic } from "../audio/music.ts"; @@ -10,7 +10,7 @@ import { num, pct, raceLabel, signed } from "./labels.ts"; import { pointsForRun } from "../island/data.ts"; import { addPoints } from "../island/store.ts"; import { coinsForRun, earnCoins } from "../shop/wardrobe.ts"; -import { recordRun, todayKey, type RunRecord } from "./progress.ts"; +import { recordRun, TERRITORIES, todayKey, type RunRecord } from "./progress.ts"; import "./rogue-finale.css"; /** @@ -365,6 +365,46 @@ function ResultPanel({ const [sharing, setSharing] = useState(null); const tutorial = view.options.tutorial; const names = useMemo(() => new Map(view.towns.map((t) => [t.code, t.name])), [view.towns]); + const free = !tutorial && !view.options.career; + const level = view.options.ascension; + // 贏了就能直接挑戰下一級(已經解鎖的話):一場接一場 + const nextLevel = r.won && free && !view.options.daily && level < 10 && level + 1 <= record.progress.ascension ? level + 1 : null; + const owned = Object.keys(record.progress.conquered ?? {}).length; + const [moving, setMoving] = useState(false); + + /** 攻下一塊地盤(全台制霸):挑一個還沒打下的縣市,縣市長劇本(勢均力敵版優先、最近一屆),兩大黨候選人隨機一位 */ + const conquerNext = async () => { + setMoving(true); + try { + const done = new Set(Object.keys(record.progress.conquered ?? {})); + const list = await api.scenarios(); + const open = list.filter((s) => !done.has(s.region.countyCode) && (s.region.kind === "mayor" || s.region.kind === "president")); + const counties = [...new Set(open.map((s) => s.region.countyCode))]; + const county = counties[Math.floor(Math.random() * counties.length)]; + const pool = open.filter((s) => s.region.countyCode === county).sort((a, b) => Number(b.id.endsWith("-even")) - Number(a.id.endsWith("-even")) || b.electionDate.localeCompare(a.electionDate)); + const s = pool[0]; + if (!s) return; + const majors = s.candidates.filter((c) => c.slot === "a" || c.slot === "b"); + const cand = (majors.length ? majors : s.candidates)[Math.floor(Math.random() * (majors.length || s.candidates.length))]!; + const { runId } = await rogueApi.create(s.id, cand.id, { ascension: level, even: s.id.endsWith("-even") }); + location.hash = `#/rogue/${runId}`; + } catch (e) { + setSharing(e instanceof Error ? e.message : String(e)); + setMoving(false); + } + }; + + // Enter 直接再來一局(贏了就挑戰下一級):焦點不在按鈕、輸入框上的時候 + useEffect(() => { + if (!free) return; + const onKey = (e: KeyboardEvent) => { + if (e.key !== "Enter" || e.repeat || (document.activeElement && document.activeElement !== document.body)) return; + e.preventDefault(); + onAgain(nextLevel ?? undefined); + }; + addEventListener("keydown", onKey); + return () => removeEventListener("keydown", onKey); + }, [free, nextLevel, onAgain]); useEffect(() => { let alive = true; @@ -446,6 +486,17 @@ function ResultPanel({ 解鎖逆風 {record.unlocked} 級!

)} + {record.conquered && ( +

+ 全台制霸:拿下{record.conquered}!({owned}/{TERRITORIES.length}) + 看制霸地圖 +

+ )} + {record.typeRecord && view.identity && ( +

+ {view.identity.name}的新紀錄:贏下逆風 {record.typeRecord.level} 級 +

+ )} {island && (

政績點 +{island.points}({island.reason}) @@ -530,9 +581,14 @@ function ResultPanel({ 再選一次 )} - {record.unlocked !== null && !view.options.career && ( - + )} + {free && owned < TERRITORIES.length && ( + )} {!view.options.career && ( diff --git a/web/src/game/rogue/parts.tsx b/web/src/game/rogue/parts.tsx index db9d987..64ff332 100644 --- a/web/src/game/rogue/parts.tsx +++ b/web/src/game/rogue/parts.tsx @@ -1,5 +1,5 @@ import type { RogueCard, RogueIntent, RoguePreview, RogueTown, RogueView } from "@election2026/protocol"; -import { AlertTriangle, BookOpen, CircleHelp, Coins, Flag, Layers, Mic, Shield, ThumbsUp, Wind, Zap } from "lucide-react"; +import { AlertTriangle, BookOpen, CircleHelp, Coins, Flag, House, Layers, Mic, Shield, ThumbsUp, Wind, Zap } from "lucide-react"; import { CandidateBadge } from "../art/Badge.tsx"; import { CardArt } from "../art/CardArt.tsx"; import { AdvisorFace, CardFace } from "./cards.tsx"; @@ -14,6 +14,7 @@ export function RogueHud({ view, onDeck, onHelp }: { view: RogueView; onDeck: ()

{raceLabel(view)}

+ {view.identity && }
    {Array.from({ length: view.totalWeeks }, (_, i) => (
  1. @@ -178,6 +179,39 @@ export function TownList({ view, previews, best, onPick, focus }: { view: RogueV ); } +/** 候選人特色(docs/25):類型的名字一直看得到,點開看技能、弱點、本命區與依據 */ +function Identity({ view }: { view: RogueView }) { + const id = view.identity!; + return ( +
    + {id.name} +
    +

    + 技能 + {id.skill} +

    +

    + 弱點 + {id.weakness} +

    + {id.home && ( +

    + 本命區 + {id.home}:你的牌 ×1.2,失守聲勢 −2 +

    + )} + {id.rivalHome && ( +

    + 對手本命區 + {id.rivalHome}:攻下來聲勢 +2、對手下週少一個行動 +

    + )} + {id.basis && 依據:{id.basis}} +
    +
    + ); +} + function TownRow({ view, town: t, preview, best, focus, onPick }: { view: RogueView; town: RogueTown; preview: RoguePreview | null; best: boolean; focus: boolean; onPick: () => void }) { const share = townShare(t); const width = (n: number) => `${(n / (t.voters || 1)) * 100}%`; @@ -191,6 +225,11 @@ function TownRow({ view, town: t, preview, best, focus, onPick }: { view: RogueV )} {t.name} + {t.home && ( + + {t.home === "you" ? "本命區" : "對手本命區"} + + )} {t.office && ( 據點 diff --git a/web/src/game/rogue/progress.ts b/web/src/game/rogue/progress.ts index 8c582a1..ab04d7d 100644 --- a/web/src/game/rogue/progress.ts +++ b/web/src/game/rogue/progress.ts @@ -1,5 +1,6 @@ -import type { RogueView } from "@election2026/protocol"; +import { RogueArchetype, type RogueView } from "@election2026/protocol"; import { rogueApi } from "../api.ts"; +import { COUNTIES } from "../counties.ts"; /** * 選戰卡牌的進度(docs/22):成就、逆風難度解鎖、圖鑑看過的東西、每日一戰成績。 @@ -24,6 +25,10 @@ export interface Progress { /** 舊存檔已經從記錄過的局補過 played */ playedBackfilled?: boolean; tutorialDone: boolean; + /** 全台制霸(docs/25):打贏過的縣市代碼 → 第一次打贏的日期;總統大選是 "00000" */ + conquered?: Record; + /** 每種候選人類型打贏過的最高逆風等級(沒贏過就沒有) */ + typeBest?: Partial>; } export interface PlayedCandidate { @@ -34,6 +39,8 @@ export interface PlayedCandidate { } const KEY = "tongsuan.rogue.progress.v1"; +/** 上一局的 id(首頁的「繼續選戰」用) */ +export const LAST_RUN_KEY = "tongsuan.rogue.last"; const MAX_ASCENSION = 10; const empty = (): Progress => ({ @@ -106,9 +113,43 @@ export function markSeen(view: RogueView): void { saveProgress({ ...p, seen: { cards, advisors, events } }); } +/** 全台制霸的地盤:22 個縣市加總統大選 */ +export const PRESIDENT_CODE = "00000"; +export const TERRITORIES: readonly [string, string][] = [...COUNTIES, [PRESIDENT_CODE, "總統大選"]]; +const territoryName = (code: string): string | null => TERRITORIES.find(([c]) => c === code)?.[1] ?? null; + +export interface CompletionPart { + id: "map" | "types" | "climb" | "feats"; + label: string; + hint: string; + done: number; + total: number; +} + +/** + * 完成度(docs/25:讓人一場接一場、想把東西收集完):全台制霸、六種類型都贏過、每種類型的逆風挑戰、成就。 + * percent 是四項的平均;featTotal 是成就總數(圖鑑目錄給) + */ +export function completion(p: Progress, featTotal: number): { parts: CompletionPart[]; percent: number } { + const types = RogueArchetype.options; + const best = p.typeBest ?? {}; + const parts: CompletionPart[] = [ + { id: "map", label: "全台制霸", hint: "22 個縣市和總統大選,每一塊都打贏一次", done: Object.keys(p.conquered ?? {}).length, total: TERRITORIES.length }, + { id: "types", label: "六種類型", hint: "媒體、組織、資深、財務、清廉、黑馬型都贏過", done: types.filter((t) => best[t] !== undefined).length, total: types.length }, + { id: "climb", label: "類型逆風挑戰", hint: "每種類型從逆風 0 一路贏到逆風 10", done: types.reduce((a, t) => a + (best[t] === undefined ? 0 : best[t]! + 1), 0), total: types.length * (MAX_ASCENSION + 1) }, + { id: "feats", label: "成就", hint: "圖鑑裡的成就", done: Object.keys(p.feats).length, total: Math.max(featTotal, Object.keys(p.feats).length) }, + ]; + const percent = parts.reduce((a, x) => a + (x.total ? Math.min(1, x.done / x.total) : 0), 0) / parts.length; + return { parts, percent }; +} + export interface RunRecord { /** 這局第一次拿到的成就 */ newFeats: string[]; + /** 這局第一次打下的地盤(縣市或總統大選;沒有是 null) */ + conquered: string | null; + /** 這個類型的逆風新紀錄(沒有是 null) */ + typeRecord: { archetype: RogueArchetype; level: number } | null; /** 這局解鎖的逆風等級(沒有是 null) */ unlocked: number | null; /** 這個劇本的新紀錄 */ @@ -156,7 +197,7 @@ export async function backfillPlayed(): Promise> export function recordRun(view: RogueView): RunRecord { const p = loadProgress(); const r = view.result; - if (!r || p.recorded.includes(view.runId)) return { newFeats: [], unlocked: null, record: false, progress: p }; + if (!r || p.recorded.includes(view.runId)) return { newFeats: [], conquered: null, typeRecord: null, unlocked: null, record: false, progress: p }; const today = todayKey(); const newFeats = r.feats.filter((f) => !p.feats[f]); const feats = { @@ -168,6 +209,11 @@ export function recordRun(view: RogueView): RunRecord { const unlocked = r.won && !tutorial && level >= p.ascension && level < MAX_ASCENSION ? level + 1 : null; const prev = p.best[view.scenarioId]; const record = !tutorial && (!prev || r.youShare > prev.share); + // 全台制霸與類型挑戰:打贏才算,新手教學不算 + const territory = territoryName(view.countyCode) ? view.countyCode : null; + const conquered = r.won && !tutorial && territory && !p.conquered?.[territory] ? territory : null; + const arch = view.identity?.archetype ?? null; + const typeRecord = r.won && !tutorial && arch && level > (p.typeBest?.[arch] ?? -1) ? { archetype: arch, level } : null; const next: Progress = { ...p, feats, @@ -205,7 +251,9 @@ export function recordRun(view: RogueView): RunRecord { [view.you.name]: playedAfter(p.played[view.you.name], view.scenarioId, r.won, r.grade), }, tutorialDone: p.tutorialDone || tutorial, + conquered: conquered ? { ...p.conquered, [conquered]: today } : p.conquered, + typeBest: typeRecord ? { ...p.typeBest, [typeRecord.archetype]: typeRecord.level } : p.typeBest, }; saveProgress(next); - return { newFeats, unlocked, record, progress: next }; + return { newFeats, conquered: conquered ? territoryName(conquered) : null, typeRecord, unlocked, record, progress: next }; } diff --git a/web/src/game/rogue/rogue.css b/web/src/game/rogue/rogue.css index 2a04da5..63e6e1d 100644 --- a/web/src/game/rogue/rogue.css +++ b/web/src/game/rogue/rogue.css @@ -30,6 +30,17 @@ } .rg-hud-week { display: grid; gap: 4px; min-width: 0; } .rg-race { margin: 0; font-size: 12px; font-weight: 800; color: var(--muted); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; } +/* 候選人特色(docs/25):類型的名字一直看得到,點開看技能、弱點、本命區 */ +.rg-arch { position: relative; justify-self: start; font-size: 12px; } +.rg-arch > summary { display: inline-flex; align-items: center; gap: 4px; padding: 1px 8px; border-radius: 999px; background: var(--signal); color: var(--signal-ink); font-weight: 800; cursor: pointer; list-style: none; } +.rg-arch > summary::-webkit-details-marker { display: none; } +.rg-arch > summary::after { content: "▾"; font-size: 10px; } +.rg-arch-pop { position: absolute; z-index: 30; top: calc(100% + 6px); left: 0; width: min(320px, 80vw); display: grid; gap: 6px; padding: 10px 12px; background: var(--surface); color: var(--ink); border: 2px solid var(--ink); border-radius: 12px; box-shadow: 3px 3px 0 var(--shadow-ink); font-size: 13px; line-height: 1.5; } +.rg-arch-pop p { margin: 0; } +.rg-arch-pop b { margin-right: 6px; } +.rg-arch-pop small { color: var(--muted); } +.rg-home { display: inline-flex; align-items: center; gap: 2px; font-size: 11px; font-weight: 800; padding: 0 6px; border-radius: 999px; background: var(--signal); color: var(--signal-ink); } +.rg-home.is-rival { background: var(--stamp); color: #fff; } .rg-weeks { display: flex; gap: 4px; list-style: none; margin: 0; padding: 0; } .rg-weeks li { min-width: 26px; padding: 1px 6px; border-radius: 6px; text-align: center; font-family: var(--font-num); font-weight: 700; font-size: 14px; background: var(--surface-2); color: var(--muted); } .rg-weeks li.is-done { background: color-mix(in srgb, var(--ink) 18%, var(--surface)); color: var(--ink); } diff --git a/web/src/game/screens.css b/web/src/game/screens.css index 7508bb2..cf24542 100644 --- a/web/src/game/screens.css +++ b/web/src/game/screens.css @@ -14,6 +14,7 @@ .settings { position: relative; } .settings-menu { position: absolute; right: 0; top: calc(100% + 6px); background: var(--surface); border: 1px solid var(--line); border-radius: 12px; padding: 10px 12px; box-shadow: 0 10px 30px rgb(0 0 0 / 0.15); display: grid; gap: 8px; min-width: 200px; z-index: 10; transform-origin: top right; animation: modal-in 160ms var(--ease-out); } .settings-menu label { display: flex; align-items: center; justify-content: space-between; gap: 12px; font-size: 14px; } +.settings-credit { margin: 4px 0 0; max-width: 220px; font-size: 11px; line-height: 1.5; color: var(--muted); } .settings-menu select { min-height: 44px; padding: 2px 8px; border: 2px solid var(--ink); border-radius: 8px; background: var(--surface); color: var(--ink); font: inherit; font-size: 14px; } .icon-btn { display: inline-grid; place-items: center; width: 34px; height: 34px; border-radius: 10px; background: var(--surface-2); border: 1px solid var(--line); color: var(--ink); } diff --git a/web/src/game/start/HeroDiorama.tsx b/web/src/game/start/HeroDiorama.tsx index 39fd1ba..4918540 100644 --- a/web/src/game/start/HeroDiorama.tsx +++ b/web/src/game/start/HeroDiorama.tsx @@ -3,8 +3,9 @@ import { useEffect, useRef, useState, type ReactNode } from "react"; import { BallotStamp } from "../art/BallotStamp.tsx"; import { updateSettings, useSettings } from "../audio/settings.ts"; import { sfx } from "../audio/sfx.ts"; +import { holdSplash, splashProgress } from "../../splash.ts"; import { CampaignHero } from "./CampaignHero.tsx"; -import { createHero, type HeroHandle, type HeroPop } from "./hero3d.ts"; +import type { HeroHandle, HeroPop } from "./hero3d.ts"; import "./hero.css"; export type HeroCheer = (kind: "rally" | "truck" | "crowd") => void; @@ -20,6 +21,26 @@ interface HeroProps { * 首頁主視覺:會動的選戰小鎮(three.js),疊上標題、開始按鈕(copy)、手牌(overlay)與音樂開關。 * WebGL 不能用時退回原本的文宣海報;減少動態時只畫一張靜止的畫面。 */ +/** 首頁的內容畫上螢幕之後再執行(不支援的瀏覽器最多等 2 秒) */ +function whenPainted(fn: () => void) { + let done = false; + let observer: PerformanceObserver | null = null; + const go = () => { + if (done) return; + done = true; + observer?.disconnect(); + fn(); + }; + if (performance.getEntriesByName("first-contentful-paint").length) return go(); + try { + observer = new PerformanceObserver((list) => list.getEntriesByName("first-contentful-paint").length && go()); + observer.observe({ type: "paint", buffered: true }); + } catch { + // 不支援 paint 計時:靠下面的逾時 + } + window.setTimeout(go, 2000); +} + export function HeroDiorama({ copy, overlay }: HeroProps) { const canvasRef = useRef(null); const wrapRef = useRef(null); @@ -42,31 +63,61 @@ export function HeroDiorama({ copy, overlay }: HeroProps) { if (!canvas || !wrap) return; const reduceMotion = matchMedia("(prefers-reduced-motion: reduce)").matches; const lowPower = matchMedia("(max-width: 720px)").matches || (navigator.hardwareConcurrency ?? 8) <= 4; - let hero: HeroHandle | null = createHero(canvas, { - reduceMotion, - lowPower, - onReady: () => setState("ready"), - onError: () => setState("failed"), - onPop: (pop) => { - const id = ++popId.current; - setPops((list) => [...list.slice(-5), { ...pop, id }]); - setTimeout(() => setPops((list) => list.filter((x) => x.id !== id)), 1100); - if (pop.kind === "vote") sfx.coin(); - else if (pop.kind === "truck") sfx.cheer(); - else if (pop.kind === "stage") sfx.firecracker(); - else sfx.hop(); - }, - onChallenge: ({ left, score, done }) => { - setChallenge({ endAt: Date.now() + left * 1000, score, done }); - if (done) sfx.applause(); - }, - }); - heroRef.current = hero; + let hero: HeroHandle | null = null; + let cancelled = false; + // 小鎮搭好(或失敗)才讓載入畫面淡出 + const releaseSplash = holdSplash(); + splashProgress("準備選戰小鎮…", 0.05); const size = () => { const r = wrap.getBoundingClientRect(); hero?.resize(Math.round(r.width), Math.round(r.height)); }; - size(); + // three.js 和模型很大,建 WebGL 也要時間:等首頁先畫出來、瀏覽器閒下來再開始(標題和按鈕不用等小鎮) + const start = () => { + if (cancelled) return; + void import("./hero3d.ts").then( + ({ createHero }) => { + if (cancelled) return; + hero = createHero(canvas, { + reduceMotion, + lowPower, + onReady: () => { + setState("ready"); + releaseSplash(); + }, + onError: () => { + setState("failed"); + releaseSplash(); + }, + onProgress: (loaded, total) => splashProgress(loaded < total ? `搭建選戰小鎮… ${loaded}/${total}` : "準備畫面…", 0.1 + 0.85 * (loaded / Math.max(1, total))), + onPop: (pop) => { + const id = ++popId.current; + setPops((list) => [...list.slice(-5), { ...pop, id }]); + setTimeout(() => setPops((list) => list.filter((x) => x.id !== id)), 1100); + if (pop.kind === "vote") sfx.coin(); + else if (pop.kind === "truck") sfx.cheer(); + else if (pop.kind === "stage") sfx.firecracker(); + else sfx.hop(); + }, + onChallenge: ({ left, score, done }) => { + setChallenge({ endAt: Date.now() + left * 1000, score, done }); + if (done) sfx.applause(); + }, + }); + heroRef.current = hero; + size(); + hero.setActive(!document.hidden); + }, + () => { + if (cancelled) return; + setState("failed"); + releaseSplash(); + }, + ); + }; + // 再等瀏覽器回報首頁的字已經畫上螢幕:沒有顯示卡時建 WebGL 會讓繪圖行程忙好幾秒,太早開始首頁會晚出來 + const afterPaint = () => whenPainted(start); + const idle = typeof requestIdleCallback === "function" ? requestIdleCallback(afterPaint, { timeout: 1500 }) : window.setTimeout(afterPaint, 300); const ro = new ResizeObserver(size); ro.observe(wrap); // 捲到看不見或切到別的分頁時暫停,省電 @@ -75,6 +126,10 @@ export function HeroDiorama({ copy, overlay }: HeroProps) { const onVis = () => hero?.setActive(!document.hidden); document.addEventListener("visibilitychange", onVis); return () => { + cancelled = true; + releaseSplash(); + if (typeof cancelIdleCallback === "function") cancelIdleCallback(idle); + else window.clearTimeout(idle); ro.disconnect(); io.disconnect(); document.removeEventListener("visibilitychange", onVis); diff --git a/web/src/game/start/hero3d.ts b/web/src/game/start/hero3d.ts index d00a6a5..b079247 100644 --- a/web/src/game/start/hero3d.ts +++ b/web/src/game/start/hero3d.ts @@ -8,6 +8,9 @@ import { clone as cloneSkinned } from "three/examples/jsm/utils/SkeletonUtils.js * 模型、貼圖都是 CC0(web/public/assets/LICENSES.md);人物是不具名的 Q 版小人,不代表任何真人。 */ +// 同一個資料夾的模型共用 Textures/colormap.png:開快取,同一張圖只下載一次 +THREE.Cache.enabled = true; + const A = "/assets/3d/"; const T = "/assets/textures/"; const PALETTE = ["#d61f2c", "#ffd23f", "#1d4fa3", "#ffffff", "#0f8a4a", "#ff8a3d"]; @@ -37,10 +40,12 @@ export interface HeroPop { interface Options { reduceMotion: boolean; - /** 手機:關陰影、降解析度 */ + /** 手機:關陰影、降解析度(桌機跑不動時也會自動降,見 QUALITY) */ lowPower: boolean; onReady: () => void; onError: () => void; + /** 模型、貼圖讀了幾個(載入畫面的進度) */ + onProgress?: (loaded: number, total: number) => void; onPop: (pop: HeroPop) => void; onChallenge: (state: { left: number; score: number; done: boolean }) => void; } @@ -169,6 +174,23 @@ function roadPoint(u: number): { x: number; z: number; angle: number } { return { x: p.x, z: p.z, angle: Math.atan2(d.x, d.z) }; } +/** + * 畫質等級:一開始用最高的,實際每秒畫不到 30 張就往下降一級(沒有獨立顯示卡、虛擬機的軟體繪圖都會用到)。 + * 降級只會往下,不會再升回去,避免畫面忽好忽壞。 + */ +const QUALITY = [ + { shadows: true, maxDpr: 1.5, fps: 60 }, + { shadows: false, maxDpr: 1, fps: 60 }, + { shadows: false, maxDpr: 0.75, fps: 30 }, +] as const; + +/** 沒有顯示卡、用 CPU 畫 WebGL(虛擬機、遠端桌面):建立 WebGL 和編譯 shader 都要好幾秒 */ +function isSoftwareRenderer(gl: WebGLRenderingContext | WebGL2RenderingContext): boolean { + const info = gl.getExtension("WEBGL_debug_renderer_info"); + const name = String(gl.getParameter(info ? info.UNMASKED_RENDERER_WEBGL : gl.RENDERER)); + return /swiftshader|llvmpipe|softpipe|software|basic render/i.test(name); +} + export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle { let renderer: THREE.WebGLRenderer; try { @@ -188,12 +210,22 @@ export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle dispose: () => {}, }; } - renderer.setPixelRatio(Math.min(devicePixelRatio, opts.lowPower ? 1.25 : 1.75)); + // 軟體繪圖一開始就用最低畫質:先用高畫質編譯一輪、再降級重編一輪,會卡更久 + let level = isSoftwareRenderer(renderer.getContext()) ? QUALITY.length - 1 : opts.lowPower ? 1 : 0; + const startShadows = QUALITY[level]!.shadows; + let size = { w: 1, h: 1 }; + const applyPixelRatio = () => { + renderer.setPixelRatio(Math.min(devicePixelRatio, QUALITY[level]!.maxDpr)); + renderer.setSize(size.w, size.h, false); + }; + applyPixelRatio(); renderer.outputColorSpace = THREE.SRGBColorSpace; renderer.toneMapping = THREE.ACESFilmicToneMapping; renderer.toneMappingExposure = 1.05; - renderer.shadowMap.enabled = !opts.lowPower; + renderer.shadowMap.enabled = startShadows; renderer.shadowMap.type = THREE.PCFSoftShadowMap; + // 影子每兩張畫面更新一次:宣傳車和小人動得慢,看不出差別,陰影的成本少一半 + renderer.shadowMap.autoUpdate = false; const scene = new THREE.Scene(); const camera = new THREE.PerspectiveCamera(32, 2, 0.1, 200); @@ -203,7 +235,7 @@ export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle scene.add(new THREE.HemisphereLight("#fff4df", "#6b4a2b", 1.1)); const sun = new THREE.DirectionalLight("#ffe0b0", 2.2); sun.position.set(-8, 14, 9); - sun.castShadow = !opts.lowPower; + sun.castShadow = startShadows; sun.shadow.mapSize.set(1024, 1024); Object.assign(sun.shadow.camera, { left: -12, @@ -220,7 +252,9 @@ export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle scene.add(rim); const textures: THREE.Texture[] = []; - const texLoader = new THREE.TextureLoader(); + const manager = new THREE.LoadingManager(); + manager.onProgress = (_url, loaded, total) => opts.onProgress?.(loaded, total); + const texLoader = new THREE.TextureLoader(manager); const tex = (url: string, repeat = 1, color = true) => { const t = texLoader.load(url); if (color) t.colorSpace = THREE.SRGBColorSpace; @@ -280,7 +314,7 @@ export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle }); stage.add(deck, trim, backdrop, ...poles); stage.position.set(0.4, 0, -1.4); - shadows(stage, !opts.lowPower); + shadows(stage, startShadows); scene.add(stage); const mixers: THREE.AnimationMixer[] = []; @@ -327,7 +361,7 @@ export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle } }; - const loader = new GLTFLoader(); + const loader = new GLTFLoader(manager); const load = (path: string) => new Promise((resolve, reject) => loader.load(A + path, resolve, undefined, reject)); const build = async () => { @@ -378,7 +412,7 @@ export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle const box = new THREE.Box3().setFromObject(b); b.position.set(x + w / 2, 0, front - box.max.z); x += w + GAP; - shadows(b, !opts.lowPower); + shadows(b, startShadows); scene.add(b); } // 樹:種在板子四周的草地上,離馬路有距離,不擋宣傳車 @@ -393,7 +427,7 @@ export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle ).forEach(([tx, tz, kind, size]) => { const t = fit(trees[kind]!.scene.clone(), size); t.position.set(tx, 0, tz); - shadows(t, !opts.lowPower); + shadows(t, startShadows); scene.add(t); }); // 舞台上方的燈串 @@ -426,7 +460,7 @@ export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle const speaker = fit(cloneSkinned(chars[0]!.scene), 1.25); speaker.position.set(0.4, 0.5, -1.2); speaker.rotation.y = 0; - shadows(speaker, !opts.lowPower); + shadows(speaker, startShadows); scene.add(speaker); anim(chars[0]!, "emote-yes", speaker.children[0]!, 0, speaker); stageGroup = stage; @@ -449,7 +483,7 @@ export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle person.position.set(x, 0, z); // 面向舞台,帶一點角度讓鏡頭看得到臉 person.rotation.y = Math.PI + Math.atan2(x - 0.4, z + 1.2) * 0.6; - shadows(person, !opts.lowPower); + shadows(person, startShadows); scene.add(person); anim(src, i % 3 === 1 ? "emote-yes" : "idle", person.children[0]!, (i * 0.37) % 1, person); // 一半的人旁邊插一支旗子 @@ -457,7 +491,7 @@ export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle const f = fit(flag.scene.clone(), 1.5); f.position.set(x + 0.28, 0, z - 0.1); f.rotation.y = -0.4 + (i % 4) * 0.2; - shadows(f, !opts.lowPower); + shadows(f, startShadows); scene.add(f); } }); @@ -474,7 +508,7 @@ export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle sign2.position.x = -0.12; sign2.rotation.y = Math.PI; truck.add(sign, sign2); - shadows(truck, !opts.lowPower); + shadows(truck, startShadows); scene.add(truck); floaterSources = [fit(coin.scene, 0.45), fit(star.scene, 0.5), fit(heart.scene, 0.45), fit(pineapple.scene, 0.55)]; @@ -509,26 +543,28 @@ export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle const crowdIdx = people.map((_, i) => i).filter((i) => i > 0 && i !== not); return crowdIdx[Math.floor(Math.random() * crowdIdx.length)] ?? 1; }; - const owner = (o: THREE.Object3D | null): { kind: "person"; index: number } | { kind: "truck" | "stage" } | null => { - for (let x = o; x; x = x.parent) { - const i = people.findIndex((p) => p.root === x); - if (i >= 0) return { kind: "person", index: i }; - if (x === truck) return { kind: "truck" }; - if (x === stageGroup) return { kind: "stage" }; - } - return null; - }; - const hit = (e: PointerEvent) => { + // 點擊、滑過用每個東西的外框盒判斷:小人有骨架動畫,逐點判斷很貴,滑鼠一動就會卡 + type Target = { kind: "person"; index: number } | { kind: "truck" | "stage" }; + const hitBox = new THREE.Box3(); + const hitPoint = new THREE.Vector3(); + const hit = (e: { clientX: number; clientY: number }) => { const r = canvas.getBoundingClientRect(); ndc.set(((e.clientX - r.left) / r.width) * 2 - 1, -((e.clientY - r.top) / r.height) * 2 + 1); ray.setFromCamera(ndc, camera); - const roots = [...people.map((p) => p.root), ...(truck ? [truck] : []), ...(stageGroup ? [stageGroup] : [])]; - const first = ray.intersectObjects(roots, true)[0]; - return { - target: first ? owner(first.object) : null, - x: e.clientX - r.left, - y: e.clientY - r.top, - }; + const candidates: [THREE.Object3D, Target][] = people.map((p, index) => [p.root, { kind: "person", index }]); + if (truck) candidates.push([truck, { kind: "truck" }]); + if (stageGroup) candidates.push([stageGroup, { kind: "stage" }]); + let target: Target | null = null; + let nearest = Infinity; + for (const [obj, t] of candidates) { + if (!ray.ray.intersectBox(hitBox.setFromObject(obj), hitPoint)) continue; + const d = hitPoint.distanceToSquared(ray.ray.origin); + if (d < nearest) { + nearest = d; + target = t; + } + } + return { target, x: e.clientX - r.left, y: e.clientY - r.top }; }; const jump = (i: number) => { const p = people[i]; @@ -566,8 +602,16 @@ export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle opts.onPop({ x, y, text: "選戰開打!", kind: "stage" }); } }; + // 滑過只記下位置,下一張畫面再判斷一次(滑鼠事件一秒可能上百次) + let hoverAt: { clientX: number; clientY: number } | null = null; + const updateHover = () => { + if (!hoverAt) return; + canvas.style.cursor = hit(hoverAt).target ? "pointer" : ""; + hoverAt = null; + }; const onHover = (e: PointerEvent) => { - canvas.style.cursor = hit(e).target ? "pointer" : ""; + hoverAt = { clientX: e.clientX, clientY: e.clientY }; + if (opts.reduceMotion) updateHover(); }; canvas.addEventListener("pointerdown", onDown); canvas.addEventListener("pointermove", onHover); @@ -581,11 +625,34 @@ export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle camera.lookAt(target.x, target.y + view.lift, target.z); }; + // 關影子要重編 shader:在背景編好之前先停畫,不然會整個卡住 + let compiling = false; + const setLevel = (next: number) => { + level = next; + if (!QUALITY[level]!.shadows && sun.castShadow) { + sun.castShadow = false; + renderer.shadowMap.enabled = false; + compiling = true; + void renderer.compileAsync(scene, camera).finally(() => (compiling = false)); + } + applyPixelRatio(); + }; + // 實際每秒畫幾張:暖身一秒後量兩秒,太慢就降一級再量;夠快就不再量 + let probe: { start: number; frames: number } | null = null; + const restartProbe = (now: number) => { + probe = level < QUALITY.length - 1 ? { start: now + 1000, frames: 0 } : null; + }; + let lastDraw = 0; + let frameNo = 0; + const dummy = new THREE.Object3D(); - const frame = () => { + const frame = (now: number) => { if (disposed) return; raf = requestAnimationFrame(frame); if (!active) return; + // 30 fps 的等級隔一張才畫 + if (compiling || now - lastDraw < 1000 / QUALITY[level]!.fps - 4) return; + lastDraw = now; const dt = Math.min(clock.getDelta(), 0.05); const t = clock.elapsedTime; place(t); @@ -661,19 +728,38 @@ export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle confetti.setMatrixAt(i, dummy.matrix); } if (CONFETTI) confetti.instanceMatrix.needsUpdate = true; + updateHover(); + frameNo++; + if (renderer.shadowMap.enabled && frameNo % 2 === 0) renderer.shadowMap.needsUpdate = true; renderer.render(scene, camera); + if (probe && now >= probe.start) { + probe.frames++; + const span = now - probe.start; + if (span >= 2000) { + const fps = (probe.frames * 1000) / span; + if (fps < 27) { + setLevel(level + 1); + restartProbe(now); + } else probe = null; + } + } }; // 模型還沒讀完玩家就離開首頁(已經 dispose):不要再啟動繪圖迴圈,否則它會在背景一直跑 let disposed = false; build() + // shader 在背景編譯(瀏覽器支援時不會卡住畫面),編好才畫第一張 + .then(() => renderer.compileAsync(scene, camera)) .then(() => { if (disposed) return; place(0); + renderer.shadowMap.needsUpdate = true; renderer.render(scene, camera); opts.onReady(); - if (!opts.reduceMotion) raf = requestAnimationFrame(frame); - else { + if (!opts.reduceMotion) { + restartProbe(performance.now()); + raf = requestAnimationFrame(frame); + } else { // 減少動態:停在一張好看的畫面,只畫一次 for (const m of mixers) m.update(0.4); if (truck) { @@ -681,6 +767,7 @@ export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle truck.position.set(p.x, 0, p.z); truck.rotation.y = p.angle; } + renderer.shadowMap.needsUpdate = true; renderer.render(scene, camera); } }) @@ -688,7 +775,8 @@ export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle return { resize(w, h) { - renderer.setSize(w, h, false); + size = { w, h }; + applyPixelRatio(); camera.aspect = w / Math.max(1, h); // 窄螢幕拉遠一點,整塊板子都看得到 camera.fov = camera.aspect < 1 ? 40 : camera.aspect < 1.5 ? 36 : 32; @@ -696,6 +784,7 @@ export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle camera.updateProjectionMatrix(); if (opts.reduceMotion) { place(0); + renderer.shadowMap.needsUpdate = true; renderer.render(scene, camera); } }, @@ -714,7 +803,11 @@ export function createHero(canvas: HTMLCanvasElement, opts: Options): HeroHandle }, setActive(on) { active = on; - if (on) clock.getDelta(); + if (on) { + clock.getDelta(); + // 切回來時重新量,暫停期間的空檔不算 + if (probe) restartProbe(performance.now()); + } }, dispose() { disposed = true; diff --git a/web/src/splash.ts b/web/src/splash.ts new file mode 100644 index 0000000..d96f18c --- /dev/null +++ b/web/src/splash.ts @@ -0,0 +1,44 @@ +/** + * 載入畫面(index.html 的 #splash):首頁等 3D 小鎮搭好才淡出,其他畫面一顯示就淡出。 + * 首頁的主視覺用 holdSplash() 擋住,搭好或離開首頁時放開;最多擋 8 秒,免得卡在載入畫面。 + */ +const MAX_MS = 8000; +let holders = 0; + +const el = () => document.getElementById("splash"); + +export function splashProgress(text: string, fraction: number) { + const s = el(); + if (!s) return; + const fill = s.querySelector(".splash-fill"); + const label = s.querySelector(".splash-text"); + if (fill) fill.style.width = `${Math.round(8 + Math.min(1, Math.max(0, fraction)) * 92)}%`; + if (label) label.textContent = text; +} + +export function hideSplash() { + const s = el(); + if (!s || s.classList.contains("is-done")) return; + s.classList.add("is-done"); + window.setTimeout(() => s.remove(), 350); +} + +/** 先別淡出(首頁的 3D 小鎮還在搭);回傳放開的函式 */ +export function holdSplash(): () => void { + holders++; + let released = false; + return () => { + if (released) return; + released = true; + holders--; + releaseSplashIfFree(); + }; +} + +/** 沒有人擋著就淡出(每個畫面顯示時呼叫) */ +export function releaseSplashIfFree() { + // 晚一拍再看:React 開發模式會先卸載再重新掛上,中間那一下不能淡出 + window.setTimeout(() => holders === 0 && hideSplash(), 0); +} + +window.setTimeout(hideSplash, MAX_MS); diff --git a/web/test/rogue-progress.test.ts b/web/test/rogue-progress.test.ts index 3f8e167..37293ff 100644 --- a/web/test/rogue-progress.test.ts +++ b/web/test/rogue-progress.test.ts @@ -1,6 +1,6 @@ import type { RogueView } from "@election2026/protocol"; import { beforeEach, describe, expect, it } from "vitest"; -import { dailyPick, loadProgress, recordRun, todayKey } from "../src/game/rogue/progress.ts"; +import { completion, dailyPick, loadProgress, PRESIDENT_CODE, recordRun, TERRITORIES, todayKey } from "../src/game/rogue/progress.ts"; /** 測試用的 localStorage(vitest 跑在 Node,沒有瀏覽器的儲存空間) */ function fakeStorage(): Storage { @@ -87,3 +87,37 @@ describe("選戰卡牌的進度", () => { expect(todayKey(new Date(2026, 9, 26))).toBe("2026-10-26"); }); }); + +describe("完成度:全台制霸、類型逆風挑戰(docs/25)", () => { + beforeEach(() => { + Object.defineProperty(globalThis, "localStorage", { + value: fakeStorage(), + configurable: true, + }); + }); + + const inCounty = (view: RogueView, countyCode: string, archetype: string | null): RogueView => + ({ ...view, countyCode, identity: archetype ? { archetype, name: "媒體型", skill: "", weakness: "", basis: null, home: "", rivalHome: "" } : null }) as unknown as RogueView; + + it("贏了才插旗;同一個縣市只算第一次;總統大選是另一塊地盤", () => { + expect(recordRun(inCounty(finished("a", false), "68000", null)).conquered).toBeNull(); + expect(recordRun(inCounty(finished("b", true), "68000", null)).conquered).toBe("桃園市"); + expect(recordRun(inCounty(finished("c", true), "68000", null)).conquered).toBeNull(); + expect(recordRun(inCounty(finished("d", true), PRESIDENT_CODE, null)).conquered).toBe("總統大選"); + expect(Object.keys(loadProgress().conquered ?? {}).sort()).toEqual([PRESIDENT_CODE, "68000"].sort()); + }); + + it("類型各自記最高贏到的逆風;完成度是四項的平均", () => { + expect(recordRun(inCounty(finished("a", true, 0), "68000", "media")).typeRecord).toEqual({ archetype: "media", level: 0 }); + expect(recordRun(inCounty(finished("b", true, 1), "68000", "media")).typeRecord).toEqual({ archetype: "media", level: 1 }); + expect(recordRun(inCounty(finished("c", true, 0), "68000", "media")).typeRecord).toBeNull(); + expect(recordRun(inCounty(finished("d", false, 3), "68000", "finance")).typeRecord).toBeNull(); + const { parts, percent } = completion(loadProgress(), 22); + const by = Object.fromEntries(parts.map((p) => [p.id, p])); + expect(by.map).toMatchObject({ done: 1, total: TERRITORIES.length }); + expect(by.types).toMatchObject({ done: 1, total: 6 }); + expect(by.climb).toMatchObject({ done: 2, total: 66 }); + expect(by.feats).toMatchObject({ done: 1, total: 22 }); + expect(percent).toBeCloseTo((1 / 23 + 1 / 6 + 2 / 66 + 1 / 22) / 4); + }); +});