Skip to content

控制台页面详解 ​

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

🖱️ 顶部操作区 ​

元素说明
插件运行中表示控制台已收到插件状态,不代表支付渠道和邮件一定配置成功
刷新数据重新读取商品、库存、订单、日志和配置;外部发生支付或群消息后可点击刷新查看最新状态
保存配置保存支付、邮箱、指令、群组和系统设置;修改输入框后必须点击保存,关闭窗口不会自动保存所有变更

一次只改一个模块

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

🏠 首页概览 ​

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

区块说明
今日订单统计当天创建的订单数量并显示待支付数量;待支付持续增长时,检查订单有效期是否过长、用户是否重复下单或渠道无法完成付款
今日成交金额只统计已确认支付的订单;属于插件业务统计,对账以支付平台结算记录为准
可用卡密统计所有商品当前可销售的卡密数量,旁边的预警数量来自商品设置的预警线
发货异常展示自动发货失败的订单数量;出现异常先打开订单详情,再按运行日志检查 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 起提供):

  • 输入授权卡密激活插件,支持天卡/月卡/季卡/年卡/永久卡;
  • 授权与机器指纹绑定,一台卡密只能在一台电脑使用;
  • 显示剩余有效期、心跳状态与机器指纹,续费卡密自动叠加剩余时间;
  • 授权到期或失效后售卡功能锁定,已支付订单仍会正常完成发货;
  • 购买与续费见插件介绍中的官网入口。

🧭 推荐操作顺序 ​

text
授权管理(激活插件)
  → 系统设置(主人 QQ / 管理员)
  → 云端同步(可选:绑定云端店铺)
  → 商品管理
  → 卡密库存
  → 支付渠道
  → 邮箱设置
  → 发货设置
  → 指令与回复
  → 欢迎语与群组
  → 0.01 元测试订单
  → 订单管理与运行日志验收

📚 下一节:更新记录

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