dsh-data-cleaning-agent 0.9.9 → 0.9.11

package/CHANGELOG.md

@@ -4,6 +4,17 @@
 
 ## [Unreleased]
 
+## [0.9.11] - 2026-09-13
+
+- 修正真实 Host 首页判断：Session 并不提供 composerPhase；改为观察当前清洗会话 DOM 的真实 data-phase，确保标题替换实际启用。
+- 回归夹具移除虚构 composerPhase 字段，覆盖 settling/hero/active、普通会话隔离与卸载恢复。
+
+## [0.9.10] - 2026-09-13
+
+- 修复首页先挂载于 settling 阶段导致 Logo 与标题替换被跳过的问题；监听宿主阶段及文本节点变化，显示“数据清洗补全智能体”。
+- 兼容“探索未知之境”文案，保留 0.9.9 同级标题分支适配；不再降级到 document.body 全局改写。
+- 新增延迟 Hero 挂载、标题刷新和离开会话恢复回归；真实 DSH 页面仍需登录后验收。
+
 ## [0.9.9] - 2026-09-13
 
 - 原生首页标题桥接适配新版 Host 的 composer sibling slot；菜单进入数据清洗补全后稳定显示“数据清洗补全智能体”，不再回退为“探索未至之境”。

package/README.en.md

@@ -10,7 +10,11 @@ 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.9** (stable release)
+> Current source version / 当前源码版本: **0.9.11** (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.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.
 
 0.9.9 restores the “数据清洗补全智能体” native home title when newer Host builds place the plugin marker and Hero headline in sibling composer branches. The bridge remains reversible and isolated from other business plugins. The 0.9.8 read-only Profile history and origin Workspace/Session guarantees remain unchanged. Rollback: `dsh plugin --profile web add dsh-data-cleaning-agent@0.9.8`. Live DSH A/B verification remains a post-install user check.
 

package/README.md

@@ -9,7 +9,7 @@
 数据清洗补全智能体：面向 Excel/CSV/JSON 企业名单，提供数据清洗、表格清洗、清洗补全、去重、企业数据补全与字段补全，支持企查查 MCP 和结果导出。
 
 ```sh
-dsh plugin --profile web add dsh-data-cleaning-agent@0.9.9
+dsh plugin --profile web add dsh-data-cleaning-agent@0.9.11
 ```
 
 请先满足下文的 DSH、连接器及侧边栏依赖要求；安装后完整停止并重启对应 Profile。
@@ -27,7 +27,11 @@ dsh plugin --profile web add dsh-data-cleaning-agent@0.9.9
 
 > 在 DeepSeek Harness 中清洗、补全、画像企业名单数据的智能体插件：本地 CSV/XLSX/JSON 引擎 + 可选企查查（Qichacha/QCC）MCP 企业数据补全，由企查查（Qichacha/QCC）团队发起并维护。
 >
-> 当前源码版本 / Current source version: **0.9.9**（正式版本）
+> 当前源码版本 / Current source version: **0.9.11**（正式版本）
+
+0.9.11 修正真实 Host 的首页状态接口：不再依赖 Session.composerPhase，按当前清洗会话所在宿主根节点的 data-phase 显示 Logo 与标题，并在离开首页时恢复。
+
+0.9.10 补齐首页 settling → hero 阶段监听，避免首次挂载漏掉 Logo 与标题替换；兼容“探索未知之境”，未知结构不做全局标题改写。回滚版本为 0.9.9。
 
 0.9.9 修复新版 Host composer sibling slot 下的原生首页标题定位，进入数据清洗补全后稳定显示“数据清洗补全智能体”，并保持对其它业务插件的标题隔离。0.9.8 的 Profile 历史只读、来源工作区/会话校验与旧记录边界全部保留。回滚：`dsh plugin --profile web add dsh-data-cleaning-agent@0.9.8`。真实 DSH A/B 验收仍以安装后的用户验证为准，详见发布说明。
 

package/docs/RELEASE-0.9.11.md

@@ -0,0 +1,18 @@
+# 0.9.11 · Real Host home phase
+
+The real DSH Session snapshot does not expose composerPhase. Versions 0.9.9/0.9.10
+adapted the DOM rewrite but its caller never enabled it. The former React fixture
+supplied that nonexistent property and masked the integration bug.
+
+The cleaning experience now observes data-phase on its own marker's closest Host
+root. It never derives the phase from input text or other Sessions. Unknown or active
+roots are not treated as home. The observer disconnects on Session changes/unmount.
+Hero changes retain the existing reversible logo/title behavior.
+
+Session-scoped factories can also mount after the root ownership event. Restore
+ownership from the explicit independently-created cleaning Session namespace;
+never infer it from another Session, a task history selection or draft text.
+
+Tests must omit composerPhase, cover settling/hero/active and ordinary Session cleanup.
+Real logged-in DSH visual acceptance and final registry evidence are recorded in Release notes.
+No paid QCC/OCR calls are needed for branding acceptance. Rollback: 0.9.10 (known title bug).

package/lib/client.js

@@ -1530,6 +1530,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
         isCleaningSession(sessionId) ? sessionId : null,
       );
       react.useEffect(() => {
+        setMarkedSessionId(isCleaningSession(sessionId) ? sessionId : null);
         const handleMarked = (event) => {
           const detail = event?.detail ?? {};
           setMarkedSessionId(detail.active === true && detail.sessionId === sessionId ? sessionId : null);
@@ -1539,7 +1540,9 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
       }, [sessionId]);
       // DSH 可能复用同一个 slot component 切换会话；状态必须绑定具体 sessionId，
       // 避免从清洗会话切回普通会话后仍残留业务首页与提示词入口。
-      return markedSessionId === sessionId && isCleaningSession(sessionId);
+      // Session-scoped slot factories can mount after the root ownership event.
+      // Our independently-created namespace is durable ownership, unlike a draft.
+      return ownedSessionId(sessionId) || (markedSessionId === sessionId && isCleaningSession(sessionId));
     }
 
     /**
@@ -2722,18 +2725,19 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
         if (!scope?.querySelectorAll) return false;
         const spans = [...scope.querySelectorAll('span')];
         return spans.some((element) => element.dataset?.dcAgentHeroTitle === 'true'
-          || ['探索未至之境', 'Into the Unknown'].includes(element.textContent?.trim()))
+          || ['探索未至之境', '探索未知之境', 'Into the Unknown'].includes(element.textContent?.trim()))
           || Boolean(scope.querySelector?.('[class*="headlineText"]'));
       };
       // 新版 Host 会把 list slot 放在 composer seat 的独立分支；marker 不一定再是
       // data-phase=hero 的后代。沿祖先寻找同时包含原生标题的最小范围，保留旧结构兼容。
-      let hero = marker?.closest?.('[data-phase="hero"]') ?? null;
+      // Observe the same root while Host layout transitions from settling to hero.
+      let hero = marker?.closest?.('[data-phase="hero"]')
+        ?? marker?.closest?.('[data-phase="settling"]') ?? null;
       if (!hasHeadline(hero)) {
         let scope = marker?.closest?.('[data-composer-seat]') ?? marker?.parentElement ?? null;
-        while (scope && !hasHeadline(scope)) scope = scope.parentElement;
-        if (scope) hero = scope;
+        while (scope && scope !== document.body && scope !== document.documentElement && !hasHeadline(scope)) scope = scope.parentElement;
+        if (scope && scope !== document.body && scope !== document.documentElement) hero = scope;
       }
-      if (!hero && document.body?.querySelectorAll) hero = document.body;
       if (!hero) return () => {};
       const changedTitles = new Map();
       const changedBadges = new Map();
@@ -2742,7 +2746,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
       const ownedLogos = new Map();
       const hiddenForeignDocks = new Map();
       const composerStack = marker?.parentElement?.parentElement;
-      // 单一会话所有权由入口的 enabled 参数（useCleaningSession(sessionId) && composerPhase==='blank'）
+      // 单一会话所有权由入口 enabled 与真实宿主 data-phase=hero 共同保证，
       // 与 React effect 生命周期共同保证：非清洗会话不会挂载，会话切换即走 cleanup 让位。
       // 有界同步：每次 fix 的 DOM 变更计入校正预算，达到上限即断开观察器，杜绝与其它插件互相改写的死循环。
       const MAX_HERO_CORRECTIONS = 8;
@@ -2750,10 +2754,12 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
       let observer = null;
 
       const fix = () => {
+        if (hero.getAttribute?.('data-phase') === 'settling') return;
+        if (hero.getAttribute?.('data-phase') === 'active') return;
         let mutated = false;
         const spans = [...hero.querySelectorAll('span')];
         const title = spans.find((element) => element.dataset?.dcAgentHeroTitle === 'true')
-          ?? spans.find((element) => ['探索未至之境', 'Into the Unknown'].includes(element.textContent?.trim()))
+          ?? spans.find((element) => ['探索未至之境', '探索未知之境', 'Into the Unknown'].includes(element.textContent?.trim()))
           ?? hero.querySelector?.('[class*="headlineText"]');
         const badge = spans.find((element) => element.dataset?.dcAgentHeroBadge === 'true')
           ?? spans.find((element) => ['预览版', 'Preview'].includes(element.textContent?.trim()));
@@ -2818,7 +2824,8 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
 
       fix();
       observer = typeof MutationObserver === 'function' ? new MutationObserver(fix) : null;
-      observer?.observe?.(hero, { childList: true, subtree: true });
+      observer?.observe?.(hero, { childList: true, subtree: true, characterData: true,
+        attributes: true, attributeFilter: ['data-phase'] });
       return () => {
         observer?.disconnect?.();
         for (const logo of ownedLogos.values()) logo.remove();
@@ -2841,6 +2848,22 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
       };
     }
 
+    function observeHomePhase(sessionId, enabled, onChange) {
+      onChange(false);
+      if (!enabled || typeof document === 'undefined') return () => {};
+      const marker = [...(document.querySelectorAll?.('.dcAgentExperience') || [])]
+        .find(node => node.dataset?.sessionId === sessionId);
+      // Session snapshots do not expose composerPhase. The Host's own rendered root
+      // is authoritative; never infer a blank conversation from draft text or title.
+      const root = marker?.closest?.('[data-phase]');
+      if (!root) return () => {};
+      const update = () => onChange(root.getAttribute('data-phase') === 'hero');
+      update();
+      const observer = typeof MutationObserver === 'function' ? new MutationObserver(update) : null;
+      observer?.observe(root, { attributes: true, attributeFilter: ['data-phase'] });
+      return () => observer?.disconnect();
+    }
+
     function DataCleaningExperience(props) {
       const { sessionId, session: ownerSession } = props;
       const enabled = useCleaningSession(sessionId);
@@ -2850,7 +2873,10 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
         document.addEventListener(DEPENDENCY_EVENT, listener);
         return () => document.removeEventListener(DEPENDENCY_EVENT, listener);
       }, [sessionId]);
-      const hero = ownerSession?.composerPhase === 'blank';
+      const [hero, setHero] = react.useState(false);
+      react.useEffect(() => observeHomePhase(sessionId, enabled,
+        value => setHero(current => current === value ? current : value)),
+      [sessionId, enabled, ownerSession?.openState]);
       const [menuMount, setMenuMount] = react.useState(null);
       react.useEffect(() => {
         if (!enabled) return undefined;
@@ -5244,6 +5270,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
       plainEntityListDataset,
       resultFieldLabel,
       rewriteHeroChrome,
+      observeHomePhase,
       ensureWorkflowTask,
       ensureEditableWorkflowTask,
       queueWorkflowOperation,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-data-cleaning-agent",
-  "version": "0.9.9",
+  "version": "0.9.11",
   "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",
@@ -20,7 +20,7 @@
     "install.sh",
     "marketing",
     "docs/USER-GUIDE.md",
-    "docs/RELEASE-0.9.9.md",
+    "docs/RELEASE-0.9.11.md",
     "docs/FIRST-CONTRIBUTION.md",
     "docs/COMPATIBILITY.md",
     "docs/UI-V1.5.0-ADOPTION.md",

package/docs/RELEASE-0.9.9.md

@@ -1,24 +0,0 @@
-# 0.9.9 · Native home title compatibility
-
-Status: stable release. Date: 2026-09-13.
-
-## Scope
-
-- Adapt the reversible native Hero title bridge to Host layouts where the plugin marker and headline live in sibling branches below the composer container.
-- Keep the data-cleaning home title fixed at “数据清洗补全智能体” without modifying another business plugin's headline, prompt UI or input focus.
-- Preserve the 0.9.8 Profile history ownership, origin Workspace/Session checks and artifact-download behavior.
-
-## Verification
-
-- The coexistence fixture now exercises a sibling-slot Host structure rather than the obsolete nested Hero structure.
-- `npm run check` covers syntax, documentation version consistency, marketing metadata, package allowlist and the full Node test suite.
-- The React/Chromium layout matrix remains a separate isolated UI gate; real DSH and production QCC Provider behavior require post-install acceptance.
-
-## Install and rollback
-
-```sh
-dsh plugin --profile web add dsh-data-cleaning-agent@0.9.9
-```
-
-Rollback package: `dsh plugin --profile web add dsh-data-cleaning-agent@0.9.8`.
-Do not move or overwrite existing tags or npm versions.