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

package/README.md

@@ -19,10 +19,10 @@
 ## 🛠️ 技术架构
 
 ```
-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)
+                                                 ↓
+                                    ✅ 通过：自动填充 Commit Message
+                                    ❌ 失败：拦截提交并输出建议
 ```
 
 ---
@@ -93,7 +93,7 @@ git commit
 ```
 your-project/
 ├── .husky/
-│   └── commit-msg              # Git Hook（自动创建）
+│   └── prepare-commit-msg     # Git Hook（自动创建）
 ├── .env                       # API Key（自己创建，不要提交！）
 ├── .env.example               # 配置示例（自动创建）
 ├── .reviewignore              # AI 审查忽略文件（可选）
@@ -169,14 +169,15 @@ npx ai-review setup
 npx ai-review help
 ```
 
-### 特殊情况
+### 跳过 AI Review
 
 ```bash
-# 跳过 AI 审查（紧急情况）
-git commit --no-verify -m "hotfix: urgent fix"
+# 使用 -m 参数时自动跳过 AI 生成（直接使用你的消息）
+git commit -m "feat: your message"
 
-# 带 -m 提交时仍会进行审查，但会使用你提供的消息
-git commit -m "your message"
+# merge/squash/amend 提交也会自动跳过
+git merge feature-branch
+git commit --amend
 ```
 
 ---

package/bin/cli.mjs

@@ -25,9 +25,10 @@ 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)
+# 当使用 git commit -m "xxx" 时，$2 为 "message"，自动跳过 AI 生成
+npx ai-review-hook "$1" "$2"
 `;
 
 const ENV_EXAMPLE = `# AI 提供商选择 (openai / deepseek)
@@ -117,17 +118,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

@@ -259,38 +259,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);
 }
 

package/package.json

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