@spaceflow/review 0.30.0 → 0.31.0

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # Changelog
 
+## [0.30.0](https://github.com/Lydanne/spaceflow/compare/@spaceflow/review@0.29.3...@spaceflow/review@0.30.0) (2026-02-16)
+
+### 新特性
+
+* **ci-scripts:** 迁移到新架构格式 ([5df3630](https://github.com/Lydanne/spaceflow/commit/5df3630208894e6543d34f9985fcf0f612a78d7e))
+* **ci-shell:** 迁移到新架构格式 ([b7d92fd](https://github.com/Lydanne/spaceflow/commit/b7d92fd5f83e9a5e8edeb0ce4971b19190078a7f))
+* **cli:** 修复 commander.js 集成问题 ([8e6aeca](https://github.com/Lydanne/spaceflow/commit/8e6aecadb06e6168050371ec5da3b0a3c40d51c2))
+* **cli:** 阶段3 - 创建新 CLI 架构基础 ([deeaf0d](https://github.com/Lydanne/spaceflow/commit/deeaf0dfeedb3e8c9a8f30fcd05c37e9db18cb55))
+* **core:** 阶段2 - 去除核心服务的 NestJS 装饰器 ([684ec07](https://github.com/Lydanne/spaceflow/commit/684ec0723a90383a6c5fb84fc9198d8b908a89d8))
+* **period-summary:** 迁移到新架构格式 ([b6c7a92](https://github.com/Lydanne/spaceflow/commit/b6c7a927963c84349637884e8fab37d550daa91f))
+* **publish:** 迁移到新架构格式 ([5df49a8](https://github.com/Lydanne/spaceflow/commit/5df49a8b3df6906e7ff65fd2a3bae4ee5ef31bc5))
+* **review:** 迁移到新架构格式 ([6bda477](https://github.com/Lydanne/spaceflow/commit/6bda4773eed9cdbc82593ee29888d1d2cce6efef))
+
+### 修复BUG
+
+* 修复 ReviewSpecService 构造函数调用，传入 gitProvider 参数 ([747b87e](https://github.com/Lydanne/spaceflow/commit/747b87e7e4621b8976c6444e0350e71600c20801))
+* 修复 StorageServiceOptions 类型错误 ([0bd2820](https://github.com/Lydanne/spaceflow/commit/0bd2820af594f2f30473e57ba4843197e3e7a2ff))
+* 修复 TypeScript 编译配置 ([8c3a4f1](https://github.com/Lydanne/spaceflow/commit/8c3a4f148ccbd5598fb553608f4832ec6a4dc40b))
+* 修复扩展 tsconfig.json 中的路径错误 ([ff42b24](https://github.com/Lydanne/spaceflow/commit/ff42b244645128b1c31714e6e6cf6c71fa4bbc80))
+* 清理 list.service.ts 中的 NestJS 依赖 ([f483bc1](https://github.com/Lydanne/spaceflow/commit/f483bc1edcaf472acf2bdc38902d992840d004c8))
+* 清理命令服务中的 NestJS 依赖 ([a5ca870](https://github.com/Lydanne/spaceflow/commit/a5ca870782eaf4117ecc4f58a689e001df34ce5e))
+* 清理命令服务中的 NestJS 依赖 ([2bebe2a](https://github.com/Lydanne/spaceflow/commit/2bebe2ab23367d661706368c37c01bc6360e5e36))
+
+### 代码重构
+
+* 使用 ciConfig 函数替代配置读取，简化 CI 配置获取 ([9356752](https://github.com/Lydanne/spaceflow/commit/93567520181a95398f36413a68e8334342d01e51))
+* 删除不再使用的 cli.module.ts ([5b86cb2](https://github.com/Lydanne/spaceflow/commit/5b86cb21d0b55aa4ed8934a51c7bba88f3892ece))
+* 删除所有不再使用的 .module.ts 文件 ([7049a59](https://github.com/Lydanne/spaceflow/commit/7049a59fca05906e163a58a2bc1ad64b51dbccf1))
+* 增强 MCP 工具收集的日志输出 ([e889c2b](https://github.com/Lydanne/spaceflow/commit/e889c2bad0c2dba833905299af2cb4a76126ed0e))
+* 实现 MCP 工具收集和 Inspector 模式支持 ([0702d83](https://github.com/Lydanne/spaceflow/commit/0702d83791e9836ed54576b6d3d373a0fc5085b4))
+* 支持 verbose 计数选项，实现 -vvv 累加级别 ([42ab32d](https://github.com/Lydanne/spaceflow/commit/42ab32dbbf42cff1774d27a1ba2fedab02f33038))
+* 清理 NestJS 依赖和模块文件 ([3efe7d7](https://github.com/Lydanne/spaceflow/commit/3efe7d7555746f93737d91508b06a0061ba2295f))
+* 清理剩余的 NestJS 依赖 ([a3104b3](https://github.com/Lydanne/spaceflow/commit/a3104b36cecb0c93bc839472dba63b88e71bb662))
+* 移除 dtoToJsonSchema 中的 class-validator 元数据推断逻辑 ([0dd1c8e](https://github.com/Lydanne/spaceflow/commit/0dd1c8e1424e1de57ca40b8e317f3bad00d08e7d))
+* 移除 MonorepoService 中的 NestJS 依赖 ([c6a3243](https://github.com/Lydanne/spaceflow/commit/c6a32439da97efb287239e16723f4cb982bdf208))
+* 移除测试文件中的 NestJS 依赖，改用直接实例化 ([325f2e3](https://github.com/Lydanne/spaceflow/commit/325f2e36b434ebb4e471c17b5e2ef2f9a4db2456))
+* 简化 list 命令，只显示外部扩展 ([babcb24](https://github.com/Lydanne/spaceflow/commit/babcb245f527c427103726e290ff889444c1e8da))
+* 统一配置管理，支持环境变量自动合并 ([f6b09a3](https://github.com/Lydanne/spaceflow/commit/f6b09a35c273f1f96f5a07546f2bf58ceb6942f6))
+* 迁移 ci-scripts、ci-shell、publish、review 扩展到新架构 ([4630116](https://github.com/Lydanne/spaceflow/commit/4630116c96699a6a3c36aa439badaa3567cc4c06))
+* 重构服务容器为懒加载依赖注入架构 ([c74a346](https://github.com/Lydanne/spaceflow/commit/c74a346ef27540836b06a8fd825283155722d4af))
+
+### 文档更新
+
+* **architecture:** 添加 Spaceflow 架构重设计方案 v2 ([21b252c](https://github.com/Lydanne/spaceflow/commit/21b252c97aaf4561cc5837b68229356e5ffa8d36))
+
+### 其他修改
+
+* **ci-scripts:** released version 0.20.0 [no ci] ([ed8d88d](https://github.com/Lydanne/spaceflow/commit/ed8d88df09c7d119df092793e4c83d451d67a6b8))
+* **ci-shell:** released version 0.20.0 [no ci] ([5109d94](https://github.com/Lydanne/spaceflow/commit/5109d944bfbd95596e71d6e11e56d3e3599f8297))
+* **cli:** released version 0.20.0 [no ci] ([7cb015c](https://github.com/Lydanne/spaceflow/commit/7cb015c9fba3b9b4a8a170f66597505300e35e10))
+* **core:** released version 0.2.0 [no ci] ([6176e7e](https://github.com/Lydanne/spaceflow/commit/6176e7e5755dd594dee7d4e0016dfb89b391d824))
+* **period-summary:** released version 0.20.0 [no ci] ([54feb4a](https://github.com/Lydanne/spaceflow/commit/54feb4adaf0d72d402287bef84fd9433db673ed6))
+* **publish:** released version 0.22.0 [no ci] ([2e39f34](https://github.com/Lydanne/spaceflow/commit/2e39f347c514490be5da690c896849fc6dbfd513))
+
 ## [0.29.3](https://github.com/Lydanne/spaceflow/compare/@spaceflow/review@0.29.2...@spaceflow/review@0.29.3) (2026-02-16)
 
 ### 修复BUG

package/dist/index.js

@@ -1,4 +1,4 @@
-import { LlmJsonPut, addLocaleResources, calculateNewLineNumber, createStreamLoggerState, defineExtension, logStreamEvent, normalizeVerbose, parallel, parseChangedLinesFromPatch, parseDiffText, parseHunksFromPatch, parseRepoUrl, parseVerbose, shouldLog, t, z } from "@spaceflow/core";
+import { LlmJsonPut, REVIEW_STATE, addLocaleResources, calculateNewLineNumber, createStreamLoggerState, defineExtension, logStreamEvent, normalizeVerbose, parallel, parseChangedLinesFromPatch, parseDiffText, parseHunksFromPatch, parseRepoUrl, parseVerbose, shouldLog, t, z } from "@spaceflow/core";
 import { basename, dirname, extname, isAbsolute, join, relative } from "path";
 import { execSync, spawn } from "child_process";
 import { access, mkdir, readFile, readdir, writeFile } from "fs/promises";
@@ -143,9 +143,9 @@ __webpack_require__.d(__webpack_exports__, {
 ;// CONCATENATED MODULE: external "@spaceflow/core"
 
 ;// CONCATENATED MODULE: ./src/locales/zh-cn/review.json
-var review_namespaceObject = JSON.parse('{"description":"代码审查命令，使用 LLM 对 PR 代码进行自动审查","options.dryRun":"仅打印将要执行的操作，不实际提交评论","options.prNumber":"PR 编号，如果不指定则从环境变量获取","options.base":"基准分支/tag，用于比较差异","options.head":"目标分支/tag，用于比较差异","options.includes":"要审查的文件 glob 模式，如 *.ts *.js（可多次指定）","options.llmMode":"使用的 LLM 模式: claude-code, openai, gemini","options.files":"仅审查指定的文件（空格分隔）","options.commits":"仅审查指定的 commits（空格分隔）","options.verifyFixes":"是否验证历史问题是否已修复（默认从配置文件读取）","options.noVerifyFixes":"禁用历史问题验证","options.verifyConcurrency":"验证历史问题的并发数（默认 10）","options.analyzeDeletions":"分析删除代码可能带来的影响 (true, false, ci, pr, terminal)","options.deletionAnalysisMode":"删除代码分析模式: openai (标准模式) 或 claude-code (Agent 模式，可使用工具)","options.deletionOnly":"仅执行删除代码分析，跳过常规代码审查","options.outputFormat":"输出格式: markdown, terminal, json。不指定则智能选择（PR 用 markdown，终端用 terminal）","options.generateDescription":"使用 AI 生成 PR 功能描述","options.showAll":"显示所有发现的问题，不过滤非变更行的问题","options.eventAction":"PR 事件类型（opened, synchronize, closed 等），closed 时仅收集统计不进行 AI 审查","extensionDescription":"代码审查命令，使用 LLM 对 PR 代码进行自动审查","mcp.serverDescription":"代码审查规则查询服务","mcp.listRules":"获取当前项目的所有代码审查规则，返回规则列表包含 ID、标题、描述、适用的文件扩展名等信息","mcp.getRulesForFile":"获取某个文件应该使用的代码审查规则，根据文件扩展名和 includes 配置过滤","mcp.getRuleDetail":"获取某个规则的完整详情，包括描述、示例代码等","mcp.ruleNotFound":"规则 {{ruleId}} 不存在","mcp.dto.cwd":"项目根目录路径，默认为当前工作目录","mcp.dto.filePath":"文件路径，可以是相对路径或绝对路径","mcp.dto.includeExamples":"是否包含规则示例代码，默认 false","mcp.dto.ruleId":"规则 ID，如 JsTs.Naming.FileName"}')
+var review_namespaceObject = JSON.parse('{"description":"代码审查命令，使用 LLM 对 PR 代码进行自动审查","options.dryRun":"仅打印将要执行的操作，不实际提交评论","options.prNumber":"PR 编号，如果不指定则从环境变量获取","options.base":"基准分支/tag，用于比较差异","options.head":"目标分支/tag，用于比较差异","options.includes":"要审查的文件 glob 模式，如 *.ts *.js（可多次指定）","options.llmMode":"使用的 LLM 模式: claude-code, openai, gemini","options.files":"仅审查指定的文件（空格分隔）","options.commits":"仅审查指定的 commits（空格分隔）","options.verifyFixes":"是否验证历史问题是否已修复（默认从配置文件读取）","options.noVerifyFixes":"禁用历史问题验证","options.verifyConcurrency":"验证历史问题的并发数（默认 10）","options.analyzeDeletions":"分析删除代码可能带来的影响 (true, false, ci, pr, terminal)","options.deletionAnalysisMode":"删除代码分析模式: openai (标准模式) 或 claude-code (Agent 模式，可使用工具)","options.deletionOnly":"仅执行删除代码分析，跳过常规代码审查","options.outputFormat":"输出格式: markdown, terminal, json。不指定则智能选择（PR 用 markdown，终端用 terminal）","options.generateDescription":"使用 AI 生成 PR 功能描述","options.showAll":"显示所有发现的问题，不过滤非变更行的问题","options.flush":"仅刷新状态（同步 reactions、resolved conversations、replies），不执行 LLM 审查","options.eventAction":"PR 事件类型（opened, synchronize, closed 等），closed 时仅收集统计不进行 AI 审查","extensionDescription":"代码审查命令，使用 LLM 对 PR 代码进行自动审查","mcp.serverDescription":"代码审查规则查询服务","mcp.listRules":"获取当前项目的所有代码审查规则，返回规则列表包含 ID、标题、描述、适用的文件扩展名等信息","mcp.getRulesForFile":"获取某个文件应该使用的代码审查规则，根据文件扩展名和 includes 配置过滤","mcp.getRuleDetail":"获取某个规则的完整详情，包括描述、示例代码等","mcp.ruleNotFound":"规则 {{ruleId}} 不存在","mcp.dto.cwd":"项目根目录路径，默认为当前工作目录","mcp.dto.filePath":"文件路径，可以是相对路径或绝对路径","mcp.dto.includeExamples":"是否包含规则示例代码，默认 false","mcp.dto.ruleId":"规则 ID，如 JsTs.Naming.FileName"}')
 ;// CONCATENATED MODULE: ./src/locales/en/review.json
-var en_review_namespaceObject = JSON.parse('{"description":"Code review command using LLM for automated PR review","options.dryRun":"Only print actions without posting comments","options.prNumber":"PR number, auto-detected from env if not specified","options.base":"Base branch/tag for diff comparison","options.head":"Head branch/tag for diff comparison","options.includes":"File glob patterns to review, e.g. *.ts *.js (can be specified multiple times)","options.llmMode":"LLM mode: claude-code, openai, gemini","options.files":"Only review specified files (space-separated)","options.commits":"Only review specified commits (space-separated)","options.verifyFixes":"Verify if historical issues are fixed (default from config)","options.noVerifyFixes":"Disable historical issue verification","options.verifyConcurrency":"Concurrency for verifying historical issues (default 10)","options.analyzeDeletions":"Analyze impact of deleted code (true, false, ci, pr, terminal)","options.deletionAnalysisMode":"Deletion analysis mode: openai (standard) or claude-code (Agent mode with tools)","options.deletionOnly":"Only run deletion analysis, skip regular code review","options.outputFormat":"Output format: markdown, terminal, json. Auto-selected if not specified (markdown for PR, terminal for CLI)","options.generateDescription":"Generate PR description using AI","options.showAll":"Show all issues found, including those on unchanged lines","options.eventAction":"PR event type (opened, synchronize, closed, etc.), closed only collects stats without AI review","extensionDescription":"Code review command using LLM for automated PR review","mcp.serverDescription":"Code review rules query service","mcp.listRules":"List all code review rules for the current project, returning rule list with ID, title, description, applicable file extensions, etc.","mcp.getRulesForFile":"Get applicable code review rules for a specific file, filtered by file extension and includes configuration","mcp.getRuleDetail":"Get full details of a specific rule, including description, example code, etc.","mcp.ruleNotFound":"Rule {{ruleId}} not found","mcp.dto.cwd":"Project root directory path, defaults to current working directory","mcp.dto.filePath":"File path, can be relative or absolute","mcp.dto.includeExamples":"Whether to include rule example code, defaults to false","mcp.dto.ruleId":"Rule ID, e.g. JsTs.Naming.FileName"}')
+var en_review_namespaceObject = JSON.parse('{"description":"Code review command using LLM for automated PR review","options.dryRun":"Only print actions without posting comments","options.prNumber":"PR number, auto-detected from env if not specified","options.base":"Base branch/tag for diff comparison","options.head":"Head branch/tag for diff comparison","options.includes":"File glob patterns to review, e.g. *.ts *.js (can be specified multiple times)","options.llmMode":"LLM mode: claude-code, openai, gemini","options.files":"Only review specified files (space-separated)","options.commits":"Only review specified commits (space-separated)","options.verifyFixes":"Verify if historical issues are fixed (default from config)","options.noVerifyFixes":"Disable historical issue verification","options.verifyConcurrency":"Concurrency for verifying historical issues (default 10)","options.analyzeDeletions":"Analyze impact of deleted code (true, false, ci, pr, terminal)","options.deletionAnalysisMode":"Deletion analysis mode: openai (standard) or claude-code (Agent mode with tools)","options.deletionOnly":"Only run deletion analysis, skip regular code review","options.outputFormat":"Output format: markdown, terminal, json. Auto-selected if not specified (markdown for PR, terminal for CLI)","options.generateDescription":"Generate PR description using AI","options.showAll":"Show all issues found, including those on unchanged lines","options.flush":"Only sync status (reactions, resolved conversations, replies), skip LLM review","options.eventAction":"PR event type (opened, synchronize, closed, etc.), closed only collects stats without AI review","extensionDescription":"Code review command using LLM for automated PR review","mcp.serverDescription":"Code review rules query service","mcp.listRules":"List all code review rules for the current project, returning rule list with ID, title, description, applicable file extensions, etc.","mcp.getRulesForFile":"Get applicable code review rules for a specific file, filtered by file extension and includes configuration","mcp.getRuleDetail":"Get full details of a specific rule, including description, example code, etc.","mcp.ruleNotFound":"Rule {{ruleId}} not found","mcp.dto.cwd":"Project root directory path, defaults to current working directory","mcp.dto.filePath":"File path, can be relative or absolute","mcp.dto.includeExamples":"Whether to include rule example code, defaults to false","mcp.dto.ruleId":"Rule ID, e.g. JsTs.Naming.FileName"}')
 ;// CONCATENATED MODULE: ./src/locales/index.ts
 
 
@@ -939,6 +939,7 @@ function parseAnalyzeDeletionsValue(value) {
 
 
 const REVIEW_COMMENT_MARKER = "<!-- spaceflow-review -->";
+const REVIEW_LINE_COMMENTS_MARKER = "<!-- spaceflow-review-lines -->";
 const REVIEW_SCHEMA = {
     type: "object",
     properties: {
@@ -1147,6 +1148,7 @@ class ReviewService {
             retryDelay: options.retryDelay ?? reviewConf.retryDelay ?? 1000,
             generateDescription: options.generateDescription ?? reviewConf.generateDescription ?? false,
             showAll: options.showAll ?? false,
+            flush: options.flush ?? false,
             eventAction: options.eventAction
         };
     }
@@ -1229,8 +1231,8 @@ class ReviewService {
         if (deletionOnly) {
             return this.executeDeletionOnly(context);
         }
-        // 如果是 closed 事件，仅收集 review 状态
-        if (context.eventAction === "closed") {
+        // 如果是 closed 事件或 flush 模式，仅收集 review 状态
+        if (context.eventAction === "closed" || context.flush) {
             return this.executeCollectOnly(context);
         }
         if (shouldLog(verbose, 1)) {
@@ -1556,7 +1558,7 @@ class ReviewService {
         return result;
     }
     /**
-   * 仅收集 review 状态模式（用于 PR 关闭时）
+   * 仅收集 review 状态模式（用于 PR 关闭或 --flush 指令）
    * 从现有的 AI review 评论中读取问题状态，同步已解决/无效状态，输出统计信息
    */ async executeCollectOnly(context) {
         const { owner, repo, prNumber, verbose, ci, dryRun } = context;
@@ -2423,12 +2425,12 @@ ${fileChanges || "无"}`;
                 console.warn("⚠️ 更新 PR 标题失败:", error);
             }
         }
-        // 获取已解决的评论，同步 fixed 状态（在删除旧 review 之前）
+        // 获取已解决的评论，同步 fixed 状态（在更新 review 之前）
         await this.syncResolvedComments(owner, repo, prNumber, result);
         // 获取评论的 reactions，同步 valid 状态（👎 标记为无效）
         await this.syncReactionsToIssues(owner, repo, prNumber, result, verbose);
-        // 删除已有的 AI review（避免重复评论）
-        await this.deleteExistingAiReviews(owner, repo, prNumber);
+        // 查找已有的 AI 评论（Issue Comment）
+        const existingComment = await this.findExistingAiComment(owner, repo, prNumber);
         // 调试：检查 issues 是否有 author
         if (shouldLog(verbose, 3)) {
             for (const issue of result.issues.slice(0, 3)){
@@ -2443,45 +2445,117 @@ ${fileChanges || "无"}`;
         // 获取 PR 信息以获取 head commit SHA
         const pr = await this.gitProvider.getPullRequest(owner, repo, prNumber);
         const commitId = pr.head?.sha;
-        // 构建行级评论（根据配置决定是否启用）
+        // 1. 发布或更新主评论（使用 Issue Comment API，支持删除和更新）
+        try {
+            if (existingComment?.id) {
+                await this.gitProvider.updateIssueComment(owner, repo, existingComment.id, reviewBody);
+                console.log(`✅ 已更新 AI Review 评论`);
+            } else {
+                await this.gitProvider.createIssueComment(owner, repo, prNumber, {
+                    body: reviewBody
+                });
+                console.log(`✅ 已发布 AI Review 评论`);
+            }
+        } catch (error) {
+            console.warn("⚠️ 发布/更新 AI Review 评论失败:", error);
+        }
+        // 2. 删除旧的行级评论（逐条删除 PR Review Comment）
+        try {
+            const reviews = await this.gitProvider.listPullReviews(owner, repo, prNumber);
+            const oldLineReviews = reviews.filter((r)=>r.body?.includes(REVIEW_LINE_COMMENTS_MARKER));
+            for (const review of oldLineReviews){
+                if (review.id) {
+                    const reviewComments = await this.gitProvider.listPullReviewComments(owner, repo, prNumber, review.id);
+                    for (const comment of reviewComments){
+                        if (comment.id) {
+                            try {
+                                await this.gitProvider.deletePullReviewComment(owner, repo, comment.id);
+                            } catch  {
+                            // 删除失败忽略
+                            }
+                        }
+                    }
+                    // 评论删除后尝试删除 review 本身
+                    try {
+                        await this.gitProvider.deletePullReview(owner, repo, prNumber, review.id);
+                    } catch  {
+                    // 已提交的 review 无法删除，忽略
+                    }
+                }
+            }
+            if (oldLineReviews.length > 0) {
+                console.log(`🗑️ 已清理 ${oldLineReviews.length} 个旧的行级评论 review`);
+            }
+        } catch (error) {
+            console.warn("⚠️ 清理旧行级评论失败:", error);
+        }
+        // 3. 发布新的行级评论（使用 PR Review API）
         let comments = [];
         if (reviewConf.lineComments) {
             comments = result.issues.filter((issue)=>!issue.fixed && issue.valid !== "false").map((issue)=>this.issueToReviewComment(issue)).filter((comment)=>comment !== null);
         }
+        if (comments.length > 0) {
+            try {
+                await this.gitProvider.createPullReview(owner, repo, prNumber, {
+                    event: REVIEW_STATE.COMMENT,
+                    body: REVIEW_LINE_COMMENTS_MARKER,
+                    comments,
+                    commit_id: commitId
+                });
+                console.log(`✅ 已发布 ${comments.length} 条行级评论`);
+            } catch  {
+                // 批量失败时逐条发布，跳过无法定位的评论
+                console.warn("⚠️ 批量发布行级评论失败，尝试逐条发布...");
+                let successCount = 0;
+                for (const comment of comments){
+                    try {
+                        await this.gitProvider.createPullReview(owner, repo, prNumber, {
+                            event: REVIEW_STATE.COMMENT,
+                            body: successCount === 0 ? REVIEW_LINE_COMMENTS_MARKER : undefined,
+                            comments: [
+                                comment
+                            ],
+                            commit_id: commitId
+                        });
+                        successCount++;
+                    } catch  {
+                        console.warn(`⚠️ 跳过无法定位的评论: ${comment.path}:${comment.new_position}`);
+                    }
+                }
+                if (successCount > 0) {
+                    console.log(`✅ 逐条发布成功 ${successCount}/${comments.length} 条行级评论`);
+                } else {
+                    console.warn("⚠️ 所有行级评论均无法定位，已跳过");
+                }
+            }
+        }
+    }
+    /**
+   * 查找已有的 AI 评论（Issue Comment）
+   */ async findExistingAiComment(owner, repo, prNumber) {
         try {
-            // 使用 PR Review 发布主评论 + 行级评论（合并为一个消息块）
-            await this.gitProvider.createPullReview(owner, repo, prNumber, {
-                event: "COMMENT",
-                body: reviewBody,
-                comments,
-                commit_id: commitId
-            });
-            const lineMsg = comments.length > 0 ? `，包含 ${comments.length} 条行级评论` : "";
-            console.log(`✅ 已发布 AI Review${lineMsg}`);
-        } catch (error) {
-            console.warn("⚠️ 发布 AI Review 失败:", error);
+            const comments = await this.gitProvider.listIssueComments(owner, repo, prNumber);
+            const aiComment = comments.find((c)=>c.body?.includes(REVIEW_COMMENT_MARKER));
+            return aiComment?.id ? {
+                id: aiComment.id
+            } : null;
+        } catch  {
+            return null;
         }
     }
     /**
-   * 从旧的 AI review 中获取已解决的评论，同步 fixed 状态到 result.issues
+   * 从 PR 的所有 resolved review threads 中同步 fixed 状态到 result.issues
+   * 直接通过 GraphQL 查询所有 resolved threads 的 path+line，匹配 issues
    */ async syncResolvedComments(owner, repo, prNumber, result) {
         try {
-            const reviews = await this.gitProvider.listPullReviews(owner, repo, prNumber);
-            const aiReview = reviews.find((r)=>r.body?.includes(REVIEW_COMMENT_MARKER));
-            if (!aiReview?.id) {
-                return;
-            }
-            // 获取该 review 的所有行级评论
-            const reviewComments = await this.gitProvider.listPullReviewComments(owner, repo, prNumber, aiReview.id);
-            // 找出已解决的评论（resolver 不为 null）
-            const resolvedComments = reviewComments.filter((c)=>c.resolver !== null && c.resolver !== undefined);
-            if (resolvedComments.length === 0) {
+            const resolvedThreads = await this.gitProvider.listResolvedThreads(owner, repo, prNumber);
+            if (resolvedThreads.length === 0) {
                 return;
             }
-            // 根据文件路径和行号匹配 issues，标记为已解决
             const now = new Date().toISOString();
-            for (const comment of resolvedComments){
-                const matchedIssue = result.issues.find((issue)=>issue.file === comment.path && this.lineMatchesPosition(issue.line, comment.position));
+            for (const thread of resolvedThreads){
+                if (!thread.path) continue;
+                const matchedIssue = result.issues.find((issue)=>issue.file === thread.path && this.lineMatchesPosition(issue.line, thread.line));
                 if (matchedIssue && !matchedIssue.fixed) {
                     matchedIssue.fixed = now;
                     console.log(`🟢 问题已标记为已解决: ${matchedIssue.file}:${matchedIssue.line}`);
@@ -2509,7 +2583,7 @@ ${fileChanges || "无"}`;
    */ async syncReactionsToIssues(owner, repo, prNumber, result, verbose) {
         try {
             const reviews = await this.gitProvider.listPullReviews(owner, repo, prNumber);
-            const aiReview = reviews.find((r)=>r.body?.includes(REVIEW_COMMENT_MARKER));
+            const aiReview = reviews.find((r)=>r.body?.includes(REVIEW_LINE_COMMENTS_MARKER));
             if (!aiReview?.id) {
                 if (shouldLog(verbose, 2)) {
                     console.log(`[syncReactionsToIssues] No AI review found`);
@@ -2520,7 +2594,7 @@ ${fileChanges || "无"}`;
             const reviewers = new Set();
             // 1. 从已提交的 review 中获取评审人（排除 AI bot）
             for (const review of reviews){
-                if (review.user?.login && !review.body?.includes(REVIEW_COMMENT_MARKER)) {
+                if (review.user?.login && !review.body?.includes(REVIEW_LINE_COMMENTS_MARKER)) {
                     reviewers.add(review.user.login);
                 }
             }
@@ -2579,7 +2653,7 @@ ${fileChanges || "无"}`;
                     commentIdToIssue.set(comment.id, matchedIssue);
                 }
                 try {
-                    const reactions = await this.gitProvider.getIssueCommentReactions(owner, repo, comment.id);
+                    const reactions = await this.gitProvider.getPullReviewCommentReactions(owner, repo, comment.id);
                     if (reactions.length === 0 || !matchedIssue) continue;
                     // 按 content 分组，收集每种 reaction 的用户列表
                     const reactionMap = new Map();
@@ -2657,20 +2731,46 @@ ${fileChanges || "无"}`;
     }
     /**
    * 删除已有的 AI review（通过 marker 识别）
+   * - 删除行级评论的 PR Review（带 REVIEW_LINE_COMMENTS_MARKER）
+   * - 删除主评论的 Issue Comment（带 REVIEW_COMMENT_MARKER）
    */ async deleteExistingAiReviews(owner, repo, prNumber) {
+        let deletedCount = 0;
+        // 删除行级评论的 PR Review
         try {
             const reviews = await this.gitProvider.listPullReviews(owner, repo, prNumber);
-            const aiReviews = reviews.filter((r)=>r.body?.includes(REVIEW_COMMENT_MARKER));
+            const aiReviews = reviews.filter((r)=>r.body?.includes(REVIEW_LINE_COMMENTS_MARKER) || r.body?.includes(REVIEW_COMMENT_MARKER));
             for (const review of aiReviews){
                 if (review.id) {
-                    await this.gitProvider.deletePullReview(owner, repo, prNumber, review.id);
+                    try {
+                        await this.gitProvider.deletePullReview(owner, repo, prNumber, review.id);
+                        deletedCount++;
+                    } catch  {
+                    // 已提交的 review 无法删除，忽略
+                    }
                 }
             }
-            if (aiReviews.length > 0) {
-                console.log(`🗑️ 已删除 ${aiReviews.length} 个旧的 AI review`);
+        } catch (error) {
+            console.warn("⚠️ 列出 PR reviews 失败:", error);
+        }
+        // 删除主评论的 Issue Comment
+        try {
+            const comments = await this.gitProvider.listIssueComments(owner, repo, prNumber);
+            const aiComments = comments.filter((c)=>c.body?.includes(REVIEW_COMMENT_MARKER));
+            for (const comment of aiComments){
+                if (comment.id) {
+                    try {
+                        await this.gitProvider.deleteIssueComment(owner, repo, comment.id);
+                        deletedCount++;
+                    } catch (error) {
+                        console.warn(`⚠️ 删除评论 ${comment.id} 失败:`, error);
+                    }
+                }
             }
         } catch (error) {
-            console.warn("⚠️ 删除旧 AI review 失败:", error);
+            console.warn("⚠️ 列出 issue comments 失败:", error);
+        }
+        if (deletedCount > 0) {
+            console.log(`🗑️ 已删除 ${deletedCount} 个旧的 AI review`);
         }
     }
     /**
@@ -2918,8 +3018,11 @@ ${fileChanges || "无"}`;
         return filtered;
     }
     filterDuplicateIssues(newIssues, existingIssues) {
-        // 只有 valid === 'true' 的历史问题才阻止新问题，其他情况允许覆盖
-        const existingKeys = new Set(existingIssues.filter((issue)=>issue.valid === "true").map((issue)=>this.generateIssueKey(issue)));
+        // 所有历史问题（无论 valid 状态）都阻止新问题重复添加
+        // valid='false' 的问题已被评审人标记为无效，不应再次报告
+        // valid='true' 的问题已存在，无需重复
+        // fixed 的问题已解决，无需重复
+        const existingKeys = new Set(existingIssues.map((issue)=>this.generateIssueKey(issue)));
         const filteredIssues = newIssues.filter((issue)=>!existingKeys.has(this.generateIssueKey(issue)));
         const skippedCount = newIssues.length - filteredIssues.length;
         return {
@@ -2929,11 +3032,11 @@ ${fileChanges || "无"}`;
     }
     async getExistingReviewResult(owner, repo, prNumber) {
         try {
-            // 从 PR Review 获取已有的审查结果
-            const reviews = await this.gitProvider.listPullReviews(owner, repo, prNumber);
-            const existingReview = reviews.find((r)=>r.body?.includes(REVIEW_COMMENT_MARKER));
-            if (existingReview?.body) {
-                return this.parseExistingReviewResult(existingReview.body);
+            // 从 Issue Comment 获取已有的审查结果
+            const comments = await this.gitProvider.listIssueComments(owner, repo, prNumber);
+            const existingComment = comments.find((c)=>c.body?.includes(REVIEW_COMMENT_MARKER));
+            if (existingComment?.body) {
+                return this.parseExistingReviewResult(existingComment.body);
             }
         } catch (error) {
             console.warn("⚠️ 获取已有评论失败:", error);
@@ -5080,23 +5183,28 @@ const extension = defineExtension({
                     flags: "--show-all",
                     description: t("review:options.showAll")
                 },
+                {
+                    flags: "--flush",
+                    description: t("review:options.flush")
+                },
                 {
                     flags: "--event-action <action>",
                     description: t("review:options.eventAction")
                 }
             ],
             run: async (_args, options, ctx)=>{
+                const isFlush = !!options?.flush;
                 if (!ctx.hasService("gitProvider")) {
                     ctx.output.error("review 命令需要配置 Git Provider，请在 spaceflow.json 中配置 gitProvider 字段");
                     process.exit(1);
                 }
-                if (!ctx.hasService("llmProxy")) {
+                if (!isFlush && !ctx.hasService("llmProxy")) {
                     ctx.output.error("review 命令需要配置 LLM 服务，请在 spaceflow.json 中配置 llm 字段");
                     process.exit(1);
                 }
                 const gitProvider = ctx.getService("gitProvider");
                 const configReader = ctx.getService("config");
-                const llmProxy = ctx.getService("llmProxy");
+                const llmProxy = ctx.hasService("llmProxy") ? ctx.getService("llmProxy") : undefined;
                 const gitSdk = ctx.hasService("gitSdk") ? ctx.getService("gitSdk") : undefined;
                 const reviewSpecService = new ReviewSpecService(gitProvider);
                 const reviewReportService = new ReviewReportService();
@@ -5121,6 +5229,7 @@ const extension = defineExtension({
                     outputFormat: options?.outputFormat,
                     generateDescription: !!options?.generateDescription,
                     showAll: !!options?.showAll,
+                    flush: isFlush,
                     eventAction: options?.eventAction
                 };
                 try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spaceflow/review",
-  "version": "0.30.0",
+  "version": "0.31.0",
   "description": "Spaceflow 代码审查插件，使用 LLM 对 PR 代码进行自动审查",
   "license": "MIT",
   "author": "Lydanne",
@@ -25,10 +25,10 @@
     "@vitest/coverage-v8": "^4.0.18",
     "unplugin-swc": "^1.5.9",
     "vitest": "^4.0.18",
-    "@spaceflow/cli": "0.20.0"
+    "@spaceflow/cli": "0.21.0"
   },
   "peerDependencies": {
-    "@spaceflow/core": "0.2.0"
+    "@spaceflow/core": "0.3.0"
   },
   "spaceflow": {
     "type": "flow",

package/src/index.ts

@@ -48,23 +48,27 @@ export const extension = defineExtension({
         { flags: "-o, --output-format <format>", description: t("review:options.outputFormat") },
         { flags: "--generate-description", description: t("review:options.generateDescription") },
         { flags: "--show-all", description: t("review:options.showAll") },
+        { flags: "--flush", description: t("review:options.flush") },
         { flags: "--event-action <action>", description: t("review:options.eventAction") },
       ],
       run: async (_args, options, ctx) => {
+        const isFlush = !!options?.flush;
         if (!ctx.hasService("gitProvider")) {
           ctx.output.error(
             "review 命令需要配置 Git Provider，请在 spaceflow.json 中配置 gitProvider 字段",
           );
           process.exit(1);
         }
-        if (!ctx.hasService("llmProxy")) {
+        if (!isFlush && !ctx.hasService("llmProxy")) {
           ctx.output.error("review 命令需要配置 LLM 服务，请在 spaceflow.json 中配置 llm 字段");
           process.exit(1);
         }
 
         const gitProvider = ctx.getService<GitProviderService>("gitProvider");
         const configReader = ctx.getService<ConfigReaderService>("config");
-        const llmProxy = ctx.getService<LlmProxyService>("llmProxy");
+        const llmProxy = ctx.hasService("llmProxy")
+          ? ctx.getService<LlmProxyService>("llmProxy")
+          : (undefined as unknown as LlmProxyService);
         const gitSdk = ctx.hasService("gitSdk")
           ? ctx.getService<GitSdkService>("gitSdk")
           : undefined;
@@ -104,6 +108,7 @@ export const extension = defineExtension({
           outputFormat: options?.outputFormat as ReportFormat,
           generateDescription: !!options?.generateDescription,
           showAll: !!options?.showAll,
+          flush: isFlush,
           eventAction: options?.eventAction as string,
         };
 

package/src/locales/en/review.json

@@ -17,6 +17,7 @@
   "options.outputFormat": "Output format: markdown, terminal, json. Auto-selected if not specified (markdown for PR, terminal for CLI)",
   "options.generateDescription": "Generate PR description using AI",
   "options.showAll": "Show all issues found, including those on unchanged lines",
+  "options.flush": "Only sync status (reactions, resolved conversations, replies), skip LLM review",
   "options.eventAction": "PR event type (opened, synchronize, closed, etc.), closed only collects stats without AI review",
   "extensionDescription": "Code review command using LLM for automated PR review",
   "mcp.serverDescription": "Code review rules query service",

package/src/locales/zh-cn/review.json

@@ -17,6 +17,7 @@
   "options.outputFormat": "输出格式: markdown, terminal, json。不指定则智能选择（PR 用 markdown，终端用 terminal）",
   "options.generateDescription": "使用 AI 生成 PR 功能描述",
   "options.showAll": "显示所有发现的问题，不过滤非变更行的问题",
+  "options.flush": "仅刷新状态（同步 reactions、resolved conversations、replies），不执行 LLM 审查",
   "options.eventAction": "PR 事件类型（opened, synchronize, closed 等），closed 时仅收集统计不进行 AI 审查",
   "extensionDescription": "代码审查命令，使用 LLM 对 PR 代码进行自动审查",
   "mcp.serverDescription": "代码审查规则查询服务",

package/src/review.config.ts

@@ -63,6 +63,8 @@ export interface ReviewOptions {
   generateDescription?: boolean;
   /** 显示所有问题，不过滤非变更行的问题 */
   showAll?: boolean;
+  /** 仅刷新状态（同步 reactions、resolved 等），不执行 LLM 审查 */
+  flush?: boolean;
   /** PR 事件类型（opened, synchronize, closed 等） */
   eventAction?: string;
   concurrency?: number;