返回文档列表

Strapi AI Publisher 使用文档

基于 AI 的内容生成器与多语言发布系统，专为 Strapi CMS 设计：自动生成内容、翻译多语言、SEO 优化、图片生成与智能调度。

🚀 快速开始

系统要求

  • Node.js：18+
  • Strapi：v4+（兼容 v5 的 documentId / localizations 场景）
  • OpenAI API Key：用于内容生成/翻译/SEO 标签/（可选）图片相关能力
  • 数据库：SQLite / MySQL / PostgreSQL（任选其一）

安装步骤（本地快速跑起来）

  1. 安装依赖
npm install
  1. 配置环境变量
cp config.env.example .env

常用配置项示例：

# OpenAI
OPENAI_API_KEY=your_openai_api_key
OPENAI_API_URL=https://api.openai.com/v1/chat/completions
OPENAI_MODEL=gpt-3.5-turbo

# Strapi
STRAPI_URL=http://localhost:1337
STRAPI_API_TOKEN=your_strapi_api_token

# Database
DB_TYPE=sqlite
DB_PATH=./data/database.sqlite

# Web
PORT=3000
  1. 初始化数据库
npm run init-db
  1. 启动服务
npm start
  1. 打开管理仪表板
  • 默认地址：http://localhost:3000

🧩 核心能力说明

1) AI 内容生成

  • 标题生成：支持主题随机/自定义、关键词注入、一次生成多个候选
  • 正文生成：支持模板化提示词、最小字数/Token 控制、Markdown 结构保持
  • 摘要与描述：自动生成 description（可限制最大长度）

2) SEO 优化

  • SEO 标签生成：支持 AI 生成（推荐）与简单算法（备用）
  • Slug 生成：
    • 支持中文转拼音
    • 冲突自动处理（追加随机后缀）
    • 策略：same（各语言相同 slug）/ localeSuffix（默认，附语言后缀）

3) 多语言发布

  • 支持 11+ 语言（简中/繁中、日/韩、法/德/西/意/葡/俄/阿等）
  • 翻译保持 Markdown 结构（标题/正文/摘要/图片 alt 等）
  • 支持跨语言共享媒体（可配置）

4) 图片生成（可选）

  • 支持特色图、内容配图生成
  • 自动上传到 Strapi 媒体库，并可插入到 Markdown 内容中

5) 调度与监控

  • 支持自动化调度（定时生成/发布）
  • 通过 SSE 实时监控生成进度与状态
  • 提供统计与日志，便于运营与排错

🔧 Strapi 字段映射（重要）

你可以配置内容字段如何映射到你的 Strapi 内容类型字段，例如：

{
  "title": "title",
  "content": "body",
  "summary": "description",
  "featuredImage": "media",
  "tags": "tags",
  "category": "category"
}

建议在接入前先在 Strapi 里确认：

  • 内容类型字段名称是否一致（如 body/description/slug）
  • 分类、标签、媒体字段类型是否正确
  • 多语言插件是否启用（若需要多语言发布）

🧭 常用工作流

手动生成（适合运营同学）

  • 在仪表板配置好 OpenAI / Strapi / 字段映射
  • 选择主题/关键词 → 手动触发生成 → 查看进度 → 发布到 Strapi

自动调度（适合持续内容生产）

  • 配置调度规则（生成频率、目标语言、是否生成图片等）
  • 运行后通过 SSE/统计面板监控成功率与错误

🧪 常见问题（FAQ）

Q1：为什么写入 Strapi 失败？

  • 检查 STRAPI_URL 是否可访问
  • 检查 STRAPI_API_TOKEN 权限是否包含对应内容类型的读写权限
  • 检查字段映射（body/description/category/tags/media）是否与内容类型一致

Q2：多语言发布失败或关联不对？

  • 确认 Strapi 多语言插件启用
  • 确认内容类型支持本地化（localized）
  • 检查 slug 策略（是否需要统一 slug 便于语言切换）

🔗 相关链接

  • 产品页：/products/strapi-ai-publisher/
  • 更新日志：/（本站的更新日志文件位于 src/content/changelog/strapi-ai-publisher.md）