Code Scanner
基于正则的轻量级代码安全扫描引擎,支持 Bash 和 Python,内置 25 条检测规则。
调用方式
agent-sec-cli scan-code --code '<source_code>' --language <bash|python>
输入
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
code |
string | 是 | 待扫描的源代码字符串,支持多行 |
language |
string | 是 | 编程语言,取值:bash 或 python |
输出
返回 JSON 格式的 ScanResult 对象:
| 字段 | 类型 | 说明 |
|---|---|---|
ok |
bool | 扫描是否正常完成(无内部错误) |
verdict |
string | 最终判定,见下方 Verdict 说明 |
summary |
string | 人类可读的扫描摘要 |
findings |
Finding[] | 命中的规则列表,无命中时为空数组 |
language |
string | 输入的语言 |
engine_version |
string | 与 agent-sec-cli 版本一致 |
elapsed_ms |
int | 扫描耗时(毫秒) |
Finding 结构
| 字段 | 类型 | 说明 |
|---|---|---|
rule_id |
string | 规则 ID,如 shell-recursive-delete |
severity |
string | 严重级别:warn / deny |
desc_zh |
string | 中文描述 |
desc_en |
string | 英文描述 |
evidence |
string[] | 匹配到的代码片段列表 |
Verdict 说明
| 值 | 含义 |
|---|---|
pass |
未检测到安全风险 |
warn |
存在告警级风险,建议关注 |
deny |
存在阻断级风险,应阻止执行 |
error |
扫描引擎内部错误 |