dsh-data-cleaning-agent 0.5.1 → 0.5.2

package/CHANGELOG.md

@@ -4,6 +4,26 @@
 
 ## [Unreleased]
 
+## [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.2** (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)
@@ -40,10 +40,10 @@ 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" 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.
 
 Without the `dsh` CLI, use the install script:
 
@@ -65,7 +65,7 @@ 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 sidebar entry + five native composer actions | keeps the DSH conversation in the center and opens the Mockup-aligned workbench on the right |
 | 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 +106,7 @@ 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 [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.2**（正式版本）
 
 [![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)
@@ -35,8 +35,9 @@ dsh plugin --profile web add dsh-data-cleaning-agent
 安装后**完全重启** DeepSeek Harness（停止后重新运行 `dsh web`）。
 之后在对话中说「帮我清洗这批企业名单数据」，插件会自动加载内嵌 Skill 并调度清洗/补全/画像工具。
 
-重启后侧边栏底部会出现「数据清洗」入口：点击打开工作台（上传与映射 → 数据体检 → 匹配核验 → 补全与导出四步），
-模型调用清洗/补全/画像工具时对话内会渲染对应工具卡片，工作台头部用任务 pill 展示排队/进行中的任务。
+重启后，「数据清洗」入口会显示在侧边栏顶部的「新会话」与「工作区」之间。点击后打开 DSH 原生会话，
+输入框工具行提供上传清洗、质量体检、匹配核验、字段补全和任务历史五个入口；右侧工作台承载
+上传与映射 → 数据体检 → 匹配核验 → 补全与导出四步。模型调用工具时，对话内会渲染对应工具卡片。
 
 没有 `dsh` CLI 时，也可以用安装脚本：
 
@@ -58,7 +59,7 @@ 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 对齐工作台：上传与映射 → 数据体检 → 匹配核验 → 补全与导出 |
+| 应用内入口 | 侧栏顶部「数据清洗」+ 原生输入框五能力按钮 | 中央保留 DSH 原生对话，右侧打开 Mockup 对齐工作台 |
 | 工具卡片 | `tool.call.toolview`（`data_clean_rows`/`data_complete_rows`/`data_profile`） | 对话内渲染清洗/补全/画像结果卡，含运行/已完成/失败状态 |
 | 任务进度 | 工作台头部任务 pill | 轮询 `/data-cleaning/api/mvp/jobs`，展示排队/运行中任务 |
 | Skill | `data-cleaning` | 引导模型按工作流调度上述工具 |
@@ -102,6 +103,7 @@ 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)。
 
 ## 本地开发
 

package/docs/COMPATIBILITY.md

@@ -18,9 +18,14 @@
 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 工具契约或计费安全门。
+
 ## 2. Node 运行时
 
 - 本包 `engines.node` 声明 `>=20`。
@@ -73,7 +78,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 +89,12 @@ 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 降级按钮。
+
 ### 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,43 @@
+# 0.5.2 DSH 原生 UI 对齐发布记录
+
+> 版本：**0.5.2**
+>
+> 状态：**正式版本；由 `v0.5.2` 标签触发 npm OIDC Trusted Publishing 与 GitHub Release。**
+>
+> 发布日期：2026-09-03
+
+## 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。
+
+## 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/lib/client.js

@@ -3,11 +3,13 @@
  *
  * 通过 `window.__ModuleLoader__.load({id, factory})` 注册为惰性 CJS 工厂，
  * 与 dsh-mcp-connector@0.2.32（生产 profile 中已实测的「MCP连接器」）同构：
- *   - `react` / `@deepseek-ai/dsh-client-ui-primitives` 由 web shell 静态模块表提供，
+ *   - `react` / `react-dom` / `@deepseek-ai/dsh-client-ui-primitives` 由 web shell 静态模块表提供，
  *     第三方 bundle 无需打包 React、无需构建步骤。
  *   - `defineStore` 首选 `@deepseek-ai/dsh-client-store`，回退 `@deepseek-ai/dsh-client-runtime/client`。
- *   - 入口注册到 `sidebar.footer.action`（order 10，排在 MCP连接器的 order 0 下方），
- *     工作台注册到 `shell.overlay`（order 200）。
+ *   - `sidebar.footer.action` 仅托管入口生命周期和降级渲染；实际入口 Portal 到
+ *     `sidebar.workspaces` 前，位于「新会话」与「工作区」之间。
+ *   - DSH 原生会话保持在中间，能力入口使用 `conversation.input.left`，右侧非模态
+ *     工作台使用 `shell.overlay`，会话头使用 `conversation.session.header.actions`。
  *
  * 0.5.0 工作台复用本地 `/mvp/*` 与三域 `/phase3/*` 后端，完整覆盖上传映射、
  * 数据体检、匹配核验、补全导出；计费调用仍由 Host Bridge 的确认/幂等/上限门约束。
@@ -20,7 +22,19 @@ window.__ModuleLoader__.load({
     Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
     const react = require('react');
-    const { Button } = require('@deepseek-ai/dsh-client-ui-primitives');
+    const reactDom = require('react-dom');
+    const primitives = require('@deepseek-ai/dsh-client-ui-primitives');
+    const {
+      Button,
+      IconArchiveOutline20,
+      IconChecklistOutline14,
+      IconCloseOutline16,
+      IconDataOutline16,
+      IconDownloadOutline16,
+      IconFullscreenOutline16,
+      IconPaperclipOutline16,
+      IconSearchOutline16,
+    } = primitives;
 
     let defineStore;
     try {
@@ -41,20 +55,45 @@ window.__ModuleLoader__.load({
     /** 客户端所需服务：与 mcp-connector 对齐（槽位 + 会话/工作区/输入机）。 */
     const inject = ['slots', 'sessions', 'workspaces', 'conversation'];
 
-    const FOOTER_STYLE_ID = 'dsh-data-cleaning-agent-sidebar';
+    const UI_STYLE_ID = 'dsh-data-cleaning-agent-ui';
+    const SIDEBAR_WORKSPACES_SELECTOR = '[data-slot="sidebar.workspaces"]';
+    const TOP_MOUNT_SELECTOR = '[data-data-cleaning-top-mount="true"]';
     const stylesCss = `
-[data-slot="sidebar.footer.action"] {
-  display: flex !important;
-  flex-direction: column;
+.dcAgentTopMount {
+  flex: none;
   min-width: 0;
   width: 100%;
 }
 
+.dcAgentTopEntry {
+  box-sizing: border-box;
+  width: 100%;
+  padding-right: var(--dsh-sidebar-inline-padding, 12px);
+}
+
 .dcAgentLauncher {
   flex: none;
   box-sizing: border-box;
   width: 100%;
+  height: 42px;
+  margin: 0 0 8px;
+  padding: 0 10px 0 8px;
+  justify-content: flex-start;
   min-width: 0;
+  overflow: hidden;
+  border-radius: 12px;
+  white-space: nowrap;
+}
+.dcAgentLauncher[data-wide="false"] {
+  width: 36px;
+  height: 36px;
+  padding: 0;
+  justify-content: center;
+  border-radius: 50%;
+}
+.dcAgentTopEntry[data-wide="false"] {
+  width: 36px;
+  padding-right: 0;
 }
 
 .dcAgentOverlay {
@@ -64,22 +103,79 @@ window.__ModuleLoader__.load({
   display: flex;
   align-items: stretch;
   justify-content: flex-end;
-  background: rgba(8, 10, 14, 0.22);
+  pointer-events: none;
+  background: transparent;
 }
 
 .dcAgentWorkbench {
   display: flex;
   flex-direction: column;
-  width: min(980px, calc(100vw - 72px));
+  width: min(510px, calc(100vw - 72px));
   height: 100vh;
   border: 1px solid light-dark(#d5dae4, #2a3038);
-  border-radius: 14px 0 0 14px;
+  border-radius: 12px 0 0 12px;
   background: light-dark(#ffffff, #161b23);
   color: light-dark(#172033, #edf2fa);
-  box-shadow: light-dark(0 18px 50px rgba(33, 55, 88, .14), 0 20px 60px rgba(0, 0, 0, .42));
+  box-shadow: light-dark(-10px 0 32px rgba(33, 55, 88, .12), -12px 0 40px rgba(0, 0, 0, .32));
   overflow: hidden;
+  pointer-events: auto;
+}
+.dcAgentWorkbench.is-expanded { width: min(980px, calc(100vw - 72px)); }
+
+.dcAgentCapabilities {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  max-width: min(56vw, 560px);
+  overflow-x: auto;
+  scrollbar-width: none;
+  transform: translateX(var(--dc-agent-workbench-shift, 0px));
+  transition: transform 160ms ease;
+}
+.dcAgentCapabilities::-webkit-scrollbar { display: none; }
+.dcAgentCapability {
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  flex: 0 0 auto;
+  min-height: 30px;
+  padding: 4px 8px;
+  border: 1px solid transparent;
+  border-radius: 8px;
+  background: transparent;
+  color: light-dark(#5d687a, #aab5c7);
+  font: inherit;
+  font-size: 12px;
+  cursor: pointer;
+}
+.dcAgentCapability:hover,
+.dcAgentCapability:focus-visible,
+.dcAgentCapability.is-active {
+  border-color: light-dark(#c9d9f8, #365681);
+  background: light-dark(#edf4ff, #172841);
+  color: light-dark(#1556cf, #8cb3ff);
+}
+.dcAgentCapability svg { flex: 0 0 auto; }
+
+.dcAgentHeaderAction {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  min-height: 30px;
+  padding: 4px 9px;
+  border: 1px solid light-dark(#d9dee8, #394352);
+  border-radius: 8px;
+  background: light-dark(#ffffff, #191f28);
+  color: inherit;
+  font: inherit;
+  font-size: 12px;
+  cursor: pointer;
+}
+.dcAgentHeaderAction:hover,
+.dcAgentHeaderAction:focus-visible {
+  border-color: light-dark(#2869e6, #6d9eff);
+  color: light-dark(#1556cf, #8cb3ff);
 }
-.dcAgentWorkbench.is-expanded { width: calc(100vw - 72px); }
 
 .dcAgentWbHeader {
   display: flex;
@@ -365,17 +461,19 @@ window.__ModuleLoader__.load({
 }
 @media (max-width: 760px) {
   .dcAgentWorkbench, .dcAgentWorkbench.is-expanded { width: 100vw; border-radius: 0; }
+  .dcAgentOverlay { background: rgba(8, 10, 14, 0.22); pointer-events: auto; }
   .dcAgentStepper { grid-template-columns: repeat(2, minmax(0, 1fr)); }
   .dcAgentQccBadge { display: none; }
   .dcAgentCandidate { grid-template-columns: 1fr; }
+  .dcAgentCapabilityLabel { display: none; }
 }
 `;
 
-    /** 让 footer 多个入口纵向堆叠（与 mcp-connector 注入的列式 CSS 幂等并存）。 */
-    function installSidebarStyles() {
-      if (document.querySelector(`style[data-plugin="${FOOTER_STYLE_ID}"]`) !== null) return () => {};
+    /** 安装入口、会话能力按钮与右侧工作台样式。 */
+    function installUiStyles() {
+      if (document.querySelector(`style[data-plugin="${UI_STYLE_ID}"]`) !== null) return () => {};
       const style = document.createElement('style');
-      style.dataset.plugin = FOOTER_STYLE_ID;
+      style.dataset.plugin = UI_STYLE_ID;
       style.textContent = stylesCss;
       document.head.append(style);
       return () => { style.remove(); };
@@ -392,6 +490,16 @@ window.__ModuleLoader__.load({
       { key: 'enrich', label: '补全与导出', icon: '⬇️' },
     ];
 
+    const CAPABILITIES = [
+      { key: 'upload', label: '上传清洗', icon: IconPaperclipOutline16, fallback: '＋' },
+      { key: 'profile', label: '质量体检', icon: IconChecklistOutline14, fallback: '✓' },
+      { key: 'review', label: '匹配核验', icon: IconSearchOutline16, fallback: '⌕' },
+      { key: 'enrich', label: '字段补全', icon: IconDataOutline16, fallback: '▦' },
+      { key: 'history', label: '任务历史', icon: IconArchiveOutline20, fallback: '◷' },
+    ];
+
+    const DEFAULT_SESSION_PROMPT = '请帮我清洗并补全企业名单。我会在右侧数据清洗工作台上传文件或粘贴数据。';
+
     /** 后端往返：POST JSON，返回解析后的对象。 */
     async function api(path, body) {
       const res = await fetch(path, {
@@ -422,13 +530,20 @@ window.__ModuleLoader__.load({
           qccEstimate: null,
           qccRun: null,
           paidConfirmed: false,
+          activeSessionId: null,
           jobs: [],        // 后台任务列表（/mvp/jobs 轮询），仅用于状态 pill，不接计费遥测
         }),
         actions: {
           open: (draft) => { draft.open = true; },
+          openAt: (draft, step, sessionId) => {
+            draft.open = true;
+            if (step) draft.step = step;
+            if (sessionId) draft.activeSessionId = sessionId;
+          },
           close: (draft) => { draft.open = false; },
           toggleExpanded: (draft) => { draft.expanded = !draft.expanded; },
           setStep: (draft, step) => { draft.step = step; },
+          setActiveSession: (draft, sessionId) => { draft.activeSessionId = sessionId ?? null; },
           setBusy: (draft, busy) => { draft.busy = busy; },
           setError: (draft, error) => { draft.error = error; },
           setInput: (draft, input) => { draft.input = input; },
@@ -453,27 +568,178 @@ window.__ModuleLoader__.load({
       });
     }
 
-    /** 左栏入口按钮：使用 DSH Button，与 MCP连接器一致。 */
+    /**
+     * DSH 当前没有公开的「新会话与工作区之间」list slot。和 MCP连接器一样，
+     * footer slot 只托管生命周期；真实入口只依赖稳定 data-slot Portal 到工作区前。
+     */
+    function ensureTopLauncherMount() {
+      const workspaceSlot = document.querySelector(SIDEBAR_WORKSPACES_SELECTOR);
+      const parent = workspaceSlot && workspaceSlot.parentElement;
+      if (!workspaceSlot || !parent) return null;
+      let mount = parent.querySelector(TOP_MOUNT_SELECTOR);
+      if (!mount) {
+        mount = document.createElement('div');
+        mount.dataset.dataCleaningTopMount = 'true';
+        mount.className = 'dcAgentTopMount';
+      }
+      // 不与 MCP连接器各自的 MutationObserver 争抢「紧邻工作区」位置：首次挂载后
+      // 保持稳定顺序。MCP连接器会占据紧邻工作区的位置，本入口自然位于它上方。
+      if (mount.parentElement !== parent) parent.insertBefore(mount, workspaceSlot);
+      return mount;
+    }
+
+    /** 使用 DSH 原生工作区、会话和输入机打开中央对话，不构造第二套聊天界面。 */
+    async function startCleaningSession(ctx) {
+      const workspace = ctx.workspaces.list.getSnapshot();
+      const current = ctx.sessions.list.getSnapshot().current;
+      const items = Array.isArray(workspace.items) ? workspace.items : [];
+      const currentWorkspaceId = current === undefined
+        ? undefined
+        : 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('请先选择一个工作空间，再打开数据清洗智能体');
+      }
+      // rc.2 暴露 workspaces.connectWorkspace；alpha.2 把同一导航策略迁移到
+      // uiWorkspace.connectWorkspace，纯 workspaces controller 不再带该方法。
+      // 只在检测到真实方法后调用，避免把 alpha 实验面当成稳定契约。
+      const uiWorkspace = typeof ctx.get === 'function' ? ctx.get('uiWorkspace') : ctx.uiWorkspace;
+      const connectWorkspace = typeof ctx.workspaces.connectWorkspace === 'function'
+        ? ctx.workspaces.connectWorkspace.bind(ctx.workspaces)
+        : typeof uiWorkspace?.connectWorkspace === 'function'
+          ? uiWorkspace.connectWorkspace.bind(uiWorkspace)
+          : null;
+      const sessionId = connectWorkspace
+        ? await connectWorkspace(targetWorkspaceId)
+        : typeof ctx.sessions.create === 'function'
+          ? await ctx.sessions.create({ workspaceId: targetWorkspaceId })
+          : null;
+      if (!sessionId) throw new Error('当前 DSH 版本没有可用的工作区会话创建能力');
+      const conversation = typeof ctx.get === 'function' ? ctx.get('conversation') : ctx.conversation;
+      if (!conversation) throw new Error('DSH 对话服务尚未就绪，请稍后重试');
+      conversation.input.shell(sessionId).setDraft(DEFAULT_SESSION_PROMPT);
+      ctx.sessions.open(sessionId);
+      return sessionId;
+    }
+
+    function capabilityIcon(item, size = 16) {
+      return typeof item.icon === 'function'
+        ? h(item.icon, { size, 'aria-hidden': 'true' })
+        : h('span', { 'aria-hidden': 'true' }, item.fallback);
+    }
+
+    function openWorkbench(actions, step, sessionId) {
+      actions.openAt(step, sessionId);
+      startJobsPolling(actions);
+    }
+
+    const WORKBENCH_OPEN_EVENT = 'dsh:data-cleaning-workbench-open';
+
+    // session scope 不能复用 root scope 的 store handle。DSH 当前会分别物化 root/session
+    // 插槽组件，因此以 document 事件跨 scope 通知；闭包引用仅作为无 DOM 测试降级。
+    let rootWorkbenchActions = null;
+
+    /** 从 session scope 的 composer/header 触发 root scope 工作台。 */
+    function requestWorkbenchOpen(step, sessionId) {
+      if (typeof document !== 'undefined'
+        && typeof document.createEvent === 'function'
+        && typeof document.dispatchEvent === 'function') {
+        const event = document.createEvent('CustomEvent');
+        event.initCustomEvent(WORKBENCH_OPEN_EVENT, false, true, { step, sessionId });
+        if (!document.dispatchEvent(event)) return;
+      }
+      if (rootWorkbenchActions) openWorkbench(rootWorkbenchActions, step, sessionId);
+    }
+
+    /** 左栏入口按钮：公开 footer 托管，真实按钮 Portal 到「新会话 / 工作区」之间。 */
     function SidebarEntry(props) {
-      const { wide, useStore, actions } = props;
+      const { wide, useStore, actions, startSession } = props;
       const open = useStore((state) => state.open);
-      return react.createElement(Button, {
+      const [topMount, setTopMount] = react.useState(null);
+
+      react.useEffect(() => {
+        let disposed = false;
+        const ownedMounts = new Set();
+        const syncMount = () => {
+          if (disposed) return;
+          const mount = ensureTopLauncherMount();
+          if (mount) ownedMounts.add(mount);
+          setTopMount((current) => current === mount ? current : mount);
+        };
+        syncMount();
+        let observer = null;
+        if (typeof window.MutationObserver === 'function' && document.body) {
+          observer = new window.MutationObserver(syncMount);
+          observer.observe(document.body, { childList: true, subtree: true });
+        }
+        return () => {
+          disposed = true;
+          if (observer) observer.disconnect();
+          for (const mount of ownedMounts) mount.remove();
+        };
+      }, []);
+
+      const launcher = react.createElement(Button, {
         variant: 'ghost',
         className: 'dcAgentLauncher',
         'data-wide': wide,
         'aria-label': '数据清洗',
         'aria-haspopup': 'dialog',
         'aria-expanded': open,
-        onClick: () => {
+        onClick: async () => {
           try {
-            actions.open();
-            startJobsPolling(actions);
+            openWorkbench(actions, 'upload');
+            if (typeof startSession === 'function') {
+              const sessionId = await startSession();
+              actions.setActiveSession(sessionId);
+            }
           } catch (error) {
+            actions.setError(error instanceof Error ? error.message : String(error));
             console.error('[dc-agent] open failed:', error);
           }
         },
         children: wide ? '🧹 数据清洗' : '🧹',
       });
+      if (!topMount || typeof reactDom.createPortal !== 'function') return launcher;
+      return reactDom.createPortal(h('div', {
+        className: 'dcAgentTopEntry',
+        'data-wide': wide,
+      }, launcher), topMount);
+    }
+
+    /** Mockup 五能力入口：位于原生 composer 的交互工具行。 */
+    function CapabilityBar(props) {
+      const { sessionId } = props;
+      return h('div', { className: 'dcAgentCapabilities', 'aria-label': '数据清洗智能体能力' },
+        CAPABILITIES.map((item) => h('button', {
+          key: item.key,
+          type: 'button',
+          className: 'dcAgentCapability',
+          'aria-label': item.label,
+          title: item.label,
+          onClick: () => requestWorkbenchOpen(item.key, sessionId),
+        },
+          capabilityIcon(item),
+          h('span', { className: 'dcAgentCapabilityLabel' }, item.label),
+        )),
+      );
+    }
+
+    /** 会话头部的可恢复入口：关闭右栏后仍可从当前会话再次打开。 */
+    function WorkbenchHeaderEntry(props) {
+      const { sessionId } = props;
+      return h('button', {
+        type: 'button',
+        className: 'dcAgentHeaderAction',
+        '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, '清洗工作台'),
+      );
     }
 
     /** M3 · 三工具 tool.call.toolview 卡片元数据（wire 名 → 展示文案）。 */
@@ -606,8 +872,8 @@ window.__ModuleLoader__.load({
       });
     }
 
-    /** 工作台主视图：header + stepper + 当前 pane。 */
-    function WorkbenchOverlay(props) {
+    /** 右侧非模态工作台：中央区域始终保留 DSH 原生会话。 */
+    function WorkbenchDrawer(props) {
       const { useStore, actions } = props;
       const open = useStore((state) => state.open);
       const step = useStore((state) => state.step);
@@ -626,6 +892,65 @@ window.__ModuleLoader__.load({
       const qccRun = useStore((state) => state.qccRun);
       const paidConfirmed = useStore((state) => state.paidConfirmed);
       const jobs = useStore((state) => state.jobs);
+      const activeSessionId = useStore((state) => state.activeSessionId);
+
+      react.useEffect(() => {
+        rootWorkbenchActions = actions;
+        const handleOpen = (event) => {
+          event?.preventDefault?.();
+          const detail = event?.detail ?? {};
+          openWorkbench(actions, detail.step ?? null, detail.sessionId ?? null);
+        };
+        if (typeof document !== 'undefined' && typeof document.addEventListener === 'function') {
+          document.addEventListener(WORKBENCH_OPEN_EVENT, handleOpen);
+        }
+        return () => {
+          if (typeof document !== 'undefined' && typeof document.removeEventListener === 'function') {
+            document.removeEventListener(WORKBENCH_OPEN_EVENT, handleOpen);
+          }
+          stopJobsPolling();
+          if (rootWorkbenchActions === actions) rootWorkbenchActions = null;
+        };
+      }, [actions]);
+
+      // 非模态右栏会覆盖 Host 的中央画布；按实际重叠量把 composer 能力栏左移，
+      // 保证 Mockup 中的五个入口在窄桌面视口仍可见、可点击。展开态专注工作台，
+      // 不强行挤压到不足一栏的剩余区域。
+      react.useEffect(() => {
+        if (typeof document === 'undefined' || typeof document.querySelectorAll !== 'function') return undefined;
+        const reset = () => {
+          for (const bar of document.querySelectorAll('.dcAgentCapabilities')) {
+            bar.style?.removeProperty('--dc-agent-workbench-shift');
+          }
+        };
+        if (!open || expanded) {
+          reset();
+          return reset;
+        }
+        const align = () => {
+          const drawer = document.querySelector('.dcAgentWorkbench');
+          if (!drawer) return;
+          const drawerRect = drawer.getBoundingClientRect();
+          for (const bar of document.querySelectorAll('.dcAgentCapabilities')) {
+            const barRect = bar.getBoundingClientRect();
+            const overlap = Math.max(0, barRect.right - drawerRect.left + 8);
+            const leftRoom = Math.max(0, barRect.left - 88);
+            const shift = Math.min(overlap, leftRoom);
+            bar.style?.setProperty('--dc-agent-workbench-shift', `${-shift}px`);
+          }
+        };
+        const view = document.defaultView;
+        const frameId = typeof view?.requestAnimationFrame === 'function'
+          ? view.requestAnimationFrame(align)
+          : null;
+        view?.addEventListener?.('resize', align);
+        align();
+        return () => {
+          if (frameId !== null) view?.cancelAnimationFrame?.(frameId);
+          view?.removeEventListener?.('resize', align);
+          reset();
+        };
+      }, [open, expanded]);
 
       // DSH 的 useStore 基于 React hooks；所有订阅必须在每次渲染时以相同顺序调用。
       // 把关闭态 guard 放在全部 useStore 之后，避免首次关闭、随后打开时触发
@@ -885,7 +1210,37 @@ window.__ModuleLoader__.load({
       );
 
       let pane;
-      if (step === 'profile') {
+      if (step === 'history') {
+        pane = h('div', { className: 'dcAgentPane' },
+          h('p', { className: 'dcAgentHint' }, '查看当前 Host 的数据清洗后台任务。任务数据仅在本机保存，不进入模型上下文。'),
+          h('div', { className: 'dcAgentRow' },
+            h('button', {
+              type: 'button',
+              className: 'dcAgentButton',
+              disabled: busy,
+              'aria-label': '刷新任务历史',
+              onClick: () => pollJobsOnce(actions),
+            }, '刷新任务'),
+            h('button', {
+              type: 'button',
+              className: 'dcAgentButton is-primary',
+              onClick: () => actions.setStep('upload'),
+            }, '新建清洗任务'),
+          ),
+          jobs.length ? h('div', { className: 'dcAgentPane', 'aria-label': '任务历史列表' },
+            jobs.map((job) => h('section', { key: job.id, className: 'dcAgentSection' },
+              h('h3', null, job.name || job.id || '数据清洗任务'),
+              h('div', { className: 'dcAgentRow' },
+                h('span', { className: 'dcAgentJobsPill', 'data-state': job.state ?? 'idle' }, JOB_STATE_LABEL[job.state] ?? job.state ?? '未知'),
+                h('span', { className: 'dcAgentHint' }, job.createdAt ? new Date(job.createdAt).toLocaleString() : ''),
+              ),
+            )),
+          ) : h('section', { className: 'dcAgentSection' },
+            h('h3', null, '暂无后台任务'),
+            h('p', { className: 'dcAgentHint' }, '上传企业名单并开始处理后，任务状态会显示在这里。'),
+          ),
+        );
+      } else if (step === 'profile') {
         pane = h('div', { className: 'dcAgentPane' },
           h('p', { className: 'dcAgentHint' }, '基于已解析数据生成本地质量画像（缺失率、去重值、金额分布）。本步骤不发起企查查调用。'),
           profile ? h('div', null,
@@ -1048,20 +1403,34 @@ window.__ModuleLoader__.load({
 
       return h('div', {
         className: 'dcAgentOverlay',
-        role: 'dialog',
-        'aria-modal': 'true',
-        'aria-label': '数据清洗',
+        'data-dsh-plugin': 'data-cleaning-agent',
         onClick: (event) => {
-          if (event.target === event.currentTarget) actions.close();
+          if (event.target === event.currentTarget) {
+            stopJobsPolling();
+            actions.close();
+          }
         },
       },
-        h('div', { className: `dcAgentWorkbench${expanded ? ' is-expanded' : ''}` },
+        h('aside', {
+          className: `dcAgentWorkbench${expanded ? ' is-expanded' : ''}`,
+          role: 'dialog',
+          'aria-modal': 'false',
+          'aria-label': '数据清洗工作台',
+          'data-session-id': activeSessionId ?? undefined,
+          onKeyDown: (event) => {
+            if (event.key === 'Escape') {
+              event.preventDefault();
+              stopJobsPolling();
+              actions.close();
+            }
+          },
+        },
           h('header', { className: 'dcAgentWbHeader' },
             h('div', { className: 'dcAgentWbTitle' },
               h('span', { className: 'dcAgentWbIcon', 'aria-hidden': 'true' }, '🧹'),
               h('div', null,
                 h('b', null, '数据清洗补全'),
-                h('small', null, '本地确定性清洗 · 企查查三域 Host Bridge'),
+                h('small', null, '本地确定性清洗 · 可选企查查 MCP 补全'),
               ),
             ),
             h('span', {
@@ -1106,28 +1475,51 @@ window.__ModuleLoader__.load({
     function apply(ctx) {
       // eslint-disable-next-line no-console
       console.log('[dc-agent] client apply() ran');
-      const state = { applied: true, entry: 'sidebar.footer.action', overlay: 'shell.overlay', error: null };
+      const state = {
+        applied: true,
+        entry: 'sidebar.workspaces:before(portal)',
+        lifecycleSlot: 'sidebar.footer.action',
+        capabilitySlot: 'conversation.input.left',
+        headerSlot: 'conversation.session.header.actions',
+        overlay: 'shell.overlay',
+        error: null,
+      };
       window.__DC_MVP__ = state;
       try {
         const workbenchStore = createWorkbenchStore();
-        ctx.effect(() => installSidebarStyles(), 'data-cleaning-agent: sidebar styles');
+        ctx.effect(() => installUiStyles(), 'data-cleaning-agent: UI styles');
 
-        // 工作台：注册到 shell.overlay（与 mcp-connector 同源）。
+        // 右侧工作台：additive overlay，不替换 DSH 单占位 details 面板。
         ctx.slots.inject('shell.overlay', () => ctx.slots.register({
           name: 'shell.overlay',
           id: 'data-cleaning-agent',
           order: 200,
           store: workbenchStore,
-        }, WorkbenchOverlay));
+        }, WorkbenchDrawer));
 
-        // 左栏：注册到 sidebar.footer.action，order 10 → 排在 MCP连接器（order 0）下方。
+        // 左栏：footer 只托管生命周期和 Portal 降级；实际入口显示在工作区列表前。
         ctx.slots.inject('sidebar.footer.action', () => ctx.slots.register({
           name: 'sidebar.footer.action',
           id: 'data-cleaning-agent',
           order: 10,
           store: workbenchStore,
+          inject: () => ({ startSession: () => startCleaningSession(ctx) }),
         }, SidebarEntry));
 
+        // 原生会话输入框工具行：对齐 Mockup 的五个能力 ICON，不创建第二套聊天 UI。
+        ctx.slots.inject('conversation.input.left', () => ctx.slots.register({
+          name: 'conversation.input.left',
+          id: 'data-cleaning-agent-capabilities',
+          order: 110,
+        }, CapabilityBar));
+
+        // 会话头部恢复入口：用户关闭右栏后可随时重新打开当前任务工作台。
+        ctx.slots.inject('conversation.session.header.actions', () => ctx.slots.register({
+          name: 'conversation.session.header.actions',
+          id: 'data-cleaning-agent-workbench',
+          order: 110,
+        }, WorkbenchHeaderEntry));
+
         // M3：三个工具的 tool.call.toolview 富化卡片（keyed by wire name，替代裸 JSON 摘要）。
         // 说明：分三条独立 inject（而非 generator）——测试 shim 对 inject 回调仅执行一次并 push 其返回值。
         const toolviewKeys = ['data_clean_rows', 'data_complete_rows', 'data_profile'];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-data-cleaning-agent",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "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",
@@ -29,6 +29,7 @@
     "docs/RELEASE-0.4.0.md",
     "docs/RELEASE-0.5.0.md",
     "docs/RELEASE-0.5.1.md",
+    "docs/RELEASE-0.5.2.md",
     "docs/G5-HOST-BRIDGE.md",
     "docs/G5-E2E-RUNBOOK.md"
   ],