# dsh-data-cleaning-agent v0.8.17

## 本版改进

发送在向导或右侧工作台确认的任务说明后，由同一个 Host 高层工具负责匹配、补全、生成新的 XLSX 与异常清单，并将下载绑定到任务。无需再次确认额度或提供源文件路径；不覆盖上传的原始文件，不由模型运行 Bash 拼装替代报表。

- 保留已确认原列、多列共用补全字段、仅补空白及非空 0/false 保护。
- 真正的多候选在工作台确认；授权、限流等异常不自动重试或扩大范围。
- 过期任务 revision 在查询前阻断；同一命令重放不重复扣量。
- 刷新与切换后恢复独立清洗会话；侧栏重新打开当前工作台。Host 生成文件不依赖页面存在，已保存结果可跨 Host 重启下载。
- 只在浏览器保存会话 ID → 任务 ID 绑定，不持久化原始名单。执行中的 Host 进程不可强制重启；尚未生成的命令、候选与运行明细仍可能过期，不能自动重新查询。
- 未选外部字段时不发起 QCC 调用，可使用工作台本地清洗与导出。

## 验证

241 项自动化测试、10 组浏览器回归通过。使用合成数据和隔离的 ToolRuntime/Chromium，不调用真实企查查账号、不修改客户测试文件。覆盖真实 XLSX 内容回读、双列补空、原值保护、重放幂等、候选续跑、部分失败重试、磁盘写入失败及恢复下载。浏览器覆盖浅色/深色与五种视口，分离 root/session 实例验证向导凭证交接。

## 升级

保存未完成任务后安装：

`dsh plugin --profile web add dsh-data-cleaning-agent@0.8.17`

完整重启对应 DSH Profile 并刷新页面；仅刷新浏览器不会更新 Host。旧对话中的普通提示词不会自动改成新凭证，请在升级后的工作台重新生成。历史导出不会被改写。本次发布不自动重启或安装到本机正在运行的 DSH。

回滚可安装 0.8.16，但会失去本版 Host 自动交付与会话恢复逻辑。共享字段内核、AI 填表版本均不变。