# 更新日志 ## v1.3.0 (2026-10-21) ### 新增:支付结果页展示卡密 - 支付成功页 `/#/result` 增加卡密展示区:绿色高亮大框、22px 大字、**一键复制**、提示语(购买中心可用订单号随时查询) - 显示商品与套餐名(`项目名 · 套餐名`) - `POST /api/public/payment/complete` 新增返回 `card_key`、`card_type_name`(自动发卡订单),并回读 `orders.card_id` 关联信息 - 复制兼容 http 环境(`navigator.clipboard` 不可用时降级 `execCommand`) ### 新增:代理端图形数字验证码(替代 Turnstile) - 新接口 `GET /api/public/captcha`:输出 SVG 图形,**4 位数字、无 GD 依赖**、干扰线/噪点/逐字随机旋转 - 验证码存 Session:**5 分钟有效、一次性**(校验后立即失效) - 新组件 `frontend/src/components/ImageCaptcha.vue`(点击图片刷新,校验失败自动换图) - 代理登录 `POST /api/auth/agent-login`、代理注册 `POST /api/auth/agent-register` 改为校验 `captcha_code` - 管理员登录**仍保留** Cloudflare Turnstile(不受影响) - `stores/user.js` 的 `login()` 第 4 个参数改为对象:`{turnstile_token}` / `{captcha_code}` ### 优化 - **后台内容区全屏铺满**:移除列表页统一 `max-width:1600px` 与系统设置 900px / 支付配置 800px 限宽,`common.css` 统一覆盖各页面 scoped 限宽规则 - 支付回调地址统一走域名:`APP_URL=https://auth.88531.cn`(`notify_url` / `return_url` 不再使用 `IP:8881`) ### 修复 - **支付同步回调「签名验证失败」**:签名改用网关原始回调串 `sign_params`(原前端回传字段丢失 `name` 等导致重算不一致),并按网关规则跳过空值;同步补单失败时自动查 `orders/query` 兜底显示卡密 - SMTP 邮件主题 UTF-8 编码乱码 - 清理旧构建产物残留(`backend/public/assets` 历史版本文件) ### 部署环境联动改动(不在本仓库) - **易支付 wxpay 插件**:微信返回 `ORDERPAID(该订单已支付)` 时不再显示错误页,改为带签名直接跳回商户 `/#/result`(覆盖 qrcode / jspay / wap / h5 / apppay),修复「刷新支付页后永不跳回」 - **易支付支付页轮询主动查单**:`getshop.php` 发现订单未入账时调用微信订单查询 API(同单 10 秒节流),入账走与异步回调同一套 `processNotify`(幂等),微信回调延迟也能1-2秒内跳回 - 补丁位置:`/home/docker/epay/plugins/wxpay/wxpay_plugin.php`(bind mount)、`/home/docker/epay/patches/getshop.php`(已加 compose 挂载) - **宝塔反代改回环**:`auth/xboard/bts` 三个站点 `proxy_pass` 由公网 IP 改为 `127.0.0.1`,修复本机回环访问自身公网 IP 不通导致外部请求全部超时/499 --- ## v1.2.0 (2026-10-10) ### 新增:公告推送 - 新表 `ca_announcements`:标题/内容/类型/推送对象/置顶/弹窗/起止时间/关联项目 - 管理端页面「公告推送」:发布、编辑、上线/下线、删除、批量删除 - 公开接口 `GET /api/public/announcements`:客户端/商城拉取,返回 `list` + `popup` - 权限:admin / project_admin 可发布;project_admin 仅限绑定项目 - 类型:系统 / 更新 / 活动 / 通知;对象:全部 / 管理端 / 代理端 / 客户端 --- ## v1.1.1 (2026-10-08) ### 新增说明:自动发卡补丁(IPTV/App 直购) - 支付成功后,若订单**不含** `bot_qq`(App/IPTV 直购场景),自动从同项目同套餐**未用卡池**取 1 张卡 - 从 `contact_info` 解析机器码:`MACHINE:TV-XXXX`(未填则用 `AUTO-{订单号}`) - 自动绑定机器码并标记卡密为已使用,订单关联 `card_id` - 实现位置:`OrderController::processOrderPaid()`(约 L297–L332) - 卡池无卡时订单仍为已支付,需管理端补卡后处理 ### 修复 - **安装统计时间统一为北京时间(UTC+8)** - MySQL 默认时区改为 `+08:00`(docker-compose / 运行中实例) - PHP 时区设为 `Asia/Shanghai`(php.ini / Dockerfile / entrypoint) - 历史安装记录时间已由 UTC 转换为北京时间 - 接口返回与后台页面展示均为北京时间 --- ## v1.1.0 (2026-10-08) ### 新增功能:安装统计与版本推送 #### 安装统计 - 新增 `ca_installations` 安装记录表:每次安装独立计数(含已删除) - 统计维度:总安装次数、存活安装、已删除、今日/本周新增、最后上线时间 - 支持按项目汇总查看安装情况 - 管理端页面:`安装统计`(列表 / 筛选 / 详情 / 软删除 / 恢复 / 批量删除 / 导出 CSV) - 权限:超级管理员、项目管理员(限绑定项目)、代理(限本人卡密相关) #### 版本推送(安装包分发) - 新增 `ca_project_versions` 项目版本表 - 管理端上传安装包(zip/tar/gz/7z/exe/dmg/apk/msi/pkg/rar/bin,≤200MB) - 支持更新说明、设为最新版本、禁用/启用、删除版本及文件 - 管理端页面:`版本推送` - 权限:发布/修改/删除仅超级管理员与项目管理员;**代理仅只读** #### 强制推送 - 版本可开启 `is_force` 或设置 `min_client_version` - 客户端检查更新时返回 `update_required=true`,提示强制更新 - **仅客户端提示,不阻断** `verify` 授权结果 #### 客户端接口(API Key) | 接口 | 说明 | |------|------| | `POST /api/public/installations/check-update` | 检查更新 + 登记安装/更新在线时间 | | `POST /api/public/installations/heartbeat` | 轻量心跳,更新 `last_online_at` | | `POST /api/public/verify` | 成功响应附带更新字段,并同步安装记录 | `check-update` / `verify` 成功时返回:`update_available`、`update_required`、`latest_version`、`download_url`、`file_size`、`checksum`、`changelog`、`is_force`、`install_id` 等。 #### 管理端接口(JWT) | 方法 | 路径 | 说明 | |------|------|------| | GET | `/api/installations` | 安装列表 | | GET | `/api/installations/stats` | 安装统计(含已删除) | | GET | `/api/installations/export` | 导出 CSV | | DELETE | `/api/installations/{id}` | 标记已删除 | | POST | `/api/installations/{id}/restore` | 恢复安装 | | GET | `/api/projects/{projectId}/versions` | 版本列表 | | POST | `/api/projects/{projectId}/versions` | 发布版本(multipart) | | PUT | `/api/versions/{id}/force` | 强制推送开关 | | PUT | `/api/versions/{id}/latest` | 设为最新 | | DELETE | `/api/versions/{id}` | 删除版本 | #### 文档 - README 补充安装统计与版本推送 API 文档 - 公开文档页 `/docs` 增加功能介绍、后台使用方法、客户端对接说明与 CURL 示例 #### 数据库升级 - 已有库执行:`backend/database/migrations/20261008_add_installations_and_versions.sql` - 全新安装:`backend/database/schema.sql` 已包含新表 --- ## v1.0.0 初始版本:卡密授权、项目/套餐/卡密管理、代理分销、在线支付商城、授权验证 API、黑名单、SMTP 到期提醒、Docker 部署。