astro:gate — gate 规则编辑器
在浏览器中启动 ai-gate/ 迷你应用(SQLite + Web UI),编辑 gate 用于拦截禁止命令的规则。它是 astro:setup(用于安装 gate)的可编辑对应组件。
第一步 — 确认 gate 已安装
- 项目根目录必须存在
ai-gate/app.py。如果不存在,请先运行astro:setup(它会安装ai-gate/并生成 gate)。
第二步 — 启动应用
- 运行
python3 ai-gate/app.py(默认端口 8787;如果端口被占用,使用--port N)。服务器监听127.0.0.1并保持运行 — 请在后台启动,以免阻塞当前会话。 - 在浏览器中打开
http://127.0.0.1:8787(如果环境有内置浏览器,在其中打开;否则,将 URL 提供给用户)。
第三步 — 编辑与生成
- 在 UI 中:添加 / 编辑 / 禁用 / 删除规则(支持正则或文本字面量)。
- 点击 生成 gate 以使用当前启用的规则重写
.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"。