dsh-data-cleaning-agent 0.8.5 → 0.8.7

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 本文件记录 `dsh-data-cleaning-agent` 的版本变更。格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
+## [0.8.7] - 2026-09-06
+
+### Changed
+- 中央首页移除大型宣传/流程/最近任务卡片，保留简短业务说明；五个快捷菜单通过自有 Portal 挂在原生输入框外、正下方，不重排共享槽位。
+- 工作台分为当前任务与任务历史；五步统一为导入与核验、规则与体检、主体匹配、字段补全、结果下载。质量报告归入规则阶段，缺少前置条件时显示指引而不启动调用。
+- 提示词生成改为视口居中模态向导，窄屏全屏；正文独立滚动，标题和操作区固定。支持 Escape、Tab 焦点循环、回填后聚焦原生输入框，不自动发送。
+- 任务历史的新建入口统一打开提示词向导；帮助说明折叠收纳于工作台。桌面工作台普通/展开模式为输入框让位，图片放大通过独立 Portal 保持可见。
+
+### Tests
+- 新增菜单 DOM 生命周期与流程前置条件回归；新增隔离真实 React/Chromium 布局脚本，覆盖深浅色及四种窗口尺寸，不调用 QCC。
+
+## [0.8.6] - 2026-09-06
+
+### Fixed
+- 上传/OCR 核验页使用完整原始清单，每页 20 行可翻页，显示序号与全列；不再把前 5 行摘要当成核验视图。
+- 匹配结果共用全量分页和中文字段展示，不再截断为前 8 行/列。
+- 核验阶段支持全量 CSV 和原值 JSON 下载，不触发 QCC 调用；CSV 对公式及长编号作文本保护。明细未完整载入时禁用核验下载。
+- OCR 完成后的引导明确真实核验路径、规则/体检/匹配步骤及自动回填，无需人工复制 dcq- 凭证，不将识别清单误报为匹配结果。
+
 ## [0.8.5] - 2026-09-06
 
 ### Fixed

package/README.en.md

@@ -2,7 +2,7 @@
 
 > A data cleaning & completion agent plugin for DeepSeek Harness: local CSV/XLSX/JSON engine plus optional Qichacha (QCC) MCP enterprise-data enrichment. Initiated and maintained by the Qichacha (QCC) team.
 >
-> Current source version / 当前源码版本: **0.8.5** (stable release)
+> Current source version / 当前源码版本: **0.8.7** (stable release)
 
 [![CI](https://github.com/duhu2000/dsh-data-cleaning-agent/actions/workflows/ci.yml/badge.svg)](https://github.com/duhu2000/dsh-data-cleaning-agent/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/dsh-data-cleaning-agent)](https://www.npmjs.com/package/dsh-data-cleaning-agent)

package/README.md

@@ -2,7 +2,7 @@
 
 > 在 DeepSeek Harness 中清洗、补全、画像企业名单数据的智能体插件：本地 CSV/XLSX/JSON 引擎 + 可选企查查（Qichacha/QCC）MCP 企业数据补全，由企查查（Qichacha/QCC）团队发起并维护。
 >
-> 当前源码版本 / Current source version: **0.8.5**（正式版本）
+> 当前源码版本 / Current source version: **0.8.7**（正式版本）
 
 [![CI](https://github.com/duhu2000/dsh-data-cleaning-agent/actions/workflows/ci.yml/badge.svg)](https://github.com/duhu2000/dsh-data-cleaning-agent/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/dsh-data-cleaning-agent)](https://www.npmjs.com/package/dsh-data-cleaning-agent)

package/docs/USER-GUIDE.md

@@ -16,6 +16,15 @@ bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-data-cleaning-a
 
 ## 2. 使用方式
 
+### 0.8.7 页面入口与分工
+
+- 左侧「数据清洗补全」进入业务会话；中央保留原生对话框和一句说明，不再显示大型工作台介绍卡片。
+- 对话框下方「导入名单 / 质量体检 / 匹配核验 / 字段补全 / 任务历史」是同一工作台的快捷菜单，不是五个独立任务，也不会直接启动企查查调用。
+- 「提示词生成」打开居中向导：录入文字、Excel 或图片 → 匹配规则 → 清洗与补全字段 → 确认描述。可关闭后继续编辑；回填不自动发送。
+- 工作台「当前任务」使用五步导航：导入与核验 → 规则与体检 → 主体匹配 → 字段补全 → 结果下载。质量体检报告位于第二阶段；未满足前置条件会显示明确提示。
+- 「任务历史」管理已有任务、恢复下载，也可新建任务进入向导。原始识别清单下载在第一阶段，最终结果与异常清单下载在第五阶段。
+- 向导正文可独立滚动，底部操作区保持可见；Esc 关闭向导或工作台。桌面工作台与对话区并排，窄屏工作台为覆盖式页面，可关闭返回。
+
 ### 2.1 对话式（推荐）
 
 在对话中说：

package/lib/client.js

@@ -9,7 +9,7 @@
  *   - `sidebar.footer.action` 仅托管入口生命周期和降级渲染；实际入口 Portal 到
  *     `sidebar.workspaces` 前，位于「新会话」与「工作区」之间。
  *   - DSH 原生会话保持在中间，能力入口使用 `conversation.input.dock` 并通过稳定
- *     `data-slot` 排到输入框下方；右侧非模态工作台使用 `shell.overlay`。
+ *     `data-composer-seat/card` 将自有菜单 Portal 到输入框下方；右侧工作台使用 `shell.overlay`。
  *   - 提示词生成器使用 `conversation.input.overlay`，只对本插件创建的会话生效。
  *     Hero 标题没有公开替换槽位，故以可恢复、精确文本匹配的 DOM Bridge 对齐业务首页。
  *
@@ -111,6 +111,7 @@ window.__ModuleLoader__.load({
 }
 
 .dcAgentWorkbench {
+  box-sizing: border-box;
   display: flex;
   flex-direction: column;
   width: min(460px, 42vw);
@@ -170,72 +171,17 @@ window.__ModuleLoader__.load({
 }
 .dcAgentCapability svg { flex: 0 0 auto; }
 
-/* DSH 官方 input.dock 默认在 composer 上方；只把本插件自己的 cell 排到下方。 */
-[data-slot="conversation.input.dock"]:has(.dcAgentExperience) {
-  order: 20;
-}
+/* 原生 input.dock 保留轻量简介；菜单独立 Portal 到 composer 后，不重排共享 slot。 */
 
 .dcAgentExperience {
   width: 100%;
   box-sizing: border-box;
 }
+.dcAgentCapabilityMount { width: 100%; padding: 8px 0; flex: none; }
+.dcAgentHomeSummary { margin: 0 20px 8px; text-align: center; color: light-dark(#697386, #aab5c7); font-size: 13px; line-height: 20px; }
+.dcAgentPromptBackdrop { position: fixed; inset: 0; z-index: 2000; display: grid; place-items: center; padding: 16px; box-sizing: border-box; background: rgba(8, 15, 28, .36); pointer-events: auto; }
+body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
 
-.dcAgentProductHome {
-  width: 100%;
-  max-width: 980px;
-  box-sizing: border-box;
-  margin: 10px auto 0;
-  padding: 16px 18px;
-  border: 1px solid light-dark(#e4e8f0, #303947);
-  border-radius: 16px;
-  background: light-dark(rgba(255,255,255,.82), rgba(20,25,33,.86));
-  box-shadow: light-dark(0 10px 30px rgba(42,75,120,.06), 0 14px 34px rgba(0,0,0,.14));
-}
-.dcAgentProductHome h2 {
-  margin: 0;
-  color: light-dark(#172033, #edf2fa);
-  font-size: 16px;
-  line-height: 24px;
-}
-.dcAgentProductHome > p {
-  margin: 4px 0 12px;
-  color: light-dark(#697386, #aab5c7);
-  font-size: 12px;
-  line-height: 18px;
-}
-.dcAgentHomeFlow {
-  display: grid;
-  grid-template-columns: repeat(7, minmax(0, 1fr));
-  gap: 8px;
-}
-.dcAgentHomeStep {
-  min-width: 0;
-  padding: 9px 8px;
-  border-radius: 10px;
-  background: light-dark(#f4f7fc, #1c2330);
-  color: light-dark(#33415a, #c9d4e5);
-  font-size: 12px;
-  line-height: 18px;
-}
-.dcAgentHomeStep b {
-  display: block;
-  margin-bottom: 2px;
-  color: light-dark(#1556cf, #8cb3ff);
-  font-size: 11px;
-}
-.dcAgentHomeTrust {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 6px;
-  margin-top: 10px;
-}
-.dcAgentHomeTrust span {
-  padding: 3px 8px;
-  border: 1px solid light-dark(#dce4f1, #344052);
-  border-radius: 999px;
-  color: light-dark(#59677c, #b1bdd0);
-  font-size: 11px;
-}
 
 /* input.overlay 是 DSH 官方浮层锚点；给触发器让出输入卡片顶部空间。 */
 [data-composer-card]:has(.dcAgentPromptTrigger) {
@@ -263,13 +209,13 @@ window.__ModuleLoader__.load({
   pointer-events: auto;
 }
 .dcAgentPromptPanel {
-  position: absolute;
-  top: 44px;
-  left: 16px;
-  width: min(660px, calc(100vw - 120px));
-  max-height: min(68vh, 660px);
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  width: min(860px, 100%);
+  max-height: calc(100dvh - 32px);
   box-sizing: border-box;
-  overflow: auto;
+  overflow: hidden;
   padding: 16px;
   border: 1px solid light-dark(#d5dae4, #303947);
   border-radius: 16px;
@@ -278,6 +224,9 @@ window.__ModuleLoader__.load({
   box-shadow: light-dark(0 18px 48px rgba(33,55,88,.20), 0 20px 54px rgba(0,0,0,.40));
   pointer-events: auto;
 }
+.dcAgentPromptBody { min-height: 0; overflow: auto; overscroll-behavior: contain; padding: 0 2px; }
+.dcAgentPromptHead, .dcAgentPromptActions { flex: none; }
+.dcAgentPromptActions { border-top: 1px solid light-dark(#e4e8f0, #303947); padding-top: 12px; }
 .dcAgentPromptHead {
   display: flex;
   align-items: flex-start;
@@ -402,7 +351,7 @@ window.__ModuleLoader__.load({
 .dcAgentImageLightbox {
   position: fixed;
   inset: 0;
-  z-index: 1400;
+  z-index: 2100;
   display: grid;
   place-items: center;
   padding: 32px;
@@ -766,18 +715,7 @@ window.__ModuleLoader__.load({
   line-height: 1.6;
   color: light-dark(#33415a, #c9d4e5);
 }
-.dcAgentHomeHero { display: flex; align-items: center; justify-content: space-between; gap: 18px; }
-.dcAgentHomeHero p { margin: 5px 0 0; color: light-dark(#697386, #aab5c7); font-size: 12px; line-height: 18px; }
-.dcAgentHomeEyebrow { display: block; margin-bottom: 4px; color: light-dark(#2869e6, #8cb3ff); font-size: 11px; font-weight: 700; letter-spacing: .08em; }
-.dcAgentHomeActions { display: flex; flex-wrap: wrap; gap: 8px; margin-top: 10px; }
-.dcAgentHomeActions button,
-.dcAgentHomeRecent button,
 .dcAgentHistoryTask { border: 1px solid light-dark(#dce4f1, #344052); border-radius: 9px; background: light-dark(#fff, #1b222e); color: inherit; font: inherit; cursor: pointer; }
-.dcAgentHomeActions button { padding: 6px 9px; font-size: 11px; }
-.dcAgentHomeRecent { display: grid; gap: 6px; margin-top: 12px; }
-.dcAgentHomeRecent > b { font-size: 12px; }
-.dcAgentHomeRecent button { display: flex; justify-content: space-between; gap: 12px; padding: 7px 9px; text-align: left; font-size: 11px; }
-.dcAgentHomeRecent small { color: light-dark(#697386, #aab5c7); }
 .dcAgentWizardNav { display: grid; grid-template-columns: repeat(4, 1fr); gap: 6px; margin-bottom: 12px; }
 .dcAgentWizardStep { display: flex; align-items: center; gap: 6px; padding: 7px; border: 1px solid light-dark(#d9dee8, #394352); border-radius: 9px; background: transparent; color: inherit; font: inherit; font-size: 11px; cursor: pointer; }
 .dcAgentWizardStep b { display: grid; place-items: center; width: 20px; height: 20px; border-radius: 50%; background: light-dark(#eef1f6, #252e3b); color: light-dark(#607088, #b9c6da); }
@@ -830,6 +768,12 @@ window.__ModuleLoader__.load({
     padding-right: min(420px, 48vw);
   }
 }
+@media (min-width: 761px) {
+  body:has(.dcAgentWorkbench.is-expanded) [data-conversation-scroll] {
+    box-sizing: border-box;
+    padding-right: min(980px, calc(100vw - 420px));
+  }
+}
 @media (max-width: 760px) {
   .dcAgentWorkbench, .dcAgentWorkbench.is-expanded { width: 100vw; max-width: none; min-width: 0; border-radius: 0; }
   .dcAgentOverlay { background: rgba(8, 10, 14, 0.22); pointer-events: auto; }
@@ -838,9 +782,8 @@ window.__ModuleLoader__.load({
   .dcAgentCandidate { grid-template-columns: 1fr; }
   .dcAgentCapabilities { justify-content: flex-start; padding-inline: 12px; }
   .dcAgentCapability { min-width: 92px; }
-  .dcAgentPromptPanel { left: 8px; width: calc(100vw - 88px); max-height: 72vh; }
-  .dcAgentHomeFlow { grid-template-columns: repeat(2, minmax(0, 1fr)); }
-  .dcAgentHomeHero { align-items: flex-start; flex-direction: column; }
+  .dcAgentPromptBackdrop { padding: 0; }
+  .dcAgentPromptPanel { width: 100%; height: 100dvh; max-height: 100dvh; border-radius: 0; }
   .dcAgentWizardNav { grid-template-columns: repeat(2, 1fr); }
   .dcAgentRulesGrid { grid-template-columns: 1fr; }
   .dcAgentMappingRow { grid-template-columns: 1fr; }
@@ -887,6 +830,7 @@ window.__ModuleLoader__.load({
       if (!from || !toId || String(fromId) === String(toId)) return runtimeFor(toId);
       const target = runtimeFor(toId);
       target.rows = from.rows;
+      target.sourceRows = from.sourceRows;
       target.headers = from.headers;
       target.source = from.source;
       target.lastCsv = from.lastCsv;
@@ -896,15 +840,15 @@ window.__ModuleLoader__.load({
     }
 
     const STEPS = [
-      { key: 'upload', label: '上传数据', icon: '📄' },
-      { key: 'rules', label: '规则确认', icon: '⚙' },
-      { key: 'match', label: '数据匹配', icon: '🔎' },
-      { key: 'enrich', label: '清洗补全', icon: '▦' },
-      { key: 'download', label: '下载数据', icon: '⬇️' },
+      { key: 'upload', label: '导入与核验', icon: '1' },
+      { key: 'rules', label: '规则与体检', icon: '2' },
+      { key: 'match', label: '主体匹配', icon: '3' },
+      { key: 'enrich', label: '字段补全', icon: '4' },
+      { key: 'download', label: '结果下载', icon: '5' },
     ];
 
     const CAPABILITIES = [
-      { key: 'upload', label: '上传清洗', icon: IconPaperclipOutline16, fallback: '＋' },
+      { key: 'upload', label: '导入名单', icon: IconPaperclipOutline16, fallback: '＋' },
       { key: 'profile', label: '质量体检', icon: IconChecklistOutline14, fallback: '✓' },
       { key: 'match', label: '匹配核验', icon: IconSearchOutline16, fallback: '⌕' },
       { key: 'enrich', label: '字段补全', icon: IconDataOutline16, fallback: '▦' },
@@ -1800,7 +1744,7 @@ window.__ModuleLoader__.load({
       }, launcher), topMount);
     }
 
-    /** Mockup 五能力入口：由 input.dock 承载，并在 CSS 中排到原生 composer 下方。 */
+    /** 快捷菜单只切换同一工作台视图，由自有 Portal 挂载在原生 composer 下方。 */
     function CapabilityBar(props) {
       const { sessionId } = props;
       return h('div', { className: 'dcAgentCapabilities', 'aria-label': '数据清洗补全智能体能力' },
@@ -1825,66 +1769,109 @@ window.__ModuleLoader__.load({
       authorization_required: '待连接企查查', cancelled: '已取消', parse_failed: '解析失败',
     };
 
-    function ProductHome(props = {}) {
-      const { sessionId } = props;
-      const [recentTasks, setRecentTasks] = react.useState([]);
-      const flow = [
-        ['01', '任务设置', '提示词向导明确目标'],
-        ['02', '上传数据', '文本、Excel、JSON 或图片'],
-        ['03', '规则确认', '字段映射与匹配主键'],
-        ['04', '质量体检', '缺失、重复与格式诊断'],
-        ['05', '数据匹配', '精确优先，多候选复核'],
-        ['06', '清洗补全', '按需选择当前企业字段'],
-        ['07', '下载数据', '保留原值、依据与状态'],
-      ];
+    function ProductHome() {
+      return h('p', { className: 'dcAgentHomeSummary' },
+        '导入企业名单或图片，核验主体、补全字段，并导出可追溯结果。');
+    }
+
+    function workflowNavigationIssue(step, task, hasData, profile, qccRun) {
+      if (['upload', 'history'].includes(step)) return null;
+      if (step === 'download' && task?.artifacts?.length) return null;
+      if (!hasData) return '请先在「导入与核验」载入并核对完整名单。';
+      if (step === 'rules') return null;
+      if (!task || ['draft', 'uploaded'].includes(task.state)) return '请先在「规则与体检」确认字段映射和处理规则。';
+      if (step === 'profile') return null;
+      if (!profile && task.state === 'rules_confirmed') return '请先生成质量体检报告，再推进主体匹配。';
+      const requiresQcc = Array.isArray(task.objectives)
+        ? task.objectives.some((key) => ['validate_identity', 'complete_fields'].includes(key))
+        : Boolean(task.fieldSelection?.length);
+      if (step === 'enrich' && requiresQcc && !['matched', 'enriching', 'export_ready', 'completed', 'partial'].includes(task.state)) {
+        return '请先在「主体匹配」确认企业；多候选需要人工核验。';
+      }
+      if (step === 'download' && !['export_ready', 'completed', 'partial'].includes(task.state) && !['completed', 'partial'].includes(qccRun?.state)) {
+        return '请先完成清洗或字段补全。原始清单可在「导入与核验」下载。';
+      }
+      return null;
+    }
+
+    // 只新增自己的 Portal 容器，不移动 DSH/其他插件拥有的 DOM。
+    function installCapabilityMount(marker, onMount) {
+      const owned = new Set();
+      const sync = () => {
+        const seat = marker?.closest?.('[data-composer-seat]');
+        const card = seat?.querySelector?.('[data-composer-card]');
+        if (!card) { onMount(null); return; }
+        let branch = card;
+        while (branch.parentElement && branch.parentElement !== seat && !branch.parentElement.contains(marker)) {
+          branch = branch.parentElement;
+        }
+        const parent = branch.parentElement;
+        if (!parent?.contains(marker) || branch.contains(marker)) { onMount(null); return; }
+        let mount = [...owned].find((node) => node.parentElement === parent);
+        if (!mount) {
+          for (const node of owned) node.remove();
+          owned.clear();
+          mount = document.createElement('div');
+          mount.className = 'dcAgentCapabilityMount';
+          owned.add(mount);
+        }
+        if (branch.nextSibling !== mount) parent.insertBefore(mount, branch.nextSibling);
+        onMount(mount);
+      };
+      sync();
+      const observer = typeof MutationObserver === 'function' ? new MutationObserver(sync) : null;
+      observer?.observe(marker.closest('[data-composer-seat]') || marker, { childList: true, subtree: true });
+      return () => { observer?.disconnect(); for (const node of owned) node.remove(); };
+    }
+
+    function PromptDialog({ sessionId, onClose, children }) {
       react.useEffect(() => {
-        let disposed = false;
-        requestJson('/data-cleaning/api/workflow/tasks').then((response) => {
-          if (!disposed) setRecentTasks((response.tasks || []).slice(0, 3));
-        }).catch(() => {});
-        return () => { disposed = true; };
+        const panel = [...(document.querySelectorAll?.('.dcAgentPromptPanel') || [])]
+          .find((node) => node.dataset.sessionId === sessionId);
+        if (!panel) return undefined;
+        const previous = document.activeElement;
+        const focusable = () => [...panel.querySelectorAll('button:not(:disabled), input:not(:disabled), textarea:not(:disabled), select:not(:disabled), [tabindex="0"]')]
+          .filter((node) => node.getClientRects().length);
+        (focusable()[0] || panel).focus();
+        const keydown = (event) => {
+          if (event.key === 'Escape') { event.preventDefault(); event.stopPropagation(); onClose(); }
+          if (event.key !== 'Tab') return;
+          const nodes = focusable();
+          const first = nodes[0] || panel, last = nodes[nodes.length - 1] || panel;
+          if (event.shiftKey && (document.activeElement === first || document.activeElement === panel)) {
+            event.preventDefault(); last.focus();
+          } else if (!event.shiftKey && (document.activeElement === last || !panel.contains(document.activeElement))) {
+            event.preventDefault(); first.focus();
+          }
+        };
+        panel.addEventListener('keydown', keydown);
+        return () => {
+          panel.removeEventListener('keydown', keydown);
+          if (panel.contains(document.activeElement) && previous?.isConnected) previous.focus();
+        };
       }, [sessionId]);
-      return h('section', { className: 'dcAgentProductHome', 'aria-label': '数据清洗补全产品介绍' },
-        h('div', { className: 'dcAgentHomeHero' },
-          h('div', null,
-            h('span', { className: 'dcAgentHomeEyebrow' }, '企业主数据治理工作台'),
-            h('h2', null, '把企业名单变成可核验、可回写的标准数据'),
-            h('p', null, '面向销售线索、客户尽调、供应商管理与 CRM / ERP 数据治理，先确认任务和规则，再按需使用当前用户连接的企查查 MCP。'),
-          ),
-          h('button', { type: 'button', className: 'dcAgentButton is-primary', onClick: () => requestWorkbenchOpen('upload', sessionId) }, '开始新任务'),
-        ),
-        h('div', { className: 'dcAgentHomeFlow', 'aria-label': '数据清洗补全工作流' },
-          flow.map(([index, title, hint]) => h('div', { className: 'dcAgentHomeStep', key: index },
-            h('b', null, index),
-            h('span', null, title),
-            h('small', { style: { display: 'block', opacity: .72 } }, hint),
-          )),
-        ),
-        h('div', { className: 'dcAgentHomeTrust' },
-          h('span', null, '本地解析与确定性清洗'),
-          h('span', null, '匹配候选人工确认'),
-          h('span', null, '客户自带企查查连接与额度'),
-          h('span', null, '结果与待复核清单可导出'),
-        ),
-        h('div', { className: 'dcAgentHomeActions' },
-          h('button', { type: 'button', onClick: () => requestWorkbenchOpen('profile', sessionId) }, '🩺 查看质量体检'),
-          h('button', { type: 'button', onClick: () => requestWorkbenchOpen('match', sessionId) }, '🔎 进入匹配核验'),
-          h('button', { type: 'button', onClick: () => requestWorkbenchOpen('history', sessionId) }, '◷ 查看任务历史'),
-        ),
-        recentTasks.length ? h('div', { className: 'dcAgentHomeRecent', 'aria-label': '最近任务' },
-          h('b', null, '最近任务'),
-          recentTasks.map((task) => h('button', {
-            key: task.id,
-            type: 'button',
-            onClick: () => requestWorkbenchOpen(task.stage || 'upload', sessionId, task),
-          },
-            h('span', null, task.title || '未命名任务'),
-            h('small', null, WORKFLOW_STATE_LABELS[task.state] || task.state),
-          )),
-        ) : null,
-      );
+      const dialog = h('div', { className: 'dcAgentPromptBackdrop' },
+        h('section', { className: 'dcAgentPromptPanel', role: 'dialog', 'aria-modal': 'true',
+          'aria-label': '数据清洗补全任务生成器', 'data-session-id': sessionId, tabIndex: -1 }, children));
+      return document.body && typeof reactDom.createPortal === 'function'
+        ? reactDom.createPortal(dialog, document.body) : dialog;
+    }
+
+    function ImagePreview({ src, alt, onClose, sessionId }) {
+      react.useEffect(() => () => {
+        const panel = [...(document.querySelectorAll?.('.dcAgentPromptPanel') || [])]
+          .find((node) => node.dataset.sessionId === sessionId);
+        panel?.querySelector('.dcAgentPromptImageThumb')?.focus();
+      }, [sessionId]);
+      const view = h('button', { type: 'button', className: 'dcAgentImageLightbox',
+        'aria-label': '关闭图片预览', onClick: onClose, autoFocus: true,
+        onKeyDown: (event) => {
+          if (event.key === 'Escape') { event.preventDefault(); event.stopPropagation(); onClose(); }
+          if (event.key === 'Tab') event.preventDefault();
+        },
+      }, h('img', { src, alt }));
+      return document.body && typeof reactDom.createPortal === 'function' ? reactDom.createPortal(view, document.body) : view;
     }
-
     /**
      * DSH 当前只公开 hero brand.mark，没有 headline slot。这里仅在本插件会话且 blank hero
      * 阶段替换标题，并在卸载时恢复，避免污染普通会话。
@@ -1978,6 +1965,13 @@ window.__ModuleLoader__.load({
       const { sessionId, session: ownerSession } = props;
       const enabled = useCleaningSession(sessionId);
       const hero = ownerSession?.composerPhase === 'blank';
+      const [menuMount, setMenuMount] = react.useState(null);
+      react.useEffect(() => {
+        if (!enabled) return undefined;
+        const marker = [...document.querySelectorAll('.dcAgentExperience')]
+          .find((node) => node.dataset.sessionId === sessionId);
+        return marker ? installCapabilityMount(marker, (mount) => setMenuMount((current) => current === mount ? current : mount)) : undefined;
+      }, [enabled, sessionId, hero]);
       react.useEffect(
         () => rewriteHeroChrome(sessionId, enabled && hero),
         [sessionId, enabled, hero, ownerSession?.openState]
@@ -1987,7 +1981,7 @@ window.__ModuleLoader__.load({
         className: `dcAgentExperience${hero ? ' is-home' : ''}`,
         'data-session-id': sessionId,
       },
-        h(CapabilityBar, { sessionId }),
+        menuMount ? reactDom.createPortal(h(CapabilityBar, { sessionId }), menuMount) : h(CapabilityBar, { sessionId }),
         hero ? h(ProductHome, { sessionId }) : null,
       );
     }
@@ -2275,6 +2269,12 @@ window.__ModuleLoader__.load({
         }, sessionId);
         setError(null);
         setOpen(false);
+        setTimeout(() => {
+          if (typeof document === 'undefined' || !isCleaningSession(sessionId)) return;
+          const marker = [...(document.querySelectorAll?.('.dcAgentExperience') || [])]
+            .find((node) => node.dataset.sessionId === sessionId);
+          marker?.closest?.('[data-composer-seat]')?.querySelector?.('textarea, [contenteditable="true"], [role="textbox"]')?.focus();
+        }, 0);
         setWizardStep(1);
       };
 
@@ -2331,6 +2331,16 @@ window.__ModuleLoader__.load({
       // 右侧工作台共用此图片入口；仅由当前会话确认接收，不把图片交给表格解析器。
       react.useEffect(() => {
         if (!enabled) return undefined;
+        const receiveNewTask = (event) => {
+          if (event.detail?.sessionId !== sessionId || busy || imageCommand?.state === 'running') return;
+          event.preventDefault();
+          discardCurrentImage();
+          setMode('text'); setRawText(''); setEntries([]); setEntryCount(0); setSpreadsheetFileName('');
+          setCleaningKeys(DEFAULT_CLEANING_KEYS); setEnrichmentKeys(DEFAULT_ENRICHMENT_KEYS);
+          setAnchorKeys(['company_name', 'credit_no']);
+          setPromptMatchRules({ normalizeNames: true, preferCreditNo: true, deduplicate: true, manualReviewAmbiguous: true });
+          setWizardStep(1); setOpen(true); setError(null);
+        };
         const receiveImage = (event) => {
           if (event.detail?.sessionId !== sessionId || busy || imageCommand?.state === 'running') return;
           event.preventDefault();
@@ -2341,7 +2351,11 @@ window.__ModuleLoader__.load({
           if (event.detail.file) acceptImageFiles([event.detail.file]);
         };
         document.addEventListener('dsh:data-cleaning-prompt-image', receiveImage);
-        return () => document.removeEventListener('dsh:data-cleaning-prompt-image', receiveImage);
+        document.addEventListener('dsh:data-cleaning-prompt-new', receiveNewTask);
+        return () => {
+          document.removeEventListener('dsh:data-cleaning-prompt-image', receiveImage);
+          document.removeEventListener('dsh:data-cleaning-prompt-new', receiveNewTask);
+        };
       }, [enabled, sessionId, busy, imageCommand, imageAttachment]);
 
       if (!enabled) return null;
@@ -2375,18 +2389,7 @@ window.__ModuleLoader__.load({
           'aria-expanded': open,
           onClick: () => setOpen(!open),
         }, '✨ 提示词生成'),
-        open ? h('section', {
-          className: 'dcAgentPromptPanel',
-          role: 'dialog',
-          'aria-modal': 'false',
-          'aria-label': '数据清洗补全任务生成器',
-          onKeyDown: (event) => {
-            if (event.key === 'Escape') {
-              event.preventDefault();
-              setOpen(false);
-            }
-          },
-        },
+        open ? h(PromptDialog, { sessionId, onClose: () => setOpen(false) },
           h('div', { className: 'dcAgentPromptHead' },
             h('div', null,
               h('h3', null, '生成数据清洗补全任务'),
@@ -2394,6 +2397,7 @@ window.__ModuleLoader__.load({
             ),
             h('button', { type: 'button', className: 'dcAgentPromptClose', 'aria-label': '关闭提示词生成', onClick: () => setOpen(false) }, '✕'),
           ),
+          h('div', { className: 'dcAgentPromptBody' },
           h('nav', { className: 'dcAgentWizardNav', 'aria-label': '任务设置步骤' },
             [['1', '数据来源'], ['2', '匹配规则'], ['3', '清洗与补全'], ['4', '确认描述']].map(([index, label]) => h('button', {
               key: index,
@@ -2521,6 +2525,7 @@ window.__ModuleLoader__.load({
             ? h('p', { className: 'dcAgentPromptNote', role: 'status' }, `图片已载入，可继续选择规则和字段；暂存有效期 15 分钟。${imageCommand.providerIssue.message}`)
             : null,
           error ? h('p', { className: 'dcAgentPromptError', role: 'alert' }, error) : null,
+          ),
           h('div', { className: 'dcAgentPromptActions' },
             h('button', { type: 'button', className: 'dcAgentPromptAction', disabled: wizardStep === 1, onClick: () => setWizardStep(Math.max(1, wizardStep - 1)) }, '上一步'),
             h('button', { type: 'button', className: 'dcAgentPromptAction is-primary', disabled: busy || imageCommand?.state === 'running', onClick: nextWizard }, busy
@@ -2530,11 +2535,9 @@ window.__ModuleLoader__.load({
                   : wizardStep === 4 ? '回填到对话框' : '下一步'),
           ),
         ) : null,
-        imageLightbox && imageAttachment?.previewUrl ? h('button', {
-          type: 'button', className: 'dcAgentImageLightbox',
-          'aria-label': '关闭图片预览',
-          onClick: () => setImageLightbox(false),
-        }, h('img', { src: imageAttachment.previewUrl, alt: imageFileName })) : null,
+        imageLightbox && imageAttachment?.previewUrl ? h(ImagePreview, {
+          src: imageAttachment.previewUrl, alt: imageFileName, sessionId, onClose: () => setImageLightbox(false),
+        }) : null,
       );
     }
 
@@ -2681,6 +2684,7 @@ window.__ModuleLoader__.load({
     function applyParsed(result, actions, taskId = 'unassigned', source = {}) {
       const runtime = runtimeFor(taskId);
       runtime.rows = Array.isArray(result.rows) ? result.rows : [];
+      runtime.sourceRows = runtime.rows;
       runtime.headers = Array.isArray(result.headers) ? result.headers : [];
       runtime.source = {
         type: source.type || result.fmt || 'csv',
@@ -2712,6 +2716,7 @@ window.__ModuleLoader__.load({
       // 都以本次解析结果覆盖目标 runtime，避免复用已完成任务的一行旧数据。
       const target = runtimeFor(current.id);
       target.rows = Array.isArray(result.rows) ? result.rows : [];
+      target.sourceRows = target.rows;
       target.headers = Array.isArray(result.headers) ? result.headers : [];
       target.source = {
         type: source.type || result.fmt || 'csv',
@@ -2733,6 +2738,67 @@ window.__ModuleLoader__.load({
       return current;
     }
 
+    function reviewColumns(rows, headers = []) {
+      return [...new Set([...headers, ...rows.flatMap((row) => Object.keys(row || {}))])];
+    }
+
+    function reviewCsv(rows, headers) {
+      const cell = (value) => {
+        let text = value == null ? '' : typeof value === 'object' ? JSON.stringify(value) : String(value);
+        // 保留长编号的文本形式，阻止外部 OCR/企业字段成为 Excel 公式。
+        if (/^[\s]*[=+@-]/.test(text) || /^\d{15,}$/.test(text) || /^0\d+/.test(text)) text = "'" + text;
+        return '"' + text.replace(/"/g, '""') + '"';
+      };
+      return '\uFEFF' + [headers.map((key) => cell(resultFieldLabel(key))).join(','),
+        ...rows.map((row) => headers.map((key) => cell(row?.[key])).join(','))].join('\r\n');
+    }
+
+    /** 页内查看和核验下载均使用完整 rows，不使用 store 的五行摘要。 */
+    function DatasetReview({ rows, headers, title, expectedCount, onError }) {
+      const [page, setPage] = react.useState(0);
+      const pageSize = 20;
+      const total = rows.length;
+      const columns = reviewColumns(rows, headers);
+      const currentPage = Math.min(page, Math.max(0, Math.ceil(total / pageSize) - 1));
+      const start = currentPage * pageSize;
+      const download = (format) => {
+        try {
+          const content = format === 'csv' ? reviewCsv(rows, columns) : JSON.stringify(rows, null, 2);
+          const url = URL.createObjectURL(new Blob([content], { type: format === 'csv' ? 'text/csv;charset=utf-8' : 'application/json;charset=utf-8' }));
+          const anchor = document.createElement('a');
+          anchor.href = url;
+          anchor.download = title + '.' + format;
+          try { anchor.click(); } finally { setTimeout(() => URL.revokeObjectURL(url), 1000); }
+        } catch (error) { onError?.(error instanceof Error ? error.message : String(error)); }
+      };
+      const complete = expectedCount == null || expectedCount === total;
+      return h('section', { className: 'dcAgentSection', 'aria-label': title },
+        h('h3', null, title),
+        h('p', { className: 'dcAgentHint', role: 'status' }, complete
+          ? `共 ${total} 条，当前显示 ${total ? start + 1 : 0}–${Math.min(start + pageSize, total)} 条；共 ${columns.length} 列，可横向滚动。`
+          : `完整清单尚未就绪：预期 ${expectedCount} 条，当前载入 ${total} 条。请等待同步；刷新后若仍缺失，请重新上传源文件。`),
+        h('div', { className: 'dcAgentPreviewTable', style: { overflow: 'auto', maxHeight: '420px' } },
+          h('table', { className: 'dcAgentTable' },
+            h('thead', null, h('tr', null, h('th', null, '序号'), columns.map((key) => h('th', { key }, resultFieldLabel(key))))),
+            h('tbody', null, rows.slice(start, start + pageSize).map((row, index) => h('tr', { key: start + index },
+              h('td', null, String(start + index + 1)),
+              columns.map((key) => h('td', { key }, row?.[key] == null ? '' : typeof row[key] === 'object' ? JSON.stringify(row[key]) : String(row[key]))),
+            ))),
+          ),
+        ),
+        h('div', { className: 'dcAgentRow' },
+          h('button', { type: 'button', className: 'dcAgentButton', disabled: currentPage === 0, onClick: () => setPage(currentPage - 1) }, '上一页'),
+          h('span', null, `第 ${currentPage + 1} / ${Math.max(1, Math.ceil(total / pageSize))} 页`),
+          h('button', { type: 'button', className: 'dcAgentButton', disabled: start + pageSize >= total, onClick: () => setPage(currentPage + 1) }, '下一页'),
+        ),
+        h('div', { className: 'dcAgentRow' },
+          h('button', { type: 'button', className: 'dcAgentButton', disabled: !complete || !total, onClick: () => download('csv') }, `下载全部 ${total} 条 CSV`),
+          h('button', { type: 'button', className: 'dcAgentButton', disabled: !complete || !total, onClick: () => download('json') }, '下载原值 JSON'),
+        ),
+        h('p', { className: 'dcAgentHint' }, '下载包含全部行，不受分页影响。CSV 对公式及长编号作文本保护；JSON 保留原值。仅导出当前清单，不触发企查查调用。'),
+      );
+    }
+
     /** 右侧非模态工作台：中央区域始终保留 DSH 原生会话。 */
     function WorkbenchDrawer(props) {
       const { useStore, actions } = props;
@@ -2888,10 +2954,9 @@ window.__ModuleLoader__.load({
       const cachedTask = workflowTaskBySession.get(String(activeSessionId || 'unassigned')) ?? workflowTask;
       const runtimeKey = cachedTask?.id ?? `session:${activeSessionId || 'unassigned'}`;
       const runtime = runtimeFor(runtimeKey);
+      const stagedSource = runtimeFor(`session:${activeSessionId || 'unassigned'}`, false);
+      const sourceRows = stagedSource?.sourceRows ?? runtime.sourceRows ?? runtime.rows;
       const lastCsv = runtime.lastCsv;
-      const qccPreviewColumns = Array.isArray(qccRun?.rows) && qccRun.rows.length
-        ? Object.keys(qccRun.rows[0] || {}).slice(0, 8)
-        : [];
       const fieldByPattern = (pattern) => runtime.headers.find((field) => pattern.test(field)) ?? null;
       const phoneField = fieldByPattern(/^(phone|mobile|tel|telephone|联系电话|手机号码|手机号)$/i);
       const amountField = fieldByPattern(/^(amount|price|金额|注册资本)$/i);
@@ -3315,10 +3380,18 @@ window.__ModuleLoader__.load({
       };
 
       const startNewWorkflow = () => {
+        const event = document.createEvent('CustomEvent');
+        event.initCustomEvent('dsh:data-cleaning-prompt-new', false, true, { sessionId: activeSessionId });
+        if (document.dispatchEvent(event)) {
+          actions.setError('当前会话的任务向导尚未就绪或正在解析图片，请稍后重试。');
+          return;
+        }
         if (cachedTask?.id) runtimeTasks.delete(String(cachedTask.id));
+        runtimeTasks.delete(`session:${activeSessionId || 'unassigned'}`);
         runtimeTasks.delete('unassigned');
         workflowTaskBySession.delete(String(activeSessionId || 'unassigned'));
         actions.resetWorkflow();
+        actions.close();
       };
 
       const exportRows = () => runtime.resultRows.qcc
@@ -3604,17 +3677,11 @@ window.__ModuleLoader__.load({
               stat('未匹配', qccRun.summary?.unresolved ?? 0, (qccRun.summary?.unresolved ?? 0) > 0 ? 'warn' : null),
               stat('失败', qccRun.summary?.failed ?? 0, (qccRun.summary?.failed ?? 0) > 0 ? 'bad' : null),
             ),
-            Array.isArray(qccRun.rows) && qccRun.rows.length ? h('div', { className: 'dcAgentTableWrap' },
-              h('table', { className: 'dcAgentTable', 'aria-label': '匹配补全结果预览' },
-                h('thead', null, h('tr', null,
-                  qccPreviewColumns.map((key) => h('th', { key }, resultFieldLabel(key))),
-                )),
-                h('tbody', null, qccRun.rows.slice(0, 8).map((row, index) => h('tr', { key: `${index}-${row?.qcc_credit_no || row?.credit_no || ''}` },
-                  qccPreviewColumns.map((key) => h('td', { key }, String(row?.[key] ?? ''))),
-                ))),
-              ),
-              h('p', { className: 'dcAgentHint' }, `显示前 ${Math.min(8, qccRun.rows.length)} 行；完整结果在下载阶段生成耐久制品。`),
-            ) : null,
+            Array.isArray(qccRun.rows) && qccRun.rows.length ? h(DatasetReview, {
+              key: qccRun.runId, rows: qccRun.rows, headers: runtime.headers,
+              title: '企查查匹配补全结果', expectedCount: qccRun.summary?.totalRows,
+              onError: actions.setError,
+            }) : null,
             (qccRun.reviewQueue || []).map((item) => h('div', { key: item.companyName, className: 'dcAgentSection' },
               h('h3', null, `待核验：${item.companyName}`),
               item.candidates.map((candidate) => h('div', { key: candidate.creditNo, className: 'dcAgentCandidate' },
@@ -3716,15 +3783,16 @@ window.__ModuleLoader__.load({
             (dataset.headers || []).slice(0, 12).map((name) => h('span', { key: name, className: 'dcAgentChip' }, name)),
             (dataset.headers || []).length > 12 ? h('span', { className: 'dcAgentChip' }, `+${dataset.headers.length - 12} 列`) : null,
           ) : null,
-          dataset ? h('div', { className: 'dcAgentPreviewTable', 'aria-label': '数据预览' },
-            h('table', { className: 'dcAgentTable' },
-              h('thead', null, h('tr', null, (dataset.headers || []).slice(0, 8).map((name) => h('th', { key: name }, name)))),
-              h('tbody', null, (dataset.preview || []).slice(0, 5).map((row, index) => h('tr', { key: index }, (dataset.headers || []).slice(0, 8).map((name) => h('td', { key: name }, String(row?.[name] ?? '')))))),
-            ),
-          ) : null,
+          dataset ? h(DatasetReview, {
+            key: runtimeKey, rows: sourceRows, headers: dataset.headers || [],
+            expectedCount: dataset.rowCount,
+            title: runtime.source?.type === 'image' ? '图片识别原始名单（尚未匹配）' : '导入原始清单',
+            onError: actions.setError,
+          }) : null,
+          hasData ? h('p', { className: 'dcAgentHint' }, '请核对完整名单。识别清单不代表已完成企查查匹配。核对后进入「规则与体检」，确认规则生成质量体检；再进入「主体匹配」估算调用量并确认账号额度，点击「生成可编辑任务说明」自动回填中央对话框，无需手工复制任务凭证。') : null,
           h('div', { className: 'dcAgentRow' },
             h('button', { type: 'button', className: 'dcAgentButton is-primary', disabled: busy, 'aria-label': '解析数据', onClick: handleParse }, busy ? '解析中…' : '解析数据'),
-            hasData ? h('button', { type: 'button', className: 'dcAgentButton', onClick: () => actions.setStep('rules') }, '下一步：字段映射与规则') : null,
+            hasData ? h('button', { type: 'button', className: 'dcAgentButton', disabled: busy || sourceRows.length !== dataset.rowCount, onClick: () => actions.setStep('rules') }, '已核对清单，下一步：字段映射与规则') : null,
           ),
         );
       }
@@ -3785,19 +3853,39 @@ window.__ModuleLoader__.load({
               }, '✕'),
             ),
           ),
-          h('nav', { className: 'dcAgentStepper', 'aria-label': '清洗流程' },
+          h('nav', { className: 'dcAgentRow', style: { padding: '10px 16px' }, 'aria-label': '工作台管理' },
+            h('button', { type: 'button', className: 'dcAgentButton', 'aria-pressed': step !== 'history',
+              onClick: () => actions.setStep(cachedTask?.stage || 'upload') }, '当前任务'),
+            h('button', { type: 'button', className: 'dcAgentButton', 'aria-pressed': step === 'history',
+              onClick: () => actions.setStep('history') }, '任务历史'),
+          ),
+          step !== 'history' ? h('nav', { className: 'dcAgentStepper', 'aria-label': '清洗流程' },
             STEPS.map((st) => h('button', {
               key: st.key,
               type: 'button',
-              className: `dcAgentStep${step === st.key ? ' is-active' : ''}`,
+              className: `dcAgentStep${(step === 'profile' ? 'rules' : step) === st.key ? ' is-active' : ''}`,
               'aria-label': st.label,
-              'aria-current': step === st.key ? 'step' : undefined,
+              'aria-current': (step === 'profile' ? 'rules' : step) === st.key ? 'step' : undefined,
               onClick: () => actions.setStep(st.key),
             }, `${st.icon} ${st.label}`)),
-          ),
+          ) : null,
           h('div', { className: 'dcAgentWbBody' },
             error ? h('div', { className: 'dcAgentError', role: 'alert' }, error) : null,
-            pane,
+            step !== 'history' ? h('details', { className: 'dcAgentSection' },
+              h('summary', null, '使用说明与任务流程'),
+              h('p', { className: 'dcAgentHint' }, '导入与核验 → 规则与体检 → 主体匹配 → 字段补全 → 结果下载。菜单只切换视图，不启动调用；按页面主按钮逐步确认。'),
+              h('p', { className: 'dcAgentHint' }, '支持文本、Excel、JSON 和图片名单。原值保留、多候选人工核验；企查查调用使用当前用户自己的连接与额度。'),
+            ) : null,
+            ['rules', 'profile'].includes(step) ? h('nav', { className: 'dcAgentRow', 'aria-label': '规则与体检视图' },
+              h('button', { type: 'button', className: 'dcAgentButton', 'aria-pressed': step === 'rules', onClick: () => actions.setStep('rules') }, '字段映射与规则'),
+              h('button', { type: 'button', className: 'dcAgentButton', 'aria-pressed': step === 'profile', onClick: () => actions.setStep('profile') }, '质量体检报告'),
+            ) : null,
+            workflowNavigationIssue(step, cachedTask, hasData, profile, qccRun)
+              ? h('section', { className: 'dcAgentSection', role: 'status' },
+                  h('p', null, workflowNavigationIssue(step, cachedTask, hasData, profile, qccRun)),
+                  h('button', { type: 'button', className: 'dcAgentButton',
+                    onClick: () => actions.setStep(!hasData ? 'upload' : !cachedTask || ['draft', 'uploaded'].includes(cachedTask.state) ? 'rules' : cachedTask.state === 'rules_confirmed' ? 'profile' : step === 'download' ? 'enrich' : 'match') }, '前往前置步骤'))
+              : pane,
           ),
         ),
       );
@@ -3844,7 +3932,7 @@ window.__ModuleLoader__.load({
           inject: () => ({ startSession: () => startCleaningSession(ctx) }),
         }, SidebarEntry));
 
-        // 独立 dock 行：对齐 Mockup 的五个能力 ICON，CSS 只把本 cell 排到输入框下方。
+        // dock 托管会话生命周期；菜单 Portal 到输入框后，不重排共享槽位。
         ctx.slots.inject('conversation.input.dock', () => ctx.slots.register({
           name: 'conversation.input.dock',
           id: 'data-cleaning-agent-capabilities',
@@ -3896,7 +3984,14 @@ window.__ModuleLoader__.load({
     exports.inject = inject;
     // 测试用纯函数，不构成 Host / DSH 稳定 API。
     exports.__testing = {
+      installCapabilityMount,
+      PromptDialog,
+      ProductHome,
+      workflowNavigationIssue,
       buildTaskPrompt,
+      DatasetReview,
+      reviewColumns,
+      reviewCsv,
       clearCleaningDraft,
       entriesToDataset,
       extractPromptEntries,

package/lib/image-intake.js

@@ -580,7 +580,7 @@ export function registerImageIntakeTool(tools, store) {
       },
       render: (_args, value) => [{
         type: 'text',
-        text: `企查查智能文档解析已识别图片企业名单：${value.entryCount} 条，已同步回数据清洗补全工作台等待核验。`,
+        text: `企查查智能文档解析已识别图片企业名单：${value.entryCount} 条，已同步回数据清洗补全工作台等待核验。请在「导入与核验」查看原始清单全部行或下载全量 CSV/JSON，核对后进入「规则与体检」确认规则并生成质量体检，再到「主体匹配」估算调用量并确认账号额度，点击「生成可编辑任务说明」自动回填中央对话框。无需手工复制 dcq- 凭证或重新粘贴名单；识别名单不代表已匹配，尚未查询时不要编造匹配摘要。`,
       }],
     },
     async execute(args, exec) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-data-cleaning-agent",
-  "version": "0.8.5",
+  "version": "0.8.7",
   "description": "Clean, complete, and profile enterprise name lists in DeepSeek Harness — a data cleaning & completion agent plugin with local CSV/XLSX/JSON engine and optional Qichacha (QCC) MCP enrichment. Maintained by Qichacha/QCC.",
   "type": "module",
   "main": "lib/index.js",
@@ -45,6 +45,7 @@
     "docs/G5-E2E-RUNBOOK.md"
   ],
   "scripts": {
+    "test:ui": "node scripts/ui-layout-regression.mjs",
     "test": "node --test",
     "lint": "node --check lib/index.js && node --check lib/engine.js && node --check lib/artifacts.js && node --check lib/image-intake.js && node --check lib/tools.js && node --check lib/skill.js && node --check lib/qcc-field-catalog.js && node --check lib/qcc-phase2.js && node --check lib/qcc-phase3.js && node --check lib/qcc-phase3-batch.js && node --check lib/qcc-phase2-acceptance.js && node --check lib/skill-enrich.js && node --check lib/jobs.js && node --check lib/workflow-contract.js && node --check lib/workflow.js && node --check lib/qcc-safety.js && node --check lib/qcc.js && node --check lib/qcc-command.js && node --check lib/qcc-runs.js && node --check lib/web.js && node --check lib/client.js && node --check scripts/check-readme-version.mjs && node --check scripts/check-market-registration.mjs && node --check scripts/g5-e2e.mjs && node --check scripts/phase3-e2e.mjs && node --check scripts/phase2-acceptance.mjs",
     "docs:check": "node scripts/check-readme-version.mjs",