用途
Blind Auditor 是一个基于 MCP（Model Context Protocol）的强制代码审计系统，旨在提升 AI 智能体生成代码的质量。它通过独特的“思维隔离”机制，强制 AI 在输出最终结果前，进入一个独立的“审计阶段”进行自我审查。
核心机制：思维隔离
传统 AI 编码通常是“生成即输出”，容易遗留错误和偏见。Blind Auditor 引入了一个中间层：
- 拦截：当智能体想要输出代码时，必须首先提交给 Blind Auditor。
- 隔离：Blind Auditor 不立即返回结果，而是注入一条强制系统指令，迫使智能体暂停当前角色，切换为“无情审计员”角色。
- 审计：在这个隔离的上下文中，智能体必须根据预定义的 rules.json 逐行扫描生成的代码。
- 放行：只有当审计分数达到阈值（默认 > 80）且没有严重问题时，代码才会解锁并返回给用户。
主要特性
- 零信任架构：默认不信任智能体的初稿，必须通过审计。
- 零额外成本：复用宿主 IDE 的当前会话模型，无需额外 API Key。
- 消除偏见：通过提示注入强制切换视角，打破生成惯性。
- 严格合规：将团队代码规范（rules.json）硬编码到生成过程中，比简单提示更有效。
- 自动修复循环：审计失败时自动触发“修复-重新提交”循环，直到符合要求或达到最大重试次数。
使用方式
前提条件
需要 Python 3.10+ 和 uv。
配置审计规则（rules.json）
在项目根目录创建或编辑 rules.json。这是审计员的“规则手册”。 配置字段：
- severity：CRITICAL（致命错误，一旦发现立即失败，通常高扣分）；WARNING（警告，中等扣分，累积可导致失败）；PREFERENCE（风格偏好，低扣分）。
- weight：违反规则时扣除的分数（总分 100）。
配置 IDE（Antigravity / Cursor / Windsurf）
为确保智能体知道必须使用此工具，需在 .cursorrules 或 IDE 系统提示设置中添加相应指令。 同时，在 MCP 客户端配置文件（如 claude_desktop_config.json 或 IDE 设置）中添加配置。 注意：将 /path/to/your/blind-auditor 替换为实际克隆仓库的绝对路径。
工具接口
- submit_draft：提交代码草稿。输入：code（内容）、language（编程语言）。行为：锁定会话并返回强制审计指令。
- submit_audit_result：提交审计结论。输入：passed（布尔值，是否通过）、issues（问题列表）、score（0-100 分）。行为：如果 score < 80，强制 passed=False；如果通过，解锁代码；如果失败，增加重试计数并要求智能体修复后重新提交。
- reset_session：重置状态并清除重试计数。
适用场景
适用于使用 AI 智能体编写代码的开发者或团队，特别是在需要强制执行代码规范、提升生成代码质量、减少人工审查负担的场景。支持 Antigravity、Cursor、Windsurf 等 IDE。
限制
- 理论上支持所有编程语言。Blind Auditor 本身不解析代码语法，而是依赖智能体对 rules.json 中描述的理解进行匹配。
- 使用前需确保系统提示配置正确，明确告知智能体“不要直接输出代码”。也可在聊天中手动提醒：“请先通过 Blind Auditor 审计”。
- 若代码评分 100 仍失败，需检查是否触发了 rules.json 中的 CRITICAL 规则；当前逻辑主要依赖智能体传递的分数，但若 passed 为 True 而 score < 80，系统会强制拒绝。
