深鲸表格对比(dsh-csv-diff):两份 CSV 按关键列做增删改对比

前言

在 DSH 工作流里,经常要对两份导出的表格做核对:名单有没有增减、字段有没有改。手工在 Excel 里 VLOOKUP 或写一次性脚本都能做,但步骤分散,也不方便在 Harness 侧栏里反复用。下面介绍社区插件 深鲸表格对比(npm 包名 @deepwhale-cn/dsh-csv-diff,仓库 feely0208/dsh-csv-diff):指定关键列,把两份 CSV 的新增、删除、修改行列出来,并提供 CLI 与 Web 面板入口。

这是什么

深鲸表格对比 是 DeepSeek Harness 下的工作流类插件,由维护者 feely0208 发布(源码仓库归属见 GitHub;package 中作者信息为温州深鲸智能科技有限公司)。它解决的是:两份 CSV 按同一关键列对齐后,输出相对基准文件的新增行、删除行、以及关键列相同但其它列有变化的修改行。解析在本地完成,README 说明不上传文件。

核心功能

依据 README 与 package.json 描述,当前可核实能力如下:

  1. 按关键列 diff:用户指定一列作为键(例如「编号」),比较 --a 与 --b 两份 CSV。
  2. 三类结果:新增、删除、修改的行(相对两份文件的对比语义以插件实现为准)。
  3. 命令行入口:通过 dsh-csv-diff 可执行文件调用(见下文示例)。
  4. Web 面板:安装 Web profile 后,侧栏出现「深鲸表格对比」,便于在 DSH 界面内操作(与 CLI 同属该插件,具体面板字段以运行环境为准)。
  5. 本地处理:README 明确为纯本地解析,不上传。

插件版本在资料中为 0.1.0,许可证 MIT。运行环境要求:Node.js >= 18;dsh 版本需满足 >=0.1.0-rc.6 且 <0.3.0。

安装与启用

安装命令须使用 README 原文(Web 侧客户端注入配置在 package.json 的 dsh.client.platform: web):

dsh plugin --profile web add @deepwhale-cn/dsh-csv-diff

说明:--profile web 与包内 dsh.client.platform 一致,用于带 Web 客户端的 Harness 环境。安装前请自行查看仓库源码与 LICENSE,确认符合你的安全与合规要求;插件以当前 dsh 进程权限运行,能读写的路径即插件能访问的范围。

典型用法

README 给出的 CLI 示例可直接复现(路径与关键列名按你的文件替换):

dsh-csv-diff --a ./上月.csv --b ./本月.csv --key 编号

这一步的含义是:以 ./上月.csv 与 ./本月.csv 为输入,用列名 编号 作为关键列做对比。输出形式(终端文本或文件)以 CLI 实际行为为准;需要在界面里操作时,可在侧栏打开 深鲸表格对比。

适用场景与注意

适合:周期性导出 CSV 的名单、台账、配置表,需要快速看「多了谁、少了谁、谁被改过」;希望在 DSH 工作流分类里用同一工具,而不是每次写 ad hoc 脚本。

注意:

  1. 两份 CSV 须能被插件正确解析;关键列 --key 必须在表头中存在且语义一致。
  2. 大文件性能与内存占用未在 README 中说明,生产数据建议先用小样验证。
  3. 社区目录页(skillhub 插件页)与 GitHub 为独立信息源;DSH 生态强调「一切皆插件」,该目录站点与 DeepSeek / 幻方无官方从属关系,安装来源以你实际使用的 registry 与命令为准。
  4. 再次强调:安装前检查源码与许可证;插件权限等同于运行 dsh 的用户/进程权限。

结尾

深鲸表格对比把「两份 CSV + 一个关键列」的表格 diff 收成一条安装命令、一条 CLI 和侧栏入口,适合纳入 DSH 工作流。进一步了解可访问目录页 https://www.skillhub.cn/plugins/feely0208/dsh-csv-diff 与源码 https://github.com/feely0208/dsh-csv-diff。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜