SuperAPI AI 工具集

side-effect-analyzer

前端与建站

查看项目

更新于 10-16 01:17

技能介绍

用途:运行 se-scan 并将扫描输出转化为可执行的审计报告与修复计划,聚焦前端副作用检测。

主要能力:检测 CSS 副作用(全局选择器、冲突、高风险规则);全局变量污染(意外全局变量、window/prototype 覆盖);全局事件监听器(缺少清理、重复监听、匿名处理器);动态 DOM 变更(append/remove/insert/innerHTML,启用时)。

使用方式:选择扫描模式。构建产物(推荐):npx se-scan --dir dist;源码入口:npx se-scan --entry src/index.ts。需要 TS/JSX 编译时保留 --compile(默认);扫描 --dir 时编译自动关闭。可选项目配置 .serc.ts,支持 alias 路径映射、maxDepth 限制依赖遍历、ignore 排除文件/行、adapter 适配自定义构建工具。常用命令:npx se-scan --dir dist --format md --output side-effect-report.md;npx se-scan --entry src/index.ts --format json --output side-effect-report.json。

解读发现:引用确切文件与位置,说明影响范围(全局或模块局部),评定严重级别(Critical/High/Medium/Low),给出具体修复(代码/配置)与验证步骤。验证:修复后重跑 se-scan 确认计数下降;位置映射错误时启用 sourcemap 并参考仓库 README 的 Common Issues;CSS Modules 误报可参考 CSS_MODULE_LOCAL_IDENT_NAME 指引。

适用场景:前端项目构建产物或源码入口的副作用审计,尤其涉及 CSS 全局污染、全局变量与事件监听器泄漏、动态 DOM 操作风险时。

限制:具体收费、价格、平台支持范围、效果数据暂未提供;需依赖 @module-federation/side-effect-scanner 及 Node 环境运行 npx 命令。