前言¶
在 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 描述,当前可核实能力如下:
- 按关键列 diff:用户指定一列作为键(例如「编号」),比较
--a与--b两份 CSV。 - 三类结果:新增、删除、修改的行(相对两份文件的对比语义以插件实现为准)。
- 命令行入口:通过
dsh-csv-diff可执行文件调用(见下文示例)。 - Web 面板:安装 Web profile 后,侧栏出现「深鲸表格对比」,便于在 DSH 界面内操作(与 CLI 同属该插件,具体面板字段以运行环境为准)。
- 本地处理: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 脚本。
注意:
- 两份 CSV 须能被插件正确解析;关键列
--key必须在表头中存在且语义一致。 - 大文件性能与内存占用未在 README 中说明,生产数据建议先用小样验证。
- 社区目录页(skillhub 插件页)与 GitHub 为独立信息源;DSH 生态强调「一切皆插件」,该目录站点与 DeepSeek / 幻方无官方从属关系,安装来源以你实际使用的 registry 与命令为准。
- 再次强调:安装前检查源码与许可证;插件权限等同于运行 dsh 的用户/进程权限。
结尾¶
深鲸表格对比把「两份 CSV + 一个关键列」的表格 diff 收成一条安装命令、一条 CLI 和侧栏入口,适合纳入 DSH 工作流。进一步了解可访问目录页 https://www.skillhub.cn/plugins/feely0208/dsh-csv-diff 与源码 https://github.com/feely0208/dsh-csv-diff。