✨ feat(ai): add reasoning support for compatible models

Author: Jannchie

tests/unit/test_commit.py

@@ -306,6 +306,8 @@ def test_generate_commit_with_ai_success(self, mock_settings, mock_template, moc
         mock_check.assert_called_once()
         mock_create_client.assert_called_once()
         mock_client.responses.parse.assert_called_once()
+        _, kwargs = mock_client.responses.parse.call_args
+        assert "reasoning" not in kwargs
 
     @patch("tgit.commit._check_openai_availability")
     @patch("tgit.commit._create_openai_client")
@@ -319,6 +321,31 @@ def test_generate_commit_with_ai_failure(self, mock_console, mock_create_client,
         with pytest.raises(Exception):
             _generate_commit_with_ai("diff content", None, "main")
 
+    @patch("tgit.commit._check_openai_availability")
+    @patch("tgit.commit._create_openai_client")
+    @patch("tgit.commit.console")
+    @patch("tgit.commit.commit_prompt_template")
+    @patch("tgit.commit.settings")
+    def test_generate_commit_with_ai_reasoning_model(self, mock_settings, mock_template, mock_console, mock_create_client, mock_check):
+        """Test reasoning effort is added for reasoning-capable models."""
+        mock_client = Mock()
+        mock_create_client.return_value = mock_client
+        mock_template.render.return_value = "system prompt"
+        mock_settings.model = "o1-mini"
+
+        mock_response = Mock()
+        mock_commit_data = CommitData(type="fix", scope=None, msg="correct bug", is_breaking=False)
+        mock_response.output_parsed = mock_commit_data
+        mock_client.responses.parse.return_value = mock_response
+
+        result = _generate_commit_with_ai("diff content", None, "main")
+
+        assert result == mock_commit_data
+        mock_check.assert_called_once()
+        mock_create_client.assert_called_once()
+        _, kwargs = mock_client.responses.parse.call_args
+        assert kwargs["reasoning"] == {"effort": "minimal"}
+
 
 class TestGetAICommand:
     """Test get_ai_command function."""

tgit/commit.py

@@ -3,15 +3,15 @@
 import itertools
 from dataclasses import dataclass
 from pathlib import Path
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Any
 
 import click
 import git
 from jinja2 import Environment, FileSystemLoader
 from pydantic import BaseModel
 from rich import get_console, print
 
-from tgit.constants import DEFAULT_MODEL
+from tgit.constants import DEFAULT_MODEL, REASONING_MODEL_HINTS
 from tgit.shared import settings
 from tgit.utils import get_commit_command, run_command, type_emojis
 
@@ -72,6 +72,14 @@ class CommitData(BaseModel):
     is_breaking: bool
 
 
+def _supports_reasoning(model: str) -> bool:
+    """Return True when the selected model supports reasoning parameters."""
+    if not model:
+        return False
+    model_lower = model.lower()
+    return any(hint in model_lower for hint in REASONING_MODEL_HINTS)
+
+
 def get_changed_files_from_status(repo: git.Repo) -> set[str]:
     """获取所有变更的文件，包括重命名/移动的文件"""
     diff_name_status = repo.git.diff("--cached", "--name-status", "-M")
@@ -178,18 +186,24 @@ def _generate_commit_with_ai(diff: str, specified_type: str | None, current_bran
     )
 
     with console.status("[bold green]Generating commit message...[/bold green]"):
-        chat_completion = client.responses.parse(
-            input=[
+        model_name = settings.model or DEFAULT_MODEL
+        request_kwargs: dict[str, Any] = {
+            "input": [
                 {
                     "role": "system",
                     "content": commit_prompt_template.render(**template_params.__dict__),
                 },
                 {"role": "user", "content": diff},
             ],
-            model=settings.model or DEFAULT_MODEL,
-            reasoning={"effort": "minimal"},
-            max_output_tokens=50,
-            text_format=CommitData,
+            "model": model_name,
+            "max_output_tokens": 50,
+            "text_format": CommitData,
+        }
+        if _supports_reasoning(model_name):
+            request_kwargs["reasoning"] = {"effort": "minimal"}
+
+        chat_completion = client.responses.parse(
+            **request_kwargs,
         )
 
     return chat_completion.output_parsed

tgit/constants.py

@@ -1,3 +1,4 @@
 """Global constants used across the TGIT project."""
 
 DEFAULT_MODEL = "gpt-5-mini"
+REASONING_MODEL_HINTS = ("-reasoning", "o1", "o3")