01 · 安装与首次配置
目标:装好插件、打开控制台、完成主人与群组基础配置。
📦 安装插件
获取完整的
XiaoLin.ZLPartnerPicker.uniqq插件包(官网或官方群下载)。将插件包放入 UniQQ 的
Plugins目录,或在插件管理中直接安装。启动 / 重启 UniQQ,在插件管理中启用 ZL-抽老婆插件。
首次启用会自动在插件数据目录生成默认配置
config.json,无需手动建文件。
⚠️ 必须使用完整插件包;运行环境要求 .NET 10 桌面运行时与 Microsoft Edge WebView2 Runtime(缺一会在日志中提示)。
🖥️ 打开控制台
入口:插件管理 → ZL-抽老婆插件 → 设置。
控制台为独立窗口(WebView2),左侧导航共 7 页:
📊 仪表盘
🎛️ 玩法配置
👥 分群配置
🗂️ 数据管理
📣 播报文案
📑 指令菜单
ℹ️ 关于
👑 配置主人(管理员)
进入 指令菜单 → 主人设置。
填写主人 QQ 号(一行一个或逗号分隔,可配置多个)。
点右上角 保存配置。
主人权限:
✅ 跨群使用重置类指令(重置记录、重置强娶时间、重置求婚时间)。
✅ 排查问题时无需群管理员身份。
群管理员本身也拥有本群重置类指令权限;主人是"跨群管理员"。
🚦 群组启用方式
三种模式二选一(在"玩法配置"页底部):
| 模式 | 配置方式 | 说明 |
|---|---|---|
| 全群启用 | 开启"启用所有群"(默认) | 所有群都响应指令,再配合黑名单排除 |
| 白名单 | 关闭"启用所有群" + 填写启用群号 | 只有名单内的群响应 |
| 黑名单 | 填写黑名单群号 | 名单内的群永不响应,优先级最高 |
💡 单个群的精细开关请用 分群配置 页(见
04-分群配置与黑白名单.md)。
🤖 多机器人用户注意(0.0.5+):同一框架登录多个机器人时,请到「玩法配置 → 机器人接管」填入本实例要执玩的机器人 QQ,名单外的机器人不再响应老婆指令,避免重复回复。详见
03-控制台玩法配置.md。
🗂️ 数据目录
配置文件:
config.json(所有玩法数值、开关、模板都在这里)。玩法数据:每群关系记录、活跃池、冷却与好感数据由插件自动维护。
备份:数据管理 页支持一键备份,详见
09-插件更新与版本日志.md。
✅ 首次配置检查清单
插件已启用,控制台能打开且页面不空白
已填写主人 QQ
已确认群组启用方式(全群 白名单 黑名单)
在目标群发送"今日老婆"能正常回复并 @ 双方
发送"老婆菜单"能弹出指令主菜单