# misc-api **Repository Path**: xunjinlu/misc-api ## Basic Information - **Project Name**: misc-api - **Description**: misc-api 是基于 PHP + MySQL 的轻量级 Web 管理系统，提供安装向导、后台管理、安全认证、系统设置与云端在线更新。源码完全开源，可个人/商业免费使用。 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: https://gitee.com/xunjinlu/misc-api - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-07-10 - **Last Updated**: 2026-07-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: PHP, API ## README

MISC-API

开放接口平台 · 自部署管理 · 云端在线更新

version license Gitee PHP MySQL

--- ## 项目简介 **MISC-API** 是一套可自部署的**开放 API 接口平台**管理系统。基于 PHP + MySQL，无重型框架依赖，提供前台接口目录与在线调试、后台接口审核与分类管理，以及用户体系与云端在线更新。 **主要能力：** - Web 五步安装向导，自动创建数据表与初始配置 - **双端认证**：管理员后台（安装时创建）+ 用户中心（邮箱验证码注册 + QQ/Gitee OAuth） - **API 管理（已实现）**：后台接口列表与分类；接口审核（待审核/通过/不通过，可选拒绝原因）；用户中心开发者投稿与邮件通知 - **调用统计（v3.18+）**：本地脚本头 ≤3 行 `ApiStats::hit()`（见 `api/统计代码使用说明.md`）+ 代理 `/apis/{短码}` 自动记账；日志表 `apilog`（含 `iploc` 预留） - **用户令牌（v3.29+）**：表 `apikey`；用户中心与管理员后台均可管理；格式 `SK-`+32 位；每账号最多 3 个；本地/代理调用已校验密钥并累计次数 - **积分计费与充值（v3.33+ / v3.34）**：接口收费扣积分；用户充值中心扫码支付；订单管理与积分变动分栏；回调直访 `core/play/codeplay/notify.php` - **前台双主题**：默认主题（FeerApi 风：粒子背景、终端 Hero、接口目录、在线调试）+ 主题二 slate（API 平台风：搜索与**数据库分类**筛选、接口卡片列表）；首页与全部接口页分类标签默认显示 15 个、超出「更多」展开；各主题 CSS/JS/shell **完全独立** - 前台页面：首页、全部接口、文章、贡献者、友情链接、赞助、关于（导航支持伪静态，URL 无 `.php` 后缀） - 分组侧边栏管理后台（控制台、数据大屏、API 管理、内容运营、交易财务、系统管理） - 用户中心侧边栏：控制台、API 管理（仅开发者，可投稿）、**令牌管理**（创建/重置/禁用，每账号最多 3 个）、积分变动、接口列表、账号设置（部分为占位页） - **用户角色**：普通用户（调用全站接口、管理令牌）/ 开发者（可进入 API 管理提交接口待审）；注册页横条分段选择身份，管理员可转换身份 - 用户管理：列表查看、搜索、封禁/解封/删除、身份转换（AJAX 无整页刷新） - 用户头像：QQ 邮箱自动匹配 / 自定义链接 / 默认头像 - 用户登录支持 QQ / Gitee 第三方登录（须先注册并绑定） - 管理员认证：登录、忘记密码（邮箱验证码）、CSRF 与登录频率限制 - 邮箱验证码发信限流（MySQL 表 `mail_code_rate_log` + 一次性 mail_ticket） - 站点信息、注册邮箱后缀白名单、SMTP 邮箱发信 - **站点扩展（v3.28+）**：自定义底栏左/中/右 HTML、站点运行时间、页脚 1～2 个二维码；主题可开关运行时间 / 二维码 / 合作伙伴 - **SEO（v3.28+）**：公开页 description / OG / Twitter 卡片；后台与登录 `noindex`；根目录 `robots.txt` - **云端在线更新**：后台检测新版本、分步下载安装、可选数据库结构迁移 - 认证页角色动画背景；后台 `vs-overlay` 大弹窗（电脑约 92% 视口 / 手机全宽 85vh 抽屉）与 Toast 提示 - 简洁白色后台主题，纯 CSS 图标，适配电脑端与手机端 ### UI 规范（弹窗 / 布局） - **手机端（≤900px）**：侧边栏默认隐藏，点击顶栏菜单从右侧滑出；点击遮罩关闭 - **电脑端（≥768px）**：侧边栏默认展开，可收缩 - **后台弹窗**：`vs-overlay--lg`——电脑端约 92% 视口居中（上限 1440×960），手机端 100% 宽底部抽屉（85vh），内容区可滚动 - **参数类型选择（v3.32+）**：嵌套选择器——电脑端弹窗中的弹窗、手机端抽屉中的抽屉；预设类型自适应网格 + 自定义输入 - **认证页**：可交互角色动画背景，随前台主题联动 --- ## 代码仓库与下载 | 平台 | 链接 | |------|------| | **Gitee（主仓库）** | [xunjinlu/misc-api](https://gitee.com/xunjinlu/misc-api) | | **发行版下载** | [Releases · 下载 ZIP](https://gitee.com/xunjinlu/misc-api/releases) | 压缩包命名：`misc-api{版本号}.zip`（如 `misc-api1.0.0.zip`）。各版本详细说明见 `发行说明/` 目录。 --- ## 功能列表 | 功能 | 路径 | 说明 | |------|------|------| | 前台首页 | `/` | 主题驱动首页：Hero、统计区、接口目录、在线调试 Playground | | 全部接口 | `/apis` | 公开接口列表（搜索、**数据库分类**筛选，展示已通过审核接口） | | 接口详情 | `/detail.php/{id}` | 单个接口详情（PATH_INFO，不依赖伪静态） | | 文章 | `/articles` | 前台文章列表 | | 贡献者 | `/contributors` | 项目贡献者展示 | | 友情链接 | `/links` | 友链展示 | | 赞助 | `/sponsor` | 赞助说明 | | 关于 | `/about` | 站点与版本信息 | | Web 安装向导 | `/install/` | 五步安装，执行 `install/database.sql` | | 用户登录 | `/user/login.php` | 账号密码登录 + QQ/Gitee 第三方登录 | | OAuth 回调 | `/user/oauth/callback.php` | 第三方授权回调（由平台配置） | | OAuth 绑定 | `/user/oauth/bind.php` | 首次第三方登录绑定已有账号 | | 用户注册 | `/user/register.php` | 邮箱验证码注册，横条分段选择普通用户或开发者 | | 用户忘记密码 | `/user/forgot.php` | 邮箱验证码重置密码 | | 用户中心 | `/user/index.php` | 登录后控制台首页 | | API 管理 | `/user/api-manage.php` | 仅开发者：提交/编辑/删除自有接口，查看审核状态与拒绝原因；手机卡片分页 | | 令牌管理 | `/user/keys.php` | 创建/编辑/重置/禁用/删除调用令牌（每账号最多 3 个，格式 SK-…；点击密钥可复制） | | 积分变动（占位） | `/user/points.php` | 后续开发 | | 接口列表（占位） | `/user/apis.php` | 后续开发 | | 用户账号设置 | `/user/account.php` | 修改资料、头像、密码 | | 管理员登录 | `/admin/login.php` | 管理员登录（安装时创建账号，无开放注册） | | 管理员忘记密码 | `/admin/forgot.php` | 邮箱验证码重置（需配置 SMTP） | | 管理控制台 | `/admin/index` | 后台首页，展示站点与版本信息 | | 数据大屏（占位） | `/admin/data-screen.php` | 后续开发 | | 接口列表 | `/admin/api/list.php` | 紧凑卡片：类型、完整调用链接、状态、调用量、编辑/维护/禁用/删除 | | 接口审核 | `/admin/api/review.php` | 待审/通过/未通过；编辑/通过/不通过；拒绝原因（选填）；邮件通知 | | 接口分类 | `/admin/api/categories.php` | 表格式列表、分类 CRUD、内置 SVG 图标库（自动扫描）、描述、启禁 | | 令牌管理 | `/admin/api/keys.php` | 查看全站用户令牌，可重置/禁用/删除（点击密钥可复制） | | API 管理（占位） | `/admin/api/docs.php` 等 | 文档、反馈仍为占位页 | | 内容运营（占位） | `/admin/content/` | 文章、评论、友链、合作伙伴 | | 交易财务（占位） | `/admin/finance/` | 支付、订单、赞助、积分 | | 用户管理 | `/admin/users.php` | 查看用户、搜索、封禁/解封/删除 | | 公告管理（占位） | `/admin/content/announcements.php` | 后续开发 | | 日志查询（占位） | `/admin/system/logs.php` | 后续开发 | | Redis 管理 | `/admin/system/redis.php` | 业务缓存环形图监控（扇区悬停/点击明细、缓存占用） | | 主题设置 | `/admin/system/theme.php` | 主题切换 + 各主题独立配置 | | 账号设置 | `/admin/account.php` | 修改资料、发布身份绑定用户账号 | | 系统设置 | `/admin/settings.php` | 站点信息、注册策略、OAuth、邮箱发信 | | 系统升级 | `/admin/upgrade.php` | 手动检测更新、安装更新、查看更新记录 | | 关于 | `/admin/about.php` | 系统与环境信息 | | 更新 API | `/admin/update` | 在线更新接口（版本检测 / 分步更新） | | 404 错误页 | `/404.php` | 不存在页面与非法访问提示（含法律条款） | --- ## 后台框架特性 - **自定义 PHP 架构**：无 Laravel / ThinkPHP 等重型框架依赖 - **API 业务层**：`ApiManager`（接口列表 CRUD 与状态）、`ApiCategoryManager`（分类与 `category` 表） - **白色主题**：顶部栏 + 可收缩分组侧边栏 - **电脑端**：侧边栏默认展开，点击左上角可收缩/展开 - **手机端**：侧边栏默认隐藏，点击顶栏菜单滑出 - **弹窗体系**：`assets/css/modal.css` 中的 `vs-overlay` / `vs-overlay--lg`，电脑约 92% 视口、手机全宽抽屉 - **会话超时**：长时间无操作自动退出（可配置） - **系统可配置**：名称、描述、关键词、Favicon、Logo 可在后台修改 - **源码开放**：全部逻辑可阅读、可二次开发 --- ## 环境要求 - **PHP** 7.4 / 8.0 / 8.2（推荐 8.0+） - **MySQL** 5.7+ 或 MariaDB 10.3+ - **PHP 扩展**：pdo、pdo_mysql、**redis**、mbstring、json、session、curl、openssl、zip - **目录权限**：`config/`、`data/` 可写；安装后自动生成 `config/database.php` --- ## 目录结构 ``` misc-api/ ├── README.md ├── CORE模块说明.md # core/ 下全部 PHP 类说明与主题对接指南 ├── LICENSE # 开源协议 ├── update.json # 远程版本清单（在线更新检测） ├── update-log.json # 版本更新记录 ├── 404.php # 全站 404（含安全法律提示） ├── index.php # 前台首页（主题驱动） ├── apis.php # 全部接口列表 + 代理网关（对外 /apis/{短码}，内记统计） ├── api/ # 本地业务接口脚本（头部注入 ApiStats::hit）+ 统计代码使用说明.md │ └── yiyan/ # 示例：随机一言 ├── articles.php # 前台 · 文章 ├── links.php # 前台 · 友情链接 ├── sponsor.php # 前台 · 赞助 ├── contributors.php # 前台 · 贡献者 ├── about.php # 前台 · 关于 ├── .htaccess # Apache 伪静态（可选） ├── admin/ # 后台 │ ├── init.php # 后台统一引导 │ ├── includes/ │ │ ├── layout.php # 侧边栏布局 │ │ └── auth_layout.php # 登录/注册/忘记密码布局 │ ├── api/ # API 管理 │ │ ├── list.php # 接口列表（添加/编辑/状态） │ │ ├── categories.php # 接口分类 │ │ └── review.php / docs.php / feedback.php # 占位 │ ├── content/ # 内容运营（占位） │ ├── finance/ # 交易财务（支付配置/订单/积分） │ ├── system/ # 系统管理扩展（日志等） │ ├── index.php # 控制台 │ ├── data-screen.php # 数据大屏（占位） │ ├── users.php # 用户管理 │ ├── login.php / forgot.php │ ├── account.php # 账号设置 │ ├── settings.php # 系统设置 │ ├── upgrade.php # 系统升级 │ ├── update.php # 更新 API │ └── about.php # 关于 ├── user/ # 用户中心 │ ├── init.php │ ├── includes/layout.php │ ├── index.php │ ├── api-manage.php / keys.php # API 投稿 / 令牌管理（已实现） │ ├── points.php / apis.php # 占位 │ ├── account.php │ └── login.php / register.php / forgot.php ├── assets/ │ ├── css/ # common, admin, modal (vs-overlay), toast, install … │ ├── js/ # common.js, user-keys.js, user-api-manage.js, admin-keys.js … │ └── img/ │ ├── category-icons/ # 内置分类 / 接口 SVG 图标库（自动扫描） │ └── … # 头像、站点图片等 ├── config/ │ ├── database.php # 安装后生成（更新时不覆盖） │ └── install.lock # 安装锁定文件 ├── core/ │ ├── bootstrap.php │ ├── version.php # VS_VERSION 版本常量 │ ├── ThemeManager.php # 前台主题加载与切换 │ ├── ApiManager.php # 接口列表 CRUD 与状态 │ ├── ApiStats.php # 本地/代理调用统计（apilog） │ ├── ApiProxy.php # 代理网关 /apis/{短码} │ ├── ApiCategoryManager.php # 接口分类（后台 CRUD） │ ├── FrontendCategory.php # 前台分类（主题调用） │ ├── FrontendApi.php # 前台公开接口（主题调用） │ ├── FrontendUser.php # 前台用户资料（主题/用户中心调用） │ ├── UserRole.php # 用户角色与权限判断 │ ├── RedisService.php # Redis 连接与监控采集 │ ├── RedisCache.php # 业务数据缓存（接口/分类/限流） │ ├── theme/default/ # 默认主题（FeerApi 风白色 UI） │ ├── theme/slate/ # 主题二（API 平台风） │ │ └── preview.png # 主题预览图 │ ├── Auth.php / UserAuth.php # 管理员与用户认证 │ ├── Updater.php # 云端在线更新 │ ├── UpdateLog.php # 更新记录读取 │ └── DatabaseMigrator.php # 数据库增量迁移 ├── data/ # 运行时数据（更新临时文件等，自动创建） ├── install/ │ ├── index.php # 五步安装向导 │ ├── database.sql # 全新安装数据库结构 │ └── migrations/ # 在线升级增量 SQL └── 发行说明/ # 各版本发行说明 Markdown ``` **core 各 PHP 类详细说明、用法与主题对接规范见根目录 [CORE模块说明.md](CORE模块说明.md)。** --- ## 安装说明 1. 上传代码到 Web 服务器（或 `git clone` 后部署） 2. 确保 `config/` 目录可写 3. 创建 MySQL 空数据库 4. 访问 `https://你的域名/install/` 完成五步安装 5. 安装完成后访问 `/admin/login.php` 登录后台 --- ## 伪静态 / URL 重写 ### Apache 项目根目录 `.htaccess` 已含：全站可用规则 + `/apis/{短码}` → `apis.php?_vs_slug=短码`。启用 `mod_rewrite` 即可。 ### Nginx（宝塔「伪静态」请只粘贴英文规则，不要带中文注释） **可直接粘贴（推荐完整）：** ```nginx location ~ ^/apis/([a-z0-9]+)/?$ { rewrite ^/apis/([a-z0-9]+)/?$ /apis.php?_vs_slug=$1 last; } location / { try_files $uri $uri/ $uri.php$is_args$args; } ``` 若站点配置里已有 `location / { try_files ... }`，**只追加**上面的 `apis` 段，并放在 `location /` **上面**。 > **注意：** 不要写 `[a-z0-9]{3,64}`。宝塔伪静态保存时会吞掉 `{…}`，正则变成 `^/apis/([a-z0-9]` 导致 `pcre_compile() failed: missing )`。长度校验由 PHP 完成即可。 > **注意：** 不要 rewrite 到 `/apis.php/$1`（PATH_INFO），面板 PHP 常只匹配以 `.php` 结尾的 URI。 > **接口详情不需要伪静态：** 出站地址为 `/detail.php/{id}`（PATH_INFO），由 PHP 解析。 详情见 [`nginx伪静态配置.md`](nginx伪静态配置.md)。 --- ## 在线更新 登录后台后会向**云端**检测最新版本（读取 `update.json`）。若本地 `core/version.php` 中的版本号**低于**远程版本，可在「系统升级」中安装更新；若本地**高于**远程（开发测试环境），则提示无需更新。 **更新过程（分步进度）：** 1. 从云端下载资源包 2. 解压更新包 3. 覆盖系统文件（**绝不替换** `config/database.php`、`config/install.lock`，**不覆盖** 运行时 `data/`） 4. 若该版本含数据库结构变更，则执行 `install/migrations/` 增量 SQL 5. 完成后自动清理 `data/update/` 临时文件 **若在线更新失败：** 请从 [发行页](https://gitee.com/xunjinlu/misc-api/releases) 手动下载最新 `misc-api{版本}.zip` 覆盖（保留 `config/database.php`）。 **服务器要求：** PHP `ZipArchive` 扩展、可写项目目录、可访问云端更新源。 --- ## 版本记录 ### v3.34.2（2026-07-18） - 订单/积分：桌面多列表格、标题行紧凑、手机端紧凑卡 ### v3.34.1（2026-07-18） - 订单/积分：筛选与刷新并入标题行；列表紧凑卡片 - 码支付回调直访 `core/play/codeplay/notify.php` / `return.php` ### v3.34.0（2026-07-18） - 订单管理与积分变动拆分为独立页面；状态彩色标识；列表支持每页条数 - 支付配置：图标支付方式按钮 + 套餐可视化编辑；去掉重复页标题 - 收费接口强制需要密钥；GET/POST 切换按钮；密钥参数自动写入 - 用户充值中心 / 积分变动 UI 重做；码支付回调在 `core/play/codeplay/`（带 `.php` 直访，不改伪静态） ### v3.33.0（2026-07-18） **类型：** 大版本（积分计费 + 订单 + 码支付） - 接口收费开关与单次扣费；调用扣积分并写订单 - 用户积分余额、充值中心扫码支付、管理员加减款 - 支付配置（码支付网关 / 渠道 / 套餐 / 兑换比例） - 须执行数据库结构更新 ### v3.32.0（2026-07-18） **类型：** 大版本（参数类型嵌套选择器） - 请求参数类型改为嵌套选择器：电脑端「弹窗中的弹窗」、手机端「抽屉中的抽屉」 - 类型网格式自适应排布（英文 · 中文），支持自定义类型输入 - 修复类型下拉被表格容器裁切不可见的问题 ### v3.31.1（2026-07-18） **类型：** 小版本（列表底栏与参数类型展示） - 用户中心 API/令牌底栏移出背景板；修复末张卡片底边丢失 - 参数类型曾接入 vs-pick 双语下拉（后续由 3.32.0 嵌套选择器取代） ### v3.31.0（2026-07-18） **类型：** 大版本（请求参数表格编辑 + 主题壳层） - 请求参数默认表格填写，支持 JSON 互转 - 修复默认主题用户中心因过期复制 admin.css 导致 UI 丢失 ### v3.30.0（2026-07-18） **类型：** 大版本（令牌页命名与主题二导航） - 令牌页更名为 keys；密钥一键复制 - 主题二用户中心导航与调色盘同步 ### v3.29.1（2026-07-18） **类型：** 小版本（调用守卫文案 + 统计规范） - 统一本地/代理失败提示：该接口已经被禁用、该接口维护中、密钥错误等 - 代理禁用接口返回明确文案并记账 - 完善统计机制开发规范与站长说明 ### v3.29.0（2026-07-18） **类型：** 大版本（用户密钥体系 + API 管理体验） - 新建 `apikey` 表（勿用 `token` 命名）；用户中心令牌管理（创建/编辑/重置/禁用/删除，每账号最多 3 个，`SK-` + 32 位） - 管理员后台「令牌管理」可查看并处理全站密钥 - 本地/代理统计：识别并校验密钥、归属用户、累加密钥调用次数 - 用户 API 管理：手机卡片间距与布局优化，补充分页与接口总数 - 须执行数据库结构更新 ### v3.28.1（2026-07-17） **类型：** 小版本（页脚二维码 / 自定义徽章 / 首页告警） - 双主题页脚二维码缩小并统一靠右 - 自定义底栏徽章图统一高度，修复忽大忽小 - 默认主题首页改为直接读取站点上下文 ### v3.28.0（2026-07-17） **类型：** 中版本（安全纠偏 + 底栏扩展 + SEO + 库表删列） - 忘记密码未注册邮箱禁止发码；登录偶发「来源无效 / 刷新重试」修复 - 删除 `apilog.source`；主题二列表卡片去掉描述占位空白 - 系统设置：底栏三栏自定义、运行时间、二维码；双主题可开关显示 - 全站 SEO 与 `robots.txt`；默认主题赞助页 `//` 标题样式对齐 - 运行时间 JS 归属各主题 assets（删除公共 front-runtime）；默认主题 home 注入变量兜底 ### v3.27.0（2026-07-17） **类型：** 中版本（主题二全页配色 + 双主题详情页） - 主题二选色后顶栏/底栏/背景一并变色；调色盘图标与后台一致 - 修复用户数/今日调用不跳动；主题设置统计项双列网格 - 默认主题与主题二接口详情页完整 UI（响应式） ### v3.26.0（2026-07-17） **类型：** 中版本（主题二卡片/配色 + 后台分页） - 后台分页「每页」横向、选择框与页码按钮同高 - 主题二首页卡片可进详情、双方法徽章、固定卡片高度 - 主题二可配首页统计项与默认浅色；顶栏圆形淡色调色盘 ### v3.25.0（2026-07-17） **类型：** 中版本（详情 PATH_INFO 纠偏、去除外链代理、命名精简） - 接口详情改为 `/detail.php/{id}`（纯 PATH_INFO，**不再**写伪静态） - 移除 `media-proxy` / `ExternalMedia`；外链头像/图标按原 URL 直链加载 - Nginx / `.htaccess` 仅保留 `/apis/{短码}` 代理规则（还原至可用形态） - 页面命名与流程记录规范补强（本地 `开发规范/`） ### v3.24.0（2026-07-17） **类型：** 中版本（接口详情 + 多选请求方式 + 自定义选择面板 + 外链代理 + 后台去 .php） - 请求方式支持 GET/POST 同时勾选；密钥「完全不需要 / 可选」增加说明 - 后台/用户表单单选改用 vs-pick；审核页按钮按状态互斥 - 新增双主题接口详情页；后台去 `.php`；默认主题列表/贡献者/赞助页 UI 对齐 - （已由 3.25.0 纠正：详情伪静态与 media-proxy 方案） ### v3.23.0（2026-07-17） - **真分列布局**：电脑端横向铺开图标/名称/链接/标签/状态/请求/提交/操作；手机满宽右靠、分隔线拉满 - **分页**：每页条数与页码同一行；统计仍在页底居中 - **按钮高亮**：正常/维护/禁用（及审核通过/不通过）常显并变色标识当前态 - **审核红点**：待审时侧栏折叠亮「API 管理」、展开亮「接口审核」 ### v3.22.0（2026-07-17） - **列表布局**：电脑端紧凑行式（非大卡片）；手机端少留白、扁按钮 - **分页外置**：背景板外居中页码 + 每页条数；接口统计移至页底居中 - **规范**：禁止临时脚本改业务文件，临时功能性文件发版前必须删除 ### v3.21.0（2026-07-17） - **卡片 UI**：标签/按钮横排；名称上移；调用链接；提交者+请求次数；代理/本地标签 - **列表能力**：搜索、分页（可选条数）、ID 倒序、标题旁接口统计 ### v3.20.0（2026-07-16） - **接口管理 UI**：电脑端表格行 + 手机端参考卡片；分类/免费/KEY/代理/状态标签；完整调用链接 - **统计注入**：简化为 3 行向上查找；`api/hit.php` 一行引入；规范「宜简不宜繁」 ### v3.19.0（2026-07-16） - **接口管理 UI**：管理端列表/审核、用户端 API 管理改为紧凑卡片；完整调用链接；审核去掉「全部」并修复筛选 - **统计增强**：`apilog.iploc` 预留；本地注入兼容任意目录深度；`api/统计代码使用说明.md` ### v3.18.0（2026-07-16） - **调用统计**：本地文件头 `ApiStats::hit()` + 代理网关自动记账；新表 `apilog`；同步 `api.calls`（须结构更新） ### v3.17.2（2026-07-15） - **接口审核**：修复通过/不通过无响应；仅列开发者投稿；筛选含「全部」，默认待审核 ### v3.17.1（2026-07-15） - **忘记密码 / 改密**：修复邮箱大小写、rowCount 误失败、中文用户名与头像校验拖垮保存等问题（主题 UI 共用核心 `UserAuth`） ### v3.17.0（2026-07-15） - **用户 API 管理**：修复提交无反应、编辑误报网络异常；手机卡片与后台列表布局优化 - **状态标签**：已通过审核只显示「正常」等运行状态，不再叠「审核通过」 ### v3.16.2（2026-07-15） - **文档澄清**：路径样式开发规范恢复为 PATH_INFO 主体；代理伪静态说明独立在 `nginx伪静态配置.md` ### v3.16.1（2026-07-15） - **宝塔伪静态**：去掉正则 `{3,64}`（面板会吞花括号导致无法保存）；文档改为可直接粘贴的纯英文规则 ### v3.16.0（2026-07-15） - **代理伪静态纠偏**：`/apis/{短码}` → `/apis.php?_vs_slug=短码`（兼容宝塔等仅匹配 `*.php` 的规则）；**勿再** rewrite 到 `/apis.php/$1` - **兼容原有去 .php**：保留 `try_files`；列表 `/apis` 与代理 `/apis/短码` 互不冲突 - 发行包新增可随版阅读的 `nginx伪静态配置.md` ### v3.15.0（2026-07-15） - **代理地址美观化**：出站改为 `/apis/{短码}`（能省 `.php` 就省）；`/apis.php/{短码}` 仍可用 - **伪静态**：Nginx / Apache 将 `/apis/{短码}` 转到 `apis.php/{短码}`（PATH_INFO） - **需执行数据库结构更新**（`install/migrations/3.15.0.sql`）；并同步站点伪静态 ### v3.14.0（2026-07-15） - **代理网关纠偏**：公开地址改为 `/apis.php/{短码}`（PATH_INFO），不再依赖 `/apis/短码` 伪静态 - **apis.php**：无路径段 → 列表；有路径段 → 跳转上游；去掉 `?s=` 兜底 - **需执行数据库结构更新**（`install/migrations/3.14.0.sql`） ### v3.13.0（2026-07-15） - **表单修复**：代理外链保存不再误校验本地路径；短码改为必填 - **弹窗顺序**：接口名称优先，图标置于表单末尾（后台 / 用户中心） - **slate 用户中心**：修复「提交接口」与内容面板重叠、点击无反应 - **在线更新**：覆盖后按 `install/obsolete-files.json` 删除废弃文件（如 `proxy.php`） ### v3.12.0（2026-07-15） - **路径样式公开地址**：代理接口由 `/proxy.php?s=短码` 改为 `/apis/{短码}`（如 `/apis/sjspks`） - **入口合并**：移除 `proxy.php`；`apis.php` 兼任列表页与外链网关 - **入站兼容**：`PATH_INFO` / 伪静态路径 / 查询参数 `s` - **伪静态**：Nginx、Apache 增加 `/apis/{短码}` 重写；请同步站点配置 - **需执行数据库结构更新**（`install/migrations/3.12.0.sql`，统一历史 endpoint） ### v3.11.0（2026-07-15） - **本地 / 代理接口**：本地填路径；代理填上游 URL，公开地址原为 `/proxy.php?s=短码`（已由 v3.12.0 改为路径样式） - **投稿权限**：未绑定管理员的开发者仅可投代理；已绑定与管理员可选两种类型 - **用户中心**：修复提交弹窗；右上角提交按钮 - **邮件开关**：投稿 / 通过 / 拒绝通知可分别开关 - **需执行数据库结构更新**（`install/migrations/3.11.0.sql`） ### v3.10.0（2026-07-14） - **开发者投稿**：用户中心「API 管理」可提交/编辑/删除自有接口 - **审核三态**：待审核 / 通过 / 不通过；新增 `rejectreason`（拒绝原因，选填） - **邮件通知**：投稿通知管理员；审核结果通知用户（须配置 SMTP） - **审核页**：空状态对齐接口列表；拒绝时可选填原因 - **需执行数据库结构更新**（`install/migrations/3.10.0.sql`） ### v3.9.0（2026-07-14） - **字段命名**：去掉下划线，改为短英文（`needkey`/`audit`/`createtime`/`userid`/`binduid`/`avatar`/`calls`/`params`/`doc`/`aidoc` 等） - **表重命名**：`mail_code_rate_log` → `mailrate` - **策略**：新版不长期兼容旧字段名；升级后执行结构更新即可 - **需执行数据库结构更新**（`install/migrations/3.9.0.sql`） ### v3.8.1（2026-07-14） - **残留清理**：移除旧文件管理系统迁入的 LocalStorage 迁移、废弃 `Domain.php`、后台无效的 upload-queue 资源引用 - 结构更新时自动清理残留表（`domain` / `file_folder` / `file_item`）与配置键（如 `storage_local_public_slug`、`bound_domains`） ### v3.8.0（2026-07-14） - **库表中文注释**：所有表/字段补齐详细中文 COMMENT；去掉纯英文注释 - **接口状态数字化**：`status` 改为 `0` 正常 / `1` 禁用 / `2` 维护（升级自动转换旧英文值） - **审核字段**：新增 `audit_status`（`0` 不通过 / `1` 通过）；管理员发布默认通过；前台仅展示已通过且非禁用接口 - **接口审核页**：可筛选并切换通过/不通过（用户投稿上线后可复用） - **需执行数据库结构更新**（`install/migrations/3.8.0.sql`） ### v3.7.1（2026-07-14） - **下拉**：修复请求方式 / 状态 / 分类箭头重影 - **密钥三态**：不需要 / 必须 / 可选；前台对接 `require_api_key` 0/1/2 - **弹窗**：LG 桌面约 92vw×88vh；空状态仅保留右上角添加入口 - **图标选择**：去掉搜索，改为点选 ### v3.7.0（2026-07-14）· 大版本 - **图标库**：内置 SVG 扩充至约 188 个；分类 / 接口弹窗自动扫描并可搜索选用 - **交互**：图标入场、列表行与表单 Tab 过渡动画；尊重 `prefers-reduced-motion` - **接口列表**：空状态引导与表未就绪时「前往系统升级」入口；双端布局优化 - **说明**：若仍见「功能开发中」，请升级至本版（接口列表自 3.6.0 起已非占位页） ### v3.6.0（2026-07-14）· 大版本 - **API 表重构**：废弃旧审核字段，重建为接口运营模型（参数、返回示例、普通/AI 文档、调用次数、密钥、图标、状态） - **接口列表**：后台 `/admin/api/list.php` 大弹窗添加/编辑；禁用 / 维护 / 正常状态；本地 SVG + 外链图标 - **前台**：`FrontendApi` 对接新字段；禁用不展示；维护中请求提示「维护中」 - **数据库迁移**：`install/migrations/3.6.0.sql`（**会清空旧 api 表数据**） - **清理**：移除废弃的 `api-review.js`、空 `api/` 目录 ### v3.5.1（2026-07-14） - **修复**：回退 3.5.0 默认主题登录/注册/忘记密码/绑定页视觉改版，恢复原双栏角色小人界面 - **清理**：移除默认主题 anime.js 动效依赖 ### v3.5.0（2026-07-14） - **默认主题认证页**：登录 / 注册 / 忘记密码（及绑定）与前台 Feer 视觉统一（已由 3.5.1 回退） - **动效**：本主题引入 anime.js（已由 3.5.1 移除） ### v3.4.3（2026-07-14） - **修复**：回退 3.4.2 引出线饼图（手机端线条溢出、UI 错乱）；恢复 3.4.1 环形图交互，并加强卡片防溢出 ### v3.4.2（2026-07-14） - **Redis 饼图**：默认引出线指向各扇区并显示数据；点击扇区外扩高亮对应引出线与标注（中心同步聚焦），不再使用图下方提示条 ### v3.4.1（2026-07-14） - **Redis 监控**：去掉图表下方重复图例与冗余统计卡片；SVG 环形图支持悬停/点击高亮并展示明细 - **缓存占用**：缓存项状态图中心默认显示业务缓存占用；多端图表网格自适应 ### v3.4.0（2026-07-14） - **认证页**：主题 1 登录/注册/忘记密码/绑定去掉输入框上方标签，提示改入 placeholder；主题 2 注册用户名占位改为「请输入用户名（3～50 个字符）」 - **Toast**：长条内 flex 垂直居中（内层 `.vs-toast__text`），单行不再偏上 - **Redis**：运行时长显示天/时/分/秒并每秒累加；业务缓存「刷新周期」保持静态，仅剩余秒数倒计时 - **用户管理**：手机卡片角色标签移至右上角（OAuth 图标左侧），右下增加「最后登录」 - **接口分类**：手机端「接口数量」移至「启用」标签左侧 ### v3.3.0（2026-07-14） - **Toast**：全站改为长条形圆角提示，手机端左右留边；禁止胶囊/灵动岛形 - **按钮规范**：后台按钮统一圆角矩形（`--vs-btn-radius: 10px`）；新增《按钮样式规范》 - **主题 1**：注册身份滑块样式写入 `core/theme/default/assets/auth.css`，修复无渲染问题 - **主题 2**：登录/注册/忘记密码/绑定页移除输入框上方标签，保留 placeholder + `aria-label` - **主题切换**：后台桌面端待保存主题 `.is-selected` 边框持久显示 - **Redis**：管理页增加命中/键分布/缓存项饼图；文案去站点化；超限时自动清理限流键 ### v3.2.1（2026-07-14） - **注册页 UI**：移除「注册身份」卡片区块；用户名上方增加横条分段选择器（普通用户 / 开发者），滑块随点击切换 - **身份说明**：切换身份时 Toast 提示权限说明；默认主题与主题二布局一致 ### v3.2.0（2026-07-13） - **Redis 业务缓存**：新增 `RedisCache.php`；公开接口列表、分类标签读 Redis；发信限流优先 Redis 写入，减轻 MySQL 压力 - **Redis 管理页**：聚焦 misc-api 业务缓存（命中率、各缓存项状态、可一键清空）；服务器信息收折展示；移动端布局优化 - **接口分类**：修复桌面端「接口/状态/操作」列错位；手机端卡片显示「接口数量」 ### v3.1.0（2026-07-13） - **Redis 管理页**：由占位改为完整监控面板（版本、内存、键数、命中率、QPS、服务器 INFO） - **core/RedisService.php**：统一 Redis 连接与指标采集；支持 config 表配置 host/port/password/db/prefix - **关于页**：环境信息「当前域名」改为「Redis 版本」 ### v3.0.0（2026-07-13）· 大版本 - **用户角色体系**：`user` 表新增 `role` 字段（`user`=普通用户、`developer`=开发者） - **core 调度**：`UserRole.php` 权限判断；`FrontendUser.php` 统一用户名/头像/邮箱/角色（主题与用户中心通过 core 获取，禁止直读库） - **注册**：默认普通用户；注册页横条分段选择开发者，切换时 Toast 说明权限 - **用户中心**：普通用户隐藏「API 管理」；直链访问 `/user/api-manage` 服务端拦截并提示身份 - **后台**：用户管理新增身份列与「设为开发者 / 设为普通」AJAX 操作 - **数据库迁移**：`install/migrations/3.0.0.sql` ### v2.17.1（2026-07-13） - **core 统一调度**：新增 `FrontendCategory.php`（分类）、`FrontendApi.php`（公开接口）；主题只调用 core 类，不直接访问数据库表/字段 - **自定义主题**：主题三及后续主题可直接 `FrontendCategory::listTags()` / `FrontendApi::listForTheme()` 读取数据 - **分类展示**：全部已启用分类始终显示（与下属接口数量无关）；分类键统一为 `all` + 数据库 **id** - **移除**：各主题 `includes/api-payload.php`；前台分类逻辑从 `ApiCategoryManager` 迁至 `FrontendCategory` ### v2.17.0（2026-07-13） - **双主题分类对接**：默认主题与主题二首页/全部接口页分类标签从数据库读取（纯文字，无图标） - **分类展示**：自动换行；默认显示 15 个，超出显示「更多」可展开 - **主题二重构**：首页真实接口列表；全部接口页改为搜索 + 分类 + 卡片网格（移除建设中占位） - **后端**：`listEnabled()` 按 `sort_order` 排序 ### v2.16.4（2026-07-13） - **弹窗优化**：标题区浅灰底 + 底部分隔线；底部按钮加大（电脑 46px / 手机 48px 高） - **分类图标**：新增 12 款内置 SVG（网易云、QQ音乐、王者荣耀等），内置共 35 款 - **弹窗规范**：更新 `开发规范/弹窗开发规范.md` v1.2 ### v2.16.3（2026-07-13） - **标题栏**：「添加分类」移至「接口分类」标题同一行右侧（背景框外） - **手机端卡片**：名称在上、描述在下；编辑/启用/删除靠右下角 - **操作按钮**：改为带边框的 `vs-btn--pill` 胶囊样式 - **布局扩展**：`vs_admin_layout_start` 支持第三参数 `$headerActions` ### v2.16.2（2026-07-13） - **接口分类页**：卡片改为紧凑表格式列表，移除搜索框；「添加分类」按钮右对齐 - **操作样式**：编辑/启禁/删除改为文字链接，减少占位 - **弹窗修复**：修复手机端抽屉未铺满屏幕宽度（`--form` 宽度误作用于移动端） - **大弹窗**：新增 `vs-overlay--lg`，电脑端 75% 视口（15/20），手机端 100% 宽 85vh 抽屉 - **弹窗规范**：更新 `开发规范/弹窗开发规范.md` v1.1 ### v2.16.1（2026-07-13） - **接口分类页**：恢复 `vs-panel` 背景板，去除内容区重复标题与说明文案 - **工具栏**：添加分类（左）+ 搜索框（右）同一行；输入内容后显示「搜索」按钮 - **弹窗**：按 `开发规范/弹窗开发规范.md` 改用 `vs-overlay`（电脑居中 / 手机 80vh 抽屉） - **内置图标**：扩充为 23 款内置 SVG（图片、视频、AI、热榜、抖音等） ### v2.16.0（2026-07-13） - **接口分类页重构**：去除重复标题与背景板，改为卡片列表 + 搜索 - **修复 AJAX 无刷新**：添加/编辑/删除/启禁后立即更新列表（修正 `code` 响应判断） - **添加分类弹窗**：电脑端居中弹窗，手机端 80% 高度底部抽屉 - **分类图标**：8 款内置 SVG + 自定义正方形图片链接；新增 `description` 字段 - **需执行数据库结构更新**（`install/migrations/2.16.0.sql`） ### v2.15.1（2026-07-13） - **表名精简**：接口分类表 `api_category` 重命名为 `category`（新装直接使用短表名） - 新增本地规范 `开发规范/数据库开发规范.md`（原「数据库命名规范」）：表名能短则短，避免冗余 `api_` 等前缀；表/字段须带详细 COMMENT - 迁移 `2.15.1.sql`：已存在 `api_category` 的站点自动 `RENAME` ### v2.15.0（2026-07-13） - **后台 API 管理 · 接口分类**：新增分类 CRUD、启用/禁用、排序；重命名同步更新已关联接口 - 新增 `category` 表与 `ApiCategoryManager`；前台接口目录优先展示后台启用的官方分类 - **需执行数据库结构更新**（`install/migrations/2.15.0.sql`） ### v2.14.4（2026-07-12） - **首页统计**：第三项由「系统版本」改为「累计调用次数」，读取配置项 `api_total_calls`（可在 `vs_config` 表设置数值） - **移除主题一昼夜切换**：顶栏去掉切换按钮，`front-theme.js` 固定浅色模式 - **分类标签**：修复深色模式下选中态文字不可见等问题；默认主题 v1.5.4 ### v2.14.3（2026-07-12） - **修复 Hero 首屏异常**：v2.14.2 的 `section { display:block }` 覆盖了 `.hero-section` 的 flex 居中，导致内容贴顶、下方大面积留白；已恢复垂直居中并优化 min-height - Hero 按钮补全 clip-path 与 hover 样式；标题改为 block 排版，修正「开放 API 接口平台」间距 - 默认主题 v1.5.3 ### v2.14.2（2026-07-12） - **修复主题一布局根因**：`front-common.css` 误将 `.main-wrapper` 设为 `display:flex`（横向），导致 Hero/统计/接口/调试/合作伙伴全部并排重叠；已移除并强制纵向 block 排版 - 默认主题 v1.5.2 ### v2.14.1（2026-07-12） - **修复主题一布局错乱**：新增 `feer-compat.css` 兼容 Tailwind 工具类；CDN 优先加载 Tailwind，本地 vendor 回退 - **顶栏 Logo** 改为站点设置中的自定义图标（与站点绑定），无配置时使用中性占位 - **移除 `api-proxy.php`**；首页在线调试改为浏览器直连，跨域时给出友好提示 - 默认主题 v1.5.1 ### v2.14.0（2026-07-12） - **主题一参考 UI 完整复刻**：迁入粒子背景、Glitch Hero、终端、接口目录、在线调试、合作伙伴等；绿色色板改为 misc-api 白色主题 - 新增 `api-proxy.php`、`ThemeManager::defaultFrontendAssets()` 多资源加载；默认主题 v1.5.0 ### v2.13.0（2026-07-12） - **默认主题（主题一）前台全面重设计**：首页 Hero + 统计区 + 接口目录（搜索/分类/卡片），多栏页脚与返回顶部 - **全部接口**页展示已通过审核的公开 API / TAPI，支持搜索与分类筛选 - `ApiManager` 新增 `listPublic`、`countApproved`、`categoriesFromList`；默认主题 v1.4.0 ### v2.12.2（2026-07-12） - 主题二首页**恢复胶囊式统计**（收录 / 今日调用 / 累计调用横排），并优化阴影、分隔线与窄屏横向滚动 ### v2.12.1（2026-07-12） - **主题二**（slate）更名为「主题二」，取消「青绿平台」对外命名 - 修复 FAB 导航保存后不显示；顶栏仅**站点名称**可跳转首页（Logo 区域不再误触） - 首页主标题留空时显示「欢迎使用 {站点名}」；副文案支持**打字机效果** - 统计区由胶囊改为三卡片布局，视觉更清晰 ### v2.12.0（2026-07-12） - 后台 **API 管理** 新增 **接口审核**（待审核 / 已通过 / 已拒绝 / 下线），新增 `{prefix}api` 数据表 - 修复主题设置保存后「当前使用」标志不随切换实时更新；主题卡片补充 **版本号** 展示 - **主题二** 主题设置新增导航展开方式：顶栏抽屉（默认）或右下角 FAB 向上弹出 - **默认主题** 首页移除「快速入口」板块 ### v2.11.2（2026-07-12） - 还原青绿主题认证页为 2.10.2 前的居中无卡片布局（标题右对齐、渐变光球背景），保留 mail_ticket 等安全能力 - 桌面端适度放宽表单宽度；修复「忘记密码」等辅助链接在小屏/窄宽下被挤压截断 ### v2.11.1（2026-07-12） - 重构青绿主题认证页为双栏布局（左品牌 / 右表单），修复动效异常与文字溢出 ### v2.11.0（2026-07-12） - 限流表重命名为 `mail_code_rate_log`（字段 `limit_key` / `created_at`），自动迁移旧表 - 青绿主题登录页：电脑端右侧登录 + 左侧原生动效；手机端保持居中样式 ### v2.10.2（2026-07-12） - 邮箱验证码限流改为 MySQL 表存储；新增 `mail_ticket` 一次性票据防抓包重放 - 加强 IP 日/小时限额，限制轮换邮箱无限制发信；清理误提交的开发规范文档 ### v2.10.1（2026-07-12） - 加固邮箱验证码 `send_code` 服务端限流，防止接口工具持续轰炸 - 新增《邮箱发信规范.md》；前端倒计时与限流策略同步为 120 秒 ### v2.10.0（2026-07-12） - 后台主题设置：二级导航「主题切换 / 主题设置」；移除卡片设置按钮与弹窗 - 主题卡片简化展示，画廊区域分界强化；修正 README Nginx 伪静态 ### v2.9.0（2026-07-12） - 后台主题设置：画廊悬停黑边框、卡片下设置按钮、专属配置弹窗（手机 75% 抽屉 / 电脑居中） - 主题 `data/settings.json` 专属存储；`ThemeManager::themeSetting()` 前台读取 ### v2.8.1（2026-07-12） - 修复青绿主题账号设置页头像栏与第三方账号栏宽度不一致、电脑端右侧空白 ### v2.8.0（2026-07-12） - 青绿用户中心移除侧栏；右下角圆形三横线 FAB 向上弹出导航（含退出） - 选中菜单仅青绿背景、无左侧竖线；前台首页整体浅绿渐变 ### v2.7.0（2026-07-12） - 青绿用户中心恢复侧边栏 `st-uc`，布局对齐 default；固定青绿渐变、移除调色盘 - 右下角三角横线 FAB 展开侧栏；圆角优化；账号设置头像尺寸限制防溢出 ### v2.6.0（2026-07-12） - 青绿用户中心 `st-dash` 顶栏导航重构（非 default 侧边栏）；渐变顶栏 + 调色盘顶栏内挂载 - 认证页无卡片无图标：标题右对齐动效，表单全屏居中 ### v2.5.0（2026-07-12） - 青绿用户中心 `st-uc` 独立 UI 重构；修复顶栏「退出」hover 绿色色块 - 认证页验证码行横排优化；双主题登录态显示头像 +「用户中心」 ### v2.4.0（2026-07-12） - 青绿平台认证页双栏重设计，修复站点 Logo 尺寸异常；原生动画与 loading 交互 - 首页统计改为参考主题单行胶囊条；全站返回顶部按钮 ### v2.3.0（2026-07-12） - 主题严格隔离：`ThemeManager` 无跨主题回退，路径穿越防护 - 青绿平台认证四页独立 `st-auth` 视觉；用户中心独立 shell 与完整样式脚本 - 《主题规范.md》扩充主题引入与渲染流程说明 ### v2.2.0（2026-07-12） **类型：** 中版本（用户中心主题联动） **变更说明：** - 用户中心/认证页迁入主题包，随 `frontend_theme` 切换 - 新增《主题规范.md》；主题文件夹自动扫描识别 - 后台主题设置「当前使用」逻辑修正；青绿平台统计横排 ### v2.1.1（2026-07-11） **类型：** 小版本（青绿平台主题优化） **变更说明：** - 主题二更名为「青绿平台」，首页搜索 + 统计 + 分类，移除快速入口 - 预览图规范：`core/theme/{id}/preview.png`，开发阶段随主题包预部署 - 页脚四列布局与参考 HTML 对齐 ### v2.1.0（2026-07-11） **类型：** 小版本（双主题 UI 优化） **变更说明：** - 默认主题手机端右侧抽屉、遮罩关闭、站点图标与名称 - 青绿平台主题（slate）全新重做，电脑端顶栏 / 手机端抽屉 - 前台导航 URL 去除 `.php`，适配 nginx 伪静态 ### v2.0.0（2026-07-11） **类型：** 大版本（双主题体系） **变更说明：** - 默认主题 + 深岩主题（slate），CSS/JS 完全独立 - 贡献者页面、导航顺序梳理、主题预览与画廊设置 ### v1.9.0（2026-07-11） **类型：** 大版本（前台主题系统 + 多页面） **变更说明：** - 前台主题系统 `core/theme/default`，页面 PHP 动态加载主题模板 - 新增 apis/articles/links/sponsor/about 前台页面 - 电脑端顶栏导航 + 手机端侧边栏与登录/注册 - 后台主题设置、`frontend_theme` 配置与 1.9.0 迁移 ### v1.8.2（2026-07-11） **类型：** 小版本（界面优化） **变更说明：** - 用户管理手机端：标题/计数靠左、搜索靠右 - 账号设置电脑端：左侧栏加宽、头像放大、表单铺满右侧 - 账号设置保存按钮统一靠右 ### v1.8.1（2026-07-11） **类型：** 小版本（界面修复） **变更说明：** - 管理员账号设置页电脑端恢复左右布局（与用户中心一致） - 发布身份绑定解除按钮样式优化 ### v1.8.0（2026-07-11） **类型：** 大版本（安装检测 + 管理员用户绑定） **变更说明：** - 安装检测：Redis 扩展必选、config/data 目录可写、MySQL 扩展必选 - 管理员表新增 `bound_user_id`，账号设置支持绑定用户发布身份 - 数据库迁移 `1.8.0.sql` ### v1.7.1（2026-07-11） **类型：** 小版本（侧边栏菜单扩展） **变更说明：** - 控制台下方新增独立模块「数据大屏」（占位） - 系统管理下新增「Redis 管理」（占位） ### v1.7.0（2026-07-11） **类型：** 大版本（安全 404 + 用户搜索 + 公告占位） **变更说明：** - 全站 404 页面与网络安全法律提示 - 用户管理列表搜索（电脑端常显 / 手机端放大镜展开） - 内容运营新增公告管理占位 ### v1.6.1（2026-07-11） **类型：** 小版本（侧边栏菜单微调） **变更说明：** - 用户中心「管理」更名为「API 管理」，新增「令牌管理」 - 管理员系统管理下新增「主题设置」占位页 ### v1.6.0（2026-07-11） **类型：** 大版本（双端侧边栏导航扩展） **变更说明：** - 用户中心新增：管理、积分变动、接口列表（一级菜单占位页） - 管理员后台新增：API 管理、内容运营、交易财务、系统管理四大分组 - 系统管理整合用户管理、日志查询等；请求规范强调静态更新优先 ### v1.5.0（2026-07-11） **类型：** 大版本（表单 POST 安全与 AJAX 无刷新） **变更说明：** - 修复用户管理封禁/删除后浏览器刷新「重新发送表单」：AJAX 局部更新 - 用户/管理员账号设置、OAuth 解绑改为 AJAX；系统设置统一 CSRF 校验 - 新增 `VS.postForm()` 与《请求与表单规范.md》（本地维护） ### v1.4.4（2026-07-11） **类型：** 小版本（OAuth 会话修复 + 升级页 UI） **变更说明：** - 修复第三方绑定后跳转登录页，回调后自动恢复登录态 - 系统升级页有新版时显示 `当前版本 → 新版本` 箭头 ### v1.4.3（2026-07-11） **类型：** 小版本（账号设置 UI 修复） **变更说明：** - 修复账号设置页提示条与输入框宽度/列对齐不一致 - 更新《界面提示规范.md》§4.1 账号表单 Notice 约定 ### v1.4.2（2026-07-11） **类型：** 小版本（OAuth 绑定 Bug 修复） **变更说明：** - 修复 Gitee/QQ 账号设置绑定回调 state 失效（SameSite=Lax + HMAC 签名 state） - 绑定错误跳转账号设置页 ### v1.4.1（2026-07-11） **类型：** 小版本（账号设置 UI 优化） **变更说明：** - 电脑端账号设置：第三方绑定移至头像侧栏下方 - 移动端绑定/解绑按钮圆角优化（6px，避免过圆） ### v1.4.0（2026-07-11） **类型：** 大版本（用户管理功能增强） **变更说明：** - 管理员可封禁/解封/删除用户（复用 `status` 字段，无需数据库迁移） - 用户管理移动端卡片紧凑化，OAuth 状态右上角图标展示 - 删除用户二次确认；封禁账号登录明确提示 ### v1.3.1（2026-07-11） **类型：** 小版本（OAuth 体验与安全优化） **变更说明：** - 登录页第三方图标居中，位于登录按钮正下方 - 用户账号设置支持第三方绑定/解绑 - OAuth 安全加固（state intent、授权码防重放、会话完整性、频率限制） - 用户管理移动端卡片紧凑化；Notice 提示去除图标 ### v1.3.0（2026-07-11） **类型：** 大版本（OAuth 聚合登录 + 用户管理） **变更说明：** - 用户登录页支持 QQ / Gitee OAuth（须先注册，首次绑定验证账号密码） - 用户表新增 `oauth_qq_openid`、`oauth_gitee_id` - 后台新增用户管理页（响应式表格/卡片） - 系统设置新增 OAuth 配置 ### v1.2.0（2026-07-11） **类型：** 次大版本（修复 + UI + 注册策略 + 架构简化） **变更说明：** - 修复系统升级页更新记录无法显示 - 统一界面提示组件（`vs-notice`），新增《界面提示规范.md》 - 注册邮箱后缀白名单（JSON 配置） - 移除多域名/子域名绑定功能 ### v1.1.1（2026-07-11） **类型：** 小版本（用户后台 UI 与账号能力） **变更说明：** - 用户后台自适应侧边栏 + 顶栏布局 - 新增用户账号设置页与头像支持 - 官网隐藏管理后台入口 ### v1.1.0（2026-07-10） **类型：** 大版本（用户体系） **变更说明：** - 新增用户模块：登录、邮箱注册、忘记密码、用户中心 - 新增 `vs_user` 数据表 - 移除管理员开放注册 - 用户注册需管理员配置邮箱发信 ### v1.0.0（2026-07-10） **类型：** 初始版本 **变更说明：** - misc-api 初始版本发布 - 管理员认证与安全防护 - 系统设置（站点信息、邮箱发信） - 在线更新机制 - 安装向导（五步 Web 安装） - 响应式后台管理界面 - 角色动画登录页面 - 主题切换 --- ## 开源协议 本项目采用 **[misc-api 开源许可协议](LICENSE)**。 ### 您可以 - **学习研究**：阅读、学习本项目全部源码 - **个人使用**：在个人网站、项目中免费使用 - **商业使用**：在商业项目中免费使用 - **修改分发**：可修改代码并再发布（需保留版权声明与协议全文） ### 作者声明（免责） - 本项目按 **「原样（AS IS）」** 提供，**不提供任何明示或暗示的担保** - 因使用、无法使用或依赖本项目而产生的任何直接、间接、附带、特殊或后果性损害（包括但不限于数据丢失、业务中断、安全漏洞、法律纠纷等），**作者不承担任何责任** - 使用者应自行评估安全风险，并在生产环境中做好备份、加固与合规审查 完整法律条文见仓库根目录 **[LICENSE](LICENSE)** 文件。 --- ## 作者与仓库 - 仓库地址：[https://gitee.com/xunjinlu/misc-api](https://gitee.com/xunjinlu/misc-api) - 问题反馈：请通过 Gitee Issues 提交 --- > 维护者本地文档（README 编写要点、发版检查清单等）不随仓库发布，请在本地查阅。