@spaceflow/review-summary 0.23.0 → 0.24.0

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## [0.23.0](https://github.com/Lydanne/spaceflow/compare/@spaceflow/review-summary@0.22.0...@spaceflow/review-summary@0.23.0) (2026-03-02)
+
+### 新特性
+
+* **actions:** 增强对 Gitea 平台的环境变量支持 ([21ba3da](https://github.com/Lydanne/spaceflow/commit/21ba3daa182083ecaec0113de91caf2ab1068000))
+* **actions:** 支持 Gitea 作为 Git Provider ([4c88b36](https://github.com/Lydanne/spaceflow/commit/4c88b36d97ab49a322bac571385b0e57029676ff))
+* **core:** 增强对 Gitea 平台的支持并修复类型转换 ([bfbb45c](https://github.com/Lydanne/spaceflow/commit/bfbb45c521035c80f0e81f5572d5aa1b554405f7))
+* **publish:** 支持 Gitea 环境变量作为 CI 配置来源 ([cd1ba77](https://github.com/Lydanne/spaceflow/commit/cd1ba778617731ef85f9851883122175a99d72ac))
+* **review-summary:** 新增 defect-rate 缺陷率评分策略 ([2777f4d](https://github.com/Lydanne/spaceflow/commit/2777f4da6d364cbc801792f4fa7ac6323da5e1bc))
+* **review-summary:** 新增 issue-based 评分策略并更新文档 ([b6d923e](https://github.com/Lydanne/spaceflow/commit/b6d923e060aafd0b298a39d6fdc3e2f76facf1f3))
+* **review:** 支持从 Gitea Actions 事件文件解析 PR 编号 ([09e2e58](https://github.com/Lydanne/spaceflow/commit/09e2e58d84f773b8a3184feb73b90cb110993ebd))
+
+### 文档更新
+
+* **docs:** 更新 review-summary 命令的 CI 配置示例 ([8b2b2c5](https://github.com/Lydanne/spaceflow/commit/8b2b2c55ed497619cbb91bd4fd2e5124b6f5ac37))
+* **docs:** 更新 review-summary 命令的 CI 集成示例 ([60c5b70](https://github.com/Lydanne/spaceflow/commit/60c5b70695aa6a4c9cae1e3936670b34d5486792))
+* **docs:** 更新环境变量参考文档，增加 GitLab 支持并优化 Gitea 说明 ([a02f8e0](https://github.com/Lydanne/spaceflow/commit/a02f8e0309368334bc77a331f65338435657eddb))
+* **review-summary:** 更新错误信息以支持 Gitea 环境变量 ([cd02818](https://github.com/Lydanne/spaceflow/commit/cd028183fe7e14d993566e8dc49849b07d2540d9))
+* **scripts:** 更新错误信息以支持 Gitea 环境变量 ([9a9d7f2](https://github.com/Lydanne/spaceflow/commit/9a9d7f20a63bea4cc13d284ed41bc9c4f4aa6595))
+* **shell:** 更新错误信息以支持 Gitea 环境变量 ([72c51d7](https://github.com/Lydanne/spaceflow/commit/72c51d792c140d44d8aa3cb05666de72d170a185))
+* 修复 GitHub Actions 配置示例的 Markdown 渲染问题 ([01daec5](https://github.com/Lydanne/spaceflow/commit/01daec551f2e23ab70357f88b7789897922064a7))
+
+### 测试用例
+
+* **core:** 修复测试用例中的导入和模拟函数实现 ([0137d4b](https://github.com/Lydanne/spaceflow/commit/0137d4b400f272ce7f7ba74fc5b37fcc453ed717))
+
+### 其他修改
+
+* **core:** released version 0.21.0 [no ci] ([7fa4381](https://github.com/Lydanne/spaceflow/commit/7fa438124cc27316ad5f37d5cbacc848ebd3b9df))
+* **publish:** released version 0.45.0 [no ci] ([9bd3bbe](https://github.com/Lydanne/spaceflow/commit/9bd3bbe725a3362f762a1407c6a92a993359dfe5))
+* **review:** released version 0.58.0 [no ci] ([790dc5f](https://github.com/Lydanne/spaceflow/commit/790dc5f4b38eba28df6f6e4414dd9c536d5a6377))
+* **scripts:** released version 0.23.0 [no ci] ([2f18d22](https://github.com/Lydanne/spaceflow/commit/2f18d2274e83b65ce006dceed47a985942c8dd1d))
+* **shell:** released version 0.23.0 [no ci] ([0668aa9](https://github.com/Lydanne/spaceflow/commit/0668aa97671ca235509bef547503c301237324f9))
+
 ## [0.22.0](https://github.com/Lydanne/spaceflow/compare/@spaceflow/review-summary@0.21.0...@spaceflow/review-summary@0.22.0) (2026-03-02)
 
 ### 新特性

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spaceflow/review-summary",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "Spaceflow 审查统计命令，根据时间范围统计 PR 贡献情况，按人员汇总并排序",
   "license": "MIT",
   "author": "Lydanne",
@@ -15,9 +15,11 @@
   "type": "module",
   "main": "./dist/index.js",
   "dependencies": {
+    "micromatch": "^4.0.8",
     "@spaceflow/review": "0.58.0"
   },
   "devDependencies": {
+    "@types/micromatch": "^4.0.9",
     "@types/node": "^22.15.0",
     "@spaceflow/cli": "0.38.0"
   },

package/src/review-summary.service.ts

@@ -2,6 +2,7 @@ import { GitProviderService, shouldLog, normalizeVerbose } from "@spaceflow/core
 import type { IConfigReader } from "@spaceflow/core";
 import type { PullRequest, Issue, CiConfig } from "@spaceflow/core";
 import { MarkdownFormatter, type ReviewIssue } from "@spaceflow/review";
+import micromatch from "micromatch";
 import { writeFileSync } from "fs";
 import { join } from "path";
 import type {
@@ -159,8 +160,13 @@ export class PeriodSummaryService {
     let additions = 0;
     let deletions = 0;
     let changedFiles = 0;
+    const includes = this.resolveIncludes();
     try {
-      const files = await this.gitProvider.getPullRequestFiles(owner, repo, pr.number!);
+      const allFiles = await this.gitProvider.getPullRequestFiles(owner, repo, pr.number!);
+      const files =
+        includes.length > 0
+          ? allFiles.filter((f) => micromatch.isMatch(f.filename ?? "", includes, { matchBase: true }))
+          : allFiles;
       changedFiles = files.length;
       for (const file of files) {
         additions += file.additions ?? 0;
@@ -371,6 +377,22 @@ export class PeriodSummaryService {
     return userMap;
   }
 
+  /**
+   * 解析文件过滤 glob 模式：优先使用 review-summary.includes，fallback 到 review.includes
+   */
+  protected resolveIncludes(): string[] {
+    const config = this.getStrategyConfig();
+    if (config.includes && config.includes.length > 0) {
+      return config.includes;
+    }
+    try {
+      const reviewConfig = this.config.get<{ includes?: string[] }>("review");
+      return reviewConfig?.includes ?? [];
+    } catch {
+      return [];
+    }
+  }
+
   /**
    * 获取当前评分策略配置
    */
@@ -470,7 +492,10 @@ export class PeriodSummaryService {
     const weights = { ...DEFAULT_DEFECT_RATE_WEIGHTS, ...config.defectRateWeights };
     if (stats.prs.length === 0) return 0;
     let complianceSum = 0;
+    let counted = 0;
     for (const pr of stats.prs) {
+      // 跳过 merge PR（标题以 "Merge" 开头），合并操作不纳入缺陷率统计
+      if (pr.title.startsWith("Merge")) continue;
       const totalLines = pr.additions + pr.deletions;
       const per100 = Math.max(1, totalLines / 100);
       const penalty =
@@ -478,8 +503,10 @@ export class PeriodSummaryService {
       const recovery = (pr.fixedErrors + pr.fixedWarns) * weights.fixedDiscount;
       const compliance = Math.min(1, Math.max(0, 1 - penalty + recovery));
       complianceSum += compliance;
+      counted++;
     }
-    const avgCompliance = complianceSum / stats.prs.length;
+    if (counted === 0) return 0;
+    const avgCompliance = complianceSum / counted;
     return Math.round((1 - avgCompliance) * 1000) / 10;
   }
 

package/src/types.ts

@@ -191,6 +191,8 @@ export interface DefectRateWeights {
 export interface ReviewSummaryConfig {
   /** 评分策略，默认 "weighted" */
   strategy?: ScoreStrategy;
+  /** 文件过滤 glob 模式，未设置时 fallback 读取 review.includes，支持 ! 排除模式 */
+  includes?: string[];
   /** 加权模式权重配置（strategy 为 "weighted" 时生效） */
   scoreWeights?: WeightedScoreWeights;
   /** 分数累计模式权重配置（strategy 为 "commit-based" 时生效） */