dsh-data-cleaning-agent 0.5.1 → 0.5.3

package/lib/client.js

@@ -3,11 +3,15 @@
  *
  * 通过 `window.__ModuleLoader__.load({id, factory})` 注册为惰性 CJS 工厂，
  * 与 dsh-mcp-connector@0.2.32（生产 profile 中已实测的「MCP连接器」）同构：
- *   - `react` / `@deepseek-ai/dsh-client-ui-primitives` 由 web shell 静态模块表提供，
+ *   - `react` / `react-dom` / `@deepseek-ai/dsh-client-ui-primitives` 由 web shell 静态模块表提供，
  *     第三方 bundle 无需打包 React、无需构建步骤。
  *   - `defineStore` 首选 `@deepseek-ai/dsh-client-store`，回退 `@deepseek-ai/dsh-client-runtime/client`。
- *   - 入口注册到 `sidebar.footer.action`（order 10，排在 MCP连接器的 order 0 下方），
- *     工作台注册到 `shell.overlay`（order 200）。
+ *   - `sidebar.footer.action` 仅托管入口生命周期和降级渲染；实际入口 Portal 到
+ *     `sidebar.workspaces` 前，位于「新会话」与「工作区」之间。
+ *   - DSH 原生会话保持在中间，能力入口使用 `conversation.input.dock` 并通过稳定
+ *     `data-slot` 排到输入框下方；右侧非模态工作台使用 `shell.overlay`。
+ *   - 提示词生成器使用 `conversation.input.overlay`，只对本插件创建的会话生效。
+ *     Hero 标题没有公开替换槽位，故以可恢复、精确文本匹配的 DOM Bridge 对齐业务首页。
  *
  * 0.5.0 工作台复用本地 `/mvp/*` 与三域 `/phase3/*` 后端，完整覆盖上传映射、
  * 数据体检、匹配核验、补全导出；计费调用仍由 Host Bridge 的确认/幂等/上限门约束。
@@ -20,7 +24,19 @@ window.__ModuleLoader__.load({
     Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
     const react = require('react');
-    const { Button } = require('@deepseek-ai/dsh-client-ui-primitives');
+    const reactDom = require('react-dom');
+    const primitives = require('@deepseek-ai/dsh-client-ui-primitives');
+    const {
+      Button,
+      IconArchiveOutline20,
+      IconChecklistOutline14,
+      IconCloseOutline16,
+      IconDataOutline16,
+      IconDownloadOutline16,
+      IconFullscreenOutline16,
+      IconPaperclipOutline16,
+      IconSearchOutline16,
+    } = primitives;
 
     let defineStore;
     try {
@@ -41,20 +57,45 @@ window.__ModuleLoader__.load({
     /** 客户端所需服务：与 mcp-connector 对齐（槽位 + 会话/工作区/输入机）。 */
     const inject = ['slots', 'sessions', 'workspaces', 'conversation'];
 
-    const FOOTER_STYLE_ID = 'dsh-data-cleaning-agent-sidebar';
+    const UI_STYLE_ID = 'dsh-data-cleaning-agent-ui';
+    const SIDEBAR_WORKSPACES_SELECTOR = '[data-slot="sidebar.workspaces"]';
+    const TOP_MOUNT_SELECTOR = '[data-data-cleaning-top-mount="true"]';
     const stylesCss = `
-[data-slot="sidebar.footer.action"] {
-  display: flex !important;
-  flex-direction: column;
+.dcAgentTopMount {
+  flex: none;
   min-width: 0;
   width: 100%;
 }
 
+.dcAgentTopEntry {
+  box-sizing: border-box;
+  width: 100%;
+  padding-right: var(--dsh-sidebar-inline-padding, 12px);
+}
+
 .dcAgentLauncher {
   flex: none;
   box-sizing: border-box;
   width: 100%;
+  height: 42px;
+  margin: 0 0 8px;
+  padding: 0 10px 0 8px;
+  justify-content: flex-start;
   min-width: 0;
+  overflow: hidden;
+  border-radius: 12px;
+  white-space: nowrap;
+}
+.dcAgentLauncher[data-wide="false"] {
+  width: 36px;
+  height: 36px;
+  padding: 0;
+  justify-content: center;
+  border-radius: 50%;
+}
+.dcAgentTopEntry[data-wide="false"] {
+  width: 36px;
+  padding-right: 0;
 }
 
 .dcAgentOverlay {
@@ -64,22 +105,293 @@ window.__ModuleLoader__.load({
   display: flex;
   align-items: stretch;
   justify-content: flex-end;
-  background: rgba(8, 10, 14, 0.22);
+  pointer-events: none;
+  background: transparent;
 }
 
 .dcAgentWorkbench {
   display: flex;
   flex-direction: column;
-  width: min(980px, calc(100vw - 72px));
+  width: min(510px, calc(100vw - 72px));
   height: 100vh;
   border: 1px solid light-dark(#d5dae4, #2a3038);
-  border-radius: 14px 0 0 14px;
+  border-radius: 12px 0 0 12px;
   background: light-dark(#ffffff, #161b23);
   color: light-dark(#172033, #edf2fa);
-  box-shadow: light-dark(0 18px 50px rgba(33, 55, 88, .14), 0 20px 60px rgba(0, 0, 0, .42));
+  box-shadow: light-dark(-10px 0 32px rgba(33, 55, 88, .12), -12px 0 40px rgba(0, 0, 0, .32));
   overflow: hidden;
+  pointer-events: auto;
+}
+.dcAgentWorkbench.is-expanded { width: min(980px, calc(100vw - 72px)); }
+
+.dcAgentCapabilities {
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  gap: 8px;
+  width: 100%;
+  max-width: var(--dsh-composer-card-max-width, 780px);
+  box-sizing: border-box;
+  margin: 0 auto;
+  padding: 2px 16px 0;
+  overflow-x: auto;
+  scrollbar-width: none;
+  transform: translateX(var(--dc-agent-workbench-shift, 0px));
+  transition: transform 160ms ease;
+}
+.dcAgentCapabilities::-webkit-scrollbar { display: none; }
+.dcAgentCapability {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  flex: 0 0 auto;
+  min-width: 108px;
+  min-height: 54px;
+  padding: 7px 12px;
+  flex-direction: column;
+  justify-content: center;
+  border: 1px solid light-dark(#e4e8f0, #303947);
+  border-radius: 12px;
+  background: light-dark(rgba(255,255,255,.86), rgba(22,27,35,.86));
+  color: light-dark(#5d687a, #aab5c7);
+  font: inherit;
+  font-size: 12px;
+  cursor: pointer;
+}
+.dcAgentCapability:hover,
+.dcAgentCapability:focus-visible,
+.dcAgentCapability.is-active {
+  border-color: light-dark(#c9d9f8, #365681);
+  background: light-dark(#edf4ff, #172841);
+  color: light-dark(#1556cf, #8cb3ff);
+}
+.dcAgentCapability svg { flex: 0 0 auto; }
+
+/* DSH 官方 input.dock 默认在 composer 上方；只把本插件自己的 cell 排到下方。 */
+[data-slot="conversation.input.dock"]:has(.dcAgentExperience) {
+  order: 20;
+}
+
+.dcAgentExperience {
+  width: 100%;
+  box-sizing: border-box;
+}
+
+.dcAgentProductHome {
+  width: 100%;
+  max-width: var(--dsh-composer-card-max-width, 780px);
+  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(4, 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) {
+  padding-top: 48px;
+}
+.dcAgentPromptLayer {
+  position: absolute;
+  inset: 0;
+  z-index: 40;
+  pointer-events: none;
+}
+.dcAgentPromptTrigger {
+  position: absolute;
+  top: 10px;
+  left: 16px;
+  min-height: 28px;
+  padding: 3px 10px;
+  border: 1px solid light-dark(#c9d9f8, #365681);
+  border-radius: 999px;
+  background: light-dark(#edf4ff, #172841);
+  color: light-dark(#1556cf, #8cb3ff);
+  font: inherit;
+  font-size: 12px;
+  cursor: pointer;
+  pointer-events: auto;
+}
+.dcAgentPromptPanel {
+  position: absolute;
+  top: 44px;
+  left: 16px;
+  width: min(660px, calc(100vw - 120px));
+  max-height: min(68vh, 660px);
+  box-sizing: border-box;
+  overflow: auto;
+  padding: 16px;
+  border: 1px solid light-dark(#d5dae4, #303947);
+  border-radius: 16px;
+  background: light-dark(#ffffff, #161b23);
+  color: light-dark(#172033, #edf2fa);
+  box-shadow: light-dark(0 18px 48px rgba(33,55,88,.20), 0 20px 54px rgba(0,0,0,.40));
+  pointer-events: auto;
+}
+.dcAgentPromptHead {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 12px;
+  margin-bottom: 12px;
+}
+.dcAgentPromptHead h3 { margin: 0; font-size: 16px; line-height: 22px; }
+.dcAgentPromptHead p { margin: 3px 0 0; color: light-dark(#697386, #aab5c7); font-size: 11px; line-height: 17px; }
+.dcAgentPromptClose {
+  width: 28px;
+  height: 28px;
+  flex: none;
+  border: 0;
+  border-radius: 50%;
+  background: transparent;
+  color: inherit;
+  cursor: pointer;
+}
+.dcAgentPromptClose:hover { background: light-dark(#f1f4f8, #222a36); }
+.dcAgentPromptTabs { display: flex; flex-wrap: wrap; gap: 6px; margin-bottom: 10px; }
+.dcAgentPromptTab,
+.dcAgentPromptChoice {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  min-height: 32px;
+  padding: 5px 10px;
+  border: 1px solid light-dark(#d9dee8, #394352);
+  border-radius: 9px;
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  font-size: 12px;
+  cursor: pointer;
+}
+.dcAgentPromptTab.is-active,
+.dcAgentPromptChoice.is-selected {
+  border-color: light-dark(#2869e6, #6d9eff);
+  background: light-dark(#edf4ff, #172841);
+  color: light-dark(#1556cf, #8cb3ff);
+}
+.dcAgentPromptField { display: grid; gap: 6px; margin: 10px 0; }
+.dcAgentPromptField > span { font-size: 12px; font-weight: 600; }
+.dcAgentPromptText {
+  box-sizing: border-box;
+  width: 100%;
+  min-height: 104px;
+  resize: vertical;
+  padding: 10px 12px;
+  border: 1px solid light-dark(#d9dee8, #394352);
+  border-radius: 10px;
+  background: light-dark(#fbfcfe, #11171f);
+  color: inherit;
+  font: inherit;
+  font-size: 12px;
+  line-height: 20px;
+}
+.dcAgentPromptFile {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 12px;
+  border: 1px dashed light-dark(#b9c5d8, #43516a);
+  border-radius: 10px;
+  color: light-dark(#59677c, #b1bdd0);
+  font-size: 12px;
+}
+.dcAgentPromptFile input { max-width: 100%; }
+.dcAgentPromptGroup { margin-top: 12px; }
+.dcAgentPromptGroup > b { display: block; margin-bottom: 7px; font-size: 12px; }
+.dcAgentPromptChoices { display: flex; flex-wrap: wrap; gap: 6px; }
+.dcAgentPromptChoice input { margin: 0; }
+.dcAgentPromptNote {
+  margin: 10px 0 0;
+  padding: 8px 10px;
+  border-radius: 8px;
+  background: light-dark(#f6f8fb, #1c2330);
+  color: light-dark(#697386, #aab5c7);
+  font-size: 11px;
+  line-height: 17px;
+}
+.dcAgentPromptError { margin: 8px 0 0; color: light-dark(#b42318, #ff8d86); font-size: 11px; }
+.dcAgentPromptActions { display: flex; justify-content: flex-end; gap: 8px; margin-top: 14px; }
+.dcAgentPromptAction {
+  min-height: 34px;
+  padding: 6px 13px;
+  border: 1px solid light-dark(#d9dee8, #394352);
+  border-radius: 9px;
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  font-size: 12px;
+  cursor: pointer;
+}
+.dcAgentPromptAction.is-primary { border-color: #2869e6; background: #2869e6; color: white; }
+.dcAgentPromptAction:disabled { opacity: .5; cursor: default; }
+
+.dcAgentHeaderAction {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  min-height: 30px;
+  padding: 4px 9px;
+  border: 1px solid light-dark(#d9dee8, #394352);
+  border-radius: 8px;
+  background: light-dark(#ffffff, #191f28);
+  color: inherit;
+  font: inherit;
+  font-size: 12px;
+  cursor: pointer;
+}
+.dcAgentHeaderAction:hover,
+.dcAgentHeaderAction:focus-visible {
+  border-color: light-dark(#2869e6, #6d9eff);
+  color: light-dark(#1556cf, #8cb3ff);
 }
-.dcAgentWorkbench.is-expanded { width: calc(100vw - 72px); }
 
 .dcAgentWbHeader {
   display: flex;
@@ -365,17 +677,22 @@ window.__ModuleLoader__.load({
 }
 @media (max-width: 760px) {
   .dcAgentWorkbench, .dcAgentWorkbench.is-expanded { width: 100vw; border-radius: 0; }
+  .dcAgentOverlay { background: rgba(8, 10, 14, 0.22); pointer-events: auto; }
   .dcAgentStepper { grid-template-columns: repeat(2, minmax(0, 1fr)); }
   .dcAgentQccBadge { display: none; }
   .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)); }
 }
 `;
 
-    /** 让 footer 多个入口纵向堆叠（与 mcp-connector 注入的列式 CSS 幂等并存）。 */
-    function installSidebarStyles() {
-      if (document.querySelector(`style[data-plugin="${FOOTER_STYLE_ID}"]`) !== null) return () => {};
+    /** 安装入口、会话能力按钮与右侧工作台样式。 */
+    function installUiStyles() {
+      if (document.querySelector(`style[data-plugin="${UI_STYLE_ID}"]`) !== null) return () => {};
       const style = document.createElement('style');
-      style.dataset.plugin = FOOTER_STYLE_ID;
+      style.dataset.plugin = UI_STYLE_ID;
       style.textContent = stylesCss;
       document.head.append(style);
       return () => { style.remove(); };
@@ -392,6 +709,120 @@ window.__ModuleLoader__.load({
       { key: 'enrich', label: '补全与导出', icon: '⬇️' },
     ];
 
+    const CAPABILITIES = [
+      { key: 'upload', label: '上传清洗', icon: IconPaperclipOutline16, fallback: '＋' },
+      { key: 'profile', label: '质量体检', icon: IconChecklistOutline14, fallback: '✓' },
+      { key: 'review', label: '匹配核验', icon: IconSearchOutline16, fallback: '⌕' },
+      { key: 'enrich', label: '字段补全', icon: IconDataOutline16, fallback: '▦' },
+      { key: 'history', label: '任务历史', icon: IconArchiveOutline20, fallback: '◷' },
+    ];
+
+    const CLEANING_OPTIONS = [
+      ['normalize_name', '规范企业名称'],
+      ['complete_name', '补全 / 修正旧名称'],
+      ['verify_credit', '校验 / 补全信用代码'],
+      ['deduplicate', '重复企业去重'],
+      ['manual_review', '模糊候选人工确认'],
+    ];
+    const ENRICHMENT_OPTIONS = [
+      ['credit_no', '统一社会信用代码'],
+      ['legal_rep', '法定代表人'],
+      ['reg_capital', '注册资本'],
+      ['establish_date', '成立日期'],
+      ['reg_status', '登记 / 经营状态'],
+      ['panorama', '企业全景与联系方式'],
+      ['ownership', '股权与对外投资'],
+      ['governance', '主要人员与变更年报'],
+      ['risk', '风险信息'],
+      ['ipr', '知识产权'],
+      ['operation', '经营信息'],
+    ];
+    const DEFAULT_CLEANING_KEYS = ['normalize_name', 'complete_name', 'verify_credit', 'deduplicate', 'manual_review'];
+    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();
+
+    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);
+      }
+    } catch (_error) {
+      // sessionStorage 可能被禁用；当前页面内的 Set 仍可工作。
+    }
+
+    function isCleaningSession(sessionId) {
+      return typeof sessionId === 'string' && cleaningSessionIds.has(sessionId);
+    }
+
+    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) {
+        // 不因浏览器存储策略阻断会话。
+      }
+      if (typeof window.CustomEvent === 'function' && typeof window.dispatchEvent === 'function') {
+        window.dispatchEvent(new window.CustomEvent(CLEANING_SESSION_EVENT, { detail: { sessionId } }));
+      }
+    }
+
+    function useCleaningSession(sessionId) {
+      const [markedSessionId, setMarkedSessionId] = react.useState(
+        isCleaningSession(sessionId) ? sessionId : null,
+      );
+      react.useEffect(() => {
+        const handleMarked = (event) => {
+          if (event?.detail?.sessionId === sessionId) setMarkedSessionId(sessionId);
+        };
+        window.addEventListener?.(CLEANING_SESSION_EVENT, handleMarked);
+        return () => window.removeEventListener?.(CLEANING_SESSION_EVENT, handleMarked);
+      }, [sessionId]);
+      // DSH 可能复用同一个 slot component 切换会话；状态必须绑定具体 sessionId，
+      // 避免从清洗会话切回普通会话后仍残留业务首页与提示词入口。
+      return markedSessionId === sessionId || isCleaningSession(sessionId);
+    }
+
+    function optionLabels(options, keys) {
+      const selected = new Set(Array.isArray(keys) ? keys : []);
+      return options.filter(([key]) => selected.has(key)).map(([, label]) => label);
+    }
+
+    /** 纯函数：把向导选择转换成可编辑、可审计的自然语言任务描述。 */
+    function buildTaskPrompt(config = {}) {
+      const mode = config.mode ?? 'text';
+      const cleanLabels = optionLabels(CLEANING_OPTIONS, config.cleaningKeys);
+      const enrichLabels = optionLabels(ENRICHMENT_OPTIONS, config.enrichmentKeys);
+      const entries = Array.isArray(config.entries)
+        ? config.entries.map((value) => String(value ?? '').trim()).filter(Boolean)
+        : [];
+      const entryCount = Number.isFinite(config.entryCount) ? config.entryCount : entries.length;
+      const source = mode === 'image'
+        ? `已附加图片${config.fileName ? `「${config.fileName}」` : ''}`
+        : mode === 'excel'
+          ? `本地表格${config.fileName ? `「${config.fileName}」` : ''}，已解析 ${entryCount} 条主体标识，完整数据已载入数据清洗补全工作台`
+          : `手工录入，共 ${entryCount} 条主体标识`;
+      const lines = [
+        '请执行一项企业名单数据清洗补全任务。',
+        `输入来源：${source}。`,
+      ];
+      if (mode === 'image') {
+        lines.push('请先使用当前已连接且可用的企查查智能文档解析 MCP 能力，从图片中提取企业全称或统一社会信用代码；若该能力未连接或不可用，请先提示我改用文本或 Excel。');
+      }
+      if (entries.length) {
+        lines.push(`${mode === 'excel' ? '主体预览' : '待处理主体'}：\n${entries.map((entry, index) => `${index + 1}. ${entry}`).join('\n')}`);
+      }
+      lines.push(`清洗要求：${cleanLabels.length ? cleanLabels.join('、') : '仅解析，不自动修改'}。`);
+      lines.push(`需要补全的字段 / 维度：${enrichLabels.length ? enrichLabels.join('、') : '不调用外部补全，仅输出本地清洗结果'}。`);
+      lines.push('处理规则：企业全称、统一社会信用代码或注册号优先精确匹配；精确匹配失败时再进入模糊候选，存在多个候选必须暂停并让我确认，不得默认选择第一项。');
+      lines.push('请先生成数据质量体检与匹配摘要，经我确认后再执行需要消耗额度的企查查 MCP 调用；企查查连接、套餐额度和费用均由当前用户自己的账号承担。缺失或无权限字段请留空并标记原因，不得编造。');
+      lines.push('完成后保留来源原值、标准主体、匹配状态与字段来源，并提供结果和待复核清单的导出。');
+      return lines.join('\n\n');
+    }
+
     /** 后端往返：POST JSON，返回解析后的对象。 */
     async function api(path, body) {
       const res = await fetch(path, {
@@ -422,13 +853,20 @@ window.__ModuleLoader__.load({
           qccEstimate: null,
           qccRun: null,
           paidConfirmed: false,
+          activeSessionId: null,
           jobs: [],        // 后台任务列表（/mvp/jobs 轮询），仅用于状态 pill，不接计费遥测
         }),
         actions: {
           open: (draft) => { draft.open = true; },
+          openAt: (draft, step, sessionId) => {
+            draft.open = true;
+            if (step) draft.step = step;
+            if (sessionId) draft.activeSessionId = sessionId;
+          },
           close: (draft) => { draft.open = false; },
           toggleExpanded: (draft) => { draft.expanded = !draft.expanded; },
           setStep: (draft, step) => { draft.step = step; },
+          setActiveSession: (draft, sessionId) => { draft.activeSessionId = sessionId ?? null; },
           setBusy: (draft, busy) => { draft.busy = busy; },
           setError: (draft, error) => { draft.error = error; },
           setInput: (draft, input) => { draft.input = input; },
@@ -453,27 +891,485 @@ window.__ModuleLoader__.load({
       });
     }
 
-    /** 左栏入口按钮：使用 DSH Button，与 MCP连接器一致。 */
+    /**
+     * DSH 当前没有公开的「新会话与工作区之间」list slot。和 MCP连接器一样，
+     * footer slot 只托管生命周期；真实入口只依赖稳定 data-slot Portal 到工作区前。
+     */
+    function ensureTopLauncherMount() {
+      const workspaceSlot = document.querySelector(SIDEBAR_WORKSPACES_SELECTOR);
+      const parent = workspaceSlot && workspaceSlot.parentElement;
+      if (!workspaceSlot || !parent) return null;
+      let mount = parent.querySelector(TOP_MOUNT_SELECTOR);
+      if (!mount) {
+        mount = document.createElement('div');
+        mount.dataset.dataCleaningTopMount = 'true';
+        mount.className = 'dcAgentTopMount';
+      }
+      // 不与 MCP连接器各自的 MutationObserver 争抢「紧邻工作区」位置：首次挂载后
+      // 保持稳定顺序。MCP连接器会占据紧邻工作区的位置，本入口自然位于它上方。
+      if (mount.parentElement !== parent) parent.insertBefore(mount, workspaceSlot);
+      return mount;
+    }
+
+    /** 使用 DSH 原生工作区、会话和输入机打开中央对话，不构造第二套聊天界面。 */
+    async function startCleaningSession(ctx) {
+      const workspace = ctx.workspaces.list.getSnapshot();
+      const current = ctx.sessions.list.getSnapshot().current;
+      const items = Array.isArray(workspace.items) ? workspace.items : [];
+      const currentWorkspaceId = current === undefined
+        ? undefined
+        : items.find((item) => Array.isArray(item.sessionIds) && item.sessionIds.includes(current))?.workspaceId;
+      const targetWorkspaceId = currentWorkspaceId ?? workspace.recentWorkspaceId ?? items[0]?.workspaceId;
+      if (targetWorkspaceId === undefined) {
+        throw new Error('请先选择一个工作空间，再打开数据清洗补全智能体');
+      }
+      // rc.2 暴露 workspaces.connectWorkspace；alpha.2 把同一导航策略迁移到
+      // uiWorkspace.connectWorkspace，纯 workspaces controller 不再带该方法。
+      // 只在检测到真实方法后调用，避免把 alpha 实验面当成稳定契约。
+      const uiWorkspace = typeof ctx.get === 'function' ? ctx.get('uiWorkspace') : ctx.uiWorkspace;
+      const connectWorkspace = typeof ctx.workspaces.connectWorkspace === 'function'
+        ? ctx.workspaces.connectWorkspace.bind(ctx.workspaces)
+        : typeof uiWorkspace?.connectWorkspace === 'function'
+          ? uiWorkspace.connectWorkspace.bind(uiWorkspace)
+          : null;
+      const sessionId = connectWorkspace
+        ? await connectWorkspace(targetWorkspaceId)
+        : typeof ctx.sessions.create === 'function'
+          ? await ctx.sessions.create({ workspaceId: targetWorkspaceId })
+          : null;
+      if (!sessionId) throw new Error('当前 DSH 版本没有可用的工作区会话创建能力');
+      const conversation = typeof ctx.get === 'function' ? ctx.get('conversation') : ctx.conversation;
+      if (!conversation) throw new Error('DSH 对话服务尚未就绪，请稍后重试');
+      markCleaningSession(sessionId);
+      conversation.input.shell(sessionId).setDraft(DEFAULT_SESSION_PROMPT);
+      ctx.sessions.open(sessionId);
+      return sessionId;
+    }
+
+    /**
+     * 图片接入兼容 Bridge。仅在运行时同时探测到 createDraftImages / input.shell.addImages
+     * 时使用；失败会释放浏览器临时对象，不假设 alpha 实验 API 稳定。
+     */
+    function attachPromptImages(ctx, sessionId, files) {
+      const conversation = typeof ctx.get === 'function' ? ctx.get('conversation') : ctx.conversation;
+      if (!conversation || typeof conversation.createDraftImages !== 'function') {
+        throw new Error('当前 DSH 版本不支持从插件附加图片，请使用输入框原生“＋”按钮上传。');
+      }
+      const shell = conversation.input?.shell?.(sessionId);
+      if (!shell || typeof shell.addImages !== 'function') {
+        throw new Error('当前会话的图片输入能力尚未就绪，请稍后重试。');
+      }
+      const images = conversation.createDraftImages(files);
+      if (!shell.addImages(images.map((image) => image.id))) {
+        conversation.releaseDraftImages?.(images);
+        throw new Error('图片未能加入当前对话，请检查格式或数量限制。');
+      }
+      return images.length;
+    }
+
+    function capabilityIcon(item, size = 16) {
+      return typeof item.icon === 'function'
+        ? h(item.icon, { size, 'aria-hidden': 'true' })
+        : h('span', { 'aria-hidden': 'true' }, item.fallback);
+    }
+
+    function openWorkbench(actions, step, sessionId) {
+      actions.openAt(step, sessionId);
+      startJobsPolling(actions);
+    }
+
+    const WORKBENCH_OPEN_EVENT = 'dsh:data-cleaning-workbench-open';
+    const WORKBENCH_DATASET_EVENT = 'dsh:data-cleaning-workbench-dataset';
+
+    // session scope 不能复用 root scope 的 store handle。DSH 当前会分别物化 root/session
+    // 插槽组件，因此以 document 事件跨 scope 通知；闭包引用仅作为无 DOM 测试降级。
+    let rootWorkbenchActions = null;
+
+    /** 从 session scope 的 composer/header 触发 root scope 工作台。 */
+    function requestWorkbenchOpen(step, sessionId) {
+      if (typeof document !== 'undefined'
+        && typeof document.createEvent === 'function'
+        && typeof document.dispatchEvent === 'function') {
+        const event = document.createEvent('CustomEvent');
+        event.initCustomEvent(WORKBENCH_OPEN_EVENT, false, true, { step, sessionId });
+        if (!document.dispatchEvent(event)) return;
+      }
+      if (rootWorkbenchActions) openWorkbench(rootWorkbenchActions, step, sessionId);
+    }
+
+    /** 把提示词生成器解析出的完整表格交给 root 工作台，不把整表塞进模型上下文。 */
+    function requestWorkbenchDataset(result, sessionId) {
+      if (typeof document !== 'undefined'
+        && typeof document.createEvent === 'function'
+        && typeof document.dispatchEvent === 'function') {
+        const event = document.createEvent('CustomEvent');
+        event.initCustomEvent(WORKBENCH_DATASET_EVENT, false, true, { result, sessionId });
+        if (!document.dispatchEvent(event)) return;
+      }
+      if (rootWorkbenchActions) {
+        applyParsed(result, rootWorkbenchActions);
+        rootWorkbenchActions.setActiveSession(sessionId);
+      }
+    }
+
+    /** 左栏入口按钮：公开 footer 托管，真实按钮 Portal 到「新会话 / 工作区」之间。 */
     function SidebarEntry(props) {
-      const { wide, useStore, actions } = props;
-      const open = useStore((state) => state.open);
-      return react.createElement(Button, {
+      const { wide, useStore, actions, startSession } = props;
+      useStore((state) => state.open);
+      const [topMount, setTopMount] = react.useState(null);
+
+      react.useEffect(() => {
+        let disposed = false;
+        const ownedMounts = new Set();
+        const syncMount = () => {
+          if (disposed) return;
+          const mount = ensureTopLauncherMount();
+          if (mount) ownedMounts.add(mount);
+          setTopMount((current) => current === mount ? current : mount);
+        };
+        syncMount();
+        let observer = null;
+        if (typeof window.MutationObserver === 'function' && document.body) {
+          observer = new window.MutationObserver(syncMount);
+          observer.observe(document.body, { childList: true, subtree: true });
+        }
+        return () => {
+          disposed = true;
+          if (observer) observer.disconnect();
+          for (const mount of ownedMounts) mount.remove();
+        };
+      }, []);
+
+      const launcher = react.createElement(Button, {
         variant: 'ghost',
         className: 'dcAgentLauncher',
         'data-wide': wide,
-        'aria-label': '数据清洗',
-        'aria-haspopup': 'dialog',
-        'aria-expanded': open,
-        onClick: () => {
+        'aria-label': '数据清洗补全',
+        onClick: async () => {
           try {
-            actions.open();
-            startJobsPolling(actions);
+            if (typeof startSession === 'function') {
+              const sessionId = await startSession();
+              actions.setActiveSession(sessionId);
+            }
           } catch (error) {
+            actions.setError(error instanceof Error ? error.message : String(error));
             console.error('[dc-agent] open failed:', error);
           }
         },
-        children: wide ? '🧹 数据清洗' : '🧹',
+        children: wide ? '🧹 数据清洗补全' : '🧹',
       });
+      if (!topMount || typeof reactDom.createPortal !== 'function') return launcher;
+      return reactDom.createPortal(h('div', {
+        className: 'dcAgentTopEntry',
+        'data-wide': wide,
+      }, launcher), topMount);
+    }
+
+    /** Mockup 五能力入口：由 input.dock 承载，并在 CSS 中排到原生 composer 下方。 */
+    function CapabilityBar(props) {
+      const { sessionId } = props;
+      return h('div', { className: 'dcAgentCapabilities', 'aria-label': '数据清洗补全智能体能力' },
+        CAPABILITIES.map((item) => h('button', {
+          key: item.key,
+          type: 'button',
+          className: 'dcAgentCapability',
+          'aria-label': item.label,
+          title: item.label,
+          onClick: () => requestWorkbenchOpen(item.key, sessionId),
+        },
+          capabilityIcon(item),
+          h('span', { className: 'dcAgentCapabilityLabel' }, item.label),
+        )),
+      );
+    }
+
+    function ProductHome() {
+      const flow = [
+        ['01', '录入名单', '文本、Excel 或图片'],
+        ['02', '质量体检', '缺失、重复与格式诊断'],
+        ['03', '主体匹配', '精确优先，多候选复核'],
+        ['04', '补全导出', '按需选字段，保留来源'],
+      ];
+      return h('section', { className: 'dcAgentProductHome', 'aria-label': '数据清洗补全产品介绍' },
+        h('h2', null, '把企业名单变成可核验、可回写的标准数据'),
+        h('p', null, '面向销售线索、客户尽调、供应商管理与 CRM / ERP 数据治理，先本地体检清洗，再按需使用当前用户连接的企查查 MCP 补全。'),
+        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, '结果与待复核清单可导出'),
+        ),
+      );
+    }
+
+    /**
+     * DSH 当前只公开 hero brand.mark，没有 headline slot。这里仅在本插件会话且 blank hero
+     * 阶段精确替换原生中英文标题，并在卸载时恢复，避免污染普通会话。
+     */
+    function rewriteHeroChrome(sessionId, enabled) {
+      if (!enabled || typeof document === 'undefined' || typeof document.querySelectorAll !== 'function') return () => {};
+      const marker = [...document.querySelectorAll('.dcAgentExperience')]
+        .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';
+      }
+      return () => {
+        if (title?.dataset?.dcAgentOriginalText !== undefined) {
+          title.textContent = title.dataset.dcAgentOriginalText;
+          delete title.dataset.dcAgentOriginalText;
+          delete title.dataset.dcAgentHeroTitle;
+        }
+        if (badge?.dataset?.dcAgentOriginalDisplay !== undefined) {
+          if (badge.style) badge.style.display = badge.dataset.dcAgentOriginalDisplay;
+          delete badge.dataset.dcAgentOriginalDisplay;
+          delete badge.dataset.dcAgentHeroBadge;
+        }
+      };
+    }
+
+    function DataCleaningExperience(props) {
+      const { sessionId, session: ownerSession } = props;
+      const enabled = useCleaningSession(sessionId);
+      const hero = ownerSession?.composerPhase === 'blank';
+      react.useEffect(
+        () => rewriteHeroChrome(sessionId, enabled && hero),
+        [sessionId, enabled, hero, ownerSession?.openState]
+      );
+      if (!enabled) return null;
+      return h('div', {
+        className: `dcAgentExperience${hero ? ' is-home' : ''}`,
+        'data-session-id': sessionId,
+      },
+        CapabilityBar({ sessionId }),
+        hero ? ProductHome() : null,
+      );
+    }
+
+    function extractPromptEntries(result) {
+      const rows = Array.isArray(result?.rows) ? result.rows : [];
+      const headers = Array.isArray(result?.headers) && result.headers.length
+        ? result.headers
+        : rows.length ? Object.keys(rows[0]) : [];
+      const nameField = headers.find((name) => /^(name|company|company_name|企业名称|公司名称)$/i.test(name))
+        ?? headers.find((name) => /企业|公司|名称|name/i.test(name));
+      const creditField = headers.find((name) => /^(credit_no|creditCode|unified_credit_code|统一社会信用代码|信用代码)$/i.test(name))
+        ?? headers.find((name) => /信用.*代码|credit/i.test(name));
+      return rows.map((row) => {
+        const name = nameField ? String(row?.[nameField] ?? '').trim() : '';
+        const credit = creditField ? String(row?.[creditField] ?? '').trim() : '';
+        return [name, credit].filter(Boolean).join(' | ');
+      }).filter(Boolean).slice(0, 50);
+    }
+
+    function PromptGenerator(props) {
+      const { sessionId, inputActions, attachImages } = props;
+      const enabled = useCleaningSession(sessionId);
+      const [open, setOpen] = react.useState(false);
+      const [mode, setMode] = react.useState('text');
+      const [rawText, setRawText] = react.useState('');
+      const [entries, setEntries] = react.useState([]);
+      const [entryCount, setEntryCount] = react.useState(0);
+      const [spreadsheetFileName, setSpreadsheetFileName] = react.useState('');
+      const [imageFileName, setImageFileName] = react.useState('');
+      const [imageAttached, setImageAttached] = react.useState(false);
+      const [cleaningKeys, setCleaningKeys] = react.useState(DEFAULT_CLEANING_KEYS);
+      const [enrichmentKeys, setEnrichmentKeys] = react.useState(DEFAULT_ENRICHMENT_KEYS);
+      const [busy, setBusy] = react.useState(false);
+      const [error, setError] = react.useState(null);
+
+      if (!enabled) return null;
+
+      const setSourceMode = (nextMode) => {
+        setMode(nextMode);
+        setError(null);
+      };
+      const toggle = (setter, values, key) => setter(values.includes(key)
+        ? values.filter((item) => item !== key)
+        : [...values, key]);
+      const handleFile = async (event) => {
+        const file = event.target?.files?.[0];
+        if (!file || busy) return;
+        setBusy(true);
+        setError(null);
+        try {
+          if (mode === 'image') {
+            if (typeof attachImages !== 'function') throw new Error('当前 DSH 没有可用的图片接入 Bridge。');
+            await attachImages(sessionId, [file]);
+            setImageFileName(file.name);
+            setImageAttached(true);
+          } else {
+            const result = await parseFile(file);
+            if (!result || result.ok === false) throw new Error(result?.message || result?.error || '表格解析失败');
+            const extracted = extractPromptEntries(result);
+            if (!extracted.length) throw new Error('未识别到企业名称或统一社会信用代码列，请检查表头。');
+            setEntries(extracted);
+            setEntryCount(Number.isFinite(result.rowCount) ? result.rowCount : (Array.isArray(result.rows) ? result.rows.length : extracted.length));
+            setSpreadsheetFileName(file.name);
+            requestWorkbenchDataset(result, sessionId);
+          }
+        } catch (fileError) {
+          setError(fileError instanceof Error ? fileError.message : String(fileError));
+        } finally {
+          setBusy(false);
+          if (event.target) event.target.value = '';
+        }
+      };
+      const generatePrompt = () => {
+        const manualEntries = rawText.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+        const selectedEntries = mode === 'text' ? manualEntries : entries;
+        if (mode === 'text' && !selectedEntries.length) {
+          setError('请先录入企业名称或统一社会信用代码，每行一条。');
+          return;
+        }
+        if (mode === 'excel' && !selectedEntries.length) {
+          setError('请先上传并解析 Excel / CSV / JSON 文件。');
+          return;
+        }
+        if (mode === 'image' && !imageAttached) {
+          setError('请先选择并附加一张包含企业名单的图片。');
+          return;
+        }
+        if (!inputActions || typeof inputActions.setDraft !== 'function') {
+          setError('当前会话输入机尚未就绪，请稍后重试。');
+          return;
+        }
+        inputActions.setDraft(buildTaskPrompt({
+          mode,
+          entries: selectedEntries,
+          entryCount: mode === 'excel' ? entryCount : selectedEntries.length,
+          fileName: mode === 'image' ? imageFileName : spreadsheetFileName,
+          cleaningKeys,
+          enrichmentKeys,
+        }));
+        setError(null);
+        setOpen(false);
+      };
+
+      const choice = (options, values, setter) => options.map(([key, label]) => h('label', {
+        key,
+        className: `dcAgentPromptChoice${values.includes(key) ? ' is-selected' : ''}`,
+      },
+        h('input', {
+          type: 'checkbox',
+          checked: values.includes(key),
+          onChange: () => toggle(setter, values, key),
+        }),
+        label,
+      ));
+
+      return h('div', { className: 'dcAgentPromptLayer' },
+        h('button', {
+          type: 'button',
+          className: 'dcAgentPromptTrigger',
+          'aria-label': '打开提示词生成',
+          '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);
+            }
+          },
+        },
+          h('div', { className: 'dcAgentPromptHead' },
+            h('div', null,
+              h('h3', null, '生成数据清洗补全任务'),
+              h('p', null, '录入主体、选择清洗动作与补全维度，生成后仍可在对话框中人工修改。'),
+            ),
+            h('button', { type: 'button', className: 'dcAgentPromptClose', 'aria-label': '关闭提示词生成', onClick: () => setOpen(false) }, '✕'),
+          ),
+          h('div', { className: 'dcAgentPromptTabs', role: 'tablist', 'aria-label': '名单录入方式' },
+            [['text', '粘贴名单'], ['excel', '上传 Excel'], ['image', '上传图片']].map(([key, label]) => h('button', {
+              key,
+              type: 'button',
+              role: 'tab',
+              'aria-selected': mode === key,
+              className: `dcAgentPromptTab${mode === key ? ' is-active' : ''}`,
+              onClick: () => setSourceMode(key),
+            }, label)),
+          ),
+          mode === 'text' ? h('label', { className: 'dcAgentPromptField' },
+            h('span', null, '企业名称或统一社会信用代码（每行一条）'),
+            h('textarea', {
+              className: 'dcAgentPromptText',
+              value: rawText,
+              placeholder: '企查查科技股份有限公司\n9132…\n某某信息技术（上海）有限公司',
+              onChange: (event) => setRawText(event.target.value),
+            }),
+          ) : h('label', { className: 'dcAgentPromptFile' },
+            h('span', null, mode === 'image' ? '选择企业名单图片' : '选择 Excel / CSV / JSON 名单'),
+            h('input', {
+              type: 'file',
+              accept: mode === 'image' ? 'image/png,image/jpeg,image/webp' : '.xlsx,.xls,.csv,.json',
+              disabled: busy,
+              onChange: handleFile,
+            }),
+            (mode === 'excel' ? spreadsheetFileName : imageFileName)
+              ? h('b', null, `${mode === 'excel' ? spreadsheetFileName : imageFileName}${mode === 'excel' ? ` · ${entryCount} 条` : ' · 已附加'}`)
+              : null,
+          ),
+          h('div', { className: 'dcAgentPromptGroup' },
+            h('b', null, '需要执行哪些清洗？'),
+            h('div', { className: 'dcAgentPromptChoices' }, choice(CLEANING_OPTIONS, cleaningKeys, setCleaningKeys)),
+          ),
+          h('div', { className: 'dcAgentPromptGroup' },
+            h('b', null, '需要补全哪些字段 / 维度？'),
+            h('div', { className: 'dcAgentPromptChoices' }, choice(ENRICHMENT_OPTIONS, enrichmentKeys, setEnrichmentKeys)),
+          ),
+          h('p', { className: 'dcAgentPromptNote' }, '图片模式只负责把图片附加到当前对话，并生成“优先调用已连接的企查查智能文档解析 MCP”的任务要求；插件不会虚构或硬编码未验证的工具名。企查查调用使用当前客户自己的连接、账号与额度。'),
+          error ? h('p', { className: 'dcAgentPromptError', role: 'alert' }, error) : null,
+          h('div', { className: 'dcAgentPromptActions' },
+            h('button', { type: 'button', className: 'dcAgentPromptAction', onClick: () => setOpen(false) }, '取消'),
+            h('button', { type: 'button', className: 'dcAgentPromptAction is-primary', disabled: busy, onClick: generatePrompt }, busy ? '处理中…' : '生成并回填'),
+          ),
+        ) : null,
+      );
+    }
+
+    /** 会话头部的可恢复入口：关闭右栏后仍可从当前会话再次打开。 */
+    function WorkbenchHeaderEntry(props) {
+      const { sessionId } = props;
+      const enabled = useCleaningSession(sessionId);
+      if (!enabled) return null;
+      return h('button', {
+        type: 'button',
+        className: 'dcAgentHeaderAction',
+        'aria-label': '打开数据清洗补全工作台',
+        title: '打开数据清洗补全工作台',
+        onClick: () => requestWorkbenchOpen(null, sessionId),
+      },
+        typeof IconDataOutline16 === 'function'
+          ? h(IconDataOutline16, { size: 16, 'aria-hidden': 'true' })
+          : h('span', { 'aria-hidden': 'true' }, '▦'),
+        h('span', null, '清洗补全工作台'),
+      );
     }
 
     /** M3 · 三工具 tool.call.toolview 卡片元数据（wire 名 → 展示文案）。 */
@@ -606,8 +1502,8 @@ window.__ModuleLoader__.load({
       });
     }
 
-    /** 工作台主视图：header + stepper + 当前 pane。 */
-    function WorkbenchOverlay(props) {
+    /** 右侧非模态工作台：中央区域始终保留 DSH 原生会话。 */
+    function WorkbenchDrawer(props) {
       const { useStore, actions } = props;
       const open = useStore((state) => state.open);
       const step = useStore((state) => state.step);
@@ -626,6 +1522,73 @@ window.__ModuleLoader__.load({
       const qccRun = useStore((state) => state.qccRun);
       const paidConfirmed = useStore((state) => state.paidConfirmed);
       const jobs = useStore((state) => state.jobs);
+      const activeSessionId = useStore((state) => state.activeSessionId);
+
+      react.useEffect(() => {
+        rootWorkbenchActions = actions;
+        const handleOpen = (event) => {
+          event?.preventDefault?.();
+          const detail = event?.detail ?? {};
+          openWorkbench(actions, detail.step ?? null, detail.sessionId ?? null);
+        };
+        const handleDataset = (event) => {
+          event?.preventDefault?.();
+          const detail = event?.detail ?? {};
+          if (detail.result) applyParsed(detail.result, actions);
+          if (detail.sessionId) actions.setActiveSession(detail.sessionId);
+        };
+        if (typeof document !== 'undefined' && typeof document.addEventListener === 'function') {
+          document.addEventListener(WORKBENCH_OPEN_EVENT, handleOpen);
+          document.addEventListener(WORKBENCH_DATASET_EVENT, handleDataset);
+        }
+        return () => {
+          if (typeof document !== 'undefined' && typeof document.removeEventListener === 'function') {
+            document.removeEventListener(WORKBENCH_OPEN_EVENT, handleOpen);
+            document.removeEventListener(WORKBENCH_DATASET_EVENT, handleDataset);
+          }
+          stopJobsPolling();
+          if (rootWorkbenchActions === actions) rootWorkbenchActions = null;
+        };
+      }, [actions]);
+
+      // 非模态右栏会覆盖 Host 的中央画布；按实际重叠量把 composer 能力栏左移，
+      // 保证 Mockup 中的五个入口在窄桌面视口仍可见、可点击。展开态专注工作台，
+      // 不强行挤压到不足一栏的剩余区域。
+      react.useEffect(() => {
+        if (typeof document === 'undefined' || typeof document.querySelectorAll !== 'function') return undefined;
+        const reset = () => {
+          for (const bar of document.querySelectorAll('.dcAgentCapabilities')) {
+            bar.style?.removeProperty('--dc-agent-workbench-shift');
+          }
+        };
+        if (!open || expanded) {
+          reset();
+          return reset;
+        }
+        const align = () => {
+          const drawer = document.querySelector('.dcAgentWorkbench');
+          if (!drawer) return;
+          const drawerRect = drawer.getBoundingClientRect();
+          for (const bar of document.querySelectorAll('.dcAgentCapabilities')) {
+            const barRect = bar.getBoundingClientRect();
+            const overlap = Math.max(0, barRect.right - drawerRect.left + 8);
+            const leftRoom = Math.max(0, barRect.left - 88);
+            const shift = Math.min(overlap, leftRoom);
+            bar.style?.setProperty('--dc-agent-workbench-shift', `${-shift}px`);
+          }
+        };
+        const view = document.defaultView;
+        const frameId = typeof view?.requestAnimationFrame === 'function'
+          ? view.requestAnimationFrame(align)
+          : null;
+        view?.addEventListener?.('resize', align);
+        align();
+        return () => {
+          if (frameId !== null) view?.cancelAnimationFrame?.(frameId);
+          view?.removeEventListener?.('resize', align);
+          reset();
+        };
+      }, [open, expanded]);
 
       // DSH 的 useStore 基于 React hooks；所有订阅必须在每次渲染时以相同顺序调用。
       // 把关闭态 guard 放在全部 useStore 之后，避免首次关闭、随后打开时触发
@@ -885,7 +1848,37 @@ window.__ModuleLoader__.load({
       );
 
       let pane;
-      if (step === 'profile') {
+      if (step === 'history') {
+        pane = h('div', { className: 'dcAgentPane' },
+          h('p', { className: 'dcAgentHint' }, '查看当前 Host 的数据清洗后台任务。任务数据仅在本机保存，不进入模型上下文。'),
+          h('div', { className: 'dcAgentRow' },
+            h('button', {
+              type: 'button',
+              className: 'dcAgentButton',
+              disabled: busy,
+              'aria-label': '刷新任务历史',
+              onClick: () => pollJobsOnce(actions),
+            }, '刷新任务'),
+            h('button', {
+              type: 'button',
+              className: 'dcAgentButton is-primary',
+              onClick: () => actions.setStep('upload'),
+            }, '新建清洗任务'),
+          ),
+          jobs.length ? h('div', { className: 'dcAgentPane', 'aria-label': '任务历史列表' },
+            jobs.map((job) => h('section', { key: job.id, className: 'dcAgentSection' },
+              h('h3', null, job.name || job.id || '数据清洗任务'),
+              h('div', { className: 'dcAgentRow' },
+                h('span', { className: 'dcAgentJobsPill', 'data-state': job.state ?? 'idle' }, JOB_STATE_LABEL[job.state] ?? job.state ?? '未知'),
+                h('span', { className: 'dcAgentHint' }, job.createdAt ? new Date(job.createdAt).toLocaleString() : ''),
+              ),
+            )),
+          ) : h('section', { className: 'dcAgentSection' },
+            h('h3', null, '暂无后台任务'),
+            h('p', { className: 'dcAgentHint' }, '上传企业名单并开始处理后，任务状态会显示在这里。'),
+          ),
+        );
+      } else if (step === 'profile') {
         pane = h('div', { className: 'dcAgentPane' },
           h('p', { className: 'dcAgentHint' }, '基于已解析数据生成本地质量画像（缺失率、去重值、金额分布）。本步骤不发起企查查调用。'),
           profile ? h('div', null,
@@ -1048,20 +2041,34 @@ window.__ModuleLoader__.load({
 
       return h('div', {
         className: 'dcAgentOverlay',
-        role: 'dialog',
-        'aria-modal': 'true',
-        'aria-label': '数据清洗',
+        'data-dsh-plugin': 'data-cleaning-agent',
         onClick: (event) => {
-          if (event.target === event.currentTarget) actions.close();
+          if (event.target === event.currentTarget) {
+            stopJobsPolling();
+            actions.close();
+          }
         },
       },
-        h('div', { className: `dcAgentWorkbench${expanded ? ' is-expanded' : ''}` },
+        h('aside', {
+          className: `dcAgentWorkbench${expanded ? ' is-expanded' : ''}`,
+          role: 'dialog',
+          'aria-modal': 'false',
+          'aria-label': '数据清洗补全工作台',
+          'data-session-id': activeSessionId ?? undefined,
+          onKeyDown: (event) => {
+            if (event.key === 'Escape') {
+              event.preventDefault();
+              stopJobsPolling();
+              actions.close();
+            }
+          },
+        },
           h('header', { className: 'dcAgentWbHeader' },
             h('div', { className: 'dcAgentWbTitle' },
               h('span', { className: 'dcAgentWbIcon', 'aria-hidden': 'true' }, '🧹'),
               h('div', null,
                 h('b', null, '数据清洗补全'),
-                h('small', null, '本地确定性清洗 · 企查查三域 Host Bridge'),
+                h('small', null, '本地确定性清洗 · 可选企查查 MCP 补全'),
               ),
             ),
             h('span', {
@@ -1106,28 +2113,61 @@ window.__ModuleLoader__.load({
     function apply(ctx) {
       // eslint-disable-next-line no-console
       console.log('[dc-agent] client apply() ran');
-      const state = { applied: true, entry: 'sidebar.footer.action', overlay: 'shell.overlay', error: null };
+      const state = {
+        applied: true,
+        entry: 'sidebar.workspaces:before(portal)',
+        lifecycleSlot: 'sidebar.footer.action',
+        capabilitySlot: 'conversation.input.dock',
+        promptSlot: 'conversation.input.overlay',
+        heroTitleBridge: 'exact-text/reversible',
+        headerSlot: 'conversation.session.header.actions',
+        overlay: 'shell.overlay',
+        error: null,
+      };
       window.__DC_MVP__ = state;
       try {
         const workbenchStore = createWorkbenchStore();
-        ctx.effect(() => installSidebarStyles(), 'data-cleaning-agent: sidebar styles');
+        ctx.effect(() => installUiStyles(), 'data-cleaning-agent: UI styles');
 
-        // 工作台：注册到 shell.overlay（与 mcp-connector 同源）。
+        // 右侧工作台：additive overlay，不替换 DSH 单占位 details 面板。
         ctx.slots.inject('shell.overlay', () => ctx.slots.register({
           name: 'shell.overlay',
           id: 'data-cleaning-agent',
           order: 200,
           store: workbenchStore,
-        }, WorkbenchOverlay));
+        }, WorkbenchDrawer));
 
-        // 左栏：注册到 sidebar.footer.action，order 10 → 排在 MCP连接器（order 0）下方。
+        // 左栏：footer 只托管生命周期和 Portal 降级；实际入口显示在工作区列表前。
         ctx.slots.inject('sidebar.footer.action', () => ctx.slots.register({
           name: 'sidebar.footer.action',
           id: 'data-cleaning-agent',
           order: 10,
           store: workbenchStore,
+          inject: () => ({ startSession: () => startCleaningSession(ctx) }),
         }, SidebarEntry));
 
+        // 独立 dock 行：对齐 Mockup 的五个能力 ICON，CSS 只把本 cell 排到输入框下方。
+        ctx.slots.inject('conversation.input.dock', () => ctx.slots.register({
+          name: 'conversation.input.dock',
+          id: 'data-cleaning-agent-capabilities',
+          order: 110,
+        }, DataCleaningExperience));
+
+        // 输入框左上角提示词生成器：文本 / Excel / 图片 → 可编辑任务描述。
+        ctx.slots.inject('conversation.input.overlay', () => ctx.slots.register({
+          name: 'conversation.input.overlay',
+          id: 'data-cleaning-agent-prompt-generator',
+          order: 110,
+          inject: () => ({ attachImages: (sessionId, files) => attachPromptImages(ctx, sessionId, files) }),
+        }, PromptGenerator));
+
+        // 会话头部恢复入口：用户关闭右栏后可随时重新打开当前任务工作台。
+        ctx.slots.inject('conversation.session.header.actions', () => ctx.slots.register({
+          name: 'conversation.session.header.actions',
+          id: 'data-cleaning-agent-workbench',
+          order: 110,
+        }, WorkbenchHeaderEntry));
+
         // M3：三个工具的 tool.call.toolview 富化卡片（keyed by wire name，替代裸 JSON 摘要）。
         // 说明：分三条独立 inject（而非 generator）——测试 shim 对 inject 回调仅执行一次并 push 其返回值。
         const toolviewKeys = ['data_clean_rows', 'data_complete_rows', 'data_profile'];
@@ -1149,6 +2189,8 @@ window.__ModuleLoader__.load({
 
     exports.apply = apply;
     exports.inject = inject;
+    // 测试用纯函数，不构成 Host / DSH 稳定 API。
+    exports.__testing = { buildTaskPrompt, extractPromptEntries, markCleaningSession };
     return module.exports;
   },
 });