i18n

i18n 助手是專為簡化 LobeHub 生態系統本地化流程而設計的工具。它強制執行嚴格的開發標準，以確保應用程式中在地化文本的一致性、可維護性和可擴展性。透過直接與 react-i18next 框架整合，它為管理語言檔案、實作翻譯鍵值以及遵循專案特定的架構模式提供了明確的指導。

• 標準化使用點符號的扁平鍵名約定（例如 feature.context.action），以防止衝突並提高清晰度。

• 透過引導開發人員將鍵值新增至 src/locales/default/ 中的特定命名空間檔案來管理翻譯工作流。

• 提供在 .tsx 元件中使用 useTranslation 等 react-i18next 鉤子的語法指導。

• 強制執行關於檔案編輯的嚴格限制，強調只能修改預設的本地化原始檔，而自動生成的 JSON 檔案應嚴格保留供建置流程使用。

• 支援高階 i18n 功能，例如使用 {{variableName}} 語法進行參數插值。

• 在實作新功能時使用此助手，以確保所有使用者可見的字串都正確抽象化到 i18n 系統中。

• 始終參考命名空間列表（common, chat, setting 等），以確保翻譯邏輯分組。

• 請記住，在提交拉取請求之前執行 pnpm i18n 生成指令碼，以確保各語言區域的同步一致性。

• 避免在翻譯檔案中嵌套物件；使用規定的扁平結構來維護架構穩定性。

• 當遇到翻譯鍵衝突或將複雜變數整合到在地化字串時，請諮詢此工具。