DefendTaipei-Lab 保衛台北

以真實台北街道為戰場的生存遊戲原型：玩法參考《Project Zomboid》（俯視生存沙盒），但敵人是已經佔領台北的解放軍佔領部隊。你是萬華巷弄裡的倖存者，搜刮物資、避開巡邏、一區一區奪回街區。

線上遊玩： https://game.lijiabao.uk/defendtaipei/（遊戲總站 https://game.lijiabao.uk/ ；舊網址 https://lijiabao1998.github.io/DefendTaipei-Lab/ 會自動轉址）

語言 / Language

可在標題畫面或「設定」選擇 English／繁體中文，切換會重新載入；一般單人遊戲會先存檔並續玩。預設維持繁體中文，既有存檔 ID 不變。原場景招牌與歷史紀錄保留原文。驗證界線見 English localization notes。

操作

按鍵	功能
WASD	移動
Shift	奔跑（噪音大、耗體力）
C	切換潛行（慢、無腳步聲、較難被看見）
滑鼠 / 左鍵	瞄準 / 攻擊（近戰從背後偷襲傷害×3）
E	搜刮附近容器／上下車／和 NPC 交談
Tab / I	背包（點物品使用或裝備）
B	用鐵鎚+木板封門／拆除
Z	室內睡覺（時間快轉）
F	手電筒
空白鍵	翻越矮牆
Q	推開敵人
1 / 2 / 3	時間 ×1 / ×3 / ×20
M	生存者地圖（Esc 關閉）
滾輪	縮放

手機：畫面左下方的虛擬搖桿移動（推到底奔跑），上車後同一個搖桿駕駛；地圖按右側 🗺。

v0.1 內容

• 萬華／西門町約 1 km² 真實街道與 497 棟建築（OpenStreetMap），可進入建築、屋頂與前景牆面自動透明化
• 騎樓柱廊、鐵窗、頂樓加蓋鐵皮屋、水塔、機車、諧仿招牌（7-12、康是福藥局…）
• 飽足／水分／疲勞／生命、流血與止血、死亡即永久結束（刪除存檔）
• 解放軍巡邏：視野錐（白天遠、夜間近）、聽覺（槍聲約 40–55m）、搜索與交火；夜間宵禁有額外巡邏隊
• 9 個街區，消滅區內全部佔領軍即奪回該街區
• 日夜循環（1 秒 = 遊戲 1 分鐘）、localStorage 自動存檔

開發

npm install
npm run dev                      # 開發伺服器
npm run typecheck                # TypeScript 型別檢查
npm run format                   # Prettier 排版（設定在 .prettierrc.json）
npm run build && npm run smoke   # 建置後跑冒煙測試（Playwright：選角、序章、移動、背包、搜刮、夜間）
npm run fetch-osm                # 重新從 Overpass API 抓取地圖
node scripts/tiles.mjs           # 重新切 200 m 道路細節圖塊（public/data/tiles/）

• 推到 main 會由 GitHub Actions 建置並部署到 GitHub Pages。
• 每個 PR 會自動跑 CI（.github/workflows/ci.yml）：型別檢查、排版檢查、不需瀏覽器的檢查（node scripts/checks/modules.mjs）、建置，接著平行跑三個瀏覽器測試：冒煙測試、劇情存檔流程、警報測試音。CI 用軟體算圖，全部跑完約 15 分鐘。合併前請等 CI 全綠。
• scripts/checks/ 是各版本的功能截圖腳本（例如 node scripts/checks/v18veh.mjs），需要先 npm run preview；截圖存到 shots/。共用設定見 scripts/lib.mjs：URL（遊戲網址）、SHOTS_DIR（截圖資料夾）、PW_CHROMIUM（沒有安裝 Playwright 瀏覽器時指定 Chromium 路徑）。
• 多人連線伺服器在 server/，說明見 server/README.md。

程式結構

檔案	內容
src/main.ts	遊戲狀態與各系統的串接、主迴圈、開機流程（檔案開頭有章節索引）
src/world.ts、geom.ts	共用型別（建築、門、牆段、容器）、道路寬度、2D 幾何工具
src/textures.ts、texq.ts	程序生成的牆面／道路／招牌貼圖與材質（手機半解析度）
src/interiors.ts、alley.ts、decay.ts、facade.ts、park.ts、rooftin.ts	室內、夜巷、破舊感、窗戶與人行道、公園、頂樓加蓋
src/roads.ts、roadglyphs.ts、traffic.ts	道路細節串流（v19）、標線字樣圖集（v19.2）、序章車流
src/human.ts、fabric.ts、roles.ts、portrait.ts	白面人角色與動畫、程序化布料材質（v17.2）、5 種職業、選角立繪
src/drive.ts、vehicles.ts	可駕駛載具（v18）、路邊停放的車輛
src/armor.ts、drone.ts、fpv.ts、roc.ts、pla-loot.ts	解放軍裝甲與無人機、FPV 自殺無人機、國軍支援、士兵掉落物
src/items.ts、icons.ts	物品資料與圖示
src/map.ts	生存者地圖
src/evac.ts、cine.ts	撤離區與過場動畫
src/net.ts、sim/core.ts	多人連線用戶端、與伺服器共用的模擬核心
src/joystick.ts、nav.ts	手機搖桿、A* 尋路

授權與聲明

地圖資料 © OpenStreetMap contributors，以 ODbL 授權。本作為虛構作品，人物、部隊番號皆為虛構；店名皆為諧仿，與真實品牌無關。

第二版更新

• 開局選角：阿明（男）／小雯（女，護理師）
• 程序骨架人物動作：待機、走、跑、潛行、近戰、瞄準射擊、搜刮、受傷、死亡、睡覺；佔領軍同樣有骨架動作與 A* 尋路
• 出生點附近的精細街區：7-12 超商（冰箱牆、關東煮/茶葉蛋櫃台、i-Box、彩券）、康是福藥妝、雜貨店、檳榔攤、早餐店、夜市攤、有隔間的住家
• 所有物品都有圖示與貨架貼圖（皆為原創程序繪製的諧仿包裝）
• 停放的機車、汽車、計程車（載具系統雛形，尚未可駕駛），夜間路燈
• 所有模型與圖示皆為程式生成的原創內容

第三版更新（打磨出生街區）

• 白面人風格角色：無五官的白色人台臉、分層服裝（襯衫/外套/褲/鞋/背包）、女性馬尾；佔領軍同為白面人，配虛構裝備（頭盔、護目鏡、防彈背心、彈匣袋、無線電）
• 更流暢的程序動畫：彈簧混合、加減速慣性、轉彎傾身、原地轉身踏步、步幅鎖定腳步＋髖部 IK、呼吸待機、上下半身分層（邊走邊瞄）、平滑潛行、翻越（空白鍵）、推人（Q）、中彈踉蹌、三種死亡倒地
• 「破」與無序感：電線桿＋變壓器＋糾纏電線、歪斜路牌、重疊直立招牌（諧仿店名）、剝落/水痕/霉斑外牆與二丁掛磁磚、破窗、生鏽鐵窗、滴水冷氣、曬衣竿、垃圾、瓦礫、燒毀車輛、沙包、佔領軍檢查哨、路障、坑洞、積水
• 停放車輛大幅減少以提升效能；A* 尋路改為出生區 0.5m 網格並支援部分路徑

v4 — 萬華夜巷（以實景照片為參考）

• src/alley.ts：臨街立面自動佈景：鐵皮雨遮＋日光燈管、捲門/亮燈店面、牆面電線束、電表箱、水管、春聯/福。
• 垂直燈箱圖集（金爺、夜香妃、雙福餐廳、DVD光碟片、OPEN 霓虹等，全為虛構店名）。
• InstancedMesh 地面雜物：機車排（綠色外送箱）、腳踏車、紅藍塑膠椅、啤酒箱、黑垃圾袋、垃圾桶、紙箱、三角錐、盆栽、紅地毯、紅線、水溝蓋。
• 果汁攤／肉粥攤、金爐（火光＋粒子）、神桌佛具店木雕、牌樓（華興街觀光夜市）。
• 夜間：霓虹/日光燈點光源池、濕地面反光。

v5 — 劇情：有水有電 → 斷電 → 斷水

• 時間線（存檔保存）：第1天 國家級警報/收音機 → 第2天 里長群組 → 第3天 電力公司簡訊、19:00 斷電（路燈/霓虹/室內燈/冰箱全滅，冷藏食物逐時腐壞）→ 第4天 收音機 → 第5天 07:00 斷水（飲水機/流理台不再出水）。右上手機通知。
• 傳統圓盤電錶（玻璃罩＋錶盤）成排裝在立面與電線桿上，附進出線；機車格白線。
• 建築高度：約半數 2–3 樓透天（頂樓加蓋、高架水塔）、4–5 樓公寓、少數更高。
• 牆面長期髒污：窗台下水泥灰流痕、樓板邊黑色水漬、鐵窗鏽水、霉斑。
• 室內：神明廳（神明桌＋公媽龕、神明爐/公媽爐、神明燈、供品）、木沙發＋泡茶組＋藤椅、飲水機、保健食品櫃、日曆、藍白拖、磨石子地；柑仔店前店後居（糖果罐櫃、秤、後方居家）；五金行（工具洞洞板、零件盒、梯子、瓦斯桶、水管）；社區超市（貨架通道標示、結帳櫃台、冷藏牆）。

v6 — 街道比例、窗戶與頂樓

• 人行道依《市區道路及附屬工程設計標準》§16 等比例：大路 1.5–2.5m 高 15–20cm 緣石人行道（遇建築/騎樓/車道中斷），中型路 1.2–1.5m；6–10m 巷弄多數無人行道，部分繪 1.0–1.2m 綠色標線型人行道＋白色邊線＋行人圖示
• 移除零碎紅線，改為整條連續的紅線（禁停）或黃線，只出現在部分道路
• 文案：「解放」全面改為「奪回」
• 頂樓：女兒牆、鏽鐵欄杆、樓梯間、鋼架水塔、太陽能熱水器、電視天線、小耳朵、曬衣架、保麗龍箱頂樓菜園、多色鏽蝕鐵皮加蓋
• 窗戶：3D 鋁窗（銀/茶色/黑框，左右推拉）、反光玻璃、窗簾/百葉、四種鐵窗花樣、冷氣、雨遮、破窗與木板封窗；隨停電明暗

v7 — 時間系統

• 新遊戲可選一天長度 1／2／4 小時（存檔保存）；劇情依遊戲內時鐘。
• 快轉 1x／3x／20x（HUD 按鈕或 1/2/3 鍵），睡覺自動快轉；敵人接近、噪音、受傷時自動降回 1x。
• 宵禁 20:00–06:00：視野縮小、巡邏增加、手電筒光錐。飢餓／口渴／疲勞／腐敗依遊戲時間計算。
• 地下電台廣播、空投事件（紅色煙霧，解放軍會爭奪）、下雨（地面變濕、雨聲）、雨水桶集水（停水後仍可用）。
• 鐵皮／雨遮改為灰綠、青與褪色鐵鏽紅；攤車移至人行道與騎樓；騎樓柱只出現在立面前；空地改為鄰里公園或停車場。
• 路面：裂縫變細淡、油漬變淡、積水只在下雨時明顯、電線不投影、只保留主幹道連續中線、陰影 normalBias。

v8 — 撤離結局（另一個結局，奪回之路保留）

• 直升機撤離：第 6 天晚上電台預告；第 7 天 06:00 廣播開啟撤離窗口，至第 8 天 18:00 永久關閉。西側河濱撤離區（綠色 H、橘旗、紅色信號彈）；HUD 顯示剩餘時間。抵達即播放動畫：通用低多邊形直升機接應 → 飛越台灣海峽 → 降落福特號航空母艦（CVN-78）甲板 → 結算卡。
• 聯絡人＋小艇：每局聯絡人隨機出現在廟口／柑仔店後巷／公園，給出宵禁時段的河岸接頭點。30% 是佔領軍陷阱：假聯絡人說錯街名、要你「一個人來、武器留下」；廟口阿伯會提醒。可事先偵察（廂型車、無拖船痕跡 vs 藏好的橡皮艇）或用收音機／物資向「自由之聲」查證。中陷阱有 3 秒反應時間，可逃進巷子或跳進河；逃脫後該處標為危險區，叛徒躲回街區，抓到他會供出真接頭點或佔領軍前哨（計入奪回）。看穿陷阱可反伏擊並取得裝備箱。真聯絡人：小艇沿淡水河出海，與福特號會合。
• 結算卡可選「繼續留在萬華（奪回之路）」或新遊戲。

v9

• 頂樓加蓋重做：參考台灣實景，真實小屋型態（人字、圓拱、單斜屋頂＋出簷）、浪板肋紋法線、鋁窗＋鐵窗、門、雨槽落水管、不鏽鋼水塔架、鏽痕補丁、曬衣架、冷氣、盆栽、天線；以灰綠／藍綠與褪色鐵鏽紅為主；夜間窗戶亮燈。
• 撤離動畫重製（延遲載入 cine chunk）：手工建模福特級航艦（斜角甲板標線、艦島雷達、3 座升降機、彈射軌、攔截索、停放艦載機、彩色背心甲板人員）、護衛艦、Gerstner 海洋＋浪花＋航跡＋旋翼下洗、燃燒中的台北天際線、多鏡頭運鏡、景深、bloom、調色、膠片顆粒、黑邊與字幕。素材授權見 CREDITS.md。

v10

• 手機直式支援：單一虛擬搖桿（推越遠越快，推到底奔跑），手機自動降畫質（像素比上限、陰影降級），禁止縮放／捲動／長按選取。
• 解放軍制式輕兵器掉落：QBZ-191、QBZ-95-1、QBU-191、QBU-88、QSZ-92、QJY-88、QCW-05、QBS-09＋彈匣／彈鏈／手榴彈／頭盔／防彈背心，依兵種加權掉落；5.8×42、5.8×21、9×19、12 號口徑不互通。

v11

• 解放軍裝甲車只在大馬路巡邏（ZBD-05、ZTD-05、ZBL-08、東風猛士）：車載機槍會射擊視線內的玩家、發現你會呼叫步兵搜索、引擎聲會預警；輕兵器打不穿，只能躲進騎樓或巷子。armor.hit(x,z,dmg,antiArmor) 為之後 FPV 無人機／反裝甲武器預留。路上另有燒毀的殘骸。

v12 — FPV 自殺無人機與解放軍偵察無人機

• 零件（無刷馬達×4、4S 鋰電池、類比圖傳、碳纖機架）散落民宅／警局；使用機架＋手榴彈組裝。成品 FPV 也會出現在空投與士兵（特戰更常見）遺留裝備中。一次性。
• 駕駛視角：類比圖傳雜訊／色偏／雪花、OSD（RSSI 訊號格、LQ、電壓／電量、高度、速度、油門、計時）。電池約 2.5 分鐘。
• 操控：桌機滑鼠俯仰／滾轉、W/S 油門、A/D 偏航、Esc 放棄（指標鎖定）；手機雙搖桿（左＝油門／偏航、右＝俯仰／滾轉）。有慣性、重力、陣風（下雨更強）。
• 訊號隨距離與建築遮擋衰減，解放軍檢查哨的干擾站附近壓制訊號，可能斷訊墜毀。
• 撞擊即引爆；從上方俯衝命中裝甲車頂可擊毀（主要反裝甲手段），側面撞擊傷害較低。
• 解放軍偵察無人機盤旋並有嗡嗡聲；在空曠處被盯上約 2.5 秒會招來砲擊與巡邏隊，躲進騎樓或室內可避免。

v13 — 國軍、戰車支援與「奪回萬華」結局

• 國軍武器（5.56×45mm NATO，與解放軍 5.8×42mm 不通用）：T91、T65K2、T75 班用機槍、T93 狙擊槍（7.62×51mm）、T75 手槍（9mm）；反裝甲：紅隼（可裝填）、AT4（一次性）、標槍（稀有，頂部攻擊）。
• 觸發一：奪回第 2 個街區後，「自由之聲」通報國軍特戰在附近；據點出現國軍補給箱，空投開始帶國軍武器，附近有受傷聯絡官的背包（損壞無線電）。
• 觸發二：用鋰電池＋圖傳零件修好無線電，呼叫 CM-32 雲豹／CM-11 勇虎／M1A2T 沿最近的主要道路推進，摧毀佔領軍裝甲、據點與士兵；冷卻 4 分鐘，通話聲會引來巡邏。載具由 AI 控制，玩家不能駕駛。
• 觸發三：奪回 7/9 街區後全面反攻，國軍戰車縱隊開進西園路；奪回全部街區即進入新結局「奪回萬華」（運鏡過場＋結局卡），與兩種福特號撤離結局並存。

v14 — 更精密的 FPV 飛行模型與類比圖傳

• 飛行：240 Hz 固定步長；四顆馬達各自推力（∝ 轉速²）與反扭力、馬達加減速延遲、Betaflight 風格 RC rate／super rate／expo、角速度 PI 控制＋air mode 混控、30° 鏡頭上仰（ACRO 模式，需要壓頭才會前進）。
• 機體座標二次方阻力、陣風、地面效應（低空推力增加）、下降穿過自己的槳洗會抖動失穩（PROPWASH）。
• 4S 鋰電：開路電壓隨電量下降、內阻壓降（大油門瞬間電壓下沉）、電流與 mAh 統計、低電壓斷電。
• 碰撞：高速（>4.5 m/s）撞擊引爆；低速擦撞會反彈翻滾，連撞 3 次或翻肚 2.5 秒結束飛行。
• 圖傳：5.8 GHz 路徑損耗＋建築遮擋＋干擾站→RSSI；雜訊隨 RSSI 增加，多重路徑鬼影、破碎橫條、同步遺失捲動、弱訊號黑白、掃描線與暈影；DVR 錄影標記；Betaflight 風格 OSD（電壓、電流、mAh、RSSI dBm、LQ、人工水平儀、速度、高度、回家箭頭與距離、警告）。

v14b — 不規則頂樓加蓋與屋頂材質

• 頂加改為逐棟、逐「產權單位」隨機：長條建物依長邊切成 4–7 m（偶爾合併成兩戶寬）的戶，每戶各自決定：整片鐵皮棚（雙斜／圓弧，部分只有柱子不封牆）、靠前或靠後女兒牆的半屋頂鐵皮屋、兩層疊加、樓梯間＋單斜披屋、或空地放水塔／盆栽／曬衣架；高度、顏色、新舊、偶爾歪斜角度各不同，同一排不會重複。
• 屋頂地坪材質每棟不同：褪色斑駁的綠色／灰色防水漆、裸露水泥、瀝青補丁、紅磚面，加上水漬、青苔、排水孔黑色流痕、裂縫；女兒牆加壓頂與鏽水痕；太陽能熱水器、老式藍／白塑膠水塔、冷氣室外機、橫越屋頂的水管、雜物堆、保麗龍箱種菜、天線。每棟屋頂合併成少量 draw call。

v15 — 頂樓加蓋改為規律排列

• 依台北空拍照修正：鐵皮加蓋幾乎蓋滿整個屋頂（離女兒牆略退縮），與建物輪廓和女兒牆對齊，同一棟／同一排使用同一種屋頂形式與浪板方向、規律的窗戶節奏；連棟各戶之間只有些微高度、顏色、新舊差異，偶爾留一戶空地放水塔與曬衣架。移除隨機歪斜、疊加與拼貼感。保留 v14 的屋頂地坪材質、女兒牆、水塔與太陽能熱水器。

v15 — 生存者地圖（Project Zomboid 風格）

• 桌機按 M（Esc 關閉），手機點右側 🗺 按鈕。拖曳平移、滾輪／雙指縮放。
• 底圖完全由遊戲內的 OpenStreetMap 資料繪製（建物、道路、街名、公園、淡水河），依用途上色：住宅、商業／市場、寺廟、公園、醫療、工業；© OpenStreetMap contributors（ODbL）。不含門牌或任何私人資料。
• 戰爭迷霧：只有走過的地方會顯示，進度存在瀏覽器。
• 點地圖可加註記：補給、危險、撤離、安全屋；情報標記無法刪除：鄰里回報的危險點、修好國軍無線電後取得的解放軍哨點與撤離點、搜到「萬華街區地圖（手繪）」後揭露一整個街區。
• 街區以顏色區分「已奪回」（綠）與「佔領中」（紅）。

v16 — 網頁載入優化／PWA

• 載入畫面加進度條（下載程式 → 地圖資料 → 建造街區 → 出生點細節 → 目前街區頂樓）。
• 頂樓加蓋與屋頂雜物改為「串流」：開場只生成出生點 160 m 內的屋頂，其餘依玩家距離在每幀 3 ms 預算內逐步補上（結果固定種子，跟以前一樣）。
• 拆包：three.js 獨立成長期快取的 chunk；FPV 無人機、生存者地圖、過場動畫都改為延遲載入。
• 手機（觸控裝置）改用半解析度的程序貼圖。
• PWA：manifest＋圖示可「加入主畫面」；service worker 預先快取核心檔案，第一次載入後可離線遊玩；每次部署依檔案雜湊產生新的快取版本並清掉舊快取。

v17 — 五種職業與早晨序章

• 開局先選性別，再從 5 種職業選一位倖存者（皆為虛構人物）：

  職業	男／女	起點	特長
  上班族	志偉／雅婷	自家	背包正常
  學生	冠宇／欣妤	自家	體力恢復快（睡覺時「精神」恢復 1.5 倍）、書包稍大（背得比較重才會變慢）
  外送員	阿明／佳琪	門口就是自己的外送機車（有鑰匙）	熟悉街道（地圖全開）、騎機車更快、背包小
  護理師	柏翰／小雯	醫院宿舍	醫療用品效果加倍
  水電師傅	阿財／淑芬	自家	修無線電只需 1 顆鋰電池、可接線發動沒鑰匙的車、修車更快、開局帶工具

• 每個職業有自己的開局背包與白面人職業服裝（外送員安全帽、水電師傅工作帽會蓋住頭髮），選角畫面是即時算圖的 3D 立繪。

• 早晨序章（可勾選「跳過開場」）：07:20 鬧鐘響 → 跟著黃色光柱去上班／上學，手機推播新聞 → 半路響起飛彈空襲警報、防空廣播與爆炸 → 解放軍封鎖路口，正式開始求生。

• v17.2：角色改為光滑亮面的白色人台風格——蛋形無臉光頭、明顯的頸部、手肘與手指、較細的腰；衣物加上翻領、袖口、腰帶扣、口袋、縫線、手肘膝蓋皺褶、褲腳堆疊與鞋底；src/fabric.ts 以程序化法線／粗糙度貼圖做出棉布、丹寧斜紋、格紋、皮革與軍規織帶（所有角色共用材質）；遠處角色（> 22 m）隱藏細節網格（LOD）。角色檢視頁：scripts/checks/lineup/（npx vite 後執行 scripts/checks/v172chars.mjs）。

v18 — 可駕駛載具

• 機車（迅風 125、老狼 150、外送版）、電動機車、微笑單車（鎖在停車柱上，要用鐵鎚或鐵管撬開，聲音很大）、菜籃車、小貨卡、計程車、轎車、麵包車；公車與垃圾車太大開不動，只能當掩體。車款、塗裝與車牌皆為虛構。
• 靠近載具按 E 上車／下車，WASD（手機用搖桿）駕駛。要有鑰匙才能發動，水電師傅可以接線發動。
• 油量、輪胎、電瓶、引擎各自耗損：用塑膠管從別台車抽油、倒汽油桶加油、補胎片補胎、換汽車電瓶、用鐵鎚或鐵管修引擎。電動車停電後就沒地方充電。
• 引擎聲會引來巡邏；高速撞開路障會損傷引擎。

v19 — 道路細節串流與戰損

• 道路細節來自離線預處理的 200 m OSM 圖塊（scripts/tiles.mjs → public/data/tiles/），只載入玩家周圍 3×3 塊，走遠就卸載。每塊內容由固定種子產生；玩家造成的變化（搜刮過的廢車、撞開的路障）另外存檔。
• 車道線、中線、斑馬線、停止線、機車待轉格、紅綠燈（斷電後全暗）、反光鏡、水溝蓋、路面磨損、積水、紅線與綠色標線。
• 戰損：彈坑、拒馬、棄置與燒毀的車輛、燒毀的公車；廢車可以按 E 翻找物資。
• 序章裡的車流會遵守紅綠燈，空襲後陷入恐慌與塞車，最後車輛被棄置在原地，之後可以搜刮或開走。
• v19.1：修正標線重疊——重複的路段只畫一次、雙向分隔道路只畫外側邊線與中央分隔線、人行道不再產生路口、每個路口方向只有一條斑馬線、標線在路口前截斷。
• v19.2：依《道路交通標誌標線號誌設置規則》重做標線——白色車道線（4 m 實線／6 m 間隔）、雙黃／單黃分向線、路緣紅黃禁停漆、停止線、枕木紋與斑馬紋行人穿越道、機車待轉區與停等區、網狀線、槽化線、公車專用道、機車優先道、指向箭頭與「慢」「停」「禁行機車」字樣（字體 2:1 拉長，由遠而近讀）；移除舊的全域中心線與立面路緣線（左上角雜線的來源）。字樣圖集在 src/roadglyphs.ts。
• v19.3：騎樓改為建在建築輪廓內——柱子位於臨路側邊緣、二樓以上樓層正下方，一樓店面退縮 3.6 m，上方連續天花板與燈具，柱距依店面寬度約 4.5 m，磁磚柱、鐵捲門、招牌貼在騎樓上方立面；只在臨路的邊建騎樓，柱子不會進入車道，移除所有建築外的獨立柱。比例：一樓 3.8 m、其餘樓層 3.2 m，門高 2.4 m。程式在 src/arcade.ts；scripts/checks/v193shot.mjs 會拍街景並檢查建築外柱子數必須為 0。

v21.4 — 台北行道樹／公園樹、掩體射擊

• 新模組 src/trees.ts：低多邊形但辨識度高的台北樹種（台灣欒樹含黃花／紅蒴果季節色、樟樹、榕樹含氣根、茄苳、黑板樹、小葉欖仁、大王椰子、過度修剪的行道樹），加灌木、公園長椅、園燈、樹穴鐵格柵；每種一個 InstancedMesh，部分行道樹傾斜。
• 行道樹進樹穴並配格柵；公園（核心與外圍 OSM 公園）改為較密的混合樹種＋灌木、長椅、路燈。樹幹會擋人也擋子彈。
• 人行道高度查詢 walkH：玩家與佔領軍站在 15 cm 人行道上（不再陷入）；路口端點緣石降低為斜坡；鋪面貼圖在手機上走 texq 半解析度。
• 掩體射擊：牆段帶高度（車 1.45 m、沙包／紐澤西護欄／矮籬 1 m、牆全擋）。子彈以射線檢查，射手自身 1 m 內的掩體不算；G 鍵／手機 🛡 按鈕進入掩體（矮掩體蹲低、開火時探身；高掩體側身），畫面顯示掩體狀態，命中率減半。佔領軍會找最近的掩體、蹲下／探身開火，射擊先過射線再擲命中骰。煙霧測試加入掩體檢查。
• scripts/checks/v214trees.mjs：公園樹、行道樹、掩體射擊截圖。

v21.3 — 台北風鋪面：人行道、緣石、騎樓地磚

• 新模組 src/paving.ts：共用 canvas 貼圖（灰／土色 10×20 cm 人字鋪連 30×30 收邊、花崗岩緣石、黃色導盲磚、騎樓五款磁磚、老舊水泥地含磁磚／磚塊補丁、人孔蓋、樹穴）與世界座標 UV。
• 道路細節分塊（roads.ts）內，主要道路與街道兩側加 18 cm 花崗岩緣石與高 15 cm 人行道，遇建築線截止；路口端點鋪導盲磚，隨機人孔蓋，主要道路加樹穴與行道樹。鋪面用獨立亂數，不影響原有標線。路面與標線不變。
• 騎樓地板改為逐戶隨機磁磚款式；核心與外圍地面改為鋪面水泥，不再有裸地。
• scripts/checks/v213paving.mjs：人行道定點截圖（可帶入座標做前後對比）。

v21.2 — 出生點卡住修正、遮擋剖視

• 出生點：起床位置原本固定在床的 +x 0.9 m，床靠東牆的角色會卡進牆裡（除外送員外 16/20 種組合需要救援）。改為在床四周挑選屋內、可走、且能連到門與街道的一側；另加 escapeCheck（0.25 m 網格 BFS，依玩家半徑 0.35 m 與牆體判斷）與 unstuck 後備（就近移到可通往街道的點）。
• smoke 新增：5 角色 × 男女 × 序章／略過 共 20 種出生，皆須走得到街道且不需救援；scripts/checks/v212spawn.mjs 可單獨執行。
• 遮擋：鏡頭完全不變。所有材質在 shader 內剔除「玩家胸口→鏡頭」圓柱（半徑 3 m，邊緣點陣淡出）內的片段，涵蓋牆、屋頂、頂樓加蓋、鐵窗、雨遮、騎樓天花、招牌、樹，以及串流街區的網格，無需逐一註冊；地面（y < 0.35 m）保留。scripts/checks/v212occlusion.mjs 在高樓後方與外圍街區拍攝開／關對照。

v21.1 — 頂樓加蓋依建物類型

• roofClass()（src/rooftin.ts）依樓層、面積、地塊形狀分類：連棟透天（≤5F、深 6–22 m、≤450 m²）逐戶切分 4–6 m 地塊，每戶加蓋覆蓋 60–90 %，沿同一側女兒牆整齊排列，約 20 % 戶留空；4–5F 公寓僅一端局部加蓋（約 40 % 無）；6F 以上或 >600 m² 大樓多無，僅偶有退縮的小樓梯間／水箱室（≤18 % 屋頂）；學校、廟宇、市場、地標等非住宅不加蓋。
• 外圍街區屋頂改用多樣屋面材質（防水漆、水泥、柏油補丁），並加女兒牆與水塔、雜物，不再是整片灰色。
• 檢查 v21district.mjs 輸出各類覆蓋率：row 94 % 有加蓋／覆蓋 40 % 屋頂面積、walkup 50 %／9 %、big 36 %／1 %、none 0 %。

v21 — 萬華全區（串流街區）

• 地圖擴展至整個萬華區（OSM，ODbL ©OpenStreetMap contributors）：224 個 200 m 街區 tile，2787 棟 OSM 建物＋3617 棟依道路臨街生成的補齊公寓；scripts/district.mjs 產生 public/data/district/。
• 依玩家位置串流載入／卸載（LOAD 520 m、細節 300 m、卸載 680 m），每 tile 以固定種子生成；全程走查最多同時 19 tiles，單 tile 建置 ≤ 83 ms。
• 每 tile 內容額度：補給箱 ≤3、巡邏 ≤2、各區駐軍哨點（5 名＋檢查哨）；玩家變更（擊倒、拾取）按 tile 存於 localStorage dt.tiles，資料以 tile key 為單位便於多人同步。
• 15 個萬華地名分區（西門町、龍山寺、華江、南機場、青年公園、加蚋仔、馬場町…）；外圍區清除駐軍即奪回。M 地圖改為全區（含行政界、淡水河、公園），新增「全區」按鈕。
• 地標：龍山寺、西門紅樓、剝皮寮。
• 照片風格公寓：鐵窗（藍綠浪板頂、鏽底）、紅／藍綠雨遮、髒污水泥、盆栽、曬衣、褪色招牌、彎桿路燈、機車與計程車／小貨車；核心區公寓也加上鐵窗。
• 大小：index JS 約 311 kB（gzip 130 kB）、three.js 572 kB；首次載入資料 = district/index.json 49 kB＋wanhua.json 132 kB，map.json 410 kB 於開地圖時才載入，tile 檔合計約 2.1 MB 按需載入。
• 檢查：node scripts/checks/v21district.mjs <url> <out>。

v20 — 多人連線（實驗性，尚未部署）

• 2–4 人合作：選角畫面的「🌐 多人連線」可以建立房間（5 碼代碼）或輸入代碼加入，也可以用網址 ?room=代碼&mp=伺服器網址 直接加入。
• 伺服器是 Cloudflare Worker＋每個房間一個 Durable Object，和瀏覽器共用同一份確定性模擬核心 src/sim/core.ts（20 Hz）。伺服器會檢查移動速度、攻擊距離與冷卻，搜刮先搶先贏，斷線後可以重連。
• 目前只能在本機執行（見 server/README.md）。線上版還沒有架設伺服器，所以 GitHub Pages 上的多人功能暫時無法使用。

v21.5 — 萬華老公寓、可進入的一樓店面與住家

• 新 src/walkup.ts：後巷懸臂式折返樓梯（暗紅扶手）、鐵窗／陽台鐵籠（鏽色、綠色）、分離式冷氣、藍綠／紅色鐵皮雨遮與加蓋、剝落見紅磚的灰色粉刷、直式招牌（虛構店名）。
• 街區磚塊裡的部分一樓開門可進入：住家有神明廳、床、冰箱、電視櫃、塑膠椅；店面有櫃台、貨架、店內神桌與機車。每個房間都有可搜刮的容器（id t<tile>:100+，按區塊存檔），由區塊的確定性亂數產生，多人模式下大家看到的一樣。
• 看得見的沙包掩體模型（sandbags()，低矮掩體，高 1 公尺）；龍山寺廟埕有榕樹和長椅。
• 檢查腳本：scripts/checks/v215walkup.mjs。

v21.5.1 — 手機直式版面

• 直式手機：右側三顆大拇指按鈕「搜」（搜刮／互動）、「打」（按住對最近目標連射）、「撤」（找掩體，沒有掩體就遠離敵人衝刺），按下時震動；搖桿不變；有考慮安全區域。
• 選角畫面：日長與性別各縮成一行，角色排成兩欄，底部固定一條「開始遊戲」列（直式時點角色只是選取）；進入遊戲前不顯示任何遊戲內按鈕。
• ☰ 選單（暫停／地圖／存檔），直式也能打開。暫停只影響自己這台。
• 檢查腳本：scripts/checks/v2151portrait.mjs，在 390x844 和 412x915 執行。

v21.6 — 北都地下鐵（虛構捷運）

• 新 src/metro.ts：虛構的「北都地下鐵 BEIDU METRO」，有自己的標誌（白底、橘色圓環、綠色「北」字），用橘色和深綠色。萬華區內有四站：龍山寺、西門、萬大、華江。
• 每站在地面有一座綠框玻璃頂的出入口和站名招牌。走進出入口按 E 下樓，會到地下站體：大廳有售票機、服務台、閘門（停電中，只有外側通道能過），兩座樓梯通往月台；月台有黃線、立柱、玻璃月台門，停著一列列車，其中一組車門卡在開著，可以走進車廂。
• 只有站內空間，沒有搭車也沒有轉乘，拿來躲藏和搜刮（每站 5 個容器，id m<站>:<n>，跟著存檔）。生成是確定性的，多人模式下大家一樣。靠鏡頭那一側的牆壁做成矮牆剖面，所以不用改鏡頭。
• 檢查腳本：scripts/checks/v216metro.mjs（每站都測下樓再上樓）。

v22 — 戰火中的萬華：生存層

• 日夜：06–18 點白天巡邏多，適合留在家整理；18–06 點夜裡出去搜刮，摸黑翻找有機會多找到東西。
• 避難所（出生點；按 E 或 H，手機在 ☰ 選單）：可以封窗、鋪床墊、裝瓦斯爐、頂樓集雨桶、陽台菜圃，材料都從搜刮來；有共用存糧，也能在神明廳拜拜（每天一次，提振心情，廟公在的話效果更好）。
• 倖存者：阿嬤（煮飯）、廟公（安定人心）、印尼移工阿迪（修東西）、鄰居小美（找東西），各有飽足、生病、受傷、心情數值。每天早上 06:00 結算：吃飯、喝水、生病或痊癒、心情變化、夜裡被偷、有新人來敲門。
• 道德選擇：有些住家還住著獨居阿公，你可以拿走他的東西（良心 −、大家心情 −）、留一包米給他（良心 +），或把門帶上離開。
• 以物易物：在龍山寺廟埕和東園街市場，用長樂菸當貨幣，交易電池、罐頭、米、藥、木板、廢五金等。物資越來越缺，食物和藥品就越貴。
• 每天會有一件台灣日常事件：停電、停水、防空警報、颱風、鄰長發物資、疏散廣播，或是平靜的一天。用天數當亂數種子，同一房間的玩家會遇到同一件事。
• 「奪回萬華」結局會依照良心、還活著和已過世的街坊、大家的心情，寫出不同的段落。
• 新物品：長樂菸、3 號電池、廢五金、舊棉被布、地瓜葉扦插苗、地瓜葉。
• 檢查腳本：scripts/checks/v22survival.mjs。

v22.1 — 北都地下鐵站體細修

• 參考一般地下島式月台站的格局和感覺，所有內容都是自己做的：用自己的橘色和深綠色、自己的路線名（艋舺橘線）、自己的站號樣式（橘3、橘4…），圖示也是自己畫的。沒有任何既有捷運系統的名稱、標誌、配色、編號、字型、票卡或廣告。
• 每站有兩個地面出口，各有雨遮、樓梯、停住的手扶梯和電梯，出口外丟著幾台機車。
• B1 大廳：用閘門和玻璃圍欄分成付費區和非付費區，有售票機、加值機、服務台、廁所標示、置物櫃、虛構的「巷口便利站」、長椅、吊掛的指標牌、出口位置圖、虛構的宣導海報、磨石子地板、磁磚牆、天花板飾帶上的嵌燈（停電沒亮）和綠色緊急出口燈。
• B2 島式月台：兩側都是全高月台門，有黃色警示邊條、排隊箭頭和停止線、列車資訊看板（顯示全線停駛）、博愛座、掛著站名板的柱子、滅火器箱、監視器。北側是空軌道，南側停著一列沒有車頂的列車，從上方看得清楚。
• 戰時狀態：停電，只剩會閃爍的緊急照明；手扶梯停止；大廳裡有避難民眾的紙箱和棉被、丟下的包包、雜物。
• 站內在第一次有人下去時才產生（串流載入），同材質的幾何合併在一起，亂數照每站固定的種子產生，多人模式下大家一樣。鏡頭不變，靠鏡頭那一側的牆一樣做成矮牆剖面。
• 檢查腳本：scripts/checks/v221metro.mjs（每站的每個出口都測下樓再上樓）。

v22.2 — 北都地下鐵：閘門、軌道、第一天的列車、隧道口

• 閘門：不鏽鋼閘機本體、橘色頂蓋、自己設計的感應區圖示、兩端 LED（綠色箭頭／紅色 ✕）、橘色翼閘門板，最西側是加寬的無障礙通道。有電時人走近翼閘才打開；停電後 LED 全暗，中間六道卡死關閉。
• 軌道：混凝土道床、雙塊式軌枕、兩條鋼軌、外側有護蓋的第三軌和絕緣座、中央排水溝、道床邊的軌道燈。兩條軌道都一路延伸進隧道。
• 第一天列車真的會跑（停電前）：用共用的遊戲時間排固定班表，每 12 遊戲分鐘一班，每站錯開 3 分鐘，多人模式下大家看到的一樣。列車會減速進站，月台門和車門一起開關並響起提示音，停靠後駛入東側隧道。月台看板會顯示「往 X站 N 分／列車進站／請上車／車門關閉」。
• 搭車：列車停靠、車門打開時站在南側月台門前按 E，選擇另外三站其中一站，畫面淡出成車廂內景，約 3 秒後抵達目的站的月台。
• 停電後全線停駛：列車停在站內，中間那組門卡在打開的位置，看板顯示全線停駛。
• 隧道口：月台兩端有拱形門楣，上面有橘綠色環帶，配上隧道環肋、號誌燈和暗色的隧道壁，超過 ±52 m 的隧道有頂蓋，可以把行進中的列車藏起來。停電後月台端的維修閘門打開，可以沿著南側軌道走進一小段隧道，盡頭是關上的黃色防水閘門（有警示斑馬紋）。有電時防水閘門降入道床讓列車通過，維修閘門則關閉。所有碰撞牆都有看得見的阻擋物，不再有空氣牆。
• 檢查腳本：scripts/checks/v222metro.mjs。

v23.1.1 — 自訂網域 game.lijiabao.uk＋SEO

• 遊戲改放在 https://game.lijiabao.uk/（GitHub Pages 自訂網域，強制 HTTPS）；Vite base 改為 /，舊的 github.io 網址自動轉址。
• 新增 zh-TW 頁面說明、canonical、Open Graph／Twitter 分享卡（public/og.jpg 1200×630）、robots.txt、sitemap.xml。
• 檢查腳本預設網址改為 http://localhost:4173/；多人伺服器 ALLOWED_ORIGINS 加入新網域（伺服器尚未部署）。

v23.1 — 收音機：可點開的廣播卡、收音機紀錄、合成語音、萬安警報

• 廣播卡（直式在狀態欄下方、橫式／桌機在右上）可點一下展開全文、再點一下收起；點卡片不會觸發搖桿或攻擊。
• ☰ 選單新增「收音機紀錄」：列出所有收過的廣播與遊戲內 日／時間，可捲動，隨存檔保存。
• 虛構電台：「北廣 AM765（北都廣播電台）」取代真實電台名；另把真實品牌字樣改為通用名稱（電力公司簡訊、里長通訊群組、家族群組）。
• 廣播語音：用瀏覽器內建的 Web Speech API（優先 zh-TW 語音）朗讀，同時以 WebAudio 合成收音機底噪（雜訊、劈啪聲、調台嘯音、訊號忽強忽弱）；一次只播一則、排隊播放；佔領方廣播較慢較低沉、自由之聲較急促。設定新增「廣播」音量與「廣播語音」開關；手機在第一次觸控時解鎖。
• 防空警報：WebAudio 合成萬安演習式警報——緊急警報 1 長音 15 秒＋2 短音 5 秒、間隔 5 秒、連續 3 次（共 115 秒）；解除警報為 1 長音（遊戲中縮短為 30 秒）。多支街頭喇叭各有延遲、音高微差與合成殘響，在室內會變悶、變小。開場空襲時播放。
• 檢查：scripts/checks/v231radio.mjs。授權見 CREDITS.md（無任何錄音或預錄語音）。

v23.0.1 — 手機直式 HUD 修正

• 「📻 收音機」卡片改到左上狀態欄（生命／飽足／水分／精神）正下方，寬度與狀態欄相同，內文自動換行、最多 3 行，淡入淡出；不再壓到右下的 蹲 按鈕與武器欄。
• 直式時隱藏左下重複的收音機紀錄行；訊息紀錄縮窄並限制 4 行，不再壓到搖桿、蹲／打 按鈕與武器欄。
• 「跳過開場」按鈕移到左下角，不再擋在 打 按鈕下方。
• 橫式／桌機不變。檢查：scripts/checks/v2301hud.mjs（360×780、390×844、412×915）。

v23.0 — 樓內不再空曠：有人住過、匆忙逃離的室內

• 新增 src/clutter.ts：所有沒有手工佈置的可進入建築（約 480 棟）依建築 id 決定性產生室內配置，每位玩家看到的家具與掩體完全相同。
• 一樓依用途佈置：臨路店面隨機為 小吃店（料理檯、瓦斯爐架、摺疊桌與塑膠椅凳、冷藏櫃）、機車行（機車、輪胎堆、工具台、零件架、油漬）、雜貨店（貨架、櫃台、紙箱），店面門口有半拉下的鐵捲門；住家有 神明桌（紅桌、神龕、紅燈、供品）、藤椅、沙發、餐桌與碗盤、虛構的電鍋（無商標）、塑膠衣櫥、上下鋪、門口曬衣架與盆栽。大型建築逐格填滿多個單位。
• 匆忙逃離的痕跡：翻倒的椅子、散落衣物與傳單、碎玻璃、拉開的抽屜、攤開的行李箱、燒過的蠟燭（發光）、牆上彈孔與傳單。
• 多層樓建築加樓梯間：階梯、鞋櫃與亂踢的鞋、信箱牆、腳踏車、紙箱。
• 家具即掩體（矮家具為低掩體，衣櫥/冰箱/貨架為高掩體，加入碰撞與尋路）；冰箱、衣櫥、抽屜櫃、貨架、工具台可搜索（f<建築>_<n> 容器，戰利品以建築種子決定，存檔可還原）。
• 效能：配置在載入時計算，網格只在玩家 28 m 內才建立（每 0.3 s 最多 2 棟，每棟 2 個合併 draw call），40 m 外隱藏、70 m 外釋放。
• 檢查：scripts/checks/v230interiors.mjs。

v22.11 — 解放軍小隊戰術 AI

• 小隊與分工（src/squadai.ts，純函式、依士兵 id 排序 → 各端一致、無隨機）：交戰中 25 m 內的士兵自動編成小隊；第 1 人在掩體後壓制射擊（射速 ×1.67、命中 ×0.6），第 2、3 人左右翼包抄（側移至玩家側面 7 m，約 7 秒），其餘為步槍兵。包抄開始時有無線電喊話「左翼／右翼包抄！」＋無線電音效（可預判、公平）。
• 輪流探頭射擊：同掩體的士兵依小隊序號錯開 1.5 秒蹲／起。
• 負傷撤退：血量 < 35 時喊「我中彈了，掩護我！」，停火後撤約 5 秒再回到戰鬥。
• 無線電呼叫：士兵發現你時呼叫 45 m 內閒置巡邏隊前往（6 秒冷卻），無人機發現你也會呼叫；距離 40 m 內會聽到／看到通話。
• 協同搜索：失去目標後在最後位置分頭搜索，每人 3 個不同搜索點；若最後位置在建築內，搜索點落在該建築四個象限（房間）。
• 手榴彈逼出：你在士兵已知位置附近 5 m 內躲著不動、且無人看得到你超過 7 秒，5–22 m 內的士兵會丟手榴彈（25 秒冷卻）：喊「手榴彈！」、落地叮噹聲、紅色警示圈、1.6 秒引信後爆炸（核心 2.5 m 70 傷害、6 m 外無傷；不同建築 ×0.2、掩體 ×0.6）。
• 日夜：白天每個街區多一組巡邏（宵禁時停用）；夜間沿用手電筒，偵察無人機曝光 1.5 秒即發現（白天 2.5 秒）、冷卻 40 秒（白天 70 秒）。
• 檢查：scripts/checks/v2211ai.mjs。

v22.10 — 近戰／射擊動畫重做＋跑步腳穿模修正

• 菜刀／球棒／鐵管揮擊：蓄力（ease-out）→ 快速出刀 → 隨勢過頭 → 緩回；由髖部帶動腰、胸、手臂扭轉，前腳踏步＋重心前移。三種揮法輪替（斜劈、反手橫掃、過頂下劈），上半身動畫疊加在走／跑步態之上。
• 刀光拖影（src/trail.ts，單一 ribbon、固定緩衝）、程序合成揮刀聲與打擊聲（AU.swish / AU.meleeHit，無外部音源）。
• 打擊感：傷害改在揮擊接觸幀才判定；命中時 0.07 秒 hit-stop、敵人受擊後仰＋擊退 0.45 m（不穿牆），畫面只有極小震動偏移（鏡頭不變）。
• 槍械後座：快升慢回的後座曲線，手臂／胸／頭跟著頂，槍口上揚（手槍幅度較大）。
• 解放軍近身槍托：貼身 1.6 m 內改用槍托突刺，有明顯蓄力（約 0.27 秒）可閃避；命中 12–18 傷害＋擊退，被打斷則取消。
• 腳穿模修正：骨盆高度原本取「較彎那條腿」（擺動腳）→ 衝刺時支撐腳陷入地面最多約 0.7 m。改為依彈簧後實際腿角、取支撐腳計算並補鞋底厚度；步幅角度由實際步長推導（防滑步）；跑步時大腿微外展避免兩腿交錯。地面高度仍用 walkH 吸附。
• 檢查：scripts/checks/v2210anim.mjs（搭配 npx vite 開發伺服器的 scripts/anim/ 側視測試台），量測腳底最低點：走 −0.13→−0.001 m、跑 6.5 m/s −0.71→−0.009 m、8 m/s −0.70→−0.014 m。

v22.9.1 — 樓頂整修＋爆炸煙霧加濃

• 找出樓頂仍是素面方塊的原因：城區外圍（串流載入的 district 區塊）每塊只有前 40 棟有樓頂佈置，非住宅（學校、市場、商辦等）完全沒有；大面積樓頂的雜物只放在中心 ±6 m 內。
• 現在每棟都有女兒牆＋整套台北頂樓：樓梯間（鐵門、水漬、頂上小水塔）、防水層補丁、不鏽鋼臥式／立式水塔與藍色塑膠水塔（鋼架）、冷氣室外機排、小鐵皮倉庫、天線與小耳朵；數量隨面積增加並分布全頂。每棟以種子決定（各客戶端相同），每個區塊合併成兩個網格。
• 爆炸煙霧更濃更深色、範圍更大、停留更久；焦痕更大更黑。
• 前後對照：/workspace/v229/roofs/before|after（檢查：scripts/checks/v2291roofs.mjs）。

v22.9 — 砲擊範圍縮小＋真實爆炸特效

• 砲擊數值（舊 → 新）：傷害半徑 7 m 線性（中心 55）→ 致命核心 6 m（85→50）＋ 18 m 殺傷範圍平方衰減（9 m≈28、12 m≈13、15 m≈3）；落點散布 ±7 m 方框 → 半徑 4.5 m 圓；4 發、首發 6 s、間隔 1.3 s 不變。
• 落點預警圈：紅色實心＝致命核心、橘色外圈＝殺傷範圍，與實際判定半徑一致，越接近落地閃得越快；落地前 1.6 s 有呼嘯聲。
• 室內傷害 ×0.15，靠牆／騎樓等掩體 ×0.5；砲彈也會波及範圍內的佔領軍。
• 爆炸特效（全部預先配置的物件池，依畫質縮放）：瞬間閃光＋點光源、迅速轉黑的火球、塵土柱、受重力彈跳的碎塊、火花、地面衝擊波環與塵土裙、隨風飄散的灰褐煙、地面焦痕彈坑（120 秒淡出）。無人機、國軍砲火等所有爆炸共用。
• 輕微鏡頭震動：只在每幀算好鏡頭後加上一個快速衰減的位移，鏡頭設定（角度、距離、縮放）完全不變。
• 爆炸聲改用 CC0 錄音（見 CREDITS.md），含距離延遲、街道回音、室內悶音；載入失敗退回合成音。
• 檢查：scripts/checks/v229shells.mjs。

v22.8 — 真實槍聲錄音

• 玩家、佔領軍、狙擊手、裝甲機槍的槍聲改用真實錄音（CC0，The Free Firearm Sound Library，見 CREDITS.md）：手槍（Walther PPQ）、步槍（AR-15／AK-47 各型）、狙擊槍（Tikka .30-06，較低沉並加長街道回音）、機槍（7.62×54mmR）、霰彈槍（Benelli Nova），遠處（>70 m）改用中距離錄音；反裝甲仍為程序合成。
• 12 個單聲道 MP3（80 kbps，共約 134 KB），首次觸控／點擊後以共用音效 AudioContext 載入並解碼一次；載入失敗自動退回程序合成槍聲。
• 每發隨機音高（±6%）與音量變化；距離衰減＋低通；室內用合成殘響 Convolver，狙擊與遠處槍聲加街道回音。
• 槍聲專用壓縮器＋限幅器，比其他音效明顯更大聲但不破音；仍受「設定 → 音效」音量控制。
• 檢查：scripts/checks/v228guns.mjs（含封鎖音檔時的退回測試）。

v22.7.1 — 手機介面修正

• 標題畫面：版本標示統一為 src/version.ts（目前 v22.7.1）；載入完成前不顯示遊戲內按鈕（武器欄 ⇄ 等）；選單若 6 秒內沒有出現，或載入失敗，會出現「清除快取並重新載入」按鈕（解除 Service Worker、清掉 dt- 快取）。Service Worker 以 updateViaCache: 'none' 註冊，頁面導覽一律 no-store 取最新的 index.html。
• 手機不再擋掉選單／設定／面板內的觸控捲動與滑桿拖曳（原本整頁的 touchmove 都被搖桿鎖住）。
• 設定／操作說明：不透明背景、固定標題列「✕ 返回」、內容在視窗內捲動、點外面關閉、Android 返回鍵關閉（history state）；觸控裝置顯示「震動回饋」與「按鈕大小（小／標準／大）」，鍵盤按鍵與滑鼠靈敏度收進「外接鍵盤／滑鼠設定」。
• ☰ 暫停選單：全螢幕背景、右上 ✕、點外面繼續、返回鍵先關設定再關選單。
• 檢查：scripts/checks/v2271mobileui.mjs（360×780、390×844、412×915，Android Chrome UA＋觸控，含首次載入與重新整理）。

v22.7 — 手機直式按鍵精簡

• 直式手機只剩兩顆拇指按鈕（右下，避開置中的搖桿）：
  • 大的「情境鍵」：平常是「打」（按住連續攻擊最近目標）；靠近可互動的東西時變成「搜／開門／關門／爬上／下樓／上車／下車／捷運／避難／交易／交談」並變橘色，點一下互動、長按改成攻擊，按鈕上方有完整提示；裝備狙擊槍時變「瞄」（綠色）：按住開鏡、拖曳瞄準、放開射擊。
  • 「蹲」鍵：附近有掩體就貼牆進掩體，否則切換潛行；再點一下「起」身；長按＝撤退（快跑離開最近的敵人）；開鏡時變「✕」關閉狙擊鏡。
• 點畫面下方的武器欄（⇄）循環切換武器（含徒手）。
• 地圖 🗺 移到左上角 ☰ 旁；☰ 選單新增「背包」（另有地圖、避難所、存檔等）。原本的 🛡／🗺 圓鈕在直式隱藏。
• 橫式手機與桌面版不變；鏡頭不變。
• 檢查：scripts/checks/v227portrait.mjs（390×844、412×915、360×780）。

v22.6 — 程序合成音效

• 全部音效以 WebAudio 即時合成（無取樣、無版權素材），src/audio.ts；共用兩個 AudioContext：音效（設定→音效音量）與環境／雨聲／避難所（以 markMusic 歸入音樂／環境音量）；手機首次觸控即恢復播放。
• 槍聲：手槍／步槍／狙擊槍／機槍／霰彈／反裝甲，依距離衰減與低通，室內加短殘響、遠處加街道回音；玩家、佔領軍、狙擊手、裝甲機槍皆有。
• 腳步聲：玩家與士兵，依地面（磁磚騎樓、柏油、木地板、捷運金屬）變化；潛行無聲，士兵靴聲較重。
• 受傷／死亡：非人聲的悶響與倒地聲；搜刮容器時的翻找聲；門的開關聲改用共用音效通道。
• 環境：雨聲（室內較悶）、遠方爆炸、宣傳廣播車（無字語音式嗡鳴）、狗吠、機車經過；避難所內的生活聲（室內底噪、時鐘、杯碗）。
• 檢查：scripts/checks/v226audio.mjs。

v22.5 — 狙擊手與狙擊鏡

• 敵方狙擊手：固定（各端相同、可供多人連線）的頂樓狙擊點，位於主要路口（桂林路／西園路、康定路／桂林路、桂林路／環河南路，取最高的樓）；只在白天 06:00–18:30 活動。
• 進入狙擊區且暴露時：鏡面反光＋紅色雷射預警 1.6 秒才開槍；HUD 顯示「你被狙擊手鎖定」。躲進騎樓／室內、車輛旁或讓牆擋住視線即可脫離鎖定。
• 擊殺狙擊手即清除該區（地圖標記改為已清除，掉落補給箱：7.62 子彈＋繃帶）。
• 玩家狙擊：裝備 T93（交易／戰利品）或 QBU-88，按住右鍵開狙擊鏡（獨立的第一人稱視窗，一般鏡頭不變），左鍵射擊；子彈下墜（約 300 m/s）、爆頭即死、射擊聲極大會引來搜索。
• 爬頂樓：在狙擊點大樓門口按 [E] 爬上頂樓，可近戰制伏狙擊手；再按 [E] 下樓。
• 道德抉擇：第二天起，開鏡時可能看見一名解放軍士兵扶著受傷的阿嬤——開槍或放過，會影響聲望。
• 檢查：scripts/checks/v225snipers.mjs。

v22.4.1b

• 桌面版五張角色卡排成一列；移除 dbgAt 除錯函式；門的近照截圖 scripts/checks/v2241doorshots.mjs。
• 用詞：線人／線民改為「聯絡人」（假的為「假聯絡人」），地圖情報改為「鄰里回報的危險點」。

v22.4.1 — 家門醒目化、開門互動、選角卡對齊

• 所有門加上門框／門檻（家門紅框、店門橘框），門扇可用 [E] 開門／關門，有開關動畫與音效；3 公尺內地面光圈提示。
• 第一天在小地圖標示「家門口（出口）」並在門上方顯示指示錐，走出家門後移除。
• 關閉的門只擋玩家；自動走出測試 scripts/checks/v2241walkout.mjs 驗證 5 角色 × 2 性別 × 是否跳過開場共 20 組皆可從床邊走到街上（無推擠、無傳送）。
• 選角卡改為固定寬度網格、等高卡片，男女版面一致（scripts/checks/v2241sel.mjs）。

v22.4 — 開始選單、Esc 暫停選單、設定與按鍵設定

• 開始選單：標誌＋標題，繼續遊戲（有存檔時）、新遊戲、多人連線、設定、操作說明、製作名單／關於；新遊戲／多人連線才進入角色選擇（← 返回主選單）。桌機與直立手機皆可用。
• Esc（手機 ☰）：先關閉最上層的視窗（設定／商店／搭車／避難所／地圖／背包），沒有視窗時開啟暫停選單：繼續、存檔、讀檔、地圖、避難所、設定、操作說明、返回主選單（確認後自動存檔）。多人連線時只有自己的畫面暫停。
• 設定（localStorage dt.settings）：主音量／音效／環境音、畫質 低／中／高（材質解析度與像素比）、語言（預留）、滑鼠靈敏度（FPV 無人機）、手機震動開關。
• 按鍵設定（dt.keys）：所有按鍵可重新綁定，重複的鍵自動互換，可恢復預設。預設：WASD 移動、Shift 奔跑、C 潛行、G 掩體、E 互動、空白鍵 翻越、Q 推開、Tab／I 背包、M 地圖、H 避難所、B 封門、Z 睡覺、F 手電筒、1/2/3 時間、左鍵 攻擊、Esc 選單。提示文字會顯示目前綁定的按鍵。
• 虛構化：長壽菸改名為長樂菸（物品代號仍為 cig，舊存檔相容）。
• 檢查：scripts/checks/v224menu.mjs。

v22.3 — 北都地下鐵站內商店與自動販賣機

• 站內商店仿照一般捷運站的配置，品牌全部是虛構的：
  • 「巷口便利站」便利商店：玻璃店面、兩排貨架、冷藏櫃、櫃檯和收銀機、關東煮保溫櫃。
  • 「安心藥局」藥妝店。
  • 「橘子烘焙・咖啡」小亭：麵包櫃、咖啡機。
  • 「小巷花坊・手機配件」小亭。
  • 6 台自動販賣機：飲料、零食、雨傘／口罩，都有發光面板和一排排商品。
  • 投幣置物櫃。
• 第一天有電：店裡燈亮著，有店員（無臉、光頭）。可以用錢包（初始 NT$1200，存在存檔裡）買東西，販賣機會「喀噹」掉出商品。
• 停電後：
  • 鐵捲門拉下一半，貨架被搬空，東西掉了一地。
  • 販賣機和置物櫃都沒電了，可以撬開拿東西。有鐵鎚、鐵管、球棒或菜刀時用撬的，噪音半徑 24 m；沒工具就硬砸，噪音半徑 36 m。噪音會引來敵人。
  • 店裡的貨架這時才能搜刮。
  • 撬到的東西照每台機器的 id 固定產生，多人模式下大家一樣。新物品（折疊傘、口罩、行動電源、菠蘿麵包）可以拿來以物易物。
• 地下不再有陽光：有電時只有站內照明，停電後幾乎全黑，只剩閃爍的緊急照明。
• 檢查腳本：scripts/checks/v223retail.mjs。

v23.1.2 — 遊戲總站路徑 /defendtaipei/

• game.lijiabao.uk 改為多遊戲總站（lijiabao1998.github.io 使用者站台，持有 CNAME）；本遊戲移到 https://game.lijiabao.uk/defendtaipei/ 。
• 專案 repo 改名為 defendtaipei，移除本 repo 的自訂網域與 public/CNAME、robots.txt、sitemap.xml（改由總站提供）；Vite base 改為 /defendtaipei/，canonical／OG 網址與檢查腳本同步更新。

v23.1.3 — 多人連線（即將開放）

• 伺服器尚未上線：標題選單的「多人連線」改為暗色「多人連線（即將開放）」，點擊只顯示提示「多人連線即將開放，敬請期待」；角色選擇畫面的連線列也隱藏。
• 測試用：網址加 ?mpdebug=1（或 ?mp=／?room=）即恢復原本的多人連線流程。

v23.2.0 — 程式碼模組化（純結構重整）

• src/ 依功能分成資料夾：core/（遊戲主迴圈、事件匯流排、模擬核心）、map/、systems/、npc/、player/、story/（events/、broadcasts/）、audio/、ui/、net/、debug/。各資料夾負責人見 docs/MODULES.md。
• 新增 src/core/bus.ts：簡單的型別化事件匯流排（emit／on，同步執行）。序章空襲開始時改為發出 alert 事件，由警報器監聽後響起，時序與先前完全相同。
• 序章手機推播資料移到 src/story/broadcasts/prologue.ts；網址測試旗標（?mpdebug=1 等）移到 src/debug/flags.ts。
• 遊戲行為、畫面與鏡頭皆未改變。

v23.2.1 — 防空警報測試音

• alert 事件新增 kind: 'test'：播放短促、較小聲的三音提示（合成音效，不用音檔），不是完整的萬安警報；室內會變悶。
• emit('alert')（不帶參數）仍等於 'alert'；'clear' 仍是解除警報。
• 測試：window.__game.siren('test')。