Gemini 全能 QQ 机器人部署手册

3. 创建 bot.py
   • 使用 nano bot.py 创建：

import nonebot
from nonebot import on_message
from nonebot.adapters.onebot.v11 import Adapter, Bot, GroupMessageEvent
from memory import get_memory, save_data
import atexit
import datetime
import pytz

# ================= 管理员配置 =================
ADMIN_QQ = 1234567  # 管理员 QQ 号（替换成实际的）
# ==============================================

nonebot.init()
driver = nonebot.get_driver()
driver.register_adapter(Adapter)
atexit.register(save_data)

def unix_to_beijing(timestamp):
    """将时间戳转换为北京时间字符串"""
    dt_utc = datetime.datetime.fromtimestamp(timestamp, pytz.utc)
    dt_bj = dt_utc.astimezone(pytz.timezone('Asia/Shanghai'))
    return dt_bj.strftime("%H:%M:%S")

def get_current_bj_time():
    """获取当前北京时间字符串"""
    return datetime.datetime.now(pytz.timezone('Asia/Shanghai')).strftime("%H:%M:%S")

def is_at_me(bot: Bot, event: GroupMessageEvent) -> bool:
    """判断是否@了机器人"""
    if event.is_tome():
        return True
    for seg in event.message:
        if seg.type == "at" and str(seg.data.get("qq")) == str(bot.self_id):
            return True
    return False

# === 单核处理器 ===
handler = on_message(priority=1, block=True)

@handler.handle()
async def _(bot: Bot, event: GroupMessageEvent):
    # ===== 变量初始化 =====
    user_id = event.user_id
    group_id = event.group_id
    msg = event.get_plaintext().strip()
    mem = get_memory(group_id)  # 获取用户昵称（优先群名片，其次 QQ 昵称，最后用户 ID）
    try:
        info = await bot.get_group_member_info(group_id=group_id, user_id=user_id)
        name = info.get('card') or info.get('nickname') or str(user_id)
    except:
        name = "群友"

    # ===== 核心：统一转小写判断指令前缀（不区分大小写）=====
    msg_lower = msg.lower()  # 转小写，仅用于指令判断

    # 提取指令内容（保留原大小写）
    def get_cmd_content(prefix):
        prefix_len = len(prefix)
        # 精确匹配前缀（原大小写）
        if msg.startswith(prefix):
            return msg[prefix_len:].strip()
        # 兼容大小写的前缀匹配
        elif msg_lower.startswith(prefix.lower()):
            for i in range(len(msg)):
                if msg[i:i+len(prefix)].lower() == prefix.lower():
                    return msg[i+len(prefix):].strip()
        return ""

    # ===== 1. 管理员专属：修改机器人参数 =====
    if msg_lower.startswith("gemini 设置 "):
        cmd_content = get_cmd_content("gemini 设置 ")  # 记录原始消息
        mem.add_message(name, msg, get_current_bj_time())
        save_data()
        reply_msg = ""
        if user_id != ADMIN_QQ:
            reply_msg = "❌ 你没有权限执行此操作！仅管理员可用~"
        else:
            try:
                # 分割指令参数
                cmd_parts = msg.split(" ", 3)
                if len(cmd_parts) != 4:
                    reply_msg = "❌ 指令格式错误！\n正确格式：gemini 设置 参数名 值\n示例：gemini 设置 冷却时间 600"
                else:
                    param_map = {
                        "冷却时间": "COOLDOWN_SECONDS",
                        "插嘴概率": "TRIGGER_PROBABILITY",
                        "复读阈值": "REPEATER_THRESHOLD",
                        "复读概率": "REPEATER_EXEC_PROB",
                        "缓存字数上限": "MEMORY_LIMIT_CHARS",
                        "保留消息数": "MEMORY_KEEP_COUNT"
                    }
                    param_cn = cmd_parts[2]
                    param_value = cmd_parts[3]
                    if param_cn not in param_map:
                        valid_params = "、".join(param_map.keys())
                        reply_msg = f"❌ 参数名错误！\n支持的参数：{valid_params}"
                    else:
                        param_en = param_map[param_cn]
                        # 转换参数值类型
                        if param_en in ["COOLDOWN_SECONDS", "REPEATER_THRESHOLD", "MEMORY_LIMIT_CHARS", "MEMORY_KEEP_COUNT"]:
                            new_value = int(param_value)
                        else:
                            new_value = float(param_value)
                        # 更新参数
                        mem.bot_config[param_en] = new_value
                        save_data()
                        reply_msg = f"✅ 【{group_id}群】参数修改成功！\n{param_cn} = {new_value}"
            except ValueError:
                reply_msg = "❌ 参数值格式错误！\n整数填数字（如 600），概率填小数（如 0.02）"
            except Exception as e:
                reply_msg = f"❌ 修改失败：{str(e)}"
        # 记录并回复
        mem.add_message("Gemini", reply_msg, get_current_bj_time())
        save_data()
        await handler.finish(reply_msg)

    # ===== 2. 全员可用：打卡指令 =====
    elif msg_lower.startswith("gemini 打卡 "):
        content = get_cmd_content("gemini 打卡 ")
        if not content:
            reply_msg = "❌ 打卡内容不能为空哦~比如：「gemini 打卡 篮球」"
        else:
            # 执行打卡（user_id 转字符串确保唯一性）
            mem.checkin(str(user_id), name, content)
            # 生成排行榜
            ranking = mem.generate_checkin_ranking()
            reply_msg = f"✅ {name} 打卡「{content}」成功！\n{ranking}"
        # 记录并回复
        mem.add_message(name, msg, get_current_bj_time())
        mem.add_message("Gemini", reply_msg, get_current_bj_time())
        save_data()
        await handler.finish(reply_msg)

    # ===== 3. 全员可用：删除打卡指令 =====
    elif msg_lower.startswith("gemini 删除 "):
        content = get_cmd_content("gemini 删除 ")
        if not content:
            reply_msg = "❌ 删除内容不能为空哦~比如：「gemini 删除 篮球」"
        else:
            # 执行删除
            success, result = mem.delete_checkin(str(user_id), content)
            if success:
                ranking = mem.generate_checkin_ranking()
                reply_msg = f"{result}\n{ranking}"
            else:
                reply_msg = result
        # 记录并回复
        mem.add_message(name, msg, get_current_bj_time())
        mem.add_message("Gemini", reply_msg, get_current_bj_time())
        save_data()
        await handler.finish(reply_msg)

    # ===== 4. 全员可用：查询排行榜 =====
    elif msg_lower.strip() == "gemini 排行榜":
        # 生成排行榜
        ranking = mem.generate_checkin_ranking()
        reply_msg = f"{ranking}"
        # 记录并回复
        mem.add_message(name, msg, get_current_bj_time())
        mem.add_message("Gemini", reply_msg, get_current_bj_time())
        save_data()
        await handler.finish(reply_msg)

    # ===== 5. 管理员专属：管理他人打卡记录（QQ 号操作）=====
    elif msg_lower.startswith("gemini 管理打卡 "):
        if user_id != ADMIN_QQ:
            reply_msg = "❌ 你没有权限执行此操作！仅管理员可用~"
            mem.add_message(name, msg, get_current_bj_time())
            mem.add_message("Gemini", reply_msg, get_current_bj_time())
            save_data()
            await handler.finish(reply_msg)
        # 提取指令内容
        cmd_content = get_cmd_content("gemini 管理打卡 ")
        if not cmd_content:
            reply_msg = "❌ 指令格式错误！\n正确格式：\ngemini 管理打卡 增加 目标 QQ 号 内容 次数\n示例：gemini 管理打卡 增加 123456 跑步 3\n\ngemini 管理打卡 删除 目标 QQ 号 内容 次数\n示例：gemini 管理打卡 删除 123456 跑步 1"
            mem.add_message(name, msg, get_current_bj_time())
            mem.add_message("Gemini", reply_msg, get_current_bj_time())
            save_data()
            await handler.finish(reply_msg)
        # 分割参数
        cmd_parts = cmd_content.split()
        if len(cmd_parts) != 4:
            reply_msg = "❌ 指令参数不足！\n正确格式：gemini 管理打卡 增加/删除 目标 QQ 号 内容 次数"
            mem.add_message(name, msg, get_current_bj_time())
            mem.add_message("Gemini", reply_msg, get_current_bj_time())
            save_data()
            await handler.finish(reply_msg)
        operation = cmd_parts[0]
        target_qq = cmd_parts[1]
        content = cmd_parts[2]
        count_str = cmd_parts[3]

        # 校验操作类型
        if operation not in ["增加", "删除"]:
            reply_msg = "❌ 操作类型错误！仅支持「增加」或「删除」"
            mem.add_message(name, msg, get_current_bj_time())
            mem.add_message("Gemini", reply_msg, get_current_bj_time())
            save_data()
            await handler.finish(reply_msg)

        # 校验 QQ 号为纯数字
        if not target_qq.isdigit():
            reply_msg = "❌ 目标 QQ 号必须是纯数字！"
            mem.add_message(name, msg, get_current_bj_time())
            mem.add_message("Gemini", reply_msg, get_current_bj_time())
            save_data()
            await handler.finish(reply_msg)

        # 校验次数为正整数
        if not count_str.isdigit() or int(count_str) <= 0:
            reply_msg = "❌ 次数必须是正整数！"
            mem.add_message(name, msg, get_current_bj_time())
            mem.add_message("Gemini", reply_msg, get_current_bj_time())
            save_data()
            await handler.finish(reply_msg)

        count = int(count_str)

        # 获取目标用户昵称（优先群名片，否则用 QQ 号）
        try:
            target_info = await bot.get_group_member_info(group_id=group_id, user_id=target_qq)
            target_name = target_info.get('card') or target_info.get('nickname') or target_qq
        except:
            target_name = target_qq  # 非群成员则显示 QQ 号

        # 执行管理员操作
        op_map = {"增加": "add", "删除": "delete"}
        success, result = mem.admin_checkin(
            target_user_id=str(target_qq),
            target_user_name=target_name,
            content=content,
            count=count,
            operation=op_map[operation]
        )

        # 生成回复（含排行榜）
        if success:
            ranking = mem.generate_checkin_ranking()
            reply_msg = f"{result}\n{ranking}"
        else:
            reply_msg = result

        # 记录并回复
        mem.add_message(name, msg, get_current_bj_time())
        mem.add_message("Gemini", reply_msg, get_current_bj_time())
        save_data()
        await handler.finish(reply_msg)

    # ===== 6. 普通消息处理逻辑 =====
    if not msg:
        msg = " "
    # 记录普通消息
    mem.add_message(name, msg, unix_to_beijing(event.time))
    save_data()

    # 消息压缩逻辑
    await mem.check_and_compress()

    # 主动回复/插话逻辑
    final_reply = None
    if is_at_me(bot, event):
        final_reply = await mem.generate_reply(msg, name, is_active_interrupt=False)
    else:
        should, content = await mem.check_active_intervention(msg)
        if should and content:
            final_reply = content

    # 发送主动回复
    if final_reply:
        mem.add_message("Gemini", final_reply, get_current_bj_time())
        save_data()
        await handler.finish(final_reply)

if __name__ == "__main__":
    nonebot.run(host="0.0.0.0", port=8080)

⚙️ 第四阶段：配置系统服务 (Systemd)

为了实现您要求的命令管理，我们需要创建一个系统服务文件。

加载服务

sudo systemctl daemon-reload
sudo systemctl enable gemini-bot

粘贴内容
(注意：ExecStart 指向了虚拟环境中的 python，确保路径准确)

[Unit]
Description=Gemini QQ Bot Service
After=network.target

[Service]
# 指定用户，通常是 root
User=root
# 你的项目路径
WorkingDirectory=/root/gemini_bot
# 使用虚拟环境的 Python 启动 bot.py
ExecStart=/root/gemini_bot/venv/bin/python bot.py
# 自动重启配置
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

创建服务文件

sudo nano /etc/systemd/system/gemini-bot.service

🖥️ 第五阶段：NapCat 连接 (WebUI)

【避坑重点】：因为我们用了 host 模式，这里的 WS 地址必须填 127.0.0.1。

1. 浏览器访问 NapCat
   访问 http://服务器 IP:6099/webui
   (如果没有 Token，输入 napcat 或查看日志 docker logs napcat)
2. 扫码登录
   使用手机 QQ 扫码。
3. 配置 WebSocket (Reverse)
   • 点击左侧 网络配置 -> WebSocket (Reverse)
   • URL 填写：ws://127.0.0.1:8080/onebot/v11/ws
   • 启用：打钩
   • 点击 保存。

重启 NapCat 生效

docker restart napcat

启动机器人

systemctl start gemini-bot

🎮 最终：管理命令速查表

恭喜！部署完成。以后您只需要使用以下命令管理您的机器人：

(日志中若看到 Connect to 127.0.0.1:8080 或 Received message 即为成功)