前言¶
在 DeepSeek Harness（DSH）里跑智能体，常见情况是：对话里已经生成了图片、文档或视频，文件却散落在项目目录里，还要自己找路径、再拖到微信或邮件里。Delivery Box（取件箱）是社区维护的 DSH 客户端插件，给所有「可交付物」一个固定收件目录，并在侧边栏用项目与会话两级分组展示，支持内联预览和一键复制到剪贴板。下面介绍它的定位、能力与安装用法。
这是什么¶
Delivery Box 由 11zz-prog 维护，归类为 DSH 客户端插件（独立社区项目，非 DeepSeek 官方产品）。它解决两件事：一是让智能体或用户把成品文件放进单一、可预期的收件文件夹；二是在 DSH Web 界面里用侧边栏面板浏览、预览，并在 Windows 上把图片或文件直接写入剪贴板，便于 Ctrl+V 粘贴到微信等应用。
插件在 README 中注明已在 DSH 0.2.1-rc.3、Windows 11 上测试；许可证为 MIT，npm 包版本 1.0.0。
核心功能¶
经过上面的定位，具体能力如下（均来自项目 README）：
-
一个文件夹收齐交付物
智能体或用户把成品放入 inbox；面板每 5 秒扫描目录，其他会话丢进来的文件会自动出现。 -
两级导航
第一级按「项目/分类」列出（名称、文件数、会话数、最后更新、缩略图等）；第二级展开该项目下文件，并按产生该文件的会话再分组，便于对照「哪次对话出了哪个文件」。 -
内联预览
图片、可 seek 的视频、音频、PDF、纯文本等可在面板内预览，无需先在外部程序打开。 -
复制到剪贴板
图片写入图像剪贴板，其余类型写入文件剪贴板，便于在微信 / Teams / 邮件里一次粘贴；另有在资源管理器中显示、打开、删除到回收站（非永久删除）等操作。 -
CLI 与 AGENTS.md 规则
提供tools/inbox.mjs与 Windows 下的tools\投递.cmd，可在工作区AGENTS.md里约定：每次产出成品后自动投递到 inbox，并可选--clip、--origin等参数。
主机端在 DSH 本地 loopback Web 服务上注册 inbox 相关 API；客户端通过 DSH 插槽注册侧边栏与主面板。剪贴板、资源管理器、回收站等能力面向 Windows 10/11；面板、分类、预览与文件浏览在任意运行 dsh Web 的环境可用。
安装与启用¶
需要 dsh 0.2+，并使用 desktop profile。
方式 A：插件 registry（推荐）
dsh plugin --profile desktop add dsh-delivery-box
若尚未发布到 npm，可从 GitHub 安装：
dsh plugin --profile desktop add git+https://github.com/11zz-prog/dsh-delivery-box.git
安装后完全重启 DSH，左侧侧边栏会出现 取件箱 / Delivery Box。
方式 B：Windows 桌面一键安装（无需 CLI）
下载 Release ZIP，解压后双击 install.cmd，再完全重启 DSH。安装器会定位 DSH home 与 profile、备份 manifest 与 lockfile、链接插件，并写入 inbox.config.json（默认收件目录为 %USERPROFILE%\取件箱）。卸载可运行 uninstall.cmd。安装器使用 DSH 自带的 Node，无需单独安装 Node.js 或管理员权限。
卸载 registry 安装：
dsh plugin --profile desktop remove dsh-delivery-box
配置收件目录¶
inbox 路径按以下顺序解析：
- 环境变量
DSH_INBOX_DIR - 插件目录旁的
inbox.config.json，例如{ "inboxDir": "D:\\Inbox" } - 默认
%USERPROFILE%\取件箱
修改配置或环境变量后需重启 DSH。
典型用法¶
让智能体自动投递¶
在工作区 AGENTS.md 中加入规则，使每次会话在产出成品后执行投递（路径以本机插件目录为准）：
## Delivery inbox: file every deliverable
After producing a finished file (image / video / document / report / audio / archive), run:
& "<plugin dir>\tools\投递.cmd" add <file> --origin "<this conversation or project>" --clip --json
- --origin: the conversation/project that produced it (the panel groups by it; do not omit)
- --clip: also put it on the clipboard (images → image clipboard, others → file clipboard)
- --link: hard-link large videos instead of copying (same volume; falls back to a copy)
未使用安装器时，可改为 node <plugin dir>\tools\inbox.mjs …。完整模板见仓库 docs/AGENTS-snippet.md。
CLI 子命令¶
inbox.mjs add <file> [--name "new name"] [--clip] [--reveal] [--link] [--origin "conversation"] [--project "project"] [--json]
inbox.mjs list [--json]
inbox.mjs copy [name|latest] [--mode auto|image|file] [--json]
inbox.mjs reveal [name|latest]
inbox.mjs tag [name|latest] --origin "conversation" [--project "project"] [--json]
inbox.mjs open
add 会将文件复制进 inbox（重名自动加 -2）；--link 在同卷上使用硬链接，适合大体积视频。来源信息保存在 inbox 内隐藏的 .origins.json，供面板分组使用。
适用场景与注意¶
适合谁： 经常在 DSH 里让智能体生成图片、文档、音视频，又希望「所有成品在一个地方、按项目与会话看清来源、少开文件夹、少点文件选择器」的 Windows 桌面用户；Web 侧浏览与预览不依赖 Windows 剪贴板能力。
安全与权限： 插件以当前 dsh 进程权限运行。inbox API 注册在本地 loopback，无鉴权，任何本机进程都可调用；不要将 DSH Web 端口或隧道暴露到公网。插件仅读写 inbox 目录、剪贴板与资源管理器相关操作，删除进回收站，不上传数据。复制进 inbox 会 duplicate 文件（除非 --link）；硬链接条目共享同一磁盘文件。
安装前： 社区插件目录（如 SkillHub 插件页）为独立站点，与 DeepSeek / 幻方无官方从属关系。安装前应自行查看 GitHub 源码 与 MIT 许可证，确认符合你的环境与合规要求。
结尾¶
Delivery Box 把 DSH 智能体的成品收进一个可配置的收件箱，用侧边栏按项目与会话组织，并配合预览与 Windows 剪贴板投递，减少「文件在哪、怎么发给同事」的手动步骤。
