---
document_type: "implementation_guide"
service: "MOMENTRY_CORE"
title: "同義詞林安裝與多語系支援"
date: "2026-04-25"
version: "V1.0"
status: "active"
owner: "Warren"
created_by: "OpenCode"
tags:
  - "同義詞林安裝與多語系支援"
ai_query_hints:
  - "查詢 同義詞林安裝與多語系支援 的內容"
  - "同義詞林安裝與多語系支援 的主要目的是什麼？"
  - "如何操作或實施 同義詞林安裝與多語系支援？"
---

# 同義詞林安裝與多語系支援

## 概述

本文檔總結 Momentry Core 系統的同義詞林安裝指南和多語系支援功能。系統提供完整的同義詞擴展功能，支援多種語言，但**不提供預設同義詞資料**，客戶需自行準備合法資源。

## 主要文件

### 1. 安裝指南
- **[INSTALL_SYNONYM_FOREST.md](INSTALL_SYNONYM_FOREST.md)** - 完整的同義詞林安裝指南，包含：
  - 尋找合法同義詞資源
  - 格式轉換和配置
  - 自定義同義詞編輯方法
  - 多語系解決方案
  - 測試和故障排除

### 2. 多語系示例文件

#### 跨語言同義詞庫
- **`docs_v1.0/examples/multilingual/multilingual_synonyms.json`**
  - 中英對照同義詞示例
  - 包含科技相關術語
  - 支援繁簡體中文轉換

#### 統一格式多語系同義詞庫
- **`docs_v1.0/examples/multilingual/unified_multilingual_synonyms.json`**
  - 統一格式的多語系同義詞庫
  - 支援中、英、日、韓四種語言
  - 包含翻譯映射和同義詞組

#### 語言路由配置
- **`docs_v1.0/examples/multilingual/language_routing.json`**
  - 語言路由配置示例
  - 支援多種語言檢測方法
  - 包含跨語言回退策略

### 3. 工具腳本

#### 語言檢測工具
- **`scripts/detect_language.py`**
  - 檢測文本語言
  - 支援中、英、日、韓等語言
  - 輸出置信度和詳細分數

#### 語言路由工具
- **`scripts/language_router.py`**
  - 根據語言路由到相應同義詞庫
  - 支援語言變體和回退
  - 可配置路由策略

#### 統一格式處理器
- **`scripts/unified_synonym_processor.py`**
  - 處理統一格式多語系同義詞庫
  - 提取特定語言同義詞
  - 創建跨語言映射
  - 搜索術語和導出標準格式

#### 測試腳本
- **`scripts/test_multilingual.sh`**
  - 測試多語系功能
  - 驗證工具運作
  - 生成測試輸出

## 多語系支援方案

### 方案 1: 跨語言同義詞庫
- 單一檔案包含多種語言
- 適合簡單的多語系需求
- 配置簡單，維護方便

### 方案 2: 語言專用同義詞庫
- 每個語言獨立檔案
- 適合複雜的多語系需求
- 支援語言檢測和路由

### 方案 3: 統一格式多語系同義詞庫
- 統一格式包含所有語言
- 支援翻譯映射
- 可動態提取特定語言

## 版權政策

**重要**: Momentry Core 系統**不提供**任何預設同義詞資料。客戶必須：

1. **自行尋找合法資源** - 使用開源或合法授權的同義詞林
2. **遵守版權規定** - 確保使用的資源符合版權法
3. **自行轉換格式** - 將資源轉換為系統支援的 JSON 格式
4. **自行維護更新** - 定期更新同義詞庫

系統僅提供：
- 格式規範和配置方法
- 工具腳本和示例文件
- 安裝和測試指南

## 快速開始

### 步驟 1: 準備同義詞資源
```bash
# 1. 尋找合法同義詞資源
# 2. 轉換為 JSON 格式
# 3. 保存到 config/synonyms/ 目錄
```

### 步驟 2: 配置系統
```bash
# 編輯配置文件
vim config/momentry.toml

# 添加同義詞配置
[synonym]
enabled = true
files = [
    "config/synonyms/custom_synonyms.json",
    "config/synonyms/tech_synonyms.json"
]
```

### 步驟 3: 測試功能
```bash
# 運行測試腳本
./scripts/test_multilingual.sh

# 測試同義詞擴展
cargo run --bin test_synonym_expansion -- --text "測試文本"
```

### 步驟 4: 多語系配置（可選）
```bash
# 配置多語系支援
cp docs_v1.0/examples/multilingual/language_routing.json config/

# 編輯路由配置
vim config/language_routing.json
```

## 進階功能

### 自定義同義詞編輯
- 直接編輯 JSON 檔案
- 使用 Python 腳本編輯
- 建立領域專用同義詞庫
- 合併多個同義詞檔案

### 質量檢查
- 檢查重複項
- 驗證格式
- 測試同義詞擴展
- 性能測試

### 版本控制
- 使用 Git 管理變更
- 建立版本歷史
- 備份同義詞庫
- 回滾錯誤修改

## 故障排除

### 常見問題
1. **同義詞未生效** - 檢查配置檔案路徑和格式
2. **性能問題** - 減少同義詞數量或優化結構
3. **記憶體不足** - 分割大型同義詞庫
4. **語言檢測錯誤** - 調整檢測規則或使用明確語言標記

### 調試工具
```bash
# 檢查同義詞加載
cargo run --bin test_synonym_expansion -- --debug

# 測試語言檢測
python3 scripts/detect_language.py -v "測試文本"

# 驗證 JSON 格式
python3 -m json.tool config/synonyms/custom_synonyms.json
```

## 相關文件

- [SYNONYM_CONFIGURATION.md](../SYNONYM_CONFIGURATION.md) - 同義詞配置指南
- [PROJECT_DOCS_V1_INTEGRATION_PLAN.md](../PROJECT_DOCS_V1_INTEGRATION_PLAN.md) - 文件整合計劃
- [API_SYNONYM.md](../API/API_SYNONYM.md) - 同義詞 API 文檔

## 支援與反饋

如有問題或建議，請：
1. 查閱相關文件
2. 使用測試腳本驗證功能
3. 檢查系統日誌
4. 提交問題報告

---

**注意**: 本系統僅提供技術框架和工具，客戶需自行負責同義詞資源的合法性、準確性和維護工作。
