# LOOM 文字索引與翻譯 目前掃描 75 個原始 LFL,解析 73 個實際存在的 room、984 份腳本,列出 2038 個文字位置;1201 個含文字的項目中已翻譯 1201 個,缺漏 0 個,無效翻譯 0 個。正常解析的文字項目已全數提供繁體中文初譯;仍需按遊玩語境校閱,解析不完整的候選及圖像內文字不計入涵蓋率。 ## 產物 - catalog.json:完整文字位置、原文模板、綁定、控制碼、原始 hex、來源檔與版本 SHA256。 - catalog.csv:可供檢閱的清單(UTF-8,含原文、中文及狀態)。 - zh-TW.template.json:所有文字項目的空白翻譯範本。 - zh-TW.json:遊戲實際載入的繁體中文翻譯;以此檔編輯/補譯。 - missing-zh-TW.json:缺漏、未知索引、來源或佔位符不符,以及解析診斷。 ## 索引與佔位符 ID 是 global:N:text:OFFSET、room:R:local:N:text:OFFSET、room:R:entry/exit:text:OFFSET、room:R:object:N:text:OFFSET 或 room:R:object:N:name。OFFSET 是十六進位,依對應原始 bytecode 的起點計算;object 文字採完整 object code 的位移,不含動態 handler verb,因此共用程式碼不會產生多個翻譯鍵。 翻譯格式: ```json { "format": "loom-translation", "version": 1, "locale": "zh-TW", "fingerprint": "同 catalog", "messages": { "global:5:text:021c": { "source": "(Text speed {var_0}.)", "text": "(文字速度:{var_0}。)" } } } ``` 保留 source 不變。text 可調整語序,必須保留原來的 {var_0}/{name_0}/{string_0}/{verb_0} 等佔位符及出現次數;缺漏或不符時回退英文。換行使用 JSON 的 \n。音符及控制碼不當作一般文字重寫。動態值由原腳本執行時捕捉,物件名稱與字串參照可遞迴翻譯。 English 永遠顯示 LFL 英文;語系只改顯示,不改 VM 英文值、分支、文字等待時間或原始 LFL。切換語系會更新目前對話、靜態文字、物件預覽及清單。翻譯檔與存檔均綁定原始 LFL fingerprint。 ## 擷取方法及限制 用既有 GPL ScummVM Tools descumm 的指令解析器,在 get_string 呼叫處記錄確切字串範圍;原始 vendor 不改,instrumented 副本在 analysis/tools 生成。不是掃描可列印 ASCII。物件名稱依原始欄位定位。00.LFL 是索引,99.LFL 是字型;圖像裡的字不會列為可翻譯字串。 15 項診斷列於 missing-zh-TW.json;索引指向缺檔、損壞或無法完整反組譯的資源會明列。partial 範圍保留研究資料,不當作已完整還原;不可將清單項目數當成全遊戲語意驗收。 ## 工具 ```bash node tools/build_descumm.mjs --text node tools/build_text_catalog.mjs node tools/seed_translation.mjs # 保留現有 source 相符的翻譯,補充已完成的初譯 node tools/report_translation.mjs npm run standalone ``` 擷取器會重建 catalog 與空白範本,不覆寫 zh-TW.json;補譯後執行 report_translation 及 standalone。來源及授權沿用 tools/vendor/scummvm-tools/SOURCES.json 與 COPYING。