域名审核插件 (Domain Moderation Plugin)

一款用于论坛系统的域名审核插件，自动将包含域名链接的帖子和评论标记为待审核状态。

功能特性

• 自动审核：当帖子或评论中包含域名形式的内容时，自动标记为待审核状态
• 黑名单机制：域名黑名单中的域名会被直接拒绝，无需进入审核队列
• 白名单机制：域名白名单中的域名不会触发审核
• 免审核角色：指定角色的用户发布内容不触发审核
• 免审核用户：指定用户发布内容不触发审核
• 用户搜索：支持通过用户名或邮箱搜索并添加免审核用户

安装方法

直接将压缩包上传后台，自动启用

配置说明

基础设置

• 启用域名审核：开关控制插件是否启用

免审核角色

选择哪些角色的用户发布内容时不触发域名审核：

• 管理员 (ADMIN)
• 版主 (MODERATOR)
• 普通用户 (USER)

免审核用户

搜索并添加特定用户，这些用户发布内容时不触发域名审核：

1. 在搜索框输入用户名或邮箱
2. 点击「搜索」按钮或直接回车
3. 在搜索结果中点击「添加」按钮
4. 已添加的用户会显示在下方列表中，可随时移除

域名名单

域名白名单

• 在白名单中的域名不会触发审核
• 支持通配符，如 *.example.com
• 每行一个域名

域名黑名单

• 在黑名单中的域名会被直接拒绝
• 支持通配符，如 *.phishing-site.com
• 每行一个域名

审核流程

1. 检测域名：当帖子或评论创建时，检测内容中是否包含域名
2. 黑名单检查：如果域名在黑名单中，直接拒绝该内容
3. 白名单检查：如果所有域名都在白名单中，不触发审核
4. 角色检查：检查用户角色是否在免审核角色列表中
5. 用户检查：检查用户是否在免审核用户列表中
6. 标记待审核：以上条件都不满足时，将内容标记为待审核状态

技术实现

后端 Hooks

• post.create.after：帖子创建后触发审核
• comment.create.after：评论创建后触发审核

管理 API

文件结构

text
domain-moderation/
├── addon.json                    # 插件清单
├── dist/
│   └── server.mjs               # 服务端逻辑
└── assets/
    ├── domain-moderation-admin.js           # 设置页面入口
    ├── domain-moderation-admin.model.js     # 数据模型
    ├── domain-moderation-admin.controller.js # 控制器
    └── domain-moderation-admin.view.js      # 视图组件

权限需求

插件需要以下权限：

• database:orm - 数据库操作
• api:admin - 管理 API
• hook:register - 注册 Hooks
• config:read - 读取配置
• config:write - 写入配置

使用示例

配置示例

json
{
  "enabled": true,
  "exemptRoles": ["ADMIN", "MODERATOR"],
  "exemptUsers": ["1", "2"],
  "domainWhitelist": ["github.com", "*.example.com"],
  "domainBlacklist": ["spam.com", "*.phishing-site.com"]
}

域名格式支持

注意事项

1. 插件启用后，所有新发布的帖子和评论都会经过域名审核
2. 黑名单域名直接拒绝，不会进入待审核队列
3. 已添加的免审核用户需要保存设置后才生效
4. 建议定期清理不再需要的免审核用户

版本历史

• v1.0.0 - 插件初始，去除所有调试信息