"""참조 획득 **사람 비교 화면**. ★판을 차릴 뿐 판정하지 않는다. 유료 0. 대상 하나마다 **나란히** 놓는다 — 원문 근거 어디서 이 대상이 나왔나 보낸 질의 실제로 검색에 나간 말 받은 후보 3~5장 **그림으로** 종류 판정 심판이 후보마다 무엇이라 했나 (종류·가시성만) 고른 참조 어느 것을 왜 골랐나 ★VLM 은 **종류와 가시성**만 봤다. 시대·국가·제조사·모델·고증 정확성·좋고 나쁨은 **안 물었다** — 그건 사람 몫이다. python tools/grounding_audit/ref_review.py """ from __future__ import annotations import html import json import sys from pathlib import Path from typing import Any, Dict, List, Sequence def _e(x: Any) -> str: return html.escape(str(x if x is not None else "")) STATUS_LABEL = { "selected": "골랐다", "no_match_after_retry": "두 라운드 다 봤는데 종류가 맞는 것이 없다", "retryable": "다 못 봤다 (없다는 뜻이 아니다)", } def _verdict_for(rd: Dict[str, Any], index: int) -> str: """후보 하나에 심판들이 뭐라 했나. ★해석 안 하고 **그대로** 적는다.""" out = [] for row in rd.get("eligibility") or (): if int(row.get("index") or 0) != index: continue for judge, v in sorted((row.get("by_judge") or {}).items()): if not v: out.append(f"{judge}: 답 없음") continue out.append(f"{judge}: 종류 {v.get('object_type_match')} · " f"보임 {v.get('visible')}") return " / ".join(out) or "—" def _cands(rd: Dict[str, Any], chosen_path: str) -> str: got = rd.get("downloaded_candidates") or [] if not got: return ('
이 라운드는 받은 사진이 0장입니다 — ' '검색이 아무것도 못 돌려줬습니다
') cells = [] for c in got: pick = " picked" if c["path"] == chosen_path else "" cells.append(f"""
후보 {_e(c['index'])}
{_e(c['index'])}{' · 고른 것' if pick else ''}
{_e(_verdict_for(rd, int(c['index'])))}
{_e(c.get('caption'))}
출처
""") return f'
{"".join(cells)}
' def _rounds(rec: Dict[str, Any]) -> str: out = [] for rd in rec.get("rounds") or (): q = rd.get("queries") or [] flat = [x for g in q for x in (g if isinstance(g, list) else [g])] out.append(f"""

라운드 {_e(rd['round_no'])} 받음 {_e(rd['received'])} · 판정 {_e(rd['downloaded'])} · 중복 {_e(rd['duplicate'])}

보낸 질의
    {''.join(f'
  • {_e(x)}
    • ' for x in flat) or '
  • 질의가 하나도 안 나갔습니다
    • '}
{_cands(rd, rec.get('chosen_path') or '')}

{_e(rd.get('decision', {}).get('why'))}

""") return "".join(out) def render(doc: Dict[str, Any]) -> str: recs = doc.get("records") or [] cards = [] for rec in recs: t = rec.get("target") or {} st = str(rec.get("status")) quotes = "".join( f"
  • {_e(o.get('source_quote'))}
    • " for o in (t.get("occurrences") or ())) chosen = rec.get("chosen_path") or "" cards.append(f"""
    {_e(t.get('owner_type'))} {_e(t.get('surface_form'))} {_e(t.get('final_id') or t.get('local_id'))} {_e(STATUS_LABEL.get(st, st))}

    원문 근거

      {quotes or '
    • —
      • '}

    겉모습 (모델이 적은 것)

    {_e(t.get('visual_brief'))}

    찾을 낱말

    {_e(', '.join(t.get('terms_native') or []))}

    고른 참조

    {f'' if chosen else '
    고른 것이 없습니다
    '}
    {_rounds(rec)}
    """) n_ok = sum(1 for r in recs if r.get("status") == "selected") return f""" 참조 획득 — 사람 검토

    참조 획득 — 사람 검토

    ★이 화면은 판정하지 않습니다. VLM 이 본 것은 「우리가 찾던 종류가 맞나」와 「또렷이 보이나」 둘뿐입니다. 시대·국가·제조사·모델·고증 정확성·좋고 나쁨은 묻지 않았습니다.
    고증이 맞는지 · 이 참조가 쓸 만한지는 사람이 봅니다.
    대상{len(recs)} 고름{n_ok} 못 고름{len(recs) - n_ok} 승인 논리 상한{_e(doc.get('approved_logical'))}
    {''.join(cards)}
    """ def main() -> int: if len(sys.argv) < 3: print(__doc__) return 2 doc = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8")) out = Path(sys.argv[2]) out.write_text(render(doc), encoding="utf-8") print(f"■ 적었다: {out}") print(" ★이 화면은 **판을 차릴 뿐** 판정하지 않는다.") return 0 if __name__ == "__main__": raise SystemExit(main())