mcp-feedback-enhanced/RELEASE_NOTES

發佈說明管理系統

此目錄包含了所有版本的結構化發佈說明，支援多語言，採用雙重架構來兼顧統一的更新日誌檢視和自動化發佈功能。

📁 資料夾結構

RELEASE_NOTES/
├── README.md                  # 此說明文檔
├── template.md               # 發佈說明模板
├── CHANGELOG.en.md           # 完整更新歷史（英文）
├── CHANGELOG.zh-TW.md        # 完整更新歷史（繁體中文）
├── CHANGELOG.zh-CN.md        # 完整更新歷史（簡體中文）
├── v2.2.1/                   # 版本特定資料夾（供 GitHub Actions 使用）
│   ├── en.md                 # 英文發佈說明
│   ├── zh-TW.md              # 繁體中文發佈說明
│   └── zh-CN.md              # 簡體中文發佈說明
├── v2.2.0/
│   ├── en.md
│   ├── zh-TW.md
│   └── zh-CN.md
└── ...                       # 其他版本

🔄 雙重架構優勢

📖 CHANGELOG 檔案

• 完整歷史檢視: 用戶可在單一檔案查看所有版本更新
• 便於搜尋: 快速找到特定功能的引入版本
• GitHub 顯示友好: 更新歷史在專案主頁直接可見

📁 版本資料夾

• 自動化友好: GitHub Actions 可精確提取特定版本內容
• 維護簡便: 新版本只需建立新資料夾，無需修改大檔案
• 工具整合: 各種自動化工具容易解析單一版本檔案

🤖 GitHub Actions 整合

GitHub Actions 工作流程會自動執行：

1. 版本檢測: 從 git 標籤檢測要發佈的版本
2. 發佈說明提取: 從 RELEASE_NOTES/vX.Y.Z/ 提取對應的發佈說明
3. 多語言組合: 將所有語言版本組合成結構化的發佈內容
4. GitHub Release 發佈: 將格式化的發佈說明發佈到 GitHub Releases
5. CHANGELOG 同步: 自動將新版本內容更新到統一的 CHANGELOG 檔案

📝 撰寫發佈說明

新版本發佈：

1. 建立版本資料夾: 為每個版本建立新資料夾（例如 v2.2.1/）
2. 添加語言檔案: 為每種語言添加發佈說明（en.md、zh-TW.md、zh-CN.md）
3. 遵循模板: 依照 template.md 中的模板結構
4. 更新 CHANGELOG: 將新版本內容添加到各個 CHANGELOG 檔案的頂部
5. 一致格式: 在各語言中使用一致的表情符號和格式

維護作業：

• 版本資料夾: 供 GitHub Actions 自動化發佈使用
• CHANGELOG 檔案: 為用戶和文檔提供統一檢視
• 模板: 參考 template.md 確保結構一致

🔧 格式指南

• 表情符號一致性: 為不同類型的變更使用一致的表情符號前綴
• 簡潔描述: 保持項目符號簡潔但具描述性
• 問題引用: 在適當的地方包含問題引用（例如 fixes #10）
• 平行結構: 在所有語言中保持平行結構
• 時間順序: 在 CHANGELOG 檔案中將最新版本放在頂部