docs: 新增 git 分支整理計劃

記錄分支清理策略和最終架構：
- 基於穩定節點 99677fc 建立乾淨的 main 分支
- 清理所有混亂的開發分支
- 建立簡潔的版本管理結構

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

git分支整理計劃.md

@@ -0,0 +1,114 @@
+# Git 分支整理和 GitHub 推送計劃
+
+## 🎯 目標
+整理混亂的 git 分支結構，建立清晰的版本管理策略，安全推送到 GitHub。
+
+## 📊 當前分支狀況分析
+
+### 現有分支
+- `main` - 原始主分支
+- `feature/non-speech-improvements` - 移除例句口說功能的乾淨分支
+- `backup/before-review-cleanup` - 清理前的備份
+- `backup/speech-feature-complete` - 完整語音功能備份（包含錯誤處理改進）
+- `feature/integrate-navigation-system` - 導航系統功能
+
+### 當前狀態
+- **HEAD**: detached at `99677fc`（穩定的文檔節點）
+- **工作目錄**: 乾淨
+- **問題**: 不在任何分支上，分支結構混亂
+
+## 🏗️ 分支整理策略
+
+### 階段1：建立穩定主線
+```bash
+# 基於穩定節點創建新的主分支
+git checkout 99677fc
+git checkout -b main-stable
+
+# 這將成為推送到 GitHub 的穩定版本
+```
+
+**特色**：
+- ✅ 基於最穩定的文檔節點 `99677fc`
+- ✅ 不包含有問題的功能
+- ✅ 適合作為生產環境基礎
+
+### 階段2：保存開發工作
+```bash
+# 確保語音錯誤處理的開發工作被正確保存
+git checkout backup/speech-feature-complete
+git checkout -b feature/speech-enhancement-wip
+
+# 標記為 Work In Progress
+```
+
+**特色**：
+- 🚧 包含 `feat: 完成語音錯誤處理改進和音頻數據恢復策略`
+- 🚧 標記為開發中，將來可以修復和完善
+- 🔄 保留完整的開發歷史
+
+### 階段3：功能分支管理
+```bash
+# 檢查並清理功能分支
+git branch -d feature/non-speech-improvements  # 如果不需要的話
+git checkout main-stable
+git checkout -b feature/api-config-unification  # 如果要繼續配置統一工作
+```
+
+## 📤 推送到 GitHub 策略
+
+### 推送計劃
+1. **主穩定分支** → `main-stable`
+2. **功能開發分支** → `feature/speech-enhancement-wip`
+3. **完整備份分支** → `backup/speech-feature-complete`
+
+### 分支命名規範
+- `main-stable`: 穩定的主開發分支
+- `feature/*`: 功能開發分支
+- `backup/*`: 備份和保護分支
+- `wip/*`: 開發中的實驗性分支
+
+## ✅ 推薦的執行順序
+
+### Step 1: 建立穩定基線
+```bash
+git checkout 99677fc
+git checkout -b main-stable
+```
+
+### Step 2: 推送穩定版本
+```bash
+git push -u origin main-stable
+```
+
+### Step 3: 整理並推送備份
+```bash
+git push origin backup/speech-feature-complete
+```
+
+### Step 4: 建立清晰的開發環境
+- 從 `main-stable` 開始新的功能開發
+- 將語音功能的修復留待將來專門處理
+
+## 🎨 最終分支架構
+
+```
+main-stable (穩定基線)
+├── feature/api-config-unification (配置統一 - 可選)
+├── feature/speech-enhancement-wip (語音功能 WIP)
+└── backup/speech-feature-complete (完整備份)
+```
+
+## 💡 好處
+
+1. **清晰的版本管理**：每個分支都有明確的用途
+2. **穩定性保證**：主分支基於最穩定的節點
+3. **開發工作保護**：所有開發成果都被妥善保存
+4. **將來可擴展**：可以輕鬆從任何節點開始新的開發
+5. **GitHub 友好**：推送到 GitHub 後結構清晰易懂
+
+## ⚠️ 注意事項
+
+- 語音功能的開發工作完全保留，只是標記為 WIP
+- 穩定版本不包含任何有問題的功能
+- 所有重要的開發歷史都被保護