BatterGit

🚀 Git 新手的智慧上手工具 — 讓你從安裝到 Push 只需按幾個按鈕

✨ 特色

• 🎯 新手友善 — 全中文介面，專有名詞附帶說明
• ⚡ 一鍵操作 — 告別複雜的 Git 指令
• 🔧 自動設定 — 偵測並設定 Git 使用者資訊
• 📝 智能 .gitignore — 依專案類型自動生成
• 🔗 GitHub 整合 — 一鍵建立遠端 repository
• 📊 同步建議 — 顯示 ahead/behind 狀態並給予建議
• 🎨 差異預覽 — 彩色顯示檔案變更（綠色新增、紅色刪除）
• 🔒 安全設計 — Token 自動過濾，不會外洩到日誌
• ❓ 說明按鈕 — 不懂的術語點「?」就有解釋

📸 截圖

啟動 GUI 後，你會看到：

• 首頁 — 功能總覽與智能建議
• Git 設定 — 偵測並設定 user.name / email
• 專案管理 — 選擇資料夾、初始化、生成 .gitignore
• GitHub 連結 — 建立或連結遠端 Repository
• 推送變更 — Commit + Push，支援強制推送
• 狀態檢視 — 彩色差異預覽、檔案暫存管理

📦 安裝

下載執行檔（推薦）

前往 Releases 下載最新版本：

檔案	說明
BatterGit.exe	GUI 版本（無主控台視窗）

從原始碼編譯

# Clone 專案
git clone https://github.com/him6794/battergit.git
cd battergit

# 安裝依賴
go mod tidy

# 編譯 GUI 版本（無主控台）
go build -ldflags "-H windowsgui -s -w" -o BatterGit.exe .

🚀 快速開始

圖形化介面（推薦）

直接雙擊 BatterGit.exe 即可啟動。

程式會自動：

1. ✅ 檢測 Git 是否安裝
2. ✅ 載入已儲存的設定
3. ✅ 智能建議下一步操作

使用流程

1. 設定 Git — 填入使用者名稱和 Email
2. 選擇專案 — 選擇要管理的資料夾
3. 初始化 — 建立 Git repository 和 .gitignore
4. 連結 GitHub — 輸入 Token 連結遠端
5. 推送 — 輸入訊息，一鍵 Commit + Push

🔧 GitHub Token 設定

1. 前往 GitHub Settings > Developer settings > Personal access tokens
2. 點擊 "Generate new token (classic)"
3. 勾選 repo 權限
4. 複製產生的 token 貼到程式中

📁 專案結構

battergit/
├── main.go              # 程式入口
├── build.ps1            # Release 編譯腳本
├── cmd/                 # CLI 指令
├── gui/                 # 圖形化介面
│   ├── app.go           # 主應用程式、說明系統
│   ├── home.go          # 首頁
│   ├── setup.go         # Git 設定畫面
│   ├── project.go       # 專案管理畫面
│   ├── github.go        # GitHub 連結畫面
│   ├── push.go          # 推送畫面（含強制推送）
│   ├── status.go        # 狀態檢視（彩色差異）
│   └── theme.go         # 中文主題
├── pkg/                 # 核心套件
│   ├── checker/         # Git 安裝檢測
│   ├── config/          # Git 設定操作
│   ├── gitops/          # Git 操作封裝
│   ├── github/          # GitHub API
│   ├── ignore/          # .gitignore 模板
│   ├── logger/          # 日誌系統
│   └── storage/         # Token 儲存
└── release/             # 編譯輸出

🛠 技術棧

• 語言: Go 1.21+
• GUI 框架: Fyne v2.4
• GitHub API: go-github
• 平台: Windows（macOS/Linux 理論上可編譯）

🗺 Roadmap

• 圖形化介面 (Fyne)
• Git 設定偵測與設定
• 專案初始化
• .gitignore 生成器
• GitHub 遠端連結
• 一鍵 Commit + Push
• 同步狀態檢測
• 彩色差異預覽
• 中文介面
• 說明按鈕系統
• 強制推送功能
• 錯誤日誌記錄
• 隱藏 CMD 視窗
• 分支管理介面
• 衝突可視化編輯器
• 分支圖視覺化
• 自動更新功能

📄 License

MIT License - 詳見 LICENSE

🤝 Contributing

歡迎提交 Issue 和 Pull Request！ 覺得還不錯的話，請給個 Star ⭐️ 支持我們。

---

Made with ❤️ for Git beginners