retro-avg-taiwanese-localization

name

retro-avg-taiwanese-localization

description

老 AVG(冒險遊戲)繁中化的三個進階增量 —— (1)AGI(EGA)引擎 CHT(有別於既有 scummvm-sci-cht-localization 的純 SCI 方法);(2)遊戲內「標題 logo 疊繪」中文(不改原美術,引擎 render 期疊點陣圖,EGA 索引直寫 vs SCI nearest-palette-map);(3)「台式幽默在地化」管線 —— 把美式黃色冷笑話「重寫」成台灣人一看就笑,而非直譯(風格聖經+統一譯名表+批次 subagent fan-out+合併驗證+尺度校準)。外加 headless 破防拷擷取。素材:幻想空間(Leisure Suit Larry 1, AGI+SCI 雙版)。觸發:「Leisure Suit Larry / 幻想空間 / LSL1 中文化」「AGI 引擎繁中化 / Sierra AGI LOGIC 抽字 / avis durgan」「遊戲內中文標題 / 標題 logo 疊圖 / title overlay CJK」「台式在地化 / 台式笑話 / 黃色雙關在地化 / 成人喜劇漢化 / 讀者文摘梗」「批次 subagent 翻譯 fan-out / 譯名一致性 / 非 Big5 字 corrections」「headless 破年齡驗證 / 防拷問答 / debugger room 擷取」。repo: github.com/wicanr2/Leisure_Suit_Larry1-cht。

老 AVG 繁中化進階增量 —— AGI 引擎、遊戲內標題疊圖、台式幽默在地化

一句話定位

既有 scummvm-sci-cht-localization 講的是「SCI 引擎怎麼吐中文」。本篇是三個跨引擎、跨層次的增量,以《幻想空間》(Leisure Suit Larry 1,1987 AGI/EGA + 1991 SCI/VGA 雙版)為素材:

1. AGI 引擎 CHT —— Sierra 更早的引擎,踩雷跟 SCI 完全不同。
2. 遊戲內標題 logo 疊中文 —— 不改原始美術,引擎在標題畫面 render 期疊一塊中文點陣 logo。
3. 台式幽默在地化 —— 把笑話「重寫」成在地版,是再創作不是翻譯;用批次 subagent 規模化又保住一致性與尺度。

核心哲學延續 SCI 篇:不改遊戲資源,只 patch 引擎 + 執行期內容比對替換(英文原文當 key → 查表換 Big5)。

---

增量一:AGI(EGA)引擎 CHT —— 跟 SCI 不一樣的雷

AGI(Adventure Game Interpreter,LSL1 EGA 用 AGI 2.440)比 SCI 更老更簡單,但有幾個 SCI 沒有的坑:

[HARD] 語言 gating 會讓遊戲無法啟動 → 改「字型檔存在」當開關

• AGI 走 fallback 偵測。一旦把 target 語言設成任何非英文(tw/de 皆然),遊戲直接回啟動器、進不去。與「中文」無關,是 AGI detector 的行為。
• 解法:不靠 --language。中文啟用改成判斷「遊戲目錄有沒有 lsl_big5.fnt」——GfxMgr::loadChtResources() 開檔失敗就 _chtEnabled=false 維持英文。遊戲照英文正常啟動,中文照樣生效。
• 對比:SCI 是設 config language=tw(寫進 config,非 CLI)。兩引擎啟用機制不同,別混。

LOGIC 訊息抽字:連續 XOR "Avis Durgan"

• AGI 的對白在 LOGIC 資源裡,訊息段用 avis-durgan 金鑰連續 XOR 加密。抽字工具 extract_agi.py:對訊息區塊逐 byte XOR 循環金鑰 "Avis Durgan" 還原明文。1850 則 100% 乾淨。

拉畫布不縮字:forceHires 640×400

• EGA 原生 320×200,16×16 中文塞不下。_chtEnabled 時強制 ScummVM 內建 DISPLAY_UPSCALED_640x400 hi-res(initVideo 裡 if (_chtEnabled) forceHires=true),中文字有空間。與 rulebook 81「拉畫布非縮字」同源。
• 早期誤判「hires 把 EGA 背景畫黑」——真因是上面的語言 gating(遊戲根本沒啟動);改 file-based enable 後 hires 正常。除錯教訓:畫面全黑先確認遊戲有沒有真的跑起來,別急著怪 render。

繪字 API:drawBig5CharacterOnDisplay

• _displayScreen 是 8-bit 索引 buffer。畫中文 = 先填背景色、Big5Font::drawBig5Char 寫前景,再 copyDisplayRectToScreen(x,y,16,16) 推到螢幕。這支 API 是後面「標題疊圖」的基礎(同一套 blit 機制)。

---

增量二:遊戲內「標題 logo 疊中文」—— 不改原美術

目標:標題畫面的英文 logo 旁/上疊一塊中文「幻想空間」點陣 logo(並存,保留經典英文字),不動原始 PIC。

資產管線:設計 PNG → 索引 .ovl 疊圖

• 設計師產透明 PNG(中文 logo 字樣)。build_title_overlay.py 烘成 .ovl:header(origin/size)+ 像素(0xFF=透明,否則調色盤索引)。
• EGA:量化到標準 16 色 EGA 調色盤(索引 0-15),引擎直接寫 display buffer。標題常用的洋紅/亮紅/青正好都在 EGA-16 內。
• VGA:PIL 量化到 ≤16 色內嵌調色盤(存 RGB),引擎端 nearest-map 到當前遊戲 palette。

引擎疊繪 + gate(何時疊)

• AGI:hook PictureMgr::showPicture/showPictureWithTransition 尾端,drawChtTitleOverlay(picNr)。gate = 「第一張 show 的 pic 視為標題 pic」自動捕捉(_chtTitlePic==-1 時記下),只疊在該 pic。索引直寫 _displayScreen + copyRect。
• SCI:沒有現成「畫背景」的乾淨 hook 點,改piggyback 文字替換路徑——偵測到 Sturgeon 警告文字(strstr(text,"contains some elements of plot"))時,渲染完在 GfxText16::Box/DrawString 尾端呼叫 drawChtTitleOverlay()。內嵌調色盤 nearest-map 到 _gfxPalette16->_sysPalette,寫 _gfxScreen->putPixelOnDisplay 後 copyToScreen() 全螢幕 present。

[HARD] 陷阱:SCI display 是 320×200,不是 640×400

• 直覺以為 CHT 走 hi-res → display 640×400。錯。 SCI 的 _gfxScreen->getDisplayWidth() 回 320×200(游戲原生解析度;字型 upscale 是另一條路)。overlay 座標/尺寸要用 320×200,設計稿(640×400)得先 convert -resize 320x200 再烘,否則 guard 判越界直接不疊。
• 診斷法:在 draw 函式開頭 warning("disp=%dx%d") 一次就看穿(印出 320×200)。RE 疊圖前先印出目標 buffer 的實際尺寸,別靠假設。

通則

• 缺 .ovl 檔自動略過(不影響其他中文化),資產隨 game/ 目錄自帶進包;macOS CI 從版控 fonts/ 快照 staging。

---

增量三:台式幽默在地化 —— 把笑話「重寫」不是「翻譯」(本篇重點)

成人喜劇(LSL1)/任何靠在地哏的老遊戲,直譯會讓笑點涼掉:「Johnny Carson 的搭檔」「菸盒衛生署警語」台灣人讀得懂英文也不會笑。在地化 = 把 Al Lowe 想逗你笑的那個點,換成台灣人生活裡真的會笑的講法。

定位一句話(先跟使用者校準尺度再動手)

色在雙關、笑在自嘲、賤在旁白——露骨留白,台語提味,年代感點到為止。

兩個尺度務必先問使用者定案(用 AskUserQuestion):

• 台味濃度:中度提味(口語國語為主+情緒點插少量台語詞:歹勢/衝/款/衰/凍未條/乎/齁啦語尾)vs 濃重 vs 淡。
• 色色尺度:點到為止靠雙關(字面乾淨、諧音聯想、露骨留白=原作 double entendre)vs 更大膽 vs 收斂。

手法對照(梗庫)

先蒐一份風格聖經(讀者文摘中文版調性、台語激骨話/諺語、1980-90s 流行語、諧音雙關文化、原作官方笑話頁對齊目標調性)。分類手法:

• 死法旁白 = 報紙社會版標題腔/命理腔/綜藝誇張腔(「驚傳!中年男夜闖暗巷慘遭關切,當場領便當」)。
• 賴瑞台詞 = 自嘲魯蛇(「口袋比臉還乾淨」)。
• NPC 吐槽 = 一句冷回。
• 性暗示 = 諧音雙關(「小雨衣」保險套、「提早『領』出違約金」、em-bare-assing→丟「腚」、organ→生殖風琴)。
• [HARD] 分寸:涉真人/政治/族群諧音一律避開;原作年代性歧視玩笑改成「賴瑞自己很衰很糗」;族裔口音刻板笑話拿掉口音、改語言新手的通用誤用。

規模化管線(關鍵:批次 subagent + 一致性防漂移)

全量 3586 則(EGA 1160 + VGA 2426),流程:

1. prep(prep_localize_batches.py):從翻譯表抽「可在地化散文句」,跳過控制碼(%開頭)、防拷雙語問答(a./b./c. 或中文含 20+ 連續英文)、過短機械字串。切 ~130 則/批。
2. 試作一批先給使用者看品質、確認風格,再 fan-out 其餘(別一次燒 27 批 token 才發現風格歪)。
3. 共用指令檔 + 統一譯名表:寫一份 LOCALIZE_INSTRUCTIONS.md(風格尺度+硬規則+統一譯名表),每個 subagent 先 Read 同一份,降低獨立 subagent 的譯名/風格漂移。用 sonnet(品質)非 haiku。
4. 硬規則(給 subagent):第一欄英文原文一字不改(遊戲查表 key);\n/%s/%v 等控制序列位置數量保留;長度 ±30%;功能句別硬塞梗;繁中且 Big5 打得出來。
5. 合併驗證(merge_localized.py):逐行核對英文 key 一致 + 控制碼數量,只替換有在地化的行。→ 攔下任何被污染的批次(多個 subagent 曾因共用 scratchpad 暫存檔名撞車互相覆寫;有的自己 diff 抓到重建,合併驗證是最後防線)。
6. 譯名一致性掃描:即使發了統一譯名表,仍會漂移(Larry Laffer 姓氏出現 拉弗/拉佛/賴福 三種、Fawn 出現 佛恩/芬妮、Larry 出現 拉瑞)。合併後對中文欄做一次全域 replace 收斂(拉瑞→賴瑞、佛恩/芬妮→芳恩…)。
7. 非 Big5 字 corrections:在地化會引入 Big5 打不出的字(𨑨迌的𨑨、腚、啧、咔、銹、é、・)。掃描 → 補 corrections.tsv(啧→嘖 腚→股 咔→喀 銹→鏽 ・→· é→e),build_cht.py 烘字時套用。字型是從在地化譯文烘出來的 → 字元覆蓋由建構保證,唯一破口就是非 Big5 字,掃掉即可。
8. 重烘字型 + 部署 + 實機驗證:build_cht → 複製 game/ → headless 擷取確認在地化台詞渲染無缺字(見增量四)。

為何值得

翻譯只是「看得懂」,在地化是「會心一笑」。這是成人喜劇/靠哏老遊戲漢化的招牌賣點,也最花心思——README 要專章突顯(找遊戲文案 subagent 潤,附 before→after 對照)。

---

增量四:headless 破防拷擷取(截圖/驗證用)

老 AVG 開場常有年齡驗證/防拷問答,擋住 headless 自動擷取 gameplay。踩雷與解法:

• 年齡輸入卡住的真因:不是「數字鍵送不到」——是前面的警告對話框沒關掉。先 Return 關警告 → 「你多大了?」才吃得下數字(38 有 echo)。踩 7 次才發現,別急著怪 xfocus。
• Xvfb 無 window manager:xdotool windowactivate/windowfocus 都可能無效;直接 search --class scummvm 抓 WID 對它送鍵。
• AGI debugger room N 只改變數、不重繪畫面(teleport 沒用);SCI debugger room N 會正確重繪(可 teleport,但跳到不存在的 room = fatal 直接關遊戲,只跳已知存在的)。
• 防拷 trivia 沒有可靠 skip 碼(Ctrl+Alt+X DOS 有效、ScummVM 無效)→ 最穩是 detached 容器 + docker exec 互動逐題作答(答案查 allowe.com/攻略),過關後 ScummVM Ctrl+F5 存檔當 checkpoint,之後 --save-slot=N 直接載入 gameplay,免每次答隨機題。
• 要一張「確定含在地化台詞」的畫面:載存檔後 TYPE look + Return——parser 房間描述最可靠會跳在地化旁白(比「走進門觸發換場」穩,後者對時序/起步位置敏感,偶爾要重跑)。
• docker liveness:每個 docker run 包 timeout,腳本結尾 kill 遊戲 process,跑完 docker kill $(docker ps -q --filter ancestor=<img>) 清殘留(容易 hang)。見 rulebook 35。

---

增量五:AGI 非-LOGIC 文字全覆蓋 + F8 中英切換(「完整」在地化的最後一哩)

主體對白翻完≠完整在地化。玩家還會看到選單、道具欄、系統 UI、狀態列。這些不在 LOGIC 訊息裡,是最容易漏、也最破壞「完整感」的殘留英文。

AGI 文字有三個來源,少抽一個就露英文

1. LOGIC 訊息(extract_agi.py,avis-durgan XOR)——對白主體。
2. OBJECT 道具名(20 項:Wallet/Rose/Prophylactic…)——OBJECT 檔也是 Avis Durgan XOR 加密(同 WORDS.TOK)。解密後抽 null 結尾字串。顯示走 InventoryMgr → _text->displayText(name) → 會呼叫 getChtTranslation,所以加進 translation 表就會翻,不必改引擎。
3. SystemUI 引擎硬寫字串——道具欄標題「You are carrying:」、暫停、存讀檔提示、狀態列 Score/Sound。這些在 systemui.cpp 建構子裡按語言 switch 寫死(有 RU/HE/FR 分支),不走 content-key,得自己加分支。

[HARD] gotcha 1:EGA 用「字型檔存在」啟用中文 → getLanguage() 不是 ZH_TWN

• 承增量一,EGA 不能用 --language(會進不去)。所以 systemui 那個 switch (getLanguage()) 永遠不會命中 case ZH_TWN。
• 正解:在 switch 之後補 if (_gfx->chtEnabled()) { ... } 覆蓋為中文。判 chtEnabled、不判 language。

[HARD] gotcha 2:init 順序——SystemUI 建構早於字型載入

• agi.cpp:new SystemUI(...) 在 _gfx->loadChtResources()(設 _chtEnabled=true)之前。→ 建構子讀 chtEnabled 還是 false,中文分支不生效(道具名卻正常,因為它是顯示時即時查表)。
• 正解:把 loadChtResources() 移到 new SystemUI 之前。它只開 lsl_big5.fnt/translation.tsv、建自己的 Big5Font,不依賴 _font->init(),可安全前移(仍在 initVideo 前)。教訓:凡「建構子時抓一次狀態」的字串,要確認該狀態在建構前已就緒。

狀態列 Score/Sound 中文化(小改動、大提升)

• 狀態列 TextMgr::statusDraw 用的也是 displayText → 本就支援 Big5,不必另做狀態列繪字。
• 設 _textStatusScore = "得分:%v3 / %v7"(Big5)、_textStatusSoundOn/Off。%v3/%v7 是 AGI 變數代換(分數),stringPrintf 會填,務必保留。
• 中文比英文短,score@col1 / sound@col30 排版不撞。黑字白底(charAttrib 0,15)與英文一致。

F8 中英對照切換(雙引擎,玩家可即時對照原文)

• 獨立旗標 _chtLangOn,別重用 _chtEnabled——後者還牽動 hi-res 與 Big5 繪製 gate,拿來當語言開關會壞畫面。getChtTranslation 開頭 if (!_chtEnabled || !_chtLangOn) return 原文/nullptr。
• F8 在各引擎事件入口攔截並消費(AGI processScummVMEvents 的 EVENT_KEYDOWN、SCI getScummVMEvent),不傳給遊戲腳本(免被原本 F8 功能吃掉);只在中文化啟用時攔。
• AGI=當前訊息框原地即時重繪:messageBox 入口快取英文原文+wanted 排版,F8 時 drawMessageBox(getChtTranslation(原文))——drawMessageBox 內部先 closeWindow 再畫,可重入,切換即翻。
• SCI=下一則生效:SCI 文字框與 transient port 狀態緊耦合,就地重繪風險高,採「下次繪製生效」語意。

內容為 key 的漏字盤點法(通用)

• SCI 的坑:extract_strings.py 只抽 message/text 資源,漏掉整批 SCRIPT 內嵌 Print/物件描述字串(如「You see alleys…」)。→ SCI_DUMP_RES 已 dump script.*,自己寫抽取器抽 script 內英文 prose,diff 翻譯表補齊。
• 選單按鈕的 key 帶 padding 空格(如 " Beer "、" Save ")——SCI 按鈕置中用空格填。key 要逐字保留空格才命中,譯文也保留(啤酒)免破版。
• 零成本驗渲染路徑:同一選單裡若「已譯的顯示中文、未譯顯示英文」呈混雜態(如點酒選單「一輪酒」中文、Champagne 英文),就證明該 UI 走 getChtTranslation,補表即完成——不必先猜要不要改引擎。

引擎內 Big5 字串怎麼寫

• C++ 字面值用 \xNN 逐 byte hex escape(mirror 既有 RU/HE/FR 分支),別放裸 Big5 byte(檔案非 UTF-8)。
• [HARD] clang(macOS)的 \x 是貪婪的 → GCC/mingw 過、clang 炸:\xNN 會一路吃掉後面所有 hex 數字。若 Big5 escape 直接接一個「hex 數字字元」(0-9a-fA-F,含 ASCII 字母 AF、af),會被併吞成越界值 → error: hex escape sequence out of range。典型:中文逗號 ，(=\xA1\x41)直接接 ESC/ENTER → \x41ESC 讀成 \x41E(0x41E>255)。GCC/mingw 較寬鬆放過,只有 macOS CI 的 clang 才爆(本機 Linux 測不出)。修法:字面值串接打斷 "\xA1\x41" "ESC"(相鄰字面值自動接合,source 空格被忽略、位元組完全相同、不加字、全編譯器可攜)。通則:任何 \xNN 後緊接 hex 字元處都要插 " ";產生器可自動偵測 escape 後接 [0-9a-fA-F] 就插斷點。
• 字元必須在烘出的字庫內:字庫由 build_cht.py 從 translation 表的譯文 value取字。若引擎硬寫字串用了表裡沒有的字,先確認覆蓋(這幾組系統 UI/狀態列字剛好都被既有譯文涵蓋)。

---

增量六:年齡/問答驗證「一次通過永久免答」(自動作答,雙引擎)

老 AVG 開場常有防拷式年齡+成人常識問答,每次開機重考很煩。做法:通過一次後之後開機自動答過(片頭照留)。核心理念——不是背答案(隨機抽題),是逆向出遊戲把「正解」暫存在哪,讓遊戲自己告訴引擎。

破解流程(先靜態後動態,rulebook 62/64)

1. 靜態 dump 題庫資源看格式:SCI text.NNN(LSL1 是 722/730/743…)strings 一看就懂——每題文字第一個字元 = 正解編號(1-4)。AGI 則在 LOGIC。
2. 動態 probe 找正解暫存的變數:在每次繪字都會過的入口掛暫時 probe 印出當前 room 的 script locals + 文字。SCI 在 GfxText16::Box() 讀 getScriptIfLoaded(getScriptSegment(720))->getLocalsBegin();對照「每題後遊戲顯示 Correct」確認是哪一格 → LSL1 是 script 720 的 local[4]=正解、local[5]=題序(換題才變,用來偵測新題)。AGI 對應 v93(room 6)。
3. 輸入方式看畫面提示,別假設統一:年齡選單提示「Use the TAB key」→ TAB 移動+ENTER;a/b/c/d 問答 → 直接按字母鍵('a'+(L4-1));片頭/警告 → 不主動注入交玩家推進(保留片頭)。

引擎實作要點

• 合成鍵在事件輪詢前注入:SCI EventManager::getScummVMEvent() 開頭先送 chtVerifyPendingKey()(TAB/ENTER/字母),回傳後才 poll 真實事件 → 優先於玩家輸入(否則玩家亂按 ENTER 會誤選年齡選單焦點格 under 15 被踢)。偵測(Box() 內同步排隊)與注入之間無事件迴圈空窗,local 一設好就答;同題選項回顯用「佇列非空」擋重複、用 local[5] 未變擋重複。
• 年齡選單選中間成人格容錯大:目標「40 to 65」(TAB×3)而非「19 to 39」——TAB 差一格,鄰格 19-39/66-99 仍成人。
• 「已通過」雙保險判定:啟動時 有存檔 || .chtok 旗標存在 → 啟用自動作答;每輪 chtVerifyRoomTick() 追蹤驗證 room 進出,曾進又離開=通過→寫 .chtok(首次手動通過的玩家也會寫,下次就自動)。全新玩家第一次仍手動,機制不失效。
• 實機驗證(rulebook 65):log 應出現 TAB×3→每題 auto-answer → Correct→left room 720 → now room 100(進遊戲)→寫旗標;反向(無旗標)無 auto-answer、正常提示。

完整逆向紀錄:本專案 docs/45-sci-age-verify.md(VGA/SCI)、docs/40-agi-track.md §7(EGA/AGI v93)。通則:SCI 問答防拷幾乎都把正解存某 script local,dump 題庫看首欄+Box() probe 對照 locals 就能定位。

[HARD] 第一性原理:要「一鍵跳過」驗證 → 跳門,別答題

「逐題自動作答」(保留片頭的一次通過永久免答)與「一鍵略過」是兩種需求,別混。要當場一鍵略過時,逐題模擬會撞題型繁多的坑(常識題 TAB/字母、笑話題 local[4]=0 任意答案、手冊防拷題、各種過場推進方式全不同,一個個特例修到死)。第一性原理:驗證只是一道「門」把玩家擋在起始房間外——直接跳到門後的起始房間即可,不必答對任何一題。用引擎內建換場機制:

• SCI:_gamestate->setRoomNumber(N)(除錯器 "room" 指令同機制)+ abortScriptProcessing=kAbortLoadGame(打斷驗證控制項的 VM 阻塞迴圈,走 replay 恢復路徑進 room N;光設 room 不會打斷阻塞迴圈)+ _gfxPorts->reset()(清殘留對話框 window,同 savegame.cpp restore 路徑)。
• AGI:keyboard 攔截 → _text->closeWindow() + _game.exitAllLogics=true + cycleInnerLoopInactive() + newRoom(N)(比照 AGI restore 從 inner loop 直接換場)。
• 起始房間號:LSL1 EGA=room 11、VGA=room 100(皆老左酒吧外)。事件層攔 Ctrl+Alt+X,一律消化避免字元漏進遊戲 parser。

教訓:老遊戲 gate/防拷,「跳過」的第一直覺該是「換到門後房間」,不是「破解怎麼答對」。前者用引擎既有的 restore/除錯換場機制,幾行搞定;後者是無底洞。笑話題(任意答案、local[4]=0)若真要逐題答,要偵測問句結尾 ? 按 'a',否則卡死。

---

可複用清單(換一款靠哏的老 AVG)

要素	這次做法	換遊戲要改
引擎繪字	AGI drawBig5CharacterOnDisplay / SCI GfxFontChinese	看引擎;AGI/SCI 已有範本
啟用開關	AGI 字型檔存在 / SCI config language=tw	依引擎 detector 行為
抽字	AGI LOGIC avis-durgan XOR / SCI SCI_DUMP_RES	各引擎資源格式
非-LOGIC 文字	AGI OBJECT 道具名(avis-durgan XOR,走 displayText 免改引擎)/ SCI script.* 內嵌+選單按鈕(padding 空格當 key)	別漏道具/選單/系統 UI,才叫完整
系統 UI/狀態列	AGI systemui.cpp 加 if(chtEnabled) 分支(判 chtEnabled 非 language);狀態列走 displayText 支援 Big5,保留 %v3/%v7	引擎硬寫字串處各異;init 順序要 chtEnabled 先就緒
F8 中英切換	獨立 _chtLangOn(勿重用 chtEnabled);事件入口攔截;AGI 原地重繪/SCI 下則生效	各引擎事件入口與重繪機制
標題疊圖	.ovl 索引點陣,EGA 直寫 / VGA nearest-palette-map	確認 display 實際尺寸!320 vs 640
幽默在地化	風格聖經+統一譯名表+批次 subagent+合併驗證+譯名掃描+corrections	梗庫換該語言文化;尺度先跟使用者校準
headless 擷取	關警告→輸入年齡→存檔 checkpoint→look 觸發	各遊戲防拷流程
驗證一次免答	dump 題庫看首欄=正解→Box() probe 對照 script locals 找正解格→合成鍵事件輪詢前注入(TAB 選單/字母問答)→存檔+旗標判定;離開驗證 room 寫旗標	各引擎正解暫存變數位置(AGI v93 / SCI local[4])與輸入方式
打包	AppImage/Windows(mingw,保 config.guess)/macOS CI(自編 SDL2 非 brew)	見 mac-app-cross-pack、BUILD.md

[HARD] 通用慣例:所有 ScummVM 中文化都 enable MT-32

Roland MT-32 音樂比 AdLib/PC speaker 好很多,老 Sierra 遊戲(AGI/SCI)本就內附 MT32.DRV。慣例:configure 一律不帶 --disable-mt32emu(讓 Munt MT-32 模擬器編入;grep USE_MT32EMU config.h 應為 #define)。要點:

• 實際發聲需 MT-32 ROM(MT32_CONTROL.ROM+MT32_PCM.ROM,有版權、絕不隨引擎散布/入 GitHub;.gitignore 加 *.ROM)。LSL1 用 1987 v1.07 老 MT-32 ROM(合年代)。
• 完整包(dist-all/本機)可附 ROM → 打包腳本從本機 ROM 目錄複製進遊戲資料夾、AppRun/.bat 設 --music-driver=mt32 --extrapath=<游戲夾>,開箱即用。
• GitHub/patch-only 不附 ROM → 不設 mt32 預設(否則無 ROM 會彈一次阻擋框「MT-32 emulator cannot be used…」再回退 AdLib),文件教玩家自備 ROM 後於音效選項選 Roland MT-32。
• macOS CI(GitHub runner)拿不到本機 ROM → 只開 mt32 能力、不設預設。
• 驗證:log 出現 Falling back to MT32(=MT32 ROM 成功載入,Munt 先找 CM32L 才回退)且無 cannot be used 即 OK。

互補

• 純 SCI 繪字/baked-art 深水區 → scummvm-sci-cht-localization。
• 實機「正常玩家路徑」驗收 → retro-game-playtest。
• 推廣片(配原版音樂) → game-promo-video-ffmpeg + rulebook 93。
• 驗收對 reference 非內部訊號 → rulebook 65。