安装与首次配置
本篇覆盖安装插件、打开控制台、配置主人与管理员、设置订单基础策略、启用目标群以及数据目录备份,帮你完成正式运营前的全部基础设置。
🧰 运行前准备
- 一套可正常收发群消息的 UniQQ 环境;
- Microsoft Edge WebView2 Runtime,用于显示控制台;
- 至少一个已签约的支付渠道;
- 一个开启 SMTP 的邮箱账号;
- 一个测试群和一个普通群成员测试账号。
系统时间必须准确
支付签名和证书校验依赖系统时间,误差过大时支付请求会被拒绝。开始配置前先校准机器人电脑的时间与时区。
📦 安装插件
- 使用完整的
.uniqq插件包安装,不要只复制ZLCardStorePlugin.dll; - 重启 UniQQ 后,在插件列表确认「ZL-售卡系统」已启用;
- 打开设置控制台,页面应显示首页概览、商品、库存、订单等入口;
- 首次启动会在插件数据目录创建配置文件和 SQLite 数据库。
控制台空白或提示找不到前端文件
先确认插件包中存在 Web 文件夹(即使用的是完整插件包),再安装或修复 Microsoft Edge WebView2 Runtime,然后重启 UniQQ。
🖥️ 认识控制台
| 页面 | 用途 |
|---|---|
| 首页概览 | 今日订单、成交额、库存预警、发货异常 |
| 商品管理 | 商品名称、价格、教程、售后与上架状态 |
| 卡密库存 | 导入、筛选、作废和恢复卡密 |
| 订单管理 | 查单、确认到账、关闭订单、补发与详情 |
| 支付渠道 | 易支付、支付宝、微信支付参数 |
| 发货设置 | 邮箱优先、私聊兜底、重试和模板 |
| 邮箱设置 | SMTP、安全连接、发件昵称、主题和正文 |
| 指令与回复 | 购买触发词、帮助/查单/补发等指令与话术 |
| 欢迎语与群组 | 每个群的售卡范围、欢迎语和通知策略 |
| 用户记录 | 成交用户、常用邮箱、订单数和金额 |
| 运行日志 | 支付、发货、配置和异常记录 |
| 新手教程 | 控制台内置分步教程和上线清单 |
| 系统设置 | 主人、管理员、订单有效期、冷却和数据目录 |
👑 主人与管理员
进入「系统设置」配置:
| 配置项 | 说明 |
|---|---|
| 主人 QQ | 插件最高管理者,建议只填一个长期使用且安全的 QQ |
| 管理员 QQ | 多个 QQ 用逗号分隔,可执行库存、补发和关闭订单等运维指令 |
| 全局开关 | 关闭后所有群停止售卡,但历史订单和数据不会删除 |
权限是两套概念
不要把普通群管理员自动视为插件管理员。插件权限与群职务相互独立,一律以控制台配置为准。
⏱️ 订单基础策略
| 参数 | 建议 | 说明 |
|---|---|---|
| 订单有效期 | 10–15 分钟 | 过短用户来不及支付,过长会积累付款码 |
| 待支付上限 | 2–3 笔 | 防止同一用户反复创建订单 |
| 下单冷却 | 5–15 秒 | 减少刷屏和重复点击 |
| 复用待支付订单 | 按需开启 | 同一用户重复购买同商品时优先复用尚未过期订单 |
| 日志保留天数 | ≥ 30 天 | 便于售后核对 |
👥 群组首次设置
群组采用严格白名单模式:机器人收到陌生群消息时不会自动添加或启用该群。请在「欢迎语与群组」页面读取机器人群列表并选择需要配置的群,读取失败时仍可手动填写。新增群的全部功能默认关闭,请开启需要的功能并保存。
每个群需要逐项确认:
- 售卡开关是否开启;
- 欢迎语是否开启;
- 允许展示哪些商品;
- 支付成功是否在群内提示;
- 支付二维码是否在订单完成、取消或过期后撤回。
先小范围验证
测试阶段建议只开放一个测试群,确认完整流程后再逐个开放正式群。
💾 数据目录与备份
「系统设置」会显示插件数据目录与数据库路径。建议定期备份整个数据目录,备份前尽量停止插件,避免数据库正在写入。
需要保护的数据包括:
- 商品、库存和订单数据库;
- 插件配置;
- 支付渠道密钥;
- 邮箱授权配置;
- 群组与指令自定义内容。
密钥与 Windows 用户绑定
支付和邮箱秘密数据按当前 Windows 用户保护。更换电脑或 Windows 用户后,应重新填写密钥,直接复制加密值无法使用。
📚 下一节:商品与卡密库存
