前言¶

在 DSH（DeepSeek Harness）裏做智能體或本地工作流時，常會碰到同一類文檔要整批處理：合同目錄裏批量替換公司名、週報合併成一份、掃描 PDF 拆頁或壓體積。若每種格式各裝一個插件、各記一套入口，維護和腳本化成本都會上去。下面介紹社區插件 dsh-doc-batch（npm 包名 @deepwhale-cn/dsh-doc-batch）：把 Word、Excel、PDF 三類能力收進一個插件、一個側欄面板，同時保留統一 CLI，處理在本機完成，不上傳文件。

這是什麼¶

dsh-doc-batch 是 DeepSeek Harness 的客戶端類插件，由維護者 feely0208（溫州深鯨智能科技有限公司）發佈，倉庫地址 github.com/feely0208/dsh-doc-batch，社區目錄頁 skillhub.cn/plugins/feely0208/dsh-doc-batch。

定位一句話：對指定文件或整個目錄做替換、提取、合併、拆分、壓縮、水印、導出等操作，覆蓋 docx / xlsx / pdf（別名 word、excel 與 docx、xlsx 等價）。README 說明該插件由原先三個單格式插件（docx-batch / xlsx-batch / pdf-kit）合併而來，能力與合併前一致，只是入口統一；三種格式的參數解析與 Python 處理內核仍各自獨立（bin/cli-docx|xlsx|pdf.mjs + lib/*.py），統一入口只做分發。

當前 package.json 中版本爲 0.1.4，許可證 MIT；要求 Node.js >= 18，DSH >=0.1.0-rc.6 且 <0.3.0。

核心功能¶

圖形面板¶

側欄打開「深鯨文檔批量」→ 選擇格式（Word / Excel / PDF）→ 選擇操作 → 填寫文件或目錄 → 開始處理。結果直接顯示在面板裏；缺 Python 依賴時，面板會把 CLI 給出的安裝提示原樣展示。

Word（docx）¶

• replace：目錄內批量替換文本（--from / --to）
• extract：提取文本到輸出目錄
• merge：合併多文件
• headers：查看標題結構等信息
• to-md：導出 Markdown

Excel（xlsx）¶

• merge：合併
• clean：清洗輸出到新目錄
• summary：彙總信息
• csv：導出 CSV

PDF¶

• merge / split（如按頁 --action page）
• compress：壓縮
• watermark：加水印（如 --text 機密）
• extract-text：提取文本
• extract-images：提取圖片（如 --dpi 150）

運行環境與依賴¶

除 Node 與 DSH 外，處理依賴本機 python3 及對應庫：python-docx（Word）、openpyxl（Excel）、pypdf（PDF）。缺庫時 CLI 會提示如何安裝。

安裝與啓用¶

在 DSH 中按 web profile 添加插件，官方 README 給出的命令如下：

dsh plugin --profile web add @deepwhale-cn/dsh-doc-batch

也可從 GitHub 源碼安裝：

dsh plugin --profile web add github:feely0208/dsh-doc-batch

安裝完成後，客戶端會在 web 平臺注入（dsh.client.platform: web），側欄即可使用面板。命令行入口爲 dsh-doc-batch（見 package.json 的 bin 字段）。

典型用法¶

以下示例均來自倉庫 README，路徑與參數可按實際目錄替換。

Word：批量替換、提取、合併、導出 Markdown

dsh-doc-batch docx replace --input ./合同 --from 深鯨科技 --to 深海鯨
dsh-doc-batch docx extract --input ./合同 --out ./文本
dsh-doc-batch docx merge   --input ./週報 --out ./合併
dsh-doc-batch docx headers --input ./合同
dsh-doc-batch docx to-md   --input ./合同 --out ./md

Excel：合併、清洗、彙總、轉 CSV

dsh-doc-batch xlsx merge   --input ./報表 --out ./合併
dsh-doc-batch xlsx clean   --input ./報表 --out ./清洗
dsh-doc-batch xlsx summary --input ./報表
dsh-doc-batch xlsx csv     --input ./報表 --out ./csv

PDF：合併、按頁拆分、壓縮、水印、抽文本與圖片

dsh-doc-batch pdf merge          --input ./掃描件 --out ./合併
dsh-doc-batch pdf split          --input a.pdf --out ./拆分 --action page
dsh-doc-batch pdf compress       --input a.pdf --out ./壓縮
dsh-doc-batch pdf watermark      --input a.pdf --out ./水印 --text 機密
dsh-doc-batch pdf extract-text   --input ./掃描件 --out ./文本
dsh-doc-batch pdf extract-images --input a.pdf --out ./圖片 --dpi 150

面板用法與上述能力對應：選格式與操作後填 --input 同等的路徑即可，無需重複記各格式的獨立插件名。

適用場景與注意¶

適合誰：需要在 DSH 客戶端裏對本地 Word / Excel / PDF 做目錄級批處理的用戶；也適合把 dsh-doc-batch 寫進腳本或 Harness 工作流，與智能體側欄操作共用同一套命令。

權限與安全：插件以當前 dsh 進程權限讀寫你指定的輸入輸出路徑；處理在本機進行，README 明確說明不上傳文件。安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證，確認依賴與行爲符合你的環境策略。社區目錄（如 SkillHub）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，本介紹僅描述該插件已公開文檔中的能力。

其他：若你曾使用 docx-batch、xlsx-batch、pdf-kit 三個舊插件，合併版能力一致，只需改用 @deepwhale-cn/dsh-doc-batch 這一入口即可。

結尾¶

dsh-doc-batch 把三類辦公文檔的批量處理能力收成「一個插件、一個面板、一條 CLI」，適合在 DSH web 客戶端裏快速處理整目錄文件。進一步瞭解可訪問目錄頁 https://www.skillhub.cn/plugins/feely0208/dsh-doc-batch 與 GitHub https://github.com/feely0208/dsh-doc-batch。