Smart Trade AI

外贸业务员的本地 AI 助手

Windows / macOS 安装教程 · 不需要懂技术，跟着步骤走，20 分钟装好

安装遇到问题？扫码加微信，备注「Trade」

🚫 禁止用 workbuddy 等国产 AI 助手安装 Trade

已有多位用户这样装，结果都是同一个：助手回报「安装成功」，实际完全不能用。更麻烦的是它还会生成错误的公司文件夹，残留下来后很难清理干净。

原因：这类助手不了解本项目的安装依赖（Hermes 必须是指定来源的可编辑检出、Trade 必须用 --no-deps 安装、装完还要同步 skills 与初始化数据库），步骤做错了却照样报告成功，所以表面看不出问题。

要 AI 代装，建议用 Hermes（见下面的安装步骤）。换其它 AI 助手前，请先确认它愿意严格按本页步骤执行 —— 上面那类问题，都是助手自己发挥了、做错了还照样报成功造成的。不想让 AI 装的话，对着下面的步骤手动做即可。

这个工具能帮你做什么？

你平时的麻烦	用了这个工具之后
每天打开好几个网站查汇率、金价、新闻	每天早上自动生成一份简报，汇率、行情、客户提醒全在里面
想了解一个新客户靠不靠谱，不知道从哪查	输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项
给客户写开发信，每封都要重新想	告诉它客户是做什么的，它帮你写好开发信
阿里国际站、中国制造网要每天登录看有没有新询盘	它定时帮你检查，有新的就提醒你
客户资料散落在微信、Excel、邮件里，找起来费劲	统一管理，按重要程度分 A/B/C 级，还能关联合同文件
不知道 LinkedIn 该发什么内容	每周帮你规划好要发什么，轮换不同话题

macOS 安装

如果你用的是 Mac 电脑，按以下步骤操作。

第一步：确保科学上网已启动

这个工具需要从 GitHub 下载代码。在开始之前，必须先打开你的科学上网工具（VPN / Clash / V2Ray 等），确保网络通畅。

验证方法： 打开浏览器，在地址栏输入 github.com，回车。如果页面能正常打开，说明网络没问题，可以继续。

第二步：注册 DeepSeek 并获取 API Key

用浏览器打开 platform.deepseek.com
点击「注册」，用手机号注册一个账号
登录后，点击「充值」，充值 20 元以上（按用量扣费，20 块钱能用很久）
在左侧菜单找到「API Keys」，点击进入
点击「创建 API Key」，名称填 trade，点确定
页面上会显示一串字符（以 sk- 开头）——这就是你的 DeepSeek API Key
立刻复制保存，关掉后就再也看不到了

第三步：注册 Tavily 并获取 API Key（建议）

Tavily 是联网搜索引擎，让 AI 能搜索实时信息。

用浏览器打开 tavily.com
点击「Sign Up」，用 Gmail 邮箱注册
登录后进入 Dashboard，在 API Keys 区域找到你的 Key（以 tvly- 开头）
复制保存到记事本里

Tavily 每月有 1000 次免费搜索额度，个人使用足够了。不注册不影响对话功能，但搜索和客户背调质量会受明显影响。

第四步：检查 Python 架构（M 芯片 Mac 必须看）

如果你是 M1/M2/M3/M4 芯片的 Mac，先确认 Python 是原生 arm64 版本：

python3 -c "import platform; print(platform.machine())"

如果输出 arm64，继续下一步。如果输出 x86_64，说明你用的是 Rosetta 转译的 Python，必须先换成原生版本：

# 安装原生 arm64 Python
brew install python@3.11
# 确保用 Homebrew 的 Python
export PATH="/opt/homebrew/bin:$PATH"

如果用 Rosetta Python，Hermes 的 C 扩展会加载失败，导致 Trade 无法启动。

第五步：安装 Hermes Agent（AI 引擎）

Hermes Agent 是驱动 AI 的底层引擎，Trade 基于它运行。

打开「终端」（在 Launchpad 或 Spotlight 搜索”终端”），粘贴以下命令：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

等待几分钟，看到「安装完成」提示即可。

如果安装过程中卡在 “Installing Node.js dependencies (browser tools)”，按 Ctrl+C 终止，不影响 Trade 使用。

📌 不用另外装 Python。 Hermes 会自带一个 Python 3.14，Trade 直接用它 —— 两者必须用同一个 Python 大版本才能配合工作（第八步安装 Trade 时脚本会自动找到它）。也不要手动把某个 Hermes 版本克隆到 ~/.hermes/hermes-agent 覆盖掉这份安装。

第六步：配置 Hermes（大模型 + 搜索）

在终端输入：

hermes setup

出现交互配置界面后：

用键盘 上下方向键 选择「DeepSeek」→ 按回车
选择模型时，选「deepseek-flash」→ 按回车
粘贴你的 DeepSeek API Key → 按回车
搜索服务选「Tavily」→ 按回车
粘贴你的 Tavily API Key → 按回车

看到「配置成功」提示就完成了。

第七步：验证 Hermes 是否正常

在终端输入：

hermes

等它启动后，在对话框里输入 hello，按回车。如果 AI 正常回复了，说明大模型配置成功。按 Ctrl+C 退出。

第八步：让 AI 帮你安装 Trade

重新启动 Hermes（输入 hermes），在聊天框里复制粘贴下面这句话：

请帮我安装 trade，地址是 https://github.com/chefroger/smart-trade-ai

AI 会自己去 GitHub 查看项目说明，然后自动执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。

装完后，关闭终端，重新打开一个，输入：

trade

浏览器会自动打开 Trade 界面。如果没有自动打开，手动访问 http://127.0.0.1:9119/trade。

第九步：设置 Hermes Gateway 开机自启（可选）

如果希望开机后定时任务（每日简报等）能自动运行，在终端执行：

hermes gateway install

这会安装一个 macOS 后台服务（com.foreign-trade.gateway，端口 8642），开机后自动启动 Hermes Gateway。注意：它只负责 Gateway，不包含 Trade 本体。

Trade 服务本身的开机自启由安装脚本 scripts/install.sh 单独配置（写入 ~/Library/LaunchAgents/com.trade.assistant.plist，开机静默启动 trade）。

以后的使用方式（仅对经 install.sh 安装的用户成立）：开机后等约 30 秒，Trade 与 Gateway 均已自启，直接浏览器访问 http://127.0.0.1:9119/trade 即可；若未配置 Trade 自启，仍需先手动运行 trade 再访问。

Windows 安装

如果你用的是 Windows 电脑，按以下步骤操作。

第一步：确保科学上网已启动

这个工具需要从 GitHub 下载代码，而 GitHub 在国内访问不稳定。在开始之前，必须先打开你的科学上网工具（VPN / Clash / V2Ray 等），确保网络通畅。

验证方法： 打开 Google Chrome 浏览器，在地址栏输入 github.com，回车。如果页面能正常打开，说明网络没问题，可以继续。

如果 GitHub 打不开，检查你的科学上网工具是否已启动、是否设为全局模式或 TUN 模式。

第二步：注册 DeepSeek 并获取 API Key

AI 不是免费的，需要去 DeepSeek 注册账号并充值。

用 Google Chrome 浏览器 打开 platform.deepseek.com
点击「注册」，用手机号注册一个账号
登录后，点击页面上的「充值」，充值 20 元以上（按用量扣费，20 块钱能用很久）
在左侧菜单找到「API Keys」，点击进入
点击「创建 API Key」，名称填 trade，点确定
页面上会显示一串字符（以 sk- 开头）——这就是你的 DeepSeek API Key
立刻复制保存，关掉后就再也看不到了

把这串 Key 先粘贴到记事本里，后面要用。

第三步：注册 Tavily 并获取 API Key

Tavily 是联网搜索引擎，让 AI 能搜索实时信息。

用 Google Chrome 浏览器 打开 tavily.com
点击「Sign Up」，用 Gmail 邮箱注册一个账号
登录后进入 Dashboard，在 API Keys 区域找到你的 Key（以 tvly- 开头）
复制保存到记事本里

Tavily 每月有 1000 次免费搜索额度，个人使用足够了。

第四步：在桌面创建 API Key 文件

把刚才拿到的两个 Key 整理到一个文件里，后面配置时会用到。

在桌面上右键 → 新建 → 文本文档
把文件重命名为 apikey.txt
打开文件，按以下格式粘贴：

DeepSeek API Key: <在此粘贴你的 DeepSeek Key，以 sk- 开头>
Tavily API Key: <在此粘贴你的 Tavily Key，以 tvly- 开头>

上面用尖括号表示占位——不要照抄尖括号内容，把你自己的 Key 整串替换进去即可。

保存并关闭。后面配置 Hermes 时需要从这里复制粘贴。

第五步：安装 Hermes Agent（AI 引擎）

Hermes Agent 是驱动 AI 的底层引擎，Trade 基于它运行。

5.1 以管理员身份打开 PowerShell

按键盘 Win 键，输入 powershell
右键点击搜索结果里的「Windows PowerShell」
选择「以管理员身份运行」
弹出提示问”是否允许此应用对设备进行更改”，点「是」

5.2 开启长路径支持

在 PowerShell 里粘贴下面这行命令，按回车：

New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force

5.3 一键安装 Hermes

接着执行下面这行命令：

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

等待几分钟，看到「安装完成」提示即可。

在 PowerShell 里粘贴的方法是点一下鼠标右键（不是 Ctrl+V）。

📌 不用另外装 Python。 Hermes 会自带一个 Python 3.14，Trade 直接用它 —— 两者必须用同一个 Python 大版本才能配合工作（第八步安装 Trade 时脚本会自动找到它）。也不要手动把某个 Hermes 版本克隆到 ~\.hermes\hermes-agent 覆盖掉这份安装。

第六步：配置 Hermes（大模型 + 搜索）

安装完成后，在同一个 PowerShell 窗口输入：

hermes setup

这时会出现交互配置界面，按以下步骤操作：

用键盘的 上下方向键 选择「DeepSeek」→ 按回车
选择模型时，选「deepseek-flash」→ 按回车
粘贴你的 DeepSeek API Key（从桌面的 apikey.txt 复制）→ 按回车
搜索服务选「Tavily」→ 按回车
粘贴你的 Tavily API Key → 按回车

看到「配置成功」提示就完成了。

第七步：验证 Hermes 是否正常

在 PowerShell 里输入：

hermes

等它启动后，在对话框里输入：

hello

按回车发送。如果 AI 正常回复了，说明大模型配置成功。

按 Ctrl+C 可以退出 Hermes，回到命令行。

第八步：让 AI 帮你安装 Trade

重新启动 Hermes（输入 hermes），在聊天框里复制粘贴下面这句话：

请帮我安装 trade，地址是 https://github.com/chefroger/smart-trade-ai

AI 会自己去 GitHub 查看项目说明，然后自动执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。

装完后，关闭当前 PowerShell，重新打开一个新的，输入：

trade

浏览器会自动打开 Trade 界面。如果没有自动打开，手动访问 http://127.0.0.1:9119/trade。

验证能用后，按 Ctrl+C 退出 trade（暂时退出，下一步设置开机自启后会自动运行）。

第九步：设置 Hermes Gateway 开机自启

Hermes Gateway 是定时任务调度器，Trade 的定时简报、定时询盘检查都依赖它。必须让它随系统启动，否则每天还要手动开。

在 PowerShell 里执行：

hermes gateway install

看到「服务已安装」或类似提示即成功。以后开机时 Hermes Gateway 会自动在后台运行，无需手动启动。

验证是否装好：按 Win+R，输入 services.msc，回车。在列表里找到「Hermes Gateway」服务，状态应为「正在运行」。

第十步：开机自启与桌面快捷方式（已自动完成）

这一步正常情况下不需要你做。 首次运行 trade 时，程序会自动完成：

在 %LOCALAPPDATA%\trade\ 生成隐藏窗口启动器（trade-autostart.bat + .vbs）
注册登录自启的计划任务 SmartTradeAI（不弹终端窗口）
在桌面创建 Trade 快捷方式（双击 = 启动服务并打开界面）
清理旧版遗留的、会弹终端窗口的自启方式

快捷方式双击后的行为：服务没跑就先在后台静默启动；如果浏览器里已经开着 Trade 页面，就把那个窗口切到前台（不会重复开标签页）；没开才新开。浏览器不向外部程序暴露「聚焦已有标签页」的能力，所以这是按窗口标题找回的。

启动日志在 %LOCALAPPDATA%\trade\trade-autostart.log（隐藏窗口后看不到控制台，出问题看这个文件）。

想跳过这套自动配置（例如你有自己的启动方式）：设环境变量 TRADE_SKIP_AUTOSTART_SETUP=1。

从旧版本升级上来的机器若曾用手动方案配过，程序会自动把注册表里的旧自启项清掉并改用计划任务，不会双重启动。

手动配置（仅在自动配置失败时使用）

先运行一次 trade 并确认界面能打开，然后按下面做。

10.1 创建启动器脚本

$tradeExe = (Get-Command trade -ErrorAction Stop).Source
$dir = "$env:LOCALAPPDATA\trade"
$bat  = "$dir\trade-autostart.bat"
$vbs  = "$dir\trade-autostart.vbs"
$log  = "$dir\trade-autostart.log"
New-Item -ItemType Directory -Force -Path $dir | Out-Null

@"
@echo off
"$tradeExe" --no-browser > "$log" 2>&1
"@ | Out-File -FilePath $bat -Encoding OEM

@"
Set WshShell = CreateObject("WScript.Shell")
WshShell.Run "cmd /c ""$bat""", 0, False
"@ | Out-File -FilePath $vbs -Encoding OEM

用 -Encoding OEM 而不是 -Encoding ASCII：后者会把中文用户名路径里的非 ASCII 字符静默替换成 ?，写出来的启动器直接失效（早期教程栽在这里）。

10.2 注册登录自启（计划任务，隐藏窗口）

schtasks /create /tn SmartTradeAI /sc onlogon /rl limited /f /tr "wscript.exe \"$env:LOCALAPPDATA\trade\trade-autostart.vbs\""

10.3 创建桌面快捷方式

桌面上只应有一个 Trade.lnk 快捷方式，不要放 .vbs / .bat 文件 —— 启动器脚本都在 %LOCALAPPDATA%\trade\ 下，快捷方式只是指向它们。直接把 .vbs 拖到桌面会多出一个可执行文件，既容易被误删，也可能被杀软拦截。

$ws = New-Object -ComObject WScript.Shell
$lnk = "$([Environment]::GetFolderPath('Desktop'))\Trade.lnk"
$sc = $ws.CreateShortcut($lnk)
$sc.TargetPath = "wscript.exe"
# 注意指向 trade-open.vbs（打开界面），不是 trade-autostart.vbs（那个只启动服务、
# 不开浏览器）—— 早期文档写错了这一处，照抄会得到"启动了但页面不弹"的快捷方式
$sc.Arguments = "\"$env:LOCALAPPDATA\trade\trade-open.vbs\""
$sc.Description = "打开 Trade 外贸 AI 助手"
$sc.Save()

10.4 验证

执行 wscript.exe "$env:LOCALAPPDATA\trade\trade-autostart.vbs"，等约 15 秒，访问 http://127.0.0.1:9119/trade。能看到界面、且没有弹出终端窗口即为正确。

打不开就看 %LOCALAPPDATA%\trade\trade-autostart.log。最常见的是 ModuleNotFoundError，说明 trade 没装好。

10.5 取消开机自启

schtasks /delete /tn SmartTradeAI /f

（若曾按早期教程配过注册表方式，再执行：Remove-ItemProperty -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\Run" -Name "TradeAutoStart" -Force）

如何更新 Trade

Trade 会持续更新，新版本增加功能和修复问题。最简单的方式是让 AI 帮你更新：

按 Win+R，输入 powershell，回车
输入 hermes 启动 Hermes
在对话框里输入：

帮我更新trade，并重启trade，地址是https://github.com/chefroger/smart-trade-ai

等 AI 执行完毕，看到「重启完成」提示后，刷新浏览器页面（Ctrl+Shift+R）即可。

如果 hermes 命令找不到，说明 Hermes 没装好，回到第五步重装。

自检（装完或出问题时先跑这个）

Trade 装好后首次启动会自动做一次自检，检查四项：Hermes 运行环境、图片识别（原生 vision）、Tavily 搜索、Trade 自身（数据库 + 一次真实对话）。结果会打印在启动日志里，也会出现在 http://127.0.0.1:9119/api/status 的 doctor 字段中。

想手动再跑一次（推荐在「对话没反应」「图片读不出来」「搜索不工作」时先跑它）：

trade doctor

输出形如：

══ Trade 自检 ══
  ✓ Hermes 版本: 0.21.7（要求 >=0.13.0,<0.22.0）
  ✓ Agent 构造: run_agent.AIAgent
  ✓ 急停状态（ESTOP）: 未处于急停状态，定时任务正常调度
  ✓ holehe（邮箱注册检测）: 已安装，Layer 1 可用
  ⚠ Hindsight（长期记忆）: 未安装/未配置：记忆降级为会话内（不阻断）
  ✓ sqlite-vec（语义检索）: 可用：客户/文档支持语义搜索
  ⚠ sentence-transformers: 未安装：使用内置 TF-IDF 后端（离线可用，改写查询召回稍弱）
  ✓ vision 工具在场: vision_analyze 在工具表中
  ✓ vision 读图: deepseek-flash 正确读出探测文字
  ✓ Tavily 搜索: 搜索可用
  ✓ 数据库: 可读写
  ✓ 对话回合: 收到回复（1.5s）

  ⚠ 2 项降级（功能打折但可用）

它是端到端验活，不是”看配置对不对”：图片那项会真的生成一张写着随机验证码的图发给模型、看它能否读出来；对话那项会真的走一次问答。所以它能发现”配置看着都对但实际调不通”的问题（例如搜索被网络拦截、所选模型其实不支持看图）。

标 ⚠ 的是可选能力层，缺了不影响主流程（安装脚本会自动装 sqlite-vec 与 holehe； sentence-transformers 属可选项，装了更好、不装自动降级）。

自检只在首次启动跑；没通过则每次启动重试，直到修好为止（所以改完配置重启即可自动恢复）。跑一次约花极少量 token 和一次 Tavily 配额。

装完后没通过的项会显示 ✗ 与原因。✗ 分两种：标「无法正常使用」的是致命项（必须先修），标「功能不可用」的不影响基本使用。

常见问题

你看到的现象	怎么解决
打开 Trade 后满屏提示「正在升级 Hermes」	这是正常的，不用管它。说明你电脑上的 Hermes 版本太旧（低于 0.21.6），Trade 正在自动帮你升级。升级需要能访问 GitHub，所以请确认科学上网已开启；升级期间不要关闭 Trade，等它跑完会自动重启，之后就能正常用
上面的升级进度停在「需要先开启代理」	电脑连不上 GitHub。开启科学上网（VPN）后，点界面上的「重试升级」按钮
上面的升级提示「升级失败」	多半是网络中途断了。确认科学上网正常后点「重试升级」；反复失败就把界面上的日志复制发给技术支持
第五步安装 Hermes 卡住不动	科学上网没开好。确认 VPN 是全局模式，关掉 PowerShell 重开再试
`hermes` 输入后提示「不是内部或外部命令」	关掉 PowerShell 重新打开一个新的
`trade` 输入后提示「不是内部或外部命令」	改成输入 `cd $env:LOCALAPPDATA\trade\foreign-trade-assistant` 然后 `python server.py`
任何功能不对劲	先跑 `trade doctor` —— 它会端到端验活并指出是哪一项坏了（见「自检」一节）
Hermes 对话没反应	API Key 没配置对。重新运行 `hermes setup` 检查
浏览器打开显示「无法访问此网站」	程序没在运行。打开一个新的 PowerShell，输入 `trade` 启动
开机后访问 127.0.0.1:9119/trade 打不开	Trade 自启还没跑完，等 30 秒再试。若仍不行，打开 `%LOCALAPPDATA%\trade\trade-autostart.log` 看错误日志；或按 `Win+R` 输入 `taskmgr` 回车，看进程里有没有 `python.exe`，没有就手动运行第十步的 VBS 脚本
定时任务（每日简报等）不执行	第九步的 Hermes Gateway 没装好或没运行。重新执行 `hermes gateway install`，再到 `services.msc` 确认服务状态
收不到桌面 Trade 图标	首次运行 `trade` 时自动创建；被删了的话重启一次 Trade 会重新生成，仍没有就按第十步手动创建
登录后弹出黑色终端窗口	自启任务还是旧版（直接跑 python.exe）。重启一次 Trade 会自动换成隐藏窗口版本；没换掉就按第十步手动重建计划任务
提示「Filename too long」	第五步的长路径设置没做。回到 5.2 执行那行命令，然后重启电脑
M 芯片 Mac 启动 Trade 报错 (Mach-O / 422)	用了 Rosetta 转译的 Python。按 macOS 第四步检查 Python 架构，切换到原生 arm64 Python

Smart Trade AI — 外贸业务员的本地 AI 助手
GitHub · Releases

Skills 参考手册

Trade 会自动识别你的意图，匹配合适的技能。以下是全部 39 个技能的详细说明和使用示例。

39 个技能速查

#	技能	功能	典型提示词示例
1	b2b-osint	客户背景调查（6 层检测）	帮我查一下这家公司 / 背调这个邮箱 / 查一下域名注册时间
2	b2b-email-intel	邮箱情报（120+ 平台检测）	查一下这个邮箱哪个平台注册了 / 邮箱是真的吗
3	b2b-lead-generation	多通道客户搜索与开发	帮我找一下德国的 XX 产品客户 / 写一封开发信给美国客户
4	b2b-document	本地文档分析与提取	分析一下这份报价单 / 帮我看看这个合同有什么问题
5	b2b-doc-generation	生成报价/合同/提案文件	帮我生成一份 PDF 报价单 / 做一份产品介绍 PPT
6	b2b-platform	B2B 平台店铺诊断优化	帮我看看这个阿里国际站产品页 / 优化一下产品标题
7	b2b-linkedin-marketing	LinkedIn 营销策略与内容	帮我想一下领英发什么内容 / 写一条领英连接邀请留言
8	b2b-social-media	社媒营销（FB/Ins/TikTok/YT）	帮我做一个 Facebook 内容计划 / 写一个 TikTok 脚本
9	b2b-customs-data	海关数据分析找采购商	帮我看看谁在进口这个产品 / 分析一下这个 HS 编码
10	b2b-onboarding	新公司全套部署方案	我刚做外贸，帮我制定一个营销方案 / 新公司怎么开始
11	b2b-daily-automation	定时任务（早报/晚报/周报）	每天早上 8 点给我一份简报 / 设置一个每日工作总结
12	b2b-customer-mgmt	客户档案与分级管理	帮我查一下 XX 公司的信息 / A 级客户有哪些
13	b2b-data-directory	数据目录结构管理	我的数据存在哪了 / 帮我初始化一下数据目录
14	chat-memory	历史对话查询	上次和 XX 公司聊到什么了 / 之前那份报价是多少
15	b2b-skill-generator	动态创建新的 B2B Skill	帮我创建一个新的 skill，用来查 XX
16	b2b-trade-ops	外贸履约与售后沟通	帮我写一封催款邮件 / 客户投诉质量有问题怎么办
17	b2b-trade-compliance	合规检查与文化禁忌	这个颜色在沙特有什么忌讳吗 / 检查一下 FOB 写对了没有
18	b2b-cold-outreach	冷 outreach 邮件撰写	给德国的 XX 公司写一封开发信 / 写一封产品推广信
19	auto-trade-customer-development	全自动客户开发流水线	帮我跑一轮自动化客户开发 / 全自动开发一批客户
20	~~auto-smtp-email~~	~~SMTP 邮件发送 — 已禁用~~	~~把这封开发信发出去 / 群发这批邮件~~
21	b2b-email-imitation	开发信仿写与再创作	参考这封邮件，帮我写一个类似的 / 模仿这个风格写一封开发信
22	b2b-buyer-persona	买家画像与角色分层	帮我分析一下买家画像 / 针对采购经理应该怎么沟通
23	b2b-market-analysis	市场分析作战地图	分析一下德国市场进入策略 / 帮我做一个中东市场调研
24	b2b-sales-pipeline	销售管线与跟进策略	这个客户一个月没回了怎么办 / 帮我设计一个 30 天跟进计划
25	b2b-inquiry-training	询盘回复训练	帮我练一下询盘回复 / 模拟一个刁钻买家
26	b2b-kol-imitation	KOL 风格模仿	模仿这个领英大V的风格 / 分析这个账号的内容策略
27	b2b-reddit-engagement	Reddit 社区互动	帮我在 Reddit 写一条专业评论 / 在哪个 subreddit 发帖
28	b2b-seo-aeo	SEO+AEO 文章生成	写一篇针对 AI 搜索优化的行业文章 / 帮我做 Pillar Page
29	b2b-short-video	短视频脚本生成	帮我写一个 TikTok 产品视频脚本 / 工厂参观短视频
30	b2b-exhibition	展会全流程管理	帮我写展会邀约邮件 / 展会后的跟进计划
31	b2b-product-description	产品描述生成	帮我把这款产品写成销售资料 / 用 FAB 分析产品卖点
32	b2b-six-thinking-hats	六顶思考帽决策	帮我分析这个决策 / 要不要给这个客户独家代理权
33	b2b-customer-intel	客户深度画像	帮我做一份某客户的深度画像 / 这个客户有什么偏好
34	b2b-customer-finder	客户开发向导	三问启动：卖什么→卖到哪→找谁，自动搜索生成开发信
35	b2b-inquiry-meeting	询盘分析会主持	周度复盘 / 逐人点评 / 重点询盘 / 跟进行动表
36	b2b-sales-playbook	销冠经验封装器	将销冠经验转化为SOP/话术库/新人路线/避坑清单
37	b2b-guarantee-proposal	商业提案生成器	三档方案对比 + ROI分析 + 实施路线图
38	b2b-tech-drawing	工程图纸分析（实验性）	帮我看看这张图纸 / 分析这个铸件图 / 提取图纸尺寸
39	b2b-china-leads	国内企业线索挖掘（免费渠道）	帮我找货源厂家 / 帮我找竞品国内厂家 / 开发国内客户 / 1688 上找供应商

技能自动匹配原理

当你在聊天框输入内容时，Trade 会自动匹配关键词，调用最合适的 skill。匹配规则：

词边界匹配（+3 分）：独立关键词命中，如”背调”、”开发信”、”海关数据”
子串匹配（+1 分）：关键词出现在句子中，如”帮我查一下这个公司”匹配到”查公司”
显式调用（最高优先级）：用”用 b2b-xxx” 或 “加载 skill b2b-xxx” 直接指定

注：2 个字母以内的英文缩写触发词（如 DA / BL / LC——信用证、提单、承兑交单等）只做词边界匹配，避免 “today”、”table” 这类普通单词被误判。

得分最高的 skill 会被激活。如果连续使用同一个 skill，系统会用简短的提示词继续（节省 token）。中英文提问均可正常触发对应技能。

如何查看当前激活的技能

当 Trade 匹配到一个 skill 时，在回复的开头会显示技能名称，如 [SKILL AUGMENTATION] 技能触发：b2b-osint。你也可以直接输入”用 b2b-osint 查一下这个邮箱”来强制指定某个技能。

设计理念：Trade 辅助用户梳理工作流程、生成邮件草稿、撰写文档， 但不替用户直接发送邮件/文件给客户。AI 可能出错，所有对外内容必须经用户复核确认后自主发出。auto-smtp-email 已被禁用，不会由系统触发。

技能别名

部分技能之间存在别名关联，输入一个技能名可能触发相关联的技能：

输入技能	也会触发
b2b-osint	b2b-email-intel
b2b-lead-generation	b2b-customer-mgmt
b2b-trade-ops	b2b-customer-mgmt
auto-trade-customer-development	b2b-lead-generation, b2b-osint, ~~auto-smtp-email~~

Smart Trade AI

外贸业务员的 AI 助手 — 本地运行，数据安全

Smart Trade AI

这个工具能帮你做什么？

macOS 安装

第一步：确保科学上网已启动

第二步：注册 DeepSeek 并获取 API Key

第三步：注册 Tavily 并获取 API Key（建议）

第四步：检查 Python 架构（M 芯片 Mac 必须看）

第五步：安装 Hermes Agent（AI 引擎）

第六步：配置 Hermes（大模型 + 搜索）

第七步：验证 Hermes 是否正常

第八步：让 AI 帮你安装 Trade

第九步：设置 Hermes Gateway 开机自启（可选）

Windows 安装

第一步：确保科学上网已启动

第二步：注册 DeepSeek 并获取 API Key

第三步：注册 Tavily 并获取 API Key

第四步：在桌面创建 API Key 文件

第五步：安装 Hermes Agent（AI 引擎）

5.1 以管理员身份打开 PowerShell

5.2 开启长路径支持

5.3 一键安装 Hermes

第六步：配置 Hermes（大模型 + 搜索）

第七步：验证 Hermes 是否正常

第八步：让 AI 帮你安装 Trade

第九步：设置 Hermes Gateway 开机自启

第十步：开机自启与桌面快捷方式（已自动完成）

手动配置（仅在自动配置失败时使用）

如何更新 Trade

自检（装完或出问题时先跑这个）

常见问题

Skills 参考手册

39 个技能速查

技能自动匹配原理

如何查看当前激活的技能

技能别名

相关使用指南