前言¶

在 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。