feat: add pure decision core for adversarial filter (hash/fingerprint/canonical/flip)

app/question_gen/adversarial_filter.py

@@ -0,0 +1,92 @@
+"""Phase B 独立后置对抗过滤层 — 作弊者门 + 配对翻转门。
+
+在 Phase A 产物 accepted_questions.json 之上，用完整 inference agent 揪残余
+shortcut：作弊门（agent 秒杀=太简单，剔除）+ 翻转门（agent 答案须随问题翻转）。
+不改 Phase A 状态机；过滤进度存独立 adversarial_verdicts 表。
+
+设计: research-wiki/designs/2026-07-14-adversarial-question-gen-phaseB-design.md
+"""
+
+from __future__ import annotations
+
+import enum
+import hashlib
+import json
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from core.types import GeneratedQuestion
+
+
+class FlipDecision(enum.Enum):
+    """翻转门判定结果。"""
+
+    PASSED = "passed"
+    FILTERED_NO_FLIP = "filtered_no_flip"
+    FLIP_SKIPPED = "flip_skipped"
+
+
+def question_hash(question: GeneratedQuestion) -> str:
+    """题 payload（question+options+answer）的稳定 hash，防 JSON 变动误用旧 verdict。
+
+    参数:
+        question: 题目。
+
+    返回:
+        16 位十六进制摘要。
+    """
+    payload = json.dumps(
+        {
+            "question": question.question,
+            "options": list(question.options),
+            "answer": question.answer,
+        },
+        ensure_ascii=False,
+        sort_keys=True,
+    )
+    return hashlib.sha256(payload.encode("utf-8")).hexdigest()[:16]
+
+
+def agent_config_fingerprint(*, skill_mode: str, max_steps: int, model: str) -> str:
+    """agent 配置指纹（skill_mode/max_steps/model），变化则该题 verdict 作废。"""
+    raw = f"{skill_mode}|{max_steps}|{model}"
+    return hashlib.sha256(raw.encode("utf-8")).hexdigest()[:16]
+
+
+def canonical_answer_text(question: GeneratedQuestion, letter: str | None) -> str | None:
+    """把 agent 预测的选项字母映射为选项规范化文本；非法/越界返回 None。
+
+    镜像题选项会重洗牌，字母无语义，必须按选项文本比较。
+
+    参数:
+        question: 题目（提供 options）。
+        letter: agent 预测字母（大小写不敏感），None/空/越界视为无效。
+
+    返回:
+        去掉 "X. " 前缀的选项文本；无效时 None。
+    """
+    if not letter or not isinstance(letter, str):
+        return None
+    idx = ord(letter.strip().upper()) - ord("A")
+    if not 0 <= idx < len(question.options):
+        return None
+    opt = question.options[idx]
+    prefix = f"{letter.strip().upper()}. "
+    return opt[len(prefix):] if opt.startswith(prefix) else opt
+
+
+def judge_flip(*, p_text: str | None, q_text: str | None) -> FlipDecision:
+    """按 canonical 文本判翻转：任一无效→skipped；不同→passed；相同→filtered。
+
+    参数:
+        p_text: 原题 P 的 agent 所选 canonical 文本。
+        q_text: 镜像题 Q 的 agent 所选 canonical 文本。
+
+    返回:
+        FlipDecision。
+    """
+    if p_text is None or q_text is None:
+        return FlipDecision.FLIP_SKIPPED
+    if p_text.strip() != q_text.strip():
+        return FlipDecision.PASSED
+    return FlipDecision.FILTERED_NO_FLIP