astro:gate — 閘門規則編輯器
在瀏覽器中啟動 mini-app ai-gate/(SQLite + Web UI),用來編輯閘門用於阻擋禁止指令的規則。它是 astro:setup(負責安裝閘門)的可編輯對應部分。
步驟 1 — 確認閘門已安裝
- 需要在專案根目錄存在
ai-gate/app.py。如果不存在,請先執行astro:setup(它會安裝ai-gate/並產生閘門)。
步驟 2 — 啟動應用程式
- 執行
python3 ai-gate/app.py(預設連接埠 8787;如果被佔用,請使用--port N)。伺服器位址為本機 (127.0.0.1),並會保持執行狀態 — 請在背景啟動,以免阻塞工作階段。 - 在瀏覽器中開啟
http://127.0.0.1:8787(如果環境中有內建瀏覽器,請在該處開啟;否則,將 URL 提供給使用者)。
步驟 3 — 編輯與生成
- 在 UI 中:新增 / 編輯 / 停用 / 移除規則(支援正規表示式或純文字比對)。
- 點擊 「生成閘門」 以使用作用中的規則重新寫入
.claude/hooks/astro_gate.py。SQLite (ai-gate/rules.db) 是真理來源;腳本是生成的產物 — 請勿手動編輯。 - 完成後,停止伺服器(在程序上按 Ctrl+C)。
生成的
astro_gate.py是獨立腳本(規則內嵌),因此也可以在 VM/CI 中以 CLI 方式執行:python3 astro_gate.py "$CMD" && eval "$CMD"。