商家后台详细使用教程

〇登录前准备与首次登录

0.1部署前置条件（只做一次）

1. Cloudflare 已建好 D1 数据库 并导入仓库里的 schema.sql（18 张表）
2. Cloudflare 已建好 R2 存储桶（存图片）
3. Pages 项目的绑定名为 xyfk（D1）和 r2（R2），绑定后站点可正常打开

0.2首次登录

1. 浏览器打开 https://你的域名/admin/
2. 默认账号（预设在 schema.sql）：用户名 admin，密码 123456
3. 登录后第一件事：进入「系统设置 → 商家账号」修改用户名和密码

一仪表盘

登录后首屏，一眼看清店铺经营状况 + 快速跳转常用功能。本页只读，不需要填写任何东西。

二商品分类

给商品分组（如「视频会员」「游戏点卡」「话费充值」），前台首页按分类展示导航 / 筛选。点【新建分类】弹窗填写。

示例：建 3 个分类

视频会员   排序 30
游戏点卡   排序 20
话费充值   排序 10   ← 希望排最前

管理操作：列表里可【编辑】【删除】。删除分类不会删除分类下的商品，但商品会变成「无分类」，建议先移走商品再删。

三商品管理

核心模块。管理商品（SKU 规格、价格、批发价、发货模式、卡密等）。一个商品下可挂多个规格（SKU）。

3.1新建 / 编辑商品

点【新建商品】（或列表里点【编辑】）。

标签格式详解

• 最简单：热销 → 灰色徽章，文字「热销」
• 自定义文字色：推荐#0000ff → 文字蓝色「推荐」
• 自定义边框 / 背景：b1#ff0000 b2#ffecec 热销#ff0000 → 红边框、浅红底、红字「热销」
• 多个标签用英文逗号分隔：b1#ff0000 b2#ffecec 热销#ff0000, 推荐#0000ff

商品描述示例

<p><b>充值账号：</b>下单时在联系方式填写你的账号</p>
<p><b>到账时间：</b>自动发货，付款后 1 分钟内显示卡密</p>
<p><b>注意事项：</b>虚拟商品，发货后不退不换</p>

3.2规格（SKU）字段详解 ★

批发配置示例

售价 3 元，批发填：5=3,10=2.5,50=2
→ 买 1-4 个：3 元/个
→ 买 5-9 个：3 元/个（档位价）
→ 买 10-49 个：2.5 元/个
→ 买 50+ 个：2 元/个

3.3快速加卡

商品行的【快速加卡】按钮：直接给该商品的自动发货规格塞卡密。文本框里一行一条，适合补货——上游发来 50 条新卡，全选复制 → 粘贴 → 确认。

3.4导入 / 导出商品

• 导出商品：把商品连同规格导出成 .json 文件（备份或搬店用）
• 导入商品：选择 .json 文件导入，同名商品可选：跳过（推荐，防重复）或仍然新建

四卡密管理

管理自动发货的卡密库存——导入、查看、导出、删除。买家付款后系统自动从未售出卡密里扣一条发货。

4.1列表筛选

顶部筛选栏：按商品 / 规格 / 状态（未售出 / 已售出）过滤，搜索框支持卡密内容、商品名、规格名模糊搜索。分页可选 10/20/30/50/100 条每页。

4.2导入卡密 ★

点【导入卡密】：

支持的两种格式

格式一：普通模式（只导入到所选规格）
AAAA-1111-XXXX
BBBB-2222-YYYY
CCCC-3333-ZZZZ

格式二：分组模式（选「整文件导入」，一行搞定多个规格）
规格名:卡密
月卡:AAAA-1111-XXXX
月卡:BBBB-2222-YYYY
季卡:DDDD-4444-WWWW

示例：给「腾讯视频月卡」补 3 条货

1. 商品选 腾讯视频 VIP 会员，规格选 月卡
2. 粘贴卡密（一行一条）：TXSP-M001-8f3ka9 / TXSP-M002-7gd2b1 / TXSP-M003-9ks8c4
3. 确认 → 提示导入成功，规格库存自动 +3

导入后若有「未匹配的卡密」，会单独列出供你复制保存后重新导入（通常是规格名写错）。

4.3导出卡密

可按商品 / 规格 / 状态（未售出 / 已售出 / 全部）导出，导出文件和导入格式对称，可直接再导入回系统。用途：搬库备份、已售卡密存档、给上游对账。

4.4删除

删除已售出卡密 = 清理历史记录（订单里仍有发放记录）；删除未售出卡密 = 下架该库存。谨慎操作，建议先导出。

五订单管理

查看 / 处理所有订单：改价、手动发货、补发卡密、关闭、删除。

订单状态流转

5.1筛选与搜索

• 状态筛选：待支付 / 待发货 / 已完成 / 已关闭
• 搜索框：订单号 或 联系方式 模糊搜索

5.2订单详情 / 编辑订单

点订单行【详情】查看完整信息：商品、规格、数量、金额、联系方式、支付方式、发放的卡密内容。

操作示例：手动发货

1. 筛选「待发货」订单
2. 点开订单 → 编辑订单
3. 在「卡密信息」框粘贴要发的卡密（一行一条）
4. 状态改为「已完成」→ 保存
5. 买家在订单查询页即可看到卡密

操作示例：改价（买家砍价后）

1. 编辑订单 → 修改金额字段为谈好的价格
2. 保存后买家按新金额支付

六会员管理

管理注册会员：余额、等级、冻结、密码重置、交易记录。

6.1新增会员

6.2列表操作

示例：给投诉补偿的会员加 10 元

1. 找到该会员 → 【调整余额】
2. 类型：增加余额；金额：10；备注：客服补偿
3. 保存 → 会员余额流水多一条记录（可追溯）

七优惠券

生成满减 / 折扣券，买家结算时输入券码抵扣。

7.1新增优惠券

7.2配置示例

示例 1：新人无门槛立减券

券头：NEW    券码：每行一个 → 001 / 002 / 003
名称：新人立减5元   类型：立减券   值：5
门槛：0   总次数：50   每人限用：1   启用 ✓

→ 买家结算输 NEW001，减 5 元。

示例 2：VIP 8.5 折券（满 100 可用）

券头：（空）  券码：VIP85
名称：VIP85折   类型：折扣券   值：8.5
门槛：100   总次数：不限   每人限用：10

→ 满 100 元的订单输 VIP85，打 85 折。

八支付设置

配置收款通道，前台结算页按这里配置展示支付方式。支持三种：支付宝当面付、USDT（全链 XY-SK）、易支付（EasyPay）。可配置多个，排序数字大的靠前。

8.1支付宝当面付（官方直连）

8.2USDT 支付（XY-SK 全链监控）

8.3易支付（EasyPay）★ 最常用

示例配置（v2 易支付）

名称：支付宝    版本：v2
网关：https://pay.epaydemo.com
商户ID：10001
商户私钥：（粘贴你的 PEM 私钥）
平台公钥：（粘贴平台 PEM 公钥）
接口模式：API 接口下单
排序：10

九文章分类

给文章 / 公告分组（如「新手教程」「活动公告」）。

建好后在「文章管理」里给文章选分类。

十文章管理

发布教程、公告、使用说明，前台 /articles 页面展示。

示例：发布公告文章

1. 先建分类 活动公告
2. 新建文章：标题 双十一 全场8折！，分类 活动公告，勾选「显示」+「置顶」
3. 内容写活动规则和优惠码
4. 保存 → 前台文章列表第一行就是它

十一系统设置

后台最重要的配置区，共 6 个标签页。

1基本设置

2会员设置

• 开启会员注册：总开关
• 会员等级与折扣：点【添加等级】。等级名称如 VIP1；折扣如 8 = 8 折（9.5 = 95 折）。示例：普通会员(10，不打折) / VIP1(9.5) / VIP2(8.5) / SVIP(8)
• 充值自动升级规则：点【添加升级规则】。累计充值满 X 元 → 自动升到某等级。示例：满 100 元 → VIP1、满 500 元 → VIP2。规则从上到下匹配，满足即升级

3管理员订单推送

新订单推送到你手机 / 邮箱，随时掌握出单。三种通道可单独开关：

配置完点【测试发送】验证通不通。

4客户订单推送

付款成功后给买家发通知（如邮件告知「卡密已发放，请查收」）。配置方式同管理员推送，可选发给订单里的联系方式邮箱。

5图床设置

上传图片用哪个存储。三选一：

6商家账号

十二页面管理

创建「单页内容」（关于我们、服务条款、免责声明），前台通过固定链接访问。

访问方式：https://你的域名/custom?alias=about-us

建好后可把链接挂到前台页脚导航（基本设置的「自定义页脚内容」里写 <a href="/custom?alias=about-us">关于我们</a>）。

常见页面：about-us（关于）、terms（服务条款）、refund（退款政策）、contact（联系我们）

十三图片管理

全站图片库（图床管理）——上传图片到 R2 / 图床、分类整理、批量删除、复制链接。商品图、分类图、文章封面都在这里传完拿链接。

13.1上传图片

• 直接拖拽 / 选择文件上传（自动压缩、生成缩略图）
• 【添加图片链接】：批量粘贴已有图片 URL（一行一个）入库

示例（批量粘贴）：
https://example.com/image1.jpg
https://example.com/image2.png

13.2分类与编辑

• 图片可归类（如「商品图」「文章封面」），便于找
• 【编辑】可改图片名称、移动分类

13.3特色功能

13.4使用流程示例

1. 图片管理 → 上传 txsp.jpg → 复制链接 https://img.你的域名.com/txsp.jpg
2. 商品管理 → 新建商品 → 商品主图 URL 粘贴该链接
3. 商品描述里点编辑器的图片按钮 → 从图库选择插入

附录 A数据备份与迁移

每个管理页右上角都有【导出】/【导入】按钮（商品、分类、卡密、订单、会员、优惠券、文章、页面、支付、系统设置各自独立）。

导出

• 点【导出】即下载当前模块的 JSON 备份文件，文件名如 products_backup_1729000000.json
• 升级 / 改代码前务必先全模块导出一遍

导入

• 选择之前导出的 JSON 文件导入，按主键自动合并（存在则更新，不存在则新增）
• 安全机制：商家凭据 / 密钥默认不导入，防别人的备份接管你的后台
• admin_token 一律丢弃并强制重新生成（导入后所有后台会话需重新登录）
• 确实要迁移自己的店铺（连凭据一起搬）：导入弹窗里显式勾选包含凭据
• 导入前先读弹窗的 ① ② 提示，确认模块和文件匹配

搬店流程

1. 旧店：每个模块【导出】保存所有 JSON
2. 新店：部署好 + 导入 schema.sql
3. 新店：逐模块【导入】（系统设置最后导，且注意凭据选项）
4. 新店：测试下单流程

附录 B完整开店流程清单

按顺序做一遍，即可开门营业：

• Cloudflare 建 D1 → 导入 schema.sql（18 张表）
• Cloudflare 建 R2 桶 → Pages 绑定 xyfk / r2
• 访问 /admin/ → admin / 123456 登录
• 系统设置 → 商家账号：改用户名和密码
• 基本设置：网站名称、Logo、公告、联系方式、选主题
• 图床设置：确认 R2 图床可用 → 图片管理试传一张图
• 商品分类：建 2-3 个分类
• 商品管理：建商品 + 规格（填好售价、发货模式）
• 卡密管理：给自动发货规格导入卡密
• 支付设置：配置至少一个收款通道（配完下 1 元测试单）
• 测试全流程：下单 → 支付 → 自动发卡 → 订单查询找回卡密
• 会员设置 / 优惠券 / 文章公告：按营销需要配置
• 安全加固：开 Turnstile 人机验证、设订单推送
• 备份：全部模块导出一次存档