gyti

✨ gyti: 告别手动，智能撰写 Git 提交信息！

厌倦了为每次代码提交撰写繁琐、千篇一律的提交信息吗？gyti 将成为您的得力助手！它是一款智能 CLI 工具，能自动根据您的暂存更改生成符合规范的 Git 提交信息，让您的开发流程更加顺畅高效。

---

💡 产品亮点一览

• 告别手动撰写： gyti 深度分析您的代码变更，智能生成准确、专业的提交信息。
• 无缝集成： 作为 CLI 工具，gyti 与您的 Git 工作流完美融合，不打断您的开发节奏。
• 灵活配置： 支持多种后端模式（官方或自托管），并可自定义 API 密钥、日志输出等。
• 智能增强： 即使您提供一个草稿，gyti 也能将其润色，生成更具描述性的信息。

---

🚀 轻松上手，两步搞定！

1. 全局安装：

   npm install -g gyti

2. 运行设置： (自动配置、认证并安装 Git Hook)

   gyti setup

🎉 就这么简单！现在，您可以像往常一样使用 git commit，gyti 会自动为您生成完美的提交信息。

---

🎯 核心功能详解

✍️ 智能提交信息生成

gyti 的核心优势在于其强大的 AI 能力，能够理解您的代码意图，并生成语义化、结构化的提交信息。

• 只需 git add . 然后 git commit，gyti 即可自动完成信息撰写。
• 您也可以使用 git commit -m "."，gyti 会将其替换为生成的提交信息。

示例：

git add src/components/Button.tsx

git commit

输出： feat: add Button component with variants

✨ 提交信息交互式优化 (Interactive Refinement)

gyti 不仅仅是生成，它还能帮您优化！即使您提供一个简短的草稿，gyti 也能将其扩展为更详尽、更符合规范的提交信息。

示例：

git commit -m "fix bug"

gyti 将其增强为：

fix: resolve authentication error in login flow
- Handle expired token refresh
- Add proper error handling

此功能默认开启，您也可以通过 gyti config --no-interactive 来关闭。

⚙️ 灵活配置与自托管

gyti 提供了丰富的配置选项，满足不同用户的需求。

• 后端选择：
  • 使用 gyti 官方推荐的后端服务。
  • 自托管模式： 支持 OpenAI (GPT), Anthropic (Claude), Ollama (本地模型), Groq 等多种 AI 提供商，甚至兼容自定义 OpenAI API。
• API 密钥管理： securely 存储您的 API 密钥。
• 跳过 AI 生成： 可通过 gyti config --skip-ai 全局跳过 AI，或使用环境变量 GYTI_SKIP=true git commit 针对单次提交跳过。
• 详细日志： 开启 gyti config --verbose 获取更详细的运行日志，便于调试。

🛡️ 身份验证

如果您使用 gyti 官方后端，可以通过简单的 gyti login 命令进行认证，支持邮件/密码或 OAuth (GitHub, Google) 登录。

需要退出时，使用 gyti logout 即可。

---

トラブルシューティング (常见问题解决)

• Hook 未运行？ 确保您在仓库中运行过 gyti install。
• API 连接错误/超时？
  • 检查您的网络连接。
  • 验证您的后端服务是否正常运行。
  • 开启 verbose 模式 (GYTI_VERBOSE=true git commit) 获取详细错误信息。
• 如何卸载？ 要从仓库中移除 gyti，只需删除 Git Hook 文件： rm .git/hooks/prepare-commit-msg。

---

💖 来自 gyti 的问候

我们致力于让您的开发体验更加流畅和愉快。gyti 希望能成为您日常开发中的一个小小但强大的助力，让您把更多精力投入到真正的代码创造中！

访问 gyti.ai 了解更多详细信息。