📖
怎么用这套后台
1. 首次进入：设置管理员密码（服务器模式保存在后端
server/data/；本机模式保存在本浏览器）。
2. 新增学员：填用户名、姓名、初始密码、有效期与生图额度。学员用「用户名 + 密码」在前台任意作图菜单的登录页登录。
3. 交付给学员：点「复制账号」生成话术发给学员，附前台地址与账号信息。
4. 停用 / 恢复：点「停用」立即失效，账号信息保留，随时可恢复。
5. 重置密码：学员忘记密码时点「重置密码」，把新初始密码发给他。
6. 微信二维码 / 登录页封面：二维码上传后前台三处联系位自动同步；封面是学员打开前台未登录时的全屏大图，不上传则用内置默认封面。都可随时替换。上传的封面在学员端
浅色（☀️）与深色（🌙）主题下都会正常显示。
7. ⚙️ 生图通道：在这里统一配置生图接口（GPT-Image-2 中转 / 再来点Token 等）。
学员端看不到任何接口地址与密钥，只能使用你配好的通道。改完点「保存通道配置」立即下发；点「测试通道连通性」可验证是否可用。后台里
API Key 以明文保存，可以随时查看 / 复制 / 改写，切换渠道只需换个下拉选项再点保存。
·
以后换了新的 API 网站怎么办？下拉框选「
自定义渠道」，把新网站的
中转 API Base URL（形如
https://xxx.com/v1）、
API Key、
模型名称 三项填好，点「保存通道配置」——学员端立刻改用它出图，不用改任何代码。
8. 🎨 生图流水：记录每个学员
什么时间、生成了多少张图、消耗了几次额度、用的是什么提示词，支持按学员筛选、按提示词/备注搜索、按时间范围查看、导出 CSV。顶部还会显示生图榜单。
9. ⚡ 批量操作：勾选多个学员后可批量启用 / 停用 / 续期 / 加额度 / 重置已用额度 / 删除；学员列表支持按状态筛选与关键词搜索。
10. 到期与额度预警：顶部「需要注意」会列出 7 天内到期、额度告急、已过期、从未登录的学员，并可一键续期或加额度。
11. 使用日志：查看学员登录时间与生图动作。
12. 📊 首页那几个数字怎么读：
·
累计生图 / 今日生图＝实际出图
张数（下面小字是同时消耗的
额度次数）。
·
在线账号＝最近 30 天内登录过、且登录态仍有效的
账号数；鼠标悬停可看到「登录会话」个数。
「会话」是什么：每次登录都会生成一个会话，有效期 30 天。同一个账号在电脑、手机上各登录一次就是 2 个会话，但
账号数只算 1 个。所以「会话数」总是 ≥「账号数」。
·
当前生图通道（首页最上面那张卡）＝现在学员用的是哪个接口、Key 配没配、服务器到接口通不通；打开后台会自动检测一次，也可以点「重新检测」随时复测。
13. 💎 额度消耗规则：在「💳 额度充值说明」页设置
每张图按分辨率扣几次额度（默认 1K=1 次、2K=2 次、4K=3 次）。保存后学员端立刻按新规则扣，前台分辨率下拉框下也会提示「这一档消耗几次」。
14. ⏱️ 每日生图上限：同一个页面里还能设置
每个学员每天最多出多少（按额度或按张数，填 0 = 不限）。
每天 0 点自动重置，管理员不受限制；超了会直接拦下并提示还剩多少。
15. 🎟️ 兑换码：批量生成带额度的码发给学员，学员在前台「💳 充值 / 兑换码」里一填，额度
自动到账，不用你手动加。能设有效期、备注、前缀，列表里能看到谁在什么时候用了哪个码。前台「兑换码充值」页的
「🎟️ 购买兑换码」按钮会自动弹出你上传的
微信二维码，并引导学员「扫码加好友 → 说明档位付款 → 你发兑换码 → 学员回来输入」，无需你手动发图。
16. 📊 通道健康：自动记录每次真实生图的成功/失败与耗时，显示
近 24h 成功率、平均耗时、失败原因 TOP。成功率掉到 70% 以下会红字告警 —— 接口挂了能在学员来问之前先发现。
17. 📍 用户定位：每次学员登录都会记一条「账号 / 设备 / IP / 位置」，位置有两种来源，列表里分得很清楚：
•
IP 粗定位（默认）：按登录 IP 猜到
城市级（如「广东省深圳市 · 电信」），学员不需要授权，缺点是换城市、走代理会不准。
•
🎯 精确定位：在页面顶部把「精确定位」
开启后，学员
下次登录时浏览器会静默取一次设备位置（手机 GPS / WiFi 定位），由服务端翻成「省·市·区 街道」写进同一条记录，后面还能点「地图↗」直接在地图上看到点。学员端
不会多任何按钮或提示，只有首次会弹一次
浏览器自带的授权询问。
这个开关你可以
随时开 / 随时关：关掉后立刻停止采集，历史记录保留。注意两点：① 创作台
必须用 https 访问，http 下浏览器不允许取定位（会静默失败，不影响生图）；② 学员在浏览器里拒绝了授权，就只能退回 IP 粗定位。
旧记录如果显示「未定位」，点页面上的「🔍 解析历史 IP」补一下即可（一次最多 12 个 IP，可多点几次）。服务器无法访问外网时定位会失败，此时只显示 IP（精确定位则退化为显示经纬度坐标），不影响其他功能。
18. 📱 手机端怎么用：手机上打开后台时，功能页签会收成
一行左右滑动的胶囊条，并吸在顶栏下面（往下翻也能随时切页）。页签条右边有个「
☰ 全部功能」按钮，点开是
分组功能菜单（学员与流水 / 运营与收入 / 通道与页面 / 系统设置），不用左右滑就能直达任意一页。宽表格（生图流水、使用日志等）在手机上
可以左右滑动查看，不会撑破页面。电脑端不受影响，仍是原来的多行排布。
19. 💾 图片会不会把服务器空间占满：不会。
•
服务器不存图：学员生成的图是
以数据流从接口传到浏览器的（后端只在内存里转一次，不落盘）。服务器上写下来的只有「谁、什么时候、生了几张」这类
文字流水（`images.json` / `logs.json`，有固定条数上限）和临时任务文件（`data/poryf/*.json`，2 小时后自动清理）。
•
学员的历史原图存在学员自己手机上：前台「🖼️ 我的生图历史」里的图是
不压缩的原图，存在该学员设备的浏览器（本机 IndexedDB，默认最多 20 张 / 约 260MB），换设备就没了 ——
吃的是学员的手机空间，不是你的服务器。
• 学员在历史里
长按图片 → 保存图片，存下来就是生成时那张的画质（4K 存下来仍是 4K）；点开大图后也有「⬇ 保存原图」。
💾 数据存放：连接了
server/server.js 后端时，数据存在服务器
server/data/ 目录（多设备共享）；未连接时仅存本浏览器（换设备会丢，仅供应急）。前台地址：
打开创作台 →