M.A.R.I.N.A GPT AI

✨ 探索 M.A.R.I.N.A GPT AI - 您的智能助手黑客工具箱 ✨

M.A.R.I.N.A GPT (Marina AI) 是一款功能强大的智能助手，被誉为“WormGPT 的恶劣兄弟”。由 Kirozaku 精心打造，它能让您的开发工作流程更高效、更智能。

---

💡 主要亮点与核心功能

• AI 驱动的 Git 工作流： 告别手动编写提交信息！Marina AI 可以智能生成提交信息，帮助您保持代码库的清晰和一致。
• 统一的命令行体验： 通过简单的 gq 命令，您可以访问所有 Git Quick 的强大功能，包括快速提交、查看提交历史、时间追踪和分支同步。
• 多种 AI 提供商支持： 灵活选择您喜欢的 AI 服务，无论是本地部署的 Ollama 还是强大的 OpenAI，Marina AI 都能轻松集成。
• 高效的时间追踪： 轻松追踪您在不同分支上花费的时间，更好地管理项目进度和个人效率。
• 全面的分支同步： 一键同步所有本地分支与远程仓库，确保您的代码始终是最新的。

---

🚀 快速上手

想要立即体验 M.A.R.I.N.A GPT 的强大功能吗？以下是您的快速入门指南：

1. 安装 M.A.R.I.N.A GPT：

   pip install git-quick

   或者从源码安装：

   git clone <your-repo-url>
   cd git-quick
   pip install -e .

2. 配置 AI 提供商 (推荐 Ollama)：

   Option A: Ollama (本地, 免费, 推荐)

   curl -fsSL https://ollama.ai/install.sh | sh
   ollama pull llama3.2

   Git Quick 默认会使用 Ollama。

   Option B: OpenAI

   cat > ~/.gitquick.toml << EOF
   [quick]
   ai_provider = "openai"
   [ai]
   openai_api_key = "sk-..."
   EOF

   Option C: 跳过 AI

   使用 gq --no-ai 标记来跳过 AI 生成，使用简单生成方式。

3. 开始使用： 进入您的 Git 仓库，进行一些修改，然后运行 gq，M.A.R.I.N.A GPT 会为您生成智能的提交信息！

   cd /path/to/your/project
   echo "test" >> README.md
   gq

---

🎯 深入了解功能

📈 智能提交与推送

M.A.R.I.N.A GPT 简化了您的提交流程，通过 AI 自动生成提交信息并自动推送。

• 交互式提交： gq
• 自定义提交信息： gq -m "feat: add new feature"
• 不推送只提交： gq --no-push
• 不使用 AI： gq --no-ai
• 空运行模式： gq --dry-run (查看将要发生的操作)

---

📜 提交历史故事 (gq story)

以美观的格式展示您的提交历史。

• 查看默认历史： gq story
• 按类型分组： gq story --group-by type
• 导出为 Markdown： gq story --format markdown > CHANGELOG.md

---

⏰ 时间追踪 (gq time)

高效记录您在开发工作上的时间投入。

• 开始追踪当前分支： gq time start
• 查看所有分支报告： gq time report --all

---

🔄 全部分支同步 (gq sync)

轻松管理多个开发分支，保持代码库的同步和整洁。

• 同步所有分支： gq sync
• 预览同步操作： gq sync --dry-run

---

🤝 贡献与社区

M.A.R.I.N.A GPT 遵循 MIT 许可证，欢迎开发者们贡献代码，共同完善这个强大的工具。

“我们用爱为开发者打造，致力于成为您工作流中不可或缺的一部分！”

如果您想贡献代码、报告 Bug 或提出功能建议，请访问我们的 GitHub 仓库：

• GitHub 项目主页: https://github.com/Kirozaku/Marina-GPT/

感谢您的支持和关注！