Skip to content

安装与首次配置 ​

本篇覆盖安装插件、打开控制台、配置主人与管理员、设置订单基础策略、启用目标群以及数据目录备份,帮你完成正式运营前的全部基础设置。

🧰 运行前准备 ​

  • 一套可正常收发群消息的 UniQQ 环境;
  • Microsoft Edge WebView2 Runtime,用于显示控制台;
  • 至少一个已签约的支付渠道;
  • 一个开启 SMTP 的邮箱账号;
  • 一个测试群和一个普通群成员测试账号。

系统时间必须准确

支付签名和证书校验依赖系统时间,误差过大时支付请求会被拒绝。开始配置前先校准机器人电脑的时间与时区。

📦 安装插件 ​

  1. 使用完整的 .uniqq 插件包安装,不要只复制 ZLCardStorePlugin.dll;
  2. 重启 UniQQ 后,在插件列表确认「ZL-售卡系统」已启用;
  3. 打开设置控制台,页面应显示首页概览、商品、库存、订单等入口;
  4. 首次启动会在插件数据目录创建配置文件和 SQLite 数据库。

控制台空白或提示找不到前端文件

先确认插件包中存在 Web 文件夹(即使用的是完整插件包),再安装或修复 Microsoft Edge WebView2 Runtime,然后重启 UniQQ。

🖥️ 认识控制台 ​

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

👑 主人与管理员 ​

进入「系统设置」配置:

配置项说明
主人 QQ插件最高管理者,建议只填一个长期使用且安全的 QQ
管理员 QQ多个 QQ 用逗号分隔,可执行库存、补发和关闭订单等运维指令
全局开关关闭后所有群停止售卡,但历史订单和数据不会删除

权限是两套概念

不要把普通群管理员自动视为插件管理员。插件权限与群职务相互独立,一律以控制台配置为准。

⏱️ 订单基础策略 ​

参数建议说明
订单有效期10–15 分钟过短用户来不及支付,过长会积累付款码
待支付上限2–3 笔防止同一用户反复创建订单
下单冷却5–15 秒减少刷屏和重复点击
复用待支付订单按需开启同一用户重复购买同商品时优先复用尚未过期订单
日志保留天数≥ 30 天便于售后核对

👥 群组首次设置 ​

群组采用严格白名单模式:机器人收到陌生群消息时不会自动添加或启用该群。请在「欢迎语与群组」页面读取机器人群列表并选择需要配置的群,读取失败时仍可手动填写。新增群的全部功能默认关闭,请开启需要的功能并保存。

每个群需要逐项确认:

  1. 售卡开关是否开启;
  2. 欢迎语是否开启;
  3. 允许展示哪些商品;
  4. 支付成功是否在群内提示;
  5. 支付二维码是否在订单完成、取消或过期后撤回。

先小范围验证

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

💾 数据目录与备份 ​

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

需要保护的数据包括:

  • 商品、库存和订单数据库;
  • 插件配置;
  • 支付渠道密钥;
  • 邮箱授权配置;
  • 群组与指令自定义内容。

密钥与 Windows 用户绑定

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


📚 下一节:商品与卡密库存

薇薇官机平台 · ZL 系列插件