dsh-data-cleaning-agent 0.9.1 → 0.9.2

package/CHANGELOG.md

@@ -4,6 +4,13 @@
 
 ## [Unreleased]
 
+## [0.9.2] - 2026-09-10
+
+- Better Sidebar 改为可选 peer；缺失侧栏不阻断基础安装、原生会话和本地清洗/补全/画像工具。
+- 基础预检与 `--workbench` 预检分离；已安装的已知不兼容组合仍明确阻断。
+- 工作台缺失提示明确可用边界，保留草稿与任务，不创建私有抽屉。
+- 隔离真实 Host 验证无侧栏工具执行、兼容侧栏 XLSX 闭环及已知不兼容阻断；真实计费 MCP、OCR 与四产品共存不在本次验收范围。
+
 ## [0.9.1] - 2026-09-10
 
 - 新宿主 uiWorkspace 生命周期适配：新会话不再复用清洗空会话，普通草稿与菜单隔离。

package/README.en.md

@@ -1,6 +1,6 @@
 # dsh-data-cleaning-agent
 
-> 0.9.1 upgrade: the workbench now uses a Session-singleton Better Sidebar Tab, requiring `targetedOpen` and `stateSubscription`. Missing providers show an install/upgrade message, not a private drawer. See the [adoption and validation record](docs/UI-V1.5.0-ADOPTION.md).
+> 0.9.2 upgrade: Better Sidebar is an optional workbench dependency. Base tools and conversations remain available without it. The workbench requires `targetedOpen` and `stateSubscription`; no private drawer fallback is created. See the [compatibility record](docs/COMPATIBILITY.md).
 
 Data cleaning and data enrichment for CSV/XLSX/JSON enterprise lists in DeepSeek Harness, including spreadsheet cleaning, deduplication, profiling, optional Qichacha MCP and exports.
 
@@ -10,7 +10,7 @@ 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.1** (stable release)
+> Current source version / 当前源码版本: **0.9.2** (stable release)
 
 This release unifies spreadsheet previews, column mapping, and enrichment scope across the prompt wizard and workbench. Mapping statuses use color and text; mapped fields automatically enter the scope, with optional extra fields collapsed. Multiple confirmed output columns may share a non-identity field while preserving non-empty values. It fixes saved drafts resetting the scope to five defaults and detects stale Host versions. Preparing a draft does not query QCC; sending starts execution. Fully restart DSH after upgrading. Existing download artifacts are not rewritten.
 
@@ -72,7 +72,7 @@ temporary files. The local server uploads the explicitly submitted file to the Q
 Both use the current customer's own QCC account and quota. Without the local connector,
 image intake fails closed with actionable guidance; text and spreadsheet paths remain available.
 
-Check the complete DSH `0.1.2-rc.1` + Better Sidebar `0.18.1` combination first. Context is optional; an existing `0.36.0` installation must be upgraded to `0.48.0`. Preflight does not upgrade the global host or prove business acceptance.
+Better Sidebar is optional and is not automatically installed. Native conversations and the clean/complete/profile engine tools work without it; interactive import, mapping confirmation, workbench preview/export and navigation do not. Workbench entry explains the limitation without deleting drafts/tasks or creating a private drawer. For the workbench, use the tested DSH `0.1.2-rc.1` + Sidebar `0.18.1` pair; an exact optional peer is not a general compatibility claim. Existing incompatible sidebar installations still block preflight. Context is optional; an existing `0.36.0` must be upgraded to `0.48.0`. Use `node lib/install-preflight.js <profile> <dsh-executable> --workbench` for workbench checks; base checks permit a missing sidebar. Runtime capabilities are checked separately. No global host upgrades are performed.
 
 Run from a full checkout or unpacked npm package with the actual `dsh` CLI (streamed shell installation is no longer supported):
 

package/README.md

@@ -1,6 +1,6 @@
 # dsh-data-cleaning-agent
 
-> 0.9.1 升级说明：工作台已迁移到 Better Sidebar 的 Session 单例 Tab，需要兼容的 `dsh-better-sidebar`（`targetedOpen`、`stateSubscription`）。缺失时会提示安装/升级，不回退到自有抽屉；本轮验证边界见 [采用记录](docs/UI-V1.5.0-ADOPTION.md)。
+> 0.9.2 升级说明：Better Sidebar 是可选工作台依赖；缺失时基础工具和会话仍可用。工作台需要兼容的 `dsh-better-sidebar`（`targetedOpen`、`stateSubscription`），不回退到自有抽屉；验证边界见 [兼容记录](docs/COMPATIBILITY.md)。
 
 本版统一向导与工作台的 Host 执行闭环：发送后自动生成新 Excel，原文件不修改，工作台入口可恢复；发布记录见 [发布说明](docs/RELEASE-0.8.22.md)。
 
@@ -9,7 +9,7 @@
 数据清洗补全智能体：面向 Excel/CSV/JSON 企业名单，提供数据清洗、表格清洗、清洗补全、去重、企业数据补全与字段补全，支持企查查 MCP 和结果导出。
 
 ```sh
-dsh plugin --profile web add dsh-data-cleaning-agent@0.9.1
+dsh plugin --profile web add dsh-data-cleaning-agent@0.9.2
 ```
 
 请先满足下文的 DSH、连接器及侧边栏依赖要求；安装后完整停止并重启对应 Profile。
@@ -27,7 +27,7 @@ dsh plugin --profile web add dsh-data-cleaning-agent@0.9.1
 
 > 在 DeepSeek Harness 中清洗、补全、画像企业名单数据的智能体插件：本地 CSV/XLSX/JSON 引擎 + 可选企查查（Qichacha/QCC）MCP 企业数据补全，由企查查（Qichacha/QCC）团队发起并维护。
 >
-> 当前源码版本 / Current source version: **0.9.1**（正式版本）
+> 当前源码版本 / Current source version: **0.9.2**（正式版本）
 
 本版上传表格后展示完整清单及空白数量，用绿色、琥珀色、红色及文字区分已通过、待确认和未匹配映射。已映射字段自动纳入补全范围，额外字段默认折叠；多个原列可经确认使用同一非主体字段，分别补空并保留非空原值。修复 Host 草稿重置为默认五字段的问题，增加前后端版本错配提示。生成说明不查询，发送才执行；升级后需完整重启 DSH，历史下载文件不自动改写。
 
@@ -81,7 +81,9 @@ Composer 图片附件，因此不支持视觉输入的文本模型也能调度 A
 或分发凭据。本地服务会把用户明确提交的图片上传到企查查文档解析网关；未连接本地服务时功能会
 fail closed，并明确提示配置要求，文本与 Excel 流程不受影响。
 
-安装前请核验完整 DSH `0.1.2-rc.1` + Better Sidebar `0.18.1`。context 不是必装依赖；若已装 `0.36.0`，需先升级到 `0.48.0`。预检不会升级全局宿主，也不代表业务验收通过。
+基础安装不需要 Better Sidebar，也不会自动安装它。交互工作台才需要完整 DSH `0.1.2-rc.1` + 可选 Better Sidebar `0.18.1`；optional peer 的精确版本不代表其它配对均兼容。context 不是必装依赖；若已装 `0.36.0`，需先升级到 `0.48.0`。已安装不兼容侧栏仍会阻断预检。
+
+无侧栏可用：原生会话、`data_clean_rows`、`data_complete_rows`、`data_profile` 引擎工具。不可用：交互工作台的表格导入、映射确认、结果预览/下载及流程导航；点击入口显示原因并保留草稿/任务，不创建私有抽屉。不要把会话可打开等同于完整清洗流程可用。基础预检默认允许侧栏缺失；如需校验工作台安装，运行 `node lib/install-preflight.js <Profile目录> <dsh可执行文件> --workbench`，运行时再探测 capabilities。预检不会升级全局宿主。
 
 从完整源码或解压的 npm 包运行安装脚本（需要实际 `dsh` CLI；不再支持流式脚本）：
 

package/docs/COMPATIBILITY.md

@@ -1,5 +1,19 @@
 # 兼容性 / Compatibility
 
+## 0.9.2：可选侧栏验收
+
+Node v25.9.0，完整 DSH 0.1.2-rc.1；使用 npm pack 产物、独立 DSH_HOME 和端口，未修改生产 Profile 或调用计费 MCP。
+
+| 组合 | 实测结果 |
+| --- | --- |
+| 无 Sidebar / 无 context | 基础预检允许；Host 启动、原生会话、缺失提示及草稿保留通过。真实 tools.execute 执行 data_clean_rows、data_complete_rows、data_profile 合成数据成功。工作台不可用。 |
+| Sidebar 0.18.1 / context 0.48.0 | Host 与浏览器无 pageErrors；合成 XLSX 导入、映射确认、本地清洗/补全、导出回读、HTTP 预览及普通会话草稿通过。 |
+| Sidebar 0.17.1 | 基础预检仍阻断；隔离启动复现 settingsNamespace 缺失，不因 optional 忽略冲突。 |
+
+基础安装不强装侧栏；`--workbench` 模式在侧栏缺失时阻断，运行时另检 targetedOpen/stateSubscription。工具未发现 session.events/snapshotEvents 依赖，不套用其他产品补丁。无侧栏不支持交互导入、映射确认、结果预览下载与工作台导航，不等于完整工作流可用。
+
+验收脚本：scripts/host-no-sidebar-smoke.cjs、scripts/host-rc1-smoke.cjs。测试数据为合成数据；真实 QCC、OCR、多候选确认和四产品完整共存仍未验证。以下章节是历史版本证据，不覆盖这些未测能力。
+
 ## 0.9.0：Session 单例 Tab
 
 工作台通过可选 `ctx.inject(['betterSidebar'], ...)` 接入 Provider，探测 `targetedOpen` 与 `stateSubscription`；缺失时保留会话和 Host 工具，不提供私有抽屉回退。当前仅完成隔离模拟服务与 Chromium 回归，尚未实装组合验收；旧版本的 Host/UI 验证不自动覆盖此次迁移。详见 [采用记录](UI-V1.5.0-ADOPTION.md)。

package/install.sh

@@ -28,6 +28,7 @@ if [ ! -f "$SCRIPT_DIR/lib/install-preflight.js" ]; then
   exit 1
 fi
 node "$SCRIPT_DIR/lib/install-preflight.js" "$PROFILE_DIR"
+echo "==> 基础智能体安装：不会强制安装侧栏；交互工作台需兼容 Better Sidebar，可用 --workbench 单独预检。"
 
 # ── 1) 安装依赖 ──
 if command -v dsh >/dev/null 2>&1; then

package/lib/better-sidebar-adapter.js

@@ -1,6 +1,6 @@
 /** Public Better Sidebar seam. No business task creation, cancellation or geometry. */
 export const CLEANING_TAB_ID = 'dsh-data-cleaning-agent:workbench';
-export const SIDEBAR_DEPENDENCY_MESSAGE = '请安装或升级兼容的 dsh-better-sidebar 并重启 DSH（需要 targetedOpen 和 stateSubscription 能力），然后重新点击流程按钮。现有任务和文件不会删除。';
+export const SIDEBAR_DEPENDENCY_MESSAGE = '交互工作台暂不可用；基础清洗、规则补全、画像工具和原生会话仍可使用。启用工作台请安装或升级兼容的 dsh-better-sidebar 并重启 DSH（需要 targetedOpen 和 stateSubscription 能力），然后重新点击流程按钮。现有任务和文件不会删除。';
 
 export function sidebarCompatibility(service) {
   const methods = ['registerTab', 'openTab', 'isTabEnabled', 'getSnapshot', 'subscribeState'];

package/lib/client.js

@@ -4209,7 +4209,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
     // BEGIN generated Better Sidebar adapter (source: lib/better-sidebar-adapter.js)
     /** Public Better Sidebar seam. No business task creation, cancellation or geometry. */
     const CLEANING_TAB_ID = 'dsh-data-cleaning-agent:workbench';
-    const SIDEBAR_DEPENDENCY_MESSAGE = '请安装或升级兼容的 dsh-better-sidebar 并重启 DSH（需要 targetedOpen 和 stateSubscription 能力），然后重新点击流程按钮。现有任务和文件不会删除。';
+    const SIDEBAR_DEPENDENCY_MESSAGE = '交互工作台暂不可用；基础清洗、规则补全、画像工具和原生会话仍可使用。启用工作台请安装或升级兼容的 dsh-better-sidebar 并重启 DSH（需要 targetedOpen 和 stateSubscription 能力），然后重新点击流程按钮。现有任务和文件不会删除。';
 
     function sidebarCompatibility(service) {
       const methods = ['registerTab', 'openTab', 'isTabEnabled', 'getSnapshot', 'subscribeState'];

package/lib/install-preflight.js

@@ -5,7 +5,7 @@ import { createRequire } from 'node:module';
 import { fileURLToPath } from 'node:url';
 import { execFileSync } from 'node:child_process';
 
-export function assessCombination({ host, sidebar, context }) {
+export function assessCombination({ host, sidebar, context, workbench = false }) {
   const errors = [], warnings = [];
   if (host === '0.1.2-rc.1' && sidebar === '0.17.1') errors.push('DSH 0.1.2-rc.1 与 Better Sidebar 0.17.1 不兼容：缺少 settingsNamespace；请升级侧边栏到 0.18.1。');
   if (!host) errors.push('无法识别实际 DSH CLI 版本；请先安装完整 DSH，再重新预检。');
@@ -14,15 +14,15 @@ export function assessCombination({ host, sidebar, context }) {
       errors.push('Better Sidebar 0.18.1 不兼容此旧宿主。备份后由宿主管理者升级完整 @deepseek-ai/dsh@0.1.2-rc.1；不要只升级 Session 子包。');
     } else warnings.push('此宿主与 Better Sidebar 0.18.1 组合未验证。');
   }
-  if (!sidebar) errors.push('工作台需要 dsh-better-sidebar；目标 Profile 请安装 0.18.1（需完整 DSH 0.1.2-rc.1）。');
-  else if (sidebar !== '0.18.1') warnings.push('此侧边栏版本未验证；仍需 targetedOpen 和 stateSubscription 能力。');
+  if (!sidebar) (workbench ? errors : warnings).push('未安装可选 dsh-better-sidebar：基础引擎、工具与原生会话可用；交互工作台不可用。如需工作台，请配套安装 0.18.1 与完整 DSH 0.1.2-rc.1。');
+  else if (sidebar !== '0.18.1' && !(host === '0.1.2-rc.1' && sidebar === '0.17.1')) warnings.push('此侧边栏版本未验证；仍需 targetedOpen 和 stateSubscription 能力。');
   if (host === '0.1.2-rc.1' && context === '0.36.0') errors.push('已安装的 dsh-context 0.36.0 使用旧 settingsNamespace；先升级该插件到 0.48.0。context 并非本产品必装依赖。');
   else if (context && context !== '0.48.0') warnings.push('已安装的 context 版本尚未做共存验证。');
   if (host && host !== '0.1.2-rc.1' && !warnings.length && !errors.length) warnings.push('此宿主组合未验证。');
-  return { host, sidebar, context, errors, warnings, ok: errors.length === 0 };
+  return { host, sidebar, context, mode: workbench ? 'workbench' : 'base', errors, warnings, ok: errors.length === 0 };
 }
 
-export function inspectProfile(profile, host) {
+export function inspectProfile(profile, host, workbench = false) {
   const req = createRequire(resolve(profile, 'package.json'));
   const version = name => {
     let path;
@@ -33,16 +33,17 @@ export function inspectProfile(profile, host) {
       if (dirname(dir) === dir) return null;
     }
   };
-  return assessCombination({ host, sidebar: version('dsh-better-sidebar'), context: version('dsh-context') });
+  return assessCombination({ host, sidebar: version('dsh-better-sidebar'), context: version('dsh-context'), workbench });
 }
 
 if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
-  const profile = process.argv[2];
-  if (!profile) { console.error('Usage: node lib/install-preflight.js <profile-directory> [dsh-executable]'); process.exitCode = 2; }
+  const positional = process.argv.slice(2).filter(arg => arg !== '--workbench');
+  const profile = positional[0];
+  if (!profile) { console.error('Usage: node lib/install-preflight.js <profile-directory> [dsh-executable] [--workbench]'); process.exitCode = 2; }
   else {
     let host = null;
-    try { host = execFileSync(process.argv[3] || 'dsh', ['--version'], { encoding: 'utf8', timeout: 15000 }).match(/\b\d+\.\d+\.\d+(?:-[\w.]+)?\b/)?.[0] ?? null; } catch { /* reported below */ }
-    const report = inspectProfile(profile, host);
+    try { host = execFileSync(positional[1] || 'dsh', ['--version'], { encoding: 'utf8', timeout: 15000 }).match(/\b\d+\.\d+\.\d+(?:-[\w.]+)?\b/)?.[0] ?? null; } catch { /* reported below */ }
+    const report = inspectProfile(profile, host, process.argv.includes('--workbench'));
     console.log(JSON.stringify(report, null, 2));
     process.exitCode = report.ok ? 0 : 1;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-data-cleaning-agent",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "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",
@@ -123,11 +123,17 @@
     "xlsx": "^0.18.5"
   },
   "peerDependencies": {
+    "dsh-better-sidebar": "0.18.1",
     "@deepseek-ai/dsh-client-ui-conversation": "*",
     "@deepseek-ai/dsh-client-ui-layout": "*",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
+  "peerDependenciesMeta": {
+    "dsh-better-sidebar": {
+      "optional": true
+    }
+  },
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"