dsh-data-cleaning-agent 0.9.10 → 0.9.11

package/CHANGELOG.md

@@ -4,6 +4,11 @@
 
 ## [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 与标题替换被跳过的问题；监听宿主阶段及文本节点变化，显示“数据清洗补全智能体”。

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.10** (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.
 

package/README.md

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

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));
     }
 
     /**
@@ -2743,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;
@@ -2845,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);
@@ -2854,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;
@@ -5248,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.10",
+  "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.10.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.10.md

@@ -1,24 +0,0 @@
-# 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).