Files
AirCoding/AirPlan/docs/spec/AirPlanV2/lib/air_runtime/evidence_gate.py
AirCoding ae44be31d5 chore: push all design docs, V2 plan specs, and current working state
Includes AirPlan design documents, AircOding-alpha1-plan, AirPlanV2,
AirPlan-ParaV2, AirPlan-Para V1 reference docs, and all working code
changes across packages.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-12 17:12:29 +08:00

75 lines
2.8 KiB
Python
Executable File

"""
任务类型感知的证据门控 — V2 P0-1 修复。
替代 V1 无差别触发 AirXDB 的逻辑,根据任务特征差异化要求证据类型。
"""
from __future__ import annotations
import enum
from dataclasses import dataclass
class EvidenceClass(enum.Enum):
GUI_REQUIRED = "gui_required" # 需要截图/GUI 操作验证
NETWORK_REQUIRED = "network_required" # 需要抓包/流量验证
STATIC_ANALYSIS = "static_analysis" # 需要静态分析
CODE_ONLY = "code_only" # 代码级验证即可
@dataclass
class EvidenceGatePolicy:
"""基于任务特征的差异化证据要求。
关键词匹配 → 确定性分类,零额外 API 调用,可测试可覆盖。
用户可在 todo.md 中用 [no-xdb] / [no-ndb] 标记显式跳过。
"""
GUI_INDICATORS: tuple[str, ...] = (
"gui", "ui", "render", "layout", "dialog", "osd",
"overlay", "visual", "screenshot", "display",
"widget", "pane", "toolbar", "settings_dialog",
"canvas", "button", "window", "popup", "menu",
"drm", "kms", "opengl", "vulkan",
)
NETWORK_INDICATORS: tuple[str, ...] = (
"network", "rtsp", "http", "tcp", "udp", "tls",
"dns", "proxy", "socket", "stream", "port",
"packet", "pcap", "bandwidth", "latency",
)
STATIC_ANALYSIS_INDICATORS: tuple[str, ...] = (
"cppcheck", "clang-tidy", "mypy", "ruff", "lint",
"static analysis", "compile_commands",
)
SKIP_MARKERS: tuple[str, ...] = ("[no-xdb]", "[no-ndb]", "[no-sdb]")
def classify(self, task_text: str, task_id: str = "", skip_overrides: list[str] | None = None) -> EvidenceClass:
text = task_text.lower()
skips = set(skip_overrides or [])
for marker in self.SKIP_MARKERS:
if marker in text:
skips.add(marker)
has_gui = any(kw in text for kw in self.GUI_INDICATORS)
has_net = any(kw in text for kw in self.NETWORK_INDICATORS)
has_static = any(kw in text for kw in self.STATIC_ANALYSIS_INDICATORS)
if has_gui and "[no-xdb]" not in skips:
return EvidenceClass.GUI_REQUIRED
if has_net and "[no-ndb]" not in skips:
return EvidenceClass.NETWORK_REQUIRED
if has_static and "[no-sdb]" not in skips:
return EvidenceClass.STATIC_ANALYSIS
return EvidenceClass.CODE_ONLY
def required_evidence_for(self, evidence_class: EvidenceClass) -> list[str]:
evidence_map = {
EvidenceClass.GUI_REQUIRED: ["screenshot", "gui-operation-validation"],
EvidenceClass.NETWORK_REQUIRED: ["packet-capture", "connectivity-verification"],
EvidenceClass.STATIC_ANALYSIS: ["static-analysis-report"],
EvidenceClass.CODE_ONLY: ["code-review", "test-results"],
}
return evidence_map.get(evidence_class, ["code-review"])