用途:用于回答“改动这个函数安全吗”“修改 X 会破坏什么”“谁在用这段代码”,在非平凡代码变更前或提交前做安全影响分析。
主要能力:impact 工具分析符号的上游依赖,返回按深度划分的结果——d=1(WILL BREAK,直接调用方/导入方)、d=2(LIKELY AFFECTED,间接依赖)、d=3(MAY NEED TESTING,传递影响);支持 minConfidence(如 0.8)与 maxDepth 参数过滤。detect_changes 基于 git diff 做影响分析,可将当前变更映射到受影响的执行流。可读取 gitnexus://repo/{name}/processes 检查受影响的执行流。
工作流:1) impact({target: "X", direction: "upstream"}) 找出依赖方;2) 读取 processes 检查受影响执行流;3) detect_changes() 做提交前映射;4) 评估风险并报告。若提示“Index is stale”,需在终端运行 node .gitnexus/run.cjs analyze。
检查清单:用 impact 找依赖方,优先查看 d=1 项,检查高置信度(>0.8)依赖,读取 processes 检查执行流,用 detect_changes() 做提交前检查,并评估风险等级。
风险判定:受影响符号少于 5 且流程少为 LOW;5–15 个符号、2–5 个流程为 MEDIUM;超过 15 个符号或流程多为 HIGH;涉及认证、支付等关键路径为 CRITICAL。
示例:询问“改 validateUser 会破坏什么”,impact 返回 d=1 的 loginHandler、apiMiddleware(WILL BREAK)与 d=2 的 authRouter、sessionManager(LIKELY AFFECTED),再结合 LoginFlow、TokenRefresh 流程,判定风险为 MEDIUM。
限制:需先建立索引,否则提示索引过期;具体安装方式、支持语言与平台限制资料暂未提供。