ScamScreener for Hypixel SkyBlock - Hypixel SkyBlock 专用 ScamScreener 防骗助手

ScamScreener

ScamScreener 是一个客户端 Fabric mod，用于分析收到的聊天消息、高亮类似诈骗的行为模式，并为你提供结构化的审核流程，帮助你做出更安全的判断。

概览

• 通过多阶段检测管线进行实时聊天风险分析
• 游戏内审核队列，支持按案例为消息打标签
• 提供白名单与黑名单工具，支持命令 + GUI
• 黑名单警报时可选自动执行 /p leave
• 用于后续调优的规范训练导出（training-cases-v2.jsonl）
• 面向集成的公共 API 入口（scamscreener-api）

支持版本与要求

• Minecraft：1.21.10（EOL），1.21.11（EOL），26.1
• Mod 加载器：Fabric Loader >= 0.17
• 依赖：Fabric API
• 环境：仅客户端

安装

• 为你的 Minecraft 版本安装 Fabric Loader。
• 将 ScamScreener 和 Fabric API 放入你的 mods 文件夹。
• 启动游戏。
• 使用 /scamscreener settings（或 /ss settings）打开设置。

快速开始

• 设置你的风险阈值（LOW、MEDIUM、HIGH、CRITICAL）。请注意，在大型公共岛屿上使用 LOW 可能会非常频繁地警告你！
• 像平常一样游玩，让 ScamScreener 监控收到的聊天消息。
• 打开审核队列（/scamscreener review）查看被标记的案例。
• 将案例标记为 RISK、SAFE 或 DISMISSED。
• 如有需要，使用 /scamscreener review export 导出已审核数据。

检测机制

ScamScreener 会通过分阶段管线评估每一条收到的消息：

• 玩家列表阶段（白名单/黑名单精确匹配）
• 确定性规则阶段（链接、紧迫性、平台跳转、支付/账号信号）
• 相似度阶段（模糊短语匹配）
• 行为阶段（发送者本地重复/突发模式）
• 趋势阶段（跨发送者波次检测）
• 漏斗阶段（多步信任 -> 跳转 -> 支付/账号模式）
• 上下文阶段（综合近期同一发送者消息中的信号）
• 静音阶段 / 绕过逻辑

管线结果可能包括 IGNORE、REVIEW、BLOCK、WHITELISTED、BLACKLISTED 或 MUTED。

游戏内命令

根命令：

• /scamscreener ...
• /ss ...（别名）

主要命令组：

• settings、rules、runtime、messages、metrics
• whitelist add/remove/clear
• blacklist add/remove/clear
• review、review player、review manage、review info、review export
• alertlevel
• autoleave on/off
• mute、mute 、unmute、unmute
• debug
• version、help

GUI 概览

主设置界面包括：

• 警报阈值与自动捕获设置
• 自动离开与静音过滤器开关
• 白名单 / 黑名单管理
• 审核队列与审核设置
• 规则、运行时、指标和消息设置

案例审核与训练导出

审核流程：

• 打开队列并选择一个案例。
• 将每条消息标记为 Exclude、Context 或 Signal。
• 将最终结论保存为 Risk、Safe 或 Dismiss。

导出：

• 命令：/scamscreener review export
• 输出文件：config/scamscreener/training-cases-v2.jsonl

重要状态：

• Training Hub 当前尚未上线。
• GUI 中的 Contribute Training Data 按钮目前是有意禁用的。
• 本地导出功能仍然可用且稳定。

配置文件

ScamScreener 将其数据存储在 config/scamscreener/ 中：

• runtime.json（运行时与输出行为）
• rules.json（管线规则配置）
• review.json（审核队列状态）
• whitelist.json（受信任玩家）
• blacklist.json（已屏蔽玩家）
• training-cases-v2.jsonl（手动导出产物）

隐私与数据处理

• ScamScreener 在客户端运行。
• 该 mod 不会自动上传训练数据。
• 审核/训练负载会经过脱敏处理，不会持久保存发送者 UUID 身份。
• 基于 UUID 的持久化被有意限制在白名单/黑名单管理中。

v1 到 v2 迁移

在首次启动 v2 时，ScamScreener 会执行一次性迁移：

• 将旧版白名单/黑名单文件迁移到 v2 配置文件中
• 写入迁移标记 .v1-to-v2-migration.done
• 迁移后清理旧版 v1 配置文件夹产物

现有的 v2 目标文件绝不会被覆盖。

面向其他 Mod 的 API

通过 Fabric 入口点获取 API：

import eu.tango.scamscreener.api.ScamScreenerApi;
import net.fabricmc.loader.api.FabricLoader;

import java.util.List;

List apis = FabricLoader.getInstance()
    .getEntrypoints(ScamScreenerApi.ENTRYPOINT_KEY, ScamScreenerApi.class);

if (!apis.isEmpty()) {
    ScamScreenerApi api = apis.get(0);
}

然后使用共享列表访问和事件：

import eu.tango.scamscreener.api.BlacklistAccess;
import eu.tango.scamscreener.api.WhitelistAccess;
import eu.tango.scamscreener.api.event.BlacklistEvent;
import eu.tango.scamscreener.api.event.PipelineDecisionEvent;
import eu.tango.scamscreener.api.event.WhitelistEvent;

WhitelistAccess whitelist = api.whitelist();
BlacklistAccess blacklist = api.blacklist();

PipelineDecisionEvent.EVENT.register((chatEvent, decision) -> {
    // 对管线决策作出反应
});

WhitelistEvent.EVENT.register((changeType, entry) -> {
    // 当列表被清空时，entry 为 null
});

BlacklistEvent.EVENT.register((changeType, entry) -> {
    // 当列表被清空时，entry 为 null
});