Lydanne/spaceflow
1
0
Fork 0
mirror of https://github.com/Lydanne/spaceflow.git synced 2026-03-11 19:52:45 +08:00
Code Issues Packages Projects Releases Wiki Activity

chore: 初始化仓库

Browse Source
This commit is contained in:
Lydanne
2026-02-15 22:02:21 +08:00
commit 08d011d63f
381 changed files with 87202 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

533
commands/review/CHANGELOG.md Normal file
View File

@@ -0,0 +1,533 @@
# Changelog
## [0.29.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.28.0...@spaceflow/review@0.29.0) (2026-02-15)
### 新特性
* **cli:** 新增 MCP Server 命令并集成 review 扩展的 MCP 工具 ([b794b36](https://git.bjxgj.com/xgj/spaceflow/commit/b794b36d90788c7eb4cbb253397413b4a080ae83))
* **cli:** 新增 MCP Server 导出类型支持 ([9568cbd](https://git.bjxgj.com/xgj/spaceflow/commit/9568cbd14d4cfbdedaf2218379c72337af6db271))
* **core:** 为所有命令添加 i18n 国际化支持 ([867c5d3](https://git.bjxgj.com/xgj/spaceflow/commit/867c5d3eccc285c8a68803b8aa2f0ffb86a94285))
* **core:** 新增 GitLab 平台适配器并完善配置支持 ([47be9ad](https://git.bjxgj.com/xgj/spaceflow/commit/47be9adfa90944a9cb183e03286a7a96fec747f1))
* **core:** 新增 Logger 全局日志工具并支持 plain/tui 双模式渲染 ([8baae7c](https://git.bjxgj.com/xgj/spaceflow/commit/8baae7c24139695a0e379e1c874023cd61dfc41b))
* **docs:** 新增 VitePress 文档站点并完善项目文档 ([a79d620](https://git.bjxgj.com/xgj/spaceflow/commit/a79d6208e60390a44fa4c94621eb41ae20159e98))
* **mcp:** 新增 MCP Inspector 交互式调试支持并优化工具日志输出 ([05fd2ee](https://git.bjxgj.com/xgj/spaceflow/commit/05fd2ee941c5f6088b769d1127cb7c0615626f8c))
* **review:** 为 MCP 服务添加 i18n 国际化支持 ([a749054](https://git.bjxgj.com/xgj/spaceflow/commit/a749054eb73b775a5f5973ab1b86c04f2b2ddfba))
* **review:** 新增规则级 includes 解析测试并修复文件级/规则级 includes 过滤逻辑 ([4baca71](https://git.bjxgj.com/xgj/spaceflow/commit/4baca71c17782fb92a95b3207f9c61e0b410b9ff))
### 修复BUG
* **actions:** 修正 pnpm setup 命令调用方式 ([8f014fa](https://git.bjxgj.com/xgj/spaceflow/commit/8f014fa90b74e20de4c353804d271b3ef6f1288f))
* **mcp:** 添加 -y 选项确保 Inspector 自动安装依赖 ([a9201f7](https://git.bjxgj.com/xgj/spaceflow/commit/a9201f74bd9ddc5eba92beaaa676f377842863e0))
### 代码重构
* **claude:** 移除 .claude 目录及其 .gitignore 配置文件 ([91916a9](https://git.bjxgj.com/xgj/spaceflow/commit/91916a99f65da31c1d34e6f75b5cbea1d331ba35))
* **cli:** 优化依赖安装流程并支持 .spaceflow 目录配置 ([5977631](https://git.bjxgj.com/xgj/spaceflow/commit/597763183eaa61bb024bba2703d75239650b54fb))
* **cli:** 拆分 CLI 为独立包并重构扩展加载机制 ([b385d28](https://git.bjxgj.com/xgj/spaceflow/commit/b385d281575f29b823bb6dc4229a396a29c0e226))
* **cli:** 移除 ExtensionModule 并优化扩展加载机制 ([8f7077d](https://git.bjxgj.com/xgj/spaceflow/commit/8f7077deaef4e5f4032662ff5ac925cd3c07fdb6))
* **cli:** 调整依赖顺序并格式化导入语句 ([32a9c1c](https://git.bjxgj.com/xgj/spaceflow/commit/32a9c1cf834725a20f93b1f8f60b52692841a3e5))
* **cli:** 重构 getPluginConfigFromPackageJson 方法以提高代码可读性 ([f5f6ed9](https://git.bjxgj.com/xgj/spaceflow/commit/f5f6ed9858cc4ca670e30fac469774bdc8f7b005))
* **cli:** 重构扩展配置格式，支持 flow/command/skill 三种导出类型 ([958dc13](https://git.bjxgj.com/xgj/spaceflow/commit/958dc130621f78bbcc260224da16a5f16ae0b2b1))
* **core:** 为 build/clear/commit 命令添加国际化支持 ([de82cb2](https://git.bjxgj.com/xgj/spaceflow/commit/de82cb2f1ed8cef0e446a2d42a1bf1f091e9c421))
* **core:** 优化 list 命令输出格式并修复 MCP Inspector 包管理器兼容性 ([a019829](https://git.bjxgj.com/xgj/spaceflow/commit/a019829d3055c083aeb86ed60ce6629d13012d91))
* **core:** 将 rspack 配置和工具函数中的 @spaceflow/cli 引用改为 @spaceflow/core ([3c301c6](https://git.bjxgj.com/xgj/spaceflow/commit/3c301c60f3e61b127db94481f5a19307f5ef00eb))
* **core:** 将扩展依赖从 @spaceflow/cli 迁移到 @spaceflow/core ([6f9ffd4](https://git.bjxgj.com/xgj/spaceflow/commit/6f9ffd4061cecae4faaf3d051e3ca98a0b42b01f))
* **core:** 提取 source 处理和包管理器工具函数到共享模块 ([ab3ff00](https://git.bjxgj.com/xgj/spaceflow/commit/ab3ff003d1cd586c0c4efc7841e6a93fe3477ace))
* **core:** 新增 getEnvFilePaths 工具函数统一管理 .env 文件路径优先级 ([809fa18](https://git.bjxgj.com/xgj/spaceflow/commit/809fa18f3d0b8eabcb068988bab53d548eaf03ea))
* **core:** 新增远程仓库规则拉取功能并支持 Git API 获取目录内容 ([69ade16](https://git.bjxgj.com/xgj/spaceflow/commit/69ade16c9069f9e1a90b3ef56dc834e33a3c0650))
* **core:** 统一 LogLevel 类型定义并支持字符串/数字双模式 ([557f6b0](https://git.bjxgj.com/xgj/spaceflow/commit/557f6b0bc39fcfb0e3f773836cbbf08c1a8790ae))
* **core:** 重构配置读取逻辑,新增 ConfigReaderService 并支持 .spaceflowrc 配置文件 ([72e88ce](https://git.bjxgj.com/xgj/spaceflow/commit/72e88ced63d03395923cdfb113addf4945162e54))
* **i18n:** 将 locales 导入从命令文件迁移至扩展入口文件 ([0da5d98](https://git.bjxgj.com/xgj/spaceflow/commit/0da5d9886296c4183b24ad8c56140763f5a870a4))
* **i18n:** 移除扩展元数据中的 locales 字段并改用 side-effect 自动注册 ([2c7d488](https://git.bjxgj.com/xgj/spaceflow/commit/2c7d488a9dfa59a99b95e40e3c449c28c2d433d8))
* **mcp:** 使用 DTO + Swagger 装饰器替代手动 JSON Schema 定义 ([87ec262](https://git.bjxgj.com/xgj/spaceflow/commit/87ec26252dd295536bb090ae8b7e418eec96e1bd))
* **mcp:** 升级 MCP SDK API 并优化 Inspector 调试配置 ([176d04a](https://git.bjxgj.com/xgj/spaceflow/commit/176d04a73fbbb8d115520d922f5fedb9a2961aa6))
* **mcp:** 将 MCP 元数据存储从 Reflect Metadata 改为静态属性以支持跨模块访问 ([cac0ea2](https://git.bjxgj.com/xgj/spaceflow/commit/cac0ea2029e1b504bc4278ce72b3aa87fff88c84))
* **test:** 迁移测试框架从 Jest 到 Vitest ([308f9d4](https://git.bjxgj.com/xgj/spaceflow/commit/308f9d49089019530588344a5e8880f5b6504a6a))
* 优化构建流程并调整 MCP/review 日志输出级别 ([74072c0](https://git.bjxgj.com/xgj/spaceflow/commit/74072c04be7a45bfc0ab53b636248fe5c0e1e42a))
* 将 .spaceflow/package.json 纳入版本控制并自动添加到根项目依赖 ([ab83d25](https://git.bjxgj.com/xgj/spaceflow/commit/ab83d2579cb5414ee3d78a9768fac2147a3d1ad9))
* 将 GiteaSdkModule/GiteaSdkService 重命名为 GitProviderModule/GitProviderService ([462f492](https://git.bjxgj.com/xgj/spaceflow/commit/462f492bc2607cf508c5011d181c599cf17e00c9))
* 恢复 pnpm catalog 配置并移除 .spaceflow 工作区导入器 ([217387e](https://git.bjxgj.com/xgj/spaceflow/commit/217387e2e8517a08162e9bcaf604893fd9bca736))
* 迁移扩展依赖到 .spaceflow 工作区并移除 pnpm catalog ([c457c0f](https://git.bjxgj.com/xgj/spaceflow/commit/c457c0f8918171f1856b88bc007921d76c508335))
* 重构 Extension 安装机制为 pnpm workspace 模式 ([469b12e](https://git.bjxgj.com/xgj/spaceflow/commit/469b12eac28f747b628e52a5125a3d5a538fba39))
* 重构插件加载改为扩展模式 ([0e6e140](https://git.bjxgj.com/xgj/spaceflow/commit/0e6e140b19ea2cf6084afc261c555d2083fe04f9))
### 文档更新
* **guide:** 更新编辑器集成文档,补充四种导出类型说明和 MCP 注册机制 ([19a7409](https://git.bjxgj.com/xgj/spaceflow/commit/19a7409092c89d002f11ee51ebcb6863118429bd))
* **guide:** 更新配置文件位置说明并补充 RC 文件支持 ([2214dc4](https://git.bjxgj.com/xgj/spaceflow/commit/2214dc4e197221971f5286b38ceaa6fcbcaa7884))
### 测试用例
* **core:** 新增 GiteaAdapter 完整单元测试并实现自动检测 provider 配置 ([c74f745](https://git.bjxgj.com/xgj/spaceflow/commit/c74f7458aed91ac7d12fb57ef1c24b3d2917c406))
* **review:** 新增 DeletionImpactService 测试覆盖并配置 coverage 工具 ([50bfbfe](https://git.bjxgj.com/xgj/spaceflow/commit/50bfbfe37192641f1170ade8f5eb00e0e382af67))
### 其他修改
* **ci-scripts:** released version 0.19.0 [no ci] ([9f747c6](https://git.bjxgj.com/xgj/spaceflow/commit/9f747c617b387e105e92b4a5dcd0f5d3cf51c26d))
* **ci-shell:** released version 0.19.0 [no ci] ([59ac30d](https://git.bjxgj.com/xgj/spaceflow/commit/59ac30da6802a9493c33e560ea9121d378597e89))
* **ci:** 迁移工作流从 Gitea 到 GitHub 并统一环境变量命名 ([57e3bae](https://git.bjxgj.com/xgj/spaceflow/commit/57e3bae635b324c8c4ea50a9fb667b6241fae0ef))
* **cli:** released version 0.19.0 [no ci] ([6b63149](https://git.bjxgj.com/xgj/spaceflow/commit/6b631499e2407a1822395d5f40cec2d725331b78))
* **config:** 将 git 推送白名单用户从 "Gitea Actions" 改为 "GiteaActions" ([fdbb865](https://git.bjxgj.com/xgj/spaceflow/commit/fdbb865341e6f02b26fca32b54a33b51bee11cad))
* **config:** 将 git 推送白名单用户从 github-actions[bot] 改为 Gitea Actions ([9c39819](https://git.bjxgj.com/xgj/spaceflow/commit/9c39819a9f95f415068f7f0333770b92bc98321b))
* **config:** 移除 review-spec 私有仓库依赖 ([8ae18f1](https://git.bjxgj.com/xgj/spaceflow/commit/8ae18f13c441b033d1cbc75119695a5cc5cb6a0b))
* **core:** released version 0.1.0 [no ci] ([170fa67](https://git.bjxgj.com/xgj/spaceflow/commit/170fa670e98473c2377120656d23aae835c51997))
* **core:** 禁用 i18next 初始化时的 locize.com 推广日志 ([a99fbb0](https://git.bjxgj.com/xgj/spaceflow/commit/a99fbb068441bc623efcf15a1dd7b6bd38c05f38))
* **deps:** 移除 pnpm catalog 配置并更新依赖锁定 ([753fb9e](https://git.bjxgj.com/xgj/spaceflow/commit/753fb9e3e43b28054c75158193dc39ab4bab1af5))
* **docs:** 统一文档脚本命名,为 VitePress 命令添加 docs: 前缀 ([3cc46ea](https://git.bjxgj.com/xgj/spaceflow/commit/3cc46eab3a600290f5064b8270902e586b9c5af4))
* **i18n:** 配置 i18n-ally-next 自动提取键名生成策略 ([753c3dc](https://git.bjxgj.com/xgj/spaceflow/commit/753c3dc3f24f3c03c837d1ec2c505e8e3ce08b11))
* **i18n:** 重构 i18n 配置并统一 locales 目录结构 ([3e94037](https://git.bjxgj.com/xgj/spaceflow/commit/3e94037fa6493b3b0e4a12ff6af9f4bea48ae217))
* **period-summary:** released version 0.19.0 [no ci] ([b833948](https://git.bjxgj.com/xgj/spaceflow/commit/b83394888ac47ae8d91bfd9317980f56bd322b34))
* **publish:** released version 0.21.0 [no ci] ([18f9b20](https://git.bjxgj.com/xgj/spaceflow/commit/18f9b20f26716c88eb389778912de8e7713bffca))
* **scripts:** 修正 setup 和 build 脚本的过滤条件,避免重复构建 cli 包 ([ffd2ffe](https://git.bjxgj.com/xgj/spaceflow/commit/ffd2ffedca08fd56cccb6a9fbd2b6bd106e367b6))
* **templates:** 新增 MCP 工具插件模板 ([5f6df60](https://git.bjxgj.com/xgj/spaceflow/commit/5f6df60b60553f025414fd102d8a279cde097485))
* **workflows:** 为所有 GitHub Actions 工作流添加 GIT_PROVIDER_TYPE 环境变量 ([a463574](https://git.bjxgj.com/xgj/spaceflow/commit/a463574de6755a0848a8d06267f029cb947132b0))
* **workflows:** 在发布流程中添加 GIT_PROVIDER_TYPE 环境变量 ([a4bb388](https://git.bjxgj.com/xgj/spaceflow/commit/a4bb3881f39ad351e06c5502df6895805b169a28))
* **workflows:** 在发布流程中添加扩展安装步骤 ([716be4d](https://git.bjxgj.com/xgj/spaceflow/commit/716be4d92641ccadb3eaf01af8a51189ec5e9ade))
* **workflows:** 将发布流程的 Git 和 NPM 配置从 GitHub 迁移到 Gitea ([6d9acff](https://git.bjxgj.com/xgj/spaceflow/commit/6d9acff06c9a202432eb3d3d5552e6ac972712f5))
* **workflows:** 将发布流程的 GITHUB_TOKEN 改为使用 CI_GITEA_TOKEN ([e7fe7b4](https://git.bjxgj.com/xgj/spaceflow/commit/e7fe7b4271802fcdbfc2553b180f710eed419335))
* 为所有 commands 包添加 @spaceflow/cli 开发依赖 ([d4e6c83](https://git.bjxgj.com/xgj/spaceflow/commit/d4e6c8344ca736f7e55d7db698482e8fa2445684))
* 优化依赖配置并移除 .spaceflow 包依赖 ([be5264e](https://git.bjxgj.com/xgj/spaceflow/commit/be5264e5e0fe1f53bbe3b44a9cb86dd94ab9d266))
* 修正 postinstall 脚本命令格式 ([3f0820f](https://git.bjxgj.com/xgj/spaceflow/commit/3f0820f85dee88808de921c3befe2d332f34cc36))
* 恢复 pnpm catalog 配置并更新依赖锁定 ([0b2295c](https://git.bjxgj.com/xgj/spaceflow/commit/0b2295c1f906d89ad3ba7a61b04c6e6b94f193ef))
* 新增 .spaceflow/pnpm-workspace.yaml 防止被父级 workspace 接管并移除根项目 devDependencies 自动添加逻辑 ([61de3a2](https://git.bjxgj.com/xgj/spaceflow/commit/61de3a2b75e8a19b28563d2a6476158d19f6c5be))
* 新增 postinstall 钩子自动执行 setup 脚本 ([64dae0c](https://git.bjxgj.com/xgj/spaceflow/commit/64dae0cb440bd5e777cb790f826ff2d9f8fe65ba))
* 移除 postinstall 钩子避免依赖安装时自动执行构建 ([ea1dc85](https://git.bjxgj.com/xgj/spaceflow/commit/ea1dc85ce7d6cf23a98c13e2c21e3c3bcdf7dd79))
## [0.28.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.27.0...@spaceflow/review@0.28.0) (2026-02-04)
### 代码重构
* **verbose:** 扩展 verbose 级别支持至 3 ([c1a0808](https://git.bjxgj.com/xgj/spaceflow/commit/c1a080859e5d25ca1eb3dc7e00a67b32eb172635))
### 其他修改
* **ci-scripts:** released version 0.18.0 [no ci] ([e17894a](https://git.bjxgj.com/xgj/spaceflow/commit/e17894a5af53ff040a0a17bc602d232f78415e1b))
* **ci-shell:** released version 0.18.0 [no ci] ([f64fd80](https://git.bjxgj.com/xgj/spaceflow/commit/f64fd8009a6dd725f572c7e9fbf084d9320d5128))
* **core:** released version 0.18.0 [no ci] ([c5e973f](https://git.bjxgj.com/xgj/spaceflow/commit/c5e973fbe22c0fcd0d6d3af6e4020e2fbff9d31f))
* **period-summary:** released version 0.18.0 [no ci] ([f0df638](https://git.bjxgj.com/xgj/spaceflow/commit/f0df63804d06f8c75e04169ec98226d7a4f5d7f9))
* **publish:** released version 0.20.0 [no ci] ([d347e3b](https://git.bjxgj.com/xgj/spaceflow/commit/d347e3b2041157d8dc6e3ade69b05a481b2ab371))
## [0.27.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.26.0...@spaceflow/review@0.27.0) (2026-02-04)
### 修复BUG
- **core:** 从 PR diff 填充缺失的 patch 字段 ([24bfaa7](https://git.bjxgj.com/xgj/spaceflow/commit/24bfaa76f3bd56c8ead307e73e0623a2221c69cf))
### 代码重构
- **config:** 降低并发数以优化 AI 审查性能 ([052dd72](https://git.bjxgj.com/xgj/spaceflow/commit/052dd728f759da0a31e86a0ad480e9bb35052781))
- **review:** 优化 Markdown 格式化器的代码风格和 JSON 数据输出逻辑 ([ca1b0c9](https://git.bjxgj.com/xgj/spaceflow/commit/ca1b0c96d9d0663a8b8dc93b4a9f63d4e5590df0))
- **review:** 新增测试方法用于验证 PR 审查功能 ([5c57833](https://git.bjxgj.com/xgj/spaceflow/commit/5c578332cedffb7fa7e5ad753a788bcd55595c68))
- **review:** 移除测试方法 testMethod ([21e9938](https://git.bjxgj.com/xgj/spaceflow/commit/21e9938100c5dd7d4eada022441c565b5c41a55a))
### 测试用例
- **review:** 新增新增文件无 patch 时的测试用例,优化变更行标记逻辑 ([a593f0d](https://git.bjxgj.com/xgj/spaceflow/commit/a593f0d4a641b348f7c9d30b14f639b24c12dcfa))
### 其他修改
- **ci-scripts:** released version 0.17.0 [no ci] ([31abd3d](https://git.bjxgj.com/xgj/spaceflow/commit/31abd3dcb48e2ddea5175552c0a87c1eaa1e7a41))
- **ci-shell:** released version 0.17.0 [no ci] ([a53508b](https://git.bjxgj.com/xgj/spaceflow/commit/a53508b15e4020e3399bae9cc04e730f1539ad8e))
- **core:** released version 0.17.0 [no ci] ([c85a8ed](https://git.bjxgj.com/xgj/spaceflow/commit/c85a8ed88929d867d2d460a44d08d8b7bc4866a2))
- **period-summary:** released version 0.17.0 [no ci] ([ac4e5b6](https://git.bjxgj.com/xgj/spaceflow/commit/ac4e5b6083773146ac840548a69006f6c4fbac1d))
- **publish:** released version 0.19.0 [no ci] ([7a96bca](https://git.bjxgj.com/xgj/spaceflow/commit/7a96bca945434a99f7d051a38cb31adfd2ade5d2))
## [0.26.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.25.0...@spaceflow/review@0.26.0) (2026-02-04)
### 新特性
- **review:** 新增 override 作用域测试,验证 includes 对 override 过滤的影响 ([820e0cb](https://git.bjxgj.com/xgj/spaceflow/commit/820e0cb0f36783dc1c7e1683ad08501e91f094b2))
## [0.25.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.24.0...@spaceflow/review@0.25.0) (2026-02-04)
### 代码重构
- **review:** 优化 override 和变更行过滤的日志输出,增强调试信息的可读性 ([9a7c6f5](https://git.bjxgj.com/xgj/spaceflow/commit/9a7c6f5b4ef2b8ae733fa499a0e5ec82feebc1d2))
## [0.24.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.23.0...@spaceflow/review@0.24.0) (2026-02-04)
### 修复BUG
- **review:** 新增 getFileContents、getChangedFilesBetweenRefs 和 filterIssuesByValidCommits 方法的单元测试 ([7618c91](https://git.bjxgj.com/xgj/spaceflow/commit/7618c91bc075d218b9f51b862e5161d15a306bf8))
## [0.23.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.22.0...@spaceflow/review@0.23.0) (2026-02-03)
### 代码重构
- **review:** 使用 Base64 编码存储审查数据,避免 JSON 格式在 Markdown 中被转义 ([fb91e30](https://git.bjxgj.com/xgj/spaceflow/commit/fb91e30d0979cfe63ed8e7657c578db618b5e783))
## [0.22.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.21.0...@spaceflow/review@0.22.0) (2026-02-02)
### 代码重构
- **review:** 基于 fileContents 实际 commit hash 验证问题归属,替代依赖 LLM 填写的 commit 字段 ([de3e377](https://git.bjxgj.com/xgj/spaceflow/commit/de3e3771eb85ff93200c63fa9feb38941914a07d))
- **review:** 移除 filterNoCommit 配置项,统一使用基于 commit hash 的问题过滤逻辑 ([82429b1](https://git.bjxgj.com/xgj/spaceflow/commit/82429b1072affb4f2b14d52f99887e12184d8218))
- **review:** 统一使用 parseLineRange 方法解析行号,避免重复的正则匹配逻辑 ([c64f96a](https://git.bjxgj.com/xgj/spaceflow/commit/c64f96aa2e1a8e22dcd3e31e1a2acc1bb338a1a8))
- **review:** 调整 filterIssuesByValidCommits 逻辑,保留无 commit 的 issue 交由 filterNoCommit 配置处理 ([e9c5d47](https://git.bjxgj.com/xgj/spaceflow/commit/e9c5d47aebef42507fd9fcd67e5eab624437e81a))
- **review:** 过滤非 PR commits 的问题,避免 merge commit 引入的代码被审查 ([9e20f54](https://git.bjxgj.com/xgj/spaceflow/commit/9e20f54d57e71725432dfb9e7c943946aa6677d4))
## [0.21.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.20.0...@spaceflow/review@0.21.0) (2026-02-02)
### 代码重构
- **review:** 过滤 merge commits,避免在代码审查中处理合并提交 ([d7c647c](https://git.bjxgj.com/xgj/spaceflow/commit/d7c647c33156a58b42bfb45a67417723b75328c6))
## [0.20.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.19.0...@spaceflow/review@0.20.0) (2026-02-02)
### 新特性
- **core:** 新增 Git diff 行号映射工具并优化 Claude 配置 ([88ef340](https://git.bjxgj.com/xgj/spaceflow/commit/88ef3400127fac3ad52fc326ad79fdc7bd058e98))
- **review:** 为 execute 方法添加文档注释 ([a21f582](https://git.bjxgj.com/xgj/spaceflow/commit/a21f58290c873fb07789e70c8c5ded2b5874a29d))
- **review:** 为 getPrNumberFromEvent 方法添加文档注释 ([54d1586](https://git.bjxgj.com/xgj/spaceflow/commit/54d1586f4558b5bfde81b926c7b513a32e5caf89))
- **review:** 优化行号更新统计,分别统计更新和标记无效的问题数量 ([892b8be](https://git.bjxgj.com/xgj/spaceflow/commit/892b8bed8913531a9440579f777b1965fec772e5))
### 代码重构
- **review:** 优化历史 issue commit 匹配逻辑,支持短 SHA 与完整 SHA 的前缀匹配 ([e30c6dd](https://git.bjxgj.com/xgj/spaceflow/commit/e30c6ddefb14ec6631ce341f1d45c59786e94a46))
- **review:** 简化历史问题处理策略,将行号更新改为标记变更文件问题为无效 ([5df7f00](https://git.bjxgj.com/xgj/spaceflow/commit/5df7f0087c493e104fe0dc054fd0b6c19ebe3500))
- **review:** 简化行号更新逻辑,使用最新 commit diff 替代增量 diff ([6de7529](https://git.bjxgj.com/xgj/spaceflow/commit/6de7529c90ecbcee82149233fc01c393c5c4e7f7))
- **review:** 重构行号更新逻辑,使用增量 diff 替代全量 diff ([d4f4304](https://git.bjxgj.com/xgj/spaceflow/commit/d4f4304e1e41614f7be8946d457eea1cf4e202fb))
### 测试用例
- **review:** 添加单元测试以覆盖行号更新逻辑 ([ebf33e4](https://git.bjxgj.com/xgj/spaceflow/commit/ebf33e45c18c910b88b106cdd4cfeb516b3fb656))
### 其他修改
- **actions:** 增强命令执行日志,输出原始 command 和 args 参数 ([0f0c238](https://git.bjxgj.com/xgj/spaceflow/commit/0f0c238de7d6f10875022f364746cefa56631b7f))
- **ci-scripts:** released version 0.16.0 [no ci] ([9ab007d](https://git.bjxgj.com/xgj/spaceflow/commit/9ab007db178878e093ba93ea27c4f05ca813a65d))
- **ci-shell:** released version 0.16.0 [no ci] ([87fd703](https://git.bjxgj.com/xgj/spaceflow/commit/87fd7030b54d2f614f23e092499c5c51bfc33788))
- **core:** released version 0.16.0 [no ci] ([871f981](https://git.bjxgj.com/xgj/spaceflow/commit/871f981b0b908c981aaef366f2382ec6ca2e2269))
- **period-summary:** released version 0.16.0 [no ci] ([b214e31](https://git.bjxgj.com/xgj/spaceflow/commit/b214e31221d5afa04481c48d9ddb878644a22ae7))
- **publish:** released version 0.18.0 [no ci] ([2f2ce01](https://git.bjxgj.com/xgj/spaceflow/commit/2f2ce01726f7b3e4387e23a17974b58acd3e6929))
- 在 PR 审查工作流中启用 --filter-no-commit 参数 ([e0024ad](https://git.bjxgj.com/xgj/spaceflow/commit/e0024ad5cb29250b452a841db2ce6ebf84016a2c))
- 禁用删除代码分析功能 ([988e3f1](https://git.bjxgj.com/xgj/spaceflow/commit/988e3f156f2ca4e92413bf7a455eba1760ad9eba))
## [0.19.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.18.0...@spaceflow/review@0.19.0) (2026-02-02)
### 新特性
- **core:** 在 Gitea SDK 中新增编辑 Pull Request 的方法 ([a586bf1](https://git.bjxgj.com/xgj/spaceflow/commit/a586bf110789578f23b39d64511229a1e5635dc4))
- **core:** 在 Gitea SDK 中新增获取 reactions 的方法 ([9324cf2](https://git.bjxgj.com/xgj/spaceflow/commit/9324cf2550709b8302171e5522d0792c08bc1415))
- **review:** 优化 commit author 获取逻辑,支持 committer 作为备选 ([b75b613](https://git.bjxgj.com/xgj/spaceflow/commit/b75b6133e5b8c95580516480315bc979fc6eb59b))
- **review:** 优化 commit author 获取逻辑,支持从 Git 原始作者信息中提取 ([10ac821](https://git.bjxgj.com/xgj/spaceflow/commit/10ac8210a4457e0356c3bc1645f54f6f3d8c904c))
- **review:** 优化 commit author 获取逻辑,通过 Gitea API 搜索用户以关联 Git 原始作者 ([daa274b](https://git.bjxgj.com/xgj/spaceflow/commit/daa274bba2255e92d1e9a6e049e20846a69e8df7))
- **review:** 优化 PR 标题生成的格式要求 ([a4d807d](https://git.bjxgj.com/xgj/spaceflow/commit/a4d807d0a4feee4ccc88c6096e069c6dbb650a03))
- **review:** 优化 verbose 参数支持多级别累加,将日志级别扩展为 0-3 级 ([fe4c830](https://git.bjxgj.com/xgj/spaceflow/commit/fe4c830cac137c5502d700d2cd5f22b52a629e5f))
- **review:** 优化历史问题的 author 信息填充逻辑 ([b18d171](https://git.bjxgj.com/xgj/spaceflow/commit/b18d171c9352fe5815262d43ffd9cd7751f03a4e))
- **review:** 优化审查报告中回复消息的格式显示 ([f478c8d](https://git.bjxgj.com/xgj/spaceflow/commit/f478c8da4c1d7494819672006e3230dbc8e0924d))
- **review:** 优化审查报告中的消息展示格式 ([0996c2b](https://git.bjxgj.com/xgj/spaceflow/commit/0996c2b45c9502c84308f8a7f9186e4dbd4164fb))
- **review:** 优化问题 author 信息填充时机,统一在所有问题合并后填充 ([ea8c586](https://git.bjxgj.com/xgj/spaceflow/commit/ea8c586fc60061ffd339e85c6c298b905bdfdcd8))
- **review:** 优化问题展示和无效标记逻辑 ([e2b45e1](https://git.bjxgj.com/xgj/spaceflow/commit/e2b45e1ec594488bb79f528911fd6009a3213eca))
- **review:** 在 fillIssueAuthors 方法中添加详细的调试日志 ([42ab288](https://git.bjxgj.com/xgj/spaceflow/commit/42ab288933296abdeeb3dbbedbb2aecedbea2251))
- **review:** 在 syncReactionsToIssues 中添加详细日志并修复团队成员获取逻辑 ([91f166a](https://git.bjxgj.com/xgj/spaceflow/commit/91f166a07c2e43dabd4dd4ac186ec7b5f03dfc71))
- **review:** 在审查报告的回复中为用户名添加 @ 前缀 ([bc6186b](https://git.bjxgj.com/xgj/spaceflow/commit/bc6186b97f0764f6335690eca1f8af665f9b7629))
- **review:** 在审查问题中添加作者信息填充功能 ([8332dba](https://git.bjxgj.com/xgj/spaceflow/commit/8332dba4bb826cd358dc96db5f9b9406fb23df9b))
- **review:** 将审查命令的详细日志参数从 --verbose 简化为 -vv ([5eb320b](https://git.bjxgj.com/xgj/spaceflow/commit/5eb320b92d1f7165052730b2e90eee52367391dd))
- **review:** 扩展评审人收集逻辑,支持从 PR 指定的评审人和团队中获取 ([bbd61af](https://git.bjxgj.com/xgj/spaceflow/commit/bbd61af9d3e2b9e1dcf28c5e3867645fdda52e6f))
- **review:** 支持 AI 自动生成和更新 PR 标题 ([e02fb02](https://git.bjxgj.com/xgj/spaceflow/commit/e02fb027d525dd3e794d649e6dbc53c99a3a9a59))
- **review:** 支持 PR 关闭事件触发审查并自动传递事件类型参数 ([03967d9](https://git.bjxgj.com/xgj/spaceflow/commit/03967d9e860af7da06e3c04539f16c7bb31557ff))
- **review:** 支持在审查报告中展示评论的 reactions 和回复记录 ([f4da31a](https://git.bjxgj.com/xgj/spaceflow/commit/f4da31adf6ce412cb0ce27bfe7a1e87e5350e915))
- **review:** 移除 handleReview 中的重复 author 填充逻辑 ([e458bfd](https://git.bjxgj.com/xgj/spaceflow/commit/e458bfd0d21724c37fdd4023265d6a2dd1700404))
- **review:** 限制 PR 标题自动更新仅在第一轮审查时执行 ([1891cbc](https://git.bjxgj.com/xgj/spaceflow/commit/1891cbc8d85f6eaef9e7107a7f1003bdc654d3a3))
- **review:** 默认启用 PR 标题自动更新功能 ([fda6656](https://git.bjxgj.com/xgj/spaceflow/commit/fda6656efaf6479bb398ddc5cb1955142f31f369))
### 修复BUG
- **actions:** 修复日志输出中的 emoji 显示问题,将 <20> 替换为 ℹ️ ([d3cd94a](https://git.bjxgj.com/xgj/spaceflow/commit/d3cd94afa9c6893b923d316fdcb5904f42ded632))
- **review:** 修复审查完成日志中的乱码 emoji ([36c1c48](https://git.bjxgj.com/xgj/spaceflow/commit/36c1c48faecda3cc02b9e0b097aebba0a85ea5f8))
- **review:** 将 UserInfo 的 id 字段类型从 number 改为 string ([505e019](https://git.bjxgj.com/xgj/spaceflow/commit/505e019c85d559ce1def1350599c1de218f7516a))
### 其他修改
- **ci-scripts:** released version 0.15.0 [no ci] ([e314fb1](https://git.bjxgj.com/xgj/spaceflow/commit/e314fb11e7425b27c337d3650857cf3b737051fd))
- **ci-shell:** released version 0.15.0 [no ci] ([5c0dc0b](https://git.bjxgj.com/xgj/spaceflow/commit/5c0dc0b5482366ccfd7854868d1eb5f306c24810))
- **core:** released version 0.15.0 [no ci] ([48f3875](https://git.bjxgj.com/xgj/spaceflow/commit/48f38754dee382548bab968c57dd0f40f2343981))
- **period-summary:** released version 0.15.0 [no ci] ([3dd72cb](https://git.bjxgj.com/xgj/spaceflow/commit/3dd72cb65a422b5b008a83820e799b810a6d53eb))
- **publish:** released version 0.17.0 [no ci] ([8e0d065](https://git.bjxgj.com/xgj/spaceflow/commit/8e0d0654040d6af7e99fa013a8255aa93acbcc3a))
## [0.18.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.17.0...@spaceflow/review@0.18.0) (2026-01-31)
### 修复BUG
- **core:** 统一所有命令的错误处理,添加堆栈信息输出 ([31224a1](https://git.bjxgj.com/xgj/spaceflow/commit/31224a16ce7155402504bd8d3e386e59e47949df))
- **review:** 增强错误处理,添加堆栈信息输出 ([e0fb5de](https://git.bjxgj.com/xgj/spaceflow/commit/e0fb5de6bc877d8f0b3dc3c03f8d614320427bf3))
### 其他修改
- **ci-scripts:** released version 0.14.0 [no ci] ([c536208](https://git.bjxgj.com/xgj/spaceflow/commit/c536208e352baa82e5b56c490ea9df0aff116cb2))
- **ci-shell:** released version 0.14.0 [no ci] ([c6e4bdc](https://git.bjxgj.com/xgj/spaceflow/commit/c6e4bdca44874739694e3e46998e376779503e53))
- **core:** released version 0.14.0 [no ci] ([996dbc6](https://git.bjxgj.com/xgj/spaceflow/commit/996dbc6f80b0d3fb8049df9a9a31bd1e5b5d4b92))
- **period-summary:** released version 0.14.0 [no ci] ([55a72f2](https://git.bjxgj.com/xgj/spaceflow/commit/55a72f2b481e5ded1d9207a5a8d6a6864328d5a0))
- **publish:** released version 0.16.0 [no ci] ([e31e46d](https://git.bjxgj.com/xgj/spaceflow/commit/e31e46d08fccb10a42b6579fa042aa6c57d79c8a))
## [0.17.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.16.0...@spaceflow/review@0.17.0) (2026-01-31)
### 修复BUG
- **core:** 修复 resolveRef 方法未处理空 ref 参数的问题 ([0824c83](https://git.bjxgj.com/xgj/spaceflow/commit/0824c8392482263036888b2fec95935371d67d4d))
- **review:** 修复参数空值检查，增强代码健壮性 ([792a192](https://git.bjxgj.com/xgj/spaceflow/commit/792a192fd5dd80ed1e6d85cd61f6ce997bcc9dd9))
### 其他修改
- **ci-scripts:** released version 0.13.0 [no ci] ([021eefd](https://git.bjxgj.com/xgj/spaceflow/commit/021eefdf2ff72d16b36123335548df2d3ad1d6b7))
- **ci-shell:** released version 0.13.0 [no ci] ([81e7582](https://git.bjxgj.com/xgj/spaceflow/commit/81e75820eb69ca188155e33945111e2b1f6b3012))
- **core:** released version 0.13.0 [no ci] ([e3edde3](https://git.bjxgj.com/xgj/spaceflow/commit/e3edde3e670c79544af9a7249d566961740a2284))
- **period-summary:** released version 0.13.0 [no ci] ([1d47460](https://git.bjxgj.com/xgj/spaceflow/commit/1d47460e40ba422a32865ccddd353e089eb91c6a))
- **publish:** released version 0.15.0 [no ci] ([4b09122](https://git.bjxgj.com/xgj/spaceflow/commit/4b091227265a57f0a05488749eb4852fb421a06e))
## [0.16.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.15.0...@spaceflow/review@0.16.0) (2026-01-31)
### 新特性
- **review:** 为删除影响分析添加文件过滤功能 ([7304293](https://git.bjxgj.com/xgj/spaceflow/commit/73042937c5271ff4b0dcb6cd6d823e5aa0c03e7b))
## [0.15.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.14.0...@spaceflow/review@0.15.0) (2026-01-31)
### 修复BUG
- **review:** 修复按指定提交过滤时未处理空值导致的潜在问题 ([5d4d3e0](https://git.bjxgj.com/xgj/spaceflow/commit/5d4d3e0390a50c01309bb09e01c7328b211271b8))
## [0.14.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.13.0...@spaceflow/review@0.14.0) (2026-01-31)
### 新特性
- **review:** 新增过滤无commit问题的选项 ([7a4c458](https://git.bjxgj.com/xgj/spaceflow/commit/7a4c458da03ae4a4646abca7e5f03abc849dc405))
## [0.13.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.12.0...@spaceflow/review@0.13.0) (2026-01-31)
### 新特性
- **core:** 为 CLI 入口文件添加 Node shebang 支持 ([0d787d3](https://git.bjxgj.com/xgj/spaceflow/commit/0d787d329e69f2b53d26ba04720d60625ca51efd))
### 其他修改
- **ci-scripts:** released version 0.12.0 [no ci] ([097863f](https://git.bjxgj.com/xgj/spaceflow/commit/097863f0c5cc46cb5cb930f14a6f379f60a13f08))
- **ci-shell:** released version 0.12.0 [no ci] ([274216f](https://git.bjxgj.com/xgj/spaceflow/commit/274216fc930dfbf8390d02e25c06efcb44980fed))
- **core:** released version 0.12.0 [no ci] ([1ce5034](https://git.bjxgj.com/xgj/spaceflow/commit/1ce50346d73a1914836333415f5ead9fbfa27be7))
- **period-summary:** released version 0.12.0 [no ci] ([38490aa](https://git.bjxgj.com/xgj/spaceflow/commit/38490aa75ab20789c5495a5d8d009867f954af4f))
- **publish:** released version 0.14.0 [no ci] ([fe0e140](https://git.bjxgj.com/xgj/spaceflow/commit/fe0e14058a364362d7d218da9b34dbb5d8fb8f42))
## [0.12.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.11.0...@spaceflow/review@0.12.0) (2026-01-29)
### 新特性
- **core:** 优化 commit message 的 scope 处理逻辑 ([42869dd](https://git.bjxgj.com/xgj/spaceflow/commit/42869dd4bde0a3c9bf8ffb827182775e2877a57b))
- **core:** 重构 commit 服务并添加结构化 commit message 支持 ([22b4db8](https://git.bjxgj.com/xgj/spaceflow/commit/22b4db8619b0ce038667ab42dea1362706887fc9))
### 其他修改
- **ci-scripts:** released version 0.11.0 [no ci] ([d4f5bba](https://git.bjxgj.com/xgj/spaceflow/commit/d4f5bba6f89e9e051dde8d313b6e102c6dadfa41))
- **ci-shell:** released version 0.11.0 [no ci] ([cf9e486](https://git.bjxgj.com/xgj/spaceflow/commit/cf9e48666197295f118396693abc08b680b3ddee))
- **core:** released version 0.11.0 [no ci] ([f0025c7](https://git.bjxgj.com/xgj/spaceflow/commit/f0025c792e332e8b8752597a27f654c0197c36eb))
- **period-summary:** released version 0.11.0 [no ci] ([b518887](https://git.bjxgj.com/xgj/spaceflow/commit/b518887bddd5a452c91148bac64d61ec64b0b509))
- **publish:** released version 0.13.0 [no ci] ([1d308d9](https://git.bjxgj.com/xgj/spaceflow/commit/1d308d9e32c50902dd881144ff541204d368006f))
## [0.11.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.10.0...@spaceflow/review@0.11.0) (2026-01-29)
### 新特性
- **core:** 优化 npm 包名处理逻辑 ([ae23ebd](https://git.bjxgj.com/xgj/spaceflow/commit/ae23ebdc3144b611e1aa8c4e66bf0db074d09798))
- **core:** 添加依赖更新功能 ([1a544eb](https://git.bjxgj.com/xgj/spaceflow/commit/1a544eb5e2b64396a0187d4518595e9dcb51d73e))
### 其他修改
- **ci-scripts:** released version 0.10.0 [no ci] ([ca2daad](https://git.bjxgj.com/xgj/spaceflow/commit/ca2daada8b04bbe809e69a3d5bd9373e897c6f40))
- **ci-shell:** released version 0.10.0 [no ci] ([53864b8](https://git.bjxgj.com/xgj/spaceflow/commit/53864b8c2534cae265b8fbb98173a5b909682d4e))
- **core:** released version 0.10.0 [no ci] ([a80d34f](https://git.bjxgj.com/xgj/spaceflow/commit/a80d34fb647e107343a07a8793363b3b76320e81))
- **period-summary:** released version 0.10.0 [no ci] ([c1ca3bb](https://git.bjxgj.com/xgj/spaceflow/commit/c1ca3bb67fa7f9dbb4de152f0461d644f3044946))
- **publish:** released version 0.12.0 [no ci] ([50e209e](https://git.bjxgj.com/xgj/spaceflow/commit/50e209ebc57504462ed192a0fe22f6f944165fa3))
## [0.10.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.9.0...@spaceflow/review@0.10.0) (2026-01-29)
### 新特性
- **review:** 支持绝对路径转换为相对路径 ([9050f64](https://git.bjxgj.com/xgj/spaceflow/commit/9050f64b8ef67cb2c8df9663711a209523ae9d18))
## [0.9.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.8.0...@spaceflow/review@0.9.0) (2026-01-28)
### 新特性
- **core:** 为 npm 包添加 npx 直接执行支持 ([e67a7da](https://git.bjxgj.com/xgj/spaceflow/commit/e67a7da34c4e41408760da4de3a499495ce0df2f))
### 其他修改
- **ci-scripts:** released version 0.9.0 [no ci] ([1b9e816](https://git.bjxgj.com/xgj/spaceflow/commit/1b9e8167bb8fc67fcc439b2ef82e7a63dc323e6d))
- **ci-shell:** released version 0.9.0 [no ci] ([accdda7](https://git.bjxgj.com/xgj/spaceflow/commit/accdda7ee4628dc8447e9a89da6c8101c572cb90))
- **core:** released version 0.9.0 [no ci] ([8127211](https://git.bjxgj.com/xgj/spaceflow/commit/812721136828e8c38adf0855fb292b0da89daf1a))
- **period-summary:** released version 0.9.0 [no ci] ([ac03f9b](https://git.bjxgj.com/xgj/spaceflow/commit/ac03f9bcff742d669c6e8b2f94e40153b6c298f5))
- **publish:** released version 0.11.0 [no ci] ([df17cd1](https://git.bjxgj.com/xgj/spaceflow/commit/df17cd1250c8fd8a035eb073d292885a4b1e3322))
## [0.8.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.7.0...@spaceflow/review@0.8.0) (2026-01-28)
### 新特性
- **core:** 优化 commit 消息生成器中的 scope 处理逻辑 ([1592079](https://git.bjxgj.com/xgj/spaceflow/commit/1592079edde659fe94a02bb6e2dea555c80d3b6b))
### 其他修改
- **ci-scripts:** released version 0.8.0 [no ci] ([be6273d](https://git.bjxgj.com/xgj/spaceflow/commit/be6273dab7f1c80c58abdb8de6f0eeb986997e28))
- **ci-shell:** released version 0.8.0 [no ci] ([3102178](https://git.bjxgj.com/xgj/spaceflow/commit/310217827c6ec29294dee5689b2dbb1b66492728))
- **core:** released version 0.8.0 [no ci] ([625dbc0](https://git.bjxgj.com/xgj/spaceflow/commit/625dbc0206747b21a893ae43032f55d0a068c6fd))
- **period-summary:** released version 0.8.0 [no ci] ([44ff3c5](https://git.bjxgj.com/xgj/spaceflow/commit/44ff3c505b243e1291565e354e239ce893e5e47c))
- **publish:** released version 0.10.0 [no ci] ([8722ba9](https://git.bjxgj.com/xgj/spaceflow/commit/8722ba9eddb03c2f73539f4e09c504ed9491a5eb))
## [0.7.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.6.0...@spaceflow/review@0.7.0) (2026-01-28)
### 代码重构
- **core:** 重构安装服务目录结构和命名 ([50cc900](https://git.bjxgj.com/xgj/spaceflow/commit/50cc900eb864b23f20c5f48dec20d1a754238286))
### 其他修改
- **ci-scripts:** released version 0.7.0 [no ci] ([ea294e1](https://git.bjxgj.com/xgj/spaceflow/commit/ea294e138c6b15033af85819629727915dfcbf4b))
- **ci-shell:** released version 0.7.0 [no ci] ([247967b](https://git.bjxgj.com/xgj/spaceflow/commit/247967b30876aae78cfb1f9c706431b5bb9fb57e))
- **core:** released version 0.7.0 [no ci] ([000c53e](https://git.bjxgj.com/xgj/spaceflow/commit/000c53eff80899dbadad8d668a2227921373daad))
- **period-summary:** released version 0.7.0 [no ci] ([8869d58](https://git.bjxgj.com/xgj/spaceflow/commit/8869d5876e86ebe83ae65c3259cd9a7e402257cf))
- **publish:** released version 0.9.0 [no ci] ([b404930](https://git.bjxgj.com/xgj/spaceflow/commit/b40493049877c1fd3554d77a14e9bd9ab318e15a))
## [0.6.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.5.0...@spaceflow/review@0.6.0) (2026-01-28)
### 新特性
- **core:** 优化pnpm包安装逻辑，检测是否为workspace ([6555daf](https://git.bjxgj.com/xgj/spaceflow/commit/6555dafe1f08a244525be3a0345cc585f2552086))
### 其他修改
- **ci-scripts:** released version 0.6.0 [no ci] ([d485758](https://git.bjxgj.com/xgj/spaceflow/commit/d48575827941cae6ffc7ae6ba911e5d4cf3bd7fa))
- **ci-shell:** released version 0.6.0 [no ci] ([a2d1239](https://git.bjxgj.com/xgj/spaceflow/commit/a2d12397997b309062a9d93af57a5588cdb82a79))
- **core:** released version 0.6.0 [no ci] ([21e1ec6](https://git.bjxgj.com/xgj/spaceflow/commit/21e1ec61a2de542e065034f32a259092dd7c0e0d))
- **period-summary:** released version 0.6.0 [no ci] ([6648dfb](https://git.bjxgj.com/xgj/spaceflow/commit/6648dfb31b459e8c4522cff342dfa87a4bdaab4b))
- **publish:** released version 0.8.0 [no ci] ([d7cd2e9](https://git.bjxgj.com/xgj/spaceflow/commit/d7cd2e9a7af178acdf91f16ae299c82e915db6e6))
## [0.5.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.4.0...@spaceflow/review@0.5.0) (2026-01-28)
### 新特性
- **core:** 优化包管理器检测与 npm 包处理逻辑 ([63f7fa4](https://git.bjxgj.com/xgj/spaceflow/commit/63f7fa4f55cb41583009b2ea313b5ad327615e52))
### 代码重构
- **core:** 优化配置合并逻辑，添加字段覆盖策略 ([18680e6](https://git.bjxgj.com/xgj/spaceflow/commit/18680e69b0d6e9e05c843ed3f07766830955d658))
### 其他修改
- **ci-scripts:** released version 0.5.0 [no ci] ([a87a1da](https://git.bjxgj.com/xgj/spaceflow/commit/a87a1da0490986c46c2a527cda5e7d0df9df6d03))
- **ci-shell:** released version 0.5.0 [no ci] ([920d9a8](https://git.bjxgj.com/xgj/spaceflow/commit/920d9a8165fe6eabf7a074eb65762f4693883438))
- **core:** released version 0.5.0 [no ci] ([ad20098](https://git.bjxgj.com/xgj/spaceflow/commit/ad20098ef954283dd6d9867a4d2535769cbb8377))
- **period-summary:** released version 0.5.0 [no ci] ([8e547e9](https://git.bjxgj.com/xgj/spaceflow/commit/8e547e9e6a6496a8c314c06cf6e88c97e623bc2d))
- **publish:** released version 0.7.0 [no ci] ([7124435](https://git.bjxgj.com/xgj/spaceflow/commit/712443516845f5bbc097af16ec6e90bb57b69fa3))
- 更新项目依赖锁定文件 ([19d2d1d](https://git.bjxgj.com/xgj/spaceflow/commit/19d2d1d86bb35b8ee5d3ad20be51b7aa68e83eff))
- 移除 npm registry 配置文件 ([2d9fac6](https://git.bjxgj.com/xgj/spaceflow/commit/2d9fac6db79e81a09ca8e031190d0ebb2781cc31))
- 调整依赖配置并添加npm registry配置 ([a754db1](https://git.bjxgj.com/xgj/spaceflow/commit/a754db1bad1bafcea50b8d2825aaf19457778f2e))
## [0.4.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.3.0...@spaceflow/review@0.4.0) (2026-01-28)
### 代码重构
- **publish:** 调整zod依赖的导入来源 ([574eef1](https://git.bjxgj.com/xgj/spaceflow/commit/574eef1910809a72a4b13acd4cb070e12dc42ce8))
- **review:** 调整zod依赖的导入路径 ([02014cd](https://git.bjxgj.com/xgj/spaceflow/commit/02014cdab9829df583f0f621150573b8c45a3ad7))
### 其他修改
- **ci-scripts:** released version 0.4.0 [no ci] ([364f696](https://git.bjxgj.com/xgj/spaceflow/commit/364f696d0df5d84be915cfaa9202a592073d9b46))
- **ci-shell:** released version 0.4.0 [no ci] ([7e6bf1d](https://git.bjxgj.com/xgj/spaceflow/commit/7e6bf1dabffc6250b918b89bb850d478d3f4b875))
- **core:** released version 0.4.0 [no ci] ([bc4cd89](https://git.bjxgj.com/xgj/spaceflow/commit/bc4cd89af70dce052e7e00fe413708790f65be61))
- **core:** 调整核心依赖与配置，新增Zod类型系统支持 ([def0751](https://git.bjxgj.com/xgj/spaceflow/commit/def0751577d9f3350494ca3c7bb4a4b087dab05e))
- **period-summary:** released version 0.4.0 [no ci] ([ca89a9b](https://git.bjxgj.com/xgj/spaceflow/commit/ca89a9b9436761e210dedfc38fb3c16ef39b0718))
- **publish:** released version 0.6.0 [no ci] ([b6d8d09](https://git.bjxgj.com/xgj/spaceflow/commit/b6d8d099fc439ce67f802d56e30dadaa28afed0e))
- 调整项目依赖配置 ([6802386](https://git.bjxgj.com/xgj/spaceflow/commit/6802386f38f4081a3b5d5c47ddc49e9ec2e4f28d))
## [0.3.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.2.0...@spaceflow/review@0.3.0) (2026-01-28)
### 代码重构
- **publish:** 调整包变更检测的日志输出格式 ([df35e92](https://git.bjxgj.com/xgj/spaceflow/commit/df35e92d614ce59e202643cf34a0fef2803412a1))
### 其他修改
- **ci-scripts:** released version 0.3.0 [no ci] ([9292b52](https://git.bjxgj.com/xgj/spaceflow/commit/9292b524f2b8171f8774fab4e4ef4b32991f5d3d))
- **ci-shell:** released version 0.3.0 [no ci] ([7b25e55](https://git.bjxgj.com/xgj/spaceflow/commit/7b25e557b628fdfa66d7a0be4ee21267906ac15f))
- **core:** released version 0.3.0 [no ci] ([bf8b005](https://git.bjxgj.com/xgj/spaceflow/commit/bf8b005ccbfcdd2061c18ae4ecdd476584ecbb53))
- **core:** 调整依赖配置 ([c86534a](https://git.bjxgj.com/xgj/spaceflow/commit/c86534ad213293ee2557ba5568549e8fbcb74ba5))
- **period-summary:** released version 0.3.0 [no ci] ([7e74c59](https://git.bjxgj.com/xgj/spaceflow/commit/7e74c59d90d88e061e693829f8196834d9858307))
- **publish:** released version 0.4.0 [no ci] ([be66220](https://git.bjxgj.com/xgj/spaceflow/commit/be662202c1e9e509368eb683a0d6df3afd876ff8))
- **publish:** released version 0.5.0 [no ci] ([8eecd19](https://git.bjxgj.com/xgj/spaceflow/commit/8eecd19c4dd3fbaa27187a9b24234e753fff5efe))
- 调整项目依赖配置 ([f4009cb](https://git.bjxgj.com/xgj/spaceflow/commit/f4009cb0c369b225c356584afb28a7ff5a1a89ec))
## [0.2.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.1.2...@spaceflow/review@0.2.0) (2026-01-28)
### 新特性
- **publish:** 增强包变更检测的日志输出 ([b89c5cc](https://git.bjxgj.com/xgj/spaceflow/commit/b89c5cc0654713b6482ee591325d4f92ad773600))
### 修复BUG
- **publish:** 修复分支锁定时未捕获异常处理器的资源泄漏问题 ([ae326e9](https://git.bjxgj.com/xgj/spaceflow/commit/ae326e95c0cea033893cf084cbf7413fb252bd33))
### 文档更新
- **core:** 更新核心框架README文档 ([0d98658](https://git.bjxgj.com/xgj/spaceflow/commit/0d98658f6ab01f119f98d3387fb5651d4d4351a8))
### 其他修改
- **ci-scripts:** released version 0.2.0 [no ci] ([716e9ad](https://git.bjxgj.com/xgj/spaceflow/commit/716e9ad0f32bde09c608143da78f0a4299017797))
- **ci-shell:** released version 0.2.0 [no ci] ([4f5314b](https://git.bjxgj.com/xgj/spaceflow/commit/4f5314b1002b90d7775a5ef51e618a3f227ae5a9))
- **core:** released version 0.2.0 [no ci] ([5a96529](https://git.bjxgj.com/xgj/spaceflow/commit/5a96529cabdce4fb150732b34c55e668c33cb50c))
- **period-summary:** released version 0.2.0 [no ci] ([66a4e20](https://git.bjxgj.com/xgj/spaceflow/commit/66a4e209519b64d946ec21b1d1695105fb9de106))
- **publish:** released version 0.2.0 [no ci] ([bc30a82](https://git.bjxgj.com/xgj/spaceflow/commit/bc30a82082bba4cc1a66c74c11dc0ad9deef4692))
- **publish:** released version 0.3.0 [no ci] ([972eca4](https://git.bjxgj.com/xgj/spaceflow/commit/972eca440dd333e8c5380124497c16fe6e3eea6c))
- 优化CI工作流的代码检出配置 ([d9740dd](https://git.bjxgj.com/xgj/spaceflow/commit/d9740dd6d1294068ffdcd7a12b61149773866a2a))
## [0.1.2](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.1.1...@spaceflow/review@0.1.2) (2026-01-28)
### 修复BUG
- **publish:** 修复预演模式下的交互式提示问题 ([0b785bf](https://git.bjxgj.com/xgj/spaceflow/commit/0b785bfddb9f35e844989bd3891817dc502302f8))
### 其他修改
- **ci-scripts:** released version 0.1.2 [no ci] ([ab9c100](https://git.bjxgj.com/xgj/spaceflow/commit/ab9c1000bcbe64d8a99ffa6bebb974c024b14325))
- **ci-shell:** released version 0.1.2 [no ci] ([bf7977b](https://git.bjxgj.com/xgj/spaceflow/commit/bf7977bed684b557555861b9dc0359eda3c5d476))
- **core:** released version 0.1.2 [no ci] ([8292dbe](https://git.bjxgj.com/xgj/spaceflow/commit/8292dbe59a200cc640a95b86afb6451ec0c044ce))
- **period-summary:** released version 0.1.2 [no ci] ([eaf41a0](https://git.bjxgj.com/xgj/spaceflow/commit/eaf41a0149ee4306361ccab0b3878bded79677df))
- **publish:** released version 0.1.2 [no ci] ([4786731](https://git.bjxgj.com/xgj/spaceflow/commit/4786731da7a21982dc1e912b1a5002f5ebba9104))
## [0.1.1](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.1.0...@spaceflow/review@0.1.1) (2026-01-28)
### 文档更新
- **publish:** 完善发布插件README文档 ([faa57b0](https://git.bjxgj.com/xgj/spaceflow/commit/faa57b095453c00fb3c9a7704bc31b63953c0ac5))
### 其他修改
- **ci-scripts:** released version 0.1.1 [no ci] ([19ca0d8](https://git.bjxgj.com/xgj/spaceflow/commit/19ca0d8461f9537f4318b772cad3ea395d2b3264))
- **ci-shell:** released version 0.1.1 [no ci] ([488a686](https://git.bjxgj.com/xgj/spaceflow/commit/488a6869240151e7d1cf37a3b177897c2b5d5c1e))
- **core:** released version 0.1.1 [no ci] ([0cf3a4d](https://git.bjxgj.com/xgj/spaceflow/commit/0cf3a4d37d7d1460e232dd30bc7ab8dc015ed11f))
- **period-summary:** released version 0.1.1 [no ci] ([b77e96b](https://git.bjxgj.com/xgj/spaceflow/commit/b77e96b1b768efa81d37143101057224fc3cef0f))
- **publish:** released version 0.1.1 [no ci] ([43ba6cb](https://git.bjxgj.com/xgj/spaceflow/commit/43ba6cb565ab84155ddc335b8bf6a72424e99b69))
## [0.1.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/review@0.0.1...@spaceflow/review@0.1.0) (2026-01-28)
### 新特性
- **core:** 添加同步解锁分支方法用于进程退出清理 ([cbec480](https://git.bjxgj.com/xgj/spaceflow/commit/cbec480511e074de3ccdc61226f3baa317cff907))
### 其他修改
- **ci-scripts:** released version 0.1.0 [no ci] ([57b3a1c](https://git.bjxgj.com/xgj/spaceflow/commit/57b3a1c826dafd5ec51d68b7471266efd5cc32b2))
- **ci-shell:** released version 0.1.0 [no ci] ([2283d9d](https://git.bjxgj.com/xgj/spaceflow/commit/2283d9d69ada1c071bef6c548dc756fe062893bd))
- **core:** released version 0.1.0 [no ci] ([f455607](https://git.bjxgj.com/xgj/spaceflow/commit/f45560735082840410e08e0d8113f366732a1243))
- **period-summary:** released version 0.1.0 [no ci] ([36fb7a4](https://git.bjxgj.com/xgj/spaceflow/commit/36fb7a486da82e1d8e4b0574c68b4473cd86b28e))
- **publish:** released version 0.1.0 [no ci] ([0ca1b54](https://git.bjxgj.com/xgj/spaceflow/commit/0ca1b54fd52e1721b5453dc1922c1d5b6a00acf4))
## 0.0.1 (2026-01-28)
### 其他修改
- **ci-scripts:** released version 0.0.1 [no ci] ([b38fb9b](https://git.bjxgj.com/xgj/spaceflow/commit/b38fb9ba56200ced1baf563b097faa8717693783))
- **ci-shell:** released version 0.0.1 [no ci] ([ec2a84b](https://git.bjxgj.com/xgj/spaceflow/commit/ec2a84b298c5fb989951caf42e2b016b3336f6a0))
- **core:** released version 0.0.1 [no ci] ([66497d6](https://git.bjxgj.com/xgj/spaceflow/commit/66497d60be04b4756a3362dbec4652177910165c))
- **period-summary:** released version 0.0.1 [no ci] ([7ab3504](https://git.bjxgj.com/xgj/spaceflow/commit/7ab3504750191b88643fe5db6b92bb08acc9ab5d))
- **publish:** released version 0.0.1 [no ci] ([16b0f64](https://git.bjxgj.com/xgj/spaceflow/commit/16b0f647cf7fe23b921947b4a53ac94076bbee9e))
- 重置所有包版本至 0.0.0 并清理 CHANGELOG 文件 ([f7efaf9](https://git.bjxgj.com/xgj/spaceflow/commit/f7efaf967467f1272e05d645720ee63941fe79be))

40
commands/review/package.json Normal file
View File

@@ -0,0 +1,40 @@
{
"name": "@spaceflow/review",
"version": "0.29.0",
"description": "Spaceflow 代码审查插件，使用 LLM 对 PR 代码进行自动审查",
"type": "module",
"main": "./dist/index.js",
"scripts": {
"build": "spaceflow build",
"dev": "spaceflow dev",
"test": "vitest run",
"test:cov": "vitest run --coverage"
},
"dependencies": {
"micromatch": "^4.0.8"
},
"devDependencies": {
"@nestjs/testing": "catalog:",
"@spaceflow/cli": "workspace:*",
"@swc/core": "catalog:",
"@types/micromatch": "^4.0.9",
"@types/node": "catalog:",
"typescript": "catalog:",
"@vitest/coverage-v8": "catalog:",
"unplugin-swc": "catalog:",
"vitest": "catalog:"
},
"peerDependencies": {
"@nestjs/common": "catalog:",
"@nestjs/config": "catalog:",
"@nestjs/swagger": "catalog:",
"@spaceflow/core": "workspace:*",
"class-transformer": "catalog:",
"class-validator": "catalog:",
"nest-commander": "catalog:"
},
"spaceflow": {
"type": "flow",
"entry": "."
}
}

364
commands/review/src/README.md Normal file
View File

@@ -0,0 +1,364 @@
# Review 模块
Review 是 spaceflow 的核心模块，提供基于 LLM 的自动化代码审查功能。支持在 GitHub Actions CI 环境中运行，也可在本地命令行使用。
## 目录结构
```text
review/
├── index.ts # 模块导出入口
├── review.module.ts # NestJS 模块定义
├── review.command.ts # CLI 命令定义
├── review.service.ts # 核心审查服务
├── review.service.spec.ts # 审查服务单元测试
├── issue-verify.service.ts # 历史问题验证服务
├── issue-verify.service.spec.ts # 验证服务单元测试
├── deletion-impact.service.ts # 删除代码影响分析服务
├── deletion-impact.service.spec.ts # 删除分析服务单元测试
├── parse-title-options.ts # PR 标题参数解析
├── parse-title-options.spec.ts # 标题解析单元测试
```
## 模块依赖
```text
ReviewModule
├── ConfigModule # 配置管理
├── GitProviderModule # Git Provider 适配器
├── ClaudeSetupModule # Claude CLI 配置
├── ReviewSpecModule # 审查规范加载
├── ReviewReportModule # 审查报告格式化
├── GitSdkModule # Git 命令封装
└── LlmProxyModule # LLM 统一代理（支持 OpenAI/Claude/Gemini）
```
## 核心功能
### 1. ReviewCommand
CLI 命令入口，支持以下参数：
| 参数 | 简写 | 说明 |
| --------------------------------- | ---- | ------------------------------------- |
| `--dry-run` | `-d` | 仅打印将要执行的操作，不实际提交评论 |
| `--ci` | `-c` | 在 CI 环境中运行 |
| `--pr-number <number>` | `-p` | PR 编号 |
| `--base <ref>` | `-b` | 基准分支/tag |
| `--head <ref>` | | 目标分支/tag |
| `--verbose [level]` | `-v` | 详细输出 (1: 过程日志, 2: 含提示词) |
| `--includes <patterns...>` | `-i` | 文件 glob 过滤模式 |
| `--llm-mode <mode>` | `-l` | LLM 模式: claude-code, openai, gemini |
| `--files <files...>` | `-f` | 仅审查指定文件 |
| `--commits <commits...>` | | 仅审查指定 commits |
| `--verify-fixes` | | 验证历史问题是否已修复 |
| `--no-verify-fixes` | | 禁用历史问题验证 |
| `--verify-concurrency <n>` | | 验证并发数（默认 10） |
| `--analyze-deletions` | | 分析删除代码影响 |
| `--deletion-only` | | 仅执行删除代码分析 |
| `--deletion-analysis-mode <mode>` | | 删除分析模式: openai, claude-code |
| `--output-format <format>` | `-o` | 输出格式: markdown, terminal, json |
| `--generate-description` | | 使用 AI 生成 PR 功能描述 |
**环境变量**：
- `GITHUB_TOKEN`: GitHub API Token
- `GITHUB_REPOSITORY`: 仓库名称 (owner/repo 格式)
- `GITHUB_REF_NAME`: 当前分支名称
- `GITHUB_EVENT_PATH`: 事件文件路径
### 2. ReviewService
核心审查服务，主要功能：
#### 2.1 审查流程
```text
getContextFromEnv() # 从环境变量/配置构建上下文
↓
execute() # 执行审查主流程
↓
┌───────────────────────────────────────┐
│ 1. 加载审查规范 (ReviewSpec) │
│ 2. 获取 PR/分支变更信息 │
│ 3. 过滤文件 (files/commits/includes) │
│ 4. 获取文件内容并构建行号-commit 映射 │
│ 5. 构建审查提示词 │
│ 6. 并行调用 LLM 审查各文件 │
│ 7. 过滤/格式化审查结果 │
│ 8. 验证历史问题修复状态 │
│ 9. 提交/更新 PR 评论 │
│ 10. 可选：删除代码影响分析 │
└───────────────────────────────────────┘
```
#### 2.2 审查结果 Schema
```typescript
interface ReviewResult {
success: boolean;
description: string; // PR 功能描述
issues: ReviewIssue[]; // 发现的问题列表
summary: FileSummary[]; // 各文件审查总结
deletionImpact?: DeletionImpactResult; // 删除代码影响
round: number; // 审查轮次
}
interface ReviewIssue {
file: string; // 文件路径
line: string; // 行号 (如 "123" 或 "123-125")
ruleId: string; // 规则 ID
specFile: string; // 规则来源文件
reason: string; // 问题描述
suggestion?: string; // 修改建议
severity?: "error" | "warn"; // 严重程度
commit?: string; // 相关 commit SHA
code?: string; // 问题代码片段
date?: string; // 发现时间
fixed?: string; // 修复时间
valid?: "true" | "false"; // 问题有效性
round?: number; // 发现轮次
}
```
#### 2.3 关键方法
| 方法 | 说明 |
| ----------------------------- | ------------------------------ |
| `getContextFromEnv()` | 从环境变量和配置构建审查上下文 |
| `execute()` | 执行完整审查流程 |
| `executeDeletionOnly()` | 仅执行删除代码分析 |
| `buildReviewPrompt()` | 为每个文件构建审查提示词 |
| `runLLMReview()` | 调用 LLM 执行审查 |
| `callLLM()` | 并行审查多个文件 |
| `reviewSingleFile()` | 审查单个文件 |
| `getFileContents()` | 获取文件内容并构建行号映射 |
| `buildLineCommitMap()` | 构建行号到 commit 的映射 |
| `filterDuplicateIssues()` | 过滤重复问题 |
| `postOrUpdateReviewComment()` | 发布/更新 PR 评论 |
| `generatePrDescription()` | AI 生成 PR 功能描述 |
### 3. IssueVerifyService
历史问题验证服务，用于检查之前发现的问题是否已被修复。
#### 3.1 验证流程
```text
verifyIssueFixes()
↓
┌─────────────────────────────────────┐
│ 1. 跳过已修复/无效的问题 │
│ 2. 检查文件是否已删除 │
│ 3. 并行调用 LLM 验证各问题 │
│ 4. 更新问题的 fixed/valid 状态 │
└─────────────────────────────────────┘
```
#### 3.2 验证结果
```typescript
interface VerifyResult {
fixed: boolean; // 问题是否已修复
valid: boolean; // 问题是否有效（非误报）
reason: string; // 判断依据
}
```
### 4. DeletionImpactService
删除代码影响分析服务，评估删除代码可能带来的风险。
#### 4.1 分析流程
```text
analyzeDeletionImpact()
↓
┌─────────────────────────────────────┐
│ 1. 获取删除的代码块 │
│ - Git Provider API 模式：从 PR diff 获取 │
│ - Git Diff 模式：本地 git 命令 │
│ 2. 查找代码引用关系 (git grep) │
│ 3. 调用 LLM 分析影响 │
│ - OpenAI 模式：标准 chat │
│ - Claude Agent 模式：可用工具 │
└─────────────────────────────────────┘
```
#### 4.2 风险等级
| 等级 | 说明 |
| -------- | ---------------------------- |
| `high` | 可能导致编译错误或运行时异常 |
| `medium` | 可能影响部分功能行为 |
| `low` | 影响较小 |
| `none` | 无影响（清理无用代码） |
#### 4.3 分析结果
```typescript
interface DeletionImpactResult {
impacts: DeletionImpact[];
summary: string;
}
interface DeletionImpact {
file: string; // 被删除代码所在文件
deletedCode: string; // 删除代码摘要
riskLevel: "high" | "medium" | "low" | "none";
affectedFiles: string[]; // 可能受影响的文件
reason: string; // 影响分析说明
suggestion?: string; // 建议处理方式
}
```
### 5. parseTitleOptions
从 PR 标题解析命令参数，支持在标题末尾添加 `[/ai-review ...]` 格式的参数。
**示例**：
```text
feat: 添加新功能 [/ai-review -l openai -v 2]
```
**支持的参数**：
- `-l, --llm-mode <mode>`: LLM 模式
- `-v, --verbose [level]`: 详细输出级别
- `-d, --dry-run`: 仅打印不执行
- `-i, --includes <pattern>`: 文件过滤模式
- `--verify-fixes` / `--no-verify-fixes`: 历史问题验证
- `--analyze-deletions`: 分析删除代码
- `--deletion-only`: 仅执行删除分析
- `--deletion-analysis-mode <mode>`: 删除分析模式
## 配置项
在 `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 配置
},
},
};
```
## 使用示例
### CI 环境
```yaml
# .github/workflows/ai-review.yml
name: AI Review
on:
pull_request:
types: [opened, synchronize]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Review
run: npx spaceflow review --ci -l openai
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
```
### 本地命令行
```bash
# 审查 PR
npx spaceflow review -p 123 -l openai
# 审查两个分支之间的差异
npx spaceflow review -b main --head feature/xxx -l openai
# 仅审查指定文件
npx spaceflow review -f src/app.ts -l openai
# 详细输出
npx spaceflow review -p 123 -l openai -v 2
# 仅分析删除代码
npx spaceflow review -p 123 --deletion-only -l openai
```
## 审查规范
审查规范文件位于 `.spaceflow/review-spec/` 目录，使用 Markdown 格式定义规则。
详见 [ReviewSpec 模块文档](../../shared/review-spec/README.md)。
## 输出格式
### Markdown 格式（PR 评论）
包含以下部分：
- PR 功能描述
- 问题列表（按严重程度分组）
- 各文件审查总结
- 删除代码影响分析（如启用）
- 隐藏的 JSON 数据（用于增量审查）
### Terminal 格式
彩色终端输出，适合本地调试。
### JSON 格式
结构化 JSON 输出，适合程序处理。
## 增量审查
AI Review 支持增量审查，即在同一个 PR 上多次运行时：
1. **问题去重**：不会重复报告已存在的问题
2. **修复验证**：自动验证历史问题是否已修复
3. **轮次追踪**：记录每个问题的发现轮次
4. **评论更新**：更新而非新增评论
## 注意事项
1. **Token 限制**：单个文件审查的提示词长度受 LLM token 限制
2. **并发控制**：可通过 `concurrency` 配置控制并行审查数量
3. **超时处理**：可通过 `timeout` 配置单文件审查超时时间
4. **重试机制**：可通过 `retries` 和 `retryDelay` 配置重试策略

3
commands/review/src/__mocks__/@anthropic-ai/claude-agent-sdk.js Normal file
View File

@@ -0,0 +1,3 @@
module.exports = {
query: jest.fn(),
};

4
commands/review/src/__mocks__/json-stringify-pretty-compact.ts Normal file
View File

@@ -0,0 +1,4 @@
// Mock for json-stringify-pretty-compact ESM module
export default function stringify(obj: unknown, options: { indent?: number } = {}): string {
return JSON.stringify(obj, null, options.indent || 2);
}

974
commands/review/src/deletion-impact.service.spec.ts Normal file
View File

@@ -0,0 +1,974 @@
import { vi, type Mocked, type Mock } from "vitest";
import { Test, TestingModule } from "@nestjs/testing";
import { LlmProxyService, GitProviderService } from "@spaceflow/core";
import { DeletionImpactService } from "./deletion-impact.service";
import * as child_process from "child_process";
import { EventEmitter } from "events";
vi.mock("@anthropic-ai/claude-agent-sdk", () => ({
query: vi.fn(),
}));
vi.mock("child_process");
describe("DeletionImpactService", () => {
let service: DeletionImpactService;
let llmProxyService: Mocked<LlmProxyService>;
let gitProvider: Mocked<GitProviderService>;
beforeEach(async () => {
const mockLlmProxyService = {
chatStream: vi.fn(),
};
const mockGitProvider = {
getPullRequestFiles: vi.fn(),
getPullRequestDiff: vi.fn(),
};
const module: TestingModule = await Test.createTestingModule({
providers: [
DeletionImpactService,
{ provide: LlmProxyService, useValue: mockLlmProxyService },
{ provide: GitProviderService, useValue: mockGitProvider },
],
}).compile();
service = module.get<DeletionImpactService>(DeletionImpactService);
llmProxyService = module.get(LlmProxyService) as Mocked<LlmProxyService>;
gitProvider = module.get(GitProviderService) as Mocked<GitProviderService>;
});
describe("analyzeDeletionImpact", () => {
it("should return early if no parameters provided", async () => {
const result = await service.analyzeDeletionImpact({}, "openai", 1);
expect(result.impacts).toHaveLength(0);
expect(result.summary).toBe("缺少必要参数");
});
it("should extract blocks and analyze with LLM (Gitea API source)", async () => {
const context = {
owner: "owner",
repo: "repo",
prNumber: 123,
};
const mockFiles = [
{
filename: "test.ts",
patch: "@@ -1,1 +1,0 @@\n-const oldCode = 1;",
deletions: 1,
},
];
gitProvider.getPullRequestFiles.mockResolvedValue(mockFiles as any);
// Mock LLM response
const mockStream = (async function* () {
yield {
type: "result",
response: {
structuredOutput: {
impacts: [
{
file: "test.ts",
deletedCode: "const oldCode",
riskLevel: "low",
affectedFiles: [],
reason: "Clean up",
suggestion: "None",
},
],
summary: "Safe deletion",
},
},
};
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
// Mock git grep (for findCodeReferences)
const mockProcess = new EventEmitter() as any;
mockProcess.stdout = new EventEmitter();
mockProcess.stderr = new EventEmitter();
(child_process.spawn as Mock).mockReturnValue(mockProcess);
process.nextTick(() => {
mockProcess.stdout.emit("data", ""); // No references found
mockProcess.emit("close", 0);
});
const result = await service.analyzeDeletionImpact(context, "openai", 1);
expect(result.impacts).toHaveLength(1);
expect(result.summary).toBe("Safe deletion");
expect(gitProvider.getPullRequestFiles).toHaveBeenCalled();
});
});
describe("parseDeletedBlocksFromPatch", () => {
it("should correctly parse deleted lines from patch", () => {
const patch = "@@ -10,2 +10,1 @@\n-line 1\n-line 2\n+line 1 modified";
const blocks = (service as any).parseDeletedBlocksFromPatch("test.ts", patch);
expect(blocks).toHaveLength(1);
expect(blocks[0]).toEqual({
file: "test.ts",
startLine: 10,
endLine: 11,
content: "line 1\nline 2",
});
});
});
describe("extractIdentifiers", () => {
it("should extract function names", () => {
const code = "function testFunc() {}\nasync function asyncFunc() {}";
const ids = (service as any).extractIdentifiers(code);
expect(ids).toContain("testFunc");
expect(ids).toContain("asyncFunc");
});
it("should extract class names", () => {
const code = "class MyClass {}";
const ids = (service as any).extractIdentifiers(code);
expect(ids).toContain("MyClass");
});
it("should extract interface names", () => {
const code = "interface MyInterface {}";
const ids = (service as any).extractIdentifiers(code);
expect(ids).toContain("MyInterface");
});
it("should extract type names", () => {
const code = "type MyType = string;";
const ids = (service as any).extractIdentifiers(code);
expect(ids).toContain("MyType");
});
it("should extract exported variable names", () => {
const code = "export const MY_CONST = 1;\nexport let myVar = 2;";
const ids = (service as any).extractIdentifiers(code);
expect(ids).toContain("MY_CONST");
expect(ids).toContain("myVar");
});
it("should extract method names", () => {
const code = "async getData() {\n return [];\n}";
const ids = (service as any).extractIdentifiers(code);
expect(ids).toContain("getData");
});
it("should not extract control flow keywords as methods", () => {
const code = "if (true) {\n}\nfor (const x of arr) {\n}\nwhile (true) {\n}";
const ids = (service as any).extractIdentifiers(code);
expect(ids).not.toContain("if");
expect(ids).not.toContain("for");
expect(ids).not.toContain("while");
});
it("should deduplicate identifiers", () => {
const code = "function test() {}\nfunction test() {}";
const ids = (service as any).extractIdentifiers(code);
const testCount = ids.filter((id: string) => id === "test").length;
expect(testCount).toBe(1);
});
});
describe("extractDeletedBlocksFromChangedFiles", () => {
it("should extract blocks from files with patch", () => {
const changedFiles = [
{
filename: "test.ts",
patch: "@@ -5,3 +5,1 @@\n-const a = 1;\n-const b = 2;\n+const c = 3;",
},
];
const blocks = (service as any).extractDeletedBlocksFromChangedFiles(changedFiles);
expect(blocks.length).toBeGreaterThanOrEqual(1);
expect(blocks[0].file).toBe("test.ts");
});
it("should skip files without filename or patch", () => {
const changedFiles = [{ filename: "", patch: "" }, { patch: "some patch" }];
const blocks = (service as any).extractDeletedBlocksFromChangedFiles(changedFiles);
expect(blocks).toHaveLength(0);
});
it("should filter out comment-only blocks", () => {
const changedFiles = [
{
filename: "test.ts",
patch: "@@ -1,2 +1,0 @@\n-// this is a comment\n-/* another comment */",
},
];
const blocks = (service as any).extractDeletedBlocksFromChangedFiles(changedFiles);
expect(blocks).toHaveLength(0);
});
});
describe("extractDeletedBlocksFromDiffText", () => {
it("should parse diff text with multiple files", () => {
const diffText = `diff --git a/file1.ts b/file1.ts
--- a/file1.ts
+++ b/file1.ts
@@ -1,2 +1,1 @@
-const old1 = 1;
-const old2 = 2;
+const new1 = 1;
diff --git a/file2.ts b/file2.ts
--- a/file2.ts
+++ b/file2.ts
@@ -5,1 +5,0 @@
-function removed() {}`;
const blocks = (service as any).extractDeletedBlocksFromDiffText(diffText);
expect(blocks.length).toBeGreaterThanOrEqual(1);
});
it("should handle empty diff text", () => {
const blocks = (service as any).extractDeletedBlocksFromDiffText("");
expect(blocks).toHaveLength(0);
});
it("should skip files without header match", () => {
const diffText = "some random text without diff header";
const blocks = (service as any).extractDeletedBlocksFromDiffText(diffText);
expect(blocks).toHaveLength(0);
});
it("should save last delete block at end of file", () => {
const diffText = `diff --git a/test.ts b/test.ts
--- a/test.ts
+++ b/test.ts
@@ -1,2 +1,0 @@
-const a = 1;
-const b = 2;`;
const blocks = (service as any).extractDeletedBlocksFromDiffText(diffText);
expect(blocks).toHaveLength(1);
expect(blocks[0].content).toContain("const a = 1;");
expect(blocks[0].content).toContain("const b = 2;");
});
});
describe("filterMeaningfulBlocks", () => {
it("should keep blocks with meaningful code", () => {
const blocks = [{ file: "test.ts", startLine: 1, endLine: 1, content: "const x = 1;" }];
const result = (service as any).filterMeaningfulBlocks(blocks);
expect(result).toHaveLength(1);
});
it("should filter out blocks with only comments", () => {
const blocks = [
{ file: "test.ts", startLine: 1, endLine: 2, content: "// comment\n* another" },
];
const result = (service as any).filterMeaningfulBlocks(blocks);
expect(result).toHaveLength(0);
});
it("should filter out blocks with only blank lines", () => {
const blocks = [{ file: "test.ts", startLine: 1, endLine: 2, content: " \n " }];
const result = (service as any).filterMeaningfulBlocks(blocks);
expect(result).toHaveLength(0);
});
});
describe("parseDeletedBlocksFromPatch - more branches", () => {
it("should handle multiple hunks", () => {
const patch = "@@ -1,1 +1,0 @@\n-line1\n@@ -10,1 +9,0 @@\n-line10";
const blocks = (service as any).parseDeletedBlocksFromPatch("test.ts", patch);
expect(blocks).toHaveLength(2);
});
it("should save block when encountering new hunk after deletions", () => {
const patch = "@@ -1,2 +1,0 @@\n-line1\n-line2\n@@ -10,1 +8,1 @@\n-old\n+new";
const blocks = (service as any).parseDeletedBlocksFromPatch("test.ts", patch);
expect(blocks.length).toBeGreaterThanOrEqual(1);
});
it("should handle added lines breaking delete block", () => {
const patch = "@@ -1,3 +1,2 @@\n-deleted1\n+added1\n-deleted2";
const blocks = (service as any).parseDeletedBlocksFromPatch("test.ts", patch);
expect(blocks.length).toBeGreaterThanOrEqual(1);
});
it("should save last block at end of patch", () => {
const patch = "@@ -1,1 +1,0 @@\n-const x = 1;";
const blocks = (service as any).parseDeletedBlocksFromPatch("test.ts", patch);
expect(blocks).toHaveLength(1);
expect(blocks[0].startLine).toBe(1);
expect(blocks[0].endLine).toBe(1);
});
});
describe("analyzeDeletionImpact - more branches", () => {
it("should use git-diff source with baseRef/headRef", async () => {
const mockProcess = new EventEmitter() as any;
mockProcess.stdout = new EventEmitter();
mockProcess.stderr = new EventEmitter();
(child_process.spawn as Mock).mockReturnValue(mockProcess);
const context = { baseRef: "main", headRef: "feature" };
// resolveRef 会调用 git rev-parse，然后 getDeletedCodeBlocks 调用 git diff
// 第一次 spawn: rev-parse main
// 第二次 spawn: rev-parse feature
// 第三次 spawn: git diff
let callCount = 0;
(child_process.spawn as Mock).mockImplementation(() => {
callCount++;
const proc = new EventEmitter() as any;
proc.stdout = new EventEmitter();
proc.stderr = new EventEmitter();
process.nextTick(() => {
if (callCount <= 2) {
// rev-parse 成功
proc.stdout.emit("data", "abc123");
proc.emit("close", 0);
} else {
// git diff 返回空
proc.stdout.emit("data", "");
proc.emit("close", 0);
}
});
return proc;
});
const result = await service.analyzeDeletionImpact(context, "openai", 1);
expect(result.impacts).toHaveLength(0);
expect(result.summary).toBe("没有发现删除的代码");
});
it("should use PR diff API when no patch in files", async () => {
const context = { owner: "o", repo: "r", prNumber: 1 };
gitProvider.getPullRequestFiles.mockResolvedValue([
{ filename: "test.ts", deletions: 5 },
] as any);
gitProvider.getPullRequestDiff.mockResolvedValue(
`diff --git a/test.ts b/test.ts
--- a/test.ts
+++ b/test.ts
@@ -1,1 +1,0 @@
-const removed = true;`,
);
// Mock git grep for findCodeReferences
const mockProcess = new EventEmitter() as any;
mockProcess.stdout = new EventEmitter();
mockProcess.stderr = new EventEmitter();
(child_process.spawn as Mock).mockReturnValue(mockProcess);
process.nextTick(() => {
mockProcess.emit("close", 1); // grep 没找到
});
const mockStream = (async function* () {
yield {
type: "result",
response: {
structuredOutput: { impacts: [], summary: "ok" },
},
};
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const result = await service.analyzeDeletionImpact(context, "openai", 1);
expect(gitProvider.getPullRequestDiff).toHaveBeenCalled();
expect(result).toBeDefined();
});
it("should handle PR diff API failure", async () => {
const context = { owner: "o", repo: "r", prNumber: 1 };
gitProvider.getPullRequestFiles.mockResolvedValue([
{ filename: "test.ts", deletions: 5 },
] as any);
gitProvider.getPullRequestDiff.mockRejectedValue(new Error("API error"));
const result = await service.analyzeDeletionImpact(context, "openai", 1);
expect(result.impacts).toHaveLength(0);
expect(result.summary).toBe("没有发现删除的代码");
});
it("should return early when no deletions in files", async () => {
const context = { owner: "o", repo: "r", prNumber: 1 };
gitProvider.getPullRequestFiles.mockResolvedValue([
{ filename: "test.ts", additions: 5, deletions: 0 },
] as any);
const result = await service.analyzeDeletionImpact(context, "openai", 1);
expect(result.impacts).toHaveLength(0);
});
it("should filter blocks by includes", async () => {
const context = {
owner: "o",
repo: "r",
prNumber: 1,
includes: ["*.service.ts"],
};
gitProvider.getPullRequestFiles.mockResolvedValue([
{
filename: "test.controller.ts",
patch: "@@ -1,1 +1,0 @@\n-const x = 1;",
deletions: 1,
},
] as any);
const result = await service.analyzeDeletionImpact(context, "openai", 1);
expect(result.impacts).toHaveLength(0);
});
it("should use verbose logging", async () => {
const context = { owner: "o", repo: "r", prNumber: 1 };
gitProvider.getPullRequestFiles.mockResolvedValue([] as any);
const result = await service.analyzeDeletionImpact(context, "openai", 1);
expect(result.impacts).toHaveLength(0);
});
});
describe("analyzeWithLLM", () => {
it("should handle error event from stream", async () => {
const mockStream = (async function* () {
yield { type: "error", message: "LLM failed" };
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const blocks = [{ file: "test.ts", startLine: 1, endLine: 1, content: "const x = 1;" }];
const refs = new Map<string, string[]>();
const result = await (service as any).analyzeWithLLM(blocks, refs, "openai");
expect(result.impacts).toHaveLength(0);
expect(result.summary).toBe("分析返回格式无效");
});
it("should handle invalid result from LLM", async () => {
const mockStream = (async function* () {
yield { type: "result", response: { structuredOutput: null } };
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const blocks = [{ file: "test.ts", startLine: 1, endLine: 1, content: "const x = 1;" }];
const refs = new Map<string, string[]>();
const result = await (service as any).analyzeWithLLM(blocks, refs, "openai");
expect(result.impacts).toHaveLength(0);
expect(result.summary).toBe("分析返回格式无效");
});
it("should handle array result from LLM", async () => {
const mockStream = (async function* () {
yield { type: "result", response: { structuredOutput: [] } };
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const blocks = [{ file: "test.ts", startLine: 1, endLine: 1, content: "const x = 1;" }];
const refs = new Map<string, string[]>();
const result = await (service as any).analyzeWithLLM(blocks, refs, "openai");
expect(result.impacts).toHaveLength(0);
});
it("should handle LLM call exception", async () => {
llmProxyService.chatStream.mockImplementation(() => {
throw new Error("Connection failed");
});
const consoleSpy = vi.spyOn(console, "error").mockImplementation(() => {});
const blocks = [{ file: "test.ts", startLine: 1, endLine: 1, content: "const x = 1;" }];
const refs = new Map<string, string[]>();
const result = await (service as any).analyzeWithLLM(blocks, refs, "openai");
expect(result.summary).toBe("LLM 调用失败");
consoleSpy.mockRestore();
});
it("should handle non-Error exception", async () => {
llmProxyService.chatStream.mockImplementation(() => {
throw "string error";
});
const consoleSpy = vi.spyOn(console, "error").mockImplementation(() => {});
const blocks = [{ file: "test.ts", startLine: 1, endLine: 1, content: "const x = 1;" }];
const refs = new Map<string, string[]>();
const result = await (service as any).analyzeWithLLM(blocks, refs, "openai");
expect(result.summary).toBe("LLM 调用失败");
consoleSpy.mockRestore();
});
it("should include references in prompt", async () => {
const mockStream = (async function* () {
yield {
type: "result",
response: { structuredOutput: { impacts: [], summary: "ok" } },
};
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const blocks = [{ file: "test.ts", startLine: 1, endLine: 5, content: "const x = 1;" }];
const refs = new Map([["test.ts:1-5", ["other.ts", "another.ts"]]]);
const result = await (service as any).analyzeWithLLM(blocks, refs, "openai");
expect(result.summary).toBe("ok");
});
it("should log prompts with verbose=2", async () => {
const mockStream = (async function* () {
yield {
type: "result",
response: { structuredOutput: { impacts: [], summary: "ok" } },
};
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const blocks = [{ file: "test.ts", startLine: 1, endLine: 1, content: "const x = 1;" }];
const refs = new Map<string, string[]>();
const result = await (service as any).analyzeWithLLM(blocks, refs, "openai", 2);
expect(result.summary).toBe("ok");
});
});
describe("analyzeWithAgent", () => {
it("should handle successful agent analysis", async () => {
const mockStream = (async function* () {
yield {
type: "result",
response: { structuredOutput: { impacts: [], summary: "agent ok" } },
};
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const blocks = [{ file: "test.ts", startLine: 1, endLine: 1, content: "const x = 1;" }];
const refs = new Map<string, string[]>();
const result = await (service as any).analyzeWithAgent("claude-code", blocks, refs);
expect(result.summary).toBe("agent ok");
});
it("should handle agent error event", async () => {
const mockStream = (async function* () {
yield { type: "error", message: "Agent failed" };
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const consoleSpy = vi.spyOn(console, "error").mockImplementation(() => {});
const blocks = [{ file: "test.ts", startLine: 1, endLine: 1, content: "const x = 1;" }];
const refs = new Map<string, string[]>();
const result = await (service as any).analyzeWithAgent("claude-code", blocks, refs);
expect(result.impacts).toHaveLength(0);
consoleSpy.mockRestore();
});
it("should handle agent call exception", async () => {
llmProxyService.chatStream.mockImplementation(() => {
throw new Error("Agent connection failed");
});
const consoleSpy = vi.spyOn(console, "error").mockImplementation(() => {});
const blocks = [{ file: "test.ts", startLine: 1, endLine: 1, content: "const x = 1;" }];
const refs = new Map<string, string[]>();
const result = await (service as any).analyzeWithAgent("claude-code", blocks, refs);
expect(result.summary).toBe("Agent 调用失败");
consoleSpy.mockRestore();
});
it("should handle non-Error agent exception", async () => {
llmProxyService.chatStream.mockImplementation(() => {
throw "agent string error";
});
const consoleSpy = vi.spyOn(console, "error").mockImplementation(() => {});
const blocks = [{ file: "test.ts", startLine: 1, endLine: 1, content: "const x = 1;" }];
const refs = new Map<string, string[]>();
const result = await (service as any).analyzeWithAgent("claude-code", blocks, refs);
expect(result.summary).toBe("Agent 调用失败");
consoleSpy.mockRestore();
});
it("should handle invalid agent result", async () => {
const mockStream = (async function* () {
yield { type: "result", response: { structuredOutput: null } };
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const blocks = [{ file: "test.ts", startLine: 1, endLine: 1, content: "const x = 1;" }];
const refs = new Map<string, string[]>();
const result = await (service as any).analyzeWithAgent("claude-code", blocks, refs);
expect(result.summary).toBe("分析返回格式无效");
});
it("should log with verbose=2", async () => {
const mockStream = (async function* () {
yield {
type: "result",
response: { structuredOutput: { impacts: [], summary: "ok" } },
};
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const blocks = [{ file: "test.ts", startLine: 1, endLine: 1, content: "const x = 1;" }];
const refs = new Map<string, string[]>();
const result = await (service as any).analyzeWithAgent("claude-code", blocks, refs, 2);
expect(result.summary).toBe("ok");
});
});
describe("resolveRef", () => {
it("should return SHA directly for commit hash", async () => {
const result = await (service as any).resolveRef("abc1234", 1);
expect(result).toBe("abc1234");
});
it("should return origin/ ref directly", async () => {
const result = await (service as any).resolveRef("origin/main", 1);
expect(result).toBe("origin/main");
});
it("should throw for empty ref", async () => {
await expect((service as any).resolveRef("")).rejects.toThrow("ref 参数不能为空");
});
it("should try local branch first", async () => {
const mockProcess = new EventEmitter() as any;
mockProcess.stdout = new EventEmitter();
mockProcess.stderr = new EventEmitter();
(child_process.spawn as Mock).mockReturnValue(mockProcess);
process.nextTick(() => {
mockProcess.stdout.emit("data", "abc123");
mockProcess.emit("close", 0);
});
const result = await (service as any).resolveRef("main", 1);
expect(result).toBe("main");
});
it("should fallback to origin/ when local fails", async () => {
let callCount = 0;
(child_process.spawn as Mock).mockImplementation(() => {
callCount++;
const proc = new EventEmitter() as any;
proc.stdout = new EventEmitter();
proc.stderr = new EventEmitter();
process.nextTick(() => {
if (callCount === 1) {
// rev-parse --verify main 失败
proc.stderr.emit("data", "not found");
proc.emit("close", 1);
} else {
// rev-parse --verify origin/main 成功
proc.stdout.emit("data", "abc123");
proc.emit("close", 0);
}
});
return proc;
});
const result = await (service as any).resolveRef("main", 1);
expect(result).toBe("origin/main");
});
it("should try fetch when both local and origin fail", async () => {
let callCount = 0;
(child_process.spawn as Mock).mockImplementation(() => {
callCount++;
const proc = new EventEmitter() as any;
proc.stdout = new EventEmitter();
proc.stderr = new EventEmitter();
process.nextTick(() => {
if (callCount <= 2) {
// rev-parse 失败
proc.stderr.emit("data", "not found");
proc.emit("close", 1);
} else {
// fetch 成功
proc.stdout.emit("data", "");
proc.emit("close", 0);
}
});
return proc;
});
const result = await (service as any).resolveRef("develop", 1);
expect(result).toBe("origin/develop");
});
it("should return original ref when all attempts fail", async () => {
(child_process.spawn as Mock).mockImplementation(() => {
const proc = new EventEmitter() as any;
proc.stdout = new EventEmitter();
proc.stderr = new EventEmitter();
process.nextTick(() => {
proc.stderr.emit("data", "error");
proc.emit("close", 1);
});
return proc;
});
const result = await (service as any).resolveRef("nonexistent", 1);
expect(result).toBe("nonexistent");
});
});
describe("runGitCommand", () => {
it("should resolve with stdout on success", async () => {
const mockProcess = new EventEmitter() as any;
mockProcess.stdout = new EventEmitter();
mockProcess.stderr = new EventEmitter();
(child_process.spawn as Mock).mockReturnValue(mockProcess);
process.nextTick(() => {
mockProcess.stdout.emit("data", "output");
mockProcess.emit("close", 0);
});
const result = await (service as any).runGitCommand(["status"]);
expect(result).toBe("output");
});
it("should reject on non-zero exit code", async () => {
const mockProcess = new EventEmitter() as any;
mockProcess.stdout = new EventEmitter();
mockProcess.stderr = new EventEmitter();
(child_process.spawn as Mock).mockReturnValue(mockProcess);
process.nextTick(() => {
mockProcess.stderr.emit("data", "error msg");
mockProcess.emit("close", 1);
});
await expect((service as any).runGitCommand(["bad"])).rejects.toThrow("Git 命令失败");
});
it("should reject on spawn error", async () => {
const mockProcess = new EventEmitter() as any;
mockProcess.stdout = new EventEmitter();
mockProcess.stderr = new EventEmitter();
(child_process.spawn as Mock).mockReturnValue(mockProcess);
process.nextTick(() => {
mockProcess.emit("error", new Error("spawn failed"));
});
await expect((service as any).runGitCommand(["bad"])).rejects.toThrow("spawn failed");
});
});
describe("findCodeReferences", () => {
it("should find references using git grep", async () => {
(child_process.spawn as Mock).mockImplementation(() => {
const proc = new EventEmitter() as any;
proc.stdout = new EventEmitter();
proc.stderr = new EventEmitter();
process.nextTick(() => {
proc.stdout.emit("data", "other.ts\nanother.ts\n");
proc.emit("close", 0);
});
return proc;
});
const blocks = [
{ file: "test.ts", startLine: 1, endLine: 5, content: "function myFunc() {}" },
];
const refs = await (service as any).findCodeReferences(blocks);
expect(refs.size).toBeGreaterThanOrEqual(0);
});
it("should skip short identifiers", async () => {
(child_process.spawn as Mock).mockImplementation(() => {
const proc = new EventEmitter() as any;
proc.stdout = new EventEmitter();
proc.stderr = new EventEmitter();
process.nextTick(() => {
proc.emit("close", 1);
});
return proc;
});
const blocks = [{ file: "test.ts", startLine: 1, endLine: 1, content: "const x = 1;" }];
const refs = await (service as any).findCodeReferences(blocks);
expect(refs.size).toBe(0);
});
it("should handle grep errors gracefully", async () => {
(child_process.spawn as Mock).mockImplementation(() => {
const proc = new EventEmitter() as any;
proc.stdout = new EventEmitter();
proc.stderr = new EventEmitter();
process.nextTick(() => {
proc.stderr.emit("data", "error");
proc.emit("close", 1);
});
return proc;
});
const blocks = [
{ file: "test.ts", startLine: 1, endLine: 5, content: "function longFuncName() {}" },
];
const refs = await (service as any).findCodeReferences(blocks);
expect(refs.size).toBe(0);
});
});
describe("getDeletedCodeBlocks", () => {
it("should parse deleted blocks from git diff output", async () => {
let callCount = 0;
(child_process.spawn as Mock).mockImplementation(() => {
callCount++;
const proc = new EventEmitter() as any;
proc.stdout = new EventEmitter();
proc.stderr = new EventEmitter();
process.nextTick(() => {
if (callCount <= 2) {
// resolveRef: rev-parse 成功
proc.stdout.emit("data", "abc123");
proc.emit("close", 0);
} else {
// git diff 返回有删除的内容
proc.stdout.emit(
"data",
`diff --git a/test.ts b/test.ts\n--- a/test.ts\n+++ b/test.ts\n@@ -1,3 +1,1 @@\n-const old1 = 1;\n-const old2 = 2;\n+const new1 = 1;\n@@ -10,2 +8,0 @@\n-function removed() {}\n-// end`,
);
proc.emit("close", 0);
}
});
return proc;
});
const blocks = await (service as any).getDeletedCodeBlocks("main", "feature", 1);
expect(blocks.length).toBeGreaterThanOrEqual(1);
});
it("should handle diff with last block at end", async () => {
let callCount = 0;
(child_process.spawn as Mock).mockImplementation(() => {
callCount++;
const proc = new EventEmitter() as any;
proc.stdout = new EventEmitter();
proc.stderr = new EventEmitter();
process.nextTick(() => {
if (callCount <= 2) {
proc.stdout.emit("data", "abc123");
proc.emit("close", 0);
} else {
proc.stdout.emit(
"data",
`diff --git a/test.ts b/test.ts\n--- a/test.ts\n+++ b/test.ts\n@@ -1,2 +1,0 @@\n-const removed1 = true;\n-const removed2 = true;`,
);
proc.emit("close", 0);
}
});
return proc;
});
const blocks = await (service as any).getDeletedCodeBlocks("main", "feature");
expect(blocks.length).toBeGreaterThanOrEqual(1);
});
});
describe("analyzeDeletionImpact - git-diff with blocks", () => {
it("should analyze deleted blocks from git diff", async () => {
let callCount = 0;
(child_process.spawn as Mock).mockImplementation(() => {
callCount++;
const proc = new EventEmitter() as any;
proc.stdout = new EventEmitter();
proc.stderr = new EventEmitter();
process.nextTick(() => {
if (callCount <= 2) {
proc.stdout.emit("data", "abc123");
proc.emit("close", 0);
} else if (callCount === 3) {
// git diff 返回有删除的内容
proc.stdout.emit(
"data",
`diff --git a/test.ts b/test.ts\n--- a/test.ts\n+++ b/test.ts\n@@ -1,1 +1,0 @@\n-function removedFunc() {}`,
);
proc.emit("close", 0);
} else {
// git grep 失败（没有引用）
proc.stderr.emit("data", "");
proc.emit("close", 1);
}
});
return proc;
});
const mockStream = (async function* () {
yield {
type: "result",
response: {
structuredOutput: {
impacts: [
{
file: "test.ts",
deletedCode: "removedFunc",
riskLevel: "low",
affectedFiles: [],
reason: "safe",
},
],
summary: "safe deletion",
},
},
};
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const context = { baseRef: "main", headRef: "feature" };
const result = await service.analyzeDeletionImpact(context, "openai", 1);
expect(result.impacts.length).toBeGreaterThanOrEqual(1);
expect(result.summary).toBe("safe deletion");
});
});
describe("analyzeDeletionImpact - agent mode", () => {
it("should use agent mode for claude-code", async () => {
const context = { owner: "o", repo: "r", prNumber: 1, analysisMode: "claude-code" as const };
gitProvider.getPullRequestFiles.mockResolvedValue([
{
filename: "test.ts",
patch: "@@ -1,1 +1,0 @@\n-const removed = true;",
deletions: 1,
},
] as any);
const mockProcess = new EventEmitter() as any;
mockProcess.stdout = new EventEmitter();
mockProcess.stderr = new EventEmitter();
(child_process.spawn as Mock).mockReturnValue(mockProcess);
process.nextTick(() => {
mockProcess.emit("close", 1);
});
const mockStream = (async function* () {
yield {
type: "result",
response: { structuredOutput: { impacts: [], summary: "agent analysis" } },
};
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const result = await service.analyzeDeletionImpact(context, "openai");
expect(result.summary).toBe("agent analysis");
});
});
describe("analyzeDeletionImpact - defensive checks", () => {
it("should fix invalid impacts array", async () => {
const context = { owner: "o", repo: "r", prNumber: 1 };
gitProvider.getPullRequestFiles.mockResolvedValue([
{
filename: "test.ts",
patch: "@@ -1,1 +1,0 @@\n-const removed = true;",
deletions: 1,
},
] as any);
const mockProcess = new EventEmitter() as any;
mockProcess.stdout = new EventEmitter();
mockProcess.stderr = new EventEmitter();
(child_process.spawn as Mock).mockReturnValue(mockProcess);
process.nextTick(() => {
mockProcess.emit("close", 1);
});
const mockStream = (async function* () {
yield {
type: "result",
response: { structuredOutput: { impacts: null, summary: "ok" } },
};
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const result = await service.analyzeDeletionImpact(context, "openai");
expect(result.impacts).toEqual([]);
});
});
});

879
commands/review/src/deletion-impact.service.ts Normal file
View File

@@ -0,0 +1,879 @@
import {
Injectable,
LlmProxyService,
logStreamEvent,
createStreamLoggerState,
type LLMMode,
type VerboseLevel,
shouldLog,
type LlmJsonPutSchema,
LlmJsonPut,
GitProviderService,
ChangedFile,
} from "@spaceflow/core";
import micromatch from "micromatch";
import type { DeletionImpactResult } from "./review-spec";
import { spawn } from "child_process";
export interface DeletedCodeBlock {
file: string;
startLine: number;
endLine: number;
content: string;
commit?: string;
}
const DELETION_IMPACT_SCHEMA: LlmJsonPutSchema = {
type: "object",
properties: {
impacts: {
type: "array",
items: {
type: "object",
properties: {
file: { type: "string", description: "被删除代码所在的文件路径" },
deletedCode: { type: "string", description: "被删除的代码片段摘要（前50字符）" },
riskLevel: {
type: "string",
enum: ["high", "medium", "low", "none"],
description:
"风险等级：high=可能导致功能异常，medium=可能影响部分功能，low=影响较小，none=无影响",
},
affectedFiles: {
type: "array",
items: { type: "string" },
description: "可能受影响的文件列表",
},
reason: { type: "string", description: "影响分析的详细说明" },
suggestion: { type: "string", description: "建议的处理方式" },
},
required: ["file", "deletedCode", "riskLevel", "affectedFiles", "reason"],
additionalProperties: false,
},
},
summary: { type: "string", description: "删除代码影响的整体总结" },
},
required: ["impacts", "summary"],
additionalProperties: false,
};
export type DeletionDiffSource = "provider-api" | "git-diff";
export interface DeletionAnalysisContext {
owner?: string;
repo?: string;
prNumber?: number;
baseRef?: string;
headRef?: string;
/** diff 来源：provider-api 使用 Git Provider API，git-diff 使用本地 git 命令（两点语法） */
diffSource?: DeletionDiffSource;
/** 分析模式：openai 使用标准模式，claude-agent 使用 Agent 模式（可使用工具） */
analysisMode?: LLMMode;
/** 文件过滤 glob 模式，与 review.includes 一致 */
includes?: string[];
}
@Injectable()
export class DeletionImpactService {
constructor(
protected readonly llmProxyService: LlmProxyService,
protected readonly gitProvider: GitProviderService,
) {}
/**
* 分析删除代码的影响
*/
async analyzeDeletionImpact(
context: DeletionAnalysisContext,
llmMode: LLMMode,
verbose?: VerboseLevel,
): Promise<DeletionImpactResult> {
if (shouldLog(verbose, 1)) {
console.log(`\n🔍 开始分析删除代码的影响...`);
}
// 1. 获取删除的代码块
let deletedBlocks: DeletedCodeBlock[];
const diffSource = context.diffSource ?? (context.prNumber ? "provider-api" : "git-diff");
if (diffSource === "provider-api" && context.prNumber && context.owner && context.repo) {
// Git Provider API 模式：使用 API 获取 diff
if (shouldLog(verbose, 1)) {
console.log(` 📡 使用 Git Provider API 获取 PR #${context.prNumber} 的 diff`);
}
const changedFiles = await this.gitProvider.getPullRequestFiles(
context.owner,
context.repo,
context.prNumber,
);
// 检查 changedFiles 是否包含 patch 字段
const filesWithPatch = changedFiles.filter((f) => f.patch);
const filesWithDeletions = changedFiles.filter((f) => f.deletions && f.deletions > 0);
if (shouldLog(verbose, 1)) {
console.log(
` 📊 共 ${changedFiles.length} 个文件, ${filesWithPatch.length} 个有 patch, ${filesWithDeletions.length} 个有删除`,
);
}
if (filesWithPatch.length > 0) {
// 有 patch 字段，直接解析
deletedBlocks = this.extractDeletedBlocksFromChangedFiles(changedFiles);
} else if (filesWithDeletions.length > 0) {
// 没有 patch 字段但有删除，使用 PR diff API
if (shouldLog(verbose, 1)) {
console.log(` ⚠️ API 未返回 patch 字段，使用 PR diff API`);
}
try {
const diffText = await this.gitProvider.getPullRequestDiff(
context.owner,
context.repo,
context.prNumber,
);
deletedBlocks = this.extractDeletedBlocksFromDiffText(diffText);
} catch (e) {
if (shouldLog(verbose, 1)) {
console.log(` ❌ PR diff API 失败: ${e instanceof Error ? e.message : String(e)}`);
}
deletedBlocks = [];
}
} else {
// 没有删除的文件
deletedBlocks = [];
}
} else if (context.baseRef && context.headRef) {
// Git Diff 模式：使用本地 git 命令（两点语法）
if (shouldLog(verbose, 1)) {
console.log(` 💻 使用 Git Diff 获取 ${context.baseRef}..${context.headRef} 的差异`);
}
deletedBlocks = await this.getDeletedCodeBlocks(context.baseRef, context.headRef, verbose);
} else {
if (shouldLog(verbose, 1)) {
console.log(` ⚠️ 缺少必要参数，跳过删除分析`);
}
return { impacts: [], summary: "缺少必要参数" };
}
if (deletedBlocks.length === 0) {
if (shouldLog(verbose, 1)) {
console.log(` ✅ 没有发现删除的代码`);
}
return { impacts: [], summary: "没有发现删除的代码" };
}
if (shouldLog(verbose, 1)) {
console.log(` 📦 发现 ${deletedBlocks.length} 个删除的代码块`);
}
// 1.5 使用 includes 过滤文件
if (context.includes && context.includes.length > 0) {
const beforeCount = deletedBlocks.length;
const filenames = deletedBlocks.map((b) => b.file);
const matchedFilenames = micromatch(filenames, context.includes);
deletedBlocks = deletedBlocks.filter((b) => matchedFilenames.includes(b.file));
if (shouldLog(verbose, 1)) {
console.log(` 🔍 Includes 过滤: ${beforeCount} -> ${deletedBlocks.length} 个删除块`);
}
if (deletedBlocks.length === 0) {
return { impacts: [], summary: "过滤后没有需要分析的删除代码" };
}
}
// 2. 获取删除代码的引用关系
const references = await this.findCodeReferences(deletedBlocks);
if (shouldLog(verbose, 1)) {
console.log(` 🔗 找到 ${references.size} 个文件可能引用了被删除的代码`);
}
// 3. 根据分析模式选择不同的分析方法
const analysisMode = context.analysisMode ?? "openai";
let result: DeletionImpactResult;
if (["claude-code", "open-code"].includes(analysisMode)) {
// Claude Agent 模式：使用工具主动探索代码库
result = await this.analyzeWithAgent(analysisMode, deletedBlocks, references, verbose);
} else {
// OpenAI 模式：标准 chat completion
result = await this.analyzeWithLLM(deletedBlocks, references, llmMode, verbose);
}
// 防御性检查：确保 impacts 是数组
if (!result.impacts || !Array.isArray(result.impacts)) {
result.impacts = [];
}
const highRiskCount = result.impacts.filter((i) => i.riskLevel === "high").length;
const mediumRiskCount = result.impacts.filter((i) => i.riskLevel === "medium").length;
if (shouldLog(verbose, 1)) {
console.log(`\n📊 分析完成: ${highRiskCount} 个高风险, ${mediumRiskCount} 个中风险`);
}
return result;
}
/**
* 从 Git Provider API 返回的 ChangedFile 中提取被删除的代码块
*/
protected extractDeletedBlocksFromChangedFiles(changedFiles: ChangedFile[]): DeletedCodeBlock[] {
const deletedBlocks: DeletedCodeBlock[] = [];
for (const file of changedFiles) {
if (!file.filename || !file.patch) continue;
const blocks = this.parseDeletedBlocksFromPatch(file.filename, file.patch);
deletedBlocks.push(...blocks);
}
// 过滤掉空白行和注释行为主的删除块
return this.filterMeaningfulBlocks(deletedBlocks);
}
/**
* 从单个文件的 patch 中解析删除的代码块
*/
protected parseDeletedBlocksFromPatch(filename: string, patch: string): DeletedCodeBlock[] {
const deletedBlocks: DeletedCodeBlock[] = [];
const lines = patch.split("\n");
let currentDeleteBlock: { startLine: number; lines: string[] } | null = null;
for (const line of lines) {
// 解析 hunk header: @@ -oldStart,oldCount +newStart,newCount @@
const hunkMatch = line.match(/^@@ -(\d+)(?:,(\d+))? \+\d+(?:,\d+)? @@/);
if (hunkMatch) {
// 保存之前的删除块
if (currentDeleteBlock && currentDeleteBlock.lines.length > 0) {
deletedBlocks.push({
file: filename,
startLine: currentDeleteBlock.startLine,
endLine: currentDeleteBlock.startLine + currentDeleteBlock.lines.length - 1,
content: currentDeleteBlock.lines.join("\n"),
});
}
currentDeleteBlock = {
startLine: parseInt(hunkMatch[1], 10),
lines: [],
};
continue;
}
// 删除的行（以 - 开头，但不是 ---）
if (line.startsWith("-") && !line.startsWith("---") && currentDeleteBlock) {
currentDeleteBlock.lines.push(line.slice(1)); // 去掉 - 前缀
} else if (line.startsWith("+") && !line.startsWith("+++")) {
// 新增行，保存当前删除块
if (currentDeleteBlock && currentDeleteBlock.lines.length > 0) {
deletedBlocks.push({
file: filename,
startLine: currentDeleteBlock.startLine,
endLine: currentDeleteBlock.startLine + currentDeleteBlock.lines.length - 1,
content: currentDeleteBlock.lines.join("\n"),
});
currentDeleteBlock = { startLine: currentDeleteBlock.startLine, lines: [] };
}
}
}
// 保存最后一个删除块
if (currentDeleteBlock && currentDeleteBlock.lines.length > 0) {
deletedBlocks.push({
file: filename,
startLine: currentDeleteBlock.startLine,
endLine: currentDeleteBlock.startLine + currentDeleteBlock.lines.length - 1,
content: currentDeleteBlock.lines.join("\n"),
});
}
return deletedBlocks;
}
/**
* 过滤掉空白行和注释行为主的删除块
*/
protected filterMeaningfulBlocks(blocks: DeletedCodeBlock[]): DeletedCodeBlock[] {
return blocks.filter((block) => {
const meaningfulLines = block.content.split("\n").filter((line) => {
const trimmed = line.trim();
return (
trimmed &&
!trimmed.startsWith("//") &&
!trimmed.startsWith("*") &&
!trimmed.startsWith("/*")
);
});
return meaningfulLines.length > 0;
});
}
/**
* 从 diff 文本中提取被删除的代码块
*/
protected extractDeletedBlocksFromDiffText(diffText: string): DeletedCodeBlock[] {
const deletedBlocks: DeletedCodeBlock[] = [];
const fileDiffs = diffText.split(/^diff --git /m).filter(Boolean);
for (const fileDiff of fileDiffs) {
// 解析文件名
const headerMatch = fileDiff.match(/^a\/(.+?) b\/(.+?)[\r\n]/);
if (!headerMatch) continue;
const filename = headerMatch[1]; // 使用原文件名（a/...）
const lines = fileDiff.split("\n");
let currentDeleteBlock: { startLine: number; lines: string[] } | null = null;
for (const line of lines) {
// 解析 hunk header: @@ -oldStart,oldCount +newStart,newCount @@
const hunkMatch = line.match(/^@@ -(\d+)(?:,(\d+))? \+\d+(?:,\d+)? @@/);
if (hunkMatch) {
// 保存之前的删除块
if (currentDeleteBlock && currentDeleteBlock.lines.length > 0) {
deletedBlocks.push({
file: filename,
startLine: currentDeleteBlock.startLine,
endLine: currentDeleteBlock.startLine + currentDeleteBlock.lines.length - 1,
content: currentDeleteBlock.lines.join("\n"),
});
}
currentDeleteBlock = {
startLine: parseInt(hunkMatch[1], 10),
lines: [],
};
continue;
}
// 删除的行（以 - 开头，但不是 ---）
if (line.startsWith("-") && !line.startsWith("---") && currentDeleteBlock) {
currentDeleteBlock.lines.push(line.slice(1)); // 去掉 - 前缀
} else if (line.startsWith("+") && !line.startsWith("+++")) {
// 新增行，保存当前删除块
if (currentDeleteBlock && currentDeleteBlock.lines.length > 0) {
deletedBlocks.push({
file: filename,
startLine: currentDeleteBlock.startLine,
endLine: currentDeleteBlock.startLine + currentDeleteBlock.lines.length - 1,
content: currentDeleteBlock.lines.join("\n"),
});
currentDeleteBlock = { startLine: currentDeleteBlock.startLine, lines: [] };
}
}
}
// 保存最后一个删除块
if (currentDeleteBlock && currentDeleteBlock.lines.length > 0) {
deletedBlocks.push({
file: filename,
startLine: currentDeleteBlock.startLine,
endLine: currentDeleteBlock.startLine + currentDeleteBlock.lines.length - 1,
content: currentDeleteBlock.lines.join("\n"),
});
}
}
// 过滤掉空白行和注释行为主的删除块
return this.filterMeaningfulBlocks(deletedBlocks);
}
/**
* 从 git diff 中提取被删除的代码块
*/
protected async getDeletedCodeBlocks(
baseRef: string,
headRef: string,
verbose?: VerboseLevel,
): Promise<DeletedCodeBlock[]> {
if (shouldLog(verbose, 1)) {
console.log(` 🔎 分析 ${baseRef}...${headRef} 的删除代码`);
}
// 尝试解析 ref，支持本地分支、远程分支、commit SHA
const resolvedBaseRef = await this.resolveRef(baseRef, verbose);
const resolvedHeadRef = await this.resolveRef(headRef, verbose);
// 使用两点语法 (..) 而非三点语法 (...)，避免浅克隆时找不到 merge base
// 两点语法直接比较两个 ref 的差异，不需要计算共同祖先
const diffOutput = await this.runGitCommand([
"diff",
"-U0", // 不显示上下文，只显示变更
`${resolvedBaseRef}..${resolvedHeadRef}`,
]);
const deletedBlocks: DeletedCodeBlock[] = [];
const fileDiffs = diffOutput.split(/^diff --git /m).filter(Boolean);
for (const fileDiff of fileDiffs) {
// 解析文件名
const headerMatch = fileDiff.match(/^a\/(.+?) b\/(.+?)[\r\n]/);
if (!headerMatch) continue;
const filename = headerMatch[1]; // 使用原文件名（a/...）
const lines = fileDiff.split("\n");
let currentDeleteBlock: { startLine: number; lines: string[] } | null = null;
for (const line of lines) {
// 解析 hunk header: @@ -oldStart,oldCount +newStart,newCount @@
const hunkMatch = line.match(/^@@ -(\d+)(?:,(\d+))? \+\d+(?:,\d+)? @@/);
if (hunkMatch) {
// 保存之前的删除块
if (currentDeleteBlock && currentDeleteBlock.lines.length > 0) {
deletedBlocks.push({
file: filename,
startLine: currentDeleteBlock.startLine,
endLine: currentDeleteBlock.startLine + currentDeleteBlock.lines.length - 1,
content: currentDeleteBlock.lines.join("\n"),
});
}
currentDeleteBlock = {
startLine: parseInt(hunkMatch[1], 10),
lines: [],
};
continue;
}
// 删除的行（以 - 开头，但不是 ---）
if (line.startsWith("-") && !line.startsWith("---") && currentDeleteBlock) {
currentDeleteBlock.lines.push(line.slice(1)); // 去掉 - 前缀
} else if (line.startsWith("+") && !line.startsWith("+++")) {
// 新增行，保存当前删除块
if (currentDeleteBlock && currentDeleteBlock.lines.length > 0) {
deletedBlocks.push({
file: filename,
startLine: currentDeleteBlock.startLine,
endLine: currentDeleteBlock.startLine + currentDeleteBlock.lines.length - 1,
content: currentDeleteBlock.lines.join("\n"),
});
currentDeleteBlock = { startLine: currentDeleteBlock.startLine, lines: [] };
}
}
}
// 保存最后一个删除块
if (currentDeleteBlock && currentDeleteBlock.lines.length > 0) {
deletedBlocks.push({
file: filename,
startLine: currentDeleteBlock.startLine,
endLine: currentDeleteBlock.startLine + currentDeleteBlock.lines.length - 1,
content: currentDeleteBlock.lines.join("\n"),
});
}
}
// 过滤掉空白行和注释行为主的删除块
return this.filterMeaningfulBlocks(deletedBlocks);
}
/**
* 查找可能引用被删除代码的文件
*/
protected async findCodeReferences(
deletedBlocks: DeletedCodeBlock[],
): Promise<Map<string, string[]>> {
const references = new Map<string, string[]>();
for (const block of deletedBlocks) {
// 从删除的代码中提取可能的标识符（函数名、类名、变量名等）
const identifiers = this.extractIdentifiers(block.content);
const fileRefs: string[] = [];
for (const identifier of identifiers) {
if (identifier.length < 3) continue; // 跳过太短的标识符
try {
// 使用 git grep 查找引用
const grepOutput = await this.runGitCommand([
"grep",
"-l", // 只输出文件名
"-w", // 全词匹配
identifier,
"--",
"*.ts",
"*.js",
"*.tsx",
"*.jsx",
]);
const files = grepOutput
.trim()
.split("\n")
.filter((f) => f && f !== block.file);
fileRefs.push(...files);
} catch {
// grep 没找到匹配，忽略
}
}
if (fileRefs.length > 0) {
const uniqueRefs = [...new Set(fileRefs)];
references.set(`${block.file}:${block.startLine}-${block.endLine}`, uniqueRefs);
}
}
return references;
}
/**
* 从代码中提取标识符
*/
protected extractIdentifiers(code: string): string[] {
const identifiers: string[] = [];
// 匹配函数定义
const funcMatches = code.matchAll(/(?:function|async\s+function)\s+(\w+)/g);
for (const match of funcMatches) {
identifiers.push(match[1]);
}
// 匹配方法定义
const methodMatches = code.matchAll(/(?:async\s+)?(\w+)\s*\([^)]*\)\s*[:{]/g);
for (const match of methodMatches) {
if (!["if", "for", "while", "switch", "catch", "function"].includes(match[1])) {
identifiers.push(match[1]);
}
}
// 匹配类定义
const classMatches = code.matchAll(/class\s+(\w+)/g);
for (const match of classMatches) {
identifiers.push(match[1]);
}
// 匹配接口定义
const interfaceMatches = code.matchAll(/interface\s+(\w+)/g);
for (const match of interfaceMatches) {
identifiers.push(match[1]);
}
// 匹配类型定义
const typeMatches = code.matchAll(/type\s+(\w+)/g);
for (const match of typeMatches) {
identifiers.push(match[1]);
}
// 匹配 export 的变量/常量
const exportMatches = code.matchAll(/export\s+(?:const|let|var)\s+(\w+)/g);
for (const match of exportMatches) {
identifiers.push(match[1]);
}
return [...new Set(identifiers)];
}
/**
* 使用 LLM 分析删除代码的影响
*/
protected async analyzeWithLLM(
deletedBlocks: DeletedCodeBlock[],
references: Map<string, string[]>,
llmMode: LLMMode,
verbose?: VerboseLevel,
): Promise<DeletionImpactResult> {
const llmJsonPut = new LlmJsonPut<DeletionImpactResult>(DELETION_IMPACT_SCHEMA);
const systemPrompt = `你是一个代码审查专家，专门分析删除代码可能带来的影响。
## 任务
分析以下被删除的代码块，判断删除这些代码是否会影响到其他功能。
## 分析要点
1. **功能依赖**: 被删除的代码是否被其他模块调用或依赖
2. **接口变更**: 删除是否会导致 API 或接口不兼容
3. **副作用**: 删除是否会影响系统的其他行为
4. **数据流**: 删除是否会中断数据处理流程
## 风险等级判断标准
- **high**: 删除的代码被其他文件直接调用，删除后会导致编译错误或运行时异常
- **medium**: 删除的代码可能影响某些功能的行为，但不会导致直接错误
- **low**: 删除的代码影响较小，可能只是清理无用代码
- **none**: 删除的代码确实是无用代码，不会产生任何影响
## 输出要求
- 对每个有风险的删除块给出详细分析
- 如果删除是安全的，也要说明原因
- 提供具体的建议`;
const deletedCodeSection = deletedBlocks
.map((block, index) => {
const refs = references.get(`${block.file}:${block.startLine}-${block.endLine}`) || [];
return `### 删除块 ${index + 1}: ${block.file}:${block.startLine}-${block.endLine}
\`\`\`
${block.content}
\`\`\`
可能引用此代码的文件: ${refs.length > 0 ? refs.join(", ") : "未发现直接引用"}
`;
})
.join("\n");
const userPrompt = `## 被删除的代码块
${deletedCodeSection}
请分析这些删除操作可能带来的影响。`;
if (shouldLog(verbose, 2)) {
console.log(`\nsystemPrompt:\n----------------\n${systemPrompt}\n----------------`);
console.log(`\nuserPrompt:\n----------------\n${userPrompt}\n----------------`);
}
try {
const stream = this.llmProxyService.chatStream(
[
{ role: "system", content: systemPrompt },
{ role: "user", content: userPrompt },
],
{
adapter: llmMode,
jsonSchema: llmJsonPut,
verbose,
},
);
let result: DeletionImpactResult | undefined;
for await (const event of stream) {
if (event.type === "result") {
result = event.response.structuredOutput as DeletionImpactResult | undefined;
} else if (event.type === "error") {
console.error(` ❌ 分析失败: ${event.message}`);
}
}
// 防御性检查：确保返回的是有效对象
if (!result || typeof result !== "object" || Array.isArray(result)) {
return { impacts: [], summary: "分析返回格式无效" };
}
return result;
} catch (error) {
if (error instanceof Error) {
console.error(` ❌ LLM 调用失败: ${error.message}`);
if (error.stack) {
console.error(` 堆栈信息:\n${error.stack}`);
}
} else {
console.error(` ❌ LLM 调用失败: ${String(error)}`);
}
return { impacts: [], summary: "LLM 调用失败" };
}
}
/**
* 使用 Claude Agent 模式分析删除代码的影响
* Claude Agent 可以使用工具主动探索代码库，分析更深入
*/
protected async analyzeWithAgent(
analysisMode: LLMMode,
deletedBlocks: DeletedCodeBlock[],
references: Map<string, string[]>,
verbose?: VerboseLevel,
): Promise<DeletionImpactResult> {
const llmJsonPut = new LlmJsonPut<DeletionImpactResult>(DELETION_IMPACT_SCHEMA);
const systemPrompt = `你是一个资深代码架构师，擅长分析代码变更的影响范围和潜在风险。
## 任务
深入分析以下被删除的代码块，评估删除操作对代码库的影响。
## 你的能力
你可以使用以下工具来深入分析代码：
- **Read**: 读取文件内容，查看被删除代码的完整上下文
- **Grep**: 搜索代码库，查找对被删除代码的引用
- **Glob**: 查找匹配模式的文件
## 分析流程
1. 首先阅读被删除代码的上下文，理解其功能
2. 使用 Grep 搜索代码库中对这些代码的引用
3. 分析引用处的代码，判断删除后的影响
4. 给出风险评估和建议
## 风险等级判断标准
- **high**: 删除的代码被其他文件直接调用，删除后会导致编译错误或运行时异常
- **medium**: 删除的代码可能影响某些功能的行为，但不会导致直接错误
- **low**: 删除的代码影响较小，可能只是清理无用代码
- **none**: 删除的代码确实是无用代码，不会产生任何影响
## 输出要求
- 对每个有风险的删除块给出详细分析
- 如果删除是安全的，也要说明原因
- 提供具体的建议`;
const deletedCodeSection = deletedBlocks
.map((block, index) => {
const refs = references.get(`${block.file}:${block.startLine}-${block.endLine}`) || [];
return `### 删除块 ${index + 1}: ${block.file}:${block.startLine}-${block.endLine}
\`\`\`
${block.content}
\`\`\`
可能引用此代码的文件: ${refs.length > 0 ? refs.join(", ") : "未发现直接引用"}
`;
})
.join("\n");
const userPrompt = `## 被删除的代码块
${deletedCodeSection}
## 补充说明
请使用你的工具能力深入分析这些删除操作可能带来的影响。
- 如果需要查看更多上下文，请读取相关文件
- 如果需要确认引用关系，请搜索代码库
- 分析完成后，给出结构化的影响评估`;
if (shouldLog(verbose, 2)) {
console.log(
`\n[Agent Mode] systemPrompt:\n----------------\n${systemPrompt}\n----------------`,
);
console.log(`\n[Agent Mode] userPrompt:\n----------------\n${userPrompt}\n----------------`);
}
if (shouldLog(verbose, 1)) {
console.log(` 🤖 使用 Agent 模式分析（${analysisMode}，可使用工具）...`);
}
try {
const stream = this.llmProxyService.chatStream(
[
{ role: "system", content: systemPrompt },
{ role: "user", content: userPrompt },
],
{
adapter: analysisMode,
jsonSchema: llmJsonPut,
allowedTools: ["Read", "Grep", "Glob"],
verbose,
},
);
let result: DeletionImpactResult | undefined;
const streamLoggerState = createStreamLoggerState();
for await (const event of stream) {
if (shouldLog(verbose, 1)) {
logStreamEvent(event, streamLoggerState);
}
if (event.type === "result") {
result = event.response.structuredOutput as DeletionImpactResult | undefined;
} else if (event.type === "error") {
console.error(` ❌ 分析失败: ${event.message}`);
}
}
// 防御性检查：确保返回的是有效对象
if (!result || typeof result !== "object" || Array.isArray(result)) {
return { impacts: [], summary: "分析返回格式无效" };
}
return result;
} catch (error) {
if (error instanceof Error) {
console.error(` ❌ Agent 调用失败: ${error.message}`);
if (error.stack) {
console.error(` 堆栈信息:\n${error.stack}`);
}
} else {
console.error(` ❌ Agent 调用失败: ${String(error)}`);
}
return { impacts: [], summary: "Agent 调用失败" };
}
}
/**
* 解析 ref，支持本地分支、远程分支、commit SHA
* 优先级：本地分支 > origin/分支 > fetch后重试 > 原始值
*/
protected async resolveRef(ref: string, verbose?: VerboseLevel): Promise<string> {
if (!ref) {
throw new Error(`resolveRef: ref 参数不能为空。调用栈: ${new Error().stack}`);
}
// 如果已经是 commit SHA 格式（7-40位十六进制），直接返回
if (/^[0-9a-f]{7,40}$/i.test(ref)) {
if (shouldLog(verbose, 1)) {
console.log(` 📌 ${ref} 是 commit SHA，直接使用`);
}
return ref;
}
// 如果已经是 origin/ 格式，直接返回
if (ref.startsWith("origin/")) {
if (shouldLog(verbose, 1)) {
console.log(` 📌 ${ref} 已是远程分支格式，直接使用`);
}
return ref;
}
// 尝试解析本地分支
try {
await this.runGitCommand(["rev-parse", "--verify", ref]);
if (shouldLog(verbose, 1)) {
console.log(` 📌 ${ref} 解析为本地分支`);
}
return ref;
} catch {
// 本地分支不存在，尝试 origin/分支
}
// 尝试 origin/分支
try {
await this.runGitCommand(["rev-parse", "--verify", `origin/${ref}`]);
if (shouldLog(verbose, 1)) {
console.log(` 📌 ${ref} 解析为 origin/${ref}`);
}
return `origin/${ref}`;
} catch {
// origin/分支也不存在，尝试 fetch
}
// 尝试 fetch 该分支
if (shouldLog(verbose, 1)) {
console.log(` ⏳ 尝试 fetch ${ref}...`);
}
try {
await this.runGitCommand([
"fetch",
"origin",
`${ref}:refs/remotes/origin/${ref}`,
"--depth=1",
]);
if (shouldLog(verbose, 1)) {
console.log(` 📌 ${ref} fetch 成功，使用 origin/${ref}`);
}
return `origin/${ref}`;
} catch (e) {
if (shouldLog(verbose, 1)) {
console.log(` ⚠️ fetch ${ref} 失败: ${e instanceof Error ? e.message : String(e)}`);
}
}
if (shouldLog(verbose, 1)) {
console.log(` ⚠️ 无法解析 ${ref}，使用原始值`);
}
return ref;
}
protected runGitCommand(args: string[]): Promise<string> {
return new Promise((resolve, reject) => {
const child = spawn("git", args, {
cwd: process.cwd(),
env: process.env,
stdio: ["pipe", "pipe", "pipe"],
});
let stdout = "";
let stderr = "";
child.stdout.on("data", (data) => {
stdout += data.toString();
});
child.stderr.on("data", (data) => {
stderr += data.toString();
});
child.on("close", (code) => {
if (code === 0) {
resolve(stdout);
} else {
reject(new Error(`Git 命令失败 (${code}): ${stderr}`));
}
});
child.on("error", (err) => {
reject(err);
});
});
}
}

42
commands/review/src/dto/mcp.dto.ts Normal file
View File

@@ -0,0 +1,42 @@
import {
ApiProperty,
ApiPropertyOptional,
IsString,
IsBoolean,
IsOptional,
t,
} from "@spaceflow/core";
export class ListRulesInput {
@ApiPropertyOptional({ description: t("review:mcp.dto.cwd") })
@IsString()
@IsOptional()
cwd?: string;
}
export class GetRulesForFileInput {
@ApiProperty({ description: t("review:mcp.dto.filePath") })
@IsString()
filePath!: string;
@ApiPropertyOptional({ description: t("review:mcp.dto.cwd") })
@IsString()
@IsOptional()
cwd?: string;
@ApiPropertyOptional({ description: t("review:mcp.dto.includeExamples") })
@IsBoolean()
@IsOptional()
includeExamples?: boolean;
}
export class GetRuleDetailInput {
@ApiProperty({ description: t("review:mcp.dto.ruleId") })
@IsString()
ruleId!: string;
@ApiPropertyOptional({ description: t("review:mcp.dto.cwd") })
@IsString()
@IsOptional()
cwd?: string;
}

32
commands/review/src/index.ts Normal file
View File

@@ -0,0 +1,32 @@
import "./locales";
import { SpaceflowExtension, SpaceflowExtensionMetadata, t } from "@spaceflow/core";
import { ReviewModule } from "./review.module";
import { reviewSchema } from "./review.config";
/** review Extension 元数据 */
export const reviewMetadata: SpaceflowExtensionMetadata = {
name: "review",
commands: ["review"],
configKey: "review",
configSchema: reviewSchema,
version: "1.0.0",
description: t("review:extensionDescription"),
};
export class ReviewExtension implements SpaceflowExtension {
getMetadata(): SpaceflowExtensionMetadata {
return reviewMetadata;
}
getModule() {
return ReviewModule;
}
}
export default ReviewExtension;
export * from "./review.module";
export * from "./review.command";
export * from "./review.service";
export * from "./review.mcp";
export * from "./issue-verify.service";
export * from "./deletion-impact.service";

460
commands/review/src/issue-verify.service.spec.ts Normal file
View File

@@ -0,0 +1,460 @@
import { vi, type Mocked } from "vitest";
import { Test, TestingModule } from "@nestjs/testing";
import { LlmProxyService } from "@spaceflow/core";
import { ReviewIssue, FileContentsMap, ReviewSpecService } from "./review-spec";
import { IssueVerifyService } from "./issue-verify.service";
vi.mock("@anthropic-ai/claude-agent-sdk", () => ({
query: vi.fn(),
}));
describe("IssueVerifyService", () => {
let service: IssueVerifyService;
let llmProxyService: Mocked<LlmProxyService>;
beforeEach(async () => {
const mockLlmProxyService = {
chatStream: vi.fn(),
};
const mockReviewSpecService = {
findRuleById: vi.fn(),
buildSpecsSection: vi.fn().mockReturnValue("mock rule specs"),
};
const module: TestingModule = await Test.createTestingModule({
providers: [
IssueVerifyService,
{
provide: LlmProxyService,
useValue: mockLlmProxyService,
},
{
provide: ReviewSpecService,
useValue: mockReviewSpecService,
},
],
}).compile();
service = module.get<IssueVerifyService>(IssueVerifyService);
llmProxyService = module.get(LlmProxyService) as Mocked<LlmProxyService>;
});
it("should return empty array if no issues provided", async () => {
const result = await service.verifyIssueFixes([], new Map(), [], "openai");
expect(result).toEqual([]);
});
it("should skip already fixed issues", async () => {
const issues: ReviewIssue[] = [
{
file: "test.ts",
line: "10",
ruleId: "R1",
specFile: "s1.md",
reason: "r1",
fixed: "2023-01-01",
round: 1,
} as any,
];
const result = await service.verifyIssueFixes(
issues,
new Map() as FileContentsMap,
[],
"openai",
);
expect(result).toHaveLength(1);
expect(result[0]).toBe(issues[0]);
expect(llmProxyService.chatStream).not.toHaveBeenCalled();
});
it("should mark as fixed if file is deleted", async () => {
const issues: ReviewIssue[] = [
{
file: "deleted.ts",
line: "10",
ruleId: "R1",
specFile: "s1.md",
reason: "r1",
round: 1,
} as any,
];
const fileContents: FileContentsMap = new Map();
const result = await service.verifyIssueFixes(issues, fileContents, [], "openai");
expect(result).toHaveLength(1);
expect(result[0].fixed).toBeDefined();
expect(llmProxyService.chatStream).not.toHaveBeenCalled();
});
it("should call LLM to verify issue fix", async () => {
const issues: ReviewIssue[] = [
{
file: "test.ts",
line: "10",
ruleId: "R1",
specFile: "s1.md",
reason: "r1",
round: 1,
} as any,
];
const fileContents: FileContentsMap = new Map([["test.ts", [["-------", "new content"]]]]);
const mockStream = (async function* () {
yield {
type: "result",
response: { structuredOutput: { fixed: true, reason: "Fixed now" } },
};
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const result = await service.verifyIssueFixes(issues, fileContents, [], "openai");
expect(result).toHaveLength(1);
expect(result[0].fixed).toBeDefined();
expect(llmProxyService.chatStream).toHaveBeenCalled();
});
it("should handle LLM saying issue is not fixed", async () => {
const issues: ReviewIssue[] = [
{
file: "test.ts",
line: "10",
ruleId: "R1",
specFile: "s1.md",
reason: "r1",
round: 1,
} as any,
];
const fileContents: FileContentsMap = new Map([
["test.ts", [["-------", "still bad content"]]],
]);
const mockStream = (async function* () {
yield {
type: "result",
response: { structuredOutput: { fixed: false, reason: "Still broken" } },
};
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const result = await service.verifyIssueFixes(issues, fileContents, [], "openai");
expect(result).toHaveLength(1);
expect(result[0].fixed).toBeUndefined();
});
it("should handle invalid issue from LLM", async () => {
const issues: ReviewIssue[] = [
{
file: "test.ts",
line: "10",
ruleId: "R1",
specFile: "s1.md",
reason: "r1",
round: 1,
} as any,
];
const fileContents: FileContentsMap = new Map([["test.ts", [["-------", "content"]]]]);
const mockStream = (async function* () {
yield {
type: "result",
response: { structuredOutput: { fixed: false, valid: false, reason: "False positive" } },
};
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const result = await service.verifyIssueFixes(issues, fileContents, [], "openai");
expect(result).toHaveLength(1);
expect(result[0].valid).toBe("false");
expect(result[0].fixed).toBeUndefined();
});
it("should handle error in LLM stream", async () => {
const issues: ReviewIssue[] = [
{
file: "test.ts",
line: "10",
ruleId: "R1",
specFile: "s1.md",
reason: "r1",
round: 1,
} as any,
];
const fileContents: FileContentsMap = new Map([["test.ts", [["-------", "content"]]]]);
const mockStream = (async function* () {
yield { type: "error", message: "LLM error" };
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const result = await service.verifyIssueFixes(issues, fileContents, [], "openai");
expect(result).toHaveLength(1);
expect(result[0]).toBe(issues[0]); // Returns original issue on error
});
it("should handle exception during LLM call", async () => {
const issues: ReviewIssue[] = [
{
file: "test.ts",
line: "10",
ruleId: "R1",
specFile: "s1.md",
reason: "r1",
round: 1,
} as any,
];
const fileContents: FileContentsMap = new Map([["test.ts", [["-------", "content"]]]]);
llmProxyService.chatStream.mockImplementation(() => {
throw new Error("Critical failure");
});
const result = await service.verifyIssueFixes(issues, fileContents, [], "openai");
expect(result).toHaveLength(1);
expect(result[0]).toBe(issues[0]);
});
it("should skip issues with valid=false", async () => {
const issues: ReviewIssue[] = [
{
file: "test.ts",
line: "10",
ruleId: "R1",
specFile: "s1.md",
reason: "r1",
valid: "false",
round: 1,
} as any,
];
const result = await service.verifyIssueFixes(
issues,
new Map() as FileContentsMap,
[],
"openai",
);
expect(result).toHaveLength(1);
expect(result[0]).toBe(issues[0]);
expect(llmProxyService.chatStream).not.toHaveBeenCalled();
});
it("should handle non-Error exception during LLM call", async () => {
const issues: ReviewIssue[] = [
{
file: "test.ts",
line: "10",
ruleId: "R1",
specFile: "s1.md",
reason: "r1",
round: 1,
} as any,
];
const fileContents: FileContentsMap = new Map([["test.ts", [["-------", "content"]]]]);
llmProxyService.chatStream.mockImplementation(() => {
throw "string error";
});
const consoleSpy = vi.spyOn(console, "error").mockImplementation(() => {});
const result = await service.verifyIssueFixes(issues, fileContents, [], "openai");
expect(result).toHaveLength(1);
expect(result[0]).toBe(issues[0]);
consoleSpy.mockRestore();
});
it("should return original issue when LLM returns no structured output", async () => {
const issues: ReviewIssue[] = [
{
file: "test.ts",
line: "10",
ruleId: "R1",
specFile: "s1.md",
reason: "r1",
round: 1,
} as any,
];
const fileContents: FileContentsMap = new Map([["test.ts", [["-------", "content"]]]]);
const mockStream = (async function* () {
yield { type: "result", response: { content: "no json" } };
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const result = await service.verifyIssueFixes(issues, fileContents, [], "openai");
expect(result).toHaveLength(1);
expect(result[0]).toBe(issues[0]);
});
it("should include suggestion in prompt when present", async () => {
const issues: ReviewIssue[] = [
{
file: "test.ts",
line: "10",
ruleId: "R1",
specFile: "s1.md",
reason: "r1",
suggestion: "fix this way",
round: 1,
} as any,
];
const fileContents: FileContentsMap = new Map([["test.ts", [["-------", "content"]]]]);
const mockStream = (async function* () {
yield {
type: "result",
response: { structuredOutput: { fixed: true, valid: true, reason: "ok" } },
};
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const result = await service.verifyIssueFixes(issues, fileContents, [], "openai");
expect(result).toHaveLength(1);
expect(result[0].fixed).toBeDefined();
const callArgs = llmProxyService.chatStream.mock.calls[0][0];
expect(callArgs[1].content).toContain("fix this way");
});
it("should log verbose messages when verbose=1", async () => {
const issues: ReviewIssue[] = [
{
file: "test.ts",
line: "10",
ruleId: "R1",
specFile: "s1.md",
reason: "r1",
round: 1,
} as any,
];
const fileContents: FileContentsMap = new Map([["test.ts", [["-------", "content"]]]]);
const mockStream = (async function* () {
yield {
type: "result",
response: { structuredOutput: { fixed: true, valid: true, reason: "Fixed" } },
};
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const consoleSpy = vi.spyOn(console, "log").mockImplementation(() => {});
await service.verifyIssueFixes(issues, fileContents, [], "openai", 1);
expect(consoleSpy).toHaveBeenCalled();
consoleSpy.mockRestore();
});
it("should log verbose for invalid issues", async () => {
const issues: ReviewIssue[] = [
{
file: "test.ts",
line: "10",
ruleId: "R1",
specFile: "s1.md",
reason: "r1",
round: 1,
} as any,
];
const fileContents: FileContentsMap = new Map([["test.ts", [["-------", "content"]]]]);
const mockStream = (async function* () {
yield {
type: "result",
response: { structuredOutput: { fixed: false, valid: false, reason: "Invalid" } },
};
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const consoleSpy = vi.spyOn(console, "log").mockImplementation(() => {});
await service.verifyIssueFixes(issues, fileContents, [], "openai", 1);
const logMessages = consoleSpy.mock.calls.map((c) => c[0]);
expect(logMessages.some((m: string) => m.includes("无效问题"))).toBe(true);
consoleSpy.mockRestore();
});
it("should log verbose for unfixed issues", async () => {
const issues: ReviewIssue[] = [
{
file: "test.ts",
line: "10",
ruleId: "R1",
specFile: "s1.md",
reason: "r1",
round: 1,
} as any,
];
const fileContents: FileContentsMap = new Map([["test.ts", [["-------", "content"]]]]);
const mockStream = (async function* () {
yield {
type: "result",
response: { structuredOutput: { fixed: false, valid: true, reason: "Still broken" } },
};
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const consoleSpy = vi.spyOn(console, "log").mockImplementation(() => {});
await service.verifyIssueFixes(issues, fileContents, [], "openai", 1);
const logMessages = consoleSpy.mock.calls.map((c) => c[0]);
expect(logMessages.some((m: string) => m.includes("未修复"))).toBe(true);
consoleSpy.mockRestore();
});
it("should use ruleInfo when available", async () => {
const mockReviewSpecService = (service as any).reviewSpecService;
mockReviewSpecService.findRuleById.mockReturnValue({
rule: { id: "R1", description: "test rule" },
spec: { name: "test-spec" },
});
const issues: ReviewIssue[] = [
{
file: "test.ts",
line: "10",
ruleId: "R1",
specFile: "s1.md",
reason: "r1",
round: 1,
} as any,
];
const fileContents: FileContentsMap = new Map([["test.ts", [["-------", "content"]]]]);
const specs = [{ name: "test-spec" }] as any;
const mockStream = (async function* () {
yield {
type: "result",
response: { structuredOutput: { fixed: false, valid: true, reason: "ok" } },
};
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
await service.verifyIssueFixes(issues, fileContents, specs, "openai");
expect(mockReviewSpecService.buildSpecsSection).toHaveBeenCalled();
});
it("should handle valid=true and fixed=true result", async () => {
const issues: ReviewIssue[] = [
{
file: "test.ts",
line: "10",
ruleId: "R1",
specFile: "s1.md",
reason: "r1",
round: 1,
} as any,
];
const fileContents: FileContentsMap = new Map([["test.ts", [["-------", "content"]]]]);
const mockStream = (async function* () {
yield {
type: "result",
response: { structuredOutput: { fixed: true, valid: true, reason: "Fixed" } },
};
})();
llmProxyService.chatStream.mockReturnValue(mockStream as any);
const result = await service.verifyIssueFixes(issues, fileContents, [], "openai");
expect(result[0].fixed).toBeDefined();
expect(result[0].valid).toBe("true");
});
});

309
commands/review/src/issue-verify.service.ts Normal file
View File

@@ -0,0 +1,309 @@
import {
Injectable,
LlmProxyService,
type LLMMode,
type VerboseLevel,
shouldLog,
type LlmJsonPutSchema,
LlmJsonPut,
parallel,
} from "@spaceflow/core";
import {
ReviewIssue,
ReviewSpec,
ReviewRule,
ReviewSpecService,
FileContentsMap,
FileContentLine,
} from "./review-spec";
interface VerifyResult {
fixed: boolean;
valid: boolean;
reason: string;
}
const TRUE = "true";
const FALSE = "false";
const VERIFY_SCHEMA: LlmJsonPutSchema = {
type: "object",
properties: {
fixed: {
type: "boolean",
description: "问题是否已被修复",
},
valid: {
type: "boolean",
description: "问题是否有效，有效的条件就是你需要看看代码是否符合规范",
},
reason: {
type: "string",
description: "判断依据，说明为什么认为问题已修复或仍存在",
},
},
required: ["fixed", "valid", "reason"],
additionalProperties: false,
};
@Injectable()
export class IssueVerifyService {
constructor(
protected readonly llmProxyService: LlmProxyService,
protected readonly reviewSpecService: ReviewSpecService,
) {}
/**
* 验证历史 issues 是否已被修复
* 按并发数批量验证，每批并行调用 LLM
*/
async verifyIssueFixes(
existingIssues: ReviewIssue[],
fileContents: FileContentsMap,
specs: ReviewSpec[],
llmMode: LLMMode,
verbose?: VerboseLevel,
concurrency: number = 10,
): Promise<ReviewIssue[]> {
if (existingIssues.length === 0) {
return [];
}
if (shouldLog(verbose, 1)) {
console.log(
`\n🔍 开始验证 ${existingIssues.length} 个历史问题是否已修复 (并发: ${concurrency})...`,
);
}
const verifiedIssues: ReviewIssue[] = [];
const llmJsonPut = new LlmJsonPut<VerifyResult>(VERIFY_SCHEMA);
// 预处理：分离已修复和需要验证的 issues
const toVerify: {
issue: ReviewIssue;
fileContent: FileContentLine[];
ruleInfo: { rule: ReviewRule; spec: ReviewSpec } | null;
}[] = [];
for (const issue of existingIssues) {
if (issue.fixed) {
if (shouldLog(verbose, 1)) {
console.log(` ⏭️ 跳过已修复: ${issue.file}:${issue.line} (${issue.ruleId})`);
}
verifiedIssues.push(issue);
continue;
}
// valid === 'false' 的问题跳过复查（已确认无效的问题无需再次验证）
if (issue.valid === "false") {
if (shouldLog(verbose, 1)) {
console.log(` ⏭️ 跳过无效问题: ${issue.file}:${issue.line} (${issue.ruleId})`);
}
verifiedIssues.push(issue);
continue;
}
const fileContent = fileContents.get(issue.file);
if (fileContent === undefined) {
if (shouldLog(verbose, 1)) {
console.log(` ✅ 文件已删除: ${issue.file}:${issue.line} (${issue.ruleId})`);
}
verifiedIssues.push({
...issue,
fixed: new Date().toISOString(),
valid: FALSE,
reason: "文件已删除",
});
continue;
}
const ruleInfo = this.reviewSpecService.findRuleById(issue.ruleId, specs);
toVerify.push({ issue, fileContent, ruleInfo });
}
// 使用 parallel 库并行处理
const executor = parallel({
concurrency,
onTaskStart: (taskId) => {
if (shouldLog(verbose, 1)) {
console.log(` 🔎 验证: ${taskId}`);
}
},
onTaskComplete: (taskId, success) => {
if (shouldLog(verbose, 1)) {
console.log(` ${success ? "✅" : "❌"} 完成: ${taskId}`);
}
},
});
const results = await executor.map(
toVerify,
async ({ issue, fileContent, ruleInfo }) =>
this.verifySingleIssue(issue, fileContent, ruleInfo, llmMode, llmJsonPut, verbose),
({ issue }) => `${issue.file}:${issue.line}`,
);
for (const result of results) {
if (result.success && result.result) {
verifiedIssues.push(result.result);
} else {
// 失败时保留原始 issue
const originalItem = toVerify.find(
(item) => `${item.issue.file}:${item.issue.line}` === result.id,
);
if (originalItem) {
verifiedIssues.push(originalItem.issue);
}
}
}
const fixedCount = verifiedIssues.filter((i) => i.fixed).length;
const unfixedCount = verifiedIssues.length - fixedCount;
if (shouldLog(verbose, 1)) {
console.log(`\n📊 验证完成: ${fixedCount} 个已修复, ${unfixedCount} 个未修复`);
}
return verifiedIssues;
}
/**
* 验证单个 issue 是否已修复
*/
protected async verifySingleIssue(
issue: ReviewIssue,
fileContent: FileContentLine[],
ruleInfo: { rule: ReviewRule; spec: ReviewSpec } | null,
llmMode: LLMMode,
llmJsonPut: LlmJsonPut<VerifyResult>,
verbose?: VerboseLevel,
): Promise<ReviewIssue> {
const verifyPrompt = this.buildVerifyPrompt(issue, fileContent, ruleInfo);
try {
const stream = this.llmProxyService.chatStream(
[
{ role: "system", content: verifyPrompt.systemPrompt },
{ role: "user", content: verifyPrompt.userPrompt },
],
{
adapter: llmMode,
jsonSchema: llmJsonPut,
verbose,
},
);
let result: VerifyResult | undefined;
for await (const event of stream) {
if (event.type === "result") {
result = event.response.structuredOutput as VerifyResult | undefined;
} else if (event.type === "error") {
console.error(` ❌ 验证失败: ${event.message}`);
}
}
if (result) {
const updatedIssue: ReviewIssue = {
...issue,
valid: result.valid ? TRUE : FALSE,
};
if (result.fixed) {
if (shouldLog(verbose, 1)) {
console.log(` ✅ 已修复: ${result.reason}`);
}
updatedIssue.fixed = new Date().toISOString();
} else if (!result.valid) {
if (shouldLog(verbose, 1)) {
console.log(` ❌ 无效问题: ${result.reason}`);
}
} else {
if (shouldLog(verbose, 1)) {
console.log(` ⚠️ 未修复: ${result.reason}`);
}
}
return updatedIssue;
} else {
return issue;
}
} catch (error) {
if (error instanceof Error) {
console.error(` ❌ 验证出错: ${error.message}`);
if (error.stack) {
console.error(` 堆栈信息:\n${error.stack}`);
}
} else {
console.error(` ❌ 验证出错: ${String(error)}`);
}
return issue;
}
}
/**
* 构建验证单个 issue 是否已修复的 prompt
*/
protected buildVerifyPrompt(
issue: ReviewIssue,
fileContent: FileContentLine[],
ruleInfo: { rule: ReviewRule; spec: ReviewSpec } | null,
): { systemPrompt: string; userPrompt: string } {
const padWidth = String(fileContent.length).length;
const linesWithNumbers = fileContent
.map(([, line], index) => `${String(index + 1).padStart(padWidth)}| ${line}`)
.join("\n");
const systemPrompt = `你是一个代码审查专家。你的任务是判断之前发现的一个代码问题：
1. 是否有效（是否真的违反了规则）
2. 是否已经被修复
请仔细分析当前的代码内容。
## 输出要求
- valid: 布尔值，true 表示问题有效（代码确实违反了规则），false 表示问题无效（误报）
- fixed: 布尔值，true 表示问题已经被修复，false 表示问题仍然存在
- reason: 判断依据
## 判断标准
### valid 判断
- 根据规则 ID 和问题描述，判断代码是否真的违反了该规则
- 如果问题描述与实际代码不符，valid 为 false
- 如果规则不适用于该代码场景，valid 为 false
### fixed 判断
- 只有当问题所在的代码已被修改，且修改后的代码不再违反规则时，fixed 才为 true
- 如果问题所在的代码仍然存在且仍违反规则，fixed 必须为 false
- 如果代码行号发生变化但问题本质仍存在，fixed 必须为 false
## 重要提醒
- valid=false 时，fixed 的值无意义（无效问题无需修复）
- 请确保 valid 和 fixed 的值与 reason 的描述一致！`;
// 构建规则定义部分
let ruleSection = "";
if (ruleInfo) {
ruleSection = this.reviewSpecService.buildSpecsSection([ruleInfo.spec]);
}
const userPrompt = `## 规则定义
${ruleSection}
## 之前发现的问题
- **文件**: ${issue.file}
- **行号**: ${issue.line}
- **规则**: ${issue.ruleId} (来自 ${issue.specFile})
- **问题描述**: ${issue.reason}
${issue.suggestion ? `- **原建议**: ${issue.suggestion}` : ""}
## 当前文件内容
\`\`\`
${linesWithNumbers}
\`\`\`
请判断这个问题是否有效，以及是否已经被修复。`;
return { systemPrompt, userPrompt };
}
}

31
commands/review/src/locales/en/review.json Normal file
View File

@@ -0,0 +1,31 @@
{
"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"
}

11
commands/review/src/locales/index.ts Normal file
View File

@@ -0,0 +1,11 @@
import { addLocaleResources } from "@spaceflow/core";
import zhCN from "./zh-cn/review.json";
import en from "./en/review.json";
/** review 命令 i18n 资源 */
export const reviewLocales: Record<string, Record<string, string>> = {
"zh-CN": zhCN,
en,
};
addLocaleResources("review", reviewLocales);

31
commands/review/src/locales/zh-cn/review.json Normal file
View File

@@ -0,0 +1,31 @@
{
"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"
}

251
commands/review/src/parse-title-options.spec.ts Normal file
View File

@@ -0,0 +1,251 @@
import { parseTitleOptions } from "./parse-title-options";
describe("parseTitleOptions", () => {
describe("基本解析", () => {
it("应该从 PR 标题末尾解析命令参数 (/review)", () => {
const title = "feat: 添加新功能 [/review -l openai -v 2]";
const options = parseTitleOptions(title);
expect(options.llmMode).toBe("openai");
expect(options.verbose).toBe(2);
});
it("应该支持旧的 /ai-review 格式", () => {
const title = "feat: 添加新功能 [/ai-review -l openai -v 2]";
const options = parseTitleOptions(title);
expect(options.llmMode).toBe("openai");
expect(options.verbose).toBe(2);
});
it("没有命令参数时应返回空对象", () => {
const title = "feat: 添加新功能";
const options = parseTitleOptions(title);
expect(options).toEqual({});
});
it("格式不正确时应返回空对象", () => {
const title = "feat: 添加新功能 [ai-review -l openai]"; // 缺少 /
const options = parseTitleOptions(title);
expect(options).toEqual({});
});
});
describe("LLM 模式参数", () => {
it("应该解析 -l 短参数", () => {
const title = "fix: bug [/ai-review -l claude-code]";
const options = parseTitleOptions(title);
expect(options.llmMode).toBe("claude-code");
});
it("应该解析 --llm-mode 长参数", () => {
const title = "fix: bug [/ai-review --llm-mode gemini]";
const options = parseTitleOptions(title);
expect(options.llmMode).toBe("gemini");
});
it("无效的 LLM 模式应被忽略", () => {
const title = "fix: bug [/ai-review -l invalid-mode]";
const options = parseTitleOptions(title);
expect(options.llmMode).toBeUndefined();
});
});
describe("详细输出级别参数", () => {
it("应该解析 -v 1", () => {
const title = "fix: bug [/ai-review -v 1]";
const options = parseTitleOptions(title);
expect(options.verbose).toBe(1);
});
it("应该解析 -v 2", () => {
const title = "fix: bug [/ai-review -v 2]";
const options = parseTitleOptions(title);
expect(options.verbose).toBe(2);
});
it("-v 不带值时应默认为 1", () => {
const title = "fix: bug [/ai-review -v]";
const options = parseTitleOptions(title);
expect(options.verbose).toBe(1);
});
it("-v 后跟其他参数时应默认为 1", () => {
const title = "fix: bug [/ai-review -v -l openai]";
const options = parseTitleOptions(title);
expect(options.verbose).toBe(1);
expect(options.llmMode).toBe("openai");
});
it("应该解析 --verbose 长参数", () => {
const title = "fix: bug [/ai-review --verbose 2]";
const options = parseTitleOptions(title);
expect(options.verbose).toBe(2);
});
});
describe("dry-run 参数", () => {
it("应该解析 -d 短参数", () => {
const title = "fix: bug [/ai-review -d]";
const options = parseTitleOptions(title);
expect(options.dryRun).toBe(true);
});
it("应该解析 --dry-run 长参数", () => {
const title = "fix: bug [/ai-review --dry-run]";
const options = parseTitleOptions(title);
expect(options.dryRun).toBe(true);
});
});
describe("includes 参数", () => {
it("应该解析 -i 短参数", () => {
const title = "fix: bug [/ai-review -i *.ts]";
const options = parseTitleOptions(title);
expect(options.includes).toEqual(["*.ts"]);
});
it("应该解析多个 includes", () => {
const title = "fix: bug [/ai-review -i *.ts -i *.js]";
const options = parseTitleOptions(title);
expect(options.includes).toEqual(["*.ts", "*.js"]);
});
});
describe("verify-fixes 参数", () => {
it("应该解析 --verify-fixes", () => {
const title = "fix: bug [/ai-review --verify-fixes]";
const options = parseTitleOptions(title);
expect(options.verifyFixes).toBe(true);
});
it("应该解析 --no-verify-fixes", () => {
const title = "fix: bug [/ai-review --no-verify-fixes]";
const options = parseTitleOptions(title);
expect(options.verifyFixes).toBe(false);
});
});
describe("删除代码分析参数", () => {
it("应该解析 --analyze-deletions 无值时默认为 true", () => {
const title = "fix: bug [/ai-review --analyze-deletions]";
const options = parseTitleOptions(title);
expect(options.analyzeDeletions).toBe(true);
});
it("应该解析 --analyze-deletions true", () => {
const title = "fix: bug [/ai-review --analyze-deletions true]";
const options = parseTitleOptions(title);
expect(options.analyzeDeletions).toBe(true);
});
it("应该解析 --analyze-deletions false", () => {
const title = "fix: bug [/ai-review --analyze-deletions false]";
const options = parseTitleOptions(title);
expect(options.analyzeDeletions).toBe(false);
});
it("应该解析 --analyze-deletions ci", () => {
const title = "fix: bug [/ai-review --analyze-deletions ci]";
const options = parseTitleOptions(title);
expect(options.analyzeDeletions).toBe("ci");
});
it("应该解析 --analyze-deletions pr", () => {
const title = "fix: bug [/ai-review --analyze-deletions pr]";
const options = parseTitleOptions(title);
expect(options.analyzeDeletions).toBe("pr");
});
it("应该解析 --analyze-deletions terminal", () => {
const title = "fix: bug [/ai-review --analyze-deletions terminal]";
const options = parseTitleOptions(title);
expect(options.analyzeDeletions).toBe("terminal");
});
it("应该解析 --deletion-only", () => {
const title = "fix: bug [/ai-review --deletion-only]";
const options = parseTitleOptions(title);
expect(options.deletionOnly).toBe(true);
});
it("应该解析 --deletion-analysis-mode", () => {
const title = "fix: bug [/ai-review --deletion-analysis-mode claude-code]";
const options = parseTitleOptions(title);
expect(options.deletionAnalysisMode).toBe("claude-code");
});
});
describe("组合参数", () => {
it("应该正确解析多个参数组合", () => {
const title = "feat: 新功能 [/ai-review -l openai -v 2 -d --no-verify-fixes]";
const options = parseTitleOptions(title);
expect(options.llmMode).toBe("openai");
expect(options.verbose).toBe(2);
expect(options.dryRun).toBe(true);
expect(options.verifyFixes).toBe(false);
});
it("应该处理带引号的参数值", () => {
const title = 'fix: bug [/ai-review -i "src/**/*.ts"]';
const options = parseTitleOptions(title);
expect(options.includes).toEqual(["src/**/*.ts"]);
});
});
describe("大小写不敏感", () => {
it("命令名称应该大小写不敏感", () => {
const title = "fix: bug [/AI-REVIEW -l openai]";
const options = parseTitleOptions(title);
expect(options.llmMode).toBe("openai");
});
});
describe("边界情况", () => {
it("空标题应返回空对象", () => {
const options = parseTitleOptions("");
expect(options).toEqual({});
});
it("命令在标题中间也应该被解析", () => {
const title = "feat: [/review -l openai] 替换 [/ai-review -l openai] 添加新功能";
const options = parseTitleOptions(title);
expect(options.llmMode).toBe("openai");
});
it("多个命令只解析第一个", () => {
const title = "feat: [/review -l openai] 替换 [/ai-review -l openai] [/ai-review -l gemini]";
const options = parseTitleOptions(title);
expect(options.llmMode).toBe("openai");
});
});
});

185
commands/review/src/parse-title-options.ts Normal file
View File

@@ -0,0 +1,185 @@
import type { LLMMode, VerboseLevel } from "@spaceflow/core";
import type { AnalyzeDeletionsMode } from "./review.config";
import { normalizeVerbose } from "@spaceflow/core";
/**
* 从 PR 标题中解析的命令参数
*/
export interface TitleOptions {
llmMode?: LLMMode;
verbose?: VerboseLevel;
dryRun?: boolean;
includes?: string[];
verifyFixes?: boolean;
analyzeDeletions?: AnalyzeDeletionsMode;
deletionOnly?: boolean;
deletionAnalysisMode?: LLMMode;
}
/**
* 从 PR 标题中解析命令参数
*
* 支持的格式：标题末尾 [/review -l openai -v 2]
*
* 支持的参数：
* - `-l, --llm-mode <mode>`: LLM 模式 (claude-code, openai, gemini)
* - `-v, --verbose [level]`: 详细输出级别 (1 或 2)
* - `-d, --dry-run`: 仅打印不执行
* - `-i, --includes <pattern>`: 文件过滤模式
* - `--verify-fixes`: 验证历史问题
* - `--no-verify-fixes`: 禁用历史问题验证
* - `--analyze-deletions`: 分析删除代码
* - `--deletion-only`: 仅执行删除代码分析
* - `--deletion-analysis-mode <mode>`: 删除分析模式
*
* @param title PR 标题
* @returns 解析出的命令参数，如果没有找到命令则返回空对象
*/
export function parseTitleOptions(title: string): TitleOptions {
const options: TitleOptions = {};
// 匹配 [/review ...] 或 [/ai-review ...] (保持向后兼容) 格式
const match = title.match(/\[\/(review|ai-review)\s+([^\]]+)\]/i);
if (!match) {
return options;
}
const argsString = match[2].trim();
const args = parseArgs(argsString);
for (let i = 0; i < args.length; i++) {
const arg = args[i];
switch (arg) {
case "-l":
case "--llm-mode": {
const value = args[++i];
if (value && isValidLLMMode(value)) {
options.llmMode = value;
}
break;
}
case "-v":
case "--verbose": {
const nextArg = args[i + 1];
if (nextArg && !nextArg.startsWith("-")) {
const level = parseInt(nextArg, 10);
if (level === 1 || level === 2) {
options.verbose = level;
i++;
} else {
options.verbose = normalizeVerbose(1);
}
} else {
options.verbose = normalizeVerbose(1);
}
break;
}
case "-d":
case "--dry-run":
options.dryRun = true;
break;
case "-i":
case "--includes": {
const value = args[++i];
if (value && !value.startsWith("-")) {
if (!options.includes) {
options.includes = [];
}
options.includes.push(value);
}
break;
}
case "--verify-fixes":
options.verifyFixes = true;
break;
case "--no-verify-fixes":
options.verifyFixes = false;
break;
case "--analyze-deletions": {
const nextArg = args[i + 1];
if (nextArg && !nextArg.startsWith("-") && isValidAnalyzeDeletionsMode(nextArg)) {
options.analyzeDeletions = parseAnalyzeDeletionsValue(nextArg);
i++;
} else {
options.analyzeDeletions = true;
}
break;
}
case "--deletion-only":
options.deletionOnly = true;
break;
case "--deletion-analysis-mode": {
const value = args[++i];
if (value && isValidDeletionAnalysisMode(value)) {
options.deletionAnalysisMode = value;
}
break;
}
}
}
return options;
}
/**
* 解析参数字符串为数组
* 支持引号包裹的参数值
*/
function parseArgs(argsString: string): string[] {
const args: string[] = [];
let current = "";
let inQuote = false;
let quoteChar = "";
for (let i = 0; i < argsString.length; i++) {
const char = argsString[i];
if ((char === '"' || char === "'") && !inQuote) {
inQuote = true;
quoteChar = char;
} else if (char === quoteChar && inQuote) {
inQuote = false;
quoteChar = "";
} else if (char === " " && !inQuote) {
if (current) {
args.push(current);
current = "";
}
} else {
current += char;
}
}
if (current) {
args.push(current);
}
return args;
}
function isValidLLMMode(value: string): value is LLMMode {
return ["claude-code", "openai", "gemini"].includes(value);
}
function isValidDeletionAnalysisMode(value: string): value is LLMMode {
return ["openai", "claude-code"].includes(value);
}
function isValidAnalyzeDeletionsMode(value: string): boolean {
return ["true", "false", "ci", "pr", "terminal"].includes(value);
}
function parseAnalyzeDeletionsValue(value: string): AnalyzeDeletionsMode {
if (value === "true") return true;
if (value === "false") return false;
return value as "ci" | "pr" | "terminal";
}

144
commands/review/src/review-report/formatters/deletion-impact.formatter.ts Normal file
View File

@@ -0,0 +1,144 @@
import type { DeletionImpactResult, DeletionImpact } from "../../review-spec/types";
const RISK_EMOJI: Record<string, string> = {
high: "🔴",
medium: "🟡",
low: "🟢",
none: "⚪",
};
const RISK_LABEL: Record<string, string> = {
high: "高风险",
medium: "中风险",
low: "低风险",
none: "无风险",
};
export interface DeletionImpactReportOptions {
includeJsonData?: boolean;
}
const DELETION_IMPACT_DATA_START = "<!-- spaceflow-deletion-impact-data-start -->";
const DELETION_IMPACT_DATA_END = "<!-- spaceflow-deletion-impact-data-end -->";
export class DeletionImpactFormatter {
format(result: DeletionImpactResult, options: DeletionImpactReportOptions = {}): string {
const { includeJsonData = true } = options;
const lines: string[] = [];
lines.push("## 🗑️ 删除代码影响分析\n");
// 防御性检查：确保 impacts 是数组
const impacts = result.impacts && Array.isArray(result.impacts) ? result.impacts : [];
if (impacts.length === 0) {
lines.push("✅ **未发现有风险的代码删除**\n");
lines.push(result.summary);
return lines.join("\n");
}
// 统计风险等级
const highRisk = impacts.filter((i) => i.riskLevel === "high");
const mediumRisk = impacts.filter((i) => i.riskLevel === "medium");
const lowRisk = impacts.filter((i) => i.riskLevel === "low");
lines.push("### 📊 风险概览\n");
lines.push(`| 风险等级 | 数量 |`);
lines.push(`|----------|------|`);
if (highRisk.length > 0) {
lines.push(`| ${RISK_EMOJI.high} 高风险 | ${highRisk.length} |`);
}
if (mediumRisk.length > 0) {
lines.push(`| ${RISK_EMOJI.medium} 中风险 | ${mediumRisk.length} |`);
}
if (lowRisk.length > 0) {
lines.push(`| ${RISK_EMOJI.low} 低风险 | ${lowRisk.length} |`);
}
lines.push("");
// 详情折叠
lines.push("<details>");
lines.push("<summary>📋 点击查看详情</summary>\n");
// 高风险项详情
if (highRisk.length > 0) {
lines.push("### 🔴 高风险删除\n");
lines.push(this.formatImpactList(highRisk));
}
// 中风险项详情
if (mediumRisk.length > 0) {
lines.push("### 🟡 中风险删除\n");
lines.push(this.formatImpactList(mediumRisk));
}
// 低风险项
if (lowRisk.length > 0) {
lines.push("### 🟢 低风险删除\n");
lines.push(this.formatImpactList(lowRisk));
}
// 总结
lines.push("\n### 📝 总结\n");
lines.push(result.summary);
lines.push("\n</details>");
return lines.join("\n");
}
private formatImpactList(impacts: DeletionImpact[]): string {
const lines: string[] = [];
for (const impact of impacts) {
const emoji = RISK_EMOJI[impact.riskLevel] || RISK_EMOJI.none;
const label = RISK_LABEL[impact.riskLevel] || "未知";
const codePreview =
impact.deletedCode.length > 50
? impact.deletedCode.slice(0, 50) + "..."
: impact.deletedCode;
lines.push(`#### ${emoji} \`${impact.file}\`\n`);
lines.push(`- **风险等级**: ${label}`);
lines.push(`- **删除代码**: \`${codePreview.replace(/\n/g, " ")}\``);
if (impact.affectedFiles.length > 0) {
lines.push(`- **受影响文件**:`);
for (const file of impact.affectedFiles.slice(0, 5)) {
lines.push(` - \`${file}\``);
}
if (impact.affectedFiles.length > 5) {
lines.push(` - ... 还有 ${impact.affectedFiles.length - 5} 个文件`);
}
}
lines.push(`- **影响分析**: ${impact.reason}`);
if (impact.suggestion) {
lines.push(`- **建议**: ${impact.suggestion}`);
}
lines.push("");
}
return lines.join("\n");
}
parse(content: string): DeletionImpactResult | null {
const startIndex = content.indexOf(DELETION_IMPACT_DATA_START);
const endIndex = content.indexOf(DELETION_IMPACT_DATA_END);
if (startIndex === -1 || endIndex === -1 || startIndex >= endIndex) {
return null;
}
const jsonStart = startIndex + DELETION_IMPACT_DATA_START.length;
const jsonContent = content.slice(jsonStart, endIndex).trim();
try {
return JSON.parse(jsonContent) as DeletionImpactResult;
} catch {
return null;
}
}
}

4
commands/review/src/review-report/formatters/index.ts Normal file
View File

@@ -0,0 +1,4 @@
export * from "./markdown.formatter";
export * from "./json.formatter";
export * from "./terminal.formatter";
export * from "./deletion-impact.formatter";

8
commands/review/src/review-report/formatters/json.formatter.ts Normal file
View File

@@ -0,0 +1,8 @@
import { ReviewResult } from "../../review-spec/types";
import { ReportOptions, ReviewReportFormatter } from "../types";
export class JsonFormatter implements ReviewReportFormatter {
format(result: ReviewResult, _options: ReportOptions = {}): string {
return JSON.stringify(result, null, 2);
}
}

291
commands/review/src/review-report/formatters/markdown.formatter.ts Normal file
View File

@@ -0,0 +1,291 @@
import { extname } from "path";
import {
FileSummary,
ReviewIssue,
ReviewResult,
ReviewStats,
SEVERITY_EMOJI,
} from "../../review-spec/types";
import { ParsedReport, ReportOptions, ReviewReportFormatter, ReviewReportParser } from "../types";
import { DeletionImpactFormatter } from "./deletion-impact.formatter";
const REVIEW_DATA_START = "<!-- spaceflow-review-data-start -->";
const REVIEW_DATA_END = "<!-- spaceflow-review-data-end -->";
function formatDateToUTC8(dateStr: string): string {
const date = new Date(dateStr);
if (isNaN(date.getTime())) return dateStr;
return date.toLocaleString("zh-CN", {
timeZone: "Asia/Shanghai",
year: "numeric",
month: "2-digit",
day: "2-digit",
hour: "2-digit",
minute: "2-digit",
second: "2-digit",
hour12: false,
});
}
export class MarkdownFormatter implements ReviewReportFormatter, ReviewReportParser {
static clearReviewData(content: string, replaceData: string): string {
return content
.replace(new RegExp(`${REVIEW_DATA_START}[\\s\\S]*?${REVIEW_DATA_END}`, "g"), replaceData)
.trim();
}
private readonly deletionImpactFormatter = new DeletionImpactFormatter();
private formatIssueList(issues: ReviewIssue[]): string {
const lines: string[] = [];
for (const issue of issues) {
const severityEmoji = SEVERITY_EMOJI[issue.severity] || SEVERITY_EMOJI.error;
lines.push(`### ${issue.fixed ? "🟢" : severityEmoji} ${issue.file}:${issue.line}\n`);
lines.push(`- **问题**: ${issue.reason}`);
lines.push(`- **规则**: \`${issue.ruleId}\` (来自 \`${issue.specFile}\`)`);
if (issue.commit) {
lines.push(`- **Commit**: ${issue.commit}`);
}
lines.push(`- **开发人员**: ${issue.author ? "@" + issue.author.login : "未知"}`);
if (issue.date) {
lines.push(`- **发现时间**: ${formatDateToUTC8(issue.date)}`);
}
if (issue.fixed) {
lines.push(`- **修复时间**: ${formatDateToUTC8(issue.fixed)}`);
}
if (issue.suggestion) {
const ext = extname(issue.file).slice(1) || "";
const cleanSuggestion = issue.suggestion.replace(/```/g, "//").trim();
const lineCount = cleanSuggestion.split("\n").length;
lines.push("- **建议**:");
if (lineCount < 4) {
lines.push(`\`\`\`${ext}`);
lines.push(cleanSuggestion);
lines.push("```");
} else {
lines.push("<details>");
lines.push("<summary>💡 查看建议</summary>\n");
lines.push(`\`\`\`${ext}`);
lines.push(cleanSuggestion);
lines.push("```");
lines.push("\n</details>");
}
}
// 渲染消息（reactions 统计 + replies 详情，合并到一个折叠块）
const hasReactions = issue.reactions && issue.reactions.length > 0;
const hasReplies = issue.replies && issue.replies.length > 0;
if (hasReactions || hasReplies) {
const reactionCount = hasReactions
? issue.reactions!.reduce((sum, r) => sum + r.users.length, 0)
: 0;
const replyCount = hasReplies ? issue.replies!.length : 0;
const totalCount = reactionCount + replyCount;
lines.push("<details>");
lines.push(`<summary>💬 消息 (${totalCount} 条)</summary>\n`);
// 先显示 reactions 统计（格式：👎(1) 👍(2)）
if (hasReactions) {
const reactionStats = issue.reactions!.map((r) => {
const emoji = this.getReactionEmoji(r.content);
return `${emoji}(${r.users.length})`;
});
lines.push(`> ${reactionStats.join(" ")}`);
}
// 再显示 replies 详情
if (hasReplies) {
for (const reply of issue.replies!) {
const time = reply.createdAt ? formatDateToUTC8(reply.createdAt) : "";
lines.push(`> @${reply.user.login} ${time ? `(${time})` : ""}:`);
lines.push(`> ${reply.body.split("\n").join("\n> ")}`);
lines.push("");
}
}
lines.push("</details>");
}
lines.push("");
}
return lines.join("\n");
}
/** 将 reaction content 转换为 emoji */
private getReactionEmoji(content: string): string {
const emojiMap: Record<string, string> = {
"+1": "👍",
"-1": "👎",
laugh: "😄",
hooray: "🎉",
confused: "😕",
heart: "❤️",
rocket: "🚀",
eyes: "👀",
};
return emojiMap[content] || content;
}
private formatFileSummaries(summaries: FileSummary[], issues: ReviewIssue[]): string {
if (summaries.length === 0) {
return "没有需要审查的文件";
}
const issuesByFile = new Map<string, { resolved: number; unresolved: number }>();
for (const issue of issues) {
if (issue.valid === "false") continue;
const stats = issuesByFile.get(issue.file) || { resolved: 0, unresolved: 0 };
if (issue.fixed) {
stats.resolved++;
} else {
stats.unresolved++;
}
issuesByFile.set(issue.file, stats);
}
const lines: string[] = [];
lines.push("| 文件 | 🟢 | 🔴 | 总结 |");
lines.push("|------|----|----|------|");
for (const fileSummary of summaries) {
const stats = issuesByFile.get(fileSummary.file) || { resolved: 0, unresolved: 0 };
const summaryText = fileSummary.summary
.split("\n")
.filter((line) => line.trim())
.join("<br>");
lines.push(
`| \`${fileSummary.file}\` | ${stats.resolved} | ${stats.unresolved} | ${summaryText} |`,
);
}
return lines.join("\n");
}
parse(content: string): ParsedReport | null {
const startIndex = content.indexOf(REVIEW_DATA_START);
const endIndex = content.indexOf(REVIEW_DATA_END);
if (startIndex === -1 || endIndex === -1 || startIndex >= endIndex) {
return null;
}
const dataStart = startIndex + REVIEW_DATA_START.length;
const encodedContent = content.slice(dataStart, endIndex).trim();
try {
// 尝试 Base64 解码，如果失败则尝试直接解析 JSON（兼容旧格式）
let jsonContent: string;
try {
jsonContent = Buffer.from(encodedContent, "base64").toString("utf-8");
// 验证解码后是否为有效 JSON
JSON.parse(jsonContent);
} catch {
// Base64 解码失败或解码后不是有效 JSON，尝试直接解析（旧格式）
jsonContent = encodedContent;
}
const parsed = JSON.parse(jsonContent);
const hasReanalysisRequest = content.includes("- [x]");
// 新格式：完整的 ReviewResult
return {
result: parsed as ReviewResult,
hasReanalysisRequest,
};
} catch {
return null;
}
}
format(result: ReviewResult, options: ReportOptions = {}): string {
const {
prNumber,
includeReanalysisCheckbox = true,
includeJsonData = true,
reviewCommentMarker,
} = options;
const lines: string[] = [];
if (reviewCommentMarker) {
lines.push(reviewCommentMarker);
}
const validIssues = result.issues.filter((issue) => issue.valid !== "false");
const invalidIssues = result.issues.filter((issue) => issue.valid === "false");
lines.push("# 🤖 AI 代码审查报告\n");
// 输出统计信息（如果有）
if (result.stats) {
lines.push(this.formatStats(result.stats));
lines.push("");
}
// 输出 PR 功能描述
if (result.description) {
lines.push("## 📋 功能概述\n");
// 将 description 中的标题级别降低（h1->h3, h2->h4, h3->h5 等）
const adjustedDescription = result.description.replace(/^(#{1,4})\s/gm, "$1## ");
lines.push(adjustedDescription);
lines.push("");
}
lines.push("## 📝 新增代码分析\n");
lines.push("### 📊 审查概览\n");
lines.push(this.formatFileSummaries(result.summary, validIssues));
lines.push("<details>");
lines.push("<summary>📋 点击查看详情</summary>\n");
lines.push("### 🐛 详细问题\n");
if (validIssues.length === 0 && invalidIssues.length === 0) {
lines.push("✅ **未发现问题**\n");
} else {
if (validIssues.length === 0) {
lines.push("✅ **未发现有效问题**\n");
} else {
lines.push(`⚠️ **发现 ${validIssues.length} 个问题**\n`);
lines.push(this.formatIssueList(validIssues));
}
if (invalidIssues.length > 0) {
lines.push("\n<details>");
lines.push(`<summary>🚫 无效问题 (${invalidIssues.length} 个)</summary>\n`);
lines.push(this.formatIssueList(invalidIssues));
lines.push("\n</details>");
}
}
lines.push("\n</details>");
// if (includeReanalysisCheckbox) {
// lines.push("\n---");
// lines.push("<details>");
// lines.push("<summary>🔄 重新分析</summary>\n");
// if (prNumber) {
// lines.push("- [ ] 勾选此复选框后保存评论，将触发重新分析");
// }
// lines.push("\n</details>");
// }
// 输出删除代码影响分析报告
if (result.deletionImpact) {
lines.push("\n---\n");
lines.push(this.deletionImpactFormatter.format(result.deletionImpact, { includeJsonData }));
}
if (includeJsonData) {
lines.push("");
lines.push("<details>");
lines.push("<summary>📊 审查数据 (JSON)</summary>\n");
lines.push(REVIEW_DATA_START);
lines.push(Buffer.from(JSON.stringify(result)).toString("base64"));
lines.push(REVIEW_DATA_END);
lines.push("\n</details>");
}
return lines.join("\n");
}
formatStats(stats: ReviewStats, prNumber?: number): string {
const title = prNumber ? `PR #${prNumber} Review 状态统计` : "Review 状态统计";
const lines = [`## 📊 ${title}\n`, `| 指标 | 数量 |`, `|------|------|`];
lines.push(`| 总问题数 | ${stats.total} |`);
lines.push(`| ✅ 已修复 | ${stats.fixed} |`);
lines.push(`| ❌ 无效 | ${stats.invalid} |`);
lines.push(`| ⚠️ 待处理 | ${stats.pending} |`);
lines.push(`| 修复率 | ${stats.fixRate}% |`);
return lines.join("\n");
}
}

130
commands/review/src/review-report/formatters/terminal.formatter.ts Normal file
View File

@@ -0,0 +1,130 @@
import { extname } from "path";
import {
FileSummary,
ReviewIssue,
ReviewResult,
ReviewStats,
Severity,
} from "../../review-spec/types";
import { ReportOptions, ReviewReportFormatter } from "../types";
const SEVERITY_COLORS: Record<Severity, string> = {
off: "\x1b[90m",
warn: "\x1b[33m",
error: "\x1b[31m",
};
const RESET = "\x1b[0m";
const BOLD = "\x1b[1m";
const DIM = "\x1b[2m";
const CYAN = "\x1b[36m";
const GREEN = "\x1b[32m";
const YELLOW = "\x1b[33m";
const RED = "\x1b[31m";
export class TerminalFormatter implements ReviewReportFormatter {
private formatFileSummaries(summaries: FileSummary[], issues: ReviewIssue[]): string {
if (summaries.length === 0) {
return "没有需要审查的文件";
}
const issuesByFile = new Map<string, { resolved: number; unresolved: number }>();
for (const issue of issues) {
const stats = issuesByFile.get(issue.file) || { resolved: 0, unresolved: 0 };
if (issue.fixed) {
stats.resolved++;
} else {
stats.unresolved++;
}
issuesByFile.set(issue.file, stats);
}
const lines: string[] = [];
for (const fileSummary of summaries) {
const stats = issuesByFile.get(fileSummary.file) || { resolved: 0, unresolved: 0 };
const resolvedText = stats.resolved > 0 ? `${GREEN}✅ ${stats.resolved} 已解决${RESET}` : "";
const unresolvedText =
stats.unresolved > 0 ? `${YELLOW}❌ ${stats.unresolved} 未解决${RESET}` : "";
const statsText = [resolvedText, unresolvedText].filter(Boolean).join(" / ");
if (statsText) {
lines.push(`${BOLD}${fileSummary.file}${RESET} (${statsText}): ${fileSummary.summary}`);
} else {
lines.push(`${BOLD}${fileSummary.file}${RESET}: ${fileSummary.summary}`);
}
}
return lines.join("\n");
}
format(result: ReviewResult, _options: ReportOptions = {}): string {
const lines: string[] = [];
lines.push("");
lines.push(`${BOLD}${CYAN}═══════════════════════════════════════════════════════════${RESET}`);
lines.push(
`${BOLD}${CYAN} 🤖 AI 代码审查报告 ${RESET}`,
);
lines.push(`${BOLD}${CYAN}═══════════════════════════════════════════════════════════${RESET}`);
lines.push("");
const issues = result.issues;
if (issues.length === 0) {
lines.push(`${GREEN}✅ 未发现问题${RESET}`);
lines.push("");
lines.push(this.formatFileSummaries(result.summary, []));
} else {
lines.push(`${YELLOW}⚠️ 发现 ${issues.length} 个问题${RESET}`);
lines.push("");
for (let i = 0; i < issues.length; i++) {
const issue = issues[i];
const color = SEVERITY_COLORS[issue.severity] || SEVERITY_COLORS.error;
const severityLabel = issue.severity.toUpperCase();
lines.push(`${DIM}───────────────────────────────────────────────────────────${RESET}`);
lines.push(`${BOLD}[${i + 1}/${issues.length}]${RESET} ${color}${severityLabel}${RESET}`);
lines.push(`${BOLD}📍 位置:${RESET} ${issue.file}:${issue.line}`);
lines.push(`${BOLD}📋 规则:${RESET} ${issue.ruleId} ${DIM}(${issue.specFile})${RESET}`);
lines.push(`${BOLD}❓ 问题:${RESET} ${issue.reason}`);
if (issue.commit) {
lines.push(`${BOLD}📝 Commit:${RESET} ${issue.commit}`);
}
if (issue.suggestion) {
const ext = extname(issue.file).slice(1) || "";
lines.push(`${BOLD}💡 建议:${RESET}`);
lines.push(`${DIM}--- ${ext} ---${RESET}`);
lines.push(issue.suggestion);
lines.push(`${DIM}------------${RESET}`);
}
lines.push("");
}
lines.push(`${DIM}───────────────────────────────────────────────────────────${RESET}`);
lines.push("");
lines.push(`${BOLD}📝 总结${RESET}`);
lines.push(this.formatFileSummaries(result.summary, issues));
}
lines.push("");
lines.push(`${BOLD}${CYAN}═══════════════════════════════════════════════════════════${RESET}`);
lines.push("");
return lines.join("\n");
}
formatStats(stats: ReviewStats, prNumber?: number): string {
const title = prNumber ? `PR #${prNumber} Review 状态统计` : "Review 状态统计";
const lines = [`\n${BOLD}${CYAN}📊 ${title}:${RESET}`];
lines.push(` 总问题数: ${stats.total}`);
lines.push(` ${GREEN}✅ 已修复: ${stats.fixed}${RESET}`);
lines.push(` ${RED}❌ 无效: ${stats.invalid}${RESET}`);
lines.push(` ${YELLOW}⚠️ 待处理: ${stats.pending}${RESET}`);
lines.push(` 修复率: ${stats.fixRate}%`);
return lines.join("\n");
}
}

4
commands/review/src/review-report/index.ts Normal file
View File

@@ -0,0 +1,4 @@
export * from "./types";
export * from "./formatters";
export * from "./review-report.service";
export * from "./review-report.module";

8
commands/review/src/review-report/review-report.module.ts Normal file
View File

@@ -0,0 +1,8 @@
import { Module } from "@nestjs/common";
import { ReviewReportService } from "./review-report.service";
@Module({
providers: [ReviewReportService],
exports: [ReviewReportService],
})
export class ReviewReportModule {}

58
commands/review/src/review-report/review-report.service.ts Normal file
View File

@@ -0,0 +1,58 @@
import { Injectable } from "@nestjs/common";
import { ReviewResult, ReviewStats } from "../review-spec/types";
import { JsonFormatter, MarkdownFormatter, TerminalFormatter } from "./formatters";
import { ParsedReport, ReportFormat, ReportOptions, ReviewReportFormatter } from "./types";
@Injectable()
export class ReviewReportService {
private readonly markdownFormatter = new MarkdownFormatter();
private readonly terminalFormatter = new TerminalFormatter();
private formatters: Map<ReportFormat, ReviewReportFormatter> = new Map([
["markdown", this.markdownFormatter],
["json", new JsonFormatter()],
["terminal", this.terminalFormatter],
]);
format(result: ReviewResult, format: ReportFormat = "markdown", options?: ReportOptions): string {
const formatter = this.formatters.get(format);
if (!formatter) {
throw new Error(`Unsupported format: ${format}`);
}
return formatter.format(result, options);
}
formatMarkdown(result: ReviewResult, options?: ReportOptions): string {
return this.format(result, "markdown", options);
}
formatJson(result: ReviewResult, options?: ReportOptions): string {
return this.format(result, "json", options);
}
formatTerminal(result: ReviewResult, options?: ReportOptions): string {
return this.format(result, "terminal", options);
}
parseMarkdown(content: string): ParsedReport | null {
return this.markdownFormatter.parse(content);
}
registerFormatter(format: ReportFormat, formatter: ReviewReportFormatter): void {
this.formatters.set(format, formatter);
}
/**
* 格式化统计信息为终端输出
*/
formatStatsTerminal(stats: ReviewStats, prNumber?: number): string {
return this.terminalFormatter.formatStats(stats, prNumber);
}
/**
* 格式化统计信息为 Markdown
*/
formatStatsMarkdown(stats: ReviewStats, prNumber?: number): string {
return this.markdownFormatter.formatStats(stats, prNumber);
}
}

26
commands/review/src/review-report/types.ts Normal file
View File

@@ -0,0 +1,26 @@
import { ReviewIssue, ReviewResult, ReviewStats } from "../review-spec/types";
export type ReportFormat = "markdown" | "json" | "terminal";
export interface ReportOptions {
prNumber?: number;
includeReanalysisCheckbox?: boolean;
includeJsonData?: boolean;
reviewCommentMarker?: string;
}
export interface ParsedReport {
/** 完整的 ReviewResult 数据 */
result: ReviewResult;
/** 是否请求重新分析 */
hasReanalysisRequest?: boolean;
}
export interface ReviewReportFormatter {
format(result: ReviewResult, options?: ReportOptions): string;
formatStats?(stats: ReviewStats, prNumber?: number): string;
}
export interface ReviewReportParser {
parse(content: string): ParsedReport | null;
}

3
commands/review/src/review-spec/index.ts Normal file
View File

@@ -0,0 +1,3 @@
export * from "./types";
export * from "./review-spec.service";
export * from "./review-spec.module";

10
commands/review/src/review-spec/review-spec.module.ts Normal file
View File

@@ -0,0 +1,10 @@
import { Module } from "@nestjs/common";
import { GitProviderModule } from "@spaceflow/core";
import { ReviewSpecService } from "./review-spec.service";
@Module({
imports: [GitProviderModule.forFeature()],
providers: [ReviewSpecService],
exports: [ReviewSpecService],
})
export class ReviewSpecModule {}

1543
commands/review/src/review-spec/review-spec.service.spec.ts Normal file
View File

File diff suppressed because it is too large Load Diff

902
commands/review/src/review-spec/review-spec.service.ts Normal file
View File

@@ -0,0 +1,902 @@
import {
Injectable,
type ChangedFile,
type VerboseLevel,
shouldLog,
GitProviderService,
parseRepoUrl,
type RemoteRepoRef,
type RepositoryContent,
} from "@spaceflow/core";
import { Optional } from "@nestjs/common";
import { readdir, readFile, mkdir, access, writeFile } from "fs/promises";
import { join, basename, extname } from "path";
import { homedir } from "os";
import { execSync } from "child_process";
import micromatch from "micromatch";
import { ReviewSpec, ReviewRule, RuleExample, Severity } from "./types";
/** 远程规则缓存 TTL（毫秒），默认 5 分钟 */
const REMOTE_SPEC_CACHE_TTL = 5 * 60 * 1000;
@Injectable()
export class ReviewSpecService {
constructor(@Optional() protected readonly gitProvider?: GitProviderService) {}
/**
* 检查规则 ID 是否匹配（精确匹配或前缀匹配）
* 例如: "JsTs.FileName" 匹配 "JsTs.FileName" 和 "JsTs.FileName.UpperCamel"
*/
protected matchRuleId(ruleId: string, pattern: string): boolean {
if (!ruleId || !pattern) {
console.warn(
`matchRuleId: 参数为空 (ruleId=${JSON.stringify(ruleId)}, pattern=${JSON.stringify(pattern)})`,
);
return false;
}
return ruleId === pattern || ruleId.startsWith(pattern + ".");
}
/**
* 从 Map 中查找匹配的规则值（精确匹配优先，然后前缀匹配）
*/
protected findByRuleId<T>(ruleId: string, map: Map<string, T>): T | undefined {
if (!ruleId) {
console.warn(`findByRuleId: ruleId 为空 (ruleId=${JSON.stringify(ruleId)})`);
return undefined;
}
// 精确匹配
if (map.has(ruleId)) {
return map.get(ruleId);
}
// 前缀匹配
for (const [key, value] of map) {
if (ruleId.startsWith(key + ".")) {
return value;
}
}
return undefined;
}
/**
* 根据变更文件的扩展名过滤适用的规则文件
* 只按扩展名过滤，includes 和 override 在 LLM 审查后处理
*/
filterApplicableSpecs(specs: ReviewSpec[], changedFiles: { filename?: string }[]): ReviewSpec[] {
const changedExtensions = new Set<string>();
for (const file of changedFiles) {
if (file.filename) {
const ext = extname(file.filename).slice(1).toLowerCase();
if (ext) {
changedExtensions.add(ext);
}
}
}
return specs.filter((spec) => spec.extensions.some((ext) => changedExtensions.has(ext)));
}
async loadReviewSpecs(specDir: string): Promise<ReviewSpec[]> {
const specs: ReviewSpec[] = [];
try {
const files = await readdir(specDir);
for (const file of files) {
if (!file.endsWith(".md")) continue;
const content = await readFile(join(specDir, file), "utf-8");
const spec = this.parseSpecFile(file, content);
if (spec) {
specs.push(spec);
}
}
} catch (error) {
// 目录不存在时静默跳过（这些是可选的配置目录）
if ((error as NodeJS.ErrnoException).code !== "ENOENT") {
console.warn(`警告: 无法读取规则目录 ${specDir}:`, error);
}
}
return specs;
}
async resolveSpecSources(sources: string[]): Promise<string[]> {
const dirs: string[] = [];
for (const source of sources) {
// 优先尝试解析为远程仓库 URL（浏览器复制的链接）
const repoRef = parseRepoUrl(source);
if (repoRef && this.gitProvider) {
const dir = await this.fetchRemoteSpecs(repoRef);
if (dir) {
dirs.push(dir);
continue;
}
}
if (this.isRepoUrl(source)) {
const dir = await this.cloneSpecRepo(source);
if (dir) {
dirs.push(dir);
}
} else {
// 检查是否是 deps 目录，如果是则扫描子目录的 references
const resolvedDirs = await this.resolveDepsDir(source);
dirs.push(...resolvedDirs);
}
}
return dirs;
}
/**
* 通过 Git API 从远程仓库拉取规则文件
* 缓存到 ~/.spaceflow/review-spec-cache/ 目录，带 TTL
*/
protected async fetchRemoteSpecs(ref: RemoteRepoRef): Promise<string | null> {
const cacheKey = `${ref.owner}__${ref.repo}${ref.path ? `__${ref.path.replace(/\//g, "_")}` : ""}${ref.ref ? `@${ref.ref}` : ""}`;
const cacheDir = join(homedir(), ".spaceflow", "review-spec-cache", cacheKey);
// 检查缓存是否有效（非 CI 环境下使用 TTL）
const isCI = !!process.env.CI;
if (!isCI) {
try {
const timestampFile = join(cacheDir, ".timestamp");
const timestamp = await readFile(timestampFile, "utf-8");
const age = Date.now() - Number(timestamp);
if (age < REMOTE_SPEC_CACHE_TTL) {
const entries = await readdir(cacheDir);
if (entries.some((f) => f.endsWith(".md"))) {
return cacheDir;
}
}
} catch {
// 缓存不存在或无效，继续拉取
}
}
try {
console.log(
` 📡 从远程仓库拉取规则: ${ref.owner}/${ref.repo}${ref.path ? `/${ref.path}` : ""}${ref.ref ? `@${ref.ref}` : ""}`,
);
const contents = await this.gitProvider!.listRepositoryContents(
ref.owner,
ref.repo,
ref.path || undefined,
ref.ref,
);
const mdFiles = contents.filter(
(f: RepositoryContent) => f.type === "file" && f.name.endsWith(".md"),
);
if (mdFiles.length === 0) {
console.warn(` ⚠️ 远程目录中未找到 .md 规则文件`);
return null;
}
await mkdir(cacheDir, { recursive: true });
for (const file of mdFiles) {
const content = await this.gitProvider!.getFileContent(
ref.owner,
ref.repo,
file.path,
ref.ref,
);
await writeFile(join(cacheDir, file.name), content, "utf-8");
}
// 写入时间戳
await writeFile(join(cacheDir, ".timestamp"), String(Date.now()), "utf-8");
console.log(` ✅ 已拉取 ${mdFiles.length} 个规则文件到缓存`);
return cacheDir;
} catch (error) {
console.warn(` ⚠️ 远程规则拉取失败:`, error instanceof Error ? error.message : error);
// 尝试使用过期缓存
try {
const entries = await readdir(cacheDir);
if (entries.some((f) => f.endsWith(".md"))) {
console.log(` 📦 使用过期缓存`);
return cacheDir;
}
} catch {
// 无缓存可用
}
return null;
}
}
/**
* 解析 deps 目录，扫描子目录中的 references 文件夹
* 如果目录本身包含 .md 文件则直接返回，否则扫描子目录
*/
protected async resolveDepsDir(dir: string): Promise<string[]> {
const dirs: string[] = [];
try {
const entries = await readdir(dir, { withFileTypes: true });
// 检查目录本身是否包含 .md 文件
const hasMdFiles = entries.some((e) => e.isFile() && e.name.endsWith(".md"));
if (hasMdFiles) {
dirs.push(dir);
return dirs;
}
// 扫描子目录
for (const entry of entries) {
if (entry.isDirectory()) {
const subDir = join(dir, entry.name);
// 优先检查 references 子目录
const referencesDir = join(subDir, "references");
try {
await access(referencesDir);
dirs.push(referencesDir);
} catch {
// 没有 references 子目录，检查子目录本身是否有 .md 文件
try {
const subEntries = await readdir(subDir);
if (subEntries.some((f) => f.endsWith(".md"))) {
dirs.push(subDir);
}
} catch {
// 忽略无法读取的子目录
}
}
}
}
} catch {
// 目录不存在时静默跳过
}
return dirs;
}
protected isRepoUrl(source: string): boolean {
return (
source.startsWith("http://") ||
source.startsWith("https://") ||
source.startsWith("git@") ||
source.includes("://")
);
}
protected async cloneSpecRepo(repoUrl: string): Promise<string | null> {
const repoName = this.extractRepoName(repoUrl);
if (!repoName) {
console.warn(`警告: 无法解析仓库名称: ${repoUrl}`);
return null;
}
const cacheDir = join(homedir(), ".spaceflow", "review-spec", repoName);
try {
await access(cacheDir);
// console.log(` 使用缓存的规则仓库: ${cacheDir}`);
try {
execSync("git pull --ff-only", { cwd: cacheDir, stdio: "pipe" });
// console.log(` 已更新规则仓库`);
} catch {
console.warn(` 警告: 无法更新规则仓库，使用现有版本`);
}
return cacheDir;
} catch {
// console.log(` 克隆规则仓库: ${repoUrl}`);
try {
await mkdir(join(homedir(), ".spaceflow", "review-spec"), { recursive: true });
execSync(`git clone --depth 1 "${repoUrl}" "${cacheDir}"`, { stdio: "pipe" });
// console.log(` 克隆完成: ${cacheDir}`);
return cacheDir;
} catch (error) {
console.warn(`警告: 无法克隆仓库 ${repoUrl}:`, error);
return null;
}
}
}
protected extractRepoName(repoUrl: string): string | null {
let path = repoUrl;
path = path.replace(/\.git$/, "");
path = path.replace(/^git@[^:]+:/, "");
path = path.replace(/^https?:\/\/[^/]+\//, "");
const parts = path.split("/").filter(Boolean);
if (parts.length >= 2) {
return `${parts[parts.length - 2]}__${parts[parts.length - 1]}`;
} else if (parts.length === 1) {
return parts[0];
}
return null;
}
parseSpecFile(filename: string, content: string): ReviewSpec | null {
const nameWithoutExt = basename(filename, ".md");
const parts = nameWithoutExt.split(".");
if (parts.length < 2) {
console.warn(`警告: 规则文件名格式不正确: ${filename}`);
return null;
}
const extensionsPart = parts[0];
const type = parts.slice(1).join(".");
const extensions = extensionsPart.split("&").map((ext) => ext.toLowerCase());
const rules = this.extractRules(content);
// 文件级别的 override 来自第一个规则（标题规则）的 overrides
const fileOverrides = rules.length > 0 ? rules[0].overrides : [];
// 文件级别的 severity 来自第一个规则（标题规则）的 severity，默认为 error
const fileSeverity = (rules.length > 0 ? rules[0].severity : undefined) || "error";
// 文件级别的 includes 从内容中提取
const fileIncludes = this.extractIncludes(content);
return {
filename,
extensions,
type,
content,
rules,
overrides: fileOverrides,
severity: fileSeverity,
includes: fileIncludes,
};
}
protected extractRules(content: string): ReviewRule[] {
const rules: ReviewRule[] = [];
const ruleRegex = /^(#{1,3})\s+(.+?)\s+`\[([^\]]+)\]`/gm;
const matches: { index: number; length: number; title: string; id: string }[] = [];
let match;
while ((match = ruleRegex.exec(content)) !== null) {
matches.push({
index: match.index,
length: match[0].length,
title: match[2].trim(),
id: match[3],
});
}
for (let i = 0; i < matches.length; i++) {
const current = matches[i];
const startIndex = current.index + current.length;
const endIndex = i + 1 < matches.length ? matches[i + 1].index : content.length;
const ruleContent = content.slice(startIndex, endIndex).trim();
const examples = this.extractExamples(ruleContent);
const overrides = this.extractOverrides(ruleContent);
// 提取描述：在第一个例子之前的文本
let description = ruleContent;
const firstExampleIndex = ruleContent.search(/(?:^|\n)###\s+(?:good|bad)/i);
if (firstExampleIndex !== -1) {
description = ruleContent.slice(0, firstExampleIndex).trim();
} else {
// 如果没有例子，则整个 ruleContent 都是描述
description = ruleContent;
}
const severity = this.extractSeverity(ruleContent);
const includes = this.extractConfigValues(ruleContent, "includes");
rules.push({
id: current.id,
title: current.title,
description,
examples,
overrides,
severity,
includes: includes.length > 0 ? includes : undefined,
});
}
return rules;
}
/**
* 通用配置解析方法
* 格式: > - <configName> `value1` `value2` ...
* 同名配置项后面的覆盖前面的
*/
protected extractConfigValues(content: string, configName: string): string[] {
const configRegex = new RegExp(`^>\\s*-\\s*${configName}\\s+(.+)$`, "gm");
let values: string[] = [];
let match;
while ((match = configRegex.exec(content)) !== null) {
const valuesStr = match[1];
const valueRegex = /`([^`]+)`/g;
let valueMatch;
const lineValues: string[] = [];
while ((valueMatch = valueRegex.exec(valuesStr)) !== null) {
lineValues.push(valueMatch[1]);
}
// 同名配置项覆盖
values = lineValues;
}
return values;
}
protected extractOverrides(content: string): string[] {
// override 的值格式是 `[RuleId]`，需要去掉方括号
return this.extractConfigValues(content, "override").map((v) =>
v.startsWith("[") && v.endsWith("]") ? v.slice(1, -1) : v,
);
}
protected extractSeverity(content: string): Severity | undefined {
const values = this.extractConfigValues(content, "severity");
if (values.length > 0) {
const value = values[values.length - 1];
if (value === "off" || value === "warn" || value === "error") {
return value;
}
}
return undefined;
}
protected extractIncludes(content: string): string[] {
// 只提取文件开头（第一个 ## 规则标题之前）的 includes 配置
// 避免规则级的 includes 覆盖文件级的 includes
const firstRuleIndex = content.indexOf("\n## ");
const headerContent = firstRuleIndex > 0 ? content.slice(0, firstRuleIndex) : content;
return this.extractConfigValues(headerContent, "includes");
}
protected extractExamples(content: string): RuleExample[] {
const examples: RuleExample[] = [];
const sections = content.split(/(?:^|\n)###\s+/);
for (const section of sections) {
const trimmedSection = section.trim();
if (!trimmedSection) continue;
let type: "good" | "bad" | null = null;
if (/^good\b/i.test(trimmedSection)) {
type = "good";
} else if (/^bad\b/i.test(trimmedSection)) {
type = "bad";
}
if (!type) continue;
const codeBlockRegex = /```(\w*)\n([\s\S]*?)```/g;
let codeMatch;
while ((codeMatch = codeBlockRegex.exec(trimmedSection)) !== null) {
const lang = codeMatch[1] || "text";
const code = codeMatch[2].trim();
examples.push({ lang, code, type });
}
}
return examples;
}
/**
* 收集所有 override 声明并排除被覆盖的规则
* override 使用前缀匹配：如果规则 ID 以 override 值开头，则被排除
*/
applyOverrides(specs: ReviewSpec[], verbose?: VerboseLevel): ReviewSpec[] {
// 收集所有 override 声明（文件级别 + 规则级别）
const allOverrides: string[] = [];
for (const spec of specs) {
allOverrides.push(...spec.overrides);
for (const rule of spec.rules) {
allOverrides.push(...rule.overrides);
}
}
if (allOverrides.length === 0) {
return specs;
}
// 过滤规则：排除 ID 以任意 override 值开头的规则
return specs
.map((spec) => ({
...spec,
rules: spec.rules.filter((rule) => {
const isOverridden = allOverrides.some((override) => this.matchRuleId(rule.id, override));
if (isOverridden && shouldLog(verbose, 2)) {
console.error(` 规则 [${rule.id}] 被 override 排除`);
}
return !isOverridden;
}),
}))
.filter((spec) => spec.rules.length > 0);
}
/**
* 根据 spec 的 includes 配置过滤 issues
* 只保留文件名匹配对应 spec includes 模式的 issues
* 如果 spec 没有 includes 配置，则保留该 spec 的所有 issues
*/
filterIssuesByIncludes<T extends { file: string; ruleId: string }>(
issues: T[],
specs: ReviewSpec[],
): T[] {
// 构建 spec filename -> includes 的映射
const specIncludesMap = new Map<string, string[]>();
for (const spec of specs) {
// 从规则 ID 前缀推断 spec filename
for (const rule of spec.rules) {
specIncludesMap.set(rule.id, spec.includes);
}
}
return issues.filter((issue) => {
// 找到该 issue 对应的 spec includes
const includes = this.findByRuleId(issue.ruleId, specIncludesMap) ?? [];
// 如果没有 includes 配置，保留该 issue
if (includes.length === 0) {
return true;
}
// 检查文件是否匹配 includes 模式
const matches = micromatch.isMatch(issue.file, includes, { matchBase: true });
if (!matches) {
// console.log(` Issue [${issue.ruleId}] 在文件 ${issue.file} 不匹配 includes 模式，跳过`);
}
return matches;
});
}
/**
* 根据 override 配置过滤 issues，排除被覆盖规则产生的 issues
*
* ## Override 机制说明
* Override 允许高优先级规则"覆盖"低优先级规则。当规则 A 声明 `overrides: ["B"]` 时，
* 规则 B 产生的 issues 会被过滤掉，避免重复报告或低优先级噪音。
*
* ## 作用域规则
* Override 是**作用域感知**的：只有当 issue 的文件匹配 override 所在 spec 的 includes 时，
* 该 override 才会生效。这允许不同目录/文件类型使用不同的规则优先级。
*
* 示例：
* ```yaml
* # controller-spec.yaml (includes: ["*.controller.ts"])
* overrides: ["JsTs.Base.Rule1"] # 只在 controller 文件中覆盖 Rule1
* ```
* 上述 override 不会影响 `*.service.ts` 文件中的 `Rule1` issues。
*
* ## 处理流程
* 1. **收集阶段**：遍历所有 specs，收集 overrides 并保留其作用域（includes）信息
* - 文件级 overrides (`spec.overrides`) - 继承 spec 的 includes 作用域
* - 规则级 overrides (`rule.overrides`) - 同样继承 spec 的 includes 作用域
* 2. **过滤阶段**：对每个 issue，检查是否存在匹配的 override
* - 需同时满足：ruleId 匹配 AND issue 文件在 override 的 includes 作用域内
* - 如果 includes 为空，表示全局作用域（匹配所有文件）
*
* @param issues - 待过滤的 issues 列表，每个 issue 必须包含 ruleId 字段，可选 file 字段
* @param specs - 已加载的 ReviewSpec 列表
* @param verbose - 日志详细级别：1=基础统计，3=详细收集过程
* @returns 过滤后的 issues 列表（排除了被 override 的规则产生的 issues）
*/
filterIssuesByOverrides<T extends { ruleId: string; file?: string }>(
issues: T[],
specs: ReviewSpec[],
verbose?: VerboseLevel,
): T[] {
// ========== 阶段1: 收集 spec -> overrides 的映射（保留作用域信息） ==========
// 每个 override 需要记录其来源 spec 的 includes，用于作用域判断
const scopedOverrides: Array<{
override: string;
includes: string[];
source: string; // 用于日志：spec filename 或 rule id
}> = [];
for (const spec of specs) {
// 文件级 overrides：作用域为该 spec 的 includes
if (shouldLog(verbose, 3) && spec.overrides.length > 0) {
console.error(` 📋 ${spec.filename} 文件级 overrides: ${spec.overrides.join(", ")}`);
}
for (const override of spec.overrides) {
scopedOverrides.push({
override,
includes: spec.includes,
source: spec.filename,
});
}
// 规则级 overrides：继承该 spec 的 includes 作用域
for (const rule of spec.rules) {
if (shouldLog(verbose, 3) && rule.overrides.length > 0) {
console.error(
` 📋 ${spec.filename} 规则 [${rule.id}] overrides: ${rule.overrides.join(", ")}`,
);
}
for (const override of rule.overrides) {
scopedOverrides.push({
override,
includes: spec.includes,
source: `${spec.filename}#${rule.id}`,
});
}
}
}
// 输出收集结果汇总（verbose=3 时）
if (shouldLog(verbose, 3)) {
const overrideList = scopedOverrides.map((o) => o.override);
console.error(
` 🔍 收集到的 overrides 总计: ${overrideList.length > 0 ? overrideList.join(", ") : "(无)"}`,
);
}
// 快速路径：无 override 声明时直接返回原列表
if (scopedOverrides.length === 0) {
return issues;
}
// ========== 阶段2: 过滤 issues（作用域感知） ==========
// 对每个 issue，只检查其文件匹配的 spec 中声明的 overrides
const beforeCount = issues.length;
const skipped: Array<{ issue: T; override: string; source: string }> = [];
const filtered = issues.filter((issue) => {
const issueFile = "file" in issue ? (issue as { file: string }).file : "";
// 查找第一个匹配的 override（需同时满足：ruleId 匹配 AND 文件在 includes 作用域内）
const matched = scopedOverrides.find((scoped) => {
// 检查 ruleId 是否匹配 override 模式
if (!this.matchRuleId(issue.ruleId, scoped.override)) {
return false;
}
// 检查 issue 文件是否在该 override 的作用域内
// 如果 includes 为空，表示全局作用域（匹配所有文件）
if (scoped.includes.length === 0) {
return true;
}
// 使用 micromatch 检查文件是否匹配 includes 模式
return issueFile && micromatch.isMatch(issueFile, scoped.includes, { matchBase: true });
});
if (matched) {
skipped.push({ issue, override: matched.override, source: matched.source });
return false;
}
return true;
});
// ========== 阶段3: 输出过滤结果日志 ==========
if (skipped.length > 0 && shouldLog(verbose, 1)) {
console.error(` Override 过滤: ${beforeCount} -> ${filtered.length} 个问题`);
for (const { issue, override, source } of skipped) {
const file = "file" in issue ? (issue as { file: string }).file : "";
const line = "line" in issue ? (issue as { line: string }).line : "";
console.error(
` ❌ [${issue.ruleId}] ${file}:${line} (override: ${override} from ${source})`,
);
}
}
return filtered;
}
/**
* 根据变更文件的 patch 信息过滤 issues
* 只保留 issue 的行号在实际变更行范围内的问题
*/
filterIssuesByCommits<T extends { file: string; line: string }>(
issues: T[],
changedFiles: { filename?: string; patch?: string }[],
): T[] {
// 构建文件 -> 变更行集合的映射
const fileChangedLines = new Map<string, Set<number>>();
for (const file of changedFiles) {
if (!file.filename || !file.patch) continue;
const lines = this.parseChangedLinesFromPatch(file.patch);
fileChangedLines.set(file.filename, lines);
}
return issues.filter((issue) => {
const changedLines = fileChangedLines.get(issue.file);
// 如果没有该文件的 patch 信息，保留 issue
if (!changedLines || changedLines.size === 0) {
return true;
}
// 解析 issue 的行号（支持单行或范围如 "123" 或 "123-125"）
const issueLines = this.parseLineRange(issue.line);
// 检查 issue 的任意行是否在变更行范围内
const matches = issueLines.some((line) => changedLines.has(line));
if (!matches) {
// console.log(` Issue ${issue.file}:${issue.line} 不在变更行范围内，跳过`);
}
return matches;
});
}
/**
* 从 unified diff patch 中解析变更的行号（新文件中的行号）
*/
protected parseChangedLinesFromPatch(patch: string): Set<number> {
const changedLines = new Set<number>();
const lines = patch.split("\n");
let currentLine = 0;
for (const line of lines) {
// 解析 hunk header: @@ -oldStart,oldCount +newStart,newCount @@
const hunkMatch = line.match(/^@@ -\d+(?:,\d+)? \+(\d+)(?:,\d+)? @@/);
if (hunkMatch) {
currentLine = parseInt(hunkMatch[1], 10);
continue;
}
if (line.startsWith("+") && !line.startsWith("+++")) {
// 新增行
changedLines.add(currentLine);
currentLine++;
} else if (line.startsWith("-") && !line.startsWith("---")) {
// 删除行不增加行号
} else {
// 上下文行
currentLine++;
}
}
return changedLines;
}
/**
* 解析行号字符串，支持单行 "123" 或范围 "123-125"
* 返回行号数组，如果解析失败返回空数组
*/
parseLineRange(lineStr: string): number[] {
const lines: number[] = [];
const rangeMatch = lineStr.match(/^(\d+)-(\d+)$/);
if (rangeMatch) {
const start = parseInt(rangeMatch[1], 10);
const end = parseInt(rangeMatch[2], 10);
for (let i = start; i <= end; i++) {
lines.push(i);
}
} else {
const line = parseInt(lineStr, 10);
if (!isNaN(line)) {
lines.push(line);
}
}
return lines;
}
/**
* 构建 specs 的 prompt 部分
*/
buildSpecsSection(specs: ReviewSpec[]): string {
return specs
.map((spec) => {
const firstRule = spec.rules[0];
const rulesText = spec.rules
.slice(1)
.map((rule) => {
let text = `#### [${rule.id}] ${rule.title}\n`;
if (rule.description) {
text += `${rule.description}\n`;
}
if (rule.examples.length > 0) {
for (const example of rule.examples) {
text += `##### ${example.type === "good" ? "推荐做法 (Good)" : "不推荐做法 (Bad)"}\n`;
text += `\`\`\`${example.lang}\n${example.code}\n\`\`\`\n`;
}
}
return text;
})
.join("\n");
return `### ${firstRule.title}\n- 规范文件: ${spec.filename}\n- 适用扩展名: ${spec.extensions.join(", ")}\n\n${rulesText}`;
})
.join("\n\n-------------------\n\n");
}
/**
* 根据 ruleId 查找规则定义
* 支持精确匹配和前缀匹配
*/
findRuleById(ruleId: string, specs: ReviewSpec[]): { rule: ReviewRule; spec: ReviewSpec } | null {
for (const spec of specs) {
for (const rule of spec.rules) {
if (this.matchRuleId(ruleId, rule.id)) {
return { rule, spec };
}
}
}
return null;
}
/**
* 过滤 issues，只保留 ruleId 存在于 specs 中的问题
*/
filterIssuesByRuleExistence<T extends { ruleId: string }>(issues: T[], specs: ReviewSpec[]): T[] {
return issues.filter((issue) => {
const ruleInfo = this.findRuleById(issue.ruleId, specs);
if (!ruleInfo) {
// console.log(` Issue [${issue.ruleId}] 规则不存在，跳过`);
return false;
}
return true;
});
}
/**
* 去重规范文件中的重复 ruleId
* 后加载的规则覆盖先加载的（符合配置优先级：命令行 > 配置文件 > 默认路径）
* @returns 去重后的 specs 数组
*/
deduplicateSpecs(specs: ReviewSpec[]): ReviewSpec[] {
// 记录 ruleId -> { specIndex, ruleIndex } 的映射，用于检测重复
const ruleIdMap = new Map<string, { specIndex: number; ruleIndex: number }>();
// 记录需要从每个 spec 中移除的 rule 索引
const rulesToRemove = new Map<number, Set<number>>();
for (let specIndex = 0; specIndex < specs.length; specIndex++) {
const spec = specs[specIndex];
for (let ruleIndex = 0; ruleIndex < spec.rules.length; ruleIndex++) {
const rule = spec.rules[ruleIndex];
const existing = ruleIdMap.get(rule.id);
if (existing) {
// 标记先前的规则为待移除（后加载的覆盖先加载的）
if (!rulesToRemove.has(existing.specIndex)) {
rulesToRemove.set(existing.specIndex, new Set());
}
rulesToRemove.get(existing.specIndex)!.add(existing.ruleIndex);
}
// 更新映射为当前规则
ruleIdMap.set(rule.id, { specIndex, ruleIndex });
}
}
// 如果没有重复，直接返回原数组
if (rulesToRemove.size === 0) {
return specs;
}
// 构建去重后的 specs
const result: ReviewSpec[] = [];
for (let specIndex = 0; specIndex < specs.length; specIndex++) {
const spec = specs[specIndex];
const removeSet = rulesToRemove.get(specIndex);
if (!removeSet || removeSet.size === 0) {
result.push(spec);
} else {
const filteredRules = spec.rules.filter((_, ruleIndex) => !removeSet.has(ruleIndex));
if (filteredRules.length > 0) {
result.push({ ...spec, rules: filteredRules });
}
}
}
return result;
}
/**
* 格式化 issues，用规则定义的 severity 覆盖 AI 返回的值
*/
formatIssues<T extends { ruleId: string; severity?: Severity }>(
issues: T[],
{ specs, changedFiles }: { specs: ReviewSpec[]; changedFiles: ChangedFile[] },
): T[] {
// 构建 ruleId -> severity 的映射
const ruleSeverityMap = new Map<string, Severity>();
for (const spec of specs) {
for (const rule of spec.rules) {
// 规则级别的 severity 优先，否则使用文件级别的 severity
const severity = rule.severity ?? spec.severity;
ruleSeverityMap.set(rule.id, severity);
}
}
return issues.map((issue) => {
const ruleSeverity = this.findByRuleId(issue.ruleId, ruleSeverityMap);
if (ruleSeverity && ruleSeverity !== issue.severity) {
return { ...issue, severity: ruleSeverity };
}
return issue;
});
}
}

143
commands/review/src/review-spec/types.ts Normal file
View File

@@ -0,0 +1,143 @@
export type Severity = "off" | "warn" | "error";
/** 文件内容行：[commitHash, lineCode]，commitHash 为 7 位短 hash 或 "-------" 表示非变更行 */
export type FileContentLine = [string, string];
/** 文件内容映射：filename -> 每行的 [commitHash, lineCode] 数组 */
export type FileContentsMap = Map<string, FileContentLine[]>;
export const SEVERITY_EMOJI: Record<Severity, string> = {
off: "⚪",
warn: "🟡",
error: "🔴",
};
export interface ReviewSpec {
filename: string;
extensions: string[];
type: string;
content: string;
rules: ReviewRule[];
overrides: string[]; // 文件级别的 override
severity: Severity; // 文件级别的默认 severity
includes: string[]; // 文件级别的 includes，只有匹配的文件才应用此规范
}
export interface RuleExample {
lang: string;
code: string;
type: "good" | "bad";
}
export interface ReviewRule {
id: string;
title: string;
description: string;
examples: RuleExample[];
overrides: string[]; // 规则级别的 override
severity?: Severity; // 规则级别的 severity，可覆盖文件级别
includes?: string[]; // 规则级别的 includes，可覆盖文件级别
}
/** 问题的 Reaction 记录 */
export interface IssueReaction {
/** reaction 内容，如 +1, -1, laugh, hooray, confused, heart, rocket, eyes */
content: string;
/** 点击该 reaction 的用户列表 */
users: string[];
}
/** 用户信息 */
export interface UserInfo {
/** 用户 ID */
id?: string;
/** 用户登录名 */
login: string;
}
/** 问题评论的回复记录 */
export interface IssueReply {
/** 回复用户 */
user: UserInfo;
/** 回复内容 */
body: string;
/** 回复时间 */
createdAt: string;
}
export interface ReviewIssue {
file: string;
line: string; // 格式 12 或者 12-14
code: string; // 当前行代码, 去除首尾空白
ruleId: string;
specFile: string;
reason: string;
date?: string; // 发现问题的时间
fixed?: string; // 修复时间
valid?: string; // 问题是否有效
suggestion?: string;
commit?: string;
severity: Severity;
round: number; // 发现问题的轮次
/** 问题的作者 */
author?: UserInfo;
/** 问题评论的 reactions 记录 */
reactions?: IssueReaction[];
/** 问题评论的回复/聊天记录 */
replies?: IssueReply[];
/** 原始行号（行号更新前的值） */
originalLine?: string;
}
export interface FileSummary {
file: string;
resolved: number;
unresolved: number;
summary: string;
}
export interface DeletionImpact {
file: string;
deletedCode: string;
riskLevel: "high" | "medium" | "low" | "none";
affectedFiles: string[];
reason: string;
suggestion?: string;
}
export interface DeletionImpactResult {
impacts: DeletionImpact[];
summary: string;
}
/** Review 统计信息 */
export interface ReviewStats {
/** 总问题数 */
total: number;
/** 已修复数 */
fixed: number;
/** 无效问题数 */
invalid: number;
/** 待处理数 */
pending: number;
/** 修复率 (0-100) */
fixRate: number;
}
export interface ReviewResult {
success: boolean;
/**
* AI 生成的 PR 标题
*/
title?: string;
/**
* 通过 commit 和 文件总结一下这个 PR 开发的什么功能
*/
description: string;
issues: ReviewIssue[];
summary: FileSummary[];
deletionImpact?: DeletionImpactResult;
round: number; // 当前 review 的轮次
/** 问题统计信息 */
stats?: ReviewStats;
}

244
commands/review/src/review.command.ts Normal file
View File

@@ -0,0 +1,244 @@
import { Command, CommandRunner, Option, t } from "@spaceflow/core";
import type { LLMMode, VerboseLevel } from "@spaceflow/core";
import type { AnalyzeDeletionsMode } from "./review.config";
import type { ReportFormat } from "./review-report";
import { ReviewService } from "./review.service";
export interface ReviewOptions {
dryRun: boolean;
ci: boolean;
prNumber?: number;
base?: string;
head?: string;
references?: string[];
verbose?: VerboseLevel;
includes?: string[];
llmMode?: LLMMode;
files?: string[];
commits?: string[];
verifyFixes?: boolean;
verifyConcurrency?: number;
analyzeDeletions?: AnalyzeDeletionsMode;
/** 仅执行删除代码分析，跳过常规代码审查 */
deletionOnly?: boolean;
/** 删除代码分析模式：openai 使用标准模式，claude-agent 使用 Agent 模式 */
deletionAnalysisMode?: LLMMode;
/** 输出格式：markdown, terminal, json。不指定则智能选择 */
outputFormat?: ReportFormat;
/** 是否使用 AI 生成 PR 功能描述 */
generateDescription?: boolean;
/** 显示所有问题，不过滤非变更行的问题 */
showAll?: boolean;
/** PR 事件类型（opened, synchronize, closed 等） */
eventAction?: string;
concurrency?: number;
timeout?: number;
retries?: number;
retryDelay?: number;
}
/**
* Review 命令
*
* 在 GitHub Actions 中执行，用于自动代码审查
*
* 环境变量：
* - GITHUB_TOKEN: GitHub API Token
* - GITHUB_REPOSITORY: 仓库名称 (owner/repo 格式)
* - GITHUB_REF_NAME: 当前分支名称
* - GITHUB_EVENT_PATH: 事件文件路径（包含 PR 信息）
*/
@Command({
name: "review",
description: t("review:description"),
})
export class ReviewCommand extends CommandRunner {
constructor(protected readonly reviewService: ReviewService) {
super();
}
async run(_passedParams: string[], options: ReviewOptions): Promise<void> {
try {
const context = await this.reviewService.getContextFromEnv(options);
await this.reviewService.execute(context);
} catch (error) {
if (error instanceof Error) {
console.error(t("common.executionFailed", { error: error.message }));
if (error.stack) {
console.error(t("common.stackTrace", { stack: error.stack }));
}
} else {
console.error(t("common.executionFailed", { error }));
}
process.exit(1);
}
}
@Option({
flags: "-d, --dry-run",
description: t("review:options.dryRun"),
})
parseDryRun(val: boolean): boolean {
return val;
}
@Option({
flags: "-c, --ci",
description: t("common.options.ci"),
})
parseCi(val: boolean): boolean {
return val;
}
@Option({
flags: "-p, --pr-number <number>",
description: t("review:options.prNumber"),
})
parsePrNumber(val: string): number {
return parseInt(val, 10);
}
@Option({
flags: "-b, --base <ref>",
description: t("review:options.base"),
})
parseBase(val: string): string {
return val;
}
@Option({
flags: "--head <ref>",
description: t("review:options.head"),
})
parseHead(val: string): string {
return val;
}
@Option({
flags: "-v, --verbose",
description: t("common.options.verboseDebug"),
})
parseVerbose(_val: string, previous: VerboseLevel = 0): VerboseLevel {
const current = typeof previous === "number" ? previous : previous ? 1 : 0;
return Math.min(current + 1, 3) as VerboseLevel;
}
@Option({
flags: "-i, --includes <patterns...>",
description: t("review:options.includes"),
})
parseIncludes(val: string, previous: string[] = []): string[] {
return [...previous, val];
}
@Option({
flags: "-l, --llm-mode <mode>",
description: t("review:options.llmMode"),
choices: ["claude-code", "openai", "gemini"],
})
parseLlmMode(val: string): LLMMode {
return val as LLMMode;
}
@Option({
flags: "-f, --files <files...>",
description: t("review:options.files"),
})
parseFiles(val: string, previous: string[] = []): string[] {
return [...previous, val];
}
@Option({
flags: "--commits <commits...>",
description: t("review:options.commits"),
})
parseCommits(val: string, previous: string[] = []): string[] {
return [...previous, val];
}
@Option({
flags: "--verify-fixes",
description: t("review:options.verifyFixes"),
})
parseVerifyFixes(val: boolean): boolean {
return val;
}
@Option({
flags: "--no-verify-fixes",
description: t("review:options.noVerifyFixes"),
})
parseNoVerifyFixes(val: boolean): boolean {
return !val;
}
@Option({
flags: "--verify-concurrency <number>",
description: t("review:options.verifyConcurrency"),
})
parseVerifyConcurrency(val: string): number {
return parseInt(val, 10);
}
@Option({
flags: "--analyze-deletions [mode]",
description: t("review:options.analyzeDeletions"),
})
parseAnalyzeDeletions(val: string | boolean): AnalyzeDeletionsMode {
if (val === true || val === "true") return true;
if (val === false || val === "false") return false;
if (val === "ci" || val === "pr" || val === "terminal") return val;
// 默认为 true（当只传 --analyze-deletions 不带值时）
return true;
}
@Option({
flags: "--deletion-analysis-mode <mode>",
description: t("review:options.deletionAnalysisMode"),
choices: ["openai", "claude-code"],
})
parseDeletionAnalysisMode(val: string): LLMMode {
return val as LLMMode;
}
@Option({
flags: "--deletion-only",
description: t("review:options.deletionOnly"),
})
parseDeletionOnly(val: boolean): boolean {
return val;
}
@Option({
flags: "-o, --output-format <format>",
description: t("review:options.outputFormat"),
choices: ["markdown", "terminal", "json"],
})
parseOutputFormat(val: string): ReportFormat {
return val as ReportFormat;
}
@Option({
flags: "--generate-description",
description: t("review:options.generateDescription"),
})
parseGenerateDescription(val: boolean): boolean {
return val;
}
@Option({
flags: "--show-all",
description: t("review:options.showAll"),
})
parseShowAll(val: boolean): boolean {
return val;
}
@Option({
flags: "--event-action <action>",
description: t("review:options.eventAction"),
})
parseEventAction(val: string): string {
return val;
}
}

58
commands/review/src/review.config.ts Normal file
View File

@@ -0,0 +1,58 @@
import { z } from "@spaceflow/core";
/** LLM 模式 schema（与 core 中的 LLMMode 保持一致） */
const llmModeSchema = z.enum(["claude-code", "openai", "gemini", "open-code"]);
/** 删除代码分析模式 schema */
const analyzeDeletionsModeSchema = z.union([z.boolean(), z.enum(["ci", "pr", "terminal"])]);
/** 审查规则严重级别 schema */
const severitySchema = z.enum(["off", "warn", "error"]);
/** 变更文件处理策略 schema */
const invalidateChangedFilesSchema = z.enum(["invalidate", "keep", "off"]);
/** review 命令配置 schema（LLM 敏感配置由系统 llm.config.ts 管理） */
export const reviewSchema = () =>
z.object({
references: z.array(z.string()).optional(),
llmMode: llmModeSchema.default("openai").optional(),
includes: z.array(z.string()).optional(),
rules: z.record(z.string(), severitySchema).optional(),
verifyFixes: z.boolean().default(false),
verifyFixesConcurrency: z.number().default(10).optional(),
analyzeDeletions: analyzeDeletionsModeSchema.default(false),
deletionAnalysisMode: llmModeSchema.default("openai").optional(),
lineComments: z.boolean().default(false),
generateDescription: z.boolean().default(false).optional(),
autoUpdatePrTitle: z.boolean().default(false).optional(),
concurrency: z.number().default(5).optional(),
timeout: z.number().optional(),
retries: z.number().default(0).optional(),
retryDelay: z.number().default(1000).optional(),
invalidateChangedFiles: invalidateChangedFilesSchema.default("invalidate").optional(),
});
/**
* 变更文件处理策略
* - 'invalidate': 将变更文件的历史问题标记为无效（默认）
* - 'keep': 保留历史问题，不做处理
* - 'off': 关闭此功能
*/
export type InvalidateChangedFilesMode = z.infer<typeof invalidateChangedFilesSchema>;
/** review 配置类型（从 schema 推导） */
export type ReviewConfig = z.infer<ReturnType<typeof reviewSchema>>;
/**
* 删除代码分析模式
* - true: 始终启用
* - false: 始终禁用
* - 'ci': 仅在 CI 环境中启用
* - 'pr': 仅在 PR 环境中启用
* - 'terminal': 仅在终端环境中启用
*/
export type AnalyzeDeletionsMode = z.infer<typeof analyzeDeletionsModeSchema>;
/** 审查规则严重级别 */
export type Severity = z.infer<typeof severitySchema>;

184
commands/review/src/review.mcp.ts Normal file
View File

@@ -0,0 +1,184 @@
/**
* Review MCP 服务
* 提供代码审查规则查询的 MCP 工具
*/
import { McpServer, McpTool, ConfigReaderService, t } from "@spaceflow/core";
import { ReviewSpecService } from "./review-spec/review-spec.service";
import { join } from "path";
import { existsSync } from "fs";
import { ListRulesInput, GetRulesForFileInput, GetRuleDetailInput } from "./dto/mcp.dto";
import type { ReviewConfig } from "./review.config";
@McpServer({ name: "review-mcp", version: "1.0.0", description: t("review:mcp.serverDescription") })
export class ReviewMcp {
constructor(
private readonly specService: ReviewSpecService,
private readonly configReader: ConfigReaderService,
) {}
/**
* 获取项目的规则目录
*/
private async getSpecDirs(cwd: string): Promise<string[]> {
const dirs: string[] = [];
// 1. 通过 ConfigReaderService 读取 review 配置
try {
const reviewConfig = this.configReader.getPluginConfig<ReviewConfig>("review");
if (reviewConfig?.references?.length) {
const resolved = await this.specService.resolveSpecSources(reviewConfig.references);
dirs.push(...resolved);
}
} catch {
// 忽略配置读取错误
}
// 2. 检查默认目录
const defaultDirs = [
join(cwd, ".claude", "skills"),
join(cwd, ".cursor", "skills"),
join(cwd, "review-specs"),
];
for (const dir of defaultDirs) {
if (existsSync(dir)) {
dirs.push(dir);
}
}
return [...new Set(dirs)]; // 去重
}
/**
* 加载所有规则
*/
private async loadAllSpecs(cwd: string) {
const specDirs = await this.getSpecDirs(cwd);
const allSpecs = [];
for (const dir of specDirs) {
const specs = await this.specService.loadReviewSpecs(dir);
allSpecs.push(...specs);
}
// 只去重，不应用 override（MCP 工具应返回所有规则，override 在实际审查时应用）
return this.specService.deduplicateSpecs(allSpecs);
}
@McpTool({
name: "list_rules",
description: t("review:mcp.listRules"),
dto: ListRulesInput,
})
async listRules(input: ListRulesInput) {
const workDir = input.cwd || process.cwd();
const specs = await this.loadAllSpecs(workDir);
const rules = specs.flatMap((spec) =>
spec.rules.map((rule) => ({
id: rule.id,
title: rule.title,
description: rule.description.slice(0, 200) + (rule.description.length > 200 ? "..." : ""),
severity: rule.severity || spec.severity,
extensions: spec.extensions,
specFile: spec.filename,
includes: spec.includes,
hasExamples: rule.examples.length > 0,
})),
);
return {
total: rules.length,
rules,
};
}
@McpTool({
name: "get_rules_for_file",
description: t("review:mcp.getRulesForFile"),
dto: GetRulesForFileInput,
})
async getRulesForFile(input: GetRulesForFileInput) {
const workDir = input.cwd || process.cwd();
const allSpecs = await this.loadAllSpecs(workDir);
// 根据文件过滤适用的规则
const applicableSpecs = this.specService.filterApplicableSpecs(allSpecs, [
{ filename: input.filePath },
]);
// 进一步根据 includes 过滤（支持规则级 includes 覆盖文件级）
const micromatchModule = await import("micromatch");
const micromatch = micromatchModule.default || micromatchModule;
const rules = applicableSpecs.flatMap((spec) =>
spec.rules
.filter((rule) => {
// 规则级 includes 优先于文件级
const includes = rule.includes || spec.includes;
if (includes.length === 0) return true;
return micromatch.isMatch(input.filePath, includes, { matchBase: true });
})
.map((rule) => ({
id: rule.id,
title: rule.title,
description: rule.description,
severity: rule.severity || spec.severity,
specFile: spec.filename,
...(input.includeExamples && rule.examples.length > 0
? {
examples: rule.examples.map((ex) => ({
type: ex.type,
lang: ex.lang,
code: ex.code,
})),
}
: {}),
})),
);
return {
file: input.filePath,
total: rules.length,
rules,
};
}
@McpTool({
name: "get_rule_detail",
description: t("review:mcp.getRuleDetail"),
dto: GetRuleDetailInput,
})
async getRuleDetail(input: GetRuleDetailInput) {
const workDir = input.cwd || process.cwd();
const specs = await this.loadAllSpecs(workDir);
const result = this.specService.findRuleById(input.ruleId, specs);
if (!result) {
return { error: t("review:mcp.ruleNotFound", { ruleId: input.ruleId }) };
}
const { rule, spec } = result;
return {
id: rule.id,
title: rule.title,
description: rule.description,
severity: rule.severity || spec.severity,
specFile: spec.filename,
extensions: spec.extensions,
includes: spec.includes,
overrides: rule.overrides,
examples: rule.examples.map((ex) => ({
type: ex.type,
lang: ex.lang,
code: ex.code,
})),
};
}
}
// ReviewMcpService 类已通过 @McpServer 装饰器标记
// CLI 的 `spaceflow mcp` 命令会自动扫描并发现该类

52
commands/review/src/review.module.ts Normal file
View File

@@ -0,0 +1,52 @@
import {
Module,
ConfigModule,
ConfigService,
ConfigReaderModule,
ConfigReaderService,
GitProviderModule,
ciConfig,
llmConfig,
ClaudeSetupModule,
LlmProxyModule,
GitSdkModule,
type LlmConfig,
} from "@spaceflow/core";
import { ReviewSpecModule } from "./review-spec";
import { ReviewReportModule } from "./review-report";
import { ReviewCommand } from "./review.command";
import { ReviewService } from "./review.service";
import { IssueVerifyService } from "./issue-verify.service";
import { DeletionImpactService } from "./deletion-impact.service";
import { ReviewMcp } from "./review.mcp";
import type { ReviewConfig } from "./review.config";
@Module({
imports: [
ConfigModule.forFeature(ciConfig),
ConfigModule.forFeature(llmConfig),
ConfigReaderModule,
GitProviderModule.forFeature(),
ClaudeSetupModule,
ReviewSpecModule,
ReviewReportModule,
GitSdkModule,
LlmProxyModule.forRootAsync({
imports: [ConfigReaderModule, ConfigModule],
useFactory: (configReader: ConfigReaderService, configService: ConfigService) => {
const reviewConf = configReader.getPluginConfig<ReviewConfig>("review");
const llm = configService.get<LlmConfig>("llm")!;
return {
defaultAdapter: reviewConf?.llmMode || "openai",
claudeCode: llm.claudeCode,
openai: llm.openai,
openCode: llm.openCode,
};
},
inject: [ConfigReaderService, ConfigService],
}),
],
providers: [ReviewCommand, ReviewService, IssueVerifyService, DeletionImpactService, ReviewMcp],
exports: [ReviewMcp],
})
export class ReviewModule {}

3007
commands/review/src/review.service.spec.ts Normal file
View File

File diff suppressed because it is too large Load Diff

2603
commands/review/src/review.service.ts Normal file
View File

File diff suppressed because it is too large Load Diff

8
commands/review/tsconfig.json Normal file
View File

@@ -0,0 +1,8 @@
{
"extends": "../../core/tsconfig.skill.json",
"compilerOptions": {
"types": ["vitest/globals"]
},
"include": ["src/**/*"],
"exclude": ["node_modules", "dist"]
}

34
commands/review/vitest.config.ts Normal file
View File

@@ -0,0 +1,34 @@
import swc from "unplugin-swc";
import { defineConfig } from "vitest/config";
export default defineConfig({
plugins: [swc.vite()],
test: {
root: "src",
globals: true,
environment: "node",
include: ["**/*.spec.ts"],
coverage: {
provider: "v8",
include: ["**/*.ts"],
exclude: [
"**/*.spec.ts",
"**/*.module.ts",
"**/index.ts",
"**/__mocks__/**",
"**/*.command.ts",
"**/locales/**",
"**/dto/**",
"**/review-report/**",
"**/review.mcp.ts",
"**/review.config.ts",
],
thresholds: {
lines: 80,
functions: 80,
branches: 80,
statements: 80,
},
},
},
});