ADDT 技術文件
深入了解 ADDT 擴充功能的技術實現和未來計劃
目錄
專案概覽
ADDT（Dev Docs Translation for Apple）擴充功能源自開發者對 Apple 官方文件閱讀需求。Apple 提供豐富的開發文件，但這些文件主要以英文提供，對非英語使用者來說形成理解障礙。ADDT 以瀏覽器擴充功能的形式，為全球開發者提供即時準確的 Apple 開發文件翻譯服務，旨在幫助他們更有效率地學習和運用 Apple 技術。此專案於 2024 年底啟動，經過多次改進，現已成為許多開發者工作流程中不可或缺的工具。
技術實現
了解 ADDT 擴充功能的核心技術實現原理
文件解析與處理
ADDT 擴充功能採用請求攔截裝飾器模式，在充分分析頁面資料內容和文件資料結構後，準確匹配字典並對文件內容應用 AI 翻譯。充分利用瀏覽器提供的 WebExtension API，實現內容腳本注入、背景處理、訊息傳遞等核心功能。在此過程中，不修改頁面元素內容，完全遵循 Apple 現有的資料渲染方式進行顯示，確保頁面的純淨性和樣式一致性、美觀性。
翻譯引擎
為支援多種語言，我們根據不同自然語言使用不同的大型語言模型。日文、簡體中文、繁體中文使用 QWen2.5-14B、QWen2.5-32B、Grok-2，並包含人工審核和驗證系統。韓文因目前所有大型模型的翻譯效果都不夠理想，使用更昂貴的 Grok-2 並進行廣泛的手動修改。未來對於西班牙文、德文、法文等西方語言，將使用 Grok-2 和 GPT-3.5 來確保翻譯品質。根據技術文件的特性優化翻譯引擎，特別注重程式設計術語、API 名稱、技術概念的處理。系統維護專業術語資料庫，確保技術術語的翻譯準確且一致。同時實現上下文感知翻譯，確保翻譯結果符合技術文件的語境。對模型進行微調，確保翻譯的準確性。
效能優化與快取
為提供流暢的使用者體驗，ADDT 擴充功能使用 Cloudflare 的 KV 進行認證，R2 儲存翻譯字典。依賴 Cloudflare 的全球邊緣網路快取機制，當使用者再次訪問相同頁面時，擴充功能可以從最近的位置立即提供翻譯結果。同時，擴充功能採用非同步處理模式，確保翻譯過程不會阻擋頁面的正常載入和互動。
技術堆疊
探索 ADDT 擴充功能背後的核心技術
Plasmo
ADDT 擴充功能使用 Plasmo 框架開發，提供元件式開發模型和豐富的 API，簡化擴充功能開發流程，確保跨瀏覽器相容性。
Cloudflare
Cloudflare 是優秀的全球 CDN 供應商，為 ADDT 擴充功能提供高速的翻譯結果快取服務。
TypeScript + HeroUI
TypeScript 提供優秀的型別系統，為 ADDT 擴充功能的快速開發提供必要的穩固性。HeroUI 是優秀的 UI 元件庫，為 ADDT 擴充功能提供美觀的 UI 設計。
Paddle
Paddle 是優秀的支付平台，為 ADDT 擴充功能提供安全的支付服務。
未來計劃
探索 ADDT 擴充功能的開發路線圖和未來功能
文件覆蓋範圍擴展
計劃擴展翻譯文件的覆蓋範圍，支援更多 Apple 平台技術文件，包括 UIKit、AppKit、Core Data、Metal 等框架。特別是對於 visionOS 和 Apple Vision Pro 開發的新文件，將優先提供翻譯支援，幫助開發者快速掌握這些尖端技術。另外，還將添加 WWDC 影片字幕翻譯功能，讓開發者能夠更全面地學習 Apple 技術。
翻譯品質提升
翻譯品質提升是我們持續關注的重點。未來將引入更先進的翻譯模型，特別是針對技術文件優化的大型語言模型。同時建立社群審核機制，讓專業開發者參與翻譯審核和改進，共同提高翻譯準確性。此外，開發更智能的術語管理系統，確保技術術語在不同文件間保持一致的翻譯，提升使用者的閱讀體驗。
跨平台支援與功能擴展
我們正在努力將 ADDT 擴充功能擴展到更多瀏覽器平台，特別是 Safari。同時提供離線翻譯功能，讓開發者在沒有網路連接的情況下也能使用翻譯服務。在功能方面，將添加自訂設定選項，讓使用者可以自訂翻譯環境設定，例如保留特定術語不翻譯或調整翻譯樣式。另外還將引入協作翻譯功能，讓團隊成員可以共享和同步翻譯設定。