dsh-data-cleaning-agent 0.8.21 → 0.8.22

package/CHANGELOG.md

@@ -4,6 +4,14 @@
 
 ## [Unreleased]
 
+## [0.8.22] - 2026-09-09
+
+- 表格预览保留可读列宽、横向滚动和固定表头，避免多列挤压成竖排。
+- 结果文件操作分行并留白，长文件名换行；失败计数单独展示，避免零补全被标绿。
+- 失败行导出保留规范化错误码和工具名，不输出原始上游响应或凭据。
+- 修复自动展开后关闭／切换会话时，排队中的尺寸回调重新写入布局留白的竞态。
+- 延续 0.8.21 的实际 Host 文件地址和执行自动展开功能。
+
 ## [0.8.21] - 2026-09-09
 
 - 从实际 Host 请求获取文件地址的协议和主机；修复本地 HTTP 链接被补成 HTTPS 的问题。

package/README.en.md

@@ -8,7 +8,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.8.21** (stable release)
+> Current source version / 当前源码版本: **0.8.22** (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.
 

package/README.md

@@ -1,13 +1,13 @@
 # dsh-data-cleaning-agent
 
-本版统一向导与工作台的 Host 执行闭环：发送后自动生成新 Excel，原文件不修改，工作台入口可恢复；发布记录见 [发布说明](docs/RELEASE-0.8.21.md)。
+本版统一向导与工作台的 Host 执行闭环：发送后自动生成新 Excel，原文件不修改，工作台入口可恢复；发布记录见 [发布说明](docs/RELEASE-0.8.22.md)。
 
 ## 安装与三分钟上手
 
 数据清洗补全智能体：面向 Excel/CSV/JSON 企业名单，提供数据清洗、表格清洗、清洗补全、去重、企业数据补全与字段补全，支持企查查 MCP 和结果导出。
 
 ```sh
-dsh plugin --profile web add dsh-data-cleaning-agent@0.8.21
+dsh plugin --profile web add dsh-data-cleaning-agent@0.8.22
 ```
 
 请先满足下文的 DSH、连接器及侧边栏依赖要求；安装后完整停止并重启对应 Profile。
@@ -25,7 +25,7 @@ dsh plugin --profile web add dsh-data-cleaning-agent@0.8.21
 
 > 在 DeepSeek Harness 中清洗、补全、画像企业名单数据的智能体插件：本地 CSV/XLSX/JSON 引擎 + 可选企查查（Qichacha/QCC）MCP 企业数据补全，由企查查（Qichacha/QCC）团队发起并维护。
 >
-> 当前源码版本 / Current source version: **0.8.21**（正式版本）
+> 当前源码版本 / Current source version: **0.8.22**（正式版本）
 
 本版上传表格后展示完整清单及空白数量，用绿色、琥珀色、红色及文字区分已通过、待确认和未匹配映射。已映射字段自动纳入补全范围，额外字段默认折叠；多个原列可经确认使用同一非主体字段，分别补空并保留非空原值。修复 Host 草稿重置为默认五字段的问题，增加前后端版本错配提示。生成说明不查询，发送才执行；升级后需完整重启 DSH，历史下载文件不自动改写。
 

package/docs/RELEASE-0.8.22.md

@@ -0,0 +1,11 @@
+# 0.8.22 发布说明
+
+包含 0.8.21 的实际 Host 协议文件链接与执行自动展开功能；额外修复尺寸回调在工作台关闭后写回留白的竞态。
+
+- 表格不压缩列宽，支持左右滚动；纵向滚动固定表头。
+- 预览和下载操作分行留白，长文件名不再挤压按钮。
+- 单独显示失败数量；失败行在异常清单保留规范化错误码和工具名。
+
+本次不改变企查查查询范围，不自动重跑历史任务；历史异常文件不会补写已遗漏的错误信息。
+
+升级后完整重启 DSH。历史错误链接文本不会重写，可从工作台访问原有文件，不需要重新查询。

package/lib/client.js

@@ -89,19 +89,27 @@ window.__ModuleLoader__.load({
       const handle = drawer.querySelector('.dcAgentResizeHandle');
       if (!handle || !view) return () => {};
       const reservations = new Map();
+      const registryKey = Symbol.for('dsh.data-cleaning.sizing-reservations');
+      const registry = doc[registryKey] || (doc[registryKey] = new WeakMap());
+      let disposed = false;
       let requested = expanded ? 980 : preferredWidth;
       let current = 0;
       let drag = null;
       const boundsForView = () => workbenchWidthBounds(view.innerWidth,
         doc.querySelector('[data-conversation-scroll]')?.getBoundingClientRect().width || view.innerWidth);
       const reserve = () => {
+        if (disposed) return;
         const width = boundsForView().mobile ? 0 : drawer.getBoundingClientRect().width;
         for (const el of doc.querySelectorAll('[data-conversation-scroll]')) {
           if (!reservations.has(el)) {
-            reservations.set(el, {
+            const previous = registry.get(el) || {
               value: el.style.getPropertyValue('--dc-agent-workbench-reserve'),
               priority: el.style.getPropertyPriority('--dc-agent-workbench-reserve'),
-            });
+              owners: 0,
+            };
+            previous.owners += 1;
+            registry.set(el, previous);
+            reservations.set(el, previous);
             sizeObserver?.observe(el, { box: 'border-box' });
           }
           if (el.style.getPropertyValue('--dc-agent-workbench-reserve') !== `${width}px`) {
@@ -110,6 +118,7 @@ window.__ModuleLoader__.load({
         }
       };
       const apply = (value) => {
+        if (disposed) return;
         const bounds = boundsForView();
         const fallback = view.innerWidth <= 1040 ? Math.min(420, view.innerWidth * .48) : Math.min(460, view.innerWidth * .42);
         current = Math.round(Math.min(bounds.max, Math.max(bounds.min, Number.isFinite(value) ? value : fallback)));
@@ -173,6 +182,7 @@ window.__ModuleLoader__.load({
       observer?.observe(doc.body, { childList: true, subtree: true });
       apply(requested);
       return () => {
+        disposed = true;
         cancel();
         observer?.disconnect();
         sizeObserver?.disconnect();
@@ -188,6 +198,9 @@ window.__ModuleLoader__.load({
         drawer.style.removeProperty('--dc-agent-panel-width');
         delete drawer.dataset.narrow;
         for (const [el, previous] of reservations) {
+          previous.owners -= 1;
+          if (previous.owners > 0) continue;
+          registry.delete(el);
           if (previous.value) el.style.setProperty('--dc-agent-workbench-reserve', previous.value, previous.priority);
           else el.style.removeProperty('--dc-agent-workbench-reserve');
         }
@@ -970,6 +983,25 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
 }
 .dcAgentFieldAction:hover, .dcAgentFieldAction:focus-visible { background: var(--dc-selected); }
 .dcAgentPreviewTable { margin-top: 12px; overflow: auto; border: 1px solid var(--dc-border); border-radius: 8px; }
+    .dcAgentArtifactList { display: flex; flex-wrap: wrap; gap: 10px; margin-top: 16px; min-width: 0; }
+    .dcAgentArtifactList > .dcAgentButton { display: inline-flex; align-items: center; box-sizing: border-box; max-width: 100%; min-width: 0; height: auto; white-space: normal; overflow-wrap: anywhere; line-height: 1.5; text-decoration: none; }
+    .dcAgentArtifactList > a.dcAgentButton { flex-basis: 100%; }
+    .dcAgentPreviewTable { min-width: 0; max-width: 100%; scrollbar-gutter: stable; }
+.dcAgentPreviewTable > .dcAgentTable {
+  width: max-content; min-width: 100%; max-width: none;
+  table-layout: auto; border-collapse: separate; border-spacing: 0;
+}
+.dcAgentPreviewTable > .dcAgentTable th,
+.dcAgentPreviewTable > .dcAgentTable td {
+  min-width: 140px; max-width: none; white-space: nowrap;
+  word-break: normal; overflow-wrap: normal;
+  border-right: 1px solid var(--dc-border);
+}
+.dcAgentPreviewTable > .dcAgentTable th:first-child,
+.dcAgentPreviewTable > .dcAgentTable td:first-child { min-width: 64px; }
+.dcAgentPreviewTable > .dcAgentTable th {
+  position: sticky; top: 0; z-index: 2; background: var(--dc-table-head);
+}
 .dcAgentHistoryTask { display: block; width: 100%; padding: 10px; text-align: left; }
 .dcAgentHistoryTask h3 { margin: 0; font-size: 12px; }
 /*
@@ -1863,10 +1895,11 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
     }
     function watchHostedCommand(actions, sessionId, command) {
       let openedForExecution = false;
+      const ownerVisible = () => typeof document === 'undefined' || [...document.querySelectorAll('.dcAgentExperience')].some(node => node.dataset.sessionId === sessionId);
       void waitForQccCommand(command.commandId, 1800, async (status) => {
         if (!status || status.state === 'prepared') return;
         await refreshHostedTask(actions, sessionId, command.taskId, null, true).catch(() => {});
-        if (!openedForExecution && isCleaningSession(sessionId) && workflowTaskBySession.get(String(sessionId))?.id === command.taskId) {
+        if (!openedForExecution && ownerVisible() && isCleaningSession(sessionId) && workflowTaskBySession.get(String(sessionId))?.id === command.taskId) {
           openedForExecution = true;
           openWorkbench(actions, workflowTaskBySession.get(String(sessionId))?.stage || 'match', sessionId);
         }
@@ -2185,6 +2218,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
     const WORKBENCH_DATASET_EVENT = 'dsh:data-cleaning-workbench-dataset';
     const WORKBENCH_DRAFT_EVENT = 'dsh:data-cleaning-workbench-draft';
     const WORKBENCH_PREPARE_EVENT = 'dsh:data-cleaning-workbench-prepare';
+    const WORKBENCH_OWNER_LEFT_EVENT = 'dsh:data-cleaning-workbench-owner-left';
 
     // session scope 不能复用 root scope 的 store handle。DSH 当前会分别物化 root/session
     // 插槽组件，因此以 document 事件跨 scope 通知；闭包引用仅作为无 DOM 测试降级。
@@ -2547,6 +2581,10 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
     function DataCleaningExperience(props) {
       const { sessionId, session: ownerSession } = props;
       const enabled = useCleaningSession(sessionId);
+      react.useEffect(() => {
+        if (!enabled) return undefined;
+        return () => document.dispatchEvent(new CustomEvent(WORKBENCH_OWNER_LEFT_EVENT, { detail: { sessionId } }));
+      }, [enabled, sessionId]);
       const hero = ownerSession?.composerPhase === 'blank';
       const [menuMount, setMenuMount] = react.useState(null);
       react.useEffect(() => {
@@ -3428,7 +3466,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
         h('p', { className: 'dcAgentHint', role: 'status' }, complete
           ? `共 ${total} 条，当前显示 ${total ? start + 1 : 0}–${Math.min(start + pageSize, total)} 条；共 ${columns.length} 列，可横向滚动。`
           : `完整清单尚未就绪：预期 ${expectedCount} 条，当前载入 ${total} 条。请等待同步；刷新后若仍缺失，请重新上传源文件。`),
-        h('div', { className: 'dcAgentPreviewTable', style: { overflow: 'auto', maxHeight: '420px' } },
+        h('div', { className: 'dcAgentPreviewTable', tabIndex: 0, role: 'region', 'aria-label': '表格预览，可横向和纵向滚动，表头固定', style: { overflow: 'auto', maxHeight: '420px' } },
           h('table', { className: 'dcAgentTable' },
             h('thead', null, h('tr', null, h('th', null, '序号'), columns.map((key) => h('th', { key }, resultFieldLabel(key))))),
             h('tbody', null, rows.slice(start, start + pageSize).map((row, index) => h('tr', { key: start + index },
@@ -3493,6 +3531,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
 
       react.useEffect(() => {
         rootWorkbenchActions = actions;
+        const handleOwnerLeft = () => actions.close();
         const handleOpen = (event) => {
           event?.preventDefault?.();
           const detail = event?.detail ?? {};
@@ -3545,6 +3584,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
         };
         if (typeof document !== 'undefined' && typeof document.addEventListener === 'function') {
           document.addEventListener(WORKBENCH_OPEN_EVENT, handleOpen);
+          document.addEventListener(WORKBENCH_OWNER_LEFT_EVENT, handleOwnerLeft);
           document.addEventListener(WORKBENCH_DATASET_EVENT, handleDataset);
           document.addEventListener(WORKBENCH_DRAFT_EVENT, handleDraft);
           document.addEventListener(WORKBENCH_PREPARE_EVENT, handlePrepare);
@@ -3552,6 +3592,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
         return () => {
           if (typeof document !== 'undefined' && typeof document.removeEventListener === 'function') {
             document.removeEventListener(WORKBENCH_OPEN_EVENT, handleOpen);
+            document.removeEventListener(WORKBENCH_OWNER_LEFT_EVENT, handleOwnerLeft);
             document.removeEventListener(WORKBENCH_DATASET_EVENT, handleDataset);
             document.removeEventListener(WORKBENCH_DRAFT_EVENT, handleDraft);
             document.removeEventListener(WORKBENCH_PREPARE_EVENT, handlePrepare);
@@ -4143,6 +4184,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
         ? (qccRun.summary?.ambiguous ?? 0) + (qccRun.summary?.fieldReview ?? 0)
         : cachedTask?.enrichmentSummary?.reviewRequired
           ?? cachedTask?.matchSummary?.reviewRequired;
+      const qccFailedCount = qccRun?.summary?.failed ?? cachedTask?.enrichmentSummary?.failed ?? cachedTask?.matchSummary?.failed ?? 0;
       const stat = (label, value, tone) => h('div', { className: 'dcAgentCard' },
         h('span', null, label),
         h('b', { className: tone ? `is-${tone}` : null }, displayStatValue(value))
@@ -4378,12 +4420,13 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
         const availableArtifacts = (cachedTask?.artifacts || []).filter(artifact => artifact.kind !== 'review' || artifact.rowCount > 0);
         const canCreateArtifacts = Boolean(exportRows()?.length) && ['rules_confirmed', 'diagnosed', 'export_ready', 'partial'].includes(cachedTask?.state);
         pane = h('div', { className: 'dcAgentPane' },
-          h('p', { className: 'dcAgentHint' }, '结果文件由 Host 保存；仅在有待核验记录时展示异常清单。任务或插件重启后，可从任务历史继续下载；无需再次调用企查查。'),
+          h('p', { className: 'dcAgentHint' }, '结果文件由 Host 保存；有失败、未匹配或待核验记录时展示异常清单。任务或插件重启后，可从任务历史继续下载；无需再次调用企查查。'),
           h('div', { className: 'dcAgentGrid' },
             stat('输入行数', dataset ? dataset.rowCount : workflowTask?.source?.rowCount ?? '—'),
             stat('匹配补全', qccEnrichedCount, qccEnrichedCount > 0 ? 'good' : null),
             stat('待核验', qccReviewCount, qccReviewCount > 0 ? 'warn' : null),
             stat('任务状态', WORKFLOW_STATE_LABELS[cachedTask?.state] || cachedTask?.state || '进行中'),
+            stat('失败', qccFailedCount, qccFailedCount > 0 ? 'bad' : null),
           ),
           availableArtifacts.length ? h('div', { className: 'dcAgentArtifactList' },
             availableArtifacts.filter(artifact => artifact.format === 'xlsx').map(artifact => h('a', {
@@ -4560,8 +4603,8 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
                 max: commandProgress.totalUnique, value: Math.min(commandProgress.totalUnique, Math.max(0, commandProgress.completedUnique || 0)),
                 'aria-label': '主体处理进度', style: { width: '100%', accentColor: cachedTask.state === 'completed' ? '#16845b' : cachedTask.state === 'failed' ? '#c62828' : cachedTask.state === 'partial' ? '#a66a00' : '#087dcc' },
               }) : null,
-              h('p', { style: { color: Number(qccReviewCount) > 0 ? '#a66a00' : Number.isFinite(qccEnrichedCount) ? '#16845b' : 'inherit' } },
-                Number.isFinite(qccEnrichedCount) ? `已处理并补全 ${qccEnrichedCount} 条 · 待核验 ${Number.isFinite(qccReviewCount) ? qccReviewCount : '统计中'} 条（按输入行统计；未披露字段保留空白）` : '结果统计中，处理结束后展示补全与待核验数量'),
+              h('p', { style: { color: qccFailedCount > 0 ? '#c62828' : Number(qccReviewCount) > 0 ? '#a66a00' : qccEnrichedCount > 0 ? '#16845b' : 'inherit' } },
+                Number.isFinite(qccEnrichedCount) ? `已处理并补全 ${qccEnrichedCount} 条 · 待核验 ${Number.isFinite(qccReviewCount) ? qccReviewCount : '统计中'} 条 · 失败 ${qccFailedCount} 条（按输入行统计；未披露字段保留空白）` : '结果统计中，处理结束后展示补全与待核验数量'),
             ) : null,
             error ? h('div', { className: 'dcAgentError', role: 'alert' }, error) : null,
             step !== 'history' ? h('details', { className: 'dcAgentSection' },

package/lib/qcc.js

@@ -1074,7 +1074,11 @@ export class QccHostBridge {
           ...(result.fieldIssues ? { qcc_field_notes: Object.entries(result.fieldIssues).filter(([, issue]) => issue.reviewRequired === false).map(([field, issue]) => field + ': ' + issue.message).join('；') } : {}),
         };
       }
-      return { ...row, qcc_match_status: result?.status ?? 'failed' };
+      return {
+        ...row, qcc_match_status: result?.status ?? 'failed',
+        // Only export normalized diagnostic identifiers, never raw upstream messages or credentials.
+        ...(result?.error ? { qcc_error: [result.error.code, result.error.toolName, result.error.upstreamCode].filter(Boolean).join(' · ') } : {}),
+      };
     });
 
     const indexesFor = (name) => normalized.filter((item) => item.companyName === name).map((item) => item.index);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-data-cleaning-agent",
-  "version": "0.8.21",
+  "version": "0.8.22",
   "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",
@@ -40,7 +40,7 @@
     "docs/RELEASE-0.8.1.md",
     "docs/RELEASE-0.8.16.md",
     "docs/RELEASE-0.8.17.md",
-    "docs/RELEASE-0.8.21.md",
+    "docs/RELEASE-0.8.22.md",
     "docs/TEMPLATE-MAPPING-ACCEPTANCE.md",
     "docs/UI-WORKFLOW-V2.md",
     "docs/UI-WORKFLOW-V2-MIGRATION.md",

package/docs/RELEASE-0.8.21.md

@@ -1,9 +0,0 @@
-# 0.8.21 发布说明
-
-文件预览与下载地址使用实际请求的协议、主机，不硬编码 HTTPS 或端口；工具结果卡片接受同源完整地址。
-
-检测已暂存任务开始执行后自动展开右侧工作台一次，切到当前处理步骤。生成说明不会提前打开，用户关闭后同一监听不会重复打开。
-
-验证：246 项测试及 10 组浏览器回归。未重新执行付费查询，未修改上传文件。
-
-升级后完整重启 DSH，并重新生成后续任务说明。历史对话中的错误 HTTPS 文本链接不会被改写，可通过工作台打开历史文件。