git-fire

git-fire 是什麼？

git-fire 是一款用於跨多個 Git 倉庫的倉庫生命週期管理命令列工具。其核心目的是讓你以一致的工作流程「檢查點」多個倉庫：它能發現倉庫、可選自動提交髒變更，並以安全防護推送備份分支/遠端，確保本地專屬工作不遺失。

此專案適用於需要可靠、可稽核的多倉庫移動情境—例如需要一致復原路徑，並避免手動推送迴圈可能失敗（例如網路中斷、認證問題或 shell 錯誤）。專案目前處於 beta 階段。

主要功能

• 一指令多倉庫檢查點：自動發現倉庫，執行備份導向推送序列，而非逐倉庫手動步驟。
• 可選自動提交髒工作：啟用時從本地變更建立提交（預設工作流程為自動提交髒工作，除非停用）。
• 備份分支/遠端推送：作為檢查點一部分推送備份分支/遠端，讓工作有可復原位置。
• 安全防護與可稽核復原路徑：設計提供跨多倉庫一致、可檢視的復原移動。
• 乾跑預覽模式：透過 --dry-run 支援「先預覽（安全）」方式，觀察工具將執行的動作。
• 緊急一列啟動腳本模式：描述「緊急啟動腳本」路徑，用於緊急情境，先檢查 scripts/emergency.sh。
• TUI 與設定行為：倉庫文件包含 TUI（附截圖與「色彩設定檔」）及專屬「設定與行為」章節。

如何使用 git-fire

1. 使用文件所述方法安裝 git-fire：Homebrew (macOS/Linuxbrew)、WinGet (Windows)、Linux 安裝腳本、原生 Linux 套件 (.deb/.rpm) 或 Go 安裝。
2. （建議）先預覽變更：執行 git-fire --dry-run --path ~/projects 檢視檢查點行為，不執行備份推送。
3. 執行預設檢查點工作流程：執行 git-fire 進行倉庫 README 所述標準多倉庫串流檢查點。
4. 緊急情境下，僅檢查 scripts/emergency.sh 後使用緊急啟動腳本，並優先使用發行資產與校驗和。

注意：專案指出當 git-fire 在 PATH 上時，git-fire 與 git fire 等效。

使用情境

• 高風險變更前多倉庫備份： 使用 git-fire 以一致工作流程檢查點多倉庫，而非重複逐倉庫推送步驟。
• 單一預期動作復原認證/網路問題： 當手動推送迴圈易錯時，使用 git-fire 備份導向流程建立跨倉庫可稽核、可復原檢查點。
• 工作區子集檢查點： 使用 --path 鎖定目錄（範例：--dry-run --path ~/projects）來範圍多倉庫操作。
• 無法等待標準安裝的緊急啟動： 遵循「火警時」方式啟動緊急路徑，使用文件所示命令中的 RELEASE_TAG。
• 團隊標準化倉庫生命週期步驟： 使用 git-fire 文件核心承諾與安全防護，維持跨環境多倉庫檢查點程序一致。

常見問題

• git-fire 適合正式環境嗎？ 專案明確標示為 beta 軟體。核心多倉庫備份流程現已可用，但部分路線圖項目尚未實作（例如 --backup-to 與 USB 目的地模式）。

• 能否在變更前預覽 git-fire 動作？ 可以。README 顯示 git-fire --dry-run --path ~/projects 作為「先預覽（安全）」步驟。

• 緊急啟動如何運作？ README 提供一列命令，從倉庫指定 RELEASE_TAG 下載並執行 scripts/emergency.sh。建議先檢查 scripts/emergency.sh，並提及 curl | bash 直接執行遠端程式碼。

• 有哪些安裝方法？ README 列出 Homebrew、WinGet、Linux 安裝腳本、Linux 原生套件 (.deb/.rpm)、Go 安裝及 GitHub Releases 二進位檔案。

• 「一指令」包含什麼？ 文件核心承諾為發現倉庫、自動提交髒工作（除非停用）並推送備份，確保本地專屬工作不遺失。

替代方案

• 標準 Git 工作流程搭配單倉庫腳本： 你可以自行撰寫 shell 迴圈來包裝 git status、git commit 和 git push，但這會將一致性和錯誤處理的負擔轉移到你身上—這正是 git-fire 旨在減少的失敗模式。
• 通用多倉庫 Git 工具（倉庫管理實用程式）： 這些工具或許有助於遍歷多個倉庫，但 git-fire 特別針對檢查點功能設計，包含備份分支/遠端及所述安全防護。
• 手動逐倉庫建立備份分支： 這很直接，但處理多倉庫時容易繁瑣且出錯，尤其在認證或網路問題發生時。
• 支援批次操作的 GUI Git 客戶端： 有些客戶端提供跨倉庫的批次動作，但 README 強調的緊急啟動、dry-run 預覽及一致可稽核檢查點流程，可能與 GUI 導向工作流程有所不同。