# 0.5.3 UI 二次对齐发布记录

> 版本：**0.5.3**
>
> 状态：**✅ 已发布；npm `latest`、Git tag 与 GitHub Release 均为 `0.5.3`。**
>
> 发布时间：2026-09-03T10:36:28Z

## 目标

0.5.3 继续对齐原始高保真 Mockup 与招投标智能体的入口模式：

1. 侧栏名称为「数据清洗补全」，位置仍在「新会话」与「工作区」之间；
2. 点击菜单先进入中央业务首页，不自动展开右侧工作台；
3. 五个流程入口位于原生输入框下方；
4. 输入框左上角提供提示词生成器，生成内容回填原生输入框，用户可修改后发送；
5. 右侧工作台继续负责上传映射、质量体检、匹配核验、补全导出与任务历史。

## 已验证的 DSH 契约

本实现依据本机 DSH Desktop 随附的一手槽位目录与运行时代码：

| 能力 | 已验证事实 | 0.5.3 用法 |
| --- | --- | --- |
| `conversation.input.left` | 输入框卡片内部工具行 | 不再承载五流程按钮 |
| `conversation.input.dock` | session 级、独立整行，默认位于输入框上方 | 承载业务首页和五流程按钮，仅通过稳定 `data-slot` 把本 cell 排到输入框下方 |
| `conversation.input.overlay` | session 级浮层锚点，标准 props 含 `sessionId` / `inputActions` | 承载提示词生成触发器与弹层 |
| `inputActions.setDraft` | 原生输入机动作 | 把生成的任务描述回填对话框 |
| `conversation.createDraftImages` + `input.shell(id).addImages` | 本机 rc.2 运行时存在的浏览器 Draft 图片链 | 仅经能力探测 Bridge 使用；失败时释放临时图片并提示使用原生“＋” |
| Hero headline | 当前没有公开的 headline 替换槽位 | 仅在本插件 blank 会话精确匹配中英文标题并可恢复；普通会话不变 |

## 提示词生成器范围

- 输入：逐行企业名称/统一社会信用代码、本地 Excel/XLS/CSV/JSON、PNG/JPEG/WebP 图片；
- 清洗：名称规范、旧名补全/修正、信用代码校验/补全、去重、模糊候选人工确认；
- 补全：v1 工商字段，以及已经存在的企业全景、股权、组织、风险、知产、经营维度组；
- 输出：自然语言任务描述，包含精确优先、多候选暂停、缺失不编造、来源保留与客户自带 QCC 费用边界；
- 表格：完整解析结果留在本机工作台，提示词只包含最多 50 条主体预览；
- 图片：插件只附加图片并生成能力要求，不假设或硬编码尚未验证的“智能文档解析”具体工具名。

## 验收门

- [x] `npm run check` 全通过（2026-09-03：138/138）；
- [x] rc.2 隔离 Profile 安装本地 tarball，Host `apply()`、MVP seam、3 tools 与 2 skills 注册成功；
- [ ] 侧栏文案、业务首页标题和四段产品流程与设计稿一致；
- [ ] 五流程按钮位于输入框下方，打开对应右侧工作台步骤；
- [ ] 文本、Excel、图片三种提示词生成路径均能回填且可编辑；
- [x] 组件/事件契约确认 Excel 完整数据进入工作台，普通会话不出现本插件业务 UI；
- [ ] 右栏关闭/展开、窄桌面与深色模式无明显遮挡；
- [ ] 无真实 QCC 调用即可完成 UI 验收；真实调用仍受既有估算、确认、幂等与上限门保护。

> 本轮应用内浏览器首次打开时已确认顶部菜单文案；隔离 Host 重启后，本机 URL 被浏览器安全策略阻止二次访问，
> 因此标题、流程栏位置、弹层及深浅色/窄屏保留为发布后人工观察项，未用替代浏览器绕过。

发布结果：

- `v0.5.3` annotated tag 指向 `f7eac00`；Release workflow `33745170057` 全绿；
- npm 公共 Registry 返回 `latest=0.5.3`，包含 38 个文件，SHA-1 为 `d349a593d8b45efc794456bf5854e4ec583ca70f`；
- npm provenance predicate 为 SLSA v1；
- GitHub Release 为非 draft、非 prerelease：https://github.com/duhu2000/dsh-data-cleaning-agent/releases/tag/v0.5.3 。

## 升级与回滚

- 升级：安装 `dsh-data-cleaning-agent@0.5.3` 并完全重启 DSH；不覆盖客户 OAuth grant 或 Key。
- 回滚：重新安装 `dsh-data-cleaning-agent@0.5.2` 并完全重启 DSH。
- 0.5.3 不修改 Host 路由、QCC 工具契约、存储 schema 或导出格式，回滚无需数据迁移。