dsh-data-cleaning-agent 0.9.9 → 0.9.10

package/CHANGELOG.md

@@ -4,6 +4,12 @@
 
 ## [Unreleased]
 
+## [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,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.9** (stable release)
+> Current source version / 当前源码版本: **0.9.10** (stable release)
+
+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.10
 ```
 
 请先满足下文的 DSH、连接器及侧边栏依赖要求；安装后完整停止并重启对应 Profile。
@@ -27,7 +27,9 @@ 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.10**（正式版本）
+
+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.10.md

@@ -0,0 +1,24 @@
+# 0.9.10 · Delayed home branding
+
+## Scope
+
+Preserves 0.9.9 sibling-branch compatibility and 0.9.8 Session ownership. Adds observation
+of Host settling-to-hero layout transitions and headline text-node updates. The home displays
+the blue database logo plus “数据清洗补全智能体”. Both Chinese Host headline variants work.
+Unknown layout never falls back to rewriting document.body. Cleanup restores native branding.
+
+## Verification and boundary
+
+Node regression covers delayed mounting, text refresh, reversible cleanup and ordinary-session
+isolation. Real React/Chromium matrix exercises settling-to-hero before checking logo placement,
+light/dark responsive layouts and active/ordinary Session transitions. Existing workflow tests
+remain mandatory. Run npm run check and npm run test:ui before release.
+
+The live localhost DSH tab still requires authentication; no live-host success is claimed.
+After upgrading/restarting, click 数据清洗补全, confirm logo/title, then switch to an ordinary
+Session and confirm native branding. No paid MCP, OCR or production data is used in tests.
+
+## Publishing
+
+Use PR/main CI gates before annotated v0.9.10, existing GitHub OIDC/provenance workflow,
+then registry version/gitHead and tarball read-back. Rollback: 0.9.9 (may miss delayed hero).

package/lib/client.js

@@ -2722,18 +2722,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();
@@ -2750,10 +2751,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 +2821,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();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-data-cleaning-agent",
-  "version": "0.9.9",
+  "version": "0.9.10",
   "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.10.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.