如果你发现本仓库的安全问题(例如 redline_guard.py 的正则可被绕过、规则漏拦危险动作、模板泄露敏感信息、依赖链风险),请私下联系维护者:
- 邮箱:zhaoxinghua06@126.com
- 请在邮件中说明:问题描述、复现步骤、影响范围、你建议的修复方式。
不要在公开 issue / PR 中披露未修复的安全问题。
本仓库的可执行代码是 code/redline_guard.py(PreToolUse 红线守护钩子,Python 纯标准库)。它的设计目标与边界:
- 零网络外发:
redline_guard.py不发起任何网络请求;所有拦截判断都在本机内存中完成。 - 低误拦优先:stdin JSON 解析失败一律放行(exit 0),钩子绝不误伤正常工作;拦截即 exit 2 + stderr 理由。
- 密钥不回显:R2 命中明文密钥形态时,匹配值绝不打印到 stderr(铁律:密钥永不进对话)。
- 钩子只覆盖单平台四个工具入口(shell 执行、文件写/改);直连 MCP 工具调用不在拦截范围内,靠连接器权限 +
docs/dispatch_template_v1.md派单模板约束。 - 🟡 审批级动作目前是制度闸(流程约束),不是代码闸。
- 收到有效报告后,我们会在合理时间内确认并评估。
- 修复后会在提交记录中登记(按需脱敏)。
- 规则扩充只在拿到真实误拦/漏拦证据后进行(同类错误三击升级为硬门禁),不随意加严。
- 请从本仓库官方地址获取钩子代码,警惕第三方二次打包。
- 把
<PROTECTED_PATH>替换为你自己的真实受保护目录后再跑拦截测试;本 README 不印字面危险目标。 - 任何密钥 / 令牌都不应提交进仓库;如需在配置中引用,请走环境变量或本地凭据保险库。
- 本仓库规则为自我陈述(self-reported),非第三方认证或监管认可;法规引用仅供方向性参考,请以最新官方文本为准。
许可分层:代码(code/)Apache-2.0 | 文档与理论表述(docs/、本 README)all rights reserved(不在 Apache-2.0 覆盖内)| 详见 README「权属宣告统一块」。