Git Push (觸發(fā) workflow)
  → GitHub Actions 拉取代碼
    → 用 daily-report-agent 分析 git log
      → Agent 調(diào)用 LLM 分類 & 組織語(yǔ)言
        → 生成 Release Note Markdown
          → 自動(dòng)發(fā)布到 GitHub Releases

// cmd/agentd/release.go
package main
import (
    "context"
    "fmt"
    "os"
    "os/exec"
    "strings"
    "time"
    "agent-project/internal/config"
    "agent-project/internal/llm"
)
// GenerateReleaseNote 從 Git 歷史生成 Release Note
func GenerateReleaseNote(cfg *config.Config, fromTag, toTag string) (string, error) {
    // 1. 獲取提交記錄
    commits, err := getGitCommits(fromTag, toTag)
    if err != nil {
        return "", fmt.Errorf("獲取提交記錄失敗: %w", err)
    }
    if len(commits) == 0 {
        return "無(wú)新提交", nil
    }
    // 2. 構(gòu)造 Prompt
    prompt := buildReleaseNotePrompt(commits, fromTag, toTag)
    // 3. 調(diào)用 LLM
    client := llm.NewClient(cfg.LLM)
    resp, err := client.Chat(context.Background(), []llm.Message{
        {
            Role:    "system",
            Content: releaseNoteSystemPrompt,
        },
        {
            Role:    "user",
            Content: prompt,
        },
    })
    if err != nil {
        return "", fmt.Errorf("LLM 調(diào)用失敗: %w", err)
    }
    return resp.Text, nil
}
// getGitCommits 獲取兩個(gè) tag 之間的提交記錄
func getGitCommits(fromTag, toTag string) ([]Commit, error) {
    rangeStr := "HEAD"
    if fromTag != "" && toTag != "" {
        rangeStr = fmt.Sprintf("%s..%s", fromTag, toTag)
    } else if fromTag != "" {
        rangeStr = fmt.Sprintf("%s..HEAD", fromTag)
    }
    cmd := exec.Command("git", "log", rangeStr,
        "--pretty=format:%H|||%an|||%ad|||%s|||%b",
        "--date=short",
    )
    output, err := cmd.Output()
    if err != nil {
        return nil, err
    }
    var commits []Commit
    for _, line := range strings.Split(strings.TrimSpace(string(output)), "\n") {
        if line == "" {
            continue
        }
        parts := strings.SplitN(line, "|||", 5)
        if len(parts) < 4 {
            continue
        }
        body := ""
        if len(parts) == 5 {
            body = parts[4]
        }
        commits = append(commits, Commit{
            Hash:    parts[0][:7],
            Author:  parts[1],
            Date:    parts[2],
            Subject: parts[3],
            Body:    body,
        })
    }
    return commits, nil
}
type Commit struct {
    Hash    string
    Author  string
    Date    string
    Subject string
    Body    string
}
// buildReleaseNotePrompt 構(gòu)造分類 Prompt
func buildReleaseNotePrompt(commits []Commit, fromTag, toTag string) string {
    var sb strings.Builder
    sb.WriteString(fmt.Sprintf("從 %s 到 %s 的變更：\n\n", fromTag, toTag))
    for _, c := range commits {
        sb.WriteString(fmt.Sprintf("- [%s] %s (%s, %s)\n",
            c.Hash, c.Subject, c.Author, c.Date))
        if c.Body != "" {
            // 只取 body 的第一段
            bodyLines := strings.Split(c.Body, "\n\n")
            if len(bodyLines) > 0 {
                sb.WriteString(fmt.Sprintf("  詳情: %s\n", bodyLines[0]))
            }
        }
    }
    sb.WriteString(fmt.Sprintf("\n共 %d 個(gè)提交。請(qǐng)生成 Release Note。", len(commits)))
    return sb.String()
}
const releaseNoteSystemPrompt = `你是一個(gè)開源項(xiàng)目的 Release Manager。
根據(jù) Git 提交記錄生成 Release Note。
分類規(guī)則：
- ?? 新功能：feat 開頭的提交
- ?? Bug 修復(fù)：fix 開頭的提交
- ?? 改進(jìn)：refactor/perf/style 開頭的提交
- ?? 文檔：docs 開頭的提交
- ?? 破壞性變更：有 BREAKING CHANGE 標(biāo)記或明顯不向后兼容的提交
如果不能歸類的，放在 "其他" 里。
格式要求：
- 使用 Markdown
- 每個(gè)條目一行，說(shuō)明變更內(nèi)容，不寫過(guò)程
- 避免 "該同志"、"表現(xiàn)優(yōu)異" 等套話
- 語(yǔ)言：中文
輸出格式：
## ?? 新功能
- xxx
## ?? Bug 修復(fù)
- xxx
## ?? 改進(jìn)
- xxx
## ?? 文檔
- xxx
如有破壞性變更，在開頭加：
> ?? 本版本包含破壞性變更，請(qǐng)謹(jǐn)慎升級(jí)。`

# .github/workflows/release-note.yml
name: Generate Release Note
on:
  push:
    tags:
      - 'v*'         # 推送 v 開頭 tag 時(shí)觸發(fā)
  workflow_dispatch:   # 也支持手動(dòng)觸發(fā)
    inputs:
      from_tag:
        description: '從哪個(gè) tag 開始'
        required: false
      to_tag:
        description: '到哪個(gè) tag'
        required: false
jobs:
  generate-release-note:
    runs-on: ubuntu-latest
    permissions:
      contents: write  # 需要寫權(quán)限來(lái)創(chuàng)建 Release
    steps:
      - name: 拉取代碼
        uses: actions/checkout@v4
        with:
          fetch-depth: 0  # 獲取完整 git 歷史
      - name: 安裝 Go
        uses: actions/setup-go@v5
        with:
          go-version: '1.22'
      - name: 編譯 agent
        run: go build -o agentd ./cmd/agentd
      - name: 確定 tag 范圍
        id: tags
        run: |
          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
            echo "FROM=${{ inputs.from_tag }}" >> $GITHUB_OUTPUT
            echo "TO=${{ inputs.to_tag }}" >> $GITHUB_OUTPUT
          else
            # 自動(dòng)獲?。荷弦淮?tag → 當(dāng)前 tag
            CURRENT_TAG="${{ github.ref_name }}"
            PREV_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
            echo "FROM=${PREV_TAG}" >> $GITHUB_OUTPUT
            echo "TO=${CURRENT_TAG}" >> $GITHUB_OUTPUT
          fi
      - name: 生成 Release Note
        env:
          LLM_API_KEY: ${{ secrets.LLM_API_KEY }}
          LLM_MODEL: deepseek-v4-flash
        run: |
          ./agentd release-note \
            --from "${{ steps.tags.outputs.FROM }}" \
            --to "${{ steps.tags.outputs.TO }}" \
            > release-note.md
      - name: 展示生成的 Release Note
        run: cat release-note.md
      - name: 創(chuàng)建 GitHub Release
        uses: softprops/action-gh-release@v2
        with:
          tag_name: ${{ github.ref_name }}
          body_path: release-note.md
          draft: false
          prerelease: false
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

## ?? 新功能
- 支持多倉(cāng)庫(kù)批量分析，自動(dòng)匯總?cè)請(qǐng)?bào) (#15)
- 新增企業(yè)微信通知渠道，日?qǐng)?bào)直接推送到群 (#18)
## ?? Bug 修復(fù)
- 修復(fù) Git 提交信息中含特殊字符時(shí)解析崩潰的問(wèn)題 (#12)
- 修復(fù)時(shí)區(qū)問(wèn)題導(dǎo)致日?qǐng)?bào)日期差一天 (#14)
## ?? 改進(jìn)
- LLM 調(diào)用增加指數(shù)退避重試，API 超時(shí)自動(dòng)恢復(fù) (#16)
- 日志改用 slog 結(jié)構(gòu)化輸出，方便接入日志平臺(tái) (#17)
## ?? 文檔
- README 新增 Docker Compose 部署說(shuō)明
- 補(bǔ)充 API 文檔和調(diào)用示例

func GenerateMultiRepoReleaseNote(repos []string) (string, error) {
    var allNotes []string
    for _, repo := range repos {
        note, err := GenerateReleaseNoteForRepo(repo)
        if err != nil {
            log.Printf("[Warn] 倉(cāng)庫(kù) %s 生成失敗: %v", repo, err)
            continue
        }
        allNotes = append(allNotes, fmt.Sprintf("### %s\n\n%s", repo, note))
    }
    // 調(diào)一次 LLM 做最終匯總
    return summarizeReleaseNotes(allNotes)
}