前言¶

在 DSH 里做完一轮任务，产出往往是目录里的一堆文件：文档、图片、脚本片段。直接打包发 zip，对方很难确认「收到的是否完整、是否被改过」。手工写清单再算哈希，步骤多且容易漏。

深鲸交付包（@deepwhale-cn/dsh-deliverable-pack）把这一步收成一条工作流：选定目录，生成交付目录结构、MANIFEST.json、CHECKSUMS.sha256 和可选 zip，并在本机完成校验，不上传任何文件。下面介绍它是什么、怎么装、怎么用。

这是什么¶

维护者 feely0208，仓库 feely0208/dsh-deliverable-pack，在社区目录中归类为工作流。当前 package 版本为 0.1.0，许可证 MIT。

一句话定位：把指定目录下的产出物打成可核对、可追溯的交付物——`zip + 文件清单 + SHA256 校验**。律师交证据、设计师交稿、顾问交报告等场景，对方拿到的是能校验的包，而不是散文件。

核心功能¶

根据 README 与 package 说明，插件提供：

1. 打包与清单：在输出目录生成 <名称>/，内含 files/（保留相对路径）、MANIFEST.json（路径、字节数、SHA256、mtime）、CHECKSUMS.sha256（可用 shasum -a 256 -c 核对）、交付说明.md，以及 <名称>.zip。
2. 过滤与跳过：默认只收常见办公与图片后缀，可用 --exts 覆盖；自动跳过 node_modules、.git、dist 等。
3. 校验：生成后可用 --verify 复核；README 说明篡改会被发现（测试中有对应用例）。
4. Web 面板：侧栏「深鲸交付包」，填交付目录，可选输出目录、包名、后缀过滤，生成交付包，并可「重新校验 SHA256」。
5. CLI：独立命令 dsh-deliverable-pack，适合脚本与 CI 式流程。

运行环境：dsh 版本 >=0.1.0-rc.6 <0.3.0，Node >=18；依赖 @deepwhale-cn/dsh-guard-core，面向 web profile 注入客户端。

安装与启用¶

官方安装命令如下（来自 README）：

dsh plugin --profile web add @deepwhale-cn/dsh-deliverable-pack

也可从 GitHub 源码安装：

dsh plugin --profile web add github:feely0208/dsh-deliverable-pack

安装前建议浏览仓库源码与 LICENSE，确认符合你的安全与合规要求。插件以当前 DSH 进程权限访问本机文件系统，只会读写你指定的输入与输出路径。

典型用法¶

面板¶

侧栏打开「深鲸交付包」→ 填写要交付的目录（可选输出目录、包名、后缀过滤）→ 生成交付包 → 需要时可点「重新校验 SHA256」。

命令行¶

打包结案材料并命名交付包：

dsh-deliverable-pack --input ./结案材料 --out ./交付 --name 张某案-结案交付

只收指定后缀、且不生成 zip：

dsh-deliverable-pack --input ./设计稿 --exts png,jpg,pdf --no-zip

对已生成交付包做复核：

dsh-deliverable-pack --verify ./交付/张某案-结案交付

产出结构¶

生成结果大致如下（名称由 --name 或面板指定）：

<名称>/
  files/...            原始产出物（保留相对路径；自动跳过 node_modules/.git/dist 等）
  MANIFEST.json        每个文件的路径 / 字节数 / SHA256 / mtime
  CHECKSUMS.sha256     shasum -a 256 -c 可直接核对
  交付说明.md           怎么核对
<名称>.zip

适用场景与注意¶

适合谁：需要把本地产出「一次性交给对方且对方能自证完整性」的开发者或知识工作者；与 DSH 里 agent 产出的目录配合，作为交付前的最后一道归档步骤。

注意：

• 全部在本机完成，README 明确不上传任何文件。
• 默认后缀集合有限，特殊类型务必用 --exts 或面板里的后缀过滤。
• DSH 生态是「一切皆插件」；社区目录（如 SkillHub）是独立站点，与 DeepSeek / 幻方无官方从属关系，本文仅介绍该插件能力，不视为官方应用商店条目。

结尾¶

深鲸交付包把「清单 + 哈希 + 可选 zip」固定成同一套结构，减少手工核对成本。安装与用法以仓库 README 为准。

• 目录页：https://www.skillhub.cn/plugins/feely0208/dsh-deliverable-pack
• GitHub：https://github.com/feely0208/dsh-deliverable-pack