内容
# 预检
在AI生成的代码成为生产技术债务之前，阻止AI编码偏移。预检是一款本地优先的安全门户，旨在捕获不安全的身份验证、RLS、SQL、SSRF、命令执行、依赖和秘密处理变更，在它们被提交之前。
网站：<a href="https://preflight-vibe.vercel.app">https://preflight-vibe.vercel.app</a>
## 选择您的修复深度
根据代码库的需求，预检在两个不同的层级运行。
### 免费层级：预检守护者
- **功能：** 无限本地扫描加上10次免费补丁应用，涵盖本地确定性修复和代理支持的AI修复。
- **设置：** 扫描时无需配置。只有在使用10次免费补丁后才需要专业密钥。
- **命令：**
```bash
npm install -g preflight-pro
preflight init
preflight scan . --fix
```
安装`preflight-pro`会在您的shell中暴露全局的`preflight`命令。
### 专业层级：预检专业版
- **功能：** 无限扫描和无限修复，包括复杂多文件架构缺陷、租户隔离逻辑和参数化SQL注入的深入推理修复。
- **设置：** 需要有效的`PREFLIGHT_PRO_KEY`或从`preflight auth`保存的密钥。
- **PowerShell：**
```powershell
$env:PREFLIGHT_PRO_KEY="PREFLIGHT-BETA-XXXXX"
preflight scan . --fix
```
- **Bash / macOS：**
```bash
export PREFLIGHT_PRO_KEY="PREFLIGHT-BETA-XXXXX"
preflight scan . --fix
```
## 安装流程
预检支持终端优先的工作流和IDE优先的工作流。两种路径都以`preflight init`结束，因为该向导在一个地方连接您的编辑器、MCP客户端和专业/测试密钥。
### 路径 A：CLI
```bash
npm install -g preflight-pro
preflight init
```
然后从任何项目的根目录扫描：
```bash
preflight scan . --fix
```
### 路径 B：VS Code / Cursor
1. 安装全局CLI命令。VSIX为您提供编辑器内的UI，但扩展仍使用全局`preflight`命令启动The Eye守护进程并运行修复。
```bash
npm install -g preflight-pro
```
2. 下载并安装预检伴侣VSIX扩展：
- <a href="https://preflight-vibe.vercel.app/downloads/preflight-companion-0.0.1.vsix">从预检网站下载VSIX</a>
- 或打开 <a href="https://github.com/av29nassh-sketch/PreFlight/releases">GitHub Releases</a> 并安装最新的`preflight-companion` VSIX。
- 在VS Code或Cursor中，打开扩展面板，点击`...`菜单，选择`从VSIX安装...`，然后选择下载的文件。
3. 运行设置向导：
```bash
preflight init
```
4. 在IDE中打开您的项目。扩展程序自动启动The Eye，监控文件保存，并在编辑器中显示预检警报。
### The Eye 和 MCP
- **The Eye：** VS Code/Cursor扩展程序自动启动预检的本地守护进程。它监控文件保存，并在AI生成的代码引入硬阻止问题时在编辑器中引发警报。
- **MCP桥接：** `preflight init`还可以将`preflight mcp`连接到支持的AI编辑器，以便代理可以调用预检工具而无需离开编码流程。
### 测试 / 专业密钥
免费用户获得无限扫描和10次总补丁，涵盖本地修复和代理支持的AI修复。使用10次免费补丁后，无限修复需要专业/测试密钥。
您可以在`preflight init`期间添加您的密钥，或直接激活它：
```bash
preflight auth PREFLIGHT-BETA-XXXXX
```
在一个终端会话中，您也可以手动设置它：
```powershell
$env:PREFLIGHT_PRO_KEY="PREFLIGHT-BETA-XXXXX"
```
```bash
export PREFLIGHT_PRO_KEY="PREFLIGHT-BETA-XXXXX"
```
## 定价
- **免费层级：** 无限扫描，10次免费补丁（本地 + 深度推理AI）。
- **个人专业版：** 19美元/月，适用于无限扫描和修复。
- **团队：** 49美元/席位/月，适用于团队推广、共享上线和无限扫描及修复。
## 引擎升级
预检现在由更深入的本地分析基元提供支持：
- **微模糊测试：** 为SQL注入、命令注入、身份验证绕过、SSRF和路径遍历等风险数据流路径生成聚焦的安全有效载荷。
- **量化CPG（代码属性图）：** 构建语法、控制流和数据流的紧凑内存图，以便预检可以跟踪不受信任的输入进入危险的接收器，而不是依赖脆弱的字符串匹配。
- **The Eye守护进程：** 通过CLI/扩展工作流本地运行，监控文件保存，以便在AI编码会话仍处于活动状态时出现问题。
## 三状态风险评分引擎
这是核心预检信号。每次扫描都会解析为三个明确的结果之一，以便您知道是停止、审查还是发布。
| 分数 | 含义 | 它捕获的内容 |
| --- | --- | --- |
| 🔴 **硬阻止** | 立即停止。此更改不安全，无法发布。 | 暴露的前端秘密、泄露的数据库服务角色、命令执行、SQL注入或缺少Supabase行级安全（RLS）。 |
| 🟡 **高风险偏移** | 仔细审查。代码在运行上可能存在结构问题。 | 结构状态不一致、非幂等Webhook、弱验证或开放的CORS上下文。 |
| 🟢 **通过** | 可以继续。未检测到阻止结构风险。 | 匹配预期堆栈规则的标准本地编辑。 |
## 2阶段流水线
预检在严格的顺序中运行修复：
1. **阶段1：离线本地AST扫描**
预检首先完成超快的离线结构传递，并应用任何确定性的本地修复。
2. **阶段2：预检专业版深度推理交接**
剩余的SQL、模糊测试和复杂的架构缺陷通过安全的代理支持推理路径进行交接，当补丁需要更深的上下文时。
前10次补丁应用在两个阶段都是免费的。之后，需要`PREFLIGHT_PRO_KEY`。
## 编辑器和MCP用法
预检可以直接在终端、通过VS Code/Cursor扩展或作为AI原生编辑器的MCP服务器运行。
在本地启动MCP服务器：
```bash
preflight mcp
```
可用的MCP工具包括：
- `scan_project`
- `preflight_fix`
- `audit_dependencies`
`scan_project` 仍然免费且无限。`preflight_fix` 在需要`PREFLIGHT_PRO_KEY`之前共享全局10次免费补丁额度。
## 修复后验证循环
预检旨在用作闭环，而非一次性扫描器：
1. 使用AI编码助手生成或修改代码。
2. 运行 `preflight scan .` 以根据三状态风险评分对更改进行分类。
3. 如果预检返回 `硬阻止`，请停止并修复结构问题，然后再继续。
4. 如果预检返回 `高风险偏移`，请运行 `preflight scan . --fix` 并检查每个提议的修复后再应用。
5. 在每次接受的修复后重新运行 `preflight scan .` 以确认存储库结算为 `通过`。
6. 只有在最终验证通过且结构收据与您预期的架构边界匹配后，才发布。
此验证循环是产品：扫描、审查、补丁、重新扫描，然后自信部署。
