foreign-trade-operations

name	foreign-trade-operations
description	Use this skill when managing a tractor/farm-machinery export business website. Covers: product listing creation, image optimization, SEO for international markets, search engine submission, and site maintenance workflows.
triggers	["发布新产品","更新图片","SEO 优化","提交搜索引擎","外贸网站运营","tractor export"]

Foreign Trade Operations

Website Overview

Site	Platform	Domain	Canonical	Notes
主站	GitHub Pages + Cloudflare	shengtuo-tractor.com	→ farm-implement.com	已重定向
产品站	GitHub Pages + Cloudflare	farm-implement.com	✅ self	主站，SEO 所有指向这里
SADIN站	GitHub Pages + Cloudflare	sadin-tractor.com	→ farm-implement.com	内容重复，通过 canonical 避免问题
AIV站	本地服务器 + Cloudflare	aiv.qzz.io	✅ self	源码在 /home/ubuntu/wwwroot/

2026-05-18 SEO 优化完成:

• farm-implement.com: canonical/sitemap/OG/JSON-LD 全部指向正式域名 ✅
• sadin-tractor.com: 通过 canonical 指向 farm-implement.com 避免重复内容
• aiv.qzz.io: 独立优化，添加完整 OGP/JSON-LD，源码本地

⚠️ Cloudflare 覆盖 robots.txt：Cloudflare Dashboard 的 Rules 可以覆盖源站 robots.txt。更新后不生效请检查 Cloudflare 设置。

代码库： githubtalk/shengtuo-tractor

重要：SEO canonical 指向

• farm-implement.com — 主站，所有 canonical/OG/sitemap 指向这里
• sadin-tractor.com — 内容相同，通过 canonical 避免重复内容问题
• aiv.qzz.io — 独立站，有自己的源码和 sitemap

⚠️ GitHub Pages 部署需要 ~5分钟，不是 1-2 分钟。推送后不能立即验证。

源文件路径

站点	源文件位置	部署方式
farm/sadin	/tmp/shengtuo-tractor/ (git clone) 或 /home/ubuntu/shengtuo-tractor/	GitHub Pages
aiv.qzz.io	/home/ubuntu/wwwroot/	FTP上传到 Windows 主机

---

Product Listing Workflow

1. 准备产品图片

图片规范（参考 compress-images.js）：

# 压缩所有图片（已配置）
node compress-images.js

# 手动压缩单张（可选）
# - JPG: quality 75-80, progressive
# - PNG: compressionLevel 9
# - 最大尺寸: 1200x800px
# - 产品图建议: 800x600px

命名规范： 产品型号-角度-序号.jpg 例：ST904-侧面-1.jpg、MF904-正面-2.jpg

2. 添加产品页面

产品页面存放路径：/products/ 目录

每个产品页面需包含：

• 产品型号、名称（英文）
• 主要参数表格（发动机、功率、工作效率）
• 产品图片（带 alt 英文描述）
• PDF规格书下载链接（如有）
• 询盘按钮链接（mailto 或表单）

3. 更新 sitemap

生成 sitemap 后确保：

• 所有产品页面链接正确
• lastmod 更新为当天日期
• priority 按重要性：首页 1.0，产品列表 0.8，单品 0.6

---

Image Optimization Script

路径：/home/ubuntu/shengtuo-tractor/compress-images.js

用法：

cd /home/ubuntu/shengtuo-tractor
node compress-images.js

输出： 报告压缩文件数 + 节省空间

---

SEO Checklist

每次发布新产品后必做

• 产品标题含核心关键词（英文）
• 产品描述含长尾关键词（至少 3 处自然出现）
• 图片有 alt 英文描述
• sitemap 更新并提交
• Google Search Console 提交 URL
• Bing Webmaster 提交 URL
• Yandex Webmaster 提交 URL（如面向俄语市场）
• Baidu Webmaster 提交 URL（如面向中国市场）

Meta Tags（各平台验证）

平台	Tag	位置
Google	coJuNSF-ATVY_yxIm1lR6a4DphP3zTWYrzKABqat_Wg	index.html
Baidu	codeva-NbRNAmGaEy (shengtuo-tractor.com)	index.html
Baidu	codeva-1ecpfnMFSE (farm-implement.com)	index.html
Yandex	3fdba79f71c66d1b	index.html

---

Search Engine Submission

Google Search Console

URL: https://search.google.com/search-console

• 提交 sitemap: https://www.shengtuo-tractor.com/sitemap.xml
• 检测覆盖率错误
• 查看关键词排名

Bing Webmaster

URL: https://www.bing.com/webmasters

• 需注册/登录 Microsoft 账户
• 支持扫码验证

Yandex Webmaster

URL: https://webmaster.yandex.com

• 适合俄语、中亚、欧洲市场

Baidu Webmaster

URL: https://ziyuan.baidu.com

• 中国市场必备
• 支持 HTML 文件验证或 Meta 标签验证

---

SEO 优化标准流程（GitHub Pages）

当修改 GitHub Pages 站点时，所有 SEO 相关文件必须同步更新：

必须更新的 4 个文件

cd /home/ubuntu/shengtuo-tractor

# 1. index.html - canonical/OG/JSON-LD/sitemap/robots.txt
sed -i 's|old-domain|new-domain|g' index.html

# 2. categories.html（如有）
sed -i 's|old-domain|new-domain|g' categories.html

# 3. sitemap.xml
# 手动更新 <loc> 标签中的域名

# 4. robots.txt
# 更新 Sitemap 行

GitHub Pages 部署流程

# 1. 修改文件
git add .
git commit -m "SEO update: canonical/OG/JSON-LD"

# 2. 推送到 GitHub（如有冲突）
git pull --rebase origin master
# 如有冲突：
# - 解决冲突
# - git add .
# - git rebase --skip  # 当无法设置 EDITOR 时用 skip

# 3. 推送
git push origin master

# 4. 等待 ~5 分钟生效
# 验证：curl https://raw.githubusercontent.com/USER/REPO/master/robots.txt

AIV 站优化流程（本地服务器）

# 源文件在 /home/ubuntu/wwwroot/
# nginx root 已配置为 /home/ubuntu/wwwroot
# 修改后直接生效（无需上传）

# 更新包打包（需手动上传到其他服务器时）：
tar -czvf /tmp/aiv_seo_update.tar.gz index.html robots.txt sitemap.xml

域名绑定状态

• shengtuo-tractor.com → Cloudflare DNS，CNAME 指向源站
• farm-implement.com → GitHub Pages custom domain
• sadin-tractor.com → GitHub Pages custom domain（fork 仓库）

注意： GitHub Pages 如使用自定义域名，Enforce HTTPS 选项在 GitHub 后台可能不可点击（正常），由 Cloudflare 处理 HTTPS 跳转。

---

产品描述模板

英文产品描述结构（用于 SEO）：

<!-- 产品标题 -->
<h1>[型号] Agricultural [产品类型] for Sale</h1>

<!-- 产品描述段落 -->
<p>The [型号] is a high-performance agricultural [产品类型] designed for
[主要应用场景]. Featuring [核心参数], it delivers reliable performance
in [适用地形/作物类型] operations across [目标市场].</p>

<!-- 参数列表 -->
<ul>
  <li><strong>Engine:</strong> [发动机型号]</li>
  <li><strong>Power:</strong> [功率] HP</li>
  <li><strong>Working Width:</strong> [工作宽度]</li>
  <li><strong>Application:</strong> [适用场景]</li>
</ul>

<!-- 关键词自然分布 -->
<p>This [产品类型] is ideal for [目标国家/地区] farmers looking for
cost-effective farming equipment. Competitive price, fast delivery,
and [其他卖点].</p>

---

市场关键词参考

市场	高频搜索词
东南亚	tractor price, agricultural tractor, 4WD tractor
非洲	tractor for sale, farm equipment, affordable tractor
欧洲	agricultural machinery, farm tractor, CE certified
南美	tractor agrícola, equipo de granja, tractor económico
中东	farming equipment, agricultural implements

---

常见问题

图片太大会影响加载速度

运行 node compress-images.js 批量压缩，建议单图 ≤ 200KB。

sitemap 更新后搜索引擎没更新收录

手动到各平台 Search Console 提交 URL 或重新提交 sitemap，通常 3-7 天更新。

Cloudflare HTTPS 525 错误

检查源站是否有有效 SSL 证书。无独立 IP 的共享主机建议使用 Cloudflare Flexible SSL 模式。

Baidu 验证失败

确保验证文件正确上传到服务器根目录，或使用 Meta 标签验证方式（直接添加到 index.html 最优）。

---

工具路径速查

工具	路径
图片压缩脚本	/home/ubuntu/shengtuo-tractor/compress-images.js
sitemap	/home/ubuntu/shengtuo-tractor/sitemap.xml
主页	/home/ubuntu/shengtuo-tractor/index.html
GitHub 仓库	https://github.com/githubtalk/shengtuo-tractor
Cloudflare	https://dash.cloudflare.com

---

报价单翻译工作流

将盛拓农机报价单（.docx）翻译为法语、西班牙语等版本，保持格式不变。

盛拓报价单结构（实际文档）

共有 13个表格，按马力段分布：

表格	产品系列	马力范围
Table 0	TS170-ST200	17-20HP
Table 1	ST254Y-ST504Y	25-50HP
Table 2	ST304-ST504	30-50HP
Table 3	ST504D MINI.GARDEN	50HP
Table 4	ST504-ST704 GARDEN	50-70HP
Table 5	ST504-ST704	50-70HP
Table 6	ST604-ST704	60-70HP
Table 7	ST504B-ST1004B	50-100HP
Table 8	ST904-ST1304	90-130HP
Table 9	ST1404-ST1804	140-180HP
Table 10	ST2004-ST2104	200-210HP
Table 11	ST2204-ST2404	220-240HP
Table 12	ST2604	260HP

段落内容（需翻译）：

• Paragraph 1: 公司介绍（长段落，包含多句）
• Paragraph 2: "We are looking forward to cooperating with you!"

不翻译内容：

• Heading 1: 文档标题（"Shengtuo" Company Profile...）
• Heading 3: "Get in Touch:" / "Follow Us for Updates & Videos:"
• 联系信息段落（人名 Henry、电话、邮箱、地址、社交媒体）

扩展技术词汇（英→法）

英文	法语
2WD / TWO WHEEL DRIVE	2RM / DEUX ROUES MOTRICES
4WD / FOUR WHEEL DRIVE	4RM / QUATRE ROUES MOTRICES
Type de roues	Type de roues
Empattement	wheel base
Garde au sol	Ground Clearance
Masse	Structure mass
Lest roue avant/arrière	Front/Rear Wheel ballast
Marque moteur	Engine Brand
Type moteur	Engine Type
Carburant	Fuel
Gasole	Diesel oil
Pneumatique	Tyre
Roue avant/arrière	Front/Rear wheel
Embrayage mono-disque	Single-stage clutch
Direction mécanique	Mechanical steering
Direction assistée	Power steering
Boîte de vitesses	Transmission box
Méthode de transmission	Transmission method
Courroie trapézoïdale	V-belt
Suspension trois points	Tri-point suspension
PDF latérale / Prise de force	SIDE PTO
Type semi-indépendant	Semi-indenendent type
Cadre métallique	iron frame
Conteneur	container
Conteneur 40'	40' container / 40HQ
Tracteur de jardin	Garden tractor
Mini tracteur	Mini tractor
AVEC CABINE	CABIN ADD
CLIMATISATION	A/C
PDF AVANT ET SUSPENSION	FRONT PTO AND SUSPENSION
ARCEAU	ROPS
Toit solaire	Sun canopy
INVERSEUR	SHUTTLE SHIFTS
Secteur denté	Gear sector
REFROIDISSEUR	water cooled

段落翻译示例（公司介绍）

原文：

Shandong Shengtuo Heavy Industry Co.,Ltd.(short for Shengtuo) is a high-level agricultural equipment manufacturer. Shengtuo is located in Weifang City Shandong province, with investment amount of one hundred million Yuan, covers an area of 25,000 square meters, The annual production capacity is 15,000 sets of agricultural machines. The main product is tractor of 25hp--260hp. All the tractor models have been in the List of Government subsidies. Shengtuo has marketing network all over the China, and the tractors have been exported to more than 20 countries. Shengtuo, believes in "honesty, innovation, quality and win-win", for us, the responsibility is the most important, and we will never change the first mind to con-centrate on making tractors, to push the modern Mechanized agriculture!

译文：

Shandong Shengtuo Heavy Industry Co., Ltd. (abréviation : Shengtuo) est un fabricant d'équipements agricoles de haut niveau. Shengtuo est situé dans la ville de Weifang, province du Shandong, avec un investissement de cent millions de yuans, couvrant une superficie de 25 000 mètres carrés. La capacité de production annuelle est de 15 000 ensembles de machines agricoles. Le produit principal est le tracteur de 25 à 260 ch. Tous les modèles de tracteurs sont inscrits sur la liste des subventions gouvernementales. Shengtuo dispose d'un réseau commercial dans toute la Chine, et les tracteurs ont été exportés vers plus de 20 pays. Shengtuo croit en « honnêteté, innovation, qualité et gain partagé » ; pour nous, la responsabilité est la plus importante, et nous ne changerons jamais notre engagement à nous concentrer sur la fabrication de tracteurs, pour promouvoir l'agriculture mécanisée moderne !

Python 环境注意

关键发现： Hermes Agent 的 venv 在 /home/ubuntu/.hermes/hermes-agent/venv/bin/python3 没有 python-docx。系统 Python 在 /usr/bin/python3 有（通过 pip install --user 安装）。

运行翻译脚本必须用：

/usr/bin/python3 /path/to/translate_script.py

不要用 hermes-agent 的 venv Python，会报 ModuleNotFoundError: No module named 'docx'。

翻译脚本模板

#!/usr/bin/env python3
"""Translate document to target language"""

from docx import Document

TRANSLATIONS = {
    # 原文: 译文
    "Original English text": "Translated text",
}

def translate_text(text):
    if not text:
        return text
    for eng, fr in TRANSLATIONS.items():
        if eng in text:
            text = text.replace(eng, fr)
    return text

def process_document(input_path, output_path):
    doc = Document(input_path)
    
    for para in doc.paragraphs:
        # Skip headers
        if para.style and 'Heading' in para.style.name:
            continue
        original = para.text
        if original.strip():
            translated = translate_text(original)
            if translated != original:
                for run in para.runs:
                    run.text = ""
                para.runs[0].text = translated if para.runs else translated
    
    for table in doc.tables:
        for row in table.rows:
            for cell in row.cells:
                for para in cell.paragraphs:
                     para.style    para.style.name:
                        
                    original = para.text.strip()
                     original:
                        translated = translate_text(original)
                         translated != original:
                             run  para.runs:
                                run.text = 
                            para.runs[].text = translated  para.runs  translated
    
    doc.save(output_path)

 __name__ == :
     sys
    input_file = sys.argv[]
    output_file = sys.argv[]
    process_document(input_file, output_file)

运行：

/usr/bin/python3 translate_doc.py input.docx output.docx

关键原则

1. 参数标签翻译：Horsepower → Puissance，但数值和单位保留
2. 型号名称不翻译：TS904、ST504D 等保持原样
3. 价格不翻译：US$、FOB QINGDAO 保留
4. 技术规格不翻译：发动机品牌、型号、轮胎规格等
5. 人名/联系信息不翻译：Henry、电话、邮箱、地址
6. 页眉不翻译：Heading 样式跳过

---

⚠️ 关键原则：SEO/美化 ≠ 重设计

当用户要求 "SEO优化" 或 "外形美观" 时，不要替换产品结构。只做：

• 增强 CSS（hover 效果、阴影、过渡动画）
• 添加/改进结构化数据（Schema.org）
• 添加 hreflang、geo meta 标签
• 更新 sitemap.xml

不要做：

• 把产品表格改成卡片布局
• 删除或重组原有内容区块
• 替换整个 HTML 文件

用户原话："不要动原来的产品结构" — 这是明确的偏好，必须遵守。

正确做法： 用 patch 工具对 index.html 做局部修改，不要用 write_file 整体替换。

---

网站全面重设计流程

当用户明确要求全面重设计（不仅仅是 SEO/美化）时，才使用以下流程：

设计模式（工业/B2B 网站）

Hero 区域：

• 渐变背景（深色到亮色）
• 动画标题 + 打字效果
• 徽章标签（如 "Trusted by 50+ Countries"）
• 统计数字动画（15+ Years, 50+ Countries）
• 双按钮布局（主 CTA + 次 CTA）

产品展示：

• 卡片布局替代表格（更美观）
• 产品图片 + 徽章（Popular/Heavy Duty）
• 规格标签（HP, 4WD, Diesel）
• 特性列表（✓ Easy Operation）
• 双按钮（Get Quote + Learn More）

信任模块：

• 客户评价卡片（头像 + 引用 + 公司信息）
• Why Choose Us 特性网格
• 认证徽章（CE, ISO）

联系区域：

• 左侧联系信息 + 右侧询价表单
• WhatsApp 浮动按钮（右下角）
• 营业时间显示

SEO 增强模式

Schema.org 结构化数据（必须包含）：

{
  "@type": "Organization",     // 公司信息
  "@type": "WebSite",          // 网站信息
  "@type": "WebPage",          // 页面信息
  "@type": "BreadcrumbList",   // 面包屑导航
  "@type": "Product",          // 产品信息
  "@type": "FAQPage"           // 常见问题
}

hreflang 多语言标签：

<link rel="alternate" hreflang="en" href="https://example.com/">
<link rel="alternate" hreflang="zh" href="https://example.com/zh/">
<link rel="alternate" hreflang="x-default" href="https://example.com/">

Open Graph 增强：

<meta property="og:locale:alternate" content="zh_CN">
<meta property="og:site_name" content="Brand Name">

GitHub Pages 完全重设计推送

当进行完全重设计时，可能遇到合并冲突。使用 force push：

# 1. 尝试正常推送
git push origin master

# 2. 如果被拒绝（有冲突），先 rebase
git pull origin master --rebase

# 3. 如果 rebase 有冲突且是完全重设计，abort 并 force push
git rebase --abort
git push origin master --force

⚠️ 注意：Force push 会覆盖远程的所有更改。只在完全重设计时使用。

部署验证

# GitHub Pages 部署需要 ~5 分钟
# 验证方式：
# 1. 直接访问 GitHub raw 文件
curl https://raw.githubusercontent.com/USER/REPO/master/index.html

# 2. 检查 CNAME 文件
cat CNAME  # 确认域名正确

# 3. 等待后访问网站
# 注意：可能重定向到自定义域名