dsh-data-cleaning-agent 0.8.6 → 0.8.7

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 本文件记录 `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

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.6** (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.6**（正式版本）
+> 当前源码版本 / 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; }
@@ -897,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: '▦' },
@@ -1801,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': '数据清洗补全智能体能力' },
@@ -1826,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
      * 阶段替换标题，并在卸载时恢复，避免污染普通会话。
@@ -1979,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]
@@ -1988,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,
       );
     }
@@ -2276,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);
       };
 
@@ -2332,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();
@@ -2342,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;
@@ -2376,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, '生成数据清洗补全任务'),
@@ -2395,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,
@@ -2522,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
@@ -2531,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,
       );
     }
 
@@ -3378,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
@@ -3779,7 +3789,7 @@ window.__ModuleLoader__.load({
             title: runtime.source?.type === 'image' ? '图片识别原始名单（尚未匹配）' : '导入原始清单',
             onError: actions.setError,
           }) : null,
-          hasData ? h('p', { className: 'dcAgentHint' }, '请核对完整名单。识别清单不代表已完成企查查匹配。核对后进入「字段映射与规则」，确认规则生成质量体检；再进入「数据匹配」估算调用量并确认账号额度，点击「生成可编辑任务说明」自动回填中央对话框，无需手工复制任务凭证。') : 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', disabled: busy || sourceRows.length !== dataset.rowCount, onClick: () => actions.setStep('rules') }, '已核对清单，下一步：字段映射与规则') : null,
@@ -3843,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,
           ),
         ),
       );
@@ -3902,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',
@@ -3954,6 +3984,10 @@ window.__ModuleLoader__.load({
     exports.inject = inject;
     // 测试用纯函数，不构成 Host / DSH 稳定 API。
     exports.__testing = {
+      installCapabilityMount,
+      PromptDialog,
+      ProductHome,
+      workflowNavigationIssue,
       buildTaskPrompt,
       DatasetReview,
       reviewColumns,

package/lib/image-intake.js

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