From 8137f0cf37e7f3c1b1894a0af0c3aa29eed4928d Mon Sep 17 00:00:00 2001 From: ThearchyHelios Date: Wed, 21 Oct 2026 13:07:36 +0800 Subject: [PATCH] =?UTF-8?q?=E5=88=86=E6=9E=90=E5=A5=91=E7=BA=A6=E8=A1=A5?= =?UTF-8?q?=E4=B8=A4=E6=A0=B7=EF=BC=88=E5=8F=AA=E5=8A=A0=E4=B8=8D=E6=94=B9?= =?UTF-8?q?=EF=BC=89=EF=BC=9A=E7=AE=97=E5=AD=90=E3=80=81=E6=A8=A1=E5=BC=8F?= =?UTF-8?q?=E7=BB=99=E4=BA=BA=E7=9C=8B=E7=9A=84=E5=8F=AB=E6=B3=95=EF=BC=88?= =?UTF-8?q?OP=5FLABELS=E3=80=81MODE=5FLABELS=EF=BC=8Cmethod=5Flabel=20?= =?UTF-8?q?=E6=8B=BC=E6=88=90=E3=80=8C=E5=8F=98=E5=8C=96=E6=8B=86=E8=A7=A3?= =?UTF-8?q?=EF=BC=88=E5=8F=AF=E5=8A=A0=EF=BC=89=E3=80=8D=EF=BC=89=EF=BC=8C?= =?UTF-8?q?=E8=AF=81=E6=8D=AE=E9=9D=A2=E6=9D=BF=E3=80=81=E5=86=99=E4=BD=9C?= =?UTF-8?q?=E7=9B=AE=E5=BD=95=E3=80=81=E5=AE=A1=E8=AE=A1=E3=80=81=E5=AF=BC?= =?UTF-8?q?=E5=87=BA=E3=80=81=E5=8F=AF=E9=AA=8C=E8=AF=81=E6=8A=A5=E5=91=8A?= =?UTF-8?q?=E3=80=81=E8=A3=81=E5=88=A4=E6=91=98=E5=BD=95=E5=90=8C=E4=B8=80?= =?UTF-8?q?=E4=BB=BD=EF=BC=9B=E6=8C=89=E5=BD=A2=E7=8A=B6=E8=AE=A4=E4=B8=80?= =?UTF-8?q?=E4=BB=B6=E5=B7=A5=E4=BB=B6=E6=98=AF=E4=B8=8D=E6=98=AF=E5=88=86?= =?UTF-8?q?=E6=9E=90=E7=BB=93=E8=AE=BA=EF=BC=88is=5Fresult=EF=BC=9Aop=20?= =?UTF-8?q?=E6=98=AF=E4=BA=94=E4=B8=AA=E7=AE=97=E5=AD=90=E4=B9=8B=E4=B8=80?= =?UTF-8?q?=E3=80=81method=20=E6=98=AF=E6=96=87=E5=AD=97=E3=80=81inputs=20?= =?UTF-8?q?=E6=98=AF=E5=88=97=E8=A1=A8=EF=BC=89=EF=BC=8C=E8=AF=81=E6=8D=AE?= =?UTF-8?q?=E6=8E=A5=E5=85=A5=E5=8F=96=E5=9B=9E=E7=BB=93=E8=AE=BA=E5=B7=A5?= =?UTF-8?q?=E4=BB=B6=E3=80=81SQL=20=E9=97=AE=E9=A2=98=E9=A1=BA=E7=9D=80?= =?UTF-8?q?=E7=BB=93=E8=AE=BA=E7=9A=84=E8=BE=93=E5=85=A5=E5=BE=80=E4=B8=8B?= =?UTF-8?q?=E6=89=BE=E3=80=81=E5=8F=AF=E9=AA=8C=E8=AF=81=E6=8A=A5=E5=91=8A?= =?UTF-8?q?=E8=AE=A4=E5=B5=8C=E8=BF=9B=E6=9D=A5=E7=9A=84=E5=B7=A5=E4=BB=B6?= =?UTF-8?q?=E9=83=BD=E6=8C=89=E5=AE=83=E8=AE=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- backend/app/analysis/contract.py | 26 +++++++++++++++++++++++--- 1 file changed, 23 insertions(+), 3 deletions(-) diff --git a/backend/app/analysis/contract.py b/backend/app/analysis/contract.py index e70d4cf8..4b75b14d 100644 --- a/backend/app/analysis/contract.py +++ b/backend/app/analysis/contract.py @@ -53,6 +53,26 @@ METHODS: dict[tuple[str, str | None], str] = { } #: agent 分析工具的名字(tools/builtin 里注册),一个算子一个工具:参数各自聚焦,模型少写错 TOOL_NAMES: dict[str, str] = {op: f"analysis_{op}" for op in OPS} +#: 算子、模式给人看的叫法:证据面板、写作目录、审计、导出、可验证报告、裁判摘录都用它(method_label 拼成一句) +OP_LABELS: dict[str, str] = { + "decompose": "变化拆解", "baseline": "波动基线", "trend": "趋势", "differ": "差异检验", "comparable": "可比性检查", +} +MODE_LABELS: dict[str, str] = { + "additive": "可加", "ratio": "比率", "factor": "乘积", "rate": "比率", "mean": "均值", "rows": "逐行明细", +} + + +def method_label(op: Any, mode: Any = None) -> str: + """「变化拆解(可加)」「波动基线」。认不出的算子、模式原样写出来,不编叫法。""" + name = OP_LABELS.get(str(op or ""), str(op or "")) + return f"{name}({MODE_LABELS.get(str(mode), str(mode))})" if mode else name + + +def is_result(content: Any) -> bool: + """一件工件的内容是不是分析结论:按形状认(op 是五个算子之一、method 是文字、inputs 是列表)。证据接入取回 ARTIFACT_KIND + 的工件、SQL 问题顺着输入往下找、可验证报告认嵌进来的工件,都按这一个函数认。""" + return isinstance(content, Mapping) and content.get("op") in OPS and isinstance(content.get("method"), str) \ + and isinstance(content.get("inputs"), list) #: 每个算子可能给出的判定(细案 01 §2–§6) VERDICTS: dict[str, tuple[str, ...]] = { @@ -374,8 +394,8 @@ def same(a: Mapping[str, Any], b: Mapping[str, Any]) -> bool: __all__ = [ "ARTIFACT_KIND", "CATALOG_PREFIX", "CAVEATS", "DEFAULTS", "LABELS", "LEDGER_KIND", "MARKER_KIND", "METHODS", "MODES", - "NODE_TYPE", "NOT_RECOMPUTED", "OPS", "RANGES", "REASONS", "SETTINGS_KEY", "TOOL_NAMES", "VERDICTS", - "AnalysisInput", "AnalysisRequest", "AnalysisResult", "CallError", "Caveat", "Context", "InputSnapshot", + "MODE_LABELS", "NODE_TYPE", "NOT_RECOMPUTED", "OPS", "OP_LABELS", "RANGES", "REASONS", "SETTINGS_KEY", "TOOL_NAMES", + "VERDICTS", "AnalysisInput", "AnalysisRequest", "AnalysisResult", "CallError", "Caveat", "Context", "InputSnapshot", "MetricComparability", "Probe", "Prober", "ResultTable", "ScopeBlock", "ScopeItem", "Verdict", "catalog_result", - "effective_settings", "ledger_entry", "same", "settings_problem", + "effective_settings", "is_result", "ledger_entry", "method_label", "same", "settings_problem", ]