dsh-data-cleaning-agent

dsh plugin --profile web add dsh-data-cleaning-agent

dsh-data-cleaning-agent

0.9.2 升级说明：Better Sidebar 是可选工作台依赖；缺失时基础工具和会话仍可用。工作台需要兼容的 dsh-better-sidebar（targetedOpen、stateSubscription），不回退到自有抽屉；验证边界见 [兼容记录](docs/COMPATIBILITY.md)。

本版统一向导与工作台的 Host 执行闭环：发送后自动生成新 Excel，原文件不修改，工作台入口可恢复；发布记录见 [发布说明](docs/RELEASE-0.8.22.md)。

安装与三分钟上手

数据清洗补全智能体：面向 Excel/CSV/JSON 企业名单，提供数据清洗、表格清洗、清洗补全、去重、企业数据补全与字段补全，支持企查查 MCP 和结果导出。

dsh plugin --profile web add dsh-data-cleaning-agent@0.9.17

请先满足下文的 DSH、连接器及侧边栏依赖要求；安装后完整停止并重启对应 Profile。

上传一份合成 CSV（如表头“姓名,手机号,金额”，两行重复的“演示用户,13800000000,100”），选择去重并检查结果，再导出新文件。企业字段补全另需已授权的企查查 MCP；先用本地清洗体验流程。

流程样例（示意，非真实调用结果）： 输入两条相同合成记录 → 选择去重规则 → 预览一条保留记录 → 导出结果。

能力边界： 本地清洗与企业数据补全是不同步骤；外部事实来自用户授权的数据源，无法确定的主体或字段交给人工复核，不编造企业事实。

升级与回滚： 升级前停止 Profile 并备份任务目录，记录当前精确版本；使用上面的固定版本命令升级，再完整重启。回滚时将版本号替换为升级前记录的版本，并使用升级前任务目录副本；不以旧版直接读取已迁移任务目录。

相关智能体：数据清洗补全 · AI填表 · 访前尽调 · 招投标

在 DeepSeek Harness 中清洗、补全、画像企业名单数据的智能体插件：本地 CSV/XLSX/JSON 引擎 + 可选企查查（Qichacha/QCC）MCP 企业数据补全，由企查查（Qichacha/QCC）团队发起并维护。

当前源码版本 / Current source version: 0.9.17（正式版本）

0.9.17 新增省市区、地区代码、四级国标行业、四级企查查行业、主营产品与企业规模共 14 项字段，目录共 150 项；兼容行业由文本改为分层对象，优化字段搜索与原列映射。默认选择不扩大，缺失层级不推测；主营产品最多为上游返回的前 10 项。详见[字段扩展与验证边界](docs/CORE-FIELDS-20260918.md)。

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。

0.9.9 修复新版 Host composer sibling slot 下的原生首页标题定位，进入数据清洗补全后稳定显示“数据清洗补全智能体”，并保持对其它业务插件的标题隔离。0.9.8 的 Profile 历史只读、来源工作区/会话校验与旧记录边界全部保留。回滚：dsh plugin --profile web add dsh-data-cleaning-agent@0.9.8。真实 DSH A/B 验收仍以安装后的用户验证为准，详见发布说明。

本版优化工作台的信息层级、区域间距与响应式布局，重构导入清单、字段映射、质量体检及主体匹配页面。导入成功后文件、图片与粘贴入口自动收起，通过“重新导入”再次展开；映射字段按维度分组选择，搜索维度名称时展示该组全部字段。生成说明不查询，发送才执行；升级后需完整重启 DSH，历史下载文件不自动改写。








简介

dsh-data-cleaning-agent 是 DeepSeek Harness 的插件（DSH Bundle plugin）。

它面向"客户给的一批企业名单 / 表格数据"这个高频场景：上传 CSV / XLSX / JSON，

对姓名、手机号、金额等列做清洗（去空格、手机号规范化、剔除缺失/负金额/重复行）、

确定性补全与概览画像，并导出干净的 CSV。

通过右侧工作台处理表格时，模型（LLM）默认只拿到统计摘要，完整明细仅在同源 web 界面查看与导出。

如果用户主动用提示词生成器粘贴名单、附加图片或把表格主体预览回填对话框，这些用户明确选择发送的

内容会进入模型上下文；表格完整数据仍只保留在本机工作台。

企查查补全采用 客户自带连接与账号（BYO QCC）：每位客户在自己的 DSH 中开通企查查 MCP，

调用消耗其自有账号的套餐额度或按其与企查查的合同计费。本插件不内置、不分发、不共享开发者 Key，

不代理结算，也不为客户代付或补贴企查查费用。维护者自己的 Key 仅用于隔离开发测试，不进入发布包。

30 秒开始

dsh plugin --profile web add dsh-data-cleaning-agent

安装后完全重启 DeepSeek Harness（停止后重新运行 dsh web）。

之后在对话中说「帮我清洗这批企业名单数据」，插件会自动加载内嵌 Skill 并调度清洗/补全/画像工具。

重启后，「数据清洗补全」入口会显示在侧边栏顶部的「新会话」与「工作区」之间。点击后打开专属的

DSH 原生会话：首页标题、产品说明与工作流会替换通用探索页；输入框左上角提供提示词生成器，支持

粘贴名单、解析 Excel/CSV/JSON 或附加图片并选择清洗动作、补全字段。上传清洗、质量体检、匹配核验、

字段补全和任务历史五个入口位于输入框下方，右侧工作台承载“上传数据 → 规则确认 → 数据匹配 →

清洗补全 → 下载数据”五步闭环。完成后可预览、下载清洗补全结果 XLSX 和独立任务结果报告 XLSX；有异常时另提供异常清单 XLSX。执行状态和来源信息不会追加到客户主结果中。

0.8.1 起，在数据清洗补全会话的原生输入框粘贴图片，或在「提示词生成」的图片页

拖入/选择 PNG、JPEG、WebP，会显示可点击放大的原生缩略图。用户可继续完成匹配规则、清洗项与补全字段，

最后一次性把完整、可编辑的任务说明回填到对话框；不再先发送一轮 OCR 专用指令。发送前 Client 释放

Composer 图片附件，因此不支持视觉输入的文本模型也能调度 Agent-owned 高层工具。高层工具通过官方

qcc-document-mcp 的 parse_document(file_path) 提交本地图片，仅在异步处理中以同一 task_id

调用 get_parse_result，再将企业名称/信用代码交回工作台人工核对。

本地图片解析需在 MCP 连接器中另行配置官方 qcc-document-mcp；市场中的远端 qcc-document

只支持公网 file_url，不能读取本机图片。两者使用当前客户自己的企查查账号与额度，本插件不读取、保存

或分发凭据。本地服务会把用户明确提交的图片上传到企查查文档解析网关；未连接本地服务时功能会

fail closed，并明确提示配置要求，文本与 Excel 流程不受影响。

基础安装不需要 Better Sidebar，也不会自动安装它。交互工作台才需要完整 DSH 0.1.2-rc.1 + 可选 Better Sidebar 0.18.1；optional peer 的精确版本不代表其它配对均兼容。context 不是必装依赖；若已装 0.36.0，需先升级到 0.48.0。已安装不兼容侧栏仍会阻断预检。

无侧栏可用：原生会话、data_clean_rows、data_complete_rows、data_profile 引擎工具。不可用：交互工作台的表格导入、映射确认、结果预览/下载及流程导航；点击入口显示原因并保留草稿/任务，不创建私有抽屉。不要把会话可打开等同于完整清洗流程可用。基础预检默认允许侧栏缺失；如需校验工作台安装，运行 node lib/install-preflight.js <Profile目录> <dsh可执行文件> --workbench，运行时再探测 capabilities。预检不会升级全局宿主。

从完整源码或解压的 npm 包运行安装脚本（需要实际 dsh CLI；不再支持流式脚本）：

node lib/install-preflight.js "$DSH_HOME/profiles/web"
bash install.sh

或直接让 Agent 安装：

帮我安装这个插件 https://github.com/duhu2000/dsh-data-cleaning-agent

能力矩阵

能力 · 工具 / 入口 · 说明

清洗 · data_clean_rows · trim、手机号规范化、剔除缺失必填/负金额/重复行

补全 · data_complete_rows · 空金额填 0、空姓名填占位、不可补全项上报

画像 · data_profile · 列概览与金额分布

解析 · web /data-cleaning/api/mvp/parse · CSV / XLSX / JSON

异步任务 · web /data-cleaning/api/mvp/jobs · 任务状态机 + 持久化存储

UI · web /data-cleaning/ · 上传 → 清洗/补全 → 导出

五步任务 · web /data-cleaning/api/workflow/* · taskId/revision、规则、匹配、补全、恢复与状态审计

耐久制品 · Host 工作区 .dsh-data-cleaning-artifacts/v1 · 结果/异常 CSV+XLSX，checksum 校验，跨 Host 重启下载

应用

…(truncated)