@spaceflow/review-summary 0.22.0 → 0.23.0

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # Changelog
 
+## [0.22.0](https://github.com/Lydanne/spaceflow/compare/@spaceflow/review-summary@0.21.0...@spaceflow/review-summary@0.22.0) (2026-03-02)
+
+### 新特性
+
+* **core:** Gitea适配器支持通过标签名称创建Issue ([cf10eda](https://github.com/Lydanne/spaceflow/commit/cf10eda5d025c560cc0d8e3826dad40716020d5c))
+* **review-summary:** commit-based 评分新增修复问题加分机制，支持从 review 模块精确提取问题统计 ([304bf81](https://github.com/Lydanne/spaceflow/commit/304bf81ab475b280ab5f4011159bc697861bddf6))
+* **review-summary:** 支持为周期统计报告 Issue 配置自定义标签 ([df1cc61](https://github.com/Lydanne/spaceflow/commit/df1cc61167851ff7106104914319f43f73ba8902))
+* **review-summary:** 支持通过配置文件自定义评分权重 ([53e1a37](https://github.com/Lydanne/spaceflow/commit/53e1a371288aea6ceac63b03fda99eea1739be4b))
+* **review-summary:** 新增 commit-based 评分策略，支持按有效 commit 累计计分 ([111c0d6](https://github.com/Lydanne/spaceflow/commit/111c0d6b9d87d12096e0edb69a11eceff55b79c1))
+* **review:** 为行级评论 Review 添加统计信息摘要 ([58d5b37](https://github.com/Lydanne/spaceflow/commit/58d5b37ba54daa24bd2f8396318fedc87f388c74))
+* **review:** 优化问题统计展示，按 severity 分级显示 error/warn 数量 ([bcb2608](https://github.com/Lydanne/spaceflow/commit/bcb26086589a67e815db075f3001209904572926))
+* **review:** 保留历史行级评论，为每轮 Review 生成独立评论并添加上轮回顾 ([de431a0](https://github.com/Lydanne/spaceflow/commit/de431a09b4e3b5e1ada9ee5f1ee65786d22b6ff9))
+* **review:** 支持用户手动 resolve 评论并在报告中区分 AI 修复与手动解决 ([c968b65](https://github.com/Lydanne/spaceflow/commit/c968b65c850bc68de3f4409aa3b5294e5a0311ff))
+* **review:** 新增 MCP 工具支持从目录批量加载代码审查规则 ([289a836](https://github.com/Lydanne/spaceflow/commit/289a83650f1e222482fcbaaa69fb5ea562c5a4c2))
+* **review:** 新增解决率统计指标，区分修复率和解决率的计算维度 ([436541f](https://github.com/Lydanne/spaceflow/commit/436541fce605319da562445a81242a8feb257df9))
+
+### 修复BUG
+
+* **review:** 修复率计算仅统计 AI 修复的问题，排除手动解决的问题 ([12b3415](https://github.com/Lydanne/spaceflow/commit/12b3415749c9d8523e8b23365fbb39fc7657ff1d))
+* **review:** 修正 PR 评论标题中的 emoji 显示问题 ([bcdc946](https://github.com/Lydanne/spaceflow/commit/bcdc9467bf7970c9acd3ea00303bcae5eaff131f))
+
+### 代码重构
+
+* **review:** 抽取规则加载和问题验证逻辑为独立方法，优化代码复用性 ([7ea02ba](https://github.com/Lydanne/spaceflow/commit/7ea02ba86e369bc130c69c561195634072cc060a))
+
+### 文档更新
+
+* **docs:** 为 review-summary 命令文档补充 Issue 输出配置说明 ([196fa94](https://github.com/Lydanne/spaceflow/commit/196fa94ad1ed2dbadbdcb332ef26cf1fe7fcd8d7))
+* **review-summary:** 完善文档，新增时间预设、评分算法及输出示例说明 ([fb04685](https://github.com/Lydanne/spaceflow/commit/fb04685dde4157f0a1a2f8edaf1fb3c125280e27))
+* **review:** 完善 review 命令文档，新增审查流程、多轮审查、问题生命周期等核心机制说明 ([d6b2a20](https://github.com/Lydanne/spaceflow/commit/d6b2a20802ab98e5ddb01937c0fe8b268c403c6f))
+
+### 其他修改
+
+* **core:** released version 0.20.0 [no ci] ([b7ed239](https://github.com/Lydanne/spaceflow/commit/b7ed239455244cd96f2b59ef67886dd0bfc057a8))
+* **publish:** released version 0.44.0 [no ci] ([5b29159](https://github.com/Lydanne/spaceflow/commit/5b29159b2f0129d2ce81329cf48734d3d56b226e))
+* **review:** released version 0.54.0 [no ci] ([252269a](https://github.com/Lydanne/spaceflow/commit/252269a299f9e580b858e04814e7d9a13fed7736))
+* **review:** released version 0.55.0 [no ci] ([0245743](https://github.com/Lydanne/spaceflow/commit/02457439788dd70925b91118f7d5936a61d0e0de))
+* **review:** released version 0.56.0 [no ci] ([2481dec](https://github.com/Lydanne/spaceflow/commit/2481dec141b0d5f444b5815ab9598378ac3e0b12))
+* **review:** released version 0.57.0 [no ci] ([238a831](https://github.com/Lydanne/spaceflow/commit/238a83165fa1810a9429b8d6a66a1f75c477ce22))
+* **scripts:** released version 0.21.0 [no ci] ([1f0a213](https://github.com/Lydanne/spaceflow/commit/1f0a2139d155807451dc968de8213bafe2e4edb8))
+* **scripts:** released version 0.22.0 [no ci] ([f482504](https://github.com/Lydanne/spaceflow/commit/f48250486906016b414a7b00aabac342c1399045))
+* **shell:** released version 0.21.0 [no ci] ([b619af7](https://github.com/Lydanne/spaceflow/commit/b619af741e16053868a2eedd41f56d50134954d8))
+* **shell:** released version 0.22.0 [no ci] ([e716369](https://github.com/Lydanne/spaceflow/commit/e716369f57bfa20e710d354245c54d3a80e701f4))
+
 ## [0.21.0](https://github.com/Lydanne/spaceflow/compare/@spaceflow/review-summary@0.20.0...@spaceflow/review-summary@0.21.0) (2026-03-02)
 
 ### 修复BUG

package/package.json

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

package/src/review-summary.service.ts

@@ -14,6 +14,8 @@ import type {
   TimePreset,
   WeightedScoreWeights,
   CommitBasedWeights,
+  IssueBasedWeights,
+  DefectRateWeights,
   ReviewSummaryConfig,
   ScoreStrategy,
 } from "./types";
@@ -38,6 +40,24 @@ const DEFAULT_COMMIT_BASED_WEIGHTS: Required<CommitBasedWeights> = {
   minCommitLines: 5,
 };
 
+/** issue-based 模式默认权重 */
+const DEFAULT_ISSUE_BASED_WEIGHTS: Required<IssueBasedWeights> = {
+  minBase: 60,
+  maxBase: 100,
+  capLines: 1000,
+  errorDeduction: 8,
+  warnDeduction: 3,
+  errorFixedBonus: 5,
+  warnFixedBonus: 2,
+};
+
+/** defect-rate 模式默认权重 */
+const DEFAULT_DEFECT_RATE_WEIGHTS: Required<DefectRateWeights> = {
+  errorPenalty: 0.3,
+  warnPenalty: 0.1,
+  fixedDiscount: 0.05,
+};
+
 /**
  * 周期统计服务
  */
@@ -64,7 +84,7 @@ export class PeriodSummaryService {
       const ciConf = this.config.get<CiConfig>("ci");
       const repository = ciConf?.repository;
       if (!repository) {
-        throw new Error("缺少仓库配置，请通过 --repository 参数或环境变量 GITHUB_REPOSITORY 指定");
+        throw new Error("缺少仓库配置，请通过 --repository 参数或环境变量 GITHUB_REPOSITORY / GITEA_REPOSITORY 指定");
       }
       const parts = repository.split("/");
       owner = parts[0];
@@ -370,6 +390,15 @@ export class PeriodSummaryService {
     const strategy: ScoreStrategy = config.strategy ?? "weighted";
     for (const userStats of userMap.values()) {
       switch (strategy) {
+        case "defect-rate": {
+          const rate = this.calculateDefectRate(userStats, config);
+          userStats.defectRate = rate;
+          userStats.score = Math.round((100 - rate) * 10) / 10;
+          break;
+        }
+        case "issue-based":
+          userStats.score = this.calculateIssueBasedScore(userStats, config);
+          break;
         case "commit-based":
           userStats.score = this.calculateCommitBasedScore(userStats, config);
           break;
@@ -398,6 +427,62 @@ export class PeriodSummaryService {
     return Math.max(0, Math.round(totalScore * 10) / 10);
   }
 
+  /**
+   * issue-based 模式：逐 PR 计算基础分(对数缩放) + 问题扣分/修复加分
+   */
+  protected calculateIssueBasedScore(stats: UserStats, config: ReviewSummaryConfig): number {
+    const weights = { ...DEFAULT_ISSUE_BASED_WEIGHTS, ...config.issueBasedWeights };
+    let totalScore = 0;
+    for (const pr of stats.prs) {
+      const baseScore = this.calculatePrBaseScore(
+        pr.additions + pr.deletions,
+        weights.minBase,
+        weights.maxBase,
+        weights.capLines,
+      );
+      const deduction =
+        pr.errorCount * weights.errorDeduction + pr.warnCount * weights.warnDeduction;
+      const bonus =
+        pr.fixedErrors * weights.errorFixedBonus + pr.fixedWarns * weights.warnFixedBonus;
+      totalScore += Math.max(0, baseScore - deduction + bonus);
+    }
+    return Math.round(totalScore * 10) / 10;
+  }
+
+  /**
+   * 计算单个 PR 的基础分（对数缩放，映射到 [minBase, maxBase] 区间）
+   */
+  protected calculatePrBaseScore(
+    totalLines: number,
+    minBase: number,
+    maxBase: number,
+    capLines: number,
+  ): number {
+    if (totalLines <= 0) return minBase;
+    const ratio = Math.min(1, Math.log2(1 + totalLines) / Math.log2(1 + capLines));
+    return minBase + (maxBase - minBase) * ratio;
+  }
+
+  /**
+   * defect-rate 模式：基于问题密度（每百行代码）计算缺陷率
+   */
+  protected calculateDefectRate(stats: UserStats, config: ReviewSummaryConfig): number {
+    const weights = { ...DEFAULT_DEFECT_RATE_WEIGHTS, ...config.defectRateWeights };
+    if (stats.prs.length === 0) return 0;
+    let complianceSum = 0;
+    for (const pr of stats.prs) {
+      const totalLines = pr.additions + pr.deletions;
+      const per100 = Math.max(1, totalLines / 100);
+      const penalty =
+        (pr.errorCount * weights.errorPenalty + pr.warnCount * weights.warnPenalty) / per100;
+      const recovery = (pr.fixedErrors + pr.fixedWarns) * weights.fixedDiscount;
+      const compliance = Math.min(1, Math.max(0, 1 - penalty + recovery));
+      complianceSum += compliance;
+    }
+    const avgCompliance = complianceSum / stats.prs.length;
+    return Math.round((1 - avgCompliance) * 1000) / 10;
+  }
+
   /**
    * 分数累计模式：按有效 commit 加分，按 error/warn 扣分
    */
@@ -417,6 +502,12 @@ export class PeriodSummaryService {
    * 按分数排序用户统计
    */
   protected sortUserStats(userMap: Map<string, UserStats>): UserStats[] {
+    const config = this.getStrategyConfig();
+    if (config.strategy === "defect-rate") {
+      return Array.from(userMap.values()).sort(
+        (a, b) => (a.defectRate ?? 0) - (b.defectRate ?? 0),
+      );
+    }
     return Array.from(userMap.values()).sort((a, b) => b.score - a.score);
   }
 
@@ -551,18 +642,32 @@ export class PeriodSummaryService {
     lines.push("");
     lines.push(`🏆 贡献者排名`);
     lines.push(`${"─".repeat(60)}`);
-    const header = [
-      "排名".padEnd(4),
-      "用户".padEnd(15),
-      "PR数".padStart(5),
-      "新增".padStart(8),
-      "删除".padStart(8),
-      "问题".padStart(5),
-      "分数".padStart(8),
-    ].join(" │ ");
+    const isDefectRate = result.userStats.some((u) => u.defectRate !== undefined);
+    const header = isDefectRate
+      ? [
+          "排名".padEnd(4),
+          "用户".padEnd(15),
+          "PR数".padStart(5),
+          "新增".padStart(8),
+          "删除".padStart(8),
+          "问题".padStart(5),
+          "缺陷率".padStart(8),
+        ].join(" │ ")
+      : [
+          "排名".padEnd(4),
+          "用户".padEnd(15),
+          "PR数".padStart(5),
+          "新增".padStart(8),
+          "删除".padStart(8),
+          "问题".padStart(5),
+          "分数".padStart(8),
+        ].join(" │ ");
     lines.push(header);
     lines.push("─".repeat(60));
     result.userStats.forEach((user, index) => {
+      const lastCol = isDefectRate
+        ? `${(user.defectRate ?? 0).toFixed(1)}%`.padStart(8)
+        : user.score.toFixed(1).padStart(8);
       const row = [
         `#${index + 1}`.padEnd(4),
         user.username.slice(0, 15).padEnd(15),
@@ -570,7 +675,7 @@ export class PeriodSummaryService {
         `+${user.totalAdditions}`.padStart(8),
         `-${user.totalDeletions}`.padStart(8),
         String(user.totalIssues).padStart(5),
-        user.score.toFixed(1).padStart(8),
+        lastCol,
       ].join(" │ ");
       lines.push(row);
     });
@@ -603,13 +708,24 @@ export class PeriodSummaryService {
     lines.push("");
     lines.push(`## 🏆 贡献者排名`);
     lines.push("");
-    lines.push(`| 排名 | 用户 | PR数 | 新增 | 删除 | 问题 | 分数 |`);
-    lines.push(`|------|------|------|------|------|------|------|`);
-    result.userStats.forEach((user, index) => {
-      lines.push(
-        `| #${index + 1} | ${user.username} | ${user.prCount} | +${user.totalAdditions} | -${user.totalDeletions} | ${user.totalIssues} | ${user.score.toFixed(1)} |`,
-      );
-    });
+    const isDefectRate = result.userStats.some((u) => u.defectRate !== undefined);
+    if (isDefectRate) {
+      lines.push(`| 排名 | 用户 | PR数 | 新增 | 删除 | 问题 | 缺陷率 |`);
+      lines.push(`|------|------|------|------|------|------|--------|`);
+      result.userStats.forEach((user, index) => {
+        lines.push(
+          `| #${index + 1} | ${user.username} | ${user.prCount} | +${user.totalAdditions} | -${user.totalDeletions} | ${user.totalIssues} | ${(user.defectRate ?? 0).toFixed(1)}% |`,
+        );
+      });
+    } else {
+      lines.push(`| 排名 | 用户 | PR数 | 新增 | 删除 | 问题 | 分数 |`);
+      lines.push(`|------|------|------|------|------|------|------|`);
+      result.userStats.forEach((user, index) => {
+        lines.push(
+          `| #${index + 1} | ${user.username} | ${user.prCount} | +${user.totalAdditions} | -${user.totalDeletions} | ${user.totalIssues} | ${user.score.toFixed(1)} |`,
+        );
+      });
+    }
     lines.push("");
     lines.push(`## 📋 功能摘要`);
     lines.push("");

package/src/types.ts

@@ -113,6 +113,8 @@ export interface UserStats {
   totalValidCommits: number;
   /** 综合分数 */
   score: number;
+  /** 缺陷率（0-100），0 表示零缺陷，100 表示全部违规，仅 defect-rate 策略时填充 */
+  defectRate?: number;
   /** 功能摘要列表 */
   features: string[];
   /** 该用户的 PR 列表 */
@@ -120,7 +122,7 @@ export interface UserStats {
 }
 
 /** 评分策略类型 */
-export type ScoreStrategy = "weighted" | "commit-based";
+export type ScoreStrategy = "weighted" | "commit-based" | "issue-based" | "defect-rate";
 
 /** 加权模式权重配置 */
 export interface WeightedScoreWeights {
@@ -157,6 +159,34 @@ export interface CommitBasedWeights {
 /** @deprecated 使用 WeightedScoreWeights 代替 */
 export type ScoreWeights = WeightedScoreWeights;
 
+/** issue-based 模式权重配置 */
+export interface IssueBasedWeights {
+  /** PR 基础分下限，默认 60 */
+  minBase?: number;
+  /** PR 基础分上限，默认 100 */
+  maxBase?: number;
+  /** 代码量封顶行数（additions + deletions），超过此值基础分为 maxBase，默认 1000 */
+  capLines?: number;
+  /** 每个 error 问题的扣分，默认 8 */
+  errorDeduction?: number;
+  /** 每个 warn 问题的扣分，默认 3 */
+  warnDeduction?: number;
+  /** 修复一个 error 问题的加分，默认 5 */
+  errorFixedBonus?: number;
+  /** 修复一个 warn 问题的加分，默认 2 */
+  warnFixedBonus?: number;
+}
+
+/** defect-rate 模式权重配置 */
+export interface DefectRateWeights {
+  /** 每百行代码 1 个 error 降低的合规度，默认 0.3 */
+  errorPenalty?: number;
+  /** 每百行代码 1 个 warn 降低的合规度，默认 0.1 */
+  warnPenalty?: number;
+  /** 修复 1 个问题恢复的合规度，默认 0.05 */
+  fixedDiscount?: number;
+}
+
 /** review-summary 扩展配置 */
 export interface ReviewSummaryConfig {
   /** 评分策略，默认 "weighted" */
@@ -165,6 +195,10 @@ export interface ReviewSummaryConfig {
   scoreWeights?: WeightedScoreWeights;
   /** 分数累计模式权重配置（strategy 为 "commit-based" 时生效） */
   commitBasedWeights?: CommitBasedWeights;
+  /** issue-based 模式权重配置（strategy 为 "issue-based" 时生效） */
+  issueBasedWeights?: IssueBasedWeights;
+  /** defect-rate 模式权重配置（strategy 为 "defect-rate" 时生效） */
+  defectRateWeights?: DefectRateWeights;
   /** 创建 Issue 时添加的标签名称，默认 "report" */
   issueLabel?: string;
 }