控制台页面详解
本篇按控制台左侧菜单顺序,说明每个页面能做什么、什么时候使用,以及容易忽略的注意事项,最后给出推荐配置顺序。
🖱️ 顶部操作区
| 元素 | 说明 |
|---|---|
| 插件运行中 | 表示控制台已收到插件状态,不代表支付渠道和邮件一定配置成功 |
| 刷新数据 | 重新读取商品、库存、订单、日志和配置;外部发生支付或群消息后可点击刷新查看最新状态 |
| 保存配置 | 保存支付、邮箱、指令、群组和系统设置;修改输入框后必须点击保存,关闭窗口不会自动保存所有变更 |
一次只改一个模块
建议每次只修改一个业务模块,保存并测试后再修改下一个,发生错误时更容易定位。
🏠 首页概览
首页用于观察经营状态,不用于编辑数据。
| 区块 | 说明 |
|---|---|
| 今日订单 | 统计当天创建的订单数量并显示待支付数量;待支付持续增长时,检查订单有效期是否过长、用户是否重复下单或渠道无法完成付款 |
| 今日成交金额 | 只统计已确认支付的订单;属于插件业务统计,对账以支付平台结算记录为准 |
| 可用卡密 | 统计所有商品当前可销售的卡密数量,旁边的预警数量来自商品设置的预警线 |
| 发货异常 | 展示自动发货失败的订单数量;出现异常先打开订单详情,再按运行日志检查 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 元测试订单
→ 订单管理与运行日志验收📚 下一节:更新记录
