前言¶
做外贸或出口相关工具时，装柜测算和报价单、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。
