IntelliShell

✨ IntelliShell：你的智能终端伙伴！

告别繁琐的命令行操作，IntelliShell 是你终端中的智能助手，让复杂命令变得轻而易举！它能帮你轻松管理、查找、生成甚至修复各种命令，显著提升你的工作效率。

---

💡 核心功能一览

• 命令收藏与查找： 🚀 轻松保存你常用的命令模板，随时随地快速调用。

  使用 ctrl+space 快捷键，即可搜索你的个人命令库，无需记忆繁杂指令。

• 动态补全： ⚡️ 通过智能建议，加速你的输入，减少错误。

  输入过程中，IntelliShell 会为你提供上下文相关的动态补全，让你的终端操作如行云流水。

• AI 命令生成： 🤖 将自然语言转化为精确的命令行指令。

  只需用日常语言描述你的需求，AI 就能帮你生成复杂的命令，例如：

  “帮我查找最近一周内所有修改过的 Python 文件，并按大小排序。”

  IntelliShell 能将这类描述转化为可执行的命令。

• 命令修复： 🩹 智能纠正你输入的命令错误。

  如果你的命令有小错误，IntelliShell 可能会智能识别并给出修改建议，省去你排查问题的时间。

---

🎯 体验 IntelliShell：快速上手

准备好让你的终端焕然一新了吗？只需几个简单的步骤，即可开始你的智能命令行之旅！

1. 安装：通过 pip 即可快速安装。

   pip install git-quick

   或者，你也可以从源代码安装：

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

2. AI 配置（推荐）：选择你喜欢的 AI 提供商。
   • Ollama (本地 & 免费) ：

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

     安装后，IntelliShell 将默认使用 Ollama。

   • OpenAI ：

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

   • 跳过 AI：如果你不想使用 AI 功能，可以在命令中添加 --no-ai 标记。
3. 开始使用！在一个 Git 仓库中，做一些修改，然后运行 gq：

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

   你会看到由 AI 生成的提交信息，并可以确认或编辑它，然后自动提交并推送。

---

🌟 不仅仅是 AI 提交

IntelliShell 功能强大，远不止于智能提交：

• gq story：以美观的格式展示你的提交历史。

  gq story --group-by type

  你可以按类型、作者等多种方式分组，甚至导出为 Markdown 格式的 CHANGELOG。

• gq time：轻松跟踪你在不同分支上花费的时间。

  gq time start
  gq time report --all

  准确记录你的开发投入，帮助你更好地管理项目。

• gq sync：一键同步所有本地分支与远程仓库。

  gq sync

  保持所有分支最新，省去手动操作的麻烦。

• VS Code 扩展：与你常用的编辑器无缝集成。
  • 快捷键：Ctrl+Shift+G Q 快速提交 & 推送。
  • Ctrl+Shift+G M 生成 AI 提交信息。
  • 在命令面板和源代码控制视图中均可使用。

---

⚙️ 深度定制与自动化

IntelliShell 提供了丰富的配置选项，让你能根据习惯进行个性化设置，并能轻松地融入你的自动化工作流：

• 项目级配置：在项目根目录创建 .gitquick.toml 文件，即可为特定项目设置专属配置，例如：

  [quick]
  emoji_style = "none"
  conventional_commits = true
  auto_push = false # 团队偏好手动推送

• 强大的自动化能力：

  将 IntelliShell 命令整合到你的脚本、Git Hooks 甚至 GitHub Actions 中，实现更高级的自动化。

  想象一下，每天自动提交项目进度，或者在切换分支时自动开始时间跟踪，IntelliShell 都能帮你实现！

---

💖 源于热爱，服务开发

IntelliShell 由开发者为开发者而生，旨在让你的 Git 工作流更智能、更高效。我们欢迎您的加入，共同改进这款工具！

• 报告 Bug：请访问 GitHub Issues。
• 获取帮助：在 Discussions 中提问。

许可：MIT License - 欢迎自由使用、学习和修改。