dsh-data-cleaning-agent 0.5.1 → 0.5.3

package/CHANGELOG.md

@@ -4,6 +4,47 @@
 
 ## [Unreleased]
 
+## [0.5.3] - 2026-09-03
+
+> UI 二次对齐版本；不改变 Host/QCC 工具契约或计费安全门。
+
+### Added
+- 为插件创建的 blank 会话增加「数据清洗补全智能体」业务首页、产品说明、四阶段工作流与安全边界说明。
+- 在原生输入框左上角增加提示词生成器：支持粘贴企业名/统一社会信用代码、解析 Excel/CSV/JSON、
+  附加图片、选择清洗动作和补全维度，并将自然语言任务描述回填原生输入框供人工修改。
+- 表格由本地同源解析端点处理，完整数据经 session→root 事件桥载入工作台；提示词仅带主体预览，
+  避免把整表无边界写入模型上下文。
+
+### Changed
+- 侧栏菜单由「数据清洗」改为「数据清洗补全」，点击后先进入中央业务首页，不再自动拉开右侧工作台。
+- 五个流程入口从输入框内部 `conversation.input.left` 迁到公开 `conversation.input.dock`，并仅移动
+  本插件 cell 到输入框下方；普通 DSH 会话不显示业务首页、提示词按钮或流程入口。
+
+### Compatibility
+- DSH 没有公开 Hero headline 替换槽位；0.5.3 使用精确匹配中英文原生标题、卸载时恢复的隔离 DOM Bridge。
+- 图片接入只在运行时探测到 `conversation.createDraftImages` 与 `input.shell().addImages` 后启用；
+  不硬编码未验证的企查查智能文档解析工具名，任务描述只要求模型使用当前已连接且可用的能力。
+
+## [0.5.2] - 2026-09-03
+
+> DSH 原生 UI 对齐版本；不改变 QCC 工具范围、OAuth、计费确认或数据契约。
+
+### Added
+- 在 DSH 原生输入框工具行增加上传清洗、质量体检、匹配核验、字段补全和任务历史五个能力入口。
+- 在原生会话头增加「清洗工作台」恢复入口，任务历史页复用 Host `/mvp/jobs` 状态。
+
+### Changed
+- 左栏入口采用与 MCP连接器一致的兼容方式：公开 `sidebar.footer.action` 仅托管生命周期和降级，
+  实际按钮 Portal 到 `sidebar.workspaces` 前，显示在「新会话」与「工作区」之间。
+- 点击左栏入口通过 DSH `workspaces` / `sessions` / `conversation` 服务打开中央原生会话并预填清洗提示词。
+- 工作台由 980px 模态遮罩改为默认 510px 的非模态右侧面板；中央原生会话保持可见，移动端仍安全降级为全宽面板。
+
+### Fixed
+- 修复应用入口错误显示在侧栏底部、点击后只出现大尺寸右侧遮罩而没有中央原生对话的问题。
+- 修复 DSH 禁止同一 store handle 跨 root/session scope 复用导致的运行时挂载错误；会话按钮通过同页事件桥接根工作台状态。
+- 右栏打开时按实际重叠量左移输入框能力栏，避免窄桌面视口中「匹配核验」「字段补全」「任务历史」被遮挡。
+- 为 alpha.2 的 `uiWorkspace.connectWorkspace` 与 rc.2 的 `workspaces.connectWorkspace` 增加能力探测 Bridge，避免预发布版本入口只打开工作台却无法预填原生会话。
+
 ## [0.5.1] - 2026-09-03
 
 > 文档与发布流程修正版本；无运行时、QCC 工具契约或 API 变化。

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.5.1** (stable release)
+> Current source version / 当前源码版本: **0.5.3** (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)
@@ -20,9 +20,10 @@ clean name / phone / amount columns (trim, phone normalization, drop missing-req
 negative-amount / duplicate rows), deterministically complete gaps, profile the batch, and
 export clean CSV.
 
-The model only ever receives **aggregate summaries, never raw detail rows**. Details are only
-viewed and exported in the same-origin web UI, keeping customer raw data out of model context
-by construction.
+When spreadsheet data is handled in the right-side workbench, the model receives aggregate
+summaries by default while full rows stay in the same-origin UI. If the user explicitly pastes
+entities, attaches an image, or sends a spreadsheet entity preview through the prompt builder,
+that selected content enters model context; the full spreadsheet still remains local to the workbench.
 
 QCC enrichment follows a **bring-your-own connection and account (BYO QCC)** model. Each customer
 connects QCC MCP in their own DSH environment and uses quota or billing attached to their own QCC
@@ -40,10 +41,12 @@ Fully restart DeepSeek Harness afterwards (stop and re-run `dsh web`). Then say
 "help me clean this batch of company list data" and the plugin loads its built-in Skill and
 drives the clean / complete / profile tools.
 
-After restart, a "Data Cleaning" entry appears at the bottom of the sidebar: click it to open the
-workbench (upload & map → profile → match & review → enrich & export, four steps). When the model calls the clean /
-complete / profile tools, matching tool cards render in the conversation, and a jobs pill in the
-workbench header shows queued / running tasks.
+After restart, a "Data Cleaning & Completion" entry appears between "New Session" and "Workspaces"
+near the top of the sidebar. It opens a dedicated native DSH session with a business landing view,
+product/workflow introduction, and a prompt builder at the upper-left of the composer. The builder
+accepts pasted entities, locally parsed spreadsheet data, or image attachments and writes an editable
+task brief back to the native composer. Five workflow actions (upload, profile, match, enrich, history)
+sit below the composer and open the four-step workbench on demand.
 
 Without the `dsh` CLI, use the install script:
 
@@ -65,7 +68,8 @@ Or let an agent install it for you:
 | Parse | web `/data-cleaning/api/mvp/parse` | CSV / XLSX / JSON |
 | Async jobs | web `/data-cleaning/api/mvp/jobs` | job state machine + persistent storage |
 | UI | web `/data-cleaning/` | upload → clean/complete → export |
-| In-app entry | sidebar "Data Cleaning" button | opens the Mockup-aligned workbench: upload & map → profile → match & review → enrich & export |
+| 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 |
 | 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 |
@@ -106,6 +110,8 @@ See [the 0.4.0 release record](docs/RELEASE-0.4.0.md) for scope, validation gate
 See [the Phase-3 acceptance record](docs/PHASE3-ACCEPTANCE.md) and
 [the 0.5.0 release record](docs/RELEASE-0.5.0.md) for verification, upgrade, and rollback.
 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 [docs/PLAN-OSS.md](docs/PLAN-OSS.md) for details.
 

package/README.md

@@ -2,7 +2,7 @@
 
 > 在 DeepSeek Harness 中清洗、补全、画像企业名单数据的智能体插件：本地 CSV/XLSX/JSON 引擎 + 可选企查查（Qichacha/QCC）MCP 企业数据补全，由企查查（Qichacha/QCC）团队发起并维护。
 >
-> 当前源码版本 / Current source version: **0.5.1**（正式版本）
+> 当前源码版本 / Current source version: **0.5.3**（正式版本）
 
 [![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)
@@ -19,8 +19,9 @@
 对姓名、手机号、金额等列做清洗（去空格、手机号规范化、剔除缺失/负金额/重复行）、
 确定性补全与概览画像，并导出干净的 CSV。
 
-模型（LLM）**只拿到统计摘要，从不读取原始明细行**；明细只在同源 web 界面查看与导出，
-从架构上避免把客户原始数据灌进模型上下文。
+通过右侧工作台处理表格时，模型（LLM）默认只拿到统计摘要，完整明细仅在同源 web 界面查看与导出。
+如果用户主动用提示词生成器粘贴名单、附加图片或把表格主体预览回填对话框，这些用户明确选择发送的
+内容会进入模型上下文；表格完整数据仍只保留在本机工作台。
 
 企查查补全采用 **客户自带连接与账号（BYO QCC）**：每位客户在自己的 DSH 中开通企查查 MCP，
 调用消耗其自有账号的套餐额度或按其与企查查的合同计费。本插件不内置、不分发、不共享开发者 Key，
@@ -35,8 +36,10 @@ dsh plugin --profile web add dsh-data-cleaning-agent
 安装后**完全重启** DeepSeek Harness（停止后重新运行 `dsh web`）。
 之后在对话中说「帮我清洗这批企业名单数据」，插件会自动加载内嵌 Skill 并调度清洗/补全/画像工具。
 
-重启后侧边栏底部会出现「数据清洗」入口：点击打开工作台（上传与映射 → 数据体检 → 匹配核验 → 补全与导出四步），
-模型调用清洗/补全/画像工具时对话内会渲染对应工具卡片，工作台头部用任务 pill 展示排队/进行中的任务。
+重启后，「数据清洗补全」入口会显示在侧边栏顶部的「新会话」与「工作区」之间。点击后打开专属的
+DSH 原生会话：首页标题、产品说明与工作流会替换通用探索页；输入框左上角提供提示词生成器，支持
+粘贴名单、解析 Excel/CSV/JSON 或附加图片并选择清洗动作、补全字段。上传清洗、质量体检、匹配核验、
+字段补全和任务历史五个入口位于输入框下方，右侧工作台承载完整四步闭环。
 
 没有 `dsh` CLI 时，也可以用安装脚本：
 
@@ -58,7 +61,8 @@ bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-data-cleaning-a
 | 解析 | web `/data-cleaning/api/mvp/parse` | CSV / XLSX / JSON |
 | 异步任务 | web `/data-cleaning/api/mvp/jobs` | 任务状态机 + 持久化存储 |
 | UI | web `/data-cleaning/` | 上传 → 清洗/补全 → 导出 |
-| 应用内入口 | 侧边栏「数据清洗」按钮 | 打开 Mockup 对齐工作台：上传与映射 → 数据体检 → 匹配核验 → 补全与导出 |
+| 应用内入口 | 侧栏顶部「数据清洗补全」+ 输入框下方五能力按钮 | 中央业务首页与原生对话，右侧按需打开 Mockup 对齐工作台 |
+| 提示词生成 | `conversation.input.overlay` | 文本 / Excel / 图片录入、清洗项与补全维度选择，生成后回填原生输入框供人工修改 |
 | 工具卡片 | `tool.call.toolview`（`data_clean_rows`/`data_complete_rows`/`data_profile`） | 对话内渲染清洗/补全/画像结果卡，含运行/已完成/失败状态 |
 | 任务进度 | 工作台头部任务 pill | 轮询 `/data-cleaning/api/mvp/jobs`，展示排队/运行中任务 |
 | Skill | `data-cleaning` | 引导模型按工作流调度上述工具 |
@@ -102,6 +106,8 @@ bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-data-cleaning-a
 0.5.0 三域验收状态见 [docs/PHASE3-ACCEPTANCE.md](docs/PHASE3-ACCEPTANCE.md)，
 发布记录、升级与回滚见 [docs/RELEASE-0.5.0.md](docs/RELEASE-0.5.0.md)。
 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)。
 
 ## 本地开发
 

package/docs/COMPATIBILITY.md

@@ -18,9 +18,21 @@
 MVP 路由、Phase-3 capabilities、estimate 与未确认 enrich 阻断均通过。rc.2 另完成实际工作台渲染、
 中文企业名称映射和本地清洗闭环；alpha.2 仍只定位为兼容探针。
 
-0.5.1 为 README 状态与发布 Gate 文档补丁候选，不修改 Host/Client、QCC 契约或运行时依赖，
+0.5.1 为已发布的 README 状态与发布 Gate 文档补丁，不修改 Host/Client、QCC 契约或运行时依赖，
 因此继承 0.5.0 的 DSH、Node 与 OAuth 兼容矩阵。
 
+0.5.2 已发布版本只调整 Client UI：入口 Portal 到 `sidebar.workspaces` 前，中央区域复用 DSH 原生会话，
+五能力入口使用公开 `conversation.input.left`，会话头恢复入口使用公开
+`conversation.session.header.actions`，右侧面板继续使用 additive `shell.overlay`。不替换单占位
+`details` / `conversation.session.header`，也不修改 Host、QCC 工具契约或计费安全门。
+
+0.5.3 正式版本修正第二轮 UI 位置：五能力入口迁到公开 `conversation.input.dock`，只使用稳定
+`data-slot` 和 `:has()` 把本插件 cell 排到输入框下方；提示词生成器使用公开
+`conversation.input.overlay` 和标准 `inputActions.setDraft`。DSH 未提供公开 Hero headline 槽位，
+因此仅对插件创建且仍为空白的会话使用精确中英文文本匹配、卸载恢复的 DOM Bridge。图片接入对
+`conversation.createDraftImages` / `input.shell(sessionId).addImages` 做运行时探测，视为隔离兼容层，
+不承诺 alpha 实验面稳定。
+
 ## 2. Node 运行时
 
 - 本包 `engines.node` 声明 `>=20`。
@@ -73,7 +85,7 @@ MVP 路由、Phase-3 capabilities、estimate 与未确认 enrich 阻断均通过
 
 ### 4.2 应用内入口（M1–M3）双基线实测
 
-侧边栏「数据清洗」入口、全屏工作台、三张工具卡片（`data_clean_rows` /
+0.5.0/0.5.1 的侧边栏底部入口、全屏工作台、三张工具卡片（`data_clean_rows` /
 `data_complete_rows` / `data_profile`）与任务 pill 在双基线均已通过隔离 `DSH_HOME` 冒烟验证：
 
 - **rc.2**：根 HTML 直接引用 `/plugins/dsh-data-cleaning-agent/client.js?rev=…`，client bundle
@@ -84,6 +96,16 @@ MVP 路由、Phase-3 capabilities、estimate 与未确认 enrich 阻断均通过
 
 两条基线均返回 `[dc-agent] host apply() ran`，且未发起任何真实 QCC 调用。
 
+0.5.2 将入口和工作台改为 Mockup 对齐结构；已在 rc.2 与 alpha.2 的全新隔离安装中复验顶部
+Portal、原生会话、五能力按钮、跨 scope 状态桥、窄桌面布局避让与非模态右栏。alpha.2 将
+工作区导航方法放在 `uiWorkspace.connectWorkspace`，rc.2 使用 `workspaces.connectWorkspace`；
+插件只做运行时能力探测并保留 `sessions.create` 安全降级，不承诺 alpha 实验面稳定。Portal 失败时
+仍保留 footer 降级按钮。
+
+0.5.3 新增业务首页和提示词生成器，并把流程栏移出输入框。本地 tarball 已完成 rc.2 隔离
+Profile 装载与 Host 注册冒烟；受应用内浏览器本机 URL 策略限制，深浅色、窄屏和精确像素位置仍作为
+发布后人工观察项，当前单元测试与源码契约测试不能替代该视觉检查。
+
 ### 4.3 0.5.0 三域兼容面
 
 | 能力 | rc.2 | alpha.2 | 备注 |

package/docs/RELEASE-0.5.1.md

@@ -2,13 +2,15 @@
 
 > 版本：**0.5.1**（文档与发布流程修正，无运行时代码变化）
 >
-> 公共发布状态以 npm Registry 与 GitHub Releases 为准；本文件随 0.5.1 发布物固化。
+> 状态：**✅ 已发布；npm `latest`、Git tag 与 GitHub Latest 均为 `0.5.1`。**
+>
+> 发布时间：2026-09-03T03:06:54Z
 
 ## 1. 目的与范围
 
 0.5.1 只修正 0.5.0 npm tarball 中不可变 README 的历史状态文案，并加固发布流程：
 
-- 中英文 README 随 `package.json` 更新为 0.5.1 文档补丁候选；
+- 中英文 README 随 `package.json` 更新，并在标签提交中切换为不含动态 `latest` 的 0.5.1 正式态；
 - 标签发布时，`docs:check` 强制要求两份 README 都声明当前版本已正式发布；
 - Release workflow 显式设置 `DSH_RELEASE_MODE=1`，严格文案门在 `npm publish` 前执行；
 - 增加普通分支允许候选、标签拒绝候选、标签接受正式文案三项单测；
@@ -33,9 +35,11 @@
 - [x] 发布前将 README.md / README.en.md 切换为不含动态 `latest` 的 0.5.1 正式发布态。
 - [x] `DSH_RELEASE_MODE=1 npm run check` 在正式文案下全绿：128/128、36 文件。
 - [x] 用户单独批准 `v0.5.1` tag、OIDC npm publish 与 GitHub Release。
-- [ ] 发布后核验 SLSA provenance、GitHub Latest 与公共 Registry 全新安装。
+- [x] `v0.5.1` annotated tag 指向 `19205ec`；Release workflow `33710151625` 全绿。
+- [x] npm OIDC publish 与 SLSA v1 provenance、GitHub Latest 均已验证。
+- [x] 公共 Registry 全新安装通过，ESM 导出与中英文 README 正式态均正确。
 
-未经最后两项确认，不得创建标签或发布 npm。
+后续任何版本仍须重新取得发布授权，不得覆盖已发布版本。
 
 ## 4. 回滚
 

package/docs/RELEASE-0.5.2.md

@@ -0,0 +1,47 @@
+# 0.5.2 DSH 原生 UI 对齐发布记录
+
+> 版本：**0.5.2**
+>
+> 状态：**✅ 已发布；npm `latest`、Git tag 与 GitHub Latest 均为 `0.5.2`。**
+>
+> 发布时间：2026-09-03T06:10:34Z
+
+## 1. 目的与范围
+
+0.5.2 将数据清洗补全智能体的入口和工作流对齐 DSH 原生交互：
+
+- 左栏入口位于「新会话」与「工作区」之间，不再显示在侧栏底部；
+- 点击入口后复用中央原生会话，并预填数据清洗提示词；
+- 原生输入框工具行提供上传清洗、质量体检、匹配核验、字段补全和任务历史五个入口；
+- 工作台改为非模态右侧面板，中央会话保持可见；
+- 任务历史复用 Host `/mvp/jobs` 状态，可恢复已有任务；
+- 对 DSH `0.1.1-rc.2` 与 `0.1.2-alpha.2` 的 workspace 连接服务做隔离能力探测。
+
+本版本不扩展历史域、人员域或招投标域，不改变 QCC OAuth、计费确认、工具允许列表或数据契约。
+
+## 2. 验证
+
+- `DSH_RELEASE_MODE=1 npm run check`：lint、双语正式版本文案、marketing、pack 白名单和 132 项测试全部通过；
+- DSH `0.1.1-rc.2` / `0.1.2-alpha.2` 全新隔离安装与 UI 冒烟通过；
+- 已验证顶部入口、中央原生会话、五能力按钮、非模态右栏、布局避让、上传解析和质量体检；
+- 本轮 UI 验收没有调用 QCC，也没有触碰生产 DSH Host。
+- `v0.5.2` annotated tag 指向 `a1bb68a`；Release workflow `33722000758` 全绿；
+- npm 公共 Registry 返回 `latest=0.5.2`，provenance predicate 为 SLSA v1；
+- 公共 Registry 全新安装成功，ESM 导出为 `apply / inject / name`，包内中英文 README 均为 0.5.2 正式态；
+- GitHub Release 为非 draft、非 prerelease：https://github.com/duhu2000/dsh-data-cleaning-agent/releases/tag/v0.5.2 。
+
+## 3. 升级与回滚
+
+升级：
+
+```bash
+dsh plugin --profile web add dsh-data-cleaning-agent@0.5.2
+```
+
+如需回滚，安装上一稳定版本：
+
+```bash
+dsh plugin --profile web add dsh-data-cleaning-agent@0.5.1
+```
+
+npm 已发布版本不可覆盖；如发布后发现问题，使用新的补丁版本修复。

package/docs/RELEASE-0.5.3.md

@@ -0,0 +1,59 @@
+# 0.5.3 UI 二次对齐发布记录
+
+> 版本：**0.5.3**
+>
+> 状态：**正式版本；由 `v0.5.3` 标签触发 npm OIDC Trusted Publishing 与 GitHub Release。**
+>
+> 发布日期：2026-09-03
+
+## 目标
+
+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 被浏览器安全策略阻止二次访问，
+> 因此标题、流程栏位置、弹层及深浅色/窄屏保留为发布后人工观察项，未用替代浏览器绕过。
+
+## 升级与回滚
+
+- 升级候选：安装本地 `npm pack` 产物并完全重启 DSH；不覆盖客户 OAuth grant 或 Key。
+- 回滚：重新安装 `dsh-data-cleaning-agent@0.5.2` 并完全重启 DSH。
+- 0.5.3 不修改 Host 路由、QCC 工具契约、存储 schema 或导出格式，回滚无需数据迁移。

package/docs/USER-GUIDE.md

@@ -24,15 +24,27 @@ bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-data-cleaning-a
 
 插件会加载内嵌 Skill `data-cleaning`，自动按 `data_profile → data_clean_rows → data_complete_rows` 工作流调度。
 
-### 2.2 应用内入口（侧边栏「数据清洗」）
+### 2.2 应用内入口（侧边栏「数据清洗补全」）
 
-重启后，DeepSeek Harness 侧边栏底部会出现「数据清洗」按钮。点击打开全屏工作台，按四步操作：
+重启后，DeepSeek Harness 侧栏顶部的「新会话」与「工作区」之间会出现「数据清洗补全」。点击后先进入
+中央业务首页，右侧工作台保持关闭；输入框下方的五个入口分别定位到上传清洗、质量体检、匹配核验、
+字段补全和任务历史。处理步骤为：
 
 1. **上传与映射**：粘贴或上传 CSV / XLSX / JSON，确认企业名称字段；
 2. **数据体检**：查看列概览、缺失和金额分布；
 3. **匹配核验**：先做本地清洗，再选择风险/知产/经营域；多候选由人工确认；
 4. **补全与导出**：恢复任务、重试可重试失败，下载结果 CSV 和复核 CSV。
 
+输入框左上角的「提示词生成」提供三种名单录入方式：
+
+- **粘贴名单**：每行一个企业名称或统一社会信用代码；
+- **上传 Excel**：支持 XLSX/XLS/CSV/JSON，识别企业名称/信用代码列并把完整数据载入右侧工作台；
+- **上传图片**：把 PNG/JPEG/WebP 附加到当前原生对话，并生成“使用当前已连接且可用的企查查智能文档解析 MCP”要求。
+
+随后可选择名称规范、信用代码校验、去重、模糊候选复核等清洗动作，以及工商字段或已支持的维度组。
+点击「生成并回填」后，任务描述进入原生对话框；发送前仍可人工修改。图片能力不可用时，请改用输入框
+原生“＋”或文本/Excel。提示词生成器不会硬编码未验证的 QCC 工具名，也不会绕过付费确认门。
+
 模型在对话中调用 `data_clean_rows` / `data_complete_rows` / `data_profile` 时，
 对话内会渲染对应的工具结果卡片（含运行中 / 已完成 / 失败状态）；工作台头部用任务 pill
 实时展示排队 / 运行中的后台任务（轮询 `/data-cleaning/api/mvp/jobs`）。