coderev-cli 1.0.24 → 1.0.26

package/README.md

@@ -27,9 +27,14 @@
   - [coderev config（配置管理）](#coderev-config配置管理)
   - [coderev init（初始化）](#coderev-init初始化)
   - [coderev serve（GitHub App 自动审查）](#coderev-servegithub-app-自动审查)
+  - [coderev models（模型模板）🆕](#coderev-models模型模板)
+  - [coderev setup（模型配置）🆕](#coderev-setup模型配置)
+  - [coderev rules（规则市场）🆕](#coderev-rules规则市场)
+  - [coderev doctor（环境诊断）🆕](#coderev-doctor环境诊断)
 - [配置详解](#配置详解)
 - [平台集成](#平台集成)
 - [CI/CD 集成](#cicd-集成)
+- [VS Code 扩展 🆕](#vs-code-扩展)
 - [FAQ / 常见问题](#faq--常见问题)
 
 ---
@@ -94,19 +99,25 @@ coderev init
 
 会在当前目录创建 `.coderevrc.json` 配置文件。
 
-### 第 2 步：设置 API Key
+### 第 2 步：设置模型和 API Key
 
-coderev 需要调用 AI API 来审查代码。支持 OpenAI 和 DeepSeek。
+coderev 内置了 11 个热门模型模板，只需选择模板 + 设置 API Key 即可：
 
 ```bash
-# Windows PowerShell
-$env:DEEPSEEK_API_KEY="sk-your-key-here"
+# 查看所有可用模型
+coderev models
 
-# Linux / macOS
-export DEEPSEEK_API_KEY="sk-your-key-here"
+# 选择 DeepSeek（推荐，性价比最高）
+coderev setup --model deepseek
+
+# 设置 API Key
+# Windows PowerShell:
+$env:DEEPSEEK_API_KEY="***"
+# Linux / macOS:
+export DEEPSEEK_API_KEY="***"
 ```
 
-也可以写入配置文件（见下方「配置详解」）。
+支持所有主流 AI 提供商（见 [coderev models](#coderev-models模型模板) 章节）。
 
 ### 第 3 步：运行审查
 
@@ -481,6 +492,187 @@ GITHUB_APP_ID=123456 GITHUB_APP_WEBHOOK_SECRET=mysecret coderev serve
 
 ---
 
+### coderev models（模型模板）🆕 v1.0.24
+
+**作用**：列出所有内置的 AI 模型模板及其配置。只需选择一个模板并设置对应的 API Key 即可使用。
+
+```bash
+coderev models
+```
+
+**内置模板清单**：
+
+| 模板 | 提供商 | 默认模型 | API Key 环境变量 | 说明 |
+|------|--------|---------|-----------------|------|
+| ⭐ `deepseek` | DeepSeek | deepseek-chat | `DEEPSEEK_API_KEY` | 国产高性价比，¥1/百万token |
+| 🧠 `deepseek-r1` | DeepSeek | deepseek-reasoner | `DEEPSEEK_API_KEY` | 推理增强，适合复杂漏洞分析 |
+| `openai` | OpenAI | gpt-4o | `OPENAI_API_KEY` | GPT-4o 多模态旗舰 |
+| 🧠 `openai-o3` | OpenAI | o3-mini | `OPENAI_API_KEY` | 推理型，速度快 |
+| `qwen` | 阿里云 | qwen-plus | `DASHSCOPE_API_KEY` | 中文能力强，¥0.8/百万token |
+| ⭐ `qwen-coder` | 阿里云 | qwen-coder-plus | `DASHSCOPE_API_KEY` | 代码专精，¥2/百万token |
+| `claude` | Anthropic | claude-sonnet-4-20250514 | `ANTHROPIC_API_KEY` | 代码理解深度最强 |
+| `gemini` | Google | gemini-2.5-pro | `GEMINI_API_KEY` | 100万token上下文 |
+| `zhipu` | 智谱 AI | glm-4-plus | `ZHIPU_API_KEY` | 国产强推理 |
+| `moonshot` | 月之暗面 | moonshot-v1-8k | `MOONSHOT_API_KEY` | 长文本处理强 |
+| `codestral` | Mistral | codestral-latest | `MISTRAL_API_KEY` | 专注代码生成与审查 |
+
+> ⭐ = 推荐  |  🧠 = 推理增强型
+
+---
+
+### coderev setup（模型配置）🆕 v1.0.24
+
+**作用**：一键配置 AI 模型，支持主模型、从模型（fallback）、以及不同 Agent 使用不同模型。
+
+```bash
+coderev setup [选项]
+```
+
+**参数**：
+
+| 参数 | 说明 | 示例 |
+|------|------|------|
+| `--model <模板名>` | 设置主模型 | `coderev setup --model deepseek` |
+| `--fallback <模板名>` | 设置备用模型（主模型失败时自动切换） | `coderev setup --model deepseek --fallback qwen` |
+| `--agent-security <模板名>` | 安全 Agent 专用模型 | `coderev setup --agent-security deepseek-r1` |
+| `--agent-bugs <模板名>` | 缺陷检测 Agent 专用模型 | `coderev setup --agent-bugs qwen-coder` |
+| `--agent-quality <模板名>` | 质量检查 Agent 专用模型 | `coderev setup --agent-quality gemini` |
+| （无参数） | 查看当前配置 | `coderev setup` |
+
+**使用示例**：
+
+```bash
+# 最简：选择 DeepSeek
+coderev setup --model deepseek
+
+# 主从模型：DeepSeek 挂了自动切到千问
+coderev setup --model deepseek --fallback qwen
+
+# 不同 Agent 不同模型
+coderev setup --model deepseek --agent-security deepseek-r1 --agent-quality qwen
+
+# 查看当前配置
+coderev setup
+```
+
+**主从模型回退**：主模型调用失败（超时/网络/API 错误）时，自动切到从模型，控制台打印 `↩ Falling back to xxx`。
+
+---
+
+### coderev rules（规则市场）🆕 v1.0.23
+
+**作用**：访问 coderev SaaS 规则市场，搜索、安装、发布团队共享的审查规则包。
+
+```bash
+coderev rules <action> [选项]
+```
+
+**子命令**：
+
+| 动作 | 说明 | 示例 |
+|------|------|------|
+| `search [query]` | 搜索规则市场 | `coderev rules search react` |
+| `install <name>` | 安装规则包 | `coderev rules install react-security` |
+| `publish` | 发布本地规则到市场 | `coderev rules publish --name my-rules` |
+| `list` | 查看已安装的规则包 | `coderev rules list` |
+| `uninstall <name>` | 卸载规则包 | `coderev rules uninstall react-security` |
+| `info <name>` | 查看规则包详情 | `coderev rules info react-security` |
+
+**参数**：
+
+| 参数 | 说明 |
+|------|------|
+| `-q, --query <text>` | 搜索查询 |
+| `-n, --name <name>` | 规则包名称 |
+| `--version <ver>` | 发布版本号（默认 1.0.0） |
+| `--desc <text>` | 发布描述 |
+| `--api-url <url>` | 自定义市场 API 地址 |
+
+**使用示例**：
+
+```bash
+# 搜索规则
+coderev rules search react
+
+# 安装规则包（自动合并到 .coderevrc.json）
+coderev rules install react-security
+
+# 查看已安装
+coderev rules list
+
+# 发布当地规则
+coderev rules publish --name team-js-rules --desc "团队JS规范"
+
+# 卸载
+coderev rules uninstall react-security
+```
+
+安装后规则写入 `.coderevrc.json` 的 `rules.custom` 数组，带 `_source` 标记。
+
+---
+
+### coderev doctor（环境诊断）🆕 v1.0.26
+
+**作用**：一键诊断 coderev 的运行环境，快速定位配置问题。
+
+```bash
+coderev doctor
+```
+
+**检查项目**：
+
+| 检查项 | 说明 |
+|--------|------|
+| Node.js Version | 检查 Node.js 版本是否 >= 18 |
+| Git | 检查 git 是否安装及当前目录是否为 git 仓库 |
+| Config File | 检查配置文件是否存在且格式有效 |
+| API Key | 检查 API Key 是否已配置（环境变量或配置文件） |
+| AI Provider Connectivity | 检查 AI 服务商网络连通性及 API 可用性 |
+
+**参数**：
+
+| 参数 | 说明 | 示例 |
+|------|------|------|
+| `-c, --config <path>` | 指定配置文件路径 | `coderev doctor --config ./my-config.json` |
+| `--json` | 以 JSON 格式输出 | `coderev doctor --json` |
+
+**输出示例**：
+
+```
+🩺  coderev Doctor — Environment Diagnostic
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  ✔ Node.js Version
+    v24.13.0 (>= 18 required)
+
+  ✔ Git
+    git version 2.45.0 — inside a git repository
+
+  ✔ Config File
+    Valid: /path/to/.coderevrc.json
+
+  ✔ API Key
+    Found from env $DEEPSEEK_API_KEY: sk-xxxx...xxxx
+
+  ✔ AI Provider Connectivity
+    Connected to deepseek (https://api.deepseek.com) — API accessible
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  5 passed
+
+  ✔ All checks passed! Your environment is ready for coderev. 🚀
+```
+
+**适用场景**：
+- 首次安装后验证环境是否就绪
+- 遇到 `API key not found` 等错误时快速定位
+- 切换 AI 服务商后检查连通性
+- CI 环境中验证配置是否完整
+
+`doctor` 命令返回非零退出码当有检查项失败（`✖`），适合在 CI 脚本中使用。
+
+---
+
 ## 配置详解
 
 ### 配置加载顺序
@@ -815,6 +1007,55 @@ git diff origin/main...HEAD | coderev review --ci --min-confidence 70
 
 ---
 
+有关 GitHub Actions、GitLab CI、Jenkins 的 CI/CD 集成说明及模板，见 [docs/ci-cd.md](docs/ci-cd.md)。
+
+一键生成对应 CI 模板：
+
+```bash
+# GitHub Actions 模板
+coderev init --github-action
+# → 生成 .github/workflows/coderev.yml
+
+# GitLab CI 模板
+coderev init --gitlab-ci
+# → 生成 .gitlab-ci.yml
+```
+
+---
+
+## VS Code 扩展 🆕 v1.0.22
+
+coderev 自带 VS Code 扩展，安装后在编码时实时审查代码。
+
+### 安装
+
+```bash
+# 从本地安装（源码已包含在 vscode/ 目录中）
+cd vscode && npm install && npm run package
+# 在 VS Code 中：Ctrl+Shift+P → Extensions: Install from VSIX...
+# 选择 vscode/coderev-*.vsix
+```
+
+> 暂未上架 VS Code Marketplace，通过本地 VSIX 安装。
+
+### 功能
+
+| 功能 | 说明 |
+|------|------|
+| 工作区审查 | 右键项目目录 → `coderev: Review Workspace` |
+| 单文件审查 | 打开文件 → `Ctrl+Shift+P` → `coderev: Review File` |
+| 自动修复 | 审查发现问题后 → 一键调用 AI 修复 |
+| 保存即审查 | 开启 `coderev.lintOnSave` → 每次保存文件自动审查 |
+| Problems 面板集成 | 问题自动输出到 VS Code Problems 面板，点击跳转 |
+
+### 扩展设置
+
+- `coderev.enabled` — 是否启用自动检查（默认 true）
+- `coderev.lintOnSave` — 保存时审查（默认 false）
+- `coderev.minConfidence` — 最低置信度阈值（默认 60）
+
+---
+
 ## FAQ / 常见问题
 
 ### Q：为什么审查结果为空？

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "coderev-cli",
-  "version": "1.0.24",
+  "version": "1.0.26",
   "description": "Multi-agent AI code review for git -- parallel agents with confidence scoring",
   "main": "src/index.js",
   "bin": {
-    "coderev": "src/cli.js"
+    "coderev": "src/bin.js"
   },
   "scripts": {
     "start": "node src/cli.js",

package/src/bin.js

@@ -0,0 +1,3 @@
+// coderev entry point (no shebang — Windows + BOM safe)
+// npm bin wrapper calls this via node, so shebang is unnecessary
+require('./cli');

package/src/cli.js

@@ -1078,6 +1078,33 @@ program
     }
   });
 
+// ── Doctor (Environment Diagnostic) ─────────────────────────────
+program
+  .command('doctor')
+  .description('Run environment diagnostic to troubleshoot common issues')
+  .option('-c, --config <path>', 'Path to config file')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    try {
+      const { runDoctor, formatDoctorReport } = require('./doctor');
+      console.error(chalk.blue('↻ Running environment diagnostic...\n'));
+      const { checks, allPassed } = await runDoctor({ config: options.config });
+
+      if (options.json) {
+        console.log(JSON.stringify({ allPassed, checks }, null, 2));
+      } else {
+        console.log(formatDoctorReport(checks));
+      }
+
+      if (!allPassed) {
+        process.exitCode = 1;
+      }
+    } catch (err) {
+      console.error(chalk.red(`✖ ${err.message}`));
+      process.exit(1);
+    }
+  });
+
 program.parse(process.argv);
 
 // ── Helpers ───────────────────────────────────────────────────

package/src/doctor.js

@@ -0,0 +1,573 @@
+/**
+ * coderev doctor — 环境诊断命令
+ *
+ * 诊断项目环境中的常见配置问题:
+ *   1. Node.js 版本检查
+ *   2. git 可用性检查
+ *   3. 配置文件有效性检查
+ *   4. API Key 配置检查
+ *   5. AI Provider 网络连通性检查
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+const https = require('https');
+const chalk = require('chalk');
+
+// ── 检查项类型 ────────────────────────────────────────────────
+const PASS = 'pass';
+const WARN = 'warn';
+const FAIL = 'fail';
+
+/**
+ * 执行完整的诊断流程并返回结果
+ *
+ * @param {object} options - 选项
+ * @param {string} [options.config] - 显式指定配置文件路径
+ * @returns {Promise<{checks: Array, allPassed: boolean}>}
+ */
+async function runDoctor(options = {}) {
+  const checks = [];
+  const config = loadUserConfig(options.config);
+
+  // 1. Node.js 版本
+  checks.push(checkNodeVersion());
+
+  // 2. Git 可用性
+  checks.push(checkGit());
+
+  // 3. 配置文件
+  checks.push(checkConfig(options.config));
+
+  // 4. API Key
+  checks.push(checkApiKey(config));
+
+  // 5. AI Provider 连通性
+  checks.push(await checkProviderConnectivity(config));
+
+  // 判断是否全部通过
+  const allPassed = checks.every(c => c.status !== FAIL);
+
+  return { checks, allPassed };
+}
+
+// ── 各检查项 ─────────────────────────────────────────────────
+
+/**
+ * 检查 Node.js 版本 >= 18
+ */
+function checkNodeVersion() {
+  const version = process.version;
+  const major = parseInt(version.slice(1).split('.')[0], 10);
+
+  if (major >= 20) {
+    return {
+      name: 'Node.js Version',
+      status: PASS,
+      message: `${version} (>= 18 required)`,
+      detail: `Node.js version is current and fully supported.`,
+    };
+  } else if (major >= 18) {
+    return {
+      name: 'Node.js Version',
+      status: PASS,
+      message: `${version} (minimum met)`,
+      detail: `Node.js >= 18 required. Your version meets the minimum.`,
+    };
+  } else {
+    return {
+      name: 'Node.js Version',
+      status: FAIL,
+      message: `${version} is too old — Node.js >= 18 required`,
+      detail: `Upgrade to Node.js 18+ to use coderev. Download: https://nodejs.org`,
+    };
+  }
+}
+
+/**
+ * 检查 git 是否可用
+ */
+function checkGit() {
+  try {
+    const gitVersion = execSync('git --version', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+    // Verify we're in a git repo (optional, warn if not)
+    let isRepo = true;
+    try {
+      execSync('git rev-parse --git-dir', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+    } catch {
+      isRepo = false;
+    }
+
+    if (isRepo) {
+      return {
+        name: 'Git',
+        status: PASS,
+        message: `${gitVersion} — inside a git repository`,
+        detail: `Git is available and current directory is a git repo.`,
+      };
+    } else {
+      return {
+        name: 'Git',
+        status: PASS,
+        message: `${gitVersion} — not in a git repository`,
+        detail: `Git is available but current directory is not a git repo. This is fine for reviewing diff files directly.`,
+      };
+    }
+  } catch {
+    return {
+      name: 'Git',
+      status: FAIL,
+      message: 'git not found in PATH',
+      detail: `Git is required for most coderev operations. Install: https://git-scm.com`,
+    };
+  }
+}
+
+/**
+ * 检查配置文件是否存在且格式有效
+ */
+function checkConfig(explicitPath) {
+  if (explicitPath) {
+    if (!fs.existsSync(explicitPath)) {
+      return {
+        name: 'Config File',
+        status: WARN,
+        message: `Specified config not found: ${explicitPath}`,
+        detail: `The config file specified via --config does not exist. coderev will use defaults.`,
+      };
+    }
+    try {
+      JSON.parse(fs.readFileSync(explicitPath, 'utf-8'));
+      return {
+        name: 'Config File',
+        status: PASS,
+        message: `Valid: ${explicitPath}`,
+        detail: `Config file exists and contains valid JSON.`,
+      };
+    } catch (err) {
+      return {
+        name: 'Config File',
+        status: FAIL,
+        message: `Invalid JSON: ${err.message}`,
+        detail: `Fix the JSON syntax in your config file.`,
+      };
+    }
+  }
+
+  // Search for config in cwd and parents
+  const configFiles = ['.coderevrc.json', '.coderevrc', 'coderev.config.json'];
+  let found = null;
+  let current = process.cwd();
+
+  while (true) {
+    for (const name of configFiles) {
+      const full = path.join(current, name);
+      if (fs.existsSync(full)) {
+        found = full;
+        break;
+      }
+    }
+    if (found) break;
+    const parent = path.dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+
+  if (found) {
+    try {
+      const content = JSON.parse(fs.readFileSync(found, 'utf-8'));
+      // Check basic structure
+      const warnings = [];
+      if (!content.ai) warnings.push('Missing "ai" section');
+      else {
+        if (!content.ai.provider && !content.ai.model && !content.ai.apiKey) {
+          warnings.push('"ai" section has no provider, model, or apiKey — review may not work');
+        }
+      }
+
+      if (warnings.length > 0) {
+        return {
+          name: 'Config File',
+          status: WARN,
+          message: `Found at ${found} but with issues`,
+          detail: warnings.join('; '),
+          warnings,
+        };
+      }
+
+      return {
+        name: 'Config File',
+        status: PASS,
+        message: `Valid: ${found}`,
+        detail: `Config file found and contains valid JSON with required sections.`,
+      };
+    } catch (err) {
+      return {
+        name: 'Config File',
+        status: FAIL,
+        message: `Invalid JSON in ${found}: ${err.message}`,
+        detail: `Fix the JSON syntax in your config file.`,
+      };
+    }
+  }
+
+  return {
+    name: 'Config File',
+    status: WARN,
+    message: 'No config file found',
+    detail: `No .coderevrc.json found in current or parent directories. Run "coderev init" to create one.`,
+  };
+}
+
+/**
+ * 检查 API Key 是否已配置
+ */
+function checkApiKey(config) {
+  // Direct key
+  if (config.ai?.apiKey) {
+    const key = config.ai.apiKey;
+    const masked = key.slice(0, 8) + '...' + key.slice(-4);
+    return {
+      name: 'API Key',
+      status: PASS,
+      message: `Configured in config file: ${masked}`,
+      detail: `API key is set directly in the config file.`,
+    };
+  }
+
+  // Via environment variable
+  const envVar = config.ai?.apiKeyEnv || 'OPENAI_API_KEY';
+  const key = process.env[envVar];
+  if (key) {
+    const masked = key.slice(0, 8) + '...' + key.slice(-4);
+    return {
+      name: 'API Key',
+      status: PASS,
+      message: `Found from env $${envVar}: ${masked}`,
+      detail: `API key loaded from environment variable ${envVar}.`,
+    };
+  }
+
+  // Try common env vars
+  const commonVars = ['DEEPSEEK_API_KEY', 'OPENAI_API_KEY', 'ANTHROPIC_API_KEY', 'DASHSCOPE_API_KEY', 'GEMINI_API_KEY', 'ZHIPU_API_KEY', 'MOONSHOT_API_KEY', 'MISTRAL_API_KEY'];
+  for (const v of commonVars) {
+    if (process.env[v]) {
+      return {
+        name: 'API Key',
+        status: PASS,
+        message: `Found from env $${v} (not configured in config, but available)`,
+        detail: `API key found in environment variable ${v}. Consider adding "apiKeyEnv" to your config.`,
+      };
+    }
+  }
+
+  return {
+    name: 'API Key',
+    status: FAIL,
+    message: `No API key found`,
+    detail: `Set your API key via environment variable (e.g. DEEPSEEK_API_KEY) or in .coderevrc.json. Run "coderev init" and "coderev setup --model deepseek" to get started.`,
+  };
+}
+
+/**
+ * 检查 AI Provider 网络连通性
+ */
+async function checkProviderConnectivity(config) {
+  const provider = config.ai?.provider || 'deepseek';
+  const baseURL = config.ai?.baseURL || getDefaultBaseURL(provider);
+
+  // Check general internet connectivity first
+  const internetOk = await checkInternet();
+  if (!internetOk) {
+    // If we have no API key at all, this might be expected
+    const key = config.ai?.apiKey || process.env[config.ai?.apiKeyEnv || 'DEEPSEEK_API_KEY'];
+    if (!key) {
+      return {
+        name: 'AI Provider Connectivity',
+        status: WARN,
+        message: 'Cannot check connectivity — no API key configured',
+        detail: `Set up your API key first, then re-run "coderev doctor" to verify connectivity.`,
+      };
+    }
+    return {
+      name: 'AI Provider Connectivity',
+      status: FAIL,
+      message: 'No internet connectivity detected',
+      detail: `Cannot reach external servers. Check your network connection and proxy settings.`,
+    };
+  }
+
+  if (!baseURL || baseURL === 'unknown') {
+    return {
+      name: 'AI Provider Connectivity',
+      status: WARN,
+      message: `Unknown base URL for provider "${provider}"`,
+      detail: `Cannot determine the API endpoint for this provider. Check your config's "baseURL" setting.`,
+    };
+  }
+
+  try {
+    const url = new URL(baseURL);
+    const reachable = await httpHead(url.origin);
+
+    if (reachable) {
+      // Try API models endpoint to verify auth works
+      const apiKey = config.ai?.apiKey || process.env[config.ai?.apiKeyEnv || 'DEEPSEEK_API_KEY'];
+      if (apiKey) {
+        const apiOk = await checkApiEndpoint(url.origin, '/models', apiKey);
+        if (apiOk) {
+          return {
+            name: 'AI Provider Connectivity',
+            status: PASS,
+            message: `Connected to ${provider} (${url.origin}) — API accessible`,
+            detail: `Successfully connected to the AI provider's API endpoint with valid authentication.`,
+          };
+        } else {
+          return {
+            name: 'AI Provider Connectivity',
+            status: WARN,
+            message: `${provider} (${url.origin}) is reachable but API returned an error`,
+            detail: `The server is reachable but the /models endpoint returned an error. Your API key may be invalid or the endpoint URL may be incorrect.`,
+          };
+        }
+      }
+
+      return {
+        name: 'AI Provider Connectivity',
+        status: PASS,
+        message: `Connected to ${provider} (${url.origin}) — server reachable`,
+        detail: `The AI provider's server is reachable. Full API auth check skipped (no API key to verify).`,
+      };
+    }
+
+    return {
+      name: 'AI Provider Connectivity',
+      status: FAIL,
+      message: `Cannot reach ${provider} at ${url.origin}`,
+      detail: `The AI provider's server is not responding. Check your network, firewall, or proxy settings. Some providers may be blocked in certain regions.`,
+    };
+  } catch (err) {
+    return {
+      name: 'AI Provider Connectivity',
+      status: FAIL,
+      message: `Invalid base URL: ${baseURL} (${err.message})`,
+      detail: `The configured baseURL is not a valid URL. Fix the "baseURL" setting in your config.`,
+    };
+  }
+}
+
+// ── Helper Functions ──────────────────────────────────────────
+
+/**
+ * Load user config (simple, without inheritance)
+ */
+function loadUserConfig(explicitPath) {
+  if (explicitPath) {
+    if (fs.existsSync(explicitPath)) {
+      try {
+        return JSON.parse(fs.readFileSync(explicitPath, 'utf-8'));
+      } catch {
+        return {};
+      }
+    }
+    return {};
+  }
+
+  // Search for config
+  const configFiles = ['.coderevrc.json', '.coderevrc', 'coderev.config.json'];
+  let current = process.cwd();
+
+  while (true) {
+    for (const name of configFiles) {
+      const full = path.join(current, name);
+      if (fs.existsSync(full)) {
+        try {
+          return JSON.parse(fs.readFileSync(full, 'utf-8'));
+        } catch {
+          return {};
+        }
+      }
+    }
+    const parent = path.dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+
+  return {};
+}
+
+/**
+ * Get default base URL for known providers
+ */
+function getDefaultBaseURL(provider) {
+  const urls = {
+    openai: 'https://api.openai.com/v1',
+    deepseek: 'https://api.deepseek.com/v1',
+    anthropic: 'https://api.anthropic.com',
+    dashscope: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
+    qwen: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
+    gemini: 'https://generativelanguage.googleapis.com',
+    zhipu: 'https://open.bigmodel.cn/api/paas/v4',
+    moonshot: 'https://api.moonshot.cn/v1',
+    mistral: 'https://api.mistral.ai/v1',
+  };
+  return urls[provider.toLowerCase()] || 'unknown';
+}
+
+/**
+ * Check basic internet connectivity
+ */
+function checkInternet() {
+  return new Promise((resolve) => {
+    const req = https.get('https://www.google.com', { timeout: 5000 }, () => {
+      resolve(true);
+    });
+    req.on('error', () => {
+      // Try another host
+      const req2 = https.get('https://api.github.com', { timeout: 5000 }, () => {
+        resolve(true);
+      });
+      req2.on('error', () => resolve(false));
+    });
+  });
+}
+
+/**
+ * Simple HTTP HEAD check
+ */
+function httpHead(origin) {
+  return new Promise((resolve) => {
+    const url = new URL(origin);
+    const options = {
+      hostname: url.hostname,
+      port: url.port || (url.protocol === 'https:' ? 443 : 80),
+      path: '/',
+      method: 'HEAD',
+      timeout: 8000,
+      rejectUnauthorized: false,
+    };
+    const mod = url.protocol === 'https:' ? https : require('http');
+    const req = mod.request(options, (res) => {
+      resolve(true);
+      res.resume();
+    });
+    req.on('error', () => resolve(false));
+    req.on('timeout', () => {
+      req.destroy();
+      resolve(false);
+    });
+    req.end();
+  });
+}
+
+/**
+ * Check if an API endpoint is accessible with auth
+ */
+function checkApiEndpoint(origin, path, apiKey) {
+  return new Promise((resolve) => {
+    const url = new URL(origin + path);
+    const options = {
+      hostname: url.hostname,
+      port: url.port || (url.protocol === 'https:' ? 443 : 80),
+      path: url.pathname,
+      method: 'GET',
+      timeout: 10000,
+      headers: {
+        'Authorization': `Bearer ${apiKey}`,
+        'User-Agent': `coderev-doctor/${require('../package.json').version}`,
+      },
+      rejectUnauthorized: false,
+    };
+    const mod = url.protocol === 'https:' ? https : require('http');
+    const req = mod.request(options, (res) => {
+      // 2xx or 4xx (even 401 means the endpoint is accessible, just auth issue)
+      resolve(res.statusCode < 500);
+      res.resume();
+    });
+    req.on('error', () => resolve(false));
+    req.on('timeout', () => {
+      req.destroy();
+      resolve(false);
+    });
+    req.end();
+  });
+}
+
+// ── 格式化输出 ────────────────────────────────────────────────
+
+/**
+ * Format the diagnostic result as a colored terminal report
+ */
+function formatDoctorReport(checks) {
+  const lines = [];
+
+  lines.push('');
+  lines.push(chalk.bold('🩺  coderev Doctor — Environment Diagnostic'));
+  lines.push(chalk.gray('━'.repeat(58)));
+
+  let passCount = 0;
+  let warnCount = 0;
+  let failCount = 0;
+
+  for (const check of checks) {
+    const icon = check.status === PASS ? chalk.green('✔') :
+                 check.status === WARN ? chalk.yellow('⚠') :
+                 chalk.red('✖');
+
+    lines.push('');
+    lines.push(`  ${icon} ${chalk.bold(check.name)}`);
+    lines.push(`    ${colorStatus(check.status, check.message)}`);
+
+    if (check.detail) {
+      const detailColor = check.status === PASS ? chalk.gray :
+                          check.status === WARN ? chalk.yellow :
+                          chalk.red;
+      lines.push(`    ${detailColor(check.detail)}`);
+    }
+
+    if (check.warnings && check.warnings.length > 0) {
+      for (const w of check.warnings) {
+        lines.push(`    ${chalk.yellow('  → ' + w)}`);
+      }
+    }
+
+    if (check.status === PASS) passCount++;
+    else if (check.status === WARN) warnCount++;
+    else failCount++;
+  }
+
+  // Summary
+  lines.push('');
+  lines.push(chalk.gray('━'.repeat(58)));
+  const summaryParts = [];
+  if (passCount > 0) summaryParts.push(chalk.green(`${passCount} passed`));
+  if (warnCount > 0) summaryParts.push(chalk.yellow(`${warnCount} warnings`));
+  if (failCount > 0) summaryParts.push(chalk.red(`${failCount} failed`));
+  lines.push(`  ${summaryParts.join('  ')}`);
+
+  if (failCount > 0) {
+    lines.push('');
+    lines.push(chalk.red('  ✖ Some checks failed. Fix the issues above before using coderev.'));
+  } else if (warnCount > 0) {
+    lines.push('');
+    lines.push(chalk.yellow('  ⚠ Some checks have warnings. coderev will work, but may be suboptimal.'));
+  } else {
+    lines.push('');
+    lines.push(chalk.green('  ✔ All checks passed! Your environment is ready for coderev. 🚀'));
+  }
+
+  lines.push('');
+  return lines.join('\n');
+}
+
+/**
+ * Color a status message
+ */
+function colorStatus(status, message) {
+  if (status === PASS) return chalk.green(message);
+  if (status === WARN) return chalk.yellow(message);
+  return chalk.red(message);
+}
+
+module.exports = { runDoctor, formatDoctorReport, PASS, WARN, FAIL };