dsh-data-cleaning-agent 0.8.6 → 0.8.8

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 对齐业务首页。
  *
@@ -32,7 +32,6 @@ window.__ModuleLoader__.load({
       IconArchiveOutline20,
       IconChecklistOutline14,
       IconCloseOutline16,
-      IconDataOutline16,
       IconDownloadOutline16,
       IconFullscreenOutline16,
       IconPaperclipOutline16,
@@ -55,6 +54,23 @@ window.__ModuleLoader__.load({
 
     const h = react.createElement;
 
+    // 同一数据库图形用于入口、业务首页和工作台；不注册 root/single 品牌槽位。
+    const DATABASE_PATH = 'M4 6c0-4 16-4 16 0s-16 4-16 0v12c0 4 16 4 16 0V6M4 12c0 4 16 4 16 0';
+    function DatabaseLogo({ size = 20 } = {}) {
+      return h('svg', { width: size, height: size, viewBox: '0 0 24 24', fill: 'none',
+        stroke: 'currentColor', strokeWidth: 1.7, strokeLinecap: 'round', strokeLinejoin: 'round',
+        'aria-hidden': true, focusable: false, className: 'dcAgentDatabaseLogo' },
+      h('path', { d: DATABASE_PATH }));
+    }
+
+    // 搜索仅改变可见字段，绝不清除已选字段或改变 Host 的字段目录。
+    function visibleCatalogFields(group, query) {
+      const needle = String(query || '').trim().toLowerCase();
+      const [, label, fields, tool] = group;
+      if (!needle || `${label} ${tool || ''}`.toLowerCase().includes(needle)) return fields;
+      return fields.filter(([id, fieldLabel]) => `${id} ${fieldLabel}`.toLowerCase().includes(needle));
+    }
+
     /** 客户端所需服务：与 mcp-connector 对齐（槽位 + 会话/工作区/输入机）。 */
     const inject = ['slots', 'sessions', 'workspaces', 'conversation'];
 
@@ -62,6 +78,31 @@ window.__ModuleLoader__.load({
     const SIDEBAR_WORKSPACES_SELECTOR = '[data-slot="sidebar.workspaces"]';
     const TOP_MOUNT_SELECTOR = '[data-data-cleaning-top-mount="true"]';
     const stylesCss = `
+/* QCC-blue candidate tokens from shared DSH-UX-001; never theme the global shell. */
+:where(.dcAgentTopMount, .dcAgentLauncher, .dcAgentExperience, .dcAgentCapabilityMount,
+ .dcAgentOverlay, .dcAgentPromptLayer, .dcAgentPromptBackdrop, .dcAgentHeaderAction,
+ .dcAgentToolCard, [data-dc-agent-hero-row="true"]) {
+  --dc-action: light-dark(#0875d1, #82c3ff);
+  --dc-hover: light-dark(#0666b7, #acd7ff);
+  --dc-on-action: light-dark(#fff, #101820);
+  --dc-selected: light-dark(#e6f4ff, #173449);
+  --dc-surface: light-dark(#fff, #18232e);
+  --dc-page: light-dark(#f6f8fa, #101820);
+  --dc-table-head: light-dark(#f2f9fc, #172c3b);
+  --dc-text: light-dark(#202c3b, #e7eef6);
+  --dc-muted: light-dark(#626f80, #a2b1c2);
+  --dc-border: light-dark(#dce4ec, #344657);
+  --dc-success: light-dark(#12805c, #78d8b3);
+  --dc-success-bg: light-dark(#edf8f2, #193a30);
+  --dc-review: light-dark(#946000, #f3c66c);
+  accent-color: var(--dc-action);
+}
+.dcAgentLauncherContent { display: inline-flex; align-items: center; gap: 8px; }
+.dcAgentDatabaseLogo { display: block; flex: none; color: var(--dc-action); }
+[data-dc-agent-hero-row="true"] { display: flex; align-items: center; justify-content: center; gap: 12px; }
+[data-dc-agent-hero-title="true"] { min-width: 0; font-size: 28px; line-height: 1.3; color: var(--dc-text); }
+.dcAgentHeroLogo { width: 48px; height: 48px; border-radius: 12px; background: var(--dc-selected); color: var(--dc-action); display: grid; place-items: center; flex: none; }
+
 .dcAgentTopMount {
   flex: none;
   min-width: 0;
@@ -111,16 +152,17 @@ window.__ModuleLoader__.load({
 }
 
 .dcAgentWorkbench {
+  box-sizing: border-box;
   display: flex;
   flex-direction: column;
   width: min(460px, 42vw);
   max-width: calc(100vw - 420px);
   min-width: 360px;
   height: 100vh;
-  border: 1px solid light-dark(#d5dae4, #2a3038);
+  border: 1px solid var(--dc-border);
   border-radius: 12px 0 0 12px;
-  background: light-dark(#ffffff, #161b23);
-  color: light-dark(#172033, #edf2fa);
+  background: var(--dc-surface);
+  color: var(--dc-text);
   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;
@@ -129,7 +171,7 @@ window.__ModuleLoader__.load({
 
 .dcAgentCapabilities {
   display: flex;
-  justify-content: center;
+  justify-content: safe center;
   align-items: center;
   gap: 8px;
   width: 100%;
@@ -153,10 +195,10 @@ window.__ModuleLoader__.load({
   padding: 7px 12px;
   flex-direction: column;
   justify-content: center;
-  border: 1px solid light-dark(#e4e8f0, #303947);
+  border: 1px solid var(--dc-border);
   border-radius: 12px;
-  background: light-dark(rgba(255,255,255,.86), rgba(22,27,35,.86));
-  color: light-dark(#5d687a, #aab5c7);
+  background: var(--dc-surface);
+  color: var(--dc-muted);
   font: inherit;
   font-size: 12px;
   cursor: pointer;
@@ -164,78 +206,23 @@ window.__ModuleLoader__.load({
 .dcAgentCapability:hover,
 .dcAgentCapability:focus-visible,
 .dcAgentCapability.is-active {
-  border-color: light-dark(#c9d9f8, #365681);
-  background: light-dark(#edf4ff, #172841);
-  color: light-dark(#1556cf, #8cb3ff);
+  border-color: var(--dc-border);
+  background: var(--dc-selected);
+  color: var(--dc-action);
 }
 .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: var(--dc-muted); 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) {
@@ -253,31 +240,34 @@ window.__ModuleLoader__.load({
   left: 16px;
   min-height: 28px;
   padding: 3px 10px;
-  border: 1px solid light-dark(#c9d9f8, #365681);
+  border: 1px solid var(--dc-border);
   border-radius: 999px;
-  background: light-dark(#edf4ff, #172841);
-  color: light-dark(#1556cf, #8cb3ff);
+  background: var(--dc-selected);
+  color: var(--dc-action);
   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);
+  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;
-  background: light-dark(#ffffff, #161b23);
-  color: light-dark(#172033, #edf2fa);
+  border: 1px solid var(--dc-border);
+  border-radius: 12px;
+  background: var(--dc-surface);
+  color: var(--dc-text);
   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 var(--dc-border); padding-top: 12px; }
 .dcAgentPromptHead {
   display: flex;
   align-items: flex-start;
@@ -286,7 +276,7 @@ window.__ModuleLoader__.load({
   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; }
+.dcAgentPromptHead p { margin: 3px 0 0; color: var(--dc-muted); font-size: 12px; line-height: 17px; }
 .dcAgentPromptClose {
   width: 28px;
   height: 28px;
@@ -297,7 +287,7 @@ window.__ModuleLoader__.load({
   color: inherit;
   cursor: pointer;
 }
-.dcAgentPromptClose:hover { background: light-dark(#f1f4f8, #222a36); }
+.dcAgentPromptClose:hover { background: var(--dc-page); }
 .dcAgentPromptTabs { display: flex; flex-wrap: wrap; gap: 6px; margin-bottom: 10px; }
 .dcAgentPromptTab,
 .dcAgentPromptChoice {
@@ -306,8 +296,8 @@ window.__ModuleLoader__.load({
   gap: 5px;
   min-height: 32px;
   padding: 5px 10px;
-  border: 1px solid light-dark(#d9dee8, #394352);
-  border-radius: 9px;
+  border: 1px solid var(--dc-border);
+  border-radius: 6px;
   background: transparent;
   color: inherit;
   font: inherit;
@@ -316,9 +306,9 @@ window.__ModuleLoader__.load({
 }
 .dcAgentPromptTab.is-active,
 .dcAgentPromptChoice.is-selected {
-  border-color: light-dark(#2869e6, #6d9eff);
-  background: light-dark(#edf4ff, #172841);
-  color: light-dark(#1556cf, #8cb3ff);
+  border-color: var(--dc-action);
+  background: var(--dc-selected);
+  color: var(--dc-action);
 }
 .dcAgentPromptField { display: grid; gap: 6px; margin: 10px 0; }
 .dcAgentPromptField > span { font-size: 12px; font-weight: 600; }
@@ -328,9 +318,9 @@ window.__ModuleLoader__.load({
   min-height: 104px;
   resize: vertical;
   padding: 10px 12px;
-  border: 1px solid light-dark(#d9dee8, #394352);
-  border-radius: 10px;
-  background: light-dark(#fbfcfe, #11171f);
+  border: 1px solid var(--dc-border);
+  border-radius: 8px;
+  background: var(--dc-page);
   color: inherit;
   font: inherit;
   font-size: 12px;
@@ -342,8 +332,8 @@ window.__ModuleLoader__.load({
   gap: 10px;
   padding: 12px;
   border: 1px dashed light-dark(#b9c5d8, #43516a);
-  border-radius: 10px;
-  color: light-dark(#59677c, #b1bdd0);
+  border-radius: 8px;
+  color: var(--dc-muted);
   font-size: 12px;
 }
 .dcAgentPromptFile input { max-width: 100%; }
@@ -353,17 +343,17 @@ window.__ModuleLoader__.load({
   padding: 12px;
   border: 1px dashed light-dark(#b9c5d8, #43516a);
   border-radius: 12px;
-  background: light-dark(#fbfcfe, #11171f);
+  background: var(--dc-page);
   outline: none;
 }
 .dcAgentPromptImageDrop.is-active {
-  border-color: #2869e6;
-  background: light-dark(#edf4ff, #172841);
+  border-color: var(--dc-action);
+  background: var(--dc-selected);
 }
 .dcAgentPromptImageDrop > p {
   margin: 0;
-  color: light-dark(#697386, #aab5c7);
-  font-size: 11px;
+  color: var(--dc-muted);
+  font-size: 12px;
   line-height: 17px;
 }
 .dcAgentPromptImagePreview {
@@ -378,31 +368,31 @@ window.__ModuleLoader__.load({
   flex: 0 0 auto;
   overflow: hidden;
   padding: 0;
-  border: 1px solid light-dark(#d9dee8, #394352);
-  border-radius: 10px;
-  background: light-dark(#f3f6fa, #202733);
+  border: 1px solid var(--dc-border);
+  border-radius: 8px;
+  background: var(--dc-page);
   cursor: zoom-in;
 }
 .dcAgentPromptImageThumb img { width: 100%; height: 100%; object-fit: cover; display: block; }
 .dcAgentPromptImageMeta { min-width: 0; flex: 1 1 auto; }
 .dcAgentPromptImageMeta b,
 .dcAgentPromptImageMeta small { display: block; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
-.dcAgentPromptImageMeta small { margin-top: 3px; color: light-dark(#697386, #aab5c7); }
+.dcAgentPromptImageMeta small { margin-top: 3px; color: var(--dc-muted); }
 .dcAgentPromptImageRemove {
   flex: 0 0 auto;
   padding: 5px 9px;
-  border: 1px solid light-dark(#d9dee8, #394352);
+  border: 1px solid var(--dc-border);
   border-radius: 8px;
   background: transparent;
   color: inherit;
   font: inherit;
-  font-size: 11px;
+  font-size: 12px;
   cursor: pointer;
 }
 .dcAgentImageLightbox {
   position: fixed;
   inset: 0;
-  z-index: 1400;
+  z-index: 2100;
   display: grid;
   place-items: center;
   padding: 32px;
@@ -427,25 +417,25 @@ window.__ModuleLoader__.load({
   margin: 10px 0 0;
   padding: 8px 10px;
   border-radius: 8px;
-  background: light-dark(#f6f8fb, #1c2330);
-  color: light-dark(#697386, #aab5c7);
-  font-size: 11px;
+  background: var(--dc-page);
+  color: var(--dc-muted);
+  font-size: 12px;
   line-height: 17px;
 }
-.dcAgentPromptError { margin: 8px 0 0; color: light-dark(#b42318, #ff8d86); font-size: 11px; }
+.dcAgentPromptError { margin: 8px 0 0; color: light-dark(#b42318, #ff8d86); font-size: 12px; }
 .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;
+  border: 1px solid var(--dc-border);
+  border-radius: 6px;
   background: transparent;
   color: inherit;
   font: inherit;
   font-size: 12px;
   cursor: pointer;
 }
-.dcAgentPromptAction.is-primary { border-color: #2869e6; background: #2869e6; color: white; }
+.dcAgentPromptAction.is-primary { border-color: var(--dc-action); background: var(--dc-action); color: var(--dc-on-action); }
 .dcAgentPromptAction:disabled { opacity: .5; cursor: default; }
 
 .dcAgentHeaderAction {
@@ -454,9 +444,9 @@ window.__ModuleLoader__.load({
   gap: 6px;
   min-height: 30px;
   padding: 4px 9px;
-  border: 1px solid light-dark(#d9dee8, #394352);
+  border: 1px solid var(--dc-border);
   border-radius: 8px;
-  background: light-dark(#ffffff, #191f28);
+  background: var(--dc-surface);
   color: inherit;
   font: inherit;
   font-size: 12px;
@@ -464,8 +454,8 @@ window.__ModuleLoader__.load({
 }
 .dcAgentHeaderAction:hover,
 .dcAgentHeaderAction:focus-visible {
-  border-color: light-dark(#2869e6, #6d9eff);
-  color: light-dark(#1556cf, #8cb3ff);
+  border-color: var(--dc-action);
+  color: var(--dc-action);
 }
 
 .dcAgentWbHeader {
@@ -473,7 +463,7 @@ window.__ModuleLoader__.load({
   align-items: center;
   gap: 8px;
   padding: 12px 14px;
-  border-bottom: 1px solid light-dark(#e4e8f0, #303947);
+  border-bottom: 1px solid var(--dc-border);
 }
 
 .dcAgentWbTitle {
@@ -490,15 +480,15 @@ window.__ModuleLoader__.load({
   display: grid;
   place-items: center;
   flex: 0 0 auto;
-  border-radius: 11px;
+  border-radius: 8px;
   font-size: 18px;
-  background: light-dark(#edf4ff, #172841);
+  background: var(--dc-selected);
 }
 
 .dcAgentWbTitle b,
 .dcAgentWbTitle small { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .dcAgentWbTitle b { display: block; font-size: 15px; }
-.dcAgentWbTitle small { display: block; max-width: 190px; color: light-dark(#697386, #aab5c7); font-size: 11px; }
+.dcAgentWbTitle small { display: block; max-width: 190px; color: var(--dc-muted); font-size: 12px; }
 
 .dcAgentWbActions {
   display: flex;
@@ -511,10 +501,10 @@ window.__ModuleLoader__.load({
 .dcAgentQccBadge {
   flex: 0 0 auto;
   padding: 4px 10px;
-  border: 1px solid light-dark(#e4e8f0, #303947);
+  border: 1px solid var(--dc-border);
   border-radius: 999px;
-  color: light-dark(#697386, #aab5c7);
-  font-size: 11px;
+  color: var(--dc-muted);
+  font-size: 12px;
   white-space: nowrap;
 }
 
@@ -524,22 +514,22 @@ window.__ModuleLoader__.load({
   height: 30px;
   display: grid;
   place-items: center;
-  border: 1px solid light-dark(#e4e8f0, #303947);
+  border: 1px solid var(--dc-border);
   border-radius: 8px;
   background: transparent;
   color: inherit;
   font-size: 15px;
   cursor: pointer;
 }
-.dcAgentWbClose:hover, .dcAgentWbClose:focus-visible { background: light-dark(#f6f8fb, #202733); }
+.dcAgentWbClose:hover, .dcAgentWbClose:focus-visible { background: var(--dc-page); }
 
 .dcAgentStepper {
   display: grid;
   grid-template-columns: repeat(4, minmax(0, 1fr));
   gap: 8px;
   padding: 12px 18px;
-  border-bottom: 1px solid light-dark(#e4e8f0, #303947);
-  background: light-dark(#fbfcfe, #12171e);
+  border-bottom: 1px solid var(--dc-border);
+  background: var(--dc-page);
 }
 
 .dcAgentStep {
@@ -548,18 +538,18 @@ window.__ModuleLoader__.load({
   justify-content: center;
   gap: 6px;
   padding: 9px 6px;
-  border: 1px solid light-dark(#e4e8f0, #303947);
-  border-radius: 9px;
+  border: 1px solid var(--dc-border);
+  border-radius: 6px;
   background: transparent;
-  color: light-dark(#697386, #aab5c7);
+  color: var(--dc-muted);
   font-size: 12px;
   cursor: pointer;
   white-space: nowrap;
 }
 .dcAgentStep.is-active {
-  color: light-dark(#1556cf, #8cb3ff);
-  border-color: light-dark(#2869e6, #6d9eff);
-  background: light-dark(#edf4ff, #172841);
+  color: var(--dc-action);
+  border-color: var(--dc-action);
+  background: var(--dc-selected);
 }
 
 .dcAgentWbBody {
@@ -569,16 +559,16 @@ window.__ModuleLoader__.load({
 }
 
 .dcAgentPane { display: flex; flex-direction: column; gap: 14px; }
-.dcAgentHint { margin: 0; color: light-dark(#697386, #aab5c7); font-size: 13px; line-height: 1.6; }
+.dcAgentHint { margin: 0; color: var(--dc-muted); font-size: 13px; line-height: 1.6; }
 
 .dcAgentTextarea {
   width: 100%;
   box-sizing: border-box;
   min-height: 132px;
   padding: 12px;
-  border: 1px solid light-dark(#cfd6e2, #485364);
-  border-radius: 10px;
-  background: light-dark(#ffffff, #191f28);
+  border: 1px solid var(--dc-border);
+  border-radius: 8px;
+  background: var(--dc-surface);
   color: inherit;
   font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
   font-size: 12px;
@@ -591,29 +581,29 @@ window.__ModuleLoader__.load({
   box-sizing: border-box;
   min-width: 0;
   padding: 8px 12px;
-  border: 1px solid light-dark(#cfd6e2, #485364);
-  border-radius: 9px;
+  border: 1px solid var(--dc-border);
+  border-radius: 6px;
   font-size: 12px;
-  background: light-dark(#ffffff, #191f28);
+  background: var(--dc-surface);
   color: inherit;
 }
 
 .dcAgentButton {
   padding: 9px 16px;
-  border: 1px solid light-dark(#cfd6e2, #485364);
-  border-radius: 9px;
-  background: light-dark(#ffffff, #191f28);
+  border: 1px solid var(--dc-border);
+  border-radius: 6px;
+  background: var(--dc-surface);
   color: inherit;
   font-size: 13px;
   cursor: pointer;
 }
-.dcAgentButton:hover, .dcAgentButton:focus-visible { border-color: light-dark(#2869e6, #6d9eff); }
+.dcAgentButton:hover, .dcAgentButton:focus-visible { border-color: var(--dc-action); }
 .dcAgentButton.is-primary {
   border-color: transparent;
-  color: #ffffff;
-  background: light-dark(#2869e6, #3d7bf0);
+  color: var(--dc-on-action);
+  background: var(--dc-action);
 }
-.dcAgentButton.is-primary:hover, .dcAgentButton.is-primary:focus-visible { background: light-dark(#1556cf, #6d9eff); }
+.dcAgentButton.is-primary:hover, .dcAgentButton.is-primary:focus-visible { background: var(--dc-hover); }
 .dcAgentButton:disabled { opacity: 0.5; cursor: not-allowed; }
 
 .dcAgentGrid {
@@ -624,14 +614,14 @@ window.__ModuleLoader__.load({
 
 .dcAgentCard {
   padding: 12px 14px;
-  border: 1px solid light-dark(#e4e8f0, #303947);
-  border-radius: 11px;
-  background: light-dark(#fbfcfe, #191f28);
+  border: 1px solid var(--dc-border);
+  border-radius: 8px;
+  background: var(--dc-page);
 }
-.dcAgentCard span { display: block; color: light-dark(#697386, #aab5c7); font-size: 11px; }
+.dcAgentCard span { display: block; color: var(--dc-muted); font-size: 12px; }
 .dcAgentCard b { display: block; margin-top: 3px; font-size: 18px; }
-.dcAgentCard b.is-good { color: light-dark(#118a5b, #56d39b); }
-.dcAgentCard b.is-warn { color: light-dark(#c17412, #f4b85d); }
+.dcAgentCard b.is-good { color: var(--dc-success); }
+.dcAgentCard b.is-warn { color: var(--dc-review); }
 .dcAgentCard b.is-bad { color: light-dark(#d2454f, #ff838b); }
 
 .dcAgentTable {
@@ -642,9 +632,9 @@ window.__ModuleLoader__.load({
 .dcAgentTable th, .dcAgentTable td {
   padding: 7px 9px;
   text-align: left;
-  border-bottom: 1px solid light-dark(#eef1f6, #242b36);
+  border-bottom: 1px solid var(--dc-border);
 }
-.dcAgentTable th { color: light-dark(#697386, #aab5c7); font-weight: 600; }
+.dcAgentTable th { color: var(--dc-muted); font-weight: 600; }
 .dcAgentTable td.num { font-variant-numeric: tabular-nums; }
 .dcAgentTableWrap { max-width: 100%; overflow-x: auto; }
 .dcAgentTableWrap .dcAgentTable { min-width: 720px; table-layout: auto; }
@@ -656,7 +646,7 @@ window.__ModuleLoader__.load({
 .dcAgentError {
   padding: 10px 12px;
   border: 1px solid light-dark(#ffd6d8, #5b2f33);
-  border-radius: 9px;
+  border-radius: 6px;
   background: light-dark(#fff0f0, #351d21);
   color: light-dark(#d2454f, #ff838b);
   font-size: 12px;
@@ -665,22 +655,22 @@ window.__ModuleLoader__.load({
 .dcAgentChips { display: flex; flex-wrap: wrap; gap: 6px; }
 .dcAgentChip {
   padding: 4px 10px;
-  border: 1px solid light-dark(#e4e8f0, #303947);
+  border: 1px solid var(--dc-border);
   border-radius: 999px;
-  font-size: 11px;
-  color: light-dark(#697386, #aab5c7);
+  font-size: 12px;
+  color: var(--dc-muted);
 }
 .dcAgentChip.is-selected {
-  color: light-dark(#1556cf, #8cb3ff);
-  border-color: light-dark(#2869e6, #6d9eff);
-  background: light-dark(#edf4ff, #172841);
+  color: var(--dc-action);
+  border-color: var(--dc-action);
+  background: var(--dc-selected);
 }
 .dcAgentCheck { display: inline-flex; align-items: center; gap: 6px; font-size: 12px; }
 .dcAgentSection {
   padding: 14px;
-  border: 1px solid light-dark(#e4e8f0, #303947);
-  border-radius: 11px;
-  background: light-dark(#fbfcfe, #191f28);
+  border: 1px solid var(--dc-border);
+  border-radius: 8px;
+  background: var(--dc-page);
 }
 .dcAgentSection h3 { margin: 0 0 8px; font-size: 13px; }
 .dcAgentCandidate {
@@ -689,32 +679,32 @@ window.__ModuleLoader__.load({
   gap: 10px;
   align-items: center;
   padding: 10px 0;
-  border-bottom: 1px solid light-dark(#eef1f6, #242b36);
+  border-bottom: 1px solid var(--dc-border);
 }
 .dcAgentCandidate:last-child { border-bottom: 0; }
-.dcAgentCandidate small { color: light-dark(#697386, #aab5c7); }
+.dcAgentCandidate small { color: var(--dc-muted); }
 .dcAgentProgress { height: 8px; overflow: hidden; border-radius: 99px; background: light-dark(#e8edf5, #293240); }
-.dcAgentProgress > span { display: block; height: 100%; background: #2869e6; }
+.dcAgentProgress > span { display: block; height: 100%; background: var(--dc-action); }
 
 /* M3 · overlay 头部 jobs 状态 pill（轮询 /mvp/jobs，不接计费遥测）。 */
 .dcAgentJobsPill {
   flex: 0 0 auto;
   padding: 4px 10px;
-  border: 1px solid light-dark(#e4e8f0, #303947);
+  border: 1px solid var(--dc-border);
   border-radius: 999px;
-  font-size: 11px;
+  font-size: 12px;
   white-space: nowrap;
-  color: light-dark(#697386, #aab5c7);
+  color: var(--dc-muted);
 }
 .dcAgentJobsPill[data-state='running'] {
-  color: light-dark(#1556cf, #8cb3ff);
-  border-color: light-dark(#2869e6, #6d9eff);
-  background: light-dark(#edf4ff, #172841);
+  color: var(--dc-action);
+  border-color: var(--dc-action);
+  background: var(--dc-selected);
 }
 .dcAgentJobsPill[data-state='completed'] {
-  color: light-dark(#118a5b, #56d39b);
-  border-color: light-dark(#118a5b, #2f7d5e);
-  background: light-dark(#eefaf3, #12261d);
+  color: var(--dc-success);
+  border-color: var(--dc-success);
+  background: var(--dc-success-bg);
 }
 .dcAgentJobsPill[data-state='failed'] {
   color: light-dark(#d2454f, #ff838b);
@@ -728,9 +718,9 @@ window.__ModuleLoader__.load({
   flex-direction: column;
   gap: 8px;
   padding: 12px 14px;
-  border: 1px solid light-dark(#e4e8f0, #303947);
-  border-radius: 11px;
-  background: light-dark(#fbfcfe, #191f28);
+  border: 1px solid var(--dc-border);
+  border-radius: 8px;
+  background: var(--dc-page);
   margin: 4px 0;
 }
 .dcAgentToolCardHead {
@@ -750,45 +740,34 @@ window.__ModuleLoader__.load({
   flex: 0 0 auto;
   padding: 1px 8px;
   border-radius: 999px;
-  font-size: 11px;
-  color: light-dark(#697386, #aab5c7);
-  border: 1px solid light-dark(#e4e8f0, #303947);
+  font-size: 12px;
+  color: var(--dc-muted);
+  border: 1px solid var(--dc-border);
 }
-.dcAgentToolCardState.is-ok { color: light-dark(#118a5b, #56d39b); }
+.dcAgentToolCardState.is-ok { color: var(--dc-success); }
 .dcAgentToolCardState.is-error { color: light-dark(#d2454f, #ff838b); }
-.dcAgentToolCardState.is-running { color: light-dark(#1556cf, #8cb3ff); }
-.dcAgentToolCardState.is-stopped { color: light-dark(#697386, #aab5c7); }
+.dcAgentToolCardState.is-running { color: var(--dc-action); }
+.dcAgentToolCardState.is-stopped { color: var(--dc-muted); }
 .dcAgentToolCardBody {
   margin: 0;
   white-space: pre-wrap;
   word-break: break-word;
   font-size: 12px;
   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); }
+  color: var(--dc-text);
+}
+.dcAgentHistoryTask { border: 1px solid var(--dc-border); border-radius: 6px; background: var(--dc-surface); color: inherit; font: inherit; cursor: pointer; }
 .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); }
-.dcAgentWizardStep.is-active { border-color: #2869e6; background: light-dark(#edf4ff, #172841); color: light-dark(#1556cf, #8cb3ff); }
-.dcAgentWizardStep.is-active b { background: #2869e6; color: white; }
+.dcAgentWizardStep { display: flex; align-items: center; gap: 6px; padding: 7px; border: 1px solid var(--dc-border); border-radius: 6px; background: transparent; color: inherit; font: inherit; font-size: 12px; cursor: pointer; }
+.dcAgentWizardStep b { display: grid; place-items: center; width: 20px; height: 20px; border-radius: 50%; background: var(--dc-border); color: var(--dc-muted); }
+.dcAgentWizardStep.is-active { border-color: var(--dc-action); background: var(--dc-selected); color: var(--dc-action); }
+.dcAgentWizardStep.is-active b { background: var(--dc-action); color: var(--dc-on-action); }
 .dcAgentWizardPane { min-height: 230px; }
 .dcAgentWizardPane h4 { margin: 0 0 3px; font-size: 14px; }
-.dcAgentWizardPane > p { margin: 0 0 12px; color: light-dark(#697386, #aab5c7); font-size: 11px; line-height: 17px; }
+.dcAgentWizardPane > p { margin: 0 0 12px; color: var(--dc-muted); font-size: 12px; line-height: 17px; }
 .dcAgentPromptRules { display: grid; gap: 8px; margin-top: 14px; }
 .dcAgentPromptRules label { font-size: 12px; }
-.dcAgentPromptPreview { max-height: 260px; overflow: auto; margin: 10px 0 0; padding: 12px; border-radius: 10px; background: light-dark(#f6f8fb, #11171f); white-space: pre-wrap; word-break: break-word; font: inherit; font-size: 11px; line-height: 18px; }
+.dcAgentPromptPreview { max-height: 260px; overflow: auto; margin: 10px 0 0; padding: 12px; border-radius: 8px; background: var(--dc-page); white-space: pre-wrap; word-break: break-word; font: inherit; font-size: 12px; line-height: 18px; }
 .dcAgentFormField { display: grid; gap: 6px; font-size: 12px; font-weight: 600; }
 .dcAgentMappingRow { display: grid; grid-template-columns: minmax(0, 1fr) 24px minmax(180px, 1fr); align-items: center; gap: 8px; margin-top: 7px; font-size: 12px; }
 .dcAgentMappingRow > span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
@@ -804,13 +783,13 @@ window.__ModuleLoader__.load({
   border: 0;
   border-radius: 6px;
   background: transparent;
-  color: light-dark(#2869e6, #8cb3ff);
+  color: var(--dc-action);
   font: inherit;
-  font-size: 11px;
+  font-size: 12px;
   cursor: pointer;
 }
-.dcAgentFieldAction:hover, .dcAgentFieldAction:focus-visible { background: light-dark(#edf4ff, #172841); }
-.dcAgentPreviewTable { margin-top: 12px; overflow: auto; border: 1px solid light-dark(#e4e8f0, #303947); border-radius: 10px; }
+.dcAgentFieldAction:hover, .dcAgentFieldAction:focus-visible { background: var(--dc-selected); }
+.dcAgentPreviewTable { margin-top: 12px; overflow: auto; border: 1px solid var(--dc-border); border-radius: 8px; }
 .dcAgentHistoryTask { display: block; width: 100%; padding: 10px; text-align: left; }
 .dcAgentHistoryTask h3 { margin: 0; font-size: 12px; }
 /*
@@ -830,6 +809,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 +823,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; }
@@ -850,6 +834,38 @@ window.__ModuleLoader__.load({
   .dcAgentWorkbench { width: 420px; max-width: 48vw; min-width: 360px; }
   .dcAgentQccBadge, .dcAgentJobsPill { display: none; }
 }
+/* Distinct levels: management tabs → compact task steps → working content. */
+.dcAgentWorkbench, .dcAgentPromptPanel { font-size: 14px; line-height: 1.5; }
+.dcAgentWbHeader, .dcAgentManagement, .dcAgentStepper { flex: none; }
+.dcAgentManagement { display: flex; gap: 24px; padding: 0 18px; border-bottom: 1px solid var(--dc-border); }
+.dcAgentManagement .dcAgentButton { border: 0; border-bottom: 3px solid transparent; border-radius: 0; padding: 10px 0; background: transparent; }
+.dcAgentManagement .dcAgentButton[aria-pressed="true"] { border-bottom-color: var(--dc-action); color: var(--dc-action); font-weight: 600; }
+.dcAgentStepper { display: flex; overflow-x: auto; gap: 4px; padding: 10px 12px; }
+.dcAgentStep { flex: 0 0 auto; border-color: transparent; padding: 7px 8px; }
+.dcAgentStep.is-active { border-color: transparent; }
+.dcAgentCapability { border-radius: 8px; }
+.dcAgentWbBody { min-height: 0; }
+.dcAgentTable th { background: var(--dc-table-head); color: var(--dc-text); }
+.dcAgentTable th, .dcAgentTable td { height: 44px; box-sizing: border-box; font-size: 13px; }
+.dcAgentTable tbody tr:hover { background: var(--dc-selected); }
+.dcAgentSection, .dcAgentCard { background: var(--dc-surface); }
+.dcAgentFieldGroup { background: var(--dc-page); padding: 12px; border-radius: 8px; }
+.dcAgentPromptFieldGrid { display: grid; grid-template-columns: repeat(auto-fit, minmax(180px, 1fr)); gap: 8px; margin-top: 10px; }
+.dcAgentPromptFieldGrid .dcAgentPromptChoice { border: 0; border-radius: 4px; min-width: 0; align-items: flex-start; font-size: 13px; }
+.dcAgentFieldGroup .dcAgentChips { display: grid; grid-template-columns: repeat(auto-fit, minmax(180px, 1fr)); }
+.dcAgentFieldGroup .dcAgentChip { border-radius: 4px; }
+.dcAgentPromptText, .dcAgentTextarea, .dcAgentField { font-size: 14px; }
+.dcAgentPromptTrigger { border-radius: 6px; }
+.dcAgentPromptAction.is-primary:hover:not(:disabled) { background: var(--dc-hover); }
+:is(.dcAgentWorkbench, .dcAgentPromptPanel, .dcAgentCapabilities, .dcAgentPromptLayer) :is(button, input, select, textarea, summary):focus-visible,
+.dcAgentLauncher:focus-visible { outline: 2px solid var(--dc-action); outline-offset: 2px; }
+@media (max-width: 760px) {
+  [data-dc-agent-hero-title="true"] { font-size: 20px; }
+  .dcAgentHeroLogo { width: 40px; height: 40px; border-radius: 8px; }
+  .dcAgentPromptText, .dcAgentTextarea, .dcAgentField { font-size: 16px; }
+  .dcAgentPromptFieldGrid { grid-template-columns: 1fr; }
+}
+
 `;
 
     /** 安装入口、会话能力按钮与右侧工作台样式。 */
@@ -897,18 +913,18 @@ 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: '▦' },
+      { key: 'enrich', label: '字段补全', icon: DatabaseLogo, fallback: '▦' },
       { key: 'history', label: '任务历史', icon: IconArchiveOutline20, fallback: '◷' },
     ];
 
@@ -1792,7 +1808,7 @@ window.__ModuleLoader__.load({
             console.error('[dc-agent] open failed:', error);
           }
         },
-        children: wide ? '🧹 数据清洗补全' : '🧹',
+        children: h('span', { className: 'dcAgentLauncherContent' }, h(DatabaseLogo), wide ? h('span', null, '数据清洗补全') : null),
       });
       if (!topMount || typeof reactDom.createPortal !== 'function') return launcher;
       return reactDom.createPortal(h('div', {
@@ -1801,7 +1817,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 +1842,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
      * 阶段替换标题，并在卸载时恢复，避免污染普通会话。
@@ -1903,6 +1962,9 @@ window.__ModuleLoader__.load({
       if (!hero) return () => {};
       const changedTitles = new Map();
       const changedBadges = new Map();
+      const changedMarks = new Map();
+      const changedRows = new Map();
+      const ownedLogos = new Map();
       const hiddenForeignDocks = new Map();
       const composerStack = marker?.parentElement?.parentElement;
       // 单一会话所有权由入口的 enabled 参数（useCleaningSession(sessionId) && composerPhase==='blank'）
@@ -1924,6 +1986,29 @@ window.__ModuleLoader__.load({
           if (!changedTitles.has(title)) changedTitles.set(title, title.textContent ?? '');
           title.dataset.dcAgentHeroTitle = 'true';
           if (title.textContent !== '数据清洗补全智能体') { title.textContent = '数据清洗补全智能体'; mutated = true; }
+          // 只适配本会话已确认的 DSH headline；未知宿主结构保留原状。
+          const row = title.parentElement;
+          const nativeMark = row?.querySelector?.('[class*="fishHitbox"]');
+          if (nativeMark && typeof document.createElementNS === 'function') {
+            if (!changedRows.has(row)) changedRows.set(row, row.getAttribute('data-dc-agent-hero-row'));
+            row.setAttribute('data-dc-agent-hero-row', 'true');
+            if (!changedMarks.has(nativeMark)) changedMarks.set(nativeMark, nativeMark.style.display);
+            nativeMark.style.display = 'none';
+            if (!ownedLogos.get(row)?.isConnected) {
+              const logo = document.createElement('span');
+              logo.className = 'dcAgentHeroLogo';
+              logo.setAttribute('aria-hidden', 'true');
+              const svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
+              for (const [name, value] of Object.entries({ viewBox: '0 0 24 24', width: '26', height: '26', fill: 'none', stroke: 'currentColor', 'stroke-width': '1.7', 'stroke-linecap': 'round', 'stroke-linejoin': 'round', focusable: 'false' })) svg.setAttribute(name, value);
+              const path = document.createElementNS('http://www.w3.org/2000/svg', 'path');
+              path.setAttribute('d', DATABASE_PATH);
+              svg.appendChild(path);
+              logo.appendChild(svg);
+              row.insertBefore(logo, title);
+              ownedLogos.set(row, logo);
+              mutated = true;
+            }
+          }
         }
         if (badge) {
           if (!changedBadges.has(badge)) changedBadges.set(badge, badge.style?.display ?? '');
@@ -1961,6 +2046,12 @@ window.__ModuleLoader__.load({
       observer?.observe?.(hero, { childList: true, subtree: true });
       return () => {
         observer?.disconnect?.();
+        for (const logo of ownedLogos.values()) logo.remove();
+        for (const [mark, originalDisplay] of changedMarks) mark.style.display = originalDisplay;
+        for (const [row, originalValue] of changedRows) {
+          if (originalValue === null) row.removeAttribute('data-dc-agent-hero-row');
+          else row.setAttribute('data-dc-agent-hero-row', originalValue);
+        }
         for (const [title, originalText] of changedTitles) {
           if (title.textContent === '数据清洗补全智能体') title.textContent = originalText;
           delete title.dataset.dcAgentHeroTitle;
@@ -1979,6 +2070,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 +2086,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,
       );
     }
@@ -2071,6 +2169,7 @@ window.__ModuleLoader__.load({
       const [imageLightbox, setImageLightbox] = react.useState(false);
       const [cleaningKeys, setCleaningKeys] = react.useState(DEFAULT_CLEANING_KEYS);
       const [enrichmentKeys, setEnrichmentKeys] = react.useState(DEFAULT_ENRICHMENT_KEYS);
+      const [fieldQuery, setFieldQuery] = react.useState('');
       const [anchorKeys, setAnchorKeys] = react.useState(['company_name', 'credit_no']);
       const [matchRules, setPromptMatchRules] = react.useState({
         normalizeNames: true,
@@ -2276,6 +2375,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 +2437,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 +2457,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 +2495,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 +2503,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,
@@ -2498,18 +2607,27 @@ window.__ModuleLoader__.load({
               h('b', null, '清洗目标'),
               h('div', { className: 'dcAgentPromptChoices' }, choice(CLEANING_OPTIONS, cleaningKeys, setCleaningKeys)),
             ),
-            FIELD_GROUPS.map(([groupId, label, fields, sourceTool]) => h('div', { className: 'dcAgentPromptGroup', key: groupId },
+            h('label', { className: 'dcAgentPromptField' },
+              h('span', null, `查找补全字段 · 已选 ${enrichmentKeys.length}`),
+              h('input', { type: 'search', className: 'dcAgentField', value: fieldQuery, 'aria-label': '查找补全字段',
+                placeholder: '搜索维度、字段或工具名称', onChange: (event) => setFieldQuery(event.target.value) })),
+            !FIELD_GROUPS.some((group) => visibleCatalogFields(group, fieldQuery).length) ? h('p', { className: 'dcAgentHint', role: 'status' }, '没有匹配的字段；已选字段保持不变。') : null,
+            FIELD_GROUPS.filter((group) => visibleCatalogFields(group, fieldQuery).length).map(([groupId, label, fields, sourceTool]) => h('div', { className: 'dcAgentPromptGroup dcAgentFieldGroup', key: groupId },
               h('div', { className: 'dcAgentFieldGroupHead' },
                 h('div', null,
                   h('b', null, `${label} · ${fields.filter(([id]) => enrichmentKeys.includes(id)).length}/${fields.length}`),
                   sourceTool ? h('small', { className: 'dcAgentHint' }, `来源：${sourceTool}`) : null,
                 ),
                 h('div', { className: 'dcAgentFieldGroupActions' },
-                  h('button', { type: 'button', className: 'dcAgentFieldAction', onClick: () => setPromptFieldGroup(fields, true) }, '全选'),
-                  h('button', { type: 'button', className: 'dcAgentFieldAction', onClick: () => setPromptFieldGroup(fields, false) }, '清空'),
+                  h('button', { type: 'button', className: 'dcAgentFieldAction', title: '选中本维度全部字段，不受搜索过滤影响', onClick: () => setPromptFieldGroup(fields, true) }, '全选'),
+                  h('button', { type: 'button', className: 'dcAgentFieldAction', title: '清空本维度全部字段，不受搜索过滤影响', onClick: () => setPromptFieldGroup(fields, false) }, '清空'),
                 ),
               ),
-              h('div', { className: 'dcAgentPromptChoices' }, choice(fields, enrichmentKeys, setEnrichmentKeys)),
+              h('div', { className: 'dcAgentPromptFieldGrid' }, visibleCatalogFields([groupId, label, fields, sourceTool], fieldQuery).map(([id, fieldLabel]) => h('label', {
+                key: id, className: `dcAgentPromptChoice${enrichmentKeys.includes(id) ? ' is-selected' : ''}`,
+              }, h('input', { type: 'checkbox', checked: enrichmentKeys.includes(id),
+                onChange: (event) => setEnrichmentKeys((current) => event.target.checked ? [...new Set([...current, id])] : current.filter((key) => key !== id)),
+              }), fieldLabel))),
             )),
           ) : null,
           wizardStep === 4 ? h('div', { className: 'dcAgentWizardPane' },
@@ -2522,6 +2640,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 +2650,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,
       );
     }
 
@@ -2551,9 +2668,7 @@ window.__ModuleLoader__.load({
         title: '打开数据清洗补全工作台',
         onClick: () => requestWorkbenchOpen(null, sessionId),
       },
-        typeof IconDataOutline16 === 'function'
-          ? h(IconDataOutline16, { size: 16, 'aria-hidden': 'true' })
-          : h('span', { 'aria-hidden': 'true' }, '▦'),
+        h(DatabaseLogo, { size: 16 }),
         h('span', null, '清洗补全工作台'),
       );
     }
@@ -2828,6 +2943,7 @@ window.__ModuleLoader__.load({
       const paidConfirmed = useStore((state) => state.paidConfirmed);
       const jobs = useStore((state) => state.jobs);
       const activeSessionId = useStore((state) => state.activeSessionId);
+      const [fieldQuery, setFieldQuery] = react.useState('');
 
       react.useEffect(() => {
         rootWorkbenchActions = actions;
@@ -3378,10 +3494,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
@@ -3566,18 +3690,22 @@ window.__ModuleLoader__.load({
               h('span', { className: 'dcAgentChip' }, '第一批 40'),
               h('span', { className: 'dcAgentChip' }, '第二批 58'),
             ),
-            uiFieldGroups.map(([groupId, label, fields, sourceTool]) => h('div', { key: groupId, className: 'dcAgentFieldGroup' },
+            h('label', { className: 'dcAgentPromptField' }, h('span', null, '查找补全字段'),
+              h('input', { type: 'search', className: 'dcAgentField', value: fieldQuery, 'aria-label': '查找补全字段',
+                placeholder: '搜索维度、字段或工具名称', onChange: (event) => setFieldQuery(event.target.value) })),
+            !uiFieldGroups.some((group) => visibleCatalogFields(group, fieldQuery).length) ? h('p', { className: 'dcAgentHint', role: 'status' }, '没有匹配的字段；已选字段保持不变。') : null,
+            uiFieldGroups.filter((group) => visibleCatalogFields(group, fieldQuery).length).map(([groupId, label, fields, sourceTool]) => h('div', { key: groupId, className: 'dcAgentFieldGroup' },
               h('div', { className: 'dcAgentFieldGroupHead' },
                 h('div', null,
                   h('b', null, `${label} · ${fields.filter(([id]) => fieldSelection.includes(id)).length}/${fields.length}`),
                   sourceTool ? h('small', { className: 'dcAgentHint' }, `来源：${sourceTool}`) : null,
                 ),
                 h('div', { className: 'dcAgentFieldGroupActions' },
-                  h('button', { type: 'button', className: 'dcAgentFieldAction', onClick: () => setWorkbenchFieldGroup(fields, true) }, '全选'),
-                  h('button', { type: 'button', className: 'dcAgentFieldAction', onClick: () => setWorkbenchFieldGroup(fields, false) }, '清空'),
+                  h('button', { type: 'button', className: 'dcAgentFieldAction', title: '选中本维度全部字段，不受搜索过滤影响', onClick: () => setWorkbenchFieldGroup(fields, true) }, '全选'),
+                  h('button', { type: 'button', className: 'dcAgentFieldAction', title: '清空本维度全部字段，不受搜索过滤影响', onClick: () => setWorkbenchFieldGroup(fields, false) }, '清空'),
                 ),
               ),
-              h('div', { className: 'dcAgentChips' }, fields.map(([key, fieldLabel]) => h('label', { key, className: `dcAgentChip${fieldSelection.includes(key) ? ' is-selected' : ''}` },
+              h('div', { className: 'dcAgentChips' }, visibleCatalogFields([groupId, label, fields, sourceTool], fieldQuery).map(([key, fieldLabel]) => h('label', { key, className: `dcAgentChip${fieldSelection.includes(key) ? ' is-selected' : ''}` },
                 h('input', { type: 'checkbox', checked: fieldSelection.includes(key), onChange: () => actions.toggleField(key) }), ` ${fieldLabel}`,
               ))),
             )),
@@ -3779,7 +3907,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,
@@ -3813,7 +3941,7 @@ window.__ModuleLoader__.load({
         },
           h('header', { className: 'dcAgentWbHeader' },
             h('div', { className: 'dcAgentWbTitle' },
-              h('span', { className: 'dcAgentWbIcon', 'aria-hidden': 'true' }, '🧹'),
+              h('span', { className: 'dcAgentWbIcon', 'aria-hidden': 'true' }, h(DatabaseLogo, { size: 22 })),
               h('div', null,
                 h('b', null, '数据清洗补全'),
                 h('small', null, cachedTask ? `${WORKFLOW_STATE_LABELS[cachedTask.state] || cachedTask.state} · ${cachedTask.id.slice(0, 18)}` : '正在创建 Host taskId…'),
@@ -3843,19 +3971,39 @@ window.__ModuleLoader__.load({
               }, '✕'),
             ),
           ),
-          h('nav', { className: 'dcAgentStepper', 'aria-label': '清洗流程' },
+          h('nav', { className: 'dcAgentManagement', '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 +4050,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 +4102,12 @@ window.__ModuleLoader__.load({
     exports.inject = inject;
     // 测试用纯函数，不构成 Host / DSH 稳定 API。
     exports.__testing = {
+      DatabaseLogo,
+      visibleCatalogFields,
+      installCapabilityMount,
+      PromptDialog,
+      ProductHome,
+      workflowNavigationIssue,
       buildTaskPrompt,
       DatasetReview,
       reviewColumns,