Files
yao-meta-skill/scripts/review_studio_output_review.py
T
2026-06-14 06:56:44 +08:00

85 lines
3.6 KiB
Python

#!/usr/bin/env python3
"""Output review HTML helpers for Review Studio."""
import html
from typing import Any
SCRIPT_INTERFACE = "internal-module"
SCRIPT_INTERFACE_REASON = "Imported by render_review_studio.py to render output review checklist cards."
def render_required_fields(fields: dict[str, Any]) -> str:
if not fields:
return "<p class='muted'>暂无字段要求。</p>"
items = []
for key, value in fields.items():
items.append(f"<li><strong>{html.escape(str(key))}</strong><span>{html.escape(str(value))}</span></li>")
return "<ul class='output-review-fields'>" + "".join(items) + "</ul>"
def render_command_list(commands: dict[str, Any]) -> str:
if not commands:
return "<p class='muted'>暂无命令。</p>"
items = []
for label, command in commands.items():
if not command:
continue
items.append(
"<li>"
f"<span>{html.escape(str(label))}</span>"
f"<code>{html.escape(str(command))}</code>"
"</li>"
)
return "<ul class='output-review-commands'>" + "".join(items) + "</ul>" if items else "<p class='muted'>暂无命令。</p>"
def render_contract(items: list[Any]) -> str:
if not items:
return "<p class='muted'>暂无边界。</p>"
return "<ul>" + "".join(f"<li>{html.escape(str(item))}</li>" for item in items) + "</ul>"
def render_output_review_checklist(adjudication: dict[str, Any]) -> str:
checklist = adjudication.get("reviewer_checklist", []) if isinstance(adjudication, dict) else []
if not checklist:
return "<p class='muted'>当前没有输出评审操作清单。</p>"
cards = []
for item in checklist:
readiness = str(item.get("readiness", "awaiting-decision"))
answer_key = "可见" if item.get("answer_key_visible") else "隐藏"
cards.append(
"<article class='output-review-card "
+ html.escape(readiness)
+ "'>"
f"<div><span>{html.escape(readiness)} · 答案{html.escape(answer_key)}</span>"
f"<h3>{html.escape(str(item.get('case_id', 'case')))}</h3></div>"
f"<p>{html.escape(str(item.get('blocking_reason', '')))}</p>"
f"<dl><dt>盲评包</dt><dd><code>{html.escape(str(item.get('blind_pack_path', '')))}</code></dd>"
f"<dt>决策表</dt><dd><code>{html.escape(str(item.get('decisions_path', '')))}</code></dd>"
f"<dt>提示词</dt><dd>{html.escape(str(item.get('prompt', '')))}</dd></dl>"
"<div class='output-review-steps'>"
"<div><h4>操作命令</h4>"
+ render_command_list(item.get("commands", {}) if isinstance(item.get("commands", {}), dict) else {})
+ "</div>"
"<div><h4>字段要求</h4>"
+ render_required_fields(item.get("required_fields", {}) if isinstance(item.get("required_fields", {}), dict) else {})
+ "</div>"
"<div><h4>隐私边界</h4>"
+ render_contract(item.get("privacy_contract", []) if isinstance(item.get("privacy_contract", []), list) else [])
+ "</div>"
"</div>"
"</article>"
)
return "<div class='output-review-grid'>" + "".join(cards) + "</div>"
def render_output_review_section(adjudication: dict[str, Any]) -> str:
return (
"<section>"
"<h2>评审清单</h2>"
"<p class='muted'>先打开 reports/output_review_kit.md;每张卡片对应一个 blind A/B case,说明当前是否待判、答案是否仍隐藏、应填写的决策文件、有效字段和复跑命令。</p>"
f"{render_output_review_checklist(adjudication)}"
"</section>"
)