"""Render release-bound query facts; neither the model nor rendering changes KPIs.""" import json from decimal import Decimal, InvalidOperation, ROUND_HALF_UP try: from .nao_period import PERIOD_KEYS, normalize_period except ImportError: from nao_period import PERIOD_KEYS, normalize_period def number(value): if value is None or isinstance(value, bool): return None try: result=Decimal(str(value)) return result if result.is_finite() else None except InvalidOperation:return None def shown(value, percent=False, signed=False): value=number(value) if value is None:return '—' if percent:value*=100 value=value.quantize(Decimal('.01'),rounding=ROUND_HALF_UP) return ('+' if signed and value>0 else '')+f'{value:,.2f}'+('%' if percent else '') def difference(current,previous): a,b=number(current),number(previous) return a-b if a is not None and b is not None else None def change_text(value): value=number(value) if value is None:return '不可比' return ('上升' if value>0 else '下降' if value<0 else '持平')+(shown(abs(value))+'个百分点' if value else '') def product_input_text(item, stage): now=item.get('current') or {};before=item.get('comparison') or {} if stage in ('black','bright'): label='黑片' if stage=='black' else '亮片' return f'{label}投入{shown(before.get("totalWeight"))}→{shown(now.get("totalWeight"))} kg' return ('黑片投入'+shown(before.get('blackInputWeight'))+'→'+shown(now.get('blackInputWeight'))+' kg;' +'亮片投入'+shown(before.get('brightInputWeight'))+'→'+shown(now.get('brightInputWeight'))+' kg') def product_priority_summary(signals, stage): """Keep size, change, and rate as distinct investigation signals.""" if not isinstance(signals, dict):return '' parts=[] for key, prefix, field in (('scrapIncrease','报废增量首位','scrapDelta'), ('currentScrap','本期报废重量首位','currentScrap'), ('rateDrop','率降幅首位','rateDrop')): rows=signals.get(key) if not isinstance(rows,list) or not rows or not isinstance(rows[0],dict):continue row=rows[0];label=str(row.get('label') or row.get('key') or '') if not label:continue if field=='currentScrap':value=shown((row.get('current') or {}).get('scrapWeight'))+' kg' elif field=='rateDrop':value=change_text(-number(row.get('rateDrop'))*100) if number(row.get('rateDrop')) is not None else '不可比' else:value=shown(row.get('scrapDelta'),signed=True)+' kg' if field=='rateDrop':value+=';'+product_input_text(row,stage) parts.append(prefix+label+'('+value+')') return ('多维核查线索:'+';'.join(parts)+'。三种排序各有分母和含义,不能相加为总体贡献或视为现场原因。') if parts else '' def scope(value):return {k:v for k,v in (value or {}).items() if v not in (None,False,'',{},[])} def cell(value):return str(value).replace('|','\\|').replace('\n',' ') def period(value): try: value=normalize_period(value) or {} except ValueError: value=value if isinstance(value,dict) else {} if 'monthStart' in value: if value['monthStart'] == value['monthEnd']: return f"{value['year']}年{value['monthStart']}月" return f"{value['year']}年{value['monthStart']}–{value['monthEnd']}月" return str(value.get('year',''))+'年'+(str(value['month'])+'月' if value.get('month') else '第'+str(value['quarter'])+'季度' if value.get('quarter') else '') FILTER_KEYS=('department','group','product','projectGroup','extraFilters','columnFilters','exclusions','includeUnassigned') def _period_key(value): if value is None: return None try: value=normalize_period(value) except ValueError: return None return tuple(value.get(k) for k in PERIOD_KEYS) def _filters(value): return scope({k:v for k,v in (value or {}).items() if k in FILTER_KEYS}) def _frame(result): def canonical_period(value): if value in (None,{}):return {} try:return normalize_period(value) or {} except ValueError:return {'__invalid__':value} return {'period':canonical_period((result.get('current') or {}).get('period')), 'comparisonPeriod':canonical_period((result.get('comparison') or {}).get('period')), 'filters':_filters(result.get('filterBinding'))} def _frame_key(result): return json.dumps(_frame(result),ensure_ascii=False,sort_keys=True) def _matches_context(result, context): context=context if isinstance(context,dict) else {} try: from .nao_agent_task import task_from_context except ImportError: from nao_agent_task import task_from_context task = task_from_context(context) if task is not None and not (task.get('kind') == 'report' and task.get('historyMode') == 'all'): # An AI-resolved empty filter is an explicit overall task. A local # drilldown must not replace or make its overall comparison ambiguous. if _filters(result.get('filterBinding')) != _filters(task.get('filters', {})): return False selected=context.get('period') or context.get('currentPeriod') or context if (isinstance(task,dict) and isinstance(task.get('period'),dict) and 'monthStart' in task['period'] and not (isinstance(selected,dict) and any(key in selected for key in PERIOD_KEYS))): selected=task['period'] if not isinstance(selected,dict): return False expected={k:selected[k] for k in PERIOD_KEYS if k in selected} actual=(result.get('current') or {}).get('period') or {} # A frozen year without month/quarter denotes the whole year, not any month in it. if expected: if _period_key(expected) is None or _period_key(actual) is None or _period_key(expected)!=_period_key(actual):return False prior=context.get('comparisonPeriod') if isinstance(prior,dict) and (_period_key(prior) is None or _period_key((result.get('comparison') or {}).get('period'))!=_period_key(prior)):return False filters=context.get('filters') if isinstance(context.get('filters'),dict) else context # Empty extension filters/default booleans do not declare an overall scope. # A same-turn local query may express a new user condition absent from the # inherited UI context; keep such frames separate when no scope is pinned. if any(filters.get(k) not in (None,'',{},[]) for k in ('department','group','product','projectGroup','extraFilters','columnFilters','exclusions')): if _filters(filters)!=_filters(result.get('filterBinding')):return False elif 'includeUnassigned' in filters: if bool(filters.get('includeUnassigned'))!=bool((result.get('filterBinding') or {}).get('includeUnassigned')):return False return True def _scope_label(filters): names={'department':'产业部','group':'业务分组','product':'规格','projectGroup':'项目组', 'extraFilters':'扩展筛选','columnFilters':'来源列条件','exclusions':'排除条件','includeUnassigned':'包含未分类'} parts=[] for key,value in _filters(filters).items(): if key=='columnFilters': for rule in value: stage='、'.join({'black':'黑片','bright':'亮片'}.get(s,s) for s in rule.get('stages',[])) operation={'in':'为','not_in':'排除','is_empty':'为空','not_empty':'不为空'}.get(rule.get('operator'),'') parts.append(stage+'来源字段'+operation+'、'.join(rule.get('values',[]))) else: parts.append(names[key]+'='+str(value)) return ';'.join(parts) if parts else '当前授权范围内总体(默认不含未分类)' def _stage_gap(side,stage): # Coverage is the server-provided source-month signal. Do not recompute rates # or reject the original business formula merely because it exceeds 100%. from nao_quality_tools import _valid_stage_period_coverage coverage=side.get('coverage') if isinstance(side,dict) else None ok,reason=_valid_stage_period_coverage({'coverage':coverage},side.get('period') or {},stage) return None if ok else reason or '阶段来源覆盖不足。' def _stage_rate_gap(side,stage): from nao_quality_tools import _valid_stage_rate_reference if not isinstance(side,dict):return '缺少阶段快照。' snapshot={**side,'summary':{stage:side.get(stage)}} ok,reason=_valid_stage_rate_reference(snapshot,side.get('period') or {},stage) return None if ok else reason or '阶段合格率或投入依据缺失。' def _display_rate(side,stage=None): if stage: if _stage_rate_gap(side,stage):return None value=(side.get(stage) or {}).get('rate') rate=number(value) return value if rate is not None and rate>=0 else None from nao_quality_tools import _valid_composite_rate_reference ok,_=_valid_composite_rate_reference(side,side.get('period') or {}) return side.get('compositeRate') if ok else None def _same_periods(q,result): if q.get('kind')=='quality_comparison':return _frame_key(q)==_frame_key(result) current=q.get('currentPeriod') or q.get('period') prior=q.get('comparisonPeriod') return (isinstance(current,dict) and isinstance(prior,dict) and _period_key(current) is not None and _period_key(prior) is not None and _period_key(current)==_period_key((result.get('current') or {}).get('period')) and _period_key(prior)==_period_key((result.get('comparison') or {}).get('period'))) def select_comparison_frames(evidence, context=None): """Select the same verified period/scope frames for text and charts.""" comparisons=[d for d in evidence if d['result'].get('kind')=='quality_comparison'] if not comparisons:return [],[] # Exact frozen conditions take priority. Without a unique frame, retain # separately labelled comparisons instead of selecting the broadest query. unique={} for document in comparisons:unique[_frame_key(document['result'])]=document matches=[d for d in unique.values() if _matches_context(d['result'],context)] roots=matches or list(unique.values()) limitations=[] if not matches:limitations.append('查询证据未匹配本次提问的期间和范围,不能据此完成所要求的比较。') elif len(roots)>1: from nao_agent_task import task_from_context task = task_from_context(context) if not (task and task.get('historyMode') == 'all' and task.get('kind') == 'report'): limitations.append('本轮证据包含多个期间和范围,尚不能确定本次提问所指的比较对象;以下分别列示。') return roots,limitations def build_report(evidence, context=None, question=None): roots,limitations=select_comparison_frames(evidence,context) if not roots:raise ValueError('收尾缺少可绑定的正式期间比较') required_stage=(context or {}).get('stage') if isinstance(context,dict) else None if required_stage not in ('black','bright'):required_stage=None from nao_agent_task import task_from_context task = task_from_context(context) if (required_stage is None and task and task.get('kind') == 'metrics' and len(task.get('stages') or []) == 1): required_stage = task['stages'][0] scrap_rate_stages = set() if task and task.get('kind') == 'metrics' and 'scrapRate' in task.get('fields', []): selected_stages = task.get('stages') or ['black', 'bright'] scrap_rate_stages = {stage for stage in selected_stages if stage in ('black', 'bright')} reports=[_build_single_report(evidence,root,required_stage, scrap_rate_stages=scrap_rate_stages) for root in roots] if len(reports)==1: report=reports[0] else: report={'headline':limitations[0] if limitations else '已整合前述各范围的正式统计,以下分别列示。', 'sections':[], 'facts':[], 'policy':'来源细分按原表记录统计。', 'missingEvidence':[], 'rawMetrics':[]} for root,part in zip(roots,reports): q=root['result'];label=_scope_label(q.get('filterBinding'))+';'+period(q['comparison']['period'])+'→'+period(q['current']['period']) report['sections'].append('## '+label+'\n\n'+part['headline']+'\n\n'+'\n\n'.join(part['sections'])) for item in part['facts']: report['facts'].append({**item,'id':'F'+str(len(report['facts'])+1),'text':label+':'+item['text']}) report['missingEvidence'].extend(part['missingEvidence']);report['rawMetrics'].append(part['rawMetrics']) if 'VCM亮片仅录合计' in part['policy']:report['policy']=part['policy'] if question: from nao_analysis_coverage import coverage_gaps limitations.extend(coverage_gaps(evidence, question, context)) report['missingEvidence']=list(dict.fromkeys([*limitations,*report['missingEvidence']])) report['coverageSufficient']=not report['missingEvidence'] return report def _build_single_report(evidence, root, required_stage=None, *, scrap_rate_stages=None): result=root['result'];ref=root['evidenceRef'];current=result['current'];previous=result['comparison'] if (required_stage is None and (number(current.get('compositeRate')) is None or number(previous.get('compositeRate')) is None)): raise ValueError('正式综合率缺失') binding=scope(result.get('filterBinding'));a=period(previous.get('period',{}));b=period(current.get('period',{})) facts=[];sections=[] def fact(label,text,evidence_ref,kind): row={'id':'F'+str(len(facts)+1),'kind':kind,'label':label,'text':text,'evidenceRef':evidence_ref} facts.append(row);return row def bound_lead(entries): return ' '.join(item['text']+'['+item['evidenceRef']+']' for item in entries) def table(title,headers,rows,evidence_ref,notice='',lead=''): if not rows:return sections.append('### '+title+'\n\n'+(lead+'\n\n' if lead else '')+'| '+' | '.join(headers)+' |\n| '+' | '.join(['---']*len(headers))+' |\n' +'\n'.join('| '+' | '.join(cell(v) for v in row)+' |' for row in rows)+'\n\n['+evidence_ref+']'+(' '+notice if notice else '')) missing=[];display_gaps=[] for side in (previous,current): for stage in ('black','bright'): reason=_stage_gap(side,stage) or _stage_rate_gap(side,stage) if reason: display_gaps.append(reason) if required_stage==stage:missing.append(reason) if required_stage is None: for side in (previous,current): if _display_rate(side) is None: missing.append(f"{period(side.get('period',{}))}没有可引用的正式综合合格率或有效阶段来源覆盖。") delta_info=result.get('delta') or {} if required_stage is None and delta_info.get('available') is False:missing.append(delta_info.get('reason') or '服务端已标记本轮正式率不可比。') composite_delta=(delta_info.get('percentagePoints') if delta_info.get('available') is not False and _display_rate(previous) is not None and _display_rate(current) is not None else None) if required_stage is None and delta_info.get('available') is not False and number(composite_delta) is None: missing.append('服务端未提供可引用的正式综合率变化值。') main_label={'black':'黑片合格率','bright':'亮片合格率'}.get(required_stage,'综合合格率') delta=(result.get('stageRateChangesPP') or {}).get(required_stage) if required_stage else composite_delta if required_stage and number(delta) is None:missing.append(main_label+'的正式变化不可比;不以其他阶段或综合率替代。') if missing:delta=None headline=f'{main_label}:{a}{shown(_display_rate(previous,required_stage),True)}→{b}{shown(_display_rate(current,required_stage),True)},{change_text(delta)}。[{ref}]' fact(main_label,headline.split('。[')[0]+'。',ref,'stage' if required_stage else 'overall') rows=[['综合合格率',shown(_display_rate(previous),True),shown(_display_rate(current),True),shown(composite_delta,signed=True)+' pp' if number(composite_delta) is not None else '不可比']] stage_leads=[] for stage,label in (('black','黑片'),('bright','亮片')): now=current.get(stage) or {};before=previous.get(stage) or {};rate_delta=(result.get('stageRateChangesPP') or {}).get(stage) before_covered=not _stage_gap(previous,stage) now_covered=not _stage_gap(current,stage) if _stage_rate_gap(previous,stage) or _stage_rate_gap(current,stage):rate_delta=None old_rate,new_rate=_display_rate(previous,stage),_display_rate(current,stage) rows.append([label+'合格率',shown(old_rate,True),shown(new_rate,True),shown(rate_delta,signed=True)+' pp' if number(rate_delta) is not None else '不可比']) stage_fact=fact(label+'合格率',f'{label}合格率:{shown(old_rate,True)}→{shown(new_rate,True)},{change_text(rate_delta)}。',ref,'stage') if all(number(value) is not None for value in (old_rate,new_rate,rate_delta)):stage_leads.append(stage_fact) for key,name in (('totalWeight','投入重量'),('scrapWeight','报废重量')): before_value=before.get(key) if before_covered else None now_value=now.get(key) if now_covered else None delta_value=difference(now_value,before_value) if before_covered and now_covered else None rows.append([label+name,shown(before_value),shown(now_value),shown(delta_value,signed=True)]) table('总体与阶段',['指标',a,b,'变化'],rows,ref,'重量单位:kg;率变化单位:百分点(pp)。',bound_lead(stage_leads)) if scrap_rate_stages: rate_rows=[] for stage in ('black','bright'): if stage not in scrap_rate_stages: continue stage_label='黑片' if stage=='black' else '亮片' before=(previous.get(stage) or {}).get('scrapRate') now=(current.get(stage) or {}).get('scrapRate') from nao_quality_tools import _valid_stage_scrap_rate_reference before_ok,_=_valid_stage_scrap_rate_reference(previous,previous.get('period') or {},stage) now_ok,_=_valid_stage_scrap_rate_reference(current,current.get('period') or {},stage) before_text=shown(before,True) if before_ok else '—' now_text=shown(now,True) if now_ok else '—' rate_rows.append([stage_label+'报废率',before_text,now_text]) fact_text=f'{stage_label}报废率:{before_text}→{now_text}。' fact(stage_label+'报废率',fact_text,ref,'stage') if not before_ok: missing.append(f'{stage_label}{period(previous.get("period",{}))}正式报废率未提供或阶段来源覆盖不足。') if not now_ok: missing.append(f'{stage_label}{period(current.get("period",{}))}正式报废率未提供或阶段来源覆盖不足。') table('正式报废率',[ '指标',a,b ],rate_rows,ref, '直接引用服务端正式报废率;黑片使用修正后总重作为分母,不在此处重算或推导变化。') rows=[];category_leads=[] for stage,label in (('black','黑片'),('bright','亮片')): candidates=[] now=current.get(stage) or {};before=previous.get(stage) or {} old={x['name']:x.get('weight') for x in before.get('defects',[])} for item in now.get('defects',[]): name=item['name'];weight=item.get('weight');delta=difference(weight,old.get(name)) rows.append([label+'·'+name,shown(old.get(name)),shown(weight),shown(delta,signed=True)]) entry=fact(label+'·'+name,f'{label}{name}:{shown(old.get(name))}→{shown(weight)} kg,增减{shown(delta,signed=True)} kg。',ref,'category') if number(delta) is not None:candidates.append((abs(number(delta)),entry)) if stage=='bright' and now.get('headquartersScrapWeight') is not None: rows.append(['亮片·本部报废',shown(before.get('headquartersScrapWeight')),shown(now.get('headquartersScrapWeight')),shown(difference(now.get('headquartersScrapWeight'),before.get('headquartersScrapWeight')),signed=True)]) if candidates:category_leads.append(max(candidates,key=lambda item:item[0])[1]) table('正式报废类别',['类别',a+'(kg)',b+'(kg)','增减(kg)'],rows,ref,lead=('本次已列类别的变化线索:'+bound_lead(category_leads)) if category_leads else '') for document in evidence: q=document['result'];reference=document['evidenceRef'] if q.get('kind')!='quality_changes' or not _same_periods(q,result):continue same=scope(q.get('filters'))==binding dimension=q.get('dimension') stage_name={'black':'黑片','bright':'亮片'}.get(q.get('stage'),'') rate_name=stage_name+'合格率' if stage_name else '综合率' weight_name=stage_name+'报废增量' if stage_name else '两阶段报废增量' if dimension in ('group','department') and same: rows=[];leaders=[] for item in q.get('rows',[]): now=item.get('current') or {};before=item.get('comparison') or {};drop=number(item.get('rateDrop'));delta=-drop*100 if drop is not None else None label=str(item.get('label') or item.get('key')) rows.append([label,shown(before.get('rate'),True)+'→'+shown(now.get('rate'),True),shown(delta,signed=True) if delta is not None else '不可比',shown(item.get('scrapDelta'),signed=True)]) entry=fact(label,f'{label}:{rate_name}{shown(before.get("rate"),True)}→{shown(now.get("rate"),True)},{change_text(delta)};{weight_name}{shown(item.get("scrapDelta"),signed=True)} kg。',reference,'group') entry.update(dimension=dimension, stage=q.get('stage'), rateDrop=item.get('rateDrop'), scrapDelta=item.get('scrapDelta')) if drop is not None:leaders.append((drop,entry)) lead=bound_lead([max(leaders,key=lambda item:(item[0]>0,abs(item[0])))[1]]) if leaders else '' table(stage_name+('业务分组变化' if dimension=='group' else '产业部变化'),['范围',rate_name+':比较期→本期','变化(pp)',weight_name+'(kg)'],rows,reference, '报废重量为两阶段描述,不作为单一阶段投入。' if not stage_name else '',('本次返回的组织中,'+lead) if lead else '') elif dimension=='product' and same: rows=[];product_leads=[] for item in q.get('rows',[])[:5]: now=item.get('current') or {};before=item.get('comparison') or {};label=str(item.get('label') or item.get('key')) drop=number(item.get('rateDrop'));rate_change=change_text(-drop*100 if drop is not None else None) input_text=product_input_text(item,q.get('stage')) rows.append([label,shown(now.get('scrapWeight'))+' / '+shown(item.get('scrapDelta'),signed=True), shown(before.get('rate'),True)+'→'+shown(now.get('rate'),True)+';'+rate_change,input_text]) entry=fact(label,f'{label}:{stage_name}报废{shown(before.get("scrapWeight"))}→{shown(now.get("scrapWeight"))} kg,增量{shown(item.get("scrapDelta"),signed=True)} kg;{rate_name}{shown(before.get("rate"),True)}→{shown(now.get("rate"),True)},{rate_change};{input_text}。'+ ('该项仅是率变化线索,不能单凭降幅判定为重点。' if q.get('sort')=='rate_drop' else ''), reference,'product_rate_signal' if q.get('sort')=='rate_drop' else 'product') entry.update(dimension='product', stage=q.get('stage')) product_leads.append(entry) order={'scrap_delta':'报废增量','current_scrap':'当前报废重量','rate_drop':'合格率降幅'}.get(q.get('sort'),'接口排序') title=(stage_name+'产品率变化线索' if q.get('sort')=='rate_drop' else stage_name+'重点产品')+'(按'+order+',本次返回前5)' caution=('应结合投入规模和报废增量判断,不能只凭率降幅确定重点。' if q.get('sort')=='rate_drop' else '报废增量也需对照投入规模与率变化;放量可能推高报废重量,本表不单独证明质量恶化或总体贡献。') priority_note=product_priority_summary(q.get('prioritySignals'),q.get('stage')) table(title,['规格','本期报废 / 增量(kg)',rate_name+':比较期→本期 / 变化','阶段投入:比较期→本期(kg)'],rows,reference, f'查询共有{q.get("totalRows","未知")}个对象,本节展示所返回排名的前5项。投入为分阶段重量,不等于产件数;{caution}', priority_note or ('' if q.get('sort')=='rate_drop' else bound_lead(product_leads[:1]))) vcm=False;cross=[] for document in evidence: q=document['result'];reference=document['evidenceRef'] if q.get('kind')!='quality_fine_defects' or not _same_periods(q,result):continue stage={'black':'黑片','bright':'亮片'}.get(q.get('stage'),'') vcm=vcm or any((c.get('expectedTotalsOnly') or {}).get('rows',0)>0 for c in q.get('categoryReconciliation',[])) values=[dict(zip(q.get('defectColumns',[]),row)) for row in q.get('defectValues',[])] totals_only={c.get('category') for key in ('categoryReconciliation','comparisonCategoryReconciliation') for c in q.get(key,[]) if (c.get('expectedTotalsOnly') or {}).get('rows',0)>0 and (c.get('expectedTotalsOnly') or {}).get('rows')==c.get('sourceRows')} usable=[row for row in values if number(row.get('currentWeight')) is not None and row.get('category') not in totals_only] usable.sort(key=lambda row:number(row['currentWeight']),reverse=True) same=scope(q.get('filters'))==binding if same and q.get('dimension')=='defect': rows=[];defect_leads=[] for item in usable[:5]: label=str(item.get('field'));rows.append([label,shown(item.get('comparisonWeight')),shown(item.get('currentWeight')),shown(item.get('deltaWeight'),signed=True) if item.get('deltaAvailable') is True else '不可比']) entry=fact(stage+'·'+label,f'{stage}{label}:{shown(item.get("comparisonWeight"))}→{shown(item.get("currentWeight"))} kg,增量{shown(item.get("deltaWeight"),signed=True) if item.get("deltaAvailable") is True else "不可比"}。',reference,'defect') entry.update(dimension='defect', stage=q.get('stage')) if item.get('deltaAvailable') is True and number(item.get('deltaWeight')) is not None:defect_leads.append((abs(number(item['deltaWeight'])),entry)) lead=bound_lead([max(defect_leads,key=lambda item:item[0])[1]]) if defect_leads else '' table(stage+'来源具体缺陷(按本期重量,前5)',['源字段',a+'(kg)',b+'(kg)','增量(kg)'],rows,reference,lead=lead) elif (usable and all(_filters(q.get('filters')).get(k)==v for k,v in binding.items()) and bool((q.get('filters') or {}).get('includeUnassigned'))==bool(binding.get('includeUnassigned'))): details=scope(q.get('filters'));label_prefix='·'.join(str(v) for k,v in details.items() if k in ('group','product')) for item in usable[:2]: label='·'.join(v for v in (label_prefix,stage,str(q.get('defect') or ''),str(item.get('field'))) if v) text=f'{label}:{shown(item.get("comparisonWeight"))}→{shown(item.get("currentWeight"))} kg,增量{shown(item.get("deltaWeight"),signed=True) if item.get("deltaAvailable") is True else "不可比"}。' entry=fact(label,text,reference,'cross');cross.append(entry) if cross: sections.append('### 已核对的组织/规格与缺陷联系\n\n'+'\n'.join('- '+item['text']+'['+item['evidenceRef']+']' for item in cross[:4])) omitted=[d['evidenceRef'] for d in evidence if d['result'].get('kind') in ('quality_changes','quality_fine_defects') and not _same_periods(d['result'],result)] if omitted:sections.append('其他期间证据未合并进上述比较:'+ '、'.join('['+r+']' for r in omitted)+'。') policy='范围:'+_scope_label(binding)+'。来源细分按原表记录统计。'+('VCM亮片仅录合计,细分为未提供/不适用,不表示零缺陷,正式总量保留。' if vcm else '') if required_stage:policy+=' 本轮关注'+{'black':'黑片','bright':'亮片'}[required_stage]+';其他阶段和综合率仅作同范围参考。' if display_gaps: policy+=' 未通过完整阶段率核验的阶段显示“—”,不把缺失阶段的默认rate=1解释为实测100%;综合率仅在每期至少一个阶段来源有效且服务端正式compositeRate存在时引用,沿用后端正式值、不重算。'+ ';'.join(dict.fromkeys(display_gaps))+'。' return {'headline':'范围:'+_scope_label(binding)+'。\n\n'+headline,'sections':sections,'facts':facts,'policy':policy,'missingEvidence':list(dict.fromkeys(missing)), 'rawMetrics':{'evidenceRef':ref,'current':current,'comparison':previous}} def render_report(report,selected_ids,missing): known={item['id']:item for item in report['facts']} if not selected_ids or len(selected_ids)>6 or any(not isinstance(key,str) or key not in known for key in selected_ids): raise ValueError('关注方向未引用真实事实') focus=[] for key in dict.fromkeys(selected_ids): item=known[key];focus.append('- '+item['text']+'['+item['evidenceRef']+']') return report['headline']+'\n\n'+'\n\n'.join(report['sections'])+'\n\n### 重点关注\n\n'+'\n'.join(focus)+'\n\n'+report['policy']+('\n\n未覆盖内容:'+';'.join(missing) if missing else '')