Repository navigation
Releases: BillyJr0127/pc98-ai-localization-handbook
Release list
v1.2.1 — 禁止重製：DOS 執行、導出、導入
依使用者要求，所有 AI 的工作方向明確固定為三項，依序交付：
- 盡速讓 DOS 下執行：保留原引擎、遊戲邏輯與資料，以最快速度、最少必要修改轉接 IBM DOS。
- 做出導出工具：原遊戲可執行且回應基本輸入後，導出該遊戲文字／台詞至 Excel 並保存原位映射。
- 做出導入工具：將譯文分批放回原遊戲，完成必要編碼、字型、建置及回復，保護存檔。
禁止以重製方式移植，不另寫引擎、腳本 VM 或場景流程來模仿原作。必要硬體相容層與音源晶片模擬供原程式使用，保留原事件語義。
新增 AGENTS.md，更新首頁、AI 指引、流程、單檔版及交接模板。移除「全部基本驗證完畢才能開始工具」的門檻；不讓全文翻譯、全路線通關或通用框架阻擋三項交付。人工範例、文件或候選 JSON 不等於該遊戲的完整工具。
下載 AI-HANDBOOK.md 可直接交給 AI；ZIP 含全部分章及既有可執行人工範例。39 個檔案的允許清單、連結／JSON、單檔同步與既有範例檢查通過。只發布教學與自製資料，不含遊戲素材。
v1.2 — 日文版優先與 Excel 翻譯往返工具
新增「先跑穩原日文版，再加入中文化」與「台詞 Excel 往返」兩章，整理第三個仍在開發中的案例經驗。
- 先展示原日文畫面與一次真實操作，再補換景、存讀檔、焦點恢復及音訊基本驗證。
- 收錄最小硬體轉接、增量建置、同步淡出與音訊供應期限、穩定字碼、字庫容量及合法空白字形的教訓。
- 提供可執行的自製 JSON → Excel → 候選語言 JSON 範例，支援拆冊、去重、位置覆寫、語言隔離及分批保留／清除。
- 附遊戲引擎適配契約；實際遊戲解析、字庫、DOS 編譯與套用流程須另行實作。
下載 AI-HANDBOOK.md 可直接交給 AI 閱讀；下載 PC98-AI-Handbook-v1.2.zip 可取得分章、模板與全部人工範例。執行 Excel 範例需要 Python 3.10 以上，依 requirements.txt 安裝 openpyxl。
已驗證：38 個教材檔案允許清單、連結／JSON、單檔同步、既有合成音訊與二進位範例、新 Excel 實際往返、重複匯入、錯誤拒絕與來源／既有輸出保護。
只包含自有教學與人工資料，不附遊戲、圖片、劇本、譯文全文、音樂、字型、存檔或私人環境。第三案例未完成全文中文化；私人整冊預檢通過不等於最新整冊已套用或全路線驗收。
v1.1 — 跨代移植、音源與乾淨封裝經驗
本版加入第二個 PC-98 → IBM DOS 繁體中文移植案例的經驗，供 AI 在新專案重新辨識及驗證。
- 磁片配置與子模組、反編譯往返、受限字碼、雙位元組終止符及開場排版。
- 原演奏驅動、YM2203、淡出與停止語義、DPMI 排程，以及網路影片後製配樂的辨識。
- 回憶重播的操作再現、診斷副本與正式流程分離、錄影驗證界線。
- 乾淨封裝的有效初始化模板、首次只補缺槽、兩包共用內容核對與最終交接。
新增自製二進位範例與發布模板。28 個教材檔案已通過白名單、文件連結、JSON、自製範例、唯讀清單工具及 ZIP 逐檔校驗。
下載 AI-HANDBOOK.md 可直接交給 AI 閱讀；PC98-AI-Handbook-v1.1.zip 包含分章文件、模板與可執行的教學腳本。
本次只發布教學與自製範例，不附遊戲映像、程式、素材、完整翻譯、存檔、遊戲包或解鎖資料。案例證據由既有本機紀錄整理，沒有在此次文件編輯重跑遊戲；正常全程人工通關、逐句人工潤校、全曲／實體板卡比對及續作全螢幕錄影仍未完成。這份教材不是一鍵轉換器或個案法律保證。
SHA256：
AI-HANDBOOK.md
72a5d45597ead900d3b5bb529744c132c083f54979d42d389efef1dbe8b9ad3c
PC98-AI-Handbook-v1.1.zip
c4475571d03645f496123c7c894f4fa3401c4e7f794f5113098ac353431d8ee1
v1.0.0 — 給 AI 的 PC-98 中文化與音訊研究手冊
給 AI 閱讀的 PC-98 中文化與音訊研究教材，使用繁體中文撰寫。
- 直接把
AI-HANDBOOK.md交給 AI；提供輸入路徑、使用範圍、目標平台與音源需求，即可從唯讀盤點開始。 - 包含分階段工作流程、JSON 模板、交接規則、實際研究教訓，以及 FM／SSG、OPNA、MIDI、PCM／ADPCM 與混合音源的辨識、處理和驗證方法。
- 自製範例示範慢播但零 underrun、漏 Note Off，以及翻譯遺失變數的偵測。
- ZIP 內有 22 個教學檔案；不含遊戲磁片、原作程式或劇本、ROM、字型、音樂、存檔或私人紀錄。
- 文件、模板與自製程式採 MIT 授權；第三方參考及讀者的資料不因此取得授權。
已檢查檔案白名單、內部連結、JSON、單檔版同步、自製故障範例及唯讀清單工具的覆寫保護。這是研究手冊，不是任意 FDI 的一鍵轉換器，也不是所有遊戲或音源已通過驗證的承諾。