Listing I18n — 列出ing I18n

列出ing I18n

这个 技能 运行在 OpenClaw 上：

翻译和本地化改写由 OpenClaw 当前会话中的 LLM 完成 模板生成、输入检查、Excel 输出、结果校验由本地 Python 脚本完成

不要把这个 技能 当成独立翻译程序。它是“LLM 工作流 + 本地辅助脚本”的组合。

可用脚本 python3 生成_template.py [输出.xlsx] 生成输入模板 python3 inspect_输入.py <输入.xlsx|csv> [--sheet SheetName] 检查输入文件结构，列出字段和样例数据 python3 build_输出.py [输出.xlsx] 按约定 JSON 结构生成最终 Excel python3 验证.py <输出.xlsx> 校验输出文件是否满足平台限制 工作流

• 用户没有产品文件

运行：

python3 生成_template.py

告诉用户填写 Products sheet 第 3 行起的数据，再继续。

• 用户提供了产品文件

先运行：

python3 inspect_输入.py <输入_file>

基于脚本输出完成三件事：

告诉用户检测到的列名和前 3 行样例 确认以下字段映射 如果缺少必填字段，要求用户补齐

必填字段：

product_id brand product_name category specs selling_points keywords_cn package_includes

可选字段：

custom_attributes images_note

• 确认平台和目标市场

如果用户没有特别说明：

平台默认 机器人h 目标市场默认 en_US

支持的目标市场：

en_US en_UK de_DE ja_JP es_ES fr_FR it_IT

• 由 LLM 执行逐产品翻译

对每个产品、每个目标市场、每个平台分别生成内容。

Amazon title 最长 200 chars，建议不超过 150 bullet_point_1 到 bullet_point_5 共 5 条，每条建议 150-250 chars description 建议 150-300 词 backend_keywords 最长 249 bytes，小写、空格分隔、不含品牌名 Shopify title 最长 100 chars description_html 建议 100-400 词，只用基础 HTML 标签 seo_title 最长 70 chars seo_description 最长 320 chars tags 8-15 个，逗号分隔，小写 product_type 英文品类路径，用 > 分隔

翻译要求：

不是直译，要做目标市场本地化 Amazon 偏搜索导向，Shopify 偏品牌叙事 避免绝对化营销词，如 best、#1、guaranteed custom_attributes 的 key 保持英文，value 翻译成目标语言 美国站优先使用美式计量单位；英国、德国、日本按本地习惯表达

• 生成输出文件

先把翻译结果组织成 JSON，再运行：

python3 build_输出.py [输出.xlsx]

输出 workbook 需包含：

Amazon_ sheet Shopify_ sheet Source_CN sheet

Amazon sheet 列顺序必须是：

product_id brand title bullet_point_1 bullet_point_2 bullet_point_3 bullet_point_4 bullet_point_5 description backend_keywords custom_attributes source_product_name

Shopify sheet 列顺序必须是：

product_id brand title description_html seo_title seo_description tags product_type custom_attributes source_product_name

• 校验并汇报

生成 Excel 后运行：

python3 验证.py <输出.xlsx>

向用户汇报：

处理了多少个产品 生成了哪些平台和语言版本 输出文件路径 校验结果中有哪些 error 和 警告 translations.json 结构

build_输出.py 读取如下结构。仓库里还提供了可直接参考的 translations.example.json：

{ "sheets": [ { "name": "Amazon_en_US", "headers": [ "product_id", "brand", "title", "bullet_point_1", "bullet_point_2", "bullet_point_3", "bullet_point_4", "bullet_point_5", "description", "backend_keywords", "custom_attributes", "source_product_name" ], "rows": [ [ "SP-001", "SoundPulse", "SoundPulse Noise Cancelling Earbuds", "【NOISE CANCELLATION】...", "【HI-RES AUDIO】...", "【ALL-DAY COMFORT】...", "【SWEAT RESISTANCE】...", "【IN THE BOX】...", "Long description...", "wireless earbuds bluetooth earbuds sports earbuds", "color:black | connectivity:bluetooth 5.3", "SP-Pro 主动降噪真无线蓝牙耳机" ] ] }, { "name": "Source_CN", "headers": ["product_id", "brand", "product_name"], "rows": [["SP-001", "SoundPulse", "SP-Pro 主动降噪真无线蓝牙耳机"]] } ] }

注意 依赖：python3 和 openpyxl 建议每批不超过 20 个产品 日语和德语输出建议母语者最终复核