前言¶
做外貿或出口相關工具時，裝櫃測算和報價單、PI、報關類單證往往分散在獨立網頁或本地 HTML 裏，和 DeepSeek Harness（DSH）的 Web UI 不在同一入口。每次切換窗口、單獨維護賣方抬頭和草稿，和「在 Harness 裏統一操作」的預期也不一致。下面介紹社區插件 demian-trade-suite-dsh-plugin（npm 包名 dsh-plugin-demian-trade-suite）：把已有的外貿單證、裝櫃計算與報價工作臺接到 DSH 左側欄，在同源 iframe 中運行，而不重寫整套單證與打印邏輯。
這是什麼¶
維護者爲 southcul，在 SkillHub 社區目錄中歸類爲工作流。插件簡介爲：DeepSeek Harness plugin: foreign-trade documents and container-loading workbench（DSH 面板，承載離線外貿單證與裝櫃工作臺）。當前 npm 版本爲 1.0.1，許可證 MIT。它解決的是「在 DSH Web GUI 內打開完整工作臺」，而不是替代 Agent 側自動出單能力——後者需另裝 demian-trade-suite 技能倉庫。
核心功能¶
裝櫃計算¶
支持櫃型 20GP / 40GP / 40HQ / 45HQ 以及 4.2–7.6 米貨車；可多貨物、包裝填充、堆碼/承壓、擺放方向、間隙、整托等約束。輸出包括 CBM、毛淨重、裝載率、重量飽和度、重心偏移、底層壓強等指標。
裝櫃動畫¶
按當前方案逐層播放；HUD 顯示櫃型、總箱數、箱規、層數與箱數，支持暫停、繼續、重播。
外貿單證¶
覆蓋報價單、PI、CI、銷售合同、裝箱單、出口報關單、代理報關委託書；提供 A4 實時預覽、整套打印、金額大寫、定金/尾款拆分。
賣方信息與導出¶
公司抬頭、地址、稅號、銀行、Logo、公章、簽名可集中填寫，保存後新建訂單自動帶出。可導出裝櫃方案 PDF、單證 PDF、草稿 JSON。
安裝與啓用¶
從 npm¶
dsh plugin --profile <profile> add dsh-plugin-demian-trade-suite
或在 DSH 桌面端：Settings → Plugins，搜索 dsh-plugin-demian-trade-suite 安裝。刷新 DSH Web GUI 後，左側欄會出現 「外貿工作臺」。
從 GitHub Release（README 標註爲推薦）¶
- 在 最新 Release 下載
demian-trade-suite-dsh-plugin.zip - 解壓得到
demian-trade-suite-plugin/目錄 - 在 DSH Plugin Manager → 安裝本地 bundle 中選擇該目錄
- 刷新 Web GUI，確認左側欄出現 「外貿工作臺」
從源碼¶
在 Plugin Manager 中選擇倉庫根目錄安裝 bundle 並刷新頁面（README 亦給出 clone 地址，安裝步驟以 Manager 選目錄爲準）。
典型用法¶
點擊左側欄 「外貿工作臺」，中間欄打開完整工作臺：
- 頂部在 裝櫃計算 / 外貿單證 之間切換。
- 裝櫃頁可 載入示例 或 開始計算 播放動畫。
- 單證頁頂部 賣方信息 填一次並保存，之後自動帶出。
- 單證頁右上角 預覽並打印 A4 單據。
插件運行在 DSH 的 origin（默認 http://127.0.0.1:13807）。若曾直接雙擊 standalone 的 workbench.html（file:// origin），其 localStorage 與插件版不共享；遷移時用舊版 導出 草稿，再在插件版 導入（賣方信息含在草稿中）。切換到其他側欄頁面時 iframe 會卸載，工作臺會自動保存草稿，返回後恢復。
適用場景與注意¶
適合需要在 DSH 同一 Web 界面裏做裝櫃試算、單證預覽與打印的外貿/出口相關開發者或操作者。社區目錄 SkillHub 插件頁 與 GitHub 倉庫由社區維護，與 DeepSeek / 幻方無官方從屬關係；安裝前建議閱讀源碼與 MIT 許可證。插件以當前 dsh 進程權限 在本地 Web 服務上提供 /plugins/demian-trade-suite/workbench.html（Host 半 index.js + Client 半 client.js，工作臺本體爲打包的 assets/workbench.html）。若目標是完全貼合 DSH 主題的原生 React 面板，README 說明需後續把工作臺拆成組件，當前版本以同源 iframe 作爲兼容層。
結尾¶
demian-trade-suite-dsh-plugin 把裝櫃計算、動畫與成套外貿單證工作臺接入 DSH 側欄，安裝後即可在 Harness Web UI 內完成典型測算與 A4 打印流程。詳情與 Release 見 GitHub，目錄索引見 SkillHub。
