Полная документация ниже — автоматически из репозитория smailue/ozon-description-compliance-skill (ветка main). Оригинальные материалы проекта распространяются на условиях его лицензии.

russian-description-compliance

用于 Ozon/Wildberries 的俄语电商商品描述批量合规处理 Skill。

功能

• 从 Excel 第一张工作表的 A 列读取商品描述。
• 输出一列俄语 HTML 描述。
• 保留原始行顺序、重复行、空白行和源单元格内容。
• 清理高风险营销词、绝对化表述、保证性承诺、原厂/正品宣传和占位式文案。
• 将英文、中文及中英混合的描述翻译为自然俄语，同时保留型号、年份、尺寸、材质、颜色、兼容性、料号、数量和包装内容。
• 一行混有多个独立商品时，仅保留第一个商品；同一套装中的组件和规格保留。
• 长型号、料号、年份和安装参数清单合并为可读的一条说明。

处理优化

• 完全相同的源描述只处理一次，重复行直接复用结果。
• 使用 SHA-256 精确源文本缓存，减少重复模型调用并保证重复行一致。
• 大篇幅非俄文描述可先走翻译路径，但仍执行事实保留和合规校验。
• JSON解析失败、空白行以及去除 HTML/空白后仅剩一个数字的行原样保留，跳过后继续处理下一行。
• 只对校验失败的行重新处理，不重复处理整个工作簿。
• 不使用“产品用于其预期目的”等模板化占位说明；源描述没有提供的字段不写入。

文件结构

• SKILL.md：Codex 执行流程和硬性约束。
• references/writing_rules.md：俄语描述写作、事实保留和风险词规则。
• scripts/extract_first_column_xlsx.py：提取 Excel 第一列。
• scripts/preclean_classify.py：预清洗、分类、去重、缓存键和事实提取。
• scripts/validate_compliance.py：输出合规性和事实完整性校验。
• scripts/write_single_column_xlsx.py：生成一列 .xlsx 文件。
• agents/openai.yaml：Skill 在 Codex 中的显示信息。
• LICENSE：MIT license。

输出约定

输出工作簿只有一列，使用俄语 HTML。非跳过行按以下顺序组织可用内容：

1. Особенности
2. Технические характеристики
3. Комплектация
4. Примечание

没有具体事实的字段不生成。跳过行保持源单元格完全不变。

依赖

pip install openpyxl

脚本优先使用标准库读取和写入基础 .xlsx 结构；如需通过 openpyxl 处理复杂工作簿，可使用已安装的 openpyxl。