@zhuxb-clouds/ai-code-review 1.3.0 → 1.3.2

package/README.md

@@ -1,240 +1,247 @@
 # AI Code Reviewer & Commit Generator
 
-基于 Node.js 和 OpenAI-compatible API 的 Git Hooks 集成方案。在执行 `git commit` 时自动进行代码审查，并根据 Diff 自动生成符合 [Conventional Commits](https://www.conventionalcommits.org/) 规范的提交信息。
+[English] | [简体中文](./README.zh-CN.md)
 
-**支持的 AI 提供商**: OpenAI, DeepSeek
+A Git Hooks integration solution built with Node.js and OpenAI-compatible APIs. It automatically performs code reviews during `git commit` and generates commit messages that follow the [Conventional Commits](https://www.conventionalcommits.org/) specification based on your code changes.
 
-## 🚀 核心特性
+**Supported AI Providers**: OpenAI, DeepSeek, and more.
 
-- **自动化审查**：在代码提交前拦截潜在 Bug 或不规范实践
-- **语义化提交**：自动撰写符合 Conventional Commits 规范的提交信息
-- **无感集成**：通过 Git Hooks 实现，无需改变原有开发习惯
-- **成本可控**：支持 Diff 大小限制，避免 Token 浪费
-- **一键安装**：作为 npm 包安装到任何项目
-- **多提供商支持**：支持 OpenAI、DeepSeek 等兼容 API
-- **代理支持**：支持 HTTP/HTTPS/SOCKS5 代理
+## 🚀 Key Features
+
+* **Automated Review**: Intercepts potential bugs or sub-optimal practices before the commit is finalized.
+* **Semantic Commits**: Automatically drafts commit messages adhering to the Conventional Commits standard.
+* **Seamless Integration**: Powered by Git Hooks; requires no changes to your existing development workflow.
+* **Cost Efficiency**: Supports diff size limits to prevent excessive Token usage.
+* **One-Click Installation**: Easily installable as an npm package in any project.
+* **Multi-Provider Support**: Compatible with OpenAI, DeepSeek, and other OpenAI-compliant APIs.
+* **Proxy Support**: Full support for HTTP/HTTPS/SOCKS5 proxies.
 
 ---
 
-## 🛠️ 技术架构
+## 🛠️ Technical Architecture
 
 ```
-git commit → Husky (commit-msg) → ai-review-hook → AI API (OpenAI/DeepSeek)
-                                               ↓
-                                   ✅ 通过：自动填充 Commit Message
-                                   ❌ 失败：拦截提交并输出建议
+git commit → Husky (prepare-commit-msg) → ai-review-hook → AI API (OpenAI/DeepSeek)
+                                                 ↓
+                                    ✅ Pass: Auto-fill Commit Message
+                                    ❌ Fail: Block commit & output suggestions
+
 ```
 
 ---
 
-## 📦 快速开始
+## 📦 Quick Start
 
-### 1. 安装到你的项目
+### 1. Install in your project
 
 ```bash
-# 安装为开发依赖
+# Install as a dev dependency
 npm install ai-code-review -D
 
-# 初始化（自动安装 Husky 并配置 Git Hook）
+# Initialize (Automatically installs Husky and configures Git Hooks)
 npx ai-review init
+
 ```
 
-### 2. 配置环境变量
+### 2. Configure Environment Variables
 
-复制生成的 `.env.example` 为 `.env` 并填入你的 API Key：
+Copy the generated `.env.example` to `.env` and enter your API Key:
 
 ```bash
 cp .env.example .env
+
 ```
 
-#### 使用 OpenAI
+#### Using OpenAI
 
 ```bash
 AI_PROVIDER=openai
 OPENAI_API_KEY=sk-your-openai-key-here
 OPENAI_MODEL=gpt-4o-mini
+
 ```
 
-#### 使用 DeepSeek
+#### Using DeepSeek
 
 ```bash
 AI_PROVIDER=deepseek
 DEEPSEEK_API_KEY=sk-your-deepseek-key-here
-# OPENAI_MODEL=deepseek-chat  # 可选，默认 deepseek-chat
+# OPENAI_MODEL=deepseek-chat  # Optional, defaults to deepseek-chat
+
 ```
 
-#### 使用代理
+#### Using Proxies
 
 ```bash
 HTTPS_PROXY=http://127.0.0.1:7890
+
 ```
 
-> ⚠️ **安全提示**：`.env` 已自动添加到 `.gitignore`，请勿手动提交！
+> ⚠️ **Security Note**: `.env` is automatically added to `.gitignore`. Never commit your API keys!
 
-### 3. 开始使用
+### 3. Usage
 
 ```bash
-# 正常开发并暂存更改
+# Develop and stage your changes as usual
 git add .
 
-# 发起提交（推荐不带 -m，让 AI 生成）
+# Execute commit (Recommended: omit -m to let AI generate the message)
 git commit
 
-# AI 会自动审查并生成提交信息
-# 🔍 正在进行 AI 代码审查...
-# ✅ AI Review 通过
-# 📝 生成的提交信息: feat(auth): add JWT token validation
+# AI will automatically review and generate the message
+# 🔍 Running AI Code Review...
+# ✅ AI Review Passed
+# 📝 Generated Message: feat(auth): add JWT token validation
+
 ```
 
 ---
 
-## 📂 安装后的目录结构
+## 📂 Post-Installation Directory Structure
 
 ```
 your-project/
 ├── .husky/
-│   └── commit-msg              # Git Hook（自动创建）
-├── .env                       # API Key（自己创建，不要提交！）
-├── .env.example               # 配置示例（自动创建）
-├── .reviewignore              # AI 审查忽略文件（可选）
-├── .reviewignore.example      # 忽略规则示例（自动创建）
-├── .gitignore                 # 已包含 .env
-└── package.json               # 包含 ai-code-review 依赖
+│   └── prepare-commit-msg     # Git Hook (Auto-generated)
+├── .env                       # API Keys (User-created, do not commit!)
+├── .env.example               # Configuration template (Auto-generated)
+├── .reviewignore              # AI Review ignore file (Optional)
+├── .reviewignore.example      # Ignore rules template (Auto-generated)
+├── .gitignore                 # Now includes .env
+└── package.json               # Contains ai-code-review dependency
+
 ```
 
 ---
 
-## 🚫 文件忽略配置 (.reviewignore)
+## 🚫 File Exclusion (.reviewignore)
 
-创建 `.reviewignore` 文件来跳过某些文件的 AI 审查，语法类似 `.gitignore`：
+Create a `.reviewignore` file to skip AI reviews for specific files. The syntax is identical to `.gitignore`:
 
 ```bash
-# 复制示例文件
+# Copy the example file
 cp .reviewignore.example .reviewignore
+
 ```
 
-### 支持的语法
+### Supported Syntax
 
 ```gitignore
-# 注释
-# 这是一个注释
+# Comments
+# This is a comment
 
-# 通配符
-package-lock.json   # 匹配特定文件
-*.min.js            # * 匹配任意字符（不包括 /）
-dist/               # 匹配整个目录
-**/*.snap           # ** 匹配任意路径层级
+# Wildcards
+package-lock.json   # Match specific file
+*.min.js            # * matches any string (excluding /)
+dist/               # Match entire directory
+**/*.snap           # ** matches any path depth
+
+# Negation patterns
+*.md                # Ignore all markdown files
+!README.md          # Do NOT ignore README.md
 
-# 否定模式
-*.md                # 忽略所有 markdown
-!README.md          # 但不忽略 README.md
 ```
 
-### 常见配置示例
+### Common Configuration Examples
 
 ```gitignore
-# 锁文件
+# Lock files
 package-lock.json
 pnpm-lock.yaml
 yarn.lock
 
-# 生成的文件
+# Generated files
 *.min.js
 *.bundle.js
 dist/
 build/
 
-# 文档和资源
+# Docs and Assets
 *.md
 *.svg
 *.png
 
-# 测试快照
+# Test Snapshots
 __snapshots__/
 *.snap
+
 ```
 
 ---
 
-## ⌨️ CLI 命令
+## ⌨️ CLI Commands
 
 ```bash
-# 完整初始化（安装 Husky + 配置 Hook）
+# Full Initialization (Install Husky + Config Hook)
 npx ai-review init
 
-# 仅配置 Hook（如果 Husky 已安装）
+# Configure Hook Only (If Husky is already installed)
 npx ai-review setup
 
-# 显示帮助
+# Display help information
 npx ai-review help
+
 ```
 
-### 特殊情况
+### Skipping AI Review
 
 ```bash
-# 跳过 AI 审查（紧急情况）
-git commit --no-verify -m "hotfix: urgent fix"
+# Manual messages using -m will automatically skip AI generation
+git commit -m "feat: your manual message"
+
+# Merge, squash, and amend operations also skip the review automatically
+git merge feature-branch
+git commit --amend
 
-# 带 -m 提交时仍会进行审查，但会使用你提供的消息
-git commit -m "your message"
 ```
 
 ---
 
-## ⚙️ 配置选项
+## ⚙️ Configuration Options
 
-通过环境变量配置：
+Configure your setup via environment variables in the `.env` file:
 
-### 基础配置
+### Base Configuration
 
-| 环境变量           | 默认值   | 说明                                                             |
-| ------------------ | -------- | ---------------------------------------------------------------- |
-| `AI_PROVIDER`      | `openai` | AI 提供商：`openai` 或 `deepseek`                                |
-| `OPENAI_API_KEY`   | -        | OpenAI API Key（使用 OpenAI 时必填）                             |
-| `DEEPSEEK_API_KEY` | -        | DeepSeek API Key（使用 DeepSeek 时必填）                         |
-| `OPENAI_BASE_URL`  | 自动设置 | 自定义 API 地址（可覆盖默认）                                    |
-| `OPENAI_MODEL`     | 自动设置 | 模型名称（OpenAI 默认 gpt-4o-mini，DeepSeek 默认 deepseek-chat） |
+| Variable           | Default  | Description                                               |
+| ------------------ | -------- | --------------------------------------------------------- |
+| `AI_PROVIDER`      | `openai` | AI Provider: `openai` or `deepseek`                       |
+| `OPENAI_API_KEY`   | -        | OpenAI API Key (Required if using OpenAI)                 |
+| `DEEPSEEK_API_KEY` | -        | DeepSeek API Key (Required if using DeepSeek)             |
+| `OPENAI_BASE_URL`  | Auto     | Custom API endpoint URL                                   |
+| `OPENAI_MODEL`     | Auto     | Model name (OpenAI: gpt-4o-mini, DeepSeek: deepseek-chat) |
 
-### 网络配置
+### Network Configuration
 
-| 环境变量      | 默认值 | 说明                       |
-| ------------- | ------ | -------------------------- |
-| `HTTPS_PROXY` | -      | HTTP/HTTPS/SOCKS5 代理地址 |
-| `HTTP_PROXY`  | -      | 同上，备选                 |
+| Variable      | Default | Description                     |
+| ------------- | ------- | ------------------------------- |
+| `HTTPS_PROXY` | -       | HTTP/HTTPS/SOCKS5 proxy address |
+| `HTTP_PROXY`  | -       | Alternative proxy address       |
 
-### 行为配置
+### Behavior Configuration
 
-| 环境变量                  | 默认值          | 说明                       |
-| ------------------------- | --------------- | -------------------------- |
-| `AI_REVIEW_MAX_DIFF_SIZE` | `15000`         | 最大 Diff 字符数，超出截断 |
-| `AI_REVIEW_TIMEOUT`       | `30000`         | API 请求超时时间（毫秒）   |
-| `AI_REVIEW_MAX_RETRIES`   | `3`             | 失败时最大重试次数         |
-| `AI_REVIEW_RETRY_DELAY`   | `1000`          | 重试间隔时间（毫秒）       |
-| `AI_REVIEW_VERBOSE`       | `false`         | 启用详细日志               |
-| `AI_REVIEW_SKIP_BUILD`    | `false`         | 跳过构建检查               |
-| `AI_REVIEW_BUILD_COMMAND` | `npm run build` | 构建命令                   |
+| Variable                  | Default | Description                                    |
+| ------------------------- | ------- | ---------------------------------------------- |
+| `AI_REVIEW_MAX_DIFF_SIZE` | `15000` | Max characters in diff (truncated if exceeded) |
+| `AI_REVIEW_TIMEOUT`       | `30000` | API request timeout in milliseconds            |
+| `AI_REVIEW_MAX_RETRIES`   | `3`     | Max retries on failure                         |
+| `AI_REVIEW_RETRY_DELAY`   | `1000`  | Delay between retries in milliseconds          |
+| `AI_REVIEW_VERBOSE`       | `false` | Enable detailed logging                        |
 
----
+### Build Checks (Optional)
 
-## 🔄 替代方案对比
+Build checks have been moved to the hook script. You can customize them by editing `.husky/prepare-commit-msg`:
 
-| 方案                                              | 优点                              | 缺点                   |
-| ------------------------------------------------- | --------------------------------- | ---------------------- |
-| **本方案 (ai-code-review)**                       | 一键安装、代码审查 + 提交信息生成 | 需要 OpenAI API Key    |
-| [aicommits](https://github.com/Nutlope/aicommits) | 开箱即用的 CLI                    | 不含代码审查功能       |
-| [cz-git](https://cz-git.qbb.sh/) + AI             | 交互式提交、规范完善              | 配置较复杂             |
-| GitHub Copilot                                    | IDE 集成、体验好                  | 需要订阅、无 Hook 集成 |
-
----
+```bash
+# Open the hook file
+vim .husky/prepare-commit-msg
 
-## ⚠️ 注意事项
+# Uncomment the following lines to enable build checks
+echo "🔨 Running build check..."
+npm run build || exit 1
+echo "✅ Build passed"
 
-1. **网络环境**：确保可访问 OpenAI API（或配置代理/自定义 Base URL）
-2. **成本控制**：
-   - 默认使用 `gpt-4o-mini`，成本约为 GPT-4 的 1/10
-   - 大改动建议分批 `git add` 提交
-3. **安全**：`.env` 文件绝对不要提交到仓库
-4. **容错**：脚本在 API 出错时会允许提交，不阻塞开发
+```
 
 ---
 

package/README.zh-CN.md

@@ -0,0 +1,224 @@
+# AI Code Reviewer & Commit Generator
+
+[English](./README.md) | [简体中文]
+
+基于 Node.js 和 OpenAI-compatible API 的 Git Hooks 集成方案。在执行 `git commit` 时自动进行代码审查，并根据 Diff 自动生成符合 [Conventional Commits](https://www.conventionalcommits.org/) 规范的提交信息。
+
+**支持的 AI 提供商**: OpenAI, DeepSeek
+
+## 🚀 核心特性
+
+- **自动化审查**：在代码提交前拦截潜在 Bug 或不规范实践
+- **语义化提交**：自动撰写符合 Conventional Commits 规范的提交信息
+- **无感集成**：通过 Git Hooks 实现，无需改变原有开发习惯
+- **成本可控**：支持 Diff 大小限制，避免 Token 浪费
+- **一键安装**：作为 npm 包安装到任何项目
+- **多提供商支持**：支持 OpenAI、DeepSeek 等兼容 API
+- **代理支持**：支持 HTTP/HTTPS/SOCKS5 代理
+
+---
+
+## 🛠️ 技术架构
+
+```
+git commit → Husky (prepare-commit-msg) → ai-review-hook → AI API (OpenAI/DeepSeek)
+                                                 ↓
+                                    ✅ 通过：自动填充 Commit Message
+                                    ❌ 失败：拦截提交并输出建议
+```
+
+---
+
+## 📦 快速开始
+
+### 1. 安装到你的项目
+
+```bash
+# 安装为开发依赖
+npm install ai-code-review -D
+
+# 初始化（自动安装 Husky 并配置 Git Hook）
+npx ai-review init
+```
+
+### 2. 配置环境变量
+
+复制生成的 `.env.example` 为 `.env` 并填入你的 API Key：
+
+```bash
+cp .env.example .env
+```
+
+#### 使用 OpenAI
+
+```bash
+AI_PROVIDER=openai
+OPENAI_API_KEY=sk-your-openai-key-here
+OPENAI_MODEL=gpt-4o-mini
+```
+
+#### 使用 DeepSeek
+
+```bash
+AI_PROVIDER=deepseek
+DEEPSEEK_API_KEY=sk-your-deepseek-key-here
+# OPENAI_MODEL=deepseek-chat  # 可选，默认 deepseek-chat
+```
+
+#### 使用代理
+
+```bash
+HTTPS_PROXY=http://127.0.0.1:7890
+```
+
+> ⚠️ **安全提示**：`.env` 已自动添加到 `.gitignore`，请勿手动提交！
+
+### 3. 开始使用
+
+```bash
+# 正常开发并暂存更改
+git add .
+
+# 发起提交（推荐不带 -m，让 AI 生成）
+git commit
+
+# AI 会自动审查并生成提交信息
+# 🔍 正在进行 AI 代码审查...
+# ✅ AI Review 通过
+# 📝 生成的提交信息: feat(auth): add JWT token validation
+```
+
+---
+
+## 📂 安装后的目录结构
+
+```
+your-project/
+├── .husky/
+│   └── prepare-commit-msg     # Git Hook（自动创建）
+├── .env                       # API Key（自己创建，不要提交！）
+├── .env.example               # 配置示例（自动创建）
+├── .reviewignore              # AI 审查忽略文件（可选）
+├── .reviewignore.example      # 忽略规则示例（自动创建）
+├── .gitignore                 # 已包含 .env
+└── package.json               # 包含 ai-code-review 依赖
+```
+
+---
+
+## 🚫 文件忽略配置 (.reviewignore)
+
+创建 `.reviewignore` 文件来跳过某些文件的 AI 审查，语法类似 `.gitignore`：
+
+```bash
+# 复制示例文件
+cp .reviewignore.example .reviewignore
+```
+
+### 支持的语法
+
+```gitignore
+# 注释
+# 这是一个注释
+
+# 通配符
+package-lock.json   # 匹配特定文件
+*.min.js            # * 匹配任意字符（不包括 /）
+dist/               # 匹配整个目录
+**/*.snap           # ** 匹配任意路径层级
+
+# 否定模式
+*.md                # 忽略所有 markdown
+!README.md          # 但不忽略 README.md
+```
+
+### 常见配置示例
+
+```gitignore
+# 锁文件
+package-lock.json
+pnpm-lock.yaml
+yarn.lock
+
+# 生成的文件
+*.min.js
+*.bundle.js
+dist/
+build/
+
+# 文档和资源
+*.md
+*.svg
+*.png
+
+# 测试快照
+__snapshots__/
+*.snap
+```
+
+---
+
+## ⌨️ CLI 命令
+
+```bash
+# 完整初始化（安装 Husky + 配置 Hook）
+npx ai-review init
+
+# 仅配置 Hook（如果 Husky 已安装）
+npx ai-review setup
+
+# 显示帮助
+npx ai-review help
+```
+
+### 跳过 AI Review
+
+```bash
+# 使用 -m 参数时自动跳过 AI 生成（直接使用你的消息）
+git commit -m "feat: your message"
+
+# merge/squash/amend 提交也会自动跳过
+git merge feature-branch
+git commit --amend
+```
+
+---
+
+## ⚙️ 配置选项
+
+通过环境变量配置：
+
+### 基础配置
+
+| 环境变量           | 默认值   | 说明                                                             |
+| ------------------ | -------- | ---------------------------------------------------------------- |
+| `AI_PROVIDER`      | `openai` | AI 提供商：`openai` 或 `deepseek`                                |
+| `OPENAI_API_KEY`   | -        | OpenAI API Key（使用 OpenAI 时必填）                             |
+| `DEEPSEEK_API_KEY` | -        | DeepSeek API Key（使用 DeepSeek 时必填）                         |
+| `OPENAI_BASE_URL`  | 自动设置 | 自定义 API 地址（可覆盖默认）                                    |
+| `OPENAI_MODEL`     | 自动设置 | 模型名称（OpenAI 默认 gpt-4o-mini，DeepSeek 默认 deepseek-chat） |
+
+### 网络配置
+
+| 环境变量      | 默认值 | 说明                       |
+| ------------- | ------ | -------------------------- |
+| `HTTPS_PROXY` | -      | HTTP/HTTPS/SOCKS5 代理地址 |
+| `HTTP_PROXY`  | -      | 同上，备选                 |
+
+### 行为配置
+
+| 环境变量                  | 默认值          | 说明                       |
+| ------------------------- | --------------- | -------------------------- |
+| `AI_REVIEW_MAX_DIFF_SIZE` | `15000`         | 最大 Diff 字符数，超出截断 |
+| `AI_REVIEW_TIMEOUT`       | `30000`         | API 请求超时时间（毫秒）   |
+| `AI_REVIEW_MAX_RETRIES`   | `3`             | 失败时最大重试次数         |
+| `AI_REVIEW_RETRY_DELAY`   | `1000`          | 重试间隔时间（毫秒）       |
+| `AI_REVIEW_VERBOSE`       | `false`         | 启用详细日志               |
+| `AI_REVIEW_SKIP_BUILD`    | `false`         | 跳过构建检查               |
+| `AI_REVIEW_BUILD_COMMAND` | `npm run build` | 构建命令                   |
+
+---
+
+## 📄 License
+
+MIT

package/bin/cli.mjs

@@ -25,9 +25,18 @@ const command = process.argv[2];
 const HOOK_CONTENT = `#!/bin/sh
 
 # AI Code Review Hook
-# 使用 commit-msg hook 以支持 --no-verify 跳过
 # $1: 提交消息文件路径
-npx ai-review-hook "$1"
+# $2: 提交来源 (message, template, merge, squash, commit)
+
+# ======== 可选：构建检查 ========
+# 取消下面的注释来启用构建检查，可自行修改命令
+# echo "🔨 正在运行构建检查..."
+# npm run build || exit 1
+# echo "✅ 构建通过"
+# ================================
+
+# AI 代码审查和 commit message 生成
+npx ai-review-hook "$1" "$2"
 `;
 
 const ENV_EXAMPLE = `# AI 提供商选择 (openai / deepseek)
@@ -50,8 +59,6 @@ OPENAI_API_KEY=sk-your-openai-api-key-here
 # AI_REVIEW_MAX_RETRIES=3
 # AI_REVIEW_RETRY_DELAY=1000
 # AI_REVIEW_VERBOSE=false
-# AI_REVIEW_SKIP_BUILD=false
-# AI_REVIEW_BUILD_COMMAND=npm run build
 `;
 
 function showHelp() {
@@ -117,17 +124,17 @@ function setupHook() {
     fs.mkdirSync(huskyDir, { recursive: true });
   }
 
-  // 创建 commit-msg hook（支持 --no-verify 跳过）
-  const hookPath = path.join(huskyDir, "commit-msg");
+  // 创建 prepare-commit-msg hook
+  const hookPath = path.join(huskyDir, "prepare-commit-msg");
   fs.writeFileSync(hookPath, HOOK_CONTENT);
   fs.chmodSync(hookPath, "755");
-  console.log("✅ 创建 Git Hook: .husky/commit-msg");
+  console.log("✅ 创建 Git Hook: .husky/prepare-commit-msg");
 
-  // 删除旧的 prepare-commit-msg hook（如果存在）
-  const oldHookPath = path.join(huskyDir, "prepare-commit-msg");
+  // 删除旧的 commit-msg hook（如果存在）
+  const oldHookPath = path.join(huskyDir, "commit-msg");
   if (fs.existsSync(oldHookPath)) {
     fs.unlinkSync(oldHookPath);
-    console.log("🗑️  删除旧的 Hook: .husky/prepare-commit-msg");
+    console.log("🗑️  删除旧的 Hook: .husky/commit-msg");
   }
 
   // 创建 .env.example

package/bin/hook.mjs

@@ -77,8 +77,6 @@ const CONFIG = {
   model: aiConfig.model,
   maxDiffSize: parseInt(process.env.AI_REVIEW_MAX_DIFF_SIZE) || 15000,
   timeout: parseInt(process.env.AI_REVIEW_TIMEOUT) || 30000,
-  skipBuild: process.env.AI_REVIEW_SKIP_BUILD === "true",
-  buildCommand: process.env.AI_REVIEW_BUILD_COMMAND || "npm run build",
   verbose: process.env.AI_REVIEW_VERBOSE === "true",
   maxRetries: parseInt(process.env.AI_REVIEW_MAX_RETRIES) || 3,
   retryDelay: parseInt(process.env.AI_REVIEW_RETRY_DELAY) || 1000,
@@ -259,38 +257,25 @@ function filterDiff(diff, ignorePatterns) {
 }
 
 const commitMsgFile = process.argv[2];
-
-// 检查是否是 merge 提交（通过检查 MERGE_HEAD 文件）
-function isMergeCommit() {
-  try {
-    const gitDir = execSync("git rev-parse --git-dir", { encoding: "utf-8" }).trim();
-    return fs.existsSync(path.join(gitDir, "MERGE_HEAD"));
-  } catch {
-    return false;
-  }
-}
-
-// 检查 commit message 是否已经有内容（非模板）
-function hasExistingMessage() {
-  if (!commitMsgFile || !fs.existsSync(commitMsgFile)) {
-    return false;
-  }
-  const content = fs.readFileSync(commitMsgFile, "utf-8");
-  // 过滤掉注释行和空行
-  const meaningfulLines = content
-    .split("\n")
-    .filter((line) => !line.startsWith("#") && line.trim());
-  return meaningfulLines.length > 0;
-}
-
-// 如果是 merge 提交或已有 message，跳过处理
-if (isMergeCommit()) {
-  console.log("ℹ️  跳过 AI Review（merge 提交）");
-  process.exit(0);
-}
-
-if (hasExistingMessage()) {
-  logVerbose("检测到已有 commit message，跳过 AI 生成");
+const commitSource = process.argv[3]; // message, template, merge, squash, commit
+
+// 检查是否应该跳过 AI Review
+// commitSource 说明：
+// - "message": 使用 -m 或 -F 提供了消息
+// - "template": 使用了模板
+// - "merge": merge 提交
+// - "squash": squash 提交
+// - "commit": 使用 -c/-C/--amend
+
+// 如果使用了 -m 提供消息，或者是 merge/squash/amend，跳过 AI 生成
+if (["message", "merge", "squash", "commit"].includes(commitSource)) {
+  const reasons = {
+    message: "使用了 -m 参数",
+    merge: "merge 提交",
+    squash: "squash 提交",
+    commit: "amend 提交",
+  };
+  console.log(`ℹ️  跳过 AI Review（${reasons[commitSource] || commitSource}）`);
   process.exit(0);
 }
 
@@ -364,7 +349,6 @@ async function runAIReview() {
   logVerbose(`模型: ${CONFIG.model}`);
   logVerbose(`最大 Diff 大小: ${CONFIG.maxDiffSize}`);
   logVerbose(`超时时间: ${CONFIG.timeout}ms`);
-  logVerbose(`跳过构建: ${CONFIG.skipBuild}`);
   if (process.env.OPENAI_BASE_URL) {
     logVerbose(`API Base URL: ${process.env.OPENAI_BASE_URL}`);
   }
@@ -399,28 +383,7 @@ async function runAIReview() {
 
     logVerbose(`过滤后 Diff 大小: ${(diff.length / 1000).toFixed(2)}KB`);
 
-    // 2. 运行构建检查
-    if (!CONFIG.skipBuild) {
-      console.log(`🔨 正在运行构建检查: ${CONFIG.buildCommand}`);
-      const buildTimer = logTime("构建检查");
-      try {
-        execSync(CONFIG.buildCommand, {
-          cwd: projectRoot,
-          stdio: "inherit",
-          encoding: "utf-8",
-        });
-        console.log("✅ 构建通过");
-        logTimeEnd(buildTimer);
-      } catch (buildError) {
-        console.error("❌ 构建失败，请修复后重新提交");
-        console.error("\n使用 git commit --no-verify 可跳过检查");
-        process.exit(1);
-      }
-    } else {
-      logVerbose("跳过构建检查 (AI_REVIEW_SKIP_BUILD=true)");
-    }
-
-    // 3. 检查 Diff 大小
+    // 2. 检查 Diff 大小
     if (diff.length > CONFIG.maxDiffSize) {
       console.warn(`⚠️  Diff 过大 (${(diff.length / 1000).toFixed(1)}KB)，建议分批提交`);
       console.warn(`   当前限制: ${CONFIG.maxDiffSize / 1000}KB，超出部分将被截断`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuxb-clouds/ai-code-review",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "基于 OpenAI API 的 Git Hooks 集成方案，自动代码审查并生成 Conventional Commits 提交信息",
   "type": "module",
   "bin": {