gitlab-ai-review 4.2.3 → 6.3.9

package/lib/gitlab-client.js

@@ -92,11 +92,16 @@ export class GitLabClient {
       old_path: lineInfo.oldPath || lineInfo.filePath,
     };
 
-    // 设置行号（只能设置其中一个，或者两个都设置表示修改块）
+    // 设置行号
+    // GitLab API 要求：
+    // - 纯新增行：只设置 new_line
+    // - 纯删除行：只设置 old_line
+    // - 修改块：设置 new_line（评论到新代码上）
+    // 注意：同时设置 old_line 和 new_line 可能导致定位问题，优先使用 new_line
     if (lineInfo.newLine !== undefined) {
       position.new_line = lineInfo.newLine;
-    }
-    if (lineInfo.oldLine !== undefined) {
+    } else if (lineInfo.oldLine !== undefined) {
+      // 只有在没有 newLine 时才使用 oldLine（纯删除情况）
       position.old_line = lineInfo.oldLine;
     }
 
@@ -203,14 +208,590 @@ export class GitLabClient {
    * @param {string} projectId - 项目 ID
    * @param {string} ref - 分支名
    * @param {string} path - 路径（可选）
+   * @param {boolean} recursive - 是否递归获取（默认 false）
    * @returns {Promise<Array>} 文件树
    */
-  async getRepositoryTree(projectId, ref, path = '') {
+  async getRepositoryTree(projectId, ref, path = '', recursive = false) {
     try {
-      const endpoint = `/projects/${encodeURIComponent(projectId)}/repository/tree?ref=${ref}&path=${encodeURIComponent(path)}&recursive=false`;
-      return await this.request(endpoint);
+      // 获取所有页面的数据
+      let allItems = [];
+      let page = 1;
+      const perPage = 100;
+      
+      while (true) {
+        const endpoint = `/projects/${encodeURIComponent(projectId)}/repository/tree?ref=${encodeURIComponent(ref)}&path=${encodeURIComponent(path)}&recursive=${recursive}&per_page=${perPage}&page=${page}`;
+        
+        const response = await fetch(`${this.apiUrl}${endpoint}`, {
+          headers: {
+            'PRIVATE-TOKEN': this.token,
+            'Content-Type': 'application/json',
+          },
+        });
+        
+        if (!response.ok) {
+          console.warn(`❌ 获取仓库树失败: ${response.status} ${response.statusText}`);
+          return allItems;
+        }
+        
+        const items = await response.json();
+        
+        if (!Array.isArray(items) || items.length === 0) {
+          break;
+        }
+        
+        allItems = allItems.concat(items);
+        
+        if (items.length < perPage) {
+          break;
+        }
+        
+        page++;
+        
+        // 安全限制：最多获取 10 页
+        if (page > 10) {
+          break;
+        }
+      }
+      
+      return allItems;
+    } catch (error) {
+      console.warn(`❌ 获取仓库树失败:`, error.message);
+      return [];
+    }
+  }
+
+  /**
+   * 获取整个项目的源代码文件
+   * @param {string} projectId - 项目 ID
+   * @param {string} ref - 分支名
+   * @param {Object} options - 选项
+   * @param {Array} options.extensions - 要获取的文件扩展名（默认常见源代码文件）
+   * @param {Array} options.excludePaths - 排除的路径模式
+   * @param {number} options.maxFiles - 最大文件数量（默认 50）
+   * @param {number} options.maxFileSize - 最大单文件行数（默认 300）
+   * @returns {Promise<Array>} 文件内容数组 [{ path, content }]
+   */
+  async getProjectSourceFiles(projectId, ref, options = {}) {
+    const {
+      extensions = ['.js', '.ts', '.tsx', '.jsx', '.vue', '.py', '.go', '.java', '.rb', '.php', '.cs', '.cpp', '.c', '.h'],
+      excludePaths = ['node_modules', 'dist', 'build', '.git', 'vendor', '__pycache__', '.next', 'coverage'],
+    } = options;
+
+    console.log(`📂 获取项目源代码文件 (分支: ${ref})...`);
+
+    // 递归获取所有文件
+    const tree = await this.getRepositoryTree(projectId, ref, '', true);
+    
+    // 过滤源代码文件
+    const sourceFiles = tree.filter(item => {
+      if (item.type !== 'blob') return false;
+      
+      // 检查扩展名
+      const hasValidExtension = extensions.some(ext => item.path.endsWith(ext));
+      if (!hasValidExtension) return false;
+      
+      // 检查排除路径
+      const isExcluded = excludePaths.some(excludePath => item.path.includes(excludePath));
+      if (isExcluded) return false;
+      
+      return true;
+    });
+
+    console.log(`   - 找到 ${sourceFiles.length} 个源代码文件`);
+
+    // 获取所有文件内容（不限制数量和大小）
+    const filesContent = [];
+
+    for (const file of sourceFiles) {
+      try {
+        const content = await this.getProjectFile(projectId, file.path, ref);
+        if (content) {
+          const lines = content.split('\n');
+          filesContent.push({
+            path: file.path,
+            content: content,
+            totalLines: lines.length,
+          });
+        }
+      } catch (error) {
+        // 静默处理获取失败的文件
+      }
+    }
+
+    console.log(`   ✓ 成功获取 ${filesContent.length} 个文件的内容`);
+    
+    return filesContent;
+  }
+
+  /**
+   * 🎯 获取整个项目的所有代码文件（用于生成 reviewguard.md）
+   * @param {string} projectId - 项目 ID
+   * @param {string} ref - 分支名（默认 main）
+   * @param {Object} options - 选项
+   * @param {number} options.maxTotalChars - 最大总字符数（默认 500000，约 500K）
+   * @param {number} options.maxSingleFileChars - 单个文件最大字符数（默认 50000）
+   * @returns {Promise<Object>} { files: Array, techStack: Object, stats: Object }
+   */
+  async getFullProjectForAnalysis(projectId, ref = 'main', options = {}) {
+    const {
+      fullMode = true,                 // 🎯 默认使用完整模式
+      maxTotalChars = fullMode ? 500000 : 25000,  // 完整模式：500K，轻量模式：25K
+      maxConfigFiles = fullMode ? 50 : 8,         // 完整模式：50个，轻量模式：8个
+      maxSampleFiles = fullMode ? 100 : 5,        // 完整模式：100个，轻量模式：5个
+      maxFileSize = fullMode ? 50000 : 8000,      // 单文件上限：50K vs 8K
+    } = options;
+
+    const modeLabel = fullMode ? '📦 完整模式' : '🚀 轻量模式';
+
+    console.log('\n' + '='.repeat(60));
+    console.log(`📊 正在通过 GitLab API 分析项目（${fullMode ? '完整模式' : '轻量模式'}）...`);
+    console.log('='.repeat(60));
+    console.log(`  - 项目 ID: ${projectId}`);
+    console.log(`  - 分支: ${ref}`);
+    console.log(`  - 模式: ${modeLabel}`);
+    console.log(`  - 最大总字符数: ${(maxTotalChars / 1000).toFixed(0)}K`);
+
+    // 排除的路径（目录）
+    const excludePaths = [
+      'node_modules', 'dist', 'build', '.git', 'vendor',
+      '__pycache__', '.next', '.nuxt', 'coverage', 'out',
+      '.venv', 'venv', 'target', 'bin', 'obj',
+      // 🎯 排除静态资源目录
+      'assets', 'images', 'img', 'icons', 'fonts',
+      'public', 'static',
+      // 排除测试和配置目录
+      'test', 'tests', '__tests__', 'spec', 'e2e',
+      '.github', '.vscode', '.idea', '.husky',
+    ];
+
+    // 🎯 排除的文件扩展名（非代码文件）
+    const excludeExtensions = [
+      // 图片
+      '.png', '.jpg', '.jpeg', '.gif', '.svg', '.ico', '.webp', '.bmp',
+      // 字体
+      '.woff', '.woff2', '.ttf', '.eot', '.otf',
+      // 媒体
+      '.mp3', '.mp4', '.wav', '.avi', '.mov', '.webm',
+      // 其他二进制
+      '.pdf', '.doc', '.docx', '.xls', '.xlsx', '.ppt', '.pptx',
+      '.zip', '.tar', '.gz', '.rar', '.7z',
+      '.exe', '.dll', '.so', '.dylib',
+      // 锁文件
+      '.lock', '-lock.json', '-lock.yaml',
+    ];
+
+    // 🎯 关键配置文件（优先获取）
+    const keyConfigFiles = [
+      'package.json', 'tsconfig.json', 
+      'vite.config.ts', 'vite.config.js',
+      'webpack.config.js', 'tailwind.config.js',
+      '.eslintrc.js', '.eslintrc.json', 'eslint.config.js',
+      'requirements.txt', 'pyproject.toml',
+      'go.mod', 'Cargo.toml', 'pom.xml',
+    ];
+
+    // 代码文件扩展名（只读取这些类型的代码文件）
+    const codeExtensions = ['.ts', '.tsx', '.js', '.jsx', '.vue', '.py', '.go', '.java', '.rs', '.rb', '.php', '.cs', '.cpp', '.c', '.h'];
+
+    // 1. 获取项目文件树
+    console.log('\n📂 获取项目文件树...');
+    const tree = await this.getRepositoryTree(projectId, ref, '', true);
+    console.log(`   找到 ${tree.length} 个文件/目录`);
+
+    // 2. 过滤并分类文件
+    const allFiles = tree.filter(item => {
+      if (item.type !== 'blob') return false;
+      // 排除指定目录
+      if (excludePaths.some(ex => item.path.includes(`/${ex}/`) || item.path.startsWith(`${ex}/`))) {
+        return false;
+      }
+      // 排除指定扩展名
+      if (excludeExtensions.some(ext => item.path.toLowerCase().endsWith(ext))) {
+        return false;
+      }
+      return true;
+    });
+
+    // 分类：配置文件 vs 代码文件
+    const configFiles = [];
+    const sourceFiles = [];
+    
+    for (const file of allFiles) {
+      const fileName = file.path.split('/').pop();
+      const isConfig = keyConfigFiles.some(cf => fileName === cf || fileName.startsWith(cf.split('.')[0]));
+      const isCode = codeExtensions.some(ext => file.path.endsWith(ext));
+      
+      if (isConfig) configFiles.push(file);
+      else if (isCode) sourceFiles.push(file);
+    }
+
+    console.log(`   配置文件: ${configFiles.length} 个`);
+    console.log(`   代码文件: ${sourceFiles.length} 个`);
+
+    // 3. 构建目录结构树
+    const directoryTree = this.buildDirectoryTree(allFiles.map(f => f.path));
+
+    // 4. 获取关键文件内容
+    console.log(`\n📖 读取关键文件（${fullMode ? '完整模式' : '轻量模式'}）...`);
+    const files = [];
+    let totalChars = 0;
+
+    // 4.1 优先获取配置文件（完整内容）
+    for (const file of configFiles.slice(0, maxConfigFiles)) {
+      if (totalChars >= maxTotalChars) break;
+      
+      try {
+        const content = await this.getProjectFile(projectId, file.path, ref);
+        if (content && content.length < maxFileSize) {
+          files.push({ path: file.path, content, size: content.length, type: 'config' });
+          totalChars += content.length;
+          console.log(`   ✅ ${file.path} (${(content.length / 1000).toFixed(1)}K)`);
+        }
+      } catch (e) { /* skip */ }
+    }
+
+    // 4.2 获取代码文件
+    if (fullMode) {
+      // 🎯 完整模式：获取所有代码文件的完整内容
+      console.log('\n📝 读取所有代码文件（完整内容）...');
+      for (const file of sourceFiles.slice(0, maxSampleFiles)) {
+        if (totalChars >= maxTotalChars) {
+          console.log(`   ⚠️ 已达到字符上限 ${(maxTotalChars / 1000).toFixed(0)}K，停止读取更多文件`);
+          break;
+        }
+        
+        try {
+          const content = await this.getProjectFile(projectId, file.path, ref);
+          if (content && content.length < maxFileSize) {
+            files.push({ path: file.path, content, size: content.length, type: 'source' });
+            totalChars += content.length;
+            console.log(`   ✅ ${file.path} (${(content.length / 1000).toFixed(1)}K)`);
+          } else if (content) {
+            // 文件太大，截取前面部分
+            const truncated = content.slice(0, maxFileSize);
+            files.push({ path: file.path, content: truncated + '\n// ... 文件过大，已截断 ...', size: truncated.length, type: 'source', truncated: true });
+            totalChars += truncated.length;
+            console.log(`   📝 ${file.path} (截断: ${(truncated.length / 1000).toFixed(1)}K / ${(content.length / 1000).toFixed(1)}K)`);
+          }
+        } catch (e) { /* skip */ }
+      }
+    } else {
+      // 🚀 轻量模式：只获取入口文件的摘要
+      const entryPatterns = ['index.ts', 'index.js', 'main.ts', 'main.js', 'App.tsx', 'App.vue', 'app.py', 'main.go'];
+      const entryFiles = sourceFiles.filter(f => entryPatterns.some(p => f.path.endsWith(p)));
+      const sampleFiles = [...entryFiles, ...sourceFiles.slice(0, 3)].slice(0, maxSampleFiles);
+      
+      for (const file of sampleFiles) {
+        if (totalChars >= maxTotalChars) break;
+        
+        try {
+          const content = await this.getProjectFile(projectId, file.path, ref);
+          if (content) {
+            // 只取简短摘要
+            const summary = this.extractFileSummary(content, file.path, 25);
+            if (totalChars + summary.length <= maxTotalChars) {
+              files.push({ path: file.path, content: summary, size: summary.length, originalSize: content.length, type: 'sample' });
+              totalChars += summary.length;
+              console.log(`   📝 ${file.path} (摘要: ${(summary.length / 1000).toFixed(1)}K)`);
+            }
+          }
+        } catch (e) { /* skip */ }
+      }
+    }
+
+    // 5. 检测技术栈
+    const techStack = this.detectTechStackFromFiles(files);
+
+    // 6. 统计信息
+    const stats = {
+      totalFiles: files.length,
+      totalChars: totalChars,
+      configFilesCount: configFiles.length,
+      sourceFilesCount: sourceFiles.length,
+      mode: fullMode ? 'full' : 'lite',
+    };
+
+    console.log('\n' + '='.repeat(60));
+    console.log(`✅ 项目分析完成（${fullMode ? '完整模式' : '轻量模式'}）`);
+    console.log(`   - 获取文件数: ${stats.totalFiles}`);
+    console.log(`   - 总字符数: ${(stats.totalChars / 1000).toFixed(1)}K`);
+    console.log(`   - 项目配置文件: ${stats.configFilesCount} 个`);
+    console.log(`   - 项目代码文件: ${stats.sourceFilesCount} 个`);
+    console.log('='.repeat(60) + '\n');
+
+    return {
+      files,
+      techStack,
+      stats,
+      directoryTree,                    // 📁 目录结构树
+      fileList: allFiles.map(f => f.path),  // 📋 完整文件列表
+    };
+  }
+
+  /**
+   * 构建目录结构树（文本格式）
+   * @param {Array} filePaths - 文件路径数组
+   * @returns {string} 目录树文本
+   */
+  buildDirectoryTree(filePaths) {
+    // 按目录分组统计
+    const dirStats = {};
+    for (const path of filePaths) {
+      const parts = path.split('/');
+      if (parts.length > 1) {
+        const dir = parts.slice(0, -1).join('/');
+        dirStats[dir] = (dirStats[dir] || 0) + 1;
+      } else {
+        dirStats['.'] = (dirStats['.'] || 0) + 1;
+      }
+    }
+
+    // 构建简化的目录树
+    const lines = ['📦 项目结构'];
+    const topDirs = Object.entries(dirStats)
+      .sort((a, b) => b[1] - a[1])
+      .slice(0, 20);  // 只显示前 20 个目录
+
+    for (const [dir, count] of topDirs) {
+      const depth = dir.split('/').length;
+      const indent = '  '.repeat(Math.min(depth, 3));
+      lines.push(`${indent}📁 ${dir}/ (${count} 个文件)`);
+    }
+
+    if (Object.keys(dirStats).length > 20) {
+      lines.push(`  ... 还有 ${Object.keys(dirStats).length - 20} 个目录`);
+    }
+
+    lines.push(`\n📊 总计: ${filePaths.length} 个文件`);
+    return lines.join('\n');
+  }
+
+  /**
+   * 提取文件摘要（用于大文件）
+   * 提取：imports、exports、函数/类签名、关键注释
+   * @param {string} content - 文件内容
+   * @param {string} filePath - 文件路径
+   * @param {number} maxLines - 最大保留行数
+   * @returns {string} 文件摘要
+   */
+  extractFileSummary(content, filePath, maxLines = 100) {
+    const lines = content.split('\n');
+    const ext = filePath.split('.').pop()?.toLowerCase() || '';
+    const fileName = filePath.split('/').pop() || filePath;
+    
+    // 配置文件：保留完整内容（通常很重要）
+    const configFiles = ['package.json', 'tsconfig.json', 'vite.config', 'webpack.config', '.eslintrc', '.prettierrc'];
+    if (configFiles.some(cf => fileName.includes(cf))) {
+      // 配置文件只截断，不做摘要
+      if (lines.length <= maxLines * 2) {
+        return content;
+      }
+      return lines.slice(0, maxLines * 2).join('\n') + `\n// ... 省略 ${lines.length - maxLines * 2} 行 ...`;
+    }
+
+    const summary = [];
+    summary.push(`// 📄 ${filePath}`);
+    summary.push(`// 原文件共 ${lines.length} 行，以下为摘要`);
+    summary.push('');
+
+    // 提取 imports
+    const imports = lines.filter(l => {
+      const trimmed = l.trim();
+      return trimmed.startsWith('import ') || 
+             trimmed.startsWith('from ') ||
+             trimmed.match(/^(const|let|var)\s+.*=\s*require\(/);
+    });
+    if (imports.length > 0) {
+      summary.push('// === Imports ===');
+      summary.push(...imports.slice(0, 15));
+      if (imports.length > 15) {
+        summary.push(`// ... 还有 ${imports.length - 15} 个 imports`);
+      }
+      summary.push('');
+    }
+
+    // 提取 exports 和函数/类/接口定义
+    const definitions = [];
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      const trimmed = line.trim();
+      
+      // export 语句
+      if (trimmed.startsWith('export ')) {
+        // 如果是多行定义，尝试获取完整签名
+        if (trimmed.match(/export\s+(default\s+)?(function|class|interface|type|const|let|enum)/)) {
+          let def = line;
+          // 获取到第一个 { 或 = 后的几行
+          let j = i + 1;
+          while (j < lines.length && j < i + 5 && !lines[j - 1].includes('{') && !lines[j - 1].includes(';')) {
+            def += '\n' + lines[j];
+            j++;
+          }
+          definitions.push(def.split('{')[0].trim() + (def.includes('{') ? ' { ... }' : ''));
+        } else {
+          definitions.push(trimmed);
+        }
+      }
+      // 非 export 的函数/类定义
+      else if (trimmed.match(/^(async\s+)?function\s+\w+/) || 
+               trimmed.match(/^class\s+\w+/) ||
+               trimmed.match(/^interface\s+\w+/) ||
+               trimmed.match(/^type\s+\w+\s*=/)) {
+        definitions.push(trimmed.split('{')[0].trim() + (trimmed.includes('{') ? ' { ... }' : ''));
+      }
+      // React 组件（箭头函数）
+      else if (trimmed.match(/^(export\s+)?(const|let)\s+\w+\s*[=:]\s*(React\.FC|FC|\(\s*\w*\s*\)|<)/)) {
+        definitions.push(trimmed.split('=>')[0].trim() + ' => ...');
+      }
+    }
+
+    if (definitions.length > 0) {
+      summary.push('// === Exports & Definitions ===');
+      summary.push(...definitions.slice(0, 25));
+      if (definitions.length > 25) {
+        summary.push(`// ... 还有 ${definitions.length - 25} 个定义`);
+      }
+      summary.push('');
+    }
+
+    // 如果摘要太短，添加一些代码片段
+    if (summary.length < 20 && lines.length > 20) {
+      summary.push('// === 代码片段 ===');
+      summary.push(...lines.slice(0, Math.min(30, maxLines)).filter(l => l.trim()));
+      summary.push('// ... 省略剩余代码 ...');
+    }
+
+    return summary.join('\n');
+  }
+
+  /**
+   * 从文件内容中检测技术栈
+   * @param {Array} files - 文件数组
+   * @returns {Object} 技术栈信息
+   */
+  detectTechStackFromFiles(files) {
+    const techStack = {
+      languages: new Set(),
+      frameworks: new Set(),
+      tools: new Set(),
+      packageManager: null,
+    };
+
+    // 查找 package.json
+    const packageJson = files.find(f => f.path === 'package.json' || f.path.endsWith('/package.json'));
+    if (packageJson) {
+      try {
+        const pkg = JSON.parse(packageJson.content);
+        const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+
+        // 检测语言
+        if (files.some(f => f.path.endsWith('.ts') || f.path.endsWith('.tsx'))) {
+          techStack.languages.add('TypeScript');
+        }
+        if (files.some(f => f.path.endsWith('.js') || f.path.endsWith('.jsx'))) {
+          techStack.languages.add('JavaScript');
+        }
+
+        // 检测框架
+        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/core']) techStack.frameworks.add('Angular');
+        if (deps['@radix-ui/react-dialog']) 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.tailwindcss) techStack.tools.add('Tailwind CSS');
+        if (deps.eslint) techStack.tools.add('ESLint');
+        if (deps.prettier) techStack.tools.add('Prettier');
+      } catch (e) {
+        // 忽略解析错误
+      }
+    }
+
+    // 检测其他语言
+    if (files.some(f => f.path.endsWith('.py'))) techStack.languages.add('Python');
+    if (files.some(f => f.path.endsWith('.go'))) techStack.languages.add('Go');
+    if (files.some(f => f.path.endsWith('.java'))) techStack.languages.add('Java');
+    if (files.some(f => f.path.endsWith('.vue'))) techStack.languages.add('Vue');
+
+    return {
+      languages: Array.from(techStack.languages),
+      frameworks: Array.from(techStack.frameworks),
+      tools: Array.from(techStack.tools),
+    };
+  }
+
+  /**
+   * 从 Package Registry 读取文件
+   * @param {string} projectId - 项目 ID
+   * @param {string} packageName - 包名（如 'ai-review-data'）
+   * @param {string} packageVersion - 版本（如 'latest'）
+   * @param {string} fileName - 文件名（如 'review-history.json'）
+   * @returns {Promise<Object|null>} 文件内容（JSON）或 null
+   */
+  async getPackageFile(projectId, packageName, packageVersion, fileName) {
+    try {
+      const url = `${this.apiUrl}/projects/${encodeURIComponent(projectId)}/packages/generic/${packageName}/${packageVersion}/${fileName}`;
+      
+      const response = await fetch(url, {
+        headers: {
+          'PRIVATE-TOKEN': this.token,
+        },
+      });
+
+      if (!response.ok) {
+        if (response.status === 404) {
+          console.log(`📦 Package Registry 中未找到 ${fileName}，将创建新文件`);
+          return null;
+        }
+        console.warn(`⚠️  获取 Package Registry 文件失败: ${response.status}`);
+        return null;
+      }
+
+      const content = await response.text();
+      return JSON.parse(content);
+    } catch (error) {
+      console.warn(`⚠️  读取 Package Registry 失败: ${error.message}`);
+      return null;
+    }
+  }
+
+  /**
+   * 获取 MR 的单条评论内容
+   * @param {string} projectId - 项目 ID
+   * @param {number} mergeRequestIid - MR IID
+   * @param {number} noteId - 评论 ID
+   * @returns {Promise<Object|null>} 评论内容或 null
+   */
+  async getMergeRequestNote(projectId, mergeRequestIid, noteId) {
+    try {
+      return await this.request(
+        `/projects/${encodeURIComponent(projectId)}/merge_requests/${mergeRequestIid}/notes/${noteId}`
+      );
+    } catch (error) {
+      console.warn(`⚠️  获取评论 ${noteId} 失败: ${error.message}`);
+      return null;
+    }
+  }
+
+  /**
+   * 获取 MR 的所有评论
+   * @param {string} projectId - 项目 ID
+   * @param {number} mergeRequestIid - MR IID
+   * @returns {Promise<Array>} 评论列表
+   */
+  async getMergeRequestNotes(projectId, mergeRequestIid) {
+    try {
+      return await this.request(
+        `/projects/${encodeURIComponent(projectId)}/merge_requests/${mergeRequestIid}/notes?per_page=100`
+      );
     } catch (error) {
-      console.warn(`获取仓库树失败:`, error.message);
+      console.warn(`⚠️  获取 MR 评论失败: ${error.message}`);
       return [];
     }
   }