使用说明
🛡️ 盲审计员-MCP服务器
“代码->审核->修改->再次审核->通过。”
盲人审计员是 强制性代码审计制度 基于MCP（模型上下文协议）构建。它使用了一种独特的 “思维隔离” 强制AI代理进入独立的“审计阶段”并在输出最终结果之前对其代码进行自我审查的机制。
🧠 核心哲学：思维隔离
传统的人工智能编码通常是“生成和输出”的，这会让错误和偏差溜走。Blind Auditor引入了一个中间层：
- 拦截：当代理想要输出代码时，它必须首先将其提交给Blind Auditor。
- 隔离：盲审不会立即返回结果。相反，它注入了 强制性系统指令，迫使代理暂停其当前角色并切换到“无情审计员”角色。
- 审计：在这种孤立的环境中，代理必须逐行扫描生成的代码，以符合预定义的
rules.json. - 发布：只有当审计分数达到阈值（默认值>80）并且没有严重问题时，代码才会解锁并返回给用户。
🎯 主要特点
- 🛡️ 零信任架构：默认不信任代理人的初稿；它必须通过审计。
- 💰 零额外成本：重用主机IDE的当前会话模型，不需要额外的API密钥。
- ⚖️ 偏置消除：通过快速注射强制透视开关，以打破发电惯性。
- 📏 严格遵守：硬代码团队代码标准(
rules.json)这比简单的Prompts更有效。 - 🔄 自动修复循环：审核失败时自动触发“修复重新提交”循环，直到达到合规性或达到最大重试次数。
🚀 快速开始
1.先决条件
这个项目需要Python 3.10+和 紫外线.
# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh
# Enter project directory
cd blind-auditor
# Install dependencies (automatically creates virtual environment)
uv sync
2.配置审核规则(rules.json)
创建或编辑 rules.json 在项目根中。这是审计员的“规则手册”。
{
"project_name": "MyCoreProject",
"strict_mode": true,
"max_retries": 3,
"rules": [
{
"id": "SEC-001",
"severity": "CRITICAL",
"description": "Strictly prohibit hardcoding any API Keys, passwords, or sensitive Tokens.",
"weight": 50
},
{
"id": "PERF-001",
"severity": "WARNING",
"description": "Avoid database queries or IO operations inside loops.",
"weight": 15
},
{
"id": "STYLE-001",
"severity": "PREFERENCE",
"description": "Use snake_case for variable names.",
"weight": 5
}
]
}
配置字段:
severity:CRITICAL：严重错误。如果发现，审核将立即失败。通常会受到很高的惩罚。WARNING：警告。适度处罚；积累会导致失败。PREFERENCE：风格偏好。罚款低。
weight：违反此规则时扣除的罚分（总分：100）。
3.配置IDE（反重力/光标/风帆）
步骤A：添加系统提示（关键）
为确保代理知道必须使用此工具，请在您的 .cursorrules 或IDE系统提示设置：
# Blind Auditor Protocol
**CRITICAL INSTRUCTION**:
You are integrated with the **Blind Auditor MCP**.
Whenever you generate code for a user request, you **MUST NOT** output the code block directly to the user.
**Execution Protocol**:
1. **Draft**: Generate the code internally in your thought process.
2. **Submit**: Call the `submit_draft` tool with your code and language.
3. **Obey**: The tool will return a strict "Audit Instruction". You MUST follow it exactly to audit your own code.
4. **Finalize**: Only when the tool returns "✅ AUDIT PASSED" can you display the final code to the user.
**Prohibited**:
- Do NOT output code blocks before passing the audit.
- Do NOT skip the audit step for "simple" changes.
步骤B：配置MCP服务器
将以下内容添加到MCP客户端配置文件中（例如。， claude_desktop_config.json 或IDE设置）：
备注：替换 /path/to/your/blind-auditor 使用克隆此存储库的实际绝对路径。
{
"mcpServers": {
"blind-auditor": {
"command": "uv",
"args": ["run", "--directory", "/path/to/your/blind-auditor", "blind-auditor"]
}
}
}
🔧 工具详细信息
1. submit_draft
提交代码草案。
- 输入:
code（内容），language（程序设计语言） - 行为：锁定会话并返回强制审核指令。
2. submit_audit_result
提交您的审计结论。
- 输入:
passed（bool）：你是否相信它通过了。issues（列表）：发现的问题列表。score（int）：0-100分。
- 行为:
- 如果
score < 80，部队passed=False. - 如果通过，则解锁代码。
- 如果失败，将递增重试计数，并要求代理修复并重新提交。
- 如果
3. reset_session
重置状态并清除重试计数。
🔁 工作流程图
graph TD
User["User Request"] --> Agent
Agent["Agent Generates Draft"] -->|1. submit_draft| MCP
MCP -->|2. Inject Audit Instructions| Agent
subgraph Isolation ["Thinking Isolation"]
Agent -->|3. Self-Review| Agent
Agent -->|4. submit_audit_result| MCP
end
MCP -->|5. Verdict| Decision{"Passed?"}
Decision -->|No - Issues Found| Retry["Retry Count +1"]
Retry -->|Limit Not Reached| Fix["Agent Fixes Code"]
Fix -->|Resubmit| Agent
Decision -->|Yes - Score >= 80| Final["✅ Output Final Code"]
Retry -->|Limit Reached| Force["⚠️ Force Output - With Warning"]
❓ 故障排除
Q： Agent始终直接输出代码，而无需调用工具。 A： 检查系统提示是否配置正确。您必须明确告诉代理“不要直接输出代码”。您也可以在聊天中手动提醒：“请先通过盲人审核员审核”。
Q： 为什么即使我给代码100分，它也会失败？
A： 检查是否有 CRITICAL 规则在 rules.json 被触发。当前的逻辑主要依赖于 score 由代理人通过，但如果 passed 是 True 当 score < 80，系统将强制拒绝。
Q： 支持哪些编程语言？
A： 理论上，支持所有语言。Blind Auditor本身不解析代码语法，而是依赖于Agent的理解来匹配中的描述 rules.json.
🛠️ 开发指南
# Run server
uv run blind-auditor
# Or run directly with Python module
uv run python -m src.main
# Debug mode (output to stderr)
# View print statements in src/main.py
📄 许可证
MIT许可证
