用途
ThumbGate 是面向 AI 编程智能体的本地优先 Pre-Action Checks 引擎，也称为自改进的行动前防火墙。AI 编程智能体容易重复犯错，一次错误的工具调用就可能清空目录、泄露密钥或推送有问题的代码。ThumbGate 在 PreToolUse 钩子中运行，在工具调用执行之前评估拟议的工具调用，力求在代价高昂的错误发生前将其捕获。
主要能力
- 行动前检查：在工具调用执行前进行评估，做出允许、警告或拒绝的判定。
- 反馈与教训提炼：捕获 👍/👎 反馈，将具体教训通过历史感知的教训提炼提升为预防规则。
- 自改进：从已采纳的反馈和重复失败中生成预防规则，规则可从警告提升为阻断门；无需重新训练模型。
- 默认硬性阻断：默认硬性阻断检测到的密钥泄露，以及两类直接自我禁用命令——终止 ThumbGate 门进程的命令，或启用其绕过环境覆盖的命令。
- 其他高风险类别：
rm -rf、强制推送、下载并运行、直接编辑护栏等默认警告并记录。设置THUMBGATE_STRICT_ENFORCEMENT=1可启用严格模式，警告变为硬性拒绝。 - 操作评估与报告：
npx thumbgate eval将已采纳的反馈转为可复用的评估用例和本地证明报告。 - MCP 工具：提供
gate_check（读取/评估拟议工具调用）、反馈捕获与会话工具（写入）、仪表盘/统计（读取）。 - 斜杠命令：
npx thumbgate init可将相关命令安装到智能体命令面板中。
使用方式
- MCP / Glama / 注册表安装（stdio）：将 ThumbGate 作为 MCP 服务器安装的目录和客户端必须启动 stdio MCP，而非 HTTP API。等效命令：
npx -y thumbgate mcp。不要对 MCP 使用npm start，那会启动托管的 HTTP API（src/api/server.js），而非面向智能体的 stdio 服务器。 - 初始化：
npx thumbgate init。 - GitHub Marketplace Action：
uses: IgorGanapolsky/ThumbGate@v1（ThumbGate Agent Governance）。 - 工作流程：捕获 👍/👎 反馈（CLI、MCP、关联反馈会话流程 /
open_feedback_session，或 ThumbGate GPT）→ 通过历史感知的教训提炼将具体教训提升为预防规则 → 用活跃规则评估下一个拟议的工具调用（字面/AST + 本地向量）→ 在工具运行前允许/警告/拒绝。 - 安装范围：机器范围与按项目。两种范围都会写入
mcpServers.thumbgate以及 PreToolUse / UserPromptSubmit / PostToolUse / SessionStart 钩子。多数开发者适合机器范围默认值。跨仓库阻断不是自动的：一个项目中习得的教训仅在你共享存储（机器范围）或导出/导入教训时才会应用到其他地方。 - Pro 操作：可通过 MCP 调用
search_lessons，并在 CLI 中使用npx thumbgate lessons。历史感知反馈会话和教训搜索为 Pro 能力；免费版不包含召回或搜索。 - 渐进式接线：先证明管道再开启匹配，空仪表盘即成功。编号配置位于
config/progressive/。
适用场景
适用于 AI 编程智能体可能在人类看到工具调用之前泄露密钥或破坏检出目录的操作者场景，覆盖 Claude Code、Cursor、Codex、Gemini CLI、Amp、Cline、OpenCode 及其他 MCP 智能体。它也是规范驱动智能体（如 GSD、GitHub Spec Kit）的护栏层：位于计划之后、生成的工具调用与其执行之间的边界，与 GSD / Spec Kit 并行而非替代。适用于智能体开发循环 Guide → Generate → Verify → Solve 中，在生成意图与执行动作之间的行动前关卡。
限制
- ThumbGate 不更新模型权重，而是在运行时拦截工具调用。
- 本地优先——执行路径无需云端。
- 不是微调器；与 CLAUDE.md / .cursorrules 不同，那些是上下文，ThumbGate 是工具运行前的外部允许/警告/拒绝层。
- 破坏性智能体操作仍由 PreToolUse 阻断/警告；ThumbGate 不会替你执行用户 shell 命令。
- 免费版每日可捕获 2 条反馈（共 10 条），最多激活 3 条自动提升的预防规则。
- 托管团队教训同步和托管组织仪表盘尚未普遍可用。
- 跨仓库阻断不是自动的，需共享存储或导出/导入教训。
定价
- 免费版：每日 2 条反馈捕获（共 10 条），最多 3 条活跃的自动提升预防规则。
- Pro：每月 19 美元或每年 149 美元，个人版，无限规则、历史感知教训、关联反馈会话流程、个人仪表盘、DPO 导出。
- 企业版：定制，经 intake 后确定范围；Workflow Hardening Sprint 在更广泛推广承诺前先界定一个重复失败。
其他
项目采用 MIT 许可证。
