gitlab-ai-review 4.0.1 → 4.1.0

package/README.md

@@ -20,6 +20,10 @@ GitLab AI Review SDK - 支持 CI/CD 自动配置和手动配置
   - 自动跳过 Markdown 文件 (`.md`)
   - 自动跳过配置文件 (`.json`, `.yml`, `.yaml`)
   - 自动跳过依赖锁文件 (`package-lock.json`, `yarn.lock` 等)
+- ✅ **AI 自动生成审核规则** 🚀 NEW!
+  - 自动分析项目技术栈和代码结构
+  - 智能生成适合项目的审核提示词
+  - 无需手动编写 `reviewguard.md` 文件
 
 ## 安装
 
@@ -52,6 +56,8 @@ await sdk.addComment('✅ AI 代码审查完成！');
 - `CI_SERVER_URL` 或 `GITLAB_URL` - GitLab 地址
 - `CI_PROJECT_PATH` 或 `PROJECT_ID` - 项目 ID
 - `CI_MERGE_REQUEST_IID` 或 `MERGE_REQUEST_IID` - MR 编号
+- `ARK_API_KEY` - AI API 密钥（用于代码审查）
+- `AUTO_SAVE_REVIEWGUARD` - 是否自动保存生成的 reviewguard.md（默认 true）
 
 ### 方式 2：手动传递配置
 
@@ -185,6 +191,83 @@ const results = await sdk.reviewAndCommentOnLines({
 });
 ```
 
+## 配置审核规则
+
+### 方式 1：手动创建 reviewguard.md（推荐自定义）
+
+在项目根目录创建 `reviewguard.md` 文件，定义审核规则：
+
+```markdown
+# AI 代码审查规则
+
+## 破坏性变更检查（严重程度 8-10 分）
+- 删除/重命名导出的函数、组件、类型
+- API 签名变更
+- 必须检查是否有其他文件引用
+
+## 安全漏洞（严重程度 7-10 分）
+- XSS、SQL 注入等
+- 敏感信息硬编码
+- 用户输入未校验
+
+## 性能问题（严重程度 5-8 分）
+- 不必要的重渲染
+- 内存泄漏
+- 大列表未优化
+
+...
+```
+
+### 方式 2：AI 自动生成（全新功能！）🚀
+
+如果项目中**没有** `reviewguard.md` 文件，SDK 会自动：
+1. 分析项目的技术栈（检测 `package.json`、`tsconfig.json` 等）
+2. 收集关键文件信息
+3. 调用 AI 生成适合该项目的审核规则
+4. 自动保存到项目根目录
+
+**完全零配置，开箱即用！**
+
+```javascript
+import GitLabAIReview from 'gitlab-ai-review';
+
+const sdk = new GitLabAIReview({
+  arkApiKey: 'your-api-key', // AI API 密钥
+  // ... 其他配置
+});
+
+// 第一次调用审查时，会自动生成 reviewguard.md
+const results = await sdk.reviewWithImpactAnalysis();
+
+// 生成的 reviewguard.md 会保存在项目根目录，后续可以手动调整
+```
+
+**自动生成的审核规则包含：**
+- 项目概述和技术栈分析
+- 针对性的开发原则（如 React Hooks、TypeScript 类型安全等）
+- 完整的 AI 代码审查规则（破坏性变更、安全、性能、类型安全等）
+- 统一的回复格式规范
+- 严重程度评分标准（0-10 分）
+- 实际示例演示
+
+**环境变量控制：**
+```bash
+# 默认会自动保存生成的 reviewguard.md
+# 如果不想保存，设置以下环境变量：
+AUTO_SAVE_REVIEWGUARD=false
+```
+
+### 支持的配置文件
+
+SDK 会按优先级查找以下文件：
+1. `.aireviewguard`
+2. `aireviewguard`
+3. `.aireviewguard.json`
+4. `reviewguard.md` ⭐ 推荐
+5. `.reviewguard.md`
+
+如果都不存在，则自动触发 AI 生成。
+
 ## 在 GitLab CI/CD 中使用
 
 `.gitlab-ci.yml` 示例：
@@ -222,7 +305,90 @@ console.log(`共有 ${changes.length} 个文件变更`);
 await sdk.addComment('🤖 AI 代码审查已完成！');
 ```
 
+## CLI 命令行工具
+
+你也可以直接使用 `npx` 运行审查：
+
+```bash
+# 基本用法（自动从环境变量读取配置）
+npx gitlab-ai-review
+
+# 禁用影响分析
+npx gitlab-ai-review --no-impact
+
+# 限制审查文件数量
+npx gitlab-ai-review --max-files 5
+
+# 限制受影响文件分析数量
+npx gitlab-ai-review --max-affected-files 10
+
+# 查看帮助
+npx gitlab-ai-review --help
+```
+
+**在 CI/CD 中使用 CLI：**
+
+```yaml
+ai-review:
+  stage: review
+  image: node:18
+  only:
+    - merge_requests
+  variables:
+    ARK_API_KEY: $ARK_API_KEY  # 从 GitLab Variables 中读取
+  script:
+    - npx gitlab-ai-review
+```
+
+## 项目结构分析器
+
+新增的项目分析器可以自动检测：
+
+### 支持的技术栈
+
+**编程语言：**
+- JavaScript / TypeScript
+- Python (Django, Flask, FastAPI)
+- Go
+- Rust
+- Java / Kotlin
+- PHP (Laravel, Symfony)
+- Ruby (Ruby on Rails)
+
+**前端框架：**
+- React (检测 Radix UI、Headless UI、@tanstack/react-table 等)
+- Vue.js / Nuxt.js
+- Next.js
+- Svelte
+- Angular
+
+**构建工具：**
+- Vite
+- Webpack
+- Rollup
+- esbuild
+
+**样式方案：**
+- Tailwind CSS
+- Styled Components
+- Emotion
+
+### 示例：查看项目分析结果
+
+```javascript
+import { analyzeProject } from 'gitlab-ai-review/lib/project-analyzer.js';
+
+const analysis = analyzeProject(process.cwd());
+
+console.log('语言:', analysis.techStack.languages);
+console.log('框架:', analysis.techStack.frameworks);
+console.log('工具:', analysis.techStack.tools);
+console.log('关键文件:', analysis.keyFiles.length, '个');
+```
+
 ## 版本
 
+- 4.0.3 - 🚀 新增 AI 自动生成审核规则功能，支持项目结构分析
+- 4.0.2 - 添加影响分析和智能文件过滤
 - 1.0.1 - 添加 GitLab 客户端封装和自动配置
 - 1.0.0 - 初始测试版本

package/index.js

@@ -3,7 +3,7 @@
  * 支持 CI/CD 自动配置和手动配置
  */
 
-import { getConfig, validateConfig } from './lib/config.js';
+import { getConfig, validateConfig, loadGuardConfig } from './lib/config.js';
 import { GitLabClient } from './lib/gitlab-client.js';
 import { AIClient } from './lib/ai-client.js';
 import * as PromptTools from './lib/prompt-tools.js';
@@ -16,7 +16,7 @@ import * as ImpactAnalyzer from './lib/impact-analyzer.js';
 export class GitLabAIReview {
   constructor(options = {}) {
     this.name = 'GitLab AI Review SDK';
-    this.version = '2.3.0';
+    this.version = '4.1.0';
 
     // 如果传入了配置，使用手动配置；否则使用自动检测
     if (options.token || options.gitlab) {
@@ -62,6 +62,27 @@ export class GitLabAIReview {
     return validateConfig(this.config);
   }
 
+  /**
+   * 初始化并加载 Guard 配置（支持 AI 自动生成）
+   * 如果项目中没有 reviewguard.md，会自动分析项目并生成
+   */
+  async initGuardConfig() {
+    if (this.config.ai?.guardConfig) {
+      return this.config.ai.guardConfig;
+    }
+
+    const guardConfig = await loadGuardConfig(this.aiClient);
+    
+    if (guardConfig) {
+      this.config.ai.guardConfig = guardConfig;
+      console.log(`✅ Guard 配置已加载: ${guardConfig.filename}${guardConfig.generated ? ' (AI自动生成)' : ''}`);
+    } else {
+      console.log('⚠️  未找到 Guard 配置，将使用默认审查规则');
+    }
+
+    return guardConfig;
+  }
+
   /**
    * 获取当前配置
    */
@@ -177,6 +198,9 @@ export class GitLabAIReview {
    * @returns {Promise<Array>} 评论结果数组
    */
   async reviewAndCommentOnLines(options = {}) {
+    // 确保 Guard 配置已加载
+    await this.initGuardConfig();
+    
     const { maxFiles = Infinity } = options;
     const allChanges = await this.getMergeRequestChanges();
     const changes = this.filterReviewableFiles(allChanges);
@@ -212,33 +236,19 @@ export class GitLabAIReview {
         for (const review of mergedReviews) {
           if (review.hasIssue) {
             try {
-              // 找到对应的变更
-              const relatedChange = meaningfulChanges.find(c => 
-                c.lineNumber === review.lineNumber || 
-                c.lineNumber === review.oldLine ||
-                c.lineNumber === review.newLine
-              );
-              
               // 构建评论位置参数
               const positionParams = {
                 filePath: fileName,
                 oldPath: change.old_path,
               };
               
-              // 优先使用 hunk 的起始行（让评论定位到 diff 块的开头）
-              if (relatedChange && relatedChange.hunkRange) {
-                const isDeletion = relatedChange.type === 'deletion';
-                if (isDeletion) {
-                  positionParams.oldLine = relatedChange.hunkRange.oldStart;
-                } else {
-                  positionParams.newLine = relatedChange.hunkRange.newStart;
-                }
-              } else if (review.oldLine && review.newLine) {
-                // 修改块：同时指定两个行号
+              // 如果是修改块（同时有 oldLine 和 newLine），同时指定两个行号
+              if (review.oldLine && review.newLine) {
                 positionParams.oldLine = review.oldLine;
                 positionParams.newLine = review.newLine;
               } else if (review.lineNumber) {
-                // 单独的删除或新增（fallback）
+                // 单独的删除或新增
+                const relatedChange = meaningfulChanges.find(c => c.lineNumber === review.lineNumber);
                 const isDeletion = relatedChange && relatedChange.type === 'deletion';
                 if (isDeletion) {
                   positionParams.oldLine = review.lineNumber;
@@ -439,6 +449,9 @@ export class GitLabAIReview {
    * @returns {Promise<Array>} 评论结果数组
    */
   async reviewWithImpactAnalysis(options = {}) {
+    // 确保 Guard 配置已加载
+    await this.initGuardConfig();
+    
     const { 
       maxFiles = Infinity, 
       maxAffectedFiles = 10,
@@ -498,33 +511,19 @@ export class GitLabAIReview {
         for (const review of mergedReviews) {
           if (review.hasIssue) {
             try {
-              // 找到对应的变更
-              const relatedChange = meaningfulChanges.find(c => 
-                c.lineNumber === review.lineNumber || 
-                c.lineNumber === review.oldLine ||
-                c.lineNumber === review.newLine
-              );
-              
               // 构建评论位置参数
               const positionParams = {
                 filePath: fileName,
                 oldPath: change.old_path,
               };
               
-              // 优先使用 hunk 的起始行（让评论定位到 diff 块的开头）
-              if (relatedChange && relatedChange.hunkRange) {
-                const isDeletion = relatedChange.type === 'deletion';
-                if (isDeletion) {
-                  positionParams.oldLine = relatedChange.hunkRange.oldStart;
-                } else {
-                  positionParams.newLine = relatedChange.hunkRange.newStart;
-                }
-              } else if (review.oldLine && review.newLine) {
-                // 修改块：同时指定两个行号
+              // 如果是修改块（同时有 oldLine 和 newLine），同时指定两个行号
+              if (review.oldLine && review.newLine) {
                 positionParams.oldLine = review.oldLine;
                 positionParams.newLine = review.newLine;
               } else if (review.lineNumber) {
-                // 单独的删除或新增（fallback）
+                // 单独的删除或新增
+                const relatedChange = meaningfulChanges.find(c => c.lineNumber === review.lineNumber);
                 const isDeletion = relatedChange && relatedChange.type === 'deletion';
                 if (isDeletion) {
                   positionParams.oldLine = review.lineNumber;
@@ -671,7 +670,7 @@ export class GitLabAIReview {
 }
 
 // 导出工具函数和类
-export { getConfig, validateConfig } from './lib/config.js';
+export { getConfig, validateConfig, loadGuardConfig } from './lib/config.js';
 export { GitLabClient } from './lib/gitlab-client.js';
 export { AIClient } from './lib/ai-client.js';
 export { PromptTools, DiffParser, ImpactAnalyzer };

package/lib/config.js

@@ -5,11 +5,60 @@
 
 import fs from 'fs';
 import path from 'path';
+import { analyzeProject } from './project-analyzer.js';
+import { buildGenerateGuardPromptMessages } from './prompt-tools.js';
+
+/**
+ * 使用 AI 生成审核提示词
+ * @param {Object} aiClient - AI 客户端
+ * @returns {Promise<Object>} 生成的配置
+ */
+export async function generateAIReviewGuardConfig(aiClient) {
+  console.log('\n🤖 未找到 reviewguard.md 文件，正在分析项目并生成审核提示词...\n');
+  
+  try {
+    // 分析项目结构
+    const projectAnalysis = analyzeProject(process.cwd());
+    
+    // 构建生成提示词的消息
+    const messages = buildGenerateGuardPromptMessages(projectAnalysis);
+    
+    console.log('🔄 正在请求 AI 生成审核规则文档...\n');
+    
+    // 调用 AI 生成
+    const response = await aiClient.sendMessage(messages);
+    
+    const generatedContent = response.content;
+    
+    console.log('✅ AI 已生成审核规则文档\n');
+    
+    // 可选：保存到项目根目录
+    const saveToFile = process.env.AUTO_SAVE_REVIEWGUARD !== 'false'; // 默认保存
+    if (saveToFile) {
+      const savePath = path.join(process.cwd(), 'reviewguard.md');
+      fs.writeFileSync(savePath, generatedContent, 'utf-8');
+      console.log(`📝 已保存到: ${savePath}\n`);
+    }
+    
+    return {
+      type: 'markdown',
+      filename: 'reviewguard.md (AI生成)',
+      content: generatedContent,
+      generated: true,
+    };
+  } catch (error) {
+    console.error('❌ 生成审核提示词失败:', error.message);
+    console.log('⚠️  将使用默认审核规则\n');
+    return null;
+  }
+}
 
 /**
  * 读取项目根目录下的 AI Review Guard 配置文件
+ * @param {Object} aiClient - AI 客户端（可选，用于生成配置）
+ * @returns {Promise<Object>} 配置对象
  */
-function readAIReviewGuardConfig() {
+async function readAIReviewGuardConfig(aiClient = null) {
   const configFiles = ['.aireviewguard', 'aireviewguard', '.aireviewguard.json', 'reviewguard.md', '.reviewguard.md'];
   
   for (const filename of configFiles) {
@@ -47,6 +96,11 @@ function readAIReviewGuardConfig() {
     }
   }
   
+  // 如果没有找到配置文件，且提供了 AI 客户端，则自动生成
+  if (aiClient) {
+    return await generateAIReviewGuardConfig(aiClient);
+  }
+  
   return null;
 }
 
@@ -75,20 +129,27 @@ export function getGitLabConfig() {
 
 /**
  * 获取 AI 配置（ARK API Key）
+ * 注意：这里不再自动读取 guardConfig，因为需要 AI 客户端才能生成
  */
 export function getAIConfig() {
   // 从环境变量读取 ARK_API_KEY
   const arkApiKey = process.env.ARK_API_KEY || '';
   
-  // 从配置文件读取其他配置
-  const guardConfig = readAIReviewGuardConfig();
-  
   return {
     arkApiKey,
-    guardConfig,
+    guardConfig: null, // 延迟加载，在需要时通过 loadGuardConfig 加载
   };
 }
 
+/**
+ * 加载 Guard 配置（支持 AI 生成）
+ * @param {Object} aiClient - AI 客户端
+ * @returns {Promise<Object>} Guard 配置
+ */
+export async function loadGuardConfig(aiClient = null) {
+  return await readAIReviewGuardConfig(aiClient);
+}
+
 /**
  * 获取项目配置（支持自动检测 CI 环境）
  */

package/lib/project-analyzer.js

@@ -0,0 +1,349 @@
+/**
+ * 项目分析器 - 用于分析项目结构和技术栈
+ * 当找不到 reviewguard.md 文件时使用
+ */
+
+import fs from 'fs';
+import path from 'path';
+
+/**
+ * 递归遍历目录，收集文件信息
+ * @param {string} dir - 目录路径
+ * @param {number} maxDepth - 最大深度
+ * @param {number} currentDepth - 当前深度
+ * @returns {Array} 文件列表
+ */
+function walkDirectory(dir, maxDepth = 3, currentDepth = 0) {
+  if (currentDepth >= maxDepth) return [];
+  
+  const files = [];
+  const ignorePatterns = [
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    'coverage',
+    '.next',
+    '.nuxt',
+    'out',
+    'public',
+    'vendor',
+    '__pycache__',
+    '.pytest_cache',
+    '.venv',
+    'venv',
+  ];
+
+  try {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    
+    for (const entry of entries) {
+      // 跳过隐藏文件和忽略的目录
+      if (entry.name.startsWith('.') || ignorePatterns.includes(entry.name)) {
+        continue;
+      }
+
+      const fullPath = path.join(dir, entry.name);
+      
+      if (entry.isDirectory()) {
+        files.push(...walkDirectory(fullPath, maxDepth, currentDepth + 1));
+      } else if (entry.isFile()) {
+        files.push(fullPath);
+      }
+    }
+  } catch (error) {
+    // 忽略权限错误
+  }
+
+  return files;
+}
+
+/**
+ * 检测项目技术栈
+ * @param {string} projectRoot - 项目根目录
+ * @returns {Object} 技术栈信息
+ */
+export function detectTechStack(projectRoot) {
+  const techStack = {
+    languages: new Set(),
+    frameworks: new Set(),
+    tools: new Set(),
+    packageManager: null,
+  };
+
+  // 检查配置文件
+  const configFiles = {
+    'package.json': () => {
+      try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(projectRoot, 'package.json'), 'utf-8'));
+        
+        // 检测包管理器
+        if (fs.existsSync(path.join(projectRoot, 'pnpm-lock.yaml'))) {
+          techStack.packageManager = 'pnpm';
+        } else if (fs.existsSync(path.join(projectRoot, 'yarn.lock'))) {
+          techStack.packageManager = 'yarn';
+        } else if (fs.existsSync(path.join(projectRoot, 'package-lock.json'))) {
+          techStack.packageManager = 'npm';
+        }
+
+        // 检测框架和库
+        const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+        
+        // 前端框架
+        if (deps.react) techStack.frameworks.add('React');
+        if (deps.vue) techStack.frameworks.add('Vue');
+        if (deps.next) techStack.frameworks.add('Next.js');
+        if (deps.nuxt) techStack.frameworks.add('Nuxt.js');
+        if (deps.svelte) techStack.frameworks.add('Svelte');
+        if (deps.angular || deps['@angular/core']) techStack.frameworks.add('Angular');
+        
+        // UI 库
+        if (deps['@radix-ui/react-dialog'] || deps['@radix-ui/react-dropdown-menu']) {
+          techStack.frameworks.add('Radix UI');
+        }
+        if (deps['@headlessui/react']) techStack.frameworks.add('Headless UI');
+        
+        // 构建工具
+        if (deps.vite) techStack.tools.add('Vite');
+        if (deps.webpack) techStack.tools.add('Webpack');
+        if (deps.rollup) techStack.tools.add('Rollup');
+        if (deps.esbuild) techStack.tools.add('esbuild');
+        
+        // 样式方案
+        if (deps.tailwindcss) techStack.tools.add('Tailwind CSS');
+        if (deps['styled-components']) techStack.tools.add('Styled Components');
+        if (deps['@emotion/react']) techStack.tools.add('Emotion');
+        
+        // TypeScript
+        if (deps.typescript || fs.existsSync(path.join(projectRoot, 'tsconfig.json'))) {
+          techStack.languages.add('TypeScript');
+        } else {
+          techStack.languages.add('JavaScript');
+        }
+        
+        // 表格库
+        if (deps['@tanstack/react-table']) techStack.frameworks.add('@tanstack/react-table');
+        
+        // Linter
+        if (deps.eslint) techStack.tools.add('ESLint');
+        if (deps.prettier) techStack.tools.add('Prettier');
+      } catch (error) {
+        // 忽略解析错误
+      }
+    },
+    'requirements.txt': () => {
+      techStack.languages.add('Python');
+      techStack.packageManager = 'pip';
+      try {
+        const content = fs.readFileSync(path.join(projectRoot, 'requirements.txt'), 'utf-8');
+        if (content.includes('django')) techStack.frameworks.add('Django');
+        if (content.includes('flask')) techStack.frameworks.add('Flask');
+        if (content.includes('fastapi')) techStack.frameworks.add('FastAPI');
+      } catch (error) {
+        // 忽略读取错误
+      }
+    },
+    'Pipfile': () => {
+      techStack.languages.add('Python');
+      techStack.packageManager = 'pipenv';
+    },
+    'pyproject.toml': () => {
+      techStack.languages.add('Python');
+      techStack.packageManager = 'poetry';
+    },
+    'Gemfile': () => {
+      techStack.languages.add('Ruby');
+      techStack.packageManager = 'bundler';
+      techStack.frameworks.add('Ruby on Rails');
+    },
+    'go.mod': () => {
+      techStack.languages.add('Go');
+      techStack.packageManager = 'go modules';
+    },
+    'Cargo.toml': () => {
+      techStack.languages.add('Rust');
+      techStack.packageManager = 'Cargo';
+    },
+    'composer.json': () => {
+      techStack.languages.add('PHP');
+      techStack.packageManager = 'Composer';
+      try {
+        const composer = JSON.parse(fs.readFileSync(path.join(projectRoot, 'composer.json'), 'utf-8'));
+        const deps = { ...composer.require, ...composer['require-dev'] };
+        if (deps.laravel) techStack.frameworks.add('Laravel');
+        if (deps.symfony) techStack.frameworks.add('Symfony');
+      } catch (error) {
+        // 忽略解析错误
+      }
+    },
+    'pom.xml': () => {
+      techStack.languages.add('Java');
+      techStack.packageManager = 'Maven';
+      techStack.frameworks.add('Spring Boot');
+    },
+    'build.gradle': () => {
+      techStack.languages.add('Java/Kotlin');
+      techStack.packageManager = 'Gradle';
+    },
+  };
+
+  // 检查配置文件
+  for (const [filename, detector] of Object.entries(configFiles)) {
+    if (fs.existsSync(path.join(projectRoot, filename))) {
+      detector();
+    }
+  }
+
+  return {
+    languages: Array.from(techStack.languages),
+    frameworks: Array.from(techStack.frameworks),
+    tools: Array.from(techStack.tools),
+    packageManager: techStack.packageManager,
+  };
+}
+
+/**
+ * 收集项目的关键文件信息
+ * @param {string} projectRoot - 项目根目录
+ * @param {number} maxFiles - 最大文件数量
+ * @returns {Array} 文件信息列表
+ */
+export function collectKeyFiles(projectRoot, maxFiles = 20) {
+  const files = walkDirectory(projectRoot, 3);
+  
+  // 文件扩展名优先级（越重要的排在前面）
+  const extensionPriority = {
+    '.ts': 10,
+    '.tsx': 10,
+    '.js': 9,
+    '.jsx': 9,
+    '.vue': 9,
+    '.py': 9,
+    '.go': 9,
+    '.rs': 9,
+    '.java': 9,
+    '.php': 9,
+    '.rb': 9,
+    '.cs': 9,
+    '.swift': 9,
+    '.kt': 9,
+    '.md': 5,
+    '.json': 3,
+    '.yaml': 3,
+    '.yml': 3,
+    '.toml': 3,
+  };
+
+  // 文件名优先级
+  const filenamePriority = {
+    'package.json': 100,
+    'tsconfig.json': 90,
+    'vite.config': 80,
+    'webpack.config': 80,
+    'tailwind.config': 80,
+    'README': 70,
+    'index': 60,
+    'main': 60,
+    'app': 60,
+  };
+
+  // 计算文件优先级
+  const fileInfos = files.map(filePath => {
+    const ext = path.extname(filePath);
+    const basename = path.basename(filePath, ext);
+    const relativePath = path.relative(projectRoot, filePath);
+    
+    let priority = extensionPriority[ext] || 1;
+    
+    // 根据文件名增加优先级
+    for (const [key, value] of Object.entries(filenamePriority)) {
+      if (basename.includes(key)) {
+        priority += value;
+      }
+    }
+    
+    // 项目根目录的文件优先级更高
+    const depth = relativePath.split(path.sep).length - 1;
+    priority -= depth * 5;
+
+    return {
+      path: relativePath,
+      fullPath: filePath,
+      priority,
+    };
+  });
+
+  // 排序并选择最重要的文件
+  fileInfos.sort((a, b) => b.priority - a.priority);
+  
+  return fileInfos.slice(0, maxFiles).map(info => ({
+    path: info.path,
+    size: fs.statSync(info.fullPath).size,
+  }));
+}
+
+/**
+ * 读取关键文件的内容片段
+ * @param {string} projectRoot - 项目根目录
+ * @param {Array} keyFiles - 关键文件列表
+ * @param {number} maxLines - 每个文件最大读取行数
+ * @returns {Array} 文件内容片段
+ */
+export function readFileSnippets(projectRoot, keyFiles, maxLines = 50) {
+  const snippets = [];
+  
+  for (const fileInfo of keyFiles.slice(0, 10)) { // 只读取前10个文件
+    try {
+      const fullPath = path.join(projectRoot, fileInfo.path);
+      const content = fs.readFileSync(fullPath, 'utf-8');
+      const lines = content.split('\n');
+      
+      // 如果文件太长，只取前面的部分
+      const snippet = lines.slice(0, maxLines).join('\n');
+      
+      snippets.push({
+        path: fileInfo.path,
+        lines: Math.min(lines.length, maxLines),
+        totalLines: lines.length,
+        content: snippet,
+      });
+    } catch (error) {
+      // 忽略读取错误（可能是二进制文件）
+    }
+  }
+  
+  return snippets;
+}
+
+/**
+ * 分析项目结构
+ * @param {string} projectRoot - 项目根目录
+ * @returns {Object} 项目分析结果
+ */
+export function analyzeProject(projectRoot = process.cwd()) {
+  console.log('📊 正在分析项目结构...');
+  
+  const techStack = detectTechStack(projectRoot);
+  const keyFiles = collectKeyFiles(projectRoot);
+  const snippets = readFileSnippets(projectRoot, keyFiles);
+  
+  console.log('✅ 项目分析完成');
+  console.log(`  - 语言: ${techStack.languages.join(', ') || '未知'}`);
+  console.log(`  - 框架: ${techStack.frameworks.join(', ') || '未知'}`);
+  console.log(`  - 工具: ${techStack.tools.join(', ') || '未知'}`);
+  console.log(`  - 关键文件: ${keyFiles.length} 个`);
+  
+  return {
+    techStack,
+    keyFiles,
+    snippets,
+  };
+}
+
+export default {
+  detectTechStack,
+  collectKeyFiles,
+  readFileSnippets,
+  analyzeProject,
+};
+

package/lib/prompt-tools.js

@@ -379,6 +379,147 @@ export function buildFileReviewWithImpactMessages(fileName, meaningfulChanges, i
   ];
 }
 
+/**
+ * 构建生成审核提示词的消息（当找不到 reviewguard.md 时使用）
+ * @param {Object} projectAnalysis - 项目分析结果
+ * @returns {Array} 消息数组
+ */
+export function buildGenerateGuardPromptMessages(projectAnalysis) {
+  const { techStack, keyFiles, snippets } = projectAnalysis;
+  
+  let userMessage = `我需要你根据这个项目的技术栈和代码结构，生成一份适合该项目的 AI 代码审查规则文档（reviewguard.md）。
+
+## 项目技术栈
+
+**编程语言**: ${techStack.languages.join(', ') || '未知'}
+**框架/库**: ${techStack.frameworks.join(', ') || '无'}
+**构建工具**: ${techStack.tools.join(', ') || '无'}
+**包管理器**: ${techStack.packageManager || '未知'}
+
+## 项目关键文件
+
+共发现 ${keyFiles.length} 个关键文件：
+
+${keyFiles.slice(0, 15).map((file, i) => `${i + 1}. ${file.path} (${(file.size / 1024).toFixed(1)} KB)`).join('\n')}
+
+## 代码片段示例
+
+${snippets.map((snippet, i) => `
+### 文件 ${i + 1}: ${snippet.path} (共 ${snippet.totalLines} 行，显示前 ${snippet.lines} 行)
+
+\`\`\`
+${snippet.content}
+\`\`\`
+`).join('\n')}
+
+---
+
+## 要求
+
+请根据以上项目信息，生成一份完整的 **reviewguard.md** 文档内容。文档应包含：
+
+### 1. 项目概述
+- 简要描述项目的技术栈和架构
+- 列出主要使用的框架和工具
+
+### 2. 开发原则
+- 根据项目技术栈，列出该项目应遵循的开发原则
+- 例如：React 项目应包含组件设计原则、Hooks 使用规范等
+- 例如：使用 TypeScript 的项目应强调类型安全
+
+### 3. AI 代码审查规则
+必须包含以下审查类别（按严重程度分类）：
+
+#### 破坏性变更检查（严重程度 8-10 分）
+- 删除/重命名导出的函数、组件、类型
+- API 签名变更
+- 必须检查是否有其他文件引用
+
+#### 安全漏洞（严重程度 7-10 分）
+- XSS、SQL 注入等
+- 敏感信息硬编码
+- 用户输入未校验
+
+#### 性能问题（严重程度 5-8 分）
+- 不必要的重渲染（React）
+- 内存泄漏
+- 大列表未优化
+
+#### 类型安全（严重程度 4-7 分，TypeScript 项目必须包含）
+- 滥用 any 类型
+- 缺少类型定义
+- 不安全的类型断言
+
+#### 代码规范（严重程度 1-4 分）
+- 命名不规范
+- 注释缺失
+- 函数过长
+
+### 4. 回复格式规范（非常重要！）
+
+必须包含统一的回复格式，要求 AI 按照以下结构返回审查意见：
+
+\`\`\`
+【严重程度评分：X/10】
+
+📋 问题描述：
+[一句话概括问题]
+
+🔍 影响分析：
+• 当前文件：[具体影响]
+• 受影响的其他文件：[文件名和行号]
+• 可能后果：[具体说明]
+
+💡 改进建议：
+1. [具体操作步骤]
+2. [注意事项]
+\`\`\`
+
+### 5. 严重程度评分标准
+
+定义 0-10 分的评分标准：
+- 1-3 分：低风险（代码风格、命名规范）
+- 4-6 分：中等风险（违反最佳实践、性能问题）
+- 7-8 分：高风险（不兼容的变更、安全漏洞）
+- 9-10 分：严重风险（破坏性变更、系统崩溃）
+
+### 6. 示例（必须包含 3-5 个实际示例）
+
+提供具体的审查示例，展示不同严重程度的问题和回复格式
+
+---
+
+**输出要求：**
+1. 直接输出 reviewguard.md 的完整 Markdown 内容
+2. 内容必须用**中文**编写
+3. 必须针对该项目的技术栈定制审查规则
+4. 必须包含清晰的回复格式规范和评分标准
+5. 必须包含 3-5 个实际示例
+6. 内容要详细、实用、可操作
+
+请开始生成 reviewguard.md 的内容：`;
+
+  return [
+    {
+      role: 'system',
+      content: `你是一个专业的代码审查规范设计专家。你的任务是根据项目的技术栈和代码结构，生成一份详细的 AI 代码审查规则文档（reviewguard.md）。
+
+这份文档将用于指导 AI 进行代码审查，必须：
+1. 针对具体技术栈定制（不要泛泛而谈）
+2. 包含清晰的严重程度评分标准（0-10分）
+3. 定义统一的回复格式（必须包含 emoji、评分、问题描述、影响分析、改进建议）
+4. 提供实际的审查示例
+5. 全部使用中文
+
+生成的文档应该像一份专业的代码审查规范手册，让 AI 能够准确理解如何审查这个项目的代码。`
+    },
+    {
+      role: 'user',
+      content: userMessage
+    }
+  ];
+}
+
 // 导出函数
 export default {
   buildSystemPrompt,
@@ -386,5 +527,6 @@ export default {
   buildFileReviewMessages,
   buildFileReviewWithImpactPrompt,
   buildFileReviewWithImpactMessages,
+  buildGenerateGuardPromptMessages,
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitlab-ai-review",
-  "version": "4.0.1",
+  "version": "4.1.0",
   "description": "GitLab AI Review SDK with Impact Analysis - 支持影响分析、删除符号检测、注释代码识别、文件内部冲突检查、智能文件过滤的智能代码审查工具",
   "main": "index.js",
   "type": "module",
@@ -30,16 +30,16 @@
     "merge-request",
     "automation"
   ],
-  "author": "Your Name <your.email@example.com>",
+  "author": "dengjiang1",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/yourusername/gitlab-ai-review.git"
+    "url": "https://github.com/dengjiang1/gitlab-ai-review.git"
   },
   "bugs": {
-    "url": "https://github.com/yourusername/gitlab-ai-review/issues"
+    "url": "https://github.com/dengjiang1/gitlab-ai-review/issues"
   },
-  "homepage": "https://github.com/yourusername/gitlab-ai-review#readme",
+  "homepage": "https://github.com/dengjiang1/gitlab-ai-review#readme",
   "engines": {
     "node": ">=18.0.0"
   },