Project Files
docs / I18N.zh-TW.md
RAG-Flex 採用雙層語言機制，提供真正的多語系體驗：
由系統語言決定
範例：
由用戶在設置中選擇
範例：
| 部分 | 使用的語言 | 如何切換 | 何時生效 |
|---|---|---|---|
| 配置介面標籤 | 系統語言 | 改變系統語言 + 重啟插件 | 插件啟動時 |
| 訊息語言選擇器 | 系統語言 | 改變系統語言 + 重啟插件 | 插件啟動時 |
| 其他配置項標籤 | 系統語言 | 改變系統語言 + 重啟插件 | 插件啟動時 |
| 狀態訊息 | 訊息語言 | 在設置中選擇 | 立即 |
| 錯誤提示 | 訊息語言 | 在設置中選擇 | 立即 |
| LLM 系統提示 | 訊息語言 | 在設置中選擇 | 立即 |
情況： 系統是繁體中文，想要全中文體驗
設置：
結果：
情況： 系統是英文，但想看中文訊息
設置：
結果：
情況： 想同時看到中英文對照學習技術術語
設置：
結果：
這是 LM Studio SDK 的限制，不是設計缺陷：
SDK 限制：
withConfigSchematics() 只能調用一次我們的解決方案：
LANG （最常見）LANGUAGE （備選）LC_ALL （locale 覆蓋）環境變量設置（進階）：
終端機設置：
臨時設置（當前會話）：
永久設置：
選擇 English (en):
選擇 繁體中文 (zh-TW):
建議配置：
建議配置：
優勢：
測試建議：
A: 這是設計行為，不是錯誤。
如果想改變配置介面語言，請改變系統語言後重啟插件。
A: 兩步設置：
重啟插件後，所有內容都是中文。
A: 目前還不支援，但已規劃中。
如需簡體中文支援，請參考 src/locales/README.md 了解如何貢獻翻譯。
A: 可以！請參考：
src/locales/README.mdsrc/locales/README.zh-TW.md添加新語言只需 5 個步驟，歡迎貢獻！
I18N_IMPLEMENTATION.mdSUMMARY.mdCHANGELOG_I18N.md這個雙層語言機制的設計基於以下原則：
感謝 LM Studio 團隊提供優秀的插件 SDK，讓我們能夠構建這個多語系系統。
最後更新：2026-01-02 版本：v1.2.0
English (en)繁體中文 (zh-TW)src/locales/README.mdsrc/locales/README.zh-TW.md// 插件生命週期
export async function main(context: PluginContext) {
// 1. 檢測系統語言
const systemLang = detectSystemLanguage();
// 2. 生成配置介面（使用系統語言）
const config = createDynamicConfig(models, systemLang);
// 3. 註冊到 LM Studio（此時配置介面就固定了）
context.withConfigSchematics(config);
// ↑
// 從此無法更改
}
export function detectSystemLanguage(): SupportedLanguage {
const envLang = process.env.LANG ||
process.env.LANGUAGE ||
process.env.LC_ALL || "";
// 繁體中文（台灣、香港、澳門）
if (envLang.includes("zh_TW") ||
envLang.includes("zh-TW") ||
envLang.includes("zh_HK")) {
return "zh-TW";
}
// 簡體中文（暫時映射到繁體，未來支援）
if (envLang.includes("zh_CN") ||
envLang.includes("zh-CN")) {
return "zh-TW"; // TODO: 添加 zh-CN 支援
}
// 預設英文
return "en";
}
set LANG=zh_TW.UTF-8
set LANG=en_US.UTF-8
export LANG=zh_TW.UTF-8
export LANG=en_US.UTF-8
export LANG=zh_TW.UTF-8
lms dev
# 編輯 ~/.bashrc 或 ~/.zshrc
echo 'export LANG=zh_TW.UTF-8' >> ~/.bashrc
source ~/.bashrc
lms dev
Loading embedding model: bge-m3...
Retrieving relevant citations...
Retrieved 5 citations (threshold: 0.4)
載入 Embedding 模型: bge-m3...
正在檢索相關片段...
成功檢索到 5 個相關片段 (門檻: 0.4)