开源的 AI 智能体授权引擎,在每个动作执行前进行检查,返回允许、拒绝、人工审核或改道决策。
DobermanCore/Doberman-Core
为 AI 编程代理提供运行时守卫,在工具调用执行前判定放行、需人工确认或拦截。
- Star
- 247
- Fork
- 44
- 未关闭 Issue
- 54
- 最近提交
- 9天前
这是什么?
Doberman 是一个授权与运行时守卫层,位于 AI 代理和它所调用的工具(文件、Shell、MCP 服务器、API 等)之间的执行路径上。每次工具调用都会在执行前得到一个结论:PASS 直接放行,AUTH 暂停等待人工确认,BLOCK 直接拦截且不会执行。接入方式包括透明的 MCP 代理,以及面向 Claude Code、Codex、OpenClaw 和 Cursor 的宿主钩子。
系统采用失败即拒绝(fail closed)的设计:出错或无法判断的情况一律拒绝,无人响应的审批请求会在截止时间后判为拒绝。自适应学习只能自动收紧策略,不能静默放宽;放宽任何永久策略都需要经过审计的人工批准,并要求 TOTP 或本地密码等持有性验证。策略还可以以 doberman.policy.yaml 的形式提交到仓库,随代码一同评审。
项目基于 Python,可通过 pip 安装 doberman-core,提供 setup、doctor、demo、dash 等命令行工具,并附带基准测试工具,用于衡量攻击绕过率与正常操作被误拦率。
核心功能
- 01在执行前为每次工具调用给出 PASS、AUTH 或 BLOCK 判定。
- 02以透明 MCP 代理的形式部署在任意 MCP 兼容服务器前面。
- 03为 Claude Code、Codex 提供宿主钩子,对 Cursor 的支持处于实验阶段。
- 04失败即拒绝,放宽策略必须经过审计的人工批准。
- 05支持随仓库提交的策略文件,与代码一同评审。
- 06提供仪表盘,实时查看判定结果并处理待审批请求。
适用场景
- 防止 AI 编程代理在代码仓库中执行 rm -rf 等破坏性命令。
- 阻止代理通过工具调用读取 .env 文件或泄露 API 密钥。
- 在无人值守的代理流程中,对敏感操作要求人工审批。
- 为团队统一审计和执行代理的工具调用策略。
快速上手
- 1
从 PyPI 安装 Doberman
pip install doberman-core - 2
启用 shell Tab 补全(可选)
doberman --install-completion - 3
为 Claude Code 设置 Doberman(选择要保护的代理并调整防护规则)
doberman setup - 4
确认安装正常运行
doberman doctor
使用前须知
- 项目处于 alpha 阶段,可能出现破坏性变更。
- Codex 和 Cursor 集成标注为实验性功能。
- 无人응答的审批提示会在超时后自动拒绝。
收录于专题
标签
常见问题
- Doberman-Core 是什么?
- 为 AI 编程代理提供运行时守卫,在工具调用执行前判定放行、需人工确认或拦截。 Doberman 是一个授权与运行时守卫层,位于 AI 代理和它所调用的工具(文件、Shell、MCP 服务器、API 等)之间的执行路径上。每次工具调用都会在执行前得到一个结论:PASS 直接放行,AUTH 暂停等待人工确认,BLOCK 直接拦截且不会执行。接入方式包括透明的 MCP 代理,以及面向 Claude Code、Codex、OpenClaw 和 Cursor 的宿主钩子。
- Doberman-Core 可以免费使用吗?用的什么许可证?
- Doberman-Core 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
- Doberman-Core 还在维护吗?
- 活跃维护中。Doberman-Core 最近一次提交是在 2026年10月29日。
- Doberman-Core 适合用来做什么?
- 防止 AI 编程代理在代码仓库中执行 rm -rf 等破坏性命令。 阻止代理通过工具调用读取 .env 文件或泄露 API 密钥。 在无人值守的代理流程中,对敏感操作要求人工审批。 为团队统一审计和执行代理的工具调用策略。
- Doberman-Core 怎么安装和运行?
- 从 PyPI 安装 Doberman: pip install doberman-core 启用 shell Tab 补全(可选): doberman --install-completion 为 Claude Code 设置 Doberman(选择要保护的代理并调整防护规则): doberman setup 确认安装正常运行: doberman doctor
- 在哪里获取 Doberman-Core?
- 源代码和安装说明在 GitHub 上:https://github.com/DobermanCore/Doberman-Core
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
为 Claude Code、Codex 等 AI 编程助手提供执行前拦截,阻止破坏性 Git 与文件命令及敏感文件访问。
开源 Python 框架,用于对 LLM 系统和 AI 智能体进行红队测试,模拟攻击发现漏洞并提供生产环境防护。
一个开源 SDK,用于防范提示词注入、脱敏 PII 与密钥,并扫描仓库中针对 AI 智能体的攻击。
开源标准与 Python 验证器,要求 AI 智能体在执行高风险工具调用前提供可验证的来源与签名证据。
开源 AI 智能体防火墙,位于智能体与网络之间,拦截密钥外泄、提示注入、SSRF 和 MCP 工具投毒,并输出签名操作凭证。