x132204x-web/product-catalog-skill

product-catalog-skill 是做什么的？

一个用于品牌导向产品目录的 Codex 技能，支持准确文案、PDF 渲染和视觉质量检查。

概述

此技能为 Codex 平台提供了一个专业的产品目录生成工作流，专注于品牌一致性。它自动化了文案撰写、PDF 生成和视觉 QA 流程，确保目录在发布前符合高标准。

功能特性

• 品牌导向文案：根据预设品牌指南生成和验证产品描述、标题和营销文本。
• PDF 渲染：将目录内容渲染为可打印或分发的 PDF 文件。
• 视觉质量检查：提供预览和对比工具，以检测布局、对齐或格式问题。
• 多品牌支持：通过配置文件轻松切换不同品牌的样式和内容规则。

使用场景

• 电商平台的产品目录更新
• 零售业的季节性促销册子
• 出版行业的产品宣传册

先决条件

• Codex 平台（版本 1.0 或更高）
• 已安装 Node.js 和 npm
• 访问产品数据源（如 CSV、JSON 或数据库）

安装

1. 克隆仓库：

git clone https://github.com/x132204x-web/product-catalog-skill

2. 安装依赖：

cd product-catalog-skill
npm install

3. 配置环境变量：

在 .env 文件中设置以下变量：

BRAND_NAME=示例品牌
PDF_TEMPLATE_PATH=./templates/default.hbs
OUTPUT_DIR=./output

使用方法

1. 运行技能：

npm start

2. 在浏览器中打开 http://localhost:3000 以查看预览。

3. 使用 UI 上传产品数据或直接通过 API 发送：

curl -X POST http://localhost:3000/generate \
  -H "Content-Type: application/json" \
  -d '{
    "products": [
      {
        "name": "产品 A",
        "price": 99.99,
        "description": "这是产品 A 的描述。"
      }
    ]
  }'

4. 检查输出目录中的 PDF 文件。

自定义

如需修改品牌样式，请编辑 config/brand-config.json：

{
  "primaryColor": "#3498db",
  "fontFamily": "Helvetica, Arial, sans-serif",
  "headerLogo": "./assets/logo.png"
}

贡献

欢迎通过 GitHub Issues 提交功能请求或错误报告。请确保更新测试以覆盖新代码。

许可

该项目采用 MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件。