@spaceflow/review 0.40.0 → 0.41.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spaceflow/review",
-  "version": "0.40.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.30.0"
+    "@spaceflow/cli": "0.31.0"
   },
   "peerDependencies": {
-    "@spaceflow/core": "0.9.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)。
 
 ## 输出格式