dsh-trade-assistant

Readme

# dsh-trade-assistant 外贸助手

DeepSeek Harness（dsh）外贸场景工具插件：**询盘回复** 与 **多语言产品文案**。

> Everything is a plugin —— 这是给 dsh 生态补上「外贸」空白的插件。规则驱动、零模型依赖、无外部 API 调用、不烧 token，装上就能用。

## 功能

### 工具一：`trade_inquiry_reply` 询盘回复助手

粘贴客户询盘原文，自动完成：

- **询盘类型判断**：具体采购 / 比价索取价目表 / 样品需求 / 代理分销申请 / 市场开发泛询价 / 钓鱼诈骗
- **关键字段提取**：数量、金额线索、交期要求、付款方式（T/T、L/C 等）、规格线索、客户地区、客户身份线索（贸易商/政府招标/院校/制造商）
- **回复结构建议**：按询盘类型给出针对性策略与分步回复大纲
- **发出前检查清单**：时效、报价要素、附件规范、下一步动作等
- **风险提示**：钓鱼/诈骗特征（预付费、西联汇款、可疑链接附件）分级告警

### 工具二：`product_copy_multilang` 多语言产品文案

输入产品名称与卖点，输出 **13 种语言**（中、英、西、法、德、阿、俄、葡、日、韩、越、泰、印尼）的文案骨架：

- 标题备选（3 条，本地化句式）
- 核心卖点（与产品卖点对齐）
- 五段式描述结构（钩子 → 痛点 → 方案 → 信任证据 → 行动号召），每段附本地化素材
- 本地化注意点：数字格式（1.234,56 等）、语气（西语 usted、日语敬语）、市场禁忌（中东宗教敏感词）、B2B 信任词

## 安装

```bash
# 方式一：npm 包
dsh plugin --profile web add dsh-trade-assistant

# 方式二：GitHub 仓库（无构建步骤，纯 JS 直装）
dsh plugin --profile web add github:xiong18166089606-design/dsh-trade-assistant
```

验证是否加载：

```bash
dsh --profile web --dump-config | grep trade-assistant
```

## 使用示例

在 dsh Web UI 会话中：

```
用 trade_inquiry_reply 处理这封询盘：
"Dear Sir, we are an import company in Nigeria and need 500 pcs of your
solar panel 550W, please quote best price with delivery to Lagos port.
Payment by T/T."
```

```
用 product_copy_multilang 给我们的矿机产品写西语和阿拉伯语文案：
产品：BTC 矿机 S21，卖点：能效比 15J/TH；支持 220V 家用电压；质保 12 个月
```

## 工作原理

两个工具均为**规则引擎**：内置外贸行业知识（询盘类型特征、关键字段正则、13 语言本地化素材库），执行时**不发起任何 LLM 调用**，输出结构化骨架供主模型撰写最终文本。因此：

- 零 token 消耗、零延迟、零外部依赖
- 输出确定性强，可单测、可审计
- 询盘类型与风险识别逻辑完全透明（命中关键词可见）

## 为什么做外贸场景插件

dsh 生态 2026-08 起爆发式增长，但插件集中在开发工具、UI 主题、模型适配，**外贸场景（询盘、多语言文案）几乎是空白**。中国外贸从业者使用 dsh 时缺少开箱即用的行业工具，本插件即为此设计。欢迎提交 Issue/PR 补充更多语言与场景（如信用证审核、货代询价、展会跟进）。

## 开发

```bash
# 本地调试
pnpm dsh web --patch ./cordis.yml   # 或 dsh --patch ./cordis.yml

# 单元测试（Node 直接跑，无需 dsh）
node --test test/
```

## 许可证

MIT