dsh-data-cleaning-agent 0.6.0 → 0.6.2

package/lib/client.js

@@ -822,34 +822,66 @@ window.__ModuleLoader__.load({
     const DEFAULT_CLEANING_KEYS = ['clean_name', 'deduplicate', 'validate_identity', 'complete_fields'];
     const DEFAULT_ENRICHMENT_KEYS = ['credit_no', 'legal_rep', 'reg_capital', 'establish_date', 'reg_status'];
     const DEFAULT_SESSION_PROMPT = '请帮我清洗并补全企业名单。可点击输入框左上角「提示词生成」录入名单、上传 Excel 或图片，也可直接修改本段任务说明后开始。';
-    const CLEANING_SESSION_STORAGE_KEY = 'dsh.data-cleaning-agent.sessions.v1';
-    const CLEANING_SESSION_EVENT = 'dsh:data-cleaning-session-marked';
-    const cleaningSessionIds = new Set();
+    const CLEANING_SESSION_STORAGE_KEYS = [
+      'dsh.data-cleaning-agent.active-session.v2',
+      'dsh.data-cleaning-agent.sessions.v1',
+    ];
+    const CLEANING_SESSION_EVENT = 'dsh:data-cleaning-session-ownership';
+    let activeCleaningSessionId = null;
 
     try {
-      const stored = window.sessionStorage?.getItem(CLEANING_SESSION_STORAGE_KEY);
-      for (const id of JSON.parse(stored || '[]')) {
-        if (typeof id === 'string' && id) cleaningSessionIds.add(id);
-      }
+      // 旧版本持久化过 sessionId；但 DSH 会复用空白新会话，无法仅凭 ID 判断入口来源。
+      // 子系统归属因此只在当前页面、经菜单显式激活，并在升级时清除所有旧标记。
+      for (const key of CLEANING_SESSION_STORAGE_KEYS) window.sessionStorage?.removeItem(key);
     } catch (_error) {
-      // sessionStorage 可能被禁用；当前页面内的 Set 仍可工作。
+      // sessionStorage 可能被禁用；内存态不受影响。
     }
 
     function isCleaningSession(sessionId) {
-      return typeof sessionId === 'string' && cleaningSessionIds.has(sessionId);
+      return typeof sessionId === 'string' && sessionId === activeCleaningSessionId;
     }
 
     function markCleaningSession(sessionId) {
       if (typeof sessionId !== 'string' || !sessionId) return;
-      cleaningSessionIds.add(sessionId);
-      try {
-        window.sessionStorage?.setItem(CLEANING_SESSION_STORAGE_KEY, JSON.stringify([...cleaningSessionIds].slice(-20)));
-      } catch (_error) {
-        // 不因浏览器存储策略阻断会话。
+      activeCleaningSessionId = sessionId;
+      if (typeof window.CustomEvent === 'function' && typeof window.dispatchEvent === 'function') {
+        window.dispatchEvent(new window.CustomEvent(CLEANING_SESSION_EVENT, { detail: { sessionId, active: true } }));
+      }
+    }
+
+    function isKnownCleaningDraft(value) {
+      if (value === DEFAULT_SESSION_PROMPT) return true;
+      if (typeof value !== 'string') return false;
+      return value.startsWith('请执行一项企业名单数据清洗补全任务。')
+        && value.includes('企查查连接、套餐额度和费用均由当前用户自己的账号承担。')
+        && value.includes('提供结果和待复核清单的导出。');
+    }
+
+    function clearCleaningDraft(ctx, sessionId, onlyDefault = false) {
+      if (!sessionId) return false;
+      const conversation = typeof ctx.get === 'function' ? ctx.get('conversation') : ctx.conversation;
+      const shell = conversation?.input?.shell?.(sessionId);
+      if (!shell || typeof shell.setDraft !== 'function') return false;
+      if (onlyDefault && !isKnownCleaningDraft(shell.snapshot?.draft)) return false;
+      shell.setDraft('');
+      return true;
+    }
+
+    function deactivateCleaningSession(sessionId = activeCleaningSessionId) {
+      if (!activeCleaningSessionId || (sessionId && sessionId !== activeCleaningSessionId)) return false;
+      const previousSessionId = activeCleaningSessionId;
+      activeCleaningSessionId = null;
+      if (rootWorkbenchActions) {
+        stopJobsPolling();
+        rootWorkbenchActions.close?.();
+        rootWorkbenchActions.setActiveSession?.(null);
       }
       if (typeof window.CustomEvent === 'function' && typeof window.dispatchEvent === 'function') {
-        window.dispatchEvent(new window.CustomEvent(CLEANING_SESSION_EVENT, { detail: { sessionId } }));
+        window.dispatchEvent(new window.CustomEvent(CLEANING_SESSION_EVENT, {
+          detail: { sessionId: previousSessionId, active: false },
+        }));
       }
+      return true;
     }
 
     function useCleaningSession(sessionId) {
@@ -858,14 +890,89 @@ window.__ModuleLoader__.load({
       );
       react.useEffect(() => {
         const handleMarked = (event) => {
-          if (event?.detail?.sessionId === sessionId) setMarkedSessionId(sessionId);
+          const detail = event?.detail ?? {};
+          setMarkedSessionId(detail.active === true && detail.sessionId === sessionId ? sessionId : null);
         };
         window.addEventListener?.(CLEANING_SESSION_EVENT, handleMarked);
         return () => window.removeEventListener?.(CLEANING_SESSION_EVENT, handleMarked);
       }, [sessionId]);
       // DSH 可能复用同一个 slot component 切换会话；状态必须绑定具体 sessionId，
       // 避免从清洗会话切回普通会话后仍残留业务首页与提示词入口。
-      return markedSessionId === sessionId || isCleaningSession(sessionId);
+      return markedSessionId === sessionId && isCleaningSession(sessionId);
+    }
+
+    /**
+     * 清洗补全是一个显式进入的业务子系统。切换会话、点击新会话或点击侧栏其它业务
+     * 入口时立即撤销其激活态，即使 DSH 复用了同一个空白 sessionId 也不会残留首页、
+     * 提示词、能力栏或工作台。点击本插件自己的顶部入口不会提前撤销。
+     */
+    function installSessionOwnershipBridge(ctx) {
+      let staleDraftObserver = null;
+      let staleDraftObserverTimer = null;
+      const clearStaleDefaultDraft = () => {
+        if (activeCleaningSessionId) return false;
+        const currentSessionId = ctx.sessions?.list?.getSnapshot?.()?.current;
+        const cleared = clearCleaningDraft(ctx, currentSessionId, true);
+        if (cleared && staleDraftObserver) {
+          staleDraftObserver.disconnect();
+          staleDraftObserver = null;
+        }
+        return cleared;
+      };
+      const leaveSubsystem = () => {
+        const sessionId = activeCleaningSessionId;
+        if (sessionId) clearCleaningDraft(ctx, sessionId);
+        deactivateCleaningSession(sessionId);
+      };
+      const handleSidebarNavigation = (event) => {
+        if (!activeCleaningSessionId) return;
+        const target = event?.target;
+        if (!target || typeof target.closest !== 'function') return;
+        if (target.closest('.dcAgentLauncher, .dcAgentExperience, .dcAgentPromptPopover, .dcAgentWorkbench, .dcAgentHeaderAction')) return;
+
+        const actionable = target.closest('button, a, [role="button"]');
+        if (!actionable) return;
+        const workspaceSlot = document.querySelector?.(SIDEBAR_WORKSPACES_SELECTOR);
+        const sidebarRoot = workspaceSlot?.closest?.('aside, nav, [data-slot="sidebar"], [class*="sidebar"]')
+          ?? workspaceSlot?.parentElement;
+        const label = `${actionable.getAttribute?.('aria-label') ?? ''} ${actionable.textContent ?? ''}`.trim();
+        const sessionOrAgentEntry = /新建?会话|新会话|new\s+session|智能体|agent|尽调/i.test(label);
+        if (sidebarRoot?.contains?.(actionable) || sessionOrAgentEntry) leaveSubsystem();
+      };
+
+      document.addEventListener?.('click', handleSidebarNavigation, true);
+      // 升级 / 刷新后不恢复子系统所有权；仅清理由旧版本遗留且仍未被用户编辑的默认文案。
+      clearStaleDefaultDraft();
+      // DSH 会在插件 apply() 之后异步恢复 composer draft。在首屏稳定期内
+      // 监听 DOM 变化并仅清理完全匹配本插件默认文案，或同时命中
+      // 提示词向导固定首尾与费用声明签名的草稿；不触碰用户自写内容。
+      if (typeof MutationObserver === 'function' && document.documentElement) {
+        staleDraftObserver = new MutationObserver(clearStaleDefaultDraft);
+        staleDraftObserver.observe(document.documentElement, {
+          childList: true,
+          characterData: true,
+          subtree: true,
+        });
+        staleDraftObserverTimer = setTimeout(() => {
+          staleDraftObserver?.disconnect();
+          staleDraftObserver = null;
+          staleDraftObserverTimer = null;
+        }, 10_000);
+      }
+      const unsubscribe = ctx.sessions?.list?.subscribe?.((snapshot) => {
+        const nextSessionId = snapshot?.current;
+        if (activeCleaningSessionId && nextSessionId && nextSessionId !== activeCleaningSessionId) {
+          leaveSubsystem();
+        } else if (!activeCleaningSessionId) {
+          clearStaleDefaultDraft();
+        }
+      });
+      return () => {
+        document.removeEventListener?.('click', handleSidebarNavigation, true);
+        staleDraftObserver?.disconnect();
+        if (staleDraftObserverTimer !== null) clearTimeout(staleDraftObserverTimer);
+        if (typeof unsubscribe === 'function') unsubscribe();
+      };
     }
 
     function optionLabels(options, keys) {
@@ -1001,6 +1108,18 @@ window.__ModuleLoader__.load({
       return requestJson(path, body === undefined ? 'GET' : 'POST', body);
     }
 
+    async function waitForQccCommand(commandId, attempts = 180) {
+      for (let attempt = 0; attempt < attempts; attempt += 1) {
+        const response = await api(`/data-cleaning/api/g5/commands/${encodeURIComponent(commandId)}`);
+        const command = response?.command;
+        if (command?.state === 'completed' || command?.state === 'failed') return command;
+        await new Promise((resolve) => setTimeout(resolve, 1000));
+      }
+      const error = new Error('等待智能体执行企查查任务超时；可稍后从任务历史恢复结果。');
+      error.code = 'QCC_COMMAND_TIMEOUT';
+      throw error;
+    }
+
     function cacheWorkflowTask(actions, sessionId, task) {
       if (!task) return null;
       if (sessionId) workflowTaskBySession.set(String(sessionId), task);
@@ -1251,6 +1370,15 @@ window.__ModuleLoader__.load({
       return images.length;
     }
 
+    async function sendQccAgentCommand(ctx, sessionId, prompt) {
+      const scoped = typeof ctx.sessions?.scope === 'function' ? ctx.sessions.scope(sessionId) : null;
+      const sessionConversation = scoped?.get?.('conversation');
+      if (!sessionConversation || typeof sessionConversation.send !== 'function') {
+        throw new Error('当前 DSH 版本没有可用的 Session conversation.send 能力');
+      }
+      await sessionConversation.send(prompt);
+    }
+
     function capabilityIcon(item, size = 16) {
       return typeof item.icon === 'function'
         ? h(item.icon, { size, 'aria-hidden': 'true' })
@@ -1453,7 +1581,12 @@ window.__ModuleLoader__.load({
 
     /**
      * DSH 当前只公开 hero brand.mark，没有 headline slot。这里仅在本插件会话且 blank hero
-     * 阶段精确替换原生中英文标题，并在卸载时恢复，避免污染普通会话。
+     * 阶段替换标题，并在卸载时恢复，避免污染普通会话。
+     *
+     * 某些第三方插件会全局改写 hero headline、向所有会话注入自己的 dock。清洗会话必须
+     * 仍然保持自己的标题和单一业务入口，因此用 headline class 作为最后降级，并只隐藏与
+     * 当前清洗 hero 同一 composer stack 内、带明确「尽调类型」aria 标签的已知外来 dock。
+     * 所有变更均记录原值并在会话离开 / 组件卸载时恢复。
      */
     function rewriteHeroChrome(sessionId, enabled) {
       if (!enabled || typeof document === 'undefined' || typeof document.querySelectorAll !== 'function') return () => {};
@@ -1461,32 +1594,63 @@ window.__ModuleLoader__.load({
         .find((element) => element?.dataset?.sessionId === sessionId);
       const hero = marker?.closest?.('[data-phase="hero"]');
       if (!hero) return () => {};
-      const spans = [...hero.querySelectorAll('span')];
-      const title = spans.find((element) => ['探索未至之境', 'Into the Unknown'].includes(element.textContent?.trim()))
-        ?? spans.find((element) => element.dataset?.dcAgentHeroTitle === 'true');
-      const badge = spans.find((element) => ['预览版', 'Preview'].includes(element.textContent?.trim()))
-        ?? spans.find((element) => element.dataset?.dcAgentHeroBadge === 'true');
-      if (title) {
-        title.dataset.dcAgentHeroTitle = 'true';
-        title.dataset.dcAgentOriginalText ??= title.textContent ?? '';
-        title.textContent = '数据清洗补全智能体';
-      }
-      if (badge) {
-        badge.dataset.dcAgentHeroBadge = 'true';
-        badge.dataset.dcAgentOriginalDisplay ??= badge.style?.display ?? '';
-        if (badge.style) badge.style.display = 'none';
-      }
+      const changedTitles = new Map();
+      const changedBadges = new Map();
+      const hiddenForeignDocks = new Map();
+      const composerStack = marker?.parentElement?.parentElement;
+
+      const fix = () => {
+        const spans = [...hero.querySelectorAll('span')];
+        const title = spans.find((element) => element.dataset?.dcAgentHeroTitle === 'true')
+          ?? spans.find((element) => ['探索未至之境', 'Into the Unknown'].includes(element.textContent?.trim()))
+          ?? hero.querySelector?.('[class*="headlineText"]');
+        const badge = spans.find((element) => element.dataset?.dcAgentHeroBadge === 'true')
+          ?? spans.find((element) => ['预览版', 'Preview'].includes(element.textContent?.trim()));
+        if (title) {
+          if (!changedTitles.has(title)) changedTitles.set(title, title.textContent ?? '');
+          title.dataset.dcAgentHeroTitle = 'true';
+          if (title.textContent !== '数据清洗补全智能体') title.textContent = '数据清洗补全智能体';
+        }
+        if (badge) {
+          if (!changedBadges.has(badge)) changedBadges.set(badge, badge.style?.display ?? '');
+          badge.dataset.dcAgentHeroBadge = 'true';
+          if (badge.style && badge.style.display !== 'none') badge.style.display = 'none';
+        }
+
+        const foreignSurfaces = composerStack?.querySelectorAll?.('[aria-label="尽调类型"], .qccDock') ?? [];
+        for (const foreignSurface of foreignSurfaces) {
+          let hideTarget = foreignSurface;
+          while (hideTarget?.parentElement
+            && hideTarget.parentElement !== composerStack
+            && hideTarget.parentElement !== marker.parentElement) {
+            hideTarget = hideTarget.parentElement;
+          }
+          // DSH 的 list slot 可能把多个插件放进同一个 data-slot 容器。此时只能隐藏
+          // 对方自己的根节点，不能隐藏共享 slot；独立 host 则隐藏其直接容器。
+          if ((hideTarget?.parentElement === composerStack || hideTarget?.parentElement === marker.parentElement)
+            && !hideTarget.contains?.(marker)) {
+            if (!hiddenForeignDocks.has(hideTarget)) hiddenForeignDocks.set(hideTarget, hideTarget.style?.display ?? '');
+            if (hideTarget.style && hideTarget.style.display !== 'none') hideTarget.style.display = 'none';
+          }
+        }
+      };
+
+      fix();
+      const observer = typeof MutationObserver === 'function' ? new MutationObserver(fix) : null;
+      observer?.observe?.(hero, { childList: true, subtree: true });
       return () => {
-        if (title?.dataset?.dcAgentOriginalText !== undefined) {
-          title.textContent = title.dataset.dcAgentOriginalText;
-          delete title.dataset.dcAgentOriginalText;
+        observer?.disconnect?.();
+        for (const [title, originalText] of changedTitles) {
+          if (title.textContent === '数据清洗补全智能体') title.textContent = originalText;
           delete title.dataset.dcAgentHeroTitle;
         }
-        if (badge?.dataset?.dcAgentOriginalDisplay !== undefined) {
-          if (badge.style) badge.style.display = badge.dataset.dcAgentOriginalDisplay;
-          delete badge.dataset.dcAgentOriginalDisplay;
+        for (const [badge, originalDisplay] of changedBadges) {
+          if (badge.style) badge.style.display = originalDisplay;
           delete badge.dataset.dcAgentHeroBadge;
         }
+        for (const [foreignDock, originalDisplay] of hiddenForeignDocks) {
+          if (foreignDock.style) foreignDock.style.display = originalDisplay;
+        }
       };
     }
 
@@ -1942,6 +2106,7 @@ window.__ModuleLoader__.load({
     /** 右侧非模态工作台：中央区域始终保留 DSH 原生会话。 */
     function WorkbenchDrawer(props) {
       const { useStore, actions } = props;
+      const sendSessionCommand = props.sendSessionCommand;
       const open = useStore((state) => state.open);
       const step = useStore((state) => state.step);
       const expanded = useStore((state) => state.expanded);
@@ -2088,6 +2253,7 @@ window.__ModuleLoader__.load({
       if (!open) return null;
 
       const hasData = dataset !== null && dataset.rowCount > 0;
+      const requiresQcc = objectives.includes('validate_identity') || objectives.includes('complete_fields');
       const cachedTask = workflowTaskBySession.get(String(activeSessionId || 'unassigned')) ?? workflowTask;
       const runtimeKey = cachedTask?.id ?? `session:${activeSessionId || 'unassigned'}`;
       const runtime = runtimeFor(runtimeKey);
@@ -2165,7 +2331,7 @@ window.__ModuleLoader__.load({
         actions.setError(null);
         try {
           await performProfile(cachedTask);
-          actions.setStep('match');
+          actions.setStep(requiresQcc ? 'match' : 'enrich');
         } catch (err) {
           actions.setError(err instanceof Error ? err.message : String(err));
         } finally {
@@ -2246,11 +2412,13 @@ window.__ModuleLoader__.load({
 
       const estimateQcc = async () => {
         const uniqueCompanies = new Set(runtime.rows.map((row) => String(row?.[nameField] ?? '').trim()).filter(Boolean)).size;
+        const requiresProfile = fieldSelection.some((field) => ['company_profile', 'industry_large', 'industry_middle'].includes(field));
+        const callsPerCompany = requiresProfile ? 3 : 2;
         actions.setQccEstimate({
           uniqueCompanies,
-          tools: ['主体查询', '工商信息'],
-          estimatedCalls: uniqueCompanies * 2,
-          maxCalls: 200,
+          tools: requiresProfile ? ['主体查询', '工商信息', '企业画像'] : ['主体查询', '工商信息'],
+          estimatedCalls: uniqueCompanies * callsPerCompany,
+          maxCalls: 300,
           withinLimit: runtime.rows.length <= 100,
           estimateType: 'upper-bound',
         });
@@ -2302,24 +2470,44 @@ window.__ModuleLoader__.load({
         return current;
       };
 
+      const executePreparedQccCommand = async (payload) => {
+        if (!activeSessionId || typeof sendSessionCommand !== 'function') {
+          throw new Error('当前会话无法提交数据清洗补全企查查任务');
+        }
+        const prepared = await api('/data-cleaning/api/g5/commands', {
+          ...payload,
+          confirmPaidCalls: true,
+        });
+        const command = prepared?.command;
+        if (!command?.commandId || !command?.prompt) throw new Error('Host 未返回有效的企查查任务命令');
+        await sendSessionCommand(activeSessionId, command.prompt);
+        const completedCommand = await waitForQccCommand(command.commandId);
+        if (completedCommand.state === 'failed') {
+          const commandError = new Error(completedCommand.error?.message || '智能体企查查任务执行失败');
+          commandError.code = completedCommand.error?.code;
+          throw commandError;
+        }
+        if (!completedCommand.run) throw new Error('智能体企查查任务完成但结果已失效');
+        return completedCommand.run;
+      };
+
       const runQcc = async () => {
         if (busy || !qccEstimate || !paidConfirmed || !qccEstimate.withinLimit) return;
         actions.setBusy(true);
         actions.setError(null);
         try {
-          await workflowAction(actions, activeSessionId, cachedTask, 'match-start');
-          const key = `g5-ui-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
-          const r = await api('/data-cleaning/api/g5/enrich', {
+          const current = await workflowAction(actions, activeSessionId, cachedTask, 'match-start');
+          const r = await executePreparedQccCommand({
+            kind: 'enrich',
+            taskId: current.id,
             rows: runtime.rows,
             headers: runtime.headers,
             nameField,
+            fieldSelection,
             includeRisk: false,
             concurrency: 2,
-            confirmPaidCalls: true,
-            idempotencyKey: key,
           });
-          if (r && r.ok !== false) await applyQccRun(r);
-          else actions.setError((r && (r.message || r.error)) || '企业匹配补全失败');
+          await applyQccRun(r);
         } catch (err) {
           if (['QCC_NOT_CONNECTED', 'QCC_TOOL_UNAVAILABLE', 'QCC_AUTH_REQUIRED'].includes(err?.code)) {
             try { await workflowAction(actions, activeSessionId, cachedTask, 'authorization-required'); } catch (_workflowError) {}
@@ -2335,15 +2523,15 @@ window.__ModuleLoader__.load({
         actions.setBusy(true);
         actions.setError(null);
         try {
-          const r = await api('/data-cleaning/api/g5/resolve', {
+          const task = workflowTaskBySession.get(String(activeSessionId || 'unassigned')) ?? cachedTask;
+          const r = await executePreparedQccCommand({
+            kind: 'resolve',
+            taskId: task.id,
             runId: qccRun.runId,
             companyName: item.companyName,
             selectedCreditNo: candidate.creditNo,
-            confirmPaidCalls: true,
-            idempotencyKey: `g5-resolve-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
           });
-          if (r && r.ok !== false) await applyQccRun(r);
-          else actions.setError((r && (r.message || r.error)) || '候选确认失败');
+          await applyQccRun(r);
         } catch (err) {
           actions.setError(err instanceof Error ? err.message : String(err));
         } finally {
@@ -2358,14 +2546,14 @@ window.__ModuleLoader__.load({
         actions.setBusy(true);
         actions.setError(null);
         try {
-          const r = await api('/data-cleaning/api/g5/retry', {
+          const task = workflowTaskBySession.get(String(activeSessionId || 'unassigned')) ?? cachedTask;
+          const r = await executePreparedQccCommand({
+            kind: 'retry',
+            taskId: task.id,
             runId: qccRun.runId,
             companyNames: names,
-            confirmPaidCalls: true,
-            idempotencyKey: `g5-retry-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
           });
-          if (r && r.ok !== false) await applyQccRun(r);
-          else actions.setError((r && (r.message || r.error)) || '失败项重试失败');
+          await applyQccRun(r);
         } catch (err) {
           actions.setError(err instanceof Error ? err.message : String(err));
         } finally {
@@ -2526,9 +2714,23 @@ window.__ModuleLoader__.load({
         }
       };
 
+      const displayStatValue = (value) => {
+        if (typeof value === 'string' || typeof value === 'number') return value;
+        if (typeof value === 'bigint' || typeof value === 'boolean') return String(value);
+        return '—';
+      };
+      // 浏览器运行时只保留当前会话的原始明细；进程重启后，已完成任务应从
+      // Host 持久化摘要恢复计数，不能因 qccRun 仅存在于内存而显示“—”。
+      const qccEnrichedCount = qccRun
+        ? qccRun.summary?.enriched ?? 0
+        : cachedTask?.enrichmentSummary?.completed;
+      const qccReviewCount = qccRun
+        ? qccRun.summary?.ambiguous ?? 0
+        : cachedTask?.enrichmentSummary?.reviewRequired
+          ?? cachedTask?.matchSummary?.reviewRequired;
       const stat = (label, value, tone) => h('div', { className: 'dcAgentCard' },
         h('span', null, label),
-        h('b', { className: tone ? `is-${tone}` : null }, value)
+        h('b', { className: tone ? `is-${tone}` : null }, displayStatValue(value))
       );
       const uiFieldGroups = Array.isArray(workflowContract?.fieldCatalog)
         ? workflowContract.fieldCatalog.map((group) => [group.id, group.label, (group.fields || []).map((field) => [field.id, field.label])])
@@ -2645,7 +2847,12 @@ window.__ModuleLoader__.load({
               ))),
             ) : null,
             h('div', { className: 'dcAgentRow' },
-              h('button', { type: 'button', className: 'dcAgentButton is-primary', disabled: busy, onClick: () => actions.setStep('match') }, '下一步：匹配核验'),
+              h('button', {
+                type: 'button',
+                className: 'dcAgentButton is-primary',
+                disabled: busy,
+                onClick: () => actions.setStep(requiresQcc ? 'match' : 'enrich'),
+              }, requiresQcc ? '下一步：匹配核验' : '下一步：本地清洗补全'),
             ),
           ) : h('div', { className: 'dcAgentRow' },
             h('button', { type: 'button', className: 'dcAgentButton is-primary', disabled: busy || !hasData, 'aria-label': '生成体检报告', onClick: runProfile }, busy ? '体检中…' : '生成体检报告'),
@@ -2737,8 +2944,8 @@ window.__ModuleLoader__.load({
             stat('输入行数', dataset ? dataset.rowCount : '—'),
             stat('清洗保留', clean ? clean.kept : '—', clean && clean.kept > 0 ? 'good' : null),
             stat('本地补全', complete ? complete.completed : '—', complete && complete.completed > 0 ? 'good' : null),
-            stat('QCC 已补全', qccRun ? qccRun.summary?.enriched ?? 0 : '—', qccRun && qccRun.summary?.enriched > 0 ? 'good' : null),
-            stat('待核验', qccRun ? qccRun.summary?.ambiguous ?? 0 : '—', qccRun && qccRun.summary?.ambiguous > 0 ? 'warn' : null),
+            stat('QCC 已补全', qccEnrichedCount, qccEnrichedCount > 0 ? 'good' : null),
+            stat('待核验', qccReviewCount, qccReviewCount > 0 ? 'warn' : null),
           ),
           h('div', { className: 'dcAgentRow' }, h('button', { type: 'button', className: 'dcAgentButton is-primary', onClick: () => actions.setStep('download') }, '进入下载数据')),
         );
@@ -2749,8 +2956,8 @@ window.__ModuleLoader__.load({
           h('p', { className: 'dcAgentHint' }, '结果与异常清单由 Host 生成 CSV/XLSX 四件套并耐久保存。任务或插件重启后，可从任务历史继续下载；无需再次调用企查查。'),
           h('div', { className: 'dcAgentGrid' },
             stat('输入行数', dataset ? dataset.rowCount : workflowTask?.source?.rowCount ?? '—'),
-            stat('匹配补全', qccRun ? qccRun.summary?.enriched ?? 0 : '—', qccRun && qccRun.summary?.enriched > 0 ? 'good' : null),
-            stat('待核验', qccRun ? qccRun.summary?.ambiguous ?? 0 : '—', qccRun && qccRun.summary?.ambiguous > 0 ? 'warn' : null),
+            stat('匹配补全', qccEnrichedCount, qccEnrichedCount > 0 ? 'good' : null),
+            stat('待核验', qccReviewCount, qccReviewCount > 0 ? 'warn' : null),
             stat('任务状态', WORKFLOW_STATE_LABELS[cachedTask?.state] || cachedTask?.state || '进行中'),
           ),
           availableArtifacts.length ? h('div', { className: 'dcAgentArtifactList' },
@@ -2897,6 +3104,7 @@ window.__ModuleLoader__.load({
       try {
         const workbenchStore = createWorkbenchStore();
         ctx.effect(() => installUiStyles(), 'data-cleaning-agent: UI styles');
+        ctx.effect(() => installSessionOwnershipBridge(ctx), 'data-cleaning-agent: session ownership');
 
         // 右侧工作台：additive overlay，不替换 DSH 单占位 details 面板。
         ctx.slots.inject('shell.overlay', () => ctx.slots.register({
@@ -2904,6 +3112,9 @@ window.__ModuleLoader__.load({
           id: 'data-cleaning-agent',
           order: 200,
           store: workbenchStore,
+          inject: () => ({
+            sendSessionCommand: (sessionId, prompt) => sendQccAgentCommand(ctx, sessionId, prompt),
+          }),
         }, WorkbenchDrawer));
 
         // 左栏：footer 只托管生命周期和 Portal 降级；实际入口显示在工作区列表前。
@@ -2961,11 +3172,17 @@ window.__ModuleLoader__.load({
     // 测试用纯函数，不构成 Host / DSH 稳定 API。
     exports.__testing = {
       buildTaskPrompt,
+      clearCleaningDraft,
       entriesToDataset,
       extractPromptEntries,
       guessMappings,
+      deactivateCleaningSession,
+      installSessionOwnershipBridge,
+      isCleaningSession,
+      isKnownCleaningDraft,
       markCleaningSession,
       qualitySummaryFor,
+      rewriteHeroChrome,
       ensureWorkflowTask,
       queueWorkflowOperation,
     };

package/lib/engine.js

@@ -221,7 +221,7 @@ export function completeRows(rows, opts = {}) {
 
   return {
     total: input.length,
-    completed: completed.length,
+    completedCount: completed.length,
     incompleteCount: incomplete.length,
     fillStats,
     incomplete,

package/lib/index.js

@@ -60,11 +60,16 @@ export function apply(ctx, config) {
   // 3. web 半区（仅 web 组合存在；headless 组合无 webServer/webRuntime，inject 会失败）
   try {
     ctx.inject(['webServer', 'webRuntime', 'tools', 'skills', 'jobs', 'storageDomain', 'fs'], (wctx) => {
-      const dispose = mountWebRoutes(wctx, { logger: ctx.logger, report, TOOL_NAME: TOOL_CLEAN, SKILL_NAME });
-      if (typeof dispose === 'function' && typeof ctx.effect === 'function') {
-        ctx.effect(() => () => dispose(), 'data-cleaning-agent: web routes');
+      try {
+        const dispose = mountWebRoutes(wctx, { logger: ctx.logger, report, TOOL_NAME: TOOL_CLEAN, SKILL_NAME });
+        if (typeof dispose === 'function' && typeof ctx.effect === 'function') {
+          ctx.effect(() => () => dispose(), 'data-cleaning-agent: web routes');
+        }
+        report.webMounted = true;
+      } catch (error) {
+        report.webSkipped = true;
+        console.warn(`[dc-agent] web half failed during deferred mount: ${error instanceof Error ? error.stack : String(error)}`);
       }
-      report.webMounted = true;
     });
   } catch (error) {
     report.webSkipped = true;

package/lib/jobs.js

@@ -35,7 +35,7 @@ export function runSync(kind, rows, opts = {}) {
     }
     case 'complete': {
       const r = completeRows(rows, opts);
-      return { kind, summary: { total: r.total, completed: r.completed, incompleteCount: r.incompleteCount, name: r.fillStats.name, amount: r.fillStats.amount, phoneNormalized: r.fillStats.phoneNormalized }, rows: r.completed, headers: opts.headers ?? [] };
+      return { kind, summary: { total: r.total, completed: r.completedCount, incompleteCount: r.incompleteCount, name: r.fillStats.name, amount: r.fillStats.amount, phoneNormalized: r.fillStats.phoneNormalized }, rows: r.completed, headers: opts.headers ?? [] };
     }
     case 'profile': {
       const r = profileRows(rows, opts);