@spaceflow/review-summary 0.21.0 → 0.23.0

package/CHANGELOG.md

@@ -1,5 +1,70 @@
 # 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
+
+* **core:** 重构配置 Schema 生成逻辑，使用 SpaceflowConfigSchema 作为基础 ([c73eb1c](https://github.com/Lydanne/spaceflow/commit/c73eb1ce5b6f212b8a932a15224db7e63822f8d0))
+
+### 测试用例
+
+* **review:** 增强 AI 评论识别和过滤功能的测试覆盖 ([bda706b](https://github.com/Lydanne/spaceflow/commit/bda706b99aab113521afe6bcd386a590811e20a6))
+
+### 其他修改
+
+* **core:** released version 0.19.0 [no ci] ([c8bfe6b](https://github.com/Lydanne/spaceflow/commit/c8bfe6ba20893e2c3cd383ed7e7d3217b0492eb6))
+* **publish:** released version 0.43.0 [no ci] ([1074b9c](https://github.com/Lydanne/spaceflow/commit/1074b9c5fb21a447093ef23300c451d790710b33))
+* **review:** released version 0.51.0 [no ci] ([c93be78](https://github.com/Lydanne/spaceflow/commit/c93be78f6f1df9cb5e3515cee58cda65cad1b00f))
+* **review:** released version 0.52.0 [no ci] ([c86406f](https://github.com/Lydanne/spaceflow/commit/c86406f6934d5de4f198eadff66ee6c3f7cfbe0d))
+* **review:** released version 0.53.0 [no ci] ([5a6af03](https://github.com/Lydanne/spaceflow/commit/5a6af03c260060ac1b1901bb7273f501ca0037c7))
+* **review:** 移除 .spaceflow 目录及其配置文件 ([64b310d](https://github.com/Lydanne/spaceflow/commit/64b310d8a77614a259a8d7588a09169626efb3ae))
+* **scripts:** released version 0.20.0 [no ci] ([e1fac49](https://github.com/Lydanne/spaceflow/commit/e1fac49257bf4a5902c5884ec0e054384a7859d6))
+* **shell:** released version 0.20.0 [no ci] ([8b69b53](https://github.com/Lydanne/spaceflow/commit/8b69b5340fe99973add2bea3e7d53f2082d0da54))
+
 ## [0.20.0](https://github.com/Lydanne/spaceflow/compare/@spaceflow/review-summary@0.19.0...@spaceflow/review-summary@0.20.0) (2026-02-27)
 
 ### 新特性

package/package.json

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

package/src/review-summary.service.ts

@@ -1,6 +1,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 { writeFileSync } from "fs";
 import { join } from "path";
 import type {
@@ -11,24 +12,52 @@ import type {
   UserStats,
   OutputTarget,
   TimePreset,
+  WeightedScoreWeights,
+  CommitBasedWeights,
+  IssueBasedWeights,
+  DefectRateWeights,
+  ReviewSummaryConfig,
+  ScoreStrategy,
 } from "./types";
 
-/** 分数权重配置 */
-const SCORE_WEIGHTS = {
-  /** 每个 PR 的基础分 */
+/** 加权模式默认权重 */
+const DEFAULT_WEIGHTED_WEIGHTS: Required<WeightedScoreWeights> = {
   prBase: 10,
-  /** 每 100 行新增代码的分数 */
   additionsPer100: 2,
-  /** 每 100 行删除代码的分数 */
   deletionsPer100: 1,
-  /** 每个变更文件的分数 */
   changedFile: 0.5,
-  /** 每个未修复问题的扣分 */
   issueDeduction: 3,
-  /** 每个已修复问题的加分 */
   fixedBonus: 1,
 };
 
+/** 分数累计模式默认权重 */
+const DEFAULT_COMMIT_BASED_WEIGHTS: Required<CommitBasedWeights> = {
+  validCommit: 5,
+  errorDeduction: 2,
+  warnDeduction: 1,
+  errorFixedBonus: 1,
+  warnFixedBonus: 0.5,
+  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,
+};
+
 /**
  * 周期统计服务
  */
@@ -55,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];
@@ -140,7 +169,8 @@ export class PeriodSummaryService {
     } catch {
       // 如果获取文件失败，使用默认值
     }
-    const { issueCount, fixedCount } = await this.extractIssueStats(owner, repo, pr.number!);
+    const issueStats = await this.extractIssueStats(owner, repo, pr.number!);
+    const validCommitCount = await this.countValidCommits(owner, repo, pr.number!);
     return {
       number: pr.number!,
       title: pr.title ?? "",
@@ -149,8 +179,8 @@ export class PeriodSummaryService {
       additions,
       deletions,
       changedFiles,
-      issueCount,
-      fixedCount,
+      ...issueStats,
+      validCommitCount,
       description: this.extractDescription(pr),
     };
   }
@@ -162,31 +192,125 @@ export class PeriodSummaryService {
     owner: string,
     repo: string,
     prNumber: number,
-  ): Promise<{ issueCount: number; fixedCount: number }> {
+  ): Promise<{
+    issueCount: number;
+    fixedCount: number;
+    errorCount: number;
+    warnCount: number;
+    fixedErrors: number;
+    fixedWarns: number;
+  }> {
+    const empty = { issueCount: 0, fixedCount: 0, errorCount: 0, warnCount: 0, fixedErrors: 0, fixedWarns: 0 };
     try {
       const comments = await this.gitProvider.listIssueComments(owner, repo, prNumber);
-      let issueCount = 0;
-      let fixedCount = 0;
+      // 优先从 review 模块嵌入的结构化数据中精确提取
+      const formatter = new MarkdownFormatter();
       for (const comment of comments) {
         const body = comment.body ?? "";
-        const issueMatch = body.match(/发现\s*(\d+)\s*个问题/);
-        if (issueMatch) {
-          issueCount = Math.max(issueCount, parseInt(issueMatch[1], 10));
-        }
-        const fixedMatch = body.match(/已修复[：:]\s*(\d+)/);
-        if (fixedMatch) {
-          fixedCount = Math.max(fixedCount, parseInt(fixedMatch[1], 10));
+        const parsed = formatter.parse(body);
+        if (parsed?.result?.issues) {
+          return this.computeIssueStatsFromReviewIssues(parsed.result.issues);
         }
-        const statsMatch = body.match(/🔴\s*(\d+).*🟡\s*(\d+)/);
-        if (statsMatch) {
-          const errorCount = parseInt(statsMatch[1], 10);
-          const warnCount = parseInt(statsMatch[2], 10);
-          issueCount = Math.max(issueCount, errorCount + warnCount);
+      }
+      // 回退：没有结构化数据时，从评论文本正则提取（兼容旧数据）
+      return this.extractIssueStatsFromText(comments);
+    } catch {
+      return empty;
+    }
+  }
+
+  /**
+   * 从 ReviewIssue 列表中精确计算各类问题统计
+   */
+  protected computeIssueStatsFromReviewIssues(issues: ReviewIssue[]): {
+    issueCount: number;
+    fixedCount: number;
+    errorCount: number;
+    warnCount: number;
+    fixedErrors: number;
+    fixedWarns: number;
+  } {
+    const errorCount = issues.filter((i) => i.severity === "error").length;
+    const warnCount = issues.filter((i) => i.severity === "warn").length;
+    const fixedErrors = issues.filter((i) => i.severity === "error" && i.fixed).length;
+    const fixedWarns = issues.filter((i) => i.severity === "warn" && i.fixed).length;
+    return {
+      issueCount: issues.length,
+      fixedCount: fixedErrors + fixedWarns,
+      errorCount,
+      warnCount,
+      fixedErrors,
+      fixedWarns,
+    };
+  }
+
+  /**
+   * 回退：从评论文本正则提取问题统计（兼容无结构化数据的旧评论）
+   */
+  protected extractIssueStatsFromText(
+    comments: { body?: string }[],
+  ): {
+    issueCount: number;
+    fixedCount: number;
+    errorCount: number;
+    warnCount: number;
+    fixedErrors: number;
+    fixedWarns: number;
+  } {
+    let issueCount = 0;
+    let fixedCount = 0;
+    let errorCount = 0;
+    let warnCount = 0;
+    for (const comment of comments) {
+      const body = comment.body ?? "";
+      const issueMatch = body.match(/发现\s*(\d+)\s*个问题/);
+      if (issueMatch) {
+        issueCount = Math.max(issueCount, parseInt(issueMatch[1], 10));
+      }
+      const fixedMatch = body.match(/已修复[：:]\s*(\d+)/);
+      if (fixedMatch) {
+        fixedCount = Math.max(fixedCount, parseInt(fixedMatch[1], 10));
+      }
+      const statsMatch = body.match(/🔴\s*(\d+).*🟡\s*(\d+)/);
+      if (statsMatch) {
+        errorCount = Math.max(errorCount, parseInt(statsMatch[1], 10));
+        warnCount = Math.max(warnCount, parseInt(statsMatch[2], 10));
+        issueCount = Math.max(issueCount, errorCount + warnCount);
+      }
+    }
+    // 文本模式无法区分修复类型，统一设为 0
+    return { issueCount, fixedCount, errorCount, warnCount, fixedErrors: 0, fixedWarns: 0 };
+  }
+
+  /**
+   * 统计 PR 中有效 commit 数量（逐 commit 获取行数判断）
+   */
+  protected async countValidCommits(owner: string, repo: string, prNumber: number): Promise<number> {
+    const config = this.getStrategyConfig();
+    const minLines = config.commitBasedWeights?.minCommitLines ?? DEFAULT_COMMIT_BASED_WEIGHTS.minCommitLines;
+    try {
+      const commits = await this.gitProvider.getPullRequestCommits(owner, repo, prNumber);
+      let validCount = 0;
+      for (const commit of commits) {
+        if (!commit.sha) continue;
+        // 跳过 merge commit（commit message 以 "Merge" 开头）
+        if (commit.commit?.message?.startsWith("Merge")) continue;
+        try {
+          const commitInfo = await this.gitProvider.getCommit(owner, repo, commit.sha);
+          const totalLines = (commitInfo.files ?? []).reduce(
+            (sum, file) => sum + (file.additions ?? 0) + (file.deletions ?? 0),
+            0,
+          );
+          if (totalLines >= minLines) {
+            validCount++;
+          }
+        } catch {
+          // 获取单个 commit 失败，跳过
         }
       }
-      return { issueCount, fixedCount };
+      return validCount;
     } catch {
-      return { issueCount: 0, fixedCount: 0 };
+      return 0;
     }
   }
 
@@ -216,6 +340,11 @@ export class PeriodSummaryService {
           totalChangedFiles: 0,
           totalIssues: 0,
           totalFixed: 0,
+          totalErrors: 0,
+          totalWarns: 0,
+          totalFixedErrors: 0,
+          totalFixedWarns: 0,
+          totalValidCommits: 0,
           score: 0,
           features: [],
           prs: [],
@@ -228,37 +357,157 @@ export class PeriodSummaryService {
       userStats.totalChangedFiles += pr.changedFiles;
       userStats.totalIssues += pr.issueCount;
       userStats.totalFixed += pr.fixedCount;
+      userStats.totalErrors += pr.errorCount;
+      userStats.totalWarns += pr.warnCount;
+      userStats.totalFixedErrors += pr.fixedErrors;
+      userStats.totalFixedWarns += pr.fixedWarns;
+      userStats.totalValidCommits += pr.validCommitCount;
       if (pr.description) {
         userStats.features.push(pr.description);
       }
       userStats.prs.push(pr);
     }
+    this.applyScoreStrategy(userMap);
+    return userMap;
+  }
+
+  /**
+   * 获取当前评分策略配置
+   */
+  protected getStrategyConfig(): ReviewSummaryConfig {
+    try {
+      return this.config.get<ReviewSummaryConfig>("review-summary") ?? {};
+    } catch {
+      return {};
+    }
+  }
+
+  /**
+   * 根据配置的策略计算所有用户的分数
+   */
+  protected applyScoreStrategy(userMap: Map<string, UserStats>): void {
+    const config = this.getStrategyConfig();
+    const strategy: ScoreStrategy = config.strategy ?? "weighted";
     for (const userStats of userMap.values()) {
-      userStats.score = this.calculateScore(userStats);
+      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;
+        case "weighted":
+        default:
+          userStats.score = this.calculateWeightedScore(userStats, config);
+          break;
+      }
     }
-    return userMap;
   }
 
   /**
-   * 计算用户综合分数
+   * 加权模式：计算用户综合分数
    */
-  protected calculateScore(stats: UserStats): number {
-    const prScore = stats.prCount * SCORE_WEIGHTS.prBase;
-    const additionsScore = (stats.totalAdditions / 100) * SCORE_WEIGHTS.additionsPer100;
-    const deletionsScore = (stats.totalDeletions / 100) * SCORE_WEIGHTS.deletionsPer100;
-    const filesScore = stats.totalChangedFiles * SCORE_WEIGHTS.changedFile;
+  protected calculateWeightedScore(stats: UserStats, config: ReviewSummaryConfig): number {
+    const weights = { ...DEFAULT_WEIGHTED_WEIGHTS, ...config.scoreWeights };
+    const prScore = stats.prCount * weights.prBase;
+    const additionsScore = (stats.totalAdditions / 100) * weights.additionsPer100;
+    const deletionsScore = (stats.totalDeletions / 100) * weights.deletionsPer100;
+    const filesScore = stats.totalChangedFiles * weights.changedFile;
     const unfixedIssues = stats.totalIssues - stats.totalFixed;
-    const issueDeduction = unfixedIssues * SCORE_WEIGHTS.issueDeduction;
-    const fixedBonus = stats.totalFixed * SCORE_WEIGHTS.fixedBonus;
+    const issueDeduction = unfixedIssues * weights.issueDeduction;
+    const fixedBonus = stats.totalFixed * weights.fixedBonus;
     const totalScore =
       prScore + additionsScore + deletionsScore + filesScore - issueDeduction + fixedBonus;
     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 扣分
+   */
+  protected calculateCommitBasedScore(stats: UserStats, config: ReviewSummaryConfig): number {
+    const weights = { ...DEFAULT_COMMIT_BASED_WEIGHTS, ...config.commitBasedWeights };
+    const commitScore = stats.totalValidCommits * weights.validCommit;
+    const errorDeduction = stats.totalErrors * weights.errorDeduction;
+    const warnDeduction = stats.totalWarns * weights.warnDeduction;
+    const fixedBonus =
+      stats.totalFixedErrors * weights.errorFixedBonus +
+      stats.totalFixedWarns * weights.warnFixedBonus;
+    const totalScore = commitScore - errorDeduction - warnDeduction + fixedBonus;
+    return Math.max(0, Math.round(totalScore * 10) / 10);
+  }
+
   /**
    * 按分数排序用户统计
    */
   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);
   }
 
@@ -393,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),
@@ -412,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);
     });
@@ -445,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("");
@@ -497,9 +771,12 @@ export class PeriodSummaryService {
     content: string,
   ): Promise<{ type: OutputTarget; location: string }> {
     const title = `📊 周期统计报告: ${result.period.since} ~ ${result.period.until}`;
+    const config = this.getStrategyConfig();
+    const labelName = config.issueLabel ?? "report";
     const issue: Issue = await this.gitProvider.createIssue(context.owner, context.repo, {
       title,
       body: content,
+      labels: [labelName],
     });
     const location = issue.html_url ?? `#${issue.number}`;
     if (shouldLog(context.verbose, 1)) {

package/src/types.ts

@@ -71,6 +71,16 @@ export interface PrStats {
   issueCount: number;
   /** 已修复的问题数 */
   fixedCount: number;
+  /** error 级别问题数 */
+  errorCount: number;
+  /** warn 级别问题数 */
+  warnCount: number;
+  /** 已修复的 error 问题数 */
+  fixedErrors: number;
+  /** 已修复的 warn 问题数 */
+  fixedWarns: number;
+  /** 有效 commit 数（单个 commit 新增+删除 >= minCommitLines 行） */
+  validCommitCount: number;
   /** PR 描述/功能摘要 */
   description: string;
 }
@@ -91,14 +101,108 @@ export interface UserStats {
   totalIssues: number;
   /** 总已修复问题数 */
   totalFixed: number;
+  /** 总 error 级别问题数 */
+  totalErrors: number;
+  /** 总 warn 级别问题数 */
+  totalWarns: number;
+  /** 总已修复 error 数 */
+  totalFixedErrors: number;
+  /** 总已修复 warn 数 */
+  totalFixedWarns: number;
+  /** 总有效 commit 数 */
+  totalValidCommits: number;
   /** 综合分数 */
   score: number;
+  /** 缺陷率（0-100），0 表示零缺陷，100 表示全部违规，仅 defect-rate 策略时填充 */
+  defectRate?: number;
   /** 功能摘要列表 */
   features: string[];
   /** 该用户的 PR 列表 */
   prs: PrStats[];
 }
 
+/** 评分策略类型 */
+export type ScoreStrategy = "weighted" | "commit-based" | "issue-based" | "defect-rate";
+
+/** 加权模式权重配置 */
+export interface WeightedScoreWeights {
+  /** 每个 PR 的基础分，默认 10 */
+  prBase?: number;
+  /** 每 100 行新增代码的分数，默认 2 */
+  additionsPer100?: number;
+  /** 每 100 行删除代码的分数，默认 1 */
+  deletionsPer100?: number;
+  /** 每个变更文件的分数，默认 0.5 */
+  changedFile?: number;
+  /** 每个未修复问题的扣分，默认 3 */
+  issueDeduction?: number;
+  /** 每个已修复问题的加分，默认 1 */
+  fixedBonus?: number;
+}
+
+/** 分数累计模式权重配置 */
+export interface CommitBasedWeights {
+  /** 每个有效 commit 的加分，默认 5 */
+  validCommit?: number;
+  /** 每个 error 问题的扣分，默认 2 */
+  errorDeduction?: number;
+  /** 每个 warn 问题的扣分，默认 1 */
+  warnDeduction?: number;
+  /** 修复一个 error 问题的加分，默认为 errorDeduction 的一半（1） */
+  errorFixedBonus?: number;
+  /** 修复一个 warn 问题的加分，默认为 warnDeduction 的一半（0.5） */
+  warnFixedBonus?: number;
+  /** 有效 commit 的最低代码行数（新增+删除），默认 5 */
+  minCommitLines?: number;
+}
+
+/** @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" */
+  strategy?: ScoreStrategy;
+  /** 加权模式权重配置（strategy 为 "weighted" 时生效） */
+  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;
+}
+
 /** 周期统计结果 */
 export interface PeriodSummaryResult {
   /** 统计周期 */