version: "1.0.0" name: code-scanner description: 扫描 Bash / Python 代码片段中的安全风险，返回结构化 JSON 扫描结果。当用户要求检查代码安全性时使用。
Code Scanner
基于正则的轻量级代码安全扫描引擎，支持 Bash 和 Python，内置 25 条检测规则。
调用方式
bash
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 | 扫描引擎内部错误 | |