前言#

在管理自己的QQ群时，尤其是比较偏低龄化的群聊，很容易会有以下小鬼混入：

无脑发各种诡异表情包刷屏的
无脑攻击他人的
无脑发布各种逆天言论的一般人遇到这个小屁孩，通常会用禁言，踢出方式处理，但靠禁言的话，你没办法持续且合理地控制，踢出（和永久禁言）的话，一刀切还觉得没意思

所以我选择Napcat全自动化QQ机器人，利用代码之力持续监控熊孩子的发言行为，并按照规则对这个熊孩子进行处罚~~哈哈哈~~

Napcat插件文件结构介绍#

参考信息：https://github.com/NapNeko/napcat-plugin-template 当然，这个仓库还包含插件简单模板，配合文档可以更快上手插件开发

1
napcat-plugin-template/
2
├── src/
3
│   ├── index.ts              # 插件入口，导出生命周期函数
4
│   ├── config.ts             # 配置定义和 WebUI Schema
5
│   ├── types.ts              # TypeScript 类型定义
6
│   ├── core/
7
│   │   └── state.ts          # 全局状态管理单例
8
│   ├── handlers/
9
│   │   └── message-handler.ts # 消息处理器（命令解析、CD 冷却、消息工具）
10
│   ├── services/
11
│   │   └── api-service.ts    # WebUI API 路由（无认证模式）
12
│   └── webui/                # React SPA 前端（独立构建）
13
│       ├── index.html
14
│       ├── package.json
15
│       ├── vite.config.ts
16
│       ├── tailwind.config.js
17
│       ├── tsconfig.json
18
│       └── src/
19
│           ├── App.tsx           # 应用根组件，页面路由
20
│           ├── main.tsx          # React 入口
21
│           ├── index.css         # TailwindCSS + 自定义样式
22
│           ├── types.ts          # 前端类型定义
23
│           ├── vite-env.d.ts     # Vite 环境声明
24
│           ├── utils/
25
│           │   └── api.ts        # API 请求封装（noAuthFetch / authFetch）
26
│           ├── hooks/
27
│           │   ├── useStatus.ts  # 状态轮询 Hook
28
│           │   ├── useTheme.ts   # 主题切换 Hook
29
│           │   └── useToast.ts   # Toast 通知 Hook
30
│           ├── components/
31
│           │   ├── Sidebar.tsx       # 侧边栏导航
32
│           │   ├── Header.tsx        # 页面头部
33
│           │   ├── ToastContainer.tsx # Toast 通知容器
34
│           │   └── icons.tsx         # SVG 图标组件
35
│           └── pages/
36
│               ├── StatusPage.tsx  # 仪表盘页面
37
│               ├── ConfigPage.tsx  # 配置管理页面
38
│               └── GroupsPage.tsx  # 群管理页面
39
├── .github/
40
│   ├── workflows/
41
│   │   └── release.yml        # CI/CD 自动构建发布
42
│   ├── prompt/
43
│   │   ├── default.md             # 默认 Release Note 模板（回退用）
44
│   │   └── ai-release-note.md     # （可选）AI Release Note 自定义 Prompt
45
│   └── copilot-instructions.md  # Copilot 上下文说明
46
├── package.json
47
├── tsconfig.json
48
├── vite.config.ts             # Vite 构建配置（含资源复制插件）

根据结构图可知，我们的插件目的就是监听，回应消息功能，所以我们只需要处理message-hander.ts就可以了

开始写代码#

如果第一次编辑message-hander.ts（或者其他文件），会看到里面已经有很多代码内容了，我们可以全部删掉

下面是完整代码示例：#

1
import { pluginState } from '../core/state';
2

3
const speakCount: Map<string, number> = new Map();
4
const targetUid = xxxxxx; // 只针对这个用户
5

6
export async function handleMessage(event: any) {
7
    // 优先用 sender.user_id，如果没有就用 event.user_id
8
    const uid = event.sender?.user_id ?? event.user_id;
9
    const gid = event.group_id;
10

11
    if (!uid || !gid) {
12
        console.log("事件对象缺少 uid 或 gid:", event);
13
        return;
14
    }
15
    // 只处理目标用户
16
    if (uid !== targetUid) {
17
        return;
18
    }
19

20
    const key = `${gid}-${uid}`;
21
    const count = (speakCount.get(key) || 0) + 1;
22
    speakCount.set(key, count);
23

24
    console.log(`用户 ${uid} 在群 ${gid} 说话了 ${count} 次`);
25

26
    if (count === 10) {
27
        await pluginState.ctx.actions.call(
28
            'send_msg',
29
            {
30
                message: `用户 ${uid} ，宝宝再说话就要被禁言了哦！`,
31
                message_type: 'group',
32
                group_id: gid,
33
            },
34
            pluginState.ctx.adapterName,
35
            pluginState.ctx.pluginManager.config
36
        );
37
    }
38

39
    if (count > 10) {
40
        await pluginState.ctx.actions.call(
41
            'set_group_ban',
42
            { group_id: gid, user_id: uid, duration: 600 },
43
            pluginState.ctx.adapterName,
44
            pluginState.ctx.pluginManager.config
45
        );
46
        await pluginState.ctx.actions.call(
47
            'send_msg',
48
            {
49
                message: `用户 ${uid} ，宝宝休息时间到啦！休息10分钟来写写作业吧！`,
50
                message_type: 'group',
51
                group_id: gid,
52
            },
53
            pluginState.ctx.adapterName,
54
            pluginState.ctx.pluginManager.config
55
        );
56
        speakCount.delete(key); // 重置计数
57
  }
58
}

这个代码的核心作用就是，统计目标QQ号的人发言次数，若达到10次，则警告一次，若超过10次，就禁言10分钟，并重置计数，特别有意思