ashbuilds/payload-ai

AI Plugin is a powerful extension for the Payload CMS, integrating advanced AI capabilities to enhance content creation and management.

Payload AI 插件 – 概述

是什么：一个为 Payload CMS 添加 AI 驱动的内容生成、编辑、翻译和媒体创建功能的插件。它允许您从任何文本、富文本或上传字段调用大型语言模型（LLM）服务（OpenAI、Anthropic、Google Gemini、MiniMax）以及语音/图像生成器（ElevenLabs、DALL-E）。

为何重要：内容团队可以在不离开 CMS 的情况下，自动化起草、校对、翻译，甚至生成图像或音频，从而保持工作流程快速且一致。

主要功能（如 README 所述）

领域	功能
文本和富文本字段	• 创作 – 从提示生成新内容 • 校对（测试版）– 精炼现有文稿 • 翻译 – 自动语言转换 • 改写（测试版）– 替代表达 • 计划中：扩展、摘要、简化
上传字段	• 语音生成 – 通过 ElevenLabs 和 OpenAI TTS • 图像生成 – 通过 OpenAI DALL-E 和 GPT-Image-1
高级用户控制	• 自带模型 – 连接任何支持的提供方或自定义 OpenAI 兼容端点 • 字段级提示 – 为每个字段定制 AI 指令 • 访问控制 – 限制谁可以调用 AI（例如仅管理员） • 提示编辑器 – UI 用于编辑提示文本 • i18n 支持 – 与多语言 Payload 设置兼容 • 自定义组件 – 使用自己的 React 组件扩展 UI
即将推出	文档分析器、事实核查、自动工作流、编辑器建议、AI 聊天助手

安装与快速入门

# 添加插件包
pnpm add @ai-stack/payloadcms

在 payload.config.ts 中注册插件：

import { payloadAiPlugin } from '@ai-stack/payloadcms'

export default buildConfig({
  plugins: [
    payloadAiPlugin({
      collections: { [Posts.slug]: true },
      debugging: false,
    })
  ],
})

在字段中启用 AI（例如富文本字段）通过添加提供的 Lexical 编辑器功能：

import { PayloadAiPluginLexicalEditorFeature } from '@ai-stack/payloadcms'
// 在字段定义内部
editor: lexicalEditor({
  features: ({ rootFeatures }) => [
    // …其他功能
    PayloadAiPluginLexicalEditorFeature(),
  ],
})

提供 API 密钥 – 可通过 .env 文件或直接在插件配置中提供。支持的密钥包括 OPENAI_API_KEY、ANTHROPIC_API_KEY、GOOGLE_GENERATIVE_AI_API_KEY、MINIMAX_API_KEY 和 ELEVENLABS_API_KEY。
重启服务器（可选运行 payload generate:importmap）。

高级配置亮点

访问控制 – 定义 access.generate 和 access.settings 函数以限制 AI 使用（例如仅管理员）。
参考图像解析器 – 对于包含现有媒体的图像→文本或文本→图像提示，必须提供 resolveReferenceImage 回调函数，该函数需安全地从存储中获取图像 blob，同时遵守权限和大小限制。
多租户 / 自定义媒体上传 – 可通过提供 mediaUpload 函数来覆盖生成媒体的存储方式。
提示种子 – seedPrompts 允许在创建文档时自动为特定字段（例如 SEO 元描述）生成提示。
自定义语言选项 – options.enabledLanguages 控制 AI 功能暴露的区域设置。

文档与支持

演示视频 – 快速（YouTube）介绍插件的实际使用。
完整指南 – guide.md 涵盖自定义模型设置、提示工程和故障排除。
社区 – 加入 Payload Discord 频道获取帮助和讨论。
资助 – 作者接受通过 Buy Me a Coffee 的捐赠。

谁可能使用此插件？

希望加速文案撰写、翻译和媒体创作的 内容团队。
构建基于 Payload 的自定义网站并希望获得 AI 协助但不想自行搭建集成层的 开发者。
管理多租户 Payload 安装并需要按租户分配 AI 凭据和严格访问控制的机构。

所有信息均直接来自仓库的 README；未推断任何额外功能。