dsh-data-cleaning-agent 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -4,6 +4,20 @@
 
 ## [Unreleased]
 
+## [0.8.0] - 2026-09-05
+
+### Added
+- 新增企业名单图片接入：数据清洗补全会话 Composer 可直接粘贴图片，提示词向导支持 PNG/JPEG/WebP 粘贴、拖入与选择。
+- 图片使用 DSH 原生 draft attachment，向导显示 64px 缩略图、文件信息、移除操作和可点击放大的预览。
+- Host 暂存完成后，回填识别说明前自动释放 Composer 图片附件，避免文本模型因不支持图片而拒绝执行。
+- 新增 Agent-owned `data_cleaning_extract_image_companies` 高层工具与 `/data-cleaning/api/images/*` Host 指令/状态契约；运行时探测 `modlens_read_image` 并以 nested execution 识别企业名称和统一社会信用代码。
+- 识别结果自动回传原四步向导供人工核对，然后进入既有 taskId 字段选择、主体匹配、QCC 补全和导出流程。
+
+### Security
+- 图片上限 8 MiB，按 PNG/JPEG/WebP 魔数验证；Host 临时目录为 0700、文件为 0600，成功、失败、取消或 TTL 到期后删除。
+- 原图不进入 `storageDomain`、模型任务 KV 或导出制品；识别指令仅暴露随机 commandId，不包含 Host 文件路径。
+- Provider 未安装时 fail closed；图片识别阶段不调用 QCC，后续匹配补全仍受客户自有 QCC 账号确认门保护。
+
 ## [0.7.0] - 2026-09-05
 
 ### Added

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.7.0** (stable release)
+> Current source version / 当前源码版本: **0.8.0** (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,6 +49,15 @@ 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.
+
 Without the `dsh` CLI, use the install script:
 
 ```bash
@@ -73,7 +82,8 @@ Or let an agent install it for you:
 | Durable artifacts | Host workspace `.dsh-data-cleaning-artifacts/v1` | result/exception CSV+XLSX, checksum verification, restart-safe download |
 | In-app entry | top "Data Cleaning & Completion" entry + five actions below the composer | dedicated business home in the center; opens the Mockup-aligned workbench on demand |
 | Prompt builder | `conversation.input.overlay` | text / spreadsheet / image intake, cleaning and enrichment selection, editable native-composer draft |
-| Tool cards | `tool.call.toolview` (`data_clean_rows`/`data_complete_rows`/`data_profile`) | render clean/complete/profile result cards in-conversation with running/done/failed state |
+| Image list intake | `data_cleaning_extract_image_companies` + web `/data-cleaning/api/images/*` | native thumbnail/lightbox, paste/drop, ephemeral Host image, Agent-owned provider recognition, human review; no QCC call during recognition |
+| Tool cards | `tool.call.toolview` (clean/complete/profile/image-list) | render four tool result cards in-conversation with running/done/failed state |
 | Task progress | workbench header jobs pill | polls `/data-cleaning/api/mvp/jobs`; shows queued / running tasks |
 | Skill | `data-cleaning` | guides the model through the workflow |
 | QCC Skill enrichment | `enterprise-enrichment` | 0.4.0: company panorama, ownership, governance, and historical registration |
@@ -119,6 +129,8 @@ See [the 0.5.2 release record](docs/RELEASE-0.5.2.md) for native DSH UI alignmen
 See [the 0.5.3 release record](docs/RELEASE-0.5.3.md) for the business landing view and prompt builder.
 See [the 0.7.0 release record](docs/RELEASE-0.7.0.md) for the first 40 and second 58
 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.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.7.0**（正式版本）
+> 当前源码版本 / Current source version: **0.8.0**（正式版本）
 
 [![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,6 +42,13 @@ 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。
+
 没有 `dsh` CLI 时，也可以用安装脚本：
 
 ```bash
@@ -66,7 +73,8 @@ 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 / 图片录入、清洗项与补全维度选择，生成后回填原生输入框供人工修改 |
-| 工具卡片 | `tool.call.toolview`（`data_clean_rows`/`data_complete_rows`/`data_profile`） | 对话内渲染清洗/补全/画像结果卡，含运行/已完成/失败状态 |
+| 图片名单 | `data_cleaning_extract_image_companies` + web `/data-cleaning/api/images/*` | 原生缩略图/放大、粘贴/拖入；Host 临时图片 + Agent-owned Provider 识别 + 人工核对，识别阶段不调用 QCC |
+| 工具卡片 | `tool.call.toolview`（清洗/补全/画像/图片名单） | 对话内渲染四类工具结果卡，含运行/已完成/失败状态 |
 | 任务进度 | 工作台头部任务 pill | 轮询 `/data-cleaning/api/mvp/jobs`，展示排队/运行中任务 |
 | Skill | `data-cleaning` | 引导模型按工作流调度上述工具 |
 | 企查查 Skill 补全 | `enterprise-enrichment` | 0.4.0：工商全景、股权穿透与历史工商 |
@@ -114,7 +122,8 @@ bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-data-cleaning-a
 0.5.2 DSH 原生 UI 对齐范围、验收与回滚见 [docs/RELEASE-0.5.2.md](docs/RELEASE-0.5.2.md)。
 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.6.3 多行名单解析、可编辑执行说明与工作台遮挡修复见
+[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.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

@@ -38,6 +38,18 @@ MVP 路由、Phase-3 capabilities、estimate 与未确认 enrich 阻断均通过
 后可按原 taskId 下载，XLSX 反向解析工作表为“清洗补全结果”。稳定发布判断仍以 rc.2 为主，
 alpha.2 只作兼容探针。全程未触碰生产 43120，未调用 QCC。
 
+0.8.0 图片名单接入在 DSH `0.1.1-rc.2` 验证了官方
+`conversation.createDraftImages` / `releaseDraftImage(s)` 与
+`conversation.input.shell(sessionId).addImages/removeImage` 能力。视觉识别 Provider 通过
+`ctx.tools.get()` 运行时探测，已验证 `@liustack/modlens@3.25.2` 的
+`modlens_read_image`；本包不将它声明为强依赖。如 Provider 不存在，Host 在写入临时图片前
+返回 `DC_IMAGE_PROVIDER_UNAVAILABLE`，不降级为未验证 API。alpha.2 仅继续作 Host/Client 能力探针，
+不承诺实验性附件 API 稳定。
+
+图片完成 Host 暂存后，Client 会在回填识别指令前调用 `removeImage` 释放 Composer 附件；后续
+Agent-owned 工具通过 `dci-*` 凭证读取 Host 临时副本。因此图片选择与预览沿用 DSH 原生 UI，实际识别轮仍是
+文本模型可接受的纯文本工具调用。
+
 ## 2. Node 运行时
 
 - 本包 `engines.node` 声明 `>=20`。
@@ -57,6 +69,8 @@ alpha.2 只作兼容探针。全程未触碰生产 43120，未调用 QCC。
 | web 路由 | `webServer.register({kind:'prefix', path, handler})` | 最长前缀匹配；前缀需以 `/` 结尾且匹配 `pathname.startsWith(prefix + '/')` |
 | 同源守卫 | `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 强依赖 |
 
 ## 4. 与企查查 MCP OAuth 插件的共存
 

package/docs/RELEASE-0.8.0.md

@@ -0,0 +1,60 @@
+# dsh-data-cleaning-agent 0.8.0 发布记录
+
+> 日期：2026-09-05
+> 主题：图片企业名单粘贴、原生缩略图、Agent-owned OCR 与人工核对闭环
+
+## 1. 产品结果
+
+0.8.0 把早期“只把图片附加到对话”的兼容 Bridge 升级为完整可执行流程：
+
+1. 用户在「数据清洗补全」会话原生 Composer 直接粘贴图片，或在提示词向导粘贴、拖入、选择图片。
+2. DSH 原生 draft attachment 展示缩略图；向导另提供 64px 缩略图、移除和放大预览。
+3. Host 临时保存原图并只向可编辑的对话说明回填随机 `dci-*` commandId；回填前释放 Composer 图片附件，使本轮成为文本模型也能接受的纯文本调用。
+4. 用户发送说明后，Agent 只调用一次 `data_cleaning_extract_image_companies`。该高层工具以父执行 token/Session 调用已探测的图片文字 Provider。
+5. Host 确定性抽取企业全称与 18 位统一社会信用代码，去重后回传向导。
+6. 用户核对名单、选择匹配主键、清洗目标和补全字段，再进入原有 taskId 主体匹配与 QCC 补全闭环。
+
+## 2. 已验证与建议的边界
+
+### 已验证事实
+
+- DSH `0.1.1-rc.2` 提供 `conversation.createDraftImages` / `releaseDraftImage(s)` 与 `conversation.input.shell(sessionId).addImages/removeImage`。
+- 当前本机 DSH Profile 中 `@liustack/modlens@3.25.2` 注册 `modlens_read_image`，入参为本地 `path` 和可选 `prompt`，返回 OCR 文本/行。
+- QCC `parse_document` 只接受公网 HTTP(S) 文档；当前未验证任何可安全上传本地图片的 QCC 工具，因此本版不硬编码 QCC 智能文档解析。
+
+### 设计建议
+
+- Modlens 作为可选 Provider，不是本 npm 包的直接依赖；运行时以 `ctx.tools.get('modlens_read_image')` 探测。
+- 未来如 DSH 发布稳定的原生图片内容读取接口，可在 Provider 适配层新增实现，不改变 Web 指令和 taskId 契约。
+
+## 3. 安全与费用
+
+- 格式：PNG/JPEG/WebP；严格魔数验证；单张上限 8 MiB；单图最多输出 100 个主体标识。
+- 临时目录 0700、文件 0600；识别成功、失败、用户移除或 15 分钟 TTL 到期后删除。
+- 原图不进入 `storageDomain`、任务元数据或导出制品；对话中不显示 Host 文件路径。
+- 图片识别不调用 QCC，所以不产生 QCC MCP 额度消耗。核对后的企业匹配/字段补全仍由当前用户使用自己连接的 QCC 账号。
+
+## 4. 验收门
+
+- `npm run check`：lint、中英文版本、市场素材、npm pack 白名单与全量自动化测试。
+- 图片契约测试：魔数验证、OCR 两企业抽取/去重、Provider 输出兼容、Agent-owned nested execution、临时文件清理、Provider 缺失 fail closed。
+- Web 契约测试：预检与暂存为零 QCC 调用，只有高层图片工具可调 Provider，状态轮询可取回两条名单。
+- Client 契约测试：DSH 原生 attachment 增删、Composer 图片粘贴捕获、缩略图/放大、可读指令与四工具 toolview 注册。
+
+## 5. 升级与回滚
+
+```bash
+dsh plugin --profile web add dsh-data-cleaning-agent@0.8.0
+# 完全停止后重启
+dsh web
+```
+
+回滚不需要迁移 Host 数据；0.8.0 未修改 `dc_workflows_v2` 或制品 schema：
+
+```bash
+dsh plugin --profile web add dsh-data-cleaning-agent@0.7.0
+# 完全停止后重启
+dsh web
+```
+
+回滚前若有尚未发送的图片识别指令，关闭/重启 Host 即可清理临时图片；已有的清洗补全任务和导出制品不受影响。

package/docs/UI-WORKFLOW-V2.md

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

package/docs/USER-GUIDE.md

@@ -40,11 +40,15 @@ bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-data-cleaning-a
 
 - **粘贴名单**：每行一个企业名称或统一社会信用代码；
 - **上传 Excel**：支持 XLSX/XLS/CSV/JSON，识别企业名称/信用代码列并把完整数据载入右侧工作台；
-- **上传图片**：把 PNG/JPEG/WebP 附加到当前原生对话，并生成“使用当前已连接且可用的企查查智能文档解析 MCP”要求。
+- **上传图片**：支持 PNG/JPEG/WebP（单张不超过 8 MiB）；可在向导中粘贴、拖入或选择，也可直接在数据清洗补全会话的原生输入框粘贴。输入框使用 DSH 原生图片附件，向导同时显示 64px 缩略图，点击可放大。
 
 随后可选择名称规范、信用代码校验、去重、模糊候选复核等清洗动作，以及工商字段或已支持的维度组。
-点击「生成并回填」后，任务描述进入原生对话框；发送前仍可人工修改。图片能力不可用时，请改用输入框
-原生“＋”或文本/Excel。提示词生成器不会硬编码未验证的 QCC 工具名，也不会绕过付费确认门。
+图片流程分为两轮可见交互：
+
+1. 选择图片后，点击「回填图片识别指令」。此时 Host 已安全暂存原图，Client 会释放 Composer 图片附件并把可读的纯文本说明放入原生对话框；用户检查后发送。该步骤不会把图片交给当前聊天模型，因此兼容不支持视觉输入的文本模型。
+2. Agent 只调用一次 `data_cleaning_extract_image_companies`，Host 在当前父执行中调用已探测的图片文字 Provider；识别到的企业名称/统一社会信用代码会回到向导，由用户逐条核对后选择匹配规则和补全字段。
+
+当前已验证 Provider 是 Modlens `modlens_read_image`。插件不引入对 Modlens 的强依赖；运行时未安装或未配置时会 fail closed，请改用文本/Excel。图片仅作为 0600 权限的 Host 临时文件，成功、失败、取消或 15 分钟超时后删除；不进入任务 KV 或导出制品。识别阶段不调用 QCC、不消耗 QCC MCP 额度；人工核对后的匹配/补全仍受既有 BYO QCC 确认门保护。
 
 模型在对话中调用 `data_clean_rows` / `data_complete_rows` / `data_profile` 时，
 对话内会渲染对应的工具结果卡片（含运行中 / 已完成 / 失败状态）；工作台头部用任务 pill