Trade Pipeline — 外贸单证自动化工具

English | Русский | 技术深度版

一份数据，自动出报价单、PI、CI、装箱单。
不用在多个 Excel 之间来回复制粘贴。

怎么用：一个 AI 技能（Skill）

这是一个 AI Agent 技能（SKILL.md 格式）。装好后，你只需要用大白话对它说话—— 「把这份询价单转成报价单」「客户确认了，出 PI/CI/PL」——AI 全程帮你跑完，不用记任何命令。

👉 安装和使用：用 Claude Code · 用腾讯 WorkBuddy

你每周是不是在做这些事？

• 客户发来询价 Excel → 手动把产品名、规格、数量抄到报价单里
• 客户确认后 → 手动把同样的数据再抄一遍做 PI
• 备货完成 → 又抄一遍做 CI 和装箱单
• PI 里有个数量写错了 → CI、PL、报关资料全跟着错，逐个找逐个改
• 不同客户要不同的 PI 格式（俄罗斯客户要俄语、欧洲客户要英语）→ 维护好几套模板

每份单据本质上是同一组数据的不同排版，但你每次都在从零开始做。

Trade Pipeline 的解决方案很简单：只维护一份订单档案，所有单据从这份档案自动生成。改一处，四份单据联动更新。

它能帮你做什么

把一份客户询价 Excel 自动变成以下全套单据：

报价单 — 黄色高亮列填单价，填完后一键回写到订单档案：

形式发票 PI — 卖方/买方表头、分组产品行、付款条款：

商业发票 CI — 中英双语、唛头、装运信息、SAY 大写金额：

装箱单 PL — 分组明细、箱数/箱重/数量/净重/毛重、托盘汇总：

适合谁用

最适合的画像

• 年订单量：50–500 单
• 产品 SKU：< 5,000
• 主要市场：俄罗斯 / 东欧 / 南美 / 中东
• 团队规模：1–3 名外贸业务员

完全不懂代码？ 没关系。看完上面几段你就能判断自己要不要用。安装和配置部分有一点命令行操作，但不需要编程知识——跟着复制粘贴就行。

和 ERP 是什么关系

Trade Pipeline 不是 ERP 替代品。ERP 管库存、财务、应收应付、税务——这些它做不了也不打算做。

它补的是 ERP 前后两端做不好的事：

它不是什么

• ❌ 不是 ERP — 不管库存、财务、税务
• ❌ 不是在线系统 — 没有账号、没有客服，数据全在你自己电脑上
• ❌ 不是多人协作平台 — 最适合 1–3 人小团队
• ❌ 不是"AI 自动做外贸" — AI 只帮忙解析格式复杂的询价单，其他都是确定性规则
• ❌ 不直接对接海关 — 能准备报关行需要的数据，但不能直接提交单一窗口

先说清楚：适用什么行业

这个工具是我给自己公司用的，所以它是按五金 / 紧固件行业的特点做的：

• 计价以重量为主（KG / 吨）
• 产品规格相对固定（DIN / ISO / GOST 标准件那一套）
• 包装方式也比较标准

如果你也是五金 / 紧固件行业（螺栓、螺母、垫圈、标准件、线材、管件、法兰、轴承、密封件等）， 改一下公司信息和翻译表基本就能用。

如果你是别的行业，规格、计价方式（按件 / 按套 / 按米）、重量和包装逻辑都不一样， 这工具不能拿来即用，需要自己改造——主要改这三处：

框架是通的，但适配工作量取决于你行业的复杂度。

一句话：五金 / 紧固件能直接用，其他行业把它当一个可改造的底座。

比较吃力的行业：服装（尺码矩阵复杂）、电子元器件（BOM 嵌套）、大宗散货（期货定价）、跨境电商（SKU 上万）——这些改造量较大，要有心理准备。

未来还想做的事

以上是未来扩展方向，当前版本还没有。标 🔜 的不代表马上就有。

git clone https://github.com/Dangooy/trade-pipeline-skill.git
cd trade-pipeline-skill
pip install -e .

初始化配置                         → 触发 trade-pipeline-init，一步步问你公司信息
把 examples/sample_inquiry.xlsx 转成报价单   → 触发 trade-pipeline-run，自动跑完整条流水线
客户确认了，回写价格并出 PI/CI/PL          → 自动完成价格回写 + 生成正式单据

# 1. 下载项目并安装引擎
git clone https://github.com/Dangooy/trade-pipeline-skill.git
cd trade-pipeline-skill
pip install -e .

# 2. 把两个技能拷进 WorkBuddy 技能目录
mkdir "$env:USERPROFILE\.workbuddy\skills" -Force
Copy-Item -Recurse -Force ".\.claude\skills\trade-pipeline-init" "$env:USERPROFILE\.workbuddy\skills\"
Copy-Item -Recurse -Force ".\.claude\skills\trade-pipeline-run"  "$env:USERPROFILE\.workbuddy\skills\"

# 1. 下载项目并安装引擎
git clone https://github.com/Dangooy/trade-pipeline-skill.git
cd trade-pipeline-skill
pip install -e .

# 2. 把两个技能拷进 WorkBuddy 技能目录
mkdir -p ~/.workbuddy/skills
cp -r .claude/skills/trade-pipeline-init ~/.workbuddy/skills/
cp -r .claude/skills/trade-pipeline-run  ~/.workbuddy/skills/

@trade-pipeline-run 把这份询价单转成报价单

# 阶段一：只生成报价单（给客户谈价格用）
python -m trade_pipeline --input 询价单.xlsx --order 2601 --buyer global_fasteners --quote-only

# 阶段二：客户确认后，回写价格 + 生成 PI / CI / PL
python -m trade_pipeline --price-update output/2601/2601_quotation.xlsx --model output/2601/2601_model.json

# 一次生成全套（加急或 demo 场景）：
python -m trade_pipeline --input 询价单.xlsx --order 2601 --buyer global_fasteners

# 新客户（先用临时身份，之后再补）：
python -m trade_pipeline --input 询价单.xlsx --order 2601 --buyer _new --quote-only

# 系统匹配不到客户名时会停下来生成 review.json，确认后继续：
python -m trade_pipeline --input 询价单.xlsx --order 2601 --confirm output/2601/2601_review.json

output/2601/
├── 2601_rfq.json           # 从询价单提取的数据
├── 2601_model.json         # 订单档案（所有单据从这里生成）
├── 2601_quotation.xlsx     # 报价单
├── 2601_pi.xlsx            # 形式发票
├── 2601_ci.xlsx            # 商业发票
└── 2601_pl.xlsx            # 装箱单

这个工具是怎么做出来的

我不是专业程序员，是一家制造业工厂的的外贸业务人员,更准确的说，是所谓的厂二代，受限于所能获得的资源，很需要强力的助手类工具AGENT。

这个工具存在的原因很简单：我每周花好几个小时手动做贸易单据，做烦了。 Claude Code 帮我把这些年积累的业务经验变成了可运行的自动化系统。

举个例子：第一版的价格回写功能用的是行号——第 3 行的价格写回第 3 行。技术上完全正确。直到有一天，一个客户在报价单里插了几行分组标题，我跑回写——所有价格全错位了，PI 也跟着错。

我把这个 bug 告诉 Claude，它的第一反应是"解析时排除标题行"。我说不行——客户怎么编辑 Excel 是不可预测的。我们讨论了三轮，最后我提出"每行能不能藏一个隐形身份证？" Claude 实现了 UUID 隐藏列方案。

这种设计不会出现在编程教程里，因为它来自真实的生产 bug。

AI 编码工具在你有深度领域知识时最强大——我非常清楚 PI 应该长什么样，因为我手动做过几百份。

你的数据在哪里

所有客户信息、订单数据、生成的单据都存在你自己的电脑上，不会上传到任何服务器。

这意味着：

• ✅ 数据完全由你掌控
• ✅ 可以用 Git 追溯每次修改记录
• ⚠️ 需要你自己备份（建议定期复制到移动硬盘或加密云盘）

⚠️ 一个例外——可选的 LLM 解析（--use-llm）：默认的解析是纯本地、不联网的。 只有当你显式开启 --use-llm 时，工具才会把询价单原始内容（含客户名、产品、数量） 发送到 Anthropic 云端 API 帮忙解析。这个开关默认关闭、需要你主动 opt-in； 处理敏感或保密单据时请谨慎，或直接用默认的本地模式。

关于作者

作者杨天机，更多外贸 AI skill 见 tianji-skills（寻客/译盘/核单）。

许可证

MIT — 免费使用，可以自由修改。

遇到问题？
提一个 Issue（不需要技术背景，写下你看到什么、期望什么即可）