Xenon Comment Review Agent

Xenon Comment Review Agent uses AI Agent technology to automatically review and moderate comments on your WordPress site. The AI analyzes each comment in context and autonomously decides whether to approve, reject, or flag it for human review.

Key Features:

• 🤖 AI Agent Mode — AI uses function calling (tool use) to autonomously make moderation decisions
• ⚡ Async Queue Processing — Comments are moderated in the background via WP-Cron, zero impact on page load
• 🔌 Extensible AI Providers — OpenAI built-in, architecture supports adding Gemini, DeepSeek, and more
• 📊 Statistics Dashboard — Track approval, rejection, and flag rates at a glance
• 📝 Audit Log — Detailed logging of every moderation decision with reason, model, and token usage
• 🌐 Multi-Language UI — Chinese and English interface, easily extensible to more languages
• ⚙️ Customizable System Prompt — Full control over how the AI evaluates comments
• 🛡️ Prompt Injection Protection — Visitor data is isolated inside a fence carrying a per-request random token, so a comment cannot impersonate an instruction. Built-in detection patterns can be extended with your own, and a detected comment can be held for human review instead of being auto-approved
• 🧹 Smart Rules — Skip admin comments, configurable queue interval, auto-cleanup old records

How It Works:

1. A visitor submits a comment
2. The comment enters the moderation queue, which schedules a review straight away
3. The AI Agent reviews the comment, usually within seconds of submission; a recurring sweep picks up anything the immediate run missed
4. The AI analyzes context (comment content, article title, author info) and decides:
   • ✅ Approve — Genuine, relevant comment → Published
   • 🚫 Reject — Spam, hate speech, or harmful → Trash
   • ⚠️ Flag — Uncertain, needs human review → Stays pending

Supported AI Providers:

• OpenAI (GPT-4o Mini, GPT-4o, GPT-4, etc.)
• Any OpenAI-compatible API (via custom Base URL)

External Services

This plugin connects to third-party AI API services to perform comment moderation analysis.

OpenAI API

This plugin sends comment data to the OpenAI API (or a compatible API endpoint configured by the user) for AI-powered moderation analysis.

What data is sent: * Comment content (text) * Comment author name, email, and IP address * Post title, and the first 100 words of the post content (for context) * Parent comment content, when the comment is a reply and the parent is already published

Each field is truncated before it is sent: 4000 characters for the comment, 1500 for the post extract, 1000 for the parent comment, and 200 for each of the author fields.

When data is sent: * Data is sent when the WP-Cron queue processor runs to moderate pending comments * Data is also sent when an administrator manually triggers queue processing or tests the API connection

Service details: * Default API endpoint: https://api.openai.com/v1 * Users can configure a custom API Base URL to use alternative OpenAI-compatible services * OpenAI Terms of Use: https://openai.com/terms/ * OpenAI Privacy Policy: https://openai.com/privacy/

Development

The source code for the compiled JavaScript files in the build/ directory can be found in the src/ directory of this plugin, or on GitHub: https://github.com/Xenon-XG/Xenon-Comment-Review-Agent

To build from source:

1. Run npm install
2. Run npm run build