01 · 安装与首次配置

一、运行前准备

  • 一套可正常收发群消息的 UniQQ 环境;

  • Microsoft Edge WebView2 Runtime,用于显示控制台;

  • 至少一个已签约的支付渠道;

  • 一个开启 SMTP 的邮箱账号;

  • 一个测试群和一个普通群成员测试账号。

系统时间必须准确。支付签名和证书校验依赖时间,误差过大会造成请求被拒绝。

二、正确安装插件

  1. 使用完整的 .uniqq 文件安装,不要只复制 ZLCardStorePlugin.dll。

  2. 重启 UniQQ 后,在插件列表确认“ZL-售卡系统”已启用。

  3. 打开设置控制台,页面应显示首页概览、商品、库存、订单等入口。

  4. 首次启动会在插件数据目录创建配置和 SQLite 数据库。

控制台空白或报“找不到控制台前端文件”时,请先确认插件包中存在 Web 文件夹,再修复或安装 WebView2 Runtime。

三、认识控制台

页面用途
首页概览今日订单、成交额、库存预警、发货异常
商品管理商品名称、价格、教程、售后与上架状态
卡密库存导入、筛选、作废和恢复卡密
订单管理查单、确认到账、关闭订单、补发与详情
支付渠道易支付、支付宝、微信支付参数
发货设置邮箱优先、私聊兜底、重试和模板
邮箱设置SMTP、安全连接、发件昵称、主题和正文
指令与回复购买触发词、帮助/查单/补发等指令与话术
欢迎语与群组每个群的售卡范围、欢迎语和通知策略
用户记录成交用户、常用邮箱、订单数和金额
运行日志支付、发货、配置和异常记录
新手教程控制台内置分步教程和上线清单
系统设置主人、管理员、订单有效期、冷却和数据目录

四、主人和管理员

进入“系统设置”:

  • 主人 QQ:插件最高管理者,建议只填一个长期使用且安全的 QQ。

  • 管理员 QQ:多个 QQ 用逗号分隔。管理员可以执行库存、补发和关闭订单等运维指令。

  • 全局开关:关闭后所有群停止售卡,但历史订单和数据不会删除。

不要把普通群管理员自动视为插件管理员。插件权限与群职务是两套概念,以控制台配置为准。

五、订单基础策略

  • 订单有效期:建议 10 至 15 分钟。过短会让用户来不及支付,过长会积累付款码。

  • 待支付上限:建议 2 至 3 笔,防止同一用户反复创建订单。

  • 下单冷却:建议 5 至 15 秒,减少刷屏和重复点击。

  • 复用待支付订单:开启后,同一用户重复购买同商品时优先复用尚未过期订单。

  • 日志保留天数:建议至少 30 天,方便售后核对。

六、群组首次设置

机器人收到群消息后通常会记录群信息,也可以手动添加群配置。每个群需要关注:

  1. 售卡开关是否开启;

  2. 欢迎语是否开启;

  3. 允许展示哪些商品;

  4. 支付成功是否在群内提示;

  5. 支付二维码是否在订单完成、取消或过期后撤回。

测试阶段建议只开放一个测试群,确认流程后再逐个开放正式群。

七、数据目录与备份

“系统设置”会显示插件数据目录与数据库路径。建议定期备份整个数据目录,备份前尽量停止插件,避免数据库正在写入。

需要保护的数据包括:

  • 商品、库存和订单数据库;

  • 插件配置;

  • 支付渠道密钥;

  • 邮箱授权配置;

  • 群组与指令自定义内容。

支付和邮箱秘密数据按当前 Windows 用户保护。换电脑或换 Windows 用户后,应重新填写密钥,不要指望直接复制加密值即可使用。

共 11 篇 ZL-售卡插件 / 安装与首次配置 0 字 0 行 zhangxiaolin
创建 2026-09-23T09:09:16.676626998Z 更新 2026-09-23T09:11:32.634660394Z