@spaceflow/review 0.39.0 → 0.41.0

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## [0.40.0](https://github.com/Lydanne/spaceflow/compare/@spaceflow/review@0.39.0...@spaceflow/review@0.40.0) (2026-02-26)
+
+### 代码重构
+
+* **cli:** 从配置文件读取扩展依赖，自动同步到 .spaceflow/package.json ([0f3a0ae](https://github.com/Lydanne/spaceflow/commit/0f3a0ae3f1e580b6fed627e29caf55d8207ece14))
+* **cli:** 将 .env 加载提前至主流程最开始，确保子进程启动前环境变量已就绪 ([8851359](https://github.com/Lydanne/spaceflow/commit/88513596b52299c2f8262548fa60ec89d1c466f4))
+* **cli:** 将 .spaceflow/bin/ 添加到 .gitignore，移除静态生成的入口文件 ([df01d2d](https://github.com/Lydanne/spaceflow/commit/df01d2d6a8dc647d8b067e3f529b0967b2a6eabd))
+* **cli:** 改用 dynamic import 加载扩展，确保 i18n 在扩展模块执行前初始化 ([926286d](https://github.com/Lydanne/spaceflow/commit/926286d98d867a7521e7943e15d62952df35c017))
+* **cli:** 重构配置和 .env 文件查找逻辑，支持从 cwd 向上遍历目录树 ([62a381b](https://github.com/Lydanne/spaceflow/commit/62a381bac340033ce0ff9c39afca82d7f8f20311))
+* **config:** 将 .env 加载逻辑迁移至 shared 包，并在 CLI 壳子阶段提前加载 ([4c6b825](https://github.com/Lydanne/spaceflow/commit/4c6b825d44a98d1fec92ed6a4e17b74a79f7206d))
+* **core:** 移除 ConfigReaderService，统一使用 IConfigReader 接口 ([ea9ed2b](https://github.com/Lydanne/spaceflow/commit/ea9ed2b9d35886f768eac9c6d1a50ca4fc79b67d))
+* **core:** 重构 CLI 架构，将运行时逻辑迁移至 Core 包 ([6539795](https://github.com/Lydanne/spaceflow/commit/653979503d720c8a37f1731044e3c65ac2dd6e1c))
+* **core:** 重构 i18n 模块结构，统一导出路径至 cli-runtime/i18n ([b49ae95](https://github.com/Lydanne/spaceflow/commit/b49ae95cf99a41a91f9018e141afb5bbfb6b8884))
+* **mcp:** 移除重复的扩展加载逻辑，新增 TTY 检测避免手动运行时阻塞 ([51fb35f](https://github.com/Lydanne/spaceflow/commit/51fb35fab28c11cf8d297d7950c31a60bc4c4e2a))
+* 调整构建顺序，优先构建 shared 包并排除其重复构建 ([d7cd392](https://github.com/Lydanne/spaceflow/commit/d7cd392ed6578acb1e6ee85ae2097d92d81e5efb))
+
+### 其他修改
+
+* **cli:** released version 0.30.0 [no ci] ([7af2925](https://github.com/Lydanne/spaceflow/commit/7af292524349effcfc85a26cf3285dba7726b441))
+* **core:** released version 0.9.0 [no ci] ([e4bd091](https://github.com/Lydanne/spaceflow/commit/e4bd091c3f3cb4ae675f4e594d0c651cea481bc5))
+* **publish:** released version 0.32.0 [no ci] ([77a2800](https://github.com/Lydanne/spaceflow/commit/77a2800d9b001ebd2b502db59c9a5994e54665c9))
+* **review-summary:** released version 0.9.0 [no ci] ([c1a2322](https://github.com/Lydanne/spaceflow/commit/c1a2322bb7535d15c63251ea515ee21ea7a4e1bf))
+* **scripts:** released version 0.9.0 [no ci] ([8db4c68](https://github.com/Lydanne/spaceflow/commit/8db4c681b6a00bb9717f05aa809bb4e13bbb7e53))
+* **shared:** released version 0.1.0 [no ci] ([243e31d](https://github.com/Lydanne/spaceflow/commit/243e31de49dbde605d5a16ec9f0d589792b9cc30))
+* **shell:** released version 0.9.0 [no ci] ([b161fe1](https://github.com/Lydanne/spaceflow/commit/b161fe17aec13f59f0dbc04a7a2d392ba6740cca))
+
+## [0.39.0](https://github.com/Lydanne/spaceflow/compare/@spaceflow/review@0.38.0...@spaceflow/review@0.39.0) (2026-02-26)
+
+### 修复BUG
+
+* **cli:** 自动安装扩展时根据命令行参数动态设置 verbose 级别 ([d2da6f5](https://github.com/Lydanne/spaceflow/commit/d2da6f5eb30425e48bb4fd924c73bb9237a437ab))
+
+### 其他修改
+
+* **cli:** released version 0.29.0 [no ci] ([5fd87d3](https://github.com/Lydanne/spaceflow/commit/5fd87d31511d13d4937b1b1a247ad8a322d6fc9c))
+* **publish:** released version 0.31.0 [no ci] ([e928d60](https://github.com/Lydanne/spaceflow/commit/e928d6061e05c03fc92303a246b2563a5100740b))
+* **review-summary:** released version 0.8.0 [no ci] ([0e73a97](https://github.com/Lydanne/spaceflow/commit/0e73a97b035692b0fe7f59e36585cffccf6c6854))
+* **scripts:** released version 0.8.0 [no ci] ([efea246](https://github.com/Lydanne/spaceflow/commit/efea246fe1bbd8815c7af44e8fd40df57a0219d6))
+* **shell:** released version 0.8.0 [no ci] ([607b93b](https://github.com/Lydanne/spaceflow/commit/607b93bd911e3da102a73dd4513a4733b40c8672))
+
 ## [0.38.0](https://github.com/Lydanne/spaceflow/compare/@spaceflow/review@0.37.0...@spaceflow/review@0.38.0) (2026-02-26)
 
 ### 修复BUG

package/dist/index.js

@@ -1009,7 +1009,6 @@ const REVIEW_SCHEMA = {
 class ReviewService {
     gitProvider;
     config;
-    configReader;
     reviewSpecService;
     llmProxyService;
     reviewReportService;
@@ -1017,10 +1016,9 @@ class ReviewService {
     deletionImpactService;
     gitSdk;
     llmJsonPut;
-    constructor(gitProvider, config, configReader, reviewSpecService, llmProxyService, reviewReportService, issueVerifyService, deletionImpactService, gitSdk){
+    constructor(gitProvider, config, reviewSpecService, llmProxyService, reviewReportService, issueVerifyService, deletionImpactService, gitSdk){
         this.gitProvider = gitProvider;
         this.config = config;
-        this.configReader = configReader;
         this.reviewSpecService = reviewSpecService;
         this.llmProxyService = llmProxyService;
         this.reviewReportService = reviewReportService;
@@ -1049,7 +1047,7 @@ class ReviewService {
         });
     }
     async getContextFromEnv(options) {
-        const reviewConf = this.configReader.getPluginConfig("review");
+        const reviewConf = this.config.getPluginConfig("review");
         const ciConf = this.config.get("ci");
         const repository = ciConf?.repository;
         if (options.ci) {
@@ -1476,7 +1474,7 @@ class ReviewService {
                 }
                 // 如果文件有变更，将该文件的历史问题标记为无效
                 // 简化策略：避免复杂的行号更新逻辑
-                const reviewConf = this.configReader.getPluginConfig("review");
+                const reviewConf = this.config.getPluginConfig("review");
                 if (reviewConf.invalidateChangedFiles !== "off" && reviewConf.invalidateChangedFiles !== "keep") {
                     existingIssues = await this.invalidateIssuesForChangedFiles(existingIssues, pr?.head?.sha, owner, repo, verbose);
                 }
@@ -2413,7 +2411,7 @@ ${fileChanges || "无"}`;
     }
     async postOrUpdateReviewComment(owner, repo, prNumber, result, verbose) {
         // 获取配置
-        const reviewConf = this.configReader.getPluginConfig("review");
+        const reviewConf = this.config.getPluginConfig("review");
         // 如果配置启用且有 AI 生成的标题，只在第一轮审查时更新 PR 标题
         if (reviewConf.autoUpdatePrTitle && result.title && result.round === 1) {
             try {
@@ -5203,14 +5201,13 @@ const extension = defineExtension({
                     process.exit(1);
                 }
                 const gitProvider = ctx.getService("gitProvider");
-                const configReader = ctx.getService("config");
                 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();
                 const issueVerifyService = new IssueVerifyService(llmProxy, reviewSpecService);
                 const deletionImpactService = new DeletionImpactService(llmProxy, gitProvider);
-                const reviewService = new ReviewService(gitProvider, ctx.config, configReader, reviewSpecService, llmProxy, reviewReportService, issueVerifyService, deletionImpactService, gitSdk);
+                const reviewService = new ReviewService(gitProvider, ctx.config, reviewSpecService, llmProxy, reviewReportService, issueVerifyService, deletionImpactService, gitSdk);
                 const reviewOptions = {
                     dryRun: !!options?.dryRun,
                     ci: !!options?.ci,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spaceflow/review",
-  "version": "0.39.0",
+  "version": "0.41.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.29.0"
+    "@spaceflow/cli": "0.31.0"
   },
   "peerDependencies": {
-    "@spaceflow/core": "0.8.0"
+    "@spaceflow/core": "0.10.0"
   },
   "spaceflow": {
     "type": "flow",

package/src/README.md

@@ -1,14 +1,12 @@
-# Review 模块
+# Review 扩展
 
-Review 是 spaceflow 的核心模块，提供基于 LLM 的自动化代码审查功能。支持在 GitHub Actions CI 环境中运行，也可在本地命令行使用。
+Review 是 Spaceflow 的核心扩展，提供基于 LLM 的自动化代码审查功能。支持在 GitHub Actions CI 环境中运行，也可在本地命令行使用。
 
 ## 目录结构
 
 ```text
-review/
-├── index.ts                      # 模块导出入口
-├── review.module.ts              # NestJS 模块定义
-├── review.command.ts             # CLI 命令定义
+review/src/
+├── index.ts                      # Extension 入口（defineExtension）
 ├── review.service.ts             # 核心审查服务
 ├── review.service.spec.ts        # 审查服务单元测试
 ├── issue-verify.service.ts       # 历史问题验证服务
@@ -19,17 +17,16 @@ review/
 ├── parse-title-options.spec.ts   # 标题解析单元测试
 ```
 
-## 模块依赖
+## 依赖的共享模块
 
 ```text
-ReviewModule
-├── ConfigModule          # 配置管理
-├── GitProviderModule      # Git Provider 适配器
-├── ClaudeSetupModule     # Claude CLI 配置
-├── ReviewSpecModule      # 审查规范加载
-├── ReviewReportModule    # 审查报告格式化
-├── GitSdkModule          # Git 命令封装
-└── LlmProxyModule        # LLM 统一代理（支持 OpenAI/Claude/Gemini）
+review extension
+├── GitProviderService     # Git 平台适配器
+├── GitSdkService          # Git 命令封装
+├── LlmProxyService        # LLM 统一代理（OpenAI / Claude）
+├── LoggerService          # 日志系统
+├── StorageService         # 缓存存储
+└── ParallelService        # 并行执行
 ```
 
 ## 核心功能
@@ -234,50 +231,24 @@ feat: 添加新功能 [/ai-review -l openai -v 2]
 
 ## 配置项
 
-在 `spaceflow.json` 中配置：
-
-```javascript
-module.exports = {
-  review: {
-    // LLM 模式：claude-code, openai, gemini
-    llmMode: "openai",
-
-    // 文件过滤模式
-    includes: ["**/*.ts", "**/*.js"],
-
-    // 是否验证历史问题
-    verifyFixes: true,
-    verifyFixesConcurrency: 10,
-
-    // 删除代码分析
-    analyzeDeletions: false,
-    deletionAnalysisMode: "openai",
-
-    // 并发和超时配置
-    concurrency: 5,
-    timeout: 60000,
-    retries: 0,
-    retryDelay: 1000,
-
-    // 是否生成 PR 描述
-    generateDescription: false,
-
-    // 是否启用行级评论
-    lineComments: false,
-
-    // OpenAI 配置
-    openai: {
-      apiKey: "sk-xxx",
-      baseUrl: "https://api.openai.com/v1",
-      model: "gpt-4o",
-    },
-
-    // Claude Code 配置
-    claudeCode: {
-      // Claude CLI 配置
-    },
-  },
-};
+在 `.spaceflowrc` 或 `.spaceflow/spaceflow.json` 中配置 `review` 字段：
+
+```json
+{
+  "review": {
+    "includes": ["*/**/*.ts", "!*/**/*.spec.*", "!*/**/*.config.*"],
+    "references": ["./references"],
+    "generateDescription": true,
+    "autoUpdatePrTitle": false,
+    "lineComments": true,
+    "verifyFixes": true,
+    "analyzeDeletions": false,
+    "deletionAnalysisMode": "open-code",
+    "concurrency": 10,
+    "retries": 3,
+    "retryDelay": 1000
+  }
+}
 ```
 
 ## 使用示例
@@ -297,7 +268,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Review
-        run: npx spaceflow review --ci -l openai
+        run: pnpm spaceflow review --ci -l openai
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 ```
@@ -306,26 +277,26 @@ jobs:
 
 ```bash
 # 审查 PR
-npx spaceflow review -p 123 -l openai
+spaceflow review -p 123 -l openai
 
 # 审查两个分支之间的差异
-npx spaceflow review -b main --head feature/xxx -l openai
+spaceflow review -b main --head feature/xxx -l openai
 
 # 仅审查指定文件
-npx spaceflow review -f src/app.ts -l openai
+spaceflow review -f src/app.ts -l openai
 
 # 详细输出
-npx spaceflow review -p 123 -l openai -v 2
+spaceflow review -p 123 -l openai -vv
 
 # 仅分析删除代码
-npx spaceflow review -p 123 --deletion-only -l openai
+spaceflow review -p 123 --deletion-only -l openai
 ```
 
 ## 审查规范
 
-审查规范文件位于 `.spaceflow/review-spec/` 目录，使用 Markdown 格式定义规则。
+审查规范文件通过配置文件的 `review.references` 字段指定，支持本地目录和远程 Git 仓库 URL。
 
-详见 [ReviewSpec 模块文档](../../shared/review-spec/README.md)。
+详见 [Review Spec 规范](/reference/review-spec)。
 
 ## 输出格式
 

package/src/index.ts

@@ -1,12 +1,6 @@
 import "./locales";
 import { defineExtension, t } from "@spaceflow/core";
-import type {
-  GitProviderService,
-  ConfigReaderService,
-  LlmProxyService,
-  GitSdkService,
-  LLMMode,
-} from "@spaceflow/core";
+import type { GitProviderService, LlmProxyService, GitSdkService, LLMMode } from "@spaceflow/core";
 import { parseVerbose } from "@spaceflow/core";
 import { reviewSchema, type AnalyzeDeletionsMode } from "./review.config";
 import { ReviewService } from "./review.service";
@@ -65,7 +59,6 @@ export const extension = defineExtension({
         }
 
         const gitProvider = ctx.getService<GitProviderService>("gitProvider");
-        const configReader = ctx.getService<ConfigReaderService>("config");
         const llmProxy = ctx.hasService("llmProxy")
           ? ctx.getService<LlmProxyService>("llmProxy")
           : (undefined as unknown as LlmProxyService);
@@ -81,7 +74,6 @@ export const extension = defineExtension({
         const reviewService = new ReviewService(
           gitProvider,
           ctx.config,
-          configReader,
           reviewSpecService,
           llmProxy,
           reviewReportService,

package/src/review.service.spec.ts

@@ -49,7 +49,6 @@ describe("ReviewService", () => {
   let mockDeletionImpactService: any;
   let mockGitSdkService: any;
   let mockLlmProxyService: any;
-  let mockConfigReaderService: any;
 
   beforeEach(() => {
     vi.clearAllMocks();
@@ -80,6 +79,8 @@ describe("ReviewService", () => {
 
     configService = {
       get: vi.fn(),
+      getPluginConfig: vi.fn().mockReturnValue({}),
+      registerSchema: vi.fn(),
     };
 
     mockReviewSpecService = {
@@ -140,15 +141,9 @@ describe("ReviewService", () => {
       getAvailableAdapters: vi.fn().mockReturnValue(["claude-code", "openai"]),
     };
 
-    mockConfigReaderService = {
-      getPluginConfig: vi.fn().mockReturnValue({}),
-      getSystemConfig: vi.fn().mockReturnValue({}),
-    };
-
     service = new ReviewService(
       gitProvider as any,
       configService as any,
-      mockConfigReaderService as any,
       mockReviewSpecService as any,
       mockLlmProxyService as any,
       mockReviewReportService as any,

package/src/review.service.ts

@@ -1,12 +1,11 @@
 import {
-  ConfigReaderService,
   GitProviderService,
   PullRequest,
   PullRequestCommit,
   ChangedFile,
   CreatePullReviewComment,
   REVIEW_STATE,
-  CiConfig,
+  type CiConfig,
   type LLMMode,
   LlmProxyService,
   logStreamEvent,
@@ -145,7 +144,6 @@ export class ReviewService {
   constructor(
     protected readonly gitProvider: GitProviderService,
     protected readonly config: IConfigReader,
-    protected readonly configReader: ConfigReaderService,
     protected readonly reviewSpecService: ReviewSpecService,
     protected readonly llmProxyService: LlmProxyService,
     protected readonly reviewReportService: ReviewReportService,
@@ -171,7 +169,7 @@ export class ReviewService {
   }
 
   async getContextFromEnv(options: ReviewOptions): Promise<ReviewContext> {
-    const reviewConf = this.configReader.getPluginConfig<ReviewConfig>("review");
+    const reviewConf = this.config.getPluginConfig<ReviewConfig>("review");
     const ciConf = this.config.get<CiConfig>("ci");
     const repository = ciConf?.repository;
 
@@ -705,7 +703,7 @@ export class ReviewService {
 
         // 如果文件有变更，将该文件的历史问题标记为无效
         // 简化策略：避免复杂的行号更新逻辑
-        const reviewConf = this.configReader.getPluginConfig<ReviewConfig>("review");
+        const reviewConf = this.config.getPluginConfig<ReviewConfig>("review");
         if (
           reviewConf.invalidateChangedFiles !== "off" &&
           reviewConf.invalidateChangedFiles !== "keep"
@@ -1864,7 +1862,7 @@ ${fileChanges || "无"}`;
     verbose?: VerboseLevel,
   ): Promise<void> {
     // 获取配置
-    const reviewConf = this.configReader.getPluginConfig<ReviewConfig>("review");
+    const reviewConf = this.config.getPluginConfig<ReviewConfig>("review");
 
     // 如果配置启用且有 AI 生成的标题，只在第一轮审查时更新 PR 标题
     if (reviewConf.autoUpdatePrTitle && result.title && result.round === 1) {