前言¶
在 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 剪貼板投遞，減少「文件在哪、怎麼發給同事」的手動步驟。
