SuperAPI AI 工具集

mantis-dedupe

安全与审计

查看项目

更新于 10-15 21:54

技能介绍

用途:mantis-dedupe(命令 /mantis-dedupe)是安全发现去重器,读取 workspace/findings/ 下的原始发现 JSON,将指向同一安全缺陷或相邻代码路径的重复项合并为单条记录,供后续流程使用。

主要能力:读取当前发现与 workspace/archive/ 下历史 pass 的发现,跳过已评估项;对重复项设置 status 为 DUPLICATE 与 duplicate_of 并移入 workspace/findings/.trash/;对未匹配项设置软提示 possible_duplicate_of;为缺失 discovery_commit 的当前发现打标;生成并执行 workspace/helpers/merge_findings.py 合并字段与历史;事务日志追加到 workspace/.tx_log.jsonl。采用三级去重阶梯:Tier 1 精确启发式锚点(签名、文件路径+CWE+符号、行邻近窗口),Tier 2 生成五行 RCA 摘要,Tier 3 向量嵌入与余弦相似度扫描,默认阈值 0.90,低于 0.70 视为不同类;并有 CWE 家族结构守卫防止误合并。

使用方式:由编排器调用,可选参数 --snapshot_root、--snapshot_id、--state_root;全部缺省时进入 MODE-OFF/legacy 模式。先做定位解析确定 CODE_ROOT,再执行去重。快照门控下,当前与归档发现的 discovery_commit 逐字节相等才判 MATCHED 并软删除;否则保持 ACTIVE 并设 possible_duplicate_of。已解决的历史发现若未匹配,标记 POSSIBLE REGRESSION 且不丢弃。

适用场景:安全研究流程中原始发现生成后、进入分诊或报告前的合并阶段。

限制:要求 workspace/findings/ 存在且含发现文件,否则提示并退出;忽略隐藏文件与 .trash/;不读取 workspace/historical_learnings.jsonl;快照固定时禁止写入 CODE_ROOT;发现数量多时采用 Map/Reduce 分块。具体配置项与更多细节暂未提供。