Lydia Foreign Trade System

我把自己在外贸业务中积累的询盘筛选、客户背调和跟进方法，整理成这套工作台。它把散落的询盘、公开企业信息、联系人证据和熟人关系线索整理为可核查的客户档案，帮助外贸人员看清谁值得优先跟进、还缺哪些信息、下一步该做什么。

Local-first export-sales workbench: import inquiries, review evidence and missing fields, and decide who to follow up with. English quick start · 反馈问题

当前可用的四条链路：

1. 批量导入阿里巴巴、中国制造网或人工整理的询盘 CSV/JSON；
2. 按证据质量、需求清晰度、购买准备度、可联系性与信任基础评分；
3. 从产品、市场和买家类型生成公开搜索计划，把未核查候选送去官网补证后加入开发队列；
4. 输出 A/B/C/D/HOLD 分级、缺失证据和下一步动作，再在 apps/communication-extension 中完成人工沟通。

另有独立的本地成交单证工作台：录入同一客户、产品和商业条款后，生成报价单、PI、商业发票、装箱单、销售合同草稿和产品目录。它只生成可审阅、可下载的草稿，绝不发送、签署、报关或将草稿视为付款/合同/清关证明。

工作台还可以：

• 主动查询 GLEIF 官方 LEI 数据，核对海外企业的法定名称、登记编号、地址与状态；
• 导入 CSV 前逐列核对原表头、样例值和 Lydia 字段；陌生列可人工映射或忽略，未确认前不写入当前客户空间；
• 通过本机 agent-reach 可选调用 Exa 搜索公开商业候选，也可在浏览器本地导入 Lydia 候选 CSV/JSON；
• 主动读取一张公开或已授权的公司官网页面，或整理最多 5 张同站高价值页面，提取带来源的候选邮箱、电话、WhatsApp、地址及工厂自述；
• 逐条勾选官网候选证据后再写入询盘或开发队列；未选内容不写入，跨公司域名会被阻止，人工选择也不会把 candidate 升级成已验证；
• 对已入档证据执行有原因、有时间的驳回、恢复和修订；系统只回滚仍由该证据管理的字段，不覆盖后续人工修改；
• 对重复客户候选人工选择“同一客户”或“不同客户”；同一客户必须指定主账户，次账户原始询盘仍完整保留，决定可以撤销重做；
• 冻结询盘首次导入时的等级和分数，追加记录联系、回复、报价、样品、订单、成交、流失及下一步待办；按初始等级回看真实转化，误记活动可带原因撤回；
• 为不同客户建立独立本机客户空间；客户、开发活动、公开候选、研究证据和信任路径分别保存到 IndexedDB，切换时先保存再恢复目标空间，联网授权勾选和未知字段不会持久化；
• 导出的 JSON 和文件名带客户空间标记；导入另一客户空间的 Lydia JSON 时默认停止，避免把客户资料混入当前空间；
• 一键导出当前客户的完整空间备份；恢复时始终新建空间而不覆盖现有客户，同名备份会自动生成带“恢复”后缀的空间；
• 用联系人英文名和企业域名生成有限的候选邮箱，检查域名邮件路由并阻止错配客户；
• 导入客户自己拥有或授权的通讯录/CRM 关系记录，排除拒绝路径并给出熟人引荐顺序。

立即使用

需要 Node.js 20 或更高版本，无需安装第三方依赖。

首次使用，先获取源码再启动：

git clone https://github.com/LydiaTools/lydia-foreign-trade-system.git
cd lydia-foreign-trade-system
npm run workbench

打开终端显示的本机地址，选择自己的询盘 CSV 或 JSON。CSV 先核对字段映射，再点击 “确认映射并导入”，查看客户分级、待补信息和跟进建议。按需要查询企业资料、评估信任路径并导出结果。导入和分级不需要 API Key，客户文件在本机处理；停止服务时按 Ctrl+C。

命令行与开发检查

npm run qualify -- examples/inquiries.sample.csv
npm run qualify -- examples/inquiries.sample.csv --output ./qualification-results.json
npm run check

询盘、候选、研究结果和关系路径只在当前本机客户空间处理并自动保存，不抓取私人资料、不发送消息。只有使用者主动确认查询时才联网：Exa 接收选中的公开搜索词；GLEIF 接收企业名称和可选司法辖区；指定官网按使用者选择读取一页，或最多 5 张同站的联系/公司/工厂/产品页；邮箱候选只查询企业域名 DNS，联系人姓名不离开浏览器。询盘正文、关系文件和其他联系人资料不会自动发送。浏览器本机数据和导出的完整备份都未加密，客户空间也不是云备份、账号权限或 SaaS 多租户；重要批次应导出完整备份，并存放在使用者自己的受控位置。详细边界见 客户空间 和 本机自动保存。搜索摘要、官网公开联系方式和生成邮箱全部先视为候选，也不等于营销同意。

系统边界

• packages/lead-core：统一客户、证据、分级和关系路径模型。
• apps/lead-workbench：只在本机运行的可视化询盘工作台。
• apps/inquiry-qualifier：可运行的批量询盘分级工具。
• apps/communication-extension：Lydia 的外贸沟通浏览器插件。
• integrations：可选研究/验证适配器；Exa 通过本机 agent-reach、GLEIF 通过固定官方接口；官网采集只读使用者主动确认的一页或最多 5 张同站高价值页面，其他提供方只有明确配置后才启用。
• skills/lydia-foreign-trade-system：供 Codex 复用的 Lydia 工作流 Skill。

沟通插件仍保留自己的独立私有仓库，并以 Git subtree 纳入本系统。需要同步其新版本时，在系统仓库执行：

git subtree pull --prefix apps/communication-extension \
  https://github.com/LydiaTools/foreign-trade-development-plugin.git main --squash

公开资料只能作为线索和证据，不能冒充已确认事实；候选邮箱不能写成“已验证邮箱”。CSV 的建议映射也不是平台兼容承诺，必须在导入前核对，详见 渠道导入。官网结果必须逐条选择后才能进入客户档案，所选证据保留人工决定时间和具体来源。发现错误时应在客户证据中驳回或修订；完整规则见 证据复核与字段回滚。重复候选也不会自动合并或删除，详见 重复客户与主账户。开发阶段和结果回测见 客户开发记录，不同客户分区见 客户空间，本机保存、恢复和清除见 本机自动保存。系统不按姓名、国籍、性别等敏感或无关属性判断客户质量。

开源、品牌与授权

本仓库以 MIT License 开源。请勿把真实客户资料、登录态、API Key、私人关系数据或抓取快照提交到仓库。外部开源项目仅在许可证允许范围内借鉴或适配；依法需要保留的许可证和归属见 THIRD_PARTY_NOTICES.md。

规划

详见 系统架构、客户调研、渠道导入、客户开发记录、客户空间、本机自动保存、证据复核、重复客户、公开候选、官网档案、候选邮箱、关系数据导入 和 路线图。

反馈与贡献

按 CONTRIBUTING.md 提交复现步骤和相关检查结果。不要把真实询盘、联系人信息、客户备份或凭据放进 Issue、截图和 PR。如果工具确实帮你完成了工作，欢迎 Star；使用不以 Star 为条件。