README.md

---
title: TextReplacer
emoji: 📝
colorFrom: indigo
colorTo: blue
sdk: gradio
sdk_version: 5.12.0
app_file: app.py
pinned: false
---

# **TextReplacer：解決中文語音錯音問題的文字修正工具**  

## **為什麼需要 TextReplacer？**  
目前許多中文語音合成系統會錯誤發音，例如：「銀行」可能被讀成「銀型」，「調整」可能被讀成「掉整」。TextReplacer 透過 **Google AI** 解析文本，並內建 **JSON 錯音字字典**，自動將錯音字替換為發音正確的詞語，如「銀行」→「銀 航」，確保語音合成的準確性。  

---

## **功能特色**  
✅ **Google AI 文字解析**（需輸入 API Key），提升詞彙切分與語意理解的準確度。  
✅ **錯音字自動修正**，根據 JSON 字典替換錯誤發音的詞語，確保發音正確，使用者可複製專案後自行擴增內容。  
✅ **靈活詞彙替換**，使用者可自行編輯 JSON 字典，增加或修改替換規則。  
✅ **詳細處理報告**，記錄原文、替換後文本、錯音修正紀錄與處理時間。  

---

## **使用方法**  

### **1. 輸入 Google AI API Key**  
申請 Google AI API Key，啟動程式時輸入，以進行斷詞分析。  

### **2. 輸入 你要修改的文本**  
輸入你要修改的資料，系統會精準斷詞並且替換詞彙。

### **3. 檢視修正報告**  
系統會羅列修正過的內容，請仔細核對比較

---

## **注意事項**  
📌 API Key 務必妥善保管，避免外洩。  
📌 字典油 JSON 格式正確，使用者可自行擴增。  
📌 部分詞彙可能包含多種語意，請謹慎使用。例如：「都會」改成「督會」，但以下情境也會一併改掉：「上完課後，同學們督會使用python寫專案了」。  

---

## **開發者**  
**Howlin Yang**  

**貢獻**  
歡迎提交 Pull Request。  

---

這個版本開頭就清楚說明了問題與解決方案，並且讓功能與步驟更加直觀，避免冗長的技術細節影響可讀性。這樣的改寫符合你的需求嗎？😊