dsh-data-cleaning-agent 0.5.2 → 0.5.3

package/CHANGELOG.md

@@ -4,6 +4,27 @@
 
 ## [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、计费确认或数据契约。

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.2** (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 between "New Session" and "Workspaces" near the top
-of the sidebar. It opens a native DSH conversation with five composer actions (upload, profile,
-match, enrich, and history) and a right-side workbench for the four-step flow. Clean / complete /
-profile tool calls continue to render matching cards in the native conversation.
+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 | top sidebar entry + five native composer actions | keeps the DSH conversation in the center and opens the Mockup-aligned workbench on the right |
+| 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 |
@@ -107,6 +111,7 @@ 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.2**（正式版本）
+> 当前源码版本 / 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,9 +36,10 @@ dsh plugin --profile web add dsh-data-cleaning-agent
 安装后**完全重启** DeepSeek Harness（停止后重新运行 `dsh web`）。
 之后在对话中说「帮我清洗这批企业名单数据」，插件会自动加载内嵌 Skill 并调度清洗/补全/画像工具。
 
-重启后，「数据清洗」入口会显示在侧边栏顶部的「新会话」与「工作区」之间。点击后打开 DSH 原生会话，
-输入框工具行提供上传清洗、质量体检、匹配核验、字段补全和任务历史五个入口；右侧工作台承载
-上传与映射 → 数据体检 → 匹配核验 → 补全与导出四步。模型调用工具时，对话内会渲染对应工具卡片。
+重启后，「数据清洗补全」入口会显示在侧边栏顶部的「新会话」与「工作区」之间。点击后打开专属的
+DSH 原生会话：首页标题、产品说明与工作流会替换通用探索页；输入框左上角提供提示词生成器，支持
+粘贴名单、解析 Excel/CSV/JSON 或附加图片并选择清洗动作、补全字段。上传清洗、质量体检、匹配核验、
+字段补全和任务历史五个入口位于输入框下方，右侧工作台承载完整四步闭环。
 
 没有 `dsh` CLI 时，也可以用安装脚本：
 
@@ -59,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/` | 上传 → 清洗/补全 → 导出 |
-| 应用内入口 | 侧栏顶部「数据清洗」+ 原生输入框五能力按钮 | 中央保留 DSH 原生对话，右侧打开 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` | 引导模型按工作流调度上述工具 |
@@ -104,6 +107,7 @@ bash <(curl -fsSL https://raw.githubusercontent.com/duhu2000/dsh-data-cleaning-a
 发布记录、升级与回滚见 [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

@@ -21,11 +21,18 @@ MVP 路由、Phase-3 capabilities、estimate 与未确认 enrich 阻断均通过
 0.5.1 为已发布的 README 状态与发布 Gate 文档补丁，不修改 Host/Client、QCC 契约或运行时依赖，
 因此继承 0.5.0 的 DSH、Node 与 OAuth 兼容矩阵。
 
-0.5.2 源码候选只调整 Client UI：入口 Portal 到 `sidebar.workspaces` 前，中央区域复用 DSH 原生会话，
+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`。
@@ -95,6 +102,10 @@ Portal、原生会话、五能力按钮、跨 scope 状态桥、窄桌面布局
 插件只做运行时能力探测并保留 `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.2.md

@@ -2,9 +2,9 @@
 
 > 版本：**0.5.2**
 >
-> 状态：**正式版本；由 `v0.5.2` 标签触发 npm OIDC Trusted Publishing 与 GitHub Release。**
+> 状态：**✅ 已发布；npm `latest`、Git tag 与 GitHub Latest 均为 `0.5.2`。**
 >
-> 发布日期：2026-09-03
+> 发布时间：2026-09-03T06:10:34Z
 
 ## 1. 目的与范围
 
@@ -25,6 +25,10 @@
 - 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. 升级与回滚
 

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`）。

package/lib/client.js

@@ -8,8 +8,10 @@
  *   - `defineStore` 首选 `@deepseek-ai/dsh-client-store`，回退 `@deepseek-ai/dsh-client-runtime/client`。
  *   - `sidebar.footer.action` 仅托管入口生命周期和降级渲染；实际入口 Portal 到
  *     `sidebar.workspaces` 前，位于「新会话」与「工作区」之间。
- *   - DSH 原生会话保持在中间，能力入口使用 `conversation.input.left`，右侧非模态
- *     工作台使用 `shell.overlay`，会话头使用 `conversation.session.header.actions`。
+ *   - DSH 原生会话保持在中间，能力入口使用 `conversation.input.dock` 并通过稳定
+ *     `data-slot` 排到输入框下方；右侧非模态工作台使用 `shell.overlay`。
+ *   - 提示词生成器使用 `conversation.input.overlay`，只对本插件创建的会话生效。
+ *     Hero 标题没有公开替换槽位，故以可恢复、精确文本匹配的 DOM Bridge 对齐业务首页。
  *
  * 0.5.0 工作台复用本地 `/mvp/*` 与三域 `/phase3/*` 后端，完整覆盖上传映射、
  * 数据体检、匹配核验、补全导出；计费调用仍由 Host Bridge 的确认/幂等/上限门约束。
@@ -124,9 +126,14 @@ window.__ModuleLoader__.load({
 
 .dcAgentCapabilities {
   display: flex;
+  justify-content: center;
   align-items: center;
-  gap: 4px;
-  max-width: min(56vw, 560px);
+  gap: 8px;
+  width: 100%;
+  max-width: var(--dsh-composer-card-max-width, 780px);
+  box-sizing: border-box;
+  margin: 0 auto;
+  padding: 2px 16px 0;
   overflow-x: auto;
   scrollbar-width: none;
   transform: translateX(var(--dc-agent-workbench-shift, 0px));
@@ -138,11 +145,14 @@ window.__ModuleLoader__.load({
   align-items: center;
   gap: 5px;
   flex: 0 0 auto;
-  min-height: 30px;
-  padding: 4px 8px;
-  border: 1px solid transparent;
-  border-radius: 8px;
-  background: transparent;
+  min-width: 108px;
+  min-height: 54px;
+  padding: 7px 12px;
+  flex-direction: column;
+  justify-content: center;
+  border: 1px solid light-dark(#e4e8f0, #303947);
+  border-radius: 12px;
+  background: light-dark(rgba(255,255,255,.86), rgba(22,27,35,.86));
   color: light-dark(#5d687a, #aab5c7);
   font: inherit;
   font-size: 12px;
@@ -157,6 +167,212 @@ window.__ModuleLoader__.load({
 }
 .dcAgentCapability svg { flex: 0 0 auto; }
 
+/* DSH 官方 input.dock 默认在 composer 上方；只把本插件自己的 cell 排到下方。 */
+[data-slot="conversation.input.dock"]:has(.dcAgentExperience) {
+  order: 20;
+}
+
+.dcAgentExperience {
+  width: 100%;
+  box-sizing: border-box;
+}
+
+.dcAgentProductHome {
+  width: 100%;
+  max-width: var(--dsh-composer-card-max-width, 780px);
+  box-sizing: border-box;
+  margin: 10px auto 0;
+  padding: 16px 18px;
+  border: 1px solid light-dark(#e4e8f0, #303947);
+  border-radius: 16px;
+  background: light-dark(rgba(255,255,255,.82), rgba(20,25,33,.86));
+  box-shadow: light-dark(0 10px 30px rgba(42,75,120,.06), 0 14px 34px rgba(0,0,0,.14));
+}
+.dcAgentProductHome h2 {
+  margin: 0;
+  color: light-dark(#172033, #edf2fa);
+  font-size: 16px;
+  line-height: 24px;
+}
+.dcAgentProductHome > p {
+  margin: 4px 0 12px;
+  color: light-dark(#697386, #aab5c7);
+  font-size: 12px;
+  line-height: 18px;
+}
+.dcAgentHomeFlow {
+  display: grid;
+  grid-template-columns: repeat(4, minmax(0, 1fr));
+  gap: 8px;
+}
+.dcAgentHomeStep {
+  min-width: 0;
+  padding: 9px 8px;
+  border-radius: 10px;
+  background: light-dark(#f4f7fc, #1c2330);
+  color: light-dark(#33415a, #c9d4e5);
+  font-size: 12px;
+  line-height: 18px;
+}
+.dcAgentHomeStep b {
+  display: block;
+  margin-bottom: 2px;
+  color: light-dark(#1556cf, #8cb3ff);
+  font-size: 11px;
+}
+.dcAgentHomeTrust {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  margin-top: 10px;
+}
+.dcAgentHomeTrust span {
+  padding: 3px 8px;
+  border: 1px solid light-dark(#dce4f1, #344052);
+  border-radius: 999px;
+  color: light-dark(#59677c, #b1bdd0);
+  font-size: 11px;
+}
+
+/* input.overlay 是 DSH 官方浮层锚点；给触发器让出输入卡片顶部空间。 */
+[data-composer-card]:has(.dcAgentPromptTrigger) {
+  padding-top: 48px;
+}
+.dcAgentPromptLayer {
+  position: absolute;
+  inset: 0;
+  z-index: 40;
+  pointer-events: none;
+}
+.dcAgentPromptTrigger {
+  position: absolute;
+  top: 10px;
+  left: 16px;
+  min-height: 28px;
+  padding: 3px 10px;
+  border: 1px solid light-dark(#c9d9f8, #365681);
+  border-radius: 999px;
+  background: light-dark(#edf4ff, #172841);
+  color: light-dark(#1556cf, #8cb3ff);
+  font: inherit;
+  font-size: 12px;
+  cursor: pointer;
+  pointer-events: auto;
+}
+.dcAgentPromptPanel {
+  position: absolute;
+  top: 44px;
+  left: 16px;
+  width: min(660px, calc(100vw - 120px));
+  max-height: min(68vh, 660px);
+  box-sizing: border-box;
+  overflow: auto;
+  padding: 16px;
+  border: 1px solid light-dark(#d5dae4, #303947);
+  border-radius: 16px;
+  background: light-dark(#ffffff, #161b23);
+  color: light-dark(#172033, #edf2fa);
+  box-shadow: light-dark(0 18px 48px rgba(33,55,88,.20), 0 20px 54px rgba(0,0,0,.40));
+  pointer-events: auto;
+}
+.dcAgentPromptHead {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 12px;
+  margin-bottom: 12px;
+}
+.dcAgentPromptHead h3 { margin: 0; font-size: 16px; line-height: 22px; }
+.dcAgentPromptHead p { margin: 3px 0 0; color: light-dark(#697386, #aab5c7); font-size: 11px; line-height: 17px; }
+.dcAgentPromptClose {
+  width: 28px;
+  height: 28px;
+  flex: none;
+  border: 0;
+  border-radius: 50%;
+  background: transparent;
+  color: inherit;
+  cursor: pointer;
+}
+.dcAgentPromptClose:hover { background: light-dark(#f1f4f8, #222a36); }
+.dcAgentPromptTabs { display: flex; flex-wrap: wrap; gap: 6px; margin-bottom: 10px; }
+.dcAgentPromptTab,
+.dcAgentPromptChoice {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  min-height: 32px;
+  padding: 5px 10px;
+  border: 1px solid light-dark(#d9dee8, #394352);
+  border-radius: 9px;
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  font-size: 12px;
+  cursor: pointer;
+}
+.dcAgentPromptTab.is-active,
+.dcAgentPromptChoice.is-selected {
+  border-color: light-dark(#2869e6, #6d9eff);
+  background: light-dark(#edf4ff, #172841);
+  color: light-dark(#1556cf, #8cb3ff);
+}
+.dcAgentPromptField { display: grid; gap: 6px; margin: 10px 0; }
+.dcAgentPromptField > span { font-size: 12px; font-weight: 600; }
+.dcAgentPromptText {
+  box-sizing: border-box;
+  width: 100%;
+  min-height: 104px;
+  resize: vertical;
+  padding: 10px 12px;
+  border: 1px solid light-dark(#d9dee8, #394352);
+  border-radius: 10px;
+  background: light-dark(#fbfcfe, #11171f);
+  color: inherit;
+  font: inherit;
+  font-size: 12px;
+  line-height: 20px;
+}
+.dcAgentPromptFile {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 12px;
+  border: 1px dashed light-dark(#b9c5d8, #43516a);
+  border-radius: 10px;
+  color: light-dark(#59677c, #b1bdd0);
+  font-size: 12px;
+}
+.dcAgentPromptFile input { max-width: 100%; }
+.dcAgentPromptGroup { margin-top: 12px; }
+.dcAgentPromptGroup > b { display: block; margin-bottom: 7px; font-size: 12px; }
+.dcAgentPromptChoices { display: flex; flex-wrap: wrap; gap: 6px; }
+.dcAgentPromptChoice input { margin: 0; }
+.dcAgentPromptNote {
+  margin: 10px 0 0;
+  padding: 8px 10px;
+  border-radius: 8px;
+  background: light-dark(#f6f8fb, #1c2330);
+  color: light-dark(#697386, #aab5c7);
+  font-size: 11px;
+  line-height: 17px;
+}
+.dcAgentPromptError { margin: 8px 0 0; color: light-dark(#b42318, #ff8d86); font-size: 11px; }
+.dcAgentPromptActions { display: flex; justify-content: flex-end; gap: 8px; margin-top: 14px; }
+.dcAgentPromptAction {
+  min-height: 34px;
+  padding: 6px 13px;
+  border: 1px solid light-dark(#d9dee8, #394352);
+  border-radius: 9px;
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  font-size: 12px;
+  cursor: pointer;
+}
+.dcAgentPromptAction.is-primary { border-color: #2869e6; background: #2869e6; color: white; }
+.dcAgentPromptAction:disabled { opacity: .5; cursor: default; }
+
 .dcAgentHeaderAction {
   display: inline-flex;
   align-items: center;
@@ -465,7 +681,10 @@ window.__ModuleLoader__.load({
   .dcAgentStepper { grid-template-columns: repeat(2, minmax(0, 1fr)); }
   .dcAgentQccBadge { display: none; }
   .dcAgentCandidate { grid-template-columns: 1fr; }
-  .dcAgentCapabilityLabel { display: none; }
+  .dcAgentCapabilities { justify-content: flex-start; padding-inline: 12px; }
+  .dcAgentCapability { min-width: 92px; }
+  .dcAgentPromptPanel { left: 8px; width: calc(100vw - 88px); max-height: 72vh; }
+  .dcAgentHomeFlow { grid-template-columns: repeat(2, minmax(0, 1fr)); }
 }
 `;
 
@@ -498,7 +717,111 @@ window.__ModuleLoader__.load({
       { key: 'history', label: '任务历史', icon: IconArchiveOutline20, fallback: '◷' },
     ];
 
-    const DEFAULT_SESSION_PROMPT = '请帮我清洗并补全企业名单。我会在右侧数据清洗工作台上传文件或粘贴数据。';
+    const CLEANING_OPTIONS = [
+      ['normalize_name', '规范企业名称'],
+      ['complete_name', '补全 / 修正旧名称'],
+      ['verify_credit', '校验 / 补全信用代码'],
+      ['deduplicate', '重复企业去重'],
+      ['manual_review', '模糊候选人工确认'],
+    ];
+    const ENRICHMENT_OPTIONS = [
+      ['credit_no', '统一社会信用代码'],
+      ['legal_rep', '法定代表人'],
+      ['reg_capital', '注册资本'],
+      ['establish_date', '成立日期'],
+      ['reg_status', '登记 / 经营状态'],
+      ['panorama', '企业全景与联系方式'],
+      ['ownership', '股权与对外投资'],
+      ['governance', '主要人员与变更年报'],
+      ['risk', '风险信息'],
+      ['ipr', '知识产权'],
+      ['operation', '经营信息'],
+    ];
+    const DEFAULT_CLEANING_KEYS = ['normalize_name', 'complete_name', 'verify_credit', 'deduplicate', 'manual_review'];
+    const DEFAULT_ENRICHMENT_KEYS = ['credit_no', 'legal_rep', 'reg_capital', 'establish_date', 'reg_status'];
+    const DEFAULT_SESSION_PROMPT = '请帮我清洗并补全企业名单。可点击输入框左上角「提示词生成」录入名单、上传 Excel 或图片，也可直接修改本段任务说明后开始。';
+    const CLEANING_SESSION_STORAGE_KEY = 'dsh.data-cleaning-agent.sessions.v1';
+    const CLEANING_SESSION_EVENT = 'dsh:data-cleaning-session-marked';
+    const cleaningSessionIds = new Set();
+
+    try {
+      const stored = window.sessionStorage?.getItem(CLEANING_SESSION_STORAGE_KEY);
+      for (const id of JSON.parse(stored || '[]')) {
+        if (typeof id === 'string' && id) cleaningSessionIds.add(id);
+      }
+    } catch (_error) {
+      // sessionStorage 可能被禁用；当前页面内的 Set 仍可工作。
+    }
+
+    function isCleaningSession(sessionId) {
+      return typeof sessionId === 'string' && cleaningSessionIds.has(sessionId);
+    }
+
+    function markCleaningSession(sessionId) {
+      if (typeof sessionId !== 'string' || !sessionId) return;
+      cleaningSessionIds.add(sessionId);
+      try {
+        window.sessionStorage?.setItem(CLEANING_SESSION_STORAGE_KEY, JSON.stringify([...cleaningSessionIds].slice(-20)));
+      } catch (_error) {
+        // 不因浏览器存储策略阻断会话。
+      }
+      if (typeof window.CustomEvent === 'function' && typeof window.dispatchEvent === 'function') {
+        window.dispatchEvent(new window.CustomEvent(CLEANING_SESSION_EVENT, { detail: { sessionId } }));
+      }
+    }
+
+    function useCleaningSession(sessionId) {
+      const [markedSessionId, setMarkedSessionId] = react.useState(
+        isCleaningSession(sessionId) ? sessionId : null,
+      );
+      react.useEffect(() => {
+        const handleMarked = (event) => {
+          if (event?.detail?.sessionId === sessionId) setMarkedSessionId(sessionId);
+        };
+        window.addEventListener?.(CLEANING_SESSION_EVENT, handleMarked);
+        return () => window.removeEventListener?.(CLEANING_SESSION_EVENT, handleMarked);
+      }, [sessionId]);
+      // DSH 可能复用同一个 slot component 切换会话；状态必须绑定具体 sessionId，
+      // 避免从清洗会话切回普通会话后仍残留业务首页与提示词入口。
+      return markedSessionId === sessionId || isCleaningSession(sessionId);
+    }
+
+    function optionLabels(options, keys) {
+      const selected = new Set(Array.isArray(keys) ? keys : []);
+      return options.filter(([key]) => selected.has(key)).map(([, label]) => label);
+    }
+
+    /** 纯函数：把向导选择转换成可编辑、可审计的自然语言任务描述。 */
+    function buildTaskPrompt(config = {}) {
+      const mode = config.mode ?? 'text';
+      const cleanLabels = optionLabels(CLEANING_OPTIONS, config.cleaningKeys);
+      const enrichLabels = optionLabels(ENRICHMENT_OPTIONS, config.enrichmentKeys);
+      const entries = Array.isArray(config.entries)
+        ? config.entries.map((value) => String(value ?? '').trim()).filter(Boolean)
+        : [];
+      const entryCount = Number.isFinite(config.entryCount) ? config.entryCount : entries.length;
+      const source = mode === 'image'
+        ? `已附加图片${config.fileName ? `「${config.fileName}」` : ''}`
+        : mode === 'excel'
+          ? `本地表格${config.fileName ? `「${config.fileName}」` : ''}，已解析 ${entryCount} 条主体标识，完整数据已载入数据清洗补全工作台`
+          : `手工录入，共 ${entryCount} 条主体标识`;
+      const lines = [
+        '请执行一项企业名单数据清洗补全任务。',
+        `输入来源：${source}。`,
+      ];
+      if (mode === 'image') {
+        lines.push('请先使用当前已连接且可用的企查查智能文档解析 MCP 能力，从图片中提取企业全称或统一社会信用代码；若该能力未连接或不可用，请先提示我改用文本或 Excel。');
+      }
+      if (entries.length) {
+        lines.push(`${mode === 'excel' ? '主体预览' : '待处理主体'}：\n${entries.map((entry, index) => `${index + 1}. ${entry}`).join('\n')}`);
+      }
+      lines.push(`清洗要求：${cleanLabels.length ? cleanLabels.join('、') : '仅解析，不自动修改'}。`);
+      lines.push(`需要补全的字段 / 维度：${enrichLabels.length ? enrichLabels.join('、') : '不调用外部补全，仅输出本地清洗结果'}。`);
+      lines.push('处理规则：企业全称、统一社会信用代码或注册号优先精确匹配；精确匹配失败时再进入模糊候选，存在多个候选必须暂停并让我确认，不得默认选择第一项。');
+      lines.push('请先生成数据质量体检与匹配摘要，经我确认后再执行需要消耗额度的企查查 MCP 调用；企查查连接、套餐额度和费用均由当前用户自己的账号承担。缺失或无权限字段请留空并标记原因，不得编造。');
+      lines.push('完成后保留来源原值、标准主体、匹配状态与字段来源，并提供结果和待复核清单的导出。');
+      return lines.join('\n\n');
+    }
 
     /** 后端往返：POST JSON，返回解析后的对象。 */
     async function api(path, body) {
@@ -598,7 +921,7 @@ window.__ModuleLoader__.load({
         : items.find((item) => Array.isArray(item.sessionIds) && item.sessionIds.includes(current))?.workspaceId;
       const targetWorkspaceId = currentWorkspaceId ?? workspace.recentWorkspaceId ?? items[0]?.workspaceId;
       if (targetWorkspaceId === undefined) {
-        throw new Error('请先选择一个工作空间，再打开数据清洗智能体');
+        throw new Error('请先选择一个工作空间，再打开数据清洗补全智能体');
       }
       // rc.2 暴露 workspaces.connectWorkspace；alpha.2 把同一导航策略迁移到
       // uiWorkspace.connectWorkspace，纯 workspaces controller 不再带该方法。
@@ -617,11 +940,33 @@ window.__ModuleLoader__.load({
       if (!sessionId) throw new Error('当前 DSH 版本没有可用的工作区会话创建能力');
       const conversation = typeof ctx.get === 'function' ? ctx.get('conversation') : ctx.conversation;
       if (!conversation) throw new Error('DSH 对话服务尚未就绪，请稍后重试');
+      markCleaningSession(sessionId);
       conversation.input.shell(sessionId).setDraft(DEFAULT_SESSION_PROMPT);
       ctx.sessions.open(sessionId);
       return sessionId;
     }
 
+    /**
+     * 图片接入兼容 Bridge。仅在运行时同时探测到 createDraftImages / input.shell.addImages
+     * 时使用；失败会释放浏览器临时对象，不假设 alpha 实验 API 稳定。
+     */
+    function attachPromptImages(ctx, sessionId, files) {
+      const conversation = typeof ctx.get === 'function' ? ctx.get('conversation') : ctx.conversation;
+      if (!conversation || typeof conversation.createDraftImages !== 'function') {
+        throw new Error('当前 DSH 版本不支持从插件附加图片，请使用输入框原生“＋”按钮上传。');
+      }
+      const shell = conversation.input?.shell?.(sessionId);
+      if (!shell || typeof shell.addImages !== 'function') {
+        throw new Error('当前会话的图片输入能力尚未就绪，请稍后重试。');
+      }
+      const images = conversation.createDraftImages(files);
+      if (!shell.addImages(images.map((image) => image.id))) {
+        conversation.releaseDraftImages?.(images);
+        throw new Error('图片未能加入当前对话，请检查格式或数量限制。');
+      }
+      return images.length;
+    }
+
     function capabilityIcon(item, size = 16) {
       return typeof item.icon === 'function'
         ? h(item.icon, { size, 'aria-hidden': 'true' })
@@ -634,6 +979,7 @@ window.__ModuleLoader__.load({
     }
 
     const WORKBENCH_OPEN_EVENT = 'dsh:data-cleaning-workbench-open';
+    const WORKBENCH_DATASET_EVENT = 'dsh:data-cleaning-workbench-dataset';
 
     // session scope 不能复用 root scope 的 store handle。DSH 当前会分别物化 root/session
     // 插槽组件，因此以 document 事件跨 scope 通知；闭包引用仅作为无 DOM 测试降级。
@@ -651,10 +997,25 @@ window.__ModuleLoader__.load({
       if (rootWorkbenchActions) openWorkbench(rootWorkbenchActions, step, sessionId);
     }
 
+    /** 把提示词生成器解析出的完整表格交给 root 工作台，不把整表塞进模型上下文。 */
+    function requestWorkbenchDataset(result, sessionId) {
+      if (typeof document !== 'undefined'
+        && typeof document.createEvent === 'function'
+        && typeof document.dispatchEvent === 'function') {
+        const event = document.createEvent('CustomEvent');
+        event.initCustomEvent(WORKBENCH_DATASET_EVENT, false, true, { result, sessionId });
+        if (!document.dispatchEvent(event)) return;
+      }
+      if (rootWorkbenchActions) {
+        applyParsed(result, rootWorkbenchActions);
+        rootWorkbenchActions.setActiveSession(sessionId);
+      }
+    }
+
     /** 左栏入口按钮：公开 footer 托管，真实按钮 Portal 到「新会话 / 工作区」之间。 */
     function SidebarEntry(props) {
       const { wide, useStore, actions, startSession } = props;
-      const open = useStore((state) => state.open);
+      useStore((state) => state.open);
       const [topMount, setTopMount] = react.useState(null);
 
       react.useEffect(() => {
@@ -683,12 +1044,9 @@ window.__ModuleLoader__.load({
         variant: 'ghost',
         className: 'dcAgentLauncher',
         'data-wide': wide,
-        'aria-label': '数据清洗',
-        'aria-haspopup': 'dialog',
-        'aria-expanded': open,
+        'aria-label': '数据清洗补全',
         onClick: async () => {
           try {
-            openWorkbench(actions, 'upload');
             if (typeof startSession === 'function') {
               const sessionId = await startSession();
               actions.setActiveSession(sessionId);
@@ -698,7 +1056,7 @@ window.__ModuleLoader__.load({
             console.error('[dc-agent] open failed:', error);
           }
         },
-        children: wide ? '🧹 数据清洗' : '🧹',
+        children: wide ? '🧹 数据清洗补全' : '🧹',
       });
       if (!topMount || typeof reactDom.createPortal !== 'function') return launcher;
       return reactDom.createPortal(h('div', {
@@ -707,10 +1065,10 @@ window.__ModuleLoader__.load({
       }, launcher), topMount);
     }
 
-    /** Mockup 五能力入口：位于原生 composer 的交互工具行。 */
+    /** Mockup 五能力入口：由 input.dock 承载，并在 CSS 中排到原生 composer 下方。 */
     function CapabilityBar(props) {
       const { sessionId } = props;
-      return h('div', { className: 'dcAgentCapabilities', 'aria-label': '数据清洗智能体能力' },
+      return h('div', { className: 'dcAgentCapabilities', 'aria-label': '数据清洗补全智能体能力' },
         CAPABILITIES.map((item) => h('button', {
           key: item.key,
           type: 'button',
@@ -725,20 +1083,292 @@ window.__ModuleLoader__.load({
       );
     }
 
+    function ProductHome() {
+      const flow = [
+        ['01', '录入名单', '文本、Excel 或图片'],
+        ['02', '质量体检', '缺失、重复与格式诊断'],
+        ['03', '主体匹配', '精确优先，多候选复核'],
+        ['04', '补全导出', '按需选字段，保留来源'],
+      ];
+      return h('section', { className: 'dcAgentProductHome', 'aria-label': '数据清洗补全产品介绍' },
+        h('h2', null, '把企业名单变成可核验、可回写的标准数据'),
+        h('p', null, '面向销售线索、客户尽调、供应商管理与 CRM / ERP 数据治理，先本地体检清洗，再按需使用当前用户连接的企查查 MCP 补全。'),
+        h('div', { className: 'dcAgentHomeFlow', 'aria-label': '数据清洗补全工作流' },
+          flow.map(([index, title, hint]) => h('div', { className: 'dcAgentHomeStep', key: index },
+            h('b', null, index),
+            h('span', null, title),
+            h('small', { style: { display: 'block', opacity: .72 } }, hint),
+          )),
+        ),
+        h('div', { className: 'dcAgentHomeTrust' },
+          h('span', null, '本地解析与确定性清洗'),
+          h('span', null, '匹配候选人工确认'),
+          h('span', null, '客户自带企查查连接与额度'),
+          h('span', null, '结果与待复核清单可导出'),
+        ),
+      );
+    }
+
+    /**
+     * DSH 当前只公开 hero brand.mark，没有 headline slot。这里仅在本插件会话且 blank hero
+     * 阶段精确替换原生中英文标题，并在卸载时恢复，避免污染普通会话。
+     */
+    function rewriteHeroChrome(sessionId, enabled) {
+      if (!enabled || typeof document === 'undefined' || typeof document.querySelectorAll !== 'function') return () => {};
+      const marker = [...document.querySelectorAll('.dcAgentExperience')]
+        .find((element) => element?.dataset?.sessionId === sessionId);
+      const hero = marker?.closest?.('[data-phase="hero"]');
+      if (!hero) return () => {};
+      const spans = [...hero.querySelectorAll('span')];
+      const title = spans.find((element) => ['探索未至之境', 'Into the Unknown'].includes(element.textContent?.trim()))
+        ?? spans.find((element) => element.dataset?.dcAgentHeroTitle === 'true');
+      const badge = spans.find((element) => ['预览版', 'Preview'].includes(element.textContent?.trim()))
+        ?? spans.find((element) => element.dataset?.dcAgentHeroBadge === 'true');
+      if (title) {
+        title.dataset.dcAgentHeroTitle = 'true';
+        title.dataset.dcAgentOriginalText ??= title.textContent ?? '';
+        title.textContent = '数据清洗补全智能体';
+      }
+      if (badge) {
+        badge.dataset.dcAgentHeroBadge = 'true';
+        badge.dataset.dcAgentOriginalDisplay ??= badge.style?.display ?? '';
+        if (badge.style) badge.style.display = 'none';
+      }
+      return () => {
+        if (title?.dataset?.dcAgentOriginalText !== undefined) {
+          title.textContent = title.dataset.dcAgentOriginalText;
+          delete title.dataset.dcAgentOriginalText;
+          delete title.dataset.dcAgentHeroTitle;
+        }
+        if (badge?.dataset?.dcAgentOriginalDisplay !== undefined) {
+          if (badge.style) badge.style.display = badge.dataset.dcAgentOriginalDisplay;
+          delete badge.dataset.dcAgentOriginalDisplay;
+          delete badge.dataset.dcAgentHeroBadge;
+        }
+      };
+    }
+
+    function DataCleaningExperience(props) {
+      const { sessionId, session: ownerSession } = props;
+      const enabled = useCleaningSession(sessionId);
+      const hero = ownerSession?.composerPhase === 'blank';
+      react.useEffect(
+        () => rewriteHeroChrome(sessionId, enabled && hero),
+        [sessionId, enabled, hero, ownerSession?.openState]
+      );
+      if (!enabled) return null;
+      return h('div', {
+        className: `dcAgentExperience${hero ? ' is-home' : ''}`,
+        'data-session-id': sessionId,
+      },
+        CapabilityBar({ sessionId }),
+        hero ? ProductHome() : null,
+      );
+    }
+
+    function extractPromptEntries(result) {
+      const rows = Array.isArray(result?.rows) ? result.rows : [];
+      const headers = Array.isArray(result?.headers) && result.headers.length
+        ? result.headers
+        : rows.length ? Object.keys(rows[0]) : [];
+      const nameField = headers.find((name) => /^(name|company|company_name|企业名称|公司名称)$/i.test(name))
+        ?? headers.find((name) => /企业|公司|名称|name/i.test(name));
+      const creditField = headers.find((name) => /^(credit_no|creditCode|unified_credit_code|统一社会信用代码|信用代码)$/i.test(name))
+        ?? headers.find((name) => /信用.*代码|credit/i.test(name));
+      return rows.map((row) => {
+        const name = nameField ? String(row?.[nameField] ?? '').trim() : '';
+        const credit = creditField ? String(row?.[creditField] ?? '').trim() : '';
+        return [name, credit].filter(Boolean).join(' | ');
+      }).filter(Boolean).slice(0, 50);
+    }
+
+    function PromptGenerator(props) {
+      const { sessionId, inputActions, attachImages } = props;
+      const enabled = useCleaningSession(sessionId);
+      const [open, setOpen] = react.useState(false);
+      const [mode, setMode] = react.useState('text');
+      const [rawText, setRawText] = react.useState('');
+      const [entries, setEntries] = react.useState([]);
+      const [entryCount, setEntryCount] = react.useState(0);
+      const [spreadsheetFileName, setSpreadsheetFileName] = react.useState('');
+      const [imageFileName, setImageFileName] = react.useState('');
+      const [imageAttached, setImageAttached] = react.useState(false);
+      const [cleaningKeys, setCleaningKeys] = react.useState(DEFAULT_CLEANING_KEYS);
+      const [enrichmentKeys, setEnrichmentKeys] = react.useState(DEFAULT_ENRICHMENT_KEYS);
+      const [busy, setBusy] = react.useState(false);
+      const [error, setError] = react.useState(null);
+
+      if (!enabled) return null;
+
+      const setSourceMode = (nextMode) => {
+        setMode(nextMode);
+        setError(null);
+      };
+      const toggle = (setter, values, key) => setter(values.includes(key)
+        ? values.filter((item) => item !== key)
+        : [...values, key]);
+      const handleFile = async (event) => {
+        const file = event.target?.files?.[0];
+        if (!file || busy) return;
+        setBusy(true);
+        setError(null);
+        try {
+          if (mode === 'image') {
+            if (typeof attachImages !== 'function') throw new Error('当前 DSH 没有可用的图片接入 Bridge。');
+            await attachImages(sessionId, [file]);
+            setImageFileName(file.name);
+            setImageAttached(true);
+          } else {
+            const result = await parseFile(file);
+            if (!result || result.ok === false) throw new Error(result?.message || result?.error || '表格解析失败');
+            const extracted = extractPromptEntries(result);
+            if (!extracted.length) throw new Error('未识别到企业名称或统一社会信用代码列，请检查表头。');
+            setEntries(extracted);
+            setEntryCount(Number.isFinite(result.rowCount) ? result.rowCount : (Array.isArray(result.rows) ? result.rows.length : extracted.length));
+            setSpreadsheetFileName(file.name);
+            requestWorkbenchDataset(result, sessionId);
+          }
+        } catch (fileError) {
+          setError(fileError instanceof Error ? fileError.message : String(fileError));
+        } finally {
+          setBusy(false);
+          if (event.target) event.target.value = '';
+        }
+      };
+      const generatePrompt = () => {
+        const manualEntries = rawText.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+        const selectedEntries = mode === 'text' ? manualEntries : entries;
+        if (mode === 'text' && !selectedEntries.length) {
+          setError('请先录入企业名称或统一社会信用代码，每行一条。');
+          return;
+        }
+        if (mode === 'excel' && !selectedEntries.length) {
+          setError('请先上传并解析 Excel / CSV / JSON 文件。');
+          return;
+        }
+        if (mode === 'image' && !imageAttached) {
+          setError('请先选择并附加一张包含企业名单的图片。');
+          return;
+        }
+        if (!inputActions || typeof inputActions.setDraft !== 'function') {
+          setError('当前会话输入机尚未就绪，请稍后重试。');
+          return;
+        }
+        inputActions.setDraft(buildTaskPrompt({
+          mode,
+          entries: selectedEntries,
+          entryCount: mode === 'excel' ? entryCount : selectedEntries.length,
+          fileName: mode === 'image' ? imageFileName : spreadsheetFileName,
+          cleaningKeys,
+          enrichmentKeys,
+        }));
+        setError(null);
+        setOpen(false);
+      };
+
+      const choice = (options, values, setter) => options.map(([key, label]) => h('label', {
+        key,
+        className: `dcAgentPromptChoice${values.includes(key) ? ' is-selected' : ''}`,
+      },
+        h('input', {
+          type: 'checkbox',
+          checked: values.includes(key),
+          onChange: () => toggle(setter, values, key),
+        }),
+        label,
+      ));
+
+      return h('div', { className: 'dcAgentPromptLayer' },
+        h('button', {
+          type: 'button',
+          className: 'dcAgentPromptTrigger',
+          'aria-label': '打开提示词生成',
+          'aria-expanded': open,
+          onClick: () => setOpen(!open),
+        }, '✨ 提示词生成'),
+        open ? h('section', {
+          className: 'dcAgentPromptPanel',
+          role: 'dialog',
+          'aria-modal': 'false',
+          'aria-label': '数据清洗补全任务生成器',
+          onKeyDown: (event) => {
+            if (event.key === 'Escape') {
+              event.preventDefault();
+              setOpen(false);
+            }
+          },
+        },
+          h('div', { className: 'dcAgentPromptHead' },
+            h('div', null,
+              h('h3', null, '生成数据清洗补全任务'),
+              h('p', null, '录入主体、选择清洗动作与补全维度，生成后仍可在对话框中人工修改。'),
+            ),
+            h('button', { type: 'button', className: 'dcAgentPromptClose', 'aria-label': '关闭提示词生成', onClick: () => setOpen(false) }, '✕'),
+          ),
+          h('div', { className: 'dcAgentPromptTabs', role: 'tablist', 'aria-label': '名单录入方式' },
+            [['text', '粘贴名单'], ['excel', '上传 Excel'], ['image', '上传图片']].map(([key, label]) => h('button', {
+              key,
+              type: 'button',
+              role: 'tab',
+              'aria-selected': mode === key,
+              className: `dcAgentPromptTab${mode === key ? ' is-active' : ''}`,
+              onClick: () => setSourceMode(key),
+            }, label)),
+          ),
+          mode === 'text' ? h('label', { className: 'dcAgentPromptField' },
+            h('span', null, '企业名称或统一社会信用代码（每行一条）'),
+            h('textarea', {
+              className: 'dcAgentPromptText',
+              value: rawText,
+              placeholder: '企查查科技股份有限公司\n9132…\n某某信息技术（上海）有限公司',
+              onChange: (event) => setRawText(event.target.value),
+            }),
+          ) : h('label', { className: 'dcAgentPromptFile' },
+            h('span', null, mode === 'image' ? '选择企业名单图片' : '选择 Excel / CSV / JSON 名单'),
+            h('input', {
+              type: 'file',
+              accept: mode === 'image' ? 'image/png,image/jpeg,image/webp' : '.xlsx,.xls,.csv,.json',
+              disabled: busy,
+              onChange: handleFile,
+            }),
+            (mode === 'excel' ? spreadsheetFileName : imageFileName)
+              ? h('b', null, `${mode === 'excel' ? spreadsheetFileName : imageFileName}${mode === 'excel' ? ` · ${entryCount} 条` : ' · 已附加'}`)
+              : null,
+          ),
+          h('div', { className: 'dcAgentPromptGroup' },
+            h('b', null, '需要执行哪些清洗？'),
+            h('div', { className: 'dcAgentPromptChoices' }, choice(CLEANING_OPTIONS, cleaningKeys, setCleaningKeys)),
+          ),
+          h('div', { className: 'dcAgentPromptGroup' },
+            h('b', null, '需要补全哪些字段 / 维度？'),
+            h('div', { className: 'dcAgentPromptChoices' }, choice(ENRICHMENT_OPTIONS, enrichmentKeys, setEnrichmentKeys)),
+          ),
+          h('p', { className: 'dcAgentPromptNote' }, '图片模式只负责把图片附加到当前对话，并生成“优先调用已连接的企查查智能文档解析 MCP”的任务要求；插件不会虚构或硬编码未验证的工具名。企查查调用使用当前客户自己的连接、账号与额度。'),
+          error ? h('p', { className: 'dcAgentPromptError', role: 'alert' }, error) : null,
+          h('div', { className: 'dcAgentPromptActions' },
+            h('button', { type: 'button', className: 'dcAgentPromptAction', onClick: () => setOpen(false) }, '取消'),
+            h('button', { type: 'button', className: 'dcAgentPromptAction is-primary', disabled: busy, onClick: generatePrompt }, busy ? '处理中…' : '生成并回填'),
+          ),
+        ) : null,
+      );
+    }
+
     /** 会话头部的可恢复入口：关闭右栏后仍可从当前会话再次打开。 */
     function WorkbenchHeaderEntry(props) {
       const { sessionId } = props;
+      const enabled = useCleaningSession(sessionId);
+      if (!enabled) return null;
       return h('button', {
         type: 'button',
         className: 'dcAgentHeaderAction',
-        'aria-label': '打开数据清洗工作台',
-        title: '打开数据清洗工作台',
+        'aria-label': '打开数据清洗补全工作台',
+        title: '打开数据清洗补全工作台',
         onClick: () => requestWorkbenchOpen(null, sessionId),
       },
         typeof IconDataOutline16 === 'function'
           ? h(IconDataOutline16, { size: 16, 'aria-hidden': 'true' })
           : h('span', { 'aria-hidden': 'true' }, '▦'),
-        h('span', null, '清洗工作台'),
+        h('span', null, '清洗补全工作台'),
       );
     }
 
@@ -901,12 +1531,20 @@ window.__ModuleLoader__.load({
           const detail = event?.detail ?? {};
           openWorkbench(actions, detail.step ?? null, detail.sessionId ?? null);
         };
+        const handleDataset = (event) => {
+          event?.preventDefault?.();
+          const detail = event?.detail ?? {};
+          if (detail.result) applyParsed(detail.result, actions);
+          if (detail.sessionId) actions.setActiveSession(detail.sessionId);
+        };
         if (typeof document !== 'undefined' && typeof document.addEventListener === 'function') {
           document.addEventListener(WORKBENCH_OPEN_EVENT, handleOpen);
+          document.addEventListener(WORKBENCH_DATASET_EVENT, handleDataset);
         }
         return () => {
           if (typeof document !== 'undefined' && typeof document.removeEventListener === 'function') {
             document.removeEventListener(WORKBENCH_OPEN_EVENT, handleOpen);
+            document.removeEventListener(WORKBENCH_DATASET_EVENT, handleDataset);
           }
           stopJobsPolling();
           if (rootWorkbenchActions === actions) rootWorkbenchActions = null;
@@ -1415,7 +2053,7 @@ window.__ModuleLoader__.load({
           className: `dcAgentWorkbench${expanded ? ' is-expanded' : ''}`,
           role: 'dialog',
           'aria-modal': 'false',
-          'aria-label': '数据清洗工作台',
+          'aria-label': '数据清洗补全工作台',
           'data-session-id': activeSessionId ?? undefined,
           onKeyDown: (event) => {
             if (event.key === 'Escape') {
@@ -1479,7 +2117,9 @@ window.__ModuleLoader__.load({
         applied: true,
         entry: 'sidebar.workspaces:before(portal)',
         lifecycleSlot: 'sidebar.footer.action',
-        capabilitySlot: 'conversation.input.left',
+        capabilitySlot: 'conversation.input.dock',
+        promptSlot: 'conversation.input.overlay',
+        heroTitleBridge: 'exact-text/reversible',
         headerSlot: 'conversation.session.header.actions',
         overlay: 'shell.overlay',
         error: null,
@@ -1506,12 +2146,20 @@ window.__ModuleLoader__.load({
           inject: () => ({ startSession: () => startCleaningSession(ctx) }),
         }, SidebarEntry));
 
-        // 原生会话输入框工具行：对齐 Mockup 的五个能力 ICON，不创建第二套聊天 UI。
-        ctx.slots.inject('conversation.input.left', () => ctx.slots.register({
-          name: 'conversation.input.left',
+        // 独立 dock 行：对齐 Mockup 的五个能力 ICON，CSS 只把本 cell 排到输入框下方。
+        ctx.slots.inject('conversation.input.dock', () => ctx.slots.register({
+          name: 'conversation.input.dock',
           id: 'data-cleaning-agent-capabilities',
           order: 110,
-        }, CapabilityBar));
+        }, DataCleaningExperience));
+
+        // 输入框左上角提示词生成器：文本 / Excel / 图片 → 可编辑任务描述。
+        ctx.slots.inject('conversation.input.overlay', () => ctx.slots.register({
+          name: 'conversation.input.overlay',
+          id: 'data-cleaning-agent-prompt-generator',
+          order: 110,
+          inject: () => ({ attachImages: (sessionId, files) => attachPromptImages(ctx, sessionId, files) }),
+        }, PromptGenerator));
 
         // 会话头部恢复入口：用户关闭右栏后可随时重新打开当前任务工作台。
         ctx.slots.inject('conversation.session.header.actions', () => ctx.slots.register({
@@ -1541,6 +2189,8 @@ window.__ModuleLoader__.load({
 
     exports.apply = apply;
     exports.inject = inject;
+    // 测试用纯函数，不构成 Host / DSH 稳定 API。
+    exports.__testing = { buildTaskPrompt, extractPromptEntries, markCleaningSession };
     return module.exports;
   },
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-data-cleaning-agent",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "Clean, complete, and profile enterprise name lists in DeepSeek Harness — a data cleaning & completion agent plugin with local CSV/XLSX/JSON engine and optional Qichacha (QCC) MCP enrichment. Maintained by Qichacha/QCC.",
   "type": "module",
   "main": "lib/index.js",
@@ -30,6 +30,7 @@
     "docs/RELEASE-0.5.0.md",
     "docs/RELEASE-0.5.1.md",
     "docs/RELEASE-0.5.2.md",
+    "docs/RELEASE-0.5.3.md",
     "docs/G5-HOST-BRIDGE.md",
     "docs/G5-E2E-RUNBOOK.md"
   ],