dsh-data-cleaning-agent 0.6.0 → 0.6.2

package/CHANGELOG.md

@@ -4,6 +4,35 @@
 
 ## [Unreleased]
 
+## [0.6.2] - 2026-09-04
+
+### Fixed
+- 清洗补全结果 CSV/XLSX 的插件字段与状态字段统一导出为中文表头，并按任务字段选择保留空值列，
+  不再因企查查未返回某一字段而从制品中静默丢列。
+- 将任务选择的补全字段贯穿中央工作台、Agent-owned 命令、G5 Host Bridge、任务恢复与耐久制品；
+  工商详情补充注册地址、行政区划、经营范围、行业、营业期限和企业规模映射，企业简介等画像字段按需
+  调用 `get_company_profile`，且不把未声明层级的“企查查行业”猜测为一级/二级行业。
+
+## [0.6.1] - 2026-09-04
+
+### Fixed
+- 修复 DSH Code Mode 下同源 Web 路由直接调用动态 QCC 工具会被 ToolRuntime 拒绝的问题：新增
+  `data_cleaning_qcc_run` Agent-owned 高层工具，工作台仅在 Host 暂存明细并向原生会话发送不含企业
+  名单的 commandId；真实 QCC 调用以父执行 token/Session 的 nested execution 运行。
+- 当宿主不提供工具注册能力时 fail closed，并在 capabilities 中报告
+  `agentCommandToolRegistered:false`，不会暂存或误执行付费任务。
+- 历史任务恢复下载页改为读取 Host 持久化的匹配/补全摘要；进程重启后不再把已补全数和待核验数
+  显示为“—”。
+
+### Verified
+- DSH `0.1.1-rc.2` 真实连接环境完成一次且仅一次主体检索：唯一精确匹配
+  `企查查科技股份有限公司`（统一社会信用代码 `91320594088140947F`）；未查询工商详情、未重试。
+- 同一公开主体通过工作台完整执行 Agent-owned 批次：实际 2 次 QCC 调用，1/1 精确补全，回填
+  信用代码、法定代表人、注册资本、成立日期与登记状态；0 待核验、0 失败、无重试。
+- 结果 CSV/XLSX 与异常清单 CSV/XLSX 四件套均生成成功，下载后 checksum 与 Host 元数据一致，
+  XLSX 结构校验通过；重启 DSH Host 后任务、统计和四件套仍可从任务历史恢复。
+- `npm run check` 通过，174/174 自动化测试全绿。
+
 ## [0.6.0] - 2026-09-04
 
 ### 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.6.0** (stable release)
+> Current source version / 当前源码版本: **0.6.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)
@@ -78,7 +78,7 @@ Or let an agent install it for you:
 | Skill | `data-cleaning` | guides the model through the workflow |
 | QCC Skill enrichment | `enterprise-enrichment` | 0.4.0: company panorama, ownership, governance, and historical registration |
 | 0.4.0 preflight | web `/data-cleaning/api/phase2/capabilities` | Read-only 16+4 dynamic-tool check; makes no QCC or paid calls |
-| QCC Host Bridge | web `/data-cleaning/api/g5/*` | 0.4.0: real OAuth/QCC path, natural-expiry refresh, and fault injection verified |
+| QCC Host Bridge | `data_cleaning_qcc_run` + web `/data-cleaning/api/g5/*` | Web stages commands in the Host; an Agent-owned high-level tool uses nested execution for dynamic QCC tools; real OAuth/QCC path, natural-expiry refresh, and fault injection verified |
 | Three-domain enrichment | web `/data-cleaning/api/phase3/*` | 0.5.0: risk 38 + IPR 18 + operation 35, zero-call estimate, user-owned QCC quota confirmation, candidate review, recovery/retry, and two CSV exports (no domain expansion in 0.6.0) |
 
 ## Qichacha MCP enrichment (status and roadmap)
@@ -89,10 +89,12 @@ Besides local deterministic completion, the plugin supports Qichacha MCP enterpr
   `qcc-dsh-mcp-oauth`, the Skill guides the model to call
   `mcp__qcc-company__get_company_by_query` / `mcp__qcc-company__get_company_registration_info`
   per company name and feed the fresh registration data back into the completion tool.
-- **Plan B (programmatic, 0.4.0)**: the Host Bridge supports batch enrichment,
-  idempotency, explicit candidate-resolution resume, manual retry of retryable failures, and
-  metadata-only auditing through the public `ctx.tools.execute()` runtime. Paid endpoints require
-  both `confirmPaidCalls:true` and a unique `idempotencyKey`. The flag means the current user
+- **Plan B (Agent-owned batch, since 0.4.0)**: in DSH Code Mode, the workbench stages rows in the
+  local Host and sends only a typed commandId intent, containing no company list, to the native
+  conversation. The Agent calls `data_cleaning_qcc_run` exactly once; the bridge then dispatches
+  dynamic QCC tools as nested executions using the parent execution token and Session. This path
+  supports batch enrichment, idempotency, candidate-resolution resume, manual retry of retryable
+  failures, and metadata-only auditing. Command staging requires `confirmPaidCalls:true`. The flag means the current user
   confirms use of their own QCC account quota; it does not transfer the charge to the plugin maintainer.
   Ambiguous candidates are never auto-selected. A loopback-only, fail-closed E2E runner is ready. On 2026-09-01 an isolated rc.2
   Host passed real OAuth, restart recovery, and 400 QCC calls across 20 public companies. Natural-expiry
@@ -115,6 +117,10 @@ See [the Phase-3 acceptance record](docs/PHASE3-ACCEPTANCE.md) and
 See [the 0.5.1 release record](docs/RELEASE-0.5.1.md) for the README fix and release-text gate.
 See [the 0.5.2 release record](docs/RELEASE-0.5.2.md) for native DSH UI alignment, verification, and rollback.
 See [the 0.5.3 release record](docs/RELEASE-0.5.3.md) for the business landing view and prompt builder.
+See [the 0.6.2 release record](docs/RELEASE-0.6.2.md) for Chinese export headers,
+complete field-selection propagation, and profile-field enrichment.
+See [the 0.6.1 release record](docs/RELEASE-0.6.1.md) for the Agent-owned QCC workbench,
+session isolation, recovered statistics, and real end-to-end validation.
 See [the 0.6.0 release record](docs/RELEASE-0.6.0.md) for the taskId workflow, durable artifacts,
 restart recovery, and dual-baseline validation.
 

package/README.md

@@ -2,7 +2,7 @@
 
 > 在 DeepSeek Harness 中清洗、补全、画像企业名单数据的智能体插件：本地 CSV/XLSX/JSON 引擎 + 可选企查查（Qichacha/QCC）MCP 企业数据补全，由企查查（Qichacha/QCC）团队发起并维护。
 >
-> 当前源码版本 / Current source version: **0.6.0**（正式版本）
+> 当前源码版本 / Current source version: **0.6.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)
@@ -71,7 +71,7 @@ bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-data-cleaning-a
 | Skill | `data-cleaning` | 引导模型按工作流调度上述工具 |
 | 企查查 Skill 补全 | `enterprise-enrichment` | 0.4.0：工商全景、股权穿透与历史工商 |
 | 0.4.0 工具预检 | web `/data-cleaning/api/phase2/capabilities` | 只读检查 16+4 动态工具，不发起 QCC/付费调用 |
-| QCC Host Bridge | web `/data-cleaning/api/g5/*` | 0.4.0：后台批量基础层；真实 OAuth/QCC 主路径、自然到期刷新与故障注入均已验收 |
+| QCC Host Bridge | `data_cleaning_qcc_run` + web `/data-cleaning/api/g5/*` | Web 仅在 Host 暂存任务；Agent-owned 高层工具以 nested execution 调用动态 QCC 工具；真实 OAuth/QCC 主路径、自然到期刷新与故障注入均已验收 |
 | 三域补全 | web `/data-cleaning/api/phase3/*` | 0.5.0：风险 38 + 知产 18 + 经营 35；零调用估算、显式付费确认、候选复核、恢复/重试与双 CSV 导出（当前按用户要求暂不扩展工具域） |
 
 ## 企查查 MCP 补全（状态与路线图）
@@ -83,9 +83,11 @@ bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-data-cleaning-a
   `mcp__qcc-company__get_company_registration_info`，把返回的最新工商信息回填到补全工具。
   0.4.0 已将 16 个工商工具和 4 个历史工商工具固化为可测契约，
   按 `panorama` / `ownership` / `governance` / `history` 维度组按需调用；未显式选择时不会默认打满全部付费工具。
-- **方案 B（后台程序化，0.4.0）**：Host Bridge 已通过公共 `ctx.tools.execute()` 实现
-  批量补全、请求幂等、多候选人工确认续跑、retryable 失败人工重试与安全审计。
-  批量 Web 端点同时要求 `confirmPaidCalls:true` 和唯一 `idempotencyKey`；该字段表示当前用户确认
+- **方案 B（Agent-owned 批量，0.4.0 起）**：DSH Code Mode 下，工作台先把名单安全暂存在本机
+  Host，并只把不含企业名单的 commandId 类型化意图发送到原生会话；Agent 随后准确调用一次
+  `data_cleaning_qcc_run`，Bridge 使用该父执行的 token/Session 以 nested execution 调度动态 QCC 工具。
+  该路径实现批量补全、请求幂等、多候选人工确认续跑、retryable 失败人工重试与安全审计。
+  暂存命令前要求 `confirmPaidCalls:true`；该字段表示当前用户确认
   使用自己的 QCC 账号额度，不代表插件开发者代客户付款；多候选绝不自动选择。
   默认关闭的本机 E2E Runner 已就绪；2026-09-01 已在隔离 rc.2 Host 完成真实 OAuth、跨重启恢复和
   20 家公开企业的 400 次 QCC 调用；自然过期 token 的真实刷新、动态工具恢复及 1 行续期后调用也已通过。
@@ -111,8 +113,10 @@ bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-data-cleaning-a
 0.5.1 文档补丁与防回归发布门见 [docs/RELEASE-0.5.1.md](docs/RELEASE-0.5.1.md)。
 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.6.0 五步 taskId 工作流、耐久制品、跨重启恢复与双基线验收见
-[docs/RELEASE-0.6.0.md](docs/RELEASE-0.6.0.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 工作流、耐久制品、
+跨重启恢复与双基线验收见 [docs/RELEASE-0.6.0.md](docs/RELEASE-0.6.0.md)。
 
 ## 本地开发
 

package/docs/COMPATIBILITY.md

@@ -33,7 +33,7 @@ MVP 路由、Phase-3 capabilities、estimate 与未确认 enrich 阻断均通过
 `conversation.createDraftImages` / `input.shell(sessionId).addImages` 做运行时探测，视为隔离兼容层，
 不承诺 alpha 实验面稳定。
 
-2026-09-04 的未发布 v2 工作流在 rc.2（43190）与 alpha.2（43191）完成最新本地 tarball
+2026-09-04 已发布的 0.6.0 v2 工作流在 rc.2（43190）与 alpha.2（43191）完成发布 tarball
 隔离安装：两条基线均创建 `dc_workflows_v2` 任务与结果/异常 CSV+XLSX 四类制品，停止并重启 Host
 后可按原 taskId 下载，XLSX 反向解析工作表为“清洗补全结果”。稳定发布判断仍以 rc.2 为主，
 alpha.2 只作兼容探针。全程未触碰生产 43120，未调用 QCC。
@@ -56,7 +56,7 @@ alpha.2 只作兼容探针。全程未触碰生产 43120，未调用 QCC。
 | 存储 | `ctx.storageDomain` | `open({name,version,tables})` → `table('jobs')` |
 | web 路由 | `webServer.register({kind:'prefix', path, handler})` | 最长前缀匹配；前缀需以 `/` 结尾且匹配 `pathname.startsWith(prefix + '/')` |
 | 同源守卫 | `isTrusted(req)` | `sec-fetch-site !== 'cross-site'` 且 origin 为 127.0.0.1/localhost |
-| 程序化工具调用 | `ctx.tools.get()` + `ctx.tools.execute()` | S7 双基线验证；每次调用重新解析，不缓存动态 MCP 工具 |
+| Agent-owned 动态工具调用 | `ctx.tools.register()` 高层工具 + `ctx.tools.get()` + 带 `parent/agent/rootCallId` 的 `ctx.tools.execute()` | rc.2 Code Mode 实测要求 nested execution；每次调用重新解析，不缓存动态 MCP 工具 |
 
 ## 4. 与企查查 MCP OAuth 插件的共存
 
@@ -72,8 +72,9 @@ alpha.2 只作兼容探针。全程未触碰生产 43120，未调用 QCC。
   `mcp__qcc-company__*` / `mcp__qcc-risk__*`（授权成功后由 mcp-client 动态提供）。
 - 若 qcc-dsh-mcp-oauth 未安装或未授权，`enterprise-enrichment` Skill 的第一步
   `qcc_oauth_status` 即会中断并引导用户先连接，不会假装补全。
-- G5 Host Bridge 不读取 grant/token，也不访问 mcp-client 私有 client；只经共享 `ctx.tools`
-  调用动态注册的 `mcp__qcc-*` 工具。G5-2 增加幂等、候选续跑、人工重试与安全审计；
+- G5 Host Bridge 不读取 grant/token，也不访问 mcp-client 私有 client。Web 路由只暂存已确认任务，
+  原生会话中的 `data_cleaning_qcc_run` 高层工具持有 Agent 父执行上下文，再经共享 `ctx.tools`
+  nested execution 调用动态注册的 `mcp__qcc-*` 工具。G5-2 增加幂等、候选续跑、人工重试与安全审计；
   run 明细仅驻留 Host 内存。Bridge 会把 OAuth 0.1.7 的 legacy `mcp__company__*` / `mcp__history__*`
   映射到规范名称，并在 capabilities 中同时报告两者。
 - 0.5.0 三域 Bridge 同时兼容 `mcp__qcc-{risk,ipr,operation}__*`、OAuth 0.1.7 实测 legacy
@@ -107,11 +108,11 @@ Portal、原生会话、五能力按钮、跨 scope 状态桥、窄桌面布局
 插件只做运行时能力探测并保留 `sessions.create` 安全降级，不承诺 alpha 实验面稳定。Portal 失败时
 仍保留 footer 降级按钮。
 
-0.5.3 新增业务首页和提示词生成器，并把流程栏移出输入框。当前未发布 v2 已在 rc.2 真实页面完成
+0.5.3 新增业务首页和提示词生成器，并把流程栏移出输入框。0.6.0 v2 已在 rc.2 真实页面完成
 浅色、深色及 820×900 窄屏回归；窄屏页面无横向溢出，最近完成任务可恢复原 taskId 并显示四个
 Host 制品下载按钮。alpha.2 继续只检查 Host/路由/制品 Bridge，不作为精确视觉基线。
 
-### 4.4 未发布 v2 制品兼容面（2026-09-04）
+### 4.4 0.6.0 v2 制品兼容面（2026-09-04）
 
 | 能力 | rc.2 | alpha.2 | 备注 |
 | --- | --- | --- | --- |

package/docs/G5-HOST-BRIDGE.md

@@ -1,13 +1,16 @@
 # G5 Host Bridge：方案 B 批量补全基础层
 
 - 日期：2026-09-02
-- 状态：**G5-2.1～G5-2.5、真实 OAuth/QCC 主路径、token 自然到期刷新与 401/429/配额故障注入已验收**
+- 状态：**G5-2.1～G5-2.5、Agent-owned nested execution、真实 OAuth/QCC 主路径、token 自然到期刷新与 401/429/配额故障注入已验收**
 - 发布状态：✅ 已随 `v0.4.0` 发布到 npm 与 GitHub Release
 - 决策依据：`docs/adr/0002-programmatic-mcp-tool-execution.md`
 
 ## 本阶段交付
 
-`lib/qcc.js` 基于 DSH 公共 `ctx.tools.get()` / `ctx.tools.execute()` 实现 Host Bridge：
+`lib/qcc-command.js` 与 `lib/qcc.js` 基于 DSH 公共工具运行时实现 Host Bridge。2026-09-04
+在真实 rc.2 Code Mode 验证发现：动态 MCP 工具必须作为 Agent-owned 父工具调用的 nested execution
+运行，普通 Web handler 不能直接成为其父执行。因此正式 UI 路径采用「Host 暂存 + 类型化会话意图 +
+高层工具」：
 
 1. 仅允许 `qcc_oauth_*`、规范 `mcp__qcc-*__*` 与 OAuth 0.1.7 已验证 legacy serverName，拒绝任意工具代理。
 2. 每次调用重新解析工具，兼容 OAuth 刷新造成的注销/重注册窗口；只对 `UNKNOWN_TOOL` 做一次安全重试，其他失败不自动重试，避免重复计费。
@@ -15,19 +18,26 @@
 4. 解析 MCP `structuredContent` 或 QCC 文本 JSON，复用一期字段契约。
 5. 批量输入按企业名去重调用；唯一精确主体才继续工商/风险补全，多候选进入 `reviewQueue`，未匹配保留为 `unresolved`。
 6. 单企业失败隔离，不中断其他企业；原始/补全明细只在 Host/Web 同源边界内流转。
+7. Web 暂存任务不产生 QCC 调用；发送给模型的提示只含 commandId/taskId/kind，不含企业名单和字段值。
+8. `data_cleaning_qcc_run` 由 Agent 调用一次，并把父执行的 `token / agent / rootCallId` 传给每个
+   动态 QCC nested execution；重复调用同一 commandId 复用同一 Promise/结果，不重复计费。
 
 ## 数据流
 
 ```text
-同源 Web 请求（显式确认计费）
-  → QccHostBridge.enrichRows
-    → 企业名去重 + 受控并发（1–4）
+同源 Web 请求（显式确认使用当前用户自己的 QCC 额度）
+  → Host 暂存 rows，返回不含 rows 的 commandId 类型化提示（零 QCC 调用）
+  → 原生 conversation.send(prompt)
+  → Agent 调用一次 data_cleaning_qcc_run(commandId)
+    → QccHostBridge.enrichRows
+      → 企业名去重 + 受控并发（1–4）
       → ctx.tools.get（每次重新解析）
-      → ctx.tools.execute(mcp__qcc-company__get_company_by_query)
+      → ctx.tools.execute(..., parent=exec.token, agent=exec.agent)
         ├─ 唯一精确 → 锁定信用代码 → 工商详情 → 可选风险扫描
         ├─ 多候选   → reviewQueue，停止该主体下游调用
         └─ 未匹配   → unresolved
-  → 摘要 + 同源明细 + CSV 下载
+  → 高层工具只向对话返回摘要
+  → 同源 UI 轮询 commandId，取得 Host run 明细并进入候选/补全/导出
 ```
 
 ## Web 契约
@@ -38,8 +48,21 @@
 
 只检查工具是否注册，不调用 OAuth 或任何计费 QCC 工具。返回 Bridge marker、连接态推断和批量限制。
 同时声明 `idempotencyRequired / candidateResume / manualRetry`，run 状态仅为 `host-memory`。
+还会返回 `agentCommandTool / agentCommandToolRegistered / agentOwnedExecutionRequired`；若当前 Host
+不支持工具注册，命令准备接口以 `503 QCC_AGENT_COMMAND_UNAVAILABLE` 关闭，不会产生 QCC 调用。
 
-### 批量补全
+### Agent-owned 命令（正式工作台路径）
+
+- `POST /data-cleaning/api/g5/commands`：要求 `confirmPaidCalls:true`，把 enrich/resolve/retry 输入暂存
+  在 Host；返回 commandId 与不含企业名单的可见会话提示，本步骤 `paidCalls:false`。
+- `data_cleaning_qcc_run({commandId})`：只能在 Agent tool execution 内运行，缺少父执行 token/Session
+  时返回 `QCC_AGENT_EXECUTION_REQUIRED`。
+- `GET /data-cleaning/api/g5/commands/<commandId>`：同源读取 prepared/running/completed/failed 和完成后的
+  Host run，不调用 QCC。
+
+命令默认 30 分钟过期、最多 50 个；同一 commandId 在运行中和完成后都不会重复派发。
+
+### 兼容批量端点（非 Code Mode UI 主路径）
 
 `POST /data-cleaning/api/g5/enrich`
 
@@ -57,6 +80,9 @@
 
 约束：
 
+- 该端点保留给 Mock/Contract、Runner 与非 Code Mode 兼容场景；rc.2 Code Mode 的工作台不得用它
+  直接派发动态 QCC 工具，应使用上面的 Agent-owned 命令路径。
+
 - `confirmPaidCalls` 必须严格为 `true`，否则在任何工具调用前返回 `QCC_CONFIRM_REQUIRED`。
 - `idempotencyKey` 必填；相同键与相同请求复用首个结果，不重复调用工具；同键不同请求返回冲突。
 - 单批最多 100 行，并发范围 1–4；重复企业只检索一次。

package/docs/QCC-ENRICHMENT-DESIGN.md

@@ -208,8 +208,10 @@ content:
 ## 9. 与方案 B 的边界与预留
 
 - 方案 A 不改 `lib/`（最多可选加 `data_rows_to_csv` 工具）。
-- 方案 B 已新增 `lib/qcc.js`：Spike #7 双基线证明公共 `ctx.tools.execute()` 可程序化调度动态
-  MCP 工具；G5-2 幂等、候选续跑、人工重试与安全 Runner 的 Mock/Contract 已通过。
+- 方案 B 已新增 `lib/qcc.js` 与 `lib/qcc-command.js`：工作台通过同源 Web 路由把名单暂存在
+  Host，只向原生会话发送 commandId；`data_cleaning_qcc_run` 持有 Agent 父执行 token/Session 后，
+  才可通过公共 `ctx.tools.execute()` 以 nested execution 调度动态 MCP 工具。G5-2 幂等、候选续跑、
+  人工重试与安全 Runner 的 Mock/Contract 已通过。
   禁止访问 mcp-client 私有 client；真实 OAuth/QCC 主路径已验收，token 到期刷新与
   2026-09-02 已完成自然过期 token refresh 与 401/429/配额故障注入验收；
   故障注入使用本地 ToolRuntime，不重复真实付费批次。

package/docs/QCC-PHASES-ROADMAP.md

@@ -191,8 +191,9 @@ v1 字段契约（方案 A）：
 ### 4.4 三期并行 · 方案 B 批量后端
 
 一期/二期/三期均为模型中介式（模型逐个调 QCC 工具）。当名单规模进入百级/千级，模型逐调成本高，
-方案 B 已启动：插件内 `lib/qcc.js` 经公共 `ctx.tools.execute()` 调用 mcp-client 动态注册的工具；
-不直接访问 `ctx.loader` 条目或 mcp-client 私有 client。
+方案 B 已启动：插件内 `lib/qcc-command.js` 注册 Agent-owned 高层工具，由 `lib/qcc.js` 使用父执行
+token/Session，经公共 `ctx.tools.execute()` 以 nested execution 调用 mcp-client 动态注册的工具；
+Web 路由只暂存任务，不直接派发动态 QCC 工具，也不访问 `ctx.loader` 条目或 mcp-client 私有 client。
 
 - Spike #7：rc.2 / alpha.2 双基线 PASS。
 - G5-2：在 G5-1 基础上完成默认关闭 E2E Runner、脱敏、请求幂等、多候选确认续跑、

package/docs/RELEASE-0.6.0.md

@@ -41,6 +41,17 @@
 
 ## 外部发布核验
 
-Tag 推送后必须确认 Release workflow 全绿、npm `latest=0.6.0`、provenance 存在、GitHub Release
-非 draft/非 prerelease，并从公共 Registry 在全新隔离 Profile 安装验证。实际 workflow run、tarball
-哈希与公共安装结果在发布完成后的仓库进度记录中补充。
+- PR [#1](https://github.com/duhu2000/dsh-data-cleaning-agent/pull/1) 全部 CI 通过后合并；
+  `v0.6.0` 指向合并提交 `084efd0`。
+- Release workflow [33817341580](https://github.com/duhu2000/dsh-data-cleaning-agent/actions/runs/33817341580)
+  全绿，npm OIDC publish 与 GitHub Release 两个发布步骤均成功。
+- npm `latest` 为 `0.6.0`；发布时间为 2026-09-03T23:23:12Z（北京时间 2026-09-04 07:23）。
+- tarball SHA-1：`559db5f3de6ef799b0d7549d0bebb144e8cfb91d`。
+- tarball integrity：
+  `sha512-ib83dgrBNnubouISvnzJb/zbjuBnJXEuee/fVgSzlZZcZLdA/5aB8fb4YF0L+DmOINIJfb44akUMBnBajv7lVg==`。
+- npm Registry 返回 SLSA v1 provenance attestation；隔离安装后的 `npm audit signatures` 验证
+  10 个 Registry 签名和 1 个 attestation。
+- 从公共 Registry 全新安装 `dsh-data-cleaning-agent@0.6.0` 成功；包版本、五步工作流契约和
+  `WorkflowArtifactStore` 导入验证通过。
+- GitHub Release [v0.6.0](https://github.com/duhu2000/dsh-data-cleaning-agent/releases/tag/v0.6.0)
+  已发布，非 draft、非 prerelease。

package/docs/RELEASE-0.6.1.md

@@ -0,0 +1,64 @@
+# 0.6.1 Agent-owned QCC 工作台修复发布记录
+
+> 版本：**0.6.1**
+> 发布日期：2026-09-04
+> 发布来源：`v0.6.1` Tag 触发 GitHub Actions，使用 npm OIDC Trusted Publishing。
+
+## 目标
+
+0.6.1 是 0.6.0 的兼容性补丁，不扩大企查查工具域，重点修复真实 DSH Code Mode 下的工作台调度和
+多智能体共存：
+
+1. Web 工作台只在 Host 暂存企业名单，并向原生会话发送不含明细的 commandId 类型化意图；
+2. Agent 准确调用一次 `data_cleaning_qcc_run`，Bridge 使用父执行 token/Session，以 nested execution
+   调用动态 QCC 工具；
+3. 新会话及其它智能体入口默认不显示数据清洗补全内容，点击本插件入口后才进入独立业务子系统；
+4. 本地清洗任务跳过 QCC 匹配页，统计卡只渲染可读标量；
+5. Host 重启恢复任务时，下载页继续显示已补全数和待核验数。
+
+## 兼容与安全
+
+- 稳定发布基线仍为 DSH `0.1.1-rc.2`；`0.1.2-alpha.2` 只作兼容探针。
+- 工作台命令缺少 Agent 父执行上下文时 fail closed，不从普通 Web handler 直接派发动态 QCC 工具。
+- 暂存命令默认 30 分钟过期、最多 50 个；同一 commandId 重放复用同一 Promise/结果，不重复计费。
+- 企业名单与字段值不进入可见提示词；OAuth token、QCC 原始响应和凭据不进入仓库或审计日志。
+- QCC 继续采用 BYO 账号：客户使用自己的企查查 MCP 连接与额度，插件不共享 Key、不代付。
+- 历史域、人员域和招投标域继续延期，本补丁不新增这些工具或权限依赖。
+
+## 验收证据
+
+- `npm run check` 全绿，174/174 自动化测试通过；
+- npm dry-run 包全部命中白名单；
+- PR #2 的 Linux Node 22、Linux Node 24、Windows Node 24 和 PR 打包检查均通过；
+- DSH `0.1.1-rc.2` 真实工作台完成上传、映射、质量体检、零调用估算、额度确认、Agent-owned 调度、
+  主体定位、工商补全、结果回填与四件套导出；
+- 公开主体批次实际 2 次 QCC 调用，1/1 精确补全、0 待核验、0 失败、无重试；
+- 结果 CSV/XLSX 与异常清单 CSV/XLSX checksum 一致，XLSX 可反向解析；Host 重启后任务、统计和
+  四件套仍可从任务历史恢复。
+
+## 升级与回滚
+
+- 升级：安装 `dsh-data-cleaning-agent@0.6.1` 并完全重启 DSH。
+- 回滚：重新安装 `dsh-data-cleaning-agent@0.6.0` 并完全重启 DSH。
+- 本补丁不引入数据库迁移；回滚不会删除 `dc_workflows_v2` 或工作区耐久制品。
+- 完整迁移说明见 `docs/UI-WORKFLOW-V2-MIGRATION.md`。
+
+## 外部发布核验
+
+- PR [#3](https://github.com/duhu2000/dsh-data-cleaning-agent/pull/3) 四项 CI 全绿后合并；
+  `v0.6.1` 指向合并提交 `77a19aa`。
+- Release workflow [33880569564](https://github.com/duhu2000/dsh-data-cleaning-agent/actions/runs/33880569564)
+  全绿；版本校验、发布模式门禁、npm OIDC publish 与 GitHub Release 均成功。
+- npm `latest` 为 `0.6.1`；发布时间为 2026-09-04T13:53:39Z（北京时间 2026-09-04 21:53）。
+- tarball SHA-1：`ab9aaff6738e3ede08768138bc7a9000ccc28ed2`。
+- tarball integrity：
+  `sha512-VWsVelLCxpGYDZ1TZrxlZWLGC86IjtOJDZAszukCs5LaPwkos8UcJn0IWmYtdKF7S3a8TsQGN1KhOhDL0OCHFw==`。
+- npm Registry 返回 SLSA v1 provenance；隔离安装后的 `npm audit signatures` 验证 10 个 Registry
+  签名和 1 个 attestation。
+- 从公共 Registry 全新安装成功；包版本为 0.6.1，主入口可导入，浏览器 client 语法门通过，
+  `lib/qcc-command.js` 与本发布记录均存在。
+- DSH `0.1.1-rc.2` 全新隔离 Profile 安装 `dsh-data-cleaning-agent@0.6.1` 成功并加载 Host 插件。
+  第二个临时 Web Host 因本机全局文件监听资源耗尽（`EMFILE`）未完成 HTTP seam；未停止或改动用户
+  正在运行的 3080 实例。真实工作台闭环证据见上方「验收证据」。
+- GitHub Release [v0.6.1](https://github.com/duhu2000/dsh-data-cleaning-agent/releases/tag/v0.6.1)
+  已发布，为 Latest，非 draft、非 prerelease。

package/docs/RELEASE-0.6.2.md

@@ -0,0 +1,40 @@
+# 0.6.2 中文字段导出与完整补全字段修复
+
+> 版本：**0.6.2**
+> 发布日期：2026-09-04
+> 发布来源：`v0.6.2` Tag 触发 GitHub Actions，使用 npm OIDC Trusted Publishing。
+
+## 目标
+
+0.6.2 是 0.6.1 的结果正确性补丁，不扩大企查查工具域，修复真实任务中结果 XLSX 仅出现少量
+英文字段的问题：
+
+1. 任务选中的补全维度贯穿工作台、Agent-owned 命令、G5 Host Bridge、恢复/重试与耐久制品；
+2. CSV/XLSX 的插件补全字段和系统状态字段统一使用中文表头；
+3. 即使企查查未返回某个已选字段，结果文件也保留对应中文空列，不再静默丢列；
+4. 工商工具补充注册地址、行政区划、经营范围、行业、营业期限和企业规模映射；
+5. 企业简介及明确的一/二级行业字段按需调用 `get_company_profile`；未声明层级的“企查查行业”
+   不会被猜测填入一级或二级行业。
+
+## 兼容与调用边界
+
+- 稳定发布基线仍为 DSH `0.1.1-rc.2`；`0.1.2-alpha.2` 继续通过隔离 Bridge 兼容。
+- 只有选择企业简介、一级行业或二级行业时才增加企业画像调用，工作台调用估算同步调整。
+- QCC 继续采用 BYO 账号；插件不内置、不记录也不发布 OAuth token 或客户 Key。
+- 历史域、人员域和招投标域仍按既定范围延期，本补丁不新增相关工具。
+
+## 验收
+
+- 14 个目标维度按选择顺序完整进入结果数据和导出制品；
+- CSV/XLSX 表头为统一社会信用代码、登记状态、法定代表人、注册资本、成立日期、注册地址、
+  省份地区、城市、经营范围、一级行业、二级行业、营业期限、企业规模、企业简介；
+- 画像接口未明确返回层级时，一/二级行业保留空值而不是生成数据；
+- 未选择风险能力时不额外输出风险标签；
+- `npm run check` 全绿，176/176 自动化测试通过，npm dry-run 包内容命中白名单。
+
+## 升级与回滚
+
+- 升级：安装 `dsh-data-cleaning-agent@0.6.2` 并完全重启 DSH。
+- 回滚：重新安装 `dsh-data-cleaning-agent@0.6.1` 并完全重启 DSH。
+- 本补丁不修改 `dc_workflows_v2` 存储 schema，也不删除既有任务或工作区耐久制品。
+- 0.6.1 已生成的旧 XLSX 不会被自动重写；升级后重新生成制品即可获得中文完整表头。

package/docs/UI-WORKFLOW-V2.md

@@ -130,7 +130,7 @@ draft → uploaded → rules_confirmed → diagnosed(可选)
 | T6 | rc.2 深色、浅色、820×900 窄屏无横向溢出 | 真实浏览器通过 |
 | T7 | 多候选人工核验、`partial` 显式重试、补全后回到 `export_ready` | 自动化覆盖 |
 | T8 | 最近任务携带原 taskId 恢复、无原始 runtime 行时下载四类 Host 制品 | 自动化 + rc.2 浏览器通过 |
-| T9 | 迁移/回滚、兼容矩阵、发布检查和版本决策 | 文档完成；建议 0.6.0，尚未发布 |
+| T9 | 迁移/回滚、兼容矩阵、发布检查和版本决策 | 文档完成；0.6.0 已发布并完成公共安装核验 |
 
 ### 真实 Host 证据（2026-09-03）
 
@@ -167,8 +167,7 @@ draft → uploaded → rules_confirmed → diagnosed(可选)
 4. T6（完成）：Host 耐久下载制品、XLSX 与异常清单、双基线、视觉回归、迁移与回滚。
 5. T7（完成）：候选人工核验、部分失败重试、匹配与补全状态闭环。
 6. T8（完成）：四类制品导出、最近任务恢复及跨 Host 重启下载。
-7. T9（发布准备完成）：建议下一版本使用 `0.6.0`；待最终代码审查与维护者另行批准 commit、push、
-   Tag、npm 和 GitHub Release。
+7. T9（完成）：`0.6.0` 已完成代码审查、合并、Tag、npm OIDC 发布、GitHub Release 与公共安装核验。
 
 详细验收见 `docs/UI-WORKFLOW-V2-ACCEPTANCE.md`，升级/回滚见
 `docs/UI-WORKFLOW-V2-MIGRATION.md`。

package/lib/artifacts.js

@@ -7,6 +7,7 @@
  */
 import { createHash, randomUUID } from 'node:crypto';
 import XLSX from 'xlsx';
+import { FIELD_LABELS, normalizeFieldSelection } from './workflow-contract.js';
 
 const ROOT = '.dsh-data-cleaning-artifacts/v1';
 const MAX_ARTIFACT_BYTES = 32 * 1024 * 1024;
@@ -15,6 +16,17 @@ const MAX_ARTIFACT_BYTES = 32 * 1024 * 1024;
 const MAX_STORED_BYTES = Math.ceil(MAX_ARTIFACT_BYTES / 3) * 4 + 4;
 const SAFE_ID = /^(?:dcw|dca)-[a-zA-Z0-9-]{8,80}$/;
 
+const SYSTEM_FIELD_LABELS = Object.freeze({
+  biz_status: '经营状态',
+  risk_tags: '风险标签',
+  qcc_match_status: '匹配状态',
+  qcc_source: '数据来源',
+  qcc_error: '错误原因',
+  match_status: '匹配状态',
+  error: '错误原因',
+  _exception_reason: '异常原因',
+});
+
 export class ArtifactError extends Error {
   constructor(code, message, status = 400) {
     super(message);
@@ -44,10 +56,11 @@ function sha256(buffer) {
   return createHash('sha256').update(buffer).digest('hex');
 }
 
-function normalizeHeaders(headers, rows) {
+function normalizeHeaders(headers, rows, fieldSelection = []) {
   const fromInput = Array.isArray(headers) ? headers.map((item) => String(item ?? '').trim()).filter(Boolean) : [];
+  const selected = normalizeFieldSelection(fieldSelection);
   const discovered = [];
-  const seen = new Set(fromInput);
+  const seen = new Set([...fromInput, ...selected]);
   for (const row of rows) {
     for (const key of Object.keys(row ?? {})) {
       if (!seen.has(key)) {
@@ -56,7 +69,27 @@ function normalizeHeaders(headers, rows) {
       }
     }
   }
-  return [...fromInput, ...discovered].slice(0, 256);
+  return [...fromInput, ...selected.filter((field) => !fromInput.includes(field)), ...discovered].slice(0, 256);
+}
+
+function exportLabel(key) {
+  return FIELD_LABELS[key] ?? SYSTEM_FIELD_LABELS[key] ?? key;
+}
+
+function exportColumns(headers) {
+  const used = new Set();
+  return headers.map((key) => {
+    const base = exportLabel(key);
+    let label = base;
+    if (used.has(label)) {
+      const suffix = FIELD_LABELS[key] || SYSTEM_FIELD_LABELS[key] ? '（补全）' : '（原字段）';
+      label = `${base}${suffix}`;
+      let index = 2;
+      while (used.has(label)) label = `${base}${suffix.slice(0, -1)}${index++}）`;
+    }
+    used.add(label);
+    return { key, label };
+  });
 }
 
 function normalizeRows(value) {
@@ -104,8 +137,13 @@ export function deriveExceptionRows(rows) {
 
 function workbookBytes(rows, headers, sheetName) {
   const workbook = XLSX.utils.book_new();
-  const worksheet = XLSX.utils.json_to_sheet(rows, { header: headers, skipHeader: false });
-  worksheet['!cols'] = headers.map((header) => ({ wch: Math.min(42, Math.max(12, String(header).length * 2 + 4)) }));
+  const columns = exportColumns(headers);
+  const values = [
+    columns.map((column) => column.label),
+    ...rows.map((row) => columns.map((column) => row?.[column.key] ?? '')),
+  ];
+  const worksheet = XLSX.utils.aoa_to_sheet(values);
+  worksheet['!cols'] = columns.map((column) => ({ wch: Math.min(42, Math.max(12, String(column.label).length * 2 + 4)) }));
   XLSX.utils.book_append_sheet(workbook, worksheet, sheetName.slice(0, 31));
   workbook.Props = {
     Title: sheetName,
@@ -129,9 +167,10 @@ function csvBytes(rows, headers) {
     if (/^[\u0009\u000d\u000a ]*[=+\-@]/.test(text)) text = `'${text}`;
     return /[",\r\n]/.test(text) ? `"${text.replaceAll('"', '""')}"` : text;
   };
+  const columns = exportColumns(headers);
   const lines = [
-    headers.map(escapeCell).join(','),
-    ...rows.map((row) => headers.map((header) => escapeCell(row?.[header])).join(',')),
+    columns.map((column) => escapeCell(column.label)).join(','),
+    ...rows.map((row) => columns.map((column) => escapeCell(row?.[column.key])).join(',')),
   ];
   return Buffer.from(`\uFEFF${lines.join('\r\n')}`, 'utf8');
 }
@@ -180,7 +219,7 @@ export class WorkflowArtifactStore {
   async createBundle(taskId, input = {}) {
     assertId(taskId, 'taskId');
     const rows = normalizeRows(input.rows);
-    const headers = normalizeHeaders(input.headers, rows);
+    const headers = normalizeHeaders(input.headers, rows, input.fieldSelection);
     if (!headers.length) throw new ArtifactError('DC_ARTIFACT_HEADERS_REQUIRED', 'At least one export column is required.', 400);
     const exceptions = input.exceptionRows === undefined
       ? deriveExceptionRows(rows)