Repolode
DobermanCore

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. 1

    从 PyPI 安装 Doberman

    pip install doberman-core
  2. 2

    启用 shell Tab 补全(可选)

    doberman --install-completion
  3. 3

    为 Claude Code 设置 Doberman(选择要保护的代理并调整防护规则)

    doberman setup
  4. 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 数据每日更新。

相关项目