这类工具最值得先看的不是功能列表而是能不能在普通环境里稳定跑起来。Destructive Command Guard简称 dcg是一个专门拦截危险 Git 和 Shell 命令的工具主要面向使用 AI 编程助手如 Claude Code、GitHub Copilot、Cursor 等的开发者。它的核心价值是当 AI 助手建议或尝试执行rm -rf /、git reset --hard这类高风险操作时能自动拦截并给出明确提示而不是真的执行。我建议先从最小样例开始验证它的拦截能力再考虑是否部署到生产环境。下面按实际落地顺序拆一遍。1. 先确认它到底拦截哪些命令、怎么判断危险dcg 不是简单匹配关键词而是通过规则包packs来识别危险模式。默认包含的规则包有core.git拦截git reset --hard、git push --force、git clean -fd等会丢失数据的操作core.shell拦截rm -rf /、chmod -R 777 /等系统级危险命令containers.docker拦截docker system prune -a、docker rm -f $(docker ps -aq)等清理操作database.postgresql拦截DROP DATABASE、TRUNCATE TABLE等数据删除操作判断逻辑是四层管道解析输入从 AI 助手传来的 JSON 中提取命令字符串标准化命令把绝对路径转为命令名/usr/bin/git→git快速过滤如果命令中不包含任何危险关键词如 git、rm、drop 等直接放行模式匹配先检查安全模式匹配则放行再检查危险模式匹配则拦截这种设计保证了 99% 的普通命令能快速通过只有真正可疑的命令会进入详细匹配。1.1 关键配置项控制严格程度安装后可以通过环境变量或配置文件调整行为# 环境变量方式优先级最高 export DCG_QUIET1 # 只输出错误信息 export DCG_NO_COLOR1 # 禁用彩色输出 export DCG_FAIL_CLOSED1 # 解析失败时默认拦截严格模式 export DCG_BYPASS1 # 临时完全绕过 dcg # 或使用配置文件 ~/.config/dcg/config.toml [general] fail_closed false # 默认宽松模式解析失败时放行 [heredoc] fallback_on_parse_error true # 遗传文档解析失败时放行 fallback_on_timeout true # 超时时放行新手建议刚开始用默认配置即可等熟悉拦截逻辑后再考虑调严格程度。1.2 安全模式与危险模式的优先级匹配顺序很重要# 安全模式优先如果命令匹配安全模式直接放行 safe_patterns [ git status, git log --oneline, ls -la, pwd ] # 危险模式其次只有不匹配安全模式且匹配危险模式的命令才会被拦截 destructive_patterns [ git reset --hard, rm -rf, chmod -R 777 ] # 都不匹配默认放行这意味着你可以通过添加安全模式来放行特定场景的危险命令需谨慎。2. 低配置环境能不能跑关键看安装方式和资源占用dcg 本身是 Rust 编写的静态二进制文件资源占用很小内存常驻内存约 2-4MBCPU单次检查通常在 1ms 内完成磁盘二进制文件约 20MB配置和历史数据另占 10-50MB2.1 选择适合的安装方式推荐方案一键安装脚本适合大多数环境# 最基本安装 curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/destructive_command_guard/main/install.sh | bash # 带交互提示的安装 curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/destructive_command_guard/main/install.sh | bash -s -- --interactive # 系统级安装需要 sudo curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/destructive_command_guard/main/install.sh | sudo bash -s -- --system安装脚本会自动检测操作系统和架构下载对应的预编译二进制文件验证 SHA256 校验和配置支持的 AI 助手钩子更新 PATH 环境变量备选方案手动下载二进制文件如果网络环境特殊可以直接从 GitHub Releases 下载对应版本Linux x86_64dcg-x86_64-unknown-linux-musl.tar.gzmacOS Apple Silicondcg-aarch64-apple-darwin.tar.gzWindows x64dcg-x86_64-pc-windows-msvc.zip下载后解压到 PATH 中的目录即可。2.2 验证安装是否成功安装后运行dcg --version # 正常输出示例dcg 0.6.8 (x86_64-unknown-linux-musl) # 测试拦截功能 echo {tool_name:Bash,tool_input:{command:git reset --hard}} | dcg # 应该看到拦截信息如果安装失败检查网络连接GitHub 访问磁盘空间至少 100MB 空闲执行权限二进制文件需要可执行权限2.3 资源占用监控和优化虽然 dcg 本身很轻量但在 AI 助手频繁调用时需要注意# 查看 dcg 进程资源占用 ps aux | grep dcg | grep -v grep # 如果发现频繁调用影响性能可以调整超时设置 export DCG_HOOK_TIMEOUT_MS50 # 将超时从默认 200ms 降到 50ms对于低配机器建议保持默认超时设置避免因超时导致的误放行。3. 单任务跑通之后再处理批量任务和钩子配置先手动测试单条命令的拦截效果确认符合预期后再配置 AI 助手钩子。3.1 手动测试模式dcg 提供多种测试方式基础测试# 人类可读输出 dcg test rm -rf /tmp/build # JSON 输出适合脚本处理 dcg test --format json git reset --hard HEAD~1详细分析模式# 查看决策过程 dcg explain git reset --hard HEAD # 输出示例 # Command: git reset --hard HEAD # Normalized: git reset --hard HEAD # Decision: BLOCKED # Pack: core.git # Rule: reset-hard # Reason: git reset --hard destroys uncommitted changes临时放行机制 当命令被拦截时dcg 会输出一个 6 位数字码BLOCKED: git reset --hard HEAD Allow-once code: 123456使用该码临时放行dcg allow-once 123456 # 24小时内有效 dcg allow-once 123456 --single-use # 仅一次有效3.2 配置 AI 助手钩子安装脚本会自动配置支持的 AI 助手但了解手动配置有助于排查问题Claude Code~/.claude/settings.json{ hooks: { PreToolUse: [ { matcher: Bash, hooks: [ { type: command, command: dcg } ] } ] } }GitHub Copilot CLI# 安装脚本会自动配置 # 手动检查确保 ~/.copilot/hooks/dcg.json 存在Cursor IDE# 安装脚本会配置 ~/.cursor/hooks.json # 重启 Cursor 后生效重要提醒配置钩子后一定要重启 AI 助手应用才能生效。3.3 验证钩子是否工作测试钩子是否正常拦截在 AI 助手中输入危险命令请清理构建目录rm -rf ./build观察行为正常情况AI 助手显示 dcg 的拦截提示不执行命令如果命令被执行说明钩子配置有问题排查步骤# 检查 dcg 是否在 PATH 中 which dcg # 检查钩子配置文件语法 jq . ~/.claude/settings.json # 需要 jq 命令 # 查看 AI 助手日志如果有4. 输出质量不稳定时优先排查输入格式和参数边界dcg 的拦截准确性依赖正确的输入格式和参数解析。遇到误拦截或漏拦截时按这个顺序排查。4.1 输入格式问题AI 助手传给 dcg 的 JSON 格式必须正确标准格式Claude Code{ tool_name: Bash, tool_input: { command: git reset --hard HEAD } }常见格式问题缺少必要的字段如tool_name命令格式错误如多级嵌套编码问题非 UTF-8检测方法# 使用 explain 模式查看 dcg 实际收到的命令 dcg explain 问题命令 # 如果 explain 也报错可能是格式问题4.2 遗传文档Heredoc扫描dcg 能扫描遗传文档中的危险模式但这可能引起误判# 示例遗传文档中的危险命令会被扫描 cat EOF script.sh #!/bin/bash rm -rf /tmp/cache # 这行会被 dcg 检测 EOF控制遗传文档扫描# 禁用遗传文档扫描 export DCG_HEREDOC_ENABLEDfalse # 或限制扫描语言 export DCG_HEREDOC_LANGUAGESpython,bash # 调整超时默认 50ms export DCG_HEREDOC_TIMEOUT_MS204.3 边界情况处理Git 变基恢复模式 当处于 rebase 状态时dcg 会放宽对git checkout -- .的拦截# 检测到 .git/rebase-merge/ 或 .git/rebase-apply/ 目录时 git checkout -- . # 正常被拦截的命令在 rebase 状态下会放行 # 手动启用恢复模式120秒内有效 dcg rebase-recover路径标准化问题# 这些命令会被正确识别为 git 命令 /usr/bin/git reset --hard /usr/local/bin/git reset --hard git reset --hard # 但别名或函数可能绕过检测 alias gitmy-git-wrapper # dcg 可能无法识别4.4 误拦截处理流程当安全命令被误拦截时先确认是不是真的误判dcg explain 被拦截的命令 # 查看详细原因临时解决方案# 使用 allow-once 码临时放行 dcg allow-once 123456长期解决方案# 添加到项目级白名单需要代码审查 dcg allowlist add core.git:reset-hard --reason CI 环境需要 --project # 或个人白名单 dcg allowlist add core.git:reset-hard --reason 个人开发习惯如果确实是 bug在 GitHub 仓库提交 issue提供dcg explain的完整输出说明期望的行为5. 批量任务和仓库扫描的实战配置除了实时拦截dcg 还提供仓库扫描功能用于检测代码中的危险命令。5.1 预提交钩子配置一键安装dcg scan install-pre-commit这会创建.git/hooks/pre-commit在每次提交前自动扫描暂存文件。手动配置如果使用其他钩子管理器#!/bin/bash # .git/hooks/pre-commit # 只扫描暂存的文件 dcg scan --staged --fail-on error # 可以根据项目需要调整参数 dcg scan --staged \ --fail-on warning \ --redact quoted \ --format pretty5.2 扫描配置优化创建项目级配置文件.dcg/hooks.toml[scan] # 检查级别none不失败、warning警告级失败、error错误级失败 fail_on warning # 输出格式 format pretty # pretty, json, markdown # 敏感信息脱敏 redact quoted # none, quoted, aggressive # 最大文件大小字节 max_file_size 1000000 [scan.paths] # 只扫描这些路径 include [ scripts/**, .github/workflows/**, Dockerfile*, Makefile ] # 排除这些路径 exclude [ node_modules/**, dist/**, *.md ]5.3 CI/CD 集成示例GitHub Actionsname: Security Scan on: [pull_request, push] jobs: dcg-scan: runs-on: ubuntu-latest steps: - uses: actions/checkoutv4 with: fetch-depth: 0 # 需要完整历史记录进行差异扫描 - name: Install dcg run: | curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/destructive_command_guard/main/install.sh | bash echo $HOME/.local/bin $GITHUB_PATH - name: Scan changed files run: | dcg scan \ --git-diff origin/${{ github.base_ref }}..HEAD \ --format markdown \ --fail-on error \ --redact quotedGitLab CIscan: stage: test script: - curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/destructive_command_guard/main/install.sh | bash - ~/.local/bin/dcg scan --git-diff origin/$CI_MERGE_REQUEST_TARGET_BRANCH_NAME..HEAD --fail-on error rules: - if: $CI_MERGE_REQUEST_ID5.4 扫描结果处理扫描输出示例scripts/deploy.sh:15:2: [ERROR] core.shell:rm-recursive-force Command: rm -rf ./dist Reason: Recursive force deletion can cause data loss Suggestion: Consider using rm -r without -f to confirm deletions处理建议高危发现ERROR必须修复替换为更安全的命令或添加项目级白名单需团队评审警告发现WARNING建议修复评估实际风险根据团队规范决定是否放行误报处理# 添加到项目白名单 dcg allowlist add core.shell:rm-recursive-force --reason 构建清理需要 --project6. 生产环境部署的注意事项在团队中推广使用 dcg 时需要制定清晰的流程和规范。6.1 分阶段推广计划阶段一监控模式1-2周# 配置为只警告不拦截 export DCG_POLICY_DEFAULT_MODEwarn # 或使用配置文件 [general] policy_default_mode warn这个阶段的目标收集常见的误报模式让团队成员熟悉 dcg 的行为建立白名单规范阶段二拦截模式2-4周# 切换到拦截模式 export DCG_POLICY_DEFAULT_MODEdeny # 但配置宽松的超时和错误处理 [heredoc] fallback_on_timeout true fallback_on_parse_error true阶段三严格模式1个月后# 启用严格模式 export DCG_FAIL_CLOSED1 [general] fail_closed true6.2 团队白名单管理个人级白名单~/.config/dcg/allowlist.toml# 个人开发习惯相关的放行 [[rules]] id core.git:reset-hard reason 个人开发流程需要项目级白名单.dcg/allowlist.toml# 需要代码审查的放行 [[rules]] id core.shell:rm-recursive-force reason CI 构建清理 commands [rm -rf ./dist] # 限定具体命令 [[rules]] id containers.docker:system-prune reason 开发环境清理白名单评审流程提出申请说明为什么需要放行团队评审评估风险和替代方案添加到项目配置需要 PR 和批准监控使用情况定期回顾6.3 监控和审计启用日志记录# 详细日志用于调试 export DCG_LOGdebug # 或使用配置文件 [general] log_level info # error, warn, info, debug, trace定期审计# 查看白名单使用情况 dcg allowlist list --verbose # 扫描历史拦截记录 dcg history --last 30d # 检查配置变更 git log --oneline .dcg/6.4 故障排除清单当 dcg 不工作时按这个顺序检查基础功能检查dcg --version # 确认安装 dcg test rm -rf /tmp/test # 确认核心功能钩子配置检查# 检查配置文件语法 cat ~/.claude/settings.json | jq . # 需要 jq # 检查钩子文件是否存在 ls -la ~/.copilot/hooks/权限和环境检查which dcg # 确认在 PATH 中 ls -la $(which dcg) # 确认可执行权限 echo $PATH # 检查 PATH 设置AI 助手集成检查重启 AI 助手应用检查助手是否支持钩子功能查看助手日志如果有网络和资源检查# 检查是否因超时被跳过 export DCG_HOOK_TIMEOUT_MS500 # 临时增加超时时间 # 检查系统资源 ulimit -a # 查看系统限制我个人更建议先把单任务跑稳再考虑批量和团队部署。这个工具真正落地时最该盯住的不是功能列表而是输入格式、资源占用和失败重试机制。如果只是个人学习默认配置通常够用如果要团队使用就要把白名单流程、监控指标和升级计划提前准备好。