feat(ci): add JUnit XML test results and Codecov test analysis integration

[bot0419]

[Enhancement] #12 - 增加 JUnit XML 測試結果輸出與 Codecov 測試分析整合 工作報告

任務：為 SubX-CLI 專案增加 JUnit XML 格式的測試結果輸出功能，並整合 Codecov 測試分析服務
類型：Enhancement
狀態：已完成

一、任務概述

為 SubX-CLI 專案增加 JUnit XML 格式的測試結果輸出功能，並整合 Codecov 測試分析服務，以提供更完整的測試報告和失敗測試分析能力。此功能將幫助開發者更好地追蹤測試狀態、分析失敗原因，並識別不穩定的測試案例。

二、實作內容

2.1 nextest JUnit XML 配置

• 為 ci profile 增加 JUnit XML 輸出配置【F:.config/nextest.toml†L26-L30】
• 設定輸出路徑為 junit.xml，儲存所有測試的詳細輸出

2.2 更新 .gitignore

• 新增 JUnit XML 測試結果檔案忽略規則【F:.gitignore†L13-L15】

2.3 GitHub Actions 工作流程更新

• 在 test job 中新增測試結果上傳到 Codecov【F:.github/workflows/build-test-audit-coverage.yml†L67-L73】
• 在 coverage job 中新增測試結果上傳到 Codecov【F:.github/workflows/build-test-audit-coverage.yml†L115-L121】
• 使用 if: ${{ always() }} 確保失敗時也上傳結果
• 為不同平台設定不同的 flags 以便區分

2.4 更新文檔

• 在測試指南中新增 JUnit XML 相關說明【F:docs/testing-guidelines.md†L688-L706】

三、技術細節

3.1 架構變更

• nextest CI profile 自動生成 JUnit XML 格式測試結果
• 測試結果檔案位置：target/nextest/ci/junit.xml

3.2 API 變更

• 無對外 API 變更，僅為 CI/CD 流程增強

3.3 配置變更

• nextest 配置新增 CI profile 的 JUnit 輸出設定
• GitHub Actions 新增 Codecov 測試結果上傳步驟

四、測試與驗證

4.1 程式碼品質檢查

cargo fmt
cargo clippy -- -D warnings
timeout 240 scripts/quality_check.sh -v

4.2 功能測試

• 本地測試 nextest JUnit XML 輸出功能
• 驗證 JUnit XML 檔案格式正確性
• 確認包含完整測試資訊（1845 行內容）

4.3 CI 工作流程測試

• 設定正確的檔案路徑 target/nextest/ci/junit.xml
• 使用 codecov/test-results-action@v1 上傳測試結果

五、影響評估

5.1 向後相容性

• 不影響現有功能，僅為 CI 環境新增測試報告功能

5.2 使用者體驗

• 開發者可在 Codecov UI 中查看測試分析資料
• PR 評論將包含失敗測試的詳細資訊（如有）
• 測試運行時間和失敗率統計可視化

六、問題與解決方案

6.1 遇到的問題

• 問題描述：nextest 預設將 JUnit XML 檔案輸出到 target/nextest/{profile}/ 目錄
• 解決方案：更新 GitHub Actions 工作流程使用正確的檔案路徑

6.2 技術債務

• 無新的技術債務

七、後續事項

7.1 待完成項目

• 監控 Codecov 測試分析功能的資料品質
• 根據測試分析結果優化不穩定的測試

7.2 相關任務

• 增加 JUnit XML 測試結果輸出與 Codecov 測試分析整合 #12

7.3 建議的下一步

• 觀察 CI 執行情況，確保測試結果正確上傳到 Codecov
• 利用 Codecov 測試分析功能識別效能瓶頸和不穩定測試

八、檔案異動清單

檔案路徑	異動類型	描述
.config/nextest.toml	修改	新增 CI profile JUnit XML 輸出配置
.gitignore	修改	新增 JUnit XML 檔案忽略規則
.github/workflows/build-test-audit-coverage.yml	修改	新增 Codecov 測試結果上傳步驟
docs/testing-guidelines.md	修改	新增 JUnit XML 說明文檔

九、預期效益

9.1 開發體驗改善

• 結構化的測試報告提供更好的測試可見性
• 失敗測試的詳細資訊幫助快速問題定位
• 長期測試健康度追蹤支援趨勢分析

9.2 CI/CD 流程增強

• 自動化測試分析無需手動檢查測試日誌
• 智能重試機制可識別已知不穩定測試
• 測試運行時間追蹤有助於效能監控

Resolves #12

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

📢 Thoughts on this report? Let us know!