前言¶
在 DeepSeek Harness（DSH）里做交付物整理、合同汇编或章节打包时，往往需要把多份 .docx、.md、.txt 收成一份可阅读的 Word。手工复制粘贴容易格式错乱、标题层级打架，漏掉某一卷还得重新核对；在线合并又要先上传敏感文件。下面介绍社区插件 dsh-doc-merge：在本机把多份文档合成一份带静态目录页的 .docx，默认不联网（读取已有 docx 时依赖离线库 mammoth）。
这是什么¶
dsh-doc-merge（npm 包名 @deepwhale-cn/dsh-doc-merge，版本 0.1.0，MIT 许可证）是 DSH 文档合并插件。源码仓库由 feely0208/dsh-doc-merge 维护；package.json 中作者为温州深鲸智能科技有限公司。插件在 DSH 进程中提供命令行 dsh-doc-merge，将多份 Word / Markdown / 纯文本按指定或文件名顺序合并，并在文首生成目录清单。
社区目录页：skillhub.cn/plugins/feely0208/dsh-doc-merge。DSH 生态理念是「一切皆插件」；该目录为独立社区站点，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
资料中已明确的能力如下。
- 多格式输入：支持
.docx、.md、.txt；可传入多个文件路径，或传入整个目录（目录内默认按名字排序，数字自然序：2 在 10 前）。 - 章节标题：每份材料前插入一级标题；默认用文件名，也可
--title-from first-line（首行）或--title-from front-matter（Markdown 的title:）。 - 目录页：输出文首为「目录」+
第 N 章 文件名的静态清单，Word 打开即可见，不依赖更新域。 - 排版选项：
--page-break每份另起一页；--strip-title去掉原文档开头的一级标题以免与插入标题重复；页脚居中页码。 - 容错与预览：单份解析失败时提示「第 N 份解析失败（原因），已跳过」，其余继续合并并在结尾汇总；
--dry-run只计算不写文件；--json输出份数、段落数、目录条数、预估页数、跳过项等 JSON。 - 实现边界：写 docx 侧零依赖（Node 内置
zlib+ 手写 WordprocessingML）；读 docx 使用mammoth^1.13.0。合并为内容级，不保留原文字体、颜色、页眉页脚、批注与修订；不做 PDF / 图片；单文件上限 40MB。
退出码：0 全部成功；1 有文件被跳过；2 全部失败或参数错误。
安装与启用¶
安装命令须使用 README 原文（勿凭仓库名自行拼接 github:owner/repo）：
dsh plugin --profile web add @deepwhale-cn/dsh-doc-merge
运行环境：node >= 18；dsh >= 0.1.0-rc.6 且 < 0.3.0（见 package.json 的 engines）。
插件以当前 DSH 进程权限在本机读写文件；安装前建议浏览 GitHub 仓库 源码与 MIT 许可证，确认符合你的合规要求。
典型用法¶
下面示例均来自官方 README，可直接复现。
按给定顺序合并三份文件并指定输出路径：
dsh-doc-merge 01-合同.docx 02-技术方案.md 03-说明.txt -o 投标文件.docx
对整个目录按名字排序，每份另起一页并去掉原文重复标题：
dsh-doc-merge ./章节 -o 合集.docx --page-break --strip-title
只预览、不写文件：
dsh-doc-merge ./章节 -o 合集.docx --dry-run
常用选项一览：
| 选项 | 作用 |
|---|---|
-o, --out <路径> |
输出 docx（默认 merged-时间.docx） |
--title-from <来源> |
filename（默认）/ first-line / front-matter |
--sort <name\|mtime> |
目录内排序（默认 name） |
--page-break |
每份另起一页 |
--strip-title |
去掉原文档开头的一级标题 |
--dry-run |
只预览，不写文件 |
--json |
机器可读 JSON |
输出结构与适用场景¶
合并后的文档结构为：目录页 → 各份一级标题 + 正文。原文档标题整体降一级（H1→H2…），避免两份材料各自 H1 并列；表格保留为 Word 表格。
适合：投标/合同附件汇编、按章节整理的 Markdown 与 Word 混排交付、智能体工作流里在本地生成一份可发客户的 .docx。不适合需要保留原稿版式、批注、修订或页眉页脚的场景；也不处理 PDF 与图片嵌入。
结尾¶
dsh-doc-merge 把「多份打开、复制、手动敲目录」收束为一条本机命令，并带静态目录与可选分页。需要功能细节、issue 或版本信息时，以仓库 README 与 GitHub 为准；在 DSH 中安装可使用社区目录 feely0208/dsh-doc-merge。
