01 · 安装与首次配置

目标:装好插件、打开控制台、完成主人与群组基础配置。


📦 安装插件

  1. 获取完整的 XiaoLin.ZLPartnerPicker.uniqq 插件包(官网或官方群下载)。

  2. 将插件包放入 UniQQ 的 Plugins 目录,或在插件管理中直接安装。

  3. 启动 / 重启 UniQQ,在插件管理中启用 ZL-抽老婆插件。

  4. 首次启用会自动在插件数据目录生成默认配置 config.json,无需手动建文件。

⚠️ 必须使用完整插件包;运行环境要求 .NET 10 桌面运行时与 Microsoft Edge WebView2 Runtime(缺一会在日志中提示)。

🖥️ 打开控制台

  • 入口:插件管理 → ZL-抽老婆插件 → 设置。

  • 控制台为独立窗口(WebView2),左侧导航共 7 页:

    • 📊 仪表盘

    • 🎛️ 玩法配置

    • 👥 分群配置

    • 🗂️ 数据管理

    • 📣 播报文案

    • 📑 指令菜单

    • ℹ️ 关于

👑 配置主人(管理员)

  1. 进入 指令菜单 → 主人设置。

  2. 填写主人 QQ 号(一行一个或逗号分隔,可配置多个)。

  3. 点右上角 保存配置。

主人权限:

  • ✅ 跨群使用重置类指令(重置记录、重置强娶时间、重置求婚时间)。

  • ✅ 排查问题时无需群管理员身份。

  • 群管理员本身也拥有本群重置类指令权限;主人是"跨群管理员"。

🚦 群组启用方式

三种模式二选一(在"玩法配置"页底部):

模式配置方式说明
全群启用开启"启用所有群"(默认)所有群都响应指令,再配合黑名单排除
白名单关闭"启用所有群" + 填写启用群号只有名单内的群响应
黑名单填写黑名单群号名单内的群永不响应,优先级最高

💡 单个群的精细开关请用 分群配置 页(见 04-分群配置与黑白名单.md)。

🤖 多机器人用户注意(0.0.5+):同一框架登录多个机器人时,请到「玩法配置 → 机器人接管」填入本实例要执玩的机器人 QQ,名单外的机器人不再响应老婆指令,避免重复回复。详见 03-控制台玩法配置.md。

🗂️ 数据目录

  • 配置文件:config.json(所有玩法数值、开关、模板都在这里)。

  • 玩法数据:每群关系记录、活跃池、冷却与好感数据由插件自动维护。

  • 备份:数据管理 页支持一键备份,详见 09-插件更新与版本日志.md。

✅ 首次配置检查清单

  • 插件已启用,控制台能打开且页面不空白

  • 已填写主人 QQ

  • 已确认群组启用方式(全群 白名单 黑名单)

  • 在目标群发送"今日老婆"能正常回复并 @ 双方

  • 发送"老婆菜单"能弹出指令主菜单

共 18 篇 ZL-抽老婆插件 / 安装与首次配置 0 字 0 行 zhangxiaolin
创建 2026-09-26T21:01:08.310697997Z 更新 2026-09-29T04:25:17.325416668Z