1 line
461 KiB
JSON
1 line
461 KiB
JSON
{"repo": "chefroger/smart-trade-ai", "files": {"docs/index.md": {"046b396a24aa373b1aecdfc25c3f0a667e000568": {"t": 1785747384.1417005, "n": 11895, "h": "19353ab52ca80f72", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n .step-num { display:inline-block; width:32px; height:32px; line-height:32px;\n text-align:center; background:#2563EB; color:#fff; border-radius:50%;\n font-weight:bold; font-size:16px; margin-right:8px; }\n .step-title { font-size:1.3rem; font-weight:bold; margin:1.5rem 0 0.5rem; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">Windows 版安装教程 · 不需要懂技术，跟着步骤走，20 分钟装好</p>\n</div>\n\n<div style=\"text-align:center; margin:1rem 0;\">\n <p style=\"color:#8b949e; margin-bottom:0.5rem;\">安装遇到问题？扫码加微信，备注「Trade」</p>\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"180\" style=\"border-radius:8px;\">\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n## 第一步：确保科学上网已启动\n\n这个工具需要从 GitHub 下载代码，而 GitHub 在国内访问不稳定。在开始之前，**必须先打开你的科学上网工具**（VPN / Clash / V2Ray 等），确保网络通畅。\n\n**验证方法：** 打开 **Google Chrome 浏览器**，在地址栏输入 `github.com`，回车。如果页面能正常打开，说明网络没问题，可以继续。\n\n> 如果 GitHub 打不开，检查你的科学上网工具是否已启动、是否设为**全局模式**或 **TUN 模式**。\n\n---\n\n## 第二步：注册 DeepSeek 并获取 API Key\n\nAI 不是免费的，需要去 DeepSeek 注册账号并充值。\n\n1. 用 **Google Chrome 浏览器** 打开 **platform.deepseek.com**\n2. 点击「注册」，用手机号注册一个账号\n3. 登录后，点击页面上的「**充值**」，**充值 10 元以上**（按用量扣费，10 块钱能用很久）\n4. 在左侧菜单找到「**API Keys**」，点击进入\n5. 点击「**创建 API Key**」，名称填 `trade`，点确定\n6. 页面上会显示一串字符（以 `sk-` 开头）——这就是你的 **DeepSeek API Key**\n7. **立刻复制保存**，关掉后就再也看不到了\n\n> 把这串 Key 先粘贴到记事本里，后面要用。\n\n---\n\n## 第三步：注册 Tavily 并获取 API Key\n\nTavily 是联网搜索引擎，让 AI 能搜索实时信息。\n\n1. 用 **Google Chrome 浏览器** 打开 **tavily.com**\n2. 点击「Sign Up」，**用 Gmail 邮箱注册**一个账号\n3. 登录后进入 Dashboard，在 API Keys 区域找到你的 Key（以 `tvly-` 开头）\n4. **复制保存**到记事本里\n\n> Tavily 每月有 1000 次免费搜索额度，个人使用足够了。\n\n---\n\n## 第四步：在桌面创建 API Key 文件\n\n把刚才拿到的两个 Key 整理到一个文件里，后面配置时会用到。\n\n1. 在桌面上**右键** → 新建 → 文本文档\n2. 把文件重命名为 `apikey.txt`\n3. 打开文件，按以下格式粘贴：\n\n```\nDeepSeek API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nTavily API Key: tvly-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\n4. 保存并关闭。后面配置 Hermes 时需要从这里复制粘贴。\n\n---\n\n## 第五步：安装 Hermes Agent（AI 引擎）\n\nHermes Agent 是驱动 AI 的底层引擎，Trade 基于它运行。\n\n### 5.1 以管理员身份打开 PowerShell\n\n1. 按键盘 **Win 键**，输入 `powershell`\n2. **右键点击**搜索结果里的「Windows PowerShell」\n3. 选择「**以管理员身份运行**」\n4. 弹出提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n\n### 5.2 开启长路径支持\n\n在 PowerShell 里粘贴下面这行命令，按回车：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n### 5.3 一键安装 Hermes\n\n接着执行下面这行命令：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n等待几分钟，看到「安装完成」提示即可。\n\n> 在 PowerShell 里粘贴的方法是**点一下鼠标右键**（不是 Ctrl+V）。\n\n---\n\n## 第六步：配置 Hermes（大模型 + 搜索）\n\n安装完成后，在同一个 PowerShell 窗口输入：\n\n```\nhermes setup\n```\n\n这时会出现交互配置界面，按以下步骤操作：\n\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」→ 按回车\n2. 选择模型时，选「**deepseek-v4-flash**」（即 DeepSeek V4 Flash）→ 按回车\n3. 粘贴你的 **DeepSeek API Key**（从桌面的 `apikey.txt` 复制）→ 按回车\n4. 搜索服务选「**Tavily**」→ 按回车\n5. 粘贴你的 **Tavily API Key** → 按回车\n\n看到「配置成功」提示就完成了。\n\n---\n\n## 第七步：验证 Hermes 是否正常\n\n在 PowerShell 里输入：\n\n```\nhermes\n```\n\n等它启动后，在对话框里输入：\n\n```\nhello\n```\n\n按回车发送。如果 AI 正常回复了，说明大模型配置成功。\n\n> 按 `Ctrl+C` 可以退出 Hermes，回到命令行。\n\n---\n\n## 第八步：让 AI 帮你安装 Trade\n\n重新启动 Hermes（输入 `hermes`），在聊天框里**复制粘贴**下面这句话：\n\n```\n请帮我安装 trade，地址是 https://github.com/chefroger/smart-trade-ai\n```\n\nAI 会自己去 GitHub 查看项目说明，然后自动执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。\n\n装完后，**关闭当前 PowerShell，重新打开一个新的**，输入：\n\n```\ntrade\n```\n\n浏览器会自动打开 Trade 界面。如果没有自动打开，手动访问 **http://127.0.0.1:9119/trade**。\n\n> 验证能用后，按 `Ctrl+C` 退出 trade（暂时退出，下一步设置开机自启后会自动运行）。\n\n---\n\n## 第九步：设置 Hermes Gateway 开机自启\n\nHermes Gateway 是定时任务调度器，Trade 的定时简报、定时询盘检查都依赖它。必须让它随系统启动，否则每天还要手动开。\n\n在 PowerShell 里执行：\n\n```\nhermes gateway install\n```\n\n看到「服务已安装」或类似提示即成功。**以后开机时 Hermes Gateway 会自动在后台运行，无需手动启动。**\n\n> 验证是否装好：按 `Win+R`，输入 `services.msc`，回车。在列表里找到「Hermes Gateway」服务，状态应为「正在运行」。\n\n---\n\n## 第十步：设置 Trade 开机自启（无终端窗口）\n\n上一步装好了 Gateway，但 Trade 本身还没设为自启。这一步用**注册表 + VBS 脚本**的方式让 Trade 开机自动运行，**且不弹出任何终端窗口**——开机后直接打开浏览器访问 **http://127.0.0.1:9119/trade** 就能用。\n\n### 10.1 创建启动器脚本（VBS + BAT，带日志）\n\n把下面**整段命令**复制粘贴到 PowerShell 里，按回车：\n\n```powershell\n# 探测 trade.exe 完整路径（避免开机时 PATH 未完全加载导致找不到）\n$tradeExe = (Get-Command trade -ErrorAction Stop).Source\nif (-not $tradeExe) {\n Write-Host \"❌ 找不到 trade.exe，请先确认 trade 已安装\" -ForegroundColor Red\n} else {\n Write-Host \"找到 trade.exe：$tradeExe\" -ForegroundColor Green\n $dir = \"$env:LOCALAPPDATA\\trade\"\n $bat = \"$dir\\trade-autostart.bat\"\n $vbs = \"$dir\\trade-autostart.vbs\"\n $logFile = \"$dir\\trade-autostart.log\"\n New-Item -ItemType Directory -Force -Path $dir | Out-Null\n\n # .bat 用完整路径调用 trade.exe 并重定向日志（启动失败时可查日志）\n @\"\n@echo off\n\"$tradeExe\" > \"$logFile\" 2>&1\n\"@ | Out-File -FilePath $bat -Encoding ASCII\n\n # VBS 隐藏窗口启动 .bat（不等待，不弹窗）\n @\"\nSet WshShell = CreateObject(\"WScript.Shell\")\nWshShell.Run \"cmd /c \"\"$bat\"\"\", 0, False\n\"@ | Out-File -FilePath $vbs -Encoding ASCII\n\n Write-Host \"已创建启动器：$vbs\" -ForegroundColor Green\n Write-Host \"日志文件：$logFile（启动失败时打开它排查）\" -ForegroundColor Yellow\n}\n```\n\n看到绿色「已创建启动器」即成功。\n\n> **这段命令做了什么：**\n> 1. 用 `Get-Command trade` 探测 `trade.exe` 的完整路径，写入 .bat 文件——**不依赖 PATH**，开机早期也能找到\n> 2. .bat 把 trade 的所有输出重定向到 `trade-autostart.log`——启动失败时打开这个日志就能看到错误，不用两眼一抹黑\n> 3. VBS 以**隐藏窗口**模式启动 .bat——不会弹出黑框终端\n\n### 10.2 写入注册表，开机自动运行该脚本\n\n继续在 PowerShell 里粘贴下面这行，按回车：\n\n```powershell\nNew-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Value \"wscript.exe `\"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs`\"\" -PropertyType String -Force\n```\n\n没有报错就说明写入成功。\n\n### 10.3 立即测试（可选但推荐）\n\n不想等到明天才验证？在 PowerShell 里执行：\n\n```powershell\nwscript.exe \"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs\"\n```\n\n等约 15 秒，然后打开浏览器访问 **http://127.0.0.1:9119/trade**。如果能看到 Trade 界面，且**没有弹出任何终端窗口**，说明配置完全正确。\n\n> **如果打不开**：打开文件 `%LOCALAPPDATA%\\trade\\trade-autostart.log`（直接在资源管理器地址栏粘贴这个路径回车），看里面的错误信息。最常见的是 `ModuleNotFoundError`——说明 trade 安装有问题，回到第八步重装。\n\n> **以后的使用方式：** 每天打开电脑，等约 30 秒（系统启动 + Trade 自动启动），直接浏览器访问 **http://127.0.0.1:9119/trade** 即可，**再也不用打开 PowerShell 手动输入 `trade`**。\n\n### 10.4 如果想取消开机自启\n\n将来不想要自启了，在 PowerShell 里执行：\n\n```powershell\nRemove-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Force\n```\n\n即可移除自启，不影响 Trade 本身的使用。\n\n---\n\n## 如何更新 Trade\n\nTrade 会持续更新，新版本增加功能和修复问题。最简单的方式是让 AI 帮你更新：\n\n1. 按 `Win+R`，输入 `powershell`，回车\n2. 输入 `hermes` 启动 Hermes\n3. 在对话框里输入：\n\n```\n帮我更新trade，并重启trade，地址是https://github.com/chefroger/smart-trade-ai\n```\n\n4. 等 AI 执行完毕，看到「重启完成」提示后，刷新浏览器页面（`Ctrl+Shift+R`）即可。\n\n> 如果 `hermes` 命令找不到，说明 Hermes 没装好，回到第五步重装。\n\n---\n\n## 常见问题\n\n| 你看到的现象 | 怎么解决 |\n|------------|---------|\n| 第五步安装 Hermes 卡住不动 | 科学上网没开好。确认 VPN 是全局模式，关掉 PowerShell 重开再试 |\n| `hermes` 输入后提示「不是内部或外部命令」 | 关掉 PowerShell 重新打开一个新的 |\n| `trade` 输入后提示「不是内部或外部命令」 | 改成输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 然后 `python server.py` |\n| Hermes 对话没反应 | API Key 没配置对。重新运行 `hermes setup` 检查 |\n| 浏览器打开显示「无法访问此网站」 | 程序没在运行。打开一个新的 PowerShell，输入 `trade` 启动 |\n| 开机后访问 127.0.0.1:9119/trade 打不开 | Trade 自启还没跑完，等 30 秒再试。若仍不行，打开 `%LOCALAPPDATA%\\trade\\trade-autostart.log` 看错误日志；或按 `Win+R` 输入 `taskmgr` 回车，看进程里有没有 `python.exe`，没有就手动运行第十步的 VBS 脚本 |\n| 定时任务（每日简报等）不执行 | 第九步的 Hermes Gateway 没装好或没运行。重新执行 `hermes gateway install`，再到 `services.msc` 确认服务状态 |\n| 提示「Filename too long」 | 第五步的长路径设置没做。回到 5.2 执行那行命令，然后**重启电脑** |\n\n---\n\n<p style=\"text-align:center; color:#8b949e; margin-top:3rem;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n\n---\n\n## Skills 参考手册\n\nTrade 会自动识别你的意图，匹配合适的技能。以下是全部 37 个技能的详细说明和使用示例。\n\n### 37 个技能速查\n\n| # | 技能 | 功能 | 典型提示词示例 |\n|---|------|------|---------------|\n| 1 | **b2b-osint** | 客户背景调查（6 层检测） | 帮我查一下这家公司 / 背调这个邮箱 / 查一下域名注册时间 |\n| 2 | **b2b-email-intel** | 邮箱情报（120+ 平台检测） | 查一下这个邮箱哪个平台注册了 / 邮箱是真的吗 |\n| 3 | **b2b-lead-generation** | 多通道客户搜索与开发 | 帮我找一下德国的 XX 产品客户 / 写一封开发信给美国客户 |\n| 4 | **b2b-document** | 本地文档分析与提取 | 分析一下这份报价单 / 帮我看看这个合同有什么问题 |\n| 5 | **b2b-doc-generation** | 生成报价/合同/提案文件 | 帮我生成一份 PDF 报价单 / 做一份产品介绍 PPT |\n| 6 | **b2b-platform** | B2B 平台店铺诊断优化 | 帮我看看这个阿里国际站产品页 / 优化一下产品标题 |\n| 7 | **b2b-linkedin-marketing** | LinkedIn 营销策略与内容 | 帮我想一下领英发什么内容 / 写一个 LinkedIn Add Note |\n| 8 | **b2b-social-media** | 社媒营销（FB/Ins/TikTok/YT） | 帮我做一个 Facebook 内容计划 / 写一个 TikTok 脚本 |\n| 9 | **b2b-customs-data** | 海关数据分析找采购商 | 帮我看看谁在进口这个产品 / 分析一下这个 HS 编码 |\n| 10 | **b2b-onboarding** | 新公司全套部署方案 | 我刚做外贸，帮我制定一个营销方案 / 新公司怎么开始 |\n| 11 | **b2b-daily-automation** | 定时任务（早报/晚报/周报） | 每天早上 8 点给我一份简报 / 设置一个每日工作总结 |\n| 12 | **b2b-customer-mgmt** | 客户档案与分级管理 | 帮我查一下 XX 公司的信息 / A 级客户有哪些 |\n| 13 | **b2b-data-directory** | 数据目录结构管理 | 我的数据存在哪了 / 帮我初始化一下数据目录 |\n| 14 | **chat-memory** | 历史对话查询 | 上次和 XX 公司聊到什么了 / 之前那份报价是多少 |\n| 15 | **b2b-skill-generator** | 动态创建新的 B2B Skill | 帮我创建一个新的 skill，用来查 XX |\n| 16 | **b2b-trade-ops** | 外贸履约与售后沟通 | 帮我写一封催款邮件 / 客户投诉质量有问题怎么办 |\n| 17 | **b2b-trade-compliance** | 合规检查与文化禁忌 | 这个颜色在沙特有什么忌讳吗 / 检查一下 FOB 写对了没有 |\n| 18 | **b2b-cold-outreach** | 冷 outreach 邮件撰写 | 给德国的 XX 公司写一封开发信 / 写一封产品推广信 |\n| 19 | **auto-trade-customer-development** | 全自动客户开发流水线 | 帮我跑一轮自动化客户开发 / 全自动开发一批客户 |\n| 20 | ~~**auto-smtp-email**~~ | ~~SMTP 邮件发送 — 已禁用~~ | ~~把这封开发信发出去 / 群发这批邮件~~ |\n| 21 | **b2b-email-imitation** | 开发信仿写与再创作 | 参考这封邮件，帮我写一个类似的 / 模仿这个风格写一封开发信 |\n| 22 | **b2b-buyer-persona** | 买家画像与角色分层 | 帮我分析一下买家画像 / 针对采购经理应该怎么沟通 |\n| 23 | **b2b-market-analysis** | 市场分析作战地图 | 分析一下德国市场进入策略 / 帮我做一个中东市场调研 |\n| 24 | **b2b-sales-pipeline** | 销售管线与跟进策略 | 这个客户一个月没回了怎么办 / 帮我设计一个 30 天跟进计划 |\n| 25 | **b2b-inquiry-training** | 询盘回复训练 | 帮我练一下询盘回复 / 模拟一个刁钻买家 |\n| 26 | **b2b-kol-imitation** | KOL 风格模仿 | 模仿这个领英大V的风格 / 分析这个账号的内容策略 |\n| 27 | **b2b-reddit-engagement** | Reddit 社区互动 | 帮我在 Reddit 写一条专业评论 / 在哪个 subreddit 发帖 |\n| 28 | **b2b-seo-aeo** | SEO+AEO 文章生成 | 写一篇针对 AI 搜索优化的行业文章 / 帮我做 Pillar Page |\n| 29 | **b2b-short-video** | 短视频脚本生成 | 帮我写一个 TikTok 产品视频脚本 / 工厂参观短视频 |\n| 30 | **b2b-exhibition** | 展会全流程管理 | 帮我写展会邀约邮件 / 展会后的跟进计划 |\n| 31 | **b2b-product-description** | 产品描述生成 | 帮我把这款产品写成销售资料 / 用 FAB 分析产品卖点 |\n| 32 | **b2b-six-thinking-hats** | 六顶思考帽决策 | 帮我分析这个决策 / 要不要给这个客户独家代理权 |\n| 33 | **b2b-customer-intel** | 客户深度画像 | 帮我做一份某客户的深度画像 / 这个客户有什么偏好 |\n| 34 | **b2b-customer-finder** | 客户开发向导 | 三问启动：卖什么→卖到哪→找谁，自动搜索生成开发信 |\n| 35 | **b2b-inquiry-meeting** | 询盘分析会主持 | 周度复盘 / 逐人点评 / 重点询盘 / 跟进行动表 |\n| 36 | **b2b-sales-playbook** | 销冠经验封装器 | 将销冠经验转化为SOP/话术库/新人路线/避坑清单 |\n| 37 | **b2b-guarantee-proposal** | 商业提案生成器 | 三档方案对比 + ROI分析 + 实施路线图 |\n\n### 技能自动匹配原理\n\n当你在聊天框输入内容时，Trade 会自动匹配关键词，调用最合适的 skill。匹配规则：\n\n- **词边界匹配**（+3 分）：独立关键词命中，如\"背调\"、\"开发信\"、\"海关数据\"\n- **子串匹配**（+1 分）：关键词出现在句子中，如\"帮我查一下这个公司\"匹配到\"查公司\"\n- **显式调用**（最高优先级）：用\"用 b2b-xxx\" 或 \"加载 skill b2b-xxx\" 直接指定\n\n得分最高的 skill 会被激活。如果连续使用同一个 skill，系统会用简短的提示词继续（节省 token）。\n\n### 如何查看当前激活的技能\n\n当 Trade 匹配到一个 skill 时，在回复的开头会显示技能名称，如 `[SKILL AUGMENTATION] 技能触发：b2b-osint`。你也可以直接输入\"用 b2b-osint 查一下这个邮箱\"来强制指定某个技能。\n\n> **设计理念**：Trade 辅助用户梳理工作流程、生成邮件草稿、撰写文档，\n> **但不替用户直接发送邮件/文件给客户**。AI 可能出错，所有对外内容必须\n> 经用户复核确认后自主发出。`auto-smtp-email` 已被禁用，不会由系统触发。\n\n### 技能别名\n\n部分技能之间存在别名关联，输入一个技能名可能触发相关联的技能：\n\n| 输入技能 | 也会触发 |\n|----------|---------|\n| b2b-osint | b2b-email-intel |\n| b2b-lead-generation | b2b-customer-mgmt |\n| b2b-trade-ops | b2b-customer-mgmt |\n| auto-trade-customer-development | b2b-lead-generation, b2b-osint, ~~auto-smtp-email~~ |\n"}, "ef937141c1097bbd4e30c53b1f9bf802fc340f3c": {"t": 1785772957.9579926, "n": 11895, "h": "19353ab52ca80f72", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n .step-num { display:inline-block; width:32px; height:32px; line-height:32px;\n text-align:center; background:#2563EB; color:#fff; border-radius:50%;\n font-weight:bold; font-size:16px; margin-right:8px; }\n .step-title { font-size:1.3rem; font-weight:bold; margin:1.5rem 0 0.5rem; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">Windows 版安装教程 · 不需要懂技术，跟着步骤走，20 分钟装好</p>\n</div>\n\n<div style=\"text-align:center; margin:1rem 0;\">\n <p style=\"color:#8b949e; margin-bottom:0.5rem;\">安装遇到问题？扫码加微信，备注「Trade」</p>\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"180\" style=\"border-radius:8px;\">\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n## 第一步：确保科学上网已启动\n\n这个工具需要从 GitHub 下载代码，而 GitHub 在国内访问不稳定。在开始之前，**必须先打开你的科学上网工具**（VPN / Clash / V2Ray 等），确保网络通畅。\n\n**验证方法：** 打开 **Google Chrome 浏览器**，在地址栏输入 `github.com`，回车。如果页面能正常打开，说明网络没问题，可以继续。\n\n> 如果 GitHub 打不开，检查你的科学上网工具是否已启动、是否设为**全局模式**或 **TUN 模式**。\n\n---\n\n## 第二步：注册 DeepSeek 并获取 API Key\n\nAI 不是免费的，需要去 DeepSeek 注册账号并充值。\n\n1. 用 **Google Chrome 浏览器** 打开 **platform.deepseek.com**\n2. 点击「注册」，用手机号注册一个账号\n3. 登录后，点击页面上的「**充值**」，**充值 10 元以上**（按用量扣费，10 块钱能用很久）\n4. 在左侧菜单找到「**API Keys**」，点击进入\n5. 点击「**创建 API Key**」，名称填 `trade`，点确定\n6. 页面上会显示一串字符（以 `sk-` 开头）——这就是你的 **DeepSeek API Key**\n7. **立刻复制保存**，关掉后就再也看不到了\n\n> 把这串 Key 先粘贴到记事本里，后面要用。\n\n---\n\n## 第三步：注册 Tavily 并获取 API Key\n\nTavily 是联网搜索引擎，让 AI 能搜索实时信息。\n\n1. 用 **Google Chrome 浏览器** 打开 **tavily.com**\n2. 点击「Sign Up」，**用 Gmail 邮箱注册**一个账号\n3. 登录后进入 Dashboard，在 API Keys 区域找到你的 Key（以 `tvly-` 开头）\n4. **复制保存**到记事本里\n\n> Tavily 每月有 1000 次免费搜索额度，个人使用足够了。\n\n---\n\n## 第四步：在桌面创建 API Key 文件\n\n把刚才拿到的两个 Key 整理到一个文件里，后面配置时会用到。\n\n1. 在桌面上**右键** → 新建 → 文本文档\n2. 把文件重命名为 `apikey.txt`\n3. 打开文件，按以下格式粘贴：\n\n```\nDeepSeek API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nTavily API Key: tvly-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\n4. 保存并关闭。后面配置 Hermes 时需要从这里复制粘贴。\n\n---\n\n## 第五步：安装 Hermes Agent（AI 引擎）\n\nHermes Agent 是驱动 AI 的底层引擎，Trade 基于它运行。\n\n### 5.1 以管理员身份打开 PowerShell\n\n1. 按键盘 **Win 键**，输入 `powershell`\n2. **右键点击**搜索结果里的「Windows PowerShell」\n3. 选择「**以管理员身份运行**」\n4. 弹出提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n\n### 5.2 开启长路径支持\n\n在 PowerShell 里粘贴下面这行命令，按回车：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n### 5.3 一键安装 Hermes\n\n接着执行下面这行命令：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n等待几分钟，看到「安装完成」提示即可。\n\n> 在 PowerShell 里粘贴的方法是**点一下鼠标右键**（不是 Ctrl+V）。\n\n---\n\n## 第六步：配置 Hermes（大模型 + 搜索）\n\n安装完成后，在同一个 PowerShell 窗口输入：\n\n```\nhermes setup\n```\n\n这时会出现交互配置界面，按以下步骤操作：\n\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」→ 按回车\n2. 选择模型时，选「**deepseek-v4-flash**」（即 DeepSeek V4 Flash）→ 按回车\n3. 粘贴你的 **DeepSeek API Key**（从桌面的 `apikey.txt` 复制）→ 按回车\n4. 搜索服务选「**Tavily**」→ 按回车\n5. 粘贴你的 **Tavily API Key** → 按回车\n\n看到「配置成功」提示就完成了。\n\n---\n\n## 第七步：验证 Hermes 是否正常\n\n在 PowerShell 里输入：\n\n```\nhermes\n```\n\n等它启动后，在对话框里输入：\n\n```\nhello\n```\n\n按回车发送。如果 AI 正常回复了，说明大模型配置成功。\n\n> 按 `Ctrl+C` 可以退出 Hermes，回到命令行。\n\n---\n\n## 第八步：让 AI 帮你安装 Trade\n\n重新启动 Hermes（输入 `hermes`），在聊天框里**复制粘贴**下面这句话：\n\n```\n请帮我安装 trade，地址是 https://github.com/chefroger/smart-trade-ai\n```\n\nAI 会自己去 GitHub 查看项目说明，然后自动执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。\n\n装完后，**关闭当前 PowerShell，重新打开一个新的**，输入：\n\n```\ntrade\n```\n\n浏览器会自动打开 Trade 界面。如果没有自动打开，手动访问 **http://127.0.0.1:9119/trade**。\n\n> 验证能用后，按 `Ctrl+C` 退出 trade（暂时退出，下一步设置开机自启后会自动运行）。\n\n---\n\n## 第九步：设置 Hermes Gateway 开机自启\n\nHermes Gateway 是定时任务调度器，Trade 的定时简报、定时询盘检查都依赖它。必须让它随系统启动，否则每天还要手动开。\n\n在 PowerShell 里执行：\n\n```\nhermes gateway install\n```\n\n看到「服务已安装」或类似提示即成功。**以后开机时 Hermes Gateway 会自动在后台运行，无需手动启动。**\n\n> 验证是否装好：按 `Win+R`，输入 `services.msc`，回车。在列表里找到「Hermes Gateway」服务，状态应为「正在运行」。\n\n---\n\n## 第十步：设置 Trade 开机自启（无终端窗口）\n\n上一步装好了 Gateway，但 Trade 本身还没设为自启。这一步用**注册表 + VBS 脚本**的方式让 Trade 开机自动运行，**且不弹出任何终端窗口**——开机后直接打开浏览器访问 **http://127.0.0.1:9119/trade** 就能用。\n\n### 10.1 创建启动器脚本（VBS + BAT，带日志）\n\n把下面**整段命令**复制粘贴到 PowerShell 里，按回车：\n\n```powershell\n# 探测 trade.exe 完整路径（避免开机时 PATH 未完全加载导致找不到）\n$tradeExe = (Get-Command trade -ErrorAction Stop).Source\nif (-not $tradeExe) {\n Write-Host \"❌ 找不到 trade.exe，请先确认 trade 已安装\" -ForegroundColor Red\n} else {\n Write-Host \"找到 trade.exe：$tradeExe\" -ForegroundColor Green\n $dir = \"$env:LOCALAPPDATA\\trade\"\n $bat = \"$dir\\trade-autostart.bat\"\n $vbs = \"$dir\\trade-autostart.vbs\"\n $logFile = \"$dir\\trade-autostart.log\"\n New-Item -ItemType Directory -Force -Path $dir | Out-Null\n\n # .bat 用完整路径调用 trade.exe 并重定向日志（启动失败时可查日志）\n @\"\n@echo off\n\"$tradeExe\" > \"$logFile\" 2>&1\n\"@ | Out-File -FilePath $bat -Encoding ASCII\n\n # VBS 隐藏窗口启动 .bat（不等待，不弹窗）\n @\"\nSet WshShell = CreateObject(\"WScript.Shell\")\nWshShell.Run \"cmd /c \"\"$bat\"\"\", 0, False\n\"@ | Out-File -FilePath $vbs -Encoding ASCII\n\n Write-Host \"已创建启动器：$vbs\" -ForegroundColor Green\n Write-Host \"日志文件：$logFile（启动失败时打开它排查）\" -ForegroundColor Yellow\n}\n```\n\n看到绿色「已创建启动器」即成功。\n\n> **这段命令做了什么：**\n> 1. 用 `Get-Command trade` 探测 `trade.exe` 的完整路径，写入 .bat 文件——**不依赖 PATH**，开机早期也能找到\n> 2. .bat 把 trade 的所有输出重定向到 `trade-autostart.log`——启动失败时打开这个日志就能看到错误，不用两眼一抹黑\n> 3. VBS 以**隐藏窗口**模式启动 .bat——不会弹出黑框终端\n\n### 10.2 写入注册表，开机自动运行该脚本\n\n继续在 PowerShell 里粘贴下面这行，按回车：\n\n```powershell\nNew-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Value \"wscript.exe `\"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs`\"\" -PropertyType String -Force\n```\n\n没有报错就说明写入成功。\n\n### 10.3 立即测试（可选但推荐）\n\n不想等到明天才验证？在 PowerShell 里执行：\n\n```powershell\nwscript.exe \"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs\"\n```\n\n等约 15 秒，然后打开浏览器访问 **http://127.0.0.1:9119/trade**。如果能看到 Trade 界面，且**没有弹出任何终端窗口**，说明配置完全正确。\n\n> **如果打不开**：打开文件 `%LOCALAPPDATA%\\trade\\trade-autostart.log`（直接在资源管理器地址栏粘贴这个路径回车），看里面的错误信息。最常见的是 `ModuleNotFoundError`——说明 trade 安装有问题，回到第八步重装。\n\n> **以后的使用方式：** 每天打开电脑，等约 30 秒（系统启动 + Trade 自动启动），直接浏览器访问 **http://127.0.0.1:9119/trade** 即可，**再也不用打开 PowerShell 手动输入 `trade`**。\n\n### 10.4 如果想取消开机自启\n\n将来不想要自启了，在 PowerShell 里执行：\n\n```powershell\nRemove-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Force\n```\n\n即可移除自启，不影响 Trade 本身的使用。\n\n---\n\n## 如何更新 Trade\n\nTrade 会持续更新，新版本增加功能和修复问题。最简单的方式是让 AI 帮你更新：\n\n1. 按 `Win+R`，输入 `powershell`，回车\n2. 输入 `hermes` 启动 Hermes\n3. 在对话框里输入：\n\n```\n帮我更新trade，并重启trade，地址是https://github.com/chefroger/smart-trade-ai\n```\n\n4. 等 AI 执行完毕，看到「重启完成」提示后，刷新浏览器页面（`Ctrl+Shift+R`）即可。\n\n> 如果 `hermes` 命令找不到，说明 Hermes 没装好，回到第五步重装。\n\n---\n\n## 常见问题\n\n| 你看到的现象 | 怎么解决 |\n|------------|---------|\n| 第五步安装 Hermes 卡住不动 | 科学上网没开好。确认 VPN 是全局模式，关掉 PowerShell 重开再试 |\n| `hermes` 输入后提示「不是内部或外部命令」 | 关掉 PowerShell 重新打开一个新的 |\n| `trade` 输入后提示「不是内部或外部命令」 | 改成输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 然后 `python server.py` |\n| Hermes 对话没反应 | API Key 没配置对。重新运行 `hermes setup` 检查 |\n| 浏览器打开显示「无法访问此网站」 | 程序没在运行。打开一个新的 PowerShell，输入 `trade` 启动 |\n| 开机后访问 127.0.0.1:9119/trade 打不开 | Trade 自启还没跑完，等 30 秒再试。若仍不行，打开 `%LOCALAPPDATA%\\trade\\trade-autostart.log` 看错误日志；或按 `Win+R` 输入 `taskmgr` 回车，看进程里有没有 `python.exe`，没有就手动运行第十步的 VBS 脚本 |\n| 定时任务（每日简报等）不执行 | 第九步的 Hermes Gateway 没装好或没运行。重新执行 `hermes gateway install`，再到 `services.msc` 确认服务状态 |\n| 提示「Filename too long」 | 第五步的长路径设置没做。回到 5.2 执行那行命令，然后**重启电脑** |\n\n---\n\n<p style=\"text-align:center; color:#8b949e; margin-top:3rem;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n\n---\n\n## Skills 参考手册\n\nTrade 会自动识别你的意图，匹配合适的技能。以下是全部 37 个技能的详细说明和使用示例。\n\n### 37 个技能速查\n\n| # | 技能 | 功能 | 典型提示词示例 |\n|---|------|------|---------------|\n| 1 | **b2b-osint** | 客户背景调查（6 层检测） | 帮我查一下这家公司 / 背调这个邮箱 / 查一下域名注册时间 |\n| 2 | **b2b-email-intel** | 邮箱情报（120+ 平台检测） | 查一下这个邮箱哪个平台注册了 / 邮箱是真的吗 |\n| 3 | **b2b-lead-generation** | 多通道客户搜索与开发 | 帮我找一下德国的 XX 产品客户 / 写一封开发信给美国客户 |\n| 4 | **b2b-document** | 本地文档分析与提取 | 分析一下这份报价单 / 帮我看看这个合同有什么问题 |\n| 5 | **b2b-doc-generation** | 生成报价/合同/提案文件 | 帮我生成一份 PDF 报价单 / 做一份产品介绍 PPT |\n| 6 | **b2b-platform** | B2B 平台店铺诊断优化 | 帮我看看这个阿里国际站产品页 / 优化一下产品标题 |\n| 7 | **b2b-linkedin-marketing** | LinkedIn 营销策略与内容 | 帮我想一下领英发什么内容 / 写一个 LinkedIn Add Note |\n| 8 | **b2b-social-media** | 社媒营销（FB/Ins/TikTok/YT） | 帮我做一个 Facebook 内容计划 / 写一个 TikTok 脚本 |\n| 9 | **b2b-customs-data** | 海关数据分析找采购商 | 帮我看看谁在进口这个产品 / 分析一下这个 HS 编码 |\n| 10 | **b2b-onboarding** | 新公司全套部署方案 | 我刚做外贸，帮我制定一个营销方案 / 新公司怎么开始 |\n| 11 | **b2b-daily-automation** | 定时任务（早报/晚报/周报） | 每天早上 8 点给我一份简报 / 设置一个每日工作总结 |\n| 12 | **b2b-customer-mgmt** | 客户档案与分级管理 | 帮我查一下 XX 公司的信息 / A 级客户有哪些 |\n| 13 | **b2b-data-directory** | 数据目录结构管理 | 我的数据存在哪了 / 帮我初始化一下数据目录 |\n| 14 | **chat-memory** | 历史对话查询 | 上次和 XX 公司聊到什么了 / 之前那份报价是多少 |\n| 15 | **b2b-skill-generator** | 动态创建新的 B2B Skill | 帮我创建一个新的 skill，用来查 XX |\n| 16 | **b2b-trade-ops** | 外贸履约与售后沟通 | 帮我写一封催款邮件 / 客户投诉质量有问题怎么办 |\n| 17 | **b2b-trade-compliance** | 合规检查与文化禁忌 | 这个颜色在沙特有什么忌讳吗 / 检查一下 FOB 写对了没有 |\n| 18 | **b2b-cold-outreach** | 冷 outreach 邮件撰写 | 给德国的 XX 公司写一封开发信 / 写一封产品推广信 |\n| 19 | **auto-trade-customer-development** | 全自动客户开发流水线 | 帮我跑一轮自动化客户开发 / 全自动开发一批客户 |\n| 20 | ~~**auto-smtp-email**~~ | ~~SMTP 邮件发送 — 已禁用~~ | ~~把这封开发信发出去 / 群发这批邮件~~ |\n| 21 | **b2b-email-imitation** | 开发信仿写与再创作 | 参考这封邮件，帮我写一个类似的 / 模仿这个风格写一封开发信 |\n| 22 | **b2b-buyer-persona** | 买家画像与角色分层 | 帮我分析一下买家画像 / 针对采购经理应该怎么沟通 |\n| 23 | **b2b-market-analysis** | 市场分析作战地图 | 分析一下德国市场进入策略 / 帮我做一个中东市场调研 |\n| 24 | **b2b-sales-pipeline** | 销售管线与跟进策略 | 这个客户一个月没回了怎么办 / 帮我设计一个 30 天跟进计划 |\n| 25 | **b2b-inquiry-training** | 询盘回复训练 | 帮我练一下询盘回复 / 模拟一个刁钻买家 |\n| 26 | **b2b-kol-imitation** | KOL 风格模仿 | 模仿这个领英大V的风格 / 分析这个账号的内容策略 |\n| 27 | **b2b-reddit-engagement** | Reddit 社区互动 | 帮我在 Reddit 写一条专业评论 / 在哪个 subreddit 发帖 |\n| 28 | **b2b-seo-aeo** | SEO+AEO 文章生成 | 写一篇针对 AI 搜索优化的行业文章 / 帮我做 Pillar Page |\n| 29 | **b2b-short-video** | 短视频脚本生成 | 帮我写一个 TikTok 产品视频脚本 / 工厂参观短视频 |\n| 30 | **b2b-exhibition** | 展会全流程管理 | 帮我写展会邀约邮件 / 展会后的跟进计划 |\n| 31 | **b2b-product-description** | 产品描述生成 | 帮我把这款产品写成销售资料 / 用 FAB 分析产品卖点 |\n| 32 | **b2b-six-thinking-hats** | 六顶思考帽决策 | 帮我分析这个决策 / 要不要给这个客户独家代理权 |\n| 33 | **b2b-customer-intel** | 客户深度画像 | 帮我做一份某客户的深度画像 / 这个客户有什么偏好 |\n| 34 | **b2b-customer-finder** | 客户开发向导 | 三问启动：卖什么→卖到哪→找谁，自动搜索生成开发信 |\n| 35 | **b2b-inquiry-meeting** | 询盘分析会主持 | 周度复盘 / 逐人点评 / 重点询盘 / 跟进行动表 |\n| 36 | **b2b-sales-playbook** | 销冠经验封装器 | 将销冠经验转化为SOP/话术库/新人路线/避坑清单 |\n| 37 | **b2b-guarantee-proposal** | 商业提案生成器 | 三档方案对比 + ROI分析 + 实施路线图 |\n\n### 技能自动匹配原理\n\n当你在聊天框输入内容时，Trade 会自动匹配关键词，调用最合适的 skill。匹配规则：\n\n- **词边界匹配**（+3 分）：独立关键词命中，如\"背调\"、\"开发信\"、\"海关数据\"\n- **子串匹配**（+1 分）：关键词出现在句子中，如\"帮我查一下这个公司\"匹配到\"查公司\"\n- **显式调用**（最高优先级）：用\"用 b2b-xxx\" 或 \"加载 skill b2b-xxx\" 直接指定\n\n得分最高的 skill 会被激活。如果连续使用同一个 skill，系统会用简短的提示词继续（节省 token）。\n\n### 如何查看当前激活的技能\n\n当 Trade 匹配到一个 skill 时，在回复的开头会显示技能名称，如 `[SKILL AUGMENTATION] 技能触发：b2b-osint`。你也可以直接输入\"用 b2b-osint 查一下这个邮箱\"来强制指定某个技能。\n\n> **设计理念**：Trade 辅助用户梳理工作流程、生成邮件草稿、撰写文档，\n> **但不替用户直接发送邮件/文件给客户**。AI 可能出错，所有对外内容必须\n> 经用户复核确认后自主发出。`auto-smtp-email` 已被禁用，不会由系统触发。\n\n### 技能别名\n\n部分技能之间存在别名关联，输入一个技能名可能触发相关联的技能：\n\n| 输入技能 | 也会触发 |\n|----------|---------|\n| b2b-osint | b2b-email-intel |\n| b2b-lead-generation | b2b-customer-mgmt |\n| b2b-trade-ops | b2b-customer-mgmt |\n| auto-trade-customer-development | b2b-lead-generation, b2b-osint, ~~auto-smtp-email~~ |\n"}, "5bfbb61715ff7dbbc8f76d4e05ddcf7d88a09f50": {"t": 1785772960.5206337, "n": 11682, "h": "e317e8e2e755fa88", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n .step-num { display:inline-block; width:32px; height:32px; line-height:32px;\n text-align:center; background:#2563EB; color:#fff; border-radius:50%;\n font-weight:bold; font-size:16px; margin-right:8px; }\n .step-title { font-size:1.3rem; font-weight:bold; margin:1.5rem 0 0.5rem; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">Windows 版安装教程 · 不需要懂技术，跟着步骤走，20 分钟装好</p>\n</div>\n\n<div style=\"text-align:center; margin:1rem 0;\">\n <p style=\"color:#8b949e; margin-bottom:0.5rem;\">安装遇到问题？扫码加微信，备注「Trade」</p>\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"180\" style=\"border-radius:8px;\">\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n## 第一步：确保科学上网已启动\n\n这个工具需要从 GitHub 下载代码，而 GitHub 在国内访问不稳定。在开始之前，**必须先打开你的科学上网工具**（VPN / Clash / V2Ray 等），确保网络通畅。\n\n**验证方法：** 打开 **Google Chrome 浏览器**，在地址栏输入 `github.com`，回车。如果页面能正常打开，说明网络没问题，可以继续。\n\n> 如果 GitHub 打不开，检查你的科学上网工具是否已启动、是否设为**全局模式**或 **TUN 模式**。\n\n---\n\n## 第二步：注册 DeepSeek 并获取 API Key\n\nAI 不是免费的，需要去 DeepSeek 注册账号并充值。\n\n1. 用 **Google Chrome 浏览器** 打开 **platform.deepseek.com**\n2. 点击「注册」，用手机号注册一个账号\n3. 登录后，点击页面上的「**充值**」，**充值 10 元以上**（按用量扣费，10 块钱能用很久）\n4. 在左侧菜单找到「**API Keys**」，点击进入\n5. 点击「**创建 API Key**」，名称填 `trade`，点确定\n6. 页面上会显示一串字符（以 `sk-` 开头）——这就是你的 **DeepSeek API Key**\n7. **立刻复制保存**，关掉后就再也看不到了\n\n> 把这串 Key 先粘贴到记事本里，后面要用。\n\n---\n\n## 第三步：注册 Tavily 并获取 API Key\n\nTavily 是联网搜索引擎，让 AI 能搜索实时信息。\n\n1. 用 **Google Chrome 浏览器** 打开 **tavily.com**\n2. 点击「Sign Up」，**用 Gmail 邮箱注册**一个账号\n3. 登录后进入 Dashboard，在 API Keys 区域找到你的 Key（以 `tvly-` 开头）\n4. **复制保存**到记事本里\n\n> Tavily 每月有 1000 次免费搜索额度，个人使用足够了。\n\n---\n\n## 第四步：在桌面创建 API Key 文件\n\n把刚才拿到的两个 Key 整理到一个文件里，后面配置时会用到。\n\n1. 在桌面上**右键** → 新建 → 文本文档\n2. 把文件重命名为 `apikey.txt`\n3. 打开文件，按以下格式粘贴：\n\n```\nDeepSeek API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nTavily API Key: tvly-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\n4. 保存并关闭。后面配置 Hermes 时需要从这里复制粘贴。\n\n---\n\n## 第五步：安装 Hermes Agent（AI 引擎）\n\nHermes Agent 是驱动 AI 的底层引擎，Trade 基于它运行。\n\n### 5.1 以管理员身份打开 PowerShell\n\n1. 按键盘 **Win 键**，输入 `powershell`\n2. **右键点击**搜索结果里的「Windows PowerShell」\n3. 选择「**以管理员身份运行**」\n4. 弹出提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n\n### 5.2 开启长路径支持\n\n在 PowerShell 里粘贴下面这行命令，按回车：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n### 5.3 一键安装 Hermes\n\n接着执行下面这行命令：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n等待几分钟，看到「安装完成」提示即可。\n\n> 在 PowerShell 里粘贴的方法是**点一下鼠标右键**（不是 Ctrl+V）。\n\n---\n\n## 第六步：配置 Hermes（大模型 + 搜索）\n\n安装完成后，在同一个 PowerShell 窗口输入：\n\n```\nhermes setup\n```\n\n这时会出现交互配置界面，按以下步骤操作：\n\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」→ 按回车\n2. 选择模型时，选「**deepseek-v4-flash**」（即 DeepSeek V4 Flash）→ 按回车\n3. 粘贴你的 **DeepSeek API Key**（从桌面的 `apikey.txt` 复制）→ 按回车\n4. 搜索服务选「**Tavily**」→ 按回车\n5. 粘贴你的 **Tavily API Key** → 按回车\n\n看到「配置成功」提示就完成了。\n\n---\n\n## 第七步：验证 Hermes 是否正常\n\n在 PowerShell 里输入：\n\n```\nhermes\n```\n\n等它启动后，在对话框里输入：\n\n```\nhello\n```\n\n按回车发送。如果 AI 正常回复了，说明大模型配置成功。\n\n> 按 `Ctrl+C` 可以退出 Hermes，回到命令行。\n\n---\n\n## 第八步：让 AI 帮你安装 Trade\n\n重新启动 Hermes（输入 `hermes`），在聊天框里**复制粘贴**下面这句话：\n\n```\n请帮我安装 trade，地址是 https://github.com/chefroger/smart-trade-ai\n```\n\nAI 会自己去 GitHub 查看项目说明，然后自动执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。\n\n装完后，**关闭当前 PowerShell，重新打开一个新的**，输入：\n\n```\ntrade\n```\n\n浏览器会自动打开 Trade 界面。如果没有自动打开，手动访问 **http://127.0.0.1:9119/trade**。\n\n> 验证能用后，按 `Ctrl+C` 退出 trade（暂时退出，下一步设置开机自启后会自动运行）。\n\n---\n\n## 第九步：设置 Hermes Gateway 开机自启\n\nHermes Gateway 是定时任务调度器，Trade 的定时简报、定时询盘检查都依赖它。必须让它随系统启动，否则每天还要手动开。\n\n在 PowerShell 里执行：\n\n```\nhermes gateway install\n```\n\n看到「服务已安装」或类似提示即成功。**以后开机时 Hermes Gateway 会自动在后台运行，无需手动启动。**\n\n> 验证是否装好：按 `Win+R`，输入 `services.msc`，回车。在列表里找到「Hermes Gateway」服务，状态应为「正在运行」。\n\n---\n\n## 第十步：设置 Trade 开机自启（无终端窗口）\n\n上一步装好了 Gateway，但 Trade 本身还没设为自启。这一步用**注册表 + VBS 脚本**的方式让 Trade 开机自动运行，**且不弹出任何终端窗口**——开机后直接打开浏览器访问 **http://127.0.0.1:9119/trade** 就能用。\n\n### 10.1 创建启动器脚本（VBS + BAT，带日志）\n\n把下面**整段命令**复制粘贴到 PowerShell 里，按回车：\n\n```powershell\n# 探测 trade.exe 完整路径（避免开机时 PATH 未完全加载导致找不到）\n$tradeExe = (Get-Command trade -ErrorAction Stop).Source\nif (-not $tradeExe) {\n Write-Host \"❌ 找不到 trade.exe，请先确认 trade 已安装\" -ForegroundColor Red\n} else {\n Write-Host \"找到 trade.exe：$tradeExe\" -ForegroundColor Green\n $dir = \"$env:LOCALAPPDATA\\trade\"\n $bat = \"$dir\\trade-autostart.bat\"\n $vbs = \"$dir\\trade-autostart.vbs\"\n $logFile = \"$dir\\trade-autostart.log\"\n New-Item -ItemType Directory -Force -Path $dir | Out-Null\n\n # .bat 用完整路径调用 trade.exe 并重定向日志（启动失败时可查日志）\n @\"\n@echo off\n\"$tradeExe\" > \"$logFile\" 2>&1\n\"@ | Out-File -FilePath $bat -Encoding ASCII\n\n # VBS 隐藏窗口启动 .bat（不等待，不弹窗）\n @\"\nSet WshShell = CreateObject(\"WScript.Shell\")\nWshShell.Run \"cmd /c \"\"$bat\"\"\", 0, False\n\"@ | Out-File -FilePath $vbs -Encoding ASCII\n\n Write-Host \"已创建启动器：$vbs\" -ForegroundColor Green\n Write-Host \"日志文件：$logFile（启动失败时打开它排查）\" -ForegroundColor Yellow\n}\n```\n\n看到绿色「已创建启动器」即成功。\n\n> **这段命令做了什么：**\n> 1. 用 `Get-Command trade` 探测 `trade.exe` 的完整路径，写入 .bat 文件——**不依赖 PATH**，开机早期也能找到\n> 2. .bat 把 trade 的所有输出重定向到 `trade-autostart.log`——启动失败时打开这个日志就能看到错误，不用两眼一抹黑\n> 3. VBS 以**隐藏窗口**模式启动 .bat——不会弹出黑框终端\n\n### 10.2 写入注册表，开机自动运行该脚本\n\n继续在 PowerShell 里粘贴下面这行，按回车：\n\n```powershell\nNew-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Value \"wscript.exe `\"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs`\"\" -PropertyType String -Force\n```\n\n没有报错就说明写入成功。\n\n### 10.3 立即测试（可选但推荐）\n\n不想等到明天才验证？在 PowerShell 里执行：\n\n```powershell\nwscript.exe \"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs\"\n```\n\n等约 15 秒，然后打开浏览器访问 **http://127.0.0.1:9119/trade**。如果能看到 Trade 界面，且**没有弹出任何终端窗口**，说明配置完全正确。\n\n> **如果打不开**：打开文件 `%LOCALAPPDATA%\\trade\\trade-autostart.log`（直接在资源管理器地址栏粘贴这个路径回车），看里面的错误信息。最常见的是 `ModuleNotFoundError`——说明 trade 安装有问题，回到第八步重装。\n\n> **以后的使用方式：** 每天打开电脑，等约 30 秒（系统启动 + Trade 自动启动），直接浏览器访问 **http://127.0.0.1:9119/trade** 即可，**再也不用打开 PowerShell 手动输入 `trade`**。\n\n### 10.4 如果想取消开机自启\n\n将来不想要自启了，在 PowerShell 里执行：\n\n```powershell\nRemove-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Force\n```\n\n即可移除自启，不影响 Trade 本身的使用。\n\n---\n\n## 如何更新 Trade\n\nTrade 会持续更新，新版本增加功能和修复问题。最简单的方式是让 AI 帮你更新：\n\n1. 按 `Win+R`，输入 `powershell`，回车\n2. 输入 `hermes` 启动 Hermes\n3. 在对话框里输入：\n\n```\n帮我更新trade，并重启trade，地址是https://github.com/chefroger/smart-trade-ai\n```\n\n4. 等 AI 执行完毕，看到「重启完成」提示后，刷新浏览器页面（`Ctrl+Shift+R`）即可。\n\n> 如果 `hermes` 命令找不到，说明 Hermes 没装好，回到第五步重装。\n\n---\n\n## 常见问题\n\n| 你看到的现象 | 怎么解决 |\n|------------|---------|\n| 第五步安装 Hermes 卡住不动 | 科学上网没开好。确认 VPN 是全局模式，关掉 PowerShell 重开再试 |\n| `hermes` 输入后提示「不是内部或外部命令」 | 关掉 PowerShell 重新打开一个新的 |\n| `trade` 输入后提示「不是内部或外部命令」 | 改成输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 然后 `python server.py` |\n| Hermes 对话没反应 | API Key 没配置对。重新运行 `hermes setup` 检查 |\n| 浏览器打开显示「无法访问此网站」 | 程序没在运行。打开一个新的 PowerShell，输入 `trade` 启动 |\n| 开机后访问 127.0.0.1:9119/trade 打不开 | Trade 自启还没跑完，等 30 秒再试。若仍不行，打开 `%LOCALAPPDATA%\\trade\\trade-autostart.log` 看错误日志；或按 `Win+R` 输入 `taskmgr` 回车，看进程里有没有 `python.exe`，没有就手动运行第十步的 VBS 脚本 |\n| 定时任务（每日简报等）不执行 | 第九步的 Hermes Gateway 没装好或没运行。重新执行 `hermes gateway install`，再到 `services.msc` 确认服务状态 |\n| 提示「Filename too long」 | 第五步的长路径设置没做。回到 5.2 执行那行命令，然后**重启电脑** |\n\n---\n\n<p style=\"text-align:center; color:#8b949e; margin-top:3rem;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n\n---\n\n## Skills 参考手册\n\nTrade 会自动识别你的意图，匹配合适的技能。以下是全部 34 个技能的详细说明和使用示例。\n\n### 34 个技能速查\n\n| # | 技能 | 功能 | 典型提示词示例 |\n|---|------|------|---------------|\n| 1 | **b2b-osint** | 客户背景调查（6 层检测） | 帮我查一下这家公司 / 背调这个邮箱 / 查一下域名注册时间 |\n| 2 | **b2b-email-intel** | 邮箱情报（120+ 平台检测） | 查一下这个邮箱哪个平台注册了 / 邮箱是真的吗 |\n| 3 | **b2b-lead-generation** | 多通道客户搜索与开发 | 帮我找一下德国的 XX 产品客户 / 写一封开发信给美国客户 |\n| 4 | **b2b-document** | 本地文档分析与提取 | 分析一下这份报价单 / 帮我看看这个合同有什么问题 |\n| 5 | **b2b-doc-generation** | 生成报价/合同/提案文件 | 帮我生成一份 PDF 报价单 / 做一份产品介绍 PPT |\n| 6 | **b2b-platform** | B2B 平台店铺诊断优化 | 帮我看看这个阿里国际站产品页 / 优化一下产品标题 |\n| 7 | **b2b-linkedin-marketing** | LinkedIn 营销策略与内容 | 帮我想一下领英发什么内容 / 写一个 LinkedIn Add Note |\n| 8 | **b2b-social-media** | 社媒营销（FB/Ins/TikTok/YT） | 帮我做一个 Facebook 内容计划 / 写一个 TikTok 脚本 |\n| 9 | **b2b-customs-data** | 海关数据分析找采购商 | 帮我看看谁在进口这个产品 / 分析一下这个 HS 编码 |\n| 10 | **b2b-onboarding** | 新公司全套部署方案 | 我刚做外贸，帮我制定一个营销方案 / 新公司怎么开始 |\n| 11 | **b2b-daily-automation** | 定时任务（早报/晚报/周报） | 每天早上 8 点给我一份简报 / 设置一个每日工作总结 |\n| 12 | **b2b-customer-mgmt** | 客户档案与分级管理 | 帮我查一下 XX 公司的信息 / A 级客户有哪些 |\n| 13 | **b2b-data-directory** | 数据目录结构管理 | 我的数据存在哪了 / 帮我初始化一下数据目录 |\n| 14 | **chat-memory** | 历史对话查询 | 上次和 XX 公司聊到什么了 / 之前那份报价是多少 |\n| 15 | **b2b-skill-generator** | 动态创建新的 B2B Skill | 帮我创建一个新的 skill，用来查 XX |\n| 16 | **b2b-trade-ops** | 外贸履约与售后沟通 | 帮我写一封催款邮件 / 客户投诉质量有问题怎么办 |\n| 17 | **b2b-trade-compliance** | 合规检查与文化禁忌 | 这个颜色在沙特有什么忌讳吗 / 检查一下 FOB 写对了没有 |\n| 18 | **b2b-cold-outreach** | 冷 outreach 邮件撰写 | 给德国的 XX 公司写一封开发信 / 写一封产品推广信 |\n| 19 | **auto-trade-customer-development** | 全自动客户开发流水线 | 帮我跑一轮自动化客户开发 / 全自动开发一批客户 |\n| 20 | ~~**auto-smtp-email**~~ | ~~SMTP 邮件发送 — 已禁用~~ | ~~把这封开发信发出去 / 群发这批邮件~~ |\n| 21 | **b2b-email-imitation** | 开发信仿写与再创作 | 参考这封邮件，帮我写一个类似的 / 模仿这个风格写一封开发信 |\n| 22 | **b2b-buyer-persona** | 买家画像与角色分层 | 帮我分析一下买家画像 / 针对采购经理应该怎么沟通 |\n| 23 | **b2b-market-analysis** | 市场分析作战地图 | 分析一下德国市场进入策略 / 帮我做一个中东市场调研 |\n| 24 | **b2b-sales-pipeline** | 销售管线与跟进策略 | 这个客户一个月没回了怎么办 / 帮我设计一个 30 天跟进计划 |\n| 25 | **b2b-inquiry-training** | 询盘回复训练 | 帮我练一下询盘回复 / 模拟一个刁钻买家 |\n| 26 | **b2b-kol-imitation** | KOL 风格模仿 | 模仿这个领英大V的风格 / 分析这个账号的内容策略 |\n| 27 | **b2b-reddit-engagement** | Reddit 社区互动 | 帮我在 Reddit 写一条专业评论 / 在哪个 subreddit 发帖 |\n| 28 | **b2b-seo-aeo** | SEO+AEO 文章生成 | 写一篇针对 AI 搜索优化的行业文章 / 帮我做 Pillar Page |\n| 29 | **b2b-short-video** | 短视频脚本生成 | 帮我写一个 TikTok 产品视频脚本 / 工厂参观短视频 |\n| 30 | **b2b-exhibition** | 展会全流程管理 | 帮我写展会邀约邮件 / 展会后的跟进计划 |\n| 31 | **b2b-product-description** | 产品描述生成 | 帮我把这款产品写成销售资料 / 用 FAB 分析产品卖点 |\n| 32 | **b2b-six-thinking-hats** | 六顶思考帽决策 | 帮我分析这个决策 / 要不要给这个客户独家代理权 |\n| 33 | **b2b-customer-intel** | 客户深度画像 | 帮我做一份某客户的深度画像 / 这个客户有什么偏好 |\n| 34 | **b2b-customer-finder** | 客户开发向导 | 三问启动：卖什么→卖到哪→找谁，自动搜索生成开发信 |\n\n### 技能自动匹配原理\n\n当你在聊天框输入内容时，Trade 会自动匹配关键词，调用最合适的 skill。匹配规则：\n\n- **词边界匹配**（+3 分）：独立关键词命中，如\"背调\"、\"开发信\"、\"海关数据\"\n- **子串匹配**（+1 分）：关键词出现在句子中，如\"帮我查一下这个公司\"匹配到\"查公司\"\n- **显式调用**（最高优先级）：用\"用 b2b-xxx\" 或 \"加载 skill b2b-xxx\" 直接指定\n\n得分最高的 skill 会被激活。如果连续使用同一个 skill，系统会用简短的提示词继续（节省 token）。\n\n### 如何查看当前激活的技能\n\n当 Trade 匹配到一个 skill 时，在回复的开头会显示技能名称，如 `[SKILL AUGMENTATION] 技能触发：b2b-osint`。你也可以直接输入\"用 b2b-osint 查一下这个邮箱\"来强制指定某个技能。\n\n> **设计理念**：Trade 辅助用户梳理工作流程、生成邮件草稿、撰写文档，\n> **但不替用户直接发送邮件/文件给客户**。AI 可能出错，所有对外内容必须\n> 经用户复核确认后自主发出。`auto-smtp-email` 已被禁用，不会由系统触发。\n\n### 技能别名\n\n部分技能之间存在别名关联，输入一个技能名可能触发相关联的技能：\n\n| 输入技能 | 也会触发 |\n|----------|---------|\n| b2b-osint | b2b-email-intel |\n| b2b-lead-generation | b2b-customer-mgmt |\n| b2b-trade-ops | b2b-customer-mgmt |\n| auto-trade-customer-development | b2b-lead-generation, b2b-osint, ~~auto-smtp-email~~ |\n"}, "0f7afd6faca960727acc130792df53ef60e3c2ff": {"t": 1785772962.0058017, "n": 11612, "h": "a339a71dff46b820", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n .step-num { display:inline-block; width:32px; height:32px; line-height:32px;\n text-align:center; background:#2563EB; color:#fff; border-radius:50%;\n font-weight:bold; font-size:16px; margin-right:8px; }\n .step-title { font-size:1.3rem; font-weight:bold; margin:1.5rem 0 0.5rem; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">Windows 版安装教程 · 不需要懂技术，跟着步骤走，20 分钟装好</p>\n</div>\n\n<div style=\"text-align:center; margin:1rem 0;\">\n <p style=\"color:#8b949e; margin-bottom:0.5rem;\">安装遇到问题？扫码加微信，备注「Trade」</p>\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"180\" style=\"border-radius:8px;\">\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n## 第一步：确保科学上网已启动\n\n这个工具需要从 GitHub 下载代码，而 GitHub 在国内访问不稳定。在开始之前，**必须先打开你的科学上网工具**（VPN / Clash / V2Ray 等），确保网络通畅。\n\n**验证方法：** 打开 **Google Chrome 浏览器**，在地址栏输入 `github.com`，回车。如果页面能正常打开，说明网络没问题，可以继续。\n\n> 如果 GitHub 打不开，检查你的科学上网工具是否已启动、是否设为**全局模式**或 **TUN 模式**。\n\n---\n\n## 第二步：注册 DeepSeek 并获取 API Key\n\nAI 不是免费的，需要去 DeepSeek 注册账号并充值。\n\n1. 用 **Google Chrome 浏览器** 打开 **platform.deepseek.com**\n2. 点击「注册」，用手机号注册一个账号\n3. 登录后，点击页面上的「**充值**」，**充值 10 元以上**（按用量扣费，10 块钱能用很久）\n4. 在左侧菜单找到「**API Keys**」，点击进入\n5. 点击「**创建 API Key**」，名称填 `trade`，点确定\n6. 页面上会显示一串字符（以 `sk-` 开头）——这就是你的 **DeepSeek API Key**\n7. **立刻复制保存**，关掉后就再也看不到了\n\n> 把这串 Key 先粘贴到记事本里，后面要用。\n\n---\n\n## 第三步：注册 Tavily 并获取 API Key\n\nTavily 是联网搜索引擎，让 AI 能搜索实时信息。\n\n1. 用 **Google Chrome 浏览器** 打开 **tavily.com**\n2. 点击「Sign Up」，**用 Gmail 邮箱注册**一个账号\n3. 登录后进入 Dashboard，在 API Keys 区域找到你的 Key（以 `tvly-` 开头）\n4. **复制保存**到记事本里\n\n> Tavily 每月有 1000 次免费搜索额度，个人使用足够了。\n\n---\n\n## 第四步：在桌面创建 API Key 文件\n\n把刚才拿到的两个 Key 整理到一个文件里，后面配置时会用到。\n\n1. 在桌面上**右键** → 新建 → 文本文档\n2. 把文件重命名为 `apikey.txt`\n3. 打开文件，按以下格式粘贴：\n\n```\nDeepSeek API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nTavily API Key: tvly-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\n4. 保存并关闭。后面配置 Hermes 时需要从这里复制粘贴。\n\n---\n\n## 第五步：安装 Hermes Agent（AI 引擎）\n\nHermes Agent 是驱动 AI 的底层引擎，Trade 基于它运行。\n\n### 5.1 以管理员身份打开 PowerShell\n\n1. 按键盘 **Win 键**，输入 `powershell`\n2. **右键点击**搜索结果里的「Windows PowerShell」\n3. 选择「**以管理员身份运行**」\n4. 弹出提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n\n### 5.2 开启长路径支持\n\n在 PowerShell 里粘贴下面这行命令，按回车：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n### 5.3 一键安装 Hermes\n\n接着执行下面这行命令：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n等待几分钟，看到「安装完成」提示即可。\n\n> 在 PowerShell 里粘贴的方法是**点一下鼠标右键**（不是 Ctrl+V）。\n\n---\n\n## 第六步：配置 Hermes（大模型 + 搜索）\n\n安装完成后，在同一个 PowerShell 窗口输入：\n\n```\nhermes setup\n```\n\n这时会出现交互配置界面，按以下步骤操作：\n\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」→ 按回车\n2. 选择模型时，选「**deepseek-v4-flash**」（即 DeepSeek V4 Flash）→ 按回车\n3. 粘贴你的 **DeepSeek API Key**（从桌面的 `apikey.txt` 复制）→ 按回车\n4. 搜索服务选「**Tavily**」→ 按回车\n5. 粘贴你的 **Tavily API Key** → 按回车\n\n看到「配置成功」提示就完成了。\n\n---\n\n## 第七步：验证 Hermes 是否正常\n\n在 PowerShell 里输入：\n\n```\nhermes\n```\n\n等它启动后，在对话框里输入：\n\n```\nhello\n```\n\n按回车发送。如果 AI 正常回复了，说明大模型配置成功。\n\n> 按 `Ctrl+C` 可以退出 Hermes，回到命令行。\n\n---\n\n## 第八步：让 AI 帮你安装 Trade\n\n重新启动 Hermes（输入 `hermes`），在聊天框里**复制粘贴**下面这句话：\n\n```\n请帮我安装 trade，地址是 https://github.com/chefroger/smart-trade-ai\n```\n\nAI 会自己去 GitHub 查看项目说明，然后自动执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。\n\n装完后，**关闭当前 PowerShell，重新打开一个新的**，输入：\n\n```\ntrade\n```\n\n浏览器会自动打开 Trade 界面。如果没有自动打开，手动访问 **http://127.0.0.1:9119/trade**。\n\n> 验证能用后，按 `Ctrl+C` 退出 trade（暂时退出，下一步设置开机自启后会自动运行）。\n\n---\n\n## 第九步：设置 Hermes Gateway 开机自启\n\nHermes Gateway 是定时任务调度器，Trade 的定时简报、定时询盘检查都依赖它。必须让它随系统启动，否则每天还要手动开。\n\n在 PowerShell 里执行：\n\n```\nhermes gateway install\n```\n\n看到「服务已安装」或类似提示即成功。**以后开机时 Hermes Gateway 会自动在后台运行，无需手动启动。**\n\n> 验证是否装好：按 `Win+R`，输入 `services.msc`，回车。在列表里找到「Hermes Gateway」服务，状态应为「正在运行」。\n\n---\n\n## 第十步：设置 Trade 开机自启（无终端窗口）\n\n上一步装好了 Gateway，但 Trade 本身还没设为自启。这一步用**注册表 + VBS 脚本**的方式让 Trade 开机自动运行，**且不弹出任何终端窗口**——开机后直接打开浏览器访问 **http://127.0.0.1:9119/trade** 就能用。\n\n### 10.1 创建启动器脚本（VBS + BAT，带日志）\n\n把下面**整段命令**复制粘贴到 PowerShell 里，按回车：\n\n```powershell\n# 探测 trade.exe 完整路径（避免开机时 PATH 未完全加载导致找不到）\n$tradeExe = (Get-Command trade -ErrorAction Stop).Source\nif (-not $tradeExe) {\n Write-Host \"❌ 找不到 trade.exe，请先确认 trade 已安装\" -ForegroundColor Red\n} else {\n Write-Host \"找到 trade.exe：$tradeExe\" -ForegroundColor Green\n $dir = \"$env:LOCALAPPDATA\\trade\"\n $bat = \"$dir\\trade-autostart.bat\"\n $vbs = \"$dir\\trade-autostart.vbs\"\n $logFile = \"$dir\\trade-autostart.log\"\n New-Item -ItemType Directory -Force -Path $dir | Out-Null\n\n # .bat 用完整路径调用 trade.exe 并重定向日志（启动失败时可查日志）\n @\"\n@echo off\n\"$tradeExe\" > \"$logFile\" 2>&1\n\"@ | Out-File -FilePath $bat -Encoding ASCII\n\n # VBS 隐藏窗口启动 .bat（不等待，不弹窗）\n @\"\nSet WshShell = CreateObject(\"WScript.Shell\")\nWshShell.Run \"cmd /c \"\"$bat\"\"\", 0, False\n\"@ | Out-File -FilePath $vbs -Encoding ASCII\n\n Write-Host \"已创建启动器：$vbs\" -ForegroundColor Green\n Write-Host \"日志文件：$logFile（启动失败时打开它排查）\" -ForegroundColor Yellow\n}\n```\n\n看到绿色「已创建启动器」即成功。\n\n> **这段命令做了什么：**\n> 1. 用 `Get-Command trade` 探测 `trade.exe` 的完整路径，写入 .bat 文件——**不依赖 PATH**，开机早期也能找到\n> 2. .bat 把 trade 的所有输出重定向到 `trade-autostart.log`——启动失败时打开这个日志就能看到错误，不用两眼一抹黑\n> 3. VBS 以**隐藏窗口**模式启动 .bat——不会弹出黑框终端\n\n### 10.2 写入注册表，开机自动运行该脚本\n\n继续在 PowerShell 里粘贴下面这行，按回车：\n\n```powershell\nNew-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Value \"wscript.exe `\"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs`\"\" -PropertyType String -Force\n```\n\n没有报错就说明写入成功。\n\n### 10.3 立即测试（可选但推荐）\n\n不想等到明天才验证？在 PowerShell 里执行：\n\n```powershell\nwscript.exe \"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs\"\n```\n\n等约 15 秒，然后打开浏览器访问 **http://127.0.0.1:9119/trade**。如果能看到 Trade 界面，且**没有弹出任何终端窗口**，说明配置完全正确。\n\n> **如果打不开**：打开文件 `%LOCALAPPDATA%\\trade\\trade-autostart.log`（直接在资源管理器地址栏粘贴这个路径回车），看里面的错误信息。最常见的是 `ModuleNotFoundError`——说明 trade 安装有问题，回到第八步重装。\n\n> **以后的使用方式：** 每天打开电脑，等约 30 秒（系统启动 + Trade 自动启动），直接浏览器访问 **http://127.0.0.1:9119/trade** 即可，**再也不用打开 PowerShell 手动输入 `trade`**。\n\n### 10.4 如果想取消开机自启\n\n将来不想要自启了，在 PowerShell 里执行：\n\n```powershell\nRemove-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Force\n```\n\n即可移除自启，不影响 Trade 本身的使用。\n\n---\n\n## 如何更新 Trade\n\nTrade 会持续更新，新版本增加功能和修复问题。最简单的方式是让 AI 帮你更新：\n\n1. 按 `Win+R`，输入 `powershell`，回车\n2. 输入 `hermes` 启动 Hermes\n3. 在对话框里输入：\n\n```\n帮我更新trade，并重启trade，地址是https://github.com/chefroger/smart-trade-ai\n```\n\n4. 等 AI 执行完毕，看到「重启完成」提示后，刷新浏览器页面（`Ctrl+Shift+R`）即可。\n\n> 如果 `hermes` 命令找不到，说明 Hermes 没装好，回到第五步重装。\n\n---\n\n## 常见问题\n\n| 你看到的现象 | 怎么解决 |\n|------------|---------|\n| 第五步安装 Hermes 卡住不动 | 科学上网没开好。确认 VPN 是全局模式，关掉 PowerShell 重开再试 |\n| `hermes` 输入后提示「不是内部或外部命令」 | 关掉 PowerShell 重新打开一个新的 |\n| `trade` 输入后提示「不是内部或外部命令」 | 改成输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 然后 `python server.py` |\n| Hermes 对话没反应 | API Key 没配置对。重新运行 `hermes setup` 检查 |\n| 浏览器打开显示「无法访问此网站」 | 程序没在运行。打开一个新的 PowerShell，输入 `trade` 启动 |\n| 开机后访问 127.0.0.1:9119/trade 打不开 | Trade 自启还没跑完，等 30 秒再试。若仍不行，打开 `%LOCALAPPDATA%\\trade\\trade-autostart.log` 看错误日志；或按 `Win+R` 输入 `taskmgr` 回车，看进程里有没有 `python.exe`，没有就手动运行第十步的 VBS 脚本 |\n| 定时任务（每日简报等）不执行 | 第九步的 Hermes Gateway 没装好或没运行。重新执行 `hermes gateway install`，再到 `services.msc` 确认服务状态 |\n| 提示「Filename too long」 | 第五步的长路径设置没做。回到 5.2 执行那行命令，然后**重启电脑** |\n\n---\n\n<p style=\"text-align:center; color:#8b949e; margin-top:3rem;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n\n---\n\n## Skills 参考手册\n\nTrade 会自动识别你的意图，匹配合适的技能。以下是全部 33 个技能的详细说明和使用示例。\n\n### 33 个技能速查\n\n| # | 技能 | 功能 | 典型提示词示例 |\n|---|------|------|---------------|\n| 1 | **b2b-osint** | 客户背景调查（6 层检测） | 帮我查一下这家公司 / 背调这个邮箱 / 查一下域名注册时间 |\n| 2 | **b2b-email-intel** | 邮箱情报（120+ 平台检测） | 查一下这个邮箱哪个平台注册了 / 邮箱是真的吗 |\n| 3 | **b2b-lead-generation** | 多通道客户搜索与开发 | 帮我找一下德国的 XX 产品客户 / 写一封开发信给美国客户 |\n| 4 | **b2b-document** | 本地文档分析与提取 | 分析一下这份报价单 / 帮我看看这个合同有什么问题 |\n| 5 | **b2b-doc-generation** | 生成报价/合同/提案文件 | 帮我生成一份 PDF 报价单 / 做一份产品介绍 PPT |\n| 6 | **b2b-platform** | B2B 平台店铺诊断优化 | 帮我看看这个阿里国际站产品页 / 优化一下产品标题 |\n| 7 | **b2b-linkedin-marketing** | LinkedIn 营销策略与内容 | 帮我想一下领英发什么内容 / 写一个 LinkedIn Add Note |\n| 8 | **b2b-social-media** | 社媒营销（FB/Ins/TikTok/YT） | 帮我做一个 Facebook 内容计划 / 写一个 TikTok 脚本 |\n| 9 | **b2b-customs-data** | 海关数据分析找采购商 | 帮我看看谁在进口这个产品 / 分析一下这个 HS 编码 |\n| 10 | **b2b-onboarding** | 新公司全套部署方案 | 我刚做外贸，帮我制定一个营销方案 / 新公司怎么开始 |\n| 11 | **b2b-daily-automation** | 定时任务（早报/晚报/周报） | 每天早上 8 点给我一份简报 / 设置一个每日工作总结 |\n| 12 | **b2b-customer-mgmt** | 客户档案与分级管理 | 帮我查一下 XX 公司的信息 / A 级客户有哪些 |\n| 13 | **b2b-data-directory** | 数据目录结构管理 | 我的数据存在哪了 / 帮我初始化一下数据目录 |\n| 14 | **chat-memory** | 历史对话查询 | 上次和 XX 公司聊到什么了 / 之前那份报价是多少 |\n| 15 | **b2b-skill-generator** | 动态创建新的 B2B Skill | 帮我创建一个新的 skill，用来查 XX |\n| 16 | **b2b-trade-ops** | 外贸履约与售后沟通 | 帮我写一封催款邮件 / 客户投诉质量有问题怎么办 |\n| 17 | **b2b-trade-compliance** | 合规检查与文化禁忌 | 这个颜色在沙特有什么忌讳吗 / 检查一下 FOB 写对了没有 |\n| 18 | **b2b-cold-outreach** | 冷 outreach 邮件撰写 | 给德国的 XX 公司写一封开发信 / 写一封产品推广信 |\n| 19 | **auto-trade-customer-development** | 全自动客户开发流水线 | 帮我跑一轮自动化客户开发 / 全自动开发一批客户 |\n| 20 | ~~**auto-smtp-email**~~ | ~~SMTP 邮件发送 — 已禁用~~ | ~~把这封开发信发出去 / 群发这批邮件~~ |\n| 21 | **b2b-email-imitation** | 开发信仿写与再创作 | 参考这封邮件，帮我写一个类似的 / 模仿这个风格写一封开发信 |\n| 22 | **b2b-buyer-persona** | 买家画像与角色分层 | 帮我分析一下买家画像 / 针对采购经理应该怎么沟通 |\n| 23 | **b2b-market-analysis** | 市场分析作战地图 | 分析一下德国市场进入策略 / 帮我做一个中东市场调研 |\n| 24 | **b2b-sales-pipeline** | 销售管线与跟进策略 | 这个客户一个月没回了怎么办 / 帮我设计一个 30 天跟进计划 |\n| 25 | **b2b-inquiry-training** | 询盘回复训练 | 帮我练一下询盘回复 / 模拟一个刁钻买家 |\n| 26 | **b2b-kol-imitation** | KOL 风格模仿 | 模仿这个领英大V的风格 / 分析这个账号的内容策略 |\n| 27 | **b2b-reddit-engagement** | Reddit 社区互动 | 帮我在 Reddit 写一条专业评论 / 在哪个 subreddit 发帖 |\n| 28 | **b2b-seo-aeo** | SEO+AEO 文章生成 | 写一篇针对 AI 搜索优化的行业文章 / 帮我做 Pillar Page |\n| 29 | **b2b-short-video** | 短视频脚本生成 | 帮我写一个 TikTok 产品视频脚本 / 工厂参观短视频 |\n| 30 | **b2b-exhibition** | 展会全流程管理 | 帮我写展会邀约邮件 / 展会后的跟进计划 |\n| 31 | **b2b-product-description** | 产品描述生成 | 帮我把这款产品写成销售资料 / 用 FAB 分析产品卖点 |\n| 32 | **b2b-six-thinking-hats** | 六顶思考帽决策 | 帮我分析这个决策 / 要不要给这个客户独家代理权 |\n| 33 | **b2b-customer-intel** | 客户深度画像 | 帮我做一份某客户的深度画像 / 这个客户有什么偏好 |\n\n### 技能自动匹配原理\n\n当你在聊天框输入内容时，Trade 会自动匹配关键词，调用最合适的 skill。匹配规则：\n\n- **词边界匹配**（+3 分）：独立关键词命中，如\"背调\"、\"开发信\"、\"海关数据\"\n- **子串匹配**（+1 分）：关键词出现在句子中，如\"帮我查一下这个公司\"匹配到\"查公司\"\n- **显式调用**（最高优先级）：用\"用 b2b-xxx\" 或 \"加载 skill b2b-xxx\" 直接指定\n\n得分最高的 skill 会被激活。如果连续使用同一个 skill，系统会用简短的提示词继续（节省 token）。\n\n### 如何查看当前激活的技能\n\n当 Trade 匹配到一个 skill 时，在回复的开头会显示技能名称，如 `[SKILL AUGMENTATION] 技能触发：b2b-osint`。你也可以直接输入\"用 b2b-osint 查一下这个邮箱\"来强制指定某个技能。\n\n> **设计理念**：Trade 辅助用户梳理工作流程、生成邮件草稿、撰写文档，\n> **但不替用户直接发送邮件/文件给客户**。AI 可能出错，所有对外内容必须\n> 经用户复核确认后自主发出。`auto-smtp-email` 已被禁用，不会由系统触发。\n\n### 技能别名\n\n部分技能之间存在别名关联，输入一个技能名可能触发相关联的技能：\n\n| 输入技能 | 也会触发 |\n|----------|---------|\n| b2b-osint | b2b-email-intel |\n| b2b-lead-generation | b2b-customer-mgmt |\n| b2b-trade-ops | b2b-customer-mgmt |\n| auto-trade-customer-development | b2b-lead-generation, b2b-osint, ~~auto-smtp-email~~ |\n"}, "a3d63776953ae2c495fca19ececd353baced3cb7": {"t": 1785772963.5245678, "n": 11306, "h": "5fe6cbc79c1c3799", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n .step-num { display:inline-block; width:32px; height:32px; line-height:32px;\n text-align:center; background:#2563EB; color:#fff; border-radius:50%;\n font-weight:bold; font-size:16px; margin-right:8px; }\n .step-title { font-size:1.3rem; font-weight:bold; margin:1.5rem 0 0.5rem; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">Windows 版安装教程 · 不需要懂技术，跟着步骤走，20 分钟装好</p>\n</div>\n\n<div style=\"text-align:center; margin:1rem 0;\">\n <p style=\"color:#8b949e; margin-bottom:0.5rem;\">安装遇到问题？扫码加微信，备注「Trade」</p>\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"180\" style=\"border-radius:8px;\">\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n## 第一步：确保科学上网已启动\n\n这个工具需要从 GitHub 下载代码，而 GitHub 在国内访问不稳定。在开始之前，**必须先打开你的科学上网工具**（VPN / Clash / V2Ray 等），确保网络通畅。\n\n**验证方法：** 打开 **Google Chrome 浏览器**，在地址栏输入 `github.com`，回车。如果页面能正常打开，说明网络没问题，可以继续。\n\n> 如果 GitHub 打不开，检查你的科学上网工具是否已启动、是否设为**全局模式**或 **TUN 模式**。\n\n---\n\n## 第二步：注册 DeepSeek 并获取 API Key\n\nAI 不是免费的，需要去 DeepSeek 注册账号并充值。\n\n1. 用 **Google Chrome 浏览器** 打开 **platform.deepseek.com**\n2. 点击「注册」，用手机号注册一个账号\n3. 登录后，点击页面上的「**充值**」，**充值 10 元以上**（按用量扣费，10 块钱能用很久）\n4. 在左侧菜单找到「**API Keys**」，点击进入\n5. 点击「**创建 API Key**」，名称填 `trade`，点确定\n6. 页面上会显示一串字符（以 `sk-` 开头）——这就是你的 **DeepSeek API Key**\n7. **立刻复制保存**，关掉后就再也看不到了\n\n> 把这串 Key 先粘贴到记事本里，后面要用。\n\n---\n\n## 第三步：注册 Tavily 并获取 API Key\n\nTavily 是联网搜索引擎，让 AI 能搜索实时信息。\n\n1. 用 **Google Chrome 浏览器** 打开 **tavily.com**\n2. 点击「Sign Up」，**用 Gmail 邮箱注册**一个账号\n3. 登录后进入 Dashboard，在 API Keys 区域找到你的 Key（以 `tvly-` 开头）\n4. **复制保存**到记事本里\n\n> Tavily 每月有 1000 次免费搜索额度，个人使用足够了。\n\n---\n\n## 第四步：在桌面创建 API Key 文件\n\n把刚才拿到的两个 Key 整理到一个文件里，后面配置时会用到。\n\n1. 在桌面上**右键** → 新建 → 文本文档\n2. 把文件重命名为 `apikey.txt`\n3. 打开文件，按以下格式粘贴：\n\n```\nDeepSeek API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nTavily API Key: tvly-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\n4. 保存并关闭。后面配置 Hermes 时需要从这里复制粘贴。\n\n---\n\n## 第五步：安装 Hermes Agent（AI 引擎）\n\nHermes Agent 是驱动 AI 的底层引擎，Trade 基于它运行。\n\n### 5.1 以管理员身份打开 PowerShell\n\n1. 按键盘 **Win 键**，输入 `powershell`\n2. **右键点击**搜索结果里的「Windows PowerShell」\n3. 选择「**以管理员身份运行**」\n4. 弹出提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n\n### 5.2 开启长路径支持\n\n在 PowerShell 里粘贴下面这行命令，按回车：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n### 5.3 一键安装 Hermes\n\n接着执行下面这行命令：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n等待几分钟，看到「安装完成」提示即可。\n\n> 在 PowerShell 里粘贴的方法是**点一下鼠标右键**（不是 Ctrl+V）。\n\n---\n\n## 第六步：配置 Hermes（大模型 + 搜索）\n\n安装完成后，在同一个 PowerShell 窗口输入：\n\n```\nhermes setup\n```\n\n这时会出现交互配置界面，按以下步骤操作：\n\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」→ 按回车\n2. 选择模型时，选「**deepseek-v4-flash**」（即 DeepSeek V4 Flash）→ 按回车\n3. 粘贴你的 **DeepSeek API Key**（从桌面的 `apikey.txt` 复制）→ 按回车\n4. 搜索服务选「**Tavily**」→ 按回车\n5. 粘贴你的 **Tavily API Key** → 按回车\n\n看到「配置成功」提示就完成了。\n\n---\n\n## 第七步：验证 Hermes 是否正常\n\n在 PowerShell 里输入：\n\n```\nhermes\n```\n\n等它启动后，在对话框里输入：\n\n```\nhello\n```\n\n按回车发送。如果 AI 正常回复了，说明大模型配置成功。\n\n> 按 `Ctrl+C` 可以退出 Hermes，回到命令行。\n\n---\n\n## 第八步：让 AI 帮你安装 Trade\n\n重新启动 Hermes（输入 `hermes`），在聊天框里**复制粘贴**下面这句话：\n\n```\n请帮我安装 trade，地址是 https://github.com/chefroger/smart-trade-ai\n```\n\nAI 会自己去 GitHub 查看项目说明，然后自动执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。\n\n装完后，**关闭当前 PowerShell，重新打开一个新的**，输入：\n\n```\ntrade\n```\n\n浏览器会自动打开 Trade 界面。如果没有自动打开，手动访问 **http://127.0.0.1:9119/trade**。\n\n> 验证能用后，按 `Ctrl+C` 退出 trade（暂时退出，下一步设置开机自启后会自动运行）。\n\n---\n\n## 第九步：设置 Hermes Gateway 开机自启\n\nHermes Gateway 是定时任务调度器，Trade 的定时简报、定时询盘检查都依赖它。必须让它随系统启动，否则每天还要手动开。\n\n在 PowerShell 里执行：\n\n```\nhermes gateway install\n```\n\n看到「服务已安装」或类似提示即成功。**以后开机时 Hermes Gateway 会自动在后台运行，无需手动启动。**\n\n> 验证是否装好：按 `Win+R`，输入 `services.msc`，回车。在列表里找到「Hermes Gateway」服务，状态应为「正在运行」。\n\n---\n\n## 第十步：设置 Trade 开机自启（无终端窗口）\n\n上一步装好了 Gateway，但 Trade 本身还没设为自启。这一步用**注册表 + VBS 脚本**的方式让 Trade 开机自动运行，**且不弹出任何终端窗口**——开机后直接打开浏览器访问 **http://127.0.0.1:9119/trade** 就能用。\n\n### 10.1 创建启动器脚本（VBS + BAT，带日志）\n\n把下面**整段命令**复制粘贴到 PowerShell 里，按回车：\n\n```powershell\n# 探测 trade.exe 完整路径（避免开机时 PATH 未完全加载导致找不到）\n$tradeExe = (Get-Command trade -ErrorAction Stop).Source\nif (-not $tradeExe) {\n Write-Host \"❌ 找不到 trade.exe，请先确认 trade 已安装\" -ForegroundColor Red\n} else {\n Write-Host \"找到 trade.exe：$tradeExe\" -ForegroundColor Green\n $dir = \"$env:LOCALAPPDATA\\trade\"\n $bat = \"$dir\\trade-autostart.bat\"\n $vbs = \"$dir\\trade-autostart.vbs\"\n $logFile = \"$dir\\trade-autostart.log\"\n New-Item -ItemType Directory -Force -Path $dir | Out-Null\n\n # .bat 用完整路径调用 trade.exe 并重定向日志（启动失败时可查日志）\n @\"\n@echo off\n\"$tradeExe\" > \"$logFile\" 2>&1\n\"@ | Out-File -FilePath $bat -Encoding ASCII\n\n # VBS 隐藏窗口启动 .bat（不等待，不弹窗）\n @\"\nSet WshShell = CreateObject(\"WScript.Shell\")\nWshShell.Run \"cmd /c \"\"$bat\"\"\", 0, False\n\"@ | Out-File -FilePath $vbs -Encoding ASCII\n\n Write-Host \"已创建启动器：$vbs\" -ForegroundColor Green\n Write-Host \"日志文件：$logFile（启动失败时打开它排查）\" -ForegroundColor Yellow\n}\n```\n\n看到绿色「已创建启动器」即成功。\n\n> **这段命令做了什么：**\n> 1. 用 `Get-Command trade` 探测 `trade.exe` 的完整路径，写入 .bat 文件——**不依赖 PATH**，开机早期也能找到\n> 2. .bat 把 trade 的所有输出重定向到 `trade-autostart.log`——启动失败时打开这个日志就能看到错误，不用两眼一抹黑\n> 3. VBS 以**隐藏窗口**模式启动 .bat——不会弹出黑框终端\n\n### 10.2 写入注册表，开机自动运行该脚本\n\n继续在 PowerShell 里粘贴下面这行，按回车：\n\n```powershell\nNew-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Value \"wscript.exe `\"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs`\"\" -PropertyType String -Force\n```\n\n没有报错就说明写入成功。\n\n### 10.3 立即测试（可选但推荐）\n\n不想等到明天才验证？在 PowerShell 里执行：\n\n```powershell\nwscript.exe \"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs\"\n```\n\n等约 15 秒，然后打开浏览器访问 **http://127.0.0.1:9119/trade**。如果能看到 Trade 界面，且**没有弹出任何终端窗口**，说明配置完全正确。\n\n> **如果打不开**：打开文件 `%LOCALAPPDATA%\\trade\\trade-autostart.log`（直接在资源管理器地址栏粘贴这个路径回车），看里面的错误信息。最常见的是 `ModuleNotFoundError`——说明 trade 安装有问题，回到第八步重装。\n\n> **以后的使用方式：** 每天打开电脑，等约 30 秒（系统启动 + Trade 自动启动），直接浏览器访问 **http://127.0.0.1:9119/trade** 即可，**再也不用打开 PowerShell 手动输入 `trade`**。\n\n### 10.4 如果想取消开机自启\n\n将来不想要自启了，在 PowerShell 里执行：\n\n```powershell\nRemove-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Force\n```\n\n即可移除自启，不影响 Trade 本身的使用。\n\n---\n\n## 常见问题\n\n| 你看到的现象 | 怎么解决 |\n|------------|---------|\n| 第五步安装 Hermes 卡住不动 | 科学上网没开好。确认 VPN 是全局模式，关掉 PowerShell 重开再试 |\n| `hermes` 输入后提示「不是内部或外部命令」 | 关掉 PowerShell 重新打开一个新的 |\n| `trade` 输入后提示「不是内部或外部命令」 | 改成输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 然后 `python server.py` |\n| Hermes 对话没反应 | API Key 没配置对。重新运行 `hermes setup` 检查 |\n| 浏览器打开显示「无法访问此网站」 | 程序没在运行。打开一个新的 PowerShell，输入 `trade` 启动 |\n| 开机后访问 127.0.0.1:9119/trade 打不开 | Trade 自启还没跑完，等 30 秒再试。若仍不行，打开 `%LOCALAPPDATA%\\trade\\trade-autostart.log` 看错误日志；或按 `Win+R` 输入 `taskmgr` 回车，看进程里有没有 `python.exe`，没有就手动运行第十步的 VBS 脚本 |\n| 定时任务（每日简报等）不执行 | 第九步的 Hermes Gateway 没装好或没运行。重新执行 `hermes gateway install`，再到 `services.msc` 确认服务状态 |\n| 提示「Filename too long」 | 第五步的长路径设置没做。回到 5.2 执行那行命令，然后**重启电脑** |\n\n---\n\n<p style=\"text-align:center; color:#8b949e; margin-top:3rem;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n\n---\n\n## Skills 参考手册\n\nTrade 会自动识别你的意图，匹配合适的技能。以下是全部 33 个技能的详细说明和使用示例。\n\n### 33 个技能速查\n\n| # | 技能 | 功能 | 典型提示词示例 |\n|---|------|------|---------------|\n| 1 | **b2b-osint** | 客户背景调查（6 层检测） | 帮我查一下这家公司 / 背调这个邮箱 / 查一下域名注册时间 |\n| 2 | **b2b-email-intel** | 邮箱情报（120+ 平台检测） | 查一下这个邮箱哪个平台注册了 / 邮箱是真的吗 |\n| 3 | **b2b-lead-generation** | 多通道客户搜索与开发 | 帮我找一下德国的 XX 产品客户 / 写一封开发信给美国客户 |\n| 4 | **b2b-document** | 本地文档分析与提取 | 分析一下这份报价单 / 帮我看看这个合同有什么问题 |\n| 5 | **b2b-doc-generation** | 生成报价/合同/提案文件 | 帮我生成一份 PDF 报价单 / 做一份产品介绍 PPT |\n| 6 | **b2b-platform** | B2B 平台店铺诊断优化 | 帮我看看这个阿里国际站产品页 / 优化一下产品标题 |\n| 7 | **b2b-linkedin-marketing** | LinkedIn 营销策略与内容 | 帮我想一下领英发什么内容 / 写一个 LinkedIn Add Note |\n| 8 | **b2b-social-media** | 社媒营销（FB/Ins/TikTok/YT） | 帮我做一个 Facebook 内容计划 / 写一个 TikTok 脚本 |\n| 9 | **b2b-customs-data** | 海关数据分析找采购商 | 帮我看看谁在进口这个产品 / 分析一下这个 HS 编码 |\n| 10 | **b2b-onboarding** | 新公司全套部署方案 | 我刚做外贸，帮我制定一个营销方案 / 新公司怎么开始 |\n| 11 | **b2b-daily-automation** | 定时任务（早报/晚报/周报） | 每天早上 8 点给我一份简报 / 设置一个每日工作总结 |\n| 12 | **b2b-customer-mgmt** | 客户档案与分级管理 | 帮我查一下 XX 公司的信息 / A 级客户有哪些 |\n| 13 | **b2b-data-directory** | 数据目录结构管理 | 我的数据存在哪了 / 帮我初始化一下数据目录 |\n| 14 | **chat-memory** | 历史对话查询 | 上次和 XX 公司聊到什么了 / 之前那份报价是多少 |\n| 15 | **b2b-skill-generator** | 动态创建新的 B2B Skill | 帮我创建一个新的 skill，用来查 XX |\n| 16 | **b2b-trade-ops** | 外贸履约与售后沟通 | 帮我写一封催款邮件 / 客户投诉质量有问题怎么办 |\n| 17 | **b2b-trade-compliance** | 合规检查与文化禁忌 | 这个颜色在沙特有什么忌讳吗 / 检查一下 FOB 写对了没有 |\n| 18 | **b2b-cold-outreach** | 冷 outreach 邮件撰写 | 给德国的 XX 公司写一封开发信 / 写一封产品推广信 |\n| 19 | **auto-trade-customer-development** | 全自动客户开发流水线 | 帮我跑一轮自动化客户开发 / 全自动开发一批客户 |\n| 20 | ~~**auto-smtp-email**~~ | ~~SMTP 邮件发送 — 已禁用~~ | ~~把这封开发信发出去 / 群发这批邮件~~ |\n| 21 | **b2b-email-imitation** | 开发信仿写与再创作 | 参考这封邮件，帮我写一个类似的 / 模仿这个风格写一封开发信 |\n| 22 | **b2b-buyer-persona** | 买家画像与角色分层 | 帮我分析一下买家画像 / 针对采购经理应该怎么沟通 |\n| 23 | **b2b-market-analysis** | 市场分析作战地图 | 分析一下德国市场进入策略 / 帮我做一个中东市场调研 |\n| 24 | **b2b-sales-pipeline** | 销售管线与跟进策略 | 这个客户一个月没回了怎么办 / 帮我设计一个 30 天跟进计划 |\n| 25 | **b2b-inquiry-training** | 询盘回复训练 | 帮我练一下询盘回复 / 模拟一个刁钻买家 |\n| 26 | **b2b-kol-imitation** | KOL 风格模仿 | 模仿这个领英大V的风格 / 分析这个账号的内容策略 |\n| 27 | **b2b-reddit-engagement** | Reddit 社区互动 | 帮我在 Reddit 写一条专业评论 / 在哪个 subreddit 发帖 |\n| 28 | **b2b-seo-aeo** | SEO+AEO 文章生成 | 写一篇针对 AI 搜索优化的行业文章 / 帮我做 Pillar Page |\n| 29 | **b2b-short-video** | 短视频脚本生成 | 帮我写一个 TikTok 产品视频脚本 / 工厂参观短视频 |\n| 30 | **b2b-exhibition** | 展会全流程管理 | 帮我写展会邀约邮件 / 展会后的跟进计划 |\n| 31 | **b2b-product-description** | 产品描述生成 | 帮我把这款产品写成销售资料 / 用 FAB 分析产品卖点 |\n| 32 | **b2b-six-thinking-hats** | 六顶思考帽决策 | 帮我分析这个决策 / 要不要给这个客户独家代理权 |\n| 33 | **b2b-customer-intel** | 客户深度画像 | 帮我做一份某客户的深度画像 / 这个客户有什么偏好 |\n\n### 技能自动匹配原理\n\n当你在聊天框输入内容时，Trade 会自动匹配关键词，调用最合适的 skill。匹配规则：\n\n- **词边界匹配**（+3 分）：独立关键词命中，如\"背调\"、\"开发信\"、\"海关数据\"\n- **子串匹配**（+1 分）：关键词出现在句子中，如\"帮我查一下这个公司\"匹配到\"查公司\"\n- **显式调用**（最高优先级）：用\"用 b2b-xxx\" 或 \"加载 skill b2b-xxx\" 直接指定\n\n得分最高的 skill 会被激活。如果连续使用同一个 skill，系统会用简短的提示词继续（节省 token）。\n\n### 如何查看当前激活的技能\n\n当 Trade 匹配到一个 skill 时，在回复的开头会显示技能名称，如 `[SKILL AUGMENTATION] 技能触发：b2b-osint`。你也可以直接输入\"用 b2b-osint 查一下这个邮箱\"来强制指定某个技能。\n\n> **设计理念**：Trade 辅助用户梳理工作流程、生成邮件草稿、撰写文档，\n> **但不替用户直接发送邮件/文件给客户**。AI 可能出错，所有对外内容必须\n> 经用户复核确认后自主发出。`auto-smtp-email` 已被禁用，不会由系统触发。\n\n### 技能别名\n\n部分技能之间存在别名关联，输入一个技能名可能触发相关联的技能：\n\n| 输入技能 | 也会触发 |\n|----------|---------|\n| b2b-osint | b2b-email-intel |\n| b2b-lead-generation | b2b-customer-mgmt |\n| b2b-trade-ops | b2b-customer-mgmt |\n| auto-trade-customer-development | b2b-lead-generation, b2b-osint, ~~auto-smtp-email~~ |\n"}, "c75a6ed1997067fe2e52f78f47027e975b5f7316": {"t": 1785772966.015167, "n": 11237, "h": "0344c57b15acf61c", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n .step-num { display:inline-block; width:32px; height:32px; line-height:32px;\n text-align:center; background:#2563EB; color:#fff; border-radius:50%;\n font-weight:bold; font-size:16px; margin-right:8px; }\n .step-title { font-size:1.3rem; font-weight:bold; margin:1.5rem 0 0.5rem; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">Windows 版安装教程 · 不需要懂技术，跟着步骤走，20 分钟装好</p>\n</div>\n\n<div style=\"text-align:center; margin:1rem 0;\">\n <p style=\"color:#8b949e; margin-bottom:0.5rem;\">安装遇到问题？扫码加微信，备注「Trade」</p>\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"180\" style=\"border-radius:8px;\">\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n## 第一步：确保科学上网已启动\n\n这个工具需要从 GitHub 下载代码，而 GitHub 在国内访问不稳定。在开始之前，**必须先打开你的科学上网工具**（VPN / Clash / V2Ray 等），确保网络通畅。\n\n**验证方法：** 打开 **Google Chrome 浏览器**，在地址栏输入 `github.com`，回车。如果页面能正常打开，说明网络没问题，可以继续。\n\n> 如果 GitHub 打不开，检查你的科学上网工具是否已启动、是否设为**全局模式**或 **TUN 模式**。\n\n---\n\n## 第二步：注册 DeepSeek 并获取 API Key\n\nAI 不是免费的，需要去 DeepSeek 注册账号并充值。\n\n1. 用 **Google Chrome 浏览器** 打开 **platform.deepseek.com**\n2. 点击「注册」，用手机号注册一个账号\n3. 登录后，点击页面上的「**充值**」，**充值 10 元以上**（按用量扣费，10 块钱能用很久）\n4. 在左侧菜单找到「**API Keys**」，点击进入\n5. 点击「**创建 API Key**」，名称填 `trade`，点确定\n6. 页面上会显示一串字符（以 `sk-` 开头）——这就是你的 **DeepSeek API Key**\n7. **立刻复制保存**，关掉后就再也看不到了\n\n> 把这串 Key 先粘贴到记事本里，后面要用。\n\n---\n\n## 第三步：注册 Tavily 并获取 API Key\n\nTavily 是联网搜索引擎，让 AI 能搜索实时信息。\n\n1. 用 **Google Chrome 浏览器** 打开 **tavily.com**\n2. 点击「Sign Up」，**用 Gmail 邮箱注册**一个账号\n3. 登录后进入 Dashboard，在 API Keys 区域找到你的 Key（以 `tvly-` 开头）\n4. **复制保存**到记事本里\n\n> Tavily 每月有 1000 次免费搜索额度，个人使用足够了。\n\n---\n\n## 第四步：在桌面创建 API Key 文件\n\n把刚才拿到的两个 Key 整理到一个文件里，后面配置时会用到。\n\n1. 在桌面上**右键** → 新建 → 文本文档\n2. 把文件重命名为 `apikey.txt`\n3. 打开文件，按以下格式粘贴：\n\n```\nDeepSeek API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nTavily API Key: tvly-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\n4. 保存并关闭。后面配置 Hermes 时需要从这里复制粘贴。\n\n---\n\n## 第五步：安装 Hermes Agent（AI 引擎）\n\nHermes Agent 是驱动 AI 的底层引擎，Trade 基于它运行。\n\n### 5.1 以管理员身份打开 PowerShell\n\n1. 按键盘 **Win 键**，输入 `powershell`\n2. **右键点击**搜索结果里的「Windows PowerShell」\n3. 选择「**以管理员身份运行**」\n4. 弹出提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n\n### 5.2 开启长路径支持\n\n在 PowerShell 里粘贴下面这行命令，按回车：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n### 5.3 一键安装 Hermes\n\n接着执行下面这行命令：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n等待几分钟，看到「安装完成」提示即可。\n\n> 在 PowerShell 里粘贴的方法是**点一下鼠标右键**（不是 Ctrl+V）。\n\n---\n\n## 第六步：配置 Hermes（大模型 + 搜索）\n\n安装完成后，在同一个 PowerShell 窗口输入：\n\n```\nhermes setup\n```\n\n这时会出现交互配置界面，按以下步骤操作：\n\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」→ 按回车\n2. 选择模型时，选「**deepseek-v4-flash**」（即 DeepSeek V4 Flash）→ 按回车\n3. 粘贴你的 **DeepSeek API Key**（从桌面的 `apikey.txt` 复制）→ 按回车\n4. 搜索服务选「**Tavily**」→ 按回车\n5. 粘贴你的 **Tavily API Key** → 按回车\n\n看到「配置成功」提示就完成了。\n\n---\n\n## 第七步：验证 Hermes 是否正常\n\n在 PowerShell 里输入：\n\n```\nhermes\n```\n\n等它启动后，在对话框里输入：\n\n```\nhello\n```\n\n按回车发送。如果 AI 正常回复了，说明大模型配置成功。\n\n> 按 `Ctrl+C` 可以退出 Hermes，回到命令行。\n\n---\n\n## 第八步：让 AI 帮你安装 Trade\n\n重新启动 Hermes（输入 `hermes`），在聊天框里**复制粘贴**下面这句话：\n\n```\n请帮我安装 trade，地址是 https://github.com/chefroger/smart-trade-ai\n```\n\nAI 会自己去 GitHub 查看项目说明，然后自动执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。\n\n装完后，**关闭当前 PowerShell，重新打开一个新的**，输入：\n\n```\ntrade\n```\n\n浏览器会自动打开 Trade 界面。如果没有自动打开，手动访问 **http://127.0.0.1:9119/trade**。\n\n> 验证能用后，按 `Ctrl+C` 退出 trade（暂时退出，下一步设置开机自启后会自动运行）。\n\n---\n\n## 第九步：设置 Hermes Gateway 开机自启\n\nHermes Gateway 是定时任务调度器，Trade 的定时简报、定时询盘检查都依赖它。必须让它随系统启动，否则每天还要手动开。\n\n在 PowerShell 里执行：\n\n```\nhermes gateway install\n```\n\n看到「服务已安装」或类似提示即成功。**以后开机时 Hermes Gateway 会自动在后台运行，无需手动启动。**\n\n> 验证是否装好：按 `Win+R`，输入 `services.msc`，回车。在列表里找到「Hermes Gateway」服务，状态应为「正在运行」。\n\n---\n\n## 第十步：设置 Trade 开机自启（无终端窗口）\n\n上一步装好了 Gateway，但 Trade 本身还没设为自启。这一步用**注册表 + VBS 脚本**的方式让 Trade 开机自动运行，**且不弹出任何终端窗口**——开机后直接打开浏览器访问 **http://127.0.0.1:9119/trade** 就能用。\n\n### 10.1 创建启动器脚本（VBS + BAT，带日志）\n\n把下面**整段命令**复制粘贴到 PowerShell 里，按回车：\n\n```powershell\n# 探测 trade.exe 完整路径（避免开机时 PATH 未完全加载导致找不到）\n$tradeExe = (Get-Command trade -ErrorAction Stop).Source\nif (-not $tradeExe) {\n Write-Host \"❌ 找不到 trade.exe，请先确认 trade 已安装\" -ForegroundColor Red\n} else {\n Write-Host \"找到 trade.exe：$tradeExe\" -ForegroundColor Green\n $dir = \"$env:LOCALAPPDATA\\trade\"\n $bat = \"$dir\\trade-autostart.bat\"\n $vbs = \"$dir\\trade-autostart.vbs\"\n $logFile = \"$dir\\trade-autostart.log\"\n New-Item -ItemType Directory -Force -Path $dir | Out-Null\n\n # .bat 用完整路径调用 trade.exe 并重定向日志（启动失败时可查日志）\n @\"\n@echo off\n\"$tradeExe\" > \"$logFile\" 2>&1\n\"@ | Out-File -FilePath $bat -Encoding ASCII\n\n # VBS 隐藏窗口启动 .bat（不等待，不弹窗）\n @\"\nSet WshShell = CreateObject(\"WScript.Shell\")\nWshShell.Run \"cmd /c \"\"$bat\"\"\", 0, False\n\"@ | Out-File -FilePath $vbs -Encoding ASCII\n\n Write-Host \"已创建启动器：$vbs\" -ForegroundColor Green\n Write-Host \"日志文件：$logFile（启动失败时打开它排查）\" -ForegroundColor Yellow\n}\n```\n\n看到绿色「已创建启动器」即成功。\n\n> **这段命令做了什么：**\n> 1. 用 `Get-Command trade` 探测 `trade.exe` 的完整路径，写入 .bat 文件——**不依赖 PATH**，开机早期也能找到\n> 2. .bat 把 trade 的所有输出重定向到 `trade-autostart.log`——启动失败时打开这个日志就能看到错误，不用两眼一抹黑\n> 3. VBS 以**隐藏窗口**模式启动 .bat——不会弹出黑框终端\n\n### 10.2 写入注册表，开机自动运行该脚本\n\n继续在 PowerShell 里粘贴下面这行，按回车：\n\n```powershell\nNew-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Value \"wscript.exe `\"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs`\"\" -PropertyType String -Force\n```\n\n没有报错就说明写入成功。\n\n### 10.3 立即测试（可选但推荐）\n\n不想等到明天才验证？在 PowerShell 里执行：\n\n```powershell\nwscript.exe \"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs\"\n```\n\n等约 15 秒，然后打开浏览器访问 **http://127.0.0.1:9119/trade**。如果能看到 Trade 界面，且**没有弹出任何终端窗口**，说明配置完全正确。\n\n> **如果打不开**：打开文件 `%LOCALAPPDATA%\\trade\\trade-autostart.log`（直接在资源管理器地址栏粘贴这个路径回车），看里面的错误信息。最常见的是 `ModuleNotFoundError`——说明 trade 安装有问题，回到第八步重装。\n\n> **以后的使用方式：** 每天打开电脑，等约 30 秒（系统启动 + Trade 自动启动），直接浏览器访问 **http://127.0.0.1:9119/trade** 即可，**再也不用打开 PowerShell 手动输入 `trade`**。\n\n### 10.4 如果想取消开机自启\n\n将来不想要自启了，在 PowerShell 里执行：\n\n```powershell\nRemove-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Force\n```\n\n即可移除自启，不影响 Trade 本身的使用。\n\n---\n\n## 常见问题\n\n| 你看到的现象 | 怎么解决 |\n|------------|---------|\n| 第五步安装 Hermes 卡住不动 | 科学上网没开好。确认 VPN 是全局模式，关掉 PowerShell 重开再试 |\n| `hermes` 输入后提示「不是内部或外部命令」 | 关掉 PowerShell 重新打开一个新的 |\n| `trade` 输入后提示「不是内部或外部命令」 | 改成输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 然后 `python server.py` |\n| Hermes 对话没反应 | API Key 没配置对。重新运行 `hermes setup` 检查 |\n| 浏览器打开显示「无法访问此网站」 | 程序没在运行。打开一个新的 PowerShell，输入 `trade` 启动 |\n| 开机后访问 127.0.0.1:9119/trade 打不开 | Trade 自启还没跑完，等 30 秒再试。若仍不行，打开 `%LOCALAPPDATA%\\trade\\trade-autostart.log` 看错误日志；或按 `Win+R` 输入 `taskmgr` 回车，看进程里有没有 `python.exe`，没有就手动运行第十步的 VBS 脚本 |\n| 定时任务（每日简报等）不执行 | 第九步的 Hermes Gateway 没装好或没运行。重新执行 `hermes gateway install`，再到 `services.msc` 确认服务状态 |\n| 提示「Filename too long」 | 第五步的长路径设置没做。回到 5.2 执行那行命令，然后**重启电脑** |\n\n---\n\n<p style=\"text-align:center; color:#8b949e; margin-top:3rem;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n\n---\n\n## Skills 参考手册\n\nTrade 会自动识别你的意图，匹配合适的技能。以下是全部 32 个技能的详细说明和使用示例。\n\n### 32 个技能速查\n\n| # | 技能 | 功能 | 典型提示词示例 |\n|---|------|------|---------------|\n| 1 | **b2b-osint** | 客户背景调查（6 层检测） | 帮我查一下这家公司 / 背调这个邮箱 / 查一下域名注册时间 |\n| 2 | **b2b-email-intel** | 邮箱情报（120+ 平台检测） | 查一下这个邮箱哪个平台注册了 / 邮箱是真的吗 |\n| 3 | **b2b-lead-generation** | 多通道客户搜索与开发 | 帮我找一下德国的 XX 产品客户 / 写一封开发信给美国客户 |\n| 4 | **b2b-document** | 本地文档分析与提取 | 分析一下这份报价单 / 帮我看看这个合同有什么问题 |\n| 5 | **b2b-doc-generation** | 生成报价/合同/提案文件 | 帮我生成一份 PDF 报价单 / 做一份产品介绍 PPT |\n| 6 | **b2b-platform** | B2B 平台店铺诊断优化 | 帮我看看这个阿里国际站产品页 / 优化一下产品标题 |\n| 7 | **b2b-linkedin-marketing** | LinkedIn 营销策略与内容 | 帮我想一下领英发什么内容 / 写一个 LinkedIn Add Note |\n| 8 | **b2b-social-media** | 社媒营销（FB/Ins/TikTok/YT） | 帮我做一个 Facebook 内容计划 / 写一个 TikTok 脚本 |\n| 9 | **b2b-customs-data** | 海关数据分析找采购商 | 帮我看看谁在进口这个产品 / 分析一下这个 HS 编码 |\n| 10 | **b2b-onboarding** | 新公司全套部署方案 | 我刚做外贸，帮我制定一个营销方案 / 新公司怎么开始 |\n| 11 | **b2b-daily-automation** | 定时任务（早报/晚报/周报） | 每天早上 8 点给我一份简报 / 设置一个每日工作总结 |\n| 12 | **b2b-customer-mgmt** | 客户档案与分级管理 | 帮我查一下 XX 公司的信息 / A 级客户有哪些 |\n| 13 | **b2b-data-directory** | 数据目录结构管理 | 我的数据存在哪了 / 帮我初始化一下数据目录 |\n| 14 | **chat-memory** | 历史对话查询 | 上次和 XX 公司聊到什么了 / 之前那份报价是多少 |\n| 15 | **b2b-skill-generator** | 动态创建新的 B2B Skill | 帮我创建一个新的 skill，用来查 XX |\n| 16 | **b2b-trade-ops** | 外贸履约与售后沟通 | 帮我写一封催款邮件 / 客户投诉质量有问题怎么办 |\n| 17 | **b2b-trade-compliance** | 合规检查与文化禁忌 | 这个颜色在沙特有什么忌讳吗 / 检查一下 FOB 写对了没有 |\n| 18 | **b2b-cold-outreach** | 冷 outreach 邮件撰写 | 给德国的 XX 公司写一封开发信 / 写一封产品推广信 |\n| 19 | **auto-trade-customer-development** | 全自动客户开发流水线 | 帮我跑一轮自动化客户开发 / 全自动开发一批客户 |\n| 20 | ~~**auto-smtp-email**~~ | ~~SMTP 邮件发送 — 已禁用~~ | ~~把这封开发信发出去 / 群发这批邮件~~ |\n| 21 | **b2b-email-imitation** | 开发信仿写与再创作 | 参考这封邮件，帮我写一个类似的 / 模仿这个风格写一封开发信 |\n| 22 | **b2b-buyer-persona** | 买家画像与角色分层 | 帮我分析一下买家画像 / 针对采购经理应该怎么沟通 |\n| 23 | **b2b-market-analysis** | 市场分析作战地图 | 分析一下德国市场进入策略 / 帮我做一个中东市场调研 |\n| 24 | **b2b-sales-pipeline** | 销售管线与跟进策略 | 这个客户一个月没回了怎么办 / 帮我设计一个 30 天跟进计划 |\n| 25 | **b2b-inquiry-training** | 询盘回复训练 | 帮我练一下询盘回复 / 模拟一个刁钻买家 |\n| 26 | **b2b-kol-imitation** | KOL 风格模仿 | 模仿这个领英大V的风格 / 分析这个账号的内容策略 |\n| 27 | **b2b-reddit-engagement** | Reddit 社区互动 | 帮我在 Reddit 写一条专业评论 / 在哪个 subreddit 发帖 |\n| 28 | **b2b-seo-aeo** | SEO+AEO 文章生成 | 写一篇针对 AI 搜索优化的行业文章 / 帮我做 Pillar Page |\n| 29 | **b2b-short-video** | 短视频脚本生成 | 帮我写一个 TikTok 产品视频脚本 / 工厂参观短视频 |\n| 30 | **b2b-exhibition** | 展会全流程管理 | 帮我写展会邀约邮件 / 展会后的跟进计划 |\n| 31 | **b2b-product-description** | 产品描述生成 | 帮我把这款产品写成销售资料 / 用 FAB 分析产品卖点 |\n| 32 | **b2b-six-thinking-hats** | 六顶思考帽决策 | 帮我分析这个决策 / 要不要给这个客户独家代理权 |\n\n### 技能自动匹配原理\n\n当你在聊天框输入内容时，Trade 会自动匹配关键词，调用最合适的 skill。匹配规则：\n\n- **词边界匹配**（+3 分）：独立关键词命中，如\"背调\"、\"开发信\"、\"海关数据\"\n- **子串匹配**（+1 分）：关键词出现在句子中，如\"帮我查一下这个公司\"匹配到\"查公司\"\n- **显式调用**（最高优先级）：用\"用 b2b-xxx\" 或 \"加载 skill b2b-xxx\" 直接指定\n\n得分最高的 skill 会被激活。如果连续使用同一个 skill，系统会用简短的提示词继续（节省 token）。\n\n### 如何查看当前激活的技能\n\n当 Trade 匹配到一个 skill 时，在回复的开头会显示技能名称，如 `[SKILL AUGMENTATION] 技能触发：b2b-osint`。你也可以直接输入\"用 b2b-osint 查一下这个邮箱\"来强制指定某个技能。\n\n> **设计理念**：Trade 辅助用户梳理工作流程、生成邮件草稿、撰写文档，\n> **但不替用户直接发送邮件/文件给客户**。AI 可能出错，所有对外内容必须\n> 经用户复核确认后自主发出。`auto-smtp-email` 已被禁用，不会由系统触发。\n\n### 技能别名\n\n部分技能之间存在别名关联，输入一个技能名可能触发相关联的技能：\n\n| 输入技能 | 也会触发 |\n|----------|---------|\n| b2b-osint | b2b-email-intel |\n| b2b-lead-generation | b2b-customer-mgmt |\n| b2b-trade-ops | b2b-customer-mgmt |\n| auto-trade-customer-development | b2b-lead-generation, b2b-osint, ~~auto-smtp-email~~ |\n"}, "f07bc51a040ea848cbc62ab246f85d821d870820": {"t": 1785772968.8937829, "n": 11093, "h": "c482a19d4aebe98c", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n .step-num { display:inline-block; width:32px; height:32px; line-height:32px;\n text-align:center; background:#2563EB; color:#fff; border-radius:50%;\n font-weight:bold; font-size:16px; margin-right:8px; }\n .step-title { font-size:1.3rem; font-weight:bold; margin:1.5rem 0 0.5rem; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">Windows 版安装教程 · 不需要懂技术，跟着步骤走，20 分钟装好</p>\n</div>\n\n<div style=\"text-align:center; margin:1rem 0;\">\n <p style=\"color:#8b949e; margin-bottom:0.5rem;\">安装遇到问题？扫码加微信，备注「Trade」</p>\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"180\" style=\"border-radius:8px;\">\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n## 第一步：确保科学上网已启动\n\n这个工具需要从 GitHub 下载代码，而 GitHub 在国内访问不稳定。在开始之前，**必须先打开你的科学上网工具**（VPN / Clash / V2Ray 等），确保网络通畅。\n\n**验证方法：** 打开 **Google Chrome 浏览器**，在地址栏输入 `github.com`，回车。如果页面能正常打开，说明网络没问题，可以继续。\n\n> 如果 GitHub 打不开，检查你的科学上网工具是否已启动、是否设为**全局模式**或 **TUN 模式**。\n\n---\n\n## 第二步：注册 DeepSeek 并获取 API Key\n\nAI 不是免费的，需要去 DeepSeek 注册账号并充值。\n\n1. 用 **Google Chrome 浏览器** 打开 **platform.deepseek.com**\n2. 点击「注册」，用手机号注册一个账号\n3. 登录后，点击页面上的「**充值**」，**充值 10 元以上**（按用量扣费，10 块钱能用很久）\n4. 在左侧菜单找到「**API Keys**」，点击进入\n5. 点击「**创建 API Key**」，名称填 `trade`，点确定\n6. 页面上会显示一串字符（以 `sk-` 开头）——这就是你的 **DeepSeek API Key**\n7. **立刻复制保存**，关掉后就再也看不到了\n\n> 把这串 Key 先粘贴到记事本里，后面要用。\n\n---\n\n## 第三步：注册 Tavily 并获取 API Key\n\nTavily 是联网搜索引擎，让 AI 能搜索实时信息。\n\n1. 用 **Google Chrome 浏览器** 打开 **tavily.com**\n2. 点击「Sign Up」，**用 Gmail 邮箱注册**一个账号\n3. 登录后进入 Dashboard，在 API Keys 区域找到你的 Key（以 `tvly-` 开头）\n4. **复制保存**到记事本里\n\n> Tavily 每月有 1000 次免费搜索额度，个人使用足够了。\n\n---\n\n## 第四步：在桌面创建 API Key 文件\n\n把刚才拿到的两个 Key 整理到一个文件里，后面配置时会用到。\n\n1. 在桌面上**右键** → 新建 → 文本文档\n2. 把文件重命名为 `apikey.txt`\n3. 打开文件，按以下格式粘贴：\n\n```\nDeepSeek API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nTavily API Key: tvly-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\n4. 保存并关闭。后面配置 Hermes 时需要从这里复制粘贴。\n\n---\n\n## 第五步：安装 Hermes Agent（AI 引擎）\n\nHermes Agent 是驱动 AI 的底层引擎，Trade 基于它运行。\n\n### 5.1 以管理员身份打开 PowerShell\n\n1. 按键盘 **Win 键**，输入 `powershell`\n2. **右键点击**搜索结果里的「Windows PowerShell」\n3. 选择「**以管理员身份运行**」\n4. 弹出提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n\n### 5.2 开启长路径支持\n\n在 PowerShell 里粘贴下面这行命令，按回车：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n### 5.3 一键安装 Hermes\n\n接着执行下面这行命令：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n等待几分钟，看到「安装完成」提示即可。\n\n> 在 PowerShell 里粘贴的方法是**点一下鼠标右键**（不是 Ctrl+V）。\n\n---\n\n## 第六步：配置 Hermes（大模型 + 搜索）\n\n安装完成后，在同一个 PowerShell 窗口输入：\n\n```\nhermes setup\n```\n\n这时会出现交互配置界面，按以下步骤操作：\n\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」→ 按回车\n2. 选择模型时，选「**deepseek-v4-flash**」（即 DeepSeek V4 Flash）→ 按回车\n3. 粘贴你的 **DeepSeek API Key**（从桌面的 `apikey.txt` 复制）→ 按回车\n4. 搜索服务选「**Tavily**」→ 按回车\n5. 粘贴你的 **Tavily API Key** → 按回车\n\n看到「配置成功」提示就完成了。\n\n---\n\n## 第七步：验证 Hermes 是否正常\n\n在 PowerShell 里输入：\n\n```\nhermes\n```\n\n等它启动后，在对话框里输入：\n\n```\nhello\n```\n\n按回车发送。如果 AI 正常回复了，说明大模型配置成功。\n\n> 按 `Ctrl+C` 可以退出 Hermes，回到命令行。\n\n---\n\n## 第八步：让 AI 帮你安装 Trade\n\n重新启动 Hermes（输入 `hermes`），在聊天框里**复制粘贴**下面这句话：\n\n```\n请帮我安装 trade，地址是 https://github.com/chefroger/smart-trade-ai\n```\n\nAI 会自己去 GitHub 查看项目说明，然后自动执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。\n\n装完后，**关闭当前 PowerShell，重新打开一个新的**，输入：\n\n```\ntrade\n```\n\n浏览器会自动打开 Trade 界面。如果没有自动打开，手动访问 **http://127.0.0.1:9119/trade**。\n\n> 验证能用后，按 `Ctrl+C` 退出 trade（暂时退出，下一步设置开机自启后会自动运行）。\n\n---\n\n## 第九步：设置 Hermes Gateway 开机自启\n\nHermes Gateway 是定时任务调度器，Trade 的定时简报、定时询盘检查都依赖它。必须让它随系统启动，否则每天还要手动开。\n\n在 PowerShell 里执行：\n\n```\nhermes gateway install\n```\n\n看到「服务已安装」或类似提示即成功。**以后开机时 Hermes Gateway 会自动在后台运行，无需手动启动。**\n\n> 验证是否装好：按 `Win+R`，输入 `services.msc`，回车。在列表里找到「Hermes Gateway」服务，状态应为「正在运行」。\n\n---\n\n## 第十步：设置 Trade 开机自启（无终端窗口）\n\n上一步装好了 Gateway，但 Trade 本身还没设为自启。这一步用**注册表 + VBS 脚本**的方式让 Trade 开机自动运行，**且不弹出任何终端窗口**——开机后直接打开浏览器访问 **http://127.0.0.1:9119/trade** 就能用。\n\n### 10.1 创建启动器脚本（VBS + BAT，带日志）\n\n把下面**整段命令**复制粘贴到 PowerShell 里，按回车：\n\n```powershell\n# 探测 trade.exe 完整路径（避免开机时 PATH 未完全加载导致找不到）\n$tradeExe = (Get-Command trade -ErrorAction Stop).Source\nif (-not $tradeExe) {\n Write-Host \"❌ 找不到 trade.exe，请先确认 trade 已安装\" -ForegroundColor Red\n} else {\n Write-Host \"找到 trade.exe：$tradeExe\" -ForegroundColor Green\n $dir = \"$env:LOCALAPPDATA\\trade\"\n $bat = \"$dir\\trade-autostart.bat\"\n $vbs = \"$dir\\trade-autostart.vbs\"\n $logFile = \"$dir\\trade-autostart.log\"\n New-Item -ItemType Directory -Force -Path $dir | Out-Null\n\n # .bat 用完整路径调用 trade.exe 并重定向日志（启动失败时可查日志）\n @\"\n@echo off\n\"$tradeExe\" > \"$logFile\" 2>&1\n\"@ | Out-File -FilePath $bat -Encoding ASCII\n\n # VBS 隐藏窗口启动 .bat（不等待，不弹窗）\n @\"\nSet WshShell = CreateObject(\"WScript.Shell\")\nWshShell.Run \"cmd /c \"\"$bat\"\"\", 0, False\n\"@ | Out-File -FilePath $vbs -Encoding ASCII\n\n Write-Host \"已创建启动器：$vbs\" -ForegroundColor Green\n Write-Host \"日志文件：$logFile（启动失败时打开它排查）\" -ForegroundColor Yellow\n}\n```\n\n看到绿色「已创建启动器」即成功。\n\n> **这段命令做了什么：**\n> 1. 用 `Get-Command trade` 探测 `trade.exe` 的完整路径，写入 .bat 文件——**不依赖 PATH**，开机早期也能找到\n> 2. .bat 把 trade 的所有输出重定向到 `trade-autostart.log`——启动失败时打开这个日志就能看到错误，不用两眼一抹黑\n> 3. VBS 以**隐藏窗口**模式启动 .bat——不会弹出黑框终端\n\n### 10.2 写入注册表，开机自动运行该脚本\n\n继续在 PowerShell 里粘贴下面这行，按回车：\n\n```powershell\nNew-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Value \"wscript.exe `\"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs`\"\" -PropertyType String -Force\n```\n\n没有报错就说明写入成功。\n\n### 10.3 立即测试（可选但推荐）\n\n不想等到明天才验证？在 PowerShell 里执行：\n\n```powershell\nwscript.exe \"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs\"\n```\n\n等约 15 秒，然后打开浏览器访问 **http://127.0.0.1:9119/trade**。如果能看到 Trade 界面，且**没有弹出任何终端窗口**，说明配置完全正确。\n\n> **如果打不开**：打开文件 `%LOCALAPPDATA%\\trade\\trade-autostart.log`（直接在资源管理器地址栏粘贴这个路径回车），看里面的错误信息。最常见的是 `ModuleNotFoundError`——说明 trade 安装有问题，回到第八步重装。\n\n> **以后的使用方式：** 每天打开电脑，等约 30 秒（系统启动 + Trade 自动启动），直接浏览器访问 **http://127.0.0.1:9119/trade** 即可，**再也不用打开 PowerShell 手动输入 `trade`**。\n\n### 10.4 如果想取消开机自启\n\n将来不想要自启了，在 PowerShell 里执行：\n\n```powershell\nRemove-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Force\n```\n\n即可移除自启，不影响 Trade 本身的使用。\n\n---\n\n## 常见问题\n\n| 你看到的现象 | 怎么解决 |\n|------------|---------|\n| 第五步安装 Hermes 卡住不动 | 科学上网没开好。确认 VPN 是全局模式，关掉 PowerShell 重开再试 |\n| `hermes` 输入后提示「不是内部或外部命令」 | 关掉 PowerShell 重新打开一个新的 |\n| `trade` 输入后提示「不是内部或外部命令」 | 改成输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 然后 `python server.py` |\n| Hermes 对话没反应 | API Key 没配置对。重新运行 `hermes setup` 检查 |\n| 浏览器打开显示「无法访问此网站」 | 程序没在运行。打开一个新的 PowerShell，输入 `trade` 启动 |\n| 开机后访问 127.0.0.1:9119/trade 打不开 | Trade 自启还没跑完，等 30 秒再试。若仍不行，打开 `%LOCALAPPDATA%\\trade\\trade-autostart.log` 看错误日志；或按 `Win+R` 输入 `taskmgr` 回车，看进程里有没有 `python.exe`，没有就手动运行第十步的 VBS 脚本 |\n| 定时任务（每日简报等）不执行 | 第九步的 Hermes Gateway 没装好或没运行。重新执行 `hermes gateway install`，再到 `services.msc` 确认服务状态 |\n| 提示「Filename too long」 | 第五步的长路径设置没做。回到 5.2 执行那行命令，然后**重启电脑** |\n\n---\n\n<p style=\"text-align:center; color:#8b949e; margin-top:3rem;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n\n---\n\n## Skills 参考手册\n\nTrade 会自动识别你的意图，匹配合适的技能。以下是全部 32 个技能的详细说明和使用示例。\n\n### 32 个技能速查\n\n| # | 技能 | 功能 | 典型提示词示例 |\n|---|------|------|---------------|\n| 1 | **b2b-osint** | 客户背景调查（6 层检测） | 帮我查一下这家公司 / 背调这个邮箱 / 查一下域名注册时间 |\n| 2 | **b2b-email-intel** | 邮箱情报（120+ 平台检测） | 查一下这个邮箱哪个平台注册了 / 邮箱是真的吗 |\n| 3 | **b2b-lead-generation** | 多通道客户搜索与开发 | 帮我找一下德国的 XX 产品客户 / 写一封开发信给美国客户 |\n| 4 | **b2b-document** | 本地文档分析与提取 | 分析一下这份报价单 / 帮我看看这个合同有什么问题 |\n| 5 | **b2b-doc-generation** | 生成报价/合同/提案文件 | 帮我生成一份 PDF 报价单 / 做一份产品介绍 PPT |\n| 6 | **b2b-platform** | B2B 平台店铺诊断优化 | 帮我看看这个阿里国际站产品页 / 优化一下产品标题 |\n| 7 | **b2b-linkedin-marketing** | LinkedIn 营销策略与内容 | 帮我想一下领英发什么内容 / 写一个 LinkedIn Add Note |\n| 8 | **b2b-social-media** | 社媒营销（FB/Ins/TikTok/YT） | 帮我做一个 Facebook 内容计划 / 写一个 TikTok 脚本 |\n| 9 | **b2b-customs-data** | 海关数据分析找采购商 | 帮我看看谁在进口这个产品 / 分析一下这个 HS 编码 |\n| 10 | **b2b-onboarding** | 新公司全套部署方案 | 我刚做外贸，帮我制定一个营销方案 / 新公司怎么开始 |\n| 11 | **b2b-daily-automation** | 定时任务（早报/晚报/周报） | 每天早上 8 点给我一份简报 / 设置一个每日工作总结 |\n| 12 | **b2b-customer-mgmt** | 客户档案与分级管理 | 帮我查一下 XX 公司的信息 / A 级客户有哪些 |\n| 13 | **b2b-data-directory** | 数据目录结构管理 | 我的数据存在哪了 / 帮我初始化一下数据目录 |\n| 14 | **chat-memory** | 历史对话查询 | 上次和 XX 公司聊到什么了 / 之前那份报价是多少 |\n| 15 | **b2b-skill-generator** | 动态创建新的 B2B Skill | 帮我创建一个新的 skill，用来查 XX |\n| 16 | **b2b-trade-ops** | 外贸履约与售后沟通 | 帮我写一封催款邮件 / 客户投诉质量有问题怎么办 |\n| 17 | **b2b-trade-compliance** | 合规检查与文化禁忌 | 这个颜色在沙特有什么忌讳吗 / 检查一下 FOB 写对了没有 |\n| 18 | **b2b-cold-outreach** | 冷 outreach 邮件撰写 | 给德国的 XX 公司写一封开发信 / 写一封产品推广信 |\n| 19 | **auto-trade-customer-development** | 全自动客户开发流水线 | 帮我跑一轮自动化客户开发 / 全自动开发一批客户 |\n| 20 | **auto-smtp-email** | SMTP 邮件发送 | 把这封开发信发出去 / 群发这批邮件，间隔 60 秒 |\n| 21 | **b2b-email-imitation** | 开发信仿写与再创作 | 参考这封邮件，帮我写一个类似的 / 模仿这个风格写一封开发信 |\n| 22 | **b2b-buyer-persona** | 买家画像与角色分层 | 帮我分析一下买家画像 / 针对采购经理应该怎么沟通 |\n| 23 | **b2b-market-analysis** | 市场分析作战地图 | 分析一下德国市场进入策略 / 帮我做一个中东市场调研 |\n| 24 | **b2b-sales-pipeline** | 销售管线与跟进策略 | 这个客户一个月没回了怎么办 / 帮我设计一个 30 天跟进计划 |\n| 25 | **b2b-inquiry-training** | 询盘回复训练 | 帮我练一下询盘回复 / 模拟一个刁钻买家 |\n| 26 | **b2b-kol-imitation** | KOL 风格模仿 | 模仿这个领英大V的风格 / 分析这个账号的内容策略 |\n| 27 | **b2b-reddit-engagement** | Reddit 社区互动 | 帮我在 Reddit 写一条专业评论 / 在哪个 subreddit 发帖 |\n| 28 | **b2b-seo-aeo** | SEO+AEO 文章生成 | 写一篇针对 AI 搜索优化的行业文章 / 帮我做 Pillar Page |\n| 29 | **b2b-short-video** | 短视频脚本生成 | 帮我写一个 TikTok 产品视频脚本 / 工厂参观短视频 |\n| 30 | **b2b-exhibition** | 展会全流程管理 | 帮我写展会邀约邮件 / 展会后的跟进计划 |\n| 31 | **b2b-product-description** | 产品描述生成 | 帮我把这款产品写成销售资料 / 用 FAB 分析产品卖点 |\n| 32 | **b2b-six-thinking-hats** | 六顶思考帽决策 | 帮我分析这个决策 / 要不要给这个客户独家代理权 |\n\n### 技能自动匹配原理\n\n当你在聊天框输入内容时，Trade 会自动匹配关键词，调用最合适的 skill。匹配规则：\n\n- **词边界匹配**（+3 分）：独立关键词命中，如\"背调\"、\"开发信\"、\"海关数据\"\n- **子串匹配**（+1 分）：关键词出现在句子中，如\"帮我查一下这个公司\"匹配到\"查公司\"\n- **显式调用**（最高优先级）：用\"用 b2b-xxx\" 或 \"加载 skill b2b-xxx\" 直接指定\n\n得分最高的 skill 会被激活。如果连续使用同一个 skill，系统会用简短的提示词继续（节省 token）。\n\n### 如何查看当前激活的技能\n\n当 Trade 匹配到一个 skill 时，在回复的开头会显示技能名称，如 `[SKILL AUGMENTATION] 技能触发：b2b-osint`。你也可以直接输入\"用 b2b-osint 查一下这个邮箱\"来强制指定某个技能。\n\n### 技能别名\n\n部分技能之间存在别名关联，输入一个技能名可能触发相关联的技能：\n\n| 输入技能 | 也会触发 |\n|----------|---------|\n| b2b-osint | b2b-email-intel |\n| b2b-lead-generation | b2b-customer-mgmt |\n| b2b-trade-ops | b2b-customer-mgmt |\n| auto-trade-customer-development | b2b-lead-generation, b2b-osint, auto-smtp-email |\n"}, "13b9ed5c2a77193ea394b358763f37f59cfdcc5c": {"t": 1785772971.024682, "n": 11098, "h": "d5f98f05c4b113c6", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n .step-num { display:inline-block; width:32px; height:32px; line-height:32px;\n text-align:center; background:#2563EB; color:#fff; border-radius:50%;\n font-weight:bold; font-size:16px; margin-right:8px; }\n .step-title { font-size:1.3rem; font-weight:bold; margin:1.5rem 0 0.5rem; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">Windows 版安装教程 · 不需要懂技术，跟着步骤走，20 分钟装好</p>\n</div>\n\n<div style=\"text-align:center; margin:1rem 0;\">\n <p style=\"color:#8b949e; margin-bottom:0.5rem;\">安装遇到问题？扫码加微信，备注「Trade」</p>\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"180\" style=\"border-radius:8px;\">\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n## 第一步：确保科学上网已启动\n\n这个工具需要从 GitHub 下载代码，而 GitHub 在国内访问不稳定。在开始之前，**必须先打开你的科学上网工具**（VPN / Clash / V2Ray 等），确保网络通畅。\n\n**验证方法：** 打开 **Google Chrome 浏览器**，在地址栏输入 `github.com`，回车。如果页面能正常打开，说明网络没问题，可以继续。\n\n> 如果 GitHub 打不开，检查你的科学上网工具是否已启动、是否设为**全局模式**或 **TUN 模式**。\n\n---\n\n## 第二步：注册 DeepSeek 并获取 API Key\n\nAI 不是免费的，需要去 DeepSeek 注册账号并充值。\n\n1. 用 **Google Chrome 浏览器** 打开 **platform.deepseek.com**\n2. 点击「注册」，用手机号注册一个账号\n3. 登录后，点击页面上的「**充值**」，**充值 10 元以上**（按用量扣费，10 块钱能用很久）\n4. 在左侧菜单找到「**API Keys**」，点击进入\n5. 点击「**创建 API Key**」，名称填 `trade`，点确定\n6. 页面上会显示一串字符（以 `sk-` 开头）——这就是你的 **DeepSeek API Key**\n7. **立刻复制保存**，关掉后就再也看不到了\n\n> 把这串 Key 先粘贴到记事本里，后面要用。\n\n---\n\n## 第三步：注册 Tavily 并获取 API Key\n\nTavily 是联网搜索引擎，让 AI 能搜索实时信息。\n\n1. 用 **Google Chrome 浏览器** 打开 **tavily.com**\n2. 点击「Sign Up」，**用 Gmail 邮箱注册**一个账号\n3. 登录后进入 Dashboard，在 API Keys 区域找到你的 Key（以 `tvly-` 开头）\n4. **复制保存**到记事本里\n\n> Tavily 每月有 1000 次免费搜索额度，个人使用足够了。\n\n---\n\n## 第四步：在桌面创建 API Key 文件\n\n把刚才拿到的两个 Key 整理到一个文件里，后面配置时会用到。\n\n1. 在桌面上**右键** → 新建 → 文本文档\n2. 把文件重命名为 `apikey.txt`\n3. 打开文件，按以下格式粘贴：\n\n```\nDeepSeek API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nTavily API Key: tvly-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\n4. 保存并关闭。后面配置 Hermes 时需要从这里复制粘贴。\n\n---\n\n## 第五步：安装 Hermes Agent（AI 引擎）\n\nHermes Agent 是驱动 AI 的底层引擎，Trade 基于它运行。\n\n### 5.1 以管理员身份打开 PowerShell\n\n1. 按键盘 **Win 键**，输入 `powershell`\n2. **右键点击**搜索结果里的「Windows PowerShell」\n3. 选择「**以管理员身份运行**」\n4. 弹出提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n\n### 5.2 开启长路径支持\n\n在 PowerShell 里粘贴下面这行命令，按回车：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n### 5.3 一键安装 Hermes\n\n接着执行下面这行命令：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n等待几分钟，看到「安装完成」提示即可。\n\n> 在 PowerShell 里粘贴的方法是**点一下鼠标右键**（不是 Ctrl+V）。\n\n---\n\n## 第六步：配置 Hermes（大模型 + 搜索）\n\n安装完成后，在同一个 PowerShell 窗口输入：\n\n```\nhermes setup\n```\n\n这时会出现交互配置界面，按以下步骤操作：\n\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」→ 按回车\n2. 选择模型时，选「**deepseek-v4-flash**」（即 DeepSeek V4 Flash）→ 按回车\n3. 粘贴你的 **DeepSeek API Key**（从桌面的 `apikey.txt` 复制）→ 按回车\n4. 搜索服务选「**Tavily**」→ 按回车\n5. 粘贴你的 **Tavily API Key** → 按回车\n\n看到「配置成功」提示就完成了。\n\n---\n\n## 第七步：验证 Hermes 是否正常\n\n在 PowerShell 里输入：\n\n```\nhermes\n```\n\n等它启动后，在对话框里输入：\n\n```\nhello\n```\n\n按回车发送。如果 AI 正常回复了，说明大模型配置成功。\n\n> 按 `Ctrl+C` 可以退出 Hermes，回到命令行。\n\n---\n\n## 第八步：让 AI 帮你安装 Trade\n\n重新启动 Hermes（输入 `hermes`），在聊天框里**复制粘贴**下面这句话：\n\n```\n请帮我安装 trade，地址是 https://github.com/chefroger/smart-trade-ai\n```\n\nAI 会自己去 GitHub 查看项目说明，然后自动执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。\n\n装完后，**关闭当前 PowerShell，重新打开一个新的**，输入：\n\n```\ntrade\n```\n\n浏览器会自动打开 Trade 界面。如果没有自动打开，手动访问 **http://127.0.0.1:9119/trade**。\n\n> 验证能用后，按 `Ctrl+C` 退出 trade（暂时退出，下一步设置开机自启后会自动运行）。\n\n---\n\n## 第九步：设置 Hermes Gateway 开机自启\n\nHermes Gateway 是定时任务调度器，Trade 的定时简报、定时询盘检查都依赖它。必须让它随系统启动，否则每天还要手动开。\n\n在 PowerShell 里执行：\n\n```\nhermes gateway install\n```\n\n看到「服务已安装」或类似提示即成功。**以后开机时 Hermes Gateway 会自动在后台运行，无需手动启动。**\n\n> 验证是否装好：按 `Win+R`，输入 `services.msc`，回车。在列表里找到「Hermes Gateway」服务，状态应为「正在运行」。\n\n---\n\n## 第十步：设置 Trade 开机自启（无终端窗口）\n\n上一步装好了 Gateway，但 Trade 本身还没设为自启。这一步用**注册表 + VBS 脚本**的方式让 Trade 开机自动运行，**且不弹出任何终端窗口**——开机后直接打开浏览器访问 **http://127.0.0.1:9119/trade** 就能用。\n\n### 10.1 创建启动器脚本（VBS + BAT，带日志）\n\n把下面**整段命令**复制粘贴到 PowerShell 里，按回车：\n\n```powershell\n# 探测 trade.exe 完整路径（避免开机时 PATH 未完全加载导致找不到）\n$tradeExe = (Get-Command trade -ErrorAction Stop).Source\nif (-not $tradeExe) {\n Write-Host \"❌ 找不到 trade.exe，请先确认 trade 已安装\" -ForegroundColor Red\n} else {\n Write-Host \"找到 trade.exe：$tradeExe\" -ForegroundColor Green\n $dir = \"$env:LOCALAPPDATA\\trade\"\n $bat = \"$dir\\trade-autostart.bat\"\n $vbs = \"$dir\\trade-autostart.vbs\"\n $logFile = \"$dir\\trade-autostart.log\"\n New-Item -ItemType Directory -Force -Path $dir | Out-Null\n\n # .bat 用完整路径调用 trade.exe 并重定向日志（启动失败时可查日志）\n @\"\n@echo off\n\"$tradeExe\" > \"$logFile\" 2>&1\n\"@ | Out-File -FilePath $bat -Encoding ASCII\n\n # VBS 隐藏窗口启动 .bat（不等待，不弹窗）\n @\"\nSet WshShell = CreateObject(\"WScript.Shell\")\nWshShell.Run \"cmd /c \"\"$bat\"\"\", 0, False\n\"@ | Out-File -FilePath $vbs -Encoding ASCII\n\n Write-Host \"已创建启动器：$vbs\" -ForegroundColor Green\n Write-Host \"日志文件：$logFile（启动失败时打开它排查）\" -ForegroundColor Yellow\n}\n```\n\n看到绿色「已创建启动器」即成功。\n\n> **这段命令做了什么：**\n> 1. 用 `Get-Command trade` 探测 `trade.exe` 的完整路径，写入 .bat 文件——**不依赖 PATH**，开机早期也能找到\n> 2. .bat 把 trade 的所有输出重定向到 `trade-autostart.log`——启动失败时打开这个日志就能看到错误，不用两眼一抹黑\n> 3. VBS 以**隐藏窗口**模式启动 .bat——不会弹出黑框终端\n\n### 10.2 写入注册表，开机自动运行该脚本\n\n继续在 PowerShell 里粘贴下面这行，按回车：\n\n```powershell\nNew-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Value \"wscript.exe `\"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs`\"\" -PropertyType String -Force\n```\n\n没有报错就说明写入成功。\n\n### 10.3 立即测试（可选但推荐）\n\n不想等到明天才验证？在 PowerShell 里执行：\n\n```powershell\nwscript.exe \"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs\"\n```\n\n等约 15 秒，然后打开浏览器访问 **http://127.0.0.1:9119/trade**。如果能看到 Trade 界面，且**没有弹出任何终端窗口**，说明配置完全正确。\n\n> **如果打不开**：打开文件 `%LOCALAPPDATA%\\trade\\trade-autostart.log`（直接在资源管理器地址栏粘贴这个路径回车），看里面的错误信息。最常见的是 `ModuleNotFoundError`——说明 trade 安装有问题，回到第八步重装。\n\n> **以后的使用方式：** 每天打开电脑，等约 30 秒（系统启动 + Trade 自动启动），直接浏览器访问 **http://127.0.0.1:9119/trade** 即可，**再也不用打开 PowerShell 手动输入 `trade`**。\n\n### 10.4 如果想取消开机自启\n\n将来不想要自启了，在 PowerShell 里执行：\n\n```powershell\nRemove-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Force\n```\n\n即可移除自启，不影响 Trade 本身的使用。\n\n---\n\n## 常见问题\n\n| 你看到的现象 | 怎么解决 |\n|------------|---------|\n| 第五步安装 Hermes 卡住不动 | 科学上网没开好。确认 VPN 是全局模式，关掉 PowerShell 重开再试 |\n| `hermes` 输入后提示「不是内部或外部命令」 | 关掉 PowerShell 重新打开一个新的 |\n| `trade` 输入后提示「不是内部或外部命令」 | 改成输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 然后 `python server.py` |\n| Hermes 对话没反应 | API Key 没配置对。重新运行 `hermes setup` 检查 |\n| 浏览器打开显示「无法访问此网站」 | 程序没在运行。打开一个新的 PowerShell，输入 `trade` 启动 |\n| 开机后访问 127.0.0.1:9119/trade 打不开 | Trade 自启还没跑完，等 30 秒再试。若仍不行，打开 `%LOCALAPPDATA%\\trade\\trade-autostart.log` 看错误日志；或按 `Win+R` 输入 `taskmgr` 回车，看进程里有没有 `python.exe`，没有就手动运行第十步的 VBS 脚本 |\n| 定时任务（每日简报等）不执行 | 第九步的 Hermes Gateway 没装好或没运行。重新执行 `hermes gateway install`，再到 `services.msc` 确认服务状态 |\n| 提示「Filename too long」 | 第五步的长路径设置没做。回到 5.2 执行那行命令，然后**重启电脑** |\n\n---\n\n<p style=\"text-align:center; color:#8b949e; margin-top:3rem;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n\n---\n\n## Skills 参考手册\n\nTrade 会自动识别你的意图，匹配合适的技能。以下是全部 32 个技能的详细说明和使用示例。\n\n### 32 个技能速查\n\n| # | 技能 | 功能 | 典型提示词示例 |\n|---|------|------|---------------|\n| 1 | **b2b-osint** | 客户背景调查（6 层检测） | 帮我查一下这家公司 / 背调这个邮箱 / 查一下域名注册时间 |\n| 2 | **b2b-email-intel** | 邮箱情报（120+ 平台检测） | 查一下这个邮箱哪个平台注册了 / 邮箱是真的吗 |\n| 3 | **b2b-lead-generation** | 多通道客户搜索与开发 | 帮我找一下德国的 XX 产品客户 / 写一封开发信给美国客户 |\n| 4 | **b2b-document** | 本地文档分析与提取 | 分析一下这份报价单 / 帮我看看这个合同有什么问题 |\n| 5 | **b2b-doc-generation** | 生成报价/合同/提案文件 | 帮我生成一份 PDF 报价单 / 做一份产品介绍 PPT |\n| 6 | **b2b-platform** | B2B 平台店铺诊断优化 | 帮我看看这个阿里国际站产品页 / 优化一下产品标题 |\n| 7 | **b2b-linkedin-marketing** | LinkedIn 营销策略与内容 | 帮我想一下领英发什么内容 / 写一个 LinkedIn Add Note |\n| 8 | **b2b-social-media** | 社媒营销（FB/Ins/TikTok/YT） | 帮我做一个 Facebook 内容计划 / 写一个 TikTok 脚本 |\n| 9 | **b2b-customs-data** | 海关数据分析找采购商 | 帮我看看谁在进口这个产品 / 分析一下这个 HS 编码 |\n| 10 | **b2b-onboarding** | 新公司全套部署方案 | 我刚做外贸，帮我制定一个营销方案 / 新公司怎么开始 |\n| 11 | **b2b-daily-automation** | 定时任务（早报/晚报/周报） | 每天早上 8 点给我一份简报 / 设置一个每日工作总结 |\n| 12 | **b2b-customer-mgmt** | 客户档案与分级管理 | 帮我查一下 XX 公司的信息 / A 级客户有哪些 |\n| 13 | **b2b-data-directory** | 数据目录结构管理 | 我的数据存在哪了 / 帮我初始化一下数据目录 |\n| 14 | **chat-memory** | 历史对话查询 | 上次和 XX 公司聊到什么了 / 之前那份报价是多少 |\n| 15 | **b2b-skill-generator** | 动态创建新的 B2B Skill | 帮我创建一个新的 skill，用来查 XX |\n| 16 | **b2b-trade-ops** | 外贸履约与售后沟通 | 帮我写一封催款邮件 / 客户投诉质量有问题怎么办 |\n| 17 | **b2b-trade-compliance** | 合规检查与文化禁忌 | 这个颜色在沙特有什么忌讳吗 / 检查一下 FOB 写对了没有 |\n| 18 | **b2b-cold-outreach** | 冷 outreach 邮件撰写 | 给德国的 XX 公司写一封开发信 / 写一封产品推广信 |\n| 19 | **auto-trade-customer-development** | 全自动客户开发流水线 | 帮我跑一轮自动化客户开发 / 全自动开发一批客户 |\n| 20 | **auto-smtp-email** | SMTP 邮件发送 | 把这封开发信发出去 / 群发这批邮件，间隔 60 秒 |\n| 21 | **b2b-email-imitation** | 开发信仿写与再创作 | 参考这封邮件，帮我写一个类似的 / 模仿这个风格写一封开发信 |\n| 22 | **b2b-buyer-persona** | 买家画像与角色分层 | 帮我分析一下买家画像 / 针对采购经理应该怎么沟通 |\n| 23 | **b2b-market-analysis** | 市场分析作战地图 | 分析一下德国市场进入策略 / 帮我做一个中东市场调研 |\n| 24 | **b2b-sales-pipeline** | 销售管线与跟进策略 | 这个客户一个月没回了怎么办 / 帮我设计一个 30 天跟进计划 |\n| 25 | **b2b-inquiry-training** | 询盘回复训练 | 帮我练一下询盘回复 / 模拟一个刁钻买家 |\n| 26 | **b2b-kol-imitation** | KOL 风格模仿 | 模仿这个领英大V的风格 / 分析这个账号的内容策略 |\n| 27 | **b2b-reddit-engagement** | Reddit 社区互动 | 帮我在 Reddit 写一条专业评论 / 在哪个 subreddit 发帖 |\n| 28 | **b2b-seo-aeo** | SEO+AEO 文章生成 | 写一篇针对 AI 搜索优化的行业文章 / 帮我做 Pillar Page |\n| 29 | **b2b-short-video** | 短视频脚本生成 | 帮我写一个 TikTok 产品视频脚本 / 工厂参观短视频 |\n| 30 | **b2b-exhibition** | 展会全流程管理 | 帮我写展会邀约邮件 / 展会后的跟进计划 |\n| 31 | **b2b-product-description** | 产品描述生成 | 帮我把这款产品写成销售资料 / 用 FAB 分析产品卖点 |\n| 32 | **b2b-six-thinking-hats** | 六顶思考帽决策 | 帮我分析这个决策 / 要不要给这个客户独家代理权 |\n\n### 技能自动匹配原理\n\n当你在聊天框输入内容时，Trade 会自动匹配关键词，调用最合适的 skill。匹配规则：\n\n- **词边界匹配**（+3 分）：独立关键词命中，如\"背调\"、\"开发信\"、\"海关数据\"\n- **子串匹配**（+1 分）：关键词出现在句子中，如\"帮我查一下这个公司\"匹配到\"查公司\"\n- **显式调用**（最高优先级）：用\"用 b2b-xxx\" 或 \"加载 skill b2b-xxx\" 直接指定\n\n得分最高的 skill 会被激活。如果连续使用同一个 skill，系统会用简短的提示词继续（节省 token）。\n\n### 如何查看当前激活的技能\n\n当 Trade 匹配到一个 skill 时，在回复的开头会显示技能名称，如 `[SKILL AUGMENTATION] 技能触发：b2b-osint`。你也可以直接输入\"用 b2b-osint 查一下这个邮箱\"来强制指定某个技能。\n\n### 技能别名\n\n部分技能之间存在别名关联，输入一个技能名可能触发相关联的技能：\n\n| 输入技能 | 也会触发 |\n|----------|---------|\n| b2b-osint | b2b-email-intel |\n| b2b-lead-generation | b2b-customer-mgmt |\n| b2b-trade-ops | b2b-customer-mgmt |\n| auto-trade-customer-development | b2b-lead-generation, b2b-osint, auto-smtp-email |\n</p>\n"}, "29189b3ae51f3f2416c886531ab1504ffc1f6920": {"t": 1785772972.3238852, "n": 10579, "h": "124833316a6eb82c", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n .step-num { display:inline-block; width:32px; height:32px; line-height:32px;\n text-align:center; background:#2563EB; color:#fff; border-radius:50%;\n font-weight:bold; font-size:16px; margin-right:8px; }\n .step-title { font-size:1.3rem; font-weight:bold; margin:1.5rem 0 0.5rem; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">Windows 版安装教程 · 不需要懂技术，跟着步骤走，20 分钟装好</p>\n</div>\n\n<div style=\"text-align:center; margin:1rem 0;\">\n <p style=\"color:#8b949e; margin-bottom:0.5rem;\">安装遇到问题？扫码加微信，备注「Trade」</p>\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"180\" style=\"border-radius:8px;\">\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n## 第一步：确保科学上网已启动\n\n这个工具需要从 GitHub 下载代码，而 GitHub 在国内访问不稳定。在开始之前，**必须先打开你的科学上网工具**（VPN / Clash / V2Ray 等），确保网络通畅。\n\n**验证方法：** 打开 **Google Chrome 浏览器**，在地址栏输入 `github.com`，回车。如果页面能正常打开，说明网络没问题，可以继续。\n\n> 如果 GitHub 打不开，检查你的科学上网工具是否已启动、是否设为**全局模式**或 **TUN 模式**。\n\n---\n\n## 第二步：注册 DeepSeek 并获取 API Key\n\nAI 不是免费的，需要去 DeepSeek 注册账号并充值。\n\n1. 用 **Google Chrome 浏览器** 打开 **platform.deepseek.com**\n2. 点击「注册」，用手机号注册一个账号\n3. 登录后，点击页面上的「**充值**」，**充值 10 元以上**（按用量扣费，10 块钱能用很久）\n4. 在左侧菜单找到「**API Keys**」，点击进入\n5. 点击「**创建 API Key**」，名称填 `trade`，点确定\n6. 页面上会显示一串字符（以 `sk-` 开头）——这就是你的 **DeepSeek API Key**\n7. **立刻复制保存**，关掉后就再也看不到了\n\n> 把这串 Key 先粘贴到记事本里，后面要用。\n\n---\n\n## 第三步：注册 Tavily 并获取 API Key\n\nTavily 是联网搜索引擎，让 AI 能搜索实时信息。\n\n1. 用 **Google Chrome 浏览器** 打开 **tavily.com**\n2. 点击「Sign Up」，**用 Gmail 邮箱注册**一个账号\n3. 登录后进入 Dashboard，在 API Keys 区域找到你的 Key（以 `tvly-` 开头）\n4. **复制保存**到记事本里\n\n> Tavily 每月有 1000 次免费搜索额度，个人使用足够了。\n\n---\n\n## 第四步：在桌面创建 API Key 文件\n\n把刚才拿到的两个 Key 整理到一个文件里，后面配置时会用到。\n\n1. 在桌面上**右键** → 新建 → 文本文档\n2. 把文件重命名为 `apikey.txt`\n3. 打开文件，按以下格式粘贴：\n\n```\nDeepSeek API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nTavily API Key: tvly-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\n4. 保存并关闭。后面配置 Hermes 时需要从这里复制粘贴。\n\n---\n\n## 第五步：安装 Hermes Agent（AI 引擎）\n\nHermes Agent 是驱动 AI 的底层引擎，Trade 基于它运行。\n\n### 5.1 以管理员身份打开 PowerShell\n\n1. 按键盘 **Win 键**，输入 `powershell`\n2. **右键点击**搜索结果里的「Windows PowerShell」\n3. 选择「**以管理员身份运行**」\n4. 弹出提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n\n### 5.2 开启长路径支持\n\n在 PowerShell 里粘贴下面这行命令，按回车：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n### 5.3 一键安装 Hermes\n\n接着执行下面这行命令：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n等待几分钟，看到「安装完成」提示即可。\n\n> 在 PowerShell 里粘贴的方法是**点一下鼠标右键**（不是 Ctrl+V）。\n\n---\n\n## 第六步：配置 Hermes（大模型 + 搜索）\n\n安装完成后，在同一个 PowerShell 窗口输入：\n\n```\nhermes setup\n```\n\n这时会出现交互配置界面，按以下步骤操作：\n\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」→ 按回车\n2. 选择模型时，选「**deepseek-v4-flash**」（即 DeepSeek V4 Flash）→ 按回车\n3. 粘贴你的 **DeepSeek API Key**（从桌面的 `apikey.txt` 复制）→ 按回车\n4. 搜索服务选「**Tavily**」→ 按回车\n5. 粘贴你的 **Tavily API Key** → 按回车\n\n看到「配置成功」提示就完成了。\n\n---\n\n## 第七步：验证 Hermes 是否正常\n\n在 PowerShell 里输入：\n\n```\nhermes\n```\n\n等它启动后，在对话框里输入：\n\n```\nhello\n```\n\n按回车发送。如果 AI 正常回复了，说明大模型配置成功。\n\n> 按 `Ctrl+C` 可以退出 Hermes，回到命令行。\n\n---\n\n## 第八步：让 AI 帮你安装 Trade\n\n重新启动 Hermes（输入 `hermes`），在聊天框里**复制粘贴**下面这句话：\n\n```\n请帮我安装 trade，地址是 https://github.com/chefroger/smart-trade-ai\n```\n\nAI 会自己去 GitHub 查看项目说明，然后自动执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。\n\n装完后，**关闭当前 PowerShell，重新打开一个新的**，输入：\n\n```\ntrade\n```\n\n浏览器会自动打开 Trade 界面。如果没有自动打开，手动访问 **http://127.0.0.1:9119/trade**。\n\n> 验证能用后，按 `Ctrl+C` 退出 trade（暂时退出，下一步设置开机自启后会自动运行）。\n\n---\n\n## 第九步：设置 Hermes Gateway 开机自启\n\nHermes Gateway 是定时任务调度器，Trade 的定时简报、定时询盘检查都依赖它。必须让它随系统启动，否则每天还要手动开。\n\n在 PowerShell 里执行：\n\n```\nhermes gateway install\n```\n\n看到「服务已安装」或类似提示即成功。**以后开机时 Hermes Gateway 会自动在后台运行，无需手动启动。**\n\n> 验证是否装好：按 `Win+R`，输入 `services.msc`，回车。在列表里找到「Hermes Gateway」服务，状态应为「正在运行」。\n\n---\n\n## 第十步：设置 Trade 开机自启（无终端窗口）\n\n上一步装好了 Gateway，但 Trade 本身还没设为自启。这一步用**注册表 + VBS 脚本**的方式让 Trade 开机自动运行，**且不弹出任何终端窗口**——开机后直接打开浏览器访问 **http://127.0.0.1:9119/trade** 就能用。\n\n### 10.1 创建启动器脚本（VBS + BAT，带日志）\n\n把下面**整段命令**复制粘贴到 PowerShell 里，按回车：\n\n```powershell\n# 探测 trade.exe 完整路径（避免开机时 PATH 未完全加载导致找不到）\n$tradeExe = (Get-Command trade -ErrorAction Stop).Source\nif (-not $tradeExe) {\n Write-Host \"❌ 找不到 trade.exe，请先确认 trade 已安装\" -ForegroundColor Red\n} else {\n Write-Host \"找到 trade.exe：$tradeExe\" -ForegroundColor Green\n $dir = \"$env:LOCALAPPDATA\\trade\"\n $bat = \"$dir\\trade-autostart.bat\"\n $vbs = \"$dir\\trade-autostart.vbs\"\n $logFile = \"$dir\\trade-autostart.log\"\n New-Item -ItemType Directory -Force -Path $dir | Out-Null\n\n # .bat 用完整路径调用 trade.exe 并重定向日志（启动失败时可查日志）\n @\"\n@echo off\n\"$tradeExe\" > \"$logFile\" 2>&1\n\"@ | Out-File -FilePath $bat -Encoding ASCII\n\n # VBS 隐藏窗口启动 .bat（不等待，不弹窗）\n @\"\nSet WshShell = CreateObject(\"WScript.Shell\")\nWshShell.Run \"cmd /c \"\"$bat\"\"\", 0, False\n\"@ | Out-File -FilePath $vbs -Encoding ASCII\n\n Write-Host \"已创建启动器：$vbs\" -ForegroundColor Green\n Write-Host \"日志文件：$logFile（启动失败时打开它排查）\" -ForegroundColor Yellow\n}\n```\n\n看到绿色「已创建启动器」即成功。\n\n> **这段命令做了什么：**\n> 1. 用 `Get-Command trade` 探测 `trade.exe` 的完整路径，写入 .bat 文件——**不依赖 PATH**，开机早期也能找到\n> 2. .bat 把 trade 的所有输出重定向到 `trade-autostart.log`——启动失败时打开这个日志就能看到错误，不用两眼一抹黑\n> 3. VBS 以**隐藏窗口**模式启动 .bat——不会弹出黑框终端\n\n### 10.2 写入注册表，开机自动运行该脚本\n\n继续在 PowerShell 里粘贴下面这行，按回车：\n\n```powershell\nNew-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Value \"wscript.exe `\"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs`\"\" -PropertyType String -Force\n```\n\n没有报错就说明写入成功。\n\n### 10.3 立即测试（可选但推荐）\n\n不想等到明天才验证？在 PowerShell 里执行：\n\n```powershell\nwscript.exe \"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs\"\n```\n\n等约 15 秒，然后打开浏览器访问 **http://127.0.0.1:9119/trade**。如果能看到 Trade 界面，且**没有弹出任何终端窗口**，说明配置完全正确。\n\n> **如果打不开**：打开文件 `%LOCALAPPDATA%\\trade\\trade-autostart.log`（直接在资源管理器地址栏粘贴这个路径回车），看里面的错误信息。最常见的是 `ModuleNotFoundError`——说明 trade 安装有问题，回到第八步重装。\n\n> **以后的使用方式：** 每天打开电脑，等约 30 秒（系统启动 + Trade 自动启动），直接浏览器访问 **http://127.0.0.1:9119/trade** 即可，**再也不用打开 PowerShell 手动输入 `trade`**。\n\n### 10.4 如果想取消开机自启\n\n将来不想要自启了，在 PowerShell 里执行：\n\n```powershell\nRemove-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Force\n```\n\n即可移除自启，不影响 Trade 本身的使用。\n\n---\n\n## 常见问题\n\n| 你看到的现象 | 怎么解决 |\n|------------|---------|\n| 第五步安装 Hermes 卡住不动 | 科学上网没开好。确认 VPN 是全局模式，关掉 PowerShell 重开再试 |\n| `hermes` 输入后提示「不是内部或外部命令」 | 关掉 PowerShell 重新打开一个新的 |\n| `trade` 输入后提示「不是内部或外部命令」 | 改成输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 然后 `python server.py` |\n| Hermes 对话没反应 | API Key 没配置对。重新运行 `hermes setup` 检查 |\n| 浏览器打开显示「无法访问此网站」 | 程序没在运行。打开一个新的 PowerShell，输入 `trade` 启动 |\n| 开机后访问 127.0.0.1:9119/trade 打不开 | Trade 自启还没跑完，等 30 秒再试。若仍不行，打开 `%LOCALAPPDATA%\\trade\\trade-autostart.log` 看错误日志；或按 `Win+R` 输入 `taskmgr` 回车，看进程里有没有 `python.exe`，没有就手动运行第十步的 VBS 脚本 |\n| 定时任务（每日简报等）不执行 | 第九步的 Hermes Gateway 没装好或没运行。重新执行 `hermes gateway install`，再到 `services.msc` 确认服务状态 |\n| 提示「Filename too long」 | 第五步的长路径设置没做。回到 5.2 执行那行命令，然后**重启电脑** |\n\n---\n\n<p style=\"text-align:center; color:#8b949e; margin-top:3rem;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n\n---\n\n## Skills 参考手册\n\nTrade 会自动识别你的意图，匹配合适的技能。以下是全部 25 个技能的详细说明和使用示例。\n\n### 25 个技能速查\n\n| # | 技能 | 功能 | 典型提示词示例 |\n|---|------|------|---------------|\n| 1 | **b2b-osint** | 客户背景调查（6 层检测） | 帮我查一下这家公司 / 背调这个邮箱 / 查一下域名注册时间 |\n| 2 | **b2b-email-intel** | 邮箱情报（120+ 平台检测） | 查一下这个邮箱哪个平台注册了 / 邮箱是真的吗 |\n| 3 | **b2b-lead-generation** | 多通道客户搜索与开发 | 帮我找一下德国的 XX 产品客户 / 写一封开发信给美国客户 |\n| 4 | **b2b-document** | 本地文档分析与提取 | 分析一下这份报价单 / 帮我看看这个合同有什么问题 |\n| 5 | **b2b-doc-generation** | 生成报价/合同/提案文件 | 帮我生成一份 PDF 报价单 / 做一份产品介绍 PPT |\n| 6 | **b2b-platform** | B2B 平台店铺诊断优化 | 帮我看看这个阿里国际站产品页 / 优化一下产品标题 |\n| 7 | **b2b-linkedin-marketing** | LinkedIn 营销策略与内容 | 帮我想一下领英发什么内容 / 写一个 LinkedIn Add Note |\n| 8 | **b2b-social-media** | 社媒营销（FB/Ins/TikTok/YT） | 帮我做一个 Facebook 内容计划 / 写一个 TikTok 脚本 |\n| 9 | **b2b-customs-data** | 海关数据分析找采购商 | 帮我看看谁在进口这个产品 / 分析一下这个 HS 编码 |\n| 10 | **b2b-onboarding** | 新公司全套部署方案 | 我刚做外贸，帮我制定一个营销方案 / 新公司怎么开始 |\n| 11 | **b2b-daily-automation** | 定时任务（早报/晚报/周报） | 每天早上 8 点给我一份简报 / 设置一个每日工作总结 |\n| 12 | **b2b-customer-mgmt** | 客户档案与分级管理 | 帮我查一下 XX 公司的信息 / A 级客户有哪些 |\n| 13 | **b2b-data-directory** | 数据目录结构管理 | 我的数据存在哪了 / 帮我初始化一下数据目录 |\n| 14 | **chat-memory** | 历史对话查询 | 上次和 XX 公司聊到什么了 / 之前那份报价是多少 |\n| 15 | **b2b-skill-generator** | 动态创建新的 B2B Skill | 帮我创建一个新的 skill，用来查 XX |\n| 16 | **b2b-trade-ops** | 外贸履约与售后沟通 | 帮我写一封催款邮件 / 客户投诉质量有问题怎么办 |\n| 17 | **b2b-trade-compliance** | 合规检查与文化禁忌 | 这个颜色在沙特有什么忌讳吗 / 检查一下 FOB 写对了没有 |\n| 18 | **b2b-cold-outreach** | 冷 outreach 邮件撰写 | 给德国的 XX 公司写一封开发信 / 写一封产品推广信 |\n| 19 | **auto-trade-customer-development** | 全自动客户开发流水线 | 帮我跑一轮自动化客户开发 / 全自动开发一批客户 |\n| 20 | **auto-smtp-email** | SMTP 邮件发送 | 把这封开发信发出去 / 群发这批邮件，间隔 60 秒 |\n| 21 | **b2b-email-imitation** | 开发信仿写与再创作 | 参考这封邮件，帮我写一个类似的 / 模仿这个风格写一封开发信 |\n| 22 | **b2b-buyer-persona** | 买家画像与角色分层 | 帮我分析一下买家画像 / 针对采购经理应该怎么沟通 |\n| 23 | **b2b-market-analysis** | 市场分析作战地图 | 分析一下德国市场进入策略 / 帮我做一个中东市场调研 |\n| 24 | **b2b-sales-pipeline** | 销售管线与跟进策略 | 这个客户一个月没回了怎么办 / 帮我设计一个 30 天跟进计划 |\n| 25 | **b2b-inquiry-training** | 询盘回复训练 | 帮我练一下询盘回复 / 模拟一个刁钻买家 |\n\n### 技能自动匹配原理\n\n当你在聊天框输入内容时，Trade 会自动匹配关键词，调用最合适的 skill。匹配规则：\n\n- **词边界匹配**（+3 分）：独立关键词命中，如\"背调\"、\"开发信\"、\"海关数据\"\n- **子串匹配**（+1 分）：关键词出现在句子中，如\"帮我查一下这个公司\"匹配到\"查公司\"\n- **显式调用**（最高优先级）：用\"用 b2b-xxx\" 或 \"加载 skill b2b-xxx\" 直接指定\n\n得分最高的 skill 会被激活。如果连续使用同一个 skill，系统会用简短的提示词继续（节省 token）。\n\n### 如何查看当前激活的技能\n\n当 Trade 匹配到一个 skill 时，在回复的开头会显示技能名称，如 `[SKILL AUGMENTATION] 技能触发：b2b-osint`。你也可以直接输入\"用 b2b-osint 查一下这个邮箱\"来强制指定某个技能。\n\n### 技能别名\n\n部分技能之间存在别名关联，输入一个技能名可能触发相关联的技能：\n\n| 输入技能 | 也会触发 |\n|----------|---------|\n| b2b-osint | b2b-email-intel |\n| b2b-lead-generation | b2b-customer-mgmt |\n| b2b-trade-ops | b2b-customer-mgmt |\n| auto-trade-customer-development | b2b-lead-generation, b2b-osint, auto-smtp-email |\n</p>\n"}, "adb3b3726f56810ed58c1f85fb971bb9df5cabed": {"t": 1785772973.64917, "n": 10513, "h": "aac7b3098d7750cc", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n .step-num { display:inline-block; width:32px; height:32px; line-height:32px;\n text-align:center; background:#2563EB; color:#fff; border-radius:50%;\n font-weight:bold; font-size:16px; margin-right:8px; }\n .step-title { font-size:1.3rem; font-weight:bold; margin:1.5rem 0 0.5rem; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">Windows 版安装教程 · 不需要懂技术，跟着步骤走，20 分钟装好</p>\n</div>\n\n<div style=\"text-align:center; margin:1rem 0;\">\n <p style=\"color:#8b949e; margin-bottom:0.5rem;\">安装遇到问题？扫码加微信，备注「Trade」</p>\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"180\" style=\"border-radius:8px;\">\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n## 第一步：确保科学上网已启动\n\n这个工具需要从 GitHub 下载代码，而 GitHub 在国内访问不稳定。在开始之前，**必须先打开你的科学上网工具**（VPN / Clash / V2Ray 等），确保网络通畅。\n\n**验证方法：** 打开 **Google Chrome 浏览器**，在地址栏输入 `github.com`，回车。如果页面能正常打开，说明网络没问题，可以继续。\n\n> 如果 GitHub 打不开，检查你的科学上网工具是否已启动、是否设为**全局模式**或 **TUN 模式**。\n\n---\n\n## 第二步：注册 DeepSeek 并获取 API Key\n\nAI 不是免费的，需要去 DeepSeek 注册账号并充值。\n\n1. 用 **Google Chrome 浏览器** 打开 **platform.deepseek.com**\n2. 点击「注册」，用手机号注册一个账号\n3. 登录后，点击页面上的「**充值**」，**充值 10 元以上**（按用量扣费，10 块钱能用很久）\n4. 在左侧菜单找到「**API Keys**」，点击进入\n5. 点击「**创建 API Key**」，名称填 `trade`，点确定\n6. 页面上会显示一串字符（以 `sk-` 开头）——这就是你的 **DeepSeek API Key**\n7. **立刻复制保存**，关掉后就再也看不到了\n\n> 把这串 Key 先粘贴到记事本里，后面要用。\n\n---\n\n## 第三步：注册 Tavily 并获取 API Key\n\nTavily 是联网搜索引擎，让 AI 能搜索实时信息。\n\n1. 用 **Google Chrome 浏览器** 打开 **tavily.com**\n2. 点击「Sign Up」，**用 Gmail 邮箱注册**一个账号\n3. 登录后进入 Dashboard，在 API Keys 区域找到你的 Key（以 `tvly-` 开头）\n4. **复制保存**到记事本里\n\n> Tavily 每月有 1000 次免费搜索额度，个人使用足够了。\n\n---\n\n## 第四步：在桌面创建 API Key 文件\n\n把刚才拿到的两个 Key 整理到一个文件里，后面配置时会用到。\n\n1. 在桌面上**右键** → 新建 → 文本文档\n2. 把文件重命名为 `apikey.txt`\n3. 打开文件，按以下格式粘贴：\n\n```\nDeepSeek API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nTavily API Key: tvly-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\n4. 保存并关闭。后面配置 Hermes 时需要从这里复制粘贴。\n\n---\n\n## 第五步：安装 Hermes Agent（AI 引擎）\n\nHermes Agent 是驱动 AI 的底层引擎，Trade 基于它运行。\n\n### 5.1 以管理员身份打开 PowerShell\n\n1. 按键盘 **Win 键**，输入 `powershell`\n2. **右键点击**搜索结果里的「Windows PowerShell」\n3. 选择「**以管理员身份运行**」\n4. 弹出提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n\n### 5.2 开启长路径支持\n\n在 PowerShell 里粘贴下面这行命令，按回车：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n### 5.3 一键安装 Hermes\n\n接着执行下面这行命令：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n等待几分钟，看到「安装完成」提示即可。\n\n> 在 PowerShell 里粘贴的方法是**点一下鼠标右键**（不是 Ctrl+V）。\n\n---\n\n## 第六步：配置 Hermes（大模型 + 搜索）\n\n安装完成后，在同一个 PowerShell 窗口输入：\n\n```\nhermes setup\n```\n\n这时会出现交互配置界面，按以下步骤操作：\n\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」→ 按回车\n2. 选择模型时，选「**deepseek-v4-flash**」（即 DeepSeek V4 Flash）→ 按回车\n3. 粘贴你的 **DeepSeek API Key**（从桌面的 `apikey.txt` 复制）→ 按回车\n4. 搜索服务选「**Tavily**」→ 按回车\n5. 粘贴你的 **Tavily API Key** → 按回车\n\n看到「配置成功」提示就完成了。\n\n---\n\n## 第七步：验证 Hermes 是否正常\n\n在 PowerShell 里输入：\n\n```\nhermes\n```\n\n等它启动后，在对话框里输入：\n\n```\nhello\n```\n\n按回车发送。如果 AI 正常回复了，说明大模型配置成功。\n\n> 按 `Ctrl+C` 可以退出 Hermes，回到命令行。\n\n---\n\n## 第八步：让 AI 帮你安装 Trade\n\n重新启动 Hermes（输入 `hermes`），在聊天框里**复制粘贴**下面这句话：\n\n```\n请帮我安装 trade，地址是 https://github.com/chefroger/smart-trade-ai\n```\n\nAI 会自己去 GitHub 查看项目说明，然后自动执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。\n\n装完后，**关闭当前 PowerShell，重新打开一个新的**，输入：\n\n```\ntrade\n```\n\n浏览器会自动打开 Trade 界面。如果没有自动打开，手动访问 **http://127.0.0.1:9119/trade**。\n\n> 验证能用后，按 `Ctrl+C` 退出 trade（暂时退出，下一步设置开机自启后会自动运行）。\n\n---\n\n## 第九步：设置 Hermes Gateway 开机自启\n\nHermes Gateway 是定时任务调度器，Trade 的定时简报、定时询盘检查都依赖它。必须让它随系统启动，否则每天还要手动开。\n\n在 PowerShell 里执行：\n\n```\nhermes gateway install\n```\n\n看到「服务已安装」或类似提示即成功。**以后开机时 Hermes Gateway 会自动在后台运行，无需手动启动。**\n\n> 验证是否装好：按 `Win+R`，输入 `services.msc`，回车。在列表里找到「Hermes Gateway」服务，状态应为「正在运行」。\n\n---\n\n## 第十步：设置 Trade 开机自启（无终端窗口）\n\n上一步装好了 Gateway，但 Trade 本身还没设为自启。这一步用**注册表 + VBS 脚本**的方式让 Trade 开机自动运行，**且不弹出任何终端窗口**——开机后直接打开浏览器访问 **http://127.0.0.1:9119/trade** 就能用。\n\n### 10.1 创建启动器脚本（VBS + BAT，带日志）\n\n把下面**整段命令**复制粘贴到 PowerShell 里，按回车：\n\n```powershell\n# 探测 trade.exe 完整路径（避免开机时 PATH 未完全加载导致找不到）\n$tradeExe = (Get-Command trade -ErrorAction Stop).Source\nif (-not $tradeExe) {\n Write-Host \"❌ 找不到 trade.exe，请先确认 trade 已安装\" -ForegroundColor Red\n} else {\n Write-Host \"找到 trade.exe：$tradeExe\" -ForegroundColor Green\n $dir = \"$env:LOCALAPPDATA\\trade\"\n $bat = \"$dir\\trade-autostart.bat\"\n $vbs = \"$dir\\trade-autostart.vbs\"\n $logFile = \"$dir\\trade-autostart.log\"\n New-Item -ItemType Directory -Force -Path $dir | Out-Null\n\n # .bat 用完整路径调用 trade.exe 并重定向日志（启动失败时可查日志）\n @\"\n@echo off\n\"$tradeExe\" > \"$logFile\" 2>&1\n\"@ | Out-File -FilePath $bat -Encoding ASCII\n\n # VBS 隐藏窗口启动 .bat（不等待，不弹窗）\n @\"\nSet WshShell = CreateObject(\"WScript.Shell\")\nWshShell.Run \"cmd /c \"\"$bat\"\"\", 0, False\n\"@ | Out-File -FilePath $vbs -Encoding ASCII\n\n Write-Host \"已创建启动器：$vbs\" -ForegroundColor Green\n Write-Host \"日志文件：$logFile（启动失败时打开它排查）\" -ForegroundColor Yellow\n}\n```\n\n看到绿色「已创建启动器」即成功。\n\n> **这段命令做了什么：**\n> 1. 用 `Get-Command trade` 探测 `trade.exe` 的完整路径，写入 .bat 文件——**不依赖 PATH**，开机早期也能找到\n> 2. .bat 把 trade 的所有输出重定向到 `trade-autostart.log`——启动失败时打开这个日志就能看到错误，不用两眼一抹黑\n> 3. VBS 以**隐藏窗口**模式启动 .bat——不会弹出黑框终端\n\n### 10.2 写入注册表，开机自动运行该脚本\n\n继续在 PowerShell 里粘贴下面这行，按回车：\n\n```powershell\nNew-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Value \"wscript.exe `\"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs`\"\" -PropertyType String -Force\n```\n\n没有报错就说明写入成功。\n\n### 10.3 立即测试（可选但推荐）\n\n不想等到明天才验证？在 PowerShell 里执行：\n\n```powershell\nwscript.exe \"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs\"\n```\n\n等约 15 秒，然后打开浏览器访问 **http://127.0.0.1:9119/trade**。如果能看到 Trade 界面，且**没有弹出任何终端窗口**，说明配置完全正确。\n\n> **如果打不开**：打开文件 `%LOCALAPPDATA%\\trade\\trade-autostart.log`（直接在资源管理器地址栏粘贴这个路径回车），看里面的错误信息。最常见的是 `ModuleNotFoundError`——说明 trade 安装有问题，回到第八步重装。\n\n> **以后的使用方式：** 每天打开电脑，等约 30 秒（系统启动 + Trade 自动启动），直接浏览器访问 **http://127.0.0.1:9119/trade** 即可，**再也不用打开 PowerShell 手动输入 `trade`**。\n\n### 10.4 如果想取消开机自启\n\n将来不想要自启了，在 PowerShell 里执行：\n\n```powershell\nRemove-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Force\n```\n\n即可移除自启，不影响 Trade 本身的使用。\n\n---\n\n## 常见问题\n\n| 你看到的现象 | 怎么解决 |\n|------------|---------|\n| 第五步安装 Hermes 卡住不动 | 科学上网没开好。确认 VPN 是全局模式，关掉 PowerShell 重开再试 |\n| `hermes` 输入后提示「不是内部或外部命令」 | 关掉 PowerShell 重新打开一个新的 |\n| `trade` 输入后提示「不是内部或外部命令」 | 改成输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 然后 `python server.py` |\n| Hermes 对话没反应 | API Key 没配置对。重新运行 `hermes setup` 检查 |\n| 浏览器打开显示「无法访问此网站」 | 程序没在运行。打开一个新的 PowerShell，输入 `trade` 启动 |\n| 开机后访问 127.0.0.1:9119/trade 打不开 | Trade 自启还没跑完，等 30 秒再试。若仍不行，打开 `%LOCALAPPDATA%\\trade\\trade-autostart.log` 看错误日志；或按 `Win+R` 输入 `taskmgr` 回车，看进程里有没有 `python.exe`，没有就手动运行第十步的 VBS 脚本 |\n| 定时任务（每日简报等）不执行 | 第九步的 Hermes Gateway 没装好或没运行。重新执行 `hermes gateway install`，再到 `services.msc` 确认服务状态 |\n| 提示「Filename too long」 | 第五步的长路径设置没做。回到 5.2 执行那行命令，然后**重启电脑** |\n\n---\n\n<p style=\"text-align:center; color:#8b949e; margin-top:3rem;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n\n---\n\n## Skills 参考手册\n\nTrade 会自动识别你的意图，匹配合适的技能。以下是全部 24 个技能的详细说明和使用示例。\n\n### 24 个技能速查\n\n| # | 技能 | 功能 | 典型提示词示例 |\n|---|------|------|---------------|\n| 1 | **b2b-osint** | 客户背景调查（6 层检测） | 帮我查一下这家公司 / 背调这个邮箱 / 查一下域名注册时间 |\n| 2 | **b2b-email-intel** | 邮箱情报（120+ 平台检测） | 查一下这个邮箱哪个平台注册了 / 邮箱是真的吗 |\n| 3 | **b2b-lead-generation** | 多通道客户搜索与开发 | 帮我找一下德国的 XX 产品客户 / 写一封开发信给美国客户 |\n| 4 | **b2b-document** | 本地文档分析与提取 | 分析一下这份报价单 / 帮我看看这个合同有什么问题 |\n| 5 | **b2b-doc-generation** | 生成报价/合同/提案文件 | 帮我生成一份 PDF 报价单 / 做一份产品介绍 PPT |\n| 6 | **b2b-platform** | B2B 平台店铺诊断优化 | 帮我看看这个阿里国际站产品页 / 优化一下产品标题 |\n| 7 | **b2b-linkedin-marketing** | LinkedIn 营销策略与内容 | 帮我想一下领英发什么内容 / 写一个 LinkedIn Add Note |\n| 8 | **b2b-social-media** | 社媒营销（FB/Ins/TikTok/YT） | 帮我做一个 Facebook 内容计划 / 写一个 TikTok 脚本 |\n| 9 | **b2b-customs-data** | 海关数据分析找采购商 | 帮我看看谁在进口这个产品 / 分析一下这个 HS 编码 |\n| 10 | **b2b-onboarding** | 新公司全套部署方案 | 我刚做外贸，帮我制定一个营销方案 / 新公司怎么开始 |\n| 11 | **b2b-daily-automation** | 定时任务（早报/晚报/周报） | 每天早上 8 点给我一份简报 / 设置一个每日工作总结 |\n| 12 | **b2b-customer-mgmt** | 客户档案与分级管理 | 帮我查一下 XX 公司的信息 / A 级客户有哪些 |\n| 13 | **b2b-data-directory** | 数据目录结构管理 | 我的数据存在哪了 / 帮我初始化一下数据目录 |\n| 14 | **chat-memory** | 历史对话查询 | 上次和 XX 公司聊到什么了 / 之前那份报价是多少 |\n| 15 | **b2b-skill-generator** | 动态创建新的 B2B Skill | 帮我创建一个新的 skill，用来查 XX |\n| 16 | **b2b-trade-ops** | 外贸履约与售后沟通 | 帮我写一封催款邮件 / 客户投诉质量有问题怎么办 |\n| 17 | **b2b-trade-compliance** | 合规检查与文化禁忌 | 这个颜色在沙特有什么忌讳吗 / 检查一下 FOB 写对了没有 |\n| 18 | **b2b-cold-outreach** | 冷 outreach 邮件撰写 | 给德国的 XX 公司写一封开发信 / 写一封产品推广信 |\n| 19 | **auto-trade-customer-development** | 全自动客户开发流水线 | 帮我跑一轮自动化客户开发 / 全自动开发一批客户 |\n| 20 | **auto-smtp-email** | SMTP 邮件发送 | 把这封开发信发出去 / 群发这批邮件，间隔 60 秒 |\n| 21 | **b2b-email-imitation** | 开发信仿写与再创作 | 参考这封邮件，帮我写一个类似的 / 模仿这个风格写一封开发信 |\n| 22 | **b2b-buyer-persona** | 买家画像与角色分层 | 帮我分析一下买家画像 / 针对采购经理应该怎么沟通 |\n| 23 | **b2b-market-analysis** | 市场分析作战地图 | 分析一下德国市场进入策略 / 帮我做一个中东市场调研 |\n| 24 | **b2b-sales-pipeline** | 销售管线与跟进策略 | 这个客户一个月没回了怎么办 / 帮我设计一个 30 天跟进计划 |\n\n### 技能自动匹配原理\n\n当你在聊天框输入内容时，Trade 会自动匹配关键词，调用最合适的 skill。匹配规则：\n\n- **词边界匹配**（+3 分）：独立关键词命中，如\"背调\"、\"开发信\"、\"海关数据\"\n- **子串匹配**（+1 分）：关键词出现在句子中，如\"帮我查一下这个公司\"匹配到\"查公司\"\n- **显式调用**（最高优先级）：用\"用 b2b-xxx\" 或 \"加载 skill b2b-xxx\" 直接指定\n\n得分最高的 skill 会被激活。如果连续使用同一个 skill，系统会用简短的提示词继续（节省 token）。\n\n### 如何查看当前激活的技能\n\n当 Trade 匹配到一个 skill 时，在回复的开头会显示技能名称，如 `[SKILL AUGMENTATION] 技能触发：b2b-osint`。你也可以直接输入\"用 b2b-osint 查一下这个邮箱\"来强制指定某个技能。\n\n### 技能别名\n\n部分技能之间存在别名关联，输入一个技能名可能触发相关联的技能：\n\n| 输入技能 | 也会触发 |\n|----------|---------|\n| b2b-osint | b2b-email-intel |\n| b2b-lead-generation | b2b-customer-mgmt |\n| b2b-trade-ops | b2b-customer-mgmt |\n| auto-trade-customer-development | b2b-lead-generation, b2b-osint, auto-smtp-email |\n</p>\n"}, "255bd4dc4f95906f0821f6f1d081041ce59e9652": {"t": 1785772975.814565, "n": 10508, "h": "0fa0d9df18848d10", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n .step-num { display:inline-block; width:32px; height:32px; line-height:32px;\n text-align:center; background:#2563EB; color:#fff; border-radius:50%;\n font-weight:bold; font-size:16px; margin-right:8px; }\n .step-title { font-size:1.3rem; font-weight:bold; margin:1.5rem 0 0.5rem; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">Windows 版安装教程 · 不需要懂技术，跟着步骤走，20 分钟装好</p>\n</div>\n\n<div style=\"text-align:center; margin:1rem 0;\">\n <p style=\"color:#8b949e; margin-bottom:0.5rem;\">安装遇到问题？扫码加微信，备注「Trade」</p>\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"180\" style=\"border-radius:8px;\">\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n## 第一步：确保科学上网已启动\n\n这个工具需要从 GitHub 下载代码，而 GitHub 在国内访问不稳定。在开始之前，**必须先打开你的科学上网工具**（VPN / Clash / V2Ray 等），确保网络通畅。\n\n**验证方法：** 打开 **Google Chrome 浏览器**，在地址栏输入 `github.com`，回车。如果页面能正常打开，说明网络没问题，可以继续。\n\n> 如果 GitHub 打不开，检查你的科学上网工具是否已启动、是否设为**全局模式**或 **TUN 模式**。\n\n---\n\n## 第二步：注册 DeepSeek 并获取 API Key\n\nAI 不是免费的，需要去 DeepSeek 注册账号并充值。\n\n1. 用 **Google Chrome 浏览器** 打开 **platform.deepseek.com**\n2. 点击「注册」，用手机号注册一个账号\n3. 登录后，点击页面上的「**充值**」，**充值 10 元以上**（按用量扣费，10 块钱能用很久）\n4. 在左侧菜单找到「**API Keys**」，点击进入\n5. 点击「**创建 API Key**」，名称填 `trade`，点确定\n6. 页面上会显示一串字符（以 `sk-` 开头）——这就是你的 **DeepSeek API Key**\n7. **立刻复制保存**，关掉后就再也看不到了\n\n> 把这串 Key 先粘贴到记事本里，后面要用。\n\n---\n\n## 第三步：注册 Tavily 并获取 API Key\n\nTavily 是联网搜索引擎，让 AI 能搜索实时信息。\n\n1. 用 **Google Chrome 浏览器** 打开 **tavily.com**\n2. 点击「Sign Up」，**用 Gmail 邮箱注册**一个账号\n3. 登录后进入 Dashboard，在 API Keys 区域找到你的 Key（以 `tvly-` 开头）\n4. **复制保存**到记事本里\n\n> Tavily 每月有 1000 次免费搜索额度，个人使用足够了。\n\n---\n\n## 第四步：在桌面创建 API Key 文件\n\n把刚才拿到的两个 Key 整理到一个文件里，后面配置时会用到。\n\n1. 在桌面上**右键** → 新建 → 文本文档\n2. 把文件重命名为 `apikey.txt`\n3. 打开文件，按以下格式粘贴：\n\n```\nDeepSeek API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nTavily API Key: tvly-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\n4. 保存并关闭。后面配置 Hermes 时需要从这里复制粘贴。\n\n---\n\n## 第五步：安装 Hermes Agent（AI 引擎）\n\nHermes Agent 是驱动 AI 的底层引擎，Trade 基于它运行。\n\n### 5.1 以管理员身份打开 PowerShell\n\n1. 按键盘 **Win 键**，输入 `powershell`\n2. **右键点击**搜索结果里的「Windows PowerShell」\n3. 选择「**以管理员身份运行**」\n4. 弹出提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n\n### 5.2 开启长路径支持\n\n在 PowerShell 里粘贴下面这行命令，按回车：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n### 5.3 一键安装 Hermes\n\n接着执行下面这行命令：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n等待几分钟，看到「安装完成」提示即可。\n\n> 在 PowerShell 里粘贴的方法是**点一下鼠标右键**（不是 Ctrl+V）。\n\n---\n\n## 第六步：配置 Hermes（大模型 + 搜索）\n\n安装完成后，在同一个 PowerShell 窗口输入：\n\n```\nhermes setup\n```\n\n这时会出现交互配置界面，按以下步骤操作：\n\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」→ 按回车\n2. 选择模型时，选「**deepseek-v4-flash**」（即 DeepSeek V4 Flash）→ 按回车\n3. 粘贴你的 **DeepSeek API Key**（从桌面的 `apikey.txt` 复制）→ 按回车\n4. 搜索服务选「**Tavily**」→ 按回车\n5. 粘贴你的 **Tavily API Key** → 按回车\n\n看到「配置成功」提示就完成了。\n\n---\n\n## 第七步：验证 Hermes 是否正常\n\n在 PowerShell 里输入：\n\n```\nhermes\n```\n\n等它启动后，在对话框里输入：\n\n```\nhello\n```\n\n按回车发送。如果 AI 正常回复了，说明大模型配置成功。\n\n> 按 `Ctrl+C` 可以退出 Hermes，回到命令行。\n\n---\n\n## 第八步：让 AI 帮你安装 Trade\n\n重新启动 Hermes（输入 `hermes`），在聊天框里**复制粘贴**下面这句话：\n\n```\n请帮我安装 trade，地址是 https://github.com/chefroger/smart-trade-ai\n```\n\nAI 会自己去 GitHub 查看项目说明，然后自动执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。\n\n装完后，**关闭当前 PowerShell，重新打开一个新的**，输入：\n\n```\ntrade\n```\n\n浏览器会自动打开 Trade 界面。如果没有自动打开，手动访问 **http://127.0.0.1:9119/trade**。\n\n> 验证能用后，按 `Ctrl+C` 退出 trade（暂时退出，下一步设置开机自启后会自动运行）。\n\n---\n\n## 第九步：设置 Hermes Gateway 开机自启\n\nHermes Gateway 是定时任务调度器，Trade 的定时简报、定时询盘检查都依赖它。必须让它随系统启动，否则每天还要手动开。\n\n在 PowerShell 里执行：\n\n```\nhermes gateway install\n```\n\n看到「服务已安装」或类似提示即成功。**以后开机时 Hermes Gateway 会自动在后台运行，无需手动启动。**\n\n> 验证是否装好：按 `Win+R`，输入 `services.msc`，回车。在列表里找到「Hermes Gateway」服务，状态应为「正在运行」。\n\n---\n\n## 第十步：设置 Trade 开机自启（无终端窗口）\n\n上一步装好了 Gateway，但 Trade 本身还没设为自启。这一步用**注册表 + VBS 脚本**的方式让 Trade 开机自动运行，**且不弹出任何终端窗口**——开机后直接打开浏览器访问 **http://127.0.0.1:9119/trade** 就能用。\n\n### 10.1 创建启动器脚本（VBS + BAT，带日志）\n\n把下面**整段命令**复制粘贴到 PowerShell 里，按回车：\n\n```powershell\n# 探测 trade.exe 完整路径（避免开机时 PATH 未完全加载导致找不到）\n$tradeExe = (Get-Command trade -ErrorAction Stop).Source\nif (-not $tradeExe) {\n Write-Host \"❌ 找不到 trade.exe，请先确认 trade 已安装\" -ForegroundColor Red\n} else {\n Write-Host \"找到 trade.exe：$tradeExe\" -ForegroundColor Green\n $dir = \"$env:LOCALAPPDATA\\trade\"\n $bat = \"$dir\\trade-autostart.bat\"\n $vbs = \"$dir\\trade-autostart.vbs\"\n $logFile = \"$dir\\trade-autostart.log\"\n New-Item -ItemType Directory -Force -Path $dir | Out-Null\n\n # .bat 用完整路径调用 trade.exe 并重定向日志（启动失败时可查日志）\n @\"\n@echo off\n\"$tradeExe\" > \"$logFile\" 2>&1\n\"@ | Out-File -FilePath $bat -Encoding ASCII\n\n # VBS 隐藏窗口启动 .bat（不等待，不弹窗）\n @\"\nSet WshShell = CreateObject(\"WScript.Shell\")\nWshShell.Run \"cmd /c \"\"$bat\"\"\", 0, False\n\"@ | Out-File -FilePath $vbs -Encoding ASCII\n\n Write-Host \"已创建启动器：$vbs\" -ForegroundColor Green\n Write-Host \"日志文件：$logFile（启动失败时打开它排查）\" -ForegroundColor Yellow\n}\n```\n\n看到绿色「已创建启动器」即成功。\n\n> **这段命令做了什么：**\n> 1. 用 `Get-Command trade` 探测 `trade.exe` 的完整路径，写入 .bat 文件——**不依赖 PATH**，开机早期也能找到\n> 2. .bat 把 trade 的所有输出重定向到 `trade-autostart.log`——启动失败时打开这个日志就能看到错误，不用两眼一抹黑\n> 3. VBS 以**隐藏窗口**模式启动 .bat——不会弹出黑框终端\n\n### 10.2 写入注册表，开机自动运行该脚本\n\n继续在 PowerShell 里粘贴下面这行，按回车：\n\n```powershell\nNew-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Value \"wscript.exe `\"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs`\"\" -PropertyType String -Force\n```\n\n没有报错就说明写入成功。\n\n### 10.3 立即测试（可选但推荐）\n\n不想等到明天才验证？在 PowerShell 里执行：\n\n```powershell\nwscript.exe \"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs\"\n```\n\n等约 15 秒，然后打开浏览器访问 **http://127.0.0.1:9119/trade**。如果能看到 Trade 界面，且**没有弹出任何终端窗口**，说明配置完全正确。\n\n> **如果打不开**：打开文件 `%LOCALAPPDATA%\\trade\\trade-autostart.log`（直接在资源管理器地址栏粘贴这个路径回车），看里面的错误信息。最常见的是 `ModuleNotFoundError`——说明 trade 安装有问题，回到第八步重装。\n\n> **以后的使用方式：** 每天打开电脑，等约 30 秒（系统启动 + Trade 自动启动），直接浏览器访问 **http://127.0.0.1:9119/trade** 即可，**再也不用打开 PowerShell 手动输入 `trade`**。\n\n### 10.4 如果想取消开机自启\n\n将来不想要自启了，在 PowerShell 里执行：\n\n```powershell\nRemove-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Force\n```\n\n即可移除自启，不影响 Trade 本身的使用。\n\n---\n\n## 常见问题\n\n| 你看到的现象 | 怎么解决 |\n|------------|---------|\n| 第五步安装 Hermes 卡住不动 | 科学上网没开好。确认 VPN 是全局模式，关掉 PowerShell 重开再试 |\n| `hermes` 输入后提示「不是内部或外部命令」 | 关掉 PowerShell 重新打开一个新的 |\n| `trade` 输入后提示「不是内部或外部命令」 | 改成输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 然后 `python server.py` |\n| Hermes 对话没反应 | API Key 没配置对。重新运行 `hermes setup` 检查 |\n| 浏览器打开显示「无法访问此网站」 | 程序没在运行。打开一个新的 PowerShell，输入 `trade` 启动 |\n| 开机后访问 127.0.0.1:9119/trade 打不开 | Trade 自启还没跑完，等 30 秒再试。若仍不行，打开 `%LOCALAPPDATA%\\trade\\trade-autostart.log` 看错误日志；或按 `Win+R` 输入 `taskmgr` 回车，看进程里有没有 `python.exe`，没有就手动运行第十步的 VBS 脚本 |\n| 定时任务（每日简报等）不执行 | 第九步的 Hermes Gateway 没装好或没运行。重新执行 `hermes gateway install`，再到 `services.msc` 确认服务状态 |\n| 提示「Filename too long」 | 第五步的长路径设置没做。回到 5.2 执行那行命令，然后**重启电脑** |\n\n---\n\n<p style=\"text-align:center; color:#8b949e; margin-top:3rem;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n\n---\n\n## Skills 参考手册\n\nTrade 会自动识别你的意图，匹配合适的技能。以下是全部 24 个技能的详细说明和使用示例。\n\n### 24 个技能速查\n\n| # | 技能 | 功能 | 典型提示词示例 |\n|---|------|------|---------------|\n| 1 | **b2b-osint** | 客户背景调查（6 层检测） | 帮我查一下这家公司 / 背调这个邮箱 / 查一下域名注册时间 |\n| 2 | **b2b-email-intel** | 邮箱情报（120+ 平台检测） | 查一下这个邮箱哪个平台注册了 / 邮箱是真的吗 |\n| 3 | **b2b-lead-generation** | 多通道客户搜索与开发 | 帮我找一下德国的 XX 产品客户 / 写一封开发信给美国客户 |\n| 4 | **b2b-document** | 本地文档分析与提取 | 分析一下这份报价单 / 帮我看看这个合同有什么问题 |\n| 5 | **b2b-doc-generation** | 生成报价/合同/提案文件 | 帮我生成一份 PDF 报价单 / 做一份产品介绍 PPT |\n| 6 | **b2b-platform** | B2B 平台店铺诊断优化 | 帮我看看这个阿里国际站产品页 / 优化一下产品标题 |\n| 7 | **b2b-linkedin-marketing** | LinkedIn 营销策略与内容 | 帮我想一下领英发什么内容 / 写一个 LinkedIn Add Note |\n| 8 | **b2b-social-media** | 社媒营销（FB/Ins/TikTok/YT） | 帮我做一个 Facebook 内容计划 / 写一个 TikTok 脚本 |\n| 9 | **b2b-customs-data** | 海关数据分析找采购商 | 帮我看看谁在进口这个产品 / 分析一下这个 HS 编码 |\n| 10 | **b2b-onboarding** | 新公司全套部署方案 | 我刚做外贸，帮我制定一个营销方案 / 新公司怎么开始 |\n| 11 | **b2b-daily-automation** | 定时任务（早报/晚报/周报） | 每天早上 8 点给我一份简报 / 设置一个每日工作总结 |\n| 12 | **b2b-customer-mgmt** | 客户档案与分级管理 | 帮我查一下 XX 公司的信息 / A 级客户有哪些 |\n| 13 | **b2b-data-directory** | 数据目录结构管理 | 我的数据存在哪了 / 帮我初始化一下数据目录 |\n| 14 | **chat-memory** | 历史对话查询 | 上次和 XX 公司聊到什么了 / 之前那份报价是多少 |\n| 15 | **b2b-skill-generator** | 动态创建新的 B2B Skill | 帮我创建一个新的 skill，用来查 XX |\n| 16 | **b2b-trade-ops** | 外贸履约与售后沟通 | 帮我写一封催款邮件 / 客户投诉质量有问题怎么办 |\n| 17 | **b2b-trade-compliance** | 合规检查与文化禁忌 | 这个颜色在沙特有什么忌讳吗 / 检查一下 FOB 写对了没有 |\n| 18 | **b2b-cold-outreach** | 冷 outreach 邮件撰写 | 给德国的 XX 公司写一封开发信 / 写一封产品推广信 |\n| 19 | **auto-trade-customer-development** | 全自动客户开发流水线 | 帮我跑一轮自动化客户开发 / 全自动开发一批客户 |\n| 20 | **auto-smtp-email** | SMTP 邮件发送 | 把这封开发信发出去 / 群发这批邮件，间隔 60 秒 |\n| 21 | **b2b-email-imitation** | 开发信仿写与再创作 | 参考这封邮件，帮我写一个类似的 / 模仿这个风格写一封开发信 |\n| 22 | **b2b-buyer-persona** | 买家画像与角色分层 | 帮我分析一下买家画像 / 针对采购经理应该怎么沟通 |\n| 23 | **b2b-market-analysis** | 市场分析作战地图 | 分析一下德国市场进入策略 / 帮我做一个中东市场调研 |\n| 24 | **b2b-sales-pipeline** | 销售管线与跟进策略 | 这个客户一个月没回了怎么办 / 帮我设计一个 30 天跟进计划 |\n\n### 技能自动匹配原理\n\n当你在聊天框输入内容时，Trade 会自动匹配关键词，调用最合适的 skill。匹配规则：\n\n- **词边界匹配**（+3 分）：独立关键词命中，如\"背调\"、\"开发信\"、\"海关数据\"\n- **子串匹配**（+1 分）：关键词出现在句子中，如\"帮我查一下这个公司\"匹配到\"查公司\"\n- **显式调用**（最高优先级）：用\"用 b2b-xxx\" 或 \"加载 skill b2b-xxx\" 直接指定\n\n得分最高的 skill 会被激活。如果连续使用同一个 skill，系统会用简短的提示词继续（节省 token）。\n\n### 如何查看当前激活的技能\n\n当 Trade 匹配到一个 skill 时，在回复的开头会显示技能名称，如 `[SKILL AUGMENTATION] 技能触发：b2b-osint`。你也可以直接输入\"用 b2b-osint 查一下这个邮箱\"来强制指定某个技能。\n\n### 技能别名\n\n部分技能之间存在别名关联，输入一个技能名可能触发相关联的技能：\n\n| 输入技能 | 也会触发 |\n|----------|---------|\n| b2b-osint | b2b-email-intel |\n| b2b-lead-generation | b2b-customer-mgmt |\n| b2b-trade-ops | b2b-customer-mgmt |\n| auto-trade-customer-development | b2b-lead-generation, b2b-osint, auto-smtp-email |\n</p>\n"}, "406d1b91b0e0ac499ace9410836dacf1110d18e4": {"t": 1785772977.1753063, "n": 7879, "h": "8f7b5330b470b926", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n .step-num { display:inline-block; width:32px; height:32px; line-height:32px;\n text-align:center; background:#2563EB; color:#fff; border-radius:50%;\n font-weight:bold; font-size:16px; margin-right:8px; }\n .step-title { font-size:1.3rem; font-weight:bold; margin:1.5rem 0 0.5rem; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">Windows 版安装教程 · 不需要懂技术，跟着步骤走，20 分钟装好</p>\n</div>\n\n<div style=\"text-align:center; margin:1rem 0;\">\n <p style=\"color:#8b949e; margin-bottom:0.5rem;\">安装遇到问题？扫码加微信，备注「Trade」</p>\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"180\" style=\"border-radius:8px;\">\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n## 第一步：确保科学上网已启动\n\n这个工具需要从 GitHub 下载代码，而 GitHub 在国内访问不稳定。在开始之前，**必须先打开你的科学上网工具**（VPN / Clash / V2Ray 等），确保网络通畅。\n\n**验证方法：** 打开 **Google Chrome 浏览器**，在地址栏输入 `github.com`，回车。如果页面能正常打开，说明网络没问题，可以继续。\n\n> 如果 GitHub 打不开，检查你的科学上网工具是否已启动、是否设为**全局模式**或 **TUN 模式**。\n\n---\n\n## 第二步：注册 DeepSeek 并获取 API Key\n\nAI 不是免费的，需要去 DeepSeek 注册账号并充值。\n\n1. 用 **Google Chrome 浏览器** 打开 **platform.deepseek.com**\n2. 点击「注册」，用手机号注册一个账号\n3. 登录后，点击页面上的「**充值**」，**充值 10 元以上**（按用量扣费，10 块钱能用很久）\n4. 在左侧菜单找到「**API Keys**」，点击进入\n5. 点击「**创建 API Key**」，名称填 `trade`，点确定\n6. 页面上会显示一串字符（以 `sk-` 开头）——这就是你的 **DeepSeek API Key**\n7. **立刻复制保存**，关掉后就再也看不到了\n\n> 把这串 Key 先粘贴到记事本里，后面要用。\n\n---\n\n## 第三步：注册 Tavily 并获取 API Key\n\nTavily 是联网搜索引擎，让 AI 能搜索实时信息。\n\n1. 用 **Google Chrome 浏览器** 打开 **tavily.com**\n2. 点击「Sign Up」，**用 Gmail 邮箱注册**一个账号\n3. 登录后进入 Dashboard，在 API Keys 区域找到你的 Key（以 `tvly-` 开头）\n4. **复制保存**到记事本里\n\n> Tavily 每月有 1000 次免费搜索额度，个人使用足够了。\n\n---\n\n## 第四步：在桌面创建 API Key 文件\n\n把刚才拿到的两个 Key 整理到一个文件里，后面配置时会用到。\n\n1. 在桌面上**右键** → 新建 → 文本文档\n2. 把文件重命名为 `apikey.txt`\n3. 打开文件，按以下格式粘贴：\n\n```\nDeepSeek API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nTavily API Key: tvly-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\n4. 保存并关闭。后面配置 Hermes 时需要从这里复制粘贴。\n\n---\n\n## 第五步：安装 Hermes Agent（AI 引擎）\n\nHermes Agent 是驱动 AI 的底层引擎，Trade 基于它运行。\n\n### 5.1 以管理员身份打开 PowerShell\n\n1. 按键盘 **Win 键**，输入 `powershell`\n2. **右键点击**搜索结果里的「Windows PowerShell」\n3. 选择「**以管理员身份运行**」\n4. 弹出提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n\n### 5.2 开启长路径支持\n\n在 PowerShell 里粘贴下面这行命令，按回车：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n### 5.3 一键安装 Hermes\n\n接着执行下面这行命令：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n等待几分钟，看到「安装完成」提示即可。\n\n> 在 PowerShell 里粘贴的方法是**点一下鼠标右键**（不是 Ctrl+V）。\n\n---\n\n## 第六步：配置 Hermes（大模型 + 搜索）\n\n安装完成后，在同一个 PowerShell 窗口输入：\n\n```\nhermes setup\n```\n\n这时会出现交互配置界面，按以下步骤操作：\n\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」→ 按回车\n2. 选择模型时，选「**deepseek-v4-flash**」（即 DeepSeek V4 Flash）→ 按回车\n3. 粘贴你的 **DeepSeek API Key**（从桌面的 `apikey.txt` 复制）→ 按回车\n4. 搜索服务选「**Tavily**」→ 按回车\n5. 粘贴你的 **Tavily API Key** → 按回车\n\n看到「配置成功」提示就完成了。\n\n---\n\n## 第七步：验证 Hermes 是否正常\n\n在 PowerShell 里输入：\n\n```\nhermes\n```\n\n等它启动后，在对话框里输入：\n\n```\nhello\n```\n\n按回车发送。如果 AI 正常回复了，说明大模型配置成功。\n\n> 按 `Ctrl+C` 可以退出 Hermes，回到命令行。\n\n---\n\n## 第八步：让 AI 帮你安装 Trade\n\n重新启动 Hermes（输入 `hermes`），在聊天框里**复制粘贴**下面这句话：\n\n```\n请帮我安装 trade，地址是 https://github.com/chefroger/smart-trade-ai\n```\n\nAI 会自己去 GitHub 查看项目说明，然后自动执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。\n\n装完后，**关闭当前 PowerShell，重新打开一个新的**，输入：\n\n```\ntrade\n```\n\n浏览器会自动打开 Trade 界面。如果没有自动打开，手动访问 **http://127.0.0.1:9119/trade**。\n\n> 验证能用后，按 `Ctrl+C` 退出 trade（暂时退出，下一步设置开机自启后会自动运行）。\n\n---\n\n## 第九步：设置 Hermes Gateway 开机自启\n\nHermes Gateway 是定时任务调度器，Trade 的定时简报、定时询盘检查都依赖它。必须让它随系统启动，否则每天还要手动开。\n\n在 PowerShell 里执行：\n\n```\nhermes gateway install\n```\n\n看到「服务已安装」或类似提示即成功。**以后开机时 Hermes Gateway 会自动在后台运行，无需手动启动。**\n\n> 验证是否装好：按 `Win+R`，输入 `services.msc`，回车。在列表里找到「Hermes Gateway」服务，状态应为「正在运行」。\n\n---\n\n## 第十步：设置 Trade 开机自启（无终端窗口）\n\n上一步装好了 Gateway，但 Trade 本身还没设为自启。这一步用**注册表 + VBS 脚本**的方式让 Trade 开机自动运行，**且不弹出任何终端窗口**——开机后直接打开浏览器访问 **http://127.0.0.1:9119/trade** 就能用。\n\n### 10.1 创建启动器脚本（VBS + BAT，带日志）\n\n把下面**整段命令**复制粘贴到 PowerShell 里，按回车：\n\n```powershell\n# 探测 trade.exe 完整路径（避免开机时 PATH 未完全加载导致找不到）\n$tradeExe = (Get-Command trade -ErrorAction Stop).Source\nif (-not $tradeExe) {\n Write-Host \"❌ 找不到 trade.exe，请先确认 trade 已安装\" -ForegroundColor Red\n} else {\n Write-Host \"找到 trade.exe：$tradeExe\" -ForegroundColor Green\n $dir = \"$env:LOCALAPPDATA\\trade\"\n $bat = \"$dir\\trade-autostart.bat\"\n $vbs = \"$dir\\trade-autostart.vbs\"\n $logFile = \"$dir\\trade-autostart.log\"\n New-Item -ItemType Directory -Force -Path $dir | Out-Null\n\n # .bat 用完整路径调用 trade.exe 并重定向日志（启动失败时可查日志）\n @\"\n@echo off\n\"$tradeExe\" > \"$logFile\" 2>&1\n\"@ | Out-File -FilePath $bat -Encoding ASCII\n\n # VBS 隐藏窗口启动 .bat（不等待，不弹窗）\n @\"\nSet WshShell = CreateObject(\"WScript.Shell\")\nWshShell.Run \"cmd /c \"\"$bat\"\"\", 0, False\n\"@ | Out-File -FilePath $vbs -Encoding ASCII\n\n Write-Host \"已创建启动器：$vbs\" -ForegroundColor Green\n Write-Host \"日志文件：$logFile（启动失败时打开它排查）\" -ForegroundColor Yellow\n}\n```\n\n看到绿色「已创建启动器」即成功。\n\n> **这段命令做了什么：**\n> 1. 用 `Get-Command trade` 探测 `trade.exe` 的完整路径，写入 .bat 文件——**不依赖 PATH**，开机早期也能找到\n> 2. .bat 把 trade 的所有输出重定向到 `trade-autostart.log`——启动失败时打开这个日志就能看到错误，不用两眼一抹黑\n> 3. VBS 以**隐藏窗口**模式启动 .bat——不会弹出黑框终端\n\n### 10.2 写入注册表，开机自动运行该脚本\n\n继续在 PowerShell 里粘贴下面这行，按回车：\n\n```powershell\nNew-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Value \"wscript.exe `\"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs`\"\" -PropertyType String -Force\n```\n\n没有报错就说明写入成功。\n\n### 10.3 立即测试（可选但推荐）\n\n不想等到明天才验证？在 PowerShell 里执行：\n\n```powershell\nwscript.exe \"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs\"\n```\n\n等约 15 秒，然后打开浏览器访问 **http://127.0.0.1:9119/trade**。如果能看到 Trade 界面，且**没有弹出任何终端窗口**，说明配置完全正确。\n\n> **如果打不开**：打开文件 `%LOCALAPPDATA%\\trade\\trade-autostart.log`（直接在资源管理器地址栏粘贴这个路径回车），看里面的错误信息。最常见的是 `ModuleNotFoundError`——说明 trade 安装有问题，回到第八步重装。\n\n> **以后的使用方式：** 每天打开电脑，等约 30 秒（系统启动 + Trade 自动启动），直接浏览器访问 **http://127.0.0.1:9119/trade** 即可，**再也不用打开 PowerShell 手动输入 `trade`**。\n\n### 10.4 如果想取消开机自启\n\n将来不想要自启了，在 PowerShell 里执行：\n\n```powershell\nRemove-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Force\n```\n\n即可移除自启，不影响 Trade 本身的使用。\n\n---\n\n## 常见问题\n\n| 你看到的现象 | 怎么解决 |\n|------------|---------|\n| 第五步安装 Hermes 卡住不动 | 科学上网没开好。确认 VPN 是全局模式，关掉 PowerShell 重开再试 |\n| `hermes` 输入后提示「不是内部或外部命令」 | 关掉 PowerShell 重新打开一个新的 |\n| `trade` 输入后提示「不是内部或外部命令」 | 改成输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 然后 `python server.py` |\n| Hermes 对话没反应 | API Key 没配置对。重新运行 `hermes setup` 检查 |\n| 浏览器打开显示「无法访问此网站」 | 程序没在运行。打开一个新的 PowerShell，输入 `trade` 启动 |\n| 开机后访问 127.0.0.1:9119/trade 打不开 | Trade 自启还没跑完，等 30 秒再试。若仍不行，打开 `%LOCALAPPDATA%\\trade\\trade-autostart.log` 看错误日志；或按 `Win+R` 输入 `taskmgr` 回车，看进程里有没有 `python.exe`，没有就手动运行第十步的 VBS 脚本 |\n| 定时任务（每日简报等）不执行 | 第九步的 Hermes Gateway 没装好或没运行。重新执行 `hermes gateway install`，再到 `services.msc` 确认服务状态 |\n| 提示「Filename too long」 | 第五步的长路径设置没做。回到 5.2 执行那行命令，然后**重启电脑** |\n\n---\n\n<p style=\"text-align:center; color:#8b949e; margin-top:3rem;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n"}, "80fd2a9efea68dde85142853e6ccc89305e1083d": {"t": 1785772978.5169148, "n": 6976, "h": "572e8a124a55473d", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n .step-num { display:inline-block; width:32px; height:32px; line-height:32px;\n text-align:center; background:#2563EB; color:#fff; border-radius:50%;\n font-weight:bold; font-size:16px; margin-right:8px; }\n .step-title { font-size:1.3rem; font-weight:bold; margin:1.5rem 0 0.5rem; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">Windows 版安装教程 · 不需要懂技术，跟着步骤走，20 分钟装好</p>\n</div>\n\n<div style=\"text-align:center; margin:1rem 0;\">\n <p style=\"color:#8b949e; margin-bottom:0.5rem;\">安装遇到问题？扫码加微信，备注「Trade」</p>\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"180\" style=\"border-radius:8px;\">\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n## 第一步：确保科学上网已启动\n\n这个工具需要从 GitHub 下载代码，而 GitHub 在国内访问不稳定。在开始之前，**必须先打开你的科学上网工具**（VPN / Clash / V2Ray 等），确保网络通畅。\n\n**验证方法：** 打开 **Google Chrome 浏览器**，在地址栏输入 `github.com`，回车。如果页面能正常打开，说明网络没问题，可以继续。\n\n> 如果 GitHub 打不开，检查你的科学上网工具是否已启动、是否设为**全局模式**或 **TUN 模式**。\n\n---\n\n## 第二步：注册 DeepSeek 并获取 API Key\n\nAI 不是免费的，需要去 DeepSeek 注册账号并充值。\n\n1. 用 **Google Chrome 浏览器** 打开 **platform.deepseek.com**\n2. 点击「注册」，用手机号注册一个账号\n3. 登录后，点击页面上的「**充值**」，**充值 10 元以上**（按用量扣费，10 块钱能用很久）\n4. 在左侧菜单找到「**API Keys**」，点击进入\n5. 点击「**创建 API Key**」，名称填 `trade`，点确定\n6. 页面上会显示一串字符（以 `sk-` 开头）——这就是你的 **DeepSeek API Key**\n7. **立刻复制保存**，关掉后就再也看不到了\n\n> 把这串 Key 先粘贴到记事本里，后面要用。\n\n---\n\n## 第三步：注册 Tavily 并获取 API Key\n\nTavily 是联网搜索引擎，让 AI 能搜索实时信息。\n\n1. 用 **Google Chrome 浏览器** 打开 **tavily.com**\n2. 点击「Sign Up」，**用 Gmail 邮箱注册**一个账号\n3. 登录后进入 Dashboard，在 API Keys 区域找到你的 Key（以 `tvly-` 开头）\n4. **复制保存**到记事本里\n\n> Tavily 每月有 1000 次免费搜索额度，个人使用足够了。\n\n---\n\n## 第四步：在桌面创建 API Key 文件\n\n把刚才拿到的两个 Key 整理到一个文件里，后面配置时会用到。\n\n1. 在桌面上**右键** → 新建 → 文本文档\n2. 把文件重命名为 `apikey.txt`\n3. 打开文件，按以下格式粘贴：\n\n```\nDeepSeek API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nTavily API Key: tvly-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\n4. 保存并关闭。后面配置 Hermes 时需要从这里复制粘贴。\n\n---\n\n## 第五步：安装 Hermes Agent（AI 引擎）\n\nHermes Agent 是驱动 AI 的底层引擎，Trade 基于它运行。\n\n### 5.1 以管理员身份打开 PowerShell\n\n1. 按键盘 **Win 键**，输入 `powershell`\n2. **右键点击**搜索结果里的「Windows PowerShell」\n3. 选择「**以管理员身份运行**」\n4. 弹出提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n\n### 5.2 开启长路径支持\n\n在 PowerShell 里粘贴下面这行命令，按回车：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n### 5.3 一键安装 Hermes\n\n接着执行下面这行命令：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n等待几分钟，看到「安装完成」提示即可。\n\n> 在 PowerShell 里粘贴的方法是**点一下鼠标右键**（不是 Ctrl+V）。\n\n---\n\n## 第六步：配置 Hermes（大模型 + 搜索）\n\n安装完成后，在同一个 PowerShell 窗口输入：\n\n```\nhermes setup\n```\n\n这时会出现交互配置界面，按以下步骤操作：\n\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」→ 按回车\n2. 选择模型时，选「**deepseek-v4-flash**」（即 DeepSeek V4 Flash）→ 按回车\n3. 粘贴你的 **DeepSeek API Key**（从桌面的 `apikey.txt` 复制）→ 按回车\n4. 搜索服务选「**Tavily**」→ 按回车\n5. 粘贴你的 **Tavily API Key** → 按回车\n\n看到「配置成功」提示就完成了。\n\n---\n\n## 第七步：验证 Hermes 是否正常\n\n在 PowerShell 里输入：\n\n```\nhermes\n```\n\n等它启动后，在对话框里输入：\n\n```\nhello\n```\n\n按回车发送。如果 AI 正常回复了，说明大模型配置成功。\n\n> 按 `Ctrl+C` 可以退出 Hermes，回到命令行。\n\n---\n\n## 第八步：让 AI 帮你安装 Trade\n\n重新启动 Hermes（输入 `hermes`），在聊天框里**复制粘贴**下面这句话：\n\n```\n请帮我安装 trade，地址是 https://github.com/chefroger/smart-trade-ai\n```\n\nAI 会自己去 GitHub 查看项目说明，然后自动执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。\n\n装完后，**关闭当前 PowerShell，重新打开一个新的**，输入：\n\n```\ntrade\n```\n\n浏览器会自动打开 Trade 界面。如果没有自动打开，手动访问 **http://127.0.0.1:9119/trade**。\n\n> 验证能用后，按 `Ctrl+C` 退出 trade（暂时退出，下一步设置开机自启后会自动运行）。\n\n---\n\n## 第九步：设置 Hermes Gateway 开机自启\n\nHermes Gateway 是定时任务调度器，Trade 的定时简报、定时询盘检查都依赖它。必须让它随系统启动，否则每天还要手动开。\n\n在 PowerShell 里执行：\n\n```\nhermes gateway install\n```\n\n看到「服务已安装」或类似提示即成功。**以后开机时 Hermes Gateway 会自动在后台运行，无需手动启动。**\n\n> 验证是否装好：按 `Win+R`，输入 `services.msc`，回车。在列表里找到「Hermes Gateway」服务，状态应为「正在运行」。\n\n---\n\n## 第十步：设置 Trade 开机自启（无终端窗口）\n\n上一步装好了 Gateway，但 Trade 本身还没设为自启。这一步用**注册表 + VBS 脚本**的方式让 Trade 开机自动运行，**且不弹出任何终端窗口**——开机后直接打开浏览器访问 **http://127.0.0.1:9119/trade** 就能用。\n\n### 10.1 创建 VBS 启动器脚本\n\n把下面**整段命令**复制粘贴到 PowerShell 里，按回车：\n\n```powershell\n$vbs = \"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs\"\nNew-Item -ItemType Directory -Force -Path (Split-Path $vbs) | Out-Null\n@\"\nSet WshShell = CreateObject(\"WScript.Shell\")\nWshShell.Run \"cmd /c trade\", 0, False\n\"@ | Out-File -FilePath $vbs -Encoding ASCII\nWrite-Host \"已创建 VBS 启动器：$vbs\" -ForegroundColor Green\n```\n\n看到绿色提示「已创建 VBS 启动器」即成功。\n\n> **这段命令做了什么：** 在 `%LOCALAPPDATA%\\trade\\` 目录下创建一个 VBS 脚本，它通过 `WScript.Shell` 以**隐藏窗口**模式运行 `trade` 命令，所以不会弹出黑框终端。\n\n### 10.2 写入注册表，开机自动运行该脚本\n\n继续在 PowerShell 里粘贴下面这行，按回车：\n\n```powershell\nNew-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Value \"wscript.exe `\"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs`\"\" -PropertyType String -Force\n```\n\n没有报错就说明写入成功。\n\n### 10.3 立即测试（可选但推荐）\n\n不想等到明天才验证？在 PowerShell 里执行：\n\n```powershell\nwscript.exe \"$env:LOCALAPPDATA\\trade\\trade-autostart.vbs\"\n```\n\n等约 10 秒，然后打开浏览器访问 **http://127.0.0.1:9119/trade**。如果能看到 Trade 界面，且**没有弹出任何终端窗口**，说明配置完全正确。\n\n> **以后的使用方式：** 每天打开电脑，等约 30 秒（系统启动 + Trade 自动启动），直接浏览器访问 **http://127.0.0.1:9119/trade** 即可，**再也不用打开 PowerShell 手动输入 `trade`**。\n\n### 10.4 如果想取消开机自启\n\n将来不想要自启了，在 PowerShell 里执行：\n\n```powershell\nRemove-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Run\" -Name \"TradeAutoStart\" -Force\n```\n\n即可移除自启，不影响 Trade 本身的使用。\n\n---\n\n## 常见问题\n\n| 你看到的现象 | 怎么解决 |\n|------------|---------|\n| 第五步安装 Hermes 卡住不动 | 科学上网没开好。确认 VPN 是全局模式，关掉 PowerShell 重开再试 |\n| `hermes` 输入后提示「不是内部或外部命令」 | 关掉 PowerShell 重新打开一个新的 |\n| `trade` 输入后提示「不是内部或外部命令」 | 改成输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 然后 `python server.py` |\n| Hermes 对话没反应 | API Key 没配置对。重新运行 `hermes setup` 检查 |\n| 浏览器打开显示「无法访问此网站」 | 程序没在运行。打开一个新的 PowerShell，输入 `trade` 启动 |\n| 开机后访问 127.0.0.1:9119/trade 打不开 | Trade 自启还没跑完，等 30 秒再试。若仍不行，按 `Win+R` 输入 `taskmgr` 回车，看进程里有没有 `python.exe`，没有就手动运行第十步的 VBS 脚本 |\n| 定时任务（每日简报等）不执行 | 第九步的 Hermes Gateway 没装好或没运行。重新执行 `hermes gateway install`，再到 `services.msc` 确认服务状态 |\n| 提示「Filename too long」 | 第五步的长路径设置没做。回到 5.2 执行那行命令，然后**重启电脑** |\n\n---\n\n<p style=\"text-align:center; color:#8b949e; margin-top:3rem;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n"}, "134a1af98c4ffc990492769a9154d39eee44f151": {"t": 1785772980.4652712, "n": 4862, "h": "d1439ec6d4076004", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n .step-num { display:inline-block; width:32px; height:32px; line-height:32px;\n text-align:center; background:#2563EB; color:#fff; border-radius:50%;\n font-weight:bold; font-size:16px; margin-right:8px; }\n .step-title { font-size:1.3rem; font-weight:bold; margin:1.5rem 0 0.5rem; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">Windows 版安装教程 · 不需要懂技术，跟着步骤走，20 分钟装好</p>\n</div>\n\n<div style=\"text-align:center; margin:1rem 0;\">\n <p style=\"color:#8b949e; margin-bottom:0.5rem;\">安装遇到问题？扫码加微信，备注「Trade」</p>\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"180\" style=\"border-radius:8px;\">\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n## 第一步：确保科学上网已启动\n\n这个工具需要从 GitHub 下载代码，而 GitHub 在国内访问不稳定。在开始之前，**必须先打开你的科学上网工具**（VPN / Clash / V2Ray 等），确保网络通畅。\n\n**验证方法：** 打开 **Google Chrome 浏览器**，在地址栏输入 `github.com`，回车。如果页面能正常打开，说明网络没问题，可以继续。\n\n> 如果 GitHub 打不开，检查你的科学上网工具是否已启动、是否设为**全局模式**或 **TUN 模式**。\n\n---\n\n## 第二步：注册 DeepSeek 并获取 API Key\n\nAI 不是免费的，需要去 DeepSeek 注册账号并充值。\n\n1. 用 **Google Chrome 浏览器** 打开 **platform.deepseek.com**\n2. 点击「注册」，用手机号注册一个账号\n3. 登录后，点击页面上的「**充值**」，**充值 10 元以上**（按用量扣费，10 块钱能用很久）\n4. 在左侧菜单找到「**API Keys**」，点击进入\n5. 点击「**创建 API Key**」，名称填 `trade`，点确定\n6. 页面上会显示一串字符（以 `sk-` 开头）——这就是你的 **DeepSeek API Key**\n7. **立刻复制保存**，关掉后就再也看不到了\n\n> 把这串 Key 先粘贴到记事本里，后面要用。\n\n---\n\n## 第三步：注册 Tavily 并获取 API Key\n\nTavily 是联网搜索引擎，让 AI 能搜索实时信息。\n\n1. 用 **Google Chrome 浏览器** 打开 **tavily.com**\n2. 点击「Sign Up」，**用 Gmail 邮箱注册**一个账号\n3. 登录后进入 Dashboard，在 API Keys 区域找到你的 Key（以 `tvly-` 开头）\n4. **复制保存**到记事本里\n\n> Tavily 每月有 1000 次免费搜索额度，个人使用足够了。\n\n---\n\n## 第四步：在桌面创建 API Key 文件\n\n把刚才拿到的两个 Key 整理到一个文件里，后面配置时会用到。\n\n1. 在桌面上**右键** → 新建 → 文本文档\n2. 把文件重命名为 `apikey.txt`\n3. 打开文件，按以下格式粘贴：\n\n```\nDeepSeek API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nTavily API Key: tvly-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\n4. 保存并关闭。后面配置 Hermes 时需要从这里复制粘贴。\n\n---\n\n## 第五步：安装 Hermes Agent（AI 引擎）\n\nHermes Agent 是驱动 AI 的底层引擎，Trade 基于它运行。\n\n### 5.1 以管理员身份打开 PowerShell\n\n1. 按键盘 **Win 键**，输入 `powershell`\n2. **右键点击**搜索结果里的「Windows PowerShell」\n3. 选择「**以管理员身份运行**」\n4. 弹出提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n\n### 5.2 开启长路径支持\n\n在 PowerShell 里粘贴下面这行命令，按回车：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n### 5.3 一键安装 Hermes\n\n接着执行下面这行命令：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n等待几分钟，看到「安装完成」提示即可。\n\n> 在 PowerShell 里粘贴的方法是**点一下鼠标右键**（不是 Ctrl+V）。\n\n---\n\n## 第六步：配置 Hermes（大模型 + 搜索）\n\n安装完成后，在同一个 PowerShell 窗口输入：\n\n```\nhermes setup\n```\n\n这时会出现交互配置界面，按以下步骤操作：\n\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」→ 按回车\n2. 选择模型时，选「**deepseek-v4-flash**」（即 DeepSeek V4 Flash）→ 按回车\n3. 粘贴你的 **DeepSeek API Key**（从桌面的 `apikey.txt` 复制）→ 按回车\n4. 搜索服务选「**Tavily**」→ 按回车\n5. 粘贴你的 **Tavily API Key** → 按回车\n\n看到「配置成功」提示就完成了。\n\n---\n\n## 第七步：验证 Hermes 是否正常\n\n在 PowerShell 里输入：\n\n```\nhermes\n```\n\n等它启动后，在对话框里输入：\n\n```\nhello\n```\n\n按回车发送。如果 AI 正常回复了，说明大模型配置成功。\n\n> 按 `Ctrl+C` 可以退出 Hermes，回到命令行。\n\n---\n\n## 第八步：让 AI 帮你安装 Trade\n\n重新启动 Hermes（输入 `hermes`），在聊天框里**复制粘贴**下面这句话：\n\n```\n请帮我安装 trade，地址是 https://github.com/chefroger/smart-trade-ai\n```\n\nAI 会自己去 GitHub 查看项目说明，然后自动执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。\n\n装完后，**关闭当前 PowerShell，重新打开一个新的**，输入：\n\n```\ntrade\n```\n\n浏览器会自动打开 Trade 界面。如果没有自动打开，手动访问 **http://127.0.0.1:9119/trade**。\n\n---\n\n## 常见问题\n\n| 你看到的现象 | 怎么解决 |\n|------------|---------|\n| 第五步安装 Hermes 卡住不动 | 科学上网没开好。确认 VPN 是全局模式，关掉 PowerShell 重开再试 |\n| `hermes` 输入后提示「不是内部或外部命令」 | 关掉 PowerShell 重新打开一个新的 |\n| `trade` 输入后提示「不是内部或外部命令」 | 改成输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 然后 `python server.py` |\n| Hermes 对话没反应 | API Key 没配置对。重新运行 `hermes setup` 检查 |\n| 浏览器打开显示「无法访问此网站」 | 程序没在运行。打开一个新的 PowerShell，输入 `trade` 启动 |\n| 提示「Filename too long」 | 第五步的长路径设置没做。回到 5.2 执行那行命令，然后**重启电脑** |\n\n---\n\n<p style=\"text-align:center; color:#8b949e; margin-top:3rem;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n"}, "916fb5f310ee391c0bc15d43e5388730e995f1e5": {"t": 1785772981.7870414, "n": 4635, "h": "257134fae4e3e364", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n .step-num { display:inline-block; width:32px; height:32px; line-height:32px;\n text-align:center; background:#2563EB; color:#fff; border-radius:50%;\n font-weight:bold; font-size:16px; margin-right:8px; }\n .step-title { font-size:1.3rem; font-weight:bold; margin:1.5rem 0 0.5rem; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">Windows 版安装教程 · 不需要懂技术，跟着步骤走，20 分钟装好</p>\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n## 第一步：确保科学上网已启动\n\n这个工具需要从 GitHub 下载代码，而 GitHub 在国内访问不稳定。在开始之前，**必须先打开你的科学上网工具**（VPN / Clash / V2Ray 等），确保网络通畅。\n\n**验证方法：** 打开 **Google Chrome 浏览器**，在地址栏输入 `github.com`，回车。如果页面能正常打开，说明网络没问题，可以继续。\n\n> 如果 GitHub 打不开，检查你的科学上网工具是否已启动、是否设为**全局模式**或 **TUN 模式**。\n\n---\n\n## 第二步：注册 DeepSeek 并获取 API Key\n\nAI 不是免费的，需要去 DeepSeek 注册账号并充值。\n\n1. 用 **Google Chrome 浏览器** 打开 **platform.deepseek.com**\n2. 点击「注册」，用手机号注册一个账号\n3. 登录后，点击页面上的「**充值**」，**充值 10 元以上**（按用量扣费，10 块钱能用很久）\n4. 在左侧菜单找到「**API Keys**」，点击进入\n5. 点击「**创建 API Key**」，名称填 `trade`，点确定\n6. 页面上会显示一串字符（以 `sk-` 开头）——这就是你的 **DeepSeek API Key**\n7. **立刻复制保存**，关掉后就再也看不到了\n\n> 把这串 Key 先粘贴到记事本里，后面要用。\n\n---\n\n## 第三步：注册 Tavily 并获取 API Key\n\nTavily 是联网搜索引擎，让 AI 能搜索实时信息。\n\n1. 用 **Google Chrome 浏览器** 打开 **tavily.com**\n2. 点击「Sign Up」，**用 Gmail 邮箱注册**一个账号\n3. 登录后进入 Dashboard，在 API Keys 区域找到你的 Key（以 `tvly-` 开头）\n4. **复制保存**到记事本里\n\n> Tavily 每月有 1000 次免费搜索额度，个人使用足够了。\n\n---\n\n## 第四步：在桌面创建 API Key 文件\n\n把刚才拿到的两个 Key 整理到一个文件里，后面配置时会用到。\n\n1. 在桌面上**右键** → 新建 → 文本文档\n2. 把文件重命名为 `apikey.txt`\n3. 打开文件，按以下格式粘贴：\n\n```\nDeepSeek API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nTavily API Key: tvly-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\n4. 保存并关闭。后面配置 Hermes 时需要从这里复制粘贴。\n\n---\n\n## 第五步：安装 Hermes Agent（AI 引擎）\n\nHermes Agent 是驱动 AI 的底层引擎，Trade 基于它运行。\n\n### 5.1 以管理员身份打开 PowerShell\n\n1. 按键盘 **Win 键**，输入 `powershell`\n2. **右键点击**搜索结果里的「Windows PowerShell」\n3. 选择「**以管理员身份运行**」\n4. 弹出提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n\n### 5.2 开启长路径支持\n\n在 PowerShell 里粘贴下面这行命令，按回车：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n### 5.3 一键安装 Hermes\n\n接着执行下面这行命令：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n等待几分钟，看到「安装完成」提示即可。\n\n> 在 PowerShell 里粘贴的方法是**点一下鼠标右键**（不是 Ctrl+V）。\n\n---\n\n## 第六步：配置 Hermes（大模型 + 搜索）\n\n安装完成后，在同一个 PowerShell 窗口输入：\n\n```\nhermes setup\n```\n\n这时会出现交互配置界面，按以下步骤操作：\n\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」→ 按回车\n2. 选择模型时，选「**deepseek-v4-flash**」（即 DeepSeek V4 Flash）→ 按回车\n3. 粘贴你的 **DeepSeek API Key**（从桌面的 `apikey.txt` 复制）→ 按回车\n4. 搜索服务选「**Tavily**」→ 按回车\n5. 粘贴你的 **Tavily API Key** → 按回车\n\n看到「配置成功」提示就完成了。\n\n---\n\n## 第七步：验证 Hermes 是否正常\n\n在 PowerShell 里输入：\n\n```\nhermes\n```\n\n等它启动后，在对话框里输入：\n\n```\nhello\n```\n\n按回车发送。如果 AI 正常回复了，说明大模型配置成功。\n\n> 按 `Ctrl+C` 可以退出 Hermes，回到命令行。\n\n---\n\n## 第八步：让 AI 帮你安装 Trade\n\n重新启动 Hermes（输入 `hermes`），在聊天框里**复制粘贴**下面这句话：\n\n```\n请帮我安装 trade，地址是 https://github.com/chefroger/smart-trade-ai\n```\n\nAI 会自己去 GitHub 查看项目说明，然后自动执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。\n\n装完后，**关闭当前 PowerShell，重新打开一个新的**，输入：\n\n```\ntrade\n```\n\n浏览器会自动打开 Trade 界面。如果没有自动打开，手动访问 **http://127.0.0.1:9119/trade**。\n\n---\n\n## 常见问题\n\n| 你看到的现象 | 怎么解决 |\n|------------|---------|\n| 第五步安装 Hermes 卡住不动 | 科学上网没开好。确认 VPN 是全局模式，关掉 PowerShell 重开再试 |\n| `hermes` 输入后提示「不是内部或外部命令」 | 关掉 PowerShell 重新打开一个新的 |\n| `trade` 输入后提示「不是内部或外部命令」 | 改成输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 然后 `python server.py` |\n| Hermes 对话没反应 | API Key 没配置对。重新运行 `hermes setup` 检查 |\n| 浏览器打开显示「无法访问此网站」 | 程序没在运行。打开一个新的 PowerShell，输入 `trade` 启动 |\n| 提示「Filename too long」 | 第五步的长路径设置没做。回到 5.2 执行那行命令，然后**重启电脑** |\n\n---\n\n<p style=\"text-align:center; color:#8b949e; margin-top:3rem;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n"}, "57d47905a368edd479968eda8ae166a8a7ed5016": {"t": 1785772983.7786186, "n": 4631, "h": "03eb2b6467f76c54", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n .step-num { display:inline-block; width:32px; height:32px; line-height:32px;\n text-align:center; background:#2563EB; color:#fff; border-radius:50%;\n font-weight:bold; font-size:16px; margin-right:8px; }\n .step-title { font-size:1.3rem; font-weight:bold; margin:1.5rem 0 0.5rem; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">Windows 版安装教程 · 不需要懂技术，跟着步骤走，20 分钟装好</p>\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n## 第一步：确保科学上网已启动\n\n这个工具需要从 GitHub 下载代码，而 GitHub 在国内访问不稳定。在开始之前，**必须先打开你的科学上网工具**（VPN / Clash / V2Ray 等），确保网络通畅。\n\n**验证方法：** 打开 **Google Chrome 浏览器**，在地址栏输入 `github.com`，回车。如果页面能正常打开，说明网络没问题，可以继续。\n\n> 如果 GitHub 打不开，检查你的科学上网工具是否已启动、是否设为**全局模式**或 **TUN 模式**。\n\n---\n\n## 第二步：注册 DeepSeek 并获取 API Key\n\nAI 不是免费的，需要去 DeepSeek 注册账号并充值。\n\n1. 用 **Google Chrome 浏览器** 打开 **platform.deepseek.com**\n2. 点击「注册」，用手机号注册一个账号\n3. 登录后，点击页面上的「**充值**」，**充值 10 元以上**（按用量扣费，10 块钱能用很久）\n4. 在左侧菜单找到「**API Keys**」，点击进入\n5. 点击「**创建 API Key**」，名称填 `trade`，点确定\n6. 页面上会显示一串字符（以 `sk-` 开头）——这就是你的 **DeepSeek API Key**\n7. **立刻复制保存**，关掉后就再也看不到了\n\n> 把这串 Key 先粘贴到记事本里，后面要用。\n\n---\n\n## 第三步：注册 Tavily 并获取 API Key\n\nTavily 是联网搜索引擎，让 AI 能搜索实时信息。\n\n1. 用 **Google Chrome 浏览器** 打开 **tavily.com**\n2. 点击「Sign Up」，**用 Gmail 邮箱注册**一个账号\n3. 登录后进入 Dashboard，在 API Keys 区域找到你的 Key（以 `tvly-` 开头）\n4. **复制保存**到记事本里\n\n> Tavily 每月有 1000 次免费搜索额度，个人使用足够了。\n\n---\n\n## 第四步：在桌面创建 API Key 文件\n\n把刚才拿到的两个 Key 整理到一个文件里，后面配置时会用到。\n\n1. 在桌面上**右键** → 新建 → 文本文档\n2. 把文件重命名为 `apikey.txt`\n3. 打开文件，按以下格式粘贴：\n\n```\nDeepSeek API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nTavily API Key: tvly-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\n4. 保存并关闭。后面配置 Hermes 时需要从这里复制粘贴。\n\n---\n\n## 第五步：安装 Hermes Agent（AI 引擎）\n\nHermes Agent 是驱动 AI 的底层引擎，Trade 基于它运行。\n\n### 5.1 以管理员身份打开 PowerShell\n\n1. 按键盘 **Win 键**，输入 `powershell`\n2. **右键点击**搜索结果里的「Windows PowerShell」\n3. 选择「**以管理员身份运行**」\n4. 弹出提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n\n### 5.2 开启长路径支持\n\n在 PowerShell 里粘贴下面这行命令，按回车：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n### 5.3 一键安装 Hermes\n\n接着执行下面这行命令：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n等待几分钟，看到「安装完成」提示即可。\n\n> 在 PowerShell 里粘贴的方法是**点一下鼠标右键**（不是 Ctrl+V）。\n\n---\n\n## 第六步：配置 Hermes（大模型 + 搜索）\n\n安装完成后，在同一个 PowerShell 窗口输入：\n\n```\nhermes setup\n```\n\n这时会出现交互配置界面，按以下步骤操作：\n\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」→ 按回车\n2. 选择模型时，选「**deepseek-chat**」（即 DeepSeek V4 Flash）→ 按回车\n3. 粘贴你的 **DeepSeek API Key**（从桌面的 `apikey.txt` 复制）→ 按回车\n4. 搜索服务选「**Tavily**」→ 按回车\n5. 粘贴你的 **Tavily API Key** → 按回车\n\n看到「配置成功」提示就完成了。\n\n---\n\n## 第七步：验证 Hermes 是否正常\n\n在 PowerShell 里输入：\n\n```\nhermes\n```\n\n等它启动后，在对话框里输入：\n\n```\nhello\n```\n\n按回车发送。如果 AI 正常回复了，说明大模型配置成功。\n\n> 按 `Ctrl+C` 可以退出 Hermes，回到命令行。\n\n---\n\n## 第八步：让 AI 帮你安装 Trade\n\n重新启动 Hermes（输入 `hermes`），在聊天框里**复制粘贴**下面这句话：\n\n```\n请帮我安装 trade，地址是 https://github.com/chefroger/smart-trade-ai\n```\n\nAI 会自己去 GitHub 查看项目说明，然后自动执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。\n\n装完后，**关闭当前 PowerShell，重新打开一个新的**，输入：\n\n```\ntrade\n```\n\n浏览器会自动打开 Trade 界面。如果没有自动打开，手动访问 **http://127.0.0.1:9119/trade**。\n\n---\n\n## 常见问题\n\n| 你看到的现象 | 怎么解决 |\n|------------|---------|\n| 第五步安装 Hermes 卡住不动 | 科学上网没开好。确认 VPN 是全局模式，关掉 PowerShell 重开再试 |\n| `hermes` 输入后提示「不是内部或外部命令」 | 关掉 PowerShell 重新打开一个新的 |\n| `trade` 输入后提示「不是内部或外部命令」 | 改成输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 然后 `python server.py` |\n| Hermes 对话没反应 | API Key 没配置对。重新运行 `hermes setup` 检查 |\n| 浏览器打开显示「无法访问此网站」 | 程序没在运行。打开一个新的 PowerShell，输入 `trade` 启动 |\n| 提示「Filename too long」 | 第五步的长路径设置没做。回到 5.2 执行那行命令，然后**重启电脑** |\n\n---\n\n<p style=\"text-align:center; color:#8b949e; margin-top:3rem;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n"}, "973ddb772dab3c801d00e97124578e9762622341": {"t": 1785772986.4703777, "n": 11354, "h": "a6f9c0e21c3d99b6", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">不需要懂技术，跟着步骤走，10 分钟装好</p>\n <a href=\"#windows-install\" class=\"btn\" style=\"margin:0.5rem;\">点我开始安装 →</a>\n</div>\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-2.png\" alt=\"Customer & Cron Panel\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>客户管理 + 定时任务面板</em></p>\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-1.png\" alt=\"AI Chat Interface\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>AI 对话界面 — 像聊天一样使用</em></p>\n</div>\n\n---\n\n## <a id=\"windows-install\"></a>Windows 电脑安装教程\n\n> 整个过程大约 10 分钟。你不需要懂任何电脑技术，只要会下载安装软件、会复制粘贴文字就行。\n\nWindows 有两种安装方式，**先选一种**：\n\n| 方式 | 适合你吗？ | 需要装 Python/Git 吗？ |\n|------|-----------|----------------------|\n| **A. 桌面版 TradeWin.exe**（推荐给小白） | 只想双击运行，不想敲命令 | ❌ 不需要 |\n| **B. 命令行版**（传统方式） | 想要完整功能，或电脑上已经有 Python | ✅ 需要 |\n\n- 选 **A** → 直接跳到本页底部的「[方式 A：桌面版 TradeWin.exe](#way-a-tradewin-exe)」\n- 选 **B** → 继续看下面的第一步\n\n---\n\n### 第一步：安装 Python 和 Git（只需做一次）\n\n这个工具是用 Python 语言写的，你的电脑需要先装两个小程序才能运行它：**Python**（运行工具本身）和 **Git**（从网上下载工具代码）。就像你要看 PDF 文件得先装一个 PDF 阅读器一样。\n\n#### 1.1 安装 Python\n\n1. 打开浏览器（就是上网用的那个程序），在地址栏输入 **python.org/downloads** 然后回车\n2. 页面会自动识别你是 Windows 电脑，点击页面上那个 **黄色的大按钮** 开始下载\n3. 下载完后，**双击**打开刚才下载的那个文件（一般在浏览器左下角能点开）\n4. 安装窗口打开后，**先看窗口最下面**——有一个小方框写着「**Add Python to PATH**」，**一定要打勾！** 这一步最容易忘记，忘了后面整个装不了\n5. 打勾之后，点击上面的「**Install Now**」按钮\n6. 等进度条跑完，出现「Setup was successful」就装好了，关掉安装窗口\n\n> 如果你以前已经装过 Python，这一步可以跳过。\n\n#### 1.2 安装 Git\n\n1. 打开浏览器，在地址栏输入 **git-scm.com/download/win** 然后回车\n2. 页面会自动开始下载一个安装包（如果没自动下载，点页面里的「**Click here to download**」链接）\n3. 下载完后，**双击**打开安装包\n4. 一路点「**Next**」（下一步），所有选项都用默认的就行，最后点「**Install**」\n5. 安装完成后点「**Finish**」关闭安装窗口\n\n> 如果你以前已经装过 Git，这一步可以跳过。\n>\n> **装完 Python 和 Git 后，关闭所有已经打开的 PowerShell 窗口，再重新打开一个新的**——这一步很重要，不重开的话系统可能还认不出刚装好的程序。\n\n---\n\n### 第二步：打开 PowerShell\n\n接下来的安装步骤需要在 **PowerShell** 里操作。你可能在电视剧里见过黑客在黑屏幕上敲代码——PowerShell 就是那样的一个窗口。不过别紧张，你不需要自己写代码，只要**把我给你的命令复制进去、按回车就行**。\n\n**怎么找到 PowerShell：**\n\n1. 看你的键盘，**左下角有一个 Windows 图标的键**（四个方块组成的那个，叫 Win 键），按一下它\n2. 这时候屏幕上会弹出一个搜索框，**直接打字**输入：`powershell`\n3. 搜索结果里会出现一个图标是**蓝色**的、名字叫「**Windows PowerShell**」的程序，**点击它**\n4. 屏幕上会弹出一个**蓝色背景**（也可能是黑色背景）的窗口，里面有一些白色文字和一个闪烁的光标——这就是 PowerShell 了\n\n> **两个小提示：**\n> - 在 PowerShell 里**粘贴文字的方法**和平时不一样：不是按 Ctrl+V，而是**在窗口里点一下鼠标右键**，刚才复制的内容就会粘上去\n> - 下面出现的所有 `灰底文字`，都是你需要复制到 PowerShell 里执行的命令\n\n---\n\n### 第三步（推荐）：一键安装\n\nPython 装好之后，最省事的方法是用**一键安装脚本**——把下面这一行命令复制到 PowerShell 里执行，它会自动帮你装好所有东西：\n\n```\nirm https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.ps1 | iex\n```\n\n这个脚本会自动完成：安装 AI 引擎 → 安装 Smart Trade AI → 安装 19 个专业功能 → 初始化数据库 → 设置开机自启动。\n\n等它跑完后，继续往下看**第七步**获取 API Key 就行。\n\n> **如果一键脚本跑失败了**，不要紧，跟着下面的第四步、第五步和第六步手动装就行，效果一样。\n\n---\n\n### 第四步：开启长路径支持（只做一次，以前做过的跳过）\n\n> 如果你已经通过一键脚本安装成功，可以跳过第四步、第五步和第六步，直接看第七步。\n\nWindows 系统有一个默认设置，不允许文件路径太长。但这个工具安装时会产生比较长的路径，如果不改这个设置，后面安装会报错。我们只需要改一次，改完就不用管了。\n\n**操作步骤：**\n\n1. 按键盘上的 **Win 键**，输入 `powershell`\n2. 这一次不要直接点开，而是**用鼠标右键点击**搜索结果里的「Windows PowerShell」\n3. 在弹出的菜单里点「**以管理员身份运行**」\n4. 弹出一个提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n5. 这时打开的 PowerShell 窗口标题栏会写着「**管理员**」——说明你成功以管理员身份打开了\n6. 把下面这行命令**完整复制**（从 New 一直复制到 Force），在 PowerShell 窗口里**点右键粘贴**，然后**按回车**：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n7. 没有出现红色报错就说明成功了，**关掉这个管理员窗口**\n8. **重启电脑**让设置生效\n\n> 这一步一辈子只需要做一次。重启电脑后继续下一步。\n\n---\n\n### 第五步：安装 Hermes Agent\n\n这个工具背后需要一个叫 Hermes Agent 的程序来驱动 AI 功能。你可以把它理解为\"发动机\"——我们的工具是车身，得先有发动机才能跑。\n\n1. 打开 PowerShell（这次用**普通方式**打开就行，不需要管理员）\n2. 把下面这行命令**完整复制**，在 PowerShell 里**点右键粘贴**，按回车：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n3. 等待几分钟，它会自动下载和安装需要的文件\n4. 看到提示「安装完成」或「Installation complete」就说明好了\n\n> 如果等了很久都没反应或者报错了，多半是网络问题——参考页面底部的「常见问题」。\n\n---\n\n### 第六步：安装 Smart Trade AI\n\n发动机装好了，现在装车身。\n\n把下面 4 行命令**一行一行**地复制到 PowerShell 里执行。方法是：复制第一行 → 在 PowerShell 里右键粘贴 → 按回车 → 等它跑完 → 再复制第二行……以此类推。\n\n```\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n```\n\n```\ncd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n```\n\n```\npip install -e \".\"\n```\n\n```\ninstall-trade-skills\n```\n\n> 每一行都要等它跑完再执行下一行。如果中间某一行出现红色报错，不要慌，大多数是网络不好——重新复制那一行再执行一次。\n\n---\n\n### 第七步：获取 API Key\n\n这个工具需要连接 AI 大模型才能工作。AI 不是免费的，你需要去 AI 厂商那里注册一个账号、获取一个 **API Key**。\n\nAPI Key 是一串很长的字母和数字，就像一个密码，用来证明你有权限使用这个 AI 服务。\n\n**推荐用 DeepSeek（国产，便宜好用）：**\n\n1. 打开浏览器，访问 **platform.deepseek.com**\n2. 用手机号注册一个账号\n3. 登录之后，点页面上的「**充值**」，充 10 块钱就够了（按用量扣费，10 块钱能用很久）\n4. 在页面左侧找到「**API Keys**」，点进去，再点「**创建 API Key**」\n5. 页面上会显示一串字符——这就是你的 API Key。**立刻把它复制保存下来**（比如粘贴到记事本里），因为它只显示这一次，关了就看不到了\n\n拿到 API Key 之后，回到 PowerShell 窗口，输入下面这个命令然后回车：\n\n```\nhermes setup\n```\n\n这时会出现一个交互界面，操作方法：\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」，选中后**按回车**\n2. 它会问你要 API Key——把刚才保存的那串字符**右键粘贴**进去，按回车\n3. 看到「配置成功」之类的提示就完成了\n\n> 还建议顺手注册一个 [Tavily](https://tavily.com)（免费的，不用充值），它能让工具搜索实时信息。注册后同样在 `hermes setup` 里配置，选 Tavily 那一项，粘贴 Key。\n\n---\n\n### 第八步：启动！\n\n全部装好了，现在来运行它。在 PowerShell 里输入：\n\n```\npython server.py\n```\n\n按回车。等待几秒，看到窗口里出现 **「Uvicorn running on http://127.0.0.1:9119」** 这行字，就说明启动成功了。\n\n然后打开浏览器，在地址栏输入：**http://127.0.0.1:9119/trade** ，按回车，你就能看到界面了。\n\n> **以后每次要用的时候：** 打开 PowerShell → 输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 回车 → 输入 `python server.py` 回车 → 打开浏览器访问上面的地址。**关掉 PowerShell 窗口，程序就会停止**，所以使用期间不要关那个窗口。\n\n---\n\n### 让电脑每次开机自动启动（可选）\n\n如果你不想每次都手动打开 PowerShell 输入命令，可以生成一个 exe 程序，以后双击就能运行：\n\n在 PowerShell 里依次执行这两行（一行一行来）：\n\n```\npip install pyinstaller\n```\n\n```\npowershell -File scripts\\build.ps1\n```\n\n等它跑完后，在安装目录下的 `dist` 文件夹里会出现一个 **Smart Trade AI.exe**。你可以把它**拖到桌面上**，以后双击这个图标就能启动，不需要再打开 PowerShell。\n\n---\n\n### 安装中可能遇到的问题\n\n| 你看到的现象 | 可能的原因 | 怎么解决 |\n|------------|-----------|---------|\n| 输入 python 后提示「不是内部或外部命令」 | 安装 Python 时忘记勾选「Add Python to PATH」 | 回到第一步重新安装 Python，**一定要勾选那个框**。装完后关闭 PowerShell 重新打开再试 |\n| 输入 git 后提示「不是内部或外部命令」 | 没装 Git，或装完没重开 PowerShell | 回到第一步的 1.2 小节安装 Git。装完后**一定要关闭所有 PowerShell 窗口再重新打开** |\n| 安装到一半卡住不动了 | 你的网络访问 GitHub 不稳定 | 你需要开 **VPN**（就是翻墙工具），开到**全局模式**。开好之后关掉 PowerShell 重新打开，重新执行卡住的那行命令 |\n| 出现一大堆红色文字 | 大多是网络不好，没下载完整 | 把报错的那行命令重新复制执行一次。反复报错就确认 VPN 是否开好了 |\n| 浏览器打开显示「无法访问此网站」 | 程序没有在运行 | 回到 PowerShell 看看是不是关掉了或者报错了。如果关了就重新打开 PowerShell，重新执行 `python server.py` |\n| 页面打开了但是显示不正常、按钮点不动 | 浏览器缓存了旧版本的文件 | 同时按下键盘的 **Ctrl + Shift + R** 三个键，页面会强制刷新 |\n| 提示「Filename too long」 | 第四步的长路径设置没生效 | 确认第四步已经做过，并且**重启过电脑**。如果还没重启，先重启再来 |\n\n---\n\n## <a id=\"way-a-tradewin-exe\"></a>方式 A：桌面版 TradeWin.exe（零配置）\n\n如果你不想敲命令、不想装 Python，只想双击运行，这种方式最适合你。\n\n### 下载和运行\n\n1. 打开浏览器，访问 **github.com/chefroger/smart-trade-ai/releases**\n2. 找到最新版本，下载那个名字叫 **`TradeWin.exe`** 的文件（大约 80-120 MB）\n3. 下载完后，**双击** `TradeWin.exe` 就能运行——不需要安装，直接用\n\n> 如果 Windows 弹出「已保护你的电脑」蓝色窗口，点「**更多信息**」→ 点「**仍要运行**」。这是因为程序没有数字签名，Windows 会默认拦截，但程序本身是安全的。\n\n### 首次启动的配置向导\n\n第一次双击运行后，会自动弹出一个配置向导，跟着走 4 步：\n\n1. **欢迎页** — 直接点「下一步」\n2. **选择 AI 提供商** — 用键盘上下键选 DeepSeek（推荐，便宜好用），按回车\n3. **填入 API Key** — 把你在 DeepSeek 申请的 API Key 粘贴进去\n4. **（可选）填入 Tavily Key** — 启用联网搜索（强烈建议，免费注册：[tavily.com](https://tavily.com)）\n\n点「完成」后，程序会自动帮你装好 AI 引擎、专业功能、数据库——**全程不需要你做任何事**，等几分钟就好。\n\n### 以后怎么用？\n\n- **启动**：双击 `TradeWin.exe`\n- **关闭**：点窗口右上角的 ×（可以最小化到系统托盘，后台运行）\n- **升级**：点界面里的「⚙️ 设置」→「系统」→「⬆️ 系统更新」\n\n> 桌面版和命令行版功能完全一样，数据互通，可以同时安装。\n\n---\n\n## 方式 C：让 AI 帮你装（如果你已经装好了 Hermes）\n\n如果你已经装好了 Hermes Agent（AI 引擎）并配置好了 API Key，最省心的方式是让 AI 自己装 Trade——它能根据你的电脑环境智能调整，比固定脚本更不容易出错。\n\n**前提条件：**\n- 已安装 Hermes Agent（看上面的第五步）\n- 已运行 `hermes setup` 配置好 LLM 和 **Tavily 搜索**（重要！没 Tavily AI 看不到 GitHub 仓库）\n\n**操作步骤：**\n\n1. 在 PowerShell 里启动 Hermes：\n\n```\nhermes\n```\n\n2. 等 Hermes 启动好后，在对话框里**直接粘贴**这句话（中文即可）：\n\n> 请分析 https://github.com/chefroger/smart-trade-ai 这个 GitHub 仓库，并帮我安装\n\n3. AI 会自己去 GitHub 看这个项目的说明，然后帮你执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。\n\n4. 装完后，**关闭原来的 PowerShell，重新打开一个新的**（这一步很重要，让系统认得新装的 `trade` 命令），然后输入：\n\n```\ntrade\n```\n\n按回车，等几秒钟浏览器会自动打开界面。\n\n> 如果输入 `trade` 后提示「不是内部或外部命令」，说明 PATH 没生效。改用这种方式启动：\n>\n> ```\n> cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n> python server.py\n> ```\n>\n> 然后浏览器手动打开 **http://127.0.0.1:9119/trade**\n\n> 这种方式的好处：AI 会根据你电脑上已经装了什么、Python 是什么版本、网络情况如何，动态调整安装命令。遇到冲突或报错它也能自己想办法，比固定脚本成功率高。\n\n---\n\n## 苹果电脑（Mac）安装教程\n\n### 打开终端\n\nMac 上的操作窗口叫「**终端**」，和 Windows 的 PowerShell 类似。\n\n**怎么打开：** 在桌面右上角点**放大镜图标**（或者同时按 Command + 空格键），输入 `终端` 两个字，按回车，就打开了。\n\n### 一键安装\n\n在终端里复制粘贴下面这行命令，按回车：\n\n```\ncurl -fsSL https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.sh | bash\n```\n\n等它自动安装完，然后配置 AI：\n\n```\nhermes setup\n```\n\n按提示选择 DeepSeek，粘贴 API Key（和上面 Windows 第七步的操作一样）。\n\n最后启动：\n\n```\npython server.py\n```\n\n浏览器打开 **http://127.0.0.1:9119/trade** 。\n\n### 手动安装（一键脚本失败时用）\n\n在终端里依次执行以下每一行：\n\n```\ngit clone --branch main https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent\n```\n\n```\ncd ~/.hermes/hermes-agent && pip install -e \".\"\n```\n\n```\nhermes setup\n```\n\n```\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git ~/.trade/foreign-trade-assistant\n```\n\n```\ncd ~/.trade/foreign-trade-assistant && pip install -e \".\"\n```\n\n```\ninstall-trade-skills\n```\n\n```\npython server.py\n```\n\n> Mac 如果遇到下载超时，同样需要开 VPN 全局模式。\n\n---\n\n## 17 项专业能力\n\n| 场景 | 能力 |\n|------|------|\n| 平台诊断 | 分析阿里国际站 / 中国制造网产品页面，给出优化建议 |\n| 社媒营销 | 生成 Facebook / Instagram / TikTok / YouTube 内容日历 |\n| LinkedIn 运营 | 个人资料优化 + 内容策略 + 私信模板 |\n| 海关数据 | 分析进出口数据，帮你找到高价值采购商 |\n| 客户开发 | 根据目标市场和产品，自动生成开发信和跟进邮件，含价格/付款/交期谈判 |\n| 客户管理 | A/B/C 重要度分级、客户详情、关联合同文件 |\n| 文档分析 | 上传 PDF / Word / Excel / PPT，AI 自动读取分析 |\n| 商务文档生成 | 一键生成报价单、形式发票、合同 |\n| 报价谈判 | 根据产品库和客户情况，给出谈判策略建议 |\n| 客户背调 | 6 层验证：邮箱检测 → WHOIS → 制裁名单 → 邮箱真实性 → 技术栈 → LinkedIn |\n| 每日简报 | 实时汇率 + 大宗商品行情 + 市场新闻 + 客户跟进提醒 |\n| 定时任务 | 工作日自动执行：早报、开发信、社媒发布、每日总结 |\n| 对话记录 | 按公司分开存储聊天记录，随时搜索回顾 |\n| 履约运营 | 催款/索赔/展会/验厂/物流/售后/满意度/年度总结等 11 个场景 |\n| 贸易合规 | 文化禁忌检查/缩写规范/ICC 术语/翻译二审/投标/电商上架 |\n| 能力生成器 | 用大白话描述你的需求，自动创建新功能 |\n\n---\n\n## 你的数据安全吗？\n\n- **所有业务数据都存在你自己的电脑里**，不会上传到任何服务器\n- 如果你用的是云端 AI（比如 DeepSeek），对话内容会发给 AI 厂商处理，**但不会包含客户姓名等身份信息**\n- 如果你装 [Ollama](https://ollama.com) 用本地模型，连对话内容都不出你的电脑\n- 多公司之间数据互相隔离\n- 程序只允许你自己电脑上的浏览器访问，别人看不到\n\n---\n\n## 联系作者\n\n<div style=\"text-align:center;\">\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"200\" style=\"border-radius:8px;\">\n <p>扫码添加微信，备注「Trade」</p>\n <p>商务合作或技术支持：<a href=\"mailto:lauroge@gmail.com\">lauroge@gmail.com</a></p>\n</div>\n\n---\n\n<p style=\"text-align:center; color:#8b949e;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手 · 不需要懂技术<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n"}, "4f12ce5142fff33fddf32ec6db553aa19fc5b40d": {"t": 1785772987.9164374, "n": 11354, "h": "c7440e53225a23b2", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">不需要懂技术，跟着步骤走，10 分钟装好</p>\n <a href=\"#windows-install\" class=\"btn\" style=\"margin:0.5rem;\">点我开始安装 →</a>\n</div>\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-2.png\" alt=\"Customer & Cron Panel\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>客户管理 + 定时任务面板</em></p>\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-1.png\" alt=\"AI Chat Interface\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>AI 对话界面 — 像聊天一样使用</em></p>\n</div>\n\n---\n\n## <a id=\"windows-install\"></a>Windows 电脑安装教程\n\n> 整个过程大约 10 分钟。你不需要懂任何电脑技术，只要会下载安装软件、会复制粘贴文字就行。\n\nWindows 有两种安装方式，**先选一种**：\n\n| 方式 | 适合你吗？ | 需要装 Python/Git 吗？ |\n|------|-----------|----------------------|\n| **A. 桌面版 TradeWin.exe**（推荐给小白） | 只想双击运行，不想敲命令 | ❌ 不需要 |\n| **B. 命令行版**（传统方式） | 想要完整功能，或电脑上已经有 Python | ✅ 需要 |\n\n- 选 **A** → 直接跳到本页底部的「[方式 A：桌面版 TradeWin.exe](#way-a-tradewin-exe)」\n- 选 **B** → 继续看下面的第一步\n\n---\n\n### 第一步：安装 Python 和 Git（只需做一次）\n\n这个工具是用 Python 语言写的，你的电脑需要先装两个小程序才能运行它：**Python**（运行工具本身）和 **Git**（从网上下载工具代码）。就像你要看 PDF 文件得先装一个 PDF 阅读器一样。\n\n#### 1.1 安装 Python\n\n1. 打开浏览器（就是上网用的那个程序），在地址栏输入 **python.org/downloads** 然后回车\n2. 页面会自动识别你是 Windows 电脑，点击页面上那个 **黄色的大按钮** 开始下载\n3. 下载完后，**双击**打开刚才下载的那个文件（一般在浏览器左下角能点开）\n4. 安装窗口打开后，**先看窗口最下面**——有一个小方框写着「**Add Python to PATH**」，**一定要打勾！** 这一步最容易忘记，忘了后面整个装不了\n5. 打勾之后，点击上面的「**Install Now**」按钮\n6. 等进度条跑完，出现「Setup was successful」就装好了，关掉安装窗口\n\n> 如果你以前已经装过 Python，这一步可以跳过。\n\n#### 1.2 安装 Git\n\n1. 打开浏览器，在地址栏输入 **git-scm.com/download/win** 然后回车\n2. 页面会自动开始下载一个安装包（如果没自动下载，点页面里的「**Click here to download**」链接）\n3. 下载完后，**双击**打开安装包\n4. 一路点「**Next**」（下一步），所有选项都用默认的就行，最后点「**Install**」\n5. 安装完成后点「**Finish**」关闭安装窗口\n\n> 如果你以前已经装过 Git，这一步可以跳过。\n>\n> **装完 Python 和 Git 后，关闭所有已经打开的 PowerShell 窗口，再重新打开一个新的**——这一步很重要，不重开的话系统可能还认不出刚装好的程序。\n\n---\n\n### 第二步：打开 PowerShell\n\n接下来的安装步骤需要在 **PowerShell** 里操作。你可能在电视剧里见过黑客在黑屏幕上敲代码——PowerShell 就是那样的一个窗口。不过别紧张，你不需要自己写代码，只要**把我给你的命令复制进去、按回车就行**。\n\n**怎么找到 PowerShell：**\n\n1. 看你的键盘，**左下角有一个 Windows 图标的键**（四个方块组成的那个，叫 Win 键），按一下它\n2. 这时候屏幕上会弹出一个搜索框，**直接打字**输入：`powershell`\n3. 搜索结果里会出现一个图标是**蓝色**的、名字叫「**Windows PowerShell**」的程序，**点击它**\n4. 屏幕上会弹出一个**蓝色背景**（也可能是黑色背景）的窗口，里面有一些白色文字和一个闪烁的光标——这就是 PowerShell 了\n\n> **两个小提示：**\n> - 在 PowerShell 里**粘贴文字的方法**和平时不一样：不是按 Ctrl+V，而是**在窗口里点一下鼠标右键**，刚才复制的内容就会粘上去\n> - 下面出现的所有 `灰底文字`，都是你需要复制到 PowerShell 里执行的命令\n\n---\n\n### 第三步（推荐）：一键安装\n\nPython 装好之后，最省事的方法是用**一键安装脚本**——把下面这一行命令复制到 PowerShell 里执行，它会自动帮你装好所有东西：\n\n```\nirm https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.ps1 | iex\n```\n\n这个脚本会自动完成：安装 AI 引擎 → 安装 Smart Trade AI → 安装 17 个专业功能 → 初始化数据库 → 设置开机自启动。\n\n等它跑完后，继续往下看**第七步**获取 API Key 就行。\n\n> **如果一键脚本跑失败了**，不要紧，跟着下面的第四步、第五步和第六步手动装就行，效果一样。\n\n---\n\n### 第四步：开启长路径支持（只做一次，以前做过的跳过）\n\n> 如果你已经通过一键脚本安装成功，可以跳过第四步、第五步和第六步，直接看第七步。\n\nWindows 系统有一个默认设置，不允许文件路径太长。但这个工具安装时会产生比较长的路径，如果不改这个设置，后面安装会报错。我们只需要改一次，改完就不用管了。\n\n**操作步骤：**\n\n1. 按键盘上的 **Win 键**，输入 `powershell`\n2. 这一次不要直接点开，而是**用鼠标右键点击**搜索结果里的「Windows PowerShell」\n3. 在弹出的菜单里点「**以管理员身份运行**」\n4. 弹出一个提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n5. 这时打开的 PowerShell 窗口标题栏会写着「**管理员**」——说明你成功以管理员身份打开了\n6. 把下面这行命令**完整复制**（从 New 一直复制到 Force），在 PowerShell 窗口里**点右键粘贴**，然后**按回车**：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n7. 没有出现红色报错就说明成功了，**关掉这个管理员窗口**\n8. **重启电脑**让设置生效\n\n> 这一步一辈子只需要做一次。重启电脑后继续下一步。\n\n---\n\n### 第五步：安装 Hermes Agent\n\n这个工具背后需要一个叫 Hermes Agent 的程序来驱动 AI 功能。你可以把它理解为\"发动机\"——我们的工具是车身，得先有发动机才能跑。\n\n1. 打开 PowerShell（这次用**普通方式**打开就行，不需要管理员）\n2. 把下面这行命令**完整复制**，在 PowerShell 里**点右键粘贴**，按回车：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n3. 等待几分钟，它会自动下载和安装需要的文件\n4. 看到提示「安装完成」或「Installation complete」就说明好了\n\n> 如果等了很久都没反应或者报错了，多半是网络问题——参考页面底部的「常见问题」。\n\n---\n\n### 第六步：安装 Smart Trade AI\n\n发动机装好了，现在装车身。\n\n把下面 4 行命令**一行一行**地复制到 PowerShell 里执行。方法是：复制第一行 → 在 PowerShell 里右键粘贴 → 按回车 → 等它跑完 → 再复制第二行……以此类推。\n\n```\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n```\n\n```\ncd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n```\n\n```\npip install -e \".\"\n```\n\n```\ninstall-trade-skills\n```\n\n> 每一行都要等它跑完再执行下一行。如果中间某一行出现红色报错，不要慌，大多数是网络不好——重新复制那一行再执行一次。\n\n---\n\n### 第七步：获取 API Key\n\n这个工具需要连接 AI 大模型才能工作。AI 不是免费的，你需要去 AI 厂商那里注册一个账号、获取一个 **API Key**。\n\nAPI Key 是一串很长的字母和数字，就像一个密码，用来证明你有权限使用这个 AI 服务。\n\n**推荐用 DeepSeek（国产，便宜好用）：**\n\n1. 打开浏览器，访问 **platform.deepseek.com**\n2. 用手机号注册一个账号\n3. 登录之后，点页面上的「**充值**」，充 10 块钱就够了（按用量扣费，10 块钱能用很久）\n4. 在页面左侧找到「**API Keys**」，点进去，再点「**创建 API Key**」\n5. 页面上会显示一串字符——这就是你的 API Key。**立刻把它复制保存下来**（比如粘贴到记事本里），因为它只显示这一次，关了就看不到了\n\n拿到 API Key 之后，回到 PowerShell 窗口，输入下面这个命令然后回车：\n\n```\nhermes setup\n```\n\n这时会出现一个交互界面，操作方法：\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」，选中后**按回车**\n2. 它会问你要 API Key——把刚才保存的那串字符**右键粘贴**进去，按回车\n3. 看到「配置成功」之类的提示就完成了\n\n> 还建议顺手注册一个 [Tavily](https://tavily.com)（免费的，不用充值），它能让工具搜索实时信息。注册后同样在 `hermes setup` 里配置，选 Tavily 那一项，粘贴 Key。\n\n---\n\n### 第八步：启动！\n\n全部装好了，现在来运行它。在 PowerShell 里输入：\n\n```\npython server.py\n```\n\n按回车。等待几秒，看到窗口里出现 **「Uvicorn running on http://127.0.0.1:9119」** 这行字，就说明启动成功了。\n\n然后打开浏览器，在地址栏输入：**http://127.0.0.1:9119/trade** ，按回车，你就能看到界面了。\n\n> **以后每次要用的时候：** 打开 PowerShell → 输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 回车 → 输入 `python server.py` 回车 → 打开浏览器访问上面的地址。**关掉 PowerShell 窗口，程序就会停止**，所以使用期间不要关那个窗口。\n\n---\n\n### 让电脑每次开机自动启动（可选）\n\n如果你不想每次都手动打开 PowerShell 输入命令，可以生成一个 exe 程序，以后双击就能运行：\n\n在 PowerShell 里依次执行这两行（一行一行来）：\n\n```\npip install pyinstaller\n```\n\n```\npowershell -File scripts\\build.ps1\n```\n\n等它跑完后，在安装目录下的 `dist` 文件夹里会出现一个 **Smart Trade AI.exe**。你可以把它**拖到桌面上**，以后双击这个图标就能启动，不需要再打开 PowerShell。\n\n---\n\n### 安装中可能遇到的问题\n\n| 你看到的现象 | 可能的原因 | 怎么解决 |\n|------------|-----------|---------|\n| 输入 python 后提示「不是内部或外部命令」 | 安装 Python 时忘记勾选「Add Python to PATH」 | 回到第一步重新安装 Python，**一定要勾选那个框**。装完后关闭 PowerShell 重新打开再试 |\n| 输入 git 后提示「不是内部或外部命令」 | 没装 Git，或装完没重开 PowerShell | 回到第一步的 1.2 小节安装 Git。装完后**一定要关闭所有 PowerShell 窗口再重新打开** |\n| 安装到一半卡住不动了 | 你的网络访问 GitHub 不稳定 | 你需要开 **VPN**（就是翻墙工具），开到**全局模式**。开好之后关掉 PowerShell 重新打开，重新执行卡住的那行命令 |\n| 出现一大堆红色文字 | 大多是网络不好，没下载完整 | 把报错的那行命令重新复制执行一次。反复报错就确认 VPN 是否开好了 |\n| 浏览器打开显示「无法访问此网站」 | 程序没有在运行 | 回到 PowerShell 看看是不是关掉了或者报错了。如果关了就重新打开 PowerShell，重新执行 `python server.py` |\n| 页面打开了但是显示不正常、按钮点不动 | 浏览器缓存了旧版本的文件 | 同时按下键盘的 **Ctrl + Shift + R** 三个键，页面会强制刷新 |\n| 提示「Filename too long」 | 第四步的长路径设置没生效 | 确认第四步已经做过，并且**重启过电脑**。如果还没重启，先重启再来 |\n\n---\n\n## <a id=\"way-a-tradewin-exe\"></a>方式 A：桌面版 TradeWin.exe（零配置）\n\n如果你不想敲命令、不想装 Python，只想双击运行，这种方式最适合你。\n\n### 下载和运行\n\n1. 打开浏览器，访问 **github.com/chefroger/smart-trade-ai/releases**\n2. 找到最新版本，下载那个名字叫 **`TradeWin.exe`** 的文件（大约 80-120 MB）\n3. 下载完后，**双击** `TradeWin.exe` 就能运行——不需要安装，直接用\n\n> 如果 Windows 弹出「已保护你的电脑」蓝色窗口，点「**更多信息**」→ 点「**仍要运行**」。这是因为程序没有数字签名，Windows 会默认拦截，但程序本身是安全的。\n\n### 首次启动的配置向导\n\n第一次双击运行后，会自动弹出一个配置向导，跟着走 4 步：\n\n1. **欢迎页** — 直接点「下一步」\n2. **选择 AI 提供商** — 用键盘上下键选 DeepSeek（推荐，便宜好用），按回车\n3. **填入 API Key** — 把你在 DeepSeek 申请的 API Key 粘贴进去\n4. **（可选）填入 Tavily Key** — 启用联网搜索（强烈建议，免费注册：[tavily.com](https://tavily.com)）\n\n点「完成」后，程序会自动帮你装好 AI 引擎、专业功能、数据库——**全程不需要你做任何事**，等几分钟就好。\n\n### 以后怎么用？\n\n- **启动**：双击 `TradeWin.exe`\n- **关闭**：点窗口右上角的 ×（可以最小化到系统托盘，后台运行）\n- **升级**：点界面里的「⚙️ 设置」→「系统」→「⬆️ 系统更新」\n\n> 桌面版和命令行版功能完全一样，数据互通，可以同时安装。\n\n---\n\n## 方式 C：让 AI 帮你装（如果你已经装好了 Hermes）\n\n如果你已经装好了 Hermes Agent（AI 引擎）并配置好了 API Key，最省心的方式是让 AI 自己装 Trade——它能根据你的电脑环境智能调整，比固定脚本更不容易出错。\n\n**前提条件：**\n- 已安装 Hermes Agent（看上面的第五步）\n- 已运行 `hermes setup` 配置好 LLM 和 **Tavily 搜索**（重要！没 Tavily AI 看不到 GitHub 仓库）\n\n**操作步骤：**\n\n1. 在 PowerShell 里启动 Hermes：\n\n```\nhermes\n```\n\n2. 等 Hermes 启动好后，在对话框里**直接粘贴**这句话（中文即可）：\n\n> 请分析 https://github.com/chefroger/smart-trade-ai 这个 GitHub 仓库，并帮我安装\n\n3. AI 会自己去 GitHub 看这个项目的说明，然后帮你执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。\n\n4. 装完后，**关闭原来的 PowerShell，重新打开一个新的**（这一步很重要，让系统认得新装的 `trade` 命令），然后输入：\n\n```\ntrade\n```\n\n按回车，等几秒钟浏览器会自动打开界面。\n\n> 如果输入 `trade` 后提示「不是内部或外部命令」，说明 PATH 没生效。改用这种方式启动：\n>\n> ```\n> cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n> python server.py\n> ```\n>\n> 然后浏览器手动打开 **http://127.0.0.1:9119/trade**\n\n> 这种方式的好处：AI 会根据你电脑上已经装了什么、Python 是什么版本、网络情况如何，动态调整安装命令。遇到冲突或报错它也能自己想办法，比固定脚本成功率高。\n\n---\n\n## 苹果电脑（Mac）安装教程\n\n### 打开终端\n\nMac 上的操作窗口叫「**终端**」，和 Windows 的 PowerShell 类似。\n\n**怎么打开：** 在桌面右上角点**放大镜图标**（或者同时按 Command + 空格键），输入 `终端` 两个字，按回车，就打开了。\n\n### 一键安装\n\n在终端里复制粘贴下面这行命令，按回车：\n\n```\ncurl -fsSL https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.sh | bash\n```\n\n等它自动安装完，然后配置 AI：\n\n```\nhermes setup\n```\n\n按提示选择 DeepSeek，粘贴 API Key（和上面 Windows 第七步的操作一样）。\n\n最后启动：\n\n```\npython server.py\n```\n\n浏览器打开 **http://127.0.0.1:9119/trade** 。\n\n### 手动安装（一键脚本失败时用）\n\n在终端里依次执行以下每一行：\n\n```\ngit clone --branch main https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent\n```\n\n```\ncd ~/.hermes/hermes-agent && pip install -e \".\"\n```\n\n```\nhermes setup\n```\n\n```\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git ~/.trade/foreign-trade-assistant\n```\n\n```\ncd ~/.trade/foreign-trade-assistant && pip install -e \".\"\n```\n\n```\ninstall-trade-skills\n```\n\n```\npython server.py\n```\n\n> Mac 如果遇到下载超时，同样需要开 VPN 全局模式。\n\n---\n\n## 17 项专业能力\n\n| 场景 | 能力 |\n|------|------|\n| 平台诊断 | 分析阿里国际站 / 中国制造网产品页面，给出优化建议 |\n| 社媒营销 | 生成 Facebook / Instagram / TikTok / YouTube 内容日历 |\n| LinkedIn 运营 | 个人资料优化 + 内容策略 + 私信模板 |\n| 海关数据 | 分析进出口数据，帮你找到高价值采购商 |\n| 客户开发 | 根据目标市场和产品，自动生成开发信和跟进邮件，含价格/付款/交期谈判 |\n| 客户管理 | A/B/C 重要度分级、客户详情、关联合同文件 |\n| 文档分析 | 上传 PDF / Word / Excel / PPT，AI 自动读取分析 |\n| 商务文档生成 | 一键生成报价单、形式发票、合同 |\n| 报价谈判 | 根据产品库和客户情况，给出谈判策略建议 |\n| 客户背调 | 6 层验证：邮箱检测 → WHOIS → 制裁名单 → 邮箱真实性 → 技术栈 → LinkedIn |\n| 每日简报 | 实时汇率 + 大宗商品行情 + 市场新闻 + 客户跟进提醒 |\n| 定时任务 | 工作日自动执行：早报、开发信、社媒发布、每日总结 |\n| 对话记录 | 按公司分开存储聊天记录，随时搜索回顾 |\n| 履约运营 | 催款/索赔/展会/验厂/物流/售后/满意度/年度总结等 11 个场景 |\n| 贸易合规 | 文化禁忌检查/缩写规范/ICC 术语/翻译二审/投标/电商上架 |\n| 能力生成器 | 用大白话描述你的需求，自动创建新功能 |\n\n---\n\n## 你的数据安全吗？\n\n- **所有业务数据都存在你自己的电脑里**，不会上传到任何服务器\n- 如果你用的是云端 AI（比如 DeepSeek），对话内容会发给 AI 厂商处理，**但不会包含客户姓名等身份信息**\n- 如果你装 [Ollama](https://ollama.com) 用本地模型，连对话内容都不出你的电脑\n- 多公司之间数据互相隔离\n- 程序只允许你自己电脑上的浏览器访问，别人看不到\n\n---\n\n## 联系作者\n\n<div style=\"text-align:center;\">\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"200\" style=\"border-radius:8px;\">\n <p>扫码添加微信，备注「Trade」</p>\n <p>商务合作或技术支持：<a href=\"mailto:lauroge@gmail.com\">lauroge@gmail.com</a></p>\n</div>\n\n---\n\n<p style=\"text-align:center; color:#8b949e;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手 · 不需要懂技术<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n"}, "7f6158620ba8dd646e7cfbeec917ba7a526956cb": {"t": 1785772989.3083751, "n": 11159, "h": "6045ae73bf74a25f", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">不需要懂技术，跟着步骤走，10 分钟装好</p>\n <a href=\"#windows-install\" class=\"btn\" style=\"margin:0.5rem;\">点我开始安装 →</a>\n</div>\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-2.png\" alt=\"Customer & Cron Panel\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>客户管理 + 定时任务面板</em></p>\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-1.png\" alt=\"AI Chat Interface\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>AI 对话界面 — 像聊天一样使用</em></p>\n</div>\n\n---\n\n## <a id=\"windows-install\"></a>Windows 电脑安装教程\n\n> 整个过程大约 10 分钟。你不需要懂任何电脑技术，只要会下载安装软件、会复制粘贴文字就行。\n\nWindows 有两种安装方式，**先选一种**：\n\n| 方式 | 适合你吗？ | 需要装 Python/Git 吗？ |\n|------|-----------|----------------------|\n| **A. 桌面版 TradeWin.exe**（推荐给小白） | 只想双击运行，不想敲命令 | ❌ 不需要 |\n| **B. 命令行版**（传统方式） | 想要完整功能，或电脑上已经有 Python | ✅ 需要 |\n\n- 选 **A** → 直接跳到本页底部的「[方式 A：桌面版 TradeWin.exe](#way-a-tradewin-exe)」\n- 选 **B** → 继续看下面的第一步\n\n---\n\n### 第一步：安装 Python 和 Git（只需做一次）\n\n这个工具是用 Python 语言写的，你的电脑需要先装两个小程序才能运行它：**Python**（运行工具本身）和 **Git**（从网上下载工具代码）。就像你要看 PDF 文件得先装一个 PDF 阅读器一样。\n\n#### 1.1 安装 Python\n\n1. 打开浏览器（就是上网用的那个程序），在地址栏输入 **python.org/downloads** 然后回车\n2. 页面会自动识别你是 Windows 电脑，点击页面上那个 **黄色的大按钮** 开始下载\n3. 下载完后，**双击**打开刚才下载的那个文件（一般在浏览器左下角能点开）\n4. 安装窗口打开后，**先看窗口最下面**——有一个小方框写着「**Add Python to PATH**」，**一定要打勾！** 这一步最容易忘记，忘了后面整个装不了\n5. 打勾之后，点击上面的「**Install Now**」按钮\n6. 等进度条跑完，出现「Setup was successful」就装好了，关掉安装窗口\n\n> 如果你以前已经装过 Python，这一步可以跳过。\n\n#### 1.2 安装 Git\n\n1. 打开浏览器，在地址栏输入 **git-scm.com/download/win** 然后回车\n2. 页面会自动开始下载一个安装包（如果没自动下载，点页面里的「**Click here to download**」链接）\n3. 下载完后，**双击**打开安装包\n4. 一路点「**Next**」（下一步），所有选项都用默认的就行，最后点「**Install**」\n5. 安装完成后点「**Finish**」关闭安装窗口\n\n> 如果你以前已经装过 Git，这一步可以跳过。\n>\n> **装完 Python 和 Git 后，关闭所有已经打开的 PowerShell 窗口，再重新打开一个新的**——这一步很重要，不重开的话系统可能还认不出刚装好的程序。\n\n---\n\n### 第二步：打开 PowerShell\n\n接下来的安装步骤需要在 **PowerShell** 里操作。你可能在电视剧里见过黑客在黑屏幕上敲代码——PowerShell 就是那样的一个窗口。不过别紧张，你不需要自己写代码，只要**把我给你的命令复制进去、按回车就行**。\n\n**怎么找到 PowerShell：**\n\n1. 看你的键盘，**左下角有一个 Windows 图标的键**（四个方块组成的那个，叫 Win 键），按一下它\n2. 这时候屏幕上会弹出一个搜索框，**直接打字**输入：`powershell`\n3. 搜索结果里会出现一个图标是**蓝色**的、名字叫「**Windows PowerShell**」的程序，**点击它**\n4. 屏幕上会弹出一个**蓝色背景**（也可能是黑色背景）的窗口，里面有一些白色文字和一个闪烁的光标——这就是 PowerShell 了\n\n> **两个小提示：**\n> - 在 PowerShell 里**粘贴文字的方法**和平时不一样：不是按 Ctrl+V，而是**在窗口里点一下鼠标右键**，刚才复制的内容就会粘上去\n> - 下面出现的所有 `灰底文字`，都是你需要复制到 PowerShell 里执行的命令\n\n---\n\n### 第三步（推荐）：一键安装\n\nPython 装好之后，最省事的方法是用**一键安装脚本**——把下面这一行命令复制到 PowerShell 里执行，它会自动帮你装好所有东西：\n\n```\nirm https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.ps1 | iex\n```\n\n这个脚本会自动完成：安装 AI 引擎 → 安装 Smart Trade AI → 安装 17 个专业功能 → 初始化数据库 → 设置开机自启动。\n\n等它跑完后，继续往下看**第七步**获取 API Key 就行。\n\n> **如果一键脚本跑失败了**，不要紧，跟着下面的第四步、第五步和第六步手动装就行，效果一样。\n\n---\n\n### 第四步：开启长路径支持（只做一次，以前做过的跳过）\n\n> 如果你已经通过一键脚本安装成功，可以跳过第四步、第五步和第六步，直接看第七步。\n\nWindows 系统有一个默认设置，不允许文件路径太长。但这个工具安装时会产生比较长的路径，如果不改这个设置，后面安装会报错。我们只需要改一次，改完就不用管了。\n\n**操作步骤：**\n\n1. 按键盘上的 **Win 键**，输入 `powershell`\n2. 这一次不要直接点开，而是**用鼠标右键点击**搜索结果里的「Windows PowerShell」\n3. 在弹出的菜单里点「**以管理员身份运行**」\n4. 弹出一个提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n5. 这时打开的 PowerShell 窗口标题栏会写着「**管理员**」——说明你成功以管理员身份打开了\n6. 把下面这行命令**完整复制**（从 New 一直复制到 Force），在 PowerShell 窗口里**点右键粘贴**，然后**按回车**：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n7. 没有出现红色报错就说明成功了，**关掉这个管理员窗口**\n8. **重启电脑**让设置生效\n\n> 这一步一辈子只需要做一次。重启电脑后继续下一步。\n\n---\n\n### 第五步：安装 Hermes Agent\n\n这个工具背后需要一个叫 Hermes Agent 的程序来驱动 AI 功能。你可以把它理解为\"发动机\"——我们的工具是车身，得先有发动机才能跑。\n\n1. 打开 PowerShell（这次用**普通方式**打开就行，不需要管理员）\n2. 把下面这行命令**完整复制**，在 PowerShell 里**点右键粘贴**，按回车：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n3. 等待几分钟，它会自动下载和安装需要的文件\n4. 看到提示「安装完成」或「Installation complete」就说明好了\n\n> 如果等了很久都没反应或者报错了，多半是网络问题——参考页面底部的「常见问题」。\n\n---\n\n### 第六步：安装 Smart Trade AI\n\n发动机装好了，现在装车身。\n\n把下面 4 行命令**一行一行**地复制到 PowerShell 里执行。方法是：复制第一行 → 在 PowerShell 里右键粘贴 → 按回车 → 等它跑完 → 再复制第二行……以此类推。\n\n```\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n```\n\n```\ncd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n```\n\n```\npip install -e \".\"\n```\n\n```\ninstall-trade-skills\n```\n\n> 每一行都要等它跑完再执行下一行。如果中间某一行出现红色报错，不要慌，大多数是网络不好——重新复制那一行再执行一次。\n\n---\n\n### 第七步：获取 API Key\n\n这个工具需要连接 AI 大模型才能工作。AI 不是免费的，你需要去 AI 厂商那里注册一个账号、获取一个 **API Key**。\n\nAPI Key 是一串很长的字母和数字，就像一个密码，用来证明你有权限使用这个 AI 服务。\n\n**推荐用 DeepSeek（国产，便宜好用）：**\n\n1. 打开浏览器，访问 **platform.deepseek.com**\n2. 用手机号注册一个账号\n3. 登录之后，点页面上的「**充值**」，充 10 块钱就够了（按用量扣费，10 块钱能用很久）\n4. 在页面左侧找到「**API Keys**」，点进去，再点「**创建 API Key**」\n5. 页面上会显示一串字符——这就是你的 API Key。**立刻把它复制保存下来**（比如粘贴到记事本里），因为它只显示这一次，关了就看不到了\n\n拿到 API Key 之后，回到 PowerShell 窗口，输入下面这个命令然后回车：\n\n```\nhermes setup\n```\n\n这时会出现一个交互界面，操作方法：\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」，选中后**按回车**\n2. 它会问你要 API Key——把刚才保存的那串字符**右键粘贴**进去，按回车\n3. 看到「配置成功」之类的提示就完成了\n\n> 还建议顺手注册一个 [Tavily](https://tavily.com)（免费的，不用充值），它能让工具搜索实时信息。注册后同样在 `hermes setup` 里配置，选 Tavily 那一项，粘贴 Key。\n\n---\n\n### 第八步：启动！\n\n全部装好了，现在来运行它。在 PowerShell 里输入：\n\n```\npython server.py\n```\n\n按回车。等待几秒，看到窗口里出现 **「Uvicorn running on http://127.0.0.1:9119」** 这行字，就说明启动成功了。\n\n然后打开浏览器，在地址栏输入：**http://127.0.0.1:9119/trade** ，按回车，你就能看到界面了。\n\n> **以后每次要用的时候：** 打开 PowerShell → 输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 回车 → 输入 `python server.py` 回车 → 打开浏览器访问上面的地址。**关掉 PowerShell 窗口，程序就会停止**，所以使用期间不要关那个窗口。\n\n---\n\n### 让电脑每次开机自动启动（可选）\n\n如果你不想每次都手动打开 PowerShell 输入命令，可以生成一个 exe 程序，以后双击就能运行：\n\n在 PowerShell 里依次执行这两行（一行一行来）：\n\n```\npip install pyinstaller\n```\n\n```\npowershell -File scripts\\build.ps1\n```\n\n等它跑完后，在安装目录下的 `dist` 文件夹里会出现一个 **Smart Trade AI.exe**。你可以把它**拖到桌面上**，以后双击这个图标就能启动，不需要再打开 PowerShell。\n\n---\n\n### 安装中可能遇到的问题\n\n| 你看到的现象 | 可能的原因 | 怎么解决 |\n|------------|-----------|---------|\n| 输入 python 后提示「不是内部或外部命令」 | 安装 Python 时忘记勾选「Add Python to PATH」 | 回到第一步重新安装 Python，**一定要勾选那个框**。装完后关闭 PowerShell 重新打开再试 |\n| 输入 git 后提示「不是内部或外部命令」 | 没装 Git，或装完没重开 PowerShell | 回到第一步的 1.2 小节安装 Git。装完后**一定要关闭所有 PowerShell 窗口再重新打开** |\n| 安装到一半卡住不动了 | 你的网络访问 GitHub 不稳定 | 你需要开 **VPN**（就是翻墙工具），开到**全局模式**。开好之后关掉 PowerShell 重新打开，重新执行卡住的那行命令 |\n| 出现一大堆红色文字 | 大多是网络不好，没下载完整 | 把报错的那行命令重新复制执行一次。反复报错就确认 VPN 是否开好了 |\n| 浏览器打开显示「无法访问此网站」 | 程序没有在运行 | 回到 PowerShell 看看是不是关掉了或者报错了。如果关了就重新打开 PowerShell，重新执行 `python server.py` |\n| 页面打开了但是显示不正常、按钮点不动 | 浏览器缓存了旧版本的文件 | 同时按下键盘的 **Ctrl + Shift + R** 三个键，页面会强制刷新 |\n| 提示「Filename too long」 | 第四步的长路径设置没生效 | 确认第四步已经做过，并且**重启过电脑**。如果还没重启，先重启再来 |\n\n---\n\n## <a id=\"way-a-tradewin-exe\"></a>方式 A：桌面版 TradeWin.exe（零配置）\n\n如果你不想敲命令、不想装 Python，只想双击运行，这种方式最适合你。\n\n### 下载和运行\n\n1. 打开浏览器，访问 **github.com/chefroger/smart-trade-ai/releases**\n2. 找到最新版本，下载那个名字叫 **`TradeWin.exe`** 的文件（大约 80-120 MB）\n3. 下载完后，**双击** `TradeWin.exe` 就能运行——不需要安装，直接用\n\n> 如果 Windows 弹出「已保护你的电脑」蓝色窗口，点「**更多信息**」→ 点「**仍要运行**」。这是因为程序没有数字签名，Windows 会默认拦截，但程序本身是安全的。\n\n### 首次启动的配置向导\n\n第一次双击运行后，会自动弹出一个配置向导，跟着走 4 步：\n\n1. **欢迎页** — 直接点「下一步」\n2. **选择 AI 提供商** — 用键盘上下键选 DeepSeek（推荐，便宜好用），按回车\n3. **填入 API Key** — 把你在 DeepSeek 申请的 API Key 粘贴进去\n4. **（可选）填入 Tavily Key** — 启用联网搜索（强烈建议，免费注册：[tavily.com](https://tavily.com)）\n\n点「完成」后，程序会自动帮你装好 AI 引擎、专业功能、数据库——**全程不需要你做任何事**，等几分钟就好。\n\n### 以后怎么用？\n\n- **启动**：双击 `TradeWin.exe`\n- **关闭**：点窗口右上角的 ×（可以最小化到系统托盘，后台运行）\n- **升级**：点界面里的「⚙️ 设置」→「系统」→「⬆️ 系统更新」\n\n> 桌面版和命令行版功能完全一样，数据互通，可以同时安装。\n\n---\n\n## 方式 C：让 AI 帮你装（如果你已经装好了 Hermes）\n\n如果你已经装好了 Hermes Agent（AI 引擎）并配置好了 API Key，最省心的方式是让 AI 自己装 Trade——它能根据你的电脑环境智能调整，比固定脚本更不容易出错。\n\n**前提条件：**\n- 已安装 Hermes Agent（看上面的第五步）\n- 已运行 `hermes setup` 配置好 LLM 和 **Tavily 搜索**（重要！没 Tavily AI 看不到 GitHub 仓库）\n\n**操作步骤：**\n\n1. 在 PowerShell 里启动 Hermes：\n\n```\nhermes\n```\n\n2. 等 Hermes 启动好后，在对话框里**直接粘贴**这句话（中文即可）：\n\n> 请分析 https://github.com/chefroger/smart-trade-ai 这个 GitHub 仓库，并帮我安装\n\n3. AI 会自己去 GitHub 看这个项目的说明，然后帮你执行所有安装命令。遇到报错它会自己排查重试，你只需要等它装完。\n\n4. 装完后，AI 会告诉你怎么启动。通常是：\n\n```\npython server.py\n```\n\n然后浏览器打开 **http://127.0.0.1:9119/trade** 就能用了。\n\n> 这种方式的好处：AI 会根据你电脑上已经装了什么、Python 是什么版本、网络情况如何，动态调整安装命令。遇到冲突或报错它也能自己想办法，比固定脚本成功率高。\n\n---\n\n## 苹果电脑（Mac）安装教程\n\n### 打开终端\n\nMac 上的操作窗口叫「**终端**」，和 Windows 的 PowerShell 类似。\n\n**怎么打开：** 在桌面右上角点**放大镜图标**（或者同时按 Command + 空格键），输入 `终端` 两个字，按回车，就打开了。\n\n### 一键安装\n\n在终端里复制粘贴下面这行命令，按回车：\n\n```\ncurl -fsSL https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.sh | bash\n```\n\n等它自动安装完，然后配置 AI：\n\n```\nhermes setup\n```\n\n按提示选择 DeepSeek，粘贴 API Key（和上面 Windows 第七步的操作一样）。\n\n最后启动：\n\n```\npython server.py\n```\n\n浏览器打开 **http://127.0.0.1:9119/trade** 。\n\n### 手动安装（一键脚本失败时用）\n\n在终端里依次执行以下每一行：\n\n```\ngit clone --branch main https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent\n```\n\n```\ncd ~/.hermes/hermes-agent && pip install -e \".\"\n```\n\n```\nhermes setup\n```\n\n```\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git ~/.trade/foreign-trade-assistant\n```\n\n```\ncd ~/.trade/foreign-trade-assistant && pip install -e \".\"\n```\n\n```\ninstall-trade-skills\n```\n\n```\npython server.py\n```\n\n> Mac 如果遇到下载超时，同样需要开 VPN 全局模式。\n\n---\n\n## 17 项专业能力\n\n| 场景 | 能力 |\n|------|------|\n| 平台诊断 | 分析阿里国际站 / 中国制造网产品页面，给出优化建议 |\n| 社媒营销 | 生成 Facebook / Instagram / TikTok / YouTube 内容日历 |\n| LinkedIn 运营 | 个人资料优化 + 内容策略 + 私信模板 |\n| 海关数据 | 分析进出口数据，帮你找到高价值采购商 |\n| 客户开发 | 根据目标市场和产品，自动生成开发信和跟进邮件，含价格/付款/交期谈判 |\n| 客户管理 | A/B/C 重要度分级、客户详情、关联合同文件 |\n| 文档分析 | 上传 PDF / Word / Excel / PPT，AI 自动读取分析 |\n| 商务文档生成 | 一键生成报价单、形式发票、合同 |\n| 报价谈判 | 根据产品库和客户情况，给出谈判策略建议 |\n| 客户背调 | 6 层验证：邮箱检测 → WHOIS → 制裁名单 → 邮箱真实性 → 技术栈 → LinkedIn |\n| 每日简报 | 实时汇率 + 大宗商品行情 + 市场新闻 + 客户跟进提醒 |\n| 定时任务 | 工作日自动执行：早报、开发信、社媒发布、每日总结 |\n| 对话记录 | 按公司分开存储聊天记录，随时搜索回顾 |\n| 履约运营 | 催款/索赔/展会/验厂/物流/售后/满意度/年度总结等 11 个场景 |\n| 贸易合规 | 文化禁忌检查/缩写规范/ICC 术语/翻译二审/投标/电商上架 |\n| 能力生成器 | 用大白话描述你的需求，自动创建新功能 |\n\n---\n\n## 你的数据安全吗？\n\n- **所有业务数据都存在你自己的电脑里**，不会上传到任何服务器\n- 如果你用的是云端 AI（比如 DeepSeek），对话内容会发给 AI 厂商处理，**但不会包含客户姓名等身份信息**\n- 如果你装 [Ollama](https://ollama.com) 用本地模型，连对话内容都不出你的电脑\n- 多公司之间数据互相隔离\n- 程序只允许你自己电脑上的浏览器访问，别人看不到\n\n---\n\n## 联系作者\n\n<div style=\"text-align:center;\">\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"200\" style=\"border-radius:8px;\">\n <p>扫码添加微信，备注「Trade」</p>\n <p>商务合作或技术支持：<a href=\"mailto:lauroge@gmail.com\">lauroge@gmail.com</a></p>\n</div>\n\n---\n\n<p style=\"text-align:center; color:#8b949e;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手 · 不需要懂技术<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n"}, "98d8ad47cfa7af1a0cb88e0d2fd2c24b14bbb54b": {"t": 1785772990.6369424, "n": 9369, "h": "57d50422f5f15012", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">不需要懂技术，跟着步骤走，10 分钟装好</p>\n <a href=\"#windows-install\" class=\"btn\" style=\"margin:0.5rem;\">点我开始安装 →</a>\n</div>\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-2.png\" alt=\"Customer & Cron Panel\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>客户管理 + 定时任务面板</em></p>\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-1.png\" alt=\"AI Chat Interface\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>AI 对话界面 — 像聊天一样使用</em></p>\n</div>\n\n---\n\n## <a id=\"windows-install\"></a>Windows 电脑安装教程\n\n> 整个过程大约 10 分钟。你不需要懂任何电脑技术，只要会下载安装软件、会复制粘贴文字就行。\n\n---\n\n### 第一步：安装 Python 和 Git（只需做一次）\n\n这个工具是用 Python 语言写的，你的电脑需要先装两个小程序才能运行它：**Python**（运行工具本身）和 **Git**（从网上下载工具代码）。就像你要看 PDF 文件得先装一个 PDF 阅读器一样。\n\n#### 1.1 安装 Python\n\n1. 打开浏览器（就是上网用的那个程序），在地址栏输入 **python.org/downloads** 然后回车\n2. 页面会自动识别你是 Windows 电脑，点击页面上那个 **黄色的大按钮** 开始下载\n3. 下载完后，**双击**打开刚才下载的那个文件（一般在浏览器左下角能点开）\n4. 安装窗口打开后，**先看窗口最下面**——有一个小方框写着「**Add Python to PATH**」，**一定要打勾！** 这一步最容易忘记，忘了后面整个装不了\n5. 打勾之后，点击上面的「**Install Now**」按钮\n6. 等进度条跑完，出现「Setup was successful」就装好了，关掉安装窗口\n\n> 如果你以前已经装过 Python，这一步可以跳过。\n\n#### 1.2 安装 Git\n\n1. 打开浏览器，在地址栏输入 **git-scm.com/download/win** 然后回车\n2. 页面会自动开始下载一个安装包（如果没自动下载，点页面里的「**Click here to download**」链接）\n3. 下载完后，**双击**打开安装包\n4. 一路点「**Next**」（下一步），所有选项都用默认的就行，最后点「**Install**」\n5. 安装完成后点「**Finish**」关闭安装窗口\n\n> 如果你以前已经装过 Git，这一步可以跳过。\n>\n> **装完 Python 和 Git 后，关闭所有已经打开的 PowerShell 窗口，再重新打开一个新的**——这一步很重要，不重开的话系统可能还认不出刚装好的程序。\n\n---\n\n### 第二步：打开 PowerShell\n\n接下来的安装步骤需要在 **PowerShell** 里操作。你可能在电视剧里见过黑客在黑屏幕上敲代码——PowerShell 就是那样的一个窗口。不过别紧张，你不需要自己写代码，只要**把我给你的命令复制进去、按回车就行**。\n\n**怎么找到 PowerShell：**\n\n1. 看你的键盘，**左下角有一个 Windows 图标的键**（四个方块组成的那个，叫 Win 键），按一下它\n2. 这时候屏幕上会弹出一个搜索框，**直接打字**输入：`powershell`\n3. 搜索结果里会出现一个图标是**蓝色**的、名字叫「**Windows PowerShell**」的程序，**点击它**\n4. 屏幕上会弹出一个**蓝色背景**（也可能是黑色背景）的窗口，里面有一些白色文字和一个闪烁的光标——这就是 PowerShell 了\n\n> **两个小提示：**\n> - 在 PowerShell 里**粘贴文字的方法**和平时不一样：不是按 Ctrl+V，而是**在窗口里点一下鼠标右键**，刚才复制的内容就会粘上去\n> - 下面出现的所有 `灰底文字`，都是你需要复制到 PowerShell 里执行的命令\n\n---\n\n### 第三步（推荐）：一键安装\n\nPython 装好之后，最省事的方法是用**一键安装脚本**——把下面这一行命令复制到 PowerShell 里执行，它会自动帮你装好所有东西：\n\n```\nirm https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.ps1 | iex\n```\n\n这个脚本会自动完成：安装 AI 引擎 → 安装 Smart Trade AI → 安装 17 个专业功能 → 初始化数据库 → 设置开机自启动。\n\n等它跑完后，继续往下看**第七步**获取 API Key 就行。\n\n> **如果一键脚本跑失败了**，不要紧，跟着下面的第四步、第五步和第六步手动装就行，效果一样。\n\n---\n\n### 第四步：开启长路径支持（只做一次，以前做过的跳过）\n\n> 如果你已经通过一键脚本安装成功，可以跳过第四步、第五步和第六步，直接看第七步。\n\nWindows 系统有一个默认设置，不允许文件路径太长。但这个工具安装时会产生比较长的路径，如果不改这个设置，后面安装会报错。我们只需要改一次，改完就不用管了。\n\n**操作步骤：**\n\n1. 按键盘上的 **Win 键**，输入 `powershell`\n2. 这一次不要直接点开，而是**用鼠标右键点击**搜索结果里的「Windows PowerShell」\n3. 在弹出的菜单里点「**以管理员身份运行**」\n4. 弹出一个提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n5. 这时打开的 PowerShell 窗口标题栏会写着「**管理员**」——说明你成功以管理员身份打开了\n6. 把下面这行命令**完整复制**（从 New 一直复制到 Force），在 PowerShell 窗口里**点右键粘贴**，然后**按回车**：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n7. 没有出现红色报错就说明成功了，**关掉这个管理员窗口**\n8. **重启电脑**让设置生效\n\n> 这一步一辈子只需要做一次。重启电脑后继续下一步。\n\n---\n\n### 第五步：安装 Hermes Agent\n\n这个工具背后需要一个叫 Hermes Agent 的程序来驱动 AI 功能。你可以把它理解为\"发动机\"——我们的工具是车身，得先有发动机才能跑。\n\n1. 打开 PowerShell（这次用**普通方式**打开就行，不需要管理员）\n2. 把下面这行命令**完整复制**，在 PowerShell 里**点右键粘贴**，按回车：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n3. 等待几分钟，它会自动下载和安装需要的文件\n4. 看到提示「安装完成」或「Installation complete」就说明好了\n\n> 如果等了很久都没反应或者报错了，多半是网络问题——参考页面底部的「常见问题」。\n\n---\n\n### 第六步：安装 Smart Trade AI\n\n发动机装好了，现在装车身。\n\n把下面 4 行命令**一行一行**地复制到 PowerShell 里执行。方法是：复制第一行 → 在 PowerShell 里右键粘贴 → 按回车 → 等它跑完 → 再复制第二行……以此类推。\n\n```\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n```\n\n```\ncd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n```\n\n```\npip install -e \".\"\n```\n\n```\ninstall-trade-skills\n```\n\n> 每一行都要等它跑完再执行下一行。如果中间某一行出现红色报错，不要慌，大多数是网络不好——重新复制那一行再执行一次。\n\n---\n\n### 第七步：获取 API Key\n\n这个工具需要连接 AI 大模型才能工作。AI 不是免费的，你需要去 AI 厂商那里注册一个账号、获取一个 **API Key**。\n\nAPI Key 是一串很长的字母和数字，就像一个密码，用来证明你有权限使用这个 AI 服务。\n\n**推荐用 DeepSeek（国产，便宜好用）：**\n\n1. 打开浏览器，访问 **platform.deepseek.com**\n2. 用手机号注册一个账号\n3. 登录之后，点页面上的「**充值**」，充 10 块钱就够了（按用量扣费，10 块钱能用很久）\n4. 在页面左侧找到「**API Keys**」，点进去，再点「**创建 API Key**」\n5. 页面上会显示一串字符——这就是你的 API Key。**立刻把它复制保存下来**（比如粘贴到记事本里），因为它只显示这一次，关了就看不到了\n\n拿到 API Key 之后，回到 PowerShell 窗口，输入下面这个命令然后回车：\n\n```\nhermes setup\n```\n\n这时会出现一个交互界面，操作方法：\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」，选中后**按回车**\n2. 它会问你要 API Key——把刚才保存的那串字符**右键粘贴**进去，按回车\n3. 看到「配置成功」之类的提示就完成了\n\n> 还建议顺手注册一个 [Tavily](https://tavily.com)（免费的，不用充值），它能让工具搜索实时信息。注册后同样在 `hermes setup` 里配置，选 Tavily 那一项，粘贴 Key。\n\n---\n\n### 第八步：启动！\n\n全部装好了，现在来运行它。在 PowerShell 里输入：\n\n```\npython server.py\n```\n\n按回车。等待几秒，看到窗口里出现 **「Uvicorn running on http://127.0.0.1:9119」** 这行字，就说明启动成功了。\n\n然后打开浏览器，在地址栏输入：**http://127.0.0.1:9119/trade** ，按回车，你就能看到界面了。\n\n> **以后每次要用的时候：** 打开 PowerShell → 输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 回车 → 输入 `python server.py` 回车 → 打开浏览器访问上面的地址。**关掉 PowerShell 窗口，程序就会停止**，所以使用期间不要关那个窗口。\n\n---\n\n### 让电脑每次开机自动启动（可选）\n\n如果你不想每次都手动打开 PowerShell 输入命令，可以生成一个 exe 程序，以后双击就能运行：\n\n在 PowerShell 里依次执行这两行（一行一行来）：\n\n```\npip install pyinstaller\n```\n\n```\npowershell -File scripts\\build.ps1\n```\n\n等它跑完后，在安装目录下的 `dist` 文件夹里会出现一个 **Smart Trade AI.exe**。你可以把它**拖到桌面上**，以后双击这个图标就能启动，不需要再打开 PowerShell。\n\n---\n\n### 安装中可能遇到的问题\n\n| 你看到的现象 | 可能的原因 | 怎么解决 |\n|------------|-----------|---------|\n| 输入 python 后提示「不是内部或外部命令」 | 安装 Python 时忘记勾选「Add Python to PATH」 | 回到第一步重新安装 Python，**一定要勾选那个框**。装完后关闭 PowerShell 重新打开再试 |\n| 输入 git 后提示「不是内部或外部命令」 | 没装 Git，或装完没重开 PowerShell | 回到第一步的 1.2 小节安装 Git。装完后**一定要关闭所有 PowerShell 窗口再重新打开** |\n| 安装到一半卡住不动了 | 你的网络访问 GitHub 不稳定 | 你需要开 **VPN**（就是翻墙工具），开到**全局模式**。开好之后关掉 PowerShell 重新打开，重新执行卡住的那行命令 |\n| 出现一大堆红色文字 | 大多是网络不好，没下载完整 | 把报错的那行命令重新复制执行一次。反复报错就确认 VPN 是否开好了 |\n| 浏览器打开显示「无法访问此网站」 | 程序没有在运行 | 回到 PowerShell 看看是不是关掉了或者报错了。如果关了就重新打开 PowerShell，重新执行 `python server.py` |\n| 页面打开了但是显示不正常、按钮点不动 | 浏览器缓存了旧版本的文件 | 同时按下键盘的 **Ctrl + Shift + R** 三个键，页面会强制刷新 |\n| 提示「Filename too long」 | 第四步的长路径设置没生效 | 确认第四步已经做过，并且**重启过电脑**。如果还没重启，先重启再来 |\n\n---\n\n## 苹果电脑（Mac）安装教程\n\n### 打开终端\n\nMac 上的操作窗口叫「**终端**」，和 Windows 的 PowerShell 类似。\n\n**怎么打开：** 在桌面右上角点**放大镜图标**（或者同时按 Command + 空格键），输入 `终端` 两个字，按回车，就打开了。\n\n### 一键安装\n\n在终端里复制粘贴下面这行命令，按回车：\n\n```\ncurl -fsSL https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.sh | bash\n```\n\n等它自动安装完，然后配置 AI：\n\n```\nhermes setup\n```\n\n按提示选择 DeepSeek，粘贴 API Key（和上面 Windows 第七步的操作一样）。\n\n最后启动：\n\n```\npython server.py\n```\n\n浏览器打开 **http://127.0.0.1:9119/trade** 。\n\n### 手动安装（一键脚本失败时用）\n\n在终端里依次执行以下每一行：\n\n```\ngit clone --branch main https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent\n```\n\n```\ncd ~/.hermes/hermes-agent && pip install -e \".\"\n```\n\n```\nhermes setup\n```\n\n```\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git ~/.trade/foreign-trade-assistant\n```\n\n```\ncd ~/.trade/foreign-trade-assistant && pip install -e \".\"\n```\n\n```\ninstall-trade-skills\n```\n\n```\npython server.py\n```\n\n> Mac 如果遇到下载超时，同样需要开 VPN 全局模式。\n\n---\n\n## 17 项专业能力\n\n| 场景 | 能力 |\n|------|------|\n| 平台诊断 | 分析阿里国际站 / 中国制造网产品页面，给出优化建议 |\n| 社媒营销 | 生成 Facebook / Instagram / TikTok / YouTube 内容日历 |\n| LinkedIn 运营 | 个人资料优化 + 内容策略 + 私信模板 |\n| 海关数据 | 分析进出口数据，帮你找到高价值采购商 |\n| 客户开发 | 根据目标市场和产品，自动生成开发信和跟进邮件，含价格/付款/交期谈判 |\n| 客户管理 | A/B/C 重要度分级、客户详情、关联合同文件 |\n| 文档分析 | 上传 PDF / Word / Excel / PPT，AI 自动读取分析 |\n| 商务文档生成 | 一键生成报价单、形式发票、合同 |\n| 报价谈判 | 根据产品库和客户情况，给出谈判策略建议 |\n| 客户背调 | 6 层验证：邮箱检测 → WHOIS → 制裁名单 → 邮箱真实性 → 技术栈 → LinkedIn |\n| 每日简报 | 实时汇率 + 大宗商品行情 + 市场新闻 + 客户跟进提醒 |\n| 定时任务 | 工作日自动执行：早报、开发信、社媒发布、每日总结 |\n| 对话记录 | 按公司分开存储聊天记录，随时搜索回顾 |\n| 履约运营 | 催款/索赔/展会/验厂/物流/售后/满意度/年度总结等 11 个场景 |\n| 贸易合规 | 文化禁忌检查/缩写规范/ICC 术语/翻译二审/投标/电商上架 |\n| 能力生成器 | 用大白话描述你的需求，自动创建新功能 |\n\n---\n\n## 你的数据安全吗？\n\n- **所有业务数据都存在你自己的电脑里**，不会上传到任何服务器\n- 如果你用的是云端 AI（比如 DeepSeek），对话内容会发给 AI 厂商处理，**但不会包含客户姓名等身份信息**\n- 如果你装 [Ollama](https://ollama.com) 用本地模型，连对话内容都不出你的电脑\n- 多公司之间数据互相隔离\n- 程序只允许你自己电脑上的浏览器访问，别人看不到\n\n---\n\n## 联系作者\n\n<div style=\"text-align:center;\">\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"200\" style=\"border-radius:8px;\">\n <p>扫码添加微信，备注「Trade」</p>\n <p>商务合作或技术支持：<a href=\"mailto:lauroge@gmail.com\">lauroge@gmail.com</a></p>\n</div>\n\n---\n\n<p style=\"text-align:center; color:#8b949e;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手 · 不需要懂技术<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n"}, "99f4c737220b2a3fd309de9c3633e4560d9a7365": {"t": 1785772991.931154, "n": 8866, "h": "c78755d4217eff99", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">不需要懂技术，跟着步骤走，10 分钟装好</p>\n <a href=\"#windows-install\" class=\"btn\" style=\"margin:0.5rem;\">点我开始安装 →</a>\n</div>\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-2.png\" alt=\"Customer & Cron Panel\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>客户管理 + 定时任务面板</em></p>\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-1.png\" alt=\"AI Chat Interface\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>AI 对话界面 — 像聊天一样使用</em></p>\n</div>\n\n---\n\n## <a id=\"windows-install\"></a>Windows 电脑安装教程\n\n> 整个过程大约 10 分钟。你不需要懂任何电脑技术，只要会下载安装软件、会复制粘贴文字就行。\n\n---\n\n### 第一步：安装 Python（只需做一次）\n\n这个工具是用 Python 语言写的，你的电脑需要先装一个 Python 才能运行它。就像你要看 PDF 文件得先装一个 PDF 阅读器一样。\n\n**操作步骤：**\n\n1. 打开浏览器（就是上网用的那个程序），在地址栏输入 **python.org/downloads** 然后回车\n2. 页面会自动识别你是 Windows 电脑，点击页面上那个 **黄色的大按钮** 开始下载\n3. 下载完后，**双击**打开刚才下载的那个文件（一般在浏览器左下角能点开）\n4. 安装窗口打开后，**先看窗口最下面**——有一个小方框写着「**Add Python to PATH**」，**一定要打勾！** 这一步最容易忘记，忘了后面整个装不了\n5. 打勾之后，点击上面的「**Install Now**」按钮\n6. 等进度条跑完，出现「Setup was successful」就装好了，关掉安装窗口\n\n> 如果你以前已经装过 Python，这一步可以跳过。\n\n---\n\n### 第二步：打开 PowerShell\n\n接下来的安装步骤需要在 **PowerShell** 里操作。你可能在电视剧里见过黑客在黑屏幕上敲代码——PowerShell 就是那样的一个窗口。不过别紧张，你不需要自己写代码，只要**把我给你的命令复制进去、按回车就行**。\n\n**怎么找到 PowerShell：**\n\n1. 看你的键盘，**左下角有一个 Windows 图标的键**（四个方块组成的那个，叫 Win 键），按一下它\n2. 这时候屏幕上会弹出一个搜索框，**直接打字**输入：`powershell`\n3. 搜索结果里会出现一个图标是**蓝色**的、名字叫「**Windows PowerShell**」的程序，**点击它**\n4. 屏幕上会弹出一个**蓝色背景**（也可能是黑色背景）的窗口，里面有一些白色文字和一个闪烁的光标——这就是 PowerShell 了\n\n> **两个小提示：**\n> - 在 PowerShell 里**粘贴文字的方法**和平时不一样：不是按 Ctrl+V，而是**在窗口里点一下鼠标右键**，刚才复制的内容就会粘上去\n> - 下面出现的所有 `灰底文字`，都是你需要复制到 PowerShell 里执行的命令\n\n---\n\n### 第三步（推荐）：一键安装\n\nPython 装好之后，最省事的方法是用**一键安装脚本**——把下面这一行命令复制到 PowerShell 里执行，它会自动帮你装好所有东西：\n\n```\nirm https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.ps1 | iex\n```\n\n这个脚本会自动完成：安装 AI 引擎 → 安装 Smart Trade AI → 安装 17 个专业功能 → 初始化数据库 → 设置开机自启动。\n\n等它跑完后，继续往下看**第七步**获取 API Key 就行。\n\n> **如果一键脚本跑失败了**，不要紧，跟着下面的第四步、第五步和第六步手动装就行，效果一样。\n\n---\n\n### 第四步：开启长路径支持（只做一次，以前做过的跳过）\n\n> 如果你已经通过一键脚本安装成功，可以跳过第四步、第五步和第六步，直接看第七步。\n\nWindows 系统有一个默认设置，不允许文件路径太长。但这个工具安装时会产生比较长的路径，如果不改这个设置，后面安装会报错。我们只需要改一次，改完就不用管了。\n\n**操作步骤：**\n\n1. 按键盘上的 **Win 键**，输入 `powershell`\n2. 这一次不要直接点开，而是**用鼠标右键点击**搜索结果里的「Windows PowerShell」\n3. 在弹出的菜单里点「**以管理员身份运行**」\n4. 弹出一个提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n5. 这时打开的 PowerShell 窗口标题栏会写着「**管理员**」——说明你成功以管理员身份打开了\n6. 把下面这行命令**完整复制**（从 New 一直复制到 Force），在 PowerShell 窗口里**点右键粘贴**，然后**按回车**：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n7. 没有出现红色报错就说明成功了，**关掉这个管理员窗口**\n8. **重启电脑**让设置生效\n\n> 这一步一辈子只需要做一次。重启电脑后继续下一步。\n\n---\n\n### 第五步：安装 Hermes Agent\n\n这个工具背后需要一个叫 Hermes Agent 的程序来驱动 AI 功能。你可以把它理解为\"发动机\"——我们的工具是车身，得先有发动机才能跑。\n\n1. 打开 PowerShell（这次用**普通方式**打开就行，不需要管理员）\n2. 把下面这行命令**完整复制**，在 PowerShell 里**点右键粘贴**，按回车：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n3. 等待几分钟，它会自动下载和安装需要的文件\n4. 看到提示「安装完成」或「Installation complete」就说明好了\n\n> 如果等了很久都没反应或者报错了，多半是网络问题——参考页面底部的「常见问题」。\n\n---\n\n### 第六步：安装 Smart Trade AI\n\n发动机装好了，现在装车身。\n\n把下面 4 行命令**一行一行**地复制到 PowerShell 里执行。方法是：复制第一行 → 在 PowerShell 里右键粘贴 → 按回车 → 等它跑完 → 再复制第二行……以此类推。\n\n```\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n```\n\n```\ncd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n```\n\n```\npip install -e \".\"\n```\n\n```\ninstall-trade-skills\n```\n\n> 每一行都要等它跑完再执行下一行。如果中间某一行出现红色报错，不要慌，大多数是网络不好——重新复制那一行再执行一次。\n\n---\n\n### 第七步：获取 API Key\n\n这个工具需要连接 AI 大模型才能工作。AI 不是免费的，你需要去 AI 厂商那里注册一个账号、获取一个 **API Key**。\n\nAPI Key 是一串很长的字母和数字，就像一个密码，用来证明你有权限使用这个 AI 服务。\n\n**推荐用 DeepSeek（国产，便宜好用）：**\n\n1. 打开浏览器，访问 **platform.deepseek.com**\n2. 用手机号注册一个账号\n3. 登录之后，点页面上的「**充值**」，充 10 块钱就够了（按用量扣费，10 块钱能用很久）\n4. 在页面左侧找到「**API Keys**」，点进去，再点「**创建 API Key**」\n5. 页面上会显示一串字符——这就是你的 API Key。**立刻把它复制保存下来**（比如粘贴到记事本里），因为它只显示这一次，关了就看不到了\n\n拿到 API Key 之后，回到 PowerShell 窗口，输入下面这个命令然后回车：\n\n```\nhermes setup\n```\n\n这时会出现一个交互界面，操作方法：\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」，选中后**按回车**\n2. 它会问你要 API Key——把刚才保存的那串字符**右键粘贴**进去，按回车\n3. 看到「配置成功」之类的提示就完成了\n\n> 还建议顺手注册一个 [Tavily](https://tavily.com)（免费的，不用充值），它能让工具搜索实时信息。注册后同样在 `hermes setup` 里配置，选 Tavily 那一项，粘贴 Key。\n\n---\n\n### 第八步：启动！\n\n全部装好了，现在来运行它。在 PowerShell 里输入：\n\n```\npython server.py\n```\n\n按回车。等待几秒，看到窗口里出现 **「Uvicorn running on http://127.0.0.1:9119」** 这行字，就说明启动成功了。\n\n然后打开浏览器，在地址栏输入：**http://127.0.0.1:9119/trade** ，按回车，你就能看到界面了。\n\n> **以后每次要用的时候：** 打开 PowerShell → 输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 回车 → 输入 `python server.py` 回车 → 打开浏览器访问上面的地址。**关掉 PowerShell 窗口，程序就会停止**，所以使用期间不要关那个窗口。\n\n---\n\n### 让电脑每次开机自动启动（可选）\n\n如果你不想每次都手动打开 PowerShell 输入命令，可以生成一个 exe 程序，以后双击就能运行：\n\n在 PowerShell 里依次执行这两行（一行一行来）：\n\n```\npip install pyinstaller\n```\n\n```\npowershell -File scripts\\build.ps1\n```\n\n等它跑完后，在安装目录下的 `dist` 文件夹里会出现一个 **Smart Trade AI.exe**。你可以把它**拖到桌面上**，以后双击这个图标就能启动，不需要再打开 PowerShell。\n\n---\n\n### 安装中可能遇到的问题\n\n| 你看到的现象 | 可能的原因 | 怎么解决 |\n|------------|-----------|---------|\n| 输入 python 后提示「不是内部或外部命令」 | 安装 Python 时忘记勾选「Add Python to PATH」 | 回到第一步重新安装 Python，**一定要勾选那个框**。装完后关闭 PowerShell 重新打开再试 |\n| 安装到一半卡住不动了 | 你的网络访问 GitHub 不稳定 | 你需要开 **VPN**（就是翻墙工具），开到**全局模式**。开好之后关掉 PowerShell 重新打开，重新执行卡住的那行命令 |\n| 出现一大堆红色文字 | 大多是网络不好，没下载完整 | 把报错的那行命令重新复制执行一次。反复报错就确认 VPN 是否开好了 |\n| 浏览器打开显示「无法访问此网站」 | 程序没有在运行 | 回到 PowerShell 看看是不是关掉了或者报错了。如果关了就重新打开 PowerShell，重新执行 `python server.py` |\n| 页面打开了但是显示不正常、按钮点不动 | 浏览器缓存了旧版本的文件 | 同时按下键盘的 **Ctrl + Shift + R** 三个键，页面会强制刷新 |\n| 提示「Filename too long」 | 第四步的长路径设置没生效 | 确认第四步已经做过，并且**重启过电脑**。如果还没重启，先重启再来 |\n\n---\n\n## 苹果电脑（Mac）安装教程\n\n### 打开终端\n\nMac 上的操作窗口叫「**终端**」，和 Windows 的 PowerShell 类似。\n\n**怎么打开：** 在桌面右上角点**放大镜图标**（或者同时按 Command + 空格键），输入 `终端` 两个字，按回车，就打开了。\n\n### 一键安装\n\n在终端里复制粘贴下面这行命令，按回车：\n\n```\ncurl -fsSL https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.sh | bash\n```\n\n等它自动安装完，然后配置 AI：\n\n```\nhermes setup\n```\n\n按提示选择 DeepSeek，粘贴 API Key（和上面 Windows 第七步的操作一样）。\n\n最后启动：\n\n```\npython server.py\n```\n\n浏览器打开 **http://127.0.0.1:9119/trade** 。\n\n### 手动安装（一键脚本失败时用）\n\n在终端里依次执行以下每一行：\n\n```\ngit clone --branch main https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent\n```\n\n```\ncd ~/.hermes/hermes-agent && pip install -e \".\"\n```\n\n```\nhermes setup\n```\n\n```\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git ~/.trade/foreign-trade-assistant\n```\n\n```\ncd ~/.trade/foreign-trade-assistant && pip install -e \".\"\n```\n\n```\ninstall-trade-skills\n```\n\n```\npython server.py\n```\n\n> Mac 如果遇到下载超时，同样需要开 VPN 全局模式。\n\n---\n\n## 17 项专业能力\n\n| 场景 | 能力 |\n|------|------|\n| 平台诊断 | 分析阿里国际站 / 中国制造网产品页面，给出优化建议 |\n| 社媒营销 | 生成 Facebook / Instagram / TikTok / YouTube 内容日历 |\n| LinkedIn 运营 | 个人资料优化 + 内容策略 + 私信模板 |\n| 海关数据 | 分析进出口数据，帮你找到高价值采购商 |\n| 客户开发 | 根据目标市场和产品，自动生成开发信和跟进邮件，含价格/付款/交期谈判 |\n| 客户管理 | A/B/C 重要度分级、客户详情、关联合同文件 |\n| 文档分析 | 上传 PDF / Word / Excel / PPT，AI 自动读取分析 |\n| 商务文档生成 | 一键生成报价单、形式发票、合同 |\n| 报价谈判 | 根据产品库和客户情况，给出谈判策略建议 |\n| 客户背调 | 6 层验证：邮箱检测 → WHOIS → 制裁名单 → 邮箱真实性 → 技术栈 → LinkedIn |\n| 每日简报 | 实时汇率 + 大宗商品行情 + 市场新闻 + 客户跟进提醒 |\n| 定时任务 | 工作日自动执行：早报、开发信、社媒发布、每日总结 |\n| 对话记录 | 按公司分开存储聊天记录，随时搜索回顾 |\n| 履约运营 | 催款/索赔/展会/验厂/物流/售后/满意度/年度总结等 11 个场景 |\n| 贸易合规 | 文化禁忌检查/缩写规范/ICC 术语/翻译二审/投标/电商上架 |\n| 能力生成器 | 用大白话描述你的需求，自动创建新功能 |\n\n---\n\n## 你的数据安全吗？\n\n- **所有业务数据都存在你自己的电脑里**，不会上传到任何服务器\n- 如果你用的是云端 AI（比如 DeepSeek），对话内容会发给 AI 厂商处理，**但不会包含客户姓名等身份信息**\n- 如果你装 [Ollama](https://ollama.com) 用本地模型，连对话内容都不出你的电脑\n- 多公司之间数据互相隔离\n- 程序只允许你自己电脑上的浏览器访问，别人看不到\n\n---\n\n## 联系作者\n\n<div style=\"text-align:center;\">\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"200\" style=\"border-radius:8px;\">\n <p>扫码添加微信，备注「Trade」</p>\n <p>商务合作或技术支持：<a href=\"mailto:lauroge@gmail.com\">lauroge@gmail.com</a></p>\n</div>\n\n---\n\n<p style=\"text-align:center; color:#8b949e;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手 · 不需要懂技术<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n"}, "d69b55b3641bca66a7b7ee0e0fa7ede4eba64c76": {"t": 1785772993.225458, "n": 8866, "h": "f9a631acdfb741d7", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">不需要懂技术，跟着步骤走，10 分钟装好</p>\n <a href=\"#windows-install\" class=\"btn\" style=\"margin:0.5rem;\">点我开始安装 →</a>\n</div>\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-2.png\" alt=\"Customer & Cron Panel\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>客户管理 + 定时任务面板</em></p>\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-1.png\" alt=\"AI Chat Interface\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>AI 对话界面 — 像聊天一样使用</em></p>\n</div>\n\n---\n\n## <a id=\"windows-install\"></a>Windows 电脑安装教程\n\n> 整个过程大约 10 分钟。你不需要懂任何电脑技术，只要会下载安装软件、会复制粘贴文字就行。\n\n---\n\n### 第一步：安装 Python（只需做一次）\n\n这个工具是用 Python 语言写的，你的电脑需要先装一个 Python 才能运行它。就像你要看 PDF 文件得先装一个 PDF 阅读器一样。\n\n**操作步骤：**\n\n1. 打开浏览器（就是上网用的那个程序），在地址栏输入 **python.org/downloads** 然后回车\n2. 页面会自动识别你是 Windows 电脑，点击页面上那个 **黄色的大按钮** 开始下载\n3. 下载完后，**双击**打开刚才下载的那个文件（一般在浏览器左下角能点开）\n4. 安装窗口打开后，**先看窗口最下面**——有一个小方框写着「**Add Python to PATH**」，**一定要打勾！** 这一步最容易忘记，忘了后面整个装不了\n5. 打勾之后，点击上面的「**Install Now**」按钮\n6. 等进度条跑完，出现「Setup was successful」就装好了，关掉安装窗口\n\n> 如果你以前已经装过 Python，这一步可以跳过。\n\n---\n\n### 第二步：打开 PowerShell\n\n接下来的安装步骤需要在 **PowerShell** 里操作。你可能在电视剧里见过黑客在黑屏幕上敲代码——PowerShell 就是那样的一个窗口。不过别紧张，你不需要自己写代码，只要**把我给你的命令复制进去、按回车就行**。\n\n**怎么找到 PowerShell：**\n\n1. 看你的键盘，**左下角有一个 Windows 图标的键**（四个方块组成的那个，叫 Win 键），按一下它\n2. 这时候屏幕上会弹出一个搜索框，**直接打字**输入：`powershell`\n3. 搜索结果里会出现一个图标是**蓝色**的、名字叫「**Windows PowerShell**」的程序，**点击它**\n4. 屏幕上会弹出一个**蓝色背景**（也可能是黑色背景）的窗口，里面有一些白色文字和一个闪烁的光标——这就是 PowerShell 了\n\n> **两个小提示：**\n> - 在 PowerShell 里**粘贴文字的方法**和平时不一样：不是按 Ctrl+V，而是**在窗口里点一下鼠标右键**，刚才复制的内容就会粘上去\n> - 下面出现的所有 `灰底文字`，都是你需要复制到 PowerShell 里执行的命令\n\n---\n\n### 第三步（推荐）：一键安装\n\nPython 装好之后，最省事的方法是用**一键安装脚本**——把下面这一行命令复制到 PowerShell 里执行，它会自动帮你装好所有东西：\n\n```\nirm https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.ps1 | iex\n```\n\n这个脚本会自动完成：安装 AI 引擎 → 安装 Smart Trade AI → 安装 15 个专业功能 → 初始化数据库 → 设置开机自启动。\n\n等它跑完后，继续往下看**第七步**获取 API Key 就行。\n\n> **如果一键脚本跑失败了**，不要紧，跟着下面的第四步、第五步和第六步手动装就行，效果一样。\n\n---\n\n### 第四步：开启长路径支持（只做一次，以前做过的跳过）\n\n> 如果你已经通过一键脚本安装成功，可以跳过第四步、第五步和第六步，直接看第七步。\n\nWindows 系统有一个默认设置，不允许文件路径太长。但这个工具安装时会产生比较长的路径，如果不改这个设置，后面安装会报错。我们只需要改一次，改完就不用管了。\n\n**操作步骤：**\n\n1. 按键盘上的 **Win 键**，输入 `powershell`\n2. 这一次不要直接点开，而是**用鼠标右键点击**搜索结果里的「Windows PowerShell」\n3. 在弹出的菜单里点「**以管理员身份运行**」\n4. 弹出一个提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n5. 这时打开的 PowerShell 窗口标题栏会写着「**管理员**」——说明你成功以管理员身份打开了\n6. 把下面这行命令**完整复制**（从 New 一直复制到 Force），在 PowerShell 窗口里**点右键粘贴**，然后**按回车**：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n7. 没有出现红色报错就说明成功了，**关掉这个管理员窗口**\n8. **重启电脑**让设置生效\n\n> 这一步一辈子只需要做一次。重启电脑后继续下一步。\n\n---\n\n### 第五步：安装 Hermes Agent\n\n这个工具背后需要一个叫 Hermes Agent 的程序来驱动 AI 功能。你可以把它理解为\"发动机\"——我们的工具是车身，得先有发动机才能跑。\n\n1. 打开 PowerShell（这次用**普通方式**打开就行，不需要管理员）\n2. 把下面这行命令**完整复制**，在 PowerShell 里**点右键粘贴**，按回车：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n3. 等待几分钟，它会自动下载和安装需要的文件\n4. 看到提示「安装完成」或「Installation complete」就说明好了\n\n> 如果等了很久都没反应或者报错了，多半是网络问题——参考页面底部的「常见问题」。\n\n---\n\n### 第六步：安装 Smart Trade AI\n\n发动机装好了，现在装车身。\n\n把下面 4 行命令**一行一行**地复制到 PowerShell 里执行。方法是：复制第一行 → 在 PowerShell 里右键粘贴 → 按回车 → 等它跑完 → 再复制第二行……以此类推。\n\n```\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n```\n\n```\ncd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n```\n\n```\npip install -e \".\"\n```\n\n```\ninstall-trade-skills\n```\n\n> 每一行都要等它跑完再执行下一行。如果中间某一行出现红色报错，不要慌，大多数是网络不好——重新复制那一行再执行一次。\n\n---\n\n### 第七步：获取 API Key\n\n这个工具需要连接 AI 大模型才能工作。AI 不是免费的，你需要去 AI 厂商那里注册一个账号、获取一个 **API Key**。\n\nAPI Key 是一串很长的字母和数字，就像一个密码，用来证明你有权限使用这个 AI 服务。\n\n**推荐用 DeepSeek（国产，便宜好用）：**\n\n1. 打开浏览器，访问 **platform.deepseek.com**\n2. 用手机号注册一个账号\n3. 登录之后，点页面上的「**充值**」，充 10 块钱就够了（按用量扣费，10 块钱能用很久）\n4. 在页面左侧找到「**API Keys**」，点进去，再点「**创建 API Key**」\n5. 页面上会显示一串字符——这就是你的 API Key。**立刻把它复制保存下来**（比如粘贴到记事本里），因为它只显示这一次，关了就看不到了\n\n拿到 API Key 之后，回到 PowerShell 窗口，输入下面这个命令然后回车：\n\n```\nhermes setup\n```\n\n这时会出现一个交互界面，操作方法：\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」，选中后**按回车**\n2. 它会问你要 API Key——把刚才保存的那串字符**右键粘贴**进去，按回车\n3. 看到「配置成功」之类的提示就完成了\n\n> 还建议顺手注册一个 [Tavily](https://tavily.com)（免费的，不用充值），它能让工具搜索实时信息。注册后同样在 `hermes setup` 里配置，选 Tavily 那一项，粘贴 Key。\n\n---\n\n### 第八步：启动！\n\n全部装好了，现在来运行它。在 PowerShell 里输入：\n\n```\npython server.py\n```\n\n按回车。等待几秒，看到窗口里出现 **「Uvicorn running on http://127.0.0.1:9119」** 这行字，就说明启动成功了。\n\n然后打开浏览器，在地址栏输入：**http://127.0.0.1:9119/trade** ，按回车，你就能看到界面了。\n\n> **以后每次要用的时候：** 打开 PowerShell → 输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 回车 → 输入 `python server.py` 回车 → 打开浏览器访问上面的地址。**关掉 PowerShell 窗口，程序就会停止**，所以使用期间不要关那个窗口。\n\n---\n\n### 让电脑每次开机自动启动（可选）\n\n如果你不想每次都手动打开 PowerShell 输入命令，可以生成一个 exe 程序，以后双击就能运行：\n\n在 PowerShell 里依次执行这两行（一行一行来）：\n\n```\npip install pyinstaller\n```\n\n```\npowershell -File scripts\\build.ps1\n```\n\n等它跑完后，在安装目录下的 `dist` 文件夹里会出现一个 **Smart Trade AI.exe**。你可以把它**拖到桌面上**，以后双击这个图标就能启动，不需要再打开 PowerShell。\n\n---\n\n### 安装中可能遇到的问题\n\n| 你看到的现象 | 可能的原因 | 怎么解决 |\n|------------|-----------|---------|\n| 输入 python 后提示「不是内部或外部命令」 | 安装 Python 时忘记勾选「Add Python to PATH」 | 回到第一步重新安装 Python，**一定要勾选那个框**。装完后关闭 PowerShell 重新打开再试 |\n| 安装到一半卡住不动了 | 你的网络访问 GitHub 不稳定 | 你需要开 **VPN**（就是翻墙工具），开到**全局模式**。开好之后关掉 PowerShell 重新打开，重新执行卡住的那行命令 |\n| 出现一大堆红色文字 | 大多是网络不好，没下载完整 | 把报错的那行命令重新复制执行一次。反复报错就确认 VPN 是否开好了 |\n| 浏览器打开显示「无法访问此网站」 | 程序没有在运行 | 回到 PowerShell 看看是不是关掉了或者报错了。如果关了就重新打开 PowerShell，重新执行 `python server.py` |\n| 页面打开了但是显示不正常、按钮点不动 | 浏览器缓存了旧版本的文件 | 同时按下键盘的 **Ctrl + Shift + R** 三个键，页面会强制刷新 |\n| 提示「Filename too long」 | 第四步的长路径设置没生效 | 确认第四步已经做过，并且**重启过电脑**。如果还没重启，先重启再来 |\n\n---\n\n## 苹果电脑（Mac）安装教程\n\n### 打开终端\n\nMac 上的操作窗口叫「**终端**」，和 Windows 的 PowerShell 类似。\n\n**怎么打开：** 在桌面右上角点**放大镜图标**（或者同时按 Command + 空格键），输入 `终端` 两个字，按回车，就打开了。\n\n### 一键安装\n\n在终端里复制粘贴下面这行命令，按回车：\n\n```\ncurl -fsSL https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.sh | bash\n```\n\n等它自动安装完，然后配置 AI：\n\n```\nhermes setup\n```\n\n按提示选择 DeepSeek，粘贴 API Key（和上面 Windows 第七步的操作一样）。\n\n最后启动：\n\n```\npython server.py\n```\n\n浏览器打开 **http://127.0.0.1:9119/trade** 。\n\n### 手动安装（一键脚本失败时用）\n\n在终端里依次执行以下每一行：\n\n```\ngit clone --branch main https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent\n```\n\n```\ncd ~/.hermes/hermes-agent && pip install -e \".\"\n```\n\n```\nhermes setup\n```\n\n```\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git ~/.trade/foreign-trade-assistant\n```\n\n```\ncd ~/.trade/foreign-trade-assistant && pip install -e \".\"\n```\n\n```\ninstall-trade-skills\n```\n\n```\npython server.py\n```\n\n> Mac 如果遇到下载超时，同样需要开 VPN 全局模式。\n\n---\n\n## 17 项专业能力\n\n| 场景 | 能力 |\n|------|------|\n| 平台诊断 | 分析阿里国际站 / 中国制造网产品页面，给出优化建议 |\n| 社媒营销 | 生成 Facebook / Instagram / TikTok / YouTube 内容日历 |\n| LinkedIn 运营 | 个人资料优化 + 内容策略 + 私信模板 |\n| 海关数据 | 分析进出口数据，帮你找到高价值采购商 |\n| 客户开发 | 根据目标市场和产品，自动生成开发信和跟进邮件，含价格/付款/交期谈判 |\n| 客户管理 | A/B/C 重要度分级、客户详情、关联合同文件 |\n| 文档分析 | 上传 PDF / Word / Excel / PPT，AI 自动读取分析 |\n| 商务文档生成 | 一键生成报价单、形式发票、合同 |\n| 报价谈判 | 根据产品库和客户情况，给出谈判策略建议 |\n| 客户背调 | 6 层验证：邮箱检测 → WHOIS → 制裁名单 → 邮箱真实性 → 技术栈 → LinkedIn |\n| 每日简报 | 实时汇率 + 大宗商品行情 + 市场新闻 + 客户跟进提醒 |\n| 定时任务 | 工作日自动执行：早报、开发信、社媒发布、每日总结 |\n| 对话记录 | 按公司分开存储聊天记录，随时搜索回顾 |\n| 履约运营 | 催款/索赔/展会/验厂/物流/售后/满意度/年度总结等 11 个场景 |\n| 贸易合规 | 文化禁忌检查/缩写规范/ICC 术语/翻译二审/投标/电商上架 |\n| 能力生成器 | 用大白话描述你的需求，自动创建新功能 |\n\n---\n\n## 你的数据安全吗？\n\n- **所有业务数据都存在你自己的电脑里**，不会上传到任何服务器\n- 如果你用的是云端 AI（比如 DeepSeek），对话内容会发给 AI 厂商处理，**但不会包含客户姓名等身份信息**\n- 如果你装 [Ollama](https://ollama.com) 用本地模型，连对话内容都不出你的电脑\n- 多公司之间数据互相隔离\n- 程序只允许你自己电脑上的浏览器访问，别人看不到\n\n---\n\n## 联系作者\n\n<div style=\"text-align:center;\">\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"200\" style=\"border-radius:8px;\">\n <p>扫码添加微信，备注「Trade」</p>\n <p>商务合作或技术支持：<a href=\"mailto:lauroge@gmail.com\">lauroge@gmail.com</a></p>\n</div>\n\n---\n\n<p style=\"text-align:center; color:#8b949e;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手 · 不需要懂技术<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n"}, "44c2da967bb1ea3e94278fd97f8e4cd99ce1af79": {"t": 1785772994.5644157, "n": 8765, "h": "5323d3f19270f6e6", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">不需要懂技术，跟着步骤走，10 分钟装好</p>\n <a href=\"#windows-install\" class=\"btn\" style=\"margin:0.5rem;\">点我开始安装 →</a>\n</div>\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-2.png\" alt=\"Customer & Cron Panel\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>客户管理 + 定时任务面板</em></p>\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-1.png\" alt=\"AI Chat Interface\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>AI 对话界面 — 像聊天一样使用</em></p>\n</div>\n\n---\n\n## <a id=\"windows-install\"></a>Windows 电脑安装教程\n\n> 整个过程大约 10 分钟。你不需要懂任何电脑技术，只要会下载安装软件、会复制粘贴文字就行。\n\n---\n\n### 第一步：安装 Python（只需做一次）\n\n这个工具是用 Python 语言写的，你的电脑需要先装一个 Python 才能运行它。就像你要看 PDF 文件得先装一个 PDF 阅读器一样。\n\n**操作步骤：**\n\n1. 打开浏览器（就是上网用的那个程序），在地址栏输入 **python.org/downloads** 然后回车\n2. 页面会自动识别你是 Windows 电脑，点击页面上那个 **黄色的大按钮** 开始下载\n3. 下载完后，**双击**打开刚才下载的那个文件（一般在浏览器左下角能点开）\n4. 安装窗口打开后，**先看窗口最下面**——有一个小方框写着「**Add Python to PATH**」，**一定要打勾！** 这一步最容易忘记，忘了后面整个装不了\n5. 打勾之后，点击上面的「**Install Now**」按钮\n6. 等进度条跑完，出现「Setup was successful」就装好了，关掉安装窗口\n\n> 如果你以前已经装过 Python，这一步可以跳过。\n\n---\n\n### 第二步：打开 PowerShell\n\n接下来的安装步骤需要在 **PowerShell** 里操作。你可能在电视剧里见过黑客在黑屏幕上敲代码——PowerShell 就是那样的一个窗口。不过别紧张，你不需要自己写代码，只要**把我给你的命令复制进去、按回车就行**。\n\n**怎么找到 PowerShell：**\n\n1. 看你的键盘，**左下角有一个 Windows 图标的键**（四个方块组成的那个，叫 Win 键），按一下它\n2. 这时候屏幕上会弹出一个搜索框，**直接打字**输入：`powershell`\n3. 搜索结果里会出现一个图标是**蓝色**的、名字叫「**Windows PowerShell**」的程序，**点击它**\n4. 屏幕上会弹出一个**蓝色背景**（也可能是黑色背景）的窗口，里面有一些白色文字和一个闪烁的光标——这就是 PowerShell 了\n\n> **两个小提示：**\n> - 在 PowerShell 里**粘贴文字的方法**和平时不一样：不是按 Ctrl+V，而是**在窗口里点一下鼠标右键**，刚才复制的内容就会粘上去\n> - 下面出现的所有 `灰底文字`，都是你需要复制到 PowerShell 里执行的命令\n\n---\n\n### 第三步（推荐）：一键安装\n\nPython 装好之后，最省事的方法是用**一键安装脚本**——把下面这一行命令复制到 PowerShell 里执行，它会自动帮你装好所有东西：\n\n```\nirm https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.ps1 | iex\n```\n\n这个脚本会自动完成：安装 AI 引擎 → 安装 Smart Trade AI → 安装 15 个专业功能 → 初始化数据库 → 设置开机自启动。\n\n等它跑完后，继续往下看**第七步**获取 API Key 就行。\n\n> **如果一键脚本跑失败了**，不要紧，跟着下面的第四步、第五步和第六步手动装就行，效果一样。\n\n---\n\n### 第四步：开启长路径支持（只做一次，以前做过的跳过）\n\n> 如果你已经通过一键脚本安装成功，可以跳过第四步、第五步和第六步，直接看第七步。\n\nWindows 系统有一个默认设置，不允许文件路径太长。但这个工具安装时会产生比较长的路径，如果不改这个设置，后面安装会报错。我们只需要改一次，改完就不用管了。\n\n**操作步骤：**\n\n1. 按键盘上的 **Win 键**，输入 `powershell`\n2. 这一次不要直接点开，而是**用鼠标右键点击**搜索结果里的「Windows PowerShell」\n3. 在弹出的菜单里点「**以管理员身份运行**」\n4. 弹出一个提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n5. 这时打开的 PowerShell 窗口标题栏会写着「**管理员**」——说明你成功以管理员身份打开了\n6. 把下面这行命令**完整复制**（从 New 一直复制到 Force），在 PowerShell 窗口里**点右键粘贴**，然后**按回车**：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n7. 没有出现红色报错就说明成功了，**关掉这个管理员窗口**\n8. **重启电脑**让设置生效\n\n> 这一步一辈子只需要做一次。重启电脑后继续下一步。\n\n---\n\n### 第五步：安装 Hermes Agent\n\n这个工具背后需要一个叫 Hermes Agent 的程序来驱动 AI 功能。你可以把它理解为\"发动机\"——我们的工具是车身，得先有发动机才能跑。\n\n1. 打开 PowerShell（这次用**普通方式**打开就行，不需要管理员）\n2. 把下面这行命令**完整复制**，在 PowerShell 里**点右键粘贴**，按回车：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n3. 等待几分钟，它会自动下载和安装需要的文件\n4. 看到提示「安装完成」或「Installation complete」就说明好了\n\n> 如果等了很久都没反应或者报错了，多半是网络问题——参考页面底部的「常见问题」。\n\n---\n\n### 第六步：安装 Smart Trade AI\n\n发动机装好了，现在装车身。\n\n把下面 4 行命令**一行一行**地复制到 PowerShell 里执行。方法是：复制第一行 → 在 PowerShell 里右键粘贴 → 按回车 → 等它跑完 → 再复制第二行……以此类推。\n\n```\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n```\n\n```\ncd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n```\n\n```\npip install -e \".\"\n```\n\n```\ninstall-trade-skills\n```\n\n> 每一行都要等它跑完再执行下一行。如果中间某一行出现红色报错，不要慌，大多数是网络不好——重新复制那一行再执行一次。\n\n---\n\n### 第七步：获取 API Key\n\n这个工具需要连接 AI 大模型才能工作。AI 不是免费的，你需要去 AI 厂商那里注册一个账号、获取一个 **API Key**。\n\nAPI Key 是一串很长的字母和数字，就像一个密码，用来证明你有权限使用这个 AI 服务。\n\n**推荐用 DeepSeek（国产，便宜好用）：**\n\n1. 打开浏览器，访问 **platform.deepseek.com**\n2. 用手机号注册一个账号\n3. 登录之后，点页面上的「**充值**」，充 10 块钱就够了（按用量扣费，10 块钱能用很久）\n4. 在页面左侧找到「**API Keys**」，点进去，再点「**创建 API Key**」\n5. 页面上会显示一串字符——这就是你的 API Key。**立刻把它复制保存下来**（比如粘贴到记事本里），因为它只显示这一次，关了就看不到了\n\n拿到 API Key 之后，回到 PowerShell 窗口，输入下面这个命令然后回车：\n\n```\nhermes setup\n```\n\n这时会出现一个交互界面，操作方法：\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」，选中后**按回车**\n2. 它会问你要 API Key——把刚才保存的那串字符**右键粘贴**进去，按回车\n3. 看到「配置成功」之类的提示就完成了\n\n> 还建议顺手注册一个 [Tavily](https://tavily.com)（免费的，不用充值），它能让工具搜索实时信息。注册后同样在 `hermes setup` 里配置，选 Tavily 那一项，粘贴 Key。\n\n---\n\n### 第八步：启动！\n\n全部装好了，现在来运行它。在 PowerShell 里输入：\n\n```\npython server.py\n```\n\n按回车。等待几秒，看到窗口里出现 **「Uvicorn running on http://127.0.0.1:9119」** 这行字，就说明启动成功了。\n\n然后打开浏览器，在地址栏输入：**http://127.0.0.1:9119/trade** ，按回车，你就能看到界面了。\n\n> **以后每次要用的时候：** 打开 PowerShell → 输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 回车 → 输入 `python server.py` 回车 → 打开浏览器访问上面的地址。**关掉 PowerShell 窗口，程序就会停止**，所以使用期间不要关那个窗口。\n\n---\n\n### 让电脑每次开机自动启动（可选）\n\n如果你不想每次都手动打开 PowerShell 输入命令，可以生成一个 exe 程序，以后双击就能运行：\n\n在 PowerShell 里依次执行这两行（一行一行来）：\n\n```\npip install pyinstaller\n```\n\n```\npowershell -File scripts\\build.ps1\n```\n\n等它跑完后，在安装目录下的 `dist` 文件夹里会出现一个 **Smart Trade AI.exe**。你可以把它**拖到桌面上**，以后双击这个图标就能启动，不需要再打开 PowerShell。\n\n---\n\n### 安装中可能遇到的问题\n\n| 你看到的现象 | 可能的原因 | 怎么解决 |\n|------------|-----------|---------|\n| 输入 python 后提示「不是内部或外部命令」 | 安装 Python 时忘记勾选「Add Python to PATH」 | 回到第一步重新安装 Python，**一定要勾选那个框**。装完后关闭 PowerShell 重新打开再试 |\n| 安装到一半卡住不动了 | 你的网络访问 GitHub 不稳定 | 你需要开 **VPN**（就是翻墙工具），开到**全局模式**。开好之后关掉 PowerShell 重新打开，重新执行卡住的那行命令 |\n| 出现一大堆红色文字 | 大多是网络不好，没下载完整 | 把报错的那行命令重新复制执行一次。反复报错就确认 VPN 是否开好了 |\n| 浏览器打开显示「无法访问此网站」 | 程序没有在运行 | 回到 PowerShell 看看是不是关掉了或者报错了。如果关了就重新打开 PowerShell，重新执行 `python server.py` |\n| 页面打开了但是显示不正常、按钮点不动 | 浏览器缓存了旧版本的文件 | 同时按下键盘的 **Ctrl + Shift + R** 三个键，页面会强制刷新 |\n| 提示「Filename too long」 | 第四步的长路径设置没生效 | 确认第四步已经做过，并且**重启过电脑**。如果还没重启，先重启再来 |\n\n---\n\n## 苹果电脑（Mac）安装教程\n\n### 打开终端\n\nMac 上的操作窗口叫「**终端**」，和 Windows 的 PowerShell 类似。\n\n**怎么打开：** 在桌面右上角点**放大镜图标**（或者同时按 Command + 空格键），输入 `终端` 两个字，按回车，就打开了。\n\n### 一键安装\n\n在终端里复制粘贴下面这行命令，按回车：\n\n```\ncurl -fsSL https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.sh | bash\n```\n\n等它自动安装完，然后配置 AI：\n\n```\nhermes setup\n```\n\n按提示选择 DeepSeek，粘贴 API Key（和上面 Windows 第七步的操作一样）。\n\n最后启动：\n\n```\npython server.py\n```\n\n浏览器打开 **http://127.0.0.1:9119/trade** 。\n\n### 手动安装（一键脚本失败时用）\n\n在终端里依次执行以下每一行：\n\n```\ngit clone --branch main https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent\n```\n\n```\ncd ~/.hermes/hermes-agent && pip install -e \".\"\n```\n\n```\nhermes setup\n```\n\n```\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git ~/.trade/foreign-trade-assistant\n```\n\n```\ncd ~/.trade/foreign-trade-assistant && pip install -e \".\"\n```\n\n```\ninstall-trade-skills\n```\n\n```\npython server.py\n```\n\n> Mac 如果遇到下载超时，同样需要开 VPN 全局模式。\n\n---\n\n## 15 项专业能力\n\n| 场景 | 能力 |\n|------|------|\n| 平台诊断 | 分析阿里国际站 / 中国制造网产品页面，给出优化建议 |\n| 社媒营销 | 生成 Facebook / Instagram / TikTok / YouTube 内容日历 |\n| LinkedIn 运营 | 个人资料优化 + 内容策略 + 私信模板 |\n| 海关数据 | 分析进出口数据，帮你找到高价值采购商 |\n| 客户开发 | 根据目标市场和产品，自动生成开发信和跟进邮件 |\n| 客户管理 | A/B/C 重要度分级、客户详情、关联合同文件 |\n| 文档分析 | 上传 PDF / Word / Excel / PPT，AI 自动读取分析 |\n| 商务文档生成 | 一键生成报价单、形式发票、合同 |\n| 报价谈判 | 根据产品库和客户情况，给出谈判策略建议 |\n| 客户背调 | 6 层验证：邮箱检测 → WHOIS → 制裁名单 → 邮箱真实性 → 技术栈 → LinkedIn |\n| 每日简报 | 实时汇率 + 大宗商品行情 + 市场新闻 + 客户跟进提醒 |\n| 定时任务 | 工作日自动执行：早报、开发信、社媒发布、每日总结 |\n| 对话记录 | 按公司分开存储聊天记录，随时搜索回顾 |\n| 能力生成器 | 用大白话描述你的需求，自动创建新功能 |\n\n---\n\n## 你的数据安全吗？\n\n- **所有业务数据都存在你自己的电脑里**，不会上传到任何服务器\n- 如果你用的是云端 AI（比如 DeepSeek），对话内容会发给 AI 厂商处理，**但不会包含客户姓名等身份信息**\n- 如果你装 [Ollama](https://ollama.com) 用本地模型，连对话内容都不出你的电脑\n- 多公司之间数据互相隔离\n- 程序只允许你自己电脑上的浏览器访问，别人看不到\n\n---\n\n## 联系作者\n\n<div style=\"text-align:center;\">\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"200\" style=\"border-radius:8px;\">\n <p>扫码添加微信，备注「Trade」</p>\n <p>商务合作或技术支持：<a href=\"mailto:lauroge@gmail.com\">lauroge@gmail.com</a></p>\n</div>\n\n---\n\n<p style=\"text-align:center; color:#8b949e;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手 · 不需要懂技术<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n"}, "f339c076ffe446da57b8f05eb0a371af3b9992b1": {"t": 1785772995.7723382, "n": 8850, "h": "8e63698d4acb7f49", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">不需要懂技术，跟着步骤走，10 分钟装好</p>\n <a href=\"#windows-install\" class=\"btn\" style=\"margin:0.5rem;\">点我开始安装 →</a>\n</div>\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-2.png\" alt=\"Customer & Cron Panel\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>客户管理 + 定时任务面板</em></p>\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-1.png\" alt=\"AI Chat Interface\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>AI 对话界面 — 像聊天一样使用</em></p>\n</div>\n\n---\n\n## <a id=\"windows-install\"></a>Windows 电脑安装教程\n\n> 整个过程大约 10 分钟。你不需要懂任何电脑技术，只要会下载安装软件、会复制粘贴文字就行。\n\n---\n\n### 第一步：安装 Python（只需做一次）\n\n这个工具是用 Python 语言写的，你的电脑需要先装一个 Python 才能运行它。就像你要看 PDF 文件得先装一个 PDF 阅读器一样。\n\n**操作步骤：**\n\n1. 打开浏览器（就是上网用的那个程序），在地址栏输入 **python.org/downloads** 然后回车\n2. 页面会自动识别你是 Windows 电脑，点击页面上那个 **黄色的大按钮** 开始下载\n3. 下载完后，**双击**打开刚才下载的那个文件（一般在浏览器左下角能点开）\n4. 安装窗口打开后，**先看窗口最下面**——有一个小方框写着「**Add Python to PATH**」，**一定要打勾！** 这一步最容易忘记，忘了后面整个装不了\n5. 打勾之后，点击上面的「**Install Now**」按钮\n6. 等进度条跑完，出现「Setup was successful」就装好了，关掉安装窗口\n\n> 如果你以前已经装过 Python，这一步可以跳过。\n\n---\n\n### 第二步：打开 PowerShell\n\n接下来的安装步骤需要在 **PowerShell** 里操作。你可能在电视剧里见过黑客在黑屏幕上敲代码——PowerShell 就是那样的一个窗口。不过别紧张，你不需要自己写代码，只要**把我给你的命令复制进去、按回车就行**。\n\n**怎么找到 PowerShell：**\n\n1. 看你的键盘，**左下角有一个 Windows 图标的键**（四个方块组成的那个，叫 Win 键），按一下它\n2. 这时候屏幕上会弹出一个搜索框，**直接打字**输入：`powershell`\n3. 搜索结果里会出现一个图标是**蓝色**的、名字叫「**Windows PowerShell**」的程序，**点击它**\n4. 屏幕上会弹出一个**蓝色背景**（也可能是黑色背景）的窗口，里面有一些白色文字和一个闪烁的光标——这就是 PowerShell 了\n\n> **两个小提示：**\n> - 在 PowerShell 里**粘贴文字的方法**和平时不一样：不是按 Ctrl+V，而是**在窗口里点一下鼠标右键**，刚才复制的内容就会粘上去\n> - 下面出现的所有 `灰底文字`，都是你需要复制到 PowerShell 里执行的命令\n\n---\n\n### 第三步（推荐）：一键安装\n\nPython 装好之后，最省事的方法是用**一键安装脚本**——把下面这一行命令复制到 PowerShell 里执行，它会自动帮你装好所有东西：\n\n```\nirm https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.ps1 | iex\n```\n\n这个脚本会自动完成：安装 AI 引擎 → 安装 Smart Trade AI → 安装 15 个专业功能 → 初始化数据库 → 设置开机自启动。\n\n等它跑完后，继续往下看**第六步**获取 API Key 就行。\n\n> **如果一键脚本跑失败了**，不要紧，跟着下面的第四步和第五步手动装就行，效果一样。\n\n---\n\n### 第四步：开启长路径支持（只做一次，以前做过的跳过）\n\n> 如果你已经通过一键脚本安装成功，可以跳过第四步和第五步，直接看第六步。\n\nWindows 系统有一个默认设置，不允许文件路径太长。但这个工具安装时会产生比较长的路径，如果不改这个设置，后面安装会报错。我们只需要改一次，改完就不用管了。\n\n**操作步骤：**\n\nWindows 系统有一个默认设置，不允许文件路径太长。但这个工具安装时会产生比较长的路径，如果不改这个设置，后面安装会报错。我们只需要改一次，改完就不用管了。\n\n**操作步骤：**\n\n1. 按键盘上的 **Win 键**，输入 `powershell`\n2. 这一次不要直接点开，而是**用鼠标右键点击**搜索结果里的「Windows PowerShell」\n3. 在弹出的菜单里点「**以管理员身份运行**」\n4. 弹出一个提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n5. 这时打开的 PowerShell 窗口标题栏会写着「**管理员**」——说明你成功以管理员身份打开了\n6. 把下面这行命令**完整复制**（从 New 一直复制到 Force），在 PowerShell 窗口里**点右键粘贴**，然后**按回车**：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n7. 没有出现红色报错就说明成功了，**关掉这个管理员窗口**\n8. **重启电脑**让设置生效\n\n> 这一步一辈子只需要做一次。重启电脑后继续下一步。\n\n---\n\n### 第五步：安装 Hermes Agent\n\n这个工具背后需要一个叫 Hermes Agent 的程序来驱动 AI 功能。你可以把它理解为\"发动机\"——我们的工具是车身，得先有发动机才能跑。\n\n1. 打开 PowerShell（这次用**普通方式**打开就行，不需要管理员）\n2. 把下面这行命令**完整复制**，在 PowerShell 里**点右键粘贴**，按回车：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n3. 等待几分钟，它会自动下载和安装需要的文件\n4. 看到提示「安装完成」或「Installation complete」就说明好了\n\n> 如果等了很久都没反应或者报错了，多半是网络问题——参考页面底部的「常见问题」。\n\n---\n\n### 第六步：安装 Smart Trade AI\n\n发动机装好了，现在装车身。\n\n把下面 4 行命令**一行一行**地复制到 PowerShell 里执行。方法是：复制第一行 → 在 PowerShell 里右键粘贴 → 按回车 → 等它跑完 → 再复制第二行……以此类推。\n\n```\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n```\n\n```\ncd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n```\n\n```\npip install -e \".\"\n```\n\n```\ninstall-trade-skills\n```\n\n> 每一行都要等它跑完再执行下一行。如果中间某一行出现红色报错，不要慌，大多数是网络不好——重新复制那一行再执行一次。\n\n---\n\n### 第七步：获取 API Key\n\n这个工具需要连接 AI 大模型才能工作。AI 不是免费的，你需要去 AI 厂商那里注册一个账号、获取一个 **API Key**。\n\nAPI Key 是一串很长的字母和数字，就像一个密码，用来证明你有权限使用这个 AI 服务。\n\n**推荐用 DeepSeek（国产，便宜好用）：**\n\n1. 打开浏览器，访问 **platform.deepseek.com**\n2. 用手机号注册一个账号\n3. 登录之后，点页面上的「**充值**」，充 10 块钱就够了（按用量扣费，10 块钱能用很久）\n4. 在页面左侧找到「**API Keys**」，点进去，再点「**创建 API Key**」\n5. 页面上会显示一串字符——这就是你的 API Key。**立刻把它复制保存下来**（比如粘贴到记事本里），因为它只显示这一次，关了就看不到了\n\n拿到 API Key 之后，回到 PowerShell 窗口，输入下面这个命令然后回车：\n\n```\nhermes setup\n```\n\n这时会出现一个交互界面，操作方法：\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」，选中后**按回车**\n2. 它会问你要 API Key——把刚才保存的那串字符**右键粘贴**进去，按回车\n3. 看到「配置成功」之类的提示就完成了\n\n> 还建议顺手注册一个 [Tavily](https://tavily.com)（免费的，不用充值），它能让工具搜索实时信息。注册后同样在 `hermes setup` 里配置，选 Tavily 那一项，粘贴 Key。\n\n---\n\n### 第八步：启动！\n\n全部装好了，现在来运行它。在 PowerShell 里输入：\n\n```\npython server.py\n```\n\n按回车。等待几秒，看到窗口里出现 **「Uvicorn running on http://127.0.0.1:9119」** 这行字，就说明启动成功了。\n\n然后打开浏览器，在地址栏输入：**http://127.0.0.1:9119/trade** ，按回车，你就能看到界面了。\n\n> **以后每次要用的时侯：** 打开 PowerShell → 输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 回车 → 输入 `python server.py` 回车 → 打开浏览器访问上面的地址。**关掉 PowerShell 窗口，程序就会停止**，所以使用期间不要关那个窗口。\n\n---\n\n### 让电脑每次开机自动启动（可选）\n\n如果你不想每次都手动打开 PowerShell 输入命令，可以生成一个 exe 程序，以后双击就能运行：\n\n在 PowerShell 里依次执行这两行（一行一行来）：\n\n```\npip install pyinstaller\n```\n\n```\npowershell -File scripts\\build.ps1\n```\n\n等它跑完后，在安装目录下的 `dist` 文件夹里会出现一个 **Smart Trade AI.exe**。你可以把它**拖到桌面上**，以后双击这个图标就能启动，不需要再打开 PowerShell。\n\n---\n\n### 安装中可能遇到的问题\n\n| 你看到的现象 | 可能的原因 | 怎么解决 |\n|------------|-----------|---------|\n| 输入 python 后提示「不是内部或外部命令」 | 安装 Python 时忘记勾选「Add Python to PATH」 | 回到第一步重新安装 Python，**一定要勾选那个框**。装完后关闭 PowerShell 重新打开再试 |\n| 安装到一半卡住不动了 | 你的网络访问 GitHub 不稳定 | 你需要开 **VPN**（就是翻墙工具），开到**全局模式**。开好之后关掉 PowerShell 重新打开，重新执行卡住的那行命令 |\n| 出现一大堆红色文字 | 大多是网络不好，没下载完整 | 把报错的那行命令重新复制执行一次。反复报错就确认 VPN 是否开好了 |\n| 浏览器打开显示「无法访问此网站」 | 程序没有在运行 | 回到 PowerShell 看看是不是关掉了或者报错了。如果关了就重新打开 PowerShell，重新执行 `python server.py` |\n| 页面打开了但是显示不正常、按钮点不动 | 浏览器缓存了旧版本的文件 | 同时按下键盘的 **Ctrl + Shift + R** 三个键，页面会强制刷新 |\n| 提示「Filename too long」 | 第四步的长路径设置没生效 | 确认第四步已经做过，并且**重启过电脑**。如果还没重启，先重启再来 |\n\n---\n\n## 苹果电脑（Mac）安装教程\n\n### 打开终端\n\nMac 上的操作窗口叫「**终端**」，和 Windows 的 PowerShell 类似。\n\n**怎么打开：** 在桌面右上角点**放大镜图标**（或者同时按 Command + 空格键），输入 `终端` 两个字，按回车，就打开了。\n\n### 一键安装\n\n在终端里复制粘贴下面这行命令，按回车：\n\n```\ncurl -fsSL https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.sh | bash\n```\n\n等它自动安装完，然后配置 AI：\n\n```\nhermes setup\n```\n\n按提示选择 DeepSeek，粘贴 API Key（和上面 Windows 第七步的操作一样）。\n\n最后启动：\n\n```\npython server.py\n```\n\n浏览器打开 **http://127.0.0.1:9119/trade** 。\n\n### 手动安装（一键脚本失败时用）\n\n在终端里依次执行以下每一行：\n\n```\ngit clone --branch main https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent\n```\n\n```\ncd ~/.hermes/hermes-agent && pip install -e \".\"\n```\n\n```\nhermes setup\n```\n\n```\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git ~/.trade/foreign-trade-assistant\n```\n\n```\ncd ~/.trade/foreign-trade-assistant && pip install -e \".\"\n```\n\n```\ninstall-trade-skills\n```\n\n```\npython server.py\n```\n\n> Mac 如果遇到下载超时，同样需要开 VPN 全局模式。\n\n---\n\n## 15 项专业能力\n\n| 场景 | 能力 |\n|------|------|\n| 平台诊断 | 分析阿里国际站 / 中国制造网产品页面，给出优化建议 |\n| 社媒营销 | 生成 Facebook / Instagram / TikTok / YouTube 内容日历 |\n| LinkedIn 运营 | 个人资料优化 + 内容策略 + 私信模板 |\n| 海关数据 | 分析进出口数据，帮你找到高价值采购商 |\n| 客户开发 | 根据目标市场和产品，自动生成开发信和跟进邮件 |\n| 客户管理 | A/B/C 重要度分级、客户详情、关联合同文件 |\n| 文档分析 | 上传 PDF / Word / Excel / PPT，AI 自动读取分析 |\n| 商务文档生成 | 一键生成报价单、形式发票、合同 |\n| 报价谈判 | 根据产品库和客户情况，给出谈判策略建议 |\n| 客户背调 | 6 层验证：邮箱检测 → WHOIS → 制裁名单 → 邮箱真实性 → 技术栈 → LinkedIn |\n| 每日简报 | 实时汇率 + 大宗商品行情 + 市场新闻 + 客户跟进提醒 |\n| 定时任务 | 工作日自动执行：早报、开发信、社媒发布、每日总结 |\n| 对话记录 | 按公司分开存储聊天记录，随时搜索回顾 |\n| 能力生成器 | 用大白话描述你的需求，自动创建新功能 |\n\n---\n\n## 你的数据安全吗？\n\n- **所有业务数据都存在你自己的电脑里**，不会上传到任何服务器\n- 如果你用的是云端 AI（比如 DeepSeek），对话内容会发给 AI 厂商处理，**但不会包含客户姓名等身份信息**\n- 如果你装 [Ollama](https://ollama.com) 用本地模型，连对话内容都不出你的电脑\n- 多公司之间数据互相隔离\n- 程序只允许你自己电脑上的浏览器访问，别人看不到\n\n---\n\n## 联系作者\n\n<div style=\"text-align:center;\">\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"200\" style=\"border-radius:8px;\">\n <p>扫码添加微信，备注「Trade」</p>\n <p>商务合作或技术支持：<a href=\"mailto:lauroge@gmail.com\">lauroge@gmail.com</a></p>\n</div>\n\n---\n\n<p style=\"text-align:center; color:#8b949e;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手 · 不需要懂技术<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n"}, "67f159c5373f6f5987d5b40c188bbee1baf91149": {"t": 1785772997.4232094, "n": 8364, "h": "6f5d49c366b14cd3", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">不需要懂技术，跟着步骤走，10 分钟装好</p>\n <a href=\"#windows-install\" class=\"btn\" style=\"margin:0.5rem;\">点我开始安装 →</a>\n</div>\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-2.png\" alt=\"Customer & Cron Panel\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>客户管理 + 定时任务面板</em></p>\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-1.png\" alt=\"AI Chat Interface\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>AI 对话界面 — 像聊天一样使用</em></p>\n</div>\n\n---\n\n## <a id=\"windows-install\"></a>Windows 电脑安装教程\n\n> 整个过程大约 10 分钟。你不需要懂任何电脑技术，只要会下载安装软件、会复制粘贴文字就行。\n\n---\n\n### 第一步：安装 Python（只需做一次）\n\n这个工具是用 Python 语言写的，你的电脑需要先装一个 Python 才能运行它。就像你要看 PDF 文件得先装一个 PDF 阅读器一样。\n\n**操作步骤：**\n\n1. 打开浏览器（就是上网用的那个程序），在地址栏输入 **python.org/downloads** 然后回车\n2. 页面会自动识别你是 Windows 电脑，点击页面上那个 **黄色的大按钮** 开始下载\n3. 下载完后，**双击**打开刚才下载的那个文件（一般在浏览器左下角能点开）\n4. 安装窗口打开后，**先看窗口最下面**——有一个小方框写着「**Add Python to PATH**」，**一定要打勾！** 这一步最容易忘记，忘了后面整个装不了\n5. 打勾之后，点击上面的「**Install Now**」按钮\n6. 等进度条跑完，出现「Setup was successful」就装好了，关掉安装窗口\n\n> 如果你以前已经装过 Python，这一步可以跳过。\n\n---\n\n### 第二步：打开 PowerShell\n\n接下来的安装步骤需要在 **PowerShell** 里操作。你可能在电视剧里见过黑客在黑屏幕上敲代码——PowerShell 就是那样的一个窗口。不过别紧张，你不需要自己写代码，只要**把我给你的命令复制进去、按回车就行**。\n\n**怎么找到 PowerShell：**\n\n1. 看你的键盘，**左下角有一个 Windows 图标的键**（四个方块组成的那个，叫 Win 键），按一下它\n2. 这时候屏幕上会弹出一个搜索框，**直接打字**输入：`powershell`\n3. 搜索结果里会出现一个图标是**蓝色**的、名字叫「**Windows PowerShell**」的程序，**点击它**\n4. 屏幕上会弹出一个**蓝色背景**（也可能是黑色背景）的窗口，里面有一些白色文字和一个闪烁的光标——这就是 PowerShell 了\n\n> **两个小提示：**\n> - 在 PowerShell 里**粘贴文字的方法**和平时不一样：不是按 Ctrl+V，而是**在窗口里点一下鼠标右键**，刚才复制的内容就会粘上去\n> - 下面出现的所有 `灰底文字`，都是你需要复制到 PowerShell 里执行的命令\n\n---\n\n### 第三步：开启长路径支持（只做一次，以前做过的跳过）\n\nWindows 系统有一个默认设置，不允许文件路径太长。但这个工具安装时会产生比较长的路径，如果不改这个设置，后面安装会报错。我们只需要改一次，改完就不用管了。\n\n**操作步骤：**\n\n1. 按键盘上的 **Win 键**，输入 `powershell`\n2. 这一次不要直接点开，而是**用鼠标右键点击**搜索结果里的「Windows PowerShell」\n3. 在弹出的菜单里点「**以管理员身份运行**」\n4. 弹出一个提示问\"是否允许此应用对设备进行更改\"，点「**是**」\n5. 这时打开的 PowerShell 窗口标题栏会写着「**管理员**」——说明你成功以管理员身份打开了\n6. 把下面这行命令**完整复制**（从 New 一直复制到 Force），在 PowerShell 窗口里**点右键粘贴**，然后**按回车**：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n7. 没有出现红色报错就说明成功了，**关掉这个管理员窗口**\n8. **重启电脑**让设置生效\n\n> 这一步一辈子只需要做一次。重启电脑后继续下一步。\n\n---\n\n### 第四步：安装 Hermes Agent\n\n这个工具背后需要一个叫 Hermes Agent 的程序来驱动 AI 功能。你可以把它理解为\"发动机\"——我们的工具是车身，得先有发动机才能跑。\n\n1. 打开 PowerShell（这次用**普通方式**打开就行，不需要管理员）\n2. 把下面这行命令**完整复制**，在 PowerShell 里**点右键粘贴**，按回车：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n3. 等待几分钟，它会自动下载和安装需要的文件\n4. 看到提示「安装完成」或「Installation complete」就说明好了\n\n> 如果等了很久都没反应或者报错了，多半是网络问题——参考页面底部的「常见问题」。\n\n---\n\n### 第五步：安装 Smart Trade AI\n\n发动机装好了，现在装车身。\n\n把下面 4 行命令**一行一行**地复制到 PowerShell 里执行。方法是：复制第一行 → 在 PowerShell 里右键粘贴 → 按回车 → 等它跑完 → 再复制第二行……以此类推。\n\n```\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n```\n\n```\ncd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n```\n\n```\npip install -e \".\"\n```\n\n```\ninstall-trade-skills\n```\n\n> 每一行都要等它跑完再执行下一行。如果中间某一行出现红色报错，不要慌，大多数是网络不好——重新复制那一行再执行一次。\n\n---\n\n### 第六步：获取 API Key\n\n这个工具需要连接 AI 大模型才能工作。AI 不是免费的，你需要去 AI 厂商那里注册一个账号、获取一个 **API Key**。\n\nAPI Key 是一串很长的字母和数字，就像一个密码，用来证明你有权限使用这个 AI 服务。\n\n**推荐用 DeepSeek（国产，便宜好用）：**\n\n1. 打开浏览器，访问 **platform.deepseek.com**\n2. 用手机号注册一个账号\n3. 登录之后，点页面上的「**充值**」，充 10 块钱就够了（按用量扣费，10 块钱能用很久）\n4. 在页面左侧找到「**API Keys**」，点进去，再点「**创建 API Key**」\n5. 页面上会显示一串字符——这就是你的 API Key。**立刻把它复制保存下来**（比如粘贴到记事本里），因为它只显示这一次，关了就看不到了\n\n拿到 API Key 之后，回到 PowerShell 窗口，输入下面这个命令然后回车：\n\n```\nhermes setup\n```\n\n这时会出现一个交互界面，操作方法：\n1. 用键盘的 **上下方向键** 选择「**DeepSeek**」，选中后**按回车**\n2. 它会问你要 API Key——把刚才保存的那串字符**右键粘贴**进去，按回车\n3. 看到「配置成功」之类的提示就完成了\n\n> 还建议顺手注册一个 [Tavily](https://tavily.com)（免费的，不用充值），它能让工具搜索实时信息。注册后同样在 `hermes setup` 里配置，选 Tavily 那一项，粘贴 Key。\n\n---\n\n### 第七步：启动！\n\n全部装好了，现在来运行它。在 PowerShell 里输入：\n\n```\npython server.py\n```\n\n按回车。等待几秒，看到窗口里出现 **「Uvicorn running on http://127.0.0.1:9119」** 这行字，就说明启动成功了。\n\n然后打开浏览器，在地址栏输入：**http://127.0.0.1:9119/trade** ，按回车，你就能看到界面了。\n\n> **以后每次要用的时侯：** 打开 PowerShell → 输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant` 回车 → 输入 `python server.py` 回车 → 打开浏览器访问上面的地址。**关掉 PowerShell 窗口，程序就会停止**，所以使用期间不要关那个窗口。\n\n---\n\n### 让电脑每次开机自动启动（可选）\n\n如果你不想每次都手动打开 PowerShell 输入命令，可以生成一个 exe 程序，以后双击就能运行：\n\n在 PowerShell 里依次执行这两行（一行一行来）：\n\n```\npip install pyinstaller\n```\n\n```\npowershell -File scripts\\build.ps1\n```\n\n等它跑完后，在安装目录下的 `dist` 文件夹里会出现一个 **Smart Trade AI.exe**。你可以把它**拖到桌面上**，以后双击这个图标就能启动，不需要再打开 PowerShell。\n\n---\n\n### 安装中可能遇到的问题\n\n| 你看到的现象 | 可能的原因 | 怎么解决 |\n|------------|-----------|---------|\n| 输入 python 后提示「不是内部或外部命令」 | 安装 Python 时忘记勾选「Add Python to PATH」 | 回到第一步重新安装 Python，**一定要勾选那个框**。装完后关闭 PowerShell 重新打开再试 |\n| 安装到一半卡住不动了 | 你的网络访问 GitHub 不稳定 | 你需要开 **VPN**（就是翻墙工具），开到**全局模式**。开好之后关掉 PowerShell 重新打开，重新执行卡住的那行命令 |\n| 出现一大堆红色文字 | 大多是网络不好，没下载完整 | 把报错的那行命令重新复制执行一次。反复报错就确认 VPN 是否开好了 |\n| 浏览器打开显示「无法访问此网站」 | 程序没有在运行 | 回到 PowerShell 看看是不是关掉了或者报错了。如果关了就重新打开 PowerShell，重新执行 `python server.py` |\n| 页面打开了但是显示不正常、按钮点不动 | 浏览器缓存了旧版本的文件 | 同时按下键盘的 **Ctrl + Shift + R** 三个键，页面会强制刷新 |\n| 提示「Filename too long」 | 第三步的长路径设置没生效 | 确认第三步已经做过，并且**重启过电脑**。如果还没重启，先重启再来 |\n\n---\n\n## 苹果电脑（Mac）安装教程\n\n### 打开终端\n\nMac 上的操作窗口叫「**终端**」，和 Windows 的 PowerShell 类似。\n\n**怎么打开：** 在桌面右上角点**放大镜图标**（或者同时按 Command + 空格键），输入 `终端` 两个字，按回车，就打开了。\n\n### 一键安装\n\n在终端里复制粘贴下面这行命令，按回车：\n\n```\ncurl -fsSL https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.sh | bash\n```\n\n等它自动安装完，然后配置 AI：\n\n```\nhermes setup\n```\n\n按提示选择 DeepSeek，粘贴 API Key（和上面 Windows 第六步的操作一样）。\n\n最后启动：\n\n```\npython server.py\n```\n\n浏览器打开 **http://127.0.0.1:9119/trade** 。\n\n### 手动安装（一键脚本失败时用）\n\n在终端里依次执行以下每一行：\n\n```\ngit clone --branch main https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent\n```\n\n```\ncd ~/.hermes/hermes-agent && pip install -e \".\"\n```\n\n```\nhermes setup\n```\n\n```\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git ~/.trade/foreign-trade-assistant\n```\n\n```\ncd ~/.trade/foreign-trade-assistant && pip install -e \".\"\n```\n\n```\ninstall-trade-skills\n```\n\n```\npython server.py\n```\n\n> Mac 如果遇到下载超时，同样需要开 VPN 全局模式。\n\n---\n\n## 15 项专业能力\n\n| 场景 | 能力 |\n|------|------|\n| 平台诊断 | 分析阿里国际站 / 中国制造网产品页面，给出优化建议 |\n| 社媒营销 | 生成 Facebook / Instagram / TikTok / YouTube 内容日历 |\n| LinkedIn 运营 | 个人资料优化 + 内容策略 + 私信模板 |\n| 海关数据 | 分析进出口数据，帮你找到高价值采购商 |\n| 客户开发 | 根据目标市场和产品，自动生成开发信和跟进邮件 |\n| 客户管理 | A/B/C 重要度分级、客户详情、关联合同文件 |\n| 文档分析 | 上传 PDF / Word / Excel / PPT，AI 自动读取分析 |\n| 商务文档生成 | 一键生成报价单、形式发票、合同 |\n| 报价谈判 | 根据产品库和客户情况，给出谈判策略建议 |\n| 客户背调 | 6 层验证：邮箱检测 → WHOIS → 制裁名单 → 邮箱真实性 → 技术栈 → LinkedIn |\n| 每日简报 | 实时汇率 + 大宗商品行情 + 市场新闻 + 客户跟进提醒 |\n| 定时任务 | 工作日自动执行：早报、开发信、社媒发布、每日总结 |\n| 对话记录 | 按公司分开存储聊天记录，随时搜索回顾 |\n| 能力生成器 | 用大白话描述你的需求，自动创建新功能 |\n\n---\n\n## 你的数据安全吗？\n\n- **所有业务数据都存在你自己的电脑里**，不会上传到任何服务器\n- 如果你用的是云端 AI（比如 DeepSeek），对话内容会发给 AI 厂商处理，**但不会包含客户姓名等身份信息**\n- 如果你装 [Ollama](https://ollama.com) 用本地模型，连对话内容都不出你的电脑\n- 多公司之间数据互相隔离\n- 程序只允许你自己电脑上的浏览器访问，别人看不到\n\n---\n\n## 联系作者\n\n<div style=\"text-align:center;\">\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"200\" style=\"border-radius:8px;\">\n <p>扫码添加微信，备注「Trade」</p>\n <p>商务合作或技术支持：<a href=\"mailto:lauroge@gmail.com\">lauroge@gmail.com</a></p>\n</div>\n\n---\n\n<p style=\"text-align:center; color:#8b949e;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手 · 不需要懂技术<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n"}, "05d46d62de789cd81f2d219594f12c6decab3ac0": {"t": 1785772998.99972, "n": 7184, "h": "7ce71760951132e0", "c": "---\nlayout: default\n---\n\n<style>\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">不需要懂技术，跟着步骤走，10 分钟装好</p>\n <a href=\"#windows-install\" class=\"btn\" style=\"margin:0.5rem;\">点我开始安装 →</a>\n</div>\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-2.png\" alt=\"Customer & Cron Panel\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>客户管理 + 定时任务面板</em></p>\n</div>\n\n---\n\n## 这个工具能帮你做什么？\n\n| 你平时的麻烦 | 用了这个工具之后 |\n|-------------|----------------|\n| 每天打开好几个网站查汇率、金价、新闻 | 每天早上自动生成一份简报，汇率、行情、客户提醒全在里面 |\n| 想了解一个新客户靠不靠谱，不知道从哪查 | 输入邮箱或公司名，自动帮你查域名、制裁名单、LinkedIn 等 6 项 |\n| 给客户写开发信，每封都要重新想 | 告诉它客户是做什么的，它帮你写好开发信 |\n| 阿里国际站、中国制造网要每天登录看有没有新询盘 | 它定时帮你检查，有新的就提醒你 |\n| 客户资料散落在微信、Excel、邮件里，找起来费劲 | 统一管理，按重要程度分 A/B/C 级，还能关联合同文件 |\n| 不知道 LinkedIn 该发什么内容 | 每周帮你规划好要发什么，轮换不同话题 |\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-1.png\" alt=\"AI Chat Interface\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>AI 对话界面 — 像聊天一样使用</em></p>\n</div>\n\n---\n\n## <a id=\"windows-install\"></a>Windows 电脑安装教程\n\n> 如果你是 Windows 电脑，看这一节就够了。整个过程大约 10 分钟，不需要任何电脑知识，跟着做就行。\n\n### 第一步：安装 Python（只需做一次）\n\n这个工具是用 Python 语言写的，所以你的电脑需要能\"读懂\" Python。就像要看 PDF 需要装 Adobe Reader 一样，要运行这个工具需要装 Python。\n\n**怎么装：**\n\n1. 打开浏览器，访问 [python.org](https://www.python.org/downloads/)\n2. 页面会自动识别你是 Windows，点击黄色的大按钮下载\n3. 下载完成后，双击打开安装文件\n4. **重要：第一个界面底部有一个勾选框「Add Python to PATH」，一定要打勾！**（不打勾的话后面没法用）\n5. 打勾后，点击「Install Now」按钮\n6. 等待进度条跑完，显示「Setup was successful」就装好了\n\n> 如果已经装过 Python，可以跳过这一步。\n\n### 第二步：打开 PowerShell\n\n接下来的安装操作都在一个叫 **PowerShell** 的窗口里进行。它是 Windows 自带的，不用额外安装，就是一个输入文字然后电脑帮你干活的东西。你不用理解它，**只需要把命令复制进去，按回车就行**。\n\n**怎么打开：**\n\n1. 按键盘上的 **Win 键**（键盘左下角，四个方块那个图标），然后直接打字：`powershell`\n2. 搜索结果里会出现一个蓝色图标的「Windows PowerShell」，点它打开\n3. 你会看到一个**蓝底白字**（或黑底白字）的窗口，这就是 PowerShell\n\n> 下文所有灰底绿字的内容，都是你需要**完整复制**到 PowerShell 窗口里、然后**按回车**执行的命令。在 PowerShell 里粘贴是**点右键**（不是 Ctrl+V）。\n\n### 第三步：开启长路径支持（只做一次，做过的跳过）\n\nWindows 默认不允许文件路径太长，但这个工具的文件路径比较长，需要提前放开限制。\n\n1. 按 **Win 键**，输入 `powershell`\n2. 搜索结果里，**右键点击**「Windows PowerShell」，选择「**以管理员身份运行**」\n3. 在弹出的确认框点「是」\n4. 把下面这行命令**完整复制**，在 PowerShell 窗口里**右键粘贴**，按回车：\n\n```\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n5. 看到执行完没有报错就 OK 了\n6. **重启电脑**让设置生效\n\n> 这一步只需要做一次，以后永远不用再管。\n\n### 第四步：安装 Hermes Agent（底层 AI 引擎）\n\n这个工具依赖一个叫 Hermes Agent 的基础程序。Hermes Agent 就像是汽车的发动机，我们的工具是车身——得先有发动机才行。\n\n把下面这行命令**完整复制**到 PowerShell 窗口，按回车：\n\n```\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n```\n\n> 安装过程中会下载一些文件，需要几分钟。看到「安装完成」或「Installation complete」就说明好了。\n\n### 第五步：安装 Smart Trade AI\n\n发动机有了，现在装车身。\n\n把下面这 4 行命令**一行一行**地复制到 PowerShell、按回车。等每一行跑完（光标重新闪烁）再复制下一行：\n\n```\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n\ncd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\n\npip install -e \".\"\n\ninstall-trade-skills\n```\n\n> 如果中间出现红色的报错文字，不要慌。大多数情况是网络不好没下载完整。把报错的那行重新复制执行一次就行。\n\n### 第六步：获取 API Key\n\n这个工具靠 AI 大模型来回答问题，你需要去模型厂商那里注册一个账号，获取一串 **API Key**（可以理解为一串密码，用来证明你有权限使用这个 AI）。\n\n**推荐用 DeepSeek，目前性价比最高：**\n\n1. 打开浏览器，访问 [platform.deepseek.com](https://platform.deepseek.com)\n2. 用手机号注册账号\n3. 登录后点「充值」，充个 10 块钱就够用很久了\n4. 在左侧菜单找到「API Keys」，点「创建 API Key」\n5. 把生成的那串字符**复制保存好**（只显示一次，关了就看不到了）\n\n拿到了 API Key 之后，回到 PowerShell 窗口，输入：\n\n```\nhermes setup\n```\n\n会出来一个选择界面，用键盘上下箭头选 DeepSeek，回车。把刚才复制的 API Key **右键粘贴**进去，回车。\n\n> 还建议顺便注册 [Tavily](https://tavily.com)（免费，不用充值），用于搜索客户信息。同样在 `hermes setup` 里配置。\n\n### 第七步：启动！\n\n一切都准备好了。在PowerShell 窗口输入：\n\n```\npython server.py\n```\n\n回车后看到「Uvicorn running on http://127.0.0.1:9119」就说明启动成功了。\n\n打开浏览器，在地址栏输入 **http://127.0.0.1:9119/trade**，回车，你就能看到界面了。\n\n> 每次想用的时候，都要先打开 PowerShell，输入 `cd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant`，回车；再输入 `python server.py`，回车。然后打开浏览器访问上面那个地址。关掉 PowerShell 窗口，程序就停了。\n\n### 让电脑每次开机自动启动（可选）\n\n如果你不想每次手动打开，可以在安装完成后，输入下面两行命令（一行一行执行）：\n\n```\npip install pyinstaller\n\npowershell -File scripts/build.ps1\n```\n\n完成后会在 `dist` 文件夹里生成一个 `Smart Trade AI.exe`，双击就能运行，不需要打开 PowerShell。可以把它拖到桌面。\n\n### 安装中可能遇到的问题\n\n| 你看到的 | 是什么意思 | 怎么办 |\n|---------|-----------|--------|\n| \"不是内部或外部命令\" | 说明 Python 没装好，或者装的时候没勾那个勾 | 回到第一步重新装 Python，**一定要勾选 Add Python to PATH** |\n| 下载到一半卡住了 | 网络访问 GitHub 不稳定 | 你需要开 VPN（翻墙工具）的全局模式。如果不会用 VPN，可以找身边懂电脑的朋友帮忙。开了 VPN 后重试出错的命令 |\n| 红色报错一大堆 | 通常是网络问题导致没下载完整 | 把报错那行命令重新执行一次。如果反复失败，确保 VPN 开着 |\n| 打开网页显示「无法访问」 | 程序没启动成功 | 回到 PowerShell 窗口看看有没有报错。如果关了，重新打开 PowerShell，重新执行第七步 |\n| 页面显示乱掉或按钮点不动 | 浏览器缓存了旧文件 | 按键盘上的 **Ctrl + Shift + R** 三个键一起按，强制刷新页面 |\n\n---\n\n## 苹果电脑（Mac）安装教程\n\n### 第一步：打开\"终端\"\n\nMac 上的命令行叫「终端」。\n\n在桌面右上角点放大镜图标（Spotlight），输入 `终端`，回车打开。\n\n### 第二步：一键安装\n\n把下面这行命令复制到终端窗口，按回车：\n\n```\ncurl -fsSL https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.sh | bash\n```\n\n脚本自动完成所有安装。看到安装完成的提示后，执行：\n\n```\nhermes setup\n```\n\n按提示选择模型厂商、填入 API Key（和上面 Windows 第六步一样）。\n\n然后启动：\n\n```\npython server.py\n```\n\n浏览器打开 http://127.0.0.1:9119/trade 。\n\n### 手动安装（如果一键脚本失败）\n\n把下面每一行依次复制到终端执行：\n\n```\ngit clone --branch main https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent\n\ncd ~/.hermes/hermes-agent && pip install -e \".\"\n\nhermes setup\n\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git ~/.trade/foreign-trade-assistant\n\ncd ~/.trade/foreign-trade-assistant && pip install -e \".\"\n\ninstall-trade-skills\n\npython server.py\n```\n\n> Mac 用户如果遇到 `git clone` 超时，同样需要开 VPN 全局模式。\n\n---\n\n## 15 项专业能力\n\n| 场景 | 能力 |\n|------|------|\n| 平台诊断 | 分析阿里国际站 / 中国制造网产品页面，给出优化建议 |\n| 社媒营销 | 生成 Facebook / Instagram / TikTok / YouTube 内容日历 |\n| LinkedIn 运营 | 个人资料优化 + 内容策略 + 私信模板 |\n| 海关数据 | 分析进出口数据，帮你找到高价值采购商 |\n| 客户开发 | 根据目标市场和产品，自动生成开发信和跟进邮件 |\n| 客户管理 | A/B/C 重要度分级、客户详情、关联合同文件 |\n| 文档分析 | 上传 PDF / Word / Excel / PPT，AI 自动读取分析 |\n| 商务文档生成 | 一键生成报价单、形式发票、合同 |\n| 报价谈判 | 根据产品库和客户情况，给出谈判策略建议 |\n| 客户背调 | 6 层验证：邮箱检测 → WHOIS → 制裁名单 → 邮箱真实性 → 技术栈 → LinkedIn |\n| 每日简报 | 实时汇率 + 大宗商品行情 + 市场新闻 + 客户跟进提醒 |\n| 定时任务 | 工作日自动执行：早报、开发信、社媒发布、每日总结 |\n| 对话记录 | 按公司分开存储聊天记录，随时搜索回顾 |\n| 能力生成器 | 用大白话描述你的需求，自动创建新功能 |\n\n---\n\n## 你的数据安全吗？\n\n- **所有业务数据都存在你自己的电脑里**，不会上传到任何服务器\n- 如果你用的是云端 AI（比如 DeepSeek），对话内容会发给 AI 厂商处理，**但不会包含客户姓名等身份信息**\n- 如果你装 [Ollama](https://ollama.com) 用本地模型，连对话内容都不出你的电脑\n- 多公司之间数据互相隔离\n- 程序只允许你自己电脑上的浏览器访问，别人看不到\n\n---\n\n## 联系作者\n\n<div style=\"text-align:center;\">\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"200\" style=\"border-radius:8px;\">\n <p>扫码添加微信，备注「Trade」</p>\n <p>商务合作或技术支持：<a href=\"mailto:lauroge@gmail.com\">lauroge@gmail.com</a></p>\n</div>\n\n---\n\n<p style=\"text-align:center; color:#8b949e;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手 · 不需要懂技术<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a>\n</p>\n"}, "67016070f0f01aaf7c8d537eee39f5528cf304f9": {"t": 1785773000.3188345, "n": 7474, "h": "d1b7aa95e6a26135", "c": "---\nlayout: default\n---\n\n<style>\n /* 全宽布局：覆盖 slate 主题的窄容器限制 */\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre-wrap !important; word-break: break-all !important; }\n pre { padding: 1rem !important; font-size: 0.9rem !important; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">在本地运行，数据留在自己电脑里</p>\n <a href=\"https://github.com/chefroger/smart-trade-ai\" class=\"btn btn-primary\" style=\"margin:0.5rem;\">View on GitHub</a>\n <a href=\"#windows-install\" class=\"btn\" style=\"margin:0.5rem;\">Windows 安装 →</a>\n</div>\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-2.png\" alt=\"Customer & Cron Panel\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>客户管理 + 定时任务面板</em></p>\n</div>\n\n---\n\n## 为什么外贸人需要这个？\n\n| 痛点 | 不用这个工具 | 用了之后 |\n|------|-------------|---------|\n| 早安简报 | 每天打开 5 个网站查汇率/金价/新闻 | 自动生成，含实时汇率+大宗商品行情+客户跟进提醒 |\n| 客户背调 | 手动 Google → LinkedIn → WHOIS | 一键 6 层验证：邮箱注册检测→WHOIS→制裁名单→邮箱验证→技术栈→LinkedIn |\n| 开发信 | 每封手动写，客户多了记不清 | 根据客户画像自动生成，带具体痛点引用 |\n| B2B 平台 | 每天登录阿里国际站/中国制造网看数据 | 定时自动检查，新询盘/待跟进报价一目了然 |\n| LinkedIn | 不知道发什么内容 | AI 按周生成内容日历，轮换行业洞察/产品案例/互动提问 |\n| 客户资料 | 散落在 Excel/微信/邮件里 | 统一管理，A/B/C 分级，关联文档库 |\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-1.png\" alt=\"AI Chat Interface\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>AI 对话界面 — 自动调用 web_search / read_file / database 工具</em></p>\n</div>\n\n---\n\n## <a id=\"windows-install\"></a>Windows 安装指南\n\n> Windows 是最常见的使用平台，以下提供 3 种安装方式，按难度从低到高排列。\n\n### 方式一：一键安装脚本（推荐）\n\n只需提前安装 Python，其余全自动。\n\n**Step 0 — 安装 Python**\n\n从 [python.org](https://www.python.org/downloads/) 下载 **Python 3.11 ~ 3.13 Windows installer (64-bit)**。\n\n> **必须勾选「Add Python to PATH」**，否则后续命令找不到 python。\n\n安装完成后，**重新打开 PowerShell**，验证：\n\n```powershell\npython --version\n# 应显示 Python 3.11.x 或更高\n```\n\n**Step 1 — 启用长路径支持（以管理员身份运行 PowerShell，仅需一次）**\n\n```powershell\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n> 执行后**需重启电脑**。不开启的话，后续 `pip install` 可能报 `Filename too long` 错误。\n\n**Step 2 — 下载并运行安装脚本**\n\n```powershell\nirm https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.ps1 | iex\n```\n\n脚本自动完成：Python 检查 → 创建 venv → 安装 Hermes Agent → 安装 Trade → 15 个 skills → 数据库初始化 → 注册 `trade` 命令 → 设置开机自启动。\n\n安装完成后，启动方式：\n\n```powershell\ntrade # 新终端直接运行\n# 或\npython server.py # 在安装目录下\n```\n\n浏览器自动打开 http://127.0.0.1:9119/trade 。开机也会自动后台启动。\n\n> **如果脚本执行报错**，可能是网络问题（GitHub 访问不稳定）。参考下方「网络注意事项」。\n\n### 方式二：逐步手动安装\n\n适合想控制每一步的用户，或者一键脚本失败后排查问题。\n\n**前置条件**：Python >= 3.11（已加入 PATH）· 网络能访问 GitHub\n\n```powershell\n# 0. 启用长路径支持（管理员 PowerShell，仅需一次，执行后重启电脑）\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n\n# 1. 安装 Hermes Agent（AI 引擎，自动处理 Node.js + Git + 依赖）\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n\n# 2. 配置 LLM API Key\nhermes setup\n# 按提示选择 provider（推荐 DeepSeek），粘贴 API Key\n\n# 3. 安装 Smart Trade AI\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\ncd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\npip install -e \".\"\ninstall-trade-skills\n\n# 4. 启动\npython server.py\n# → 浏览器打开 http://127.0.0.1:9119/trade\n```\n\n> 如果第 3 步 `pip install` 报 `Filename too long`，说明长路径未生效，请确认第 0 步已完成并重启电脑。\n\n### 方式三：打包为独立 EXE（双击运行，无需终端）\n\n适合不想用终端的用户，或需要分发给同事。\n\n```powershell\npip install pyinstaller\npowershell -File scripts/build.ps1\n# 生成 dist/Smart Trade AI.exe\n```\n\n双击 EXE 即可运行，无需 Python 环境。\n\n### LLM API Key 配置\n\nSmart Trade AI 需要 LLM API Key 才能工作。推荐方案：\n\n| 方案 | 模型 | 适合场景 | 注册地址 |\n|------|------|---------|---------|\n| **推荐** | DeepSeek V4 Flash | 日常对话、文档分析、开发信 | [platform.deepseek.com](https://platform.deepseek.com) → 充值 → API Keys |\n\n注册后获取 Key，运行 `hermes setup`，选择对应 provider 并填入即可。\n\n> 还建议注册 [Tavily](https://tavily.com)（免费，每月 1000 次搜索），用于客户背调和实时信息检索。同样通过 `hermes setup` 配置。\n\n### 网络注意事项\n\n安装过程需要从 GitHub 克隆仓库并下载 Python 依赖。**境内用户请注意**：\n\n- **建议全程开启 VPN（全局模式）**，否则 `git clone` 和 `pip install` 容易超时\n- 如果 VPN 不稳定，可以多次重试安装命令，脚本支持断点续装\n- VPN 代理未生效时，在 PowerShell 中手动设置：\n ```powershell\n $env:HTTPS_PROXY = \"http://127.0.0.1:你的代理端口\"\n ```\n\n### 常见问题\n\n| 问题 | 解决方案 |\n|------|---------|\n| `python` 命令找不到 | 重新安装 Python，勾选「Add Python to PATH」，然后重新打开 PowerShell |\n| `Filename too long` | 以管理员 PowerShell 执行长路径注册命令（见 Step 1），然后重启电脑 |\n| `git clone` 超时 | 开启 VPN 全局模式；或设置 `$env:HTTPS_PROXY` |\n| `pip install` 报红字 | 通常是网络问题，重试即可；确认 VPN 正常 |\n| 升级后页面样式异常 | 按 `Ctrl+Shift+R` 强制刷新浏览器缓存 |\n\n---\n\n## macOS / Linux 安装\n\n### 一键脚本\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.sh | bash\n```\n\n> 审查后执行：\n> ```bash\n> curl -fsSLO https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.sh\n> less install.sh && bash install.sh\n> ```\n\n### 手动安装\n\n```bash\n# 1. 安装 Hermes Agent\ngit clone --branch main https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent\ncd ~/.hermes/hermes-agent && pip install -e \".\"\n\n# 2. 配置 LLM\nhermes setup\n\n# 3. 安装 Smart Trade AI\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git ~/.trade/foreign-trade-assistant\ncd ~/.trade/foreign-trade-assistant && pip install -e \".\"\n\n# 4. 启动\ninstall-trade-skills\npython server.py\n# → 浏览器打开 http://127.0.0.1:9119/trade\n```\n\n---\n\n## 15 项专业能力\n\n| 场景 | 能力 |\n|------|------|\n| 平台诊断 | 分析阿里国际站/中国制造网产品页面，输出优化建议 |\n| 社媒营销 | 生成 Facebook/Instagram/TikTok/YouTube 内容日历 |\n| LinkedIn 运营 | Profile 优化 + 内容策略 + InMail 模板 |\n| 海关数据 | 分析进出口数据，筛选高价值采购商 |\n| 客户开发 | 根据目标市场+产品生成开发信和跟进序列 |\n| 客户管理 | A/B/C 分级、详情面板、文档库关联 |\n| 文档分析 | 读取本地 PDF/Word/Excel/PPT，AI 自动解析 |\n| 商务文档生成 | 一键生成报价单、PI、合同（DOCX/XLSX/PPTX） |\n| 报价谈判 | 基于产品知识库和客户画像给出谈判策略 |\n| 客户背调 | 6 层验证：邮箱→WHOIS→制裁→邮箱验证→技术栈→LinkedIn |\n| 每日简报 | 实时汇率+大宗商品+市场新闻+客户跟进提醒 |\n| 定时任务 | 工作日自动化：早报/开发信/社媒/每日总结 |\n| 对话记录 | 按公司隔离的聊天记忆，支持搜索/回溯 |\n| Skill 生成器 | 用自然语言描述需求，自动生成新 skill 并注册到系统 |\n\n---\n\n## 数据安全\n\n- **业务数据默认存储在本地**（`~/.trade/`），不上传任何服务器\n- 如使用 **Ollama 等本地模型**，可实现完整本地运行，数据完全不出电脑\n- 如使用 **OpenAI / Anthropic / DeepSeek 等云端 LLM**，用户输入和必要上下文会发送至所选服务商——不包含客户身份信息\n- 多公司数据隔离（`X-Company-ID` header）\n- 绑定 `127.0.0.1`，仅本机浏览器可访问\n- **升级前自动备份数据库**到 `~/.trade/backups/`\n\n---\n\n## 技术栈\n\n| 层 | 技术 |\n|----|------|\n| AI 引擎 | [Hermes Agent](https://github.com/NousResearch/hermes-agent)（MIT 开源） |\n| 后端 | FastAPI + SQLite + uvicorn |\n| 前端 | 原生 JavaScript SPA（单文件，零构建工具依赖） |\n| LLM | 兼容 OpenAI / Anthropic / DeepSeek / MiniMax / Ollama 等 |\n| 文档解析 | PyMuPDF / python-docx / openpyxl / python-pptx |\n\n---\n\n## 联系作者\n\n<div style=\"text-align:center;\">\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"200\" style=\"border-radius:8px;\">\n <p>扫码添加微信，备注「Trade」</p>\n <p>商务合作或技术支持请发邮件至 <a href=\"mailto:lauroge@gmail.com\">lauroge@gmail.com</a></p>\n</div>\n\n---\n\n<p style=\"text-align:center; color:#8b949e;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/blob/main/LICENSE\">MIT License</a>\n</p>\n"}, "dd2f5fd441089122b6979af679b33fad1e00905d": {"t": 1785773001.9190006, "n": 7434, "h": "3616fc0f39862064", "c": "---\nlayout: default\n---\n\n<style>\n /* 全宽布局：覆盖 slate 主题的窄容器限制 */\n .container { max-width: 100% !important; padding: 0 2rem !important; }\n .container .content { max-width: 100% !important; }\n pre, code { white-space: pre !important; overflow-x: auto !important; }\n pre { padding: 1rem !important; }\n</style>\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">在本地运行，数据留在自己电脑里</p>\n <a href=\"https://github.com/chefroger/smart-trade-ai\" class=\"btn btn-primary\" style=\"margin:0.5rem;\">View on GitHub</a>\n <a href=\"#windows-install\" class=\"btn\" style=\"margin:0.5rem;\">Windows 安装 →</a>\n</div>\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-2.png\" alt=\"Customer & Cron Panel\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>客户管理 + 定时任务面板</em></p>\n</div>\n\n---\n\n## 为什么外贸人需要这个？\n\n| 痛点 | 不用这个工具 | 用了之后 |\n|------|-------------|---------|\n| 早安简报 | 每天打开 5 个网站查汇率/金价/新闻 | 自动生成，含实时汇率+大宗商品行情+客户跟进提醒 |\n| 客户背调 | 手动 Google → LinkedIn → WHOIS | 一键 6 层验证：邮箱注册检测→WHOIS→制裁名单→邮箱验证→技术栈→LinkedIn |\n| 开发信 | 每封手动写，客户多了记不清 | 根据客户画像自动生成，带具体痛点引用 |\n| B2B 平台 | 每天登录阿里国际站/中国制造网看数据 | 定时自动检查，新询盘/待跟进报价一目了然 |\n| LinkedIn | 不知道发什么内容 | AI 按周生成内容日历，轮换行业洞察/产品案例/互动提问 |\n| 客户资料 | 散落在 Excel/微信/邮件里 | 统一管理，A/B/C 分级，关联文档库 |\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-1.png\" alt=\"AI Chat Interface\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>AI 对话界面 — 自动调用 web_search / read_file / database 工具</em></p>\n</div>\n\n---\n\n## <a id=\"windows-install\"></a>Windows 安装指南\n\n> Windows 是最常见的使用平台，以下提供 3 种安装方式，按难度从低到高排列。\n\n### 方式一：一键安装脚本（推荐）\n\n只需提前安装 Python，其余全自动。\n\n**Step 0 — 安装 Python**\n\n从 [python.org](https://www.python.org/downloads/) 下载 **Python 3.11 ~ 3.13 Windows installer (64-bit)**。\n\n> **必须勾选「Add Python to PATH」**，否则后续命令找不到 python。\n\n安装完成后，**重新打开 PowerShell**，验证：\n\n```powershell\npython --version\n# 应显示 Python 3.11.x 或更高\n```\n\n**Step 1 — 启用长路径支持（以管理员身份运行 PowerShell，仅需一次）**\n\n```powershell\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n> 执行后**需重启电脑**。不开启的话，后续 `pip install` 可能报 `Filename too long` 错误。\n\n**Step 2 — 下载并运行安装脚本**\n\n```powershell\nirm https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.ps1 | iex\n```\n\n脚本自动完成：Python 检查 → 创建 venv → 安装 Hermes Agent → 安装 Trade → 15 个 skills → 数据库初始化 → 注册 `trade` 命令 → 设置开机自启动。\n\n安装完成后，启动方式：\n\n```powershell\ntrade # 新终端直接运行\n# 或\npython server.py # 在安装目录下\n```\n\n浏览器自动打开 http://127.0.0.1:9119/trade 。开机也会自动后台启动。\n\n> **如果脚本执行报错**，可能是网络问题（GitHub 访问不稳定）。参考下方「网络注意事项」。\n\n### 方式二：逐步手动安装\n\n适合想控制每一步的用户，或者一键脚本失败后排查问题。\n\n**前置条件**：Python >= 3.11（已加入 PATH）· 网络能访问 GitHub\n\n```powershell\n# 0. 启用长路径支持（管理员 PowerShell，仅需一次，执行后重启电脑）\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n\n# 1. 安装 Hermes Agent（AI 引擎，自动处理 Node.js + Git + 依赖）\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n\n# 2. 配置 LLM API Key\nhermes setup\n# 按提示选择 provider（推荐 DeepSeek），粘贴 API Key\n\n# 3. 安装 Smart Trade AI\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\ncd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\npip install -e \".\"\ninstall-trade-skills\n\n# 4. 启动\npython server.py\n# → 浏览器打开 http://127.0.0.1:9119/trade\n```\n\n> 如果第 3 步 `pip install` 报 `Filename too long`，说明长路径未生效，请确认第 0 步已完成并重启电脑。\n\n### 方式三：打包为独立 EXE（双击运行，无需终端）\n\n适合不想用终端的用户，或需要分发给同事。\n\n```powershell\npip install pyinstaller\npowershell -File scripts/build.ps1\n# 生成 dist/Smart Trade AI.exe\n```\n\n双击 EXE 即可运行，无需 Python 环境。\n\n### LLM API Key 配置\n\nSmart Trade AI 需要 LLM API Key 才能工作。推荐方案：\n\n| 方案 | 模型 | 适合场景 | 注册地址 |\n|------|------|---------|---------|\n| **推荐** | DeepSeek V4 Flash | 日常对话、文档分析、开发信 | [platform.deepseek.com](https://platform.deepseek.com) → 充值 → API Keys |\n\n注册后获取 Key，运行 `hermes setup`，选择对应 provider 并填入即可。\n\n> 还建议注册 [Tavily](https://tavily.com)（免费，每月 1000 次搜索），用于客户背调和实时信息检索。同样通过 `hermes setup` 配置。\n\n### 网络注意事项\n\n安装过程需要从 GitHub 克隆仓库并下载 Python 依赖。**境内用户请注意**：\n\n- **建议全程开启 VPN（全局模式）**，否则 `git clone` 和 `pip install` 容易超时\n- 如果 VPN 不稳定，可以多次重试安装命令，脚本支持断点续装\n- VPN 代理未生效时，在 PowerShell 中手动设置：\n ```powershell\n $env:HTTPS_PROXY = \"http://127.0.0.1:你的代理端口\"\n ```\n\n### 常见问题\n\n| 问题 | 解决方案 |\n|------|---------|\n| `python` 命令找不到 | 重新安装 Python，勾选「Add Python to PATH」，然后重新打开 PowerShell |\n| `Filename too long` | 以管理员 PowerShell 执行长路径注册命令（见 Step 1），然后重启电脑 |\n| `git clone` 超时 | 开启 VPN 全局模式；或设置 `$env:HTTPS_PROXY` |\n| `pip install` 报红字 | 通常是网络问题，重试即可；确认 VPN 正常 |\n| 升级后页面样式异常 | 按 `Ctrl+Shift+R` 强制刷新浏览器缓存 |\n\n---\n\n## macOS / Linux 安装\n\n### 一键脚本\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.sh | bash\n```\n\n> 审查后执行：\n> ```bash\n> curl -fsSLO https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.sh\n> less install.sh && bash install.sh\n> ```\n\n### 手动安装\n\n```bash\n# 1. 安装 Hermes Agent\ngit clone --branch main https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent\ncd ~/.hermes/hermes-agent && pip install -e \".\"\n\n# 2. 配置 LLM\nhermes setup\n\n# 3. 安装 Smart Trade AI\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git ~/.trade/foreign-trade-assistant\ncd ~/.trade/foreign-trade-assistant && pip install -e \".\"\n\n# 4. 启动\ninstall-trade-skills\npython server.py\n# → 浏览器打开 http://127.0.0.1:9119/trade\n```\n\n---\n\n## 15 项专业能力\n\n| 场景 | 能力 |\n|------|------|\n| 平台诊断 | 分析阿里国际站/中国制造网产品页面，输出优化建议 |\n| 社媒营销 | 生成 Facebook/Instagram/TikTok/YouTube 内容日历 |\n| LinkedIn 运营 | Profile 优化 + 内容策略 + InMail 模板 |\n| 海关数据 | 分析进出口数据，筛选高价值采购商 |\n| 客户开发 | 根据目标市场+产品生成开发信和跟进序列 |\n| 客户管理 | A/B/C 分级、详情面板、文档库关联 |\n| 文档分析 | 读取本地 PDF/Word/Excel/PPT，AI 自动解析 |\n| 商务文档生成 | 一键生成报价单、PI、合同（DOCX/XLSX/PPTX） |\n| 报价谈判 | 基于产品知识库和客户画像给出谈判策略 |\n| 客户背调 | 6 层验证：邮箱→WHOIS→制裁→邮箱验证→技术栈→LinkedIn |\n| 每日简报 | 实时汇率+大宗商品+市场新闻+客户跟进提醒 |\n| 定时任务 | 工作日自动化：早报/开发信/社媒/每日总结 |\n| 对话记录 | 按公司隔离的聊天记忆，支持搜索/回溯 |\n| Skill 生成器 | 用自然语言描述需求，自动生成新 skill 并注册到系统 |\n\n---\n\n## 数据安全\n\n- **业务数据默认存储在本地**（`~/.trade/`），不上传任何服务器\n- 如使用 **Ollama 等本地模型**，可实现完整本地运行，数据完全不出电脑\n- 如使用 **OpenAI / Anthropic / DeepSeek 等云端 LLM**，用户输入和必要上下文会发送至所选服务商——不包含客户身份信息\n- 多公司数据隔离（`X-Company-ID` header）\n- 绑定 `127.0.0.1`，仅本机浏览器可访问\n- **升级前自动备份数据库**到 `~/.trade/backups/`\n\n---\n\n## 技术栈\n\n| 层 | 技术 |\n|----|------|\n| AI 引擎 | [Hermes Agent](https://github.com/NousResearch/hermes-agent)（MIT 开源） |\n| 后端 | FastAPI + SQLite + uvicorn |\n| 前端 | 原生 JavaScript SPA（单文件，零构建工具依赖） |\n| LLM | 兼容 OpenAI / Anthropic / DeepSeek / MiniMax / Ollama 等 |\n| 文档解析 | PyMuPDF / python-docx / openpyxl / python-pptx |\n\n---\n\n## 联系作者\n\n<div style=\"text-align:center;\">\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"200\" style=\"border-radius:8px;\">\n <p>扫码添加微信，备注「Trade」</p>\n <p>商务合作或技术支持请发邮件至 <a href=\"mailto:lauroge@gmail.com\">lauroge@gmail.com</a></p>\n</div>\n\n---\n\n<p style=\"text-align:center; color:#8b949e;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/blob/main/LICENSE\">MIT License</a>\n</p>\n"}, "ffdb06414b7230d4d9c7ca8ca53b64e9a9cd356e": {"t": 1785773003.284022, "n": 7148, "h": "85a23d3a78968736", "c": "---\nlayout: default\n---\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">在本地运行，数据留在自己电脑里</p>\n <a href=\"https://github.com/chefroger/smart-trade-ai\" class=\"btn btn-primary\" style=\"margin:0.5rem;\">View on GitHub</a>\n <a href=\"#windows-install\" class=\"btn\" style=\"margin:0.5rem;\">Windows 安装 →</a>\n</div>\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-2.png\" alt=\"Customer & Cron Panel\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>客户管理 + 定时任务面板</em></p>\n</div>\n\n---\n\n## 为什么外贸人需要这个？\n\n| 痛点 | 不用这个工具 | 用了之后 |\n|------|-------------|---------|\n| 早安简报 | 每天打开 5 个网站查汇率/金价/新闻 | 自动生成，含实时汇率+大宗商品行情+客户跟进提醒 |\n| 客户背调 | 手动 Google → LinkedIn → WHOIS | 一键 6 层验证：邮箱注册检测→WHOIS→制裁名单→邮箱验证→技术栈→LinkedIn |\n| 开发信 | 每封手动写，客户多了记不清 | 根据客户画像自动生成，带具体痛点引用 |\n| B2B 平台 | 每天登录阿里国际站/中国制造网看数据 | 定时自动检查，新询盘/待跟进报价一目了然 |\n| LinkedIn | 不知道发什么内容 | AI 按周生成内容日历，轮换行业洞察/产品案例/互动提问 |\n| 客户资料 | 散落在 Excel/微信/邮件里 | 统一管理，A/B/C 分级，关联文档库 |\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-1.png\" alt=\"AI Chat Interface\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>AI 对话界面 — 自动调用 web_search / read_file / database 工具</em></p>\n</div>\n\n---\n\n## <a id=\"windows-install\"></a>Windows 安装指南\n\n> Windows 是最常见的使用平台，以下提供 3 种安装方式，按难度从低到高排列。\n\n### 方式一：一键安装脚本（推荐）\n\n只需提前安装 Python，其余全自动。\n\n**Step 0 — 安装 Python**\n\n从 [python.org](https://www.python.org/downloads/) 下载 **Python 3.11 ~ 3.13 Windows installer (64-bit)**。\n\n> **必须勾选「Add Python to PATH」**，否则后续命令找不到 python。\n\n安装完成后，**重新打开 PowerShell**，验证：\n\n```powershell\npython --version\n# 应显示 Python 3.11.x 或更高\n```\n\n**Step 1 — 启用长路径支持（以管理员身份运行 PowerShell，仅需一次）**\n\n```powershell\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n```\n\n> 执行后**需重启电脑**。不开启的话，后续 `pip install` 可能报 `Filename too long` 错误。\n\n**Step 2 — 下载并运行安装脚本**\n\n```powershell\nirm https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.ps1 | iex\n```\n\n脚本自动完成：Python 检查 → 创建 venv → 安装 Hermes Agent → 安装 Trade → 15 个 skills → 数据库初始化 → 注册 `trade` 命令 → 设置开机自启动。\n\n安装完成后，启动方式：\n\n```powershell\ntrade # 新终端直接运行\n# 或\npython server.py # 在安装目录下\n```\n\n浏览器自动打开 http://127.0.0.1:9119/trade 。开机也会自动后台启动。\n\n> **如果脚本执行报错**，可能是网络问题（GitHub 访问不稳定）。参考下方「网络注意事项」。\n\n### 方式二：逐步手动安装\n\n适合想控制每一步的用户，或者一键脚本失败后排查问题。\n\n**前置条件**：Python >= 3.11（已加入 PATH）· 网络能访问 GitHub\n\n```powershell\n# 0. 启用长路径支持（管理员 PowerShell，仅需一次，执行后重启电脑）\nNew-ItemProperty -Path \"HKLM:\\SYSTEM\\CurrentControlSet\\Control\\FileSystem\" -Name \"LongPathsEnabled\" -Value 1 -PropertyType DWORD -Force\n\n# 1. 安装 Hermes Agent（AI 引擎，自动处理 Node.js + Git + 依赖）\nirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex\n\n# 2. 配置 LLM API Key\nhermes setup\n# 按提示选择 provider（推荐 DeepSeek），粘贴 API Key\n\n# 3. 安装 Smart Trade AI\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\ncd $env:LOCALAPPDATA\\trade\\foreign-trade-assistant\npip install -e \".\"\ninstall-trade-skills\n\n# 4. 启动\npython server.py\n# → 浏览器打开 http://127.0.0.1:9119/trade\n```\n\n> 如果第 3 步 `pip install` 报 `Filename too long`，说明长路径未生效，请确认第 0 步已完成并重启电脑。\n\n### 方式三：打包为独立 EXE（双击运行，无需终端）\n\n适合不想用终端的用户，或需要分发给同事。\n\n```powershell\npip install pyinstaller\npowershell -File scripts/build.ps1\n# 生成 dist/Smart Trade AI.exe\n```\n\n双击 EXE 即可运行，无需 Python 环境。\n\n### LLM API Key 配置\n\nSmart Trade AI 需要 LLM API Key 才能工作。推荐方案：\n\n| 方案 | 模型 | 适合场景 | 注册地址 |\n|------|------|---------|---------|\n| **推荐** | DeepSeek V4 Flash | 日常对话、文档分析、开发信 | [platform.deepseek.com](https://platform.deepseek.com) → 充值 → API Keys |\n\n注册后获取 Key，运行 `hermes setup`，选择对应 provider 并填入即可。\n\n> 还建议注册 [Tavily](https://tavily.com)（免费，每月 1000 次搜索），用于客户背调和实时信息检索。同样通过 `hermes setup` 配置。\n\n### 网络注意事项\n\n安装过程需要从 GitHub 克隆仓库并下载 Python 依赖。**境内用户请注意**：\n\n- **建议全程开启 VPN（全局模式）**，否则 `git clone` 和 `pip install` 容易超时\n- 如果 VPN 不稳定，可以多次重试安装命令，脚本支持断点续装\n- VPN 代理未生效时，在 PowerShell 中手动设置：\n ```powershell\n $env:HTTPS_PROXY = \"http://127.0.0.1:你的代理端口\"\n ```\n\n### 常见问题\n\n| 问题 | 解决方案 |\n|------|---------|\n| `python` 命令找不到 | 重新安装 Python，勾选「Add Python to PATH」，然后重新打开 PowerShell |\n| `Filename too long` | 以管理员 PowerShell 执行长路径注册命令（见 Step 1），然后重启电脑 |\n| `git clone` 超时 | 开启 VPN 全局模式；或设置 `$env:HTTPS_PROXY` |\n| `pip install` 报红字 | 通常是网络问题，重试即可；确认 VPN 正常 |\n| 升级后页面样式异常 | 按 `Ctrl+Shift+R` 强制刷新浏览器缓存 |\n\n---\n\n## macOS / Linux 安装\n\n### 一键脚本\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.sh | bash\n```\n\n> 审查后执行：\n> ```bash\n> curl -fsSLO https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.sh\n> less install.sh && bash install.sh\n> ```\n\n### 手动安装\n\n```bash\n# 1. 安装 Hermes Agent\ngit clone --branch main https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent\ncd ~/.hermes/hermes-agent && pip install -e \".\"\n\n# 2. 配置 LLM\nhermes setup\n\n# 3. 安装 Smart Trade AI\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git ~/.trade/foreign-trade-assistant\ncd ~/.trade/foreign-trade-assistant && pip install -e \".\"\n\n# 4. 启动\ninstall-trade-skills\npython server.py\n# → 浏览器打开 http://127.0.0.1:9119/trade\n```\n\n---\n\n## 15 项专业能力\n\n| 场景 | 能力 |\n|------|------|\n| 平台诊断 | 分析阿里国际站/中国制造网产品页面，输出优化建议 |\n| 社媒营销 | 生成 Facebook/Instagram/TikTok/YouTube 内容日历 |\n| LinkedIn 运营 | Profile 优化 + 内容策略 + InMail 模板 |\n| 海关数据 | 分析进出口数据，筛选高价值采购商 |\n| 客户开发 | 根据目标市场+产品生成开发信和跟进序列 |\n| 客户管理 | A/B/C 分级、详情面板、文档库关联 |\n| 文档分析 | 读取本地 PDF/Word/Excel/PPT，AI 自动解析 |\n| 商务文档生成 | 一键生成报价单、PI、合同（DOCX/XLSX/PPTX） |\n| 报价谈判 | 基于产品知识库和客户画像给出谈判策略 |\n| 客户背调 | 6 层验证：邮箱→WHOIS→制裁→邮箱验证→技术栈→LinkedIn |\n| 每日简报 | 实时汇率+大宗商品+市场新闻+客户跟进提醒 |\n| 定时任务 | 工作日自动化：早报/开发信/社媒/每日总结 |\n| 对话记录 | 按公司隔离的聊天记忆，支持搜索/回溯 |\n| Skill 生成器 | 用自然语言描述需求，自动生成新 skill 并注册到系统 |\n\n---\n\n## 数据安全\n\n- **业务数据默认存储在本地**（`~/.trade/`），不上传任何服务器\n- 如使用 **Ollama 等本地模型**，可实现完整本地运行，数据完全不出电脑\n- 如使用 **OpenAI / Anthropic / DeepSeek 等云端 LLM**，用户输入和必要上下文会发送至所选服务商——不包含客户身份信息\n- 多公司数据隔离（`X-Company-ID` header）\n- 绑定 `127.0.0.1`，仅本机浏览器可访问\n- **升级前自动备份数据库**到 `~/.trade/backups/`\n\n---\n\n## 技术栈\n\n| 层 | 技术 |\n|----|------|\n| AI 引擎 | [Hermes Agent](https://github.com/NousResearch/hermes-agent)（MIT 开源） |\n| 后端 | FastAPI + SQLite + uvicorn |\n| 前端 | 原生 JavaScript SPA（单文件，零构建工具依赖） |\n| LLM | 兼容 OpenAI / Anthropic / DeepSeek / MiniMax / Ollama 等 |\n| 文档解析 | PyMuPDF / python-docx / openpyxl / python-pptx |\n\n---\n\n## 联系作者\n\n<div style=\"text-align:center;\">\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"200\" style=\"border-radius:8px;\">\n <p>扫码添加微信，备注「Trade」</p>\n <p>商务合作或技术支持请发邮件至 <a href=\"mailto:lauroge@gmail.com\">lauroge@gmail.com</a></p>\n</div>\n\n---\n\n<p style=\"text-align:center; color:#8b949e;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/blob/main/LICENSE\">MIT License</a>\n</p>\n"}, "4105d4f415005cc63cd7aeb2dd80275ab6c95a4e": {"t": 1785773004.5311377, "n": 4147, "h": "2f852886bfb86390", "c": "---\nlayout: default\n---\n\n<!-- Hero -->\n<div style=\"text-align:center; padding:2rem 1rem 1rem;\">\n <h1 style=\"font-size:2.4rem; margin-bottom:0.2em;\">🚀 Smart Trade AI</h1>\n <p style=\"font-size:1.2rem; color:#58a6ff; margin:0;\">外贸业务员的本地 AI 助手</p>\n <p style=\"color:#8b949e;\">在本地运行，数据留在自己电脑里</p>\n <a href=\"https://github.com/chefroger/smart-trade-ai\" class=\"btn btn-primary\" style=\"margin:0.5rem;\">View on GitHub</a>\n <a href=\"#quick-start\" class=\"btn\" style=\"margin:0.5rem;\">3 分钟上手 →</a>\n</div>\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-2.png\" alt=\"Customer & Cron Panel\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>客户管理 + 定时任务面板</em></p>\n</div>\n\n---\n\n## 为什么外贸人需要这个？\n\n| 痛点 | 不用这个工具 | 用了之后 |\n|------|-------------|---------|\n| 早安简报 | 每天打开 5 个网站查汇率/金价/新闻 | 自动生成，含实时汇率+大宗商品行情+客户跟进提醒 |\n| 客户背调 | 手动 Google → LinkedIn → WHOIS | 一键 6 层验证：邮箱注册检测→WHOIS→制裁名单→邮箱验证→技术栈→LinkedIn |\n| 开发信 | 每封手动写，客户多了记不清 | 根据客户画像自动生成，带具体痛点引用 |\n| B2B 平台 | 每天登录阿里国际站/中国制造网看数据 | 定时自动检查，新询盘/待跟进报价一目了然 |\n| LinkedIn | 不知道发什么内容 | AI 按周生成内容日历，轮换行业洞察/产品案例/互动提问 |\n| 客户资料 | 散落在 Excel/微信/邮件里 | 统一管理，A/B/C 分级，关联文档库 |\n\n---\n\n<div style=\"text-align:center;\">\n <img src=\"screenshot-1.png\" alt=\"AI Chat Interface\" style=\"max-width:75%; border-radius:8px; box-shadow:0 4px 24px rgba(0,0,0,.4);\">\n <p><em>AI 对话界面 — 自动调用 web_search / read_file / database 工具</em></p>\n</div>\n\n---\n\n## 15 项专业能力\n\n| 场景 | 能力 |\n|------|------|\n| 平台诊断 | 分析阿里国际站/中国制造网产品页面，输出优化建议 |\n| 社媒营销 | 生成 Facebook/Instagram/TikTok/YouTube 内容日历 |\n| LinkedIn 运营 | Profile 优化 + 内容策略 + InMail 模板 |\n| 海关数据 | 分析进出口数据，筛选高价值采购商 |\n| 客户开发 | 根据目标市场+产品生成开发信和跟进序列 |\n| 客户管理 | A/B/C 分级、详情面板、文档库关联 |\n| 文档分析 | 读取本地 PDF/Word/Excel/PPT，AI 自动解析 |\n| 商务文档生成 | 一键生成报价单、PI、合同（DOCX/XLSX/PPTX） |\n| 报价谈判 | 基于产品知识库和客户画像给出谈判策略 |\n| 客户背调 | 6 层验证：邮箱→WHOIS→制裁→邮箱验证→技术栈→LinkedIn |\n| 每日简报 | 实时汇率+大宗商品+市场新闻+客户跟进提醒 |\n| 定时任务 | 工作日自动化：早报/开发信/社媒/每日总结 |\n| 对话记录 | 按公司隔离的聊天记忆，支持搜索/回溯 |\n| Skill 生成器 | 用自然语言描述需求，自动生成新 skill 并注册到系统 |\n\n---\n\n## <a id=\"quick-start\"></a>3 分钟上手\n\n### 一键脚本（推荐）\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.sh | bash\n```\n\n脚本自动完成：Python 环境检查 → Hermes Agent → Trade 安装 → 15 个 skills → 数据库初始化。\n\n> 如果你想先审查脚本：\n> ```bash\n> curl -fsSLO https://raw.githubusercontent.com/chefroger/smart-trade-ai/main/scripts/install.sh\n> less install.sh # 审查后\n> bash install.sh\n> ```\n\n### 手动安装\n\n**前置条件**：Python >= 3.11 · Git · LLM API Key（DeepSeek / OpenAI / Anthropic 等）\n\n```bash\n# 1. 安装 Hermes Agent（AI 引擎）\ngit clone --branch main https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent\ncd ~/.hermes/hermes-agent && pip install -e \".\"\n\n# 2. 配置 LLM\nhermes setup\n\n# 3. 安装 Smart Trade AI\ngit clone --branch main https://github.com/chefroger/smart-trade-ai.git ~/.trade/foreign-trade-assistant\ncd ~/.trade/foreign-trade-assistant && pip install -e \".\"\n\n# 4. 安装 skills 并启动\ninstall-trade-skills\npython server.py\n# → 浏览器打开 http://127.0.0.1:9119/trade\n```\n\n---\n\n## 数据安全\n\n- **业务数据默认存储在本地**（`~/.trade/`），不上传任何服务器\n- 如使用 **Ollama 等本地模型**，可实现完整本地运行，数据完全不出电脑\n- 如使用 **OpenAI / Anthropic / DeepSeek 等云端 LLM**，用户输入和必要上下文会发送至所选服务商——不包含客户身份信息\n- 多公司数据隔离（`X-Company-ID` header）\n- 绑定 `127.0.0.1`，仅本机浏览器可访问\n- **升级前自动备份数据库**到 `~/.trade/backups/`\n\n---\n\n## 技术栈\n\n| 层 | 技术 |\n|----|------|\n| AI 引擎 | [Hermes Agent](https://github.com/NousResearch/hermes-agent)（MIT 开源） |\n| 后端 | FastAPI + SQLite + uvicorn |\n| 前端 | 原生 JavaScript SPA（单文件，零构建工具依赖） |\n| LLM | 兼容 OpenAI / Anthropic / DeepSeek / MiniMax / Ollama 等 |\n| 文档解析 | PyMuPDF / python-docx / openpyxl / python-pptx |\n\n---\n\n## 联系作者\n\n<div style=\"text-align:center;\">\n <img src=\"wechat-contact.jpeg\" alt=\"WeChat Contact\" width=\"200\" style=\"border-radius:8px;\">\n <p>扫码添加微信，备注「Trade」</p>\n <p>商务合作或技术支持请发邮件至 <a href=\"mailto:lauroge@gmail.com\">lauroge@gmail.com</a></p>\n</div>\n\n---\n\n<p style=\"text-align:center; color:#8b949e;\">\n Smart Trade AI — 外贸业务员的本地 AI 助手<br>\n <a href=\"https://github.com/chefroger/smart-trade-ai\">GitHub</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/releases\">Releases</a> ·\n <a href=\"https://github.com/chefroger/smart-trade-ai/blob/main/LICENSE\">MIT License</a>\n</p>\n"}}}} |