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