SpamJudge

SpamJudge uses AI large language models to automatically detect and filter spam comments.

Features

• Supports any API compatible with the OpenAI format
• Supports both /v1/chat/completions and /v1/response endpoints
• Customizable AI prompts to adjust scoring criteria based on the characteristics of the website
• Configurable score thresholds for flexible control over filtering intensity
• Detailed logging to track the processing of each comment

Workflow

1. Visitor submits a comment
2. The plugin intercepts the comment and sends it to the AI for scoring
3. The AI returns a score between 0 and 100 (0 = spam, 100 = high quality)
4. The comment is automatically processed based on the score and threshold:
   • Score >= threshold: approved
   • Score < threshold: moved to spam or moved to moderation based on settings
   • Timeout/error: moved to moderation or directly approved based on settings
5. Detailed logs are recorded for administrators to review

Default system prompt in the current version

You are a spam comment detection system. Your ONLY task is to output a single number between 0 and 100.

SCORING RULES:
- 0-20: Obvious spam (ads, malicious links, gibberish)
- 21-40: Likely spam (suspicious links, bot-like comments)
- 41-60: Uncertain (short comments, borderline content)
- 61-80: Likely legitimate (relevant, thoughtful)
- 81-100: Clearly legitimate (detailed, helpful, on-topic)

CRITICAL INSTRUCTIONS:
1. Output ONLY a number (0-100)
2. NO explanations
3. NO additional text
4. NO punctuation
5. Just the number

Example valid outputs: 85
Example INVALID outputs: "Score: 85", "85 points", "I think it's 85"

If you output anything other than a single number, the system will fail.

Automatic installation

1. Log in to the WordPress admin dashboard
2. Navigate to “Plugins” > “Add New”
3. Search for “SpamJudge”
4. Click “Install Now”
5. After installation is complete, click “Activate”

Manual installation

1. Download the plugin zip file
2. Log in to the WordPress admin dashboard
3. Go to “Plugins” > “Add New” > “Upload Plugin”
4. Select the downloaded zip file
5. Click “Install Now”
6. After the installation is complete, click “Activate”

FTP Installation

1. Unzip the plugin zip file
2. Upload the spamjudge folder to the /wp-content/plugins/ directory via FTP
3. Log in to the WordPress admin dashboard
4. Go to the “Plugins” page
5. Locate “SpamJudge” and click “Activate”

1. 

   Log interface

2. 

   Settings interface

1.1.0（2025-12-03）

• Compatible with the /v1/responses endpoint
• Endpoint URL auto-completion
• Deprecation of “temperature”

1.0.0（2025-11-01）

• First version