dsh-data-cleaning-agent 0.8.1 → 0.8.2

package/CHANGELOG.md

@@ -2,7 +2,13 @@
 
 本文件记录 `dsh-data-cleaning-agent` 的版本变更。格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
-## [Unreleased]
+## [0.8.2] - 2026-09-06
+
+### Fixed
+- 单一会话所有权：入口改用 `sessions.create({ workspaceId, sessionId })` 显式创建带 `session-dsh-data-cleaning-agent-` 前缀的独立原生会话，不再复用空白会话（否则会与「招投标」「访前尽调」共享同一会话，导致标题与右侧工作台面板归属冲突）。
+- 图片暂存与 OCR 连接检查解耦：尚未连接本地文档解析时仍显示缩略图，允许继续选规则、字段并生成完整说明；执行 OCR 时仍严格检查连接，不调用远端 URL 接口读取本地文件。
+- 图片连接状态随轮询更新；15 分钟暂存期内补齐连接后可直接使用原图片任务。
+- Composer 和向导图片粘贴同时兼容剪贴板 `files` 与 `items`，拖入共用相同取图逻辑。
 
 ## [0.8.1] - 2026-09-05
 

package/README.en.md

@@ -2,7 +2,7 @@
 
 > 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.1** (stable release)
+> Current source version / 当前源码版本: **0.8.2** (stable release)
 
 [![CI](https://github.com/duhu2000/dsh-data-cleaning-agent/actions/workflows/ci.yml/badge.svg)](https://github.com/duhu2000/dsh-data-cleaning-agent/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/dsh-data-cleaning-agent)](https://www.npmjs.com/package/dsh-data-cleaning-agent)

package/README.md

@@ -2,7 +2,7 @@
 
 > 在 DeepSeek Harness 中清洗、补全、画像企业名单数据的智能体插件：本地 CSV/XLSX/JSON 引擎 + 可选企查查（Qichacha/QCC）MCP 企业数据补全，由企查查（Qichacha/QCC）团队发起并维护。
 >
-> 当前源码版本 / Current source version: **0.8.1**（正式版本）
+> 当前源码版本 / Current source version: **0.8.2**（正式版本）
 
 [![CI](https://github.com/duhu2000/dsh-data-cleaning-agent/actions/workflows/ci.yml/badge.svg)](https://github.com/duhu2000/dsh-data-cleaning-agent/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/dsh-data-cleaning-agent)](https://www.npmjs.com/package/dsh-data-cleaning-agent)

package/docs/RELEASE-0.8.1.md

@@ -73,3 +73,9 @@ dsh web
 ```
 
 回滚会恢复 0.8.0 的 Modlens 两轮图片流程；文本、Excel、主体匹配、字段补全和历史制品不受影响。
+
+## 6. 发布结果
+
+- 发布提交 `4d71308620115acaf78b215552565a1db4199168` 通过 Release workflow run `33977279908` 的标签校验、完整 `npm run check` 门禁、npm 发布和 GitHub Release 创建，全部成功。
+- npm 通过 GitHub Actions OIDC Trusted Publishing 发布并签署 provenance，未使用长期 npm Token；registry 回读确认 `latest` 为 `0.8.1`。
+- GitHub Release：<https://github.com/duhu2000/dsh-data-cleaning-agent/releases/tag/v0.8.1>。

package/docs/USER-GUIDE.md

@@ -67,7 +67,10 @@ bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-data-cleaning-a
 ```
 
 市场中的远端 `qcc-document` 只接受公网 `file_url`，不能读取 Host 本地临时文件；只连接远端服务时，
-插件会 fail closed 并提示配置本地服务。图片仅作为 0600 权限的 Host 临时文件，成功、失败、取消或
+图片仍可载入并显示缩略图、继续选择规则和字段，页面会单独提示配置本地服务；真正执行 OCR 时才
+阻断不可用的连接，绝不会向远端接口传本地路径。15 分钟暂存期内补齐连接后无需重新选图，超时或 Host
+重启后需重新选择。选图本身不会执行 OCR，回填并发送完整任务说明后才开始识别。
+图片仅作为 0600 权限的 Host 临时文件，成功、解析失败、取消或
 15 分钟超时后删除，不进入任务 KV、模型上下文或导出制品。`qcc-document-mcp` 会读取该临时文件并
 上传到企查查文档解析网关；用户应只提交有权处理且允许上传的数据。文档解析与后续企业补全均使用
 当前用户自己连接的企查查账号和额度；本插件不读取或保存凭据。

package/lib/client.js

@@ -1565,6 +1565,15 @@ window.__ModuleLoader__.load({
       return mount;
     }
 
+    const CLEANING_SESSION_ID_PREFIX = 'session-dsh-data-cleaning-agent-';
+    const SESSION_UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu;
+    function createCleaningSessionId() {
+      if (typeof globalThis.crypto?.randomUUID !== 'function') {
+        throw new Error('当前浏览器不支持安全会话标识生成，请使用最新版浏览器');
+      }
+      return `${CLEANING_SESSION_ID_PREFIX}${globalThis.crypto.randomUUID()}`;
+    }
+
     /** 使用 DSH 原生工作区、会话和输入机打开中央对话，不构造第二套聊天界面。 */
     async function startCleaningSession(ctx) {
       const workspace = ctx.workspaces.list.getSnapshot();
@@ -1577,21 +1586,17 @@ window.__ModuleLoader__.load({
       if (targetWorkspaceId === undefined) {
         throw new Error('请先选择一个工作空间，再打开数据清洗补全智能体');
       }
-      // rc.2 暴露 workspaces.connectWorkspace；alpha.2 把同一导航策略迁移到
-      // uiWorkspace.connectWorkspace，纯 workspaces controller 不再带该方法。
-      // 只在检测到真实方法后调用，避免把 alpha 实验面当成稳定契约。
-      const uiWorkspace = typeof ctx.get === 'function' ? ctx.get('uiWorkspace') : ctx.uiWorkspace;
-      const connectWorkspace = typeof ctx.workspaces.connectWorkspace === 'function'
-        ? ctx.workspaces.connectWorkspace.bind(ctx.workspaces)
-        : typeof uiWorkspace?.connectWorkspace === 'function'
-          ? uiWorkspace.connectWorkspace.bind(uiWorkspace)
-          : null;
-      const sessionId = connectWorkspace
-        ? await connectWorkspace(targetWorkspaceId)
-        : typeof ctx.sessions.create === 'function'
-          ? await ctx.sessions.create({ workspaceId: targetWorkspaceId })
-          : null;
-      if (!sessionId) throw new Error('当前 DSH 版本没有可用的工作区会话创建能力');
+      // 单一会话所有权：与招投标入口一致，显式创建带前缀的独立原生会话，绝不复用空白会话。
+      // connectWorkspace 会把「招投标」尚为空白的工作台会话复用为清洗会话，
+      // 使同一会话同时被招投标与清洗两个插件认领，进而争夺 Hero 标题与右侧工作台面板。
+      if (typeof ctx.sessions.create !== 'function') {
+        throw new Error('当前 DSH 版本没有可用的独立会话创建能力');
+      }
+      const requestedId = createCleaningSessionId();
+      const sessionId = await ctx.sessions.create({ workspaceId: targetWorkspaceId, sessionId: requestedId });
+      if (sessionId !== requestedId) {
+        throw new Error('当前 DSH 版本不支持独立会话创建，请升级 DSH 后再打开数据清洗补全智能体');
+      }
       const conversation = typeof ctx.get === 'function' ? ctx.get('conversation') : ctx.conversation;
       if (!conversation) throw new Error('DSH 对话服务尚未就绪，请稍后重试');
       markCleaningSession(sessionId);
@@ -1975,6 +1980,16 @@ window.__ModuleLoader__.load({
       }).filter(Boolean).slice(0, 50);
     }
 
+    function imageFilesFromTransfer(transfer) {
+      const files = Array.from(transfer?.files || []).filter((file) => String(file?.type ?? '').startsWith('image/'));
+      // Safari/Chromium clipboard implementations may expose screenshots only as items.
+      if (files.length) return files;
+      return Array.from(transfer?.items || [])
+        .filter((item) => item.kind === 'file' && String(item.type ?? '').startsWith('image/'))
+        .map((item) => item.getAsFile?.())
+        .filter(Boolean);
+    }
+
     async function imageFileBase64(file) {
       if (!file || typeof file.arrayBuffer !== 'function') throw new Error('图片文件不可读。');
       const bytes = new Uint8Array(await file.arrayBuffer());
@@ -2238,8 +2253,8 @@ window.__ModuleLoader__.load({
       react.useEffect(() => {
         if (!enabled) return undefined;
         const handleWindowPaste = (event) => {
-          const files = event.clipboardData?.files;
-          const hasImage = [...(files || [])].some((file) => String(file?.type ?? '').startsWith('image/'));
+          const files = imageFilesFromTransfer(event.clipboardData);
+          const hasImage = files.length > 0;
           if (!hasImage) return;
           const target = event.target;
           const inComposer = !open && Boolean(target?.closest?.('textarea, [contenteditable="true"], [role="textbox"]'));
@@ -2341,7 +2356,7 @@ window.__ModuleLoader__.load({
               role: 'group',
               'aria-label': '粘贴、拖入或选择企业名单图片',
               onPaste: (event) => {
-                const files = event.clipboardData?.files;
+                const files = imageFilesFromTransfer(event.clipboardData);
                 if (files?.length) {
                   event.preventDefault();
                   acceptImageFiles(files);
@@ -2352,7 +2367,7 @@ window.__ModuleLoader__.load({
               onDrop: (event) => {
                 event.preventDefault();
                 setImageDropActive(false);
-                acceptImageFiles(event.dataTransfer?.files);
+                acceptImageFiles(imageFilesFromTransfer(event.dataTransfer));
               },
             },
               h('p', null, '可直接在此粘贴图片，或拖入 / 选择 PNG、JPEG、WebP。图片会在对话框显示缩略图，点击可放大。'),
@@ -2432,6 +2447,9 @@ window.__ModuleLoader__.load({
             h('pre', { className: 'dcAgentPromptPreview' }, buildTaskPrompt(promptConfig())),
           ) : null,
           h('p', { className: 'dcAgentPromptNote' }, '向导只生成任务描述并保存任务设置。只有你在任务中明确确认后，才会使用当前客户自己的企查查 MCP 连接、账号和额度。'),
+          mode === 'image' && imageCommand?.state === 'prepared' && imageCommand?.providerIssue
+            ? h('p', { className: 'dcAgentPromptNote', role: 'status' }, `图片已载入，可继续选择规则和字段；暂存有效期 15 分钟。${imageCommand.providerIssue.message}`)
+            : null,
           error ? h('p', { className: 'dcAgentPromptError', role: 'alert' }, error) : null,
           h('div', { className: 'dcAgentPromptActions' },
             h('button', { type: 'button', className: 'dcAgentPromptAction', disabled: wizardStep === 1, onClick: () => setWizardStep(Math.max(1, wizardStep - 1)) }, '上一步'),
@@ -3786,6 +3804,7 @@ window.__ModuleLoader__.load({
       clearCleaningDraft,
       entriesToDataset,
       extractPromptEntries,
+      imageFilesFromTransfer,
       guessMappings,
       deactivateCleaningSession,
       installSessionOwnershipBridge,

package/lib/image-intake.js

@@ -395,16 +395,6 @@ export class ImageIntakeStore {
   async prepare(input = {}) {
     await this.cleanup();
     const provider = this.providerDefinition();
-    if (!provider) {
-      const remoteOnly = Boolean(this.remoteDefinition());
-      throw new ImageIntakeError(
-        remoteOnly ? 'DC_IMAGE_LOCAL_DOCUMENT_PROVIDER_REQUIRED' : 'DC_IMAGE_PROVIDER_UNAVAILABLE',
-        remoteOnly
-          ? '当前只连接了远端 qcc-document，它不能读取本地图片。请在 MCP 连接器中配置本地 qcc-document-mcp。'
-          : '当前 DSH 没有可用的企查查本地文档解析连接。请配置 qcc-document-mcp，或改用文本/Excel 名单。',
-        503,
-      );
-    }
     const decoded = decodeImage(input.content);
     const commandId = `dci-${randomUUID()}`;
     const at = new Date(this.clock()).toISOString();
@@ -417,9 +407,9 @@ export class ImageIntakeStore {
       fileName: safeName(input.fileName),
       mimeType: decoded.mimeType,
       sizeBytes: decoded.bytes.length,
-      provider: provider.provider,
-      parseTool: provider.parseName,
-      resultTool: provider.resultName,
+      provider: IMAGE_PROVIDER_QCC_DOCUMENT_LOCAL,
+      parseTool: provider?.parseName ?? null,
+      resultTool: provider?.resultName ?? null,
       path,
       createdAt: at,
       updatedAt: at,
@@ -431,7 +421,7 @@ export class ImageIntakeStore {
     };
     this.records.set(commandId, record);
     this.scheduleExpiry(record);
-    return publicRecord(record, this.clock());
+    return this.status(commandId);
   }
 
   require(commandId) {
@@ -444,7 +434,23 @@ export class ImageIntakeStore {
   }
 
   status(commandId) {
-    return publicRecord(this.require(commandId), this.clock());
+    const record = this.require(commandId);
+    const ready = Boolean(this.providerDefinition(record.parseTool));
+    return {
+      ...publicRecord(record, this.clock()),
+      providerReady: ready,
+      providerIssue: ready ? null : this.providerIssue(),
+    };
+  }
+
+  providerIssue() {
+    const remoteOnly = Boolean(this.remoteDefinition());
+    return {
+      code: remoteOnly ? 'DC_IMAGE_LOCAL_DOCUMENT_PROVIDER_REQUIRED' : 'DC_IMAGE_PROVIDER_UNAVAILABLE',
+      message: remoteOnly
+        ? '当前只连接了远端 qcc-document，它不能读取本地图片。请在 MCP 连接器中配置本地 qcc-document-mcp 后再发送识别任务。'
+        : '当前 DSH 没有可用的企查查本地文档解析连接。请配置 qcc-document-mcp 后再发送识别任务，或改用文本/Excel 名单。',
+    };
   }
 
   async run(commandId, exec) {
@@ -456,8 +462,11 @@ export class ImageIntakeStore {
     if (record.state === 'completed') return { commandId, ...record.result };
     const provider = this.providerDefinition(record.parseTool);
     if (!provider) {
-      throw new ImageIntakeError('DC_IMAGE_PROVIDER_UNAVAILABLE', '企查查本地文档解析连接已离线。', 503);
+      const issue = this.providerIssue();
+      throw new ImageIntakeError(issue.code, issue.message, 503);
     }
+    record.parseTool = provider.parseName;
+    record.resultTool = provider.resultName;
     record.state = 'running';
     record.updatedAt = new Date(this.clock()).toISOString();
     const execute = (name, args) => this.tools.execute({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-data-cleaning-agent",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "Clean, complete, and profile enterprise name lists in DeepSeek Harness — a data cleaning & completion agent plugin with local CSV/XLSX/JSON engine and optional Qichacha (QCC) MCP enrichment. Maintained by Qichacha/QCC.",
   "type": "module",
   "main": "lib/index.js",