# 原表补全与统一映射验收（v0.8.16）

本次范围：数据清洗补全的提示词向导与右侧工作台；未修改 AI 填表或共享内核仓库。

## 交互与数据规则

- 表格上传后展示完整分页清单、列数、空白单元格数，并提供原始清单下载。
- 标准表头及明确别名自动通过（绿色）；歧义与重复列给出候选（琥珀色），人工选择后转绿色；未知字段为未匹配（红色），原列保留。颜色同时配有文字。
- 已确认映射自动构成补全范围，不再要求重复勾选默认五字段。额外字段目录默认折叠，只用于新增原表之外的字段。
- 多个原列可人工确认映射同一非主体字段。查询字段去重，结果分别补空，保留非空原值及数值 0、布尔值 false。
- 企业名称、统一社会信用代码、注册号分别只允许一个匹配主列；一个原列不能同时映射多个字段。
- 映射阶段只匹配字段语义，不代表企业主体已匹配或字段数据已查询。没有当前目录支持的字段不猜测、不替换为近似口径。
- 最终任务说明包含原列映射、补空策略、未映射列及额外新增字段。用户仍可在中央对话框编辑，发送才执行查询。

## 回归证据

使用与反馈表头同结构的合成测试数据，不复制客户工作簿到仓库、不调用真实 QCC：

- 23 列、1 行、22 个空白单元格：9 列自动通过；确认重复列、企业状态、行业候选后，15 列映射至 13 个不同输出字段，8 列未匹配保留。
- 提示词回填后，Host 保存 15 个映射及 13 个字段，不被旧草稿默认五字段覆盖。
- CSV/XLSX 结果及异常清单覆盖多个原列共享同一补全字段、原值保护与异常行保护。
- 自动化检查覆盖契约、Host 路由、草稿不需要费用勾选、实际执行边界，以及深浅色 × 5 种视口的真实 React/Chromium 交互。
- 浏览器验证旧 Host 能力缺失时显示中文版本错配提示，且不创建或执行 QCC 命令。

## 本机升级注意

本次排查发现正在运行的 DSH 进程启动时间早于插件磁盘更新，可能出现新页面配旧内存 Host。新增能力标记 `draftPreparationVersion: 2`、`multipleOutputColumns: true` 用于提前识别这一情况。

发布安装后需先保存或导出现有任务，再重启 DSH 并刷新页面。仅刷新浏览器不能替换内存中的旧 Host。开发验收未安装或重启本机 DSH，也未改动用户源文件。