Jia-Ethan/grok-keysmith

解決的問題

grok-keysmith 是專為 Grok Build 設計的部署工具，用於安全地管理自訂指令（主頁規則）。它讓使用者能在不手動編輯 AGENTS.md 等關鍵檔案的情況下，安全地部署、驗證並還原全域設定的變更。

工作原理

此工具透過管理 ~/.grok 目錄內的特定檔案來運作。它將一個 Markdown 檔案部署為 ~/.grok/rules/99-keysmith.md，以便新 Grok 會話載入這些規則。為確保穩定性，它會在 config.toml 中注入相容性隔離區塊，並透過將 ~/.grok/hooks/*.json 目錄重命名為 .json.disabled 來停用現有的鈎子。

它採用「先預覽」的作法，需明確指定 --yes 標誌才會將任何變更寫入磁碟。同時也提供機制來協調設定漂移、還原鈎子，以及完全卸載已部署的規則。

適用對象

希望透過自訂指令來客製化 AI 代理全域行為，同時維持備份與安全回滾機制的 Grok Build 開發者與進階使用者。

主要特色

• 安全部署：在寫入磁碟前進行預覽執行（dry-run）。
• 非破壞性：不修改 AGENTS.md，並為被取代的檔案建立備份。
• 設定管理：處理 config.toml 的隔離與鈎子停用，防止衝突。
• 可逆操作：提供專用指令以還原鈎子並完全卸載部署。
• 跨平台支援：支援 macOS、Linux 與 Windows（Python 3.8+）。
• 會話腳本：包含 run --session-script 功能，可將多輪對話輸入至單一 Grok 會話中。