Files
lyun f1a2fbd494 统一:DSH 智能分析、Top100 与图表静默恢复
接入 DSH 专用运行时和对话界面,保留模型原始回答,支持会话分页、连续追问与显式报告。
补齐组合筛选、各维度 Top100、分组查询到排名图的转换,图表故障静默省略并基于保存数据自动恢复。
优化报告风格、图表顺序和表格换行,更新接入说明及构建输入。

验证:独立目录前后端构建通过;118 项 Java、102 项前端、102 项图表、14 项 DSH 应用和 13 项组合筛选检查通过。
仅提交相关源码、锁定依赖与测试;不包含凭据、会话、业务数据或本地产物。
2026-11-12 11:57:41 +08:00

126 lines
10 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""Shared capabilities for planning, querying, repair and evidence composition.
No KPI calculation or browser-success assertion belongs in this module.
"""
DEFAULT_QUALITY_ANALYSIS_POLICY = (
'【默认业务口径】未指定阶段的“不良/报废/废品TOP”按产品规格的黑片+亮片报废总重排序,附同规格正式综合合格率;'
'用户明确产业部或业务分组等排名维度时保留该维度;仅未明确排名对象时默认产品规格。'
'只有明确指定黑片/亮片/分别排名才拆阶段,只有明确指定缺陷/具体项目才转为来源缺陷排名。'
'合计报废总重不是把两套阶段Top拼接,也不是合并投入后重算率。'
'单期合计排名的root及ranking节点都必须stages=[]、fields=[rate,scrapWeight],dimensionStages对应维度=[];'
'root stages是输出口径,不能因数据来自黑片和亮片就写[black,bright]。'
'单个ranking节点即提供同一组Top产品的报废总重与综合率,不能额外用base metrics代替各规格合格率。'
'例如未限定阶段的产品不良TOP5:dimensions=[product]、stages=[]、fields=[rate,scrapWeight]、dimensionStages={"product":[]},'
'queryPlan=[{"nodeId":"rank","purpose":"ranking","dimension":"product","limit":5,"fields":["rate","scrapWeight"],'
'"stages":[],"selector":{"kind":"base"},"comparisonRequired":false,"visualType":"bar","visualPreference":"auto"}];'
'comparisonRequired=false、comparisonPeriod=null、trendRequired=false。追问TOP产品沿用期间、筛选和数量。'
'单期较差产品名单未问原因时,用静态合计ranking直接完成,数量按用户要求或当前展示策略;无需增加自主调查节点或额外比较期。'
'近期表现较差的产品以报废总重和综合率共同说明实际影响;未明确按最低率排名时,不能只选极小批量的零合格率。'
'按报废重量选出的Top只能支持所列对象之间的合格率比较;没有完整合格率排序证据,不能声称某项是整个授权总体的最低合格率。'
)
REPORT_STRUCTURE_INSTRUCTIONS = (
'【内容组织】根据本轮问题、实际证据和用户指定格式选择结构,不复用固定提纲或固定章节数。'
'用户明确要求的章节、标题、表格及无图要求优先;简单数值查询可只答一句,不强行生成报告。'
'只问单项指标时,首句先回答所问期间、对象和阶段的该指标;不自动追加未问阶段或其他指标的对比、解释和原因。'
'用户限定章节数量时,将简短概括放进第一章,不另设导语、摘要或总结章;按指定顺序使用Markdown章节标题。'
'趋势问题围绕时间变化和拐点,比较问题围绕可比口径和差异,排名问题围绕短表格和重点对象,'
'原件核对问题围绕核对结果、差异及尚缺证据,决策问题围绕有依据的选项与行动条件;'
'这些只是组织思路,不能逐项套成统一目录,不能为凑章节增加未问的内容。'
'一份报告只保留必要的标题和信息层次,不重复堆叠摘要、核心结论、总结和建议。'
'【阅读顺序】普通分析先用一到两句短句直接回答主要发现,再按本轮最重要的关系展开。'
'报告导读建议控制在约80—120字,只突出一到两个发现,不把全部阶段指标、重量和排名塞进开篇;用户另有限定时遵从用户。'
'报告先讲主要变化、差异与意义,月度逐项数据、重量及完整排名等明细表集中放在分析之后。平台会将可用图表放在报告前部。'
'标题应说明实际内容,不强制使用“核心发现”“摘要”等标签;简短回复不加大标题,正式报告才使用一个一级标题。'
'趋势分析优先呈现变化与拐点;对象比较先给差异再给对照表;排名先给有序短表再说明重点对象;'
'总体报告根据实际发现安排总体表现、主要差异或报废结构等必要章节,顺序随问题调整,不能把这些示例当作必填目录。'
'同一组数字集中呈现一次,正文只解释关键变化或差异,不复读整张表。导读已讲的结论,后文直接展开依据,不再用同义句总结。'
'已有图表展示的趋势,不另写图表说明式流水账;明细表每种数据只列一次,不为了排版重复总体、阶段或月度全表。'
'对话比较先给变化和必要的短对照表,若表格已足以回答,就不追加重复段落;追问直接回应新增问题,不重述上一轮整份报告。'
'一个段落只讲一个关系。仅在证据支持且用户需要时写行动建议;只保留影响本轮解读的具体范围或缺失,不固定增加口径、局限、建议和总结章。'
'含数值的句子应明确一个具体对象、阶段和指标;多个对象各写完整短句或各占一行表格,'
'不要用“均、各、分别”让多个对象共享一个数值或按长句位置猜测数值归属。表格每列只表示一种指标,投入与报废分列。'
'responseStyle=brief或用户要求简短时,只保留直接回答原问题的关系与必要短表,不扩展成整套通用调查报告。'
'简短报告只解释最关键的一到两个已核实关系,其他数值留在正式表格,不逐行复述全部调查结果。'
'用户要求一句重点结论时,应点明证据支持的实际主要发现,不能用“如下”或“见表”等引导句替代结论。'
)
CAPABILITY_INSTRUCTIONS = (
'【平台能力与职责】正式质量指标由quality_data服务端计算和核对,模型不得自行重算或补造。'
'正式黑片修正分母可能产生超过100%的合法黑片率和综合率;有效正式值照常引用,不截断、不仅因超过100%判异常。'
'平台根据已核实的quality_data结果及任务的visualPreference/visualType自动准备并展示图表。'
'模型负责理解任务、选择查询与事实、解释和组织文字,不需要输出图片、HTML、SVG或绘图代码,'
'不需要寻找绘图工具、探测图表服务或让用户另行生成图表。'
'不要调用原生display_chart:它读取原生SQL查询结果,与quality_data来源不兼容;本平台图表不经过该工具。'
'用户要求受支持的图表时,取得相应数据并保留绘图意图即可完成模型职责;'
'不能因文字JSON通道不直接包含图片就声称无法生成图表,不能把已安排的图表写成后续建议。'
'模型无法观察浏览器渲染是否成功,不得声称已看见图表或替前端宣布渲染成功。'
'同轮复合目标可通过queryPlan拆成最多8个有界节点;root目标、filters和期间继续作为权威用户意图,'
'selector只说明对象来源,不得把子对象筛选回写root filters。'
) + REPORT_STRUCTURE_INSTRUCTIONS
def capability_context(task=None):
task = task if isinstance(task, dict) else {}
plan = task.get('queryPlan') if isinstance(task.get('queryPlan'), list) else []
node_summaries = []
for node in plan[:8]:
if not isinstance(node, dict):
continue
node_summaries.append({key: node[key] for key in
('nodeId', 'purpose', 'fields', 'stages', 'visualType',
'visualPreference', 'comparisonRequired', 'dimension', 'limit', 'sort', 'optional', 'selector')
if key in node})
return {
'metrics': {'owner': 'quality_data_server', 'modelMayRecalculate': False},
'charts': {
'owner': 'platform', 'source': 'verified_quality_data',
'supportedTypes': ['bar', 'column', 'line', 'area', 'heatmap', 'donut', 'pareto', 'waterfall'],
'preference': task.get('visualPreference', 'auto'),
'requestedType': task.get('visualType'),
'drawingToolRequired': False, 'modelCanObserveBrowserRendering': False,
},
'queryPlan': {'maxNodes': 8, 'maxScopedReads': 40,
'nodeSummary': node_summaries,
'periodOwner': 'rootTask', 'scopeOwner': 'protocolServer',
'source': 'verified_node_scope_protocol'},
}
QUALITY_NATIVE_TOOLS = frozenset({'read', 'list', 'grep', 'search', 'mcp_call', 'mcp_connect'})
QUALITY_DSH_TOOLS = frozenset({'mcp__quality__quality_data'})
def apply_platform_tools(payload, *, native_agent=False, runtime_engine='NAO'):
"""Expose tools compatible with platform evidence and answer completion."""
tools = payload.get('tools')
if runtime_engine not in ('NAO', 'DSH'):
raise ValueError('分析引擎无效。')
allowed = (QUALITY_DSH_TOOLS if runtime_engine == 'DSH' else
QUALITY_NATIVE_TOOLS if native_agent else QUALITY_NATIVE_TOOLS | {'story'})
# Clarification/warehouse selection are upstream stop conditions with native
# UI replies that this platform cannot consume. SQL, renderers and writers
# also use a different data/artifact lifecycle. Unknown tools stay disabled.
tools = tools if isinstance(tools, list) else []
kept = [tool for tool in tools if isinstance(tool, dict) and tool.get('type') == 'function'
and isinstance(tool.get('function'), dict) and isinstance(tool['function'].get('name'), str)
and tool['function'].get('name') in allowed]
if kept: payload['tools'] = kept
else: payload.pop('tools', None)
choice = payload.get('tool_choice')
kept_names = {tool['function']['name'] for tool in kept}
choice_name = choice.get('function', {}).get('name') if isinstance(choice, dict) and isinstance(choice.get('function'), dict) else None
if ((isinstance(choice, dict) and choice_name not in kept_names)
or not kept and choice in ('auto', 'required')):
payload.pop('tool_choice', None)
if not kept: payload.pop('parallel_tool_calls', None)
return payload
def primary_query_required(task):
"""A source-defect TOP does not need unrelated parent KPI prefetching."""
return not (task.get('kind') == 'analysis' and set(task.get('dimensions', [])) == {'defect'}
and not task.get('comparisonRequired') and not task.get('comparisonPeriod')
and not set(task.get('fields', [])) - {'scrapWeight'})