dsh-data-cleaning-agent 0.8.19 → 0.8.21

package/CHANGELOG.md

@@ -4,6 +4,21 @@
 
 ## [Unreleased]
 
+## [0.8.21] - 2026-09-09
+
+- 从实际 Host 请求获取文件地址的协议和主机；修复本地 HTTP 链接被补成 HTTPS 的问题。
+- 工具卡片支持同源完整文件地址，继续拒绝非同源链接。
+- 已确认任务开始执行时自动展开工作台一次并跟随处理步骤；生成说明不触发，关闭后不反复弹出。
+- 246 项测试及 10 组浏览器回归通过，无付费查询。
+
+## [0.8.20] - 2026-09-09
+
+- 普通无记录／未披露字段保留为无数据说明，尊重共享契约 reviewRequired=false，不再误计为待核验。
+- 当前任务刷新同步任务历史，拒绝旧版本历史摘要覆盖新状态。
+- 增加彩色主体处理进度条；结果计数未产生时显示统计中，避免 undefined。
+- 当前任务和历史复用文件名、行数、创建时间生成的展示名；任务编号收纳至详情。
+- 246 项测试与 10 组浏览器回归通过。旧任务结果不自动改写，不重复调用 QCC。
+
 ## [0.8.19] - 2026-09-09
 
 - 受益人与主营业务收入增加待确认候选，明确首条限制及财务口径差异，不自动替换。

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

package/docs/RELEASE-0.8.21.md

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

package/lib/artifacts.js

@@ -22,6 +22,7 @@ const SYSTEM_FIELD_LABELS = Object.freeze({
   risk_tags: '风险标签',
   qcc_match_status: '匹配状态',
   qcc_field_issues: '字段补全待核验原因',
+  qcc_field_notes: '字段无数据说明',
   qcc_source: '数据来源',
   qcc_snapshot_note: '取值口径与报告期',
   qcc_error: '错误原因',

package/lib/client.js

@@ -1703,6 +1703,13 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
       throw error;
     }
 
+    function workflowDisplayName(task) {
+      if (task.title && !task.title.startsWith('企业数据清洗补全任务')) return task.title;
+      const base = task.source?.fileName?.replace(/\.[^.]+$/, '') || (task.source?.type === 'image' ? '图片名单' : '粘贴名单');
+      const date = task.createdAt ? new Date(task.createdAt) : null;
+      const time = date && Number.isFinite(date.getTime()) ? date.toLocaleString() : '';
+      return `${base}｜${task.source?.rowCount ?? 0} 条${time ? '｜' + time : ''}`;
+    }
     function cacheWorkflowTask(actions, sessionId, task) {
       if (!task) return null;
       if (sessionId) workflowTaskBySession.set(String(sessionId), task);
@@ -1855,9 +1862,14 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
       return response.task;
     }
     function watchHostedCommand(actions, sessionId, command) {
+      let openedForExecution = false;
       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) {
+          openedForExecution = true;
+          openWorkbench(actions, workflowTaskBySession.get(String(sessionId))?.stage || 'match', sessionId);
+        }
         if (isCleaningSession(sessionId) && workflowTaskBySession.get(String(sessionId))?.id === command.taskId) actions.setCommandProgress?.({ taskId: command.taskId, ...status.progress });
       }).then(async (completed) => {
         await refreshHostedTask(actions, sessionId, command.taskId, completed.run);
@@ -1919,8 +1931,15 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
           setInput: (draft, input) => { draft.input = input; },
           setWorkflowContract: (draft, value) => { draft.workflowContract = value; },
           setCommandProgress: (draft, value) => { draft.commandProgress = value; },
-          setWorkflowTask: (draft, value) => { draft.workflowTask = value ?? null; },
-          setWorkflowTasks: (draft, value) => { draft.workflowTasks = Array.isArray(value) ? value : []; },
+          setWorkflowTask: (draft, value) => {
+            draft.workflowTask = value ?? null;
+            if (value) draft.workflowTasks = [value, ...(draft.workflowTasks || []).filter(task => task.id !== value.id)];
+          },
+          setWorkflowTasks: (draft, value) => {
+            const cached = new Map((draft.workflowTasks || []).map(task => [task.id, task]));
+            draft.workflowTasks = (Array.isArray(value) ? value : []).map(task =>
+              (cached.get(task.id)?.revision ?? -1) > (task.revision ?? -1) ? cached.get(task.id) : task);
+          },
           setTaskTitle: (draft, value) => { draft.taskTitle = String(value ?? ''); },
           setMappings: (draft, value) => {
             const next = Array.isArray(value) ? value : [];
@@ -2297,7 +2316,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
     const WORKFLOW_STATE_LABELS = {
       draft: '待上传', uploaded: '待确认规则', rules_confirmed: '规则已确认', diagnosed: '体检完成',
       matching: '匹配中', review_required: '待人工核验', matched: '匹配完成', enriching: '补全中',
-      export_ready: '可下载', completed: '已完成', partial: '部分完成', failed: '失败',
+      export_ready: '可下载', completed: '已完成', partial: '处理结束（需核验）', failed: '执行失败',
       authorization_required: '待连接企查查', cancelled: '已取消', parse_failed: '解析失败',
     };
 
@@ -3214,7 +3233,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
         meta.hint ? h('div', { className: 'dcAgentToolCardHint' }, meta.hint) : null,
         summary ? h('div', { className: 'dcAgentToolCardBody' }, summary) : null,
         toolName === 'data_cleaning_qcc_run' ? h('div', { className: 'dcAgentArtifactList' },
-          [...summary.matchAll(/\[([^\]]+)\]\((\/data-cleaning\/api\/workflow\/tasks\/[a-zA-Z0-9%_-]+\/artifacts\/[a-zA-Z0-9%_-]+(?:\?preview=1)?)\)/g)].map((match, index) =>
+          [...summary.matchAll(/\[([^\]]+)\]\(((?:https?:\/\/[a-zA-Z0-9.:[\]-]+)?\/data-cleaning\/api\/workflow\/tasks\/[a-zA-Z0-9%_-]+\/artifacts\/[a-zA-Z0-9%_-]+(?:\?preview=1)?)\)/g)].filter(match => match[2].startsWith('/') || (typeof location !== 'undefined' && new URL(match[2]).origin === location.origin)).map((match, index) =>
             h('a', { key: index, className: 'dcAgentButton', href: match[2], target: '_blank', rel: 'noopener noreferrer' }, match[1]))) : null,
       );
     }
@@ -4165,7 +4184,7 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
           ),
           workflowTasks.length ? h('div', { className: 'dcAgentPane', 'aria-label': '任务历史列表' },
             workflowTasks.map((task) => h('button', { key: task.id, type: 'button', className: 'dcAgentHistoryTask', onClick: () => resumeWorkflowTask(task) },
-              h('h3', null, task.title || task.id || '数据清洗任务'),
+              h('h3', null, workflowDisplayName(task)),
               h('div', { className: 'dcAgentRow' },
                 h('span', { className: 'dcAgentJobsPill', 'data-state': task.state ?? 'idle' }, WORKFLOW_STATE_LABELS[task.state] ?? task.state ?? '未知'),
                 h('span', { className: 'dcAgentHint' }, `${task.source?.rowCount ?? 0} 行 · ${task.updatedAt ? new Date(task.updatedAt).toLocaleString() : ''}`),
@@ -4533,10 +4552,16 @@ body:has(.dcAgentPromptBackdrop) { overflow: hidden; }
           h('div', { className: 'dcAgentWbBody' },
             cachedTask && step !== 'history' ? h('section', { className: 'dcAgentSection', 'aria-label': '当前任务进展', 'aria-live': 'polite' },
               h('b', null, WORKFLOW_STATE_LABELS[cachedTask.state] || cachedTask.state),
-              h('p', { className: 'dcAgentHint' }, `任务：${cachedTask.id}`),
+              h('h3', null, workflowDisplayName(cachedTask)),
+              h('details', null, h('summary', null, '任务详情'), h('p', { className: 'dcAgentHint' }, `任务编号：${cachedTask.id}`)),
               h('p', null, `${cachedTask.source?.type === 'image' ? '图片识别' : cachedTask.source?.type === 'text' ? '粘贴名单' : '上传表格'} · ${cachedTask.source?.fileName || ''} · ${cachedTask.source?.rowCount || 0} 条 · ${cachedTask.fieldSelection?.length || 0} 个补全字段`),
               commandProgress?.taskId === cachedTask.id && Number.isFinite(commandProgress.totalUnique) ? h('p', null, `已处理主体 ${commandProgress.completedUnique}/${commandProgress.totalUnique}（去重后，含未匹配或失败，不代表补全成功）`) : null,
-              h('p', null, `已补全 ${qccEnrichedCount} 条 · 待核验 ${qccReviewCount} 条（按输入行统计）`),
+              commandProgress?.taskId === cachedTask.id && Number.isFinite(commandProgress.totalUnique) && commandProgress.totalUnique > 0 ? h('progress', {
+                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 : '统计中'} 条（按输入行统计；未披露字段保留空白）` : '结果统计中，处理结束后展示补全与待核验数量'),
             ) : null,
             error ? h('div', { className: 'dcAgentError', role: 'alert' }, error) : null,
             step !== 'history' ? h('details', { className: 'dcAgentSection' },

package/lib/qcc-command.js

@@ -138,7 +138,7 @@ export class QccCommandStore {
     }
   }
 
-  prepare(input) {
+  prepare(input, { artifactOrigin = '' } = {}) {
     this.cleanup(true);
     const normalized = normalizedInput(input);
     const estimate = normalized.kind === 'enrich'
@@ -148,6 +148,7 @@ export class QccCommandStore {
     const at = new Date(this.clock()).toISOString();
     const record = {
       commandId,
+      artifactOrigin,
       taskId: normalized.taskId,
       kind: normalized.kind,
       state: 'prepared',
@@ -265,7 +266,7 @@ export class QccCommandStore {
       state: run.state,
       summary: run.summary,
       ...(record.delivery ? { deliveryState: record.delivery.state, artifactCount: record.delivery.artifacts.length,
-        artifacts: record.delivery.artifacts.filter(a => a.format === 'xlsx' && (a.kind !== 'review' || a.rowCount > 0)).map(a => ({ fileName: a.fileName, url: `/data-cleaning/api/workflow/tasks/${encodeURIComponent(record.taskId)}/artifacts/${encodeURIComponent(a.id)}` })) } : {}),
+        artifacts: record.delivery.artifacts.filter(a => a.format === 'xlsx' && (a.kind !== 'review' || a.rowCount > 0)).map(a => ({ fileName: a.fileName, url: `${record.artifactOrigin || ''}/data-cleaning/api/workflow/tasks/${encodeURIComponent(record.taskId)}/artifacts/${encodeURIComponent(a.id)}` })) } : {}),
     });
   }
 }

package/lib/qcc.js

@@ -1070,7 +1070,8 @@ export class QccHostBridge {
           qcc_match_status: 'enriched',
           qcc_source: 'qcc-mcp',
           ...(result.snapshotNote ? { qcc_snapshot_note: result.snapshotNote } : {}),
-          ...(row.qcc_field_issues || result.fieldIssues ? { qcc_field_issues: Object.entries(result.fieldIssues || {}).map(([field, issue]) => field + ': ' + issue.message).join('；') } : {}),
+          ...(row.qcc_field_issues || result.fieldIssues ? { qcc_field_issues: Object.entries(result.fieldIssues || {}).filter(([, issue]) => issue.reviewRequired !== false).map(([field, issue]) => field + ': ' + issue.message).join('；') } : {}),
+          ...(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' };

package/lib/web.js

@@ -659,11 +659,20 @@ export function mountWebRoutes(wctx, { logger, report, TOOL_NAME, SKILL_NAME })
         }
         const payload = JSON.parse((await readBody(req)).toString('utf8'));
         if (payload.kind && payload.kind !== 'enrich') requirePaidConfirmation(payload);
+        // Resolve from the actual browser request, never from model/task input.
+        let artifactOrigin = '';
+        const requestHost = req.headers?.host;
+        if (typeof requestHost === 'string' && /^[a-zA-Z0-9.:[\]-]+$/.test(requestHost)) {
+          try {
+            const origin = new URL(req.headers.origin || `${req.socket?.encrypted ? 'https' : 'http'}://${requestHost}`);
+            if (['http:', 'https:'].includes(origin.protocol) && origin.host === requestHost) artifactOrigin = origin.origin;
+          } catch { /* Relative links remain available for hosts without an origin. */ }
+        }
         return writeJson(res, 201, {
           ok: true,
           marker: 'g5-agent-command',
           paidCalls: false,
-          command: qccCommands.prepare(payload.workflowOwned ? await execution.prepare(payload) : payload),
+          command: qccCommands.prepare(payload.workflowOwned ? await execution.prepare(payload) : payload, { artifactOrigin }),
         });
       }
       if (rest.length === 1 && req.method === 'GET') {

package/package.json

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

package/docs/RELEASE-0.8.19.md

@@ -1,13 +0,0 @@
-# 0.8.19 发布说明
-
-本版修复字段候选、搜索展示和结果交付体验。
-
-- “受益人”推荐首条受益所有人；“主营业务收入”推荐营业总收入并提示口径不同，均需人工确认。
-- 映射选择器按当前映射、搜索、大类、字段清单展示；筛选不修改已选映射。
-- 已处理主体数包含未匹配或失败，不代表已补全；同时展示按输入行统计的补全与待核验数。
-- QCC 工具结果卡片与工作台增加原生文件链接，不只依赖模型生成 Markdown。
-- 空异常清单不展示；实际存在异常时保留。
-
-验证：245 项自动测试、10 组明暗色与响应式浏览器回归通过。未发起付费 QCC 查询，未修改上传源文件。实际 DSH 宿主中的文件点击仍需升级后验收。
-
-升级至 0.8.19 后完整重启 DSH。历史对话文本不会自动重写；历史制品可从工作台获取。