114 lines
3.3 KiB
Markdown
114 lines
3.3 KiB
Markdown
# 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
|
||
- 穩定版本不包含任何有問題的功能
|
||
- 所有重要的開發歷史都被保護 |