feat(judge): 以 Claim 审查指纹结果（合约下沉 utils/jev），并恢复 Go 1.17 支持

[M09Ic]

概要

在规则引擎之上加一层指纹判定 judge，设计见 #34。它只审查规则给出的结论，不做指纹识别，模型从不说出产品名。它不是新的引擎，WebMatch 和 DetectContent 的行为不变。

与指纹无关的通用机制放在 chainreactors/utils#12 的 github.com/chainreactors/utils/jev，fingers 不新增与指纹识别无关的抽象。通用机制包括 Claim 合约、校验、Provider 接口、批次缓存和 Jev HTTP 客户端。

分层

位置	内容
utils/jev	Claim / Option / Outcome / Ruling、Resolve、Validate*、Provider、jev.Judge、Cached、Client、DefaultMinConfidence=0.3
utils/parsers（#11）	Framework.Judge *Judgement，字段为 Option、Outcome、Confidence、Evidence、Rejected、Duplicate；另有 Frameworks.Accepted()
fingers/judge	Judge{Provider, MinConfidence, DropInsufficient}、New、Inspect、Version；presence 选项有 declared、absent、running、mentioned、unrelated。代码确定的事实也表达为同一 Claim 的 Ruling
fingers/judge/maintain	Ledger：根据 presence 注解统计垃圾规则。Discover：把多个主机上的同一页面聚成簇，每簇提出一个 Coverage Claim
fingers/judge/gen	为人给定的产品名，用正反样本生成原生规则
fingers 引擎	Engine.EnableMatchDetail()：fingers、fingerprinthub、wappalyzer、ehole、goby 记录命中原文，供 Claim 引用证据

用法

普通用户只需配置一个 key：

engine, _ := fingers.NewEngine()
engine.EnableJudge("")                 // 空字符串读取 TYPESAFE_API_KEY
frames, _ := engine.DetectContent(raw) // WebMatch、Match、DetectResponse 同样生效：去掉误报和重复、补全版本

命令行：engine -u <url> --jev-key <KEY>。请求失败时返回纯规则结果；不调用 EnableJudge 时行为不变。需要全部注解或自定义策略时直接使用 judge 包：

j := judge.New(jev.Cached(c, jev.DefaultCacheSize))
all, err := j.Inspect(ctx, raw, hits) // 含被剔除条目及原因

漏报在离线维护中处理（judge/maintain.Discover → 人工命名 → judge/gen），更新到指纹库。文档见 judge/README.md 和 utils 的 jev/README.md。

本轮变更

• gen 改为 gen.New(j, name)；Via 头的协议版本和 SVG/XML 声明的格式版本不再作为版本候选。
• 所有判断都统一为 Claim。删除了 judge/jev、通用的 j.Judge、Refine / Classify / 召回，以及 Identify、Ask、Yes、Choose、Score 这几种题型。
• judge.New 的默认 MinConfidence 改为 jev.DefaultMinConfidence（0.3），与 Jev 标定值统一。
• 修复 alias 的 Attributes 被跨页面共享、导致版本号泄漏到后续页面的问题。

Go 1.17（沿用前几轮）

• go.mod 为 go 1.17。RE2 拆到子模块 github.com/chainreactors/fingers/re2，主模块默认使用标准库 regexp，通过 fingers.RegexpCompiler 切换。
• 实测：go1.17.13 下 go build ./... 与 judge 测试通过。

效果

2026-09-27 用当前代码在 69 份已标注真实响应上做真实 Jev 复测（jev-1.13.0，复测报告）：

指标	结果
有标注的误报	24 → 0
真实命中误删	0
版本	正确 36、错误 0，无依据填值 0
Ledger 前三	git、ipeakcms、webp_server_go
Discover，不加载新增规则	SearXNG、Wakapi、IT Tools 全部判 missing
Discover，加载新增规则	无误报警

规则引擎的合并结果现在可复现（原来依赖 map 遍历顺序）。确定性回归显示，judge 精简前后 Provider 请求与输出逐字节一致。

数据外发

发给 Provider 的是响应的精简视图：响应头、Cookie 名、标题、generator/description、脚本和样式路径、内联脚本开头、HTML 注释、表单字段名、正文前 1500 字，以及规则命中上下文。README 中已写明。

依赖与后续

• 依赖 feat(jev): Claim 判定合约与 Jev 客户端独立成模块 utils#12（jev）和 feat(parsers): Framework 新增 Judge 判定结论字段 utils#11（parsers），目前固定在两个 PR 的 commit 伪版本上，无 replace。合并后需要打 jev/v0.1.0、parsers/v0.0.4 并重新固定版本。
• re2 子模块合并后单独打 tag。

测试

• go vet ./judge/... ./cmd/...
• go test ./judge/... ./cmd/judgeeval .（go1.26）
• go1.17.13 下 go build ./... 与 go test ./judge/...

🤖 Generated with Claude Code