09 · 控制台页面详解

本篇按控制台左侧菜单顺序,说明每个页面能做什么、什么时候使用,以及容易忽略的注意事项。


一、顶部操作区

控制台顶部固定显示插件状态和两个常用按钮:

  • 插件运行中:表示控制台已经收到插件状态,不代表支付渠道和邮件一定配置成功。

  • 刷新数据:重新从插件读取商品、库存、订单、日志和配置。外部发生支付或群消息后,可点击刷新查看最新状态。

  • 保存配置:保存支付、邮箱、指令、群组和系统设置。修改输入框后必须点击保存,关闭窗口不会自动保存所有变更。

建议每次只修改一个业务模块,保存并测试后再修改下一个模块,发生错误时更容易定位。

二、首页概览

首页用于观察经营状态,不用于编辑数据。

今日订单

统计当天创建的订单数量,并显示当前待支付数量。待支付数量持续增长时,需要检查订单有效期是否过长、用户是否重复下单或支付渠道是否无法完成付款。

今日成交金额

只统计已经确认支付的订单。它是插件业务统计,不应替代支付平台的财务账单。对账时以支付平台结算记录为准。

可用卡密

统计所有商品当前可销售的卡密数量。旁边的库存预警数量来自商品设置的预警线。

发货异常

展示自动发货失败的订单数量。出现异常后应先打开订单详情,再根据运行日志检查 SMTP、私聊或群临时会话。

最近订单与库存预警

最近订单用于快速观察状态变化;库存预警只展示已上架且库存达到预警线的商品。点击“查看全部”进入订单管理。

三、商品管理

商品管理负责用户购买前看到的内容。

新增商品

点击“新增商品”后填写:

  • 商品名称、分类和类型;

  • 别名和排序;

  • 售价、原价和库存预警;

  • 适用群;

  • 商品说明、使用教程、售后说明和发货附加话术;

  • 是否允许邮箱发货、是否上架。

新增商品后仍需导入卡密。有商品但没有可用库存时,群友无法正常购买。

商品列表

  • 编辑图标:修改商品资料和状态;

  • 钥匙图标:直接为该商品导入卡密;

  • 删除图标:删除商品前应确认没有待处理订单和需要保留的历史关系;

  • 库存徽标:黄色通常表示达到预警线,绿色表示库存正常;

  • 上架状态:只有已上架商品才可能出现在群内商店。

搜索框支持按名称或分类筛选,不影响群内商品排序。

四、卡密库存

卡密库存用于批量补货和维护单条卡密状态。

筛选器

可以按商品和状态筛选。完整卡密默认不会直接在列表中明文展示,降低后台被旁观时泄露的风险。

导入卡密

每行一条;需要附加信息时使用:

卡密内容|附加信息

导入前选择正确商品并填写批次备注。系统过滤重复项,但仍建议保留原始库存来源记录。

作废与恢复

  • 未售出卡密可以作废,作废后不参与销售;

  • 已作废卡密可以恢复为可用;

  • 已售出卡密不应随意恢复,否则可能重复销售。

五、订单管理

订单管理是支付和售后处理的核心页面。

状态筛选

支持查看全部、待处理、已支付、已发货、发货失败和已关闭订单。订单同时包含支付状态和发货状态,两者不要混为一谈。

查单

主动向支付渠道查询订单状态。用户声称已付款但插件未更新时,应先查单。

确认到账

这是高风险人工操作。只有在支付平台商户后台确认订单号、金额和用户订单一致时才能使用。不能仅凭用户截图确认。

关闭订单

用于取消异常待支付订单。关闭后会尝试撤回原二维码,旧订单不再自动发货。

补发

对已经支付的订单重新执行交付。补发复用原订单卡密,不会再次扣减库存。

订单详情

详情应重点核对:订单号、用户 QQ、群号、商品、金额、支付渠道、邮箱、交易号、支付时间、发货时间和错误信息。

六、支付渠道

页面顶部问号按钮会打开参数来源说明。

默认渠道

用户未在购买指令中指定渠道时使用。只有启用且配置完整的渠道才应对外展示。

易支付

填写网关、PID、KEY、支付类型和站点名称。通知与同步跳转地址可按服务商要求填写;留空时插件仍会主动查单。

支付宝当面付

填写 AppId、应用私钥、支付宝公钥和网关。这里的支付宝公钥不是应用公钥。正式环境与沙箱参数必须成套使用。

微信支付 API v2 / v3

简易 API v2 只需 AppID、商户号和 32 位 API 密钥(v2),不需要证书。开启本地回调服务后,通过 Cloudflare Tunnel 将本地端口映射为公网 HTTPS 通知地址。高级 API v3 需要 API v3 Key、证书序列号、商户私钥、微信支付公钥 ID 和公钥内容。

配置完成后先保存,再创建 0.01 元订单验证,不要只看“已接入”标签。

七、发货设置

邮箱优先发货

订单包含邮箱时先发邮件。成功后不重复发送完整卡密到私聊,减少泄露面。

临时会话与私聊兜底

订单没有邮箱或邮件失败时:群内订单直接通过群临时会话发货(用户无需加机器人好友),非群订单尝试机器人私聊。

群内失败提醒

全部自动渠道失败时,在原群提醒用户联系管理员。提醒不包含卡密和完整邮箱。

重试次数与间隔

网络偶发失败时自动重试。次数过多会延长订单处理时间,建议保持默认或使用 2–3 次。

发货消息模板

控制机器人临时会话/私聊发货消息的内容。支持变量:

{用户QQ} {用户昵称} {群号} {订单号} {商品名称}
{卡密内容} {商品说明} {使用教程} {售后说明}
{支付金额} {支付方式} {支付时间} {邮箱}
  • 商品「发货附加话术」会在模板渲染完成后自动追加,无需写变量;

  • {商品说明}、{使用教程}、{售后说明} 取自商品编辑页对应字段在下单时的快照;

  • 模板被清空时,插件加载配置会自动恢复默认模板(0.1.0 起),默认模板已包含卡密、商品说明、使用教程与售后说明;

  • 修改后要用真实测试订单检查换行与变量替换。

八、邮箱设置

页面提供 QQ、163、Gmail 和 Outlook 预设。

SMTP 服务器

填写主机、端口、安全连接、用户名、授权码、发件地址和发件昵称。国内邮箱通常需要官网生成的 SMTP 授权码,不是登录密码。

测试连接

验证网络和身份认证。连接成功不代表邮件正文与收件流程一定正常。

发送测试邮件

向测试收件人发送一封邮件,用于检查发件昵称、主题、正文、编码和垃圾邮件拦截。

邮件模板

  • 发件昵称决定收件人看到谁发来的;

  • 主题模板决定邮件标题;

  • 正文模板决定打开邮件后的内容;

  • 商品说明、使用教程和售后说明通过变量插入正文。

九、指令与回复

商店回复

购买触发词支持多个别名,用逗号分隔。用户只发送触发词时打开商店;发送“触发词 + 序号 + 渠道”时直接下单。

可以自定义商店标题、开场白、结尾和暂无商品回复。右侧预览用于检查排版,但实际商品和渠道以运行状态为准。

用户指令

可以修改帮助、订单列表、客服、邮箱、查单、取消和补发指令。不同功能不要设置成完全相同的指令。

回复话术

可以编辑帮助结尾、客服回复,以及邮箱保存、取消成功、补发完成和订单无效等流程结果。

十、欢迎语与群组

群组使用严格白名单。未添加的群、刚新增但尚未开启的群,以及未点击保存的修改都不会启用插件功能。升级到配置版本 8 时,旧群配置会统一关闭一次,管理员需要重新核对群号并开启需要的售卡、欢迎语和支付成功通知开关。

默认欢迎语

支持用户昵称、QQ、群号、群名、商品列表和购买指令变量。大型群建议保持简短。

群组开关

每个群可以独立控制售卡和欢迎语。编辑群配置时还应检查:允许商品、支付成功群提示和二维码自动撤回。

群配置与商品“适用群”会共同生效。任何一侧限制当前群,商品都可能不展示。

十一、用户记录

展示购买用户、最近邮箱、成交订单数、成交金额和购买时间。这里用于运营与售后检索,不应导出或公开用户邮箱。

十二、运行日志

  • INFO:正常订单、支付和发货记录;

  • WARN:撤回失败、临时网络异常等可恢复问题;

  • ERROR:支付请求、验签、邮件、数据库或消息发送失败。

处理问题时记录发生时间和订单号,再查看日志详情。不要把包含密钥或完整卡密的截图发到公开群。

十三、新手教程

控制台内置 8 步短教程,适合边看边配置;项目 使用教程 目录中的 Markdown 文档是更完整的独立手册,适合系统学习和离线查阅。

十四、系统设置

基础设置

管理全局开关、主人 QQ、管理员 QQ、订单有效期、待支付上限、下单冷却、日志保留天数和待支付订单复用策略。

数据位置

显示插件数据目录和 SQLite 数据库路径。备份时建议停止插件并复制完整数据目录。更换 Windows 用户后,受系统保护的支付密钥与邮箱授权码通常需要重新填写。


十五、云端同步

「云端同步」页用于把插件绑定到 ZL 官方云端店铺,实现商品、卡密、群组、设置与订单的双向自动同步(0.0.8 起可用,0.0.13 起独立成页)。

绑定

首次安装并完成授权后即可绑定:登录 https://uniqq.pay.zxiaolin.com 创建插件实例,将一次性显示的连接密钥填入插件并保存。绑定信息独立于微信支付配置,换支付渠道不影响云端连接。

双向同步

  • 插件端上架/下架/改价、导入作废卡密、修改配置会实时推送到云端;

  • 云端修改约 15 秒内同步到插件;

  • 同步失败自动进入重试队列,恢复后补推;

  • 应用云端快照期间自动暂停推送,防止数据回弹;

  • 云端不可用时停止新订单出库,避免离线回退造成超卖。

上传本地数据

「上传本地数据」把本地商品、卡密与历史订单合并上传到云端,云端已有的数据自动跳过,不覆盖任何内容。适合把存量业务搬上云端或多台机器人共用同一家店铺。

⚠️ 多台电脑的插件绑同一云端店铺时,配置以云端为准互相覆盖。建议只在一边修改发货模板等配置,或改完立即保存推送。

十六、授权管理

「授权管理」页用于激活和管理插件授权(0.0.5 起提供):

  • 输入授权卡密激活插件,支持天卡/月卡/季卡/年卡/永久卡;

  • 授权与机器指纹绑定,一台卡密只能在一台电脑使用;

  • 显示剩余有效期、心跳状态与机器指纹,续费卡密自动叠加剩余时间;

  • 授权到期或失效后售卡功能锁定,已支付订单仍会正常完成发货;

  • 购买与续费见插件介绍中的官网入口。

推荐操作顺序

授权管理(激活插件)
  → 系统设置(主人 QQ / 管理员)
  → 云端同步(可选:绑定云端店铺)
  → 商品管理
  → 卡密库存
  → 支付渠道
  → 邮箱设置
  → 发货设置
  → 指令与回复
  → 欢迎语与群组
  → 0.01 元测试订单
  → 订单管理与运行日志验收
共 11 篇 ZL-售卡插件 / 控制台页面详解 0 字 0 行 zhangxiaolin
创建 2026-09-23T09:10:47.490531407Z 更新 2026-09-29T04:19:41.979437949Z