SuperAPI AI 工具集

defense-in-depth

数据与分析

查看项目

更新于 10-15 22:39

技能介绍

用途:当无效数据在深层执行中引发故障时,采用纵深防御(Defense-in-Depth)校验,在数据经过的每一层做验证,而不只修一处检查点。核心理念是单个校验容易被其他代码路径、重构或 mock 绕过,多层校验让 bug 在结构上无法出现。

主要能力:分为四层。第一层入口校验,在 API 边界拒绝明显非法输入,例如检查 workingDirectory 非空、存在且为目录。第二层业务逻辑校验,确保数据对当前操作有意义,例如校验 projectDir 非空。第三层环境守卫,防止特定上下文中的危险操作,例如在测试环境拒绝在临时目录外执行 git init。第四层调试插桩,在操作前记录目录、工作目录和调用栈日志,便于事后取证。

使用方式:发现 bug 后,追踪数据流来源与使用点,列出数据经过的全部检查点,在每层补充校验,并逐层测试——尝试绕过第一层,验证第二层能否捕获。示例中空 projectDir 导致在源码目录运行 git init,四层分别由 Project.create()、WorkspaceManager、WorktreeManager 和 git init 前的栈日志拦截,最终 1847 个测试全部通过。

适用场景:多层数据传递的系统、测试与 mock 较多的代码库、跨平台边界情况。

限制:资料未提供具体安装命令、依赖或平台范围;四层是否全部必要需结合具体系统判断,避免重复校验带来的维护成本。