kld-sdd 2.6.16 → 2.6.21

package/skywalk-sdd/reporting/change-report-renderer.cjs

@@ -14,24 +14,62 @@ function escapeHtml(value) {
 }
 
 function statusTone(status) {
-  if (['trusted', 'complete', 'passed', 'verified', 'implemented'].includes(status)) return 'good';
-  if (['attention', 'incomplete', 'provisional', 'needs_input', 'open'].includes(status)) return 'warn';
-  if (['failed', 'blocked', 'error'].includes(status)) return 'bad';
+  if (['trusted', 'complete', 'passed', 'verified', 'implemented', 'success', '可信', '已独立验证', '可计算'].includes(status)) return 'good';
+  if (['attention', 'incomplete', 'provisional', 'inconsistent', 'needs_input', 'open', '需补证', '尚未独立验证', '计算不一致'].includes(status)) return 'warn';
+  if (['failed', 'failure', 'blocked', 'error'].includes(status)) return 'bad';
   return 'neutral';
 }
 
-function metricCard({ name, code, value, state, explanation, source }) {
+function metricDrawerBody(detail, fallback) {
+  if (!detail) return fallback;
+  const inputs = (detail.raw_inputs || []).map((item) => {
+    const value = item.display_value ?? item.value ?? '暂无数据';
+    const exclusion = item.included === false
+      ? `；不计入公式：${item.exclusion_reason || '仅作辅助说明'}`
+      : '';
+    return `- ${item.label}：${value}\n  来源：${item.source || '未记录'}${exclusion}`;
+  });
+  const evidence = (detail.evidence || []).map(item => (
+    [
+      `- ${item.path || item.event_id || item.type || '证据'}${item.count == null ? '' : `（${item.count} 条）`}`,
+      ...(item.scenarios || []).map(scenario => `  - 场景：${scenario.title || '未命名'}（第 ${scenario.line ?? '未知'} 行）`),
+    ].join('\n')
+  ));
+  return [
+    `指标定义\n${detail.definition}`,
+    `指标用途\n${detail.purpose}`,
+    `计算公式\n${detail.formula}`,
+    `数据来源\n${detail.source_description}`,
+    `对应方案\n${detail.scheme_reference}`,
+    `本次原始数据\n${inputs.join('\n') || '- 暂无可展示的原始数据'}`,
+    `计算步骤\n${(detail.calculation_steps || []).map(step => `- ${step}`).join('\n') || '- 暂无可复算步骤'}`,
+    `本次结果\n${detail.result?.display_value || '暂无数据'}\n可信度：${detail.trust?.explanation || '未记录'}`,
+    `证据与限制\n${[...evidence, ...(detail.caveats || []).map(item => `- ${item}`)].join('\n') || '- 暂无可定位证据'}`,
+  ].join('\n\n');
+}
+
+function metricCard({
+  name,
+  code,
+  value,
+  state,
+  state_code: stateCode,
+  explanation,
+  source,
+  detail,
+}) {
+  const drawerBody = metricDrawerBody(detail, source || explanation);
   return `<article class="metric-card">
     <div class="metric-top"><span>${escapeHtml(name)}</span><span class="metric-code">${escapeHtml(code)}</span></div>
     <strong>${escapeHtml(value)}</strong>
-    <div class="metric-state ${statusTone(state)}">${escapeHtml(state || '暂定')}</div>
+    <div class="metric-state ${statusTone(stateCode || state)}">${escapeHtml(state || '暂定')}</div>
     <p>${escapeHtml(explanation)}</p>
-    <button class="info-btn" type="button" data-info="${escapeHtml(source || explanation)}" data-drawer-title="${escapeHtml(`${name} · ${code}`)}" data-drawer-body="${escapeHtml(source || explanation)}">查看计算口径与证据</button>
+    <button class="info-btn" type="button" data-info="${escapeHtml(source || explanation)}" data-drawer-title="${escapeHtml(`${detail?.name || name} · ${code}`)}" data-drawer-body="${escapeHtml(drawerBody)}">查看计算口径与证据</button>
   </article>`;
 }
 
 function renderChangeReportHtml(report) {
-  if (!report.change_summary || !report.artifacts?.files) {
+  if (!report.change_summary || !report.artifacts?.files || !report.metric_details) {
     report = buildChangeReportModel(report);
   }
   const view = buildChangeReportViewModel(report);
@@ -50,12 +88,23 @@ function renderChangeReportHtml(report) {
   const conclusionTone = statusTone(view.conclusion?.status);
   const evidenceCategories = evidence.categories;
   const stageNodes = metricsSection.stages || [];
-  const activeLinks = artifactSection.attribution?.active_links || [];
-  const candidateIds = artifactSection.attribution?.unassigned_candidate_event_ids || [];
   const knownWarnings = view.known_risks?.warnings || [];
-  const warningDetails = knownWarnings.flatMap((warning) => (
-    Array.isArray(warning.items) ? warning.items : []
-  ));
+  const riskRows = knownWarnings.flatMap((warning) => {
+    const items = Array.isArray(warning.items) && warning.items.length > 0
+      ? warning.items
+      : [{ description: `${warning.command || '检查'} 阶段记录了 ${warning.warnings || 0} 个提醒` }];
+    return items.map(item => ({
+      ...item,
+      status_label: ({
+        fixed: '已解决',
+        accepted: '已接受，保留观察',
+        waived: '已豁免，不阻断',
+        ignored: '不重要，已标记',
+        needs_input: '等待补充信息',
+        open: '待处理',
+      }[item.disposition] || (warning.resolved === true ? '已解决' : '待确认')),
+    }));
+  });
   const telemetryWarnings = view.telemetry_warnings?.by_type || {};
   const artifactRows = artifacts.map((item) => `
     <tr>
@@ -74,18 +123,20 @@ function renderChangeReportHtml(report) {
         : (item?.size_bytes == null ? '—' : escapeHtml(item.size_bytes))}</td>
     </tr>`).join('');
   const evidenceRows = evidenceCategories.map((group) => {
-    const issueDetails = (group.issues || []).map((issue) => [
+    const issueDetails = (group.issues || []).map((issue) => {
+      const displayIssue = issueSection.issues.find(item => item.issue_id === issue.issue_id) || issue;
+      return [
       `问题：${issue.issue_id}`,
       `对象：${issue.subject || '本次变更'}`,
-      `状态：${issue.status}`,
-      `判定：${issue.verdict}`,
+      `状态：${displayIssue.status_label || issue.status}`,
       `根因：${issue.root_cause}`,
       `预期：${issue.expected}`,
       `实际：${issue.actual}`,
       `影响：${issue.impact}`,
       `修复建议：${issue.remediation}`,
       `证据事件：${(issue.evidence_event_ids || []).join('、') || '暂无可定位事件'}`,
-    ].join('\n')).join('\n\n');
+      ].join('\n');
+    }).join('\n\n');
     return `
     <article class="issue-row">
       <div><span class="issue-count">${escapeHtml(group.occurrence_count)}</span></div>
@@ -95,7 +146,7 @@ function renderChangeReportHtml(report) {
       </div>
       <button class="text-button drawer-trigger" type="button"
         data-drawer-title="${escapeHtml(group.label)}"
-        data-drawer-body="${escapeHtml(`${issueDetails || `规则编码：${group.code}\n状态：open\n根因：当前证据未满足规则\n预期：规则证据完整\n实际：证据不足\n修复建议：补充真实证据`}\n\n规则编码：${group.code}\n关联任务：${(group.affected_tasks || []).join('、') || '无'}\n事件：${(group.event_ids || []).join('、') || '无'}\n处置：${JSON.stringify(group.dispositions || {})}`)}">查看详情</button>
+        data-drawer-body="${escapeHtml(`${issueDetails || `规则编码：${group.code}\n状态：待处理\n根因：当前证据未满足规则\n预期：规则证据完整\n实际：证据不足\n修复建议：补充真实证据`}\n\n规则编码：${group.code}\n关联任务：${(group.affected_tasks || []).join('、') || '无'}\n事件：${(group.event_ids || []).join('、') || '无'}`)}">查看详情</button>
     </article>`;
   }).join('');
   const stageRows = stageNodes.map((node) => {
@@ -106,7 +157,7 @@ function renderChangeReportHtml(report) {
       <td>${escapeHtml(stage)}${round > 1 ? '²' : ''}${round > 1 ? '<span class="tl-repeat">R</span>' : ''}</td>
       <td>${escapeHtml(round)}</td>
       <td><span class="tl-time">${escapeHtml(node.display_start)}→${escapeHtml(node.display_end)}</span><br>${escapeHtml(node.display_duration)}</td>
-      <td><span class="state ${statusTone(node.display_result === 'success' ? 'passed' : node.display_result)}">${escapeHtml(node.display_result)}</span></td>
+      <td><span class="state ${statusTone(node.result)}">${escapeHtml(node.display_result)}</span></td>
     </tr>`;
   }).join('');
 
@@ -164,9 +215,11 @@ table{width:100%;border-collapse:collapse}th,td{padding:11px 10px;border-bottom:
 .issue-row{display:grid;grid-template-columns:52px 1fr auto;align-items:center;gap:14px;padding:15px 4px;border-bottom:1px solid #edf0f4}.issue-row:last-child{border-bottom:0}.issue-count{display:grid;place-items:center;width:42px;height:42px;border-radius:12px;background:var(--warn-soft);color:var(--warn);font-weight:800}.issue-row h3{margin:0 0 2px}.issue-row p{margin:0;color:var(--muted);font-size:12px}
 .callout{border-left:4px solid var(--blue);background:var(--blue-soft);padding:12px 14px;border-radius:0 10px 10px 0;color:#344054}
 .drawer-backdrop{position:fixed;inset:0;z-index:40;background:rgba(15,23,42,.42);display:none}.drawer-backdrop.open{display:block}
-.drawer{position:absolute;right:0;top:0;height:100%;width:520px;background:#fff;padding:26px;box-shadow:-20px 0 70px rgba(15,23,42,.22);overflow:auto}
+.drawer{position:absolute;right:0;top:0;height:100%;width:min(720px,92vw);background:#fff;padding:26px;box-shadow:-20px 0 70px rgba(15,23,42,.22);overflow:auto}
 .drawer-head{display:flex;justify-content:space-between;gap:16px;align-items:start}.drawer h2{margin:0}.drawer pre{white-space:pre-wrap;word-break:break-word;background:#f8fafc;border:1px solid var(--line);border-radius:12px;padding:15px;color:#344054}
 .icon-button{border:1px solid var(--line);background:#fff;border-radius:9px;width:34px;height:34px;cursor:pointer}.icon-button:focus-visible{outline:3px solid #b2ccff}
+@media screen and (max-width:1040px){body{min-width:0}.shell{width:100%;margin:0}.report-head{border-width:0 0 1px;border-radius:0}.identity{align-items:flex-start;flex-direction:column;padding:16px;gap:8px}.freshness{text-align:left}.tabs{overflow-x:auto;padding:0 8px}.tabs button{flex:0 0 auto;padding-left:12px;padding-right:12px}.panel{border-width:0;padding:12px;min-height:0;border-radius:0}.hero,.two-col{grid-template-columns:minmax(0,1fr)}.summary-grid{grid-template-columns:repeat(2,minmax(0,1fr))}.metric-grid{grid-template-columns:minmax(0,1fr)}.section,.card,.wide-card{min-width:0}.wide-card{overflow-x:auto}.wide-card table{min-width:640px}.issue-row{grid-template-columns:44px minmax(0,1fr)}.issue-row .text-button{grid-column:2}.section-head{align-items:flex-start}.drawer{width:100%;max-width:100vw;padding:18px}}
+@media screen and (max-width:520px){.summary-grid{grid-template-columns:minmax(0,1fr)}}
 @media print{body{min-width:0;background:#fff}.shell{width:100%;margin:0}.report-head{position:static;box-shadow:none}.tabs{display:none}.panel{display:block!important;border:0;min-height:0;break-before:page}.drawer-backdrop{display:none!important}}
 </style>
 </head>
@@ -196,7 +249,7 @@ table{width:100%;border-collapse:collapse}th,td{padding:11px 10px;border-bottom:
         <h2>一句话结论</h2>
         <p>${escapeHtml(view.conclusion?.text || '当前证据不足，暂不能形成可信结论。')}</p>
       </article>
-      <article class="card scope"><span>七个标准阶段总耗时</span><strong>${escapeHtml(overviewSection.scope_duration)}</strong><span>辅助阶段不进入效率分母</span></article>
+      <article class="card scope"><span>标准阶段有效耗时（含返工）</span><strong>${escapeHtml(overviewSection.scope_duration)}</strong><span>辅助阶段和阶段间空隙不进入 E1 分子</span></article>
     </div>
     <div class="summary-grid">${summaryCards}</div>
     <div class="section">
@@ -227,13 +280,24 @@ table{width:100%;border-collapse:collapse}th,td{padding:11px 10px;border-bottom:
 
   <section class="panel" role="tabpanel" id="panel-evidence" aria-labelledby="tab-evidence" hidden>
     <div class="section-head"><div><h2>问题与证据</h2><p>按问题类别聚合；展开后再查看任务和事件，不把规则命中误称为独立缺陷。</p></div></div>
+    <article class="wide-card">
+      <h3>这些内容是怎么收集的</h3>
+      <p>${escapeHtml(issueSection.collection_method)}</p>
+      <p><strong>功能验证：</strong>${escapeHtml(issueSection.functional_result?.summary)} ${escapeHtml(issueSection.functional_result?.explanation)}</p>
+      <p><strong>证据链判断：</strong>${escapeHtml(issueSection.traceability_result?.summary)} ${escapeHtml(issueSection.traceability_result?.explanation)}</p>
+    </article>
     <div class="issue-summary"><strong>${escapeHtml(evidence.category_count ?? 0)} 类问题</strong><p>${escapeHtml(evidence.occurrence_count ?? 0)} 次规则命中</p></div>
     <article class="wide-card">${evidenceRows || '<p class="micro">当前没有证据问题。</p>'}</article>
+    ${(issueSection.warning_dispositions || []).length > 0 ? `
+    <article class="wide-card section">
+      <h3>告警处置</h3>
+      ${issueSection.warning_dispositions.map(item => `<p>${escapeHtml(item.warning || '未标识告警')}：${escapeHtml(item.disposition_label || '待处理')}${item.reason ? `；${escapeHtml(item.reason)}` : ''}</p>`).join('')}
+    </article>` : ''}
     <article class="wide-card section">
       <h3>已知风险</h3>
       <p>严重问题：${escapeHtml(view.known_risks?._available ? (view.known_risks.severe_issues?.length ?? 0) : '无数据')}</p>
-      ${warningDetails.length > 0
-        ? warningDetails.map((item) => `<p>${escapeHtml(item.description || '待确认项')}${item.target ? `（${escapeHtml(item.target)}）` : ''}</p>`).join('')
+      ${riskRows.length > 0
+        ? riskRows.map((item) => `<p><span class="state ${item.status_label === '待处理' || item.status_label === '待确认' ? 'warn' : 'neutral'}">${escapeHtml(item.status_label)}</span> ${escapeHtml(item.description || '待确认项')}${item.target ? `（${escapeHtml(item.target)}）` : ''}</p>`).join('')
         : '<p class="micro">无需修复</p>'}
     </article>
     ${Array.isArray(view.process_notes?.notes) && view.process_notes.notes.length > 0 ? `
@@ -246,26 +310,25 @@ table{width:100%;border-collapse:collapse}th,td{padding:11px 10px;border-bottom:
   </section>
 
   <section class="panel" role="tabpanel" id="panel-artifacts" aria-labelledby="tab-artifacts" hidden>
-    <div class="section-head"><div><h2>产物与追溯</h2><p>文件口径、变更归因和实际落盘产物均独立展示。</p></div></div>
+    <div class="section-head"><div><h2>产物与追溯</h2><p>分别说明任务过程中涉及的文件和最终实际交付的文件。</p></div></div>
     <div class="two-col">
       <article class="wide-card">
-        <h3>变更文件 · 双口径</h3>
-        <table><tbody>
-          <tr><td>任务事件累计文件</td><td><strong>${escapeHtml(changed.task_event_files_changed ?? '暂无数据')}</strong></td></tr>
-          <tr><td>最终输出快照文件</td><td><strong>${escapeHtml(changed.final_output_files_changed ?? '暂无数据')}</strong></td></tr>
-          <tr><td>新增 / 删除行</td><td>${escapeHtml(changed.added_lines ?? '暂无数据')} / ${escapeHtml(changed.deleted_lines ?? '暂无数据')}</td></tr>
-          <tr><td>数据来源</td><td>${escapeHtml(changed.diff_source || '未知')}</td></tr>
-        </tbody></table>
-        <p class="micro">${escapeHtml(changed.reconciliation_note || '暂无口径说明。')}</p>
+        <h3>${escapeHtml(changed.task_scope?.label || '任务过程中涉及的文件')}</h3>
+        <p>${escapeHtml(changed.task_scope?.explanation || '')}</p>
+        <p><strong>${escapeHtml(changed.task_scope?.count ?? '暂无数据')} 个</strong></p>
+        <p class="path">${escapeHtml((changed.task_scope?.files || []).join('、') || '暂无文件清单')}</p>
+        <p class="micro">来源：${escapeHtml(changed.task_scope?.source || '未记录')}；任务：${escapeHtml((changed.task_scope?.task_ids || []).join('、') || '未记录')}；最新记录：${escapeHtml(changed.task_scope?.latest_at || '未记录')}</p>
+        ${(changed.task_scope?.no_file_change_reasons || []).map(item => `<p class="micro">未改文件说明：${escapeHtml(item.task_id || '未标识任务')}：${escapeHtml(item.reason || item)}</p>`).join('')}
       </article>
       <article class="wide-card">
-        <h3>归因审计</h3>
-        <table><tbody>
-          <tr><td>显式关联历史事件</td><td>${escapeHtml(artifactSection.attribution_summary.linked_source_event_count)}</td></tr>
-          <tr><td>有效关联</td><td>${escapeHtml(artifactSection.attribution_summary.active_link_count)}</td></tr>
-          <tr><td>未归属候选</td><td>${escapeHtml(artifactSection.attribution_summary.unassigned_candidate_count)}</td></tr>
-        </tbody></table>
-        <button class="text-button drawer-trigger" type="button" data-drawer-title="归因审计详情" data-drawer-body="${escapeHtml(`有效关联：${JSON.stringify(activeLinks)}\n未归属候选：${candidateIds.join('、') || '无'}`)}">查看归因事件</button>
+        <h3>${escapeHtml(changed.final_scope?.label || '最终实际交付的文件')}</h3>
+        <p>${escapeHtml(changed.final_scope?.explanation || '')}</p>
+        <p><strong>${escapeHtml(changed.final_scope?.count ?? '暂无数据')} 个</strong></p>
+        <p class="path">${escapeHtml((changed.final_scope?.files || []).join('、') || '暂无文件清单')}</p>
+        <p class="micro">来源：${escapeHtml(changed.final_scope?.source || '未记录')}；事件：${escapeHtml(changed.final_scope?.event_id || '未记录')}；快照时间：${escapeHtml(changed.final_scope?.captured_at || '未记录')}</p>
+        <p class="micro">未产生交付文件的原因：${escapeHtml(changed.final_scope?.no_output_reason || '不适用')}</p>
+        <p class="micro">行数统计说明：${escapeHtml(changed.final_scope?.line_statistics_explanation || '未记录')}</p>
+        <p class="micro">${escapeHtml(changed.reconciliation_note || '暂无口径说明。')}</p>
       </article>
     </div>
     <article class="wide-card section">
@@ -312,6 +375,7 @@ table{width:100%;border-collapse:collapse}th,td{padding:11px 10px;border-bottom:
   var drawer=backdrop.querySelector('.drawer');
   var drawerTitle=document.getElementById('drawerTitle');
   var drawerBody=document.getElementById('drawerBody');
+  var drawerClose=document.getElementById('drawerClose');
   var lastTrigger=null;
   function closeDrawer(){
     if(!backdrop.classList.contains('open'))return;
@@ -322,10 +386,10 @@ table{width:100%;border-collapse:collapse}th,td{padding:11px 10px;border-bottom:
     button.addEventListener('click',function(){
       lastTrigger=button;drawerTitle.textContent=button.dataset.drawerTitle||'详情';
       drawerBody.textContent=button.dataset.drawerBody||'暂无详情';
-      backdrop.classList.add('open');backdrop.setAttribute('aria-hidden','false');drawer.focus();
+      backdrop.classList.add('open');backdrop.setAttribute('aria-hidden','false');drawerClose.focus();
     });
   });
-  document.getElementById('drawerClose').addEventListener('click',closeDrawer);
+  drawerClose.addEventListener('click',closeDrawer);
   backdrop.addEventListener('click',function(event){if(event.target===backdrop)closeDrawer();});
   document.addEventListener('keydown',function(event){
     if(event.key === 'Escape')closeDrawer();
@@ -333,7 +397,8 @@ table{width:100%;border-collapse:collapse}th,td{padding:11px 10px;border-bottom:
     if(e.key==='Tab'&&backdrop.classList.contains('open')){
       var items=drawer.querySelectorAll('button,[href],[tabindex]:not([tabindex="-1"])');
       var first=items[0],last=items[items.length-1];
-      if(event.shiftKey&&document.activeElement===first){event.preventDefault();last.focus();}
+      if(!drawer.contains(document.activeElement)){event.preventDefault();(event.shiftKey?last:first).focus();}
+      else if(event.shiftKey&&document.activeElement===first){event.preventDefault();last.focus();}
       else if(!event.shiftKey&&document.activeElement===last){event.preventDefault();first.focus();}
     }
   });