proofreader-api

Proofreader API 技能為實作基於瀏覽器的 AI 寫作輔助提供了一個結構化框架。此技能專為 JavaScript 與 TypeScript 網頁應用程式設計，使開發人員能夠利用內建的機器學習模型，直接在瀏覽器中整合拼寫檢查、語法修正與標點符號優化等功能。它適用於構建文字編輯器、內容管理系統或互動式表單的軟體工程師與前端開發人員，幫助處理模型可用性檢查、安全上下文要求以及瀏覽器預覽版實作中的各種細節問題。

• 支援穩健的可用性檢查，以判斷 Proofreader API 是否能在當前瀏覽器環境中初始化。

• 簡化模型下載監控流程，允許 UI 元件追蹤下載進度，並在獲取資產時更新使用者介面狀態。

• 管理工作階段生命週期，包括處理創建、Abort 訊號以及資源清理，確保應用程式高效運作。

• 支援語言配置以及針對拼寫、語法與標點符號等細節的校正類型控制。

• 提供將校正後的文本輸出以及結構化元數據（包含校正說明與索引範圍）渲染至畫面的實作模式。

• 提供封裝好的 API 封裝器，確保跨瀏覽器版本與預覽旗標的一致性表現。

• 優先使用所提供的輔助腳本來盤點瀏覽器進入點，並識別工作區內的整合目標。

• 確保所有 Proofreader 操作皆在安全上下文內執行，並在嘗試創建工作階段前檢查權限原則限制。

• 對於不支援的瀏覽器、受限框架或未達最低硬體與儲存空間要求的裝置，務必實作非 AI 的備援機制。

• 使用提供的工作階段範本以維護嚴格的型別定義，並妥善處理如 NotAllowedError 或 NotSupportedError 等錯誤。

• 注意工作階段選項是不可變的，若需變更行為應重新創建實例，而非嘗試在初始化後修改選項。

• 此技能包含故障排除參考，以解決如儲存空間不足導致模型被刪除或 iframe 特定限制等邊緣情況。