dsh-data-cleaning-agent 0.9.11 → 0.9.12

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# 0.9.12 · 2026-09-14
+
+- Remove home subtitle and its spacing, retain native controls.
+- Keep launcher naming stable and prevent duplicate launches.
+- Preserve other agents’ branding and surfaces; clarify recorded progress and synchronization failures.
+- Adopt DSH-UX-001 v1.5.4; 277 checks and 10 isolated browser scenarios pass.
+
 # Changelog
 
 本文件记录 `dsh-data-cleaning-agent` 的版本变更。格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。

package/README.en.md

@@ -10,9 +10,9 @@ Related agents: [数据清洗补全](https://github.com/duhu2000/dsh-data-cleani
 
 > A data cleaning & completion agent plugin for DeepSeek Harness: local CSV/XLSX/JSON engine plus optional Qichacha (QCC) MCP enterprise-data enrichment. Initiated and maintained by the Qichacha (QCC) team.
 >
-> Current source version / 当前源码版本: **0.9.11** (stable release)
+> Current source version / 当前源码版本: **0.9.12** (stable release)
 
-0.9.11 uses the current cleaning Session's rendered Host phase instead of the nonexistent Session.composerPhase property. Branding appears on the real home screen and restores when leaving it.
+0.9.12 removes the home subtitle and its spacing, keeps native workspace/mode/composer controls, prevents duplicate menu launches, and scopes branding to its own home. Task records are distinguished from live model activity. The 0.9.11 Host phase and Session restoration fixes remain intact.
 
 0.9.10 observes the Host settling-to-hero transition so the database logo and product title appear even after delayed layout. Unknown structures do not trigger global headline rewriting. Rollback version: 0.9.9.
 

package/README.md

@@ -9,7 +9,7 @@
 数据清洗补全智能体：面向 Excel/CSV/JSON 企业名单，提供数据清洗、表格清洗、清洗补全、去重、企业数据补全与字段补全，支持企查查 MCP 和结果导出。
 
 ```sh
-dsh plugin --profile web add dsh-data-cleaning-agent@0.9.11
+dsh plugin --profile web add dsh-data-cleaning-agent@0.9.12
 ```
 
 请先满足下文的 DSH、连接器及侧边栏依赖要求；安装后完整停止并重启对应 Profile。
@@ -27,9 +27,9 @@ dsh plugin --profile web add dsh-data-cleaning-agent@0.9.11
 
 > 在 DeepSeek Harness 中清洗、补全、画像企业名单数据的智能体插件：本地 CSV/XLSX/JSON 引擎 + 可选企查查（Qichacha/QCC）MCP 企业数据补全，由企查查（Qichacha/QCC）团队发起并维护。
 >
-> 当前源码版本 / Current source version: **0.9.11**（正式版本）
+> 当前源码版本 / Current source version: **0.9.12**（正式版本）
 
-0.9.11 修正真实 Host 的首页状态接口：不再依赖 Session.composerPhase，按当前清洗会话所在宿主根节点的 data-phase 显示 Logo 与标题，并在离开首页时恢复。
+0.9.12 统一简洁首页：移除副标题与占位，保留原生工作区、模式和输入框。菜单名称固定并防止重复创建；品牌标题仅在所属首页生效，任务记录与模型运行状态明确区分。保留 0.9.11 的真实 Host 阶段与会话切换修复。
 
 0.9.10 补齐首页 settling → hero 阶段监听，避免首次挂载漏掉 Logo 与标题替换；兼容“探索未知之境”，未知结构不做全局标题改写。回滚版本为 0.9.9。
 

package/docs/RELEASE-0.9.12.md

@@ -0,0 +1,9 @@
+# 0.9.12 · 简洁首页与局部品牌保护
+
+首页移除副标题和专属留白，使用原生工作区、模式与输入框。左栏名称保持稳定，创建中禁用并阻止重复点击。品牌适配仅改写原生默认或本产品标题，停止隐藏其他产品 dock；保留 0.9.11 的真实阶段监听及晚挂载修复。
+
+任务区说明任务记录不代表模型实时运行；同步失败保留记录且不重复查询。
+
+验证：277 项检查，浅/深色 × 5 尺寸合成 Host React/Chromium 回归全部通过。未验证本轮真实四包共装、生产页面或真实计费 MCP。没有生产 Profile 修改。
+
+发布要求：PR CI → 合并 main → main CI → 新 annotated v0.9.12 → 既有 OIDC workflow → Registry/provenance 回读。旧版本和 Tag 不动。

package/docs/UNIFIED-HOME-1.5.4-ADOPTION.md

@@ -0,0 +1,24 @@
+# DSH-UX-001 v1.5.4 采用记录
+
+日期：2026-09-14。基线：0.9.11 / a0ec971db0d25d42f67f99e4328cca6f49a2bc2f。
+本轮仅本地代码与验收，不发布，不修改正式 Profile 或全局 DSH。
+
+## 已采用
+
+- UX-05：首页删除 ProductHome 副标题组件、挂载与 dcAgentHomeSummary 样式；没有替代空白容器。保留原生工作区/模式/输入控件以及输入框下能力菜单，不修改 npm description/搜索文案。
+- UX-45：左菜单固定“数据清洗补全”；创建中通过 disabled/aria-busy 表示，ref 门闩阻止同一渲染周期重复创建。失败仍沿用已有工作台错误状态，菜单名称不变。
+- UX-46：保留 0.9.11 的真实 data-phase、openState、所有权立即重读和独立 Session namespace。只接管原生已知 Hero 标题或本插件标记；不覆盖其他产品标题，不再隐藏其他产品 dock。清理仅恢复仍为本插件标题的文字，不调用会话 rename API。
+- UX-47：任务区明确展示“任务记录”，匹配/补全记录不冒充模型实时运行证明；元数据恢复/轮询失败明确为“状态同步异常”，保留最后记录且不重新查询。已有确认、取消、失败、完成状态继续来自 Host 任务数据，实际主体进度仍来自服务端计数，不伪造百分比。
+
+## 验证范围
+
+- npm run check：277 项通过，包括安装包检查、正文语法与既有业务测试。
+- 新增/调整断言：首页不含副标题组件或专属样式；同时点击只创建一个 Session；外产品标题和 dock 不被接管；既有 settling→hero、文本刷新、普通 Session、phase observer 清理继续回归。
+- scripts/ui-layout-regression.mjs：10/10 通过，真实 React/Chromium，合成 Host DOM/API fixture，浅/深色 × 5 尺寸。验证品牌、普通会话恢复、晚挂载和无副标题；完整现有导入/映射/确认/下载测试保留。
+- 浏览器 fixture 不等于完整真实 DSH 宿主。当前本轮未验证四包真实共装、用户正式页面或真实模型/QCC/OCR；正式版本仍为 0.9.11。
+
+## 边界
+
+清洗目前没有已验证的模型 running 状态接口，不新增假定宿主正在思考的状态条，也不声称掌握模型停止原因。恢复仅读取任务元数据。模型运行态由原生会话显示。
+
+证据：`/private/tmp/dc-unified-home-check.log`、`/private/tmp/dc-unified-home-ui-final.log` 与本工作树 `_scratch/ui-layout/results.json`。最后的未知标题保护收紧由观察器行为测试覆盖，未影响布局；其后完整 277 项检查再次通过。

package/lib/client.js

@@ -200,14 +200,13 @@ window.__ModuleLoader__.load({
 }
 .dcAgentCapability svg { flex: 0 0 auto; }
 
-/* 原生 input.dock 保留轻量简介；菜单独立 Portal 到 composer 后，不重排共享 slot。 */
+/* 首页无副标题或占位；菜单独立 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; }
 
@@ -2531,6 +2530,8 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
       const { wide, useStore, actions, startSession } = props;
       useStore((state) => state.open);
       const [topMount, setTopMount] = react.useState(null);
+      const [opening, setOpening] = react.useState(false);
+      const openingRef = react.useRef(false);
 
       react.useEffect(() => {
         let disposed = false;
@@ -2559,7 +2560,12 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
         className: 'dcAgentLauncher',
         'data-wide': wide,
         'aria-label': '数据清洗补全',
+        'aria-busy': opening,
+        disabled: opening,
         onClick: async () => {
+          if (openingRef.current) return;
+          openingRef.current = true;
+          setOpening(true);
           try {
             if (typeof startSession === 'function') {
               const sessionId = await startSession();
@@ -2568,6 +2574,9 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
           } catch (error) {
             actions.setError(error instanceof Error ? error.message : String(error));
             console.error('[dc-agent] open failed:', error);
+          } finally {
+            openingRef.current = false;
+            setOpening(false);
           }
         },
         children: h('span', { className: 'dcAgentLauncherContent' }, h(DatabaseLogo), wide ? h('span', null, '数据清洗补全') : null),
@@ -2604,11 +2613,6 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
       authorization_required: '待连接企查查', cancelled: '已取消', parse_failed: '解析失败',
     };
 
-    function ProductHome() {
-      return h('p', { className: 'dcAgentHomeSummary' },
-        '导入企业名单或图片，核验主体、补全字段，并导出可追溯结果。');
-    }
-
     function workflowNavigationIssue(step, task, hasData, profile, qccRun, hasLocalResult = false) {
       if (['upload', 'history'].includes(step)) return null;
       if (step === 'download' && task?.artifacts?.length) return null;
@@ -2744,8 +2748,6 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
       const changedMarks = new Map();
       const changedRows = new Map();
       const ownedLogos = new Map();
-      const hiddenForeignDocks = new Map();
-      const composerStack = marker?.parentElement?.parentElement;
       // 单一会话所有权由入口 enabled 与真实宿主 data-phase=hero 共同保证，
       // 与 React effect 生命周期共同保证：非清洗会话不会挂载，会话切换即走 cleanup 让位。
       // 有界同步：每次 fix 的 DOM 变更计入校正预算，达到上限即断开观察器，杜绝与其它插件互相改写的死循环。
@@ -2763,7 +2765,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
           ?? hero.querySelector?.('[class*="headlineText"]');
         const badge = spans.find((element) => element.dataset?.dcAgentHeroBadge === 'true')
           ?? spans.find((element) => ['预览版', 'Preview'].includes(element.textContent?.trim()));
-        if (title) {
+        if (title && ['数据清洗补全智能体', '探索未至之境', '探索未知之境', 'Into the Unknown'].includes(title.textContent?.trim())) {
           if (!changedTitles.has(title)) changedTitles.set(title, title.textContent ?? '');
           title.dataset.dcAgentHeroTitle = 'true';
           if (title.textContent !== '数据清洗补全智能体') { title.textContent = '数据清洗补全智能体'; mutated = true; }
@@ -2791,28 +2793,12 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
             }
           }
         }
-        if (badge) {
+        if (badge && title?.dataset?.dcAgentHeroTitle === 'true') {
           if (!changedBadges.has(badge)) changedBadges.set(badge, badge.style?.display ?? '');
           badge.dataset.dcAgentHeroBadge = 'true';
           if (badge.style && badge.style.display !== 'none') { badge.style.display = 'none'; mutated = true; }
         }
 
-        const foreignSurfaces = composerStack?.querySelectorAll?.('[aria-label="尽调类型"], .qccDock') ?? [];
-        for (const foreignSurface of foreignSurfaces) {
-          let hideTarget = foreignSurface;
-          while (hideTarget?.parentElement
-            && hideTarget.parentElement !== composerStack
-            && hideTarget.parentElement !== marker.parentElement) {
-            hideTarget = hideTarget.parentElement;
-          }
-          // DSH 的 list slot 可能把多个插件放进同一个 data-slot 容器。此时只能隐藏
-          // 对方自己的根节点，不能隐藏共享 slot；独立 host 则隐藏其直接容器。
-          if ((hideTarget?.parentElement === composerStack || hideTarget?.parentElement === marker.parentElement)
-            && !hideTarget.contains?.(marker)) {
-            if (!hiddenForeignDocks.has(hideTarget)) hiddenForeignDocks.set(hideTarget, hideTarget.style?.display ?? '');
-            if (hideTarget.style && hideTarget.style.display !== 'none') { hideTarget.style.display = 'none'; mutated = true; }
-          }
-        }
         if (mutated) {
           corrections += 1;
           if (corrections >= MAX_HERO_CORRECTIONS && observer) {
@@ -2842,9 +2828,6 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
           if (badge.style) badge.style.display = originalDisplay;
           delete badge.dataset.dcAgentHeroBadge;
         }
-        for (const [foreignDock, originalDisplay] of hiddenForeignDocks) {
-          if (foreignDock.style) foreignDock.style.display = originalDisplay;
-        }
       };
     }
 
@@ -2895,7 +2878,6 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
       },
         dependencyMessage ? h('p', { className: 'dcAgentError', role: 'alert' }, dependencyMessage) : null,
         menuMount ? reactDom.createPortal(h(CapabilityBar, { sessionId }), menuMount) : h(CapabilityBar, { sessionId }),
-        hero ? h(ProductHome, { sessionId }) : null,
       );
     }
 
@@ -3872,7 +3854,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
             const taskId = workflowTaskBySession.get(key)?.id || (/^dcw-[a-zA-Z0-9-]+$/.test(saved || '') ? saved : null);
             if (taskId) await refreshHostedTask(actions, activeSessionId, taskId, null, false);
           }).catch((taskError) => {
-            if (!disposed) actions.setError(taskError instanceof Error ? taskError.message : String(taskError));
+            if (!disposed) actions.setError(`状态同步异常：${taskError instanceof Error ? taskError.message : String(taskError)}。保留最近任务记录，未重新执行查询。`);
           });
         }
         return () => { disposed = true; };
@@ -3890,7 +3872,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
             if (!task) return;
             if (['matching', 'enriching'].includes(task.state)) timer = setTimeout(poll, 2000);
             else if (step === 'match' || step === 'enrich') actions.setStep(task.stage || step);
-          } catch (error) { if (!disposed) actions.setError(error.message); }
+          } catch (error) { if (!disposed) actions.setError(`状态同步异常：${error.message}。保留最近任务记录，未重新执行查询。`); }
         };
         timer = setTimeout(poll, 2000);
         return () => { disposed = true; clearTimeout(timer); };
@@ -4831,8 +4813,9 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
           ) : null,
           h('div', { className: 'dcAgentWbBody' },
             cachedTask && step !== 'history' ? h('section', { className: 'dcAgentSection', 'aria-label': '当前任务进展', 'aria-live': 'polite' },
-              h('b', null, cachedTask.source?.type === 'image' && cachedTask.state === 'draft' ? '图片已暂存，待识别' : WORKFLOW_STATE_LABELS[cachedTask.state] || cachedTask.state),
+              h('b', null, cachedTask.source?.type === 'image' && cachedTask.state === 'draft' ? '图片已暂存，待识别' : `任务记录：${WORKFLOW_STATE_LABELS[cachedTask.state] || '状态未知'}`),
               h('h3', null, workflowDisplayName(cachedTask)),
+              ['matching', 'enriching'].includes(cachedTask.state) ? h('p', { className: 'dcAgentHint' }, '以上为最近同步的任务记录，不代表模型仍在运行。若会话已停止，请查看原会话的确认或错误提示；不要重复启动。') : null,
               h('details', null, h('summary', null, '任务详情'), h('p', { className: 'dcAgentHint' }, `任务编号：${cachedTask.id}`)),
               h('p', null, `${cachedTask.source?.type === 'image' ? '图片识别' : cachedTask.source?.type === 'text' ? '粘贴名单' : cachedTask.source ? '上传表格' : '待选择数据来源'}${cachedTask.source?.fileName ? ' · ' + cachedTask.source.fileName : ''} · ${cachedTask.source?.type === 'image' && cachedTask.state === 'draft' ? '条目数待识别' : `${cachedTask.source?.rowCount || 0} 条`} · ${cachedTask.fieldSelection?.length || 0} 个补全字段`),
               commandProgress?.taskId === cachedTask.id && Number.isFinite(commandProgress.totalUnique) ? h('p', null, `已处理主体 ${commandProgress.completedUnique}/${commandProgress.totalUnique}（去重后，含未匹配或失败，不代表补全成功）`) : null,
@@ -5239,7 +5222,6 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
       visibleCatalogFields,
       installCapabilityMount,
       PromptDialog,
-      ProductHome,
       workflowNavigationIssue,
       buildTaskPrompt,
       DatasetReview,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-data-cleaning-agent",
-  "version": "0.9.11",
+  "version": "0.9.12",
   "description": "Data cleaning and data enrichment for CSV/XLSX/JSON enterprise lists in DeepSeek Harness, including spreadsheet cleaning, deduplication, profiling, optional Qichacha MCP and exports.",
   "type": "module",
   "main": "lib/index.js",
@@ -21,6 +21,8 @@
     "marketing",
     "docs/USER-GUIDE.md",
     "docs/RELEASE-0.9.11.md",
+    "docs/RELEASE-0.9.12.md",
+    "docs/UNIFIED-HOME-1.5.4-ADOPTION.md",
     "docs/FIRST-CONTRIBUTION.md",
     "docs/COMPATIBILITY.md",
     "docs/UI-V1.5.0-ADOPTION.md",