SuperAPI AI 工具集

security-scan

安全与审计

查看项目

更新于 10-15 19:56

技能介绍

用途:合规安检 Skill(锦衣卫),由锦衣卫 Worker 在收到文件或 URL 时调用,作为流水线的第一道闸门,对进入系统的对象执行安全与合规扫描,输出结构化判定并留痕。

主要能力:输入 target 为本地文件路径(PDF/PPT/Excel/Word/图片)或外部 URL(需先解析域名),可选 policy_ref 覆盖默认合规规则集。输出 verdict(pass 或 reject)、report(含命中黑名单项、许可状态、风险等级)与 trace_id(provenance 追踪 ID,用于太史阁留痕)。

依赖:Sci-Hub 等已知违规域名黑名单(本地 CSV/JSON)、OA 文档许可校验库(本地规则)、文件类型探测(python-magic)。

失败处理:扫描服务不可用时拒绝文件并告警,绝不降级放行;文件类型无法识别时标记 reject 并写入原因,交管理员确认;黑名单库读取失败时回退到全拒加告警的保守策略,并提示运维修复。

复用价值:与具体业务解耦,任何文档处理系统(RAG、知识库、合同审查)均可挂载作入口安检;判定标准可通过替换 policy_ref 适配不同行业合规基线。

执行方式:真实入口为 scripts/run_security_scan.py,执行等价于 core.runtime.AgentSession.run_stage("security-scan"),调用 security.jinyiwei.JinYiWeiAgent(纯 Python,零外部依赖,可离线运行)。运行命令:python skills/security-scan/scripts/run_security_scan.py。产物:examples/snse_survey/skill_outputs/security_scan.json(黄卡加扫描报告)。