dsh-data-cleaning-agent 0.8.0 → 0.8.2

package/CHANGELOG.md

@@ -2,7 +2,33 @@
 
 本文件记录 `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
+
+### Changed
+- 图片企业名单识别切换为企查查智能文档解析：本地图片只通过官方 `qcc-document-mcp`
+  `parse_document(file_path)` 提交，并仅在异步处理中按返回的 `task_id` 查询 `get_parse_result`。
+- 提示词向导不再要求先发送 OCR 专用说明；用户可一次完成图片、匹配规则、清洗动作和补全字段选择，
+  再向原生对话框回填一段完整、可读、可编辑的中文任务说明。
+- 识别完成后名单直接进入同一 taskId 工作台人工核对，继续现有主体匹配、字段补全和导出流程。
+
+### Security
+- Host 仍以 0700 目录和 0600 文件临时保存图片，成功、失败、取消或 TTL 到期后删除；原图不进入
+  `storageDomain`、任务元数据、模型上下文或导出制品。
+- 远端 `qcc-document` 只接受公网 `file_url`，不能读取本机临时图片；仅连接远端服务时明确 fail closed，
+  不自动上传图片、不暴露本地路径，也不回退到聊天模型视觉能力。
+- 文档解析与后续企业补全均使用当前用户自己连接的企查查账号和额度；插件不读取、保存或分发凭据。
+
+### Fixed
+- 文本模型（包括不支持图片的 DeepSeek 模型）不再收到原生图片附件，避免在执行清洗任务前被模型能力门拒绝。
+- 统一解析企查查文档任务状态、Markdown 结果与认证失败，支持处理中轮询、超时和安全错误提示。
 
 ## [0.8.0] - 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.0** (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)
@@ -49,14 +49,18 @@ task brief back to the native composer. Five workflow actions (upload, profile,
 sit below the composer and open the five-step workbench (upload, rules, match, enrich, download)
 on demand. Completed tasks expose four durable Host artifacts: result and exception-list CSV/XLSX.
 
-Since 0.8.0, pasting an image into the native composer of a data-cleaning session, or dropping/selecting
-a PNG, JPEG, or WebP in the prompt builder, opens the image-list workflow with a clickable native
-thumbnail. After Host staging, the client releases the native composer attachment so text-only chat
-models can accept the readable recognition turn. An Agent-owned high-level tool then uses a runtime-detected
-image-text provider, returns company names/credit codes for human review, and
-then enters the existing taskId workflow. `modlens_read_image` is the verified provider. If it is not
-installed/configured, the feature fails closed and users can switch to text or Excel; recognition makes
-no QCC call.
+Since 0.8.1, users can paste, drop, or select a PNG/JPEG/WebP image, finish match rules and enrichment
+field selection, and write one complete editable task brief to the native composer; the separate OCR-only
+turn has been removed. Before send, the client releases the native image attachment so text-only models can
+still dispatch the Agent-owned high-level tool. That tool calls the official local `qcc-document-mcp`
+`parse_document(file_path)` exactly once and polls `get_parse_result` with the returned `task_id` only while
+processing, then returns company names/credit codes to the workbench for human review.
+
+Local image parsing requires the official `qcc-document-mcp` stdio server to be configured in the MCP
+connector. The remote `qcc-document` connector accepts public `file_url` values only and cannot read Host
+temporary files. The local server uploads the explicitly submitted file to the QCC document parsing gateway.
+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.
 
 Without the `dsh` CLI, use the install script:
 
@@ -131,6 +135,8 @@ See [the 0.7.0 release record](docs/RELEASE-0.7.0.md) for the first 40 and secon
 one-company-one-row fields, deduplicated QCC tool dispatch, and real two-company acceptance.
 See [the 0.8.0 release record](docs/RELEASE-0.8.0.md) for image paste/drop, native previews,
 Agent-owned OCR, and the human-review handoff.
+See [the 0.8.1 release record](docs/RELEASE-0.8.1.md) for QCC intelligent document parsing
+and the single editable task brief.
 See [the 0.6.3 release record](docs/RELEASE-0.6.3.md) for multiline entity-list parsing,
 editable execution summaries, and workbench/composer layout fixes.
 See [the 0.6.2 release record](docs/RELEASE-0.6.2.md) for Chinese export headers,

package/README.md

@@ -2,7 +2,7 @@
 
 > 在 DeepSeek Harness 中清洗、补全、画像企业名单数据的智能体插件：本地 CSV/XLSX/JSON 引擎 + 可选企查查（Qichacha/QCC）MCP 企业数据补全，由企查查（Qichacha/QCC）团队发起并维护。
 >
-> 当前源码版本 / Current source version: **0.8.0**（正式版本）
+> 当前源码版本 / 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)
@@ -42,12 +42,17 @@ DSH 原生会话：首页标题、产品说明与工作流会替换通用探索
 字段补全和任务历史五个入口位于输入框下方，右侧工作台承载“上传数据 → 规则确认 → 数据匹配 →
 清洗补全 → 下载数据”五步闭环。完成后可下载结果与异常清单的 CSV/XLSX 四类 Host 耐久制品。
 
-0.8.0 起，在数据清洗补全会话的原生输入框粘贴图片，或在「提示词生成」的图片页
-拖入/选择 PNG、JPEG、WebP，会显示可点击放大的原生缩略图。回填识别指令时，图片已由 Host 安全暂存，
-Client 会先释放 Composer 附件再回填纯文本指令，因此文本模型也能执行。用户发送可读识别指令后，Agent-owned
-高层工具使用运行时已探测的图片文字 Provider，将企业名称/信用代码回传向导供人工核对，
-再进入既有 taskId 匹配补全流程。已验证 Provider 为 `modlens_read_image`；未安装/配置时功能
-fail closed，不会调用 QCC，可改用文本或 Excel。
+0.8.1 起，在数据清洗补全会话的原生输入框粘贴图片，或在「提示词生成」的图片页
+拖入/选择 PNG、JPEG、WebP，会显示可点击放大的原生缩略图。用户可继续完成匹配规则、清洗项与补全字段，
+最后一次性把完整、可编辑的任务说明回填到对话框；不再先发送一轮 OCR 专用指令。发送前 Client 释放
+Composer 图片附件，因此不支持视觉输入的文本模型也能调度 Agent-owned 高层工具。高层工具通过官方
+`qcc-document-mcp` 的 `parse_document(file_path)` 提交本地图片，仅在异步处理中以同一 `task_id`
+调用 `get_parse_result`，再将企业名称/信用代码交回工作台人工核对。
+
+本地图片解析需在 MCP 连接器中另行配置官方 `qcc-document-mcp`；市场中的远端 `qcc-document`
+只支持公网 `file_url`，不能读取本机图片。两者使用当前客户自己的企查查账号与额度，本插件不读取、保存
+或分发凭据。本地服务会把用户明确提交的图片上传到企查查文档解析网关；未连接本地服务时功能会
+fail closed，并明确提示配置要求，文本与 Excel 流程不受影响。
 
 没有 `dsh` CLI 时，也可以用安装脚本：
 
@@ -73,7 +78,7 @@ bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-data-cleaning-a
 | 耐久制品 | Host 工作区 `.dsh-data-cleaning-artifacts/v1` | 结果/异常 CSV+XLSX，checksum 校验，跨 Host 重启下载 |
 | 应用内入口 | 侧栏顶部「数据清洗补全」+ 输入框下方五能力按钮 | 中央业务首页与原生对话，右侧按需打开 Mockup 对齐工作台 |
 | 提示词生成 | `conversation.input.overlay` | 文本 / Excel / 图片录入、清洗项与补全维度选择，生成后回填原生输入框供人工修改 |
-| 图片名单 | `data_cleaning_extract_image_companies` + web `/data-cleaning/api/images/*` | 原生缩略图/放大、粘贴/拖入；Host 临时图片 + Agent-owned Provider 识别 + 人工核对，识别阶段不调用 QCC |
+| 图片名单 | `data_cleaning_extract_image_companies` + `qcc-document-mcp` | 原生缩略图/放大、粘贴/拖入；一次性完整任务说明；`parse_document` → 按需 `get_parse_result` → 人工核对 |
 | 工具卡片 | `tool.call.toolview`（清洗/补全/画像/图片名单） | 对话内渲染四类工具结果卡，含运行/已完成/失败状态 |
 | 任务进度 | 工作台头部任务 pill | 轮询 `/data-cleaning/api/mvp/jobs`，展示排队/运行中任务 |
 | Skill | `data-cleaning` | 引导模型按工作流调度上述工具 |
@@ -123,7 +128,8 @@ bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-data-cleaning-a
 0.5.3 业务首页、提示词生成和输入框下方流程栏见 [docs/RELEASE-0.5.3.md](docs/RELEASE-0.5.3.md)。
 0.7.0 第一批 40 字段、第二批 58 字段、调用编排和真实两企业验收见
 [docs/RELEASE-0.7.0.md](docs/RELEASE-0.7.0.md)。0.8.0 图片粘贴、原生缩略图、Agent-owned OCR 和人工核对流程见
-[docs/RELEASE-0.8.0.md](docs/RELEASE-0.8.0.md)。0.6.3 多行名单解析、可编辑执行说明与工作台遮挡修复见
+[docs/RELEASE-0.8.0.md](docs/RELEASE-0.8.0.md)。0.8.1 企查查智能文档解析与单次任务说明见
+[docs/RELEASE-0.8.1.md](docs/RELEASE-0.8.1.md)。0.6.3 多行名单解析、可编辑执行说明与工作台遮挡修复见
 [docs/RELEASE-0.6.3.md](docs/RELEASE-0.6.3.md)。0.6.2 中文导出表头、完整字段选择传递与画像字段补全见
 [docs/RELEASE-0.6.2.md](docs/RELEASE-0.6.2.md)。0.6.1 Agent-owned QCC 工作台、会话隔离、恢复统计及真实闭环验收见
 [docs/RELEASE-0.6.1.md](docs/RELEASE-0.6.1.md)。0.6.0 五步 taskId 工作流、耐久制品、

package/docs/COMPATIBILITY.md

@@ -50,6 +50,13 @@ alpha.2 只作兼容探针。全程未触碰生产 43120，未调用 QCC。
 Agent-owned 工具通过 `dci-*` 凭证读取 Host 临时副本。因此图片选择与预览沿用 DSH 原生 UI，实际识别轮仍是
 文本模型可接受的纯文本工具调用。
 
+0.8.1 将当前图片 Provider 收敛到企查查官方本地 stdio 服务 `qcc-document-mcp`。本地服务的
+`parse_document` 接受 `file_path`，返回完成结果或 `task_id`；只有状态仍为处理中时才调用
+`get_parse_result(task_id)`。市场远端 `qcc-document` 的 `parse_document` 只接受公网 `file_url`，
+不能读取 Host 临时文件，因此只连接远端服务时返回
+`DC_IMAGE_LOCAL_DOCUMENT_PROVIDER_REQUIRED`。该版本保留 0.8.0 的 DSH 原生附件 API 兼容层，
+但不再依赖 Modlens，也不把图片交给当前聊天模型。
+
 ## 2. Node 运行时
 
 - 本包 `engines.node` 声明 `>=20`。
@@ -70,7 +77,8 @@ Agent-owned 工具通过 `dci-*` 凭证读取 Host 临时副本。因此图片
 | 同源守卫 | `isTrusted(req)` | `sec-fetch-site !== 'cross-site'` 且 origin 为 127.0.0.1/localhost |
 | Agent-owned 动态工具调用 | `ctx.tools.register()` 高层工具 + `ctx.tools.get()` + 带 `parent/agent/rootCallId` 的 `ctx.tools.execute()` | rc.2 Code Mode 实测要求 nested execution；每次调用重新解析，不缓存动态 MCP 工具 |
 | 原生图片附件 | `conversation.createDraftImages/releaseDraftImage(s)` + `input.shell().addImages/removeImage` | rc.2 已验证；Client 运行时探测，缺失时 fail closed |
-| 图片文字 Provider | `ctx.tools.get('modlens_read_image')` + Agent-owned nested `ctx.tools.execute()` | Modlens 3.25.2 已验证；可选运行时能力，不是 npm 强依赖 |
+| 本地图片文档解析 | `ctx.tools.get()` 探测 `qcc-document-mcp` 的 `parse_document/get_parse_result` + Agent-owned nested `ctx.tools.execute()` | 0.8.1 当前实现；要求 `parse_document` 支持 `file_path`，不是 npm 强依赖 |
+| 远端图片文档解析 | `mcp__qcc-document__parse_document(file_url)` | 只支持公网 URL；不能用于 Host 本地临时图片，当前流程明确 fail closed |
 
 ## 4. 与企查查 MCP OAuth 插件的共存
 

package/docs/RELEASE-0.8.1.md

@@ -0,0 +1,81 @@
+# dsh-data-cleaning-agent 0.8.1 发布记录
+
+> 日期：2026-09-05  
+> 主题：企查查智能文档解析图片名单与单次完整任务说明
+
+## 1. 产品结果
+
+0.8.1 修正图片名单入口的执行路径：
+
+1. 用户在提示词向导粘贴、拖入或选择 PNG/JPEG/WebP 图片，继续选择匹配规则、清洗动作与补全字段。
+2. 向导一次生成完整、可读、可编辑的中文任务说明，不再要求先发送 OCR 专用指令、识别后再发送第二轮任务。
+3. 回填前 Client 释放 Composer 原生图片附件；DeepSeek 等不支持图片的文本模型只接收纯文本任务说明。
+4. Agent 只调用一次 `data_cleaning_extract_image_companies` 高层工具；Host 以父执行上下文调用用户连接的企查查智能文档解析。
+5. Host 通过本地 `qcc-document-mcp` 准确提交一次 `parse_document(file_path)`，仅在任务仍处理中时使用同一 `task_id` 查询 `get_parse_result`。
+6. 识别出的企业名称和统一社会信用代码进入同一 taskId 工作台人工核对，再继续主体匹配、字段补全和 CSV/XLSX 导出。
+
+## 2. 连接要求
+
+本地图片必须使用官方 `qcc-document-mcp` stdio 服务：
+
+```json
+{
+  "mcpServers": {
+    "qcc-document-mcp": {
+      "command": "npx",
+      "args": ["-y", "qcc-document-mcp"],
+      "env": {
+        "QCC_DOCUMENT_AUTHORIZATION": "Bearer YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+- Key 由用户配置在自己的 DSH/MCP 环境中，不进入插件代码、日志或发布包。
+- `qcc-document-mcp` 会读取本地文件并上传到企查查文档解析网关；用户只应提交有权处理且允许上传的数据。
+- 远端市场连接 `qcc-document` 的 `parse_document` 只接受公网 `file_url`，不能读取 Host 本机路径。
+- 只连接远端服务时，本插件返回 `DC_IMAGE_LOCAL_DOCUMENT_PROVIDER_REQUIRED`，不会自动上传图片、暴露本地路径或回退到聊天模型视觉能力。
+- 文档解析额度或费用由当前用户自己的企查查账号承担；后续企业补全继续遵守现有 BYO QCC 确认门。
+
+## 3. 安全边界
+
+- 图片限制为 PNG/JPEG/WebP、8 MiB，使用魔数而非文件扩展名校验。
+- Host 临时目录权限 0700、文件权限 0600；成功、失败、移除或 15 分钟 TTL 到期后删除。
+- 原图不写入 `storageDomain`、工作流任务元数据、模型上下文或导出制品。
+- Agent 只能取得随机 `dci-*` commandId，看不到 Host 文件路径；Web handler 不直接派发动态 MCP 工具。
+- 文档解析失败、认证失效、协议异常与超时均安全收敛，不重试提交或扩大调用范围。
+
+## 4. 验收范围
+
+- `npm run check`：语法、版本一致性、市场素材、发布白名单与全量自动化测试。
+- 图片契约：QCC Markdown 结果提取、一次提交、处理中轮询、两企业抽取、临时文件清理、认证/协议/超时错误。
+- Provider 门：本地服务未配置和仅有远端 `qcc-document` 时分别 fail closed，并返回可操作说明。
+- Client 契约：原生缩略图、一次完整任务说明、发送前释放附件、识别结果进入同一 taskId 工作台。
+- Web 契约：能力预检报告当前用户 QCC 文档连接计费边界，高层工具保持 Agent-owned nested execution。
+
+真实图片 QCC E2E 需要维护者在隔离 DSH Profile 中配置自己的 `qcc-document-mcp` Key；发布包不包含测试凭据或真实解析响应。
+
+## 5. 升级与回滚
+
+```bash
+dsh plugin --profile web add dsh-data-cleaning-agent@0.8.1
+# 完全停止后重启
+dsh web
+```
+
+0.8.1 未修改 `dc_workflows_v2`、制品 schema 或已完成任务，可直接回滚：
+
+```bash
+dsh plugin --profile web add dsh-data-cleaning-agent@0.8.0
+# 完全停止后重启
+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/UI-WORKFLOW-V2.md

@@ -8,7 +8,7 @@
 
 业务主流程与企查查专业版“数据清洗补全”一致，固定为五步：
 
-1. **上传数据**：文本、CSV、XLSX、JSON；0.8.0 起支持 PNG/JPEG/WebP 企业名单图片，经 DSH 原生附件缩略图、Host 临时文件、Agent-owned 图片文字 Provider 和人工核对后进入同一 taskId 流程。
+1. **上传数据**：文本、CSV、XLSX、JSON；0.8.1 支持 PNG/JPEG/WebP 企业名单图片，经 DSH 原生附件缩略图、Host 临时文件、企查查智能文档解析和人工核对后进入同一 taskId 流程。
 2. **规则确认**：字段映射、清洗目标、匹配规则、补全字段选择。
 3. **数据匹配**：以企业名称、统一社会信用代码或注册号作为主体锚点；精确、候选、已确认、未匹配、失败分流。
 4. **清洗补全**：本地确定性清洗优先；需要 QCC 数据时，先估算调用，再由当前用户确认使用自己的 QCC 账号额度。
@@ -171,7 +171,7 @@ draft → uploaded → rules_confirmed → diagnosed(可选)
 ## 8. 当前实现与发布顺序
 
 1. T3（完成）：上传解析、字段映射、任务设置和规则确认接入 v2 taskId API。
-2. T4（完成）：提示词生成器四步向导接入 taskId 工作流，支持文本/本地文件；0.8.0 将图片 Bridge 从“仅附件”收敛为可执行的粘贴/拖入、缩略图、高层 OCR、名单回传和人工核对闭环。
+2. T4（完成）：提示词生成器四步向导接入 taskId 工作流，支持文本/本地文件；0.8.1 支持图片粘贴/拖入、缩略图、企查查智能文档解析、名单回传和人工核对，并将图片识别与后续规则/字段要求合并为一次可编辑任务说明。
 3. T5（完成）：中央业务首页、五能力入口、右侧工作台、基础企业匹配/补全和任务历史统一到 taskId。
 4. T6（完成）：Host 耐久下载制品、XLSX 与异常清单、双基线、视觉回归、迁移与回滚。
 5. T7（完成）：候选人工核验、部分失败重试、匹配与补全状态闭环。

package/docs/USER-GUIDE.md

@@ -43,12 +43,37 @@ bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-data-cleaning-a
 - **上传图片**：支持 PNG/JPEG/WebP（单张不超过 8 MiB）；可在向导中粘贴、拖入或选择，也可直接在数据清洗补全会话的原生输入框粘贴。输入框使用 DSH 原生图片附件，向导同时显示 64px 缩略图，点击可放大。
 
 随后可选择名称规范、信用代码校验、去重、模糊候选复核等清洗动作，以及工商字段或已支持的维度组。
-图片流程分为两轮可见交互：
-
-1. 选择图片后，点击「回填图片识别指令」。此时 Host 已安全暂存原图，Client 会释放 Composer 图片附件并把可读的纯文本说明放入原生对话框；用户检查后发送。该步骤不会把图片交给当前聊天模型，因此兼容不支持视觉输入的文本模型。
-2. Agent 只调用一次 `data_cleaning_extract_image_companies`，Host 在当前父执行中调用已探测的图片文字 Provider；识别到的企业名称/统一社会信用代码会回到向导，由用户逐条核对后选择匹配规则和补全字段。
+0.8.1 起，图片流程只需发送一次完整任务说明：
+
+1. 选择图片后继续完成匹配规则、清洗动作与补全字段选择；最后一步生成一段包含图片识别要求和后续任务要求的可读中文说明，可在原生对话框中继续修改。
+2. 回填前 Client 释放 Composer 图片附件，因此不支持视觉输入的聊天模型也不会收到图片；Agent 只调用一次 `data_cleaning_extract_image_companies` 高层工具。
+3. Host 通过本地 `qcc-document-mcp` 准确调用一次 `parse_document(file_path)`；仅当任务仍在处理中时，才使用同一 `task_id` 查询 `get_parse_result`。
+4. 识别到的企业名称/统一社会信用代码进入同一 taskId 工作台供人工核对，然后继续主体匹配、字段补全和导出。
+
+本地图片解析需在 DSH 的 MCP 连接器中配置官方 `qcc-document-mcp`。示例（Key 仅保存在用户自己的环境中）：
+
+```json
+{
+  "mcpServers": {
+    "qcc-document-mcp": {
+      "command": "npx",
+      "args": ["-y", "qcc-document-mcp"],
+      "env": {
+        "QCC_DOCUMENT_AUTHORIZATION": "Bearer YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
 
-当前已验证 Provider 是 Modlens `modlens_read_image`。插件不引入对 Modlens 的强依赖；运行时未安装或未配置时会 fail closed，请改用文本/Excel。图片仅作为 0600 权限的 Host 临时文件，成功、失败、取消或 15 分钟超时后删除；不进入任务 KV 或导出制品。识别阶段不调用 QCC、不消耗 QCC MCP 额度；人工核对后的匹配/补全仍受既有 BYO QCC 确认门保护。
+市场中的远端 `qcc-document` 只接受公网 `file_url`，不能读取 Host 本地临时文件；只连接远端服务时，
+图片仍可载入并显示缩略图、继续选择规则和字段，页面会单独提示配置本地服务；真正执行 OCR 时才
+阻断不可用的连接，绝不会向远端接口传本地路径。15 分钟暂存期内补齐连接后无需重新选图，超时或 Host
+重启后需重新选择。选图本身不会执行 OCR，回填并发送完整任务说明后才开始识别。
+图片仅作为 0600 权限的 Host 临时文件，成功、解析失败、取消或
+15 分钟超时后删除，不进入任务 KV、模型上下文或导出制品。`qcc-document-mcp` 会读取该临时文件并
+上传到企查查文档解析网关；用户应只提交有权处理且允许上传的数据。文档解析与后续企业补全均使用
+当前用户自己连接的企查查账号和额度；本插件不读取或保存凭据。
 
 模型在对话中调用 `data_clean_rows` / `data_complete_rows` / `data_profile` 时，
 对话内会渲染对应的工具结果卡片（含运行中 / 已完成 / 失败状态）；工作台头部用任务 pill

package/lib/client.js

@@ -1194,7 +1194,9 @@ window.__ModuleLoader__.load({
         : [];
       const entryCount = Number.isFinite(config.entryCount) ? config.entryCount : entries.length;
       const source = mode === 'image'
-        ? `图片${config.fileName ? `「${config.fileName}」` : ''}，已识别并人工核验 ${entryCount} 条主体标识`
+        ? config.imageState === 'completed'
+          ? `图片${config.fileName ? `「${config.fileName}」` : ''}，已由企查查智能文档解析识别并人工核验 ${entryCount} 条主体标识`
+          : `图片${config.fileName ? `「${config.fileName}」` : ''}，已安全暂存在本机 Host，等待企查查智能文档解析识别`
         : mode === 'excel'
           ? `本地表格${config.fileName ? `「${config.fileName}」` : ''}，已解析 ${entryCount} 条主体标识，完整数据已载入数据清洗补全工作台`
           : `手工录入，共 ${entryCount} 条主体标识`;
@@ -1202,6 +1204,10 @@ window.__ModuleLoader__.load({
         '请执行一项企业名单数据清洗补全任务。',
         `输入来源：${source}。`,
       ];
+      if (mode === 'image' && config.imageCommandId && config.imageState !== 'completed') {
+        lines.push('请先通过企查查智能文档解析提取图片中的企业全称、18 位统一社会信用代码或注册号；模糊字符不得猜测。识别结果回传数据清洗补全工作台供我核验，然后沿用本任务已经选择的匹配规则、清洗要求和补全字段。');
+        lines.push(`安全图片凭证：${config.imageCommandId}。请只调用一次 data_cleaning_extract_image_companies，参数只传 commandId；该高层工具会在 Host 内调用 qcc-document-mcp 的 parse_document / get_parse_result，不要直接调用底层 mcp__qcc-document* 工具。`);
+      }
       if (entries.length) {
         lines.push(`${mode === 'excel' ? '主体预览' : '待处理主体'}：\n${entries.map((entry, index) => `${index + 1}. ${entry}`).join('\n')}`);
       }
@@ -1559,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();
@@ -1571,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);
@@ -1865,8 +1876,15 @@ window.__ModuleLoader__.load({
       const changedBadges = new Map();
       const hiddenForeignDocks = new Map();
       const composerStack = marker?.parentElement?.parentElement;
+      // 单一会话所有权由入口的 enabled 参数（useCleaningSession(sessionId) && composerPhase==='blank'）
+      // 与 React effect 生命周期共同保证：非清洗会话不会挂载，会话切换即走 cleanup 让位。
+      // 有界同步：每次 fix 的 DOM 变更计入校正预算，达到上限即断开观察器，杜绝与其它插件互相改写的死循环。
+      const MAX_HERO_CORRECTIONS = 8;
+      let corrections = 0;
+      let observer = null;
 
       const fix = () => {
+        let mutated = false;
         const spans = [...hero.querySelectorAll('span')];
         const title = spans.find((element) => element.dataset?.dcAgentHeroTitle === 'true')
           ?? spans.find((element) => ['探索未至之境', 'Into the Unknown'].includes(element.textContent?.trim()))
@@ -1876,12 +1894,12 @@ window.__ModuleLoader__.load({
         if (title) {
           if (!changedTitles.has(title)) changedTitles.set(title, title.textContent ?? '');
           title.dataset.dcAgentHeroTitle = 'true';
-          if (title.textContent !== '数据清洗补全智能体') title.textContent = '数据清洗补全智能体';
+          if (title.textContent !== '数据清洗补全智能体') { title.textContent = '数据清洗补全智能体'; mutated = true; }
         }
         if (badge) {
           if (!changedBadges.has(badge)) changedBadges.set(badge, badge.style?.display ?? '');
           badge.dataset.dcAgentHeroBadge = 'true';
-          if (badge.style && badge.style.display !== 'none') badge.style.display = 'none';
+          if (badge.style && badge.style.display !== 'none') { badge.style.display = 'none'; mutated = true; }
         }
 
         const foreignSurfaces = composerStack?.querySelectorAll?.('[aria-label="尽调类型"], .qccDock') ?? [];
@@ -1897,13 +1915,20 @@ window.__ModuleLoader__.load({
           if ((hideTarget?.parentElement === composerStack || hideTarget?.parentElement === marker.parentElement)
             && !hideTarget.contains?.(marker)) {
             if (!hiddenForeignDocks.has(hideTarget)) hiddenForeignDocks.set(hideTarget, hideTarget.style?.display ?? '');
-            if (hideTarget.style && hideTarget.style.display !== 'none') hideTarget.style.display = 'none';
+            if (hideTarget.style && hideTarget.style.display !== 'none') { hideTarget.style.display = 'none'; mutated = true; }
+          }
+        }
+        if (mutated) {
+          corrections += 1;
+          if (corrections >= MAX_HERO_CORRECTIONS && observer) {
+            observer.disconnect();
+            observer = null;
           }
         }
       };
 
       fix();
-      const observer = typeof MutationObserver === 'function' ? new MutationObserver(fix) : null;
+      observer = typeof MutationObserver === 'function' ? new MutationObserver(fix) : null;
       observer?.observe?.(hero, { childList: true, subtree: true });
       return () => {
         observer?.disconnect?.();
@@ -1955,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());
@@ -2025,8 +2060,8 @@ window.__ModuleLoader__.load({
                 type: 'image', fileName: imageFileName, sizeBytes: imageSizeBytes,
               });
               setError(null);
-              setWizardStep(2);
-              setOpen(true);
+              setOpen(false);
+              requestWorkbenchOpen('upload', sessionId);
               return;
             }
             if (command.state === 'failed') {
@@ -2141,8 +2176,9 @@ window.__ModuleLoader__.load({
         if (mode === 'text' && !values.length) return '请先录入企业名称或统一社会信用代码，每行一条。';
         if (mode === 'excel' && !values.length) return '请先上传并解析 Excel / CSV / JSON 文件。';
         if (mode === 'image' && !imageCommand) return '请先选择、粘贴或拖入一张包含企业名单的图片。';
-        if (mode === 'image' && imageCommand?.state !== 'completed') return '请先把图片识别指令回填到对话框并发送，等待名单识别完成。';
-        if (mode === 'image' && !values.length) return '图片中未提取到可核验的企业名称或统一社会信用代码。';
+        if (mode === 'image' && imageCommand?.state === 'failed') return imageCommand.error?.message || '图片识别失败，请重新选择图片。';
+        if (mode === 'image' && imageCommand?.state === 'running') return '图片正在通过企查查智能文档解析识别，请稍候。';
+        if (mode === 'image' && imageCommand?.state === 'completed' && !values.length) return '图片中未提取到可核验的企业名称或统一社会信用代码。';
         return null;
       };
       const promptConfig = () => ({
@@ -2154,6 +2190,8 @@ window.__ModuleLoader__.load({
         enrichmentKeys,
         anchorKeys,
         matchRules,
+        imageCommandId: imageCommand?.commandId ?? '',
+        imageState: imageCommand?.state ?? null,
       });
       const generatePrompt = () => {
         const sourceError = validateSource();
@@ -2165,6 +2203,11 @@ window.__ModuleLoader__.load({
           return;
         }
         const config = promptConfig();
+        if (mode === 'image' && imageCommand?.state === 'prepared' && imageAttachment && typeof removeImage === 'function') {
+          // qcc-document-mcp 只读取 Host 暂存文件；发送前释放原生附件，文本模型不会收到图片。
+          removeImage(sessionId, imageAttachment);
+          setImageAttachment(null);
+        }
         inputActions.setDraft(buildTaskPrompt(config));
         if (mode === 'text') {
           requestWorkbenchDataset(entriesToDataset(config.entries), sessionId, { type: 'text', fileName: '' });
@@ -2183,22 +2226,6 @@ window.__ModuleLoader__.load({
 
       const nextWizard = () => {
         if (wizardStep === 1) {
-          if (mode === 'image' && imageCommand?.state === 'prepared') {
-            if (!inputActions || typeof inputActions.setDraft !== 'function') {
-              setError('当前会话输入机尚未就绪，请稍后重试。');
-              return;
-            }
-            // Host 已持久暂存图片；发送识别命令前释放 Composer 附件，避免不支持
-            // 视觉输入的文本模型拒绝本轮。识别工具只按 commandId 读取 Host 暂存副本。
-            if (imageAttachment && typeof removeImage === 'function') {
-              removeImage(sessionId, imageAttachment);
-              setImageAttachment(null);
-            }
-            inputActions.setDraft(imageCommand.prompt);
-            setError(null);
-            setOpen(false);
-            return;
-          }
           const sourceError = validateSource();
           if (sourceError) { setError(sourceError); return; }
         }
@@ -2226,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"]'));
@@ -2329,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);
@@ -2340,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。图片会在对话框显示缩略图，点击可放大。'),
@@ -2358,7 +2385,7 @@ window.__ModuleLoader__.load({
                       ? '识别中…'
                       : imageCommand?.state === 'failed'
                         ? '识别失败，可移除后重试'
-                        : '已暂存，下一步生成可编辑识别指令'),
+                        : '已暂存，可继续选择匹配规则和补全字段'),
                 ),
                 h('button', { type: 'button', className: 'dcAgentPromptImageRemove', disabled: busy || imageCommand?.state === 'running', onClick: removeCurrentImage }, '移除'),
               ) : h('label', { className: 'dcAgentPromptFile' },
@@ -2420,14 +2447,15 @@ 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)) }, '上一步'),
             h('button', { type: 'button', className: 'dcAgentPromptAction is-primary', disabled: busy || imageCommand?.state === 'running', onClick: nextWizard }, busy
               ? '处理中…'
-              : wizardStep === 1 && mode === 'image' && imageCommand?.state === 'prepared'
-                ? '回填图片识别指令'
-                : wizardStep === 1 && mode === 'image' && imageCommand?.state === 'running'
+              : wizardStep === 1 && mode === 'image' && imageCommand?.state === 'running'
                   ? '图片识别中…'
                   : wizardStep === 4 ? '回填到对话框' : '下一步'),
           ),
@@ -3776,6 +3804,7 @@ window.__ModuleLoader__.load({
       clearCleaningDraft,
       entriesToDataset,
       extractPromptEntries,
+      imageFilesFromTransfer,
       guessMappings,
       deactivateCleaningSession,
       installSessionOwnershipBridge,

package/lib/image-intake.js

@@ -1,9 +1,10 @@
 /**
  * 图片企业名单接入。
  *
- * Browser 只负责把用户明确选择/粘贴的图片暂存到 Host；真实视觉识别由
- * Agent-owned 高层工具在当前会话执行上下文中调用已探测到的 Provider。
- * 当前已验证 Provider 是 modlens_read_image。图片使用 0600 临时文件，识别
+ * Browser 只负责把用户明确选择/粘贴的图片暂存到 Host；真实文字识别由
+ * Agent-owned 高层工具在当前会话执行上下文中调用企查查智能文档解析 MCP。
+ * 本地图片必须走官方 qcc-document-mcp（file_path），远端 qcc-document 只接受
+ * 公网 file_url，不能直接读取 Host 临时文件。图片使用 0600 临时文件，识别
  * 完成、失败、取消或 TTL 到期后立即删除；不会进入 storageDomain 或导出制品。
  */
 import { randomUUID } from 'node:crypto';
@@ -12,7 +13,26 @@ import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 
 export const TOOL_IMAGE_EXTRACT = 'data_cleaning_extract_image_companies';
-export const IMAGE_PROVIDER_MODLENS = 'modlens_read_image';
+export const IMAGE_PROVIDER_QCC_DOCUMENT_LOCAL = 'qcc-document-mcp';
+export const QCC_DOCUMENT_REMOTE_PARSE = 'mcp__qcc-document__parse_document';
+export const QCC_DOCUMENT_LOCAL_TOOL_PAIRS = Object.freeze([
+  Object.freeze({
+    parse: 'mcp__document__parse_document',
+    result: 'mcp__document__get_parse_result',
+  }),
+  Object.freeze({
+    parse: 'mcp__qcc-document-mcp__parse_document',
+    result: 'mcp__qcc-document-mcp__get_parse_result',
+  }),
+  Object.freeze({
+    parse: 'mcp__qcc-document-local__parse_document',
+    result: 'mcp__qcc-document-local__get_parse_result',
+  }),
+  Object.freeze({
+    parse: 'mcp__document-mcp__parse_document',
+    result: 'mcp__document-mcp__get_parse_result',
+  }),
+]);
 
 export const IMAGE_LIMITS = Object.freeze({
   maxBytes: 8 * 1024 * 1024,
@@ -76,6 +96,7 @@ function unwrapProviderValue(result) {
     throw new ImageIntakeError('DC_IMAGE_PROVIDER_FAILED', String(message), 502);
   }
   let value = result?.value ?? result;
+  if (value?.structuredContent !== undefined) value = value.structuredContent;
   if (value && Array.isArray(value.content)) {
     const text = value.content.filter((item) => item?.type === 'text').map((item) => item.text).join('\n');
     if (text) {
@@ -87,6 +108,11 @@ function unwrapProviderValue(result) {
 
 export function providerText(result) {
   const value = unwrapProviderValue(result);
+  const markdown = [
+    ...(Array.isArray(value?.details) ? value.details : []),
+    value,
+  ].map((detail) => String(detail?.result_md ?? detail?.resultMd ?? '').trim()).filter(Boolean).join('\n');
+  if (markdown) return markdown;
   const lines = Array.isArray(value?.ocr?.lines)
     ? value.ocr.lines.map((line) => String(line?.text ?? '').trim()).filter(Boolean)
     : [];
@@ -97,6 +123,77 @@ export function providerText(result) {
   return text;
 }
 
+function providerEnvelope(result) {
+  const value = unwrapProviderValue(result);
+  if (typeof value === 'string') return { status: 'success', details: [{ result_md: value }] };
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    throw new ImageIntakeError('DC_IMAGE_DOCUMENT_CONTRACT', '企查查智能文档解析返回了无法识别的结果。', 502);
+  }
+  return value;
+}
+
+function documentStatus(value) {
+  const raw = String(value?.status ?? value?.state ?? '').trim().toLowerCase();
+  if (['success', 'succeeded', 'completed', 'complete', 'done'].includes(raw)) return 'success';
+  if (['failed', 'failure', 'error', 'cancelled', 'canceled'].includes(raw)) return 'failed';
+  if (['processing', 'pending', 'queued', 'running', 'accepted', 'submitted'].includes(raw)) return 'processing';
+  if (providerTextOrEmpty(value)) return 'success';
+  return raw || 'processing';
+}
+
+function providerTextOrEmpty(value) {
+  try { return providerText(value); } catch { return ''; }
+}
+
+function providerTaskId(value) {
+  return String(value?.task_id ?? value?.taskId ?? '').trim();
+}
+
+function documentFailure(value) {
+  const code = String(value?.error?.code ?? value?.code ?? '').trim();
+  const auth = /(?:^|\D)(?:401|403)(?:\D|$)|AUTH|TOKEN|CREDENTIAL/i.test(`${code} ${value?.message ?? ''}`);
+  if (auth) {
+    return new ImageIntakeError(
+      'DC_IMAGE_QCC_AUTH_REQUIRED',
+      '企查查本地文档解析连接未授权或授权已失效，请配置 qcc-document-mcp 后重试。',
+      401,
+    );
+  }
+  return new ImageIntakeError(
+    'DC_IMAGE_DOCUMENT_FAILED',
+    code ? `企查查智能文档解析失败（错误码 ${code}），请检查图片后重试。` : '企查查智能文档解析失败，请检查图片后重试。',
+    502,
+  );
+}
+
+function delay(ms, signal) {
+  if (signal?.aborted) return Promise.reject(signal.reason ?? new Error('aborted'));
+  return new Promise((resolve, reject) => {
+    const finish = () => {
+      signal?.removeEventListener('abort', abort);
+      resolve();
+    };
+    const timer = setTimeout(finish, ms);
+    const abort = () => {
+      clearTimeout(timer);
+      signal?.removeEventListener('abort', abort);
+      reject(signal.reason ?? new Error('aborted'));
+    };
+    signal?.addEventListener('abort', abort, { once: true });
+  });
+}
+
+function definitionParameters(definition) {
+  return definition?.parameters ?? definition?.schema?.parameters ?? definition?.inputSchema ?? null;
+}
+
+function supportsLocalPath(definition, name) {
+  const parameters = definitionParameters(definition);
+  if (parameters?.properties?.file_path) return true;
+  // 官方 npm 服务的稳定 serverName；旧 DSH 投射可能不保留完整 input schema。
+  return /(?:qcc-)?document-(?:mcp|local)__parse_document$/.test(String(name ?? ''));
+}
+
 const CREDIT_RE = /\b[0-9A-HJ-NPQRTUWXY]{18}\b/gi;
 const COMPANY_END = '(?:有限责任公司|股份有限公司|集团有限公司|有限公司|集团公司|公司|普通合伙|有限合伙|合伙企业|个人独资企业|农民专业合作社|合作社|事务所|研究院|研究所|中心|商行|工厂|厂)';
 const COMPANY_RE = new RegExp(`[\\p{Script=Han}A-Za-z0-9（）()·&＋+—\\-]{2,72}${COMPANY_END}`, 'gu');
@@ -158,6 +255,7 @@ function publicRecord(record, now = Date.now()) {
     mimeType: record.mimeType,
     sizeBytes: record.sizeBytes,
     provider: record.provider,
+    parseTool: record.parseTool,
     createdAt: record.createdAt,
     updatedAt: record.updatedAt,
     expiresInMs: Math.max(0, record.expiresAt - now),
@@ -172,35 +270,83 @@ function safeFailure(error) {
   }
   return {
     code: 'DC_IMAGE_PROVIDER_FAILED',
-    message: '图片识别 Provider 当前不可用或配置无效。请配置 Modlens 可用视觉通道，或改用文本/Excel 名单。',
+    message: '企查查智能文档解析当前不可用或配置无效。请连接本地 qcc-document-mcp，或改用文本/Excel 名单。',
   };
 }
 
 export class ImageIntakeStore {
-  constructor({ tools, clock = () => Date.now(), ttlMs = IMAGE_LIMITS.ttlMs } = {}) {
+  constructor({
+    tools,
+    clock = () => Date.now(),
+    ttlMs = IMAGE_LIMITS.ttlMs,
+    pollMs = 500,
+    maxPolls = 60,
+  } = {}) {
     if (!tools || typeof tools.get !== 'function' || typeof tools.execute !== 'function') {
       throw new TypeError('ImageIntakeStore requires ctx.tools get/execute');
     }
     this.tools = tools;
     this.clock = clock;
     this.ttlMs = ttlMs;
+    this.pollMs = pollMs;
+    this.maxPolls = maxPolls;
     this.records = new Map();
   }
 
-  providerDefinition() {
-    try { return this.tools.get(IMAGE_PROVIDER_MODLENS); } catch { return undefined; }
+  toolDefinition(name) {
+    try { return this.tools.get(name); } catch { return undefined; }
+  }
+
+  providerDefinition(preferredParseTool) {
+    const pairs = preferredParseTool
+      ? [...QCC_DOCUMENT_LOCAL_TOOL_PAIRS].sort((left) => left.parse === preferredParseTool ? -1 : 1)
+      : QCC_DOCUMENT_LOCAL_TOOL_PAIRS;
+    for (const pair of pairs) {
+      const parse = this.toolDefinition(pair.parse);
+      const result = this.toolDefinition(pair.result);
+      if (parse && result && supportsLocalPath(parse, parse.name ?? pair.parse)) {
+        return {
+          provider: IMAGE_PROVIDER_QCC_DOCUMENT_LOCAL,
+          parse,
+          result,
+          parseName: parse.name ?? pair.parse,
+          resultName: result.name ?? pair.result,
+        };
+      }
+    }
+    return null;
+  }
+
+  remoteDefinition() {
+    const candidates = [
+      QCC_DOCUMENT_REMOTE_PARSE,
+      ...QCC_DOCUMENT_LOCAL_TOOL_PAIRS.map((pair) => pair.parse),
+    ];
+    for (const name of candidates) {
+      const definition = this.toolDefinition(name);
+      const parameters = definitionParameters(definition);
+      if (definition && parameters?.properties?.file_url && !parameters?.properties?.file_path) {
+        return definition;
+      }
+    }
+    return this.toolDefinition(QCC_DOCUMENT_REMOTE_PARSE);
   }
 
   capabilities() {
     const definition = this.providerDefinition();
     return {
       ready: Boolean(definition),
-      provider: definition ? IMAGE_PROVIDER_MODLENS : null,
+      provider: definition?.provider ?? null,
+      parseTool: definition?.parseName ?? null,
+      resultTool: definition?.resultName ?? null,
+      remoteUrlOnlyConnected: Boolean(this.remoteDefinition()),
+      localFileConnectorRequired: !definition,
       nativeAttachmentUi: true,
       pasteAndDrop: true,
       formats: ['image/png', 'image/jpeg', 'image/webp'],
       limits: IMAGE_LIMITS,
       persistence: 'ephemeral-host-file',
+      billing: 'current-user-qcc-document-account',
     };
   }
 
@@ -249,13 +395,6 @@ export class ImageIntakeStore {
   async prepare(input = {}) {
     await this.cleanup();
     const provider = this.providerDefinition();
-    if (!provider) {
-      throw new ImageIntakeError(
-        'DC_IMAGE_PROVIDER_UNAVAILABLE',
-        '当前 DSH 没有可用的图片文字识别 Provider。请安装并配置 Modlens，或改用文本/Excel 名单。',
-        503,
-      );
-    }
     const decoded = decodeImage(input.content);
     const commandId = `dci-${randomUUID()}`;
     const at = new Date(this.clock()).toISOString();
@@ -268,7 +407,9 @@ export class ImageIntakeStore {
       fileName: safeName(input.fileName),
       mimeType: decoded.mimeType,
       sizeBytes: decoded.bytes.length,
-      provider: IMAGE_PROVIDER_MODLENS,
+      provider: IMAGE_PROVIDER_QCC_DOCUMENT_LOCAL,
+      parseTool: provider?.parseName ?? null,
+      resultTool: provider?.resultName ?? null,
       path,
       createdAt: at,
       updatedAt: at,
@@ -280,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) {
@@ -293,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) {
@@ -303,25 +460,44 @@ export class ImageIntakeStore {
     }
     if (record.promise) return record.promise;
     if (record.state === 'completed') return { commandId, ...record.result };
-    const provider = this.providerDefinition();
+    const provider = this.providerDefinition(record.parseTool);
     if (!provider) {
-      throw new ImageIntakeError('DC_IMAGE_PROVIDER_UNAVAILABLE', '图片识别 Provider 已离线。', 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();
-    record.promise = this.tools.execute({
-      name: provider.name ?? IMAGE_PROVIDER_MODLENS,
+    const execute = (name, args) => this.tools.execute({
+      name,
       callId: `dc-image-${randomUUID()}`,
       rootCallId: exec.rootCallId,
       parent: exec.token,
       agent: exec.agent,
       signal: exec.signal,
-      arguments: {
-        path: record.path,
-        prompt: '完整识别图片中的企业名单。重点逐行转写企业全称、统一社会信用代码或注册号；保留原始文字，不猜测模糊字符。',
-      },
-    }).then(async (providerResult) => {
-      const text = providerText(providerResult);
+      arguments: args,
+    });
+    record.promise = execute(provider.parseName, {
+      file_path: record.path,
+      wait: true,
+    }).then(async (parseResult) => {
+      let envelope = providerEnvelope(parseResult);
+      let status = documentStatus(envelope);
+      const taskId = providerTaskId(envelope);
+      for (let poll = 0; status === 'processing' && poll < this.maxPolls; poll += 1) {
+        if (!taskId) {
+          throw new ImageIntakeError('DC_IMAGE_DOCUMENT_CONTRACT', '企查查文档解析未返回 task_id。', 502);
+        }
+        await delay(this.pollMs, exec.signal);
+        envelope = providerEnvelope(await execute(provider.resultName, { task_id: taskId }));
+        status = documentStatus(envelope);
+      }
+      if (status === 'processing') {
+        throw new ImageIntakeError('DC_IMAGE_DOCUMENT_TIMEOUT', '企查查文档解析仍在处理中，请稍后重新识别。', 504);
+      }
+      if (status === 'failed') throw documentFailure(envelope);
+      const text = providerText(envelope);
       const entries = extractCompanyEntries(text);
       if (!entries.length) {
         throw new ImageIntakeError('DC_IMAGE_NO_COMPANY', '图片文字已识别，但未提取到企业全称或 18 位统一社会信用代码。', 422);
@@ -368,22 +544,22 @@ export class ImageIntakeStore {
 
 export function serializeImageExtractionPrompt(command) {
   return [
-    '请识别我刚刚在向导中安全暂存的企业名单图片，并把识别结果交回数据清洗补全工作台供我逐条核验。',
+    '请使用企查查智能文档解析识别我刚刚在向导中安全暂存的企业名单图片，并把结果交回数据清洗补全工作台供我逐条核验。',
     '',
     `图片文件：${command.fileName}。`,
     '识别目标：逐行提取企业全称、18 位统一社会信用代码或注册号；不得猜测模糊字符。',
-    '本步骤只做图片文字识别与名单提取，不调用企查查，不消耗企查查 MCP 额度。',
+    '本步骤会使用当前用户自己连接的企查查 qcc-document-mcp；文档解析额度或费用由该账号自行承担。',
     `安全图片凭证：${command.commandId}`,
     '',
     `发送本说明后，请仅调用一次图片名单识别工具（${TOOL_IMAGE_EXTRACT}），参数只传递上述安全图片凭证。`,
-    '工具完成后立即结束本轮；不要直接调用任何 mcp__qcc-* 工具。',
+    '高层工具会在 Host 内准确调用一次 parse_document，并只在异步处理中查询 get_parse_result；不要绕过高层工具直接调用任何 mcp__qcc-* 工具。',
   ].join('\n');
 }
 
 export function registerImageIntakeTool(tools, store) {
   return tools.register({
     name: TOOL_IMAGE_EXTRACT,
-    description: 'Recognize one already-staged company-list image. Call only when a visible data-cleaning prompt supplies a dci-* commandId. The Host owns the temporary image and invokes the available vision provider in the current Agent execution.',
+    description: 'Parse one already-staged local company-list image through QCC qcc-document-mcp. Call only when a visible data-cleaning prompt supplies a dci-* commandId. The Host owns the temporary image, calls parse_document once, and polls get_parse_result only while the returned task is processing.',
     parameters: {
       type: 'object',
       additionalProperties: false,
@@ -404,7 +580,7 @@ export function registerImageIntakeTool(tools, store) {
       },
       render: (_args, value) => [{
         type: 'text',
-        text: `图片企业名单已识别：${value.entryCount} 条，已同步回数据清洗补全工作台等待核验。`,
+        text: `企查查智能文档解析已识别图片企业名单：${value.entryCount} 条，已同步回数据清洗补全工作台等待核验。`,
       }],
     },
     async execute(args, exec) {

package/lib/web.js

@@ -384,7 +384,8 @@ export function mountWebRoutes(wctx, { logger, report, TOOL_NAME, SKILL_NAME })
       tool: TOOL_IMAGE_EXTRACT,
       toolRegistered: report.imageIntakeToolRegistered === true,
       capabilities: imageIntake.capabilities(),
-      qccCalls: false,
+      qccCalls: true,
+      billing: 'current-user-qcc-document-account',
     });
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-data-cleaning-agent",
-  "version": "0.8.0",
+  "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",
@@ -37,6 +37,7 @@
     "docs/RELEASE-0.6.3.md",
     "docs/RELEASE-0.7.0.md",
     "docs/RELEASE-0.8.0.md",
+    "docs/RELEASE-0.8.1.md",
     "docs/UI-WORKFLOW-V2.md",
     "docs/UI-WORKFLOW-V2-MIGRATION.md",
     "docs/UI-WORKFLOW-V2-ACCEPTANCE.md",