git-gcm 1.0.2__tar.gz → 2.0.1__tar.gz

{git_gcm-1.0.2 → git_gcm-2.0.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: git-gcm
-Version: 1.0.2
-Summary: Git Commit Message 自动生成工具
+Version: 2.0.1
+Summary: Write Git commits the smart way.
 Author-email: Luca <yangshaoxiong5545@gmail.com>
 License: MIT
 Project-URL: Homepage, https://github.com/falconluca/gcm
@@ -25,47 +25,63 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: openai>=1.0.0
 Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: questionary>=1.4.0
 Dynamic: license-file
 
 # GCM
 
 [![PyPI version](https://badge.fury.io/py/git-gcm.svg)](https://pypi.org/project/git-gcm/)
 
-基于大模型的 Git Commit Message 自动生成工具，支持所有 OpenAI 协议兼容的大模型服务
+基于大模型的 Git Commit Message 生成，支持所有 OpenAI 协议兼容的服务。
 
 ## 安装
 
 ```bash
-pip install git-gcm
+# Mac 用户先装 pipx
+brew install pipx && pipx ensurepath
+
+pipx install git-gcm
 ```
 
-## 配置
+升级：`pipx upgrade git-gcm`
 
-设置环境变量：
+## 配置
 
 ```bash
-export GCM_API_KEY="your-api-key"
-export GCM_API_URL="https://api.openai.com/v1"
-export GCM_MODEL="gpt-4o-mini"
+export GCM_API_URL=https://api.openai.com/v1
+export GCM_API_KEY=your-api-key
+export GCM_MODEL=gpt-4o-mini
 ```
 
+持久化写入 `~/.zshrc` / `~/.bashrc` 后 `source` 一下。
+
 ## 使用
 
 ```bash
 git add .
-gcm           # 生成精简 commit message
-gcm -v        # 生成详细 commit message
+gcm              # 生成 commit message 并进入交互菜单
+gcm -v           # 详细模式
+gcm -f           # 跳过 git hooks（等价 --no-verify）
+gcm --print-only # 仅输出，不提交
 ```
 
+生成后进入交互菜单（↑↓ 选择，Enter 确认）：
+
+- **提交** — 直接 `git commit`
+- **编辑** — 微调 message，Alt/⌥+Enter 保存
+- **仅输出** — 只打印不提交
+
+> 非交互终端（如 `gcm | cat`）自动跳过菜单，直接输出。
+
 ## 示例
 
-**精简模式：**
+精简模式：
 
 ```
 feat(auth): 添加用户登录功能
 ```
 
-**详细模式 (`-v`)：**
+详细模式（`-v`）：
 
 ```
 feat(auth): 添加用户登录功能

git_gcm-2.0.1/README.md

@@ -0,0 +1,64 @@
+# GCM
+
+[![PyPI version](https://badge.fury.io/py/git-gcm.svg)](https://pypi.org/project/git-gcm/)
+
+基于大模型的 Git Commit Message 生成，支持所有 OpenAI 协议兼容的服务。
+
+## 安装
+
+```bash
+# Mac 用户先装 pipx
+brew install pipx && pipx ensurepath
+
+pipx install git-gcm
+```
+
+升级：`pipx upgrade git-gcm`
+
+## 配置
+
+```bash
+export GCM_API_URL=https://api.openai.com/v1
+export GCM_API_KEY=your-api-key
+export GCM_MODEL=gpt-4o-mini
+```
+
+持久化写入 `~/.zshrc` / `~/.bashrc` 后 `source` 一下。
+
+## 使用
+
+```bash
+git add .
+gcm              # 生成 commit message 并进入交互菜单
+gcm -v           # 详细模式
+gcm -f           # 跳过 git hooks（等价 --no-verify）
+gcm --print-only # 仅输出，不提交
+```
+
+生成后进入交互菜单（↑↓ 选择，Enter 确认）：
+
+- **提交** — 直接 `git commit`
+- **编辑** — 微调 message，Alt/⌥+Enter 保存
+- **仅输出** — 只打印不提交
+
+> 非交互终端（如 `gcm | cat`）自动跳过菜单，直接输出。
+
+## 示例
+
+精简模式：
+
+```
+feat(auth): 添加用户登录功能
+```
+
+详细模式（`-v`）：
+
+```
+feat(auth): 添加用户登录功能
+
+- 实现 JWT token 认证
+- 添加登录表单验证
+- 集成第三方 OAuth 登录
+```
+
+MIT License

{git_gcm-1.0.2 → git_gcm-2.0.1}/gcm/__init__.py

@@ -1,3 +1,3 @@
 """GCM - Git Commit Message Generator"""
 
-__version__ = "0.1.0"
+__version__ = "2.0.1"

git_gcm-2.0.1/gcm/cli.py

@@ -0,0 +1,200 @@
+"""命令行入口模块"""
+
+import argparse
+import sys
+from pathlib import Path
+from typing import Optional
+
+from dotenv import load_dotenv
+
+from gcm import __version__
+from gcm.git import GitRepo
+from gcm.prompt import PromptBuilder
+from gcm.llm import LLMClient, LLMConfig
+from gcm.interactive import InteractiveCommitter
+
+
+class _ZhHelpFormatter(argparse.HelpFormatter):
+    """中文帮助格式：将 argparse 默认的 'usage:' 标题本地化为 '用法: '。"""
+
+    def _format_usage(self, usage, actions, groups, prefix):
+        return super()._format_usage(usage, actions, groups, prefix or "用法: ")
+
+
+class GCMApp:
+    """GCM 应用主控：加载配置、解析参数、编排「生成→交互→提交」流程"""
+
+    def __init__(self):
+        self.repo = GitRepo()
+        self.args: Optional[argparse.Namespace] = None
+
+    def run(self) -> None:
+        """主流程入口"""
+        self._load_env()
+        self.args = self._parse_args()
+
+        # 检查是否在 git 仓库中
+        if not self.repo.is_repo():
+            print("⚠️ 错误: 当前目录不在 Git 仓库中", file=sys.stderr)
+            sys.exit(1)
+
+        # 获取暂存区变更
+        changes = self.repo.get_staged_changes()
+        if not changes.files:
+            print("📦 暂存区没有变更。请先使用 'git add' 添加变更。", file=sys.stderr)
+            sys.exit(1)
+
+        # 生成 commit message
+        try:
+            config = self._build_config()
+            client = LLMClient(config)
+            builder = PromptBuilder(verbose=self.args.verbose)
+            commit_msg = client.chat(
+                builder.system_prompt(),
+                builder.user_prompt(changes),
+            )
+        except ValueError as e:
+            print(f"⚠️ 配置错误: {e}", file=sys.stderr)
+            sys.exit(1)
+        except RuntimeError as e:
+            print(f"❌ 生成失败: {e}", file=sys.stderr)
+            sys.exit(1)
+
+        # 仅输出模式（--print-only 或非交互终端）：保持旧行为，便于脚本/管道
+        if self.args.print_only or not sys.stdin.isatty():
+            print(commit_msg)
+            return
+
+        # 交互模式：菜单 → 修改/确认 → 提交
+        InteractiveCommitter(self.repo, no_verify=self.args.no_verify).run(commit_msg)
+
+    def _load_env(self) -> None:
+        """加载 .env 文件"""
+        # 加载用户主目录的 .env（优先级较低）
+        home_env = Path.home() / ".env"
+        if home_env.exists():
+            load_dotenv(home_env)
+
+        # 加载项目目录的 .env（优先级较高）
+        project_env = self._find_env_file()
+        if project_env:
+            load_dotenv(project_env)
+
+    def _find_env_file(self) -> Optional[Path]:
+        """查找 .env 文件
+
+        查找顺序:
+        1. 当前目录的 .env
+        2. 父目录（向上查找直到 git 根目录）
+        3. 用户主目录的 .env
+        """
+        # 当前目录
+        env_path = Path.cwd() / ".env"
+        if env_path.exists():
+            return env_path
+
+        # 向上查找直到 git 根目录
+        current = Path.cwd()
+        while current != current.parent:
+            current = current.parent
+            env_path = current / ".env"
+            if env_path.exists():
+                return env_path
+            # 如果找到 .git 目录就停止
+            if (current / ".git").exists():
+                break
+
+        # 用户主目录
+        env_path = Path.home() / ".env"
+        if env_path.exists():
+            return env_path
+
+        return None
+
+    def _parse_args(self) -> argparse.Namespace:
+        """解析命令行参数"""
+        parser = argparse.ArgumentParser(
+            prog="gcm",
+            description="基于大模型的 Git Commit Message 生成",
+            formatter_class=_ZhHelpFormatter,
+            add_help=False,
+        )
+        # 本地化 argparse 的 "options:" 分组标题
+        parser._optionals.title = "可选参数"
+
+        parser.add_argument(
+            "-h", "--help",
+            action="help",
+            default=argparse.SUPPRESS,
+            help="显示此帮助信息并退出",
+        )
+
+        parser.add_argument(
+            "-v", "--verbose",
+            action="store_true",
+            help="生成详细的 commit message"
+        )
+
+        parser.add_argument(
+            "--api-base",
+            type=str,
+            help="API 基础 URL（覆盖 GCM_API_URL）"
+        )
+
+        parser.add_argument(
+            "--api-key",
+            type=str,
+            help="API Key（覆盖 GCM_API_KEY，不推荐在命令行中使用）"
+        )
+
+        parser.add_argument(
+            "-m", "--model",
+            type=str,
+            help="使用的模型名称（覆盖 GCM_MODEL）"
+        )
+
+        parser.add_argument(
+            "--print-only", "--no-commit",
+            dest="print_only",
+            action="store_true",
+            help="仅输出 commit message，不进入交互提交（用于脚本/管道）"
+        )
+
+        parser.add_argument(
+            "-f", "--no-verify",
+            dest="no_verify",
+            action="store_true",
+            help="跳过 pre-commit / commit-msg 钩子（等价 git commit --no-verify）"
+        )
+
+        parser.add_argument(
+            "--version",
+            action="version",
+            version=f"%(prog)s {__version__}",
+            help="显示版本号并退出",
+        )
+
+        return parser.parse_args()
+
+    def _build_config(self) -> LLMConfig:
+        """构建 LLM 配置（环境变量 + 命令行覆盖）"""
+        config = LLMConfig()
+
+        # 命令行参数覆盖环境变量
+        if self.args.api_base:
+            config.api_base = self.args.api_base
+        if self.args.api_key:
+            config.api_key = self.args.api_key
+        if self.args.model:
+            config.model = self.args.model
+
+        return config
+
+
+def main():
+    """主入口函数"""
+    GCMApp().run()
+
+
+if __name__ == "__main__":
+    main()

git_gcm-2.0.1/gcm/git.py

@@ -0,0 +1,172 @@
+"""Git 操作工具模块"""
+
+import subprocess
+from dataclasses import dataclass
+from typing import ClassVar, Dict, List, Optional
+
+
+@dataclass
+class FileChange:
+    """文件变更信息"""
+    status: str  # A=新增, M=修改, D=删除, R=重命名
+    old_path: Optional[str]  # 旧路径（重命名时使用）
+    new_path: str  # 新路径
+
+    # 状态码 → 中文描述（类变量，非 dataclass 字段）
+    _STATUS_SYMBOLS: ClassVar[Dict[str, str]] = {
+        "A": "新增",
+        "M": "修改",
+        "D": "删除",
+        "R": "重命名",
+        "C": "复制",
+        "T": "类型变更",
+    }
+
+    @property
+    def symbol(self) -> str:
+        """状态对应的中文描述"""
+        return self._STATUS_SYMBOLS.get(self.status, self.status)
+
+    @property
+    def summary(self) -> str:
+        """变更摘要行，如 '- [新增] path' 或 '- [重命名] old -> new'"""
+        if self.status in ("R", "C") and self.old_path:
+            return f"- [{self.symbol}] {self.old_path} -> {self.new_path}"
+        return f"- [{self.symbol}] {self.new_path}"
+
+
+@dataclass
+class StagedChanges:
+    """暂存区变更信息"""
+    files: List[FileChange]
+    diff_content: str
+
+
+@dataclass
+class CommitResult:
+    """git commit 的执行结果"""
+    success: bool
+    stdout: str
+    stderr: str
+
+
+class GitRepo:
+    """封装对 Git 仓库的子进程操作"""
+
+    def __init__(self, path: str = "."):
+        self.path = path
+
+    def is_repo(self) -> bool:
+        """检查是否在 git 仓库中"""
+        try:
+            result = subprocess.run(
+                ["git", "rev-parse", "--is-inside-work-tree"],
+                capture_output=True,
+                text=True,
+                check=False,
+                cwd=self.path,
+            )
+            return result.returncode == 0 and result.stdout.strip() == "true"
+        except FileNotFoundError:
+            return False
+
+    def get_staged_changes(self, max_diff_lines: int = 500) -> StagedChanges:
+        """获取完整的暂存区变更信息
+
+        Args:
+            max_diff_lines: diff 内容最大行数限制，防止过长
+
+        Returns:
+            StagedChanges 对象
+        """
+        files = self._staged_files()
+        diff = self._staged_diff()
+
+        # 限制 diff 行数
+        if diff:
+            lines = diff.split("\n")
+            if len(lines) > max_diff_lines:
+                diff = "\n".join(lines[:max_diff_lines])
+                diff += f"\n\n... (truncated, {len(lines) - max_diff_lines} more lines)"
+
+        return StagedChanges(files=files, diff_content=diff)
+
+    def commit(self, message: str, no_verify: bool = False) -> CommitResult:
+        """执行 git commit
+
+        Args:
+            message: commit message
+            no_verify: 是否跳过 pre-commit / commit-msg 钩子（等价 --no-verify）
+
+        Returns:
+            CommitResult
+        """
+        cmd = ["git", "commit", "-m", message]
+        if no_verify:
+            cmd.append("--no-verify")
+
+        result = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+            check=False,
+            cwd=self.path,
+        )
+        return CommitResult(
+            success=result.returncode == 0,
+            stdout=result.stdout,
+            stderr=result.stderr,
+        )
+
+    def _staged_files(self) -> List[FileChange]:
+        """获取暂存区的文件列表"""
+        result = subprocess.run(
+            ["git", "diff", "--cached", "--name-status", "--diff-filter=ACDMRT"],
+            capture_output=True,
+            text=True,
+            check=False,
+            cwd=self.path,
+        )
+
+        if result.returncode != 0:
+            return []
+
+        files = []
+        for line in result.stdout.strip().split("\n"):
+            if not line:
+                continue
+
+            parts = line.split("\t")
+            status = parts[0][0]  # 取状态首字母
+
+            if status in ("R", "C"):
+                # 重命名/复制: status\told_path\tnew_path
+                files.append(FileChange(
+                    status=status,
+                    old_path=parts[1],
+                    new_path=parts[2]
+                ))
+            else:
+                # 其他: A/M/D\tpath
+                files.append(FileChange(
+                    status=status,
+                    old_path=None,
+                    new_path=parts[1]
+                ))
+
+        return files
+
+    def _staged_diff(self) -> str:
+        """获取暂存区的详细差异"""
+        result = subprocess.run(
+            ["git", "diff", "--cached"],
+            capture_output=True,
+            text=True,
+            check=False,
+            cwd=self.path,
+        )
+
+        if result.returncode != 0:
+            return ""
+
+        return result.stdout

git_gcm-2.0.1/gcm/interactive.py

@@ -0,0 +1,120 @@
+"""交互式提交模块（基于 questionary 的 TUI 交互）。
+
+封装生成 commit message 后的方向键菜单交互与提交。
+"""
+
+import sys
+
+import questionary
+from questionary import Style
+
+from gcm.git import GitRepo
+
+
+class InteractiveCommitter:
+    """生成 commit message 后的 TUI 交互与提交"""
+
+    # 自定义 TUI 配色：箭头与当前高亮项统一为青色
+    _STYLE = Style(
+        [
+            ("qmark", "fg:#5fd7ff bold"),
+            ("pointer", "fg:#5fd7ff bold"),
+            ("highlighted", "fg:#5fd7ff bold"),
+            ("selected", "fg:#5fd7ff"),
+            ("answer", "fg:#5fd7ff bold"),
+            ("instruction", "fg:#808080"),
+        ]
+    )
+
+    # 菜单选项（带 emoji，提升辨识度）
+    _CHOICE_COMMIT = "🍾 提交此 message"
+    _CHOICE_EDIT = "🚀 修改 message"
+    _CHOICE_PRINT = "📋 仅输出，不提交"
+
+    def __init__(self, repo: GitRepo, no_verify: bool = False):
+        self.repo = repo
+        self.no_verify = no_verify
+
+    def run(self, commit_msg: str) -> None:
+        """展示菜单，允许直接提交、修改后提交或仅输出。
+
+        每轮循环清屏后重新渲染 message 与菜单，避免修改时历史输出堆积。
+
+        Args:
+            commit_msg: 生成的初始 commit message
+        """
+        current = commit_msg
+        while True:
+            self._clear_screen()
+            self._show_message(current)
+
+            choice = questionary.select(
+                "请选择操作",
+                choices=[self._CHOICE_COMMIT, self._CHOICE_EDIT, self._CHOICE_PRINT],
+                qmark="🤖",
+                pointer="❯",
+                style=self._STYLE,
+                instruction="(↑↓ 选择, Enter 确认)",
+            ).ask()
+
+            # ESC / Ctrl-C → 取消
+            if choice is None:
+                self._clear_screen()
+                print("🚪 已取消。")
+                return
+
+            if choice == self._CHOICE_PRINT:
+                self._clear_screen()
+                print(current)
+                return
+
+            if choice == self._CHOICE_EDIT:
+                new_msg = questionary.text(
+                    "编辑 commit message（直接修改预填内容）",
+                    default=current,
+                    multiline=True,
+                    qmark="🚀",
+                    style=self._STYLE,
+                    instruction="(方向键移动光标，Alt+Enter 或 Esc→Enter 提交)\n",
+                ).ask()
+                # None: 取消编辑，保留原文；否则用编辑后的内容（未改即为原文）
+                if new_msg is not None:
+                    current = new_msg
+                continue
+
+            # _CHOICE_COMMIT：清屏后干净展示最终 message 并提交（无二次确认）
+            self._clear_screen()
+            self._show_message(current)
+            self._commit(current)
+            return
+
+    def _clear_screen(self) -> None:
+        """清屏并将光标移到左上角（ANSI 转义，现代终端通用）。"""
+        sys.stdout.write("\033[2J\033[H")
+        sys.stdout.flush()
+
+    def _show_message(self, commit_msg: str) -> None:
+        """展示当前的 commit message"""
+        print("📝 生成的 commit message：")
+        print("-" * 40)
+        print(commit_msg)
+        print("-" * 40)
+        if self.no_verify:
+            print("❗️ 已启用 -f/--no-verify：提交时将跳过 git hooks")
+
+    def _commit(self, commit_msg: str) -> None:
+        """执行 git commit 并打印结果。
+
+        提交失败时将 git 的错误信息输出到 stderr 并以非零状态码退出。
+        """
+        result = self.repo.commit(commit_msg, no_verify=self.no_verify)
+
+        if result.success:
+            if result.stdout:
+                print(result.stdout)
+            print("✅ 提交成功")
+        else:
+            print("❌ 提交失败：", file=sys.stderr)
+            if result.stderr:
+                print(result.stderr, file=sys.stderr)
+            sys.exit(1)

git_gcm-1.0.2/gcm/prompts.py → git_gcm-2.0.1/gcm/prompt.py

@@ -1,10 +1,12 @@
 """提示词模板模块"""
 
-from gcm.git_utils import StagedChanges, get_status_symbol
+from gcm.git import StagedChanges
 
 
-# 系统提示词
-SYSTEM_PROMPT = """你是一位专业的 Git 提交信息生成助手。你的任务是根据代码变更生成清晰、准确、符合规范的 commit message。
+class PromptBuilder:
+    """构建发送给大模型的系统/用户提示词"""
+
+    SYSTEM_PROMPT = """你是一位专业的 Git 提交信息生成助手。你的任务是根据代码变更生成清晰、准确、符合规范的 commit message。
 
 ## 输出规则
 
@@ -42,32 +44,31 @@ SYSTEM_PROMPT = """你是一位专业的 Git 提交信息生成助手。你的
 - 使用动词原形开头（如：添加、修复、更新、优化）
 - 简洁明了，避免冗余"""
 
+    def __init__(self, verbose: bool = False):
+        self.verbose = verbose
+
+    def system_prompt(self) -> str:
+        """系统提示词"""
+        return self.SYSTEM_PROMPT
 
-def build_user_prompt(changes: StagedChanges, verbose: bool = False) -> str:
-    """构建用户提示词
+    def user_prompt(self, changes: StagedChanges) -> str:
+        """根据暂存区变更构建用户提示词
 
-    Args:
-        changes: 暂存区变更信息
-        verbose: 是否使用详细模式
+        Args:
+            changes: 暂存区变更信息
 
-    Returns:
-        用户提示词字符串
-    """
-    if not changes.files:
-        return "暂存区没有任何变更。"
+        Returns:
+            用户提示词字符串
+        """
+        if not changes.files:
+            return "暂存区没有任何变更。"
 
-    # 构建文件变更摘要
-    file_summary = []
-    for file in changes.files:
-        status_text = get_status_symbol(file.status)
-        if file.status in ("R", "C") and file.old_path:
-            file_summary.append(f"- [{status_text}] {file.old_path} -> {file.new_path}")
-        else:
-            file_summary.append(f"- [{status_text}] {file.new_path}")
+        # 构建文件变更摘要
+        file_summary = [file.summary for file in changes.files]
 
-    # 构建提示词
-    mode = "详细" if verbose else "精简"
-    prompt = f"""请根据以下暂存区变更生成{mode}的 commit message。
+        # 构建提示词
+        mode = "详细" if self.verbose else "精简"
+        return f"""请根据以下暂存区变更生成{mode}的 commit message。
 
 ## 变更文件
 {chr(10).join(file_summary)}
@@ -78,10 +79,3 @@ def build_user_prompt(changes: StagedChanges, verbose: bool = False) -> str:
 ```
 
 请生成{mode}的 commit message："""
-
-    return prompt
-
-
-def get_system_prompt() -> str:
-    """获取系统提示词"""
-    return SYSTEM_PROMPT

{git_gcm-1.0.2 → git_gcm-2.0.1}/git_gcm.egg-info/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: git-gcm
-Version: 1.0.2
-Summary: Git Commit Message 自动生成工具
+Version: 2.0.1
+Summary: Write Git commits the smart way.
 Author-email: Luca <yangshaoxiong5545@gmail.com>
 License: MIT
 Project-URL: Homepage, https://github.com/falconluca/gcm
@@ -25,47 +25,63 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: openai>=1.0.0
 Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: questionary>=1.4.0
 Dynamic: license-file
 
 # GCM
 
 [![PyPI version](https://badge.fury.io/py/git-gcm.svg)](https://pypi.org/project/git-gcm/)
 
-基于大模型的 Git Commit Message 自动生成工具，支持所有 OpenAI 协议兼容的大模型服务
+基于大模型的 Git Commit Message 生成，支持所有 OpenAI 协议兼容的服务。
 
 ## 安装
 
 ```bash
-pip install git-gcm
+# Mac 用户先装 pipx
+brew install pipx && pipx ensurepath
+
+pipx install git-gcm
 ```
 
-## 配置
+升级：`pipx upgrade git-gcm`
 
-设置环境变量：
+## 配置
 
 ```bash
-export GCM_API_KEY="your-api-key"
-export GCM_API_URL="https://api.openai.com/v1"
-export GCM_MODEL="gpt-4o-mini"
+export GCM_API_URL=https://api.openai.com/v1
+export GCM_API_KEY=your-api-key
+export GCM_MODEL=gpt-4o-mini
 ```
 
+持久化写入 `~/.zshrc` / `~/.bashrc` 后 `source` 一下。
+
 ## 使用
 
 ```bash
 git add .
-gcm           # 生成精简 commit message
-gcm -v        # 生成详细 commit message
+gcm              # 生成 commit message 并进入交互菜单
+gcm -v           # 详细模式
+gcm -f           # 跳过 git hooks（等价 --no-verify）
+gcm --print-only # 仅输出，不提交
 ```
 
+生成后进入交互菜单（↑↓ 选择，Enter 确认）：
+
+- **提交** — 直接 `git commit`
+- **编辑** — 微调 message，Alt/⌥+Enter 保存
+- **仅输出** — 只打印不提交
+
+> 非交互终端（如 `gcm | cat`）自动跳过菜单，直接输出。
+
 ## 示例
 
-**精简模式：**
+精简模式：
 
 ```
 feat(auth): 添加用户登录功能
 ```
 
-**详细模式 (`-v`)：**
+详细模式（`-v`）：
 
 ```
 feat(auth): 添加用户登录功能

{git_gcm-1.0.2 → git_gcm-2.0.1}/git_gcm.egg-info/SOURCES.txt

@@ -3,9 +3,10 @@ README.md
 pyproject.toml
 gcm/__init__.py
 gcm/cli.py
-gcm/git_utils.py
-gcm/llm_client.py
-gcm/prompts.py
+gcm/git.py
+gcm/interactive.py
+gcm/llm.py
+gcm/prompt.py
 git_gcm.egg-info/PKG-INFO
 git_gcm.egg-info/SOURCES.txt
 git_gcm.egg-info/dependency_links.txt

{git_gcm-1.0.2 → git_gcm-2.0.1}/git_gcm.egg-info/requires.txt

@@ -1,2 +1,3 @@
 openai>=1.0.0
 python-dotenv>=1.0.0
+questionary>=1.4.0

{git_gcm-1.0.2 → git_gcm-2.0.1}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "git-gcm"
-version = "1.0.2"
-description = "Git Commit Message 自动生成工具"
+version = "2.0.1"
+description = "Write Git commits the smart way."
 readme = "README.md"
 license = { text = "MIT" }
 requires-python = ">=3.8"
@@ -26,7 +26,7 @@ classifiers = [
     "Topic :: Software Development :: Version Control :: Git",
     "Topic :: Utilities",
 ]
-dependencies = ["openai>=1.0.0", "python-dotenv>=1.0.0"]
+dependencies = ["openai>=1.0.0", "python-dotenv>=1.0.0", "questionary>=1.4.0"]
 
 [project.scripts]
 gcm = "gcm.cli:main"

git_gcm-1.0.2/README.md

@@ -1,49 +0,0 @@
-# GCM
-
-[![PyPI version](https://badge.fury.io/py/git-gcm.svg)](https://pypi.org/project/git-gcm/)
-
-基于大模型的 Git Commit Message 自动生成工具，支持所有 OpenAI 协议兼容的大模型服务
-
-## 安装
-
-```bash
-pip install git-gcm
-```
-
-## 配置
-
-设置环境变量：
-
-```bash
-export GCM_API_KEY="your-api-key"
-export GCM_API_URL="https://api.openai.com/v1"
-export GCM_MODEL="gpt-4o-mini"
-```
-
-## 使用
-
-```bash
-git add .
-gcm           # 生成精简 commit message
-gcm -v        # 生成详细 commit message
-```
-
-## 示例
-
-**精简模式：**
-
-```
-feat(auth): 添加用户登录功能
-```
-
-**详细模式 (`-v`)：**
-
-```
-feat(auth): 添加用户登录功能
-
-- 实现 JWT token 认证
-- 添加登录表单验证
-- 集成第三方 OAuth 登录
-```
-
-MIT License

git_gcm-1.0.2/gcm/cli.py

@@ -1,179 +0,0 @@
-"""命令行入口模块"""
-
-import argparse
-import sys
-import os
-from pathlib import Path
-from typing import Optional
-
-from dotenv import load_dotenv
-
-from gcm import __version__
-from gcm.git_utils import (
-    is_git_repo,
-    get_staged_changes,
-    StagedChanges
-)
-from gcm.prompts import build_user_prompt, get_system_prompt
-from gcm.llm_client import LLMClient, LLMConfig
-
-
-def find_env_file() -> Optional[Path]:
-    """查找 .env 文件
-
-    查找顺序:
-    1. 当前目录的 .env
-    2. 父目录（向上查找直到 git 根目录）
-    3. 用户主目录的 .env
-    """
-    # 当前目录
-    env_path = Path.cwd() / ".env"
-    if env_path.exists():
-        return env_path
-
-    # 向上查找直到 git 根目录
-    current = Path.cwd()
-    while current != current.parent:
-        current = current.parent
-        env_path = current / ".env"
-        if env_path.exists():
-            return env_path
-        # 如果找到 .git 目录就停止
-        if (current / ".git").exists():
-            break
-
-    # 用户主目录
-    env_path = Path.home() / ".env"
-    if env_path.exists():
-        return env_path
-
-    return None
-
-
-def load_env_files():
-    """加载 .env 文件"""
-    # 加载用户主目录的 .env（优先级较低）
-    home_env = Path.home() / ".env"
-    if home_env.exists():
-        load_dotenv(home_env)
-
-    # 加载项目目录的 .env（优先级较高）
-    project_env = find_env_file()
-    if project_env:
-        load_dotenv(project_env)
-
-
-def parse_args() -> argparse.Namespace:
-    """解析命令行参数"""
-    parser = argparse.ArgumentParser(
-        prog="gcm",
-        description="自动生成 Git Commit Message"
-    )
-
-    parser.add_argument(
-        "-v", "--verbose",
-        action="store_true",
-        help="生成详细的 commit message"
-    )
-
-    parser.add_argument(
-        "--api-base",
-        type=str,
-        help="API 基础 URL（覆盖 GCM_API_URL）"
-    )
-
-    parser.add_argument(
-        "--api-key",
-        type=str,
-        help="API Key（覆盖 GCM_API_KEY，不推荐在命令行中使用）"
-    )
-
-    parser.add_argument(
-        "-m", "--model",
-        type=str,
-        help="使用的模型名称（覆盖 GCM_MODEL）"
-    )
-
-    parser.add_argument(
-        "--version",
-        action="version",
-        version=f"%(prog)s {__version__}"
-    )
-
-    return parser.parse_args()
-
-
-def generate_commit_message(
-    changes: StagedChanges,
-    client: LLMClient,
-    verbose: bool = False
-) -> str:
-    """生成 commit message
-
-    Args:
-        changes: 暂存区变更
-        client: LLM 客户端
-        verbose: 是否详细模式
-
-    Returns:
-        生成的 commit message
-    """
-    system_prompt = get_system_prompt()
-    user_prompt = build_user_prompt(changes, verbose=verbose)
-
-    return client.chat(system_prompt, user_prompt)
-
-
-def main():
-    """主入口函数"""
-    # 加载 .env 文件
-    load_env_files()
-
-    args = parse_args()
-
-    # 检查是否在 git 仓库中
-    if not is_git_repo():
-        print("错误: 当前目录不在 Git 仓库中", file=sys.stderr)
-        sys.exit(1)
-
-    # 获取暂存区变更
-    changes = get_staged_changes()
-
-    if not changes.files:
-        print("暂存区没有变更。请先使用 'git add' 添加变更。", file=sys.stderr)
-        sys.exit(1)
-
-    # 创建配置（从环境变量加载）
-    config = LLMConfig()
-
-    # 命令行参数覆盖环境变量
-    if args.api_base:
-        config.api_base = args.api_base
-    if args.api_key:
-        config.api_key = args.api_key
-    if args.model:
-        config.model = args.model
-
-    # 创建 LLM 客户端
-    client = LLMClient(config)
-
-    # 生成 commit message
-    try:
-        commit_msg = generate_commit_message(
-            changes,
-            client,
-            verbose=args.verbose
-        )
-    except ValueError as e:
-        print(f"配置错误: {e}", file=sys.stderr)
-        sys.exit(1)
-    except RuntimeError as e:
-        print(f"生成失败: {e}", file=sys.stderr)
-        sys.exit(1)
-
-    # 输出结果
-    print(commit_msg)
-
-
-if __name__ == "__main__":
-    main()

git_gcm-1.0.2/gcm/git_utils.py

@@ -1,130 +0,0 @@
-"""Git 操作工具模块"""
-
-import subprocess
-from dataclasses import dataclass
-from typing import List, Optional
-from pathlib import Path
-
-
-@dataclass
-class FileChange:
-    """文件变更信息"""
-    status: str  # A=新增, M=修改, D=删除, R=重命名
-    old_path: Optional[str]  # 旧路径（重命名时使用）
-    new_path: str  # 新路径
-
-
-@dataclass
-class StagedChanges:
-    """暂存区变更信息"""
-    files: List[FileChange]
-    diff_content: str
-
-
-def is_git_repo() -> bool:
-    """检查当前目录是否在 git 仓库中"""
-    try:
-        result = subprocess.run(
-            ["git", "rev-parse", "--is-inside-work-tree"],
-            capture_output=True,
-            text=True,
-            check=False
-        )
-        return result.returncode == 0 and result.stdout.strip() == "true"
-    except FileNotFoundError:
-        return False
-
-
-def get_staged_files() -> List[FileChange]:
-    """获取暂存区的文件列表"""
-    result = subprocess.run(
-        ["git", "diff", "--cached", "--name-status", "--diff-filter=ACDMRT"],
-        capture_output=True,
-        text=True,
-        check=False
-    )
-
-    if result.returncode != 0:
-        return []
-
-    files = []
-    for line in result.stdout.strip().split("\n"):
-        if not line:
-            continue
-
-        parts = line.split("\t")
-        status = parts[0][0]  # 取状态首字母
-
-        if status == "R":
-            # 重命名: R\told_path\tnew_path
-            files.append(FileChange(
-                status=status,
-                old_path=parts[1],
-                new_path=parts[2]
-            ))
-        elif status == "C":
-            # 复制: C\told_path\tnew_path
-            files.append(FileChange(
-                status=status,
-                old_path=parts[1],
-                new_path=parts[2]
-            ))
-        else:
-            # 其他: A/M/D\tpath
-            files.append(FileChange(
-                status=status,
-                old_path=None,
-                new_path=parts[1]
-            ))
-
-    return files
-
-
-def get_staged_diff() -> str:
-    """获取暂存区的详细差异"""
-    result = subprocess.run(
-        ["git", "diff", "--cached"],
-        capture_output=True,
-        text=True,
-        check=False
-    )
-
-    if result.returncode != 0:
-        return ""
-
-    return result.stdout
-
-
-def get_staged_changes(max_diff_lines: int = 500) -> StagedChanges:
-    """获取完整的暂存区变更信息
-
-    Args:
-        max_diff_lines: diff 内容最大行数限制，防止过长
-
-    Returns:
-        StagedChanges 对象
-    """
-    files = get_staged_files()
-    diff = get_staged_diff()
-
-    # 限制 diff 行数
-    if diff:
-        lines = diff.split("\n")
-        if len(lines) > max_diff_lines:
-            diff = "\n".join(lines[:max_diff_lines])
-            diff += f"\n\n... (truncated, {len(lines) - max_diff_lines} more lines)"
-
-    return StagedChanges(files=files, diff_content=diff)
-
-
-def get_status_symbol(status: str) -> str:
-    """获取状态对应的符号/描述"""
-    symbols = {
-        "A": "新增",
-        "M": "修改",
-        "D": "删除",
-        "R": "重命名",
-        "C": "复制",
-        "T": "类型变更"
-    }
-    return symbols.get(status, status)