dsh-data-cleaning-agent 0.9.13 → 0.9.16

package/CHANGELOG.md

@@ -1,3 +1,25 @@
+# 0.9.16 · 2026-09-15
+
+- UX-49：仅清洗入口新建的独立 Session，通过 Host 原生草稿接口预填一次；空草稿、附件/引用、输入就绪、IME、草稿版本与晚到竞态二次核验，不自动发送、建业务任务或展开工作台。
+- 用户编辑/主动清空、旧会话、刷新、重挂载和切回不补回、不清理草稿；保留 UX-48 接纳后开台与 settling→hero 品牌修复。
+- 初始引导采用稳定模板 ID/版本和精确文本指纹；向导排除未改模板，修改后的内容不整体忽略，已有草稿提供替换/追加/取消，异步回填前重新核验。
+- 未补占位符或缺名单/待补字段，在清洗业务 Skill 中优先澄清，不调 OAuth/OCR/MCP 或创建 workflow；不拦截 DSH 全局发送。
+
+# 0.9.15 · 2026-09-14
+
+- 保留 0.9.14 的 Host 驱动单向工作流、导航保护、导入核验和紧凑状态区功能。
+- 修正发布测试的时区依赖，按运行环境验证界面本地时间，不再假定 CI 使用中国时区。
+- UI 回归使用与生产一致的 UUID commandId，并覆盖提交接纳去重、手动收起、任务历史重开和结果下载。
+- UTC 下 290 项自动化测试、10 组 Chromium 布局矩阵和 3 组制品预览回归通过。
+
+# 0.9.14 · 2026-09-14
+
+- 由 Host `flow` 投影统一五步业务流程状态，Client 仅维护当前查看节点；刷新、后台推进和单次高层执行跨阶段时保持一致。
+- 未来节点保留可点击的锁定反馈，历史节点可查看但不挂载业务写操作；当前版本不引入回退 Tool、任务版本或新的事件系统。
+- 导入后保留完整名单核验，并在表格底部确认进入规则与体检；紧凑状态区补充来源、时间、任务范围和明确的结果计数。
+- 保留 0.9.13 的提交接纳边界：草稿或失败发送不展开工作台，后台会话不抢焦点，手动收起不被轮询撤销。
+- 290 项自动化测试通过；旧 Session 迁移不在本版本验收范围，升级后请新建清洗会话验证。
+
 # 0.9.13 · 2026-09-14
 
 - 实际提交被 Host 接纳后自动展开所属会话工作台，草稿回填及失败发送不展开。

package/README.en.md

@@ -10,9 +10,11 @@ Related agents: [数据清洗补全](https://github.com/duhu2000/dsh-data-cleani
 
 > 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.9.13** (stable release)
+> Current source version / 当前源码版本: **0.9.16** (stable release)
 
-0.9.13 removes the home subtitle and its spacing, keeps native workspace/mode/composer controls, prevents duplicate menu launches, and scopes branding to its own home. Task records are distinguished from live model activity. The 0.9.11 Host phase and Session restoration fixes remain intact.
+0.9.16 implements UX-49: a one-time editable native guide for new cleaning-entry Sessions, with existing text, attachment, IME and asynchronous-race guards. Clearing, refreshing or returning never restores it. Initialization does not send, call tools or open the workbench. Incomplete templates request the missing list and fields first. See the [adoption record](docs/UNIFIED-HOME-1.5.4-ADOPTION.md) for isolated DSH evidence and unverified boundaries.
+
+0.9.15 releases the Host-driven forward-only workflow across import, rules, entity matching, enrichment, and download. Future stages provide explicit locked feedback, while completed stages remain viewable without business-state mutations. Imported rows stay visible for full review before the bottom confirmation advances to rules. The compact status area reports stage, source, time, scope, and explicit result counts. The 0.9.13 submission-admission, background-session isolation, and manual-collapse guarantees remain intact. Start a new cleaning Session after upgrading; legacy Session migration is outside this release's acceptance scope.
 
 0.9.10 observes the Host settling-to-hero transition so the database logo and product title appear even after delayed layout. Unknown structures do not trigger global headline rewriting. Rollback version: 0.9.9.
 

package/README.md

@@ -9,7 +9,7 @@
 数据清洗补全智能体：面向 Excel/CSV/JSON 企业名单，提供数据清洗、表格清洗、清洗补全、去重、企业数据补全与字段补全，支持企查查 MCP 和结果导出。
 
 ```sh
-dsh plugin --profile web add dsh-data-cleaning-agent@0.9.13
+dsh plugin --profile web add dsh-data-cleaning-agent@0.9.16
 ```
 
 请先满足下文的 DSH、连接器及侧边栏依赖要求；安装后完整停止并重启对应 Profile。
@@ -27,9 +27,11 @@ dsh plugin --profile web add dsh-data-cleaning-agent@0.9.13
 
 > 在 DeepSeek Harness 中清洗、补全、画像企业名单数据的智能体插件：本地 CSV/XLSX/JSON 引擎 + 可选企查查（Qichacha/QCC）MCP 企业数据补全，由企查查（Qichacha/QCC）团队发起并维护。
 >
-> 当前源码版本 / Current source version: **0.9.13**（正式版本）
+> 当前源码版本 / Current source version: **0.9.16**（正式版本）
 
-0.9.13 统一简洁首页：移除副标题与占位，保留原生工作区、模式和输入框。菜单名称固定并防止重复创建；品牌标题仅在所属首页生效，任务记录与模型运行状态明确区分。保留 0.9.11 的真实 Host 阶段与会话切换修复。
+0.9.16 实施 UX-49：首页仅为清洗入口新建的会话预填一次原生可编辑引导，保护已有文字、附件、中文组合输入与异步竞态。主动清空、刷新或切回不会补回；不自动发送、调用工具或展开工作台。未补全模板先澄清名单和字段。真实 DSH 隔离验收及未验证边界见[规范采用记录](docs/UNIFIED-HOME-1.5.4-ADOPTION.md)。
+
+0.9.15 发布 Host 驱动的单向工作流：统一“导入与核验 → 规则与体检 → 主体匹配 → 字段补全 → 结果下载”五步导航。未来节点给出明确锁定反馈，历史节点保留查看但不挂载业务写操作；导入后先核验完整名单，再从表格底部确认进入规则页。紧凑状态区展示节点、来源、时间、任务范围和明确结果计数。0.9.13 的真实提交接纳、后台会话隔离与手动收起保护保持不变。升级后请新建清洗会话验证，旧 Session 迁移不在本版验收范围。
 
 0.9.10 补齐首页 settling → hero 阶段监听，避免首次挂载漏掉 Logo 与标题替换；兼容“探索未知之境”，未知结构不做全局标题改写。回滚版本为 0.9.9。
 

package/docs/COMPATIBILITY.md

@@ -206,3 +206,10 @@ Host 制品下载按钮。alpha.2 继续只检查 Host/路由/制品 Bridge，
   XLSX 因此以 Base64 文本落盘。未来切换二进制 seam 必须保留旧 `v1` 制品读取兼容。
 - v2 已生成制品可跨 Host 重启恢复，但浏览器 runtime 中尚未导出的原始行不会持久化；恢复中途任务
   仍需用户重新提供输入。制品只在当前工作区，不承诺跨设备同步。
+# UX-49 原生初始草稿兼容边界（0.9.16，2026-09-15）
+
+- 采用记录见 `UNIFIED-HOME-1.5.4-ADOPTION.md` 的 v1.5.6 小节。仅新建清洗 Session 初始化，旧 Session/刷新/重挂载只恢复归属，不迁移或补回草稿。
+- 本机核对 DSH 0.1.2-rc.1 的公开 `conversation.input.shell(sessionId)`：`snapshot.draft / draftRev / phase / imageIds / occurrences` 与 `setDraft`。缺失任一必要快照能力时保守跳过，不使用 DOM 空文本推断可写，不读取私有 editor。
+- Host InputState 没有 IME 字段：使用 compositionstart/end 与入口异步期间的 beforeinput/input/paste/drop 事件，仅用于取消本插件初始化，不阻断默认事件、不修改其他产品。公开 shell 可在新 Session 的输入 DOM 挂载前使用；不把 hero/settling 或 session.blank 当草稿就绪证据。
+- 未填写的模板发送由本业务 Skill 澄清；不改 Host submit/beginSubmission 全局语义。UX-48 原有 observed 接纳桥保持独立，草稿写入不产生业务接纳事件。
+- 本轮不升级 DSH、不修改正式 Profile、不请求 QCC/OCR/模型凭据。无法验证的 Host 版本或真实模型决策明确保留为外部边界。

package/docs/RELEASE-0.9.14.md

@@ -0,0 +1,12 @@
+# 0.9.14 — Host 驱动的单向工作流
+
+- Host `flow.currentStage`、`stageAccess` 与 `allowedActions` 成为业务流程及操作权限的唯一依据；Client 独立维护当前查看节点。
+- 五步导航阻止越级操作：未来节点点击后说明解锁条件，已完成节点可查看但不挂载会改变业务状态的控件。
+- 导入完成后保留完整名单核验视图，主操作固定在表格底部；确认后进入规则与体检。
+- Agent-owned 高层执行可一次跨过匹配、补全与交付阶段，Client 按 Host 最新状态同步，不拆分 QCC 调用、确认、计费、幂等或隐私边界。
+- 刷新与重新挂载从 Host 任务恢复真实节点；运行时名单缺失时只展示可恢复信息，不自动重复查询或扣量。
+- 状态区收缩为紧凑流程摘要，展示真实节点、任务状态、来源、时间、任务范围及有意义的结果计数。
+- 保留 0.9.13 的提交接纳逻辑：草稿回填和失败发送不展开，后台 Session 不抢占界面，手动收起不被轮询重新展开。
+- 当前版本仍不提供流程回退；契约通过 `flowVersion` 与显式访问投影保留未来扩展空间，不引入任务版本或通用事件框架。
+
+发布验收通过 290 项自动化测试。升级后完整重启 Profile 并新建清洗 Session；旧 Session 迁移不在本版本验收范围。

package/docs/RELEASE-0.9.15.md

@@ -0,0 +1,13 @@
+# 0.9.15 — Host 驱动的单向工作流
+
+本版本发布 0.9.14 已完成但因 CI 可移植性断言未能进入 npm 的功能内容：
+
+- Host `flow.currentStage`、`stageAccess` 与 `allowedActions` 负责业务流程和操作权限，Client 独立维护查看节点。
+- 未来节点提供明确锁定反馈；已完成节点可查看，但不挂载改变业务状态的操作。
+- 导入完成后保留完整名单核验，主操作位于表格底部；确认后进入规则与体检。
+- Agent-owned 高层执行可以按 Host 状态跨过中间 UI 节点，不拆分 QCC 调用、确认、计费、幂等或隐私边界。
+- 紧凑状态区展示节点、来源、时间、任务范围和明确结果计数。
+- 保留提交接纳去重、后台 Session 隔离和用户手动收起保护。
+- 工作流契约以 `flowVersion` 和显式访问投影保留未来回退扩展空间，本期不增加回退 Tool 或任务版本模型。
+
+发布门禁已在 UTC 环境通过 290 项自动化测试，并通过浅色/深色共 10 组 Chromium 布局矩阵及 3 组制品预览回归。升级后完整重启 Profile 并新建清洗 Session；旧 Session 迁移不在本版本验收范围。

package/docs/UNIFIED-HOME-1.5.4-ADOPTION.md

@@ -1,4 +1,25 @@
-# DSH-UX-001 v1.5.4 采用记录
+# DSH-UX-001 首页规范采用记录
+
+## v1.5.6 / UX49-CLEAN（2026-09-15，0.9.16）
+
+发布授权补充：用户于实施与 PR 验证后明确要求 commit、push、tag、npm，按仓库既有 CI、合并及 OIDC 发布流程推进 0.9.16；原实施阶段仅授权 PR 的边界作为历史记录保留。
+
+依据共享 `DSH智能体开发交互规范方案.md` 的 UX-49、§11.1、§14，并核对 UX-48；协同清单 `DSH-UX-049-四智能体首页初始引导协同.md` 及总账同日交接。这里只记录采用与差异，不复制规范全文。
+
+- 审计基线：remote main `fc7d57240b843e1a57998cf0ebbe4f39c086befb`，npm latest 0.9.15 / gitHead `6d8b37a7a0efae1aa2fddc72d61fc5e732f3231f`。原仓 main 的未提交 client/test 修改保持原样，另建独立分支。
+- 已有正确项：独立清洗 Session namespace、宿主原生输入接口、实际接纳后开台、标题 settling→hero 修复、历史来源只读与主结果/报告分层。
+- 真实缺陷：入口无条件 setDraft；普通会话异步恢复时按宽泛签名清理草稿；已有业务入口再次点击会开台；向导缺少已有内容确认与晚到写入检查。以上已收紧。
+- 初始模板 `dsh-initial-draft/data-cleaning/1` / version 1，UTF-8 SHA-256 `2b84b86f669e64e970381e4c7ab8547c77d5e10ee7d5441543c893b9f1272e2b`。仅精确相等才排除；不 trim、不按前后缀忽略用户修改。
+- 初始化仅由本入口成功创建的全新 ID 触发，在打开会话前操作未挂载的原生 shell，避免 Host setDraft 的选区写入抢占已挂载输入焦点。snapshot 缺失或非 plain、draft 非空、draftRev 非零、imageIds/occurrences 非空均跳过。建立一次性记录、订阅后重读、微任务后再次快照；期间用户输入/附件/组合事件、会话切换或卸载使写入失效，无轮询补回。
+- 清洗业务 Skill 将信息充分性检查置于任何工具之前：占位符/缺名单或待补字段先澄清；没有注册全局发送拦截。安全凭证所指暂存来源仍可提供名单和范围，不重复要求上传。
+- 向导按 UX-10 提供替换/追加/取消，默认保留用户内容；同一 Session 未改的向导草稿更新而非重复叠加。异步回填重读草稿版本、附件和当前业务归属。
+- 本地门禁：`npm run check` 通过（296 项测试，语法/文档/营销/69 文件 pack 白名单）；Chromium 浅深色 × 5 尺寸 10/10；XLSX 预览 390/800/1440px 3/3。包含附件、IME 事件、晚到修改/清空、卸载、A/B、普通 Session、Tab X/折叠恢复、草稿回填替换/追加/取消与零开台断言。
+- 真实 DSH：`scripts/ux49-native-smoke.mjs`，独立 Profile、无模型/MCP 凭据。DSH 0.1.2-rc.1 + Sidebar 0.18.1 + 清洗候选/招投标 0.5.11/访前尽调 0.1.35/填表 0.2.30 共装通过。原生模板、正确 Hero 标题、不移动焦点、主动清空不补回、刷新保留修改、A/B/普通会话隔离、零业务 API mutation、零可见工作台、零浏览器异常均通过。
+- 实机客户端 SHA-256 `bacfd1faa7eff584ddec3e948ee3f2e19f1d710224de9068d9a62415345a28a1`，测试包 SHA-256 `e93fac1541934a43bc54789283d57c378fbd721fe0d8fc86b922b2a69c5747c5`。原始报告/截图在 `/var/folders/ws/tmsn44b140lf8b89ml5qqjf00000gn/T/cleaning-ux49-native-HtQGy0/`；本地日志 `/private/tmp/ux49-{check,ui,artifact,native}-release-candidate.log`，UI 截图 `_scratch/ui-layout/`。测试包不是 npm 发布物；随后文档和验收脚本路径清理不改变已验收客户端字节。
+- 未验证边界：真实模型执行占位符澄清（仅验证 Skill 优先规则，不冒充实际模型决策）、系统级真实中文输入法（已覆盖组合事件）、收费 QCC/OCR、多账号/其他 Host 版本，以及其余三产品各自 UX49 候选版本。正式 3080/Profile 未修改。
+- 本次仅 commit/push/PR/CI；不合并、不升版本、不 tag/Release/npm publish。
+
+## v1.5.4 历史采用记录
 
 日期：2026-09-14。基线：0.9.11 / a0ec971db0d25d42f67f99e4328cca6f49a2bc2f。
 本轮仅本地代码与验收，不发布，不修改正式 Profile 或全局 DSH。