安装与首次配置
本篇目标:装好插件、打开控制台,完成主人权限与群组启用方式两项基础配置。
📦 安装插件
- 从官网或官方交流群获取完整插件包
XiaoLin.ZLPartnerPicker.uniqq。 - 将插件包放入 UniQQ 的
Plugins目录,或在插件管理中直接安装。 - 启动或重启 UniQQ,在插件管理中启用 ZL-抽老婆插件。
- 首次启用会自动在插件数据目录生成默认配置
config.json,无需手动创建文件。
环境要求
必须使用完整插件包。运行环境要求 .NET 10 桌面运行时与 Microsoft Edge WebView2 Runtime,缺失时会在日志中给出提示;控制台页面空白或加载失败,通常即因缺少 WebView2 运行时所致。
🖥️ 打开控制台
入口:插件管理 → ZL-抽老婆插件 → 设置。控制台为独立窗口(WebView2 内核),左侧导航共七页:
| 页面 | 用途 |
|---|---|
| 📊 仪表盘 | 玩法数据总览 |
| 🎛️ 玩法配置 | 抽卡、好感、抢夺、婚姻、榜单全部数值与全局名单 |
| 👥 分群配置 | 单群总开关、模块开关、数值覆盖、排除用户 |
| 🗂️ 数据管理 | 数据查询与一键备份 |
| 📣 播报文案 | 全部播报模板自定义 |
| 📑 指令菜单 | 指令启停、主人设置、自定义菜单 |
| ℹ️ 关于 | 版本信息、一键更新、作者与官方群 |
👑 配置主人
- 进入 指令菜单 → 主人设置。
- 填写主人 QQ 号,一行一个或逗号分隔,可配置多个。
- 点击右上角 保存配置。
主人权限说明:
- ✅ 可跨群使用重置类指令(
重置记录、重置强娶时间、重置求婚时间)。 - ✅ 排查问题时无需具备群管理员身份。
- 群管理员在本群内同样拥有重置类指令权限;主人相当于「跨群管理员」。
🚦 群组启用方式
三种模式二选一,设置位置在 玩法配置 页底部:
| 模式 | 配置方式 | 说明 |
|---|---|---|
| 全群启用 | 开启「启用所有群」(默认) | 所有群都响应指令,再配合黑名单排除 |
| 白名单 | 关闭「启用所有群」并填写启用群号 | 仅名单内的群响应 |
| 黑名单 | 填写黑名单群号 | 名单内的群永不响应,优先级最高 |
TIP
单个群的精细化开关请使用 分群配置 页,详见分群配置与黑白名单。
多机器人用户(0.0.5+)
同一框架登录多个机器人时,请到 玩法配置 → 机器人接管 填写本实例要执玩的机器人 QQ,名单外的机器人不再响应老婆指令,避免重复回复。详见控制台玩法配置。
🗂️ 数据目录
- 配置文件:
config.json,全部玩法数值、开关与模板集中于此。 - 玩法数据:各群关系记录、活跃池、冷却与好感数据由插件自动维护。
- 备份:数据管理 页支持一键备份,建议大版本更新前执行一次。
✅ 首次配置检查清单
- [ ] 插件已启用,控制台可正常打开且页面不空白
- [ ] 已填写主人 QQ 并保存
- [ ] 已确认群组启用方式(全群 / 白名单 / 黑名单)
- [ ] 目标群发送
今日老婆能正常回复并 @ 双方 - [ ] 发送
老婆菜单能弹出指令主菜单
📚 下一节:群内指令玩法详解
