SuperAPI AI 工具集

npm-supply-chain-check

安全与审计

查看项目

更新于 10-16 00:04

技能介绍

用途:在仓库、锁文件和 node_modules 中排查已知恶意 npm 包版本与安装期供应链指标。默认仅扫描当前仓库,不静默扩展到主目录、全局缓存或 CI。

主要能力:自带确定性扫描脚本,支持 text/JSON 输出与 --deep 深扫源码和构建产物中的网络与活动字符串;退出码可用于机器判断(0 无指标,1 发现受影响版本或可疑指标,2 目标或 IOC 数据无效)。附带带日期的参考基线文件 references/shai-hulud-2026-iocs.json。

用法:在技能目录运行 python3 scripts/scan_npm_supply_chain.py <target> --format text 或 --format json,仅需搜索源码与构建文件时加 --deep。

证据分级:清单或锁文件中的受影响版本只是暴露候选,不代表安装或执行;node_modules 下的受影响版本说明本地可能曾存在恶意内容;SHA-256 命中为高置信本地制品匹配;IOC preinstall 命令或活动字符串为强可疑内容证据;仅有 IOC 文件名而哈希不同只能作为线索。无发现只表示该范围与基线内无已知指标,不等于机器干净。

限制:扫描只读,不会读取或打印密钥值。删除 node_modules、缓存、日志,重装依赖,轮换令牌,上传本地产物等操作需事先获得明确授权。npm 撤包不能清除本地安装与缓存;floating 声明无法证明历史安装版本;bun.lockb 等二进制锁文件会报告为不支持;基线有日期,需结合 npm registry 与安全公告核实。暂未提供定价、平台支持等其它信息。