74 lines
3.3 KiB
Python
74 lines
3.3 KiB
Python
"""Reader-facing text checks for new publications, never historical reads."""
|
|
from __future__ import annotations
|
|
|
|
import re
|
|
from typing import TYPE_CHECKING, Any
|
|
|
|
if TYPE_CHECKING:
|
|
from app.domain.schemas.answer_ui import ReportUiBlock
|
|
|
|
|
|
_execution_text = re.compile(
|
|
r"\b(?:execution_generation|handling_context|verification_ready|waiting_work_order|"
|
|
r"waiting_scada|returned_at|verified_through|required_samples|interval_seconds|"
|
|
r"knowledge_cutoff|batch_sequence|query_complete|evidence_id|action_id|run_id|"
|
|
r"task_id|source_session_id|approval_status|execution_status|verification_evidence_id|"
|
|
r"normal_day_count|baseline_method|selection_method|get_task_context|query_scada_readings|"
|
|
r"run_burst_location|publish_task_report|publish_task_progress)\b|"
|
|
r"\b(?:status|phase|interval)\s*[:=]|\b(?:mcp|recovery|sha256):|"
|
|
r"\bskill(?:\.(?:name|version))?\s*[:=]|\bskill\s+[\w-]+\s+v?\d|"
|
|
r"\b(?:final|interim)/concluded\b|"
|
|
r"[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}",
|
|
re.IGNORECASE | re.ASCII,
|
|
)
|
|
_source_time = re.compile(
|
|
r"\d{4}-\d{2}-\d{2}T\d{2}:\d{2}|UTC\s*[+-]\s*\d|Asia/Shanghai|上海时间|"
|
|
r"\d{2}:\d{2}(?::\d{2})?\s*\+\d{2}:\d{2}",
|
|
re.IGNORECASE,
|
|
)
|
|
_unrendered_markup = re.compile(r"`|\*\*|</?[A-Za-z][^>]*>|^\s{0,3}#{1,6}\s", re.MULTILINE)
|
|
|
|
|
|
def validate_report_text(value: str) -> str:
|
|
if _execution_text.search(value):
|
|
raise ValueError("请将执行字段和状态码改写为中文业务说明，完整编号保留在结构化引用中")
|
|
if _source_time.search(value):
|
|
raise ValueError("请将来源时间转换为当地日期和时刻，正文省略时区名称、偏移和 ISO 时间戳")
|
|
if _unrendered_markup.search(value):
|
|
raise ValueError("可见文字使用纯文本；重点与明细使用对应结果组件，不写 Markdown 或 HTML")
|
|
return value
|
|
|
|
|
|
def validate_report_ui_text(blocks: list[ReportUiBlock]) -> None:
|
|
for item in blocks:
|
|
validate_report_text(item.block.fallback_text)
|
|
for element in item.block.spec.elements.values():
|
|
props = element.props
|
|
for key in ("title", "summary", "text", "description", "x_axis_name", "y_axis_name"):
|
|
if isinstance(props.get(key), str):
|
|
validate_report_text(props[key])
|
|
for value in props.get("columns", []):
|
|
validate_report_text(value)
|
|
for row in props.get("rows", []):
|
|
for value in row:
|
|
validate_report_text(value)
|
|
for value in props.get("x_data", []):
|
|
validate_report_text(value)
|
|
for series in props.get("series", []):
|
|
validate_report_text(series["name"])
|
|
|
|
|
|
def validate_presentation_command_text(command: dict[str, Any]) -> None:
|
|
"""Check visible labels without touching geometry, references or timestamps."""
|
|
if command["action"] == "set_overlay":
|
|
validate_report_text(command["title"])
|
|
elif command["action"] == "open_chart":
|
|
chart = command["chart"]
|
|
for key in ("title", "x_axis_name", "y_axis_name"):
|
|
if isinstance(chart.get(key), str):
|
|
validate_report_text(chart[key])
|
|
for value in chart["x_data"]:
|
|
validate_report_text(value)
|
|
for series in chart["series"]:
|
|
validate_report_text(series["name"])
|