foxxmd/context-mod

Reddit事件驱动型Moderation机器人镜像

概述

本镜像提供一个基于snoowrap库开发的事件驱动型Reddit社区管理机器人，旨在通过自动化处理Reddit平台的内容审核、用户互动管理等moderation任务，帮助社区管理员提升管理效率，降低人工操作成本。

核心功能与特性

• 事件驱动架构：实时响应Reddit平台事件（如新帖子发布、评论提交、用户举报等）
• 基于snoowrap库：利用Reddit官方API客户端库snoowrap实现与Reddit平台的稳定交互
• 自动化Moderation任务：支持内容过滤、违规处理、用户管理、规则执行等核心moderation功能
• 可配置规则系统：允许通过规则文件自定义moderation策略，适应不同社区需求
• 轻量级设计：优化资源占用，支持容器化部署，易于集成到现有管理流程

使用场景

• Reddit社区管理员需要自动化处理日常内容审核工作
• 大型Reddit社区需要7×24小时不间断监控和管理
• 需要标准化、规则化处理社区内容的场景
• 希望减少人工moderation工作量，提高响应速度的社区

使用方法

前提条件

• 拥有Reddit开发者账号并创建应用，获取API凭证（Client ID和Client Secret）
• 拥有具备moderator权限的Reddit账号
• 已安装Docker环境

Docker Run部署示例

bash
docker run -d \
  --name reddit-mod-bot \
  -e REDDIT_CLIENT_ID="your_client_id_here" \
  -e REDDIT_CLIENT_SECRET="your_client_secret_here" \
  -e REDDIT_USER_AGENT="mod-bot/1.0 by your_username" \
  -e REDDIT_USERNAME="your_reddit_username" \
  -e REDDIT_PASSWORD="your_reddit_password" \
  -v /local/path/to/rules.json:/app/rules.json \
  [镜像名称]:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  reddit-mod-bot:
    image: docker.xuanyuan.run/[镜像名称]:latest
    container_name: reddit-mod-bot
    restart: unless-stopped
    environment:
      - REDDIT_CLIENT_ID=your_client_id_here
      - REDDIT_CLIENT_SECRET=your_client_secret_here
      - REDDIT_USER_AGENT=mod-bot/1.0 by your_username
      - REDDIT_USERNAME=your_reddit_username
      - REDDIT_PASSWORD=your_reddit_password
      - RULES_PATH=/app/rules.json
    volumes:
      - ./rules.json:/app/rules.json
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

环境变量配置说明

规则配置文件格式

规则文件采用JSON格式，支持配置帖子规则和评论规则，示例如下：

json
{
  "postRules": [
    {
      "name": "prohibitedKeywords",
      "trigger": "titleOrBodyContains",
      "keywords": ["spam", "advertisement", "scam"],
      "action": "remove",
      "notifyUser": true,
      "notificationMessage": "您的帖子因包含违规内容已被移除。",
      "reportReason": "违反社区内容政策"
    },
    {
      "name": "nsfwContent",
      "trigger": "isNSFW",
      "action": "flair",
      "flairText": "NSFW",
      "flairCSSClass": "nsfw-tag"
    }
  ],
  "commentRules": [
    {
      "name": "hateSpeech",
      "trigger": "containsRegex",
      "pattern": "(racist|homophobic|xenophobic)",
      "action": "removeAndBan",
      "banDuration": 30,
      "banReason": "发表仇恨言论"
    }
  ]
}

注意事项

• 确保Reddit账号具有目标社区的moderator权限
• 妥善保管API凭证和账号密码，避免泄露
• 初次使用建议先在测试社区验证规则配置，避免误操作
• 定期更新镜像以获取最新功能和安全修复