前言¶
在 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。
