GitHub 资源加速
主题预设
快捷设置
GitHub 资源加速
支持 GitHub、GitLab、Gitee，支持批量、历史、进度和多节点。
批量输入链接
拖拽 `.txt / .csv` 文件到这里，或点击选择文件导入。
等待输入链接...
选择加速节点
PC 端可拖拽，移动端自动适配
节点加载失败，请点击重试。
节点状态加载中...
未找到匹配节点
最近使用
共 0 个节点
测速报告
暂无测速数据
批量处理进度
0/0
| # | 资源 | 原始链接 / 加速链接 | 操作 |
|---|---|---|---|
| 暂无结果，生成后显示 | |||
离线缓存队列
0 个任务
评论功能已关闭，如需留言请联系管理员。
访客
游客
将记住你上次的定位偏好，提交时自动沿用。
将记住你上次的设备显示偏好，提交时自动沿用。
支持 Markdown 实时预览、图片上传与快捷筛选。
0/2000
评论预览
输入后会自动渲染 Markdown。
请输入内容后在这里预览。
验证码
当命中评论风控规则时，需要先完成数学验证码。
支持 Markdown 图片上传。允许：JPG, JPEG, PNG, WEBP, GIF；单文件 ≤ 8MB；单次 ≤ 10 个；总计 ≤ 32MB
当前页面评论来自 0 个城市 / 0 种浏览器 / 0 类终端 / 0 种系统 / 0 种协议 / 0 类身份 / 0 种定位方式
0 条评论
当前显示 0 条评论
暂无评论，欢迎第一个留言。
编辑评论
请输入内容后在这里预览。
支持 Markdown 与图片上传。允许：JPG, JPEG, PNG, WEBP, GIF；单文件 ≤ 8MB；单次 ≤ 10 个；总计 ≤ 32MB
举报评论
请选择举报类型后提交。
操作确认
更新日志
共 304 条
更新日志
本文件记录项目的重要更新与已知问题，便于快速排查。
最后整理时间：2026-03-24 12:47:46
阅读说明 (2026-03-24 12:47:46)
阅读说明
- 本日志按版本号倒序维护：最新版本在最前，历史版本向下追溯。
- 每个版本默认包含“版本时间”与“小节更新时间”，便于回溯发布节奏。
- 建议先看“版本阶段索引”，再用“全版本速查”定位到具体版本。
版本阶段索引 (2026-03-24 12:47:46)
版本阶段索引
| 阶段 | 版本范围 | 核心主题 |
| --- | --- | --- |
| 当前迭代阶段 | v1.0.301 ~ v1.0.53 | 灵动岛能力扩展、全局时间格式治理、异常状态码体系、认证与全站页面统一视觉治理、用户组功能中心、后台侧边栏菜单重构、全页面防溢出与性能收敛 |
| 运营与日志阶段 | v1.0.52 ~ v1.0.45 | 公告中心、更新日志管理中心、识别与导入增强 |
| 体验与下载阶段 | v1.0.44 ~ v1.0.29 | 结果区体验、下载状态机、移动端与布局稳定性 |
| 审计增强阶段 | v1.0.28 ~ v1.0.25 | 审计筛选、审阅状态、前后对比与风控能力 |
| 评论系统阶段 | v1.0.24 ~ v1.0.17 | 评论交互、身份展示、IP 定位、编辑与举报流程 |
| 基础能力阶段 | v1.0.16 ~ v1.0.1 | 后台可视化、工单、安全修复、品牌与缓存基础建设 |
全版本速查（301） (2026-03-24 12:47:46)
全版本速查（301）
<details>
<summary>点击展开完整版本索引（v1.0.301 ~ v1.0.1）</summary>
| 版本 | 发布时间 | 主题 |
| --- | --- | --- |
| v1.0.301 | 2026-03-24 05:44:15 | 后台顶栏恢复右侧内容区布局：assets/admin-dashboard.js 关闭后台壳子自动改成 split-header 通栏顶栏的运行时重排逻辑，恢复成顶栏留在右侧内容区顶部；admin/*.php 统一升级后台公共资源版本到 20260324-admin-polish-v48，确保浏览器及时刷新；README / CHANGELOG 同步更新 |
| v1.0.300 | 2026-03-24 05:28:59 | 后台移动端侧栏恢复直出布局：assets/admin-dashboard.css + assets/admin-dashboard.js 将后台手机端侧栏改成默认隐藏、初始化完成后再允许展开，避免首屏直接出现覆盖式抽屉；admin/*.php 统一升级后台公共资源版本到 20260324-admin-polish-v47，确保浏览器及时刷新；README / CHANGELOG 同步更新 |
| v1.0.299 | 2026-03-23 21:18:30 | 评论区统计面板可视化与设备信息左对齐：index.php / assets/quick-page.js 将评论筛选统计详情面板升级为可视化分布条，展示各维度条目数、占比和热度；assets/main.css / assets/quick-page.css 把评论设备信息块和移动端折叠态改成更紧凑的左对齐信息流；index.php / quick.php / about.php 升级到 main.css?v=20260323-site-polish-v108、quick-page.css?v=20260323-quick-page-v39、quick-page.js?v=20260323-quick-page-v49；README / CHANGELOG 同步更新 |
| v1.0.298 | 2026-03-23 21:05:00 | 评论区 IP 协议筛选与快捷标签扩展：lib/comments.php / lib/db.php / sql/gh-proxy-app.sql 新增 comments_show_ip_version_filter 与 quick_filter_include_ip_version 默认值、读取和保存；admin/comments.php 后台评论策略面板新增 IP 协议筛选开关，评论样式面板新增“快捷筛选包含 IP 协议”；lib/templates/comments_panel.php / index.php / assets/quick-page.js 新增“全部协议 / IPv4 / IPv6”筛选、协议统计和快捷标签联动；quick.php 提升评论脚本资源版本到 quick-page.js?v=20260323-quick-page-v48；README / CHANGELOG 同步更新 |
| v1.0.297 | 2026-03-23 20:46:20 | 评论区终端类型筛选与快捷标签扩展：lib/comments.php / lib/db.php / sql/gh-proxy-app.sql 新增 comments_show_device_type_filter 与 quick_filter_include_device_type 默认值、读取和保存；admin/comments.php 后台评论策略面板新增终端类型筛选开关，评论样式面板新增“快捷筛选包含终端类型”；lib/templates/comments_panel.php / index.php / assets/quick-page.js 新增“全部终端 / 移动端 / 桌面端”筛选、终端类型统计和快捷标签联动；quick.php 提升评论脚本资源版本到 quick-page.js?v=20260323-quick-page-v47；README / CHANGELOG 同步更新 |
| v1.0.296 | 2026-03-23 20:24:18 | 评论区快捷筛选标签与后台维度控制：lib/comments.php / lib/db.php / sql/gh-proxy-app.sql 为 comments_ui_settings 新增 show_quick_filter_chips / quick_filter_chip_limit / quick_filter_include_city / author / geo_source / browser / system；admin/comments.php 后台评论样式面板新增快捷筛选条总开关、数量上限和维度控制；lib/templates/comments_panel.php / index.php / assets/quick-page.js 新增热门快捷筛选标签并接入同一套筛选状态联动；assets/main.css / assets/quick-page.css 补齐快捷标签亮暗主题与移动端样式；index.php / quick.php / about.php 提升前台资源版本；README / CHANGELOG 同步更新 |
| v1.0.295 | 2026-03-23 19:55:07 | 评论区视图工具条与本地记忆增强：lib/comments.php / lib/db.php / sql/gh-proxy-app.sql 为 comments_ui_settings 新增 show_view_toolbar / remember_filter_state / remember_preview_state；admin/comments.php 后台评论样式面板新增对应开关；lib/templates/comments_panel.php / index.php / assets/quick-page.js 新增评论区视图工具条、本地筛选记忆、预览开关记忆以及长评论一键展开/收起；assets/main.css / assets/quick-page.css 补齐新工具条样式；index.php / quick.php / about.php 提升前台资源版本；README / CHANGELOG 同步更新 |
| v1.0.294 | 2026-03-23 19:32:40 | 评论区全端美化与交互增强：lib/comments.php / lib/db.php / api/comments.php / api/admin-comments.php 新增统一 comments_ui_settings 配置与后台保存接口；admin/comments.php 新增“评论区样式 / 交互增强”面板；lib/templates/comments_panel.php / index.php / assets/quick-page.js / assets/comments-renderer.js 接入实时预览、字数统计、拖拽上传态、移动端筛选折叠、已选标签移除与长评论折叠；assets/main.css / assets/quick-page.css 收口首页与简洁页评论区样式；sql/gh-proxy-app.sql 补齐 comments_ui_settings 默认值；index.php / quick.php / about.php 提升前台资源版本；README / CHANGELOG 同步更新 |
| v1.0.293 | 2026-03-23 08:18:28 | 评论前台设备详情与 IP 协议图标优化：lib/comments.php 修复系统版本格式化丢失斜杠、补充设备详细摘要；api/comments.php 新增公开 ip_version 字段；assets/comments-renderer.js / assets/main.css / assets/quick-page.css 重做设备折叠摘要与居中样式，并新增前台 IPv4/IPv6 协议图标；index.php / quick.php / about.php 提升前台资源版本；README / CHANGELOG 同步更新 |
| v1.0.292 | 2026-03-23 08:01:17 | 评论 IPv6 自动切换 UAPI 数据源：lib/comments.php 新增 UAPI ipinfo 查询、IPv6 provider 自动切换与 comments_ip_geo_uapi_* 配置读取/保存；admin/comments.php 的评论定位面板升级为“IP 数据源设置”，新增 UAPI IPv6 数据源 / API Key / source 后台项与 IPv4/IPv6 链路摘要；lib/db.php / sql/gh-proxy-app.sql 补齐新的数据库默认配置键；README / CHANGELOG 同步更新 |
| v1.0.291 | 2026-03-23 07:32:46 | 评论 IPv6 定位与通知邮件渲染修复：lib/comments.php 新增 IPv4 / IPv6 识别、IPv6 provider 动态回退与评论邮件内容渲染 helper；admin/comments.php 后台定位测试补充 IP 类型提示；lib/mail.php 统一把 logo / 链接 / 图片转成绝对 URL，并为评论通知邮件补充 Markdown 内容容器样式；lib/auth.php 的模板回退链路也改为继续走统一邮件包装；README / CHANGELOG 同步更新 |
| v1.0.290 | 2026-03-23 07:18:10 | 评论区移动端显示重做：assets/comments-renderer.js 将评论副信息改成分组结构，移除单行文本串联；assets/main.css / assets/quick-page.css 重做手机端筛选栏、验证码区、定位块、设备块和评论卡片间距；移动端设备折叠态重新显示摘要文本，不再只剩图标；index.php / quick.php / about.php 升级到 main.css?v=20260323-site-polish-v103、quick-page.css?v=20260323-quick-page-v34、comments-renderer.js?v=20260323-comments-renderer-v3；README / CHANGELOG 同步更新 |
| v1.0.289 | 2026-03-23 07:12:00 | 评论筛选维度继续扩展：admin/comments.php 新增前台 身份筛选 / 定位方式筛选 开关；lib/comments.php / lib/db.php / sql/gh-proxy-app.sql 补齐 comments_show_author_filter / comments_show_geo_source_filter 配置读取与默认种子；lib/templates/comments_panel.php 将顶部筛选锚点修正到评论列表前，并新增身份 / 定位方式下拉；index.php / assets/quick-page.js 接入五维组合筛选与完整重置；quick.php 升级到 quick-page.js?v=20260323-quick-page-v43；README / CHANGELOG 同步更新 |
| v1.0.288 | 2026-03-23 06:55:00 | 评论区后台前台控制增强：admin/comments.php 新增排序栏 / 筛选栏 / 验证码策略及定位、设备发布控件的后台控制项；lib/comments.php 扩展评论控制、定位前台控制、设备前台控制并加入服务端强制兜底；index.php / assets/quick-page.js / lib/templates/comments_panel.php 新增城市 / 浏览器 / 系统筛选、筛选栏位置切换与前台强制模式处理；api/comments.php / api/captcha.php / lib/captcha_runtime.php 接入评论验证码“始终显示”强制校验；lib/db.php / sql/gh-proxy-app.sql 补齐新配置键；README / CHANGELOG 同步更新 |
| v1.0.287 | 2026-03-23 06:08:08 | 评论设备信息前台缓存刷新修复：index.php / quick.php / about.php 提升前台资源版本号，强制刷新新的 main.css、comments-renderer.js、quick-page.js、quick-page.css，修复后台已开启设备信息但前台仍沿用旧单行文案的问题；index.php / assets/quick-page.js 同步把设备提示改为“自动识别浏览器与系统”；README / CHANGELOG 同步更新 |
| v1.0.286 | 2026-03-23 05:58:33 | 评论设备信息两行展示与后台配置：lib/comments.php 新增评论设备显示模式、UA 解析、公开/后台 payload 与真实后台配置透传；api/comments.php / api/admin-comments.php 下发前后台设备设置；admin/comments.php 新增设备设置面板与设备详情展示；index.php / assets/quick-page.js / assets/comments-renderer.js 完成前台设备开关、模式记忆、两行展示与移动端折叠；lib/db.php / sql/gh-proxy-app.sql 补齐评论设备字段与 comments_device_* 配置种子；README / CHANGELOG 同步更新 |
| v1.0.285 | 2026-03-23 05:26:42 | 后台评论定位异常筛选与诊断：lib/comments.php 新增后台定位异常诊断 helper 与异常统计，支持识别精确定位与 IP 不一致、坐标不完整、服务缺失、地址层级缺失等问题；api/admin-comments.php 新增 geo_anomaly 后台筛选参数；admin/comments.php 增加异常状态筛选、异常统计卡、行级高亮和详情诊断说明；本轮无新增 SQL 结构；README / CHANGELOG 同步更新 |
| v1.0.284 | 2026-03-23 05:12:41 | 后台评论定位筛选与详情增强：admin/comments.php 为评论列表新增 定位来源 / 可见范围 / 定位精度 / 地区关键词 / 定位服务关键词 筛选，并为评论详情弹窗新增独立“定位详情”区块、地图外链和回复/历史评论定位摘要；api/admin-comments.php / lib/comments.php 同步接入 geo_source / geo_visibility / geo_accuracy / geo_city_keyword / geo_provider_keyword 后台过滤参数；本轮无新增 SQL 结构；README / CHANGELOG 同步更新 |
| v1.0.283 | 2026-03-23 05:10:00 | 评论定位敏感配置改为数据库直读：lib/comments.php 为 app_settings 文件级预取缓存新增敏感键排除，comments_ip_geo_amap_key / comments_ip_geo_amap_secret 等值不再写入 cache/app-settings-prefetch-cache.php；敏感键读取会自动回退数据库查询，确保高德定位 Key / 安全密钥继续以数据库为主；README / CHANGELOG 同步更新 |
| v1.0.282 | 2026-03-23 04:18:00 | 评论定位接入高德地图后台配置与测试：admin/comments.php 新增“评论定位 / 高德地图设置”面板与顶部直达入口，支持评论 IP 定位开关、定位链路切换（自动回退 / 仅高德 / 旧版回退）、高德 Key / 安全密钥 / sig、超时、缓存 TTL、在线测试与缓存清理；api/admin-comments.php 新增 geo_settings 下发、保存、测试、清缓存动作；lib/comments.php 接入高德 v3/ip provider 与调试/测试 helper；lib/db.php / sql/gh-proxy-app.sql 补齐默认配置键；README / CHANGELOG 同步更新 |
| v1.0.281 | 2026-03-23 03:41:44 | 首页在线下载关闭态切到下载优先高亮：index.php 把“已关闭网页在线下载”场景改为下载优先布局，极速直链 会在保留元信息面板时也直接升级成亮色主按钮，并按下载优先顺序重排动作区；assets/main.css 新增下载优先态样式；index.php / quick.php / about.php 同步升级 main.css?v=20260323-site-polish-v100；README / CHANGELOG 同步更新 |
| v1.0.280 | 2026-03-23 03:24:37 | 首页在线下载开关增强：admin/global_manage.php 新增“关闭首页网页在线下载 / 首页在线下载失败后自动切极速直链”两个后台开关；index.php 关闭在线下载后不再显示站内在线下载状态机，并把无直链场景的 缓存后下载 升级成 打开下载+缓存；在线下载失败时可自动弹出极速直链；lib/db.php / sql/gh-proxy-app.sql 补齐新配置键；README / CHANGELOG 同步更新 |
| v1.0.279 | 2026-03-22 22:25:11 | 后台顶栏锁定真正生效：api/admin-toolbar.php 新增后台顶栏锁定配置下发；assets/admin-dashboard.js 读取 顶栏默认锁定 / 允许自定义 / 锁定按钮显隐，并在后台 Mega Toolbar 上新增 L 锁定按钮；assets/admin-dashboard.css 将桌面端后台顶栏改为默认流式、锁定后再 sticky；后台公共资源版本统一升级到 20260322-admin-polish-v46；README / CHANGELOG 同步更新 |
| v1.0.278 | 2026-03-22 22:07:36 | 后台左栏固定跟随顶栏：assets/admin-dashboard.css 将桌面端 split-header 左侧栏改为固定视口定位，不再随右侧内容滚动一起上滑；assets/admin-dashboard.js 新增左栏顶部偏移与高度实时同步，顶栏显示/隐藏时左栏会自动跟随到正确位置；后台公共资源版本统一升级到 20260322-admin-polish-v45；README / CHANGELOG 同步更新 |
| v1.0.277 | 2026-03-22 22:05:06 | 前后台顶栏入口拆分：lib/admin_sidebar_menu.php 将 /admin/topbar_manage.php 左侧菜单改名为“前台顶栏功能管理”，并新增“后台顶栏管理”二级菜单直达 /admin/global_manage.php#adminTopbarConfig；admin/global_manage.php 把后台顶栏相关开关拆成独立区块；admin/topbar_manage.php / admin/dynamic_island.php 同步更新标题与跳转文案；README / CHANGELOG 同步更新 |
| v1.0.276 | 2026-03-22 22:31:06 | 后台顶栏改为通栏锁定布局：assets/admin-dashboard.js 新增共享后台壳层重排，会自动把顶栏提升到第一行并同步顶栏高度；assets/admin-dashboard.css 将桌面端后台改成“顶栏通栏 + 下方侧栏/内容”两行结构，左侧栏会自动贴在顶栏下方，锁定后的顶部 Mega Toolbar 不再被左栏截断；移动端继续保留抽屉侧栏回退；后台公共资源版本统一升级到 20260322-admin-polish-v44；README / CHANGELOG 同步更新 |
| v1.0.275 | 2026-03-22 22:19:18 | 后台共享批量范围联动：assets/admin-dashboard.js 在共享工具条上继续新增 当前可见 / 整个表单 批量范围切换，批量勾选与批量排序会直接跟随当前分组筛选、视图筛选和关键词过滤命中项生效；复选框表单与纯排序表单都会记住上次范围，摘要也会实时显示本次批量动作将作用多少项；assets/admin-dashboard.css 补齐范围下拉样式；后台公共资源版本统一升级到 20260322-admin-polish-v43；README / CHANGELOG 同步更新 |
| v1.0.274 | 2026-03-22 22:08:36 | 后台共享分组直达与空分组隐藏：assets/admin-dashboard.js 在共享工具条上继续新增分组下拉、分组状态记忆、空分组自动隐藏与标题区块识别，长表单现在可以按 section.panel / fieldset / 标题分组 直接切换；定位改动 若被当前分组挡住也会自动切到目标分组；assets/admin-dashboard.css 补齐分组下拉与空分组隐藏样式；后台公共资源版本统一升级到 20260322-admin-polish-v42；README / CHANGELOG 同步更新 |
| v1.0.273 | 2026-03-22 21:48:52 | 后台共享筛选状态记忆与已填写视图：assets/admin-dashboard.js 在共享工具条上继续新增 只看已填写、重置筛选 和每表单筛选状态记忆，刷新后台后会自动恢复视图模式、关键词和批量排序起始值 / 步长；定位改动 也会在需要时自动清空关键词并切到改动视图；后台公共资源版本统一升级到 20260322-admin-polish-v41；README / CHANGELOG 同步更新 |
| v1.0.272 | 2026-03-22 21:39:25 | 后台通用关键词过滤与未配置项聚焦：assets/admin-dashboard.js 在共享工具条上继续新增关键词过滤与 只看未配置，支持按字段名 / 说明 / 当前值过滤当前表单，并快速揪出空文本、空下拉、空文本域和整组未勾选项；assets/admin-dashboard.css 补齐搜索输入框与过滤态样式；后台公共资源版本统一升级到 20260322-admin-polish-v40；README / CHANGELOG 同步更新 |
| v1.0.271 | 2026-03-22 21:26:21 | 后台通用批量表单筛选与定位增强：assets/admin-dashboard.js 在共享工具条上继续新增 显示全部 / 只看已勾选 / 只看未勾选 / 只看已改动 / 只看排序改动 视图筛选，以及 定位改动；assets/admin-dashboard.css 补齐筛选激活态、隐藏态和定位高亮态；后台公共资源版本统一升级到 20260322-admin-polish-v39；README / CHANGELOG 同步更新 |
| v1.0.270 | 2026-03-22 21:18:36 | 后台通用批量表单工具条扩展：assets/admin-dashboard.js 新增共享后台表单增强，自动为后台配置页注入 全选 / 全不选 / 反选 / 恢复初始、顺排 / +步长 / -步长 / 恢复初始、实时摘要与 跳到保存；同时补齐已有专属批量页和表格行勾选列表的跳过规则，后台公共资源版本统一升级到 20260322-admin-polish-v38；README / CHANGELOG 同步更新 |
| v1.0.269 | 2026-03-22 20:24:55 | 网站全局管理批量排序与布局 JSON 导入导出：admin/global_manage.php 新增当前可见排序项一键顺排、步长增减、恢复默认排序，以及布局配置 JSON 导入导出区；同名排序字段会自动联动，避免共享排序项改漏；同时修复页面内联脚本里的 elseif 语法错误，恢复批量工具交互；README / CHANGELOG 同步更新 |
| v1.0.268 | 2026-03-22 20:15:10 | 网站全局管理批量表单控制增强：admin/global_manage.php 新增全局批量工具条和分组级快捷操作，支持 全选 / 全不选 / 反选 / 恢复默认，并新增 只看已勾选 / 只看未勾选 / 只看已改动 / 显示全部 状态筛选与实时统计摘要；后台布局配置不再需要逐项勾选；README / CHANGELOG 同步更新 |
| v1.0.267 | 2026-03-22 18:13:05 | 网站全局管理保存互不串档：admin/global_manage.php 将“保存全局配置”和“保存菜单布局”拆成独立动作，侧栏菜单区新增单独保存按钮；提交时按动作临时禁用无关字段，避免超大表单超过 max_input_vars 后截断，导致取消一个勾选时其他配置也被误清空；README / CHANGELOG 同步更新 |
| v1.0.266 | 2026-03-22 18:05:38 | 首页关闭结果面板后的整页滚动修复：index.php 在无面板模式下为 body 增加 home-result-meta-hidden 状态类；assets/main.css 关闭右侧“最近生成记录”的内部滚动并恢复整页自然滚动，解决“页面像动不了了”的体感；index.php / quick.php / about.php 同步升级 main.css?v=20260322-site-polish-v99；README / CHANGELOG 同步更新 |
| v1.0.265 | 2026-03-22 17:50:16 | 首页结果面板后台可关闭：admin/global_manage.php 新增 layout.home.show_result_meta_panel 开关；index.php 关闭面板后不再渲染结果详情行，
v1.0.301 (2026-03-24 05:44:15)
后台顶栏恢复右侧内容区布局
- 变更文件：
assets/admin-dashboard.jsadmin/*.phpREADME.mdCHANGELOG.md- 变更说明：
- 关闭后台壳子里“自动把顶栏抽到页面最上面并拉成整条通栏”的运行时重排逻辑，恢复成顶栏留在右侧内容区顶部，左侧栏继续从页面顶部开始独立显示。
- 后台所有引用
admin-dashboard.css/js的页面统一升级到20260324-admin-polish-v48，确保浏览器及时刷新到这轮顶栏布局回退。 - 本轮没有新增配置键，也没有改 SQL 结构，属于后台共享布局回退修复。
- 文档同步：
- 推荐版本、顶部速查与正文详细小节同步推进到
v1.0.301。
v1.0.300 (2026-03-24 05:28:59)
后台移动端侧栏恢复直出布局
- 变更文件：
assets/admin-dashboard.cssassets/admin-dashboard.jsadmin/*.phpREADME.mdCHANGELOG.md- 变更说明：
- 后台移动端侧栏改成默认收起，首屏优先展示内容区域，不再先渲染成左侧覆盖式抽屉；只有点击菜单按钮后才展开侧栏。
- 侧栏遮罩同步改成默认隐藏；并补上“移动端侧栏初始化完成”标记，避免部分手机浏览器在 JS 接管前先闪出抽屉层和遮罩。
- 后台所有引用
admin-dashboard.css/js的页面统一升级到20260324-admin-polish-v47，确保浏览器及时刷新到这轮移动端后台恢复修复。 - 本轮没有新增配置键，也没有改 SQL 结构，属于后台共享响应式布局热修。
- 文档同步：
- 推荐版本、顶部速查与正文详细小节同步推进到
v1.0.300。
v1.0.299 (2026-03-23 21:18:30)
评论区统计面板可视化与设备信息左对齐
- 变更文件：
index.phpassets/quick-page.jsassets/main.cssassets/quick-page.cssquick.phpabout.phpREADME.mdCHANGELOG.md- 变更说明：
- 评论筛选统计详情面板改为可视化分布条，城市 / 身份 / 定位方式 / 浏览器 / 终端 / 系统 / 协议会显示条目数、占比和相对热度。
- 评论卡片里的设备信息块改成左对齐信息流，浏览器 / 系统两行展示在桌面端更紧凑，移动端折叠态也不再垂直居中发散。
- 首页 / 简洁页 / 关于页前台样式资源版本提升到
main.css?v=20260323-site-polish-v108，简洁页额外提升到quick-page.css?v=20260323-quick-page-v39、quick-page.js?v=20260323-quick-page-v49，确保浏览器及时刷新新样式与统计面板。 - 本轮没有新增配置键，也没有改 SQL 结构，属于评论区前台展示与交互优化。
- 文档同步：
- 推荐版本、顶部速查与正文详细小节同步推进到
v1.0.299。
v1.0.298 (2026-03-23 21:05:00)
评论区 IP 协议筛选与快捷标签扩展
- 变更文件：
lib/comments.phplib/db.phpsql/gh-proxy-app.sqladmin/comments.phplib/templates/comments_panel.phpindex.phpassets/quick-page.jsquick.phpREADME.mdCHANGELOG.md- 变更说明：
- 评论控制新增
comments_show_ip_version_filter，评论区 UI 新增quick_filter_include_ip_version，默认值、读取、保存、运行时补种和 SQL 初始化脚本全部对齐。 - 后台评论策略面板新增“显示 IP 协议筛选”，评论样式面板新增“快捷筛选包含 IP 协议”，前后台对
IPv4 / IPv6这个维度都可以单独开关。 - 评论公共模板新增“IP 协议”下拉，首页与极速页支持按“全部协议 / IPv4 / IPv6”过滤评论，并继续与已选标签、重置筛选和本地记忆共用同一套状态。
- 评论筛选统计摘要、统计详情面板、快捷筛选标签同步接入协议维度，评论筛选总览不再缺少 IPv4 / IPv6 分布。
- 简洁页评论脚本缓存版本升级到
quick-page.js?v=20260323-quick-page-v48，避免浏览器继续命中旧评论筛选逻辑。 - 文档同步：
- 推荐版本、顶部速查与正文详细小节同步推进到
v1.0.298。
v1.0.297 (2026-03-23 20:46:20)
评论区终端类型筛选与快捷标签扩展
- 变更文件：
lib/comments.phplib/db.phpsql/gh-proxy-app.sqladmin/comments.phplib/templates/comments_panel.phpindex.phpassets/quick-page.jsquick.phpREADME.mdCHANGELOG.md- 变更说明：
- 评论控制新增
comments_show_device_type_filter，评论区 UI 新增quick_filter_include_device_type，默认值、读取、保存、运行时补种和 SQL 初始化脚本全部对齐。 - 后台评论策略面板新增“显示终端类型筛选”，评论样式面板新增“快捷筛选包含终端类型”，前后台对“移动端 / 桌面端”这个维度都可以单独开关。
- 评论公共模板新增“终端类型”下拉，首页与极速页支持按“全部终端 / 移动端 / 桌面端”过滤评论，并继续与已选标签、重置筛选和本地记忆共用同一套状态。
- 评论筛选统计摘要、统计详情面板、快捷筛选标签同步接入终端类型维度，不再只有浏览器 / 系统两个设备侧筛选入口。
- 简洁页评论脚本缓存版本升级到
quick-page.js?v=20260323-quick-page-v47，避免浏览器继续命中旧评论筛选逻辑。 - 文档同步：
- 推荐版本、顶部速查与正文详细小节同步推进到
v1.0.297。
v1.0.296 (2026-03-23 20:24:18)
评论区快捷筛选标签与后台维度控制
- 变更文件：
lib/comments.phplib/db.phpsql/gh-proxy-app.sqladmin/comments.phplib/templates/comments_panel.phpindex.phpassets/quick-page.jsassets/main.cssassets/quick-page.cssquick.phpabout.phpREADME.mdCHANGELOG.md- 变更说明：
comments_ui_settings新增show_quick_filter_chips / quick_filter_chip_limit / quick_filter_include_city / quick_filter_include_author / quick_filter_include_geo_source / quick_filter_include_browser / quick_filter_include_system，默认值、读取补种、后台保存与 SQL 初始化脚本全部对齐。- 评论后台“评论区样式 / 交互增强”面板新增快捷筛选条总开关、数量上限和五个维度开关，方便按城市、身份、定位方式、浏览器、系统分别控制是否进入快捷标签。
- 评论公共模板新增
commentQuickFilterChips容器，首页与极速页会根据当前评论统计自动生成热门快捷筛选标签，点击即可切换筛选，再次点击可直接取消。 - 快捷筛选条与原有下拉筛选、已选标签、统计摘要、重置按钮、本地记忆共用同一套状态，避免出现两套筛选来源不同步。
- 首页与极速页同步补齐快捷筛选标签的亮色 / 暗色 / 移动端样式，手机端改成整行按钮，减少按钮堆叠和文字挤压。
- 前台资源版本升级到
main.css?v=20260323-site-polish-v107、quick-page.css?v=20260323-quick-page-v38、quick-page.js?v=20260323-quick-page-v46，强制浏览器刷新到这轮评论筛选增强。 - 文档同步：
- 推荐版本、顶部速查与正文详细小节同步推进到
v1.0.296。
v1.0.295 (2026-03-23 19:55:07)
评论区视图工具条与本地记忆增强
- 配置与 SQL
lib/comments.php+lib/db.php+sql/gh-proxy-app.sql- 评论区 UI 配置新增
show_view_toolbar、remember_filter_state、remember_preview_state三个后台可控项。 - 运行时默认值、补种逻辑与 SQL 初始化脚本同步对齐，避免新装库、升级库和现网补种出现配置漂移。
- 后台配置页
admin/comments.php- 评论后台“评论区样式 / 交互增强”面板新增“显示评论区视图工具条 / 记住筛选状态 / 记住预览开关状态”开关。
- 配置摘要会直接显示当前视图工具条与本地记忆策略，后台核对更直观。
- 前台模板与交互
lib/templates/comments_panel.php+index.php+assets/quick-page.js- 评论区新增共用视图工具条，支持长评论一键“展开全部 / 收起全部”，并补了“清除本地记忆”按钮。
- 评论筛选状态和发布区预览开关支持本地记忆；刷新页面后会自动恢复上次筛选和预览展开状态，也可一键恢复默认视图。
- 样式与缓存版本
assets/main.css+assets/quick-page.css+index.php+quick.php+about.php- 首页与简洁页同步补齐视图工具条样式，并做了移动端自适应，避免按钮拥挤。
- 前台资源版本提升到
main.css?v=20260323-site-polish-v106、quick-page.css?v=20260323-quick-page-v37、quick-page.js?v=20260323-quick-page-v45，确保浏览器及时刷新到这轮评论区视图增强。 - README / CHANGELOG 同步
README.md+CHANGELOG.md- 推荐版本、顶部速查与正文详细小节同步推进到
v1.0.295。
v1.0.294 (2026-03-23 19:32:40)
评论区全端美化与交互增强
- 配置与接口
lib/comments.php+lib/db.php+api/comments.php+api/admin-comments.php- 评论区新增统一
comments_ui_settingsJSON 配置，公共评论接口会把 UI 设置下发到前台，后台评论接口也会返回当前配置并支持独立保存。 - 新装库、升级库与运行时补种统一走同一份默认值，覆盖评论序号、长评论折叠、移动端筛选折叠、实时预览、字数统计、拖拽上传、卡片圆角/阴影/颜色和移动端操作按钮文案。
- 后台配置页
admin/comments.php- 新增“评论区样式 / 交互增强”面板，可直接控制评论序号、折叠行数、实时预览、字数统计、拖拽上传、筛选栏移动端折叠、卡片样式和移动端按钮文案。
- 顶部工具栏补上“评论区样式”直达入口，后台切配置时不需要再从长页面里手动寻找区块。
- 前台模板与交互
lib/templates/comments_panel.php+index.php+assets/quick-page.js+assets/comments-renderer.js- 评论发布区新增实时 Markdown 预览、字数统计、拖拽上传态、预览开关与更清晰的状态提示。
- 评论筛选栏升级为“统计摘要 + 已选标签 + 移动端折叠面板 + 重置筛选”，支持直接点标签移除当前筛选。
- 评论列表新增长内容折叠/展开、评论序号显隐、移动端操作按钮紧凑态与更统一的评论卡片布局。
- 前台样式
assets/main.css+assets/quick-page.css- 首页与简洁页评论区样式统一收口；简洁页追加
#commentsSection专属覆盖层，避免旧 quick 评论样式把新的评论布局、预览区、筛选栏与折叠样式压回旧观感。 - SQL 与缓存版本
sql/gh-proxy-app.sql+index.php+quick.php+about.php- SQL 两处
app_settings初始化区段都补齐comments_ui_settings，与lib/db.php当前默认值保持一致。 - 前台资源版本提升到
main.css?v=20260323-site-polish-v105、quick-page.css?v=20260323-quick-page-v36、comments-renderer.js?v=20260323-comments-renderer-v5、quick-page.js?v=20260323-quick-page-v44，确保浏览器能及时拿到这轮评论区增强。 - README / CHANGELOG 同步
README.md+CHANGELOG.md- 推荐版本、顶部速查和正文详细小节同步推进到
v1.0.294。
v1.0.293 (2026-03-23 08:18:28)
评论前台设备详情与 IP 协议图标优化
- 前台 payload
lib/comments.php+api/comments.php- 评论设备公开 payload 新增
summary_detailed，移动端折叠态会优先显示详细浏览器行与系统行，不再只剩浏览器 · 系统简写。 - 修复系统版本格式化把
Windows 10/11压成Windows 1011的问题，前台会继续保留10/11斜杠写法，并正确展示Windows 10/11 x64。 - 评论公共接口新增只读
ip_version字段，前台可以区分IPv4 / IPv6，但不会把真实 IP 暴露到页面。 - 前台渲染与样式
assets/comments-renderer.js+assets/main.css+assets/quick-page.css- 评论设备块改成更居中的双行布局，移动端折叠按钮也会直接显示详细摘要，与后台设备摘要更接近。
- 评论副信息区新增
IPv4 / IPv6协议图标，只显示协议类型小圆标，不显示具体地址。 - 资源版本
index.php+quick.php+about.php- 前台资源版本提升到
main.css?v=20260323-site-polish-v104、quick-page.css?v=20260323-quick-page-v35、comments-renderer.js?v=20260323-comments-renderer-v4，确保浏览器刷新到本轮修复。 - README / CHANGELOG 同步
README.md+CHANGELOG.md- 推荐版本、顶部速查与正文详细小节同步推进到
v1.0.293。 - SQL 说明
- 本轮没有新增配置键、表或字段，因此
lib/db.php/sql/gh-proxy-app.sql不需要改动。
v1.0.292 (2026-03-23 08:01:17)
评论 IPv6 自动切换 UAPI 数据源
- 定位链路
lib/comments.php- 新增 UAPI
GET https://uapis.cn/api/v1/network/ipinfo查询支持，IPv4 继续优先走高德，IPv6 会自动优先切到 UAPI，再回退兼容兜底服务。 - 评论定位配置新增
uapi_enabled / uapi_api_key / uapi_source(default/commercial)读取、保存与摘要输出；UAPI 走Authorization: Bearer请求头，不会把 API Key 写死进代码。 - 在线测试失败提示同步补充
UAPI API Key检查项，避免 IPv6 问题仍只提示高德配置。 - 后台配置页
admin/comments.php- 评论定位面板升级为“IP 数据源设置”，新增
启用 UAPI IPv6 数据源、UAPI API Key、UAPI source(default/commercial)配置项。 - 定位摘要现在会分别展示
IPv4 尝试顺序与IPv6 尝试顺序，后台在线测试也会显示 UAPI 配置状态，便于确认“高德只跑 IPv4、UAPI 处理 IPv6”是否生效。 - 数据库与 SQL
lib/db.php+sql/gh-proxy-app.sql- 新增
comments_ip_geo_uapi_enabled、comments_ip_geo_uapi_api_key、comments_ip_geo_uapi_source默认配置种子，确保新装库、升级库与运行时补种一致。 - README / CHANGELOG 同步
README.md+CHANGELOG.md- 推荐版本、顶部速查与正文详细小节同步推进到
v1.0.292。
v1.0.291 (2026-03-23 07:32:46)
评论 IPv6 定位与通知邮件渲染修复
- 定位链路
lib/comments.php- 新增
comment_geo_ip_version()与按 IP 版本动态调整 provider 的逻辑，评论定位现在会明确区分 IPv4 / IPv6。 - IPv6 不再优先请求高德 IP 定位；自动 / 仅高德模式遇到 IPv6 时，会自动优先回退到兼容的
ipwhois链路，降低空结果概率。 - 后台定位测试返回值与通用定位结果新增
ip_version，便于排查缓存命中、在线测试与真实请求链路。 - 后台测试面板
admin/comments.php- 评论定位测试说明补充 IPv6 行为提示，测试结果会直接显示
IPv4 / IPv6类型，方便核对当前 provider 顺序是否符合预期。 - 邮件通知
lib/comments.php+lib/mail.php+lib/auth.php- 评论管理员通知与回复通知改为复用评论区 Markdown 安全渲染结果，不再把正文固定包成纯文本
<pre>。 - 邮件模板包装器会把站点 logo、模板按钮、评论里的 Markdown 链接 / 图片地址统一补成绝对 URL，修复邮件客户端里 logo 不显示、链接 / 图片失效的问题。
- 评论通知邮件新增专用正文样式，正文、引用、代码块、图片全部改成高对比度展示；模板回退时也继续走统一包装层。
- README / CHANGELOG 同步
README.md+CHANGELOG.md- 推荐版本、顶部速查与正文详细小节同步推进到
v1.0.291。 - SQL 说明
- 本轮没有新增配置键、表或字段，因此
lib/db.php/sql/gh-proxy-app.sql不需要改动。
v1.0.290 (2026-03-23 07:18:10)
评论区移动端显示重做
- 评论渲染结构
assets/comments-renderer.js- 评论副信息改成“主信息行 + 扩展信息行”结构，不再把时间、定位、设备、历史评论、ID 全部用文本分隔符硬串在一行里。
- 移动端样式
assets/main.css+assets/quick-page.css- 手机端评论筛选栏改成单列堆叠布局，统计摘要独占一行，筛选下拉和重置按钮按竖向顺序排列。
- 手机端验证码区域改成纵向布局，输入框和刷新按钮不再横向硬挤。
- 评论卡片的定位信息、设备信息改成独立块，设备折叠态恢复显示摘要文字，不再只剩图标。
- 评论头像、卡片内边距、信息区间距和按钮尺寸同步收口，整体视觉更适合窄屏。
- 资源版本
index.php+quick.php+about.php- 前台资源版本提升到
main.css?v=20260323-site-polish-v103、quick-page.css?v=20260323-quick-page-v34、comments-renderer.js?v=20260323-comments-renderer-v3，确保浏览器刷新到本轮移动端修复。 - 文档
README.md+CHANGELOG.md- 推荐版本、顶部索引和正文说明同步推进到
v1.0.290。 - 说明
- 本轮没有新增配置键、表或 SQL 结构。
v1.0.289 (2026-03-23 07:12:00)
评论筛选维度扩展与位置修正
- 后台控制项
admin/comments.php- 评论策略配置继续新增
身份筛选、定位方式筛选两个前台开关，和城市 / 浏览器 / 系统 / 统计摘要 / 重置按钮 / 筛选栏位置 / 验证码策略一起统一受后台控制。 - 服务端配置
lib/comments.php- 评论控制默认值、配置读取、公开下发和保存逻辑补齐
show_author_filter、show_geo_source_filter，前后台配置链路保持一致。 lib/db.php+sql/gh-proxy-app.sql- 新增
comments_show_author_filter、comments_show_geo_source_filter默认种子，保证新装库、升级库和运行时补种一致。 - 前台交互
lib/templates/comments_panel.php- 评论筛选栏顶部锚点改到评论列表前，
列表上方 / 列表下方现在真正围绕评论列表生效；同时新增身份 / 定位方式两个筛选下拉。 index.php+assets/quick-page.js- 首页与简洁页评论区扩展为
城市 / 身份 / 定位方式 / 浏览器 / 系统五维组合筛选，统计摘要同步补齐五类维度；重置筛选会一次清空所有前台筛选项。 quick.php- 简洁页评论脚本资源版本提升到
quick-page.js?v=20260323-quick-page-v43，避免浏览器继续命中旧筛选逻辑缓存。 - 验证码与文档
api/comments.php+api/captcha.php+lib/captcha_runtime.php- 评论验证码
智能触发 / 始终显示逻辑继续保持不变，这轮筛选增强不会影响验证码展示和服务端强制校验。 README.md+CHANGELOG.md- 推荐版本、顶部索引和正文说明同步推进到
v1.0.289。
v1.0.288 (2026-03-23 06:55:00)
评论区后台前台控制增强
- 后台控制项
admin/comments.php- 评论策略配置新增
排序栏显隐、筛选栏显隐、筛选统计摘要、城市 / 浏览器 / 系统筛选、筛选栏位置与评论验证码策略（智能触发 / 始终显示）。 - 定位与设备设置新增发布区控件能力配置：
是否显示控件、是否允许用户切换、默认勾选、强制开启、是否允许切换模式。 - 服务端配置与兜底
lib/comments.php- 扩展评论基础控制、定位前台控制、设备前台控制的默认配置、读取、保存和公开下发结构。
- 评论提交链路新增服务端强制兜底，后台如果设为“强制开启”或“固定默认状态”，前端篡改请求也不会绕过。
api/comments.php+api/captcha.php+lib/captcha_runtime.php- 评论验证码新增
always模式，评论区首屏会直接拿到 challenge，提交时也会按强制模式校验，不再只是前端显示题目。 - 前台交互
lib/templates/comments_panel.php- 评论筛选栏改为共享容器，默认移动到评论头部下方，并补上
浏览器 / 系统两个筛选下拉与重置筛选按钮。 index.php+assets/quick-page.js- 首页与简洁页评论区新增
城市 / 浏览器 / 系统三维筛选、筛选栏位置切换、排序栏显隐、验证码策略透传，以及定位 / 设备控件的“用户可切换 / 默认勾选 / 强制开启 / 固定模式”联动。 assets/main.css+assets/quick-page.css- 补齐新筛选栏、重置按钮、暗色主题和移动端布局样式。
- 数据基线与缓存
lib/db.php+sql/gh-proxy-app.sql- 新增
comments_show_*、comments_filter_bar_position、comments_captcha_mode、comments_geo_composer_*、comments_device_composer_*默认配置键，保证新装库、升级库和运行时补种一致。 index.php+quick.php+about.php- 前台样式资源版本提升到
main.css?v=20260323-site-polish-v102，简洁页资源提升到quick-page.css?v=20260323-quick-page-v33、quick-page.js?v=20260323-quick-page-v42，确保浏览器及时刷新到本轮评论区新交互。 - 文档
README.md+CHANGELOG.md- 推荐版本、顶部索引和正文说明同步推进到
v1.0.288。
v1.0.287 (2026-03-23 06:08:08)
评论设备信息前台缓存刷新修复
- 前台资源刷新
index.php+quick.php+about.php- 提升前台公共资源版本号，强制浏览器刷新新的
main.css、comments-renderer.js、quick-page.js、quick-page.css。 - 修复后台已开启评论设备信息、前台发布控件已出现，但评论列表仍因旧缓存沿用单行
device_label文案的问题。 - 自动识别提示
index.php+assets/quick-page.js- 评论发布区设备状态提示文案改为“自动识别浏览器与系统”，明确设备信息来自请求头
User-Agent自动解析，而不是用户手动填写。 - 文档
README.md- 新增“评论设备信息前台缓存刷新修复（v1.0.287）”说明，并把推荐版本推进到
v1.0.287。 CHANGELOG.md- 顶部速查索引、阶段范围与正文详细小节同步推进到
v1.0.287。
v1.0.286 (2026-03-23 05:58:33)
评论设备信息两行展示与后台配置
- 前台评论区
index.php- 首页评论发布区新增
显示设备信息开关与完整 / 简化 / 隐藏模式选择，并接通本地偏好记忆、列表加载、提交透传与渲染参数下发。 assets/quick-page.js+assets/comments-renderer.js- 简洁页同步支持设备开关/模式记忆；评论卡片改为浏览器 + 系统两行展示，支持图标、品牌色、状态标签与移动端折叠。
- 后台与接口
admin/comments.php+api/admin-comments.php- 评论管理页新增
设备设置面板与保存动作，支持前台开关、游客展示策略、完整版本显示、Tooltip、状态标签、移动端折叠，以及图标/颜色/阈值/文案 JSON 自定义。 lib/comments.php+api/comments.php- 评论创建 / 列表 / 后台详情统一接入
device_visibility/device_meta_json、结构化devicepayload 与设备信息虚假举报类型；后台详情、回复链、历史评论统一显示设备摘要与 UA 解析结果。 - 数据库 / 文档
lib/db.php+sql/gh-proxy-app.sql- 评论表、升级补列逻辑与默认配置基线补齐
device_visibility、device_meta_json和整套comments_device_*配置键，新装库 / 升级库可直接启用。 README.md- 新增“评论设备信息两行展示与后台配置（v1.0.286）”说明，并把推荐版本推进到
v1.0.286。 CHANGELOG.md- 顶部速查索引、阶段范围与正文详细小节同步推进到
v1.0.286。
v1.0.285 (2026-03-23 05:26:42)
后台评论定位异常筛选与诊断
- 后端异常口径
lib/comments.php- 新增后台定位异常诊断 helper，当前支持识别
精确定位与 IP 归属地不一致、精确定位坐标不完整、定位数据缺少服务标识、精确定位缺少有效地址层级。 - 评论后台统计新增
定位异常数量，评论列表结果会附带每条评论的异常摘要。 comment_fetch_admin_page()新增geo_anomaly条件过滤，支持后台直接只看异常评论或只看正常评论。- 后台评论页
admin/comments.php- 评论列表新增
全部异常状态 / 仅定位异常 / 仅正常定位筛选，可与定位来源 / 可见范围 / 定位精度 / 地区关键词 / 定位服务关键词叠加使用。 - 顶部统计卡新增
定位异常指标，评论列表中的异常定位会做行级高亮，并在 IP / 区域列追加异常提示。 - 评论详情弹窗的
定位详情区块新增异常诊断说明，回复链与历史评论也会显示异常摘要，方便处理“定位虚假”举报。 - 后台接口 / SQL / 文档
api/admin-comments.phpdashboard查询新增geo_anomaly参数透传。- 本轮没有新增配置键、表或字段，因此
sql/gh-proxy-app.sql不需要改动。 README.md- 新增“后台评论定位异常筛选与诊断（v1.0.285）”说明，并把推荐版本推进到
v1.0.285。 CHANGELOG.md- 顶部速查索引、阶段范围与正文详细小节同步推进到
v1.0.285。
v1.0.284 (2026-03-23 05:12:41)
后台评论定位筛选与详情增强
- 后台评论页
admin/comments.php- 评论列表新增
定位来源 / 可见范围 / 定位精度 / 地区关键词 / 定位服务关键词五组定位筛选项，支持直接筛出高精度定位、IP 定位、隐藏位置、仅城市展示和特定地区评论。 - 评论详情弹窗新增独立
定位详情区块，集中展示地址层级、完整地址、经纬度、定位方式、提交模式、客户端精度、IP 对比、附近地标，以及标准地图 / 卫星图外链。 - 回复链与历史评论列表补上定位摘要，管理员排查“定位虚假”或城市切换异常时更容易横向比对。
- 后台接口与查询
api/admin-comments.phpdashboard查询新增geo_source、geo_visibility、geo_accuracy、geo_city_keyword、geo_provider_keyword五个后台定位筛选参数透传。lib/comments.phpcomment_fetch_admin_page()同步接入上述定位筛选条件，支持按定位来源、展示范围、定位精度、地区关键词和定位服务关键词联动过滤评论列表。- SQL / 文档
- 本轮没有新增配置键、表或字段，因此
sql/gh-proxy-app.sql不需要改动。 README.md- 新增“后台评论定位筛选与详情增强（v1.0.284）”说明，并把推荐版本推进到
v1.0.284。 CHANGELOG.md- 顶部速查索引、阶段范围与正文详细小节同步推进到
v1.0.284。
v1.0.283 (2026-03-23 05:10:00)
评论定位敏感配置改为数据库直读
- 配置存储安全收口
lib/comments.php- 新增
app_settings敏感键识别规则，password / secret / api_key / amap_key / amap_secret等键不再进入文件级预取缓存。 comments_ip_geo_amap_key、comments_ip_geo_amap_secret继续通过app_settings持久化，真实值不会写死到代码里。- 敏感键读取时会自动回退数据库查询，避免
cache/app-settings-prefetch-cache.php留下高德定位密钥副本。 - 文档
README.md- 新增“评论定位敏感配置改为数据库直读（v1.0.283）”说明，并把推荐版本推进到
v1.0.283。 CHANGELOG.md- 顶部速查索引、阶段范围与正文详细小节同步推进到
v1.0.283。
v1.0.282 (2026-03-23 04:18:00)
评论定位接入高德地图后台配置与测试
- 后台评论管理
admin/comments.php- 评论管理页新增
评论定位 / 高德地图设置面板，并在顶部工具条新增定位设置直达入口。 - 新增评论定位运行时开关、定位链路选择（
自动回退（高德优先）/ 仅高德 / 旧版回退链路）、高德Key、高德安全密钥、sig签名、请求超时、缓存 TTL 配置项。 - 同页补齐
测试定位、清空当前 IP 缓存、清空全部定位缓存，测试结果会回显命中来源、尝试顺序、缓存状态和原始返回摘要。 - 评论定位后端
lib/comments.php- 评论 IP 地域解析新增高德
v3/ipprovider，支持Key + 安全密钥(sig)模式。 - 新增评论定位配置读写 helper、provider 顺序解析、调试测试结果组装、定位缓存清理与后台专用测试 helper。
- 运行时定位链路升级为可配置模式：
自动回退（高德 -> ip-api -> ipwhois）、仅高德、旧版回退链路。 - 评论后台 API
api/admin-comments.phpdashboard设置下发新增geo_settings。- 新增
set_geo_settings、test_geo_lookup、clear_geo_cache三个动作，供评论后台页直接保存、测试和清缓存。 - 默认配置与 SQL
lib/db.phpdb_seed_app_settings_if_missing()新增评论定位默认配置键：comments_ip_geo_lookup、comments_ip_geo_provider、comments_ip_geo_timeout_ms、comments_ip_geo_cache_ttl_hours、comments_ip_geo_amap_enabled、comments_ip_geo_amap_key、comments_ip_geo_amap_secret、comments_ip_geo_amap_use_sig。sql/gh-proxy-app.sql- 初始化默认配置段同步追加上述评论定位键，保证新装库与升级补种基线一致。
- 文档
README.md- 新增“评论定位接入高德地图后台配置与测试（v1.0.282）”说明，并把推荐版本推进到
v1.0.282。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.282。
v1.0.281 (2026-03-23 03:41:44)
在线下载关闭态切到下载优先高亮
- 下载优先布局
index.php- 结果区新增
downloadPriorityMode判断：只要元信息面板被关闭，或后台已经关闭网页在线下载，动作区都会切到下载优先布局。 - 在“在线下载已关闭”但元信息面板仍显示的场景下，
极速直链现在也会直接套用主按钮高亮，不再维持普通浅色按钮。 - 同一状态下动作区会按下载优先顺序重排为
极速直链 / 直链下载+缓存 / 下载命令 / 复制 / 分享 / 加入队列 / 立即缓存，刷新元信息 / 哈希校验暂时收起，避免按钮区继续分散注意力。 - 前台样式
assets/main.css- 新增
is-download-priority结果动作区样式，复用无面板模式那套主 CTA / 次 CTA / 亮色直链按钮布局。 - 移动端断点也同步接入下载优先态，主按钮继续保持整行高亮显示。
- 资源版本
index.php+quick.php+about.php- 前台公共样式资源版本统一升级到
main.css?v=20260323-site-polish-v100，确保浏览器及时拿到这次高亮样式调整。 - 文档
README.md- 新增“在线下载关闭态改为下载优先高亮（v1.0.281）”说明，并把推荐版本推进到
v1.0.281。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.281。
v1.0.280 (2026-03-23 03:24:37)
首页在线下载可关闭 + 失败自动切极速直链
- 后台开关
admin/global_manage.php- 首页额外开关区新增
关闭首页网页在线下载。 - 首页额外开关区新增
首页在线下载失败后自动切极速直链。 - 两个开关互不依赖，可以单独开启或组合使用。
- 首页下载链路
index.php- 新增
layout.home.disable_web_online_download/layout.home.auto_fallback_to_direct_on_online_fail配置读取。 - 关闭网页在线下载后，结果元信息面板不再渲染“开始下载 / 分块进度”这套站内在线下载状态机，改为提示使用上方结果按钮。
- 无节点直链且已关闭在线下载时，结果区原来的
缓存后下载会自动升级成打开下载+缓存，直接走浏览器原生下载并在后台补缓存。 - 在线下载失败时，只要后台已开启自动回退且结果里存在
node_direct_url，页面会自动弹出极速直链，不再停留在失败状态。 - 默认配置与 SQL
lib/db.phpdb_seed_app_settings_if_missing()新增layout.home.disable_web_online_download默认值0。db_seed_app_settings_if_missing()新增layout.home.auto_fallback_to_direct_on_online_fail默认值0。sql/gh-proxy-app.sql- 初始化默认配置段同步追加这两个首页下载控制键。
- 最终补齐段同步追加这两个首页下载控制键，保证升级库和运行时补种基线一致。
- 文档
README.md- 新增“首页在线下载可关闭 + 失败自动切极速直链（v1.0.280）”说明，并把推荐版本推进到
v1.0.280。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.280。
v1.0.279 (2026-03-22 22:25:11)
后台顶栏锁定真正生效
- 后台锁定链路接通
api/admin-toolbar.php- 新增后台顶栏锁定配置下发，统一返回
default_fixed / allow_custom / show_fixed_toggle。 assets/admin-dashboard.js- 后台 Mega Toolbar 新增
L锁定按钮。 - 共享脚本现在会读取后台顶栏锁定配置，并结合后台本地记忆决定当前是否锁定。
- 顶栏未锁定时恢复自然滚动；锁定后才会固定在顶部，并继续和“向下滚动自动隐藏”联动。
- 后台样式
assets/admin-dashboard.css- 桌面端后台顶栏默认态改回普通流布局，只有锁定态才真正 sticky。
- 补齐后台锁定按钮的激活态和禁用态样式，方便直接看出当前状态。
- 资源版本
admin/*.php- 后台公共资源版本统一升级到
20260322-admin-polish-v46，确保浏览器及时刷新这次后台锁定修复。 - 文档
README.md- 新增“后台顶栏锁定真正生效（v1.0.279）”说明，并把推荐版本推进到
v1.0.279。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.279。 - SQL 说明
- 本轮没有新增配置键、表或字段，因此
sql/gh-proxy-app.sql不需要改动。
v1.0.278 (2026-03-22 22:07:36)
后台左栏固定跟随顶栏
- 后台共享壳层修复
assets/admin-dashboard.css- 桌面端
split-header布局下的左侧栏改为固定视口定位，不再跟着右侧长内容一起上滑。 - 左侧栏宽度、折叠宽度和可用高度继续跟随现有后台壳层变量，底部仍保留安全边距。
assets/admin-dashboard.jssyncShellMetrics()现在会同时同步顶栏高度和左栏当前顶部偏移。- 当后台顶栏滚动隐藏、重新显示、弹层打开或窗口尺寸变化时，左栏会自动重算顶部位置与高度，保证始终固定在可视区。
- 资源版本
admin/*.php- 后台公共资源版本统一升级到
20260322-admin-polish-v45，确保浏览器及时刷新这次左栏固定修复。 - 文档
README.md- 新增“后台左栏固定跟随顶栏（v1.0.278）”说明，并把推荐版本推进到
v1.0.278。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.278。 - SQL 说明
- 本轮没有新增配置键、表或字段，因此
sql/gh-proxy-app.sql不需要改动。
v1.0.277 (2026-03-22 22:05:06)
前后台顶栏入口拆分
- 菜单与入口
lib/admin_sidebar_menu.php- 原左侧二级菜单
顶栏功能管理更名为前台顶栏功能管理。 - 新增
后台顶栏管理菜单项，直接跳到/admin/global_manage.php#adminTopbarConfig。 - 页面与文案
admin/topbar_manage.php- 页面标题、顶部标题、保存成功提示统一改成“前台顶栏功能管理”。
admin/global_manage.php- 新增独立区块
后台顶栏管理，把后台顶栏滚动隐藏与移动端按钮文案开关单独收口。 - 原“顶栏功能管理入口”文案同步改成“前台顶栏功能管理入口”，避免再和后台配置混淆。
admin/dynamic_island.php- 灵动岛配置页里的迁移提示同步改成“前台顶栏功能管理”。
- 文档
README.md- 新增本次“前后台顶栏入口拆分（v1.0.277）”说明，并把推荐版本推进到
v1.0.277。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.277。 - SQL 说明
- 本轮没有新增配置键、表或字段，因此
sql/gh-proxy-app.sql不需要改动。
v1.0.276 (2026-03-22 22:31:06)
后台顶栏改为通栏锁定布局
- 该小节更新时间：2026-03-22 22:31:06
- 后台共享壳层增强：
assets/admin-dashboard.js- 新增共享后台壳层重排，会自动把后台页顶栏提升到壳层第一行，不再局限在右侧主区内部。
- 共享脚本会实时同步顶栏高度，给左侧栏贴边和顶部锁定留出稳定空间，避免锁定后和左栏互相压住。
assets/admin-dashboard.css- 桌面端后台改成“顶栏通栏 + 下方侧栏/内容”两行结构，顶部 Mega Toolbar 现在可以整条拉满。
- 左侧栏会自动贴在顶栏下方，锁定后的顶栏不再被左栏截断；移动端继续保留抽屉侧栏回退，不影响手机端现有交互。
- 资源版本：
admin/*.php- 后台公共资源版本统一升级到
20260322-admin-polish-v44，确保通栏顶栏和左栏下移布局及时刷新到浏览器缓存。 - README / CHANGELOG 同步：
README.md- 新增“后台顶栏改为通栏锁定布局（v1.0.276）”说明，并把推荐版本推进到
v1.0.276。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.276。 - SQL 说明：
- 本轮未新增数据库表、字段或配置键，因此 SQL 文件不需要变更。
- 校验：
node --check assets/admin-dashboard.js：通过。
v1.0.275 (2026-03-22 22:19:18)
后台共享批量范围联动
- 该小节更新时间：2026-03-22 22:19:18
- 后台共享表单增强：
assets/admin-dashboard.js- 共享工具条继续新增
当前可见 / 整个表单批量范围切换，批量勾选与批量排序不再只能整表单生效。 - 范围切换会和现有的分组筛选、视图筛选、关键词过滤直接联动；筛到某个分组或某类状态后，
全选 / 反选 / 顺排 / 恢复初始都可以只作用当前命中的那批项。 - 无论是复选框表单还是纯排序表单，都会自动接入这层范围控制；每个后台页面、每个表单会继续记住上次选中的批量范围。
- 工具条摘要会实时显示当前批量动作将作用多少项，切换分组或筛选时可以直接看到影响范围。
- 样式补齐：
assets/admin-dashboard.css- 新增共享批量范围下拉的紧凑样式，亮色 / 暗色后台继续统一视觉。
- 资源版本：
admin/*.php- 后台公共资源版本统一升级到
20260322-admin-polish-v43，确保“当前可见批量”逻辑及时刷新到浏览器缓存。 - README / CHANGELOG 同步：
README.md- 新增“后台共享批量范围联动（v1.0.275）”说明，并把推荐版本推进到
v1.0.275。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.275。 - SQL 说明：
- 本轮未新增数据库表、字段或配置键，因此 SQL 文件不需要变更。
- 校验：
node --check assets/admin-dashboard.js：通过。
v1.0.274 (2026-03-22 22:08:36)
后台共享分组直达与空分组隐藏
- 该小节更新时间：2026-03-22 22:08:36
- 后台共享表单增强：
assets/admin-dashboard.js- 共享工具条继续新增“分组”下拉，长表单现在可以直接按区块切到目标分组，不用再整页来回找。
- 分组筛选会和现有的视图筛选、关键词过滤叠加生效；当前分组里没有命中项时，对应分组会整块自动隐藏。
- 新增对
section.panel / fieldset / 常见标题区块的通用识别；像admin/backup_center.php这类依赖h4标题拆段的大表单，也会自动按标题分组。 定位改动如果被当前分组挡住，会自动切到目标分组再定位；每个后台页面、每个表单会继续记住上次选中的分组。- 样式补齐：
assets/admin-dashboard.css- 新增共享分组下拉样式和空分组隐藏态，亮色 / 暗色后台统一跟随共享工具条视觉。
- 资源版本：
admin/*.php- 后台公共资源版本统一升级到
20260322-admin-polish-v42，确保分组直达和空分组隐藏及时刷新到浏览器缓存。 - README / CHANGELOG 同步：
README.md- 新增“后台共享分组直达与空分组隐藏（v1.0.274）”说明，并把推荐版本推进到
v1.0.274。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.274。 - SQL 说明：
- 本轮未新增数据库表、字段或配置键，因此 SQL 文件不需要变更。
- 校验：
node --check assets/admin-dashboard.js：通过。
v1.0.273 (2026-03-22 21:48:52)
后台共享筛选状态记忆与已填写视图
- 该小节更新时间：2026-03-22 21:48:52
- 后台共享表单增强：
assets/admin-dashboard.js- 共享工具条继续新增
只看已填写，现在可以和只看未配置配合使用，快速在后台长表单里切换“已经补过的”和“还没补的”配置项。 - 新增
重置筛选，会一次性清空当前视图模式和关键词过滤，不用再分别点按钮回退。 - 共享工具条会记住每个后台页面、每个表单上次使用的视图筛选、关键词和批量排序起始值 / 步长；刷新页面后会自动恢复。
定位改动在命中关键词过滤时也会自动清空关键词并切到改动视图，避免目标项被当前过滤条件挡住。- 资源版本：
admin/*.php- 后台公共资源版本统一升级到
20260322-admin-polish-v41，确保共享筛选状态记忆和已填写视图及时刷新到浏览器缓存。 - README / CHANGELOG 同步：
README.md- 新增“后台共享筛选状态记忆与已填写视图（v1.0.273）”说明，并把推荐版本推进到
v1.0.273。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.273。 - SQL 说明：
- 本轮未新增数据库表、字段或配置键，因此 SQL 文件不需要变更。
- 校验：
node --check assets/admin-dashboard.js：通过。
v1.0.272 (2026-03-22 21:39:25)
后台通用关键词过滤与未配置项聚焦
- 该小节更新时间：2026-03-22 21:39:25
- 后台共享表单增强：
assets/admin-dashboard.js- 在共享工具条上继续新增“关键词过滤”，支持按字段名、说明文案和当前值过滤当前表单里的配置项。
- 新增
只看未配置，会优先聚焦空文本、空下拉、空文本域以及整组未勾选的布尔项，便于后台快速补漏。 - 关键词过滤会和已有的
只看已勾选 / 只看已改动 / 只看排序改动叠加生效，筛选摘要会同步显示当前关键词与可见项数量。 assets/admin-dashboard.css- 补齐共享搜索输入框、过滤态按钮和移动端 / 暗色主题输入态样式，避免工具条在窄屏下挤乱。
- 覆盖范围：
- 已接入后台共享壳层资源的后台配置页都会继承这轮关键词过滤和“只看未配置”能力。
- 资源版本：
admin/*.php- 后台公共资源版本统一升级到
20260322-admin-polish-v40，确保共享关键词过滤和未配置聚焦能力及时刷新到浏览器缓存。 - README / CHANGELOG 同步：
README.md- 新增“后台通用关键词过滤与未配置项聚焦（v1.0.272）”说明，并把推荐版本推进到
v1.0.272。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.272。 - SQL 说明：
- 本轮未新增数据库表、字段或配置键，因此 SQL 文件不需要变更。
- 校验：
node --check assets/admin-dashboard.js：通过。
v1.0.271 (2026-03-22 21:26:21)
后台通用批量表单筛选与定位增强
- 该小节更新时间：2026-03-22 21:26:21
- 后台共享表单增强：
assets/admin-dashboard.js- 在共享批量工具条基础上，继续新增通用“视图筛选”能力，统一支持
显示全部 / 只看已勾选 / 只看未勾选 / 只看已改动 / 只看排序改动。 - 筛选直接作用到当前表单里的配置项容器，长表单可以快速收起无关项，只保留当前关心的开关或排序字段。
- 新增
定位改动，会直接跳到当前表单里第一个已改动项；如果当前正处在别的筛选视图里，会先自动切到“只看已改动”再定位。 assets/admin-dashboard.css- 补齐共享筛选按钮激活态、被筛掉配置项隐藏态和定位高亮态，亮色 / 暗色 / 移动端保持一致。
- 兼容与排除：
- 继续保留
admin/global_manage.php、admin/user_groups.php等已有专属批量页逻辑，不重复叠加共享工具条。 - 上一轮已加入的表格行勾选类跳过规则继续保留，邮件队列、上传管理、分页监控这类专用批量列表不会误叠共享筛选。
- 资源版本：
admin/*.php- 后台公共资源版本统一升级到
20260322-admin-polish-v39，确保共享筛选与定位能力及时刷新到浏览器缓存。 - README / CHANGELOG 同步：
README.md- 新增“后台通用批量表单筛选与定位增强（v1.0.271）”说明，并把推荐版本推进到
v1.0.271。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.271。 - SQL 说明：
- 本轮未新增数据库表、字段或配置键，因此 SQL 文件不需要变更。
- 校验：
node --check assets/admin-dashboard.js：通过。
v1.0.270 (2026-03-22 21:18:36)
后台通用批量表单工具条扩展
- 该小节更新时间：2026-03-22 21:18:36
- 后台共享表单增强：
assets/admin-dashboard.js- 新增后台通用批量表单工具条，会自动扫描后台壳层里的
POST表单，对2个以上候选复选框或3个以上排序输入框自动注入共享工具条。 - 勾选批量统一支持
全选 / 全不选 / 反选 / 恢复初始，排序批量统一支持起始值 / 步长 / 顺排 / +步长 / -步长 / 恢复初始，并实时显示勾选数、已改动数和排序改动数。 - 新增
跳到保存，长表单可以直接定位主要提交按钮，减少后台配置时来回滚动。 - 继续保留已有专属批量页逻辑：
admin/global_manage.php、admin/user_groups.php等已有定制批量页不会重复注入。 - 补齐表格行勾选类批量列表的跳过规则，像
queue_ids[]、selected_paths[]、monitor_export_ids[]这类专用批量表格不再误叠两套工具条。 assets/admin-dashboard.css- 共享工具条样式继续统一承载勾选批量、排序批量、实时摘要、微型数字输入框和
跳到保存高亮态，亮色 / 暗色和移动端布局保持一致。 - 覆盖范围：
admin/backup_center.phpadmin/topbar_manage.phpadmin/quick_manage.phpadmin/seo.phpadmin/status_pages.phpadmin/captcha_center.phpadmin/site.phpadmin/nodes.phpadmin/mail.php- 以及其它已接入后台共享壳层资源的后台配置页
- 资源版本：
admin/*.php- 后台公共资源版本统一升级到
20260322-admin-polish-v38，确保浏览器及时刷新到这次共享工具条扩展与排除规则修正。 - README / CHANGELOG 同步：
README.md- 新增“后台通用批量表单工具条扩展（v1.0.270）”说明，并把推荐版本推进到
v1.0.270。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.270。 - SQL 说明：
- 本轮未新增数据库表、字段或配置键，因此 SQL 文件不需要变更。
- 校验：
node --check assets/admin-dashboard.js：通过。php -l admin/backup_center.php：通过。php -l admin/topbar_manage.php：通过。php -l admin/quick_manage.php：通过。php -l admin/seo.php：通过。php -l admin/status_pages.php：通过。php -l admin/captcha_center.php：通过。php -l admin/site.php：通过。php -l admin/nodes.php：通过。php -l admin/global_manage.php：通过。
v1.0.269 (2026-03-22 20:24:55)
网站全局管理批量排序与布局 JSON 导入导出
- 该小节更新时间：2026-03-22 20:24:55
- 后台表单增强：
admin/global_manage.php- 网站全局管理页新增“批量排序”工具条，支持对当前可见排序项执行
顺排当前可见 / 当前可见 +步长 / 当前可见 -步长 / 恢复默认排序。 - 每个包含排序字段的分组会自动补上
本组顺排 / 本组 +步长 / 本组 -步长 / 本组默认排序，首页、简洁页、关于页和顶部导航不再需要逐项改顺序。 - 新增布局配置 JSON 导入 / 导出区，可直接备份当前布局开关、排序和高级显示策略，也可把 JSON 批量回填到表单后再统一保存。
- 同名字段联动已接入，像首页共享的
layout_home_order_grid双输入位现在会自动同步，避免共享排序值出现“上面改了、下面没跟”的漂移。 - 修复页面内联脚本中的
elseif语法错误，避免整页批量工具和配置联动直接失效。 - 文档同步：
README.md- 新增“网站全局管理批量排序与布局 JSON 导入导出（v1.0.269）”说明，并把推荐版本推进到
v1.0.269。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.269。 - SQL 说明：
- 本轮未新增数据库表、字段或配置键，因此 SQL 文件不需要变更。
- 校验：
php -l admin/global_manage.php：通过。- 内联脚本去除 PHP 占位后的 Node 语法解析：通过。
v1.0.268 (2026-03-22 20:15:10)
网站全局管理批量表单控制增强
- 该小节更新时间：2026-03-22 20:15:10
- 后台表单批量控制：
admin/global_manage.php- 网站全局管理页新增全局批量工具条，支持对当前可见开关执行
全选当前可见 / 全不选当前可见 / 反选当前可见 / 恢复默认。 - 新增状态筛选：
显示全部 / 只看已勾选 / 只看未勾选 / 只看已改动，配合搜索框可以快速缩小配置范围。 - 每个包含布局开关的分组都自动补上
本组全选 / 本组全不选 / 本组反选 / 本组默认，避免逐条点击。 - 顶部总览和分组内摘要会实时显示“已勾选数 / 总数 / 已改动数”，更方便做批量检查和回滚前确认。
- 文档同步：
README.md- 新增“网站全局管理批量表单控制增强（v1.0.268）”说明，并把推荐版本推进到
v1.0.268。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.268。 - SQL 说明：
- 本轮未新增数据库表、字段或配置键，因此 SQL 文件不需要变更。
- 校验：
php -l admin/global_manage.php：通过。
v1.0.267 (2026-03-22 18:13:05)
网站全局管理保存互不串档
- 该小节更新时间：2026-03-22 18:13:05
- 后台保存链路拆分：
admin/global_manage.php- 新增
save_sidebar_menu分支，将侧栏菜单顺序 / 显隐 / 分组与页面布局配置拆成独立保存动作。 - 侧栏菜单区新增单独
保存菜单布局按钮，后续改菜单不需要再依赖底部“保存全局配置”。 - 大表单截断修复：
admin/global_manage.php- 提交
save_global_layout时会临时禁用侧栏菜单区的大量字段；提交save_sidebar_menu时则临时禁用布局区字段。 - 这样可以避免单页字段过多时超过 PHP
max_input_vars，导致 POST 被截断、后端把未收到的复选框误当成取消，从而出现“只改一个勾选，其他配置也被自动清空”的问题。 - 文档同步：
README.md- 新增“网站全局管理保存互不串档（v1.0.267）”说明，并把推荐版本推进到
v1.0.267。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.267。 - SQL 说明：
- 本轮未新增数据库表、字段或配置键，因此 SQL 文件不需要变更。
- 校验：
php -l admin/global_manage.php：通过。
v1.0.266 (2026-03-22 18:05:38)
首页关闭结果面板后的整页滚动修复
- 该小节更新时间：2026-03-22 18:05:38
- 滚动行为修复：
index.php- 当
layout.home.show_result_meta_panel被关闭时，首页body会自动挂上home-result-meta-hidden类，供无面板模式切换独立滚动策略。 assets/main.css- 无面板模式下，右侧“最近生成记录”的
history-table-wrap不再强制max-height + overflow-y:auto的卡片内滚动，而是恢复整页自然滚动，避免滚轮一直停留在右侧列表里，造成“页面像不动了”的体感。 - 样式缓存刷新：
index.php+quick.php+about.php- 前台公共样式资源版本统一升级到
main.css?v=20260322-site-polish-v99，确保浏览器立即拿到这次滚动修复。 - 文档同步：
README.md- 新增“首页关闭结果面板后恢复整页滚动（v1.0.266）”说明，并把推荐版本推进到
v1.0.266。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.266。 - SQL 说明：
- 本轮未新增数据库表、字段或配置键，因此 SQL 文件不需要变更。
- 校验：
php -l index.php：通过。php -l quick.php：通过。php -l about.php：通过。
v1.0.265 (2026-03-22 17:50:16)
首页结果面板后台可关闭
- 该小节更新时间：2026-03-22 17:50:16
- 后台配置新增：
admin/global_manage.php- 首页额外开关区新增
首页结果区显示元信息面板，对应配置键layout.home.show_result_meta_panel，管理员现在可以直接关闭首页结果下方的元信息详情面板。 - 首页结果区行为调整：
index.php- 接入
layout.home.show_result_meta_panel布尔配置；关闭后首页结果区不再追加详情行，也不再主动预取结果元信息，避免页面继续加载原本看不到的面板内容。 - 无面板模式下将动作区重排为下载优先：
极速直链放到最前，并在存在node_direct_url时自动切换为亮色主按钮；刷新元信息 / 哈希校验这类依赖面板的动作则自动收起。 - 结果主行新增紧凑模式类，保证关闭详情行后表格边界和间距不会塌掉，桌面端 / 移动端都保持完整卡片观感。
- 样式与移动端修复：
assets/main.css- 为无面板模式新增紧凑动作区、亮色直链按钮和次主按钮样式，突出“直接下载”主路径。
- 手机端结果卡片左上角序号 / 资源类型改成胶囊标签，主按钮独占整行，修复之前左上角观感松散和右下角按钮挤压重叠的问题。
index.php+quick.php+about.php- 前台公共样式资源版本统一升级到
main.css?v=20260322-site-polish-v98，减少浏览器缓存导致的样式不生效。 - SQL / 默认配置同步：
lib/db.phpdb_seed_app_settings_if_missing()补入layout.home.show_result_meta_panel默认键，保证老站升级后也能自动拿到新开关。sql/gh-proxy-app.sql- 初始化默认配置区与“最终补齐”区同步追加
layout.home.show_result_meta_panel，保持新装库与运行时补种逻辑一致。 - 文档同步：
README.md- 新增“首页结果面板可后台关闭（v1.0.265）”说明，并把推荐版本推进到
v1.0.265。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.265。 - 校验：
php -l index.php：通过。php -l admin/global_manage.php：通过。php -l lib/db.php：通过。php -l quick.php：通过。php -l about.php：通过。
v1.0.264 (2026-03-22 17:26:22)
代理下载拦截自动切直链
- 该小节更新时间：2026-03-22 17:26:22
- 下载任务自动兜底：
index.php- 下载任务状态机新增
403 / 451拦截识别；当站内代理下载命中上游拒绝、且当前结果存在可用node_direct_url时，不再直接停在“下载失败”。 - 系统现在会自动打开节点直链，并把任务状态切成
已切直链，同时在任务面板明确提示“代理下载被上游拒绝，已自动切到节点直链下载”。 - 新增
打开直链 / 重试代理两个动作，管理员和用户可以直接继续直链下载，也可以保留重试站内代理的能力。 - 自动切直链时不再额外补一条本地
dl_fail控制失败事件，避免后台最近日志里把同一次拦截看成“真实 403 + 本地 500”双重失败。 - 前端样式补齐：
assets/main.css- 下载任务面板新增
state-external状态颜色和提示样式，和普通失败态分开显示，避免“其实已经给你切直链了”却还保持大红报错观感。 - 文档同步：
README.md- 新增“代理下载拦截自动切直链（v1.0.264）”说明，并把推荐版本更新到
v1.0.264。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.264。 - SQL 说明：
- 本轮未改数据库结构、初始化脚本和配置键，因此没有更新 SQL 文件，避免引入无效版本漂移。
- 校验：
php -l index.php：通过。
v1.0.263 (2026-03-22 17:03:00)
下载管理统计与筛选口径统一
- 该小节更新时间：2026-03-22 17:03:00
- 下载日志 helper 扩充：
lib/download_log_view.php- 新增“非结果控制事件”类型集合与结果事件判断 helper，统一区分
dl_pause / dl_stop / dl_retry / dl_delete / dl_cache这类过程控制动作，避免它们继续混入“成功下载”统计。 - 下载管理页统计口径收口：
admin/downloads.php- “结果状态”筛选改为真正按结果事件工作：
结果成功 / 结果失败 / 超时 / 被拦截不再把202控制事件算进去，并新增控制事件独立筛选项。 - 顶部看板新增
有效结果数 / 控制事件数 / 结果失败数，原“成功率 / 缓存命中率”同步切换为结果口径，dl_stop / dl_retry / dl_pause不再把成功率抬高。 - 趋势图新增
有效结果数 / 控制事件数 / 结果失败率指标，热力图和部分表头文案改为“记录量 / 记录数”，避免把所有日志都误称为请求。 - 状态饼图从原来的重叠统计改为互斥分类：
结果成功 / 超时 / 被拦截 / 其他失败 / 控制事件，图表数字可以直接对上。 - 用户流量排行里的成功率改为按“有效结果数”计算，没有有效结果时不再显示误导性的
0.0%。 - 文档同步：
README.md- 新增“下载管理统计与筛选口径统一（v1.0.263）”说明，并把推荐版本更新到
v1.0.263。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.263。 - 校验：
php -l lib/download_log_view.php：通过。php -l admin/downloads.php：通过。php -l lib/bootstrap.php：通过。
v1.0.262 (2026-03-22 16:56:44)
下载控制日志状态文案修复
- 该小节更新时间：2026-03-22 16:56:44
- 统一下载日志展示语义：
lib/download_log_view.php- 新增下载日志展示 helper，统一维护下载动作标签、控制事件识别和状态文案映射。
dl_start / dl_resume / dl_pause / dl_stop / dl_restart / dl_retry / dl_done / dl_fail / dl_delete / dl_cache现在都会输出更贴近业务语义的状态，不再直接把202 / 200 / 500当成用户可读主文案。lib/bootstrap.php- 引导层新增
download_log_view.php加载，保证后台相关页面可直接复用同一套下载日志展示规则。 - 仪表盘最近日志修复：
admin/index.php- “动作”列现在会显示中文标签，而不是原始
dl_stop / dl_retry / dl_done代码。 - “状态”列改为主文案 + 副文案形式：例如
已停止 + 控制事件 202、已完成 + 完成事件 200、失败 + 失败事件 500，避免把控制事件误认成真实下载成功响应。 - 下载管理页同步收口：
admin/downloads.php- 列表页状态徽标和详情弹窗统一切到新的下载日志状态映射，不再把控制事件粗暴显示成“成功 / 失败”。
- 详情弹窗里的状态说明现在和列表一致，方便管理员排查“是下载结果，还是下载控制动作”。
- 文档同步：
README.md- 新增“下载控制日志状态文案修复（v1.0.262）”说明，并把推荐版本更新到
v1.0.262。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.262。 - 校验：
php -l lib/download_log_view.php：通过。php -l lib/bootstrap.php：通过。php -l admin/index.php：通过。php -l admin/downloads.php：通过。
v1.0.261 (2026-03-22 10:54:17)
后台移动端工具条与悬浮按钮适配修复
- 该小节更新时间：2026-03-22 10:54:17
- 后台移动端顶部区收口：
assets/admin-dashboard.css- 移动端 Mega Toolbar 改为更紧凑的手机布局，顶部不再继续堆叠重复的搜索 / 设置 / 说明 / 账号行，左上角显示更干净。
- 动作区改为允许自然换行，状态提示保留独立紧凑胶囊样式，减少大面积空白和孤立按钮造成的割裂感。
- 右下角悬浮区避让修复：
assets/admin-dashboard.css- 后台移动端的全局主题切换 / 返回顶部按钮现在会整体上移，避开
topbar-mobile-dock的搜索 / 设置 / 说明 / 账号按钮区。 dashboard-body的移动端底部留白同步增加，页面底部按钮和表单区不会再被右下角悬浮控件压住。- 缓存刷新：
admin/*.php- 后台公共
admin-dashboard.css资源版本统一升级到20260322-admin-polish-v36，确保手机浏览器能及时刷新到新样式。 - 文档同步：
README.md- 新增“后台移动端工具条与悬浮按钮适配修复（v1.0.261）”说明，并把推荐版本更新到
v1.0.261。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.261。 - 校验：
php -l admin/topbar_manage.php：通过。php -l admin/index.php：通过。rg -n "20260322-admin-polish-v36" admin/*.php：已确认后台公共样式版本已统一更新。
v1.0.260 (2026-03-22 11:40:20)
下载直链优先与后台补缓存提速
- 该小节更新时间：2026-03-22 11:40:20
- 首页结果区链路调整：
index.php- 结果区“打开链接”现在会优先打开最快可用链路；当节点直连可用时，按钮文案会直接显示为“极速直链”。
- “下载命令”改为优先复制节点直连地址，不再默认复制较慢的站内代理下载 URL。
- “缓存后下载”在存在节点直连时升级为“直链下载+缓存”：点击后立即新开节点直连下载，并在后台异步触发
api/offline-prefetch.php补缓存；如果当前结果没有可用直链，则继续保留原来的“先缓存、再走站内下载状态机”的流程。 - 加速打开入口同步提速：
index.phpopenAcceleratedFile()现在会按node_direct_url -> download_url -> proxy_url -> 原始链接的顺序回退，评论附件等入口也会优先直连。assets/quick-page.js- 简洁下载页的
openAcceleratedFile()同步改为优先node_direct_url，评论附件和其它快捷打开场景不再默认走代理下载地址。 - 构链成功判定放宽为“任一可用链接存在即可”，避免接口返回直链但没有
download_url时被前端误判成失败。 - 前端缓存版本同步：
quick.php- 简洁页脚本缓存版本升级为
20260322-quick-page-v40，确保浏览器及时命中新逻辑。 - 文档同步：
README.md- 新增“下载直链优先与后台补缓存提速（v1.0.260）”说明，并把推荐版本更新到
v1.0.260。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引与正文详细小节同步推进到
v1.0.260。 - 校验：
php -l index.php：通过。node --check assets/quick-page.js：通过。php -l quick.php：通过。
v1.0.259 (2026-03-22 11:32:18)
后台配额数据源与上下文规则升级
- 该小节更新时间：2026-03-22 11:32:18
- 配额组件配置层升级：
lib/admin_quota_widget.php- 配额组件从“固定缓存摘要 + 样式配置”升级为“基础配置 + 条件规则 + 运行时上下文”的统一模型，主数据源现在支持
缓存占用 / 磁盘占用 / 自定义指标三种模式。 - 新增数据源配置段：缓存目录与自定义总配额、磁盘路径与总量模式、自定义指标数值 / 单位 / 文案，以及按优先级合并的规则系统。
- 模板变量扩展为
{used_value}、{quota_value}、{remaining_value}、{source_label}、{source_type}、{unit}、{context_admin_role}、{context_user_group}、{context_theme_mode}、{context_resolved_theme}，可以直接拼出更细的上下文文案。 - 管理页与运行时接线：
admin/topbar_manage.php- “配额组件管理”区块新增主数据源切换、缓存 / 磁盘 / 自定义指标参数设置，以及高级规则 JSON 编辑器。
- 高级规则支持按
管理员角色 / 用户组 / 主题模式覆写数据源、标题、阈值、顶部条样式与侧栏卡样式，规则按priority从小到大叠加，后命中的规则覆盖前面的配置。 api/admin-toolbar.php- 管理员顶栏接口现在会把当前后台路径、管理员角色、用户组、主题模式和最终明暗主题一起送入规则匹配，并返回新的配额摘要。
assets/admin-dashboard.js- 工具栏请求会额外携带
theme_mode与resolved_theme，切换浅色 / 深色 / 自动时立即强制刷新 payload，让按主题命中的样式实时生效。 - 后台首屏摘要跟随新配置：
lib/bootstrap.php- 后台页与
api/admin-toolbar.php统一预加载lib/admin_quota_widget.php，确保后台首屏和接口层共用同一套摘要逻辑。 lib/proxy_service.phpsidebar_quota_summary()在后台上下文中优先走新的配额组件摘要，后台侧栏卡片和首页概览不再固定锁死缓存配额。admin/index.php- 后台首页配额详情和指标说明改为跟随当前数据源名称，切到磁盘或自定义指标后不会继续误写成缓存占用。
- SQL 基线补齐：
sql/gh-proxy-app.sql- 追加最终补齐段，把
lib/db.php当前db_seed_app_settings_if_missing()使用的默认键再做一次安装期对齐，确保新装库最终状态和运行时自动补种逻辑一致。 - 文档同步：
README.md- 新增“后台配额数据源与上下文规则升级（v1.0.259）”说明，并把推荐版本更新为
v1.0.259。 CHANGELOG.md- 顶部速查索引、阶段范围、全文版本索引和正文详细小节同步推进到
v1.0.259。 - 校验：
php -l lib/admin_quota_widget.php：通过。php -l admin/topbar_manage.php：通过。php -l api/admin-toolbar.php：通过。php -l lib/bootstrap.php：通过。php -l lib/proxy_service.php：通过。node --check assets/admin-dashboard.js：通过。php -r ...admin_quota_widget_payload(...)：已验证数据源切换与主题 / 角色规则命中正常。
v1.0.258 (2026-03-22 09:50:41)
后台配额组件自定义上线
- 该小节更新时间：2026-03-22 09:50:41
- 配额组件配置中心落地：
lib/admin_quota_widget.php- 新增后台配额组件公共配置层，统一负责默认值、模板变量、颜色、阈值、尺寸、页面显示范围与当前路径下的最终解析结果。
- 支持顶部配额条与侧栏配额卡分别管理，模板可使用
{used_text}、{quota_text}、{remaining_text}、{percent}、{percent_text}、{used_bytes}、{quota_bytes}、{remaining_bytes}。 admin/topbar_manage.php- 顶栏管理页新增“配额组件管理”区块，可直接配置顶部条与侧栏卡的开关、文案模板、预警/危险阈值、宽高/圆角、轨道颜色、三档渐变色，以及“仅在这些页面显示 / 在这些页面隐藏”规则。
- 保存动作与恢复默认动作已接入同一表单和后台审计，不需要再手改配置 JSON。
- 运行时接线：
api/admin-toolbar.php- 管理员顶栏接口新增
quota_widget负载，并按当前后台路径返回已经解析好的顶部/侧栏配额组件配置。 assets/admin-dashboard.js- 顶部配额条改为按接口返回动态调整宽度、高度、圆角、边框、填充色、文字模板和提示信息。
- 侧栏配额卡改为运行时重绘，支持附加说明行、阈值变色、进度条隐藏、以及按页面路径显示/隐藏。
assets/admin-dashboard.css- 新增侧栏配额附加说明行样式，兼容多行配额说明展示。
- 配额数据增强：
lib/proxy_service.phpsidebar_quota_summary()现补齐remaining_bytes、remaining_text、percent_text，供模板文案和页面展示复用。- 数据库基线：
lib/db.php- 新增默认配置键
layout.admin.quota_widget_config_json，老库升级后也会自动补齐。 sql/gh-proxy-app.sql- 初始化脚本同步补上
layout.admin.quota_widget_config_json，新装环境开箱即用。 - 文档同步：
README.md- 新增“后台配额组件自定义（v1.0.258）”说明，并把推荐版本更新到
v1.0.258。 CHANGELOG.md- 顶部索引、速查表与正文详细版本小节同步推进到
v1.0.258。 - 校验：
php -l lib/admin_quota_widget.php：通过。php -l admin/topbar_manage.php：通过。php -l api/admin-toolbar.php：通过。php -l lib/proxy_service.php：通过。php -l lib/db.php：通过。node --check assets/admin-dashboard.js：通过。php -r ...admin_quota_widget_payload(...)：已验证模板变量替换与页面可见性规则正常。
v1.0.257 (2026-03-22 09:35:59)
下载链路异常页识别修复
- 该小节更新时间：2026-03-22 09:35:59
- 后端代理与缓存防误收：
lib/proxy_service.php- 新增
proxy_detect_unexpected_download_payload()及相关辅助函数，对小体积响应读取首段内容并结合Content-Type、Content-Disposition、常见二进制文件头一起判断真实载荷类型。 - 针对
release / archive这类预期为二进制的大包，若返回内容实际是 HTML、JSON 或明显错误文本，会直接判为异常载荷，避免把错误页当成成功下载。 proxy.php- 直连 / 节点下载链路在上游返回
200后新增内容嗅探校验；命中异常页时会丢弃临时文件并继续尝试后续候选节点，而不是把页面内容直接回传给用户。 api/offline-prefetch.php- 离线缓存预取接入同一套异常载荷识别逻辑，避免将 GitHub / 节点返回的错误页面写入本地缓存并污染后续下载。
- 前端下载误判收紧：
index.php- 下载状态机新增前 4KB 响应样本采集，不再只依据
Content-Type做“下载地址返回了页面内容”的判定。 - 当前端拿到被错误标记为
text/plain的正常二进制时，会优先依据真实字节特征放行；只有样本内容确实像 HTML / JSON / 错误文本时才提示失败，降低误判率。 - 文档同步：
README.md- 新增“下载链路异常页识别修复（v1.0.257）”说明，并把推荐版本更新到
v1.0.257。 CHANGELOG.md- 顶部索引、速查表与正文详细版本小节同步推进到
v1.0.257。 - 校验：
php -l lib/proxy_service.php：通过。php -l proxy.php：通过。php -l api/offline-prefetch.php：通过。php -l index.php：通过。php -r ...proxy_detect_unexpected_download_payload(...)：已验证 HTML 错误页会被拦截，MZ头二进制样本不会误判。
v1.0.256 (2026-03-07 11:30:14)
简洁下载页评论列表首屏卡在“正在加载评论...”热修
- 该小节更新时间：2026-03-07 11:30:14
- 状态机修复：
assets/quick-page.js- 修复简洁下载页评论列表请求成功返回后，
commentsState.loading仍停留为true，导致渲染逻辑持续命中“正在加载评论...”占位的问题。 - 评论列表成功 / 失败分支现都会先切回非加载态，再刷新评论列表与“加载更多”按钮状态，避免页面一直卡在加载文案。
- 加载占位条件同步收紧为“当前评论列表为空时才显示”，避免已有评论或空列表场景被错误覆盖。
- 资源缓存同步：
quick.php- 简洁页评论脚本缓存版本升级到
quick-page-v39，确保浏览器立即获取这次热修后的 JS。 - 文档同步：
README.md- 新增“简洁页评论列表‘正在加载’卡住热修（v1.0.256）”说明，并把推荐版本更新到
v1.0.256。 CHANGELOG.md- 顶部索引、速查表与正文详细版本小节同步推进到
v1.0.256。 - 校验：
node --check assets/quick-page.js：通过。php -l quick.php：通过。
v1.0.255 (2026-03-07 10:55:53)
评论区剩余共享工具链与后台配置残留一次性收口
- 该小节更新时间：2026-03-07 10:55:53
- 共享运行时继续扩容：
assets/comments-runtime.js- 新增评论上传状态更新、上传规则解析、图片文件校验、上传预览渲染、文本插入、Markdown 选区包裹、Markdown 工具按钮执行、举报类型文案提取、举报原因拼装、评论排序规范化与通用图片上传流程。
- 主页与简洁下载页评论区继续围绕同一套共享运行时解释上传 / 举报 / 排序规则，不再各自维护重复的工具函数实现。
- 两页评论脚本继续收口：
assets/quick-page.js- 评论上传、编辑器 Markdown 按钮、举报类型 / 举报原因构建、图片上传流程全部优先走
window.GitProxyCommentRuntime。 index.php- 首页评论上传、Markdown 工具按钮、举报原因构建与图片上传流程同样优先接入共享运行时，并删除未再使用的
extractMarkdownImageUrls()遗留函数。 quick.php/index.php- 共享评论运行时脚本缓存版本升级为
comments-runtime-v2，简洁页评论脚本缓存版本升级为quick-page-v38。 - 后台配置残留收口：
lib/pagination.phpfrontend.comments描述更新为“首页与简洁下载页共用评论区列表”。frontend.quick_comments改为隐藏兼容占位并标记别名到frontend.comments，不再作为前台实际分页模块使用。admin/pagination.php- 后台分页页移除“简洁下载页评论区”独立入口与覆盖清单项，不再展示已经失效的旧评论分页模块。
- 文档同步：
README.md- 新增“评论区剩余共享逻辑一次性收口（v1.0.255）”说明，并把推荐版本更新到
v1.0.255。 CHANGELOG.md- 顶部索引、速查表与正文详细版本小节同步推进到
v1.0.255。 - 校验：
node --check assets/comments-runtime.js：通过。node --check assets/quick-page.js：通过。php -l index.php：通过。php -l quick.php：通过。php -l lib/pagination.php：通过。php -l admin/pagination.php：通过。
v1.0.254 (2026-03-07 10:44:23)
主页与简洁下载页继续共用评论运行时助手
- 该小节更新时间：2026-03-07 10:44:23
- 共享运行时新增：
assets/comments-runtime.js- 新增评论运行时共享助手，统一处理评论区标题规范化、举报原因规范化、登录态判断、举报下拉框选项同步、回复折叠阈值计算与滚动自动加载观察器。
- 两页评论脚本继续并轨：
assets/quick-page.js- 简洁下载页评论逻辑改为优先调用
window.GitProxyCommentRuntime，共享标题 / 举报原因 / 登录态 / 自动加载规则。 - 评论“加载更多”按钮的数据标记也统一写成
data-load-mode对应的dataset.loadMode，不再保留 quick 专用模式标记。 index.php- 首页内联评论脚本同样接入共享运行时助手；对评论标题、举报原因、登录态判断、自动加载观察器、折叠阈值等公共逻辑优先走共享实现。
quick.php/index.php- 两个前台页面都新增
comments-runtime.js引入，简洁页评论脚本缓存版本同步升级到quick-page-v37。 - 文档同步：
README.md- 新增“评论运行时助手继续共享（v1.0.254）”说明，并把推荐版本更新到
v1.0.254。 CHANGELOG.md- 顶部索引、速查表与正文详细版本小节同步推进到
v1.0.254。 - 校验：
node --check assets/comments-runtime.js：通过。node --check assets/quick-page.js：通过。php -l quick.php：通过。php -l index.php：通过。
v1.0.253 (2026-03-07 10:36:15)
简洁下载页评论区 DOM 绑定彻底改用主页共享节点
- 该小节更新时间：2026-03-07 10:36:15
- DOM 接线继续收口：
assets/quick-page.js- 删除对
quickCommentsSection、quickCommentInput、quickCommentList、quickCommentUploadBtn等旧 quick 专用评论节点 ID 的兼容探测。 - 简洁下载页评论区改为直接绑定共享模板固定输出的
commentsSection、commentInput、commentList、loadMoreCommentsBtn、replyHint等主页同款节点。 - 排序 / 表情按钮也只再读取共享模板提供的
data-sort与data-emoji，不再保留data-quick-comment-*过渡分支。 - 样式残留补齐：
assets/quick-page.css- 移动端评论编辑器右侧上传按钮布局里的旧
#quickCommentUploadBtn选择器同步替换为共享模板实际输出的#commentUploadBtn。 - 文档同步：
README.md- 新增“简洁页评论 DOM 接线继续并轨（v1.0.253）”说明，并把推荐版本更新到
v1.0.253。 CHANGELOG.md- 顶部索引、速查表与正文详细版本小节同步推进到
v1.0.253。 - 校验：
rg -n "quickCommentsSection|quickCommentsTitleText|quickCommentNickname|quickCommentAnonymous|quickCommentInput|quickCommentCaptchaBox|quickCommentCaptchaQuestion|quickCommentCaptchaAnswer|quickCommentCaptchaHelp|quickCommentCaptchaRefreshBtn|quickCommentImageInput|quickCommentUploadBtn|quickCommentUploadState|quickCommentUploadPreview|quickCommentSubmitBtn|quickCommentReplyHint|quickCommentList|quickCommentLoadMoreBtn|data-quick-comment-sort|data-quick-comment-emoji|dataset\\.quickCommentSort|dataset\\.quickCommentEmoji" assets/quick-page.js assets/quick-page.css quick.php lib/templates/comments_panel.php lib/templates/comments_modals.php：无结果，确认旧评论 DOM 兼容层已清空。
v1.0.252 (2026-03-07 10:29:37)
简洁下载页评论区彻底切到主页共享类名
- 该小节更新时间：2026-03-07 10:29:37
- 遗留样式收口：
assets/quick-page.css- 删除简洁下载页评论区最后一批
quick-comment-*遗留选择器，统一替换为.comments-panel .comment-*共享类名。 - 评论卡片边框 / 背景、内容换行、代码块显示、回复折叠显隐、展开按钮等样式全部直接匹配主页共享渲染结构。
- 按钮通用样式里不再保留已废弃的
.quick-comment-like-btn，避免简洁页继续维护一套不存在的旧类。 - 共享评论结构继续稳定：
assets/quick-page.js- 本轮清理后，简洁下载页评论列表只围绕
assets/comments-renderer.js输出的共享 DOM 结构工作，不再依赖旧的 quick 专用评论样式命名。 - 文档同步：
README.md- 新增“简洁页评论遗留样式收口（v1.0.252）”说明，并把推荐版本更新到
v1.0.252。 CHANGELOG.md- 顶部索引、速查表与正文详细版本小节同步推进到
v1.0.252。 - 校验：
rg -n "quick-comment-like-btn|quick-comment-item|quick-comment-content|quick-comment-replies|quick-comment-empty|quick-reply-collapsed-hidden|quick-comment-replies-group|quick-comment-replies-toggle" assets/quick-page.css：无结果，确认遗留样式已清空。
v1.0.251 (2026-03-07 10:16:28)
评论编辑 / 举报 / 管理员动作在简洁下载页继续对齐主页
- 该小节更新时间：2026-03-07 10:16:28
- 共享模板继续收口：
lib/comments_view.php- 新增
comment_render_public_modals()，把评论编辑弹窗、举报弹窗、确认框统一纳入评论区共享视图层。 lib/templates/comments_modals.php- 提供主页 / 简洁下载页共用的
commentEditModal、commentReportModal、uiDialogModal模板，评论弹窗不再各页各写一份。 index.php/quick.php- 两个前台页面都改为通过共享 helper 输出评论弹窗，后续评论弹窗字段和结构调整可一次同步两页。
- 简洁下载页交互补齐：
assets/quick-page.js- 新增评论编辑弹窗状态管理、Markdown 预览、Markdown 工具按钮、编辑图片上传、举报弹窗和确认框逻辑。
- 评论列表动作区现已支持
编辑 / 举报 / 管理员改状态 / 删除，管理员在简洁下载页也能直接处理评论。 - 评论里的文件按钮恢复走
/api/build-link.php生成加速下载链接，不再只打开原始地址。 - 评论列表渲染补齐
viewer / allow_report / report_requires_login / report_reasons等控制项，简洁页动作按钮可见性与主页保持一致。 - 文档同步：
README.md- 新增“评论弹窗共享补齐（v1.0.251）”说明，并把推荐版本更新到
v1.0.251。 CHANGELOG.md- 顶部索引、速查表与正文详细版本小节同步推进到
v1.0.251。 - 校验：
php -l index.php：通过。php -l quick.php：通过。php -l lib/comments_view.php：通过。php -l lib/templates/comments_panel.php：通过。php -l lib/templates/comments_modals.php：通过。node --check assets/comments-renderer.js：通过。node --check assets/quick-page.js：通过。
v1.0.250 (2026-03-07 10:00:04)
简洁下载页评论区改为复用主页模板与同一套渲染入口
- 该小节更新时间：2026-03-07 10:00:04
- 共享模板收口：
lib/comments_view.php- 新增前台评论区共享渲染入口，统一收口评论区类名合并、样式注入与
data-*属性输出。 lib/templates/comments_panel.php- 把主页评论编辑器 / 排序区 / 列表容器抽成可复用模板，避免主页与简洁下载页继续各自维护一份 HTML。
lib/bootstrap.phpindex.php与quick.php统一按需加载评论区视图 helper。- 主页 / 简洁页同步：
index.php- 主页评论区改为调用共享模板，并接入新的
assets/comments-renderer.js公共渲染器，评论卡片 / 回复折叠逻辑不再在首页脚本里单独维护。 quick.php- 简洁下载页评论区改为直接复用主页评论面板结构，同时将评论分页配置切换到
frontend.comments，保证两页默认加载批次一致。 assets/comments-renderer.js- 新增主页评论卡片的公共渲染器，统一处理头像回退、Markdown 内容、图片 / 文件链接、回复折叠与按钮区输出。
- 简洁下载页修复：
assets/quick-page.js- 评论区节点查找新增主页 ID 兼容，简洁页切换到共享模板后不再依赖旧的
quickComment*专用节点。 - 补齐“回复评论 / 取消回复 / 文件按钮 / 点赞按钮”事件接线，并在提交评论时正确带上
parent_id。 - 评论列表优先调用共享渲染器输出，加载 / 空状态文案与主页统一，修复评论区长期停留在“正在加载评论”及展示结构与主页漂移的问题。
- 文档同步：
README.md- 补充“评论区共享化修复（v1.0.250）”说明，并把推荐版本更新到
v1.0.250。 CHANGELOG.md- 顶部索引、速查表与正文详细版本小节同步推进到
v1.0.250。 - 校验：
php -l index.php：通过。php -l quick.php：通过。php -l lib/comments_view.php：通过。node --check assets/comments-renderer.js：通过。node --check assets/quick-page.js：通过。
v1.0.249 (2026-03-07 02:08:40)
数据库初始化基线对齐，SQL / db 迁移 / 文档说明四处同步收口
- 该小节更新时间：2026-03-07 02:08:40
- 结构与迁移对齐：
lib/db.php- 修复
user_settings新装建表缺少topbar_fixed的问题，避免新环境首次写入顶部栏固定偏好时直接失败；旧环境会通过迁移自动补列。 - 新增
db_index_exists()、db_try_add_index()、db_seed_app_settings_if_missing()，把索引补齐与配置基线补齐统一收口，减少后续新增独立配置块时散落写迁移代码的成本。 - 数据库初始化缓存指纹升级为
db-init-cache-v2，确保本轮迁移和默认键补齐能稳定触发重新校验。 - 索引优化：
lib/db.phpemail_queue新增updated_at与(status, updated_at)索引，收口后台“最近邮件 / 失败列表 / 队列状态”按时间倒序查询的性能。user_email_verifications、user_password_resets、admin_password_resets新增(user_id|admin_id, used_at)组合索引，优化验证码 / 密码重置链路中“作废旧 token、清理未使用记录”的高频更新。sql/gh-proxy-app.sql- 启动 SQL 与运行时建表结构同步补齐上述索引，保证新装环境与运行时迁移环境保持同一基线。
- 配置基线补齐：
sql/gh-proxy-app.sql- 新增当前代码已依赖但旧 SQL 未覆盖的默认配置键，覆盖：
mail.block_*_json、mail.template_versions_json、mail.template_beauty_json、mail.runtime_counters_jsoncaptcha.center.config_json / versions_json / snapshots_jsonlayout.topbar.*quick.runtime.*site.doc_sync_*、site.readme_*backup_center.notification_emails / notify_tolib/db.php- 运行时初始化同步补齐同一批配置键，避免“文档写了、代码用了、SQL 旧基线却没值”的错位。
- README / CHANGELOG 同步：
README.md- 新增“数据库初始化与基线对齐（v1.0.249）”说明，并把推荐版本更新到
v1.0.249。 CHANGELOG.md- 顶部索引、速查表与正文详细版本小节同步推进到
v1.0.249。 - 校验：
php -l lib/db.php：通过。rg -n "mail\\.block_|captcha\\.center\\.|layout\\.topbar\\.|quick\\.runtime\\.|site\\.doc_sync_|site\\.readme_|backup_center\\.(notification_emails|notify_to)" sql/gh-proxy-app.sql：通过。- Python 结构核对：
lib/db.php与sql/gh-proxy-app.sql的建表列集合对比通过，当前无列级偏差。
v1.0.248 (2026-03-07 01:13:18)
后台技术型英文占位与默认值继续清扫，验证码/邮件/公告后台统一再收口一轮
- 该小节更新时间：2026-03-07 01:13:18
- 验证码中心继续中文化：
admin/captcha_center.php- 新增
api_version、api_doc_mode、domestic_stack_mode、external_log_sink、trend_granularity、report_delivery、data_share_mode、compliance_mode、privacy_mask_level、channel_failover_mode、auto_claim_mode、inspection_schedule、diff_status等显示映射，后台文本输入不再直接露出v1 / auto / compat / elk+clickhouse / hour / mail+workbench / signed-link / enhanced / manual-claim / 0 * * * * / changed这类原始 code。 - 黑白名单、方式限制、自定义场景、品牌标语、运行日志搜索、导入导出、专题区块帮助文案等剩余技术型占位同步改为中文提示。
- 版本 / 快照对比中的差异类型由英文改为中文展示，后台管理员不再看到
added / removed / changed。 - 邮件中心继续中文化：
admin/mail.php- 邮件美化区的角度 / 尺寸 / 字体默认值改为中文展示：如
135 度、600 像素、系统默认，保存时自动回写成样式层所需的原始值。 基础邮件通道配置、邮件通道校验、接口容灾、第三方接口地址 / 密钥、富文本正文、代码高亮主题、语言标签、节点分组收件示例、场景邮箱示例等剩余英文和半英文提示同步中文化。admin/announcements.php- 公告管理页的 Markdown 工具栏按钮、来源关键字示例、设备 / 用户类型选项、预览标题等剩余英文按钮和占位同步改成中文化文案。
- README / CHANGELOG 同步：
README.md安全中心 / 验证码体系、邮件设置中心升级到v1.0.248，并新增“后台中文化收口”说明。CHANGELOG.md- 顶部索引、速查表和正文详细版本小节同步推进到
v1.0.248。 - 校验：
php -l admin/captcha_center.php：通过。php -l admin/mail.php：通过。php -l admin/announcements.php：通过。
v1.0.247 (2026-03-07 00:53:00)
CHANGELOG 正文补齐与 README 版本说明重新对齐
- 该小节更新时间：2026-03-07 00:53:00
- 文档结构修复：
CHANGELOG.md- 补齐
v1.0.246、v1.0.245、v1.0.244、v1.0.243、v1.0.242、v1.0.241、v1.0.240、v1.0.239的正文详细版本小节。 - 修复此前仅更新“版本阶段索引 / 全版本速查”，但正文没有同步新增详细小节的问题。
- 顶部索引、速查表、正文详情现已统一推进到
v1.0.247，避免后续出现“上面有、下面没有”的断层。 - README 同步：
README.md安全中心 / 验证码体系、邮件设置中心两个主说明区同步升级到v1.0.247。- 新增文档维护说明，明确
CHANGELOG.md采用“速查索引 + 正文版本小节”双轨同步维护。 - 校验：
rg -n "^## v1\\.0\\.(247|246|245|244|243|242|241|240|239)" CHANGELOG.md：通过。rg -n "v1\\.0\\.247" README.md CHANGELOG.md：通过。
v1.0.246 (2026-03-07 00:52:00)
后台界面枚举中文化收口，验证码中心与邮件中心显示统一改中文
- 该小节更新时间：2026-03-07 00:52:00
- 验证码中心中文化收口：
admin/captcha_center.php- 新增统一的“代码值 ⇄ 中文标签”映射辅助方法，后台显示层不再直接裸露
image / math / fixed / conditional / gray / vip / whitelist_ip / trusted_device等内部 code。 - 场景总览矩阵、场景高级策略、专题场景卡片、验证方式细项、审计与集成相关区块现统一显示中文标签，提交保存时再自动回写原始 code。
- 邮件中心中文化收口：
admin/mail.php- 队列状态、发送结果、报表周期、测试发送错误等高频枚举统一切换成中文显示。
running / stopped / pending / sent / failed / cancelled / daily / weekly / monthly等运行状态与周期项不再直接出现在后台界面。- 文档同步：
README.md- 验证码体系与邮件设置中心说明升级为
v1.0.246，补充后台显示中文化收口说明。 CHANGELOG.md- 更新顶部速查索引，并补录当前版本的正文详细小节。
- 校验：
php -l admin/captcha_center.php：通过。php -l admin/mail.php：通过。
v1.0.245 (2026-03-07 00:31:00)
模板测试邮件发送修复，后台测试链路不再误吃正式限额
- 该小节更新时间：2026-03-07 00:31:00
- 测试发送模式修复：
lib/mail.phpmail_template_send_test()改为后台专用测试发送模式，测试模板和页头“发送测试邮件”不再受recipient_daily_limit、sender_ip_daily_limit、system_daily_limit等正式发送限额影响。- 测试发送不再额外写入普通日级计数，避免管理员在调试模板时误占业务发送额度。
- 后台错误提示中文化：
admin/mail.php- 补齐模板测试、SMTP 校验、发送结果中的中文错误解释映射。
recipient-daily-limit、smtp-auth-failed、smtp-rcpt-failed等内部错误码会直接显示为可读中文。- 文档同步：
README.md- 邮件设置中心说明升级为
v1.0.245，补充模板测试发送修复与中文错误提示说明。 CHANGELOG.md- 更新顶部速查索引，并补录当前版本的正文详细小节。
- 校验：
php -l lib/mail.php：通过。php -l admin/mail.php：通过。
v1.0.244 (2026-03-07 00:18:00)
邮件设置中心卡片级直达补齐，验证码总控组同步补锚点
- 该小节更新时间：2026-03-07 00:18:00
- 邮件中心直达补齐：
admin/mail.php- 左侧三级导航从栏目级继续细化到卡片级，按
基础配置 / 开关策略 / 测试与校验 / 邮件美化 / 模板管理 / 队列运维 / 统计分析 / 联动配置 / 高级能力 / 审计同步挂载所有独立卡片锚点。 - 为
分层通知建议、配置导入还原、常见问题、模板目录、版本与预览、队列配置、队列进程控制、发送趋势、失败分析、高频收件人、场景占比、报表订阅、配置备份等卡片补齐真实 ID。 - 验证码总控补齐直达：
admin/captcha_center.php- 总控分组同步补充
配置总控、在线演练等独立区块直达入口。 - 文档同步：
README.md- 邮件设置中心与验证码体系说明升级为
v1.0.244，补充卡片级直达与锚点收口说明。 CHANGELOG.md- 更新顶部速查索引，并补录当前版本的正文详细小节。
- 校验：
php -l admin/mail.php：通过。php -l admin/captcha_center.php：通过。
v1.0.243 (2026-03-06 23:54:00)
验证码中心左侧导航层级优化，三级快捷入口整体右移显示
- 该小节更新时间：2026-03-06 23:54:00
- 导航层级优化：
admin/captcha_center.php- 将验证码中心侧栏改造成“二级父项 + 三级快捷入口”结构，
验证码安全中心保留为二级项。 总控 / 场景 / 方式 / 限流 / 名单 / 告警审批 / 风控体验 / 审计集成 / 分析增值等入口下沉为三级子项，并统一右移显示，层级关系更明确。- 同步补齐三级树形引导线、层级标签、搜索兼容与当前锚点高亮逻辑。
- 文档同步：
README.md- 验证码体系说明升级为
v1.0.243，补充“二级父项 + 三级快捷入口”层级说明。 CHANGELOG.md- 更新顶部速查索引，并补录当前版本的正文详细小节。
- 校验：
php -l admin/captcha_center.php：通过。
v1.0.242 (2026-03-06 23:48:00)
邮件设置页左侧导航层级优化，三级入口与分组结构统一
- 该小节更新时间：2026-03-06 23:48:00
- 导航层级优化：
admin/mail.php- 将邮件页侧栏改造成“二级父项 + 三级快捷入口”结构，
邮件设置作为二级父项保留。 基础配置 / 开关策略 / 测试与校验 / 邮件美化 / 模板管理 / 队列运维 / 统计分析 / 联动配置 / 高级能力 / 审计同步统一作为三级入口右移展示。- 同步补齐三级树形引导线、层级标签、搜索兼容与当前锚点高亮样式。
- 文档同步：
README.md- 邮件设置中心说明升级为
v1.0.242，补充左侧三级入口与快捷导航说明。 CHANGELOG.md- 更新顶部速查索引，并补录当前版本的正文详细小节。
- 校验：
php -l admin/mail.php：通过。
v1.0.241 (2026-03-06 23:40:00)
验证码中心新增后台场景邮箱验证码锁定开关，配置层和运行时双重锁死
- 该小节更新时间：2026-03-06 23:40:00
- 配置层补齐：
lib/captcha_center.php- 为邮箱验证方式补充
admin_scene_enabled默认值。 admin/captcha_center.php- 新增“后台场景彻底禁用邮箱验证码”独立区块与单独保存动作，避免再去修改大段 JSON。
- 运行时锁死：
lib/captcha_runtime.php- 增加后台敏感场景识别与邮箱方法可用性判断。
- 配置关闭后会从候选下发、发送构建、challenge 复用、结果校验四层同时锁死后台邮箱验证码，并自动清理旧的后台邮箱 challenge。
- 文档同步：
README.md- 验证码体系说明升级为
v1.0.241，补充后台场景邮箱验证码独立开关说明。 CHANGELOG.md- 更新顶部速查索引，并补录当前版本的正文详细小节。
- 校验：
php -l lib/captcha_center.php：通过。php -l lib/captcha_runtime.php：通过。php -l admin/captcha_center.php：通过。
v1.0.240 (2026-03-06 23:32:00)
后台验证码链路重新收口，在线演练切到纯预览不再真实发信
- 该小节更新时间：2026-03-06 23:32:00
- 后台认证场景候选顺序收口：
lib/captcha_runtime.php- 调整高危后台场景候选顺序，
admin_login / admin_forgot_password / admin_reset_password / admin_action / export_*不再因double / triple自动把邮箱验证码提前到前面。 - 在线演练改为预览模式：
lib/captcha_runtime.php- 新增
preview_only预览标记。 admin/captcha_center.php- 在线验证码演练默认改为
login场景。 api/captcha.php- 通过
/api/captcha.php?preview=1走本地预览，不再真实发送后台登录验证码邮件。 - 文档同步：
README.md- 验证码体系说明升级为
v1.0.240，补充后台演练预览化与后台场景候选顺序收口说明。 CHANGELOG.md- 更新顶部速查索引，并补录当前版本的正文详细小节。
- 校验：
php -l lib/captcha_runtime.php：通过。php -l admin/captcha_center.php：通过。php -l api/captcha.php：通过。
v1.0.239 (2026-03-06 23:20:00)
验证码运行时最后一批核心接线完成，名单 / 计数 / 成功动作正式生效
- 该小节更新时间：2026-03-06 23:20:00
- 运行时能力补齐：
lib/captcha_runtime.php- 新增 challenge 上下文持久化、共享失败锁、生成 / 验证计数、成功后动作（信任设备 / 解除限流 / 操作凭证）与统一免验证 TTL 折算。
- 让
IP / 账号 / 设备 / 地域名单、风险阈值、终端画像、邮箱发送限额真正参与运行时判定，不再只是后台静态配置。 - 页面成功回写接线：
user/register.php、user/login.php、user/forgot-password.php、user/reset-password.phpadmin/login.php、admin/forgot-password.php、admin/reset-password.phpuser/tickets.php、api/comments.php、lib/admin_captcha_gate.php- 以上链路同步补齐成功回写上下文，便于统一做账号 / 设备 / 场景维度风控。
- 文档同步：
README.md- 验证码体系说明升级为
v1.0.239，补充运行时名单、计数、成功动作与统一免验证窗口说明。 CHANGELOG.md- 更新顶部速查索引，并补录当前版本的正文详细小节。
- 校验：
php -l lib/captcha_runtime.php：通过。php -l lib/captcha_center.php：通过。php -l api/captcha.php：通过。
v1.0.238 (2026-03-06 23:06:00)
验证码上下文自动联动、重置场景邮箱解析与自动切换一次性补齐
- 该小节更新时间：2026-03-06 23:06:00
- 重置密码场景邮箱解析补齐：
lib/db.php- 新增
user_password_reset_lookup()、admin_password_reset_lookup()，可在不消费 token 的前提下查询有效重置记录。 lib/captcha_runtime.phpcaptcha_runtime_normalize_context()新增reset_token上下文。captcha_runtime_email_recipient()已支持reset_password、admin_reset_password通过reset_token反查收件邮箱，重置页启用邮件验证码后可真实发信。- 前端自动上下文联动补齐：
assets/captcha-widget.js- 新增
data-captcha-auto-context-refresh自动联动能力，账号 / 用户名 / 邮箱字段变化后会自动刷新 challenge。 - 新增
context_refresh=1场景刷新参数，允许“上下文变更导致的刷新”绕过邮件验证码重发冷却，避免切换账号后还卡在旧邮箱验证码。 - 补齐自动填充感知：浏览器回填账号 / 邮箱后，也会自动触发一次 challenge 对齐。
- 清空账号 / 邮箱时会自动退回到当前场景的普通验证码，不会残留旧邮箱验证码。
api/captcha.php- 新增接收
reset_token和context_refresh参数。 - 页面接入继续扩大：
user/login.php、user/forgot-password.php、user/register.php、admin/login.php、admin/forgot-password.php- 已开启自动上下文刷新，用户改完账号 / 邮箱后无需再手动点“换一张”。
user/reset-password.php、admin/reset-password.php- 已透传
token:reset_token，支持根据重置 token 自动解析邮箱验证码接收地址。 - 运行时细节补丁：
lib/captcha_runtime.php- challenge 生成日志现统一记录最终 challenge 方法，避免候选方法与最终方法不一致。
- 文档同步：
README.md- 验证码体系与邮件设置中心说明升级为
v1.0.238，补充自动刷新、自动填充感知与重置 token 反查邮箱说明。 CHANGELOG.md- 新增当前版本记录，并更新顶部阶段索引与全版本速查。
- 校验：
php -l lib/db.php：通过。php -l lib/captcha_runtime.php：通过。php -l api/captcha.php：通过。php -l user/login.php：通过。php -l user/forgot-password.php：通过。php -l user/register.php：通过。php -l user/reset-password.php：通过。php -l admin/login.php：通过。php -l admin/forgot-password.php：通过。php -l admin/reset-password.php：通过。node --check assets/captcha-widget.js：通过。
v1.0.237 (2026-03-06 22:58:00)
邮件验证码前端体验、冷却倒计时与输入规则一次性补齐
- 该小节更新时间：2026-03-06 22:58:00
- 邮箱验证码运行时继续补强：
lib/captcha_runtime.phpcaptcha_runtime_email_settings()新增读取resend_cooldown，运行时会把邮件验证码重发冷却真正带入 challenge。- 新增
captcha_runtime_challenge_input_meta()、captcha_runtime_email_refresh_remaining()，统一输出 placeholder、inputmode、maxlength与邮箱验证码剩余冷却时间。 captcha_runtime_public_challenge()现会返回refresh_available_at、resend_in、recipient_mask等前端体验字段。captcha_runtime_force_refresh()在邮箱验证码冷却期内不再重复发信，而是直接返回当前 challenge。- 邮件验证码输错或 token 过期时不再立即重发邮件，改为保留当前 challenge 并提示用户检查最新邮件。
- 前端组件体验补齐：
assets/captcha-widget.js- 新增邮件验证码
重新发送（Xs）倒计时文案、按钮禁用态、aria-disabled与帮助文案动态切换。 - 新增
字段名:参数名/字段名=参数名形式的上下文字段映射，便于把表单字段按需透传到验证码接口。 - 输入框会根据 challenge 自动切换
placeholder、inputmode和maxlength，不再把邮件验证码错误地按数学题处理。 assets/auth-pages.css、assets/tickets.css、admin/captcha_center.php- 为邮箱验证码模式补齐独立视觉样式，收件人提示文案不再沿用大号数学题样式。
- 页面接入范围扩大：
user/register.php- 新增
username,email:recipient_email上下文透传，注册页可以直接根据输入邮箱切到邮件验证码。 user/login.php、user/forgot-password.php、user/reset-password.php- 初始输入框元信息与冷却元信息已同步使用 challenge 元数据。
admin/login.php、admin/forgot-password.php、admin/reset-password.php- 后台认证链路同步支持邮箱验证码倒计时与输入规则。
user/tickets.php、lib/admin_captcha_gate.php、admin/captcha_center.php- 工单场景、后台导出验证码闸门、验证码演练区也已统一支持邮箱验证码样式与输入行为。
- 文档同步：
README.md- 验证码体系与邮件设置中心说明升级为
v1.0.237，补充邮件验证码倒计时、字段映射透传与注册场景接入说明。 CHANGELOG.md- 新增当前版本记录，并更新顶部阶段索引与全版本速查。
- 校验：
php -l lib/captcha_runtime.php：通过。php -l user/login.php：通过。php -l user/forgot-password.php：通过。php -l user/register.php：通过。php -l user/reset-password.php：通过。php -l admin/login.php：通过。php -l admin/forgot-password.php：通过。php -l admin/reset-password.php：通过。php -l lib/admin_captcha_gate.php：通过。php -l user/tickets.php：通过。php -l admin/captcha_center.php：通过。node --check assets/captcha-widget.js：通过。
v1.0.236 (2026-03-06 22:55:00)
邮件 API 容灾、验证码邮箱兜底与后台直达入口一次性补齐
- 该小节更新时间：2026-03-06 22:55:00
- 邮件运行时链路继续落地：
lib/mail.php- 新增
mail_basic_sender_pool()、mail_pick_from_address()，支持主发件邮箱 + 备用发件邮箱池轮询，并按收件人 / 场景稳定选择发件地址。 - 新增
mail_provider_runtime_settings()、mail_provider_api_send()、mail_send_via_runtime_transport()，把 SMTP 与第三方 API 发信接入同一运行时出口。 send_or_queue_email()与process_email_queue_once()已统一走运行时传输选择，支持SMTP -> API自动容灾切换。- 内置模板扩展到 27 个，新增
user_captcha_code_email邮件验证码模板。 - 验证码邮箱兜底能力接入真实链路：
lib/captcha_runtime.php- 新增
captcha_runtime_email_fallback_enabled()、captcha_runtime_build_email_challenge()等 helper，运行时可为指定场景下发email挑战。 captcha_runtime_method_candidates()、captcha_runtime_public_challenge()、captcha_runtime_store_new_challenge()、captcha_runtime_normalize_answer()已补齐email分支。api/captcha.php- 刷新 challenge 时支持接收
account、username、recipient_email上下文字段，便于根据账号解析邮件接收地址。 assets/captcha-widget.js- 新增
data-captcha-context-fields自动透传、captcha-method-email样式态与“请输入邮件验证码”占位文案。 user/login.php、user/forgot-password.php、admin/login.php、admin/forgot-password.php- 刷新验证码时已自动带上账号上下文，邮件验证码 fallback 不再只停留在后台配置层。
- 后台一键直达入口同步补齐：
lib/admin_sidebar_menu.php- 新增
邮件 · 开关策略、邮件 · 系统联动、邮件 · 高级能力、邮件 · 审计同步二 / 三级快捷入口。 - 邮件中心剩余大区块现已与页内左侧锚点、顶部快捷导航保持一致。
- 文档同步：
README.md- 验证码体系与邮件设置中心说明升级为
v1.0.236，补充邮箱验证码 fallback、SMTP / API 容灾、27 个模板与后台直达入口说明。 CHANGELOG.md- 新增当前版本记录，并更新顶部阶段索引与全版本速查。
- 校验：
php -l lib/mail.php：通过。php -l lib/captcha_runtime.php：通过。php -l api/captcha.php：通过。php -l user/login.php：通过。php -l user/forgot-password.php：通过。php -l admin/login.php：通过。php -l admin/forgot-password.php：通过。php -l lib/auth.php：通过。php -l lib/node_monitor.php：通过。php -l lib/tickets.php：通过。php -l lib/backup_center.php：通过。php -l admin/users.php：通过。php -l admin/backup_center.php：通过。php -l admin/mail.php：通过。php -l lib/admin_sidebar_menu.php：通过。php -r "require 'lib/mail.php'; echo 'templates=' . count(mail_template_builtin_definitions()) . PHP_EOL;"：输出templates=27。
v1.0.235 (2026-03-06 22:40:00)
邮件中心剩余运行时能力一次性接入发送链路
- 该小节更新时间：2026-03-06 22:40:00
- 发送链路治理落地：
lib/mail.php- 新增运行时路由与限额能力：
场景邮箱分配、收件人白名单、收件人黑名单、内容黑名单、单收件人单日上限、单 IP 单日上限、系统单日总发送上限、配额降级已全部接入send_or_queue_email()/enqueue_email()。 - 新增邮件日级计数器，后台高级策略不再只是配置卡片，已经可以在实际发送时拦截、限流和降级。
- 新增账号变更模板
user_account_change_notice，内置模板数扩展到 26 个。 - 节点与认证联动补齐：
lib/node_monitor.php- 节点告警收件人收集逻辑已接入邮件中心管理分组开关，并会合并
节点分组接收人配置。 lib/auth.php- 用户找回密码流程已接入邮件中心
用户通知 / 找回密码开关，禁用后不再进入发送链路。 - 用户管理联动补齐：
admin/users.php- 管理员重置密码、启用 / 禁用账号、批量启用 / 禁用、角色调整、资料更新均已接入账号变更邮件模板。
- 用户管理页原本零散的直写邮件逻辑已并入邮件中心统一通知链路，受邮件模板与高级运行时策略共同控制。
- 既有联动继续保持：
lib/tickets.php- 工单管理员 / 用户通知继续使用强制场景键发送，避免工单主题被误判到错误分组。
lib/backup_center.php- 备份成功 / 失败通知继续使用系统告警场景键发送，确保备份链路与系统告警开关一致。
- 文档同步：
README.md- 邮件设置中心说明升级为
v1.0.235，补充运行时治理、节点告警和用户管理联动说明。 CHANGELOG.md- 新增当前版本记录，并更新顶部阶段索引与全版本速查。
- 校验：
php -l lib/mail.php：通过。php -l lib/auth.php：通过。php -l lib/node_monitor.php：通过。php -l lib/tickets.php：通过。php -l lib/backup_center.php：通过。php -l admin/users.php：通过。php -l admin/backup_center.php：通过。php -r "require 'lib/mail.php'; echo 'templates=' . count(mail_template_builtin_definitions()) . PHP_EOL;"：输出templates=26。
v1.0.234 (2026-03-06 22:20:00)
邮件中心联动继续落地到工单与备份中心
- 该小节更新时间：2026-03-06 22:20:00
- 工单通知模板化：
lib/tickets.php- 新增工单邮件开关联动判断，工单通知会同时遵守邮件中心全局开关、联动开关以及管理 / 用户分组开关。
- 新增工单活动模板渲染 helper，管理员 / 用户通知优先使用
admin_ticket_activity、user_ticket_activity两套通用模板。 - 工单创建、回复、关闭、重开等邮件统一改为“模板优先 + 旧 HTML 回退”机制，继续兼容旧流程，避免模板异常导致通知中断。
- 备份中心邮件联动：
lib/backup_center.php- 新增
backup_center_notification_emails()、backup_center_mail_channel_enabled()、backup_center_notify_email()等 helper，补齐备份邮件收件人解析、邮件开关联动、模板渲染与成功 / 失败发送能力。 - 新增备份中心字节格式化、绝对链接拼接、
mail.notify_to/site.contact_email回退收件人策略。 admin/backup_center.php- 全站备份、手动备份创建成功后会自动发送备份完成通知。
- 备份 / 导入 / 恢复类动作失败时会自动发送异常告警邮件，便于后台运维及时感知。
- 邮件模板扩展：
lib/mail.php- 内置模板现已扩展为 25 个，新增工单通用动态模板
user_ticket_activity、admin_ticket_activity，继续增强邮件中心的场景覆盖。 - 文档同步：
README.md- 邮件设置中心说明升级为
v1.0.234，补充工单模板化通知和备份中心邮件联动说明。 CHANGELOG.md- 新增当前版本记录，并更新顶部阶段索引与全版本速查。
- 校验：
php -l lib/mail.php：通过。php -l lib/tickets.php：通过。php -l lib/backup_center.php：通过。php -l admin/backup_center.php：通过。
v1.0.233 (2026-03-06 22:10:00)
邮件设置中心重构为模块化独立区块后台
- 该小节更新时间：2026-03-06 22:10:00
- 邮件后台页重构：
admin/mail.php- 旧版单页 SMTP + 模板编辑页面重构为完整「邮件设置中心」，拆成
基础配置、开关策略、测试与校验、邮件美化、模板管理、队列运维、发送统计、系统联动、高级能力、审计同步10 大独立区块。 - 顶部新增快捷导航、快捷入口卡片、SMTP 测试动作区、最近发送记录、环境变量说明与常见问题卡片。
- 模板中心支持分类浏览、变量说明、自定义模板保存、默认 / 自定义切换、版本恢复、模板级美化与实时预览。
- 队列中心支持状态筛选、批量重发 / 取消 / 删除、清理规则、进程状态切换和 worker 单次执行。
- 页面左侧新增“邮件中心直达”锚点入口，并增加滚动联动高亮。
- 邮件底层能力增强：
lib/mail.php- 新增模块化块配置安全合并逻辑，列表字段不再因递归合并残留旧值。
security配置块改为安全保存 SMTP 密码：后台输入留空即可保留原值，导出配置时保留加密后的存储值。- 新增 SMTP 运行时解析、MIME 主题编码、连接 / 认证校验函数
mail_validate_smtp_settings()。 - 新增队列运维辅助函数：
mail_queue_status_summary()、mail_queue_recent()、mail_queue_list()、mail_queue_bulk_action()、mail_queue_cleanup()、mail_queue_failure_buckets()、mail_queue_daily_stats()、mail_queue_top_recipients()、mail_queue_subject_stats()。 - 邮件模板扩展到 20+ 预置模板，覆盖管理员通知、用户通知、系统告警、备份、限流、风控、异地登录等场景，并补齐分类与风格标签。
- 后台共享菜单补齐：
lib/admin_sidebar_menu.php- 新增
邮件 · 基础配置、邮件 · 美化配置、邮件 · 模板管理、邮件 · 队列运维、邮件 · 发送统计、邮件 · 测试校验快捷入口，便于后台其它页面与设置检索中心直达。 - 文档同步：
README.md- 新增邮件设置中心能力说明，补充分区化后台、模板美化、队列运维和快捷入口。
CHANGELOG.md- 新增当前版本记录，并更新顶部版本范围与速查表。
- 校验：
php -l admin/mail.php：通过。php -l lib/mail.php：通过。php -l lib/admin_sidebar_menu.php：通过。
v1.0.232 (2026-03-06 21:28:00)
验证码后台导航再增强并支持滚动联动高亮
- 该小节更新时间：2026-03-06 21:28:00
- 后台导航与直达能力继续扩展：
admin/captcha_center.php- 快捷数据源
pageShortcutGroups继续扩展，补齐“场景细分”“方式细分”“限流细分”“名单细分”“运行与版本”等分组，支持更多独立卡片一键直达。 - 为“场景高级策略矩阵”“图形 / 数学验证码细项”“滑块 / 拼图 / 点选细项”“短信 / 邮箱 / 第三方验证细项”“日志 / 缓存 / 成本控制”等区块补齐稳定锚点 ID，便于左侧导航与快捷入口精确定位。
- 新增滚动联动高亮脚本：左侧导航、顶部子导航和快捷卡片区会随页面滚动自动高亮当前所在区块。
lib/admin_sidebar_menu.php- 共享后台菜单模型新增“安全中心快捷”分组，补充安全中心快捷导航、场景策略矩阵、用户认证专题、图形数学细项、发送外部细项、生成限流、IP 名单、阈值告警、角色权限、风控权重、视觉品牌、报表订阅、API 治理、看板趋势、应急响应等直达入口。
- 文档同步：
README.md- 将验证码体系说明更新到
v1.0.232，补充滚动高亮联动与共享后台菜单快捷入口说明。 CHANGELOG.md- 新增当前版本记录，并更新顶部版本范围与速查表。
- 校验：
php -l admin/captcha_center.php：通过。php -l lib/admin_sidebar_menu.php：通过。php -l lib/captcha_center.php：通过。php -l lib/captcha_runtime.php：通过。
v1.0.231 (2026-03-06 21:18:00)
验证码后台左侧导航与二三级快捷入口继续深化
- 该小节更新时间：2026-03-06 21:18:00
- 后台导航与直达能力继续扩展：
admin/captcha_center.php- 左侧导航新增按组锚点直达，补齐“总控直达”“告警细分”“审批细分”“风控细分”“体验细分”“审计细分”“集成细分”“分析细分”“增值细分”九组入口。
- 页面顶部主导航新增“快捷导航”总入口，并新增分组快捷卡片区
#captchaQuickNav，支持二/三级方式直达各独立卡片与对应总览区块。 - 左侧导航与页面快捷卡片共用同一份锚点数据源，后续新增后台区块时可同步复用，避免再次手工散落维护。
- 文档同步：
README.md- 将验证码体系说明更新到
v1.0.231，补充左侧导航锚点分组与页面二/三级快捷入口说明。 CHANGELOG.md- 新增当前版本记录，并更新顶部版本范围与速查表。
- 校验：
php -l admin/captcha_center.php：通过。php -l lib/captcha_center.php：通过。php -l lib/captcha_runtime.php：通过。
v1.0.230 (2026-03-06 21:08:00)
验证码后台剩余治理模块一次性完成块状化
- 该小节更新时间：2026-03-06 21:08:00
- 后台管理台区块化继续扩展：
admin/captcha_center.php- 告警与通知继续细拆为“阈值告警区块”“异常 / 安全告警区块”“告警渠道与分级区块”“告警处理流程区块”，并保留“告警与通知总览（高级合并维护）”兜底入口。
- 权限与审批继续细拆为“角色权限区块”“审批流区块”“跨角色复核区块”“临时权限区块”“操作留痕区块”，并保留“权限与审批总览（高级合并维护）”兜底入口。
- 风控治理继续细拆为“风控权重与阈值区块”“地域 / 时段策略区块”“机器学习 / 行为序列区块”，对应保存动作改为独立合并写入，支持单卡片保存。
- 体验治理继续细拆为“视觉与品牌区块”“交互反馈区块”“语言 / 无障碍 / 多端区块”，并保留“体验与内容总览（高级合并维护）”入口。
- 审计治理继续细拆为“报表与订阅区块”“日志溯源与存储区块”“升级与复核区块”，并保留“日志与审计总览（高级合并维护）”入口。
- 集成治理继续细拆为“API 治理区块”“插件 / SDK / 国产化区块”“外部系统联动区块”，并保留“集成与开放总览（高级合并维护）”入口。
- 数据分析继续细拆为“看板与趋势区块”“报表投递与共享区块”“体验采样与异常检测区块”，并保留“数据与分析总览（高级合并维护）”入口。
- 增值能力继续细拆为“应急响应区块”“合规与防护区块”“自动化运维区块”“用户反馈闭环区块”，并保留“应急 / 合规 / 自动化总览（高级合并维护）”入口。
- 新增
update_alert_segment、update_approval_segment、update_risk_engine_segment、update_content_experience_segment、update_audit_governance_segment、update_integration_open_segment、update_analytics_dashboard_segment、update_extra_guard_segment8 组细分保存动作，所有细分区块均采用增量合并写入，不再要求回到整块 JSON 修改。 - 文档同步：
README.md- 将验证码体系说明更新到
v1.0.230，补充告警、审批、风控、体验、审计、集成、分析、增值模块的彻底块状化说明。 CHANGELOG.md- 新增当前版本记录，并更新顶部版本范围与速查表。
- 校验：
php -l admin/captcha_center.php：通过。php -l lib/captcha_center.php：通过。php -l lib/captcha_runtime.php：通过。
v1.0.229 (2026-03-06 20:54:01)
验证码限流继续细拆
- 该小节更新时间：2026-03-06 20:54:01
- 后台管理台区块化继续扩展：
admin/captcha_center.php- 新增“生成限流区块”，支持独立维护单 IP / 单账号 / 单设备 / 单场景生成阈值。
- 新增“验证限流区块”，支持独立维护单 IP / 单设备 / 单场景验证阈值和验证成功冷却。
- 新增“发送限流区块”，支持独立维护手机号、邮箱、IP、跨平台发送上限和发送冷却。
- 新增“并发限流区块”，支持独立维护 IP / 账号 / 全局并发、超限处理模式和高峰倍率。
- 新增“梯度封禁区块”，支持独立维护 3 段冷却、封禁时长和解锁模式。
- 新增“智能自适应限流区块”，支持独立维护按流量与按风险自动调节、低峰倍率与高峰倍率。
- 原频率与限流合并块下沉为“频率与限流总览（高级合并维护）”兜底入口；细分保存动作改为增量更新，不再覆盖其它限流字段。
- 文档同步：
README.md- 将验证码体系说明更新到
v1.0.229，补充限流细分区块说明。 CHANGELOG.md- 新增当前版本记录，并更新顶部版本范围与速查表。
- 校验：
php -l admin/captcha_center.php：通过。php -l lib/captcha_center.php：通过。php -l lib/captcha_runtime.php：通过。
v1.0.228 (2026-03-06 20:47:04)
验证码黑白名单继续细拆
- 该小节更新时间：2026-03-06 20:47:04
- 后台管理台区块化继续扩展：
admin/captcha_center.php- 新增“IP 黑白名单区块”，支持独立维护 IP 白名单、黑名单、生效范围和生效时机。
- 新增“设备黑白名单区块”，支持独立维护设备白名单、黑名单、终端范围和审核开关。
- 新增“账号黑白名单区块”，支持独立维护账号白名单、黑名单、生效范围和审批开关。
- 新增“地域黑白名单区块”，支持独立维护地域白名单、黑名单、地域准入策略和 IP 联动开关。
- 新增“验证方式限制与名单策略”区块，支持独立维护验证方式禁用规则、名单优先级、默认限制策略和过期名单清理周期。
- 原黑白名单合并块下沉为“黑白名单总览（高级合并维护）”兜底入口，常规维护优先走细分区块。
- 文档同步：
README.md- 将验证码体系说明更新到
v1.0.228，补充黑白名单细分区块说明。 CHANGELOG.md- 新增当前版本记录，并更新顶部版本范围与速查表。
- 校验：
php -l admin/captcha_center.php：通过。php -l lib/captcha_center.php：通过。php -l lib/captcha_runtime.php：通过。
v1.0.227 (2026-03-06 20:41:31)
验证码发送与外部验证继续深拆
- 该小节更新时间：2026-03-06 20:41:31
- 后台管理台区块化继续扩展：
admin/captcha_center.php- 新增“短信 / 邮箱模板设置”区块，支持独立维护模板名称、签名、多语言策略、主模板、到期提醒模板、到期提醒开关与补发文案开关。
- 新增“通道与重试设置”区块，支持独立维护短信 / 邮箱主备通道、调度策略、重试次数、重试间隔、通道优先级、单次成本与失败告警。
- 新增“第三方路由与区域设置”区块，支持独立维护第三方服务商、Site Key / Secret Key、国内外节点路由、验证等级、健康探测、密钥轮换与失败降级。
- 新增“语音 / 扫码 / 生物高级设置”区块，支持独立维护语音播放模式与重播上限、扫码审批与 APP 场景、活体等级、行为轨迹联动与信任设备绑定。
- 文档同步：
README.md- 将验证码体系说明更新到
v1.0.227，补充模板、通道、第三方路由和高级因子独立区块说明。 CHANGELOG.md- 新增当前版本记录，并更新顶部版本范围与速查表。
- 校验：
php -l admin/captcha_center.php：通过。php -l lib/captcha_center.php：通过。php -l lib/captcha_runtime.php：通过。
v1.0.226 (2026-03-06 20:36:10)
验证码后台继续按业务专题拆块
- 该小节更新时间：2026-03-06 20:36:10
- 后台管理台区块化继续扩展：
admin/captcha_center.php- 新增“用户认证场景”专题区块，集中维护
login / register / forgot_password / reset_password的默认验证方式、层级、触发模式、豁免、回退、复用时长与终端配置。 - 新增“后台认证场景”专题区块，集中维护
admin_login / admin_forgot_password / admin_reset_password的安全策略。 - 新增“评论与工单场景”专题区块，集中维护
comment / ticket_create / ticket_reply的交互与风控参数。 - 新增“支付与导出场景”专题区块，集中维护
payment / data_export / export_logs / export_comments的高危策略。 - 新增“API 与后台高危场景”专题区块，集中维护
api_call / admin_action / batch_action / permission_change / device_binding的场景参数。 - 每个专题区块均可独立维护：启用状态、默认验证方式、验证层级、触发模式、豁免、回退、复用分钟数、风险阈值与终端配置，避免运营改某类业务时还要翻全量大表。
- 文档同步：
README.md- 将验证码体系说明更新到
v1.0.226，补充关键场景专题区块说明。 CHANGELOG.md- 新增当前版本记录，并更新顶部版本范围与速查表。
- 校验：
php -l admin/captcha_center.php：通过。php -l lib/captcha_center.php：通过。php -l lib/captcha_runtime.php：通过。
v1.0.225 (2026-03-06 20:32:27)
验证码后台治理面继续块状化
- 该小节更新时间：2026-03-06 20:32:27
- 后台管理台区块化继续扩展：
admin/captcha_center.php- 新增“日志与审计治理设置”区块，支持直接维护报表周期、订阅对象、导出格式、溯源字段、升级时长、双人复核、管理员录像和外部日志同步。
- 新增“集成与开放设置”区块，支持直接配置 API 鉴权、版本、文档模式、插件市场、CRM/风控/工单/支付联动与多端 SDK 目标。
- 新增“数据与分析设置”区块，支持看板刷新、趋势粒度、预测天数、投递方式、订阅对象、采样率、数据集上限、分享时效与异常检测。
- 新增“应急 / 合规 / 自动化设置”区块，支持熔断阈值、离线验证码库、一键回滚、合规模式、防重放、防截图、巡检 Cron、反馈工单和自动优化。
captchaAudit、captchaIntegrations、captchaAnalytics、captchaExtras主锚点已优先落到独立后台表单，能力清单块下沉为Catalog次级锚点。- 文档同步：
README.md- 将验证码体系说明更新到
v1.0.225，补充日志审计、集成开放、数据分析、应急合规自动化的独立区块说明。 CHANGELOG.md- 新增当前版本记录，并更新顶部版本范围与速查表。
- 校验：
php -l admin/captcha_center.php：通过。php -l lib/captcha_center.php：通过。php -l lib/captcha_runtime.php：通过。
v1.0.224 (2026-03-06 20:26:39)
验证码后台继续深拆独立卡片
- 该小节更新时间：2026-03-06 20:26:39
- 后台管理台块状化继续扩展：
admin/captcha_center.php- 新增“场景高级策略矩阵”，支持按场景独立维护触发模式、验证层级、豁免条件、回退策略、风险阈值、成功后动作、终端配置与人工审核超时。
- 新增“图形 / 数学验证码细项”区块，支持直接维护字符集、干扰线、噪点密度、背景模式、公式模式、有效期与数学题上限。
- 新增“滑块 / 拼图 / 点选细项”区块，支持单独配置容错率、拖拽时长、阻力、轨迹校验、拼图块数、动态目标与点击偏差。
- 新增“短信 / 邮箱 / 第三方验证细项”区块，支持模板、验证码类型/长度、失效时间、重发冷却、日配额、服务商、节点路由、降级方式，以及语音 / 扫码 / 生物验证参数。
- 新增“风控引擎设置”和“体验与内容定制设置”独立区块，支持风险权重、等级阈值、机器学习开关、节假日强化、主题模式、反馈方式、品牌化与无障碍设置。
- 修正
captchaMethods锚点落点，并让captchaRisk/captchaContent主锚点优先落到真正可操作的独立区块。 - 文档同步：
README.md- 将验证码体系说明更新到
v1.0.224，补充场景高级策略、验证方式细项、风控引擎与体验定制区块。 CHANGELOG.md- 新增当前版本记录，并更新顶部版本范围与速查表。
- 校验：
php -l admin/captcha_center.php：通过。php -l lib/captcha_center.php：通过。php -l lib/captcha_runtime.php：通过。
v1.0.223 (2026-03-06 20:15:27)
验证码后台继续去 JSON 化
- 该小节更新时间：2026-03-06 20:15:27
- 后台管理台区块化继续增强：
admin/captcha_center.php- 新增“频率与限流控制”独立区块，支持直接维护生成、验证、发送、并发与梯度冷却参数，不再依赖整段 JSON。
- 新增“黑白名单管理”独立区块，支持按 IP、设备、账号、地域、验证方式限制分块维护名单与优先级。
- 新增“告警与通知”独立区块，支持直接维护失败率、短信量、接口错误率、风险激增阈值，以及渠道、分级和责任人。
- 新增“权限与审批”独立区块，支持独立配置角色范围、审批模式、超时、跨角色复核、临时权限和录像保留。
- 新增通用“结构化区块”保存能力，将
智能风控规则 / 验证内容定制 / 日志与审计 / 集成与开放 / 数据与分析 / 额外增值功能改成按子模块逐块编辑、逐块保存。 - 各核心域原有 JSON 面板降级为“高级 JSON”兜底入口，导航锚点默认直接落到独立区块，降低后台误操作概率。
- 文档同步：
README.md- 将验证码体系说明更新到
v1.0.223，补充新的后台独立区块与“高级 JSON 兜底”说明。 CHANGELOG.md- 新增当前版本记录，并更新阶段索引与全版本速查。
- 校验：
php -l admin/captcha_center.php：通过。php -l lib/captcha_center.php：通过。php -l lib/captcha_runtime.php：通过。
v1.0.222 (2026-03-06 19:27:48)
验证码后台管理台继续块状化
- 该小节更新时间：2026-03-06 19:27:48
- 后台管理台区块化增强：
admin/captcha_center.php- 新增“场景总览矩阵”，支持独立调整场景启用状态、名称、分组、默认验证方式、复用时间、排序与说明。
- 新增“验证方式总览矩阵”，支持独立调整各验证方式启用状态、难度，以及图形验证码尺寸/长度/大小写敏感、数学验证码最大操作数。
- 新增“日志 / 缓存 / 成本控制”区块，独立维护缓存层级、短信/邮箱/第三方调用上限、成本告警金额、统一有效期、日志保留天数、存储驱动、脱敏字段、压缩与备份目标。
- 新增当前配置锁定/解锁、版本/快照稳定标记、历史导出以及双版本/双快照差异对比。
- 新增自定义场景创建与场景复制，进一步减少依赖整段 JSON 手工编辑。
- 底层能力增强：
lib/captcha_center.php- 新增历史条目读取、更新、稳定标记能力。
- 新增结构化配置差异比对能力，用于后台展示版本/快照字段级差异。
- 文档同步：
README.md- 将验证码体系说明更新到
v1.0.222，强调“独立区块管理”与更多后台可视化操作能力。 CHANGELOG.md- 新增当前版本记录，并更新索引。
- 校验：
php -l admin/captcha_center.php：通过。php -l lib/captcha_center.php：通过。php -l lib/captcha_runtime.php：通过。
v1.0.221 (2026-03-06 19:09:36)
验证码管理台增强与后台高危链路扩展
- 该小节更新时间：2026-03-06 19:09:36
- 管理台增强：
admin/captcha_center.php- 新增运行态指标卡：展示最近验证码运行日志中的题目签发、刷新、验证通过、验证失败、活跃场景等数据。
- 新增预设模板区：支持一键应用
平衡模式 / 高强度模式 / 体验优先 / 活动护航四类策略模板，并自动写入版本历史。 - 新增运行日志控制区：支持按场景 / 动作 / 结果 / 关键字筛选日志，并支持导出与清空运行日志。
- 新增在线验证码演练：可在后台直接按真实场景生成并验证 challenge，联调图片验证码 / 数学验证码及场景文案。
- 配置与运行库增强：
lib/captcha_center.php- 新增后台专属场景：
admin_forgot_password、admin_reset_password、export_logs、export_comments。 - 为
batch_action、api_call、payment、data_export、permission_change、device_binding等高危场景补齐默认preferred_method。 - 新增运行日志读取 / 统计函数与预设模板应用函数，支撑管理台的运营能力。
lib/captcha_runtime.php- 新增
captcha_runtime_issue_preview_challenge()，用于后台管理台在线演练。 - 新增
captcha_runtime_clear_pass()，避免管理台演练影响真实业务复用态。 - 数学验证码正式接入
methods.math.max_operand配置项，运算范围可被后台调节。 - 补充后台找回密码、后台重置密码、访问日志导出、评论导出等场景标签。
lib/admin_captcha_gate.php- 新增后台导出验证码闸门，统一为敏感 CSV 导出场景提供验证码确认页。
- 业务接入扩展：
admin/forgot-password.php- 后台找回密码页接入
admin_forgot_password场景验证码。 admin/reset-password.php- 后台重置密码页接入
admin_reset_password场景验证码。 admin/export_logs.php- 导出访问日志前必须先完成
export_logs场景验证码。 admin/export_comments.php- 导出评论数据前必须先完成
export_comments场景验证码。 - 文档同步：
README.md- 将验证码体系说明更新到
v1.0.221，补充管理台运行日志、预设模板、在线演练、后台密码链路与导出闸门说明。 CHANGELOG.md- 新增当前版本记录，并同步更新全版本速查索引。
- 校验：
php -l lib/captcha_runtime.php：通过。php -l lib/captcha_center.php：通过。php -l lib/admin_captcha_gate.php：通过。php -l admin/captcha_center.php：通过。php -l admin/forgot-password.php：通过。php -l admin/reset-password.php：通过。php -l admin/export_logs.php：通过。php -l admin/export_comments.php：通过。php -l admin/login.php：通过。php -l user/tickets.php：通过。php -l api/captcha.php：通过。node --check assets/captcha-widget.js：通过。
v1.0.220 (2026-03-06 18:26:12)
验证码体系继续接入后台登录与工单链路
- 该小节更新时间：2026-03-06 18:26:12
- 运行时升级：
lib/captcha_runtime.php- 验证方式从纯数学题扩展到
math + image双模式，新增内建 SVG 图形验证码输出、场景默认验证方式选择和ticket_create / ticket_reply / admin_login新场景。 - 新增运行日志写入
cache/captcha-runtime.log，记录场景、动作、结果、脱敏 IP 与附加元信息，便于后续审计与风控联调。 lib/captcha_center.php- 补齐
ticket_create、ticket_reply、admin_login场景默认模板，并为image/math验证方式增加长度、字符集、大小写敏感、尺寸与最大操作数等配置项。 api/captcha.php- 继续复用统一挑战接口，并支持新场景前端刷新 challenge。
- 新增前端组件：
assets/captcha-widget.js- 新增通用验证码组件，统一处理图片验证码 / 数学题展示、按钮刷新、点击视觉区域刷新、过期后聚焦自动刷新和提示文案更新。
assets/auth-pages.css- 补齐通用验证码组件样式，供用户登录、找回密码、重置密码、注册和后台登录页复用。
assets/tickets.css- 新增工单页验证码区域样式，并升级资源版本到
20260306-ticket-v9。 - 业务接入：
admin/login.php- 后台登录页接入
admin_login场景验证码，登录失败后保留用户名并刷新 challenge。 user/tickets.php- 创建工单接入
ticket_create场景验证码，回复工单接入ticket_reply场景验证码。 - 同页双表单分别绑定独立 scene，避免 challenge/token 冲突。
- 验证失败或业务失败时保留工单标题、优先级、正文与回复草稿，并继续停留在当前工单上下文。
- 文档同步：
README.md- 将验证码体系说明更新到
v1.0.220，补充后台登录、工单链路、双模式验证码、运行日志与通用组件说明。 CHANGELOG.md- 新增当前版本记录，并同步更新版本索引。
- 校验：
php -l lib/captcha_runtime.php：通过。php -l lib/captcha_center.php：通过。php -l admin/login.php：通过。php -l user/tickets.php：通过。php -l user/login.php：通过。php -l user/register.php：通过。php -l user/forgot-password.php：通过。php -l user/reset-password.php：通过。php -l api/captcha.php：通过。php -l api/comments.php：通过。node --check assets/captcha-widget.js：通过。node --check assets/quick-page.js：通过。
v1.0.219 (2026-03-06 17:44:02)
验证码体系首批接入认证与评论链路
- 该小节更新时间：2026-03-06 17:44:02
- 新增：
lib/captcha_runtime.php- 新增会话态验证码运行时，负责场景判定、挑战题生成、验证码校验、结果复用、失败计数和用户组豁免识别。
- 首个可执行验证方式落地为内建数学验证码，并按场景配置复用
captcha_center中的总控与场景模板。 api/captcha.php- 新增通用验证码挑战接口，支持按场景获取/刷新题目，当前用于评论场景前端动态取题。
- 接入：
- 用户认证页：
user/login.phpuser/register.phpuser/forgot-password.phpuser/reset-password.php- 以上页面均已接入验证码校验，提交前必须先完成人机验证；认证页会在错误后自动刷新题目，并保留关键输入值。
- 评论链路：
api/comments.php- 评论创建动作新增验证码校验，并支持返回
captcha-required、captcha-invalid、captcha-expired细分错误以及新挑战题。 index.php- 首页评论编辑器新增验证码面板、题目刷新与错误回填逻辑，提交评论时自动带上验证码答案与 token。
quick.php- 简洁页评论编辑器同步新增验证码面板。
assets/quick-page.js- 简洁页评论请求新增验证码状态管理、题目刷新和服务端验证码错误处理。
- 样式与资源：
assets/auth-pages.css- 认证页新增验证码块样式。
assets/main.css- 首页评论编辑器新增验证码区域样式。
assets/quick-page.css- 简洁页评论验证码区域样式补齐。
- 资源版本升级：
auth-pages.css→20260306-auth-ui-v7main.css→20260306-site-polish-v97quick-page.css→20260306-quick-page-v30quick-page.js→20260306-quick-page-v34- 校验：
php -l user/login.php：通过。php -l user/register.php：通过。php -l user/forgot-password.php：通过。php -l user/reset-password.php：通过。php -l api/comments.php：通过。php -l api/captcha.php：通过。php -l lib/captcha_runtime.php：通过。
v1.0.218 (2026-03-06 17:18:25)
安全中心 / 验证码体系总控台上线
- 该小节更新时间：2026-03-06 17:18:25
- 背景：
- 当前后台缺少统一的验证码与风控治理入口，登录、评论、工单、导出、支付等场景无法在一个地方做分层配置、版本管理与应急回滚。
- 验证码能力此前更多停留在零散策略概念层，尚未形成“菜单架构 + 结构化配置 + 版本快照 + 审计留痕”的完整运营台。
- 新增：
admin/captcha_center.php- 新增独立后台页面「安全中心 / 验证码体系」，作为验证码与风控的统一总控台。
- 页面内置 12 大核心域：验证码总控、场景化验证规则、验证方式管理、智能风控规则、验证内容定制、频率与限流控制、黑白名单管理、日志与审计、告警与通知、集成与开放、数据与分析、权限与审批，并补充应急响应 / 合规 / 自动化运维 / 用户反馈增值能力。
- 提供全局总控表单（全局开关、灰度启停、时段启停、应急降级、主备引擎、容灾切换、QPS、超时、快照周期、多环境同步、配置锁、继承与成本控制）以及各域 JSON 编辑器，便于后续业务接入层直接消费。
- 支持全量导入/导出 JSON、手动保存版本、创建快照、恢复历史版本、恢复快照，并在恢复前自动生成保护性快照。
lib/captcha_center.php- 新增验证码中心配置模型，内置 12 个高危场景模板、12 类验证方式模板、9 个风控维度模板，以及内容定制、限流、黑白名单、审计、告警、开放集成、分析、权限审批与增值能力默认结构。
- 提供配置读取、默认值合并、规范化、版本历史、快照历史与恢复能力，统一持久化到
app_settings。 lib/admin_sidebar_menu.php- 默认侧栏菜单新增独立一级分组「安全中心」，并补齐 10+ 二级入口，分别跳转到验证码中心各核心域锚点，优先级高于普通配置菜单。
- 文档同步：
README.md新增“安全中心 / 验证码体系（v1.0.218）”说明，并把/admin/captcha_center.php纳入后台能力总览与路由矩阵。- 校验：
php -l admin/captcha_center.php：通过。php -l lib/captcha_center.php：通过。php -l lib/admin_sidebar_menu.php：通过。
v1.0.217 (2026-03-06 16:40:45)
后台大文档预览改为精简默认渲染
- 该小节更新时间：2026-03-06 16:40:45
- 问题：
- 后台
admin/site.php的“渲染预览 / 更新日志预览 / README 快照预览”会在页面打开时直接渲染整份 Markdown，内容一长就会让后台首屏和滚动明显变卡。 - 超长 CHANGELOG / README 在后台只为了“看一眼预览”也要一次性生成完整 HTML，代价过高。
- 修复：
admin/site.php- 为站点声明、更新日志、README 快照新增“精简预览默认展示 + 完整预览按需展开”模式，初始只渲染截断版 HTML，完整内容仅在点击“展开完整预览”时请求生成。
- 预览容器新增
max-height、overflow、content-visibility、contain-intrinsic-size、scrollbar-gutter与状态栏，降低大文档加载与滚动开销。 - README 快照预览与站点设置预览统一为相同的交互模式，避免不同预览区表现不一致。
api/markdown-preview.php- 管理员手动展开完整预览时，Markdown 长度上限从 40000 提高到 90000，兼容大型 CHANGELOG / README 的按需渲染。
- 校验：
php -l admin/site.php：通过。php -l api/markdown-preview.php：通过。./scripts/admin_smoke_check.sh：通过。
v1.0.216 (2026-03-06 16:17:32)
锁定顶栏下的弹窗分层与滚动闪动修复
- 该小节更新时间：2026-03-06 16:17:32
- 问题：
- 锁定顶栏后，节点选择器和“原创系统声明 / 版本说明”弹窗仍有显示异常，弹窗顶部与顶栏边界不干净。
- 大弹窗内部滚动时，顶部固定栏与遮罩层的模糊叠加会带来闪动感。
- 修复：
assets/main.css- 锁定态下的
.modal-overlay、.version-modal改为从--topbar-fixed-offset下方直接开始布局，不再用“全屏 + 大顶部内边距”模式，节点选择器和版本说明弹窗会整体落在长条顶栏下方。 - 为
.node-list-wrap、.node-modal-side-panel、.version-modal-card、.announcement-center-list/detail、.changelog-center-list/detail补齐scrollbar-gutter、overscroll-behavior与移动滚动稳定项，降低弹窗滚动时的抖动和宽度跳变。 - 弹窗打开时关闭固定顶栏与全屏遮罩的
backdrop-filter，减少滚动中的重绘闪动。 - 全站资源版本升级：
main.css?v=20260306-site-polish-v96- 校验：
php -l index.php：通过。php -l quick.php：通过。php -l about.php：通过。./scripts/admin_smoke_check.sh：通过。
v1.0.215 (2026-03-06 15:51:09)
锁定顶栏下的弹窗安全区与可视高度修复
- 该小节更新时间：2026-03-06 15:51:09
- 问题：
- 开启“锁定顶栏”后，公告中心、版本说明、更新日志、节点选择器等固定弹窗仍按普通页面居中，首屏会被长条顶栏压住。
- 移动端和桌面端都存在标题、关闭按钮或正文起始区域贴到顶栏下方的问题。
- 修复：
assets/main.css- 为
.modal-overlay、.version-modal补充body.topbar-lock-active安全区规则，锁定后自动按--topbar-fixed-offset下移容器顶部内边距。 - 为
.version-modal-card、.changelog-modal-card、.announcement-center-card、.node-modal-content重新计算锁定态最大高度，避免模态内容顶到固定顶栏。 - 单独覆盖
#changelogModal、#announcementCenterModal这类自定义padding的大弹窗，并补齐移动端高度规则，保证首页、简洁页和关于页视觉一致。 index.php- 节点选择器浮动布局改为按弹窗可视区坐标计算默认位置、拖拽边界和缩放边界，锁定顶栏后不会再把节点弹窗吸到长条顶栏下方。
- 节点选择器位置缓存键升级为
accel_node_selector_layout_v3，旧的浮窗位置会自动失效一次，避免旧坐标与新安全区混用。 - 全站资源版本升级：
main.css?v=20260306-site-polish-v95- 校验：
php -l index.php：通过。php -l quick.php：通过。php -l about.php：通过。./scripts/admin_smoke_check.sh：通过。
v1.0.213 (2026-03-06 13:47:09)
顶栏锁定改回示例图长条固定栏
- 该小节更新时间：2026-03-06 13:47:09
- 问题：
- 当前锁定后的顶栏仍是“居中限宽条”，和示例图这种整条横向固定栏不一致。
- 锁定后的视觉变化不够大，无法清晰体现“已经锁定顶栏”。
- 修复：
assets/main.css- 将
.topbar--fixed从居中限宽改为左右撑开的长条fixed顶栏。 - PC 使用视口两侧小边距固定，移动端进一步缩小边距，整体效果与示例图一致。
- 保留现有
topbar-fixed-spacer占位链路，所以仍不会遮挡正文内容。 - 全站资源版本升级：
global-button-tip.js?v=20260306-global-tip-v23main.css?v=20260306-site-polish-v92- 校验：
node --check assets/global-button-tip.js：通过。node --check assets/dynamic-island.js：通过。php -l index.php：通过。php -l quick.php：通过。php -l about.php：通过。php -l admin/topbar_manage.php：通过。php -l api/topbar-config.php：通过。
v1.0.212 (2026-03-06 13:38:03)
顶栏锁定长条恢复与全局按钮暗色收口
- 该小节更新时间：2026-03-06 13:38:03
- 问题：
- 顶栏锁定后仍然没有回到用户要的“长条固定”形态，点击反馈不明显。
- 向下滑动再回到顶部时，正文仍有被顶栏遮挡的风险。
- 深色模式下顶栏按钮、图标、菜单按钮和卡片层次不统一，部分图标有偏移感。
- 修复：
assets/global-button-tip.js- 重新接入
topbar-fixed-spacer，锁定态按实际顶栏高度同步占位，正文不再被固定顶栏压住。 - 新增
ResizeObserver、visualViewport和窗口 resize 同步，顶栏在移动端展开/收起、尺寸变化后会重新计算偏移。 - 锁定状态同步写入
data-topbar-fixed、body.topbar-lock-active和按钮状态类，保证点击后立即有视觉反馈。 assets/main.css- 在文件末尾新增顶栏最终覆盖层，恢复锁定后的长条固定形态，并统一 PC / 移动端固定宽度、圆角和阴影。
- 统一顶栏锁定、深色模式、设置、灵动岛、公告、菜单、语言切换等按钮样式，修正图标垂直对齐、hover/active 状态和移动端尺寸。
- 为卡片与主要区块补齐
scroll-margin-top、暗色阴影和移动端间距收口，避免锁定顶栏场景下内容贴顶观感异常。 - 全站资源版本升级：
global-button-tip.js?v=20260306-global-tip-v24main.css?v=20260306-site-polish-v93- 校验：
node --check assets/global-button-tip.js：通过。node --check assets/dynamic-island.js：通过。php -l index.php：通过。php -l quick.php：通过。php -l about.php：通过。php -l admin/topbar_manage.php：通过。php -l api/topbar-config.php：通过。
v1.0.211 (2026-03-06 13:16:23)
顶栏锁定反馈修复与按钮独立锚点扩展
- 该小节更新时间：2026-03-06 13:16:23
- 问题：
- 锁定按钮点击后虽然逻辑已切换，但
active状态被平台风格样式覆盖，视觉上像“没有反应”。 - 移动端深色模式下，展开区顶栏按钮没有完整套用暗色样式，存在显示异常。
- 顶栏功能管理虽然已拆分平台，但按钮位置仍然不是“每个按钮单独可配”。
- 修复：
lib/topbar_manage_config.php- 为
desktop / mobile_collapsed / mobile_expanded三套区域新增anchor字段。 - 新增
inherit继承模式：按钮既可以跟随全局位置，也可以单独指定锚点。 admin/topbar_manage.php- 按钮矩阵新增三套独立位置字段：
PC 位置未展开位置展开位置- 每个按钮都可单独指定到：
- PC / 展开区：
语言前 / 语言后 / 组最前 / 组最后 - 移动未展开：
品牌前 / 品牌后 / 公告前 / 菜单前 - 或选择
跟随全局 assets/global-button-tip.js- 移动端未展开区改为多插槽布局，不再共用单一容器。
- 每个按钮按自己的锚点单独放位。
- PC / 移动展开区按按钮自己的锚点计算顺序，不再只吃全局锚点。
assets/main.css- 补齐锁定按钮在 PC / 移动 / 明暗主题 / 三种风格下的高优先级
active样式，修复“点击没反应”的视觉假象。 - 补齐移动端深色模式
soft风格下展开区按钮样式。 - 新增
topbar-collapsed-slot样式，适配移动端多插槽布局。 - 全站资源版本升级：
global-button-tip.js?v=20260306-global-tip-v22main.css?v=20260306-site-polish-v91- 校验：
php -l lib/topbar_manage_config.php：通过。php -l admin/topbar_manage.php：通过。php -l api/topbar-config.php：通过。node --check assets/global-button-tip.js：通过。node --check assets/dynamic-island.js：通过。
v1.0.210 (2026-03-06 12:57:00)
顶栏管理二次扩展与锁定修复
- 该小节更新时间：2026-03-06 12:57:00
- 问题：
- 后台“顶栏功能管理”页面在运行时缺少
dynamic_island_load_config()，保存配置直接报错。 - 顶栏按钮管理粒度不足，PC 与移动端共用一套规则，无法分别控制显示、模式与位置。
- 移动端按钮区仍落在品牌文字前方，且样式不够统一。
- 锁定顶栏对访客场景缺少本地持久化，平台切换后可用性判断也不够严谨。
- 修复：
lib/topbar_manage_config.php- 新增顶栏配置共享模块，统一维护默认值、旧配置迁移、PC/移动端按钮归一化、样式参数归一化。
lib/bootstrap.php- 为
/admin/topbar_manage.php补充灵动岛模块加载，修复后台保存时报Call to undefined function dynamic_island_load_config()。 admin/topbar_manage.php- 后台页面重构为平台分离版。
- 按钮矩阵拆为
PC / 移动未展开 / 移动展开三套独立控制： - 显示开关；
- 图标/文字模式；
- 顺序；
- 共用文案与图标。
- 新增顶栏全局样式与位置设置：
- 移动端未展开位置；
- 移动端展开位置；
- PC 按钮位置；
- PC/移动端按钮风格；
- PC/移动端图标位置；
- PC/移动端按钮间距；
- PC/移动端按钮高度；
- PC/移动端按钮圆角；
- PC/移动端是否允许换行。
api/topbar-config.php- 输出升级为平台分离结构：
settings + buttons + order。 - 保持旧配置兼容读取并自动迁移到新结构。
assets/global-button-tip.js- 前台按钮管理器改为读取
desktop / mobile_collapsed / mobile_expanded三套规则。 - 访客点击锁定后写入
localStorage，修复锁定状态不持久的问题。 - 锁定按钮可用性改为按“当前平台实际可见规则 + 用户权限”共同判断。
- 移动端未展开按钮区域位置改为可配置，默认排到品牌文字后方。
- PC 与移动端分别读取图标位置、样式、间距、高度、圆角等设置。
assets/main.css- 新增顶栏按钮 CSS 变量与平台样式分支。
- 移动端按钮支持
soft / solid / outline三种风格。 - 新增图标后置样式支持。
- 移动端未展开按钮区顺序调整到品牌块之后，并优化暗色模式样式。
- 全站资源版本升级：
global-button-tip.js?v=20260306-global-tip-v21main.css?v=20260306-site-polish-v90- 校验：
php -l lib/topbar_manage_config.php：通过。php -l lib/bootstrap.php：通过。php -l admin/topbar_manage.php：通过。php -l api/topbar-config.php：通过。node --check assets/global-button-tip.js：通过。
v1.0.209 (2026-03-06 11:51:51)
顶栏按钮回退容错与设置收口补丁
- 该小节更新时间：2026-03-06 11:51:51
- 问题：
- 当
/api/topbar-config.php请求异常时，assets/global-button-tip.js会把锁定按钮误判为隐藏/不可点击，导致“点击后没有锁定”。 admin/global_manage.php仍残留“前台固定顶栏按钮开关”，与“全部迁移到顶栏功能管理”目标冲突。- 修复：
assets/global-button-tip.jsshow_fixed_toggle仅在接口显式返回关闭时才隐藏锁定按钮；接口异常或字段缺失时保持默认可用。global_default_fixed / allow_custom / group_control_enabled / user.logged_in改为容错布尔解析，避免因返回值类型差异导致锁定逻辑误判。- 锁定状态持久化分支改为基于容错后的登录态判断，保证访客与登录用户流程稳定。
admin/global_manage.php- 移除残留项
layout.topbar.show_fixed_toggle，顶栏按钮相关设置统一由admin/topbar_manage.php管理。 - 全站资源版本升级：
global-button-tip.js?v=20260306-global-tip-v20（所有 PHP 页面引用同步更新，强制刷新缓存）。- 校验：
node --check assets/global-button-tip.js：通过。php -l admin/global_manage.php：通过。php -l index.php：通过。php -l quick.php：通过。php -l about.php：通过。
v1.0.208 (2026-03-06 11:42:13)
顶栏功能管理统一收口
- 该小节更新时间：2026-03-06 11:42:13
- 目标：
- 顶栏按钮位置与显示规则统一管理，支持后台配置“显示/文字/图标/展开栏与不展开栏”。
- 修复顶栏锁定后遮挡正文、锁定态宽度异常、移动端与 PC 按钮错位。
- 变更：
- 新增后台页面：
admin/topbar_manage.php- 新增“顶栏功能管理”入口页。
- 统一管理
锁定/深色模式/设置/灵动岛按钮： - 显隐开关；
- 显示模式（仅图标 / 仅文字 / 图标+文字）；
- 不展开栏显示；
- 展开栏显示；
- 自定义文字与图标。
- 同步保存顶栏固定策略（默认锁定、允许自定义、用户组管控）。
- 兼容同步旧键：
layout.topbar.show_fixed_toggle。 - 同步灵动岛旧配置：
quick_actions.show_topbar_proxy_toggle。 - 侧边栏菜单：
lib/admin_sidebar_menu.php- 新增二级菜单项：
顶栏功能管理（/admin/topbar_manage.php）。 - 顶栏配置 API：
api/topbar-config.php- 新增
button_manage输出（按钮顺序与完整按钮配置）。 - 合并旧配置与默认值并做合法化归一。
- 前台顶栏逻辑：
assets/global-button-tip.js- 顶栏锁定与常用按钮改为统一“顶栏按钮管理器”。
- 移除旧
mobile-topbar-tools外置迁移逻辑。 - 新增不展开栏容器：
.topbar-collapsed-actions（移动端菜单未展开时使用）。 - 锁定按钮、深色模式按钮、设置按钮、灵动岛按钮统一按后台规则定位。
- 锁定状态改为
.topbar--fixedsticky 固定，避免遮挡正文与宽度拉伸。 - 样式收口：
assets/main.csstopbar--fixed改为 sticky 方案。- 新增
.topbar-collapsed-actions与.topbar-managed-btn样式。 - 新增
data-topbar-display图标/文字显示模式样式。 - 删除旧外置快捷栏样式分支并补齐暗色主题。
- 旧入口迁移：
admin/global_manage.php- 移除原“顶栏固定控制”编辑块，改为跳转“顶栏功能管理”入口。
- 从全局布尔保存列表移除
layout.topbar.*，避免被旧页面覆盖。 admin/dynamic_island.php- 顶部灵动岛按钮显隐设置迁移提示到“顶栏功能管理”。
lib/dynamic_island.php- 保存配置时
di_quick_show_topbar_proxy_toggle改为“仅在字段存在时更新”，兼容迁移后页面。 assets/dynamic-island.js- 顶部灵动岛按钮支持读取后台自定义标签
data-topbar-label。 - 校验：
node --check assets/global-button-tip.js：通过。node --check assets/dynamic-island.js：通过。php -l admin/topbar_manage.php：通过。php -l api/topbar-config.php：通过。php -l admin/global_manage.php：通过。php -l admin/dynamic_island.php：通过。php -l lib/dynamic_island.php：通过。php -l lib/admin_sidebar_menu.php：通过。
v1.0.207 (2026-03-06 11:08:34)
移动端外置快捷栏层级补丁
- 该小节更新时间：2026-03-06 11:08:34
- 问题：
- 锁定顶栏后，外置快捷栏在部分移动端会出现被顶栏覆盖或位置错位。
- 修复：
assets/global-button-tip.js- 将外置快捷栏
.mobile-topbar-tools插入位置改为topbar-fixed-spacer之后。 - 结构顺序固定为
topbar -> spacer -> mobileTools，确保锁定时视觉层级稳定。 - 全站资源版本升级：
global-button-tip.js?v=20260306-global-tip-v18（全页面统一更新）。- 校验：
node --check assets/global-button-tip.js：通过。php -l index.php：通过。php -l quick.php：通过。php -l about.php：通过。
v1.0.206 (2026-03-06 11:03:48)
移动端常用按钮外置与样式美化
- 该小节更新时间：2026-03-06 11:03:48
- 需求：
- 移动端将深色模式、锁定等常用按钮从图一内部区域移到外部。
- 对这些按钮进行统一美化。
- 修复：
assets/global-button-tip.js- 新增移动端按钮外置逻辑：
- 在
max-width: 768px时，将.topbar-settings（包含锁定、语言切换、深色模式、设置）从topbarLinks移到顶栏下方独立容器.mobile-topbar-tools。 - 在桌面端自动将
.topbar-settings放回原位（topbarLinks）。 - 锁定逻辑保持生效：切换锁定时同步顶栏固定态与占位高度。
assets/main.css- 新增
.mobile-topbar-tools容器样式（独立面板、圆角、阴影、磨砂）。 - 新增移动端快捷按钮美化（锁定/深色/设置/灵动岛按钮）：
- 统一高度与圆角；
- 渐变背景、边框与阴影；
- 深色模式适配。
.mobile-topbar-tools:empty自动隐藏，避免空容器占位。- 全站资源版本升级：
global-button-tip.js?v=20260306-global-tip-v17（全页面统一更新）。main.css?v=20260306-site-polish-v88（index.php、quick.php、about.php）。- 校验：
node --check assets/global-button-tip.js：通过。php -l index.php：通过。php -l quick.php：通过。php -l about.php：通过。
v1.0.205 (2026-03-06 10:48:20)
顶栏长条锁定恢复与锁按钮归位
- 该小节更新时间：2026-03-06 10:48:20
- 需求：
- 恢复锁定后的“顶栏长条”样式。
- 重新检查锁定功能并确保生效。
- 锁定按钮放到语言切换左边。
- 修复：
assets/global-button-tip.js- 锁定按钮插入点优先固定为
.topbar-settings .lang-switch左侧。 - 现有按钮在初始化时会自动归位到语言切换左边（防止旧 DOM 位置残留）。
- 恢复
topbar-fixed-spacer占位机制并接入高度同步，锁定后正文不被顶栏遮挡。 - 锁定切换逻辑重新校准：点击后同步切换
topbar--fixed与按钮 active 状态，并保持持久化写入。 assets/main.css.topbar--fixed恢复为长条fixed形态（top/left/right/width全屏宽度）。.topbar-fixed-spacer恢复显示占位，配合脚本计算高度。- 锁定按钮去除自动右推，改为紧贴语言切换左侧并保留统一按钮视觉。
- 移动端锁定按钮顺序回调为
order:0，避免干扰语言切换所在组。 - 全站资源版本升级：
global-button-tip.js?v=20260306-global-tip-v16（全页面统一更新）。main.css?v=20260306-site-polish-v87（index.php、quick.php、about.php）。- 校验：
node --check assets/global-button-tip.js：通过。php -l index.php：通过。php -l quick.php：通过。php -l about.php：通过。
v1.0.204 (2026-03-06 10:11:08)
顶栏锁定点击无效修复与按钮位置回调
- 该小节更新时间：2026-03-06 10:11:08
- 问题：
- 锁定按钮可点击但顶栏状态无明显变化，用户感知为“没有锁定”。
- 锁定按钮位置偏左，不符合顶部按钮区视觉顺序。
- 修复：
assets/main.css.topbar默认态从sticky改为普通流（position: relative），避免默认即固定。.topbar--fixed继续使用sticky，仅在锁定态生效，实现“点击后才固定”。.topbar-lock-btn增加margin-left:auto，按钮自动靠近顶部右侧按钮区。- 移动端对
.topbar-lock-btn重置margin-left:0，避免小屏布局挤压。 - 全站资源版本升级：
global-button-tip.js?v=20260306-global-tip-v15（全页面统一更新）。main.css?v=20260306-site-polish-v86（index.php、quick.php、about.php）。- 校验：
node --check assets/global-button-tip.js：通过。php -l index.php：通过。php -l quick.php：通过。php -l about.php：通过。
v1.0.203 (2026-03-06 10:00:27)
顶栏锁定形态回归（图4样式）与图标按钮统一
- 该小节更新时间：2026-03-06 10:00:27
- 问题：
- 锁定后顶栏仍会遮挡内容，且 PC 场景顶栏出现“拉成长条”。
- 部分图标型按钮（如弹窗关闭）在移动端出现细长/扁平观感。
- 修复：
assets/global-button-tip.js- 锁定逻辑从
position: fixed脱流方案调整为容器内sticky固定，保持与图4一致的原始宽度和位置。 - 移除 fixed 几何同步与占位插入逻辑，避免重复偏移与遮挡。
- 初始化时主动清理历史
topbar-fixed-spacer残留节点，消除旧版本遗留影响。 assets/main.css.topbar--fixed改为sticky锁定态（不再脱离文档流）。.topbar-lock-btn调整为与顶部按钮体系一致的圆角图标尺寸（非扁平细长）。- 移动端为图标按钮统一取消通用
min-height:44px约束： .topbar-lock-btn.topbar-menu-toggle.version-modal-close.announcement-close.sponsor-lightbox-close.about-close-btn- 全站资源版本升级：
global-button-tip.js?v=20260306-global-tip-v14（全页面统一更新）。main.css?v=20260306-site-polish-v85（index.php、quick.php、about.php）。- 校验：
node --check assets/global-button-tip.js：通过。php -l index.php：通过。php -l quick.php：通过。php -l about.php：通过。
v1.0.202 (2026-03-06 09:43:12)
顶栏锁定遮挡与尺寸二次修复
- 该小节更新时间：2026-03-06 09:43:12
- 问题：
- 移动端与 PC 端在“锁定顶栏”后仍出现内容被遮挡。
- PC 端锁定态顶栏被拉宽，不符合原始尺寸。
- 修复：
assets/global-button-tip.js- 锁定前记录顶栏当前真实矩形，固定后按原始
left/width回填，修复 PC 锁定后全宽异常。 - 占位高度改为
顶栏高度 + 原流式 margin-bottom + top 偏移，修复锁定后回顶遮挡正文。 - 固定态几何同步回退到
.wrap容器，避免窗口变化时尺寸漂移。 - 锁定按钮恢复紧凑图标尺寸（去除加宽文字标签）。
assets/main.css.topbar-lock-btn收口为接近原始的小尺寸图标按钮（PC/移动端统一）。.topbar--fixedtop回调为0，配合脚本占位高度避免叠压。- 全站资源版本升级：
global-button-tip.js?v=20260306-global-tip-v13（全页面统一更新）。main.css?v=20260306-site-polish-v84（index.php、quick.php、about.php）。- 校验：
node --check assets/global-button-tip.js：通过。php -l index.php：通过。php -l quick.php：通过。php -l about.php：通过。
v1.0.201 (2026-03-06 09:09:14)
顶栏锁定按钮全端修复与移动端遮挡收口
- 该小节更新时间：2026-03-06 09:09:14
- 问题：
- 移动端开启“锁定顶栏”后，滚动回顶部出现内容被顶栏遮挡，且顶栏宽高观感异常。
- 锁定按钮在 PC 场景存在不稳定显示，部分页面看不到入口。
- 修复：
assets/global-button-tip.js- 锁定按钮插入位置调整为优先顶栏主行（菜单按钮前/链接前），确保 PC 与移动端都可见。
- 新增
topbar-fixed-spacer占位并同步高度，避免固定顶栏覆盖正文。 - 固定状态新增尺寸同步（
left/width）与ResizeObserver+visualViewport监听，修复滚动与视口变化引起的顶栏尺寸错位。 - 锁定按钮文案改为“锁定/已锁定”，补齐
aria-label与状态同步。 assets/main.css- 重做
.topbar-lock-btn样式（胶囊化、亮暗主题一致、交互反馈增强）。 - 调整
.topbar--fixed与移动端order，确保顶栏与按钮在手机端布局稳定。 - 新增
.topbar-fixed-spacer样式定义，配合脚本占位。 - 全站资源版本升级：
global-button-tip.js?v=20260306-global-tip-v12（全页面统一更新）。main.css?v=20260306-site-polish-v83（index.php、quick.php、about.php）。- 校验：
node --check assets/global-button-tip.js：通过。php -l index.php：通过。php -l quick.php：通过。php -l about.php：通过。
v1.0.200 (2026-02-28 23:05:00)
顶栏固定控制失效修复（无插槽页面）
- 该小节更新时间：2026-02-28 23:05:00
- 问题：
- 全局“顶栏默认固定”配置在部分页面始终不生效，尤其是后台页面。
- 根因是
assets/global-button-tip.js要求页面必须存在.topbar-settings或.topbar-links才会初始化固定逻辑。 - 修复：
assets/global-button-tip.js- 顶栏固定初始化改为“无插槽也执行”。
- 插槽缺失时仍会读取
/api/topbar-config.php并应用固定状态。 - 锁定按钮改为“有可用插槽才渲染”，避免旧页面结构缺失时提前退出。
- 全站页面统一升级脚本缓存版本：
global-button-tip.js?v=20260228-global-tip-v11- 校验：
node --check assets/global-button-tip.js：通过。
v1.0.199 (2026-02-28 20:30:24)
用户中心下沉最终热修（内联兜底）
- 该小节更新时间：2026-02-28 20:30:24
- 背景：
- 外链脚本即便已修复，仍可能被代理/CDN/浏览器缓存命中旧版本，导致“内容仍在下面”。
- 修复：
- 在以下页面
<body>开头内联注入“强制回顶”脚本： user/account.phpuser/settings.phpuser/tickets.php- 内联脚本行为：
history.scrollRestoration = 'manual'- 首屏执行
scrollTo(0, 0) pageshow/load事件再次执行scrollTo(0, 0)- 遇到 hash 锚点时不干预
- 同步升级用户中心外链脚本版本：
user-center.js?v=20260228-user-center-ui5- 校验：
php -l user/account.php：通过。php -l user/settings.php：通过。php -l user/tickets.php：通过。
v1.0.198 (2026-02-28 20:23:40)
用户工单 500 与用户中心下沉热修
- 该小节更新时间：2026-02-28 20:23:40
user/tickets.php- 修复分页下拉选项输出调用未定义变量
$h()的致命问题。 - 统一改为
htmlspecialchars(..., ENT_QUOTES, 'UTF-8')输出。 - 解决问题：
- 下拉框中插入 Warning 文本导致 DOM 结构损坏（浏览器提示
<select>自动闭合）。 uncaught-exception触发/user/tickets.php返回 500。assets/user-center.js- 增加
history.scrollRestoration = 'manual'，禁用浏览器自动滚动恢复。 - 增加
pageshow/load双时机回顶，确保进入用户中心页面时内容从顶部开始，不再落在中下部。 - 用户中心资源版本升级：
user/account.php、user/settings.php、user/tickets.phpuser-center.js?v=20260228-user-center-ui4- 校验：
php -l user/tickets.php：通过。php -l assets/user-center.js：通过。php -l user/account.php：通过。php -l user/settings.php：通过。
v1.0.197 (2026-02-28 19:45:56)
用户中心布局错位二次收口（全链路兜底）
- 该小节更新时间：2026-02-28 19:45:56
- 症状：
- 用户中心页面仍出现“顶部大面积空白、核心内容落在中下部”的问题。
- 收口策略：
- 在样式层与脚本层同时做强兜底，避免任何缓存残留或外部样式注入影响用户中心布局。
- 修复：
assets/user-center.cssbody.user-shell .topbar强制为position: sticky !important，并固定left/right/width的非 fixed 布局值。body.user-shell .topbar--fixed显式重写为 sticky 语义，彻底屏蔽误加类名引发的 fixed 错位。assets/user-center.js- 初始化时继续清理
topbar--fixed与内联position/top。 - 新增“异常滚动位置回顶”逻辑：无 hash 且初始滚动超过阈值时，自动滚动到顶部，避免浏览器滚动恢复造成“看起来页面空白”。
- 用户页资源缓存版本统一升级：
user/account.phpuser/settings.phpuser/tickets.phpuser-center.css?v=20260228-user-center-ui9user-center.js?v=20260228-user-center-ui3- 校验：
php -l user/account.php：通过。php -l user/settings.php：通过。php -l user/tickets.php：通过。php -l assets/user-center.css：通过。php -l assets/user-center.js：通过。
v1.0.196 (2026-02-28 19:35:20)
用户中心顶栏错位与异常按钮修复
- 该小节更新时间：2026-02-28 19:35:20
- 根因：
- 全局脚本
assets/global-button-tip.js在用户中心页面也执行了“顶栏锁定按钮”注入与固定顶栏逻辑。 - 用户中心未提供该功能所需布局插槽与样式，导致出现异常深色按钮、顶栏定位异常、页面内容下沉与顶部空白。
- 修复：
assets/global-button-tip.js- 新增
body.user-shell直接跳过顶栏锁定逻辑。 - 顶栏锁定按钮仅在存在
.topbar-settings或.topbar-links插槽时才初始化。 assets/user-center.js- 初始化时强制清理遗留
topbar--fixed、style.position、style.top，恢复用户页标准布局。 - 用户侧页面脚本缓存版本统一升级：
user/login.phpuser/register.phpuser/account.phpuser/settings.phpuser/tickets.phpuser/reset-password.phpuser/forgot-password.phpuser/verify.phpglobal-button-tip.js?v=20260228-global-tip-v10- 验证：
php -l assets/global-button-tip.js：通过。php -l assets/user-center.js：通过。
v1.0.195 (2026-02-28 19:17:53)
用户设置页空白修复（稳定性兜底）
- 该小节更新时间：2026-02-28 19:17:53
- 会话字段读取防御（
lib/auth.php）： admin_name()：仅在$_SESSION['admin_username']为标量时做字符串转换，异常类型回退空字符串。user_id()：增加整型/数字字符串校验，异常类型不再强制(int)转换，回退null。username()：仅在$_SESSION['username']为标量时读取，避免异常 session 结构触发类型转换问题。- 用户设置页数据归一化（
user/settings.php）： userGroupProfile增加默认字段合并（id/name/badge/icon/color），避免异常返回值导致模板访问异常。settings增加完整默认值兜底（语言、主题、默认节点、缓存策略、通知开关、顶栏固定偏好）。- 节点列表新增结构清洗：只保留合法数组节点，过滤空
id，统一为{id,name}。 - 配额统计新增默认值兜底（
used/quota/cache_count/percent），避免配额读取异常时页面块渲染中断。 - 顶栏用户名增加展示回退：当用户名为空时显示“用户”，避免空值造成显示异常。
- 兼容目标：
- 即使 session 或配置中出现异常结构，
/user/settings.php仍能完整渲染主内容，不再出现右侧空白页。 - 验证：
php -l lib/auth.php：通过。php -l user/settings.php：通过。
v1.0.194 (2026-02-28 16:42:30)
简洁下载页专项修复与后台专属配置中心
- 该小节更新时间：2026-02-28 16:42:30
- 评论区加载链路修复（
quick.php+assets/quick-page.js）： - 简洁页运行时配置新增透传：评论超时、评论初始化模式、评论优先策略等通过
data-*注入前端。 - 评论初始化默认改为
immediate，并支持配置idle；修复“评论初始化被推迟 + 自动测速抢占”的优先级冲突。 - 自动测速支持“等待评论首屏请求完成后再启动”，降低评论区长期停留“正在加载评论...”的概率。
- 评论 API 请求增强：
- 新增
Accept: application/json请求头。 - 新增非纯净响应容错（自动尝试从响应体中提取 JSON 主体）。
- 保留超时与错误兜底提示，新增“评论接口响应异常”提示文案。
- 测速状态统一文案（
assets/quick-page.js）： - 批量测速期间，节点状态与延迟标签统一显示“测速中”。
- 单节点测速按钮执行态文案统一为“测速中”，消除“测速中...”与主状态文案不一致。
- 批量测速按钮文案统一为“测速中”（进度改为
title提示），收敛“测速 x/y”与“不可用”混合状态造成的误读。 - 节点分组可展开/收起（
assets/quick-page.js+assets/quick-page.css）： - 分组标题改为可点击切换，支持
aria-expanded与折叠态视觉反馈。 - 新增默认折叠分组配置（支持
fast/stable/slow/pending/down组合）。 - 修复收起不生效：补充
.quick-node-cards[hidden] { display:none !important; }，避免被网格样式覆盖导致“看起来无法折叠”。 - 增强点击绑定：新增分组折叠事件委托，兼容不同 DOM 结构，避免点击无响应。
- 后台专属配置中心上线（
admin/quick_manage.php）： - 新增“简洁下载页配置”页面，提供二级菜单分区：
- 基础策略
- 测速调度
- 分组折叠
- 评论初始化
- 模块显隐
- 导入导出
- 支持 JSON 导出/导入、恢复默认、配置审计留痕。
- 覆盖配置键包括：
quick.runtime.*与layout.quick.show_*。 - 后台菜单入口补齐：
- 默认侧栏模型（
lib/admin_sidebar_menu.php）新增“简洁页专属”一级菜单分组及子入口（总览/测速/评论/模块显隐）。 - 现有后台页面侧栏菜单补充“简洁下载页配置”入口，统一跳转
admin/quick_manage.php。 - 兼容迁移旧菜单配置：若历史布局为“配置中心 -> 简洁页专属”，读取时自动提升为一级“简洁页专属”分组，避免手工重排。
- 缓存版本升级（
quick.php）： quick-page.css升级到v29。quick-page.js升级到v33。- 文档同步（
README.md）： - 增补“简洁下载页配置中心二级菜单与功能映射”细节，按策略分区补齐默认值、范围与运维建议。
- 全站分页“全部显示”能力（前台 + 后台 + API）：
- 分页核心库（
lib/pagination.php）新增统一哨兵值与标签能力： pagination_page_size_all_value()pagination_is_show_all_page_size()pagination_append_show_all_option()pagination_page_size_label()pagination_resolve_public_page_size()与pagination_resolve_admin_page_size()统一为所有分页模块自动追加“全部显示”选项。- 分页查询后端补齐“全部显示”语义（跳过
LIMIT/OFFSET或按全量切片）： lib/db.php（历史记录/最近日志/用户管理/审计日志）lib/comments.php（前台评论/后台评论/举报列表）lib/tickets.php（用户工单/后台工单）lib/announcement.php（公告管理）lib/proxy_service.php（缓存文件管理）lib/status_page.php（异常状态页日志）- API 链路同步：
api/comments.phpapi/admin-comments.php- 页面分页控件统一补齐“全部显示”可选项并适配显示文案（不再显示超大数值）：
- 前台：
index.php、quick.php、user/tickets.php - 后台：
admin/index.php、admin/users.php、admin/downloads.php、admin/cache.php、admin/audit.php、admin/comments.php、admin/tickets.php、admin/announcements.php、admin/site.php、admin/settings_search.php、admin/dynamic_island.php、admin/nodes.php、admin/node_selector.php、admin/upload_policy.php - 非统一分页页：
admin/backup_center.php、admin/status_pages.php、admin/pagination.php（导出历史） - 校验：
node --check assets/quick-page.js通过。php -l quick.php通过。php -l admin/quick_manage.php通过。php -l lib/admin_sidebar_menu.php通过。php -l（分页改造涉及页面）通过。
v1.0.193 (2026-02-28 15:08:12)
简洁下载页交互修复（版本入口误下载 + 评论加载无反馈）
- 该小节更新时间：2026-02-28 15:08:12
- 问题背景：
- 简洁页底部“版本”入口在部分环境中被浏览器识别为文件跳转，点击后出现
README.md下载，影响更新日志查看流程。 - 评论接口在异常响应或长耗时场景下缺少稳定超时兜底，可能出现评论区长期停留“正在加载评论...”且无明确反馈。
- 修复内容（
quick.php）： - 底部版本入口由链接交互改为按钮交互，统一交由前端弹窗逻辑接管，避免浏览器默认导航/下载行为干扰。
- 保留并兼容版本弹窗/更新日志弹窗回退逻辑，确保在不同布局开关组合下仍可正常打开对应弹层。
- 前端资源缓存版本升级：
quick-page.css升级到v27。quick-page.js升级到v28。- 修复内容（
assets/quick-page.js）： - 评论 API 请求新增超时控制（默认
12000ms）与AbortController终止逻辑。 - 新增评论加载看门狗兜底，超时后主动结束 loading 状态并给出可重试提示。
- 新增异常分层提示：
- 超时：
评论加载超时，请稍后重试。 - 非法响应：
评论接口响应异常，请稍后重试。 - 其他错误：
评论加载失败，请稍后重试。 - 验证结果：
node --check assets/quick-page.js通过。php -l quick.php通过。- 文档同步：
- 索引与版本速查新增
v1.0.193摘要，便于与后续v1.0.194专项修复形成连续追踪链路。
v1.0.192 (2026-02-28 14:25:43)
简洁下载页 500 热修（公告模块加载缺失）
- 该小节更新时间：2026-02-28 14:25:43
- 根因：
- 简洁页新增公告中心 bootstrap 数据后，
quick.php调用了announcement_fetch_front_payload()。 - 但
lib/bootstrap.php的公告模块按页面按需加载列表未包含/quick.php，导致未定义函数触发500 / uncaught-exception。 - 修复：
lib/bootstrap.php在公告模块加载条件中补充/quick.php，确保简洁页可正常调用公告函数。- 验证：
php -l lib/bootstrap.php通过。php -l quick.php通过。- 文档同步：
README.md推荐版本更新到v1.0.192。CHANGELOG.md索引与速查范围同步到v1.0.192。
v1.0.191 (2026-02-28 14:19:42)
简洁下载页公告中心与版本弹窗能力恢复
- 该小节更新时间：2026-02-28 14:19:42
- 简洁页前端结构修复（
quick.php）： - 顶部导航补回“公告中心”入口按钮（含未读角标），与主页一致接入
#announcementCenterBtn。 - 底部版本号恢复可点击入口（
site-signature-version），支持打开版本说明弹窗。 - 补齐
versionInfoModal、changelogModal、announcementPortal、announcementCenterModal相关 DOM。 - 补齐
announcementBootstrap、changelogEntriesData数据脚本，并加载assets/announcement.js。 - 简洁页交互脚本修复（
assets/quick-page.js）： - 新增版本号点击打开弹窗、弹窗关闭、
ESC关闭与焦点回退逻辑。 - 新增更新日志中心筛选（全部/仅置顶）、列表切换、详情渲染与骨架加载逻辑。
- 新增弹窗滚动锁状态同步（含公告弹窗并存场景），避免打开弹窗后背景滚动状态异常。
- 后端数据准备补齐（
quick.php）： - 简洁页补齐更新日志条目构建与格式化时间输出（与主页同源配置）。
- 简洁页补齐公告中心前端 bootstrap 数据注入。
- 验证结果：
php -l quick.php通过。node --check assets/quick-page.js通过。- 文档同步：
README.md推荐版本更新到v1.0.191。CHANGELOG.md索引与速查范围同步到v1.0.191。
v1.0.190 (2026-02-28 12:34:32)
其他页面代码全量排查（静态巡检 + 同类风险补丁）
- 该小节更新时间：2026-02-28 12:34:32
- 全量检查执行：
- 对项目
admin/、lib/、api/全部 PHP 文件执行语法巡检（php -l），结果全部通过。 - 继续按“显式空值保存一致性”做同类模式扫描，覆盖配置加载/归一化/保存链路。
- 新增修复（
lib/node_monitor.php）： - 配置加载时保留
announcement_title_prefix的空字符串，不再被if ($raw === '') continue跳过并回填默认。 alert_email_to、alert_webhook_url空字符串同样保留，避免后续读取与提交表现不一致。announcement_title_prefix改为可显式清空；仍保留 40 字符长度约束。- 结果说明：
- 本轮未发现新增语法错误。
- 已把同类“保存后仍是旧默认值”的高风险点从 SEO/状态页扩展收口到节点监控配置链路。
- 文档同步：
README.md推荐版本更新到v1.0.190。CHANGELOG.md索引与速查范围同步到v1.0.190。
v1.0.189 (2026-02-28 12:28:36)
配置保存一致性排查（防止“保存后回弹默认值”）
- 该小节更新时间：2026-02-28 12:28:36
- 全量排查范围：
- 核查配置归一化与保存链路：
seo、status_page、datetime_format、dynamic_island、node_monitor。 - 重点检查“显式空字符串是否被误判为缺失并回填默认值”。
- 本次修复：
lib/seo.php：global.title_template、global.default_description、global.default_keywords改为支持“显式清空后保持为空”。- 归一化策略改为：键存在即尊重提交值（含空字符串），键缺失才回退默认值。
lib/status_page.php：- 内置模板 locale 合并逻辑改为
array_key_exists判定缺失键，不再把空字符串当作缺失键回填默认文案。 - 验证结果：
php -l lib/seo.php通过。php -l lib/status_page.php通过。- 运行时验证：
- SEO 全局文本字段提交空字符串后可保持为空。
- 状态页内置模板 locale 字段提交空字符串后可保持为空。
- 文档同步：
README.md推荐版本更新到v1.0.189，补充本次“保存一致性排查与修复”说明。CHANGELOG.md顶部索引与速查范围同步到v1.0.189。
v1.0.188 (2026-02-28 12:21:17)
SEO 语言与地域关键词保存逻辑修复（支持清空）
- 该小节更新时间：2026-02-28 12:21:17
- 后台 SEO 配置修复（
lib/seo.php）： - 新增
seo_normalize_optional_text()，用于可空文本字段的规范化（保留空值，不回填默认值）。 i18n区段改为“键存在时尊重提交值（含空字符串）”，仅在键缺失时回退到默认配置。- 修复
中文/英文 Title 后缀、关键词、地域关键词、描述覆盖在后台清空后保存仍被还原为默认值的问题。 - 验证结果：
php -l lib/seo.php通过。- 运行时验证：
i18n.zh-CN.title_suffix提交空字符串后可稳定保存为空；未提交该键时仍保持默认值回退逻辑。 - 文档同步：
README.md推荐版本更新到v1.0.188，补充本次 SEO 可空字段修复说明。CHANGELOG.md顶部索引与版本速查同步更新到v1.0.188。
v1.0.187 (2026-02-28 12:11:24)
SQL 初始化基线与文档同步（gh-proxy-app.sql / README / CHANGELOG）
- 该小节更新时间：2026-02-28 12:11:24
- SQL 初始化脚本同步（
sql/gh-proxy-app.sql）： - 新增“补齐当前代码已使用但旧初始化脚本未覆盖的 app_settings 默认键”区段，集中补全当前运行时已依赖的配置键。
- 覆盖范围包含
layout.*、site.*、about.*、mail.*、proxy.*、system_status.*、ticket.*等模块默认键，首次部署即可获得与当前代码一致的配置基线。 - 采用
ON DUPLICATE KEY UPDATE，确保增量执行安全，不覆盖既有业务配置值。 - 文档同步：
README.md：更新推荐版本并补充本次 SQL 初始化基线同步说明。CHANGELOG.md：更新顶部“最后整理时间”、阶段范围、速查计数与索引范围到v1.0.187。
v1.0.186 (2026-02-28 12:01:29)
文档同步整理（README + CHANGELOG）
- 该小节更新时间：2026-02-28 12:01:29
- README 同步（
README.md）： - 后台功能总览与完整路由矩阵补齐：新增
admin/status_pages.php、admin/user_groups.php。 - 目录结构补齐：新增
status-pages/独立状态页目录说明。 - 配置说明补齐：新增
status_page.direct_entry_base与环境变量STATUS_PAGE_DIRECT_ENTRY_BASE文档。 - 常用入口补齐：新增
error.php?code=xxx与status-pages/*.php示例入口。 - 版本推荐更新为最新文档整理版本。
- CHANGELOG 同步（
CHANGELOG.md）： - 顶部“最后整理时间”、阶段版本范围、速查数量与索引范围统一更新到
v1.0.186。 - 速查表新增
v1.0.186摘要，确保 README 与 CHANGELOG 的版本指向一致。
v1.0.185 (2026-02-28 11:58:05)
异常状态码独立入口目录重构（前后台路径同步）
- 该小节更新时间：2026-02-28 11:58:05
- 独立状态页文件迁移（项目根目录 ->
status-pages/）： 403.php、404.php、408.php、429.php、500.php、502.php、503.php统一迁移到status-pages/目录。- 迁移后入口脚本改为
require dirname(__DIR__) . '/lib/bootstrap.php';，确保目录层级变化后仍可正常引导运行时。 - 前后台统一入口配置（
config.php+lib/status_page.php）： - 新增
status_page.direct_entry_base配置项，支持环境变量STATUS_PAGE_DIRECT_ENTRY_BASE，默认值/status-pages。 - 新增
status_page_entry_base_path()与status_page_entry_url()，统一生成状态码独立入口地址，避免页面路径硬编码分散在各处。 - 后台管理页联动更新（
admin/status_pages.php）： - 模板编辑区新增“独立状态页入口目录”展示（读取当前配置值）。
- 新增“预览独立入口”按钮，和
error.php?code=xxx统一并行，便于前台直链验证与部署排查。 - 文档同步：
- 更新
v1.0.140中独立页面路径描述，由项目根目录路径统一改为status-pages/*.php。
v1.0.184 (2026-02-28 02:06:00)
首页声明弹窗去重并对齐后台配置
- 该小节更新时间：2026-02-28 02:06:00
- 首页版本声明弹窗（
index.php）： - 移除弹窗内硬编码的重复声明文案、联系方式区块和重复版本行。
- 调整为仅保留单条“当前版本”信息，并沿用后台配置的声明 Markdown 作为正文展示。
- 修复“弹窗里同一段声明出现两份”的问题，前台与后台配置内容保持一致。
v1.0.183 (2026-02-28 01:46:00)
公告中心/更新日志移动端结构再对齐 + 卡片右上角 x/y
- 该小节更新时间：2026-02-28 01:46:00
- 列表计数位置调整（
index.php+assets/announcement.js+ 内联脚本）： - 移除公告中心与更新日志弹窗头部的
x/y徽标，避免与关闭按钮/筛选区争抢空间。 x/y改为渲染在每个列表卡片右上角（示例22/184），公告中心与更新日志统一样式。- 移动端结构统一（
assets/main.css）： - 对公告中心与更新日志在移动端统一强制为“上方横向滑动卡片条 + 下方详情内容”。
- 补充高优先级覆盖，修复更新日志被后续样式回退为左右双栏的问题。
- 卡片标题右侧预留徽标空间，避免标题与
x/y重叠。 - 缓存版本升级：
- 首页样式：
main.css升级到20260228-site-polish-v82。 - 公告脚本：
announcement.js升级到20260228-announcement-v15。
v1.0.182 (2026-02-28 01:26:00)
移动端更新日志样式对齐公告中心 + 双弹窗 x/y 徽标
- 该小节更新时间：2026-02-28 01:26:00
- 更新日志中心（
index.php+assets/main.css）： - 更新日志左栏列表结构改为与公告中心一致：标题区 + 元信息上/下分层（版本/置顶标签 + 时间），移除旧的
changelog-center-meta-row与changelog-center-entry-time专用结构依赖。 - 在移动端追加最终覆盖层，统一更新日志与公告中心卡片宽度、间距、标题换行、时间行换行策略，修复更新日志卡片被异常挤压成窄列的问题。
- 公告中心与更新日志头部计数徽标（
index.php+assets/announcement.js+ 内联脚本）： - 两个弹窗头部新增
当前/总数徽标（示例：11/123），统一放在右上角关闭按钮左侧。 - 公告中心新增动态索引更新逻辑：筛选切换、列表重绘、详情切换后实时刷新
x/y。 - 更新日志新增动态索引更新逻辑：筛选与条目切换后同步刷新
x/y。 - 样式与脚本缓存版本升级：
- 首页样式：
main.css升级到20260228-site-polish-v81。 - 公告脚本：
announcement.js升级到20260228-announcement-v14。
v1.0.181 (2026-02-28 01:08:00)
全页面深色模式收口修复（后台侧栏 + 页面级暗色兜底）
- 该小节更新时间：2026-02-28 01:08:00
- 后台侧栏暗色一致性修复（
assets/admin-dashboard.css）： - 补齐暗色下菜单默认态与层级项样式，重点覆盖子分组、子菜单项、折叠态激活项的背景与边框。
- 修复暗色主题下侧栏出现“白底菜单块”的问题，统一侧栏暗色表面与悬停/激活态对比。
- 后台页面通用暗色兜底扩展（
assets/admin-dashboard.css）： - 暗色兜底新增
site / about / sponsor页面前缀覆盖，修复站点标识页、关于页、赞助页等内联浅色残留。 - 统一暗色下卡片、面板、表格与说明文本对比，避免出现局部浅色回退。
- 页面增强层暗色补齐（
assets/admin-page-polish.css）： - 新增该增强样式文件完整暗色适配，覆盖仪表盘、节点管理、时间日期格式、状态页等后台页面。
- 修复
admin-page-polish.css后加载导致公共暗色规则被覆盖、局部回退为浅色的问题。 - 资源缓存版本升级：
- 后台壳层资源升级到
admin-polish-v35。 - 页面增强层升级到
admin-page-polish-v2。 - 同步用户中心相关引用版本，确保浏览器绕过旧缓存并立即加载修复。
v1.0.180 (2026-02-28 00:36:00)
全后台页面深色模式强制覆盖收口
- 该小节更新时间：2026-02-28 00:36:00
- 根因与策略：
- 后台多个页面存在页面内联
<style>写死浅色背景（如#fff/#f8fafc），由于加载顺序晚于公共样式，导致公共暗色规则被覆盖。 - 新增“前缀组件 +
!important”暗色兜底层，直接覆盖页面内联浅色规则，确保所有后台页面一致进入暗色视觉。 - 覆盖范围（
assets/admin-dashboard.css）： - 组件前缀：
seo / ug / ann / dl / nodes / audit / cache / mail / account / dtf / sp / di / upload / comments / pager / bc / ss / selector / changelog / users。 - 统一修复项：卡片/面板/表格容器背景、输入控件背景与边框、表格头部与单元格文本对比、说明文字可读性。
- 同步优化：
- 保留并增强顶栏/侧栏/弹层暗色对比，避免出现“暗色主题下局部发白”。
- 后台资源缓存版本统一升级为
admin-polish-v34（CSS + JS 引用），确保所有后台页面立即生效。
v1.0.179 (2026-02-28 00:20:00)
全后台深色模式一致性修复 + SQL 功能键补齐
- 该小节更新时间：2026-02-28 00:20:00
- 深色模式统一修复（
assets/admin-dashboard.css）： - 补齐后台暗色主题对比层，统一处理顶栏、菜单、面板、表格、弹层在暗色下的文本与边框可读性。
- 修复顶栏账号区名称/角色在暗色下偏暗问题，补齐
topbar-user-toggle与topbar-popover的暗色文字与背景。 - 修复状态胶囊与配额条文案暗色对比不足（
topbar-status-pill、topbar-status-quota）。 - 后台菜单与卡片在暗色主题下统一为深色表面，避免出现浅灰块突兀感。
- 全局管理页暗色适配（
admin/global_manage.php）： - 为
gm-group、gm-card、gm-table、gm-*输入控件新增暗色覆盖，修复截图中浅灰统计卡与表格在暗色模式下不协调的问题。 - 保持 PC / 移动端布局不变，仅调整暗色下的表面、边框与文字对比。
- SQL 同步更新（
sql/gh-proxy-app.sql）： - 新增核心
app_settings默认种子，覆盖当前代码已使用的功能键：下载队列、灵动岛、用户组、节点选择器、上传管理、分页监控、后台布局与侧栏菜单、备份中心、系统状态阈值等。 - 补齐
comments_review_bypass_user_ids默认值，避免新库初始化后出现配置缺项。 - 缓存版本升级：
- 后台页面统一升级
admin-dashboard.css/js资源版本为admin-polish-v33，确保修复可立即生效。
v1.0.178 (2026-02-27 23:59:59)
后台顶栏滚动隐藏开关生效修复
- 该小节更新时间：2026-02-27 23:59:59
- 前端行为修复（
assets/admin-dashboard.js）： - 顶栏偏好值解析由“严格
=== true”改为兼容布尔/字符串/数字（true/1/"1"/"true"/"on"/"yes"），避免数据类型差异导致开关被误判为关闭。 - 滚动监听从仅监听
window扩展为监听window + .main-content + .dashboard-body，兼容后台不同页面滚动容器，实现 PC/移动端一致生效。 - 顶栏滚动距离计算统一读取多容器滚动位置，防止“页面在滚动但顶栏状态不变化”。
- 后端容错修复（
api/admin-toolbar.php）： fetch_dashboard_stats/sidebar_quota_summary改为独立容错，统计异常时仍返回preferences，确保顶栏开关不被统计报错连带失效。- 缓存版本升级：
- 后台页面统一将
admin-dashboard.js?v=20260227-admin-polish-v31升级到v32，确保浏览器立即加载修复脚本。
v1.0.177 (2026-02-27 23:59:30)
用户管理页第三阶段增强（批量导入 + 用户联动详情）
- 该小节更新时间：2026-02-27 23:59:30
- 批量导入用户（
admin/users.php）： - 新增“批量导入用户（CSV / 制表符）”面板，支持直接粘贴多行数据导入。
- 支持字段顺序：
username,email,password,role,is_active,group_id,avatar_url，并兼容首行表头自动识别、空行自动忽略。 role支持user/admin；is_active支持1/0/启用/禁用等常见表达。- 导入完成后返回成功/失败/警告统计，并展示部分示例错误信息，便于快速修正后重试。
- 导入链路接入管理员审计（单用户创建留痕 + 批量导入汇总留痕）。
- 用户联动详情（
admin/users.php）： - 每行用户新增“联动详情（评论/工单/加速）”折叠卡片，聚合展示三类数据：
- 评论：总数、待审数、最近时间、最近评论摘要；
- 工单：总数、未关闭数、最近时间、最近工单摘要；
- 加速记录：总数、下载次数、最近时间、最近记录摘要。
- 每个子卡片提供快速跳转入口（评论页/工单页/下载页），便于管理员继续深挖处理。
- PC + 移动端适配（
admin/users.php）： - 导入面板、联动详情卡片在窄屏下自动切换为单列布局，避免内容挤压与横向溢出。
- 文本摘要统一做截断压缩，保障小屏可读性与表格稳定性。
v1.0.176 (2026-02-27 23:58:00)
用户管理页第二阶段增强（统计看板 + 批量邮件 + 审计联动）
- 该小节更新时间：2026-02-27 23:58:00
- 用户统计看板（
admin/users.php）： - 新增顶部统计卡片：系统总用户、启用用户、禁用用户、管理员角色用户、今日新增、可通知邮箱数量。
- 统计基于数据库实时聚合查询，便于后台快速掌握用户状态与运营体量。
- 批量邮件通知（
admin/users.php）： - 新增“批量邮件通知（发送给已勾选用户）”面板，支持邮件主题与正文输入。
- 支持跨页勾选用户后批量入队邮件（复用
enqueue_email），结果反馈包含入队数量、邮箱无效数量、失败数量。 - 批量邮件动作接入管理员审计：记录主题摘要、处理结果与用户 ID 列表。
- 用户操作历史联动（
admin/users.php）： - 用户列表每行新增“操作历史”按钮，直达审计页并自动附带
target_user_id过滤参数。 - 管理员可快速按用户维度回溯关键操作轨迹。
- 移动端与桌面端适配收口（
admin/users.php）： - 统计卡片在窄屏自动切为双列布局。
- 批量邮件面板输入区与按钮在移动端提升触达尺寸，避免拥挤与误触。
v1.0.175 (2026-02-27 23:35:00)
用户管理页第一阶段增强（批量动作 + 用户组联动 + JSON 导出）
- 该小节更新时间：2026-02-27 23:35:00
- 用户组联动增强（
admin/users.php）： - 新增行内“用户组修改”表单：每个用户可直接切换目标用户组并保存，当前组信息保留彩色标识，点击可跳转到
admin/user_groups.php。 - 创建用户表单新增“初始用户组”选择项，创建后自动执行分组绑定（失败时明确提示）。
- 新增批量用户组设置：支持跨页勾选后统一分配用户组，结果反馈包含“已更新/未变化”数量。
- 批量动作增强（
admin/users.php）： - 批量工具栏新增：批量启用、批量禁用、批量设置用户组、批量重置密码、导出所选 CSV、导出所选 JSON。
- 批量重置密码支持为每位用户生成强随机临时密码并尝试入队邮件通知，返回成功/失败/邮件入队统计。
- 导出能力增强（
admin/users.php）： - 新增 JSON 导出格式：支持“当前页/全部筛选”与“所选用户”两类导出，保留用户组信息字段。
- 原有 CSV 导出流程保留并与 JSON 并行。
- 审计日志补强（
admin/users.php）： - 角色、启用状态、用户组变更记录前后值。
- 批量删除/启用/禁用/分组/重置密码/导出动作新增聚合审计，包含
count、ids与目标动作参数。 - 用户组配置缓存刷新（
lib/user_groups.php）： user_groups_config()新增可选强制刷新参数，用户管理页写入分组绑定后可立即读取新配置，避免同请求内展示旧分组。- PC + 移动端适配收口（
admin/users.php内联样式）： - 批量工具栏控件在窄屏下改为高触达按钮与自适应换行布局。
- 行内用户组编辑表单在移动端自动纵向排列，避免挤压与溢出。
v1.0.174 (2026-02-27 22:45:00)
评论管理页侧栏折叠菜单修复（统一全局折叠行为）
- 该小节更新时间：2026-02-27 22:45:00
- 问题现象（
admin/comments.php）： - 点击“折叠菜单”后仅折叠了菜单列表高度，侧栏整体宽度未收起，出现明显空白区，交互与其他后台页面不一致。
- 修复内容：
- 评论管理页局部折叠逻辑改为复用全局侧栏折叠态（
body.sidebar-collapsed），与顶栏菜单按钮保持统一行为。 - 折叠菜单状态本地存储键统一对齐全局：
admin_sidebar_collapsed。 - 新增 body class 监听，同步“折叠菜单/展开菜单”按钮文案与
aria-expanded，避免多入口切换时状态错乱。 - 移除原“局部菜单折叠高度限制”样式逻辑，避免出现“按钮显示展开但侧栏不收起”的错误视觉。
v1.0.173 (2026-02-27 22:18:00)
评论系统第三阶段策略增强（标题/举报控制 + 前后端联动）
- 该小节更新时间：2026-02-27 22:18:00
- 后台控制项新增（
lib/comments.php+admin/comments.php）： - 评论策略新增可视化配置：
section_title（前台评论区标题）allow_report（举报开关）report_requires_login（举报是否要求登录）report_reasons（举报原因列表，支持后台维护）- 评论管理页“评论策略配置”新增对应输入项与摘要展示，支持保存/回显。
- 后端策略执行增强（
lib/comments.php）： comment_report()增加举报策略校验：- 举报关闭时返回
report-disabled - 配置“举报需登录”时，游客举报返回
login-required - 公共策略下发新增
section_title、allow_report、report_requires_login、report_reasons，前台可直接读取生效。 - 前台联动（
index.php+quick.php+assets/quick-page.js）： - 首页评论区标题改为后台动态下发。
- 首页举报弹窗原因改为后台动态列表，并按策略自动限制：
- 举报关闭时不展示举报按钮
- 举报需登录时，游客显示禁用态“登录后举报”
- 简洁页评论区标题同步后台动态配置。
- SQL 启动配置补齐（
sql/gh-proxy-app.sql）： - 新增默认设置键：
comments_section_titlecomments_allow_reportcomments_report_requires_logincomments_report_reasons- 资源版本升级（防缓存）：
quick-page.js：20260227-quick-page-v25->v26
v1.0.172 (2026-02-27 21:38:00)
评论系统策略扩展（后台控制 + 前台折叠/加载模式 + 自适应收口）
- 该小节更新时间：2026-02-27 21:38:00
- 后台控制增强（
lib/comments.php+admin/comments.php）： - 评论策略新增可配置项：
daily_limit_vip（VIP 用户组每日发言上限，0表示不限制）reply_collapse_threshold（单条评论回复折叠阈值）load_mode（load_more按钮加载 /scroll滚动自动加载）- 评论管理页“评论策略配置”新增对应表单项与摘要展示，支持实时保存与回显。
- 后端策略执行增强（
lib/comments.php）： - 评论创建流程新增 VIP 用户组每日限额判定（用户组 ID 含
vip时走daily_limit_vip）。 - 公共策略下发新增
reply_collapse_threshold与load_mode，前台可直接读取并生效。 - 前台交互增强（
index.php+assets/quick-page.js）： - 首页与简洁页新增“回复折叠/展开”交互：
- 回复数超过阈值时默认折叠
- 支持“查看更多 X 条回复 / 收起回复（共 N 条）”
- 评论列表加载模式支持后台配置：
load_more：保持按钮手动加载scroll：滚动到加载按钮附近时自动请求下一页- 自适应与显示修复（
assets/main.css+assets/quick-page.css）： - 评论内容长文本与代码块统一启用强制换行，避免卡片被超长内容撑破。
- 简洁页移动端评论昵称输入高度回调，评论按钮触控尺寸与文本更协调。
- SQL 启动配置补齐（
sql/gh-proxy-app.sql）： - 新增默认设置键：
comments_daily_limit_vipcomments_reply_collapse_thresholdcomments_load_mode- 资源版本升级（防缓存）：
main.css：20260227-site-polish-v79->v80quick-page.css：20260227-quick-page-v25->v26quick-page.js：20260227-quick-page-v24->v25
v1.0.171 (2026-02-27 20:56:27)
评论系统后台控制中心 + 前后端策略联动（第一阶段）
- 该小节更新时间：2026-02-27 20:56:27
- 后台新增（
admin/comments.php+api/admin-comments.php+lib/comments.php）： - 新增“评论策略配置”面板，支持可视化设置并保存：
- 匿名发布开关
- Markdown 渲染开关
- 图片上传开关
- 评论最小/最大字数
- 最大回复层级（0=不限制）
- 每分钟限频
- 每日发布上限（游客/用户/管理员分开）
- 前台默认排序（最新/最热/最早）
- 后台仪表盘接口
dashboard返回settings.controls，并新增set_controls写入动作。 - 后端硬校验接入（
lib/comments.php）： - 评论创建/编辑接入最小字数与最大字数限制。
- 评论创建接入匿名开关校验、回复层级上限校验。
- 评论创建接入限频与每日上限校验（按管理员/用户/游客身份分流）。
- 评论图片上传接入总开关（关闭后直接拒绝上传）。
- 评论内容渲染增加策略分支：关闭 Markdown 时按纯文本渲染（保留换行）。
- 前台评论列表新增
oldest（最早）排序支持。 - 前台联动（
index.php+quick.php+assets/quick-page.js+api/comments.php）： - 评论接口返回
settings.controls，前台根据策略动态调整： - 匿名勾选可用性
- 文本框字数限制与占位文案
- 图片上传可用性（首页）
- 排序按钮状态与默认排序回落
- 首页与简洁页评论排序新增“最早”按钮。
- 前台提交异常提示补齐（字数不足/过长、匿名关闭、频率限制、每日上限、层级超限）。
- SQL 初始化补齐（
sql/gh-proxy-app.sql）： - 新增评论策略相关默认
app_settings键值，首次部署即具备可控策略基线。 - 资源版本升级（防缓存）：
quick-page.js：20260221-quick-page-v23->20260227-quick-page-v24
v1.0.170 (2026-02-27 20:24:38)
全站按钮与表单控件统一升级（PC/移动端 + 深色主题）
- 该小节更新时间：2026-02-27 20:24:38
- 升级范围：
- 前台主页/关于/弹窗入口（
assets/main.css） - 后台管理页面壳层（
assets/admin-dashboard.css） - 认证与安装页面（
assets/auth-pages.css） - 用户中心页面（
assets/user-center.css） - 工单系统页面（
assets/tickets.css） - 简洁下载页（
assets/quick-page.css） - 状态码与状态页（
assets/status-pages.css） - 升级动作：
- 按钮统一圆角、边框、渐变背景、悬停/按下反馈、键盘焦点高亮与禁用态。
- 输入框/下拉/文本域统一边框、阴影和 hover/focus 行为，提升跨页面一致性。
- 复选框/单选框统一
accent-color与交互指针反馈。 - 移动端统一控件触控高度（44px 基线）与表单字号（16px），增强可点按性与可读性。
- 深色主题分别补齐前台/后台/用户中心/工单/简洁页/状态页的控件配色收口。
- 资源版本升级（防缓存）：
main.css：20260227-site-polish-v78->v79admin-dashboard.css：20260227-admin-polish-v30->v31auth-pages.css：20260227-auth-ui-v5->v6user-center.css：20260227-user-center-ui6->ui7tickets.css：20260227-ticket-v7->v8quick-page.css：20260227-quick-page-v24->v25status-pages.css：20260227-status-v4->v5
v1.0.169 (2026-02-27 20:15:50)
历史区“全选” + 评论区“匿名发布”视觉收口（PC/移动端）
- 该小节更新时间：2026-02-27 20:15:50
- 问题现象：
- 历史区“全选”控件出现文本拥挤换行，视觉不稳定。
- 评论区“匿名发布”样式与周边控件不一致，移动端观感偏散。
- 修复动作（
assets/main.css）： history-check-all升级为稳定胶囊样式（圆角、边框、背景、阴影、hover 反馈），并强制white-space: nowrap避免“全选”被挤成换行。- 历史区复选框尺寸统一并强化触控命中（PC/移动端分别优化）。
comment-anonymous升级为一致化开关胶囊（圆角、边框、背景、字重、hover 反馈），与评论编辑区按钮视觉统一。- 匿名发布复选框尺寸与间距统一，移动端单独适配
align-self/min-height/font-size，避免错位与拥挤。 - 深色主题同步补齐（历史区与评论区两类控件均提供 dark 方案）。
- 资源版本升级（防缓存）：
main.css：20260227-site-polish-v77->v78- 入口页同步：
index.php、about.php、quick.php
v1.0.168 (2026-02-27 20:01:02)
移动端评论区昵称输入高度修复 + 按钮样式收口
- 该小节更新时间：2026-02-27 20:01:02
- 问题现象：
- 手机端评论区“昵称输入框”高度异常偏高，影响可读性与空间利用。
- 评论区按钮与表情按钮在移动端视觉不统一，点击尺寸与间距不够稳定。
- 修复动作（
assets/main.css）： - 修复根因：在移动端将
.comment-editor-top input[type="text"]从flex: 1 1 240px改为固定单行输入流（flex: 0 0 auto+height/min-height: 46px），避免列布局下flex-basis把输入框拉高。 - 昵称输入框统一为紧凑单行样式（圆角、内边距、行高）。
- 评论操作区按钮（
取消回复/上传图片/发布评论）统一移动端样式：圆角、阴影、字号、最小点击高度与换行布局。 - 表情按钮统一移动端尺寸与圆角，提升触控命中率。
- 资源版本升级（防缓存）：
main.css：20260227-site-polish-v76->v77- 入口页同步：
index.php、about.php、quick.php
v1.0.167 (2026-02-27 19:50:09)
更新日志左栏长文本卡片自适应（长内容自动拉高）
- 该小节更新时间：2026-02-27 19:50:09
- 问题现象：
- 部分长标题条目仍会出现卡片高度不足，导致时间被挤到卡片外。
- 修复动作（
assets/main.css）： - 桌面端更新日志左栏由
grid改为稳定flex-column，避免网格行高计算导致的长文案外溢。 - 列表卡片改为
flex: 0 0 auto+height:auto+max-height:none，长内容按实际行数自动拉长卡片。 - 标题与时间区域移除潜在高度限制，保持强制换行与完整可见。
- 时间继续固定在标题下方并常显，不受悬停状态影响。
- 资源版本升级（防缓存）：
main.css：20260227-site-polish-v75->v76- 入口页同步：
index.php、about.php、quick.php
v1.0.166 (2026-02-27 19:41:42)
更新日志左栏时间下移常显 + 长文本与卡片自适应收口
- 该小节更新时间：2026-02-27 19:41:42
- 问题现象：
- 更新日志左栏存在“时间需要悬停才看得清”的观感问题。
- 长标题或长时间文本在卡片内出现挤压、显示不完整。
- 卡片尺寸在不同分辨率下自适应不足。
- 修复动作（
assets/main.css+index.php）： - 新增时间节点专用类
changelog-center-entry-time，并强制时间始终可见（固定display/opacity/visibility/position）。 - 更新日志条目强制纵向流布局：标题区在上、时间区在下，不再受悬停态影响显示顺序。
- 标题与时间统一启用强制换行（
overflow-wrap:anywhere+word-break:break-word），长文本不再被截断。 - 卡片统一
height:auto+ 自适应宽度规则，移动端卡片宽度改为可自适应容器。 - 资源版本升级（防缓存）：
main.css：20260227-site-polish-v74->v75- 入口页同步：
index.php、about.php、quick.php
v1.0.165 (2026-02-27 19:18:09)
更新日志/公告中心列表时间样式统一（时间独立行 + 全量可见）
- 该小节更新时间：2026-02-27 19:18:09
- 问题现象：
- 更新日志与公告中心列表在桌面端仍存在“时间单行省略/仅部分可见”的不一致展示。
- 修复动作（
assets/main.css）： - 桌面端时间行强制可换行展示，取消省略号与隐藏裁切，保持时间稳定落在卡片内。
- 更新日志与公告中心列表时间统一左对齐、独立成行，视觉对齐示例图。
- 资源版本升级（防缓存）：
main.css：20260227-site-polish-v73->v74- 入口页面同步：
index.php、about.php、quick.php
v1.0.164 (2026-02-27 18:58:41)
更新日志左栏时间溢出/悬浮显示根因修复（结构合法化）
- 该小节更新时间：2026-02-27 18:58:41
- 问题根因（
index.php）： - 更新日志列表项使用了
button内嵌div的无效结构，浏览器会自动重排 DOM。 - 在条目标题长短不一时，时间节点会被重排到卡片外，表现为“时间溢出到卡片下方/像悬浮才显示”。
- 修复内容（
index.php）： - 将列表按钮内的
title-row与meta-row由div全部改为span（与公告中心一致的合法嵌套）。 - 保持时间固定渲染逻辑：缺失时显示
--，避免空白条目。
- 验证说明：
- 已执行
php -l index.php，语法通过。 - 已检查渲染模板输出结构，确认不存在
button > div的无效嵌套。
v1.0.163 (2026-02-27 18:51:56)
更新日志左栏时间显示最终收口（独立行 + 常显）
- 该小节更新时间：2026-02-27 18:51:56
- 更新日志（
assets/main.css+index.php）： - 左栏元信息行改为
changelog-center-meta-row专用纵向结构，时间固定独立一行展示。 - 时间样式强制常显：固定
display/opacity/visibility/position，不再受任何悬停态影响。 - 时间文本统一左对齐并启用省略处理，修复居中/错位观感。
- 列表渲染在时间缺失时固定显示
--，避免条目出现“空白时间行”。
- 防缓存版本升级：
main.css：20260227-site-polish-v71 -> v72- 入口页同步：
index.php、about.php、quick.php
v1.0.162 (2026-02-27 18:42:37)
公告中心/更新日志列表元信息排布修正（时间常显）
- 该小节更新时间：2026-02-27 18:42:37
- 公告中心（
assets/announcement.js+assets/main.css）： - 列表元信息改为两行：第一行显示
已读(或红点) + 状态，第二行单独显示时间。 - 补充
announcement-center-meta-top/meta-bottom结构，避免元信息挤压与错位。
- 更新日志（
assets/main.css）： - 时间字段强制常显，固定
display/opacity/visibility，移除对悬停态的显示依赖。 - 时间字段强制
position: static与float: none，避免旧规则残留导致的悬浮显示。 - 列表时间改为始终渲染（缺失时显示
--），避免出现“未显示被误判为悬停显示”的情况。
- 防缓存版本升级：
main.css：20260227-site-polish-v70 -> v71announcement.js：20260227-announcement-v12 -> v13- 入口页同步：
index.php、about.php、quick.php
v1.0.161 (2026-02-27 18:33:56)
公告中心/更新日志列表显示收口（同一行 + 时间常显）
- 该小节更新时间：2026-02-27 18:33:56
- 公告中心（
assets/announcement.js+assets/main.css）： - 左侧列表项将
已读/红点从标题行移动到元信息行。 - 元信息统一为单行：
已读(或红点) + 状态 + 时间，并加强单行防裁切策略。 - 时间改为右侧对齐显示，避免状态标签和时间断裂到两行导致视觉错位。
- 更新日志（
assets/main.css）： - 时间字段强制常显（
display/opacity/visibility固定可见），取消任何悬停态依赖。 - 元信息行收口为稳定单行布局（版本标签与时间对齐），修复间距与错位。
- 防缓存版本升级：
main.css：20260227-site-polish-v69 -> v70announcement.js：20260227-announcement-v11 -> v12- 入口页同步：
index.php、about.php、quick.php
v1.0.160 (2026-02-27 18:22:29)
公告中心左栏列表底部裁切修复（状态/时间完整显示）
- 该小节更新时间：2026-02-27 18:22:29
- 反馈现象：
- 公告中心左栏卡片底部出现状态标签/时间“半截被切掉”的显示异常。
- 更新日志与公告中心复用样式后，公告项在部分布局下被约束过度。
- 修复内容（
assets/main.css）： - 将桌面端收口规则拆分为“更新日志”和“公告中心”两套，避免互相串改。
- 公告中心卡片强制改为
height: auto、overflow: visible，并提升最小高度与间距，保证元信息行完整可见。 - 公告中心元信息行恢复更稳健间距（
margin-top/gap），避免底部标签挤压。 - 更新日志列表保留稳定纵向布局，不影响已修复项。
- 防缓存版本升级（
index.php、about.php、quick.php）： main.css：20260227-site-polish-v68 -> v69
v1.0.159 (2026-02-27 18:15:01)
更新日志中心左栏显示错位修复（条目布局稳定化）
- 该小节更新时间：2026-02-27 18:15:01
- 问题现象：
- 更新日志中心左栏条目出现“标题/时间视觉挤压、错位串行”的异常显示。
- 公告中心与更新日志中心复用了同一套类名，样式覆盖链过长导致条目布局不稳定。
- 修复内容（
assets/main.css）： - 在样式文件末尾新增桌面端强约束收口块（
@media (min-width: 769px)），统一两类弹窗左栏条目规则。 - 列表项固定为稳定纵向流：
display:flex + flex-direction:column，并统一最小高度、内边距与间距。 - 标题行和元信息行强制占满宽度，补齐长文本换行与
min-width: 0兜底，避免内容被挤压或越界。 - 时间字段统一为可换行展示，并对卡片启用
overflow: hidden，消除跨条目视觉串行。
- 防缓存版本升级（
index.php、about.php、quick.php）： main.css：20260227-site-polish-v67 -> v68
v1.0.158 (2026-02-27 17:50:06)
更新日志 + 公告中心弹窗现代化美化（含移动端顶部标签栏）
- 该小节更新时间：2026-02-27 17:50:06
- 视觉统一（
assets/main.css）： - 两个弹窗统一为浅灰容器 + 白色主卡片，圆角统一
12px，阴影统一0 4px 16px rgba(0,0,0,0.08)。 - 标题区重做：标题
20px深灰、统计文案12px浅灰、底部分隔线统一。 - 关闭按钮重做为灰色极简风格，悬浮时颜色加深并旋转
90deg。 - 筛选按钮统一主次态：主按钮蓝底白字，次按钮白底灰边，悬浮浅蓝过渡。
- 列表区与详情区重做（
assets/main.css+index.php）： - 列表卡片恢复可读结构：版本标签 + 标题 + 时间，卡片
8px圆角，悬浮轻上浮。 - 更新日志列表标题行改为“版本标签 + 标题文案”（避免信息重复与拥挤）。
- 详情区信息芯片统一为灰底圆角标签，正文字号/行高提升为更易读的
14px / 1.6。 - 行内代码块统一浅灰底与
4px小圆角，提升内容层次。
- 手机端布局收口（
assets/main.css）： - 更新日志与公告中心统一改为“顶部横向标签栏 + 下方单栏详情”结构。
- 顶部标签栏支持横向滑动，选中项高亮，避免双栏在手机端挤压。
- 详情区保持纵向滚动并禁用横向溢出，长文本与时间字段强制可换行。
- 交互与加载状态（
index.php+assets/announcement.js）： - 更新日志弹窗新增列表加载态与详情骨架屏，切换条目更平滑。
- 公告中心新增加载中状态与详情骨架屏，切换筛选/条目不再出现空白跳变。
- 更新日志筛选与条目切换改为短延时渲染，减少视觉抖动。
- 缓存版本升级（防缓存）：
main.css：20260227-site-polish-v65 -> v66announcement.js：20260227-announcement-v10 -> v11- 入口页已同步：
index.php、about.php、quick.php
- 验证状态：
- 已执行：
php -l index.php about.php quick.php - 已执行：
node --check assets/announcement.js - 检查结果：通过。
v1.0.157 (2026-02-27 17:39:51)
公告中心/更新日志时间格式与后台配置同步修复
- 该小节更新时间：2026-02-27 17:39:51
- 问题现象：
- 前台公告中心与更新日志的时间显示未完全跟随后台“时间日期格式”配置，存在格式不一致。
- 公告接口在部分场景会落到
api/announcement.php页面上下文，导致页面规则匹配偏差。
- 后端修复（
lib/bootstrap.php、lib/announcement.php、api/announcement.php）： - 前台入口补齐
lib/datetime_format.php加载范围（首页、简洁页、关于页、公告接口）。 - 公告中心输出增加
display_time_text（后端按时间格式配置渲染，前端优先使用）。 - 公告接口支持
page/source_page上下文参数，时间模板可按真实来源页面命中规则。 announcement_fetch_front_payload()新增运行时上下文参数，兼容旧调用不受影响。
- 更新日志修复（
index.php、assets/announcement.js）： - 更新日志条目新增
updated_at_formatted字段，并在前端展示逻辑中优先使用。 - 公告中心列表与详情改为优先展示
display_time_text，仅在缺失时回退本地格式化。
- 缓存版本升级（防缓存）：
announcement.js：20260221-announcement-v9 -> 20260227-announcement-v10
- 验证状态：
- 已执行全量 PHP 语法检查：
find . -name '*.php' -print0 | xargs -0 -n 1 php -l - 检查结果：通过，无语法错误。
v1.0.156 (2026-02-27 17:19:16)
公告中心与更新日志中心列表挤压热修（卡片恢复正常显示）
- 该小节更新时间：2026-02-27 17:19:16
- 问题现象：
- 公告中心与更新日志中心左侧列表被挤成单行“胶囊”样式，标题与时间信息可读性明显下降。
- 修复内容（
assets/main.css）： - 为两个列表项补充按钮样式隔离（
appearance/font/line-height归位），避免被全局按钮系统污染。 - 公告中心列表项恢复纵向卡片排版（标题行 + 元信息行），补齐多行文本换行能力。
- 更新日志列表项恢复正常卡片高度和留白，标题行与右侧元信息列避免相互挤压。
- 移除会导致信息裁切的溢出策略，恢复完整可见内容。
- 左栏宽度从窄栏回调到更稳范围（
320~400px），降低长标题截断概率。
- 资源版本升级（防缓存）：
main.css：20260227-site-polish-v64 -> v65- 入口页已同步：
index.php、about.php、quick.php
v1.0.155 (2026-02-27 17:09:36)
公告中心与更新日志中心改回经典样式（按示例图收口）
- 该小节更新时间：2026-02-27 17:09:36
- 调整目标：
- 按示例图将两个弹层改回经典双栏卡片风格，保持原有交互结构，仅做视觉美化和主题适配。
- 结构与渲染（
index.php）： - 更新日志标题恢复为
版本 · 标题显示方式（有版本时自动拼接）。 - 列表右侧元信息恢复为简洁内容：
- 版本仅显示版本号（如
v1.0.155） - 时间仅显示时间（如
2026-02-27 17:09:36） - 版本/时间为空时不强制输出占位文案，避免视觉噪点。
- 样式美化（
assets/main.css）： - 公告中心与更新日志中心弹层卡片改为统一浅色磨砂风格（边框、圆角、阴影、头部线条统一）。
- 过滤按钮、关闭按钮、列表卡片激活态改为更接近示例图的蓝灰风格。
- 更新日志列表恢复“左侧标题、右侧版本+时间”桌面布局；移动端保持纵向堆叠防溢出。
- 亮色/深色主题均补齐对应颜色映射，避免主题切换后突兀。
- 资源版本升级（防缓存）：
main.css：20260227-site-polish-v63 -> v64- 入口页已同步：
index.php、about.php、quick.php
v1.0.154 (2026-02-27 16:54:09)
更新日志中心恢复稳态布局（版本号/时间可见性修复）
- 该小节更新时间：2026-02-27 16:54:09
- 反馈问题：
- 更新日志中心列表在手机端显示异常，版本号和时间出现“看不到/错位”。
- 期望恢复原有阅读顺序，保证版本号与时间始终可见。
- 结构修复（
index.php）： - 列表结构恢复为稳定双层：
标题行+元信息行（版本号、更新时间）。 - 置顶标签回归标题行右侧，不再额外拆行为独立行，减少移动端挤压和错位概率。
- 版本号与更新时间由“可选渲染”改为“强制渲染 + 缺省兜底”：
- 版本号缺失显示
版本 -- - 时间缺失显示
更新时间 -- - 详情区补齐版本芯片：新增
版本：...与更新时间：...双信息，避免仅标题展示导致信息感知不足。
- 样式修复（
assets/main.css）： - 更新日志列表标题行改回
flex双端布局（标题左、置顶标右），恢复视觉秩序。 - 元信息行统一为纵向流（版本在上、时间在下），并固定
position: static，防止外部样式污染。 - 手机端卡片上下留白加宽（
padding: 14px 12px 15px），增强可读性并降低内容挤压。
- 资源版本升级（防缓存）：
main.css：20260227-site-polish-v62 -> v63- 入口页已同步：
index.php、about.php、quick.php
v1.0.153 (2026-02-27 16:41:41)
公告中心 + 更新日志中心移动端美化收口（含叠层错位修复）
- 该小节更新时间：2026-02-27 16:41:41
- 现象与目标：
- 手机端更新日志列表出现“标题/版本/时间叠层、错位”的显示问题。
- 同步将公告中心与更新日志中心视觉样式统一提升，改善卡片层次与可读性。
- 更新日志中心（
assets/main.css）： - 列表项改为强制纵向流（
flex-column），不再依赖网格自动行推断，避免文本叠层。 - 标题行固定整行展示，元信息区（版本/时间）固定为独立纵向信息区。
- 对版本与时间增加
position: static !important和浮动清理，消除外部样式干扰导致的错位。 - 列表项增加
overflow: hidden与更稳健的间距策略，确保小屏幕下内容不串行。
- 公告中心（
assets/main.css）： - 弹层卡片升级：边框、阴影、背景渐变统一增强。
- 头部升级：标题字号自适应、Meta 信息胶囊化、背景层次增强。
- 列表卡片升级：圆角/内边距/间距提升，新增左侧状态高亮条，hover/active 反馈更明显。
- 详情区升级：标题行高、区块留白、正文阅读节奏优化。
- 深色主题补齐：公告中心头部与列表卡片在深色模式下的层次与对比统一。
- 资源版本升级（防缓存）：
main.css：20260227-site-polish-v61 -> v62
v1.0.152 (2026-02-27 16:32:10)
更新日志列表信息区重排（版本号/时间下移到标题下方）
- 该小节更新时间：2026-02-27 16:32:10
- 目标调整（按反馈定点）：
- 更新日志列表项中“版本号 + 更新时间”不再显示在右侧，改为固定显示在标题下方。
- 实现方式：
index.php（更新日志中心列表渲染模板）：- 标题行仅保留标题文本。
- 置顶标签改为独立行（
changelog-center-pin-row）。 - 版本号与时间改为独立信息区（
changelog-center-entry-meta）并置于标题下方。 assets/main.css：- 更新日志列表卡片改为网格纵向布局，确保信息按“标题 → 置顶 → 版本/时间”顺序稳定展示。
- 版本标签和时间文本均改为可换行展示，避免小屏压缩时错位。
- 资源版本升级（防缓存）：
main.css：20260227-site-polish-v60 -> v61
v1.0.151 (2026-02-27 16:27:28)
更新日志中心列表卡片上下加宽（按反馈定点修复）
- 该小节更新时间：2026-02-27 16:27:28
- 用户反馈：
- 手机端更新日志列表仍显拥挤，时间/版本区域视觉上有挤压感。
- 本次调整（
assets/main.css，仅针对.changelog-center-list）： - 卡片上下内边距加宽：
.changelog-center-list .announcement-center-item统一加大为padding: 14px 12px 15px。- 卡片间距加宽：
.changelog-center-list的网格间距由8px进一步提升为12px。- 元信息区域行距加宽：
.announcement-center-meta-row增加上边距与行间距（margin-top: 8px; gap: 6px）。- 时间/版本可读性增强：
- 时间字号与行高提升，版本标签改为自适应内容宽度，避免视觉拥挤。
- 资源版本升级（防缓存）：
main.css：20260227-site-polish-v59 -> v60
v1.0.150 (2026-02-27 16:22:43)
更新日志中心手机端溢出热修复（列表项时间/版本挤出）
- 该小节更新时间：2026-02-27 16:22:43
- 问题现象（来自真机截图）：
- 更新日志中心左侧列表在部分手机视口下，列表项右侧“更新时间”仍出现挤出和布局错位。
- 修复策略（
assets/main.css）： - 将更新日志列表项布局改为“无断点依赖”的纵向结构，仅作用于
.changelog-center-list： - 标题行：单列网格（标题与置顶标签分行）
- 元信息行：单列网格（版本与时间分行）
- 统一为标题/版本/时间增加强制断词与换行：
overflow-wrap:anywhere+word-break:break-word+white-space:normal- 为更新日志列表项补齐宽度约束：
min-width:0; max-width:100%，避免 flex 默认最小宽度导致的撑出。
- 资源版本升级（防缓存）：
main.css：20260227-site-polish-v58 -> v59
v1.0.149 (2026-02-27 16:08:14)
全页面显示溢出修复 + 加载执行速度持续优化
- 该小节更新时间：2026-02-27 16:08:14
- 显示修复（全页面巡检后的重点收口）：
assets/main.css：- 更新日志中心与公告中心的列表/详情面板改为
overflow-y:auto; overflow-x:hidden;，修复手机端横向撑出。 - 详情标题、正文、时间、行内代码统一补齐断词与换行规则，避免长文本/长 token 破坏布局。
- 公告/更新日志移动端列表结构统一为单列网格，状态标签允许换行，时间信息可断行。
- 公告正文中的
pre/table增加宽度与滚动兜底，避免详情区域被横向挤压。 assets/admin-dashboard.css：- 后台核心容器（顶栏、主内容、面板、表格容器、图表容器）统一
min-width:0; max-width:100%。 - 后台媒体元素统一
max-width:100%，收敛跨页面图像/图表溢出风险。 assets/status-pages.css：- 状态页根容器显式禁用横向溢出，并为核心卡片/区块补齐宽度约束。
- 状态页媒体元素统一
max-width:100%。
- 性能优化（本轮新增）：
admin/status_pages.php：admin-dashboard.js改为defer，减少解析阻塞。admin/downloads.php：advanced-chart-kit.js改为defer。- 页面初始化脚本改为
DOMContentLoaded触发，保证图表库就绪且不阻塞主文档解析。
- 性能优化（本轮继续沿用并确认生效）：
lib/bootstrap.php：- 公告、灵动岛、节点选择器模块按路由条件加载，减少非必要请求初始化负担。
- 启动阶段执行
app_setting_prefetch()，降低配置密集页面的重复读取开销。 lib/auth.php：- 新增用户设置会话同步时间戳与同步间隔（默认
180s，最小15s），降低高频 DB 查询。 assets/global-button-tip.js：- 全局提示配置与页面增强配置接入
sessionStorage缓存（TTL180s），网络失败可回退过期缓存。 - 认证页（用户/管理员登录与找回类页面）跳过页面增强配置请求。
- 资源版本升级（防缓存不生效）：
main.css：20260227-site-polish-v57 -> v58admin-dashboard.css：20260227-admin-polish-v29 -> v30admin-dashboard.js：20260223-admin-polish-v26 -> 20260227-admin-polish-v30status-pages.css：20260227-status-v3 -> v4
- 稳定性校验：
- 全量 PHP 语法检查通过：
find . -name '*.php' -print0 | xargs -0 -n 1 php -l- 关键脚本语法检查通过：
node --check assets/global-button-tip.jsnode --check assets/admin-dashboard.js
v1.0.148 (2026-02-27 15:40:33)
用户组权限矩阵批量勾选增强（告别逐项点选）
- 该小节更新时间：2026-02-27 15:40:33
- 背景问题：
- 用户组权限矩阵包含大量复选项，逐个勾选操作成本高、易漏选。
- 本次增强（
admin/user_groups.php）： - 新增全局批量操作：
全部全选、全部清空、全部反选。 - 新增分组批量操作：每个权限分组支持
本组全选、本组清空、本组反选。 - 权限计数改为前端实时刷新：勾选/批量操作后“已启用权限数”即时更新。
- 保持原有保存流程不变：批量调整后仍通过“保存权限矩阵”一次提交。
- 交互与样式补齐：
- 新增矩阵工具栏与分组操作按钮样式，支持桌面与移动端换行布局。
- 小屏下工具栏改为纵向自适应排列，保证可点击性与可读性。
- 稳定性验证：
- 已通过语法检查：
php -l admin/user_groups.php。
v1.0.147 (2026-02-27 15:32:40)
手机端页面贴顶修复（认证体系页面）
- 该小节更新时间：2026-02-27 15:32:40
- 问题定位：
- 认证样式文件
assets/auth-pages.css在@media (max-width: 900px)下将.auth-wrap设置为align-items: flex-start，导致手机端登录/注册等页面整体贴顶显示。
- 修复策略：
- 将手机断点默认行为改为居中：
.auth-wrap在max-width: 900px下恢复align-items: center; justify-content: center;。 - 新增超矮屏兜底：
@media (max-width: 900px) and (max-height: 760px)回退为贴顶，避免横屏或小高度设备内容被挤压不可见。
- 覆盖范围（认证全页面）：
- 用户端：登录、注册、忘记密码、重置密码、邮箱验证。
- 管理端：后台登录、忘记密码、重置密码。
- 安装向导：
setup/index.php（统一升级认证样式版本，保持行为一致）。
- 资源版本升级（防缓存）：
auth-pages.css引用统一升级：20260227-auth-ui-v4 -> 20260227-auth-ui-v5。
- 稳定性验证：
- 已执行全量语法检查：
find . -name '*.php' -print0 | xargs -0 -n 1 php -l，无语法错误。
v1.0.146 (2026-02-27 15:26:08)
用户组能力同步补齐 + 全站按钮统一美化（桌面 + 手机）
- 该小节更新时间：2026-02-27 15:26:08
- 用户组能力同步补齐（跨页面一致）：
about.php顶栏登录态文案补齐用户组标识，和首页index.php、简洁页quick.php统一为用户名/用户组徽章。- 复核并保持已接入页面一致性：
user/account.php、user/settings.php、user/tickets.php顶栏与资料卡片用户组展示持续生效。 - 用户组功能权限链路保持同步：
api/build-link.php、api/history.php、api/comments.php、user/tickets.php按组能力开关进行拦截与 UI 禁用。 - 后台用户列表同步保持：
admin/users.php继续展示用户组列与导出字段（group_id/group_name）。
- 全站按钮统一美化（重点：顶部按钮 + 所有页面按钮）：
- 后台按钮体系强化：
assets/admin-dashboard.css追加 v29 按钮系统，统一.topbar-btn、.topbar-mega-btn、.btn在亮/暗主题下的渐变、边框、阴影、hover/active 反馈。 - 前台按钮体系强化：
assets/main.css追加 v56 按钮系统，覆盖首页/关于/公告入口/通用按钮并适配data-theme="dark"。 - 用户中心与工单页按钮强化：
assets/user-center.css（ui6）、assets/tickets.css（v7）统一主次按钮、顶栏按钮与暗色主题表现。 - 简洁页/认证页/状态页按钮强化：
assets/quick-page.css（v24）、assets/auth-pages.css（v4）、assets/status-pages.css（v3）统一按钮语言与触控尺寸。 - 浮动圆角工具按钮优化：
assets/global-button-tip.js（v8）统一浅色/深色视觉，修复后台深色主题下悬浮按钮“发灰/发硬”的观感问题。
- 样式缓存版本全量升级（强制前端拉新）：
admin-dashboard.css：v28 -> v29main.css：v55 -> v56quick-page.css：v23 -> v24user-center.css：ui5 -> ui6tickets.css：v6 -> v7auth-pages.css：v3 -> v4status-pages.css：v2 -> v3global-button-tip.js：v7 -> v8
- 稳定性验证：
- 已执行全量语法检查：
find . -name '*.php' -print0 | xargs -0 -n 1 php -l（104 个 PHP 文件），结果无语法错误。
v1.0.145 (2026-02-27 14:55:35)
后台侧边栏菜单美化与位置重排（桌面 + 手机）
- 该小节更新时间：2026-02-27 14:55:35
- 侧边栏整体布局升级（
assets/admin-dashboard.css）： - 新增“Sidebar Menu Refresh v28”全局覆盖层，统一侧边栏视觉语言与交互反馈。
- 桌面端侧边栏改为浮层式定位：左侧留白、圆角容器、增强阴影与边框层次。
- 主内容区左边距同步重排，和新侧边栏宽度保持一致，解决菜单与内容区视觉挤压。
- 菜单结构与交互样式统一：
- 一级分组头、二级分组头、菜单项的圆角、边框、背景渐变与状态色统一。
- 菜单项 hover/active 动效、指示点样式与分组展开箭头统一重做，提升导航辨识度。
- 侧边栏搜索框、滚动条、底部配额区同步升级，形成完整菜单视觉闭环。
- 折叠态与移动端位置优化：
- 折叠菜单下的图标点位、间距、激活态样式重新调整，减少偏移感。
- 移动端抽屉宽度、圆角、阴影与位移动画统一优化，打开/收起位置更自然。
- 手机端菜单项高度与内边距同步调整，触控区域更稳定。
- 缓存版本升级（强制前端生效）：
- 后台与用户端相关页面
admin-dashboard.css引用统一从20260227-admin-polish-v27升级到20260227-admin-polish-v28。
- 稳定性说明：
- 本次为样式与资源版本更新，不改动业务逻辑与数据结构。
v1.0.144 (2026-02-27 14:47:11)
后台用户组功能中心上线（含菜单入口）
- 该小节更新时间：2026-02-27 14:47:11
- 新增后台页面：
admin/user_groups.php - 提供用户组基础管理：组 ID/名称/徽章/颜色/排序/默认组/启用状态/有效期与描述。
- 提供成员批量管理：按组批量加入、移出、清空显式绑定成员。
- 提供权限矩阵：按用户组配置功能权限、安全权限、后台管理权限、配额与联动能力。
- 提供自动化规则配置：升级/降级/过期/联动规则集中保存，作为后续执行器配置源。
- 提供用户预览与能力清单映射：查看最近用户的有效分组归属与覆盖能力清单。
- 后台侧边栏菜单新增默认项（
lib/admin_sidebar_menu.php）： - 新增菜单 ID：
user_groups - 名称：
用户组功能 - 路径：
/admin/user_groups.php - 所属分组：
运营 / 用户与反馈
- 权限与菜单治理补齐（
lib/admin_sidebar_menu.php）： user_groups默认最小角色设为admin，避免低权限账号看到该入口。- 菜单导入「替换模式」加入
user_groups必保留列表，防止替换后入口丢失。
- 稳定性验证：
- 已通过语法检查：
php -l admin/user_groups.php。
v1.0.143 (2026-02-27 14:30:30)
全站页面统一美化（所有页面，桌面 + 手机）
- 该小节更新时间：2026-02-27 14:30:30
- 后台全模块统一视觉层（
assets/admin-dashboard.css）： - 新增后台全局美化覆盖层（卡片/面板/图表/表格/输入框/按钮/菜单/消息提示统一风格）。
- 统一主色科技蓝 + 暖黄点缀，卡片阴影层级、悬停上浮反馈、焦点态光圈、表头与行 hover 视觉一致。
- 移动端同步收敛圆角与按钮高度，保证后台所有管理页在手机端一致可读。
- 前台首页/关于/下载主站统一视觉层（
assets/main.css）： - 全局背景、顶部导航、面板卡片、按钮、输入、表格交互统一升级。
- 前台常用模块（历史记录、结果区、评论区、关于卡片、公告项）统一高层次卡片风格与交互反馈。
- 深色主题下同步补齐边框与背景层次，减少视觉割裂。
- 简洁下载页专属强化（
assets/quick-page.css）： - 输入卡、节点卡、结果卡、历史卡、评论卡与关于模块统一样式层与强调条。
- 主按钮/次按钮体系重新统一，节点选中态、历史激活态、输入聚焦态同步优化。
- 手机端按钮触达尺寸与卡片圆角统一，提升可操作性。
- 用户中心与工单全链路美化（
assets/user-center.css+assets/tickets.css）： - 用户中心壳层、面板、按钮、侧边菜单、表单控件统一视觉规范。
- 工单列表、会话消息、统计卡、筛选区、分页区统一卡片样式与主次状态色。
- 交互反馈（hover/focus/active）统一，提升读写效率。
- 异常状态页视觉升级（
assets/status-pages.css）： - 状态 Hero、工具条、动作按钮、订阅/搜索/节点状态卡统一圆角与阴影层次。
- 输入控件、列表项、按钮统一焦点态与交互态，PC 与移动端观感一致。
- 样式资源缓存版本统一升级（强制刷新生效）：
admin-dashboard.css：20260227-admin-polish-v27main.css：20260227-site-polish-v55quick-page.css：20260227-quick-page-v23user-center.css：20260227-user-center-ui5tickets.css：20260227-ticket-v6status-pages.css：20260227-status-v2- 已同步替换所有相关页面引用，覆盖后台页面、前台页面、用户中心、工单页面与异常状态页模板。
- 稳定性验证：
- 已执行全量语法检查：
find . -name '*.php' | xargs php -l，无语法错误。
v1.0.142 (2026-02-27 14:22:30)
后台第 1 批页面统一美化（桌面 + 手机）
- 该小节更新时间：2026-02-27 14:22:30
- 新增后台视觉增强样式层（
assets/admin-page-polish.css）： - 建立后台页面统一视觉变量（主色/暖色/边框/阴影/卡片层级），覆盖卡片、表格、筛选栏、工具条、按钮与输入控件。
- 增加页面级渐变背景、卡片入场动画、悬停上浮反馈，并对
prefers-reduced-motion做兼容降级。 - 补齐移动端断点规则（圆角、间距、按钮高度、内容区留白），确保手机端与桌面端风格一致。
- 仪表盘页面（
admin/index.php）： - 接入
admin-page-polish.css，并设置页面作用域body.admin-dashboard-page。 - 统计卡片、面板、图表容器、日志分页和筛选操作区统一为“高层次卡片 + 渐变强调条”风格。
- 表格表头与行悬停反馈增强，图表工具条视觉统一，提升信息密度下的可读性。
- 节点管理页（
admin/nodes.php）： - 接入
admin-page-polish.css（nodes-page作用域），保留现有业务结构与权限逻辑不变。 - Hero 区、统计卡、监控卡、批量操作按钮、节点表格和分页控件统一风格，主次按钮更清晰。
- 移动端按钮触达面积、卡片圆角与间距同步优化，减少窄屏挤压感。
- 时间日期格式管理页（
admin/datetime_format.php）： - 接入
admin-page-polish.css，设置页面作用域body.admin-dtf-page。 - 模板卡、规则表、预览表、开关与输入表单统一视觉，交互焦点态更明确。
- 高密度表单区域在手机端改为更友好的单列视觉节奏。
- 异常状态码页面管理（
admin/status_pages.php）： - 接入
admin-page-polish.css，设置页面作用域body.admin-status-page。 - 模板统计卡、模板编辑区、规则表、告警与订阅模块统一卡片层次与配色。
- 表格与开关控件增强可读性，移动端交互元素尺寸统一。
- 资源与缓存策略：
- 新增样式资源版本：
/assets/admin-page-polish.css?v=20260227-admin-page-polish-v1。 - 四个页面均在其内联样式之后加载增强样式，保证覆盖生效且不改动业务行为。
v1.0.141 (2026-02-27 14:03:44)
认证与部署页面统一美化（桌面 + 手机）
- 该小节更新时间：2026-02-27 14:03:44
- 认证页样式重构（
assets/auth-pages.css）： - 建立独立视觉变量体系，统一背景、卡片、输入框、按钮、提示框与链接风格，不再依赖后台壳层样式。
- 新增卡片渐变高光、入场动效、字段渐进动画与
prefers-reduced-motion兼容，提升可读性与交互反馈。 - 优化移动端断点与安全区处理，修复窄屏下按钮与表单可点击区域不协调问题，保证 PC/手机一致表现。
- 页面模板统一接入（用户端 + 管理端 + 安装向导）：
- 用户页：
user/login.php、user/register.php、user/forgot-password.php、user/reset-password.php、user/verify.php全量接入新样式与统一品牌头。 - 管理端：
admin/login.php重构为统一认证布局；admin/forgot-password.php、admin/reset-password.php与用户端保持一致交互结构。 - 部署页：
setup/index.php同步接入新版认证/部署视觉体系，表单与按钮样式统一。
- 资源与缓存策略：
- 认证样式版本升级为
auth-pages.css?v=20260227-auth-ui-v3，确保线上缓存环境即时拿到新 UI。 - 认证相关页面移除对
admin-dashboard.css的依赖，避免后台全局按钮样式影响认证页布局。
- 语法与稳定性验证：
- 已通过语法检查：
user/*认证页、admin/login.php、admin/forgot-password.php、admin/reset-password.php、setup/index.php（php -l）。
v1.0.140 (2026-02-27 13:44:39)
异常状态码页面体系上线（前台专属页 + 后台治理 + 运维应急）
- 该小节更新时间：2026-02-27 13:44:39
- 新增状态码渲染引擎（
lib/status_page.php+lib/templates/status_page.php+assets/status-pages.css+error.php）： - 覆盖
403/404/408/429/500/502/503专属页面模板，支持中英双语、明暗主题、响应式布局、自动跳转、二维码、技术信息。 - 新增统一入口
error.php?code=xxx与独立页面status-pages/403.php、status-pages/404.php、status-pages/408.php、status-pages/429.php、status-pages/500.php、status-pages/502.php、status-pages/503.php，支持直接访问与系统内调用。 - 页面能力覆盖推荐资源、搜索框、节点状态、维护信息、错误编号、日志上报开关、恢复通知订阅等场景。
- 后台新增异常状态码管理中心（
admin/status_pages.php+ 菜单接入）： - 模板管理：新增/编辑/复制/删除（系统模板保护）、PC/移动预览、样式与功能开关配置。
- 规则管理：按 URL/IP/用户等级匹配模板，配置跳转策略、埋点维度、多语言文案。
- 运营治理：访问统计（趋势/来源/TOP）、日志查询与归档、报表导出、告警阈值与升级策略、订阅管理。
- 应急能力：全局维护模式、白名单放行、模板紧急替换、快速回滚、节点故障应急标记与切换。
- 运行时链路与数据库扩展：
lib/bootstrap.php接入维护模式拦截与异常处理器注册，运行时异常可落入500体系页面。lib/security.php、lib/auth.php的403场景改为状态页渲染（API 请求保持 JSON 返回）。proxy.php在浏览器场景支持渲染502/503及上游状态码专属页面，下载链路保持直通行为。lib/db.php新增status_page_event_logs、status_page_alerts、status_page_subscriptions表与兼容迁移字段，形成日志/告警/订阅闭环。
- 兼容与验证：
- 关键新增与改动文件语法校验通过（
php -l）。 - 保留系统原有核心能力：前台加速、用户中心、后台治理、API/运维能力未回退。
v1.0.139 (2026-02-27 09:57:24)
全站加载与执行速度三次优化（按页面按需加载 + 配置文件缓存 + 分页 SQL 重构）
- 该小节更新时间：2026-02-27 09:57:24
- Bootstrap 引导层改造（
lib/bootstrap.php）： - 将“所有请求统一加载全部库”调整为“公共核心 + 页面级按需模块”。
- 改为条件加载的模块：
lib/tickets.php：仅admin/user工单页面加载。lib/backup_center.php：仅备份中心与系统状态页加载。lib/admin_sidebar_menu.php：仅菜单管理/检索与对应 API 加载。lib/datetime_format.php：仅时间格式管理页加载。proxy.php请求跳过SEO运行时模块加载与头部计算，降低代理主链路初始化开销。- 新增脚本路径归一化逻辑，兼容不同 SAPI 下的
SCRIPT_NAME / PHP_SELF / SCRIPT_FILENAME差异。
app_settings跨请求缓存落地（lib/comments.php+config.php）：- 在原请求内缓存（
app_setting_runtime_state）基础上新增文件缓存层： - 缓存文件：
cache/app-settings-prefetch-cache.php - 默认 TTL：15 秒（可配置）
- 读取优先顺序：
- 文件缓存命中 -> 直接加载配置键值
- 文件缓存失效 -> 回源 DB 批量预取并回写缓存
- 配置写入（
app_setting_set）后自动失效文件缓存，并在已预取场景回写最新值，降低陈旧读风险。 - 新增配置项：
app_settings_file_cache_enabledapp_settings_file_cache_ttl_seconds- 对应环境变量：
APP_SETTINGS_FILE_CACHE_ENABLED、APP_SETTINGS_FILE_CACHE_TTL_SECONDS
- 分页查询性能优化（
lib/db.php+lib/tickets.php）： - 全部移除
SQL_CALC_FOUND_ROWS + SELECT FOUND_ROWS()。 - 统一改为
COUNT(*) + LIMIT双查询模式，减少优化器负担并提升 MySQL 8 场景稳定性。 - 覆盖范围：
- 用户管理分页
fetch_users() - 管理员审计分页（含正则筛选回退逻辑）
- 用户端工单分页
ticket_fetch_user_list() - 后台工单分页
ticket_fetch_admin_list()
- 节点选择器载荷构建减重复读取（
lib/node_selector.php）： node_selector_build_front_payload()复用同一份已解析settings，避免单请求内重复node_selector_load_settings()。- 减少首页与节点状态接口的冗余配置解析开销。
- 兼容与验证：
- 全量 PHP 语法校验通过：
find . -name '*.php' | xargs php -l。 - 运行态功能保持兼容：仅调整模块加载时机与查询实现，不改业务字段与接口结构。
v1.0.138 (2026-02-23 23:20:00)
后台浮动按钮页面级策略 + 顶栏固定显示兜底修复
- 该小节更新时间：2026-02-23 23:20:00
- 后台新增“右下角两个按钮”独立控制项（
admin/global_manage.php）： - 新增默认策略键：
layout.admin.fab_theme_mode_defaultlayout.admin.fab_back_to_top_mode_default- 新增页面覆盖键：
layout.admin.fab_theme_mode_overrideslayout.admin.fab_back_to_top_mode_overrides- 支持模式：
auto / always / scrolling / idle / hidden - 覆盖规则支持逐行配置（示例：
/admin/system_status.php=scrolling），保存时自动归一化并去重。
- 页面增强配置 API 扩展（
api/layout-enhancement-config.php）： - 保留既有布尔开关返回：
show_theme_toggleshow_back_to_top- 新增模式返回：
theme_button_modeback_to_top_button_mode- 仅后台页面读取覆盖规则；若布尔开关关闭，模式自动降级为
hidden。
- 全站浮动按钮运行时增强（
assets/global-button-tip.js）： - 主题按钮与返回顶部按钮改为独立显隐引擎，支持滚动活跃态与停止态判断。
- 新增模式语义：
auto：兼容旧行为（主题常显，返回顶部按滚动深度显示）scrolling：仅滚动中显示idle：仅停止滚动显示always/hidden：固定显隐- 保持旧配置兼容：未配置模式时按既有行为运行。
- 顶栏“关闭滚动隐藏后仍不固定显示”修复（
assets/admin-dashboard.js+assets/admin-dashboard.css）： - 增加顶栏可见状态收口函数，关闭滚动隐藏时强制恢复可见。
- 增加
data-force-visible样式兜底，规避隐藏类残留导致的顶栏误消失。 - 在关闭滚动隐藏配置时显式保持
sticky固定显示策略。
- 缓存生效保障：
- 后台壳层资源版本统一升级：
20260223-admin-polish-v25->20260223-admin-polish-v26- 全站浮动按钮脚本版本升级：
20260221-global-tip-v6->20260223-global-tip-v7- 覆盖前台/后台/用户中心引用，确保配置即时生效。
v1.0.137 (2026-02-23 22:55:00)
后台顶栏滚动行为可配置 + 移动端按钮文案模式 + 节点管理页报错修复
- 该小节更新时间：2026-02-23 22:55:00
- 新增后台可配置项（
/admin/global_manage.php）： layout.admin.topbar_hide_on_scroll- 控制后台顶栏是否启用“向下滚动隐藏、向上滚动恢复”。
layout.admin.mobile_toolbar_show_text- 控制移动端顶栏按钮显示模式：
- 关闭：符号模式（
M/R/B/N...） - 开启：文案模式（
搜索/设置/说明/账号）
- 顶栏运行时接入（
api/admin-toolbar.php+assets/admin-dashboard.js）： admin-toolbarAPI 新增preferences返回：topbar_hide_on_scrollmobile_toolbar_show_text- 前端新增偏好应用逻辑：
- 顶栏滚动显隐状态机（可开关）
- 移动端按钮文案/符号切换（顶部按钮 + 底部 Dock 同步）
- 关闭弹层/切换焦点时自动恢复顶栏可见，避免交互冲突
- 节点管理页报错修复（
admin/nodes.php）： - 修复 SVG 导出模板中的
<?xml字面量在short_open_tag=On服务器被误解析为 PHP 短标签的问题。 - 改为
\u003C?xml ...输出，保持导出结果一致并兼容不同 PHP 环境。
- 缓存生效保障：
- 后台壳层资源版本统一升级：
20260223-admin-polish-v24->20260223-admin-polish-v25- 覆盖
admin/*.php全部引用，确保线上立刻命中新版本 JS/CSS。
v1.0.136 (2026-02-23 22:35:00)
后台弹层二次热修复 + 移动端按钮说明弹窗
- 该小节更新时间：2026-02-23 22:35:00
- 桌面端弹层“打开即出现且无法关闭”二次修复：
assets/admin-dashboard.js- 新增弹层显隐状态机
setOverlayVisible()，显式同步： hidden属性aria-hidden状态- 内联
display（none/flex） - 初始化阶段执行
closeAllOverlays()，强制收口所有弹层初始状态，避免旧样式缓存干扰。 openOverlay()增加可信事件保护：仅允许isTrusted=true的真实用户事件触发打开，规避脚本/插件误触发。- 弹层集合扩展为统一数组，关闭逻辑统一走状态机，
Esc一次性收口全部弹层。
- 移动端按钮说明能力新增（PC 同步）：
assets/admin-dashboard.js- 顶栏新增“说明”按钮：
megaHelpBtn（?） - 移动端浮动按钮组新增“说明”按钮：
megaDockHelp - 新增
megaHelpModal，内置M/R/B/N/D/S/G/U全部按钮含义说明，支持关闭按钮/遮罩/“我知道了”一键关闭。 assets/admin-dashboard.css- 新增
topbar-help-list样式，保证移动端与桌面端均可读。
- 缓存生效保障：
- 后台全页
admin-dashboard.css/js资源版本统一升级： 20260223-admin-polish-v23->20260223-admin-polish-v24- 覆盖
admin/*.php全部引用，降低桌面端旧缓存命中概率。 - 后台页面增加内联隐藏兜底样式
#admin-overlay-hidden-fallback，即使旧版 CSS 缓存命中也能保证[hidden]弹层默认隐藏。
v1.0.135 (2026-02-23 22:20:00)
后台顶栏弹层热修复（默认显示且无法关闭）
- 该小节更新时间：2026-02-23 22:20:00
- 根因修复：
assets/admin-dashboard.csstopbar弹层类.topbar-overlay-modal使用了display:flex，覆盖浏览器hidden默认隐藏行为，导致弹层初始可见。- 新增
.topbar-overlay-modal[hidden] { display: none !important; }，恢复hidden语义，页面初始不再自动显示弹层。
- 交互稳定性修复：
assets/admin-dashboard.jsopenOverlay改为“互斥打开”：打开当前弹层前会隐藏其它弹层，避免出现“全部设置 + 节点选择器”叠层。closeOverlay改为按“是否仍有打开弹层”决定是否移除body.topbar-overlay-open，避免遮罩状态残留。
- 缓存刷新保障：
- 后台全页
admin-dashboard.css/js资源版本统一升级： 20260223-admin-polish-v22->20260223-admin-polish-v23- 覆盖
admin/*.php引用，确保线上浏览器立即加载修复版本。
v1.0.134 (2026-02-23 21:45:00)
后台动态冒烟回归（半自动）落地
- 该小节更新时间：2026-02-23 21:45:00
- 新增动态冒烟主脚本：
scripts/admin_dynamic_smoke.sh- 支持自动启动 PHP 内置服务（可关闭）。
- 支持后台登录态验证（自动登录，校验登录跳转）。
- 自动扫描后台管理页（排除登录/登出/导出/重置类）并逐页请求。
- 对页面执行关键断言：
- HTTP 状态校验
- 非意外跳转登录页
- viewport 与移动端基础标签
- topbar / sidebar / sidebarBackdrop 等后台壳层结构
- 后台壳层资源存在性
admin-dashboard.js的defer性能约束- 对关键 API 执行登录态断言：
GET /api/admin-toolbar.php（ok=true）GET /api/seo-status.php（ok=true且phase2完整）- 输出两类报告：
- Markdown：便于人工查看
- JSON：便于 CI/CD 或后续自动比对
- 新增 DOM 断言辅助脚本：
scripts/dom_assert.php- 支持
--xpath与--contains两类检查。 - 返回非 0 退出码用于批处理失败判定。
- 可复用于其它页面级回归脚本。
- 健壮性增强（动态冒烟脚本）：
- 请求失败显式报错（不可达/超时不再误判成页面失败）。
- 增加 fatal/SQLSTATE 检测，数据库未就绪时给出明确提示。
- 支持
ADMIN_SMOKE_*环境变量覆盖（端口、账号、启动模式、超时等）。
- 文档补齐：
README.md- 新增“后台动态冒烟（半自动回归）”章节。
- 增加环境变量、执行示例、失败诊断说明。
- 在开发校验命令中加入动态冒烟执行示例。
- 校验：
bash -n scripts/admin_dynamic_smoke.sh通过php -l scripts/dom_assert.php通过
v1.0.133 (2026-02-23 21:10:00)
后台逐页冒烟清单 + UI 细节再收敛 + 全站加载执行速度二次优化
- 该小节更新时间：2026-02-23 21:10:00
- 后台逐页冒烟测试清单（桌面 + 移动）落地：
- 新增
scripts/admin_smoke_check.sh： - 自动扫描
admin/*.php页面结构与关键加载项。 - 输出维度：
viewport、后台壳层资源、顶栏、侧栏遮罩、脚本加载模式。 - 可直接生成 Markdown 报告，便于每次发布前复跑。
- 新增
docs/admin-smoke-checklist.md： - 本轮 29 页扫描结果表。
- 桌面 / 移动
FAIL=0，导出与登出类页面按SKIP标注。 - 新增
docs/admin-smoke-round-20260223.md： - 记录本轮发现项、修复项与后续复测方式。
- UI 细节收敛（移动端与后台治理页）：
assets/admin-dashboard.csstopbar-mobile-dock新增safe-area右下偏移，避免刘海/手势区遮挡。- 移动端
dashboard-body增加底部预留，规避浮动工具条遮挡底部操作区/分页区。 - 顶栏弹层对话框增加
overscroll-behavior与触控滚动优化，减少移动端滚动穿透和抖动。
- 全站加载与执行速度优化（二次）：
- 后台阻塞脚本去同步：
admin/audit.phpadmin/nodes.phpadmin/dynamic_island.phpadmin/downloads.phpadmin/site.php- 以上页面的
admin-dashboard.js全部改为defer。 - 前台首页非关键脚本去同步：
index.php的announcement.js、dynamic-island.js改为defer，降低 HTML 解析阻断。- 后台顶栏状态轮询降载：
assets/admin-dashboard.js- 增加请求并发保护与最小间隔保护。
- 隐藏标签页暂停常规轮询，页面回到可见/聚焦时再强制刷新。
- 减少无效请求与主线程竞争。
- 后台高频配额统计缓存：
lib/proxy_service.phpsidebar_quota_summary新增内存 + 文件双层短 TTL 缓存（默认 15 秒）。- 缓存文件：
cache/sidebar-quota-summary.json。 - 减少后台多页面高频目录扫描成本。
- 后台资源版本统一升级（确保缓存环境即时拿到修复）：
admin/*.php中admin-dashboard.css/js查询参数统一升级为20260223-admin-polish-v22。
- 语法与检查：
php -l通过：lib/proxy_service.phpadmin/audit.phpadmin/nodes.phpadmin/dynamic_island.phpadmin/downloads.phpadmin/site.phpindex.phpnode --check通过：assets/admin-dashboard.js
v1.0.132 (2026-02-23 20:35:00)
SEO 第二阶段：301 重定向管理 + 404 监控 + 抓取异常看板 + 关键词排名追踪
- 该小节更新时间：2026-02-23 20:35:00
- 数据库层（自动建表，升级后即用）：
lib/db.php- 新增
seo_redirect_rules：重定向规则、状态码、启用开关、命中次数、最后命中时间。 - 新增
seo_404_logs：404 聚合日志（路径+方法维度）、命中累计、首末时间、处理状态。 - 新增
seo_crawl_anomalies：爬虫异常聚合（爬虫、路径、状态码、异常原因）与处理状态。 - 新增
seo_keyword_rankings：关键词排名快照（引擎、关键词、排名、日期、结果链接、备注）。
- SEO 核心能力扩展：
lib/seo.php- SEO 配置模型新增
redirects与monitoring两组配置，并接入保存/归一化链路： redirects.enabled/redirects.strict_pathmonitoring.log_404_enabled/monitoring.crawl_anomaly_enabled/monitoring.keyword_tracking_enabledmonitoring.keyword_targets/monitoring.max_dashboard_rows- 新增 301/302 规则解析与同步：
- 支持规则文本格式：
/from => /to、/legacy/* => /docs/{tail}、/a => /b |302 - 保存后自动 upsert 规则并禁用已删除规则，保持命中统计可持续累积。
- 新增运行时重定向与监控：
seo_apply_runtime_redirects(...)：请求进入时按规则即时跳转。seo_register_runtime_monitoring(...)：请求结束时自动聚合 404 与爬虫异常。- 新增治理数据函数：
- 404 / 抓取异常：查询、汇总、标记已处理/恢复。
- 关键词排名：快照写入、最近快照、最新排名汇总、配置关键词对齐展示。
seo_apply_runtime_headers(...)统一接入重定向 + 监控注册，确保“保存 SEO 配置后即时生效”。
- 后台 SEO 页面（可配置模块化）：
admin/seo.phpsave_seo动作接入第二阶段配置保存与 301 规则同步，并记录审计。- 新增第二阶段配置区：
- 301 开关、严格匹配开关
- 404 监控、抓取异常监控、关键词追踪开关
- 看板展示行数配置
- 关键词目标配置（引擎|关键词|URL）
- 301 规则文本治理（支持通配符与状态码）
- 新增运行态面板：
- SEO 第二阶段 KPI（301/404/异常/关键词）
- 301 命中排行表
- 404 监控表（标记已处理/恢复）
- 抓取异常看板（标记已处理/恢复）
- 关键词排名快照录入 + 追踪关键词表 + 最近快照表
- SEO 状态 API 扩展：
api/seo-status.php- 在原有配置与诊断输出基础上新增
phase2： redirects、not_found、crawl_anomalies、keywords四类汇总。- 与后台 SEO 页面展示维度保持一致，便于统一接入外部监控。
- 线上生效方式（无需额外脚本）：
- 进入
admin/seo.php - 点击“保存 SEO 配置”可同时保存第二阶段配置并即时生效
- 点击“仅重新生成 robots/sitemap”只影响文件，不改第二阶段规则
- 语法校验：
php -l lib/seo.php通过php -l admin/seo.php通过php -l api/seo-status.php通过php -l lib/db.php通过
v1.0.131 (2026-02-23 19:18:00)
后台粘性治理工具条 + 全局时间日期格式中心 + 菜单与图表性能补齐
- 该小节更新时间：2026-02-23 19:18:00
- 后台顶栏升级为“滑动置顶不动”治理工具条（前后端通用后台壳）：
assets/admin-dashboard.js- 新增
setupMegaToolbar(...)，基于现有.topbar动态注入四大分区： - 操作区：
菜单、刷新数据、一键备份、节点选择、下载记录 - 状态区：系统状态灯、待办汇总、配额进度、时间筛选（今日/昨日/本周/本月）
- 用户区：头像/用户名/当前角色、账号设置、角色切换、退出登录
- 全局设置区：主题切换、字体大小、全局搜索（菜单/节点/用户/日志）
- 接入
GET /api/admin-toolbar.php实时状态，接入POST /api/admin-switch-role.php角色切换。 - 新增节点选择弹窗（读取
api/admin-node-monitor.php）、全局设置弹窗、角色切换弹层。 - 移动端新增常驻三键浮动入口（搜索/设置/用户），满足“头像、设置、搜索固定可见”。
- 保留旧
topbar-right结构兜底，脚本异常时仍可操作。 assets/admin-dashboard.css- 新增工具条完整样式体系（分区布局、状态徽章、配额条、用户弹层、设置弹层、角色底部弹层、移动端浮动入口）。
- 顶栏在桌面端改为标题+工具条双栏网格，移动端自动收敛为图标化模式。
- 设置弹层在移动端自动切为全屏，角色切换切为底部弹层。
admin/*.php- 统一将
admin-dashboard.css/js资源版本提升为20260223-admin-polish-v21，确保浏览器缓存环境可立即加载新顶栏能力。
- 新增“全局时间日期显示格式”后台治理中心：
- 新增
admin/datetime_format.php（管理员页）： - 全局策略：时区模式、时区显示、相对时间、时间戳位数与位置、周起始、星期样式、语言、本地化数字。
- 模板管理：内置模板编辑 + 自定义模板新增（分类、格式符、时区/相对/时间戳策略）。
- 作用域规则：模块/角色/页面/数据类型四层规则配置。
- 权限控制：操作员是否可改、时区白名单、核心模块锁定。
- 专业模式：格式符即时预览（
YYYY/YY/MM/...等 token）。 - 导入导出：JSON 导入、JSON 下载。
- 预览对比：当前配置与默认配置在多场景（全局/节点/工单）并排展示。
- 所有保存/导入/重置动作写入管理员审计。
lib/bootstrap.php- 新增
require_once __DIR__ . '/datetime_format.php';，全系统可直接调用格式化库。
- 后台菜单与治理入口“无遗漏”补齐：
lib/admin_sidebar_menu.php- 默认菜单新增
datetime_manage（/admin/datetime_format.php，标签“时间日期格式”）。 - 管理员最小角色映射补齐
datetime_manage。 - replace 导入核心保留项新增
datetime_manage，避免重建布局后丢失。 admin/global_manage.php- 静态侧栏新增“时间日期格式”入口。
- 新增“全局时间日期格式（新增治理入口）”功能卡与直达按钮。
- 核心菜单保护数组、前端
coreMenuIds、隐藏扩展保留列表同步加入datetime_manage。 admin/*.php- 所有带 SEO 菜单的后台页统一补齐
/admin/datetime_format.php侧栏兜底入口，避免动态菜单接口异常时遗漏。
- 图表渲染性能优化（后台其余图表页）：
assets/advanced-chart-kit.js- 将
visibleIdx.indexOf(idx)的高频 O(n) 查询改为Map定位。 - 将多处
visibleIdx.includes(...)改为Set判定。 - 在大数据窗口下减少热点路径时间复杂度，提升鼠标悬浮/异常标注/断点标注帧率稳定性。
- API 与语法验证：
- 保持并复用新增接口：
api/admin-toolbar.phpapi/admin-switch-role.php- 本次变更后执行：
php -l：lib/bootstrap.php、lib/admin_sidebar_menu.php、lib/datetime_format.php、admin/global_manage.php、admin/datetime_format.php、api/admin-toolbar.php、api/admin-switch-role.php通过。node --check：assets/admin-dashboard.js、assets/advanced-chart-kit.js通过。
v1.0.130 (2026-02-23 18:26:00)
SEO 全链路治理 + 其余图表页能力补齐 + 后台菜单无遗漏补全
- 该小节更新时间：2026-02-23 18:26:00
- SEO 全链路治理落地：
lib/bootstrap.php- 新增
require_once __DIR__ . '/seo.php'，并在运行时统一执行seo_apply_runtime_headers($config)。 - 后台/用户/API 页面按配置输出
X-Robots-Tag，避免误抓取敏感页面。 - 新增
admin/seo.php： - 提供 SEO 独立治理后台（管理员级）：
- 全局 SEO 配置（title 模板、description、keywords、OG/Twitter、自定义 meta）
- 页面级 SEO（
index.php/quick.php/about.php） - 后台/用户/API noindex/nofollow 控制
- 语言与地域 SEO（中英双语关键词与后缀）
- 诊断阈值（title/description/关键词计数规则）
robots.txt/sitemap.xml预览 + 一键重建- 页面评分诊断（首页/简洁页/关于页）
- 保存配置后自动写入
robots.txt/sitemap.xml，并记录审计日志。 - 新增
api/seo-status.php： - 返回 SEO 配置、诊断评分、robots/sitemap 文件状态（后台鉴权）。
index.php/quick.php/about.php- 统一接入
seo_render_head_tags(...)： - 动态
title/description/keywords - canonical、robots
- OG/Twitter Card
- hreflang
- Schema.org JSON-LD
lib/seo.phpseo_sitemap_entries()改为“存在性过滤”：仅将实际存在的页面写入 sitemap，避免提交不存在路由。
- 后台菜单与治理入口无遗漏补齐：
lib/admin_sidebar_menu.php- 默认菜单新增
seo_manage（/admin/seo.php，标签“SEO 设置”）。 - 默认最小角色映射中将
seo_manage设为管理员可见。 admin/global_manage.php- 新增“SEO 设置（新增治理入口）”区块，提供直达 SEO 管理页/API/robots/sitemap 的入口。
- 菜单核心项保护列表新增
seo_manage，确保批量整理/隐藏时不遗漏。 - 后台静态侧栏兜底菜单（
admin/*.php）统一补上/admin/seo.php： - 解决动态菜单接口异常时 SEO 菜单缺失问题。
- 其余图表页能力补齐（非 nodes 页）：
- 新增
assets/advanced-chart-kit.js（通用高级趋势图引擎）： - 多指标叠加、对比模式（昨日/上周同期）
- 悬浮精确提示（时间戳/指标值/节点快照）
- 框选放大 + 滚轮缩放时间轴 + 一键还原
- 点击点位下钻明细
- 快捷时间筛选（1h/6h/24h/7d/30d/全部）+ 自定义起止时间
- 自动刷新（10s/30s/60s）
- 图表类型切换（线/面积/柱）
- 阈值线与超阈值提示
- 异常点自动标注 + 采集断点提示
- 图例显隐与曲线颜色自定义
- 导出 PNG/SVG/PDF + 导出 CSV/JSON
- 快照保存/回看/删除（
localStorage） - 分位模式（Raw/P50/P95/P99）+ 聚合模式（平均/最大/最小）
- 全屏模式
admin/index.php+assets/admin-dashboard.js- 仪表盘趋势图升级为高级交互模式（保留旧绘图兜底）。
- 新增趋势衍生指标：下载率、丢包率（模拟）与节点快照序列，支持双轴可视化。
admin/downloads.php- 下载趋势图升级为高级交互模式（保留旧绘图兜底）。
- 新增
loss_rates、节点快照与 granularity 透传，支持高级图表完整功能。 - 饼图图例支持点击显隐（交互修复与可视化增强）。
assets/admin-dashboard.css- 新增高级图表通用样式（工具栏、图例、tooltip、brush、下钻表格），修复复杂交互下的显示可读性。
- 文档与版本治理：
README.md- 详细补充 SEO 后台/API/前台渲染链路、后台菜单入口、图表增强覆盖范围与新增校验命令。
CHANGELOG.md- 新增
v1.0.130完整变更说明与全版本索引更新。
- 稳定性验证：
php -l：admin/*.php全量通过。php -l：lib/bootstrap.php、lib/seo.php、index.php、quick.php、about.php通过。node --check：assets/advanced-chart-kit.js、assets/admin-dashboard.js通过。
v1.0.129 (2026-02-23 16:18:00)
节点监控图表能力重构 + 显示问题修复
- 该小节更新时间：2026-02-23 16:18:00
- 显示问题修复：
assets/admin-dashboard.css- 修复统一分页在小屏下的布局错位：分页主区改为网格堆叠、页码区支持横向滚动、跳页输入尺寸收敛、统计文案换行策略优化。
- 解决“分页按钮换行后挤压跳页区/统计区”的问题，移动端交互稳定性提升。
- 统一升级后台/用户中心
admin-dashboard.css资源版本为20260223-admin-polish-v19，避免浏览器缓存导致修复不生效。 admin/nodes.php- 修复监控图表 x 轴标签密集重叠：增加底部留白、动态抽样标签、斜向标签排布。
- 修复图表与“节点实时摘要”区块间距不足，视觉分区更清晰。
- 图表能力增强（仅保留可视化与数据交互能力，不做页面联动）：
- 多指标叠加：支持主指标 + 多选叠加指标（含丢包率派生曲线）。
- 对比模式：支持“昨日同期/上周同期”双轨对比曲线。
- 精准悬浮：悬浮显示时间点、各曲线值与节点快照。
- 框选放大：拖拽框选区间缩放，并提供一键还原。
- 点位下钻：点击任意点位展示该时刻指标明细表。
- 时间控制：
- 快捷窗口：
1h/6h/24h/7d/30d - 自定义时间范围（
datetime-local起止） - 自动刷新间隔：
10s/30s/60s/关闭 - 滚轮时间轴缩放（围绕焦点点位放缩）
- 可视化增强：
- 图表类型切换：折线/面积/柱状
- 阈值线 + 超阈值主曲线标红
- 异常点自动标注（突增/骤降/大跳变）
- 图例显隐控制 + 多曲线颜色自定义
- 断点检测与“采集异常”断线标识
- 导出与留存：
- 图表导出：PNG / SVG / PDF（打印流）
- 数据导出：CSV / JSON（按当前可见区间与可见曲线）
- 图表快照：本地保存/加载/删除（
localStorage） - 进阶能力：
- 分位展示：Raw / P50 / P95 / P99（滚动窗口估算）
- 聚合切换：平均值 / 最大值 / 最小值
- 全屏模式：图表容器一键全屏
- 实现说明：
- 所有图表交互均在
admin/nodes.php前端脚本内完成，后端仅继续提供基础时序数据接口（/api/admin-node-monitor.php）。 - 新增控制项与交互均作用于图表自身，不依赖其他页面状态联动，避免耦合扩散。
- 稳定性验证：
php -l admin/nodes.php通过。node --check（提取admin/nodes.php内嵌脚本）通过。
v1.0.128 (2026-02-23 15:21:17)
全站性能优化（前后台页面加载与执行速度）
- 该小节更新时间：2026-02-23 15:21:17
- 后端核心性能优化：
lib/comments.php- 重构
app_setting_get()：新增请求内运行时缓存（app_setting_runtime_state），优先内存命中，避免同一请求内重复查询app_settings。 - 新增
app_setting_prefetch()：首次读取时批量加载全部配置键值，首页/简洁页/关于页与后台配置密集页面显著减少 SQL 次数。 app_setting_set()写入后同步更新运行时缓存，保证“读写同请求一致性”，并避免写后重复回库读取。lib/db.php- 新增数据库初始化缓存机制：
db_init_should_run()+db_init_mark_done()+init_database_cached()。 lib/bootstrap.php从每请求init_database()改为init_database_cached()，把高成本建表/补列/索引校验从“每次请求”降为“按 DB 指纹 + 文件指纹 + TTL（6 小时）”触发。- 优化
enrich_history_rows_with_metrics()：由target_url IN (...)改为url_hash IN (...)聚合，优先命中idx_access_logs_hash，降低历史记录加载时的大表扫描风险；保留旧库兼容回退逻辑。 lib/proxy_service.php- 新增节点与模板运行时缓存：
proxy_runtime_cache()，减少同请求内重复解析/重复查库。 load_accel_nodes_from_settings()、load_node_templates_from_settings()优先复用app_setting_get缓存通道。save_accel_nodes()、save_node_templates_to_settings()写入后清理对应运行时缓存，避免脏读。
- 前端加载与执行优化：
- 资源加载策略：
index.php、quick.php、about.php增加主样式preload，加快首屏样式可用时间。about.php增加qnyoss.rjasj.com的preconnect + dns-prefetch，优化外链图片建连时间。- 脚本执行策略：
- 全站
global-button-tip.js改为defer加载（覆盖前台/后台/用户中心/认证页）。 - 对无内联依赖冲突的后台与用户中心页面，将
admin-dashboard.js/user-center.js/tickets.js改为defer，降低 HTML 解析阻塞。 quick.php的quick-page.js改为defer，确保页面结构先完成解析再执行交互脚本。- 非关键逻辑延后执行：
assets/global-button-tip.js首段提示条初始化改为onReady + requestIdleCallback（含降级setTimeout），降低首屏主线程争用。assets/quick-page.js将评论模块初始化延后至空闲时段执行，优先保障节点列表与核心下载流程可交互。index.php首屏初始化中，将refreshHistory()、loadComments(true)调整为空闲调度，减少首次渲染期任务拥挤。- 图像与首屏细节：
index.php、quick.php、about.php顶部品牌 Logo 增加decoding="async"（并设首屏优先级），降低图片解码阻塞。about.php大图预览位增加loading="lazy"与decoding="async"。
- 可维护性与稳态保障：
- 数据库初始化缓存采用“DB 配置签名 +
db.php文件指纹”双重校验；代码或连接配置变化后会自动触发重新校验，无需手工清理缓存文件。 - 历史统计查询提供“hash 聚合优先 + 旧逻辑回退”，兼容存量环境差异，避免升级中断。
- 新增与改造逻辑均保持原接口签名不变，降低上层页面改造成本。
- 文档治理补强：
README.md增加按目录校对的完整路由矩阵（admin/user/api）与完整脚本清单，修复“后台治理”条目不完整问题，减少后续维护遗漏。
- 稳定性验证：
php -l lib/comments.php通过。php -l lib/db.php通过。php -l lib/proxy_service.php通过。php -l lib/bootstrap.php通过。php -l index.php通过。php -l quick.php通过。php -l about.php通过。node --check assets/global-button-tip.js通过。node --check assets/admin-dashboard.js通过。node --check assets/quick-page.js通过。
v1.0.127 (2026-02-22 17:39:00)
系统运行状态分页增强（异常/关键操作/告警/离线告警）
- 该小节更新时间：2026-02-22 17:39:00
admin/system_status.php分页能力补齐：- 新增分页基础函数
system_status_build_pager_meta()与system_status_paginate_rows()，统一生成页码、范围、跳转状态与分页 token。 - 新增查询参数：
exception_page、keyops_page、alerts_page、offline_page，支持独立分页切换。 - “系统异常日志”改为数据库分页查询（
COUNT + LIMIT/OFFSET），并保留异常级别/关键词筛选能力。 - “关键操作记录”“告警记录”“离线告警节点”改为表格分页展示，支持首页/上一页/页码/下一页/末页/跳页。
- 所有分页链接统一保留当前筛选和排序上下文，避免翻页后丢失过滤条件。
- 界面与移动端：
- 复用全后台统一分页视觉组件
unified-pagination，在系统运行状态页新增ss-pager容器，保持样式一致并兼容小屏布局。
- 稳定性验证：
php -l admin/system_status.php通过。
v1.0.126 (2026-02-22 17:26:00)
系统运行状态 open_basedir 兼容修复（消除 /proc 告警）
- 该小节更新时间：2026-02-22 17:26:00
admin/system_status.php兼容性修复：- 新增
system_status_path_allowed()，先按open_basedir白名单判断目标路径是否允许读取。 - 读取
/proc/cpuinfo与/proc/meminfo前增加“路径允许 + 文件可读”双重守卫，避免在受限环境触发is_readable()警告。 - 当
/proc不可访问时自动回退到已有兜底逻辑（命令探测/运行时内存统计），页面保持可用。
- 稳定性验证：
php -l admin/system_status.php通过。
v1.0.125 (2026-02-22 17:18:00)
备份功能自检上线（系统运行状态页）+ 审计动作文案补齐
- 该小节更新时间：2026-02-22 17:18:00
admin/system_status.php新增“备份功能自检”能力：- 新增自检动作
run_backup_health_check，支持一键检查备份中心关键链路。 - 自检覆盖读写项：备份策略、全站设置、高级配置、备份文件列表、导入任务、恢复任务、备份审计。
- 新增测试写入链路：创建测试备份记录并立即硬删除，验证写入与清理闭环。
- 自检结果持久化到
system_status.backup_health_last_json，页面可展示最近执行时间、通过/失败统计与逐项明细。 - 服务状态卡片新增“备份服务”，根据最近自检结果显示
运行中 / 待检查 / 异常。
- 审计可读性增强：
admin/audit.php的动作映射补齐系统运行状态相关动作（告警规则保存、重启、强制刷新、日志清理、资源释放、备份自检、失败记录）。- 便于在审计页面直接识别运维动作语义，不再只显示动作码。
- 稳定性验证：
php -l admin/system_status.php通过。php -l admin/audit.php通过。
v1.0.124 (2026-02-22 17:05:00)
系统运行状态仪表盘上线 + 备份入口风格统一 + 菜单核心项补齐
- 该小节更新时间：2026-02-22 17:05:00
- 新增后台菜单页
admin/system_status.php： - 上线“系统运行状态”菜单与仪表盘页面，覆盖核心状态概览、节点状态监控、用户访问监控、日志与告警、运维快捷操作五大区块。
- 增加服务器基础信息卡片（CPU/内存/磁盘/网络）、服务状态卡片（核心服务/节点服务/测速服务）与节点占比环形图。
- 增加节点实时延迟分布、节点负载 TOP10（支持排序切换）、近 1 小时离线告警、近 24 小时节点成功率展示。
- 增加实时在线用户、今日 PV/UV 小时趋势、热门节点排行、地域访问分布展示。
- 增加系统异常日志筛选、关键操作记录聚合（后台审计 + 备份审计）、告警规则设置、告警记录面板。
- 增加运维操作：一键重启服务（状态时间戳刷新 + 快速巡检）、清理系统日志、节点状态强制刷新、系统资源释放。
- 侧栏菜单与菜单治理同步：
lib/admin_sidebar_menu.php新增system_status默认菜单项（/admin/system_status.php），并设置最小角色为operator。lib/admin_sidebar_menu.php导入替换核心项列表新增system_status，避免菜单重置/导入时被误删。admin/global_manage.php菜单核心项集合与“保留可见项”集合同步加入system_status。
- 备份入口视觉语言统一（全后台）：
assets/admin-dashboard.css新增“系统备份与导入”二级分组强化样式（分组头/计数胶囊/子项 hover/active）。assets/admin-dashboard.css新增href*=\"/admin/backup_center.php\"的统一入口样式，保证备份入口在其他后台页也保持一致视觉。
- 稳定性验证：
php -l admin/system_status.php通过。php -l lib/admin_sidebar_menu.php通过。php -l admin/global_manage.php通过。
v1.0.123 (2026-02-22 16:18:30)
移动端分组手动收起修复（在线分组可正常折叠）
- 该小节更新时间：2026-02-22 16:18:30
- 前台节点选择器逻辑修复（
index.php）： - 修复“移动端点击在线分组无反应”的问题：手动点击分组头收起时，不再被“自动展开兜底”逻辑立即反向展开。
- 新增一次性标记
skipGroupedVisibleEnsureOnce：仅对用户主动收起动作跳过一次自动展开，避免视觉上“点了没收起”。 - “收起全部”操作同样应用该规则，确保分组可按预期保持折叠状态。
- 稳定性验证：
php -l index.php通过。- 首页内联脚本提取（替换 PHP 模板占位）后
node --check通过。
v1.0.122 (2026-02-22 16:10:45)
节点触发器红点位置调整（避让右上角）+ 移动端微调
- 该小节更新时间：2026-02-22 16:10:45
- 样式调整（
assets/main.css）： - 将节点触发器红点从按钮内部右上角移到外侧角标位（
top/right负偏移），避免压住节点名称与下拉箭头。 - 增加
z-index与pointer-events: none，确保视觉层级稳定且不影响点击。 - 移动端单独微调红点尺寸与偏移，保证小屏下不遮挡内容。
- 资源版本：
assets/main.css升级到20260222-site-polish-v54，index.php、quick.php、about.php同步更新引用。
- 稳定性验证：
php -l index.php、php -l quick.php、php -l about.php通过。
v1.0.121 (2026-02-22 16:02:10)
节点分组顶部快捷按钮（移动端友好）+ 后台开关
- 该小节更新时间：2026-02-22 16:02:10
- 前台节点选择器（
index.php）： - 新增顶部分组操作栏：
分组展开全部、分组收起全部两个按钮，交互不再依赖底部或分组头逐个点击。 - 分组按钮按当前筛选结果生效，且根据状态自动禁用（已全展开/已全收起/加载中）。
- 分组按钮改为设置项驱动显示：仅在“按状态分组”启用且后台允许时展示。
- 移动端体验优化（
assets/main.css）： - 顶部分组操作栏改为双列大触控按钮，优先展示在筛选区下方，单手点击更稳定。
- 深色模式同步补齐分组按钮配色，保证对比度与可读性。
- 后台控制补齐（
admin/node_selector.php+lib/node_selector.php）： - 新增配置项
show_group_toggle_actions（显示分组展开/收起顶部按钮），默认开启。 - 后台“节点选择器菜单管理栏”新增对应开关，保存后前台立即按配置生效。
- 资源版本：
assets/main.css升级到20260222-site-polish-v53，index.php、quick.php、about.php同步更新引用。
- 稳定性验证：
php -l index.php、php -l quick.php、php -l about.php、php -l lib/node_selector.php、php -l admin/node_selector.php通过。- 首页内联脚本提取（替换 PHP 模板占位）后
node --check通过。
v1.0.120 (2026-02-22 15:35:25)
移动端分组空白修复 + 分组头置顶 + PC 样式优化
- 该小节更新时间：2026-02-22 15:35:25
- 前台节点选择器逻辑（
index.php）： - 修复移动端“分组展开后列表看不见/展示 0”的场景：当分组模式下筛选有结果但可见节点为 0 时，自动展开一个有数据的分组并即时恢复列表显示。
- 批量测速/刷新状态导致节点跨组后，分组可见性会自动兜底，避免节点被全部折叠而“消失”。
- 分组交互优化（
index.php+assets/main.css）： - 高可用/在线/维护/离线分组头新增状态色并支持置顶吸附，滚动时始终可见，便于随时关闭当前组。
- 分组头暗黑模式样式同步补齐。
- 移动端布局优化（
assets/main.css）： - 移动端弹窗主区改为
list + action panel双区布局，列表区最小高度兜底，避免展开后被底部操作区挤没。 - 底部操作区（
一键测速 / 刷新状态 / 收藏当前列表 / 取消收藏）改为粘性显示，长列表滚动时仍可操作。
- PC 视觉优化（
assets/main.css）： - 右侧栏卡片与列表卡片统一层次（边框/阴影/背景渐变），增强可读性与信息分区。
- 右侧信息栏按钮风格统一，降低“发灰发平”的观感。
- 资源版本：
assets/main.css升级到20260222-site-polish-v52，index.php、quick.php、about.php同步更新引用。
- 稳定性验证：
php -l index.php、php -l quick.php、php -l about.php、php -l lib/node_selector.php、php -l admin/node_selector.php通过。- 首页内联脚本提取（替换 PHP 模板占位）后
node --check通过。
v1.0.119 (2026-02-22 15:25:15)
节点测速后左侧实时刷新修复 + 右侧报告区完整显示
- 该小节更新时间：2026-02-22 15:25:15
- 前台节点选择器（
index.php）： - 修复“右侧测速报告已更新但左侧列表不刷新”的问题：批量测速每个节点完成后立即写回
latency/status，并按进度触发列表重绘。 - 单节点测速完成后改为强制按当前排序重排渲染，测速结果会立刻反映到左侧列表（含排序变化）。
- 增加本地状态更新时间回写（
更新于 ...），测速后摘要时间戳同步刷新。 - 右侧栏布局最小高度提高（右侧模式最小高 520、默认高 620），避免测速报告区域被压缩。
- 样式修复（
assets/main.css）： - 右侧栏改为
auto/auto/1fr三段式布局，测速报告区独立滚动，解决“报告显示不完整”。 - 右侧主区域补齐
min-height: 0，避免 grid 子项高度挤压造成裁切。
- 资源版本：
assets/main.css升级到20260222-site-polish-v51，index.php、quick.php、about.php同步更新引用。
- 稳定性验证：
php -l index.php、php -l quick.php、php -l about.php通过。- 首页内联脚本提取（替换 PHP 模板占位）后
node --check通过。
v1.0.118 (2026-02-22 15:17:09)
节点右侧栏触发阈值继续下调 + CSS 强制缓存刷新
- 该小节更新时间：2026-02-22 15:17:09
- 前台节点选择器（
index.php）： - 继续修复“PC 端仍显示底部布局”的场景：右侧栏启用判定阈值由
680px再下调至641px。 - 对齐移动端适配边界：小屏手机保持底部堆叠，大多数桌面窗口与高缩放窗口可稳定进入右侧栏布局。
- 缓存刷新兜底：
- 样式资源版本升级到
20260222-site-polish-v50（index.php、quick.php、about.php同步），强制刷新main.css，避免旧样式缓存导致布局规则未生效。
- 稳定性验证：
php -l index.php通过。- 首页内联脚本提取（替换 PHP 模板占位）后
node --check通过。
v1.0.117 (2026-02-22 15:07:21)
节点右侧栏布局立即生效修复（去缓存覆盖）+ PC 启用阈值下调
- 该小节更新时间：2026-02-22 15:07:21
- 前台节点选择器（
index.php）： - 修复“后台已勾选 PC 端右侧信息栏，但前台仍在底部”的问题：弹窗打开与初始化阶段改为强制拉取最新节点配置，不再使用旧缓存覆盖最新设置。
- 右侧栏启用判定阈值由
1180px下调为980px，兼容浏览器缩放场景，PC 端更容易进入左右分栏布局。 - 移动端仍保持原有上下堆叠，不受本次阈值调整影响。
- 稳定性验证：
php -l index.php通过。- 首页内联脚本提取（替换 PHP 模板占位）后
node --check通过。
v1.0.116 (2026-02-22 14:38:00)
节点红点延迟分级配色上线 + 后台阈值/颜色自定义
- 该小节更新时间：2026-02-22 14:38:00
- 前台节点触发器（
index.php）： - 红点改为延迟分级配色：优/中/高/异常四档颜色，在线节点不再固定显示红色。
- 阈值支持分级：绿档、黄档、橙档阈值按配置动态计算，超出后进入异常红色。
- 红点样式（发光阴影）同步跟随颜色变化，状态提示
title同步显示状态与延迟。 - 继续保持“仅当前选中节点控制红点”的行为，不受其他节点异常干扰。
- 后台新增可配置项（
admin/node_selector.php+lib/node_selector.php）： - 新增延迟分级阈值：
红点绿档阈值、红点黄档阈值、红点橙档阈值。 - 新增颜色选择器：
红点颜色（优/中/高/异常）。 - 新增项已接入默认值、读取校验、保存白名单。
- 稳定性验证：
php -l lib/node_selector.php、php -l admin/node_selector.php、php -l index.php均通过。- 首页内联脚本提取（替换 PHP 模板占位）后
node --check通过。
v1.0.115 (2026-02-22 14:31:00)
节点触发器红点逻辑修正（仅当前节点异常才显示）
- 该小节更新时间：2026-02-22 14:31:00
- 前台节点选择器（
index.php）： - 修复节点触发器右上角红点误报：由“任意节点异常即亮红点”改为“当前选中节点异常才亮红点”。
- 新增统一异常判定函数，离线/维护/超阈值延迟共用同一规则，避免多处逻辑不一致。
- 选中节点变化时即时刷新红点状态，确保在线节点不会被其他节点异常误触发。
- 稳定性验证：
php -l index.php通过。- 首页内联脚本提取（替换 PHP 模板占位）后
node --check通过。
v1.0.114 (2026-02-22 14:26:00)
节点选择器右侧信息栏布局（PC）+ 后台开关 + 移动端回落
- 该小节更新时间：2026-02-22 14:26:00
- 前台节点选择弹窗布局调整（
index.php+assets/main.css）： - 将原底部的“最近使用 + 操作按钮 + 测速报告”区域抽离为独立侧栏容器。
- PC 宽屏下启用右侧信息栏布局，节点列表保留在左侧，侧栏显示在右侧。
- 移动端与窄屏自动回落为原有上下堆叠布局，保证可读性和触控操作空间。
- 深色模式同步补齐右侧信息栏样式。
- 后台可控配置补齐（
admin/node_selector.php+lib/node_selector.php）： - 新增设置项：
PC 端右侧信息栏布局（right_panel_on_desktop）。 - 新增配置接入默认值、读取校验与保存流程，支持后台统一开关。
- 资源版本：
assets/main.css升级到20260222-site-polish-v49，index.php、quick.php、about.php同步更新引用。
- 稳定性验证：
php -l lib/node_selector.php、php -l admin/node_selector.php、php -l index.php、php -l quick.php、php -l about.php均通过。- 首页内联脚本提取（替换 PHP 模板占位）后
node --check通过。
v1.0.113 (2026-02-22 14:14:00)
节点选择弹窗滚动修复（列表/测速报告可滑动）
- 该小节更新时间：2026-02-22 14:14:00
- 前台样式修复（
assets/main.css）： - 修复节点弹窗“滑不动”问题：节点列表容器
node-list-wrap改为可收缩（min-height: 0），避免底部区域被挤压导致滚动失效。 - 测速报告区新增最大高度与独立滚动：
node-speed-report在内容过长时内部滚动，不再把弹窗底部顶出可视区。 - 移动端补充测速报告高度限制，避免小屏上底部操作与报告区域互相挤压。
- 资源版本：
assets/main.css升级到20260222-site-polish-v48，index.php、quick.php、about.php同步更新引用。
- 稳定性验证：
php -l index.php、php -l quick.php、php -l about.php通过。- 首页内联脚本提取（替换 PHP 模板占位）后
node --check通过。
v1.0.112 (2026-02-22 14:06:00)
节点分组折叠状态记忆（本地持久化）
- 该小节更新时间：2026-02-22 14:06:00
- 前台节点选择器（
index.php）： - 新增分组折叠状态本地存储键：
accel_node_selector_group_collapse_v1。 - 分组展开/折叠状态改为持久化保存：点击分组头后立即写入本地缓存。
- 弹窗下次打开时自动恢复上次分组展开状态，不再每次回到默认折叠形态。
- 存储结构采用
version + groups格式，兼容旧结构并为后续升级预留。
- 稳定性验证：
php -l index.php通过。- 首页内联脚本提取（替换 PHP 模板占位）后
node --check通过。
v1.0.111 (2026-02-22 13:58:00)
节点列表分组折叠上线（在线/维护/离线）+ 后台新增分组控制开关
- 该小节更新时间：2026-02-22 13:58:00
- 前台节点选择器分组能力上线（
index.php+assets/main.css）： - 节点列表新增状态分组头：高可用 / 在线 / 维护中 / 离线，支持点击分组头折叠/展开。
- 支持“离线分组默认折叠”策略，打开弹窗时默认收起离线组，减少误触离线节点。
- 分组模式下保留原排序逻辑与键盘选择能力，并在摘要中增加“匹配/展示/折叠”统计。
- 移动端与深色模式同步补齐分组头样式，保证小屏与暗色下可读性。
- 后台新增分组控制项（
admin/node_selector.php+lib/node_selector.php）： - 新增
按状态分组显示节点开关。 - 新增
离线分组默认折叠开关。 - 新增配置已接入默认值、读取校验与保存流程，支持统一后台控制。
- 资源版本：
assets/main.css升级到20260222-site-polish-v47，index.php、quick.php、about.php同步更新引用。
- 稳定性验证：
php -l lib/node_selector.php、php -l admin/node_selector.php、php -l index.php均通过。- 首页内联脚本提取（替换 PHP 模板占位）后
node --check通过。
v1.0.110 (2026-02-22 13:50:00)
节点选择器后台控制补齐（快捷筛选/统计条/测速/报告导出/在线优先排序）
- 该小节更新时间：2026-02-22 13:50:00
- 后台控制项补齐（
admin/node_selector.php+lib/node_selector.php）： - 节点选择器设置新增开关并纳入统一配置存储：
快捷筛选按钮、状态统计条、在线优先排序（离线置底）。 - 测速能力新增细粒度开关：
一键测速、单节点测速按钮、测速报告面板、测速报告导出。 - 新增开关全部接入后端默认值、读取校验、保存白名单，确保后台配置可持久化并对旧配置兼容回退。
- 前台节点选择器联动生效（
index.php）： - 快捷筛选区与状态统计条改为按后台开关动态显示/隐藏。
- 在线优先排序支持后台控制：关闭后按原排序逻辑，开启后继续保证在线/高可用节点优先。
- 一键测速按钮与节点卡片测速按钮分别受后台开关控制，关闭后前端阻断操作并提示。
- 测速报告面板与导出按钮按后台开关控制，导出关闭时不允许下载 JSON 报告。
- 稳定性验证：
php -l lib/node_selector.php、php -l admin/node_selector.php、php -l index.php均通过。- 首页内联脚本提取（替换 PHP 模板占位）后
node --check通过。
v1.0.109 (2026-02-22 13:36:00)
节点测速报告导出 + 元数据筛选分页联动（搜索/状态/跳转/保存）
- 该小节更新时间：2026-02-22 13:36:00
- 前台节点选择器测速报告增强（
index.php+assets/main.css）： - 节点弹窗底部新增“测速报告”面板：展示总节点数、成功/失败数、平均延迟、总耗时。
- 报告内容拆分为“最快节点”与“失败节点”双列列表，便于一眼定位可用节点与异常节点。
- 一键测速完成后自动生成结构化报告并缓存到前端状态，弹窗重开后可继续查看最近一次结果。
- 新增“导出 JSON”按钮，支持将测速报告一键下载为
node-speed-report-*.json文件用于运维留档。 - 深色模式与移动端同步补齐报告区样式，避免小屏拥挤和暗色对比不足。
- 后台节点元数据编辑筛选能力补齐（
admin/node_selector.php+lib/pagination.php）： - 元数据管理新增关键字搜索：支持按节点 ID、名称、状态、地区、别名、分组、备注、权限说明过滤。
- 元数据管理新增状态筛选：
在线/高可用/离线/维护中/全部，其中“在线”自动覆盖“高可用”。 - 分页、页码跳转、保存回写均保持筛选上下文（
meta_q+meta_status），减少反复定位成本。 - 筛选结果为空时新增空态提示，避免出现“空白表格”导致误判。
- 分页注册模块
admin.node_selector_meta继续纳入统一分页治理体系。
- 资源版本：
assets/main.css升级到20260222-site-polish-v46，index.php、quick.php、about.php同步更新引用。
- 稳定性验证：
php -l index.php、php -l admin/node_selector.php、php -l lib/pagination.php、php -l quick.php、php -l about.php均通过。- 首页内联脚本提取后
node --check通过。
v1.0.108 (2026-02-22 13:18:00)
节点选择器二次增强（状态统计/快捷筛选/最近在线优先）+ 后台元数据分页跳转
- 该小节更新时间：2026-02-22 13:18:00
- 前台节点选择器进一步可用性增强（
index.php+assets/main.css）： - 弹窗新增状态快捷筛选按钮：
全部节点 / 仅在线 / 仅离线，并与原状态下拉联动。 - “仅在线”筛选自动包含“高可用”状态，避免优质节点被误排除。
- 弹窗新增实时状态统计条：总计、高可用、在线、维护、离线，提升节点健康可视化。
- “最近使用”区域改为在线优先排序，离线节点不再抢占首位，进一步降低误选概率。
- 移动端同步适配新控件：快捷筛选按钮等宽分布、状态统计标签缩小并优化间距。
- 深色模式补齐快捷筛选与统计标签颜色适配。
- 后台分页交互补齐（
admin/node_selector.php）： - 节点元数据分页区新增“页码输入跳转”，支持直接跳转到指定页管理。
- 移动端下页码跳转区域跟随自适应布局，不挤压分页按钮。
- 元数据保存请求新增行 ID 安全校验；若分页上下文丢失将中止写入，避免误覆盖全量元数据。
- 资源版本：
assets/main.css升级到20260222-site-polish-v45，index.php、quick.php、about.php同步更新引用。
- 稳定性验证：
php -l index.php、php -l admin/node_selector.php、php -l lib/pagination.php、php -l quick.php、php -l about.php均通过。- 首页内联脚本提取后
node --check通过。
v1.0.107 (2026-02-22 12:56:00)
节点选择器移动端重构 + 一键测速迁移 + 离线排序修复 + 后台元数据分页
- 该小节更新时间：2026-02-22 12:56:00
- 前台节点选择弹窗（
index.php+assets/main.css）： - 节点列表排序加入强约束：
high/online优先，maintenance次之，offline永远靠后，修复“离线节点排到前面”问题。 - 将简洁下载页测速能力迁移到首页节点选择器：
- 新增底部「一键测速」按钮（并发数沿用后台配置
batch_probe_concurrency）。 - 新增节点卡片级「测速」按钮，支持单节点测速与失败自动标离线。
- 测速结果即时回写弹窗列表、触发器状态与异常红点，并在当前节点失效时触发自动切换兜底。
- 节点弹窗视觉与移动端布局重构：
- 标题区新增交互说明（PC 可拖拽 / 移动端自动适配）。
- 节点卡片改为更高对比度卡片样式，增加操作区层级（测速 + 收藏）。
- 移动端筛选改为双列、显示项开关改为横向滑动、底部操作区改为双列栅格，缓解拥挤。
- 深色模式同步适配新版卡片与测速按钮状态。
- 后台节点元数据分页（
admin/node_selector.php+lib/pagination.php）： - 分页管理新增模块：
admin.node_selector_meta，支持统一后台分页配置治理。 - 节点元数据表接入分页（页码 + 每页条数 + 页码导航 + 区间统计）。
- 元数据保存改为“当前页增量更新 + 全量合并写回”，避免分页后保存覆盖未展示页数据。
- 设置保存与元数据保存均保留当前页/每页参数，减少管理操作跳转成本。
- 资源版本：
assets/main.css升级到20260222-site-polish-v44，index.php、quick.php、about.php同步更新引用。
- 稳定性验证：
php -l index.php、php -l admin/node_selector.php、php -l lib/pagination.php、php -l quick.php、php -l about.php均通过。- 首页内联脚本提取后
node --check通过。
v1.0.106 (2026-02-22 11:28:00)
节点选择器高级能力扩展（权限/白名单/容错/个性化/国际化）
- 该小节更新时间：2026-02-22 11:28:00
- 后端设置能力扩展（
lib/node_selector.php）： - 节点选择器设置新增个性化、运维、安全、效率、容错、国际化配置项：默认节点记忆、显示项开关、密度、默认弹窗位置、自动刷新、异常阈值、切换防抖、白名单、快捷切换、自动失败切换、回滚阈值、缓存降级时长、地区标签格式、延迟/负载单位等。
- 节点元数据新增权限与安全字段：
visibility_scope（公开/登录/VIP）、sensitive（敏感节点）、access_note（访问说明）。 - 前台 payload 构建接入权限过滤：开启权限控制或白名单后，服务端直接过滤不可见节点，避免仅前端隐藏。
- 后台管理页扩展（
admin/node_selector.php）： - “节点选择器菜单管理栏”升级为分组配置页：基础行为、个性化显示、运维日志、安全容错、国际化单位。
- 新增敏感节点数 / VIP 可见节点数统计卡片。
- 节点元数据表新增“可见范围 / 权限说明 / 敏感节点”编辑能力，并写入统一元数据存储。
- 前台节点选择器能力落地（
index.php+assets/main.css）： - 接入默认节点记忆（可开关）、排序偏好记忆、显示项偏好与密度偏好（可开关）。
- 新增显示项控制（延迟/负载/地区/类型/标签）与密度切换（紧凑/标准/宽松）。
- 新增异常红点提醒（按延迟阈值 + 离线/维护状态判定）。
- 新增切换防误触防抖、敏感节点验证（弹窗验证）、Alt+1..9 快捷节点切换。
- 新增节点容错：当前节点失效时自动切换；连续失败达到阈值后自动回滚；接口失败时按配置时长回退缓存数据。
- 节点弹窗继续保持全页面根层挂载与移动端适配，PC 端保持可拖拽。
- 资源版本：
assets/main.css升级到20260222-site-polish-v43，index.php、quick.php、about.php同步更新引用。
- 稳定性验证：
php -l index.php通过。php -l admin/node_selector.php通过。php -l lib/node_selector.php通过。php -l api/node-selector-status.php通过。php -l quick.php与php -l about.php通过。- 首页内联脚本
node --check通过（提取后校验）。
v1.0.105 (2026-02-22 10:42:00)
节点选择弹窗改为全页面根层挂载（与公告中心同级）
- 该小节更新时间：2026-02-22 10:42:00
index.php：- 节点选择弹窗新增根层挂载逻辑：初始化时将
#nodeModal从当前容器移动到document.body。 - 弹窗显示层级改为全页面覆盖，不再受左侧输入卡片容器（
panel的overflow/backdrop-filter）裁切。 - 交互行为保持不变：搜索、筛选、排序、拖拽、缩放、键盘快捷键、最近使用/收藏均继续生效。
- 稳定性验证：
php -l index.php通过。- 首页内联脚本
node --check通过。
v1.0.104 (2026-02-22 10:30:00)
节点选择器后台页面壳层对齐修复（侧栏与主内容错位）
- 该小节更新时间：2026-02-22 10:30:00
admin/node_selector.php：- 页面结构改为后台统一壳层：
admin-shell + main-content + dashboard-body，修复主内容未跟随侧栏宽度偏移导致的覆盖错位。 - 侧栏品牌区改为统一写法（
sidebar-brand / sidebar-brand-logo / sidebar-brand-text），修复 logo 按原始尺寸渲染导致的左侧异常放大。 - 补齐侧栏搜索框与底部说明区，保证与后台其余页面一致的布局行为。
- 顶栏按钮改为统一
topbar-btn结构并保留侧栏切换按钮，兼容现有后台脚本交互。 - 页面消息样式改为后台统一
msg show ok/err，避免局部样式不一致。
- 稳定性验证：
php -l admin/node_selector.php通过。
v1.0.103 (2026-02-22 10:18:00)
节点选择器 PC 拖拽默认开启 + 后台设置页补充行为说明
- 该小节更新时间：2026-02-22 10:18:00
index.php：- 节点选择弹窗在 PC 端改为默认可拖拽移动（不再依赖“启用弹窗拖拽”开关）。
- 移动端/窄屏仍保持固定居中策略，避免遮挡页面内容。
- 拖拽/布局缓存逻辑与新版边界约束保持一致，继续防止越界和超宽。
admin/node_selector.php：- 节点选择器设置页新增说明文案，明确“PC 端默认可拖拽、移动端自动固定居中、缩放由开关控制”。
- 设置保存增加
enable_drag=1隐藏字段，确保历史配置不会把 PC 拖拽能力意外关闭。
- 稳定性验证：
php -l index.php通过。php -l admin/node_selector.php通过。- 首页内联脚本
node --check通过。
v1.0.102 (2026-02-22 10:05:00)
节点选择弹窗布局修复（PC 限宽居中 + 移动端禁用浮动布局）
- 该小节更新时间：2026-02-22 10:05:00
index.php：- 修复节点选择弹窗在 PC 端可能出现“过宽且偏左”的问题：浮动布局最大宽度收敛到
820px，最大高度收敛到760px，默认居中显示。 - 修复移动端/窄屏下弹窗被历史拖拽尺寸影响的问题：
< 960px自动禁用浮动拖拽/缩放布局，回退到响应式居中弹窗。 - 为弹窗布局持久化增加版本校验（
layout version=2），自动忽略旧版缓存布局，避免历史缓存导致界面错位。 - 拖拽/缩放边界与保存逻辑统一改为新边界约束，防止越界或超大尺寸写入。
- 稳定性验证：
php -l index.php通过。- 首页内联脚本
node --check通过。
v1.0.101 (2026-02-22 09:45:00)
节点选择器弹窗重构 + 后台节点选择器管理栏 + 节点状态接口上线
- 该小节更新时间：2026-02-22 09:45:00
- 前台节点选择器（
index.php+assets/main.css）： - 将节点下拉改为弹窗选择器，接入
触发按钮 -> 弹窗 -> 选中 -> 关闭 -> 同步隐藏 select全链路。 - 新增实时搜索（防抖）、状态筛选、地区筛选、延迟筛选、排序（延迟/负载/名称/最近使用/优先级）。
- 新增节点状态可视化：状态标签、延迟标签、负载进度条、地区标签、类型标签、选中高亮与对勾。
- 新增收藏与最近使用能力：单节点收藏、当前列表批量收藏/取消收藏、最近使用快捷区（按配置数量显示）。
- 新增键盘交互（ESC 关闭、↑↓切换、Enter 选中）与双击快速选中。
- 新增弹窗拖拽与缩放（可配置开关），并持久化记住位置与尺寸。
- 新增节点列表懒渲染（超阈值分批渲染）与状态接口缓存读取（按分钟 TTL）。
- 新增状态刷新加载态/错误态/重试入口，兼容深色模式与移动端。
- 后台“节点选择器菜单管理栏”（
admin/node_selector.php）： - 新增节点选择器专用管理页，提供统计卡、选择器行为配置（缓存、防抖、懒加载、排序、拖拽、缩放、风险确认等）。
- 新增节点元数据编辑（别名、分组、类型、优先级、手动状态/延迟/负载、默认收藏、备注）。
- 节点选择器后端能力（
lib/node_selector.php+api/node-selector-status.php）： - 新增统一 payload 构建与设置/元数据持久化能力（
frontend.node_selector.settings、frontend.node_selector.meta）。 - 新增公开状态接口
/api/node-selector-status.php，前端按缓存策略读取节点状态与设置。 lib/bootstrap.php接入节点选择器库，后台侧栏默认菜单接入节点选择器（lib/admin_sidebar_menu.php、admin/nodes.php）。
- 资源版本：
assets/main.css版本号升级为20260222-site-polish-v42（index.php、quick.php、about.php同步更新引用）。
- 稳定性验证：
php -l index.php通过。php -l admin/node_selector.php通过。php -l api/node-selector-status.php通过。
v1.0.100 (2026-02-22 09:15:00)
全站分页样式统一补齐（备份中心/简洁页/首页历史/评论后台）
- 该小节更新时间：2026-02-22 09:15:00
admin/backup_center.php：- 导入任务、恢复任务、审计日志三处分页改为统一结构：
首页/上一页/数字页码/.../下一页/末页/页码跳转/统计摘要。 - 保留筛选参数并接入统一跳转表单，分页操作不丢失当前筛选条件。
admin/dynamic_island.php：- 配置发布日志分页补齐统一跳转输入与摘要展示，分页主控件保持一致样式。
index.php：- 首页历史记录分页改为数字页码渲染（含省略号）并统一摘要文案。
- 新增
historyPaginationPages容器和前端 token 计算逻辑，支持点击数字页直接跳转。
quick.php+assets/quick-page.js：- 简洁下载页节点分页新增数字页码容器，支持省略号与当前页高亮。
- 分页摘要统一为“显示 x-y 条，共 z 条（第 p / t 页）”格式。
admin/comments.php：- 评论列表、举报列表分页均升级为统一全量控件（首页/上一页/数字页码/下一页/末页/跳转/摘要）。
- 前端脚本新增通用分页 token 渲染，保留原有筛选、每页条数、批量操作流程。
- 稳定性验证：
php -l admin/backup_center.php通过。php -l admin/dynamic_island.php通过。php -l admin/comments.php通过。php -l index.php通过。php -l quick.php通过。node --check assets/quick-page.js通过。
v1.0.99 (2026-02-22 08:26:15)
系统备份与导入中心性能与交互优化（分页/高亮/二次确认/菜单图标）
- 该小节更新时间：2026-02-22 08:26:15
admin/backup_center.php：- 文件管理、导入任务、恢复任务、审计日志全部改为可配置分页（页码 + 每页条数），降低单页渲染与滚动压力。
- 备份文件筛选新增格式过滤与时间范围过滤，审计筛选新增每页条数控制。
- 列表状态统一升级为“图标 + 标签”样式（成功/告警/失败/进行中），导入与恢复任务补充进度条与百分比。
- 文件列表与审计日志支持关键词高亮，提升问题定位效率。
- 新增资源预加载/预连接提示、分区
content-visibility、首屏渲染负担优化。 - 新增“手动备份/数据导入”悬浮快捷入口，缩短常用操作路径。
- 新增危险操作二次确认弹窗（全量恢复、一键恢复、批量永久删除）与 3 秒自动消失 Toast 反馈。
- 策略表单新增基础/高级/安全分组标题，并增加“按模块备份”字段联动显示。
- 文件与审计关键词输入新增
500ms防抖自动提交；关键必填字段新增实时校验提示。
assets/admin-dashboard.css：- 为侧栏“系统备份与导入”二级分组增加
📦图标视觉标识。 - 侧栏与菜单交互过渡统一为
200ms linear，菜单展开/收起节奏更一致。
- 缓存版本：
admin/backup_center.php中admin-dashboard.css引用升级为20260222-admin-polish-v18。
- 稳定性验证：
php -l admin/backup_center.php通过。node --check assets/admin-dashboard.js通过。
v1.0.98 (2026-02-22 08:06:51)
关于与赞助 + 网站全局管理二次防溢出（移动端强兜底）
- 该小节更新时间：2026-02-22 08:06:51
admin/global_manage.php：- 新增页面级
overflow-x裁剪兜底，避免容器外扩引发整页横向滚动。 - 为所有
.gm-table自动包裹.gm-table-wrap横向滚动容器，统一把宽表限制在局部滚动区域。 - 小屏下对
.gm-table-wrap > .gm-table重写显示策略，避免旧的表格块化规则在部分浏览器触发异常撑宽。 JSON编辑框与长文本提示补充断行规则，防止长串内容撑出右边界。
admin/about.php：- 关于与赞助编辑区（筛选条、批量工具、上传工具、图片工具）补齐
min-width:0/max-width:100%约束。 - 预览区补充长链接/代码断行规则，修复超长 URL 引发的右侧溢出。
- 赞助名单/赞助图片表格在移动端下调最小宽度并加强局部滚动容器，避免整页跟随横向超出。
- 文件上传控件补充窄屏宽度约束，减少输入控件在移动端造成的撑宽。
- 稳定性验证：
php -l admin/global_manage.php通过。php -l admin/about.php通过。
v1.0.97 (2026-02-22 07:58:23)
后台右侧溢出修复 + 重点菜单页移动端补齐（含全局侧栏与菜单配置页）
- 该小节更新时间：2026-02-22 07:58:23
- 全局侧栏右侧溢出修复（
assets/admin-dashboard.css）： - 为侧栏导航与树形菜单节点补充
min-width: 0/max-width: 100%，修复极端情况下文本挤压导致的横向溢出。 - 补充
overflow-x: hidden与文本断行兜底，避免移动端右侧出现超出空白。 - 手机端侧栏宽度增加
max-width: calc(100vw - 6px)保护，降低不同浏览器下的越界概率。
- 网站全局管理页移动端继续加固（
admin/global_manage.php）： - 菜单配置区块、工具栏、标签胶囊、导入区统一加
max-width/min-width约束与断行规则。 - 小屏下进一步收紧组块内边距与统计胶囊行为，减少右侧挤出。
- 菜单 ID/说明字段补充
word-break兜底，避免长文本撑破容器。
- 其余重点菜单页移动端补齐：
admin/dynamic_island.php：新增<=680/<=560响应式规则，内联工具条/操作条/模板工具栏统一改为单列全宽，覆盖内联min-width与固定宽输入导致的溢出。admin/users.php：用户头部与批量操作区改为可响应布局，小屏下自动分行，分页跳转输入支持自适应宽度。admin/site.php：更新日志管理区域补充窄屏规则（分页区、跳页区、条目头、导入行），避免右侧超出。
- 缓存与发布：
- 后台统一将
admin-dashboard.css版本升级为20260222-admin-polish-v17，确保移动端立即加载新样式。
- 稳定性验证：
php -l：admin/*.php全量通过。node --check：assets/admin-dashboard.js通过。
v1.0.96 (2026-02-22 02:10:00)
后台页面移动端补齐 + 仪表盘最近日志分页 + 侧栏菜单缓存兜底 + README/时间修正
- 该小节更新时间：2026-02-22 02:10:00
- 仪表盘最近日志分页上线（
admin/index.php、lib/db.php、lib/pagination.php）： - 新增
fetch_recent_logs_paginated()，支持按资源类型筛选 + 总量统计 + 页码与偏移计算。 - 后台仪表盘“最近日志”支持
log_page/log_page_size，并保留现有筛选参数联动分页。 - 新增分页模块
admin.dashboard_logs，可在分页管理中心统一调整默认条数和角色上限。 - 日志样本卡文案改为动态每页条数，不再写死“最多 100 条”。
- 后台侧边栏偶发旧布局回退修复（
assets/admin-dashboard.js）： - 菜单配置接口新增“失败重试一次”逻辑，减少瞬时网络波动导致的回退概率。
- 接口成功后将菜单配置 + 运行开关写入本地缓存；接口失败时优先读缓存恢复新布局。
- 仅在“接口失败且缓存不可用”时才降级 DOM 旧菜单，避免刷新后偶发回到旧布局。
- 后台页面统一升级
admin-dashboard.js版本到20260222-admin-polish-v13，避免旧脚本缓存干扰。
- 后台页面移动端适配补齐（重点页面）：
admin/global_manage.php：工具栏/动作区/导入区在窄屏下改为单列，全宽输入，避免操作区挤压。admin/settings_search.php：搜索条、批量操作条、分页区移动端单列化，筛选 chip 横向滚动，提升可点按性。admin/pagination.php：多工具条与监控导出区域在小屏改为全宽堆叠，分组标签与窗口标签支持横向滚动。admin/about.php：赞助筛选、图片工具与动作按钮在手机端全宽展示，表格最小宽度下调并保留横向滚动。admin/backup_center.php：标签栏改为可横向滚动，工具栏/内联表单单列化，小屏下表格阅读更稳定。
- 文档与时间校正：
README.md完整重写，补齐当前架构、全局治理能力、排障与运维说明。- 修正更新日志“时间超前”问题：将
v1.0.95时间从未来时间回调到当前时间之前。
- 稳定性验证：
php -l：admin/index.php、admin/global_manage.php、admin/settings_search.php、admin/pagination.php、admin/about.php、admin/backup_center.php、lib/db.php、lib/pagination.php通过。node --check：assets/admin-dashboard.js通过。
v1.0.95 (2026-02-22 02:05:00)
全菜单页面增强统一接入：移动端兜底 + 全页返回顶部/深色模式 + 后台页面级开关
- 该小节更新时间：2026-02-22 02:05:00
- 页面增强配置中心扩展（
admin/global_manage.php）： - 新增首页/简洁页/关于页的页面级主题按钮开关，支持按页面独立控制深色模式入口。
- 新增简洁页与关于页“返回顶部按钮”开关，补齐与首页一致的页面增强能力。
- 新增后台菜单页与用户中心菜单页的页面增强开关：
深色模式切换按钮+返回顶部按钮。 - 新增“后台与用户中心页面增强功能”配置分组，统一在网站全局管理可视化维护。
- 全站页面增强能力新增统一配置接口（
api/layout-enhancement-config.php）： - 按当前路径自动识别页面类型（首页/简洁页/关于页/后台页/用户页/认证页）。
- 返回页面级
show_back_to_top与show_theme_toggle开关，前端按配置动态启用。 - 认证页默认关闭页面增强，避免登录/找回页面干扰。
- 全局脚本接入统一增强模块（
assets/global-button-tip.js）： - 在不改动原有点击提示逻辑的前提下，新增“全局页面增强”子模块。
- 自动为缺失页面注入右下角返回顶部按钮，支持滚动阈值显示与移动端 safe-area。
- 自动为后台/用户中心等页面注入深色模式快捷按钮，并持久化本地主题偏好。
- 补充后台深色模式样式覆盖（
admin-theme-dark），提升表格、侧栏、面板在暗色下可读性。 - 与前台既有主题机制兼容：不重复渲染已有主题按钮，保持首页/简洁页/关于页原交互。
- 前台主题开关改为页面级控制（
index.php、quick.php、about.php）： - 主题按钮显示逻辑由“全局导航开关”升级为“导航总开关 + 当前页面开关”联合控制。
- 满足“菜单内各页面单独控制显示”的运营场景。
- 全站静态资源版本升级：
global-button-tip.js引用版本统一升级为global-tip-v6，避免浏览器缓存导致新能力不生效。
- 稳定性验证：
- 全量 PHP 文件执行
php -l语法检查通过（含新增api/layout-enhancement-config.php）。 assets/global-button-tip.js执行node --check语法检查通过。
v1.0.94 (2026-02-22 01:42:00)
备份子菜单迁移至二级菜单 + 备份中心统计增强 + 设置检索前缀热度面板
- 该小节更新时间：2026-02-22 01:42:00
- 备份子菜单迁移到侧栏二级菜单（
lib/admin_sidebar_menu.php、admin/global_manage.php、assets/admin-dashboard.js）： - 将「系统备份与导入」拆分为 6 个可直达菜单：备份策略管理、备份文件管理、数据导入管理、数据恢复管理、操作日志审计、高级配置。
- 菜单默认分组迁移到
配置中心 -> 系统备份与导入，并兼容历史配置（旧数据安全分组与旧链接自动归一）。 - 菜单管理核心保护清单、覆盖导入保底菜单同步扩展，避免误删关键备份子菜单。
- 备份中心页面美化与统计增强（
admin/backup_center.php）： - 新增头部 Hero 与“当前子页面”提示，明确子菜单已迁移至左侧二级菜单。
- 新增按子页面动态变化的统计卡片（策略、文件、导入、恢复、审计、高级配置分别显示核心指标）。
- 文件管理新增“快速导入/快速恢复”入口，支持从单个备份文件直接跳转到对应业务流并自动预选文件。
- 顶部标题与页面标题支持随子菜单动态展示，提高多页面切换辨识度。
- 设置检索页面增强（
admin/settings_search.php）： - 新增“菜单索引健康”统计卡，展示菜单子功能可检索索引数量。
- 新增“前缀热度统计 Top 8”可视化面板，显示配置前缀分布与近 24h 变更活跃度。
- 前端缓存版本升级（
admin/*.php）： - 后台统一升级
admin-dashboard.js版本到20260222-admin-polish-v12，确保侧栏新激活/展开逻辑立即生效。
- 稳定性验证：
lib/admin_sidebar_menu.php、admin/backup_center.php、admin/settings_search.php、admin/global_manage.php已完成 PHP 语法校验。admin/*.php全量语法校验通过。assets/admin-dashboard.js已完成node --check校验。
v1.0.93 (2026-02-22 01:10:00)
系统备份与导入中心上线 + 侧栏一级菜单展开定位 + 菜单子功能设置可检索
- 该小节更新时间：2026-02-22 01:10:00
- 「系统备份与导入」后台中心页面上线（
admin/backup_center.php）： - 新增 6 个子菜单视图：备份策略管理、备份文件管理、数据导入管理、数据恢复管理、操作日志审计、高级配置。
- 接入
lib/backup_center.php现有能力：策略保存、手动备份、上传备份、批量文件治理、导入/恢复任务、审计链路、回收站清理。 - 支持最近 3 份备份快速恢复、审计日志 CSV/Excel 导出、日志保留策略更新与过期清理。
- 菜单管理增强（
admin/global_manage.php、lib/admin_sidebar_menu.php、api/admin-sidebar-menu.php、assets/admin-dashboard.js、assets/admin-dashboard.css）： - 新增「启用一级菜单展开定位（仅展开当前一级菜单）」配置项，归档到菜单设置并通过 API 下发。
- 侧栏一级菜单改为可折叠分组，点击三级菜单后刷新可自动定位到当前菜单，同时收起其他一级菜单。
- 保留二级菜单折叠能力，兼容原有搜索过滤与移动端收起逻辑。
- 设置检索补齐菜单子功能搜索（
lib/admin_sidebar_menu.php、admin/settings_search.php）： - 新增菜单子功能搜索索引同步：自动将菜单项摘要写入可检索设置键（哈希索引键，避免超长键名）。
- 设置检索页加载时自动补全菜单索引，修复“菜单里的小功能设置搜不到”问题。
- 扩展设置保护规则，新增菜单配置与菜单索引相关键的保护项，避免误删。
- 缓存版本更新（
admin/*.php）： - 后台页面统一升级
admin-dashboard.css/js版本号，确保侧栏新交互与样式可立即生效。
- 稳定性验证：
lib/admin_sidebar_menu.php、api/admin-sidebar-menu.php、admin/global_manage.php、admin/settings_search.php、admin/backup_center.php已完成 PHP 语法校验。assets/admin-dashboard.js已完成脚本语法校验（node --check）。
v1.0.92 (2026-02-21 23:59:59)
导出任务中心二次增强：筛选/分页 + 单条/批量删除 + 按天清理
- 该小节更新时间：2026-02-21 23:59:59
- 导出任务中心可运维化升级（
admin/pagination.php）： - 新增导出历史筛选器：支持关键字、格式（JSON/CSV）、范围（全量/模块/用户）过滤。
- 新增导出历史分页：支持每页条数切换、首页/上一页/下一页/末页与跳页。
- 新增历史记录治理动作：单条删除、批量删除、按天清理（如清理 30 天前记录）。
- 任务列表新增勾选与全选交互，删除动作附带确认提示，降低误操作风险。
- 导出历史后端治理能力补齐（
lib/pagination.php）： - 新增导出历史按 ID 删除能力（批量）。
- 新增按时间阈值清理能力（按天数裁剪历史）。
- 与原有导出记录能力配套，形成“记录 -> 检索 -> 清理”的完整闭环。
- 稳定性验证：
admin/pagination.php、lib/pagination.php已完成 PHP 语法校验。admin/pagination.php内联脚本已完成语法检查。
v1.0.91 (2026-02-21 23:59:59)
分页监控导出任务中心上线：历史记录、重下、清空全链路
- 该小节更新时间：2026-02-21 23:59:59
- 分页监控导出任务中心（
admin/pagination.php）： - 新增“导出任务中心”面板，展示最近导出记录（时间、操作人、窗口、范围、格式、结果集、文件名）。
- 支持一键“重新下载”历史任务，自动恢复当时导出的窗口与范围参数。
- 新增“清空导出历史”后台动作（管理员权限），便于运维清理历史任务。
- 监控导出历史后端能力（
lib/pagination.php）： - 新增导出历史存储、读取、记录、列表与清空函数。
- 导出 JSON/CSV 时自动落库记录（导出范围、窗口、目标模块/用户、条目数量、文件名、参数快照）。
- 历史记录保留上限控制，避免无限增长带来的配置体积膨胀。
- 稳定性验证：
admin/pagination.php与lib/pagination.php已完成 PHP 语法校验。admin/pagination.php内联脚本已完成语法检查。
v1.0.90 (2026-02-21 23:59:59)
分页监控导出再增强：按模块/按用户定向导出（JSON/CSV）
- 该小节更新时间：2026-02-21 23:59:59
- 分页监控导出维度扩展（
admin/pagination.php）： - 新增“选中模块导出”与“选中用户导出”操作，支持 JSON/CSV 双格式。
- 导出链路自动继承当前监控时间窗口（近 1 小时 / 24 小时 / 7 天 / 全部时间）。
- 导出作用域新增
overall / module / actor，便于运营与运维做定向排查。
- 分页监控导出后端聚合增强（
admin/pagination.php）： - 新增导出专用全量聚合（模块 120 / 用户 80）与筛选映射，避免页面展示截断影响报表导出。
- CSV 导出支持模块维度字段（热点页码/条数）与用户维度字段（用户类型/最近模块）。
- 稳定性验证：
admin/pagination.php、lib/pagination.php、admin/settings_search.php已完成 PHP 语法校验。admin/pagination.php内联脚本已完成语法检查。
v1.0.89 (2026-02-21 23:59:59)
设置检索勾选服务端同步 + 分页监控窗口筛选与模块报表导出
- 该小节更新时间：2026-02-21 23:59:59
- 设置检索批量勾选改为服务端持久化（
admin/settings_search.php）： - 新增勾选状态同步动作
sync_selected_keys，将当前勾选集写入服务端存储，支持跨页/跨端保持一致。 - 前端勾选交互由本地缓存迁移为服务端同步，补充
fetch + sendBeacon双通道，降低跳页时勾选丢失概率。 - 新增管理员级勾选存储键保护（
admin.settings_search.selection.admin_*），避免批量删除误清空勾选状态。
- 分页监控支持时间窗口与报表导出（
lib/pagination.php、admin/pagination.php）： - 监控后端新增分页事件流缓存（含模块、耗时、页码、每页条数、用户上下文），支持窗口化统计。
- 分页管理页新增窗口筛选（近 1 小时 / 近 24 小时 / 近 7 天 / 全部时间），监控卡片与热点表按窗口联动。
- 新增监控报表导出：支持导出监控总览 JSON 与模块维度 CSV（含热点页码/热点每页条数）。
- 本轮稳定性验证：
admin/settings_search.php、admin/pagination.php、lib/pagination.php已完成 PHP 语法校验。admin/settings_search.php与admin/pagination.php内联脚本已完成语法检查。
v1.0.88 (2026-02-21 23:59:59)
设置检索批量治理升级 + 分页监控面板落地 + 全链路语法校验
- 该小节更新时间：2026-02-21 23:59:59
- 设置检索治理能力升级（
admin/settings_search.php）： - 新增“保护白名单”管理：支持精确键名和前缀规则（
prefix*），并内置关键系统配置保护。 - 新增批量操作：勾选后可批量导出 JSON、批量删除（自动跳过受保护项）、批量加入/取消保护。
- 新增跨页勾选记忆与批量工具栏：支持全选当前页、勾选计数、快速清空勾选，并保留筛选上下文提交。
- 单条删除动作增加受保护校验，避免误删核心配置。
- 分页治理与监控继续增强（
admin/pagination.php、lib/pagination.php、admin/*、user/tickets.php）： - 分页管理中心新增性能监控总览卡片、慢分页比例、热点模块/热点用户、优化建议与监控重置。
- 多个前后台分页列表接入请求耗时上报，支持慢查询识别与高频翻页行为统计。
- 分页分组模板批量应用（前台轻量/后台标准/自定义平衡）可直接一键下发到当前可视模块。
- 稳定性验证与发布收口：
- 已对本轮涉及的分页/菜单/设置治理相关页面执行 PHP 语法校验与关键前端脚本语法校验，确保可发布性。
v1.0.87 (2026-02-21 23:59:59)
分页管理支持自定义模块注册/发现/删除 + JSON 自动建模
- 该小节更新时间：2026-02-21 23:59:59
- 分页模块能力继续扩展（
lib/pagination.php）： - 新增自定义分页模块自动发现：系统会从
app_settings中扫描pagination.*配置并自动纳入分页管理。 - 新增自定义模块配置清理能力（删除模块时自动清理该模块下所有分页键）。
- 新增元信息支持：分页模块可持久化
group / label / description，用于大规模模块管理时保持可读性。
- 分页管理页面新增“自定义模块治理”区（
admin/pagination.php）： - 新增自定义模块注册：可配置模块标识、模块分组（前台/后台/自定义）、默认每页、可选条数、角色上限与说明。
- 新增自定义模块删除：按模块标识一键删除该模块分页配置。
- 模块筛选 Tab 增加“自定义”，并在统计卡片中增加自定义模块计数。
- JSON 导入能力升级：当导入中包含新模块时自动注册为自定义分页模块，并写入元信息。
- JSON 导出内容升级：导出结果包含
group / label / description，避免跨环境迁移后语义丢失。
- 后台菜单与核心入口保护加固（
admin/global_manage.php、lib/admin_sidebar_menu.php、assets/admin-dashboard.js）： - 菜单管理核心保护名单扩展，默认保护
menu_manage / settings_search / pagination，避免批量操作误隐藏关键治理入口。 - 后台菜单排序客户端继续保持稳定（
id兜底）并与服务端排序一致。
v1.0.86 (2026-02-21 23:59:30)
设置检索管理中心上线 + 灵动岛配置版本分页纳入统一治理
- 该小节更新时间：2026-02-21 23:59:30
- 新增后台“设置检索”管理中心（
admin/settings_search.php）： - 支持按键名/值搜索、前缀过滤、排序、页码跳转、每页条数控制，并支持快捷键（
Ctrl+K、Alt+Home/End、左右键翻页、Ctrl+G）。 - 新增配置治理动作：创建设置项、编辑设置值、删除设置项（管理员权限 + CSRF 校验 + 审计日志）。
- 新增统计卡片与当前筛选结果 JSON 导出，便于大规模配置排障和跨环境对照。
- 分页治理范围继续扩展（
lib/pagination.php、admin/pagination.php）： - 新增
admin.settings_search与admin.dynamic_versions两个分页模块，纳入“分页管理”统一配置。 - 分页管理页补充模块页面映射，覆盖设置检索页与灵动岛配置版本日志页。
- 灵动岛配置发布日志升级为可分页管理（
admin/dynamic_island.php、lib/dynamic_island.php）： - 发布日志支持首页/上一页/下一页/末页、跳页、每页条数切换与区间统计显示。
- 配置版本保留上限提升（默认保留更多历史版本），回滚链路保持兼容。
- 菜单稳定性与入口修正（
lib/admin_sidebar_menu.php、assets/admin-dashboard.js、admin/global_manage.php、admin/pagination.php、admin/dynamic_island.php）： - “设置检索”菜单默认入口改为独立页面，并兼容历史锚点路径自动迁移。
- 后台菜单客户端排序补充
id兜底比较，进一步降低同序项前端渲染乱序概率。 - 多个后台页面静态侧栏补充“设置检索”兜底入口，提升 JS 失效时的可达性。
v1.0.85 (2026-02-21 23:58:44)
菜单可视化增删改批量化 + 快照下载中心上线
- 该小节更新时间：2026-02-21 23:58:44
- 全局设置菜单管理继续增强（
admin/global_manage.php）： - 新增“可视化新增菜单项”工具栏：支持填写 ID、名称、路径、一级/二级分组、最小角色、打开方式，一键新增到菜单表。
- 新增“批量操作”能力：克隆选中、选中显示、选中隐藏、删除选中（系统菜单转隐藏，自定义菜单可移除）。
- 菜单表新增勾选列与全选能力，配合筛选结果进行局部批量编辑更高效。
- 新增“下载全部快照 JSON”与“下载单个快照 JSON”，快照可直接导出离线备份。
- 菜单配置后端动作扩展（
admin/global_manage.php、lib/admin_sidebar_menu.php）： - 后台操作新增
download_sidebar_snapshot与download_sidebar_snapshots下载动作。 - 快照下载包含元信息（编号/来源/时间/操作人）与完整菜单行数据，便于跨环境迁移。
- 菜单快照基础能力与导入导出能力继续保留，确保“可回滚 + 可迁移”闭环。
- 菜单管理交互脚本重构（
admin/global_manage.php内联脚本）： - 菜单行绑定改为动态模式，新增行/克隆行后自动接入筛选、统计、拖拽排序与导出联动。
- 行级状态新增“选中高亮/新建标记”，并补充全选状态（选中/半选）实时同步。
- 批量操作后自动重算分组统计、角色统计、筛选命中数与 JSON 导出内容。
v1.0.84 (2026-02-21 23:42:06)
菜单快照回滚上线 + 用户工单分页体验升级（快捷键/记忆/加载态）
- 该小节更新时间：2026-02-21 23:42:06
- 菜单管理新增“版本快照回滚”（
lib/admin_sidebar_menu.php、admin/global_manage.php）： - 新增菜单快照能力：创建快照、恢复快照、删除快照，最多保留 20 份。
- 菜单保存 / JSON 导入 / 菜单重置 / 快照恢复前，都会自动生成“操作前快照”，用于安全回滚。
- 菜单管理界面新增快照表格，展示快照编号、创建时间、来源、操作人、菜单项数量。
- 快照相关操作全部写入后台审计日志，便于排障和变更追踪。
- 用户工单分页继续增强（
user/tickets.php、assets/tickets.js、assets/tickets.css）： - 工单分页支持每页条数会话记忆（未显式传
page_size时自动恢复上次设置）。 - 新增完整分页快捷键：
←/→上下页、Alt+Home首页、Alt+End末页、Ctrl+G聚焦跳页输入框。 - 分页交互新增加载态与防重复触发，避免连续点击导致重复请求。
- 工单页分页按钮补充
id与状态容器，支持快捷键与无障碍状态同步。
- 资源版本更新：
- 工单样式资源升级为
tickets.css?v=20260221-ticket-v5。 - 工单脚本资源升级为
tickets.js?v=20260221-ticket-v5。
v1.0.83 (2026-02-21 23:08:18)
菜单管理三次增强：JSON 导入导出 + 角色预览统计 + 用户工单分页纳入统一治理
- 该小节更新时间：2026-02-21 23:08:18
- 后台菜单治理能力扩展（
admin/global_manage.php、lib/admin_sidebar_menu.php）： - 菜单管理新增 JSON 导入/导出区：支持“合并导入 / 覆盖导入”两种模式。
- 新增菜单实时统计与角色预览筛选：支持查看员/操作员/管理员视角快速检查可见菜单。
- 新增菜单分组筛选、动态计数、角色可见标签实时联动，提升大规模菜单配置效率。
- 导入能力已接入审计日志，记录导入模式与导入条目数量，便于回溯操作。
- 菜单排序与稳定性再加固（
lib/admin_sidebar_menu.php）： - 菜单排序增加
id兜底比较，避免同序同名项在不同请求中出现不稳定顺序。 - 新增菜单配置 JSON 导出与导入归一化能力，降低人工编辑导致的字段不一致风险。
- 默认菜单新增“设置检索”入口（
/admin/global_manage.php#globalManageSearchInput），便于快速进入后台设置搜索。
- 分页覆盖继续补齐（
lib/pagination.php、user/tickets.php、admin/pagination.php）： - 新增
user.tickets分页模块，纳入后台“分页管理”统一治理。 - 用户中心工单列表支持后台可配置每页条数与页码跳转（首页/上一页/下一页/末页）。
- 工单筛选与工单操作后的回跳已联动保留
page_size，避免操作后分页上下文丢失。
v1.0.82 (2026-02-21 22:15:32)
后台菜单能力二次升级：拖拽排序 + 角色可见矩阵 + 多级菜单稳定化
- 该小节更新时间：2026-02-21 22:15:32
- 菜单治理增强（
lib/admin_sidebar_menu.php、admin/global_manage.php、api/admin-sidebar-menu.php）： - 新增菜单项最小角色可见矩阵（查看员/操作员/管理员），支持逐项配置。
- 后台菜单管理页新增角色统计卡片（查看员可见、操作员以上、仅管理员）。
- 菜单配置接口按当前登录角色过滤返回，避免低权限看到不该显示的菜单项。
- 菜单排序交互升级（
admin/global_manage.php）： - 菜单管理表格新增拖拽手柄，支持直接拖拽行排序，自动回写项排序值。
- 拖拽过程新增可视化落点提示（上边线/下边线）与拖拽状态样式。
- 保留并增强“自动整理排序”按钮，支持快速标准化排序序列。
- 后台多级菜单稳定性修复（
assets/admin-dashboard.js、assets/admin-dashboard.css）： - 多级菜单高亮逻辑优化：同路径不同锚点场景可精准高亮对应菜单。
- 增加
hashchange联动，菜单切换到锚点时高亮即时更新。 - 继续修复“顺序错乱/菜单偶发消失”链路，保持配置驱动渲染一致性。
- 资源版本更新：
- 后台样式资源升级为
admin-dashboard.css?v=20260221-admin-polish-v15。 - 后台脚本资源升级为
admin-dashboard.js?v=20260221-admin-polish-v10。
v1.0.81 (2026-02-21 22:07:28)
后台体验重构：分页管理可视化升级 + 全局侧栏菜单多级治理上线
- 该小节更新时间：2026-02-21 22:07:28
- 分页管理页美化与能力扩展（
admin/pagination.php）： - 新增分页统计卡片：模块总数、前后台数量、默认每页均值、角色限制风险项、高容量模块等。
- 新增高级工具栏：模块搜索、前台/后台分组筛选、批量套用默认每页模板（20/50/100）。
- 新增行级标签与筛选联动，支持按模块关键字快速定位并动态隐藏空分组。
- 新增未保存变更提醒（离开页面提示），降低误操作导致配置丢失的风险。
- 全局设置新增后台侧栏菜单管理（
admin/global_manage.php+lib/admin_sidebar_menu.php）： - 在“网站全局管理”中新增“后台侧边栏菜单管理”区块，支持一级菜单、二级菜单、三级功能项的分组与排序配置。
- 支持菜单项显隐、标题/路径调整、打开方式（当前页/新窗口）配置。
- 新增菜单批量工具：全部显示、隐藏扩展菜单、自动整理排序、恢复默认菜单布局。
- 新增全局设置搜索框，支持在后台配置页实时过滤设置项。
- 后台侧栏渲染机制升级（
assets/admin-dashboard.js+api/admin-sidebar-menu.php+assets/admin-dashboard.css）： - 后台侧栏由“页面静态写死 + 脚本补链”升级为“统一配置驱动渲染”，修复菜单顺序错乱与偶发缺项。
- 新增多级菜单展示样式与折叠状态记忆（可在全局设置中控制是否启用二级折叠）。
- 保留并增强菜单搜索：支持按菜单名/路径/分组筛选，并自动隐藏无结果分组。
- 缓存版本更新：
- 后台样式资源统一升级为
admin-dashboard.css?v=20260221-admin-polish-v14。 - 后台脚本资源统一升级为
admin-dashboard.js?v=20260221-admin-polish-v9。
v1.0.80 (2026-02-21 21:39:46)
分页治理收口：简洁下载页节点列表补齐完整分页
- 该小节更新时间：2026-02-21 21:39:46
- 简洁下载页节点分页补齐（
quick.php、assets/quick-page.js、assets/quick-page.css）： - 节点卡片列表新增完整分页交互：首页/上一页/下一页/末页、页码跳转、每页条数切换、页码范围显示。
- 分页状态支持禁用态与单页自动隐藏，避免在测速中或单页数据下误触。
- 节点分页配置接入后台统一策略（
frontend.quick_nodes），并新增本地分页记忆（页码/每页条数）。 - 移动端补充分页控件排版与触控尺寸优化，保证窄屏可点击性。
- 覆盖核查与资源更新：
- 核对后台主页面侧栏「分页管理」菜单覆盖情况，确保分页策略入口可达。
- 更新简洁页静态资源版本：
quick-page.css升级为v=20260221-quick-page-v22，quick-page.js升级为v=20260221-quick-page-v23。
v1.0.79 (2026-02-21 21:27:40)
全站分页治理：前后台高数据模块全量接入 + 后台分页管理中心上线
- 该小节更新时间：2026-02-21 21:27:40
- 新增后台分页管理中心（
admin/pagination.php）： - 新增「分页管理」菜单，已接入后台各主页面侧栏。
- 集中管理前台/后台分页模块：默认每页条数、可选条数组合、角色上限（查看员/操作员/管理员）。
- 支持一键恢复分页默认配置，并显示模块关联页面，便于运维统一治理。
- 前台高数据区分页改造（
index.php、api/history.php、lib/db.php、quick.php、assets/quick-page.js）： - 首页历史记录升级为真实分页：首页/上一页/下一页/末页、页码跳转、每页条数、页码状态、加载禁用与分页记忆。
/api/history.php升级为分页接口，返回page/page_size/total/pages/range_start/range_end/has_more。- 首页评论区默认分页条数改为后台可配置；简洁下载页评论区不再固定 10 条，改为读取分页配置。
- 后台分页统一接入（角色上限 + 每页条数）：
- 接入模块：用户管理、下载管理、节点管理、审计日志、缓存管理、上传管理、工单管理、评论管理（评论/举报）、站点标识更新日志。
- 公告管理列表从固定上限改为真实分页（支持每页条数、首页/末页导航与筛选联动保持）。
- 其他联动修复：
- 后台下载管理导出逻辑修复：
export_scope=all导出全部筛选结果，不再受隐式分页上限限制。
v1.0.78 (2026-02-21 20:16:03)
首页输入区快捷按钮增强 + 清空历史按钮位置调整（含移动端）
- 该小节更新时间：2026-02-21 20:16:03
- 首页主输入区交互升级（
index.php）： - 在“导入 TXT/CSV”旁新增 5 个快捷按钮：一键清空、一键复制、一键粘贴、撤销、重做。
- 新增对应交互逻辑：支持剪贴板读写、输入内容快速清理、撤销/重做编辑操作，并同步更新输入草稿与校验状态。
- 文字已按中文简洁风格处理，后续可继续改文案。
- 按钮位置调整（
index.php）： - 将“清空历史”按钮从左侧输入卡片主操作区移动到右侧“最近生成记录”操作区，与刷新/导出/复制历史按钮放在同一操作组。
- 样式与移动端适配（
assets/main.css）： - 新增输入快捷按钮组样式（胶囊按钮、可换行布局）。
- 手机端改为自适应分列，避免按钮挤压与换行错位。
main.css资源版本升级为v=20260221-site-polish-v40，前台页面同步更新引用以避免缓存影响显示。
v1.0.77 (2026-02-21 20:06:31)
网站全局管理十一次扩展：公告浮层内部模块与动作按钮全量可控
- 该小节更新时间：2026-02-21 20:06:31
- 后台全局管理继续扩容（
admin/global_manage.php）： - 首页公告浮层新增九个子模块控制项并支持排序：遮罩层、头部、正文、底部、不再提示、动作按钮组、一键忽略按钮、稍后提醒按钮、我知道了按钮。
- 上述配置统一接入“首页模块项”表格，与已有公告浮层总开关形成父子控制链。
- 前台首页公告浮层接入布局配置（
index.php+assets/announcement.js）： #announcementPortal新增一组布局数据属性，把后台子模块开关与顺序传入运行时脚本。announcement.js在渲染公告弹窗时按配置动态控制头部/正文/底部和动作按钮显隐与顺序。- 动作按钮支持独立开关：一键忽略、稍后提醒、我知道了可分别启用/禁用。
- 公告脚本资源版本升级为
v=20260221-announcement-v9，避免缓存导致旧逻辑未刷新。 - 依赖与兼容性：
- 新增依赖保护：浮层总开关关闭时所有子项自动失效；底部关闭时底部动作同步失效；动作组关闭时动作按钮同步失效。
- 保持公告数据拉取、已读统计与事件上报逻辑不变，仅扩展展示层可配置能力。
v1.0.76 (2026-02-21 20:02:07)
网站全局管理十次扩展：公告中心/评论编辑器/评论编辑弹窗再细分控制
- 该小节更新时间：2026-02-21 20:02:07
- 后台全局管理继续扩容（
admin/global_manage.php）： - 首页公告按钮新增子项：按钮文案、未读角标，支持独立显隐与优先级配置。
- 首页公告中心弹窗新增子项：关闭按钮、头部主区、标题、头部统计、头部操作区，继续细化筛选组与一键已读控制。
- 首页评论发布编辑器新增子项：身份栏、昵称行、表情栏、输入框、操作栏、上传状态、上传预览，支持独立显示与排序。
- 首页评论编辑弹窗新增子项：关闭按钮、Markdown 按钮组、上传按钮、编辑区标题、预览区标题。
- 前台首页完成全量接入（
index.php）： - 公告按钮、公告中心弹窗、评论发布编辑器、评论编辑弹窗全部新子模块接入后台可视化控制。
- 新增依赖保护链：父容器关闭时子项自动失效；公告中心头部主区/操作区关闭时对应子项自动失效；评论编辑弹窗工具栏关闭时按钮组与上传按钮自动失效。
- 保持现有公告拉取、评论发布、Markdown 编辑与上传流程不变，仅扩展展示层配置能力。
- 样式与移动端适配（
assets/main.css、index.php、quick.php、about.php）： - 补充公告按钮标签与评论编辑按钮组样式，避免在窄屏下错位。
- 公告中心头部主区改为纵向布局，保证标题与统计在移动端仍可读。
main.css资源版本升级为v=20260221-site-polish-v39，三大前台页面同步更新引用，避免缓存导致样式不生效。
v1.0.75 (2026-02-21 19:51:30)
网站全局管理九次扩展：首页评论区主体子模块细粒度控制
- 该小节更新时间：2026-02-21 19:51:30
- 后台全局管理继续扩容（
admin/global_manage.php）： - 首页评论区主体新增子模块开关与排序：标题栏、排序按钮、评论禁用提示、发布编辑器、评论列表、加载更多按钮。
- 首页模块表格中评论区由“单一容器”升级为“容器 + 子模块”双层控制，便于精细化布局。
- 前台首页接入评论区子模块控制（
index.php）： - 评论区主容器保持原有开关与顺序，内部六个子区块接入后台显隐与排序能力。
- 增加父子依赖保护：评论区容器关闭时，所有子区块自动失效；标题栏关闭时排序按钮同步失效。
- 保持评论 API、发布流程、分页加载和移动端交互不变，仅扩展展示层可配置能力。
- 兼容性说明：
- 不改变评论业务逻辑与数据结构，已有评论数据和操作流程不受影响。
v1.0.74 (2026-02-21 19:48:50)
网站全局管理八次扩展：评论编辑/举报弹窗子模块细粒度控制
- 该小节更新时间：2026-02-21 19:48:50
- 后台全局管理继续扩容（
admin/global_manage.php）： - 首页新增“评论编辑弹窗”子模块开关与排序：标题、Markdown 工具栏、双栏主体、编辑区、预览区、状态提示、上传预览、操作按钮。
- 首页新增“评论举报弹窗”子模块开关与排序：标题、举报表单、状态提示、操作按钮。
- 所有新增项统一纳入首页模块表格，支持手机端配置。
- 前台首页接入弹窗子模块控制（
index.php）： - 评论编辑与举报弹窗全部子项接入后台显示/隐藏与顺序能力。
- 新增父子依赖保护：父弹窗关闭时子项自动失效；编辑双栏主体关闭时编辑区/预览区同步失效；举报表单关闭时状态提示同步失效。
- 两个弹窗卡片改为栈式布局，确保子模块排序在前端真实生效。
- 兼容性说明：
- 保持原有评论编辑、Markdown 预览、图片上传和举报提交流程不变，仅扩展布局配置能力。
v1.0.73 (2026-02-21 19:44:11)
网站全局管理七次扩展：通用确认弹窗/分享弹窗子模块可配置化
- 该小节更新时间：2026-02-21 19:44:11
- 后台全局管理继续扩容（
admin/global_manage.php）： - 首页模块新增“通用确认弹窗”子模块：标题、提示文案、输入框、操作按钮（支持显示开关 + 排序）。
- 首页模块新增“分享弹窗”子模块：标题、链接输入区、渠道按钮区、二维码区（支持显示开关 + 排序）。
- 前台首页接入子模块控制（
index.php）： uiDialogModal与shareDialogModal全部新增子项接入后台显隐与顺序配置。- 增加父子依赖：关闭父弹窗后，内部子模块自动同步隐藏。
- 两个弹窗卡片切换为栈式布局（
flex column），确保后台“位置排序”在前端真实生效。 - 兼容性说明：
- 仅扩展显示与排序能力，不改变通用确认/分享业务逻辑与现有接口。
v1.0.72 (2026-02-21 19:41:00)
网站全局管理六次扩展：首页弹窗子模块（版本/更新日志/公告中心）细粒度控制
- 该小节更新时间：2026-02-21 19:41:00
- 后台全局管理继续扩容（
admin/global_manage.php）： - 首页模块新增弹窗子模块控制项并支持排序：版本弹窗（标题/版本信息/Markdown/更新日志按钮）、更新日志弹窗（头部/筛选/双栏主体/左侧列表/右侧详情/Markdown 回退）、公告中心弹窗（头部/筛选组/一键已读/双栏主体/左侧列表/右侧详情）。
- 上述新增项统一进入首页模块表格，支持可见性开关与优先级调整。
- 前台首页接入弹窗子模块控制（
index.php）： - 读取并应用全部新增字段，版本弹窗、更新日志弹窗、公告中心弹窗内部区块均可按后台配置显示/隐藏与排序。
- 新增父子依赖保护：父弹窗关闭时，内部子模块自动失效；头部关闭时筛选区自动失效；主体关闭时列表/详情自动失效。
- 保持原有弹窗逻辑和键盘交互不变，仅做展示层可配置化扩展。
- 样式与缓存更新（
assets/main.css、index.php、quick.php、about.php）： - 新增
version-info-card栈式布局，确保版本弹窗子模块“排序”在前端真实生效。 main.css资源版本升级为v=20260221-site-polish-v38，三大前台页面同步更新引用，避免缓存导致样式不生效。
v1.0.71 (2026-02-21 19:34:45)
网站全局管理五次扩展：简洁页/关于页子模块显隐与排序全部接入
- 该小节更新时间：2026-02-21 19:34:45
- 后台全局管理继续扩容（
admin/global_manage.php）： - 新增简洁下载页子模块控制项：设置面板主题区、当前节点元信息与备注、结果元信息、状态条、节点统计与测速按钮、评论区标题/编辑器/列表/加载更多。
- 新增关于页子模块控制项：设置面板主题区、赞助图工具栏、当前选中提示、加载更多按钮、图片网格、空态提示、预览灯箱。
- 简洁下载页接入子模块配置（
quick.php）： - 全量读取并应用新增子模块开关与顺序参数。
- 增加父子依赖保护：父模块关闭时，子模块自动同步隐藏，避免空壳区域。
- 顶部设置按钮联动页面设置面板可见性，关闭面板后不会显示无效入口。
- 关于页接入子模块配置（
about.php）： - 设置面板主题区、赞助图工具栏及其子项、网格/空态/灯箱全部支持后台显隐与顺序调整。
- 灯箱增加布局可用性检测：后台关闭后前端点击与快捷键不会再拉起弹层，避免“配置关闭但脚本仍触发”。
- 保持移动端结构不变，仅做显隐/排序层改造，避免破坏现有触摸交互。
v1.0.70 (2026-02-21 19:27:40)
网站全局管理四次扩展：评论弹窗/分享弹窗/公告浮层与版本入口联动控制
- 该小节更新时间：2026-02-21 19:27:40
- 后台全局管理新增更多首页交互层开关（
admin/global_manage.php）： - 评论编辑弹窗、评论举报弹窗、通用确认弹窗、分享链接弹窗。
- 公告浮层容器（
announcementPortal）开关。 - 首页接入新增控制（
index.php）： - 以上弹窗与浮层容器全部接入后台显隐控制。
- 页脚“版本入口”与弹窗能力联动：无可用版本类弹窗时自动隐藏入口。
- 当版本弹窗关闭但更新日志弹窗开启时，点击版本入口将直接打开更新日志，避免无响应。
- 弹窗打开函数增加布局可用性检查，后台关闭后不再被前端逻辑误拉起。
- 兼容性说明：
- 仅扩展显示控制，不改变评论/分享/公告业务流程与接口协议。
v1.0.69 (2026-02-21 19:23:48)
网站全局管理三次扩展：首页历史区子模块与弹窗/返回顶部纳入控制
- 该小节更新时间：2026-02-21 19:23:48
- 后台全局管理继续扩容（
admin/global_manage.php）： - 首页历史区新增子模块控制：筛选栏、批量操作栏、汇总信息、历史表格（支持显示开关 + 排序）。
- 首页新增弹窗级控制：版本说明弹窗、更新日志弹窗、公告中心弹窗。
- 首页新增返回顶部按钮开关控制。
- 前台首页接入（
index.php）： - 历史区改为模块栈，筛选/批量/汇总/表格四块支持独立显隐与顺序调整。
- 版本说明、更新日志、公告中心弹窗接入后台开关，关闭后前端不再显示。
- 右下角返回顶部按钮接入后台开关。
- 兼容性策略：
- 仅做显隐与排序层改造，不改变原有历史筛选、分页、统计、弹窗交互逻辑，确保现有 JS 行为保持稳定。
v1.0.68 (2026-02-21 19:18:36)
网站全局管理二次扩展：顶部栏/设置面板/关于页 Hero 与锚点全部纳入控制
- 该小节更新时间：2026-02-21 19:18:36
- 全局管理项大幅扩展（
admin/global_manage.php）： - 顶部栏新增细粒度控制：品牌区、Logo、品牌名、语言徽标、菜单按钮、设置分组、账号分组。
- 顶部栏新增排序能力：品牌区、公告按钮（首页）、链接容器、菜单按钮，以及分组内顺序。
- 页面链接顺序可调：主页面 / 简洁下载页 / 关于 / 管理后台可独立设置优先级。
- 首页新增扩展控制：灵动岛浮层、公告按钮、设置面板、设置面板子分组（主题预设/快捷设置）。
- 简洁页与关于页新增设置面板控制：支持显隐与位置排序。
- 关于页新增 Hero 与锚点导航显隐及排序控制。
- 前台页面联动扩展：
index.php：接入顶部栏全量控制、页面链接动态排序、设置面板排序、灵动岛后台强制隐藏、公告按钮显隐。quick.php：接入顶部栏全量控制、页面链接动态排序、设置面板显隐与排序。about.php：接入顶部栏全量控制、页面链接动态排序、设置面板显隐与排序、Hero/锚点显隐与排序。- 样式与脚本补丁（移动端保持可用）：
assets/quick-page.css新增quick-page-stack结构，支持简洁页设置面板和主内容区顺序调节。assets/main.css新增about-module-stack，支持关于页设置面板、Hero、锚点顺序联动。assets/dynamic-island.js增加data-layout-visible强制隐藏逻辑，后台关闭灵动岛后前端不会再次自动拉起。- 资源版本升级：
main.css升级为v=20260221-site-polish-v37（index.php、quick.php、about.php）。quick-page.css升级为v=20260221-quick-page-v21（quick.php）。dynamic-island.js升级为v=20260221-dynamic-island-v5（index.php）。
v1.0.67 (2026-02-21 19:06:33)
新增网站全局管理菜单：前端模块显示/排序统一迁移（含移动端）
- 该小节更新时间：2026-02-21 19:06:33
- 后台新增“网站全局管理”中心（
admin/global_manage.php）： - 新增统一入口：
/admin/global_manage.php，用于集中管理前台页面布局策略。 - 支持导航级开关：登录区、主页面、简洁下载页、关于、后台入口、语言切换、主题切换、设置按钮。
- 支持页面模块级开关 + 排序：主页面（Hero/主功能区/历史区/评论/声明）、简洁下载页（输入/当前节点/结果/节点列表/评论/声明）、关于页（项目/联系/赞助/赞助名单/赞助图片）。
- 支持首页网格位次微调：主功能区和历史区的左右位次独立配置。
- 已接入 CSRF 校验、保存回显、管理员审计日志（
global_layout_save）。 - 前台三大页面接入全局布局配置：
index.php：接入导航显示控制与首页模块顺序控制，新增模块堆叠容器并支持样式级隐藏/排序。quick.php：接入导航与模块控制，评论区/声明区正式迁移到全局管理，同时兼容历史字段读取。about.php：接入导航与模块控制，锚点导航按可见模块自动显示，卡片支持统一排序与隐藏。- 兼容迁移与旧字段同步（
admin/global_manage.php、quick.php、admin/site.php）： - 保留旧配置兼容：
quick.layout_show_comments与quick.layout_show_signature与新字段双向同步，避免历史部署配置失效。 admin/site.php中“简洁页评论/声明开关”迁移为指引入口，避免旧页面覆盖新配置。- 后台菜单统一扩展（多个
admin/*.php）： - 增加“网站全局管理”菜单项，统一进入全局配置中心。
- 上传页面入口保留“上传管理”命名，菜单结构保持一致。
- 样式与移动端适配（
assets/main.css、admin/global_manage.php）： - 新增
.home-module-stack支持主页面模块纵向排序。 - 全局管理页支持移动端自适应：卡片在窄屏单列、表格自动转块级显示，确保手机端可操作。
v1.0.66 (2026-02-21 19:03:27)
简洁下载页测速分组 + 评论/声明回归 + 后台布局开关（含移动端）
- 该小节更新时间：2026-02-21 19:03:27
- 简洁下载页测速后分组展示（
assets/quick-page.js、assets/quick-page.css）： - 节点列表新增“测速后自动分组”模式，按极速/稳定/低速/待测速/不可用分段展示。
- 保留单节点测速与选择交互，分组模式下按钮行为与原先一致。
- 分组头部新增范围提示与数量徽标，并补齐深色模式与移动端样式。
- 简洁下载页评论区与声明区补齐（
quick.php、assets/quick-page.js、assets/quick-page.css）： - 评论区接入
/api/comments.php：支持最新/最热排序、发布评论、点赞、分页加载更多。 - 新增评论卡片、回复层级、空态与失败态展示，适配深色模式与窄屏布局。
- 底部声明卡片补充版本徽标样式，和主站声明渲染保持一致。
- 后台新增简洁下载页布局开关（
admin/site.php）： - 新增
quick.layout_show_comments与quick.layout_show_signature两个配置项，可独立控制/quick.php的评论区与声明区显示。 - 开关已接入保存、回显和审计字段，改动即时生效。
- 资源版本升级（
quick.php）： quick-page.css升级为v=20260221-quick-page-v20。quick-page.js升级为v=20260221-quick-page-v21。
v1.0.65 (2026-02-21 18:06:07)
上传策略升级为“上传管理中心”（全页面上传聚合 + 统计 + 批量操作）
- 该小节更新时间：2026-02-21 18:06:07
- 上传管理能力扩展（
lib/upload_policy.php、admin/upload_policy.php）： - 新增全站上传扫描：统一扫描
uploads目录，自动识别评论、工单、赞助、灵动岛图标等来源，并支持“其他上传”兜底分类。 - 新增上传元数据系统（基于
app_settings）：支持别名、来源覆盖、标签、备注、隐藏标记、软删除标记与更新时间。 - 新增文件管理核心能力：筛选、排序、分页、CSV 导出、单文件编辑、批量编辑、批量软删除/恢复、批量硬删除。
- 新增统计计算能力：总量/可见/删除/隐藏、容量统计、今日/7天/30天新增、来源分布、后缀分布、最大/最新/最早文件等。
- 后台页面重构（
admin/upload_policy.php）： - 页面由“上传策略”升级为“上传管理”，保留原策略配置并新增统计卡片、来源覆盖表、文件管理表与批量工具栏。
- 新增单文件编辑器：支持从列表一键载入并编辑别名、来源覆盖、标签、备注、隐藏/软删除状态。
- 增加移动端适配：筛选区、批量区、编辑区在窄屏自动改为单列，提升手机端操作可用性。
- 后台菜单与入口文案统一（多个
admin/*.php）： - 后台各页面菜单入口“上传策略”统一更名为“上传管理”，并同步站点标识页相关提示文案。
v1.0.64 (2026-02-21 17:50:37)
灵动岛图标管理 + 模板池管理（支持多选、编辑、上传、历史）
- 该小节更新时间：2026-02-21 17:50:37
- 新增灵动岛图标更换能力（
lib/dynamic_island.php、admin/dynamic_island.php、assets/global-button-tip.js）： - 图标来源支持：内置动态图标、同步本站图标、自定义单图标、历史图标池。
- 新增历史图标池多选与编辑（名称/URL）、行级多选删除、全选/反选。
- 新增历史池取图模式：固定首个 / 随机 / 轮询。
- 新增图标上传与历史联动（
lib/dynamic_island.php、admin/dynamic_island.php）： - 后台支持上传灵动岛图标（走上传策略校验）。
- 上传成功后自动回填自定义图标 URL，并自动加入图标历史池与选中集合。
- 新增灵动岛模板池（
lib/dynamic_island.php、admin/dynamic_island.php、assets/global-button-tip.js）： - 支持自定义模板文案（支持
{label}占位符）与模板图标类型。 - 支持模板池多选、编辑、批量删除。
- 新增模板取用模式：固定首个 / 随机 / 轮询。
- 前台点击提示接入模板池渲染，未启用模板池时保持原默认文案。
- 公共配置下发扩展（
api/global-tip-config.php、lib/dynamic_island.php）： - 下发图标来源、本站图标 URL、选中历史图标列表、模板池开关/模式、选中模板列表。
- 资源版本升级：
- 全站
global-button-tip.js升级为v=20260221-global-tip-v5，确保图标与模板能力立即生效。
v1.0.63 (2026-02-21 17:37:52)
灵动岛长文案“滚动完自动消失” + 样式切换与自定义
- 该小节更新时间：2026-02-21 17:37:52
- 长文案滚动完成后自动消失（
assets/global-button-tip.js）： - 新增“单次滚动模式”：长文案滚动完整显示后自动收起，不再无限循环。
- 新增“滚动结束停留时长”参数，支持在滚动结束后短暂停留再消失。
- 仍保留循环滚动能力，可在后台关闭“滚动完整显示后自动消失”恢复循环模式。
- 新增灵动岛提示样式切换（
admin/dynamic_island.php、lib/dynamic_island.php、assets/global-button-tip.js）： - 后台新增样式模式：
灵动岛玻璃/极简紧凑/描边高对比。 - 前台根据后台配置实时切换提示条样式。
- 新增提示条自定义功能（
admin/dynamic_island.php、lib/dynamic_island.php、api/global-tip-config.php、assets/global-button-tip.js）： - 新增自定义开关与颜色项：背景色、文字色、边框色、图标色。
- 新增全站配置下发字段，前台按配置渲染，未配置时自动回退默认样式。
- 资源版本升级：
- 全站
global-button-tip.js升级为v=20260221-global-tip-v4，确保新滚动与样式能力立即生效。
v1.0.62 (2026-02-21 17:32:57)
深色模式背景发白修复（顶部泛白与面板白带）
- 该小节更新时间：2026-02-21 17:32:57
- 深色主题背景修复（
assets/main.css）： - 为
body[data-theme="dark"]增加深色专用背景渐变，移除浅色顶部底色在暗色主题下造成的“发白/雾化”观感。 - 保持
background-attachment: fixed，避免滚动时出现明暗断层。 - 深色面板高光优化（
assets/main.css）： - 降低
.panel::before在深色主题下的白色高光强度，修复卡片顶部“白色横带”问题。 - 资源版本升级（
index.php、about.php、quick.php）： main.css升级为v=20260221-site-polish-v36，确保深色背景修复即时生效。
v1.0.61 (2026-02-21 17:26:46)
长文案显示修复 + 后台滚动调节 + 深色模式位置调整（含移动端）
- 该小节更新时间：2026-02-21 17:26:46
- 全站灵动岛提示支持“长文案滚动显示”（
assets/global-button-tip.js）： - 当提示文本超出容器且超过触发长度时，自动启用无缝滚动轨道，解决“字太长被截断/挤压”的显示问题。
- 新增滚动速度按文本宽度动态计算，短文案保持静态显示，避免不必要动画。
- 窗口尺寸变化时自动重算滚动距离与时长，移动端横竖屏切换显示更稳定。
- 后台新增全站提示调节项（
lib/dynamic_island.php、admin/dynamic_island.php、api/global-tip-config.php）： - 新增配置：全站提示开关、长文案滚动开关、滚动触发长度、滚动速度、最大文案长度、显示时长。
- 新增公开配置接口
/api/global-tip-config.php，前台按后台参数实时生效，失败时自动回退默认值。 - 深色模式按钮从“设置面板”移出到顶部栏（
index.php、assets/main.css）： themeToggle回归顶部导航，与语言/设置按钮同层级，减少设置面板拥挤。- 设置面板“快捷设置”保留灵动岛开关，职责更清晰。
- 设置面板布局与移动端优化（
index.php、assets/main.css）： - 快捷设置区改为自适应网格，单按钮场景自动铺满宽度，不再显得空且偏窄。
- 当快捷操作按钮全部隐藏时，自动折叠“快捷设置”分组并切换单列布局，避免空卡片影响观感。
- 资源版本升级（
index.php）： main.css升级为v=20260221-site-polish-v35，确保布局与顶部按钮调整立即生效。
v1.0.60 (2026-02-21 17:04:52)
顶部导航与设置面板视觉重构（修复“不好看”）
- 该小节更新时间：2026-02-21 17:04:52
- 顶部导航布局优化（
assets/main.css）： - 调整顶部容器内边距与间距，减少松散感，信息密度更均衡。
- 修复公告中心按钮“居中悬空”问题：公告区从
flex: 1改为自适应宽度，按钮回归到品牌区旁侧，整体对齐更自然。 - 导航链接区改为可伸缩布局（
topbar-links增加flex: 1），减少中间空洞。 - 设置面板重排（
assets/main.css）： - 将设置面板改为双列卡片式分组（主题预设 / 快捷设置），减少大块空白区域。
- 新增设置分组容器样式（边框、圆角、浅背景）与深色模式适配，层次更清晰。
- 设置入口按钮新增展开态高亮，交互状态更明确。
- 公告中心按钮样式统一（
assets/main.css）： - 统一为与导航同系的中小尺寸按钮（更小圆角、更轻背景、更紧凑高度），避免视觉突兀。
- 移动端适配增强（
assets/main.css）： - 768px 以下设置面板自动单列化，按钮网格保留双列。
- 480px 以下按钮进一步降为单列，避免挤压换行导致错位。
- 资源版本升级（
index.php）： main.css升级为v=20260221-site-polish-v33，确保新视觉样式即时生效。
v1.0.59 (2026-02-21 16:51:05)
顶栏功能下沉到“设置”面板（含移动端适配）
- 该小节更新时间：2026-02-21 16:51:05
- 交互结构调整（
index.php）： - 将“主题切换（深色/浅色）”和“灵动岛开关”从顶栏按钮区下沉到“设置”面板内。
- 顶栏保留语言与“设置”入口，减少主导航拥挤，交互更聚焦。
- 设置面板新增“快捷设置”分组，与“主题预设”并列展示。
- 样式与布局优化（
assets/main.css）： - 新增设置面板分组布局：
ui-settings-grid、ui-settings-section、ui-settings-actions。 - 快捷设置按钮统一高度、对齐和间距，保证视觉一致性。
- 移动端适配：
- 768px 以下“快捷设置”改为两列自适应按钮。
- 480px 以下自动降为单列，避免按钮挤压换行错位。
- 资源版本升级（
index.php）： main.css升级为v=20260221-site-polish-v32，确保设置面板新布局与移动端适配立即生效。
v1.0.58 (2026-02-21 16:41:22)
顶部灵动岛开关显示修复 + 后台显示开关 + 移动端适配
- 该小节更新时间：2026-02-21 16:41:22
- 顶部按钮权限显示逻辑修复（
lib/dynamic_island.php、assets/dynamic-island.js）： - 修复
can_toggle_proxy仅按按钮配置返回导致未登录用户也显示按钮的问题，改为按“按钮配置 + 登录/管理员/免登录启停策略”综合判定真实可操作权限。 - 前端仅在具备真实权限时显示并启用顶部按钮，避免误点后提示权限不足。
- 后台新增“顶部按钮显示”配置（
lib/dynamic_island.php、admin/dynamic_island.php）： - 新增配置项
quick_actions.show_topbar_proxy_toggle（默认开启）。 - 在“灵动岛配置中心 -> 快捷操作与模板”中新增开关：
显示首页顶部“灵动岛开关”按钮。 - 前台通过接口字段
quick_actions.show_topbar_proxy_toggle实时控制按钮显示。 - 顶部按钮样式与文案优化（
assets/main.css、index.php、assets/dynamic-island.js）： - 调整按钮视觉为与顶部导航一致的轻量样式，修复“过红、突兀”的显示问题。
- 开/关状态改为点色提示（绿/红）+ 文案
灵动岛 开/关，降低视觉噪音。 - 增加
aria-label，提升可访问性。 - 移动端适配（
assets/main.css）： - 补充窄屏下按钮宽度与换行适配，避免顶部按钮挤压错位。
- 资源版本升级（
index.php）： main.css升级为v=20260221-site-polish-v31。dynamic-island.js升级为v=20260221-dynamic-island-v4。
v1.0.57 (2026-02-21 16:31:39)
首页顶部新增灵动岛开关按钮（面板按钮接入）
- 该小节更新时间：2026-02-21 16:31:39
- 顶部导航新增“灵动岛开关”按钮（
index.php）： - 在首页顶部
topbar-settings区域新增#dynamicIslandProxyToggle，位置与“设置”按钮同排。 - 默认隐藏，待灵动岛运行数据回传后按权限自动显示，避免无权限用户误触。
- 开关按钮行为接入灵动岛动作接口（
assets/dynamic-island.js）： - 新增顶部按钮状态同步逻辑：根据
runtime.proxy_enabled自动展示“灵动岛：开/关”并同步aria-pressed。 - 点击按钮调用现有
toggle_proxy动作（携带显式enabled值），成功后即时刷新快照并提示结果。 - 灵动岛未启用或当前用户无权限时，按钮自动隐藏/禁用，与后端权限保持一致。
- 视觉与移动端适配（
assets/main.css）： - 新增
.dynamic-island-proxy-toggle样式与开/关态颜色区分（开=绿色、关=红色）。 - 补充移动端按钮间距适配，保证顶部按钮排布一致。
- 资源版本升级（
index.php）： main.css升级为v=20260221-site-polish-v30。dynamic-island.js升级为v=20260221-dynamic-island-v3，确保按钮逻辑与样式立即生效。
v1.0.56 (2026-02-21 16:14:22)
灵动岛全站点击提示重做（苹果风格 + 图标 + 动画 + 移动端适配）
- 该小节更新时间：2026-02-21 16:14:22
- 全站提示条视觉重做（
assets/global-button-tip.js）： - 改为苹果灵动岛风格胶囊外观（深色玻璃质感、圆角黑胶囊、内外高光与阴影）。
- 新增操作图标体系（点击/链接/确认/警示），提示内容左侧显示动态图标。
- 新增进场与退场动画（弹入 + 淡出上移），并支持
prefers-reduced-motion降级。 - 移动端适配：安全区顶边、宽度自适应、字体与图标缩放，避免遮挡与拥挤。
- “不消失”问题修复（
assets/global-button-tip.js）： - 事件触发改为单一
click捕获，移除pointerdown + click双触发导致的重复刷新。 - 增加隐藏状态机与兜底超时清理，确保提示在预期时间内自动消失。
- 同控件短时间重复点击加入节流，避免视觉停留过长。
- 资源版本升级（全站脚本引用）：
- 将
global-button-tip.js统一升级为v=20260221-global-tip-v2，强制浏览器刷新最新样式与动画。
v1.0.55 (2026-02-21 16:01:24)
灵动岛点击提示扩展为全站页面（含后台/用户/认证页）
- 该小节更新时间：2026-02-21 16:01:24
- 新增全站按钮点击提示脚本（
assets/global-button-tip.js）： - 统一监听按钮与链接型按钮点击（
button/input[type=button|submit|reset]/[role=button]/a[href]）。 - 点击任意按钮时显示“灵动岛提示：已点击「按钮名」”，并自动消失。
- 支持按标题、
aria-label、按钮文本等自动提取提示文案，避免出现空提示。 - 首页检测到灵动岛宿主区域时自动避开宿主内事件，避免与原有灵动岛动作提示重复。
- 全站接入页面脚本注入（30 个页面）：
- 覆盖主页、关于页、简洁页、后台管理页、用户中心页、用户/管理员登录与找回密码页，以及安装页。
- 统一追加
<script src="/assets/global-button-tip.js?v=20260221-global-tip-v1" defer></script>，确保所有界面按钮点击都能收到提示反馈。
v1.0.54 (2026-02-21 15:53:47)
灵动岛操作权限与显示一致性修复
- 该小节更新时间：2026-02-21 15:53:47
- 后端动作权限与菜单配置对齐（
lib/dynamic_island.php、api/dynamic-island-action.php）： - 新增快捷按钮集合判定逻辑，
toggle_proxy/switch_node/copy_template/speed_test/diagnose/clear_cache会严格受后台“快捷按钮配置”约束。 - 新增
toggle-proxy-disabled权限错误码，并在动作 API 中映射为403，避免按钮关闭后仍可绕过调用。 - 节点切换动作增加“可用节点组”校验，和前端展示范围保持一致，防止越权切换到非授权节点。
- 前端交互与权限状态对齐（
assets/dynamic-island.js、assets/main.css）： - 节点切换未开放时，节点按钮自动禁用并给出提示，不再展开最近节点列表。
- 队列角标改为尊重后台
show_queue_badge配置，并优化文案为“还有 N 个任务等待”。 - Git 任务区域新增 LFS 同步状态提示（当检测到 LFS 传输时显示）。
- 增加节点按钮禁用态样式，降低误触与状态歧义。
- 资源版本升级（
index.php、about.php、quick.php）： main.css升级为v=20260221-site-polish-v29。dynamic-island.js升级为v=20260221-dynamic-island-v2，确保权限修复与角标/LFS 显示变更即时生效。
v1.0.53 (2026-02-21 15:45:48)
新增灵动岛前台能力 + 后台灵动岛配置中心（含发布回滚）
- 该小节更新时间：2026-02-21 15:45:48
- 前台灵动岛上线（
index.php、assets/dynamic-island.js、assets/main.css）： - 新增灵动岛浮层入口与展开面板，支持连接状态、实时上下行速率、出口 IP、节点延迟、流量环形进度、Git 任务列表与告警展示。
- 新增快捷操作区：启停代理、节点切换、触发生成、复制结果、复制代理/IP/Git 模板、测速、诊断、清缓存。
- 新增手势与交互：点击展开、长按 IP 展示完整地址、左滑呼出最近节点、双击切换极简/标准模式。
- 前端改为轮询
api/dynamic-island.php获取实时状态，通过api/dynamic-island-action.php执行快捷动作并同步快照。
- 后台新增灵动岛配置菜单与管理页（
admin/dynamic_island.php、assets/admin-dashboard.js）： - 新增“灵动岛配置”后台菜单入口，覆盖全后台侧栏自动注入。
- 新增灵动岛配置中心，支持全局开关、用户等级开关、字段可见性、刷新与心跳策略、状态码映射、文案配置、样式配色、位置模式、快捷按钮编排、模板配置、节点/任务策略、风控开关等。
- 新增运行统计看板（曝光、交互、推送触达率、配置发布次数）与“节点切换热度”报表。
- 新增配置发布日志与版本回滚，支持按版本 ID 一键回滚。
- 后端灵动岛核心库与 API（
lib/dynamic_island.php、lib/bootstrap.php、api/dynamic-island.php、api/dynamic-island-action.php）： - 新增统一配置模型（默认值、归一化、存储、版本快照、回滚）。
- 新增前台运行态聚合：连接状态、流量速率/配额、节点信息、Git 任务队列、告警聚合、字段权限裁剪。
- 新增动作执行链路：代理启停、节点切换、模板复制、测速、诊断、清缓存、心跳上报。
- 新增曝光/交互/推送事件记录与后台统计聚合函数，形成“配置-展示-操作-统计”闭环。
- 代理主链路接入全局启停（
proxy.php、api/build-link.php、api/offline-prefetch.php）： - 灵动岛“一键启停”现在会实际影响代理服务可用性。
- 全局关闭时，构建链接、离线缓存与代理请求会直接返回
proxy-disabled/503。
v1.0.52 (2026-02-21 15:05:52)
修复“一键忽略全部”后刷新仍弹窗的问题
- 该小节更新时间：2026-02-21 15:05:52
- 公告忽略逻辑修复（
lib/announcement.php）： - 修复
mark_all_read仅处理前 50 条公告导致“弹窗一键忽略全部”漏标记的问题。 - 当来源为弹窗“
popup-ignore-all”时，改为按弹窗候选范围扩大处理（最多 240 条），并按用户/设备/区域/来源受众规则匹配后统一标记为已忽略。 - 解决“点击一键忽略全部后，刷新页面同一公告仍重复弹出”的问题。
v1.0.51 (2026-02-21 14:51:49)
公告弹窗“一键忽略全部”与服务器目录识别 open_basedir 修复
- 该小节更新时间：2026-02-21 14:51:49
- 公告弹窗能力增强（
admin/site.php、lib/announcement.php、api/announcement.php、assets/announcement.js、assets/main.css）： - 前台公告弹窗新增“一键忽略全部”按钮（中文文案），点击后会一键忽略当前用户可见公告并立即关闭弹窗队列。
- 新增后台全局开关：
site.announcement_ignore_all_enabled，可控制前台是否展示“一键忽略全部”。 - 前台 bootstrap 下发新增
global_show_ignore_all字段；mark_all_read接口新增source标记，便于区分“公告中心一键已读”与“弹窗一键忽略全部”事件来源。 - 公告弹窗新增按钮样式（含暗色主题）。
- 服务器目录识别稳定性修复（
admin/site.php）： - 目录标准化逻辑接入
open_basedir允许路径检查，并对realpath()使用安全调用，避免限制目录触发 Warning 刷屏。 - 自动向上搜索父目录时，遇到
open_basedir限制会立即停止上探，不再继续探测/www、/等受限目录。 - 资源版本升级（
index.php）： announcement.js升级为v=20260221-announcement-v8，确保新按钮与行为修复立即生效。
v1.0.50 (2026-02-21 14:34:21)
服务器目录识别增强（自定义目录 + 自动搜索）与日志详情头部重叠修复
- 该小节更新时间：2026-02-21 14:34:21
- 后台服务器目录识别增强（
admin/site.php）： - 更新日志导入区新增“服务器目录”输入框，可自定义识别路径（支持留空走默认目录）。
- 新增“自动扩展搜索父目录与常见 Web 目录”开关，并支持一键“自动搜索服务器目录”。
- 新增“当前候选目录”可视化提示，识别
CHANGELOG.md/README.md时会使用当前配置并写入审计。 - 服务器目录识别按钮升级为按配置目录执行，失败提示包含已检查路径，便于定位部署路径问题。
- 前台更新日志中心显示修复（
assets/main.css）： - 修复右侧详情区滚动后头部与正文重叠/穿透显示问题（sticky 头部覆盖与内边距策略修正）。
- 详情区背景补充兼容兜底，避免部分浏览器对
color-mix兼容不足时出现透明穿透。 - 资源版本升级（
index.php、about.php、quick.php）： main.css升级为v=20260221-site-polish-v27，确保前台弹窗显示修复即时生效。
v1.0.49 (2026-02-21 14:17:35)
公告弹窗汉化 + 全局“不再提示”开关 + 服务器根目录日志识别
- 该小节更新时间：2026-02-21 14:17:35
- 前台公告弹窗体验修复（
assets/announcement.js、lib/announcement.php）： - 弹窗按钮文案与辅助文案改为中文优先显示（自动兼容旧数据里的英文默认文案）。
- 新增语言文案兜底策略：按钮留空时按当前站点语言自动补齐，不再强制英文。
- 关闭按钮
aria-label同步本地化，避免混合语种体验。 - 全局“不再提示”开关（
admin/site.php、lib/announcement.php）： - 后台站点设置新增“前台公告弹窗显示‘不再提示’复选框”开关。
- 新增
site.announcement_no_remind_enabled配置项并下发到前台 bootstrap。 - 前台弹窗改为“全局开关 + 单条公告设置”双条件控制。
- 更新日志识别能力增强（
admin/site.php）： - 新增“识别服务器根目录 CHANGELOG.md / README.md”按钮。
- 支持自动读取服务器根目录文件并导入更新日志条目，保留版本号同步与审计记录。
- 无法读取时返回明确路径检查提示，便于排查部署目录问题。
- 资源版本升级（
index.php）： announcement.js升级为v=20260221-announcement-v7，确保弹窗汉化与开关逻辑立即生效。
v1.0.48 (2026-02-21 13:59:34)
公告中心/更新日志中心弹窗滚动行为统一修复（右侧详情空白与头部丢失）
- 该小节更新时间：2026-02-21 13:59:34
- 前台更新日志中心与公告中心滚动容器统一（
assets/main.css）： - 两类中心弹窗卡片统一为固定可视高度（桌面
88vh、移动端90vh）并保持overflow: hidden，避免整卡滚动导致头部区域滑出可视区。 - 左右分栏布局统一增加
overflow: hidden，仅允许列表区/详情区内部滚动，交互与公告中心模板保持一致。 - 更新日志头部标题样式与公告中心对齐，减少模板视觉差异。
- 右侧详情切换交互修复（
index.php、assets/announcement.js）： - 切换条目后自动重置详情区滚动到顶部，修复“右侧滚动后看起来空白/内容不在当前视口”的问题。
- 无详情内容时同样回到顶部，避免保留旧滚动位置造成误判。
- 资源版本升级（
index.php、about.php、quick.php）： main.css升级为v=20260221-site-polish-v26。announcement.js升级为v=20260221-announcement-v6，确保公告中心详情滚动修复及时生效。
v1.0.47 (2026-02-21 13:07:22)
更新日志中心增强（拖拽排序 + 分页 + 回收站 + 审计）与上传体验修复
- 该小节更新时间：2026-02-21 13:07:22
- 后台更新日志管理增强（
admin/site.php）： - 新增拖拽排序并支持“保存当前页顺序”（当前筛选/分页结果内生效）。
- 新增分页能力（10/20/50/100 每页）与页内统计提示。
- 新增回收站软删除链路：删除改为“移入回收站”，支持恢复（恢复为隐藏）与永久删除（仅回收站）。
- 新增操作审计写入：识别导入、条目新增/更新、批量操作、排序保存、Markdown 重建、异常均写入管理员审计。
- 新增上传识别前端预检：未选文件、类型错误、超 2MB 会在前端直接提示并阻断提交。
- 新增上传文件预览卡：展示文件名、大小、类型与内容片段预览。
- 前台更新日志弹窗重构（
index.php、assets/main.css）： - 更新日志由“纯 Markdown 展示”升级为“左侧列表 + 右侧详情”中心化阅读模式。
- 新增“全部/仅置顶”筛选、条目统计与详情切换。
- 无结构化条目时自动回退显示原始 Markdown，兼容旧数据。
- 评论图片上传体验增强（
index.php、assets/main.css）： - 新增上传前大小/类型校验（读取后台上传策略）。
- 新增本地图片预览卡片，上传前可先确认文件。
- 取消选择文件时给出明确提示，不再静默无反馈。
- 配置存储编码兼容修复（
lib/comments.php）： app_setting_set()新增 UTF-8 归一化处理。- 遇到
Incorrect string value时自动检查并修复app_settings为utf8mb4后重试，避免中文内容写入触发致命错误。
v1.0.46 (2026-02-21 12:32:30)
更新日志识别能力增强（项目文件识别 + 上传文件自动识别）
- 该小节更新时间：2026-02-21 12:32:30
- 后台站点设置页识别入口增强（
admin/site.php）： - 新增项目文件识别按钮：支持一键识别
CHANGELOG.md、README.md、或“两个文件联合识别（优先 CHANGELOG）”。 - 新增手动上传识别：支持上传
.md/.markdown/.txt后自动识别并导入更新日志条目。 - 上传流程新增校验：文件类型、2MB 体积限制、空文件校验、上传错误提示。
- 识别与落库流程增强（
admin/site.php）： - 新增统一落库方法，识别结果会同步更新
site.changelog_entries、site.changelog_markdown、site.changelog_title与site.app_version。 - 新增去重合并逻辑（按版本 + 标题 + 内容哈希），联合识别多个文件时避免重复条目。
- 新增编码兼容与 BOM 处理（UTF-8/GBK/GB18030/BIG5 尝试转换），减少本地文本文件导入失败。
v1.0.45 (2026-02-21 12:23:50)
站点标识页升级为“更新日志管理中心”（一键识别上传 + 条目级批量管理）
- 该小节更新时间：2026-02-21 12:23:50
- 后台更新日志管理能力增强（
admin/site.php）： - 新增“一键识别并上传”：可从原始 Markdown 自动拆分为日志条目并入库（
site.changelog_entries）。 - 自动识别最新版本号并同步
site.app_version，减少手工维护版本号。 - 新增条目级编辑器：支持新增/编辑单条日志（版本号、标题、内容、状态、置顶、排序权重）。
- 新增批量管理：批量发布、隐藏、置顶、取消置顶、删除、导出 JSON、导出 Markdown。
- 新增单条快捷操作：编辑、发布/隐藏、置顶/取消置顶、删除。
- 新增筛选检索：按关键词、状态筛选日志条目（全部/发布/隐藏/置顶）。
- 新增“从条目重建 Markdown”，保证条目结构化管理与原始 Markdown 同步。
- 后台展示形态优化（
admin/site.php）： - “更新日志 Markdown”改为高级折叠区，避免大文本长期占据主视区。
- 新增公告中心风格的日志卡片列表展示，单条可读性与可操作性显著提升。
v1.0.44 (2026-02-21 12:03:02)
移动端结果详情布局修复（元信息面板被挤压成窄列）
- 该小节更新时间：2026-02-21 12:03:02
- 移动端结果表格宽度冲突修复（
assets/main.css）： - 在移动端强制取消
#resultTable固定列宽（第 1/2/4 列），避免详情行继承窄列宽导致布局塌陷。 - 详情行
result-detail-cell在移动端改为width: 100%，元信息面板可完整占宽显示。 - 元信息行可读性修复（
assets/main.css）： result-meta-row在移动端改为“标签 + 值”同一行栅格（90px + 自适应），避免逐项纵向拉长造成空白过大。- 样式缓存版本升级（
index.php、about.php、quick.php）： main.css升级为v=20260221-site-polish-v22，确保移动端修复即时生效。
v1.0.43 (2026-02-21 11:50:16)
首页历史记录侧栏视觉重构（窄栏卡片化，避免挤压难读）
- 该小节更新时间：2026-02-21 11:50:16
- 历史记录展示重构（
assets/main.css、index.php）： - 右侧“最近生成记录”由窄表格改为卡片化行布局（每条记录按字段分行显示）。
- 历史行新增字段标签（生成时间/平台/资源类型/状态/缓存状态/下载次数/加速链接），可读性明显提升。
- 历史链接区域改为分组卡片，按钮区（回填输入/重新生成）不再被压缩变形。
- 取消历史表格横向滚动依赖，避免右侧窄栏出现“挤成竖排+横向滚动条”的观感问题。
- 调整主区栅格比例，适度放宽右侧历史栏宽度。
- 动态渲染对齐（
index.php）： - JS
renderHistoryRows()输出与首屏 PHP 渲染保持一致的卡片结构与字段标签，筛选/刷新后样式一致。 - 样式缓存版本升级（
index.php、about.php、quick.php）： main.css升级为v=20260221-site-polish-v21。
v1.0.42 (2026-02-21 11:45:38)
后台侧边栏滚动稳定性修复 + 展开/收缩与移动端统一适配
- 该小节更新时间：2026-02-21 11:45:38
- 后台全局侧边栏布局修复（
assets/admin-dashboard.css）： - 侧边栏改为固定布局（
fixed + 100dvh），避免右侧内容滚动到底时左侧菜单“上移”。 - 主内容区改为按侧边栏宽度自动偏移，桌面与移动端切换时保持稳定。
- 新增桌面收缩态样式（mini sidebar）：保留图标入口，收起搜索/配额区，释放主内容宽度。
- 后台全局侧边栏交互增强（
assets/admin-dashboard.js）： - 新增“展开/收缩”状态记忆（
localStorage），桌面刷新后保持用户选择。 - 切换按钮补充
aria-expanded/aria-label/title，交互语义更清晰。 - 菜单项自动补充
title，收缩态下可悬停查看名称。 - 后台账号页对齐全局行为（
admin/account.php）： - 同步接入侧边栏状态记忆与按钮语义，避免该页与其他后台页面行为不一致。
- 后台资源版本统一升级（
admin/*.php）： admin-dashboard.css升级为v=20260221-admin-polish-v13。admin-dashboard.js升级为v=20260221-admin-polish-v7，减少旧缓存导致的样式/行为不一致。
v1.0.41 (2026-02-21 11:37:39)
首页下载进度重复显示修复（移除旧全局进度条）
- 该小节更新时间：2026-02-21 11:37:39
- 首页下载结果区展示修复（
index.php）： - 移除旧版全局下载进度条（
download-progress+progressBar/progressText容器）。 - 保留新版任务卡下载面板（含进度、速度、ETA、暂停/停止等操作）作为唯一进度展示入口。
- 解决结果卡下方出现“第二条下载进度”的重复 UI 问题。
v1.0.40 (2026-02-21 11:30:55)
后台筛选模板兼容性修复（旧浏览器点击无反应）
- 该小节更新时间：2026-02-21 11:30:55
- 后台下载管理筛选模板加载修复（
admin/downloads.php）： - 移除对
CSS.escape的硬依赖，改为form.elements.namedItem()取字段。 - 解决部分环境中“加载筛选模板后字段不回填/看起来点击无反应”的兼容问题。
- 保持原有模板保存、加载、删除交互不变。
v1.0.39 (2026-02-21 11:28:52)
下载元信息交互修复 + 后台下载管理增强（多维统计/筛选/报表/详情/批量）
- 该小节更新时间：2026-02-21 11:28:52
- 首页“刷新元信息/哈希校验”交互修复（
index.php）： - 修复点击后“无反馈”问题，新增清晰状态提示：处理中、成功、失败原因。
- 刷新元信息时增加按钮禁用保护，避免重复点击并发请求。
- 哈希校验完成后明确提示“已完成”，无缓存文件时给出可理解的失败说明。
- 后台下载管理页重构升级（
admin/downloads.php）： - 新增多维看板：总量、成功率、总流量、平均耗时、缓存命中率、超时、拦截、实时带宽。
- 新增可视化图表：
- 折线图：按日/周/月展示请求量、流量(MB)、平均耗时趋势。
- 饼图：平台占比、状态占比、节点占比。
- 热力图：星期 × 小时下载热度分布。
- 新增高级筛选能力：
- 动作类型、状态、处理标记、平台、资源类型、节点、账号、时间范围。
- 流量区间、耗时区间、全文关键词、正则匹配（URL/错误/IP）。
- 筛选模板（前端本地保存/加载/删除）。
- 新增报表导出：
- 支持按当前筛选导出
CSV / JSON / Excel(.xls) / PDF(打印页)。 - 新增下载详情弹层：
- 展示任务 ID、状态码、流量、耗时、标记信息、错误详情、结构化 JSON。
- 提供账号/节点/目标 URL 快速跳转入口，便于排障溯源。
- 新增批量操作：
- 批量标记“已处理/忽略”（含备注）。
- 批量重试/取消（记录为下载控制审计指令）。
- 批量导出选中记录（CSV/JSON）。
- 新增任务队列管理视图：
- 展示最近任务状态、进度、速度、耗时、节点、用户。
- 支持保存调度配置（并发上限/限速/暂停队列）。
- 新增异常检测视图：
- 近 30 分钟 IP 异常请求/失败聚合，辅助告警排查。
- 数据结构新增（
lib/db.php）： - 新增
download_log_marks表，用于下载记录处理标记（已处理/忽略）、备注、操作人、更新时间。
v1.0.38 (2026-02-21 10:43:40)
下载进度准确性修复（大文件小包误判）
- 该小节更新时间：2026-02-21 10:43:40
- 下载进度与总大小修复（
index.php）： - 新增
metadataExpectedSize()，下载任务可优先使用元信息中的文件大小（如1.71 GB）作为预估总大小。 - 修复状态机中
reset后总大小被清空的问题，下载开始/重试后会重新注入元信息总大小，避免再次出现?。 - 大文件下载任务新增异常判定：当预期为大包（
release/archive或元信息 > 5MB）但响应类型为文本且体积很小，直接判定失败并提示链接异常，不再误显示“下载完成”。
v1.0.37 (2026-02-21 10:31:43)
下载异常修复（小文件误判完成 + 直连回退问题）
- 该小节更新时间：2026-02-21 10:31:43
- 下载地址选择修复（
index.php）： - 新增
resolveDownloadUrl()，下载任务改为强制优先使用站内代理下载地址（proxy_url + download=1）。 - 避免在缺少
download_url字段或回退场景误用节点直连 URL，降低“下载到页面文件/提示页”的概率。 - 下载命令按钮改为复用同一下载地址解析逻辑，前后端行为保持一致。
- 下载完成判定与展示修复（
index.php）： - 当响应未返回总大小时，完成态自动用实际下载字节回填总大小，不再显示
?且100%的误导信息。 - 进度文案在未知总大小时改为“完成/进行中”语义，而不是固定百分比。
- 新增异常小文件保护：若响应类型为
text/html/text/plain/json且体积很小，判定为无效下载并提示错误，不再标记为成功。
v1.0.36 (2026-02-21 10:26:30)
结果区操作交互修复（去原生弹窗 + 按钮响应增强）
- 该小节更新时间：2026-02-21 10:26:30
- 首页弹窗体系改造（
index.php、assets/main.css）： - 新增站内统一操作弹层（
uiDialogModal），支持确认/输入/提示模式。 - 结果页原生浏览器弹窗已移除：
confirm/prompt/alert全部替换为站内弹层。 - 新增站内分享弹层（
shareDialogModal）：展示分享链接、二维码、微博/X 快捷入口、一键复制。 - 弹层支持 ESC 关闭、背景点击关闭、焦点回退，统一纳入现有
modal-open滚动锁定逻辑。 - 结果区按钮“点击无反应”修复（
index.php）： 复制按钮增加失败兜底：复制失败时自动打开分享弹层，不再静默失败。分享按钮改为站内分享弹层，不再依赖浏览器原生弹出窗口。- 下载动作（开始/继续/暂停/停止/删除）增加即时状态反馈，点击后立即可见提示。
- 链接打开逻辑改为安全
a标签方式，替代window.open异步调用，减少移动端拦截导致的“无反应”。 - 样式缓存版本升级（
index.php、about.php、quick.php）： main.css->v=20260221-site-polish-v19
v1.0.35 (2026-02-21 10:13:40)
下载流程后端留痕 + 后台控制动作可视化
- 该小节更新时间：2026-02-21 10:13:40
- 新增下载事件上报接口（
api/download-task-event.php）： - 新增下载控制动作留痕：
开始/继续/暂停/停止/重新下载/重试/完成/失败/删除/缓存后下载。 - 每次上报记录任务 ID、状态、已下载字节、总字节、速度、耗时、是否支持断点续传等字段。
- 自动兼容登录身份快照：管理员写入
admin:用户名，普通用户写入用户昵称，未登录写入guest。 - 上报数据写入
access_logs，直接纳入现有审计与导出链路。 - 首页下载流程统一（
index.php）： 缓存后下载改为走同一下载状态机（不再走旧streamDownload逻辑）。- 删除旧下载函数，统一为一套状态流，避免两套实现导致的行为不一致。
- 下载任务新增耗时跟踪（跨暂停/继续累计），并在进度面板显示耗时信息。
- 下载状态变更时自动上报事件，后台可按动作回放完整过程。
- 后台下载管理增强（
admin/downloads.php）： - 动作筛选新增
下载控制动作，可单独查看前端状态机事件。 全部筛选范围扩展为下载 + 离线缓存 + 下载控制动作。- 动作列改为中文语义化展示（如“暂停下载”“下载完成”“删除任务”）。
- 自动解析下载事件明细 JSON，展示任务 ID、状态、进度、耗时、失败原因等关键信息。
v1.0.34 (2026-02-21 10:01:54)
下载状态机与后台下载管理菜单上线
- 该小节更新时间：2026-02-21 10:01:54
- 首页下载控制升级（
index.php、assets/main.css）： - 新增下载任务状态机：
未开始 -> 下载中 -> 暂停中 -> 下载完成 / 下载失败。 - 新增按钮状态联动：
- 未开始：
开始下载 - 下载中：
暂停+停止 - 暂停中：
继续+停止 - 下载完成：
重新下载 - 下载失败：
重试+删除任务 - 每个下载任务生成唯一任务 ID（如
dl-...），并在面板中显示当前状态。 - 新增可视化下载面板：已下载/总大小、百分比进度条、实时速度、预计剩余时间、分块进度（第 n/m 块 + 单块百分比）。
- 进度条 hover 提示补充明细（任务 ID、字节、节点、URL）；下载失败时进度条和状态统一红色提示失败原因。
- 下载中按钮新增转圈动画，暂停后动画自动停止。
- 停止操作会清空当前任务缓存并重置进度为 0。
- 继续下载支持断点续传优先策略（前端自动发送
Range，服务端不支持时自动回退全量下载）。 - 下载操作增强（
index.php）： - 保留并整合
下载命令（复制curl/wget）与缓存后下载流程。 - 全局下载进度条改为同步显示当前活动任务进度、速度和剩余时间。
- 后台新增下载管理页面与菜单（
admin/downloads.php+ 多个admin/*.php）： - 新增菜单项：
下载管理（全后台侧边栏可见）。 - 新增下载管理页：支持按动作类型（下载/离线缓存）、状态、关键词、时间范围筛选。
- 新增下载统计卡片：总记录、成功率、总流量、平均耗时。
- 新增下载日志表：动作、账号、节点、状态码、流量、耗时、IP、目标 URL、失败原因。
- 样式缓存版本升级（
index.php、about.php、quick.php）： main.css->v=20260221-site-polish-v18
v1.0.33 (2026-02-21 09:45:42)
首页结果区无滚动优化 + 下载操作增强 + 元信息补全
- 该小节更新时间：2026-02-21 09:45:42
- 去除结果区横向滚动条（
index.php、assets/main.css）： - 结果表容器新增
result-table-wrap，单独关闭横向滚动。 - 结果表格列宽与换行策略再次收敛，长链接和多按钮场景不再挤出底部滚动条。
- 下载操作增强（
index.php）： - 新增
下载命令按钮：一键复制curl/wget命令。 - 新增
缓存后下载按钮：先离线缓存再执行下载。 - 元信息显示补全（
api/file-metadata.php、index.php）： - 新增
probe_upstream源站探测（HEAD）能力：无缓存时自动尝试获取文件大小/最后修改。 - 文件信息新增来源标识（缓存文件 / 源站探测），并在无缓存时给出操作提示。
- 缓存路径改为“预期路径”可见（即使当前还未生成缓存文件）。
- 样式缓存版本升级（
index.php、about.php、quick.php）： main.css->v=20260221-site-polish-v17
v1.0.32 (2026-02-21 09:34:04)
首页结果区显示优化（修复元信息面板拥挤）
- 该小节更新时间：2026-02-21 09:34:04
- 结果区结构调整（
index.php）： - 将每条结果改为“主信息行 + 元信息详情行（
colspan=4）”，元信息改为整行展示，不再受链接列宽挤压。 - 为主信息行添加
result-main-row，详情行添加result-detail-row，便于精细化样式控制。 - 样式布局优化（
assets/main.css）： - 结果表格升级为固定列布局，明确序号/资源/操作列宽，避免链接和按钮互相挤占。
- 优化操作区按钮最小宽度和换行策略，提升可读性与点击命中。
- 优化详情行边框与间距，桌面端和移动端均保持连续卡片视觉，不出现“裂开”效果。
- 调整
.url换行与溢出策略，减少长链接导致的布局塌陷。 - 样式缓存版本升级（
index.php、about.php、quick.php）： main.css->v=20260221-site-polish-v16
v1.0.31 (2026-02-21 09:19:27)
首页结果区文件信息增强（元信息 + 哈希校验 + 离线缓存队列）
- 该小节更新时间：2026-02-21 09:19:27
- 新增文件元信息接口（
api/file-metadata.php）： - 新增缓存与文件维度数据：缓存状态、TTL/过期时间、缓存路径、文件大小、最后修改时间。
- 新增哈希能力：支持按需计算
MD5/SHA1/SHA256（默认不计算，避免大文件阻塞）。 - 新增访问统计：访问/下载/预取次数、缓存命中率、平均传输速度、最近下载时间。
- 新增节点状态摘要：节点负载占比、探测状态、响应延迟、最新成功率等。
- 新增离线缓存预取接口（
api/offline-prefetch.php）： - 支持将单条结果链接预取到服务器缓存（不触发浏览器下载）。
- 缓存已命中时快速返回
already-cached，未命中时执行上游拉取并写入缓存。 - 预取行为写入访问日志（
action_type=prefetch），便于后续审计与统计。 - 首页结果区交互升级（
index.php）： - 每条成功记录新增“元信息面板”：缓存状态、下载统计、节点负载、存储路径、哈希区块。
- 新增操作按钮：
刷新元信息、哈希校验、加入队列、立即缓存。 - 新增备注能力：每条结果支持本地备注保存（
localStorage持久化）。 - 新增“离线缓存队列”面板：支持任务排队、执行、重试、移除、清空。
- 预览卡片补充元信息摘要（缓存/大小/下载/速度），并根据真实文件大小优化预计下载时间。
- 首页样式增强与响应式适配（
assets/main.css）： - 新增结果操作组、元信息卡、哈希区、备注编辑器、离线队列、预览摘要样式。
- 新增移动端断点优化，避免新增模块引起横向溢出。
- 样式缓存版本升级（
index.php、about.php、quick.php）： main.css->v=20260221-site-polish-v15
v1.0.30 (2026-02-21 08:53:35)
全站横向溢出滚动修复（PC + 移动端）
- 该小节更新时间：2026-02-21 08:53:35
- 后台通用布局溢出治理（
assets/admin-dashboard.css）： - 修复
main-content横向可见溢出导致的整页左右滚动，改为容器内裁剪（保留表格局部滚动）。 - 补齐后台容器收缩约束（
min-width: 0+max-width: 100%），避免网格/卡片最小宽度把页面撑宽。 - 顶部栏标题增加断行策略，右侧操作区允许自适应换行，降低窄屏与高缩放下溢出概率。
- 审计页专项修复（
admin/audit.php）： - 为筛选区、模板行、顶部操作区补充收缩与宽度约束，防止筛选项横向撑出视口。
- 替换内联操作区样式为可复用类，统一响应式行为并降低后续回归风险。
- 用户中心/工单/快捷页兜底（
assets/user-center.css、assets/tickets.css、assets/quick-page.css、assets/auth-pages.css）： - 统一增加横向溢出防护（页面级
overflow-x约束 + 关键容器min-width:0）。 - 修复工单筛选行输入最小宽度在中间断点撑宽的问题（改为不超过容器宽度）。
- 认证与部署页补充视口宽度兜底，避免边缘设备出现左右拖动。
- 样式缓存版本统一升级（
*.php）： admin-dashboard.css->v=20260221-admin-polish-v12user-center.css->v=20260221-user-center-ui4tickets.css->v=20260221-ticket-v4quick-page.css->v=20260221-quick-page-v18auth-pages.css->v=20260221-auth-ui-v2
v1.0.29 (2026-02-21 08:41:11)
全站认证与安装页面 PC/移动端统一优化
- 该小节更新时间：2026-02-21 08:41:11
- 新增认证/安装页统一样式资源（
assets/auth-pages.css）： - 统一认证与部署向导视觉风格（主色、卡片、阴影、输入框、按钮 hover/禁用态）。
- 补齐移动端细节：
100dvh、小屏按钮全宽、输入控件触控尺寸优化、窄屏间距收敛。 - 增加认证页与安装页的响应式断点收敛，保证 PC、平板、手机布局一致性。
- 用户与管理员认证页去重重构（
user/login.php、user/register.php、user/forgot-password.php、user/reset-password.php、user/verify.php、admin/forgot-password.php、admin/reset-password.php）： - 移除重复内联样式，统一接入
auth-pages.css。 - 登录/注册/找回/重置/验证页表单结构与交互样式统一，减少维护成本并提升跨端一致性。
- 初始部署向导响应式重构（
setup/index.php）： - 部署页样式从内联 CSS 重构为统一类样式，卡片化结构和栅格布局升级。
- 部署表单在移动端自动单列，按钮与说明区自适应换行，提升小屏可用性。
v1.0.28 (2026-02-21 08:28:12)
审计安全与风控增强（全链路留痕 + 异常检测）
- 该小节更新时间：2026-02-21 08:28:12
- 审计日志安全字段与不可篡改链路（
lib/db.php）： admin_audit新增环境与安全字段：request_ip、user_agent、session_id、result_state、prev_hash、record_hash。- 新增索引：IP、会话、结果状态、哈希字段，提升后台检索性能。
write_admin_audit()升级为自动记录操作 IP / 客户端 / 会话，并写入哈希链（前序哈希 + 当前记录哈希）。- 新增哈希校验能力：
admin_audit_calculate_row_hash()、admin_audit_verify_row_hash()。 - 新增历史数据渐进回填：
admin_audit_backfill_security_columns()（每次初始化最多回填 120 条），兼容旧环境升级。 - 审计页筛选与导出增强（
admin/audit.php、lib/db.php）： - 新增筛选维度：按
操作 IP、会话 ID检索。 - 新增
哈希状态筛选（全部/已签名/未签名），便于排查历史未签名数据。 - 新增导出格式：
Excel（.xls），并保留CSV。 - 导出字段扩展：包含 IP、会话、客户端、哈希校验状态。
- 审计导出动作自身也写入审计日志（
audit_export_csv/audit_export_excel）。 - 审计页展示与风控提示增强（
admin/audit.php）： - 审计列表新增“环境”列（IP / 会话 / 客户端）和“安全”列（哈希校验通过/异常/未签名）。
- 新增异常行为检测面板：检测 24 小时内短时间重复操作（同管理员 + 同动作 + 同目标）。
- 当前页可疑记录自动高亮，并在“安全”列展示“可疑行为”标记。
- 新增“可视化报表”模块：动作分布、24 小时操作趋势、管理员活跃度排行。
- 详情关键信息中的
node_id/user_id支持直接跳转到对应管理页面。 - 筛选模板保存/应用已同步包含 IP 与会话条件。
v1.0.27 (2026-02-21 08:10:55)
审计时间线与前后对比增强（管理员审计记录）
- 该小节更新时间：2026-02-21 08:10:55
- 审计详情前后对比（
admin/audit.php）： - 新增
old/new差异解析：支持从审计详情 JSON 自动识别old_value/new_value（含同义键）并提取变更。 - 新增差异卡片展示：按“字段路径 / 旧值 / 新值”三列展示，使用新增/删除/修改三种颜色区分。
- 支持长文本自动压缩与截断提示，避免详情列过长导致可读性下降。
- 操作时间线视图（
admin/audit.php）： - 新增“操作时间线”模块，按时间顺序展示当前页操作流。
- 同类批量操作自动归组（同动作 + 同管理员 + 短时间窗口），减少重复信息噪音。
- 新增“折叠同类批量 / 展开全部”交互按钮，支持快速聚焦异常操作。
- 时间线条目展示目标用户、记录 ID 与结果状态，便于回溯。
- 审计页样式增强（
admin/audit.php）： - 增加差异区块与时间线专用样式（状态色、标签、响应式适配），与现有后台视觉风格保持一致。
v1.0.26 (2026-02-21 08:04:59)
审计审阅状态与批量审阅增强（管理员审计记录）
- 该小节更新时间：2026-02-21 08:04:59
- 审计表结构与查询能力补充（
lib/db.php）： admin_audit新增审阅字段：reviewed_by_admin_id、reviewed_at，并增加reviewed_at索引。- 保持升级兼容：历史环境初始化时自动补字段并尝试补索引（重复索引错误自动忽略）。
fetch_admin_audit()新增reviewed筛选（全部/已审阅/未审阅），并联表返回审阅人用户名。- 新增批量方法：
admin_audit_mark_reviewed()、admin_audit_mark_unreviewed()。 - 审计页面批量审阅与筛选联动（
admin/audit.php）： - 新增“审阅状态”筛选下拉，支持按已审/未审快速过滤。
- 审计列表新增“审阅”列，展示审阅状态、审阅人、审阅时间。
- 新增批量工具栏：支持“全选当前页 + 已选计数 + 批量标记已审阅/取消审阅”。
- 批量提交增加前端校验与确认弹窗，避免误操作空提交。
- 批量操作接入 CSRF 校验、操作结果闪存提示，并写入审计留痕（
audit_mark_reviewed/audit_mark_unreviewed）。 - 导出增强（
admin/audit.php）： - CSV 导出新增“审阅状态 / 审阅人 / 审阅时间”字段，便于二次审计与归档。
- 筛选模板增强（
admin/audit.php）： - 本地筛选模板保存与应用时新增
reviewed状态字段，保证模板复用完整。
v1.0.25 (2026-02-21 07:55:04)
审计页重构与筛选能力增强（管理员审计记录）
- 该小节更新时间：2026-02-21 07:55:04
- 审计页面视觉重构（
admin/audit.php）： - 筛选区改为卡片化布局，支持多列响应式排版与快速筛选按钮（今天/本周/本月/清空）。
- 新增审计统计卡片（筛选总数、今日日志、成功/失败、高危操作、动作类型）。
- 审计表格重做：动作语义化标签、结果状态标签、关键信息胶囊、可展开详情区域。
- 详情 JSON 支持自动格式化与语法高亮，便于快速阅读复杂审计上下文。
- 筛选与搜索增强（
admin/audit.php、lib/db.php）： - 支持动作多选、管理员筛选、目标用户关键词筛选（ID/用户名/邮箱）。
- 支持时间范围筛选（精确到分）与详情关键词搜索。
- 新增详情正则搜索（可开关），正则错误时自动回退普通筛选并提示。
- 新增“操作结果”筛选（成功/失败，基于详情语义推断）。
- 支持分页参数保留，筛选翻页更稳定。
- 审计导出与效率提升（
admin/audit.php）： - 新增“导出筛选结果 CSV”按钮，按当前筛选条件导出。
- 新增筛选模板（本地存储）：保存、应用、删除常用筛选条件，一键复用。
- 审计查询能力升级（
lib/db.php）： fetch_admin_audit()扩展支持actions[]/target_keyword/created_from/created_to/detail_keyword/detail_regex/result等过滤参数。- 保持旧参数兼容（如
action/admin_id/target_user_id），避免历史调用中断。
v1.0.24 (2026-02-21 02:38:41)
举报原因乱码修复与举报弹窗改造
- 该小节更新时间：2026-02-21 02:38:41
- 举报原因后端修复（
lib/comments.php）： - 新增
comment_normalize_report_reason()，统一清洗举报原因（去控制字符、限长 200）。 - 修复历史错误默认文案编码（
涓嶅綋鍐呭）为正常中文“不当内容”。 - 举报列表与评论详情中的举报历史读取时，统一做原因文本纠正，历史脏数据可直接正常显示。
- 前台举报交互升级（
index.php、assets/main.css）： - 评论“举报”从浏览器
prompt改为页面内举报弹窗。 - 新增固定举报类型（不当内容/广告垃圾/辱骂攻击/违法信息/其他）+ 可选补充说明。
- 支持
Ctrl/Cmd + Enter提交举报、Esc关闭弹窗，并统一接入页面滚动锁。 - 修复快捷键冲突：举报弹窗输入区使用
Ctrl/Cmd + Enter时不再误触发“批量生成链接”。 - 前台样式资源版本升级（
index.php、about.php、quick.php）： main.css升级到v=20260221-site-polish-v14，确保举报弹窗和样式修复立即生效。
v1.0.23 (2026-02-21 02:28:00)
评论编辑弹窗重构（支持 Markdown 预览 + 图片上传）
- 该小节更新时间：2026-02-21 02:28:00
- 评论编辑交互升级（
index.php、assets/main.css）： - 移除浏览器原生
prompt编辑方式，改为页面内自定义弹窗（双栏编辑 + 预览）。 - 新增 Markdown 快捷按钮（加粗、斜体、链接、图片、代码、引用、列表）。
- 支持
Ctrl/Cmd + Enter在编辑弹窗内直接保存；支持Esc关闭弹窗。 - 评论图片上传能力（
lib/comments.php、api/comments.php、index.php）： - 新增评论图片上传接口动作
upload_image，上传文件写入uploads/comments/YYYYMM/。 - 上传校验复用后台“上传策略”（格式/大小限制与后台配置保持一致）。
- 前台“发布评论”与“编辑评论弹窗”均支持上传图片并自动插入 Markdown 图片链接。
- 评论 Markdown 渲染（
api/comments.php、index.php、assets/main.css）： - 评论接口新增
content_html，后端按安全 Markdown 解析后返回。 - 前台评论卡片改为优先渲染 Markdown HTML，并保留文件链接“加速下载”能力。
- 新增评论 Markdown 样式（标题、列表、引用、代码块、图片、深色主题适配）。
- 前台样式缓存版本升级（
index.php、about.php、quick.php）： main.css升级到v=20260221-site-polish-v13，确保评论弹窗与 Markdown 样式立即生效。
v1.0.22 (2026-02-21 02:09:18)
真实客户端 IP 提取增强（CDN / 反向代理场景）
- 该小节更新时间：2026-02-21 02:09:18
- 请求源 IP 提取逻辑升级（
lib/security.php）： request_ip()从仅使用REMOTE_ADDR改为“可信代理头优先 + 远端地址兜底”。- 新增并按优先级解析
CF-Connecting-IP、True-Client-IP、X-Forwarded-For、X-Real-IP、X-Client-IP、Client-IP。 X-Forwarded-For支持多 IP 链路解析，优先选择公网 IP，避免内网地址污染定位结果。- 新增 IP 归一化/公网校验/代理可信判断辅助函数，降低 CDN、负载均衡、反向代理下的来源 IP 偏差。
v1.0.21 (2026-02-21 02:05:28)
评论区身份修复与维度增强（可切换用户/管理员发布 + 指定用户免审核）
- 该小节更新时间：2026-02-21 02:05:28
- 身份判定与发布身份切换（
lib/comments.php、api/comments.php、index.php）： - 修复“编辑器显示管理员，但评论卡片显示用户”的冲突：当管理员和用户同时登录时，默认按管理员身份发布。
- 新增评论发布身份切换（管理员/用户）下拉：同会话双身份可手动选择发布角色。
- 评论发布接口支持
actor_type，后端按所选身份写入评论归属（admin_id/user_id）。 - 评论区“其他维度信息”补充（
lib/comments.php、api/comments.php、index.php、assets/main.css）： - 新增设备信息（系统 + 浏览器简要识别）展示。
- 新增作者历史评论总数展示。
- 新增相对时间（如“刚刚/xx 分钟前”）展示。
- 新增评论编号显示与“已编辑”状态标签。
- 指定用户免审核（
lib/comments.php、api/admin-comments.php、admin/comments.php）： - 新增后台“免审核用户”配置（支持用户名或用户 ID，逗号分隔）。
- 管理员发布评论默认免审核；命中违规/广告规则仍会被拦截隐藏。
- 支持保存并回显当前免审核用户列表。
- IP 定位策略微调（
lib/comments.php）： - 在线定位优先顺序调整为
ip-api->ipwho.is，优先返回中文地域结果。 - 前台样式资源版本升级（
index.php、about.php、quick.php）： main.css升级到v=20260221-site-polish-v12，确保评论区新增控件与维度样式立即生效。
v1.0.20 (2026-02-21 01:52:08)
评论区 IP 定位准确性升级（多源定位 + 缓存）
- 该小节更新时间：2026-02-21 01:52:08
- 评论 IP 归属地解析重构（
lib/comments.php）： - 新增更稳健的公网/内网识别逻辑，避免保留地址被误判为真实地域。
- 定位来源升级为“请求头优先 + 在线定位服务兜底（
ipwho.is/ip-api）”，提升城市级命中率。 - 新增定位超时保护与容错回退，保证第三方定位失败时不影响评论发布流程。
- 新增配置项：
comments.ip_geo_lookup、comments.ip_geo_timeout_ms、comments.ip_geo_cache_ttl_hours。 - 新增 IP 定位缓存表（
lib/db.php）： - 新增
comment_ip_geo_cache，按 IP 缓存地域结果与来源，减少重复请求并提升响应稳定性。 - 历史环境自动兼容：升级后初始化会自动创建该表。
- 评论写入流程调整（
lib/comments.php）： - 评论创建时
ip_region改为调用新版定位流程，后续前台/后台展示地域信息更精细。
v1.0.19 (2026-02-21 01:41:11)
评论区登录身份自动显示（头像 / 名称）与管理员前台管理
- 该小节更新时间：2026-02-21 01:41:11
- 登录身份展示增强（
index.php、api/comments.php、lib/comments.php）： - 普通用户登录后，评论区自动展示账号头像与名称；评论作者卡片显示“用户”身份标签。
- 管理员登录后，评论区自动展示管理员头像与名称；评论作者卡片显示“管理员”身份标签。
- 游客评论新增统一占位头像与“游客”标签，保持身份层级一致。
- 评论接口与权限能力增强（
api/comments.php、lib/comments.php、lib/db.php）： - 评论列表接口新增作者身份字段（
author_type/author_name/author_avatar_url/author_badge）与viewer当前查看者信息。 - 评论作者归属新增
comments.admin_id（兼容旧库自动补列），用于精确识别管理员评论身份。 - 新增前台管理员操作接口：
admin_set_status（隐藏/显示/审核通过）与admin_delete（删除评论及子回复）。 - 前台评论交互与样式升级（
index.php、assets/main.css）： - 评论卡片新增头像、身份徽章、状态标签（可见/待审核/已隐藏）与管理员操作按钮（隐藏/显示/删除）。
- 评论编辑区新增“当前身份”信息条；登录态自动填充昵称，匿名开关切换时自动同步输入行为。
- 列表 hover 高亮与阴影强化，暗色主题同步补齐新组件样式。
- 前台样式资源版本升级（
index.php、about.php、quick.php）： main.css升级到v=20260221-site-polish-v11，确保头像与身份新样式即时生效。
v1.0.18 (2026-02-21 00:44:51)
评论后台视觉与交互重构（评论管理页）
- 该小节更新时间：2026-02-21 00:44:51
- 评论管理页面视觉重构（
admin/comments.php）： - 顶部统计改为高对比数据卡片（今日/累计/违规/待审核/待处理举报），按状态配色并补充图标。
- 模块统一卡片化、阴影和留白，提升层级清晰度；评论/举报表格行 hover 高亮强化。
- 侧栏品牌区增强渐变风格，当前菜单项高亮强化；新增“折叠菜单”能力，支持长菜单收起/展开。
- 危险操作（批量删除、删除已标记）升级为“双确认”，避免误删。
- 新增评论详情弹层：完整内容、回复链、历史评论、举报历史、IP 与设备信息一屏查看。
- 增加加载骨架（评论/举报表格加载态），避免空白等待。
- 评论筛选与批量能力增强（
admin/comments.php、api/admin-comments.php、lib/comments.php）： - 高级筛选新增：置顶状态、评论范围（主评论/回复）、日期范围、IP 前缀、昵称关键词、内容关键词、点赞区间、正则内容筛选。
- 新增“筛选模板”本地保存/应用/删除（浏览器本地存储）。
- 新增批量操作：批量通过/驳回/隐藏/恢复、批量导出选中评论 CSV。
- 举报管理新增批量处理：批量已处理、批量忽略、批量封禁；支持多次举报高亮预警与关联评论直达详情。
- 规则与审核能力增强（
admin/comments.php、api/admin-comments.php、lib/comments.php）： - 关键词规则类型扩展为：违规词、广告词、敏感词、白名单词。
- 新增规则测试工具：输入文本即时返回命中词、分类、建议状态。
- 新增历史样本预估：对近期评论进行规则影响预览（隐藏/标记/状态变化统计）。
- 数据导出增强（
admin/export_comments.php、lib/comments.php）： export_comments.php支持按ids导出选中评论。- 评论导出函数支持按 ID 列表过滤，便于批量选中导出。
v1.0.17 (2026-02-21 00:29:12)
评论区视觉层次优化（标题 / 输入 / 表情 / 按钮）
- 该小节更新时间：2026-02-21 00:29:12
- 评论区标题区重做（
index.php、assets/main.css）： - 标题升级为“💬 评论区”，增强字重与层级。
- 标题区下方新增细分隔线，并拉开与输入区距离，整体更有呼吸感。
- 输入区样式优化（
assets/main.css）： - 昵称输入框改为更大圆角和更浅边框；悬停时增加轻阴影与边框高亮；聚焦时蓝色描边与光晕更清晰。
- 表情栏间距增大，按钮支持悬停缩放/高亮反馈；新增
is-selected选中态浅蓝底。 - 评论文本框提示文字颜色调浅，边框改浅灰，聚焦时蓝色边框与轻微阴影。
- 按钮与交互优化（
assets/main.css、index.php）： - “最新 / 最热”改为胶囊标签样式，激活态使用主色填充，未激活态为浅灰底深灰字。
- “发布评论”按钮悬停改为更深主色，并保留轻微上移动效。
- 匿名发布复选框与文本对齐，悬停时文字轻微变色。
- 表情按钮补充
aria-pressed与前端选中态同步逻辑，交互语义更完整。 - 前台样式资源版本升级（
index.php、about.php、quick.php）： main.css升级到v=20260221-site-polish-v10，确保评论区新样式立即生效。
v1.0.16 (2026-02-21 00:20:21)
全站界面样式美化（前台 / 后台 / 用户中心 / 工单）
- 该小节更新时间：2026-02-21 00:20:21
- 全站核心样式统一升级（
assets/main.css、assets/admin-dashboard.css、assets/user-center.css、assets/quick-page.css、assets/tickets.css）： - 前台主页/关于页/简洁页增加统一的玻璃质感面板、渐变背景、卡片阴影层级与悬停反馈。
- 后台与用户中心统一强化 topbar、面板、统计卡片、按钮、表格等视觉一致性，提升信息层级和可读性。
- 工单系统（后台 + 用户端）补齐独立视觉层：列表卡片、消息气泡、筛选控件、激活态与暗色主题细节统一优化。
- 样式缓存版本统一升级并补齐无版本号页面（
*.php）： main.css->v=20260221-site-polish-v9admin-dashboard.css->v=20260221-admin-polish-v11user-center.css->v=20260221-user-center-ui3quick-page.css->v=20260221-quick-page-v17tickets.css->v=20260221-ticket-v2- 同步覆盖登录/注册/找回密码/重置密码/验证等此前未带版本号页面，避免旧缓存导致样式不一致。
v1.0.15 (2026-02-21 00:10:04)
后台统计卡片大规模扩容
- 该小节更新时间：2026-02-21 00:10:04
- 仪表盘新增一组“扩展统计（高密度）”卡片区（
admin/index.php）： - 在原有卡片基础上，新增大量统计相关卡片，覆盖趋势窗口、平台、资源类型、节点健康、日志样本、缓存配额与待处理负载。
- 所有新增卡片均保持可点击查看明细，支持键盘访问（
Enter/Space）。 - 新增和补齐大量衍生指标计算（
admin/index.php）： - 趋势窗口指标：窗口访问/下载/命中率、最新桶环比、峰值/低谷等。
- 平台指标：TOP 平台、占比、下载 TOP、缓存最佳、最快/最慢平台。
- 资源类型指标：TOP 类型、占比、下载活跃类型、repo/raw 等访问量。
- 节点指标：24h 请求总量、成功率、缓存率、最忙节点、低可用节点等。
- 日志样本指标：样本成功率、下载率、缓存率、P95 耗时、独立 IP 等。
- 缓存与配额指标：平均缓存文件大小、配额已用/剩余比例、待处理任务总量等。
- 明细弹窗数据源扩展（
admin/index.php、assets/admin-dashboard.js）： dashboardDetailData新增summary_rows、quota_rows、log_rows。- 弹窗表格新增
summary/quota/logs三类数据集渲染，避免新增卡片点击后无明细。 - 前端资源版本升级：
admin-dashboard.js升级到v=20260221-admin-polish-v6。
v1.0.14 (2026-02-20 23:57:41)
后台仪表盘卡片可点击查看明细
- 该小节更新时间：2026-02-20 23:57:41
- 仪表盘三组统计卡片改为可点击交互（
admin/index.php）： - 顶部统计、节点统计、更多统计卡片统一增加
data-stat-*元信息与键盘可访问支持（Enter/Space打开明细）。 - 卡片点击后可查看对应统计项当前值、说明与明细数据，并支持跳转到相关管理页面或定位到对应板块。
- 新增统计明细弹层（
admin/index.php、assets/admin-dashboard.css、assets/admin-dashboard.js）： - 新增“统计明细”弹窗（含标题、当前值、说明、明细表格、快捷跳转按钮）。
- 支持
Esc、点击遮罩、点击关闭按钮关闭弹窗，并在关闭后恢复焦点。 - 弹窗打开时锁定页面滚动，防止后台页面误滚动。
- 新增仪表盘明细数据载荷（
admin/index.php、assets/admin-dashboard.js）： - 新增
dashboardDetailDataJSON，包含趋势、节点、平台、资源类型、热门资源等明细行。 - 前端按卡片数据源动态渲染明细表格（趋势/节点/平台/类型/资源/缓存）。
- 样式与资源版本升级：
admin-dashboard.css升级到v=20260220-admin-polish-v10。admin-dashboard.js升级到v=20260220-admin-polish-v5。
v1.0.13 (2026-02-20 23:45:19)
公告弹窗悬停闪烁修复
- 该小节更新时间：2026-02-20 23:45:19
- 修复鼠标移动到公告弹窗时背景页面闪烁问题（
assets/announcement.js、index.php）： - 公告遮罩节点从
button改为div，避免触发全局button:hover的位移与亮度滤镜动画。 - 升级公告脚本资源版本到
v=20260220-announcement-v5，确保浏览器加载最新修复。
v1.0.12 (2026-02-20 23:39:18)
弹窗系统统一修复（主页公告 / 版本弹窗 / 关于页图片预览）
- 该小节更新时间：2026-02-20 23:39:18
- 修复公告弹窗层级导致的“弹窗内容发灰”问题（
assets/main.css）： announcement-backdrop下沉层级，announcement-card提升层级，确保卡片在遮罩之上。- 修复弹窗打开后背景仍可滚动问题（
assets/main.css、assets/announcement.js、index.php）： - 滚动锁从仅
body扩展到html + body。 - 公告弹窗 / 公告中心 / 版本弹窗 / 更新日志弹窗统一同步
modal-open状态，避免多弹窗并存时状态互相覆盖。 - 修复关于页赞助图片预览弹窗滚动锁不一致（
about.php、assets/main.css）： - 打开/关闭预览时同步控制
sponsor-lightbox-open到html + body。 - 前台页面样式缓存版本统一升级（
index.php、about.php、quick.php）： main.css引用升级到v=20260220-site-polish-v8，减少旧缓存导致的“修复未生效”。
v1.0.11 (2026-02-14 21:45:00)
公告中心视觉修复与易读性优化
- 该小节更新时间：2026-02-14 21:45:00
- 修复公告弹窗“整体偏暗、发灰”问题（
assets/main.css）： - 降低公告遮罩强度，减少背景压暗感。
- 公告卡片改为亮面实色背景（浅色主题为纯白卡片），提升正文可读性。
- 深色主题下保留高对比深色卡片，避免文字发虚。
- 公告中心日志补录完善（
CHANGELOG.md）： - 补全本次样式修复记录。
- 历史版本时间统一补录到“秒”。
v1.0.10 (2026-02-14 21:10:00)
邮件模板管理（后台）
- 该小节更新时间：2026-02-14 21:10:00
- 后台邮件设置页新增“邮件模板管理”（
admin/mail.php）： - 支持按模板编辑邮件主题与 HTML 正文。
- 支持每个模板查看变量说明（
{{变量名}}）。 - 支持每个模板独立发送测试邮件（可自定义收件邮箱）。
- 新增“删除自定义模板”与“默认/自定义模板切换”能力。
- 每个模板卡片显示当前生效来源与自定义内容状态。
- 新增邮件模板能力（
lib/mail.php）： - 内置模板目录、变量替换、模板覆盖保存与恢复默认。
- 新增模板自定义启用状态持久化（默认/自定义切换）。
- 模板测试发送能力（优先测试邮箱，回退通知邮箱/发件邮箱）。
- 现有邮件通知接入模板渲染：
- 用户注册验证邮件（
user/register.php） - 用户注册成功邮件（
user/verify.php） - 评论管理员通知 / 评论回复通知（
lib/comments.php） - 节点监控汇总告警邮件（
lib/node_monitor.php）
忘记密码（管理员 + 用户）
- 该小节更新时间：2026-02-14 21:10:00
- 新增用户忘记密码流程：
user/forgot-password.php（申请重置链接）user/reset-password.php（通过 token 重置密码）- 登录页新增入口（
user/login.php） - 新增管理员忘记密码流程：
admin/forgot-password.php（申请重置链接）admin/reset-password.php（通过 token 重置密码）- 后台登录页新增入口（
admin/login.php） - 认证与数据层新增重置能力：
- 新增请求/消费重置 token 逻辑（
lib/auth.php、lib/db.php）。 - 新增重置 token 表：
user_password_resetsadmin_password_resets- SQL 初始化脚本同步更新（
sql/gh-proxy-app.sql）。
公告中心
- 该小节更新时间：2026-02-14 21:10:00
- 新增公告中心“一键已读”功能（
index.php、assets/announcement.js、api/announcement.php、lib/announcement.php）： - 公告中心弹窗新增“一键已读”按钮。
- 新增批量已读接口
action=mark_all_read，服务端持久化用户公告阅读状态。 - 前端同步刷新未读角标和列表状态，避免重复提示。
- 公告中心入口与交互体验升级（
index.php、assets/main.css、assets/announcement.js、lib/announcement.php）： - 公告中心入口从右下角浮动按钮移至顶部导航中间区域，未读角标保留。
- 公告弹窗头部新增“总数/未读数”摘要与“全部/仅未读”筛选。
- 公告状态文案改为中文展示（如
published -> 已发布、offline -> 已下线）。 - 公告列表新增状态标签与时间展示，详情区补充发布时间与已读状态。
- 选中公告 ID 本地记忆，重新打开弹窗可恢复上次阅读位置。
- 支持键盘快速浏览（
ArrowUp/ArrowDown/Home/End）与更完整的焦点回退。 - 新增单条公告“标记已读”事件（
mark_read）并持久化，减少重复未读提醒。
节点监控面板
- 该小节更新时间：2026-02-14 21:10:00
- 监控节点筛选新增“全部节点”（
admin/nodes.php、lib/node_monitor.php）： - 支持查看全节点聚合趋势曲线。
- 默认加载“全部节点”视角。
- 节点实时摘要指标改为按所选时间窗口统计（基于
access_logs聚合）： - 请求数、成功率、平均耗时、缓存命中、吞吐、并发、磁盘 I/O 不再只看最近一次巡检快照。
- 指标含义与“时间窗口”选择保持一致，降低“全是 0”误解。
v1.0.9 (2026-02-14 19:40:00)
节点管理与告警通知修复
- 该小节更新时间：2026-02-14 19:40:00
- 后台仪表盘新增“节点统计”卡片组（
admin/index.php）： - 节点总数、启用/停用、主/备、自动下线、24h 巡检、未恢复告警。
- 数据由
fetch_dashboard_stats()提供，支持节点配置与监控状态联动（lib/db.php）。 - 修复节点管理页统计卡片“数据不变”问题（
admin/nodes.php）： - 前端轮询监控数据后实时同步顶部统计卡片。
- 未恢复告警改为使用真实未恢复总数（不再受最近告警列表条数影响）。
- 节点告警邮件改为“每轮巡检汇总发送”（
lib/node_monitor.php）： - 同一轮新增告警合并为一封邮件（每个收件人一封汇总），不再逐条拆分发送。
- Webhook 也改为按批次汇总推送。
- 发件人名称统一品牌化（
lib/mail.php）： - 自动在发件人名称中加入“GitHub 资源加速”标识，空名称时使用该品牌名。
- 新增管理通知“一键关闭”能力（
admin/mail.php）： - 新增
mail.notify_enabled全局开关与“一键关闭通知”按钮。 - 当前覆盖评论管理员通知与节点告警邮件通知（
lib/comments.php、lib/node_monitor.php）。
v1.0.8 (2026-02-14 17:25:00)
全站安全与稳定性
- 该小节更新时间：2026-02-14 17:25:00
- 新增全局“同源状态变更”校验（
lib/security.php+lib/bootstrap.php）： - 对非
GET/HEAD/OPTIONS请求校验Origin/Referer是否同源。 - 对跨站来源请求统一返回
403（API 返回csrf-origin-mismatch）。 - 后台关键配置页新增 CSRF token 防护并支持提交后轮换：
admin/site.phpadmin/upload_policy.php
功能增强
- 该小节更新时间：2026-02-14 17:25:00
- 首页（
index.php）新增“复制本次成功链接”： - 批量生成后可一键复制所有成功结果（自动去重）。
- 按成功数量动态更新按钮状态与文案。
- 首页新增输入草稿自动保存：
- 输入内容自动写入本地缓存，刷新后自动恢复草稿。
- 简洁页（
quick.php+assets/quick-page.js）新增“复制最佳链接”： - 自动按“节点直连 > 站内代理 > 原始链接”选择优先链接并一键复制。
- 简洁页新增输入草稿自动保存与恢复（本地缓存）。
Bug 修复
- 该小节更新时间：2026-02-14 17:25:00
- 修复公告弹窗强制阅读倒计时定时器未清理问题（
assets/announcement.js）： - 关闭弹窗时清理残留
setInterval。 - 修复延迟展示计时器重复触发边界情况。
- 修复评论加载失败信息直接拼接 HTML 的风险（
index.php）： - 改为
textContent输出错误信息。 - 优化后台侧栏开关可访问性（
assets/admin-dashboard.js）： - 同步维护
aria-expanded，移动端开合状态更准确。
样式与可用性
- 该小节更新时间：2026-02-14 17:25:00
- 全站新增键盘焦点可视化与“减少动态效果”适配：
assets/main.cssassets/admin-dashboard.css- 后台顶部管理员名称样式统一迁移到 CSS，移除重复内联样式。
- 前台/后台资源版本号统一升级，减少旧缓存导致的样式与脚本不一致。
v1.0.7 (2026-02-14 14:55:00)
工单系统（用户端 + 后台端）
- 该小节更新时间：2026-02-14 14:55:00
- 新增用户工单中心：
user/tickets.php - 支持开始工单、回复工单、结束工单、重新开启工单。
- 支持状态筛选、关键词搜索、分页与会话详情查看。
- 新增后台工单管理：
admin/tickets.php - 支持按状态/优先级/关键词筛选工单。
- 支持管理员回复、结束工单、重开工单。
- 新增工单统计卡片与会话流视图。
- 导航接入：
- 前台登录态菜单新增“我的工单”（
index.php、user/account.php、user/settings.php）。 - 后台侧栏统一新增“工单管理”菜单（多后台页面静态接入 +
assets/admin-dashboard.js兜底注入）。
通知与数据层
- 该小节更新时间：2026-02-14 14:55:00
- 新增工单核心库：
lib/tickets.php - 工单状态流转：
pending_admin/pending_user/closed。 - 优先级：
low/normal/high/urgent。 - 用户与管理员双向回复、结束、重开流程。
- 用户/管理员未读计数与已读时间维护。
- 邮件通知接入：
- 用户创建/回复/结束/重开时通知管理员。
- 管理员回复/结束/重开时通知工单所属用户。
- 复用现有邮件发送/队列机制（
send_or_queue_email）。 - 数据库结构新增：
support_ticketssupport_ticket_messages- 运行时建表与 SQL 初始化脚本同步更新（
lib/db.php、sql/gh-proxy-app.sql）。
Markdown 与图片上传
- 该小节更新时间：2026-02-14 14:55:00
- 工单内容支持 Markdown 渲染（标题、列表、代码块、链接、图片等）。
- 新增工单图片上传（用户端/后台端）：
- 上传目录：
/uploads/tickets/YYYYMM/ - 限制：JPG/PNG/WebP/GIF，单图最大 8MB。
- 修复“上传后看不到图片”问题：
- 上传接口改为优先返回绝对 URL（
lib/tickets.php）。 - Markdown 安全 URL 增加站内相对路径支持（
lib/markdown.php）。
仪表盘统计
- 该小节更新时间：2026-02-14 14:55:00
- 后台仪表盘新增工单指标：
- 工单总数
- 待处理工单
- 相关统计由
fetch_dashboard_stats()提供（lib/db.php、admin/index.php）。
导航易用性
- 该小节更新时间：2026-02-14 14:55:00
- 新增品牌区返回首页能力：
- 前台顶部品牌（Logo + 站点名）点击可返回主页（
index.php、quick.php、about.php）。 - 后台/用户中心侧栏品牌（Logo + 站点名）点击可返回主页（
admin/*.php、user/*.php）。 - 后台登录页品牌区点击可返回主页（
admin/login.php）。 - 修复用户中心移动端侧栏菜单“可见但不可点”问题：
- 调整用户中心壳层与遮罩层叠放关系，避免遮罩压住侧栏菜单点击区（
assets/user-center.css）。 - 升级用户中心样式资源版本，避免手机命中旧缓存（
user/settings.php、user/account.php、user/tickets.php）。
全站图片上传限制（后台可配置）
- 该小节更新时间：2026-02-14 14:55:00
- 新增统一上传策略库（
lib/upload_policy.php）： - 允许扩展名白名单（如
jpg,jpeg,png,webp,gif）。 - 单文件大小上限、单次上传数量上限、单次总大小上限。
- 上传文件统一 MIME/内容校验与错误信息返回。
- 后台“站点标识”新增上传限制配置项（
admin/site.php）： - 管理员可在线修改并保存全站图片上传策略。
- 配置写入
app_settings（upload.image_*）。 - 配置校验失败时保留当前输入并回显，避免参数看起来“未生效”。
- 后台菜单拆分“上传策略”独立入口（
admin/upload_policy.php）： - 侧栏新增单独菜单“上传策略”，统一管理全站图片上传限制。
站点标识页面移除上传限制表单，改为跳转提示，避免功能混杂。- 上传入口接入统一策略：
- 工单图片上传（
lib/tickets.php、user/tickets.php、admin/tickets.php）。 - 关于页赞助图片上传（
admin/about.php，含前端批量导入时的数量/大小预校验）。
v1.0.6 (2026-02-14 10:20:00)
后台关于与赞助（admin/about.php）
- 该小节更新时间：2026-02-14 10:20:00
- 赞助图片上传新增文字水印功能：
- 可选开关、文字、位置、透明度、字号、颜色。
- 水印在上传前与压缩/旋转/裁剪/格式转换一起处理，保存后直接可用。
用户中心重构（user/settings.php、user/account.php、assets/user-center.css、assets/user-center.js）
- 该小节更新时间：2026-02-14 10:20:00
- 用户中心视觉重做（移动端优先）：
- 新增专用样式
assets/user-center.css，重构背景层、顶部栏、卡片、表单、按钮与深色模式对比。 - 修复小屏空白感强、控件原生风格重、信息层级弱的问题，并统一“图标按钮 + 紧凑间距”。
- 用户设置页增强：
- 新增“快捷入口 + 当前配置摘要”卡片区，实时展示默认节点、缓存模式、TTL、主题和通知状态。
- 新增节点快速定位（按名称/ID输入自动命中）、TTL 快捷芯片（1 小时/1 天/7 天/30 天/不缓存）与智能建议。
- 新增设置导入/导出（JSON）、
Ctrl/Cmd + S快捷保存、未保存变更提示、恢复默认并保存。 - 新增“保存后返回首页”选项，提交后可直接跳转首页。
- 账号管理页增强：
- 新增安全概览卡片（邮箱、注册时间、密码状态）与快捷入口。
- 新增邮箱一键复制、密码显示/隐藏、密码强度条、确认一致性提示、强密码生成与快速清空。
- 新增表单未保存状态提示，提升移动端编辑可用性。
- 保留并整合既有稳定性修复：
user-mobile-mode侧栏收起策略、用户页 Logo 尺寸兜底、已登录菜单项统一、真实缓存统计值展示。
前台简洁下载页（quick.php）
- 该小节更新时间：2026-02-14 10:20:00
- 交互语义统一：
- 主按钮文案统一为“生成加速链接”。
- 生成成功后默认不再自动弹出新标签页，改为先展示结果面板。
- 结果区布局重构：
- “本次生成结果”固定显示在“当前选择节点”下方，首屏可见。
- 结果区改为三列卡片（原始链接/站内代理/节点直连）。
- 每列卡片底部提供就近操作按钮：
复制（左）+打开下载（右）。 - 三个“打开下载”分别对应三条链接，避免一个按钮对应多链接的歧义。
- 节点展示优化：
- 当前选择节点卡片实时显示节点 ID、角色、状态、延迟、备注。
- 当数据库节点与
direct（本站主节点）前缀相同，前台节点卡片自动去重，优先保留主节点。 - 测速行为与反馈修正：
- 批量测速与手动测速统一为全量测速流程（并发执行）。
direct节点改为实时探测本站资源，不再固定复用旧延迟值。- 全局测速进行中时，当前选择节点统一显示“测速中”，避免旧毫秒值误导。
- 状态栏“正在...”提示按进行中样式显示，不再误显示为错误态。
- 深色模式与可读性：
- 节点卡片、结果卡片、按钮在深色主题下对比度增强。
- 资源版本：
quick-page.css：20260214-quick-page-v14quick-page.js：20260214-quick-page-v18
新增“关于”菜单（quick.php、assets/quick-page.css、assets/quick-page.js）
- 该小节更新时间：2026-02-14 10:20:00
- 顶部菜单新增“关于”按钮，点击后在页面下方展开面板（非新页面）。
- 面板内新增三个标签页：
关于本项目联系我赞助我- 接入以下外部二维码图片并支持“查看原图”：
- GitHub 资源加速 QQ 用户群
- 个人微信
- 个人 QQ
- 微信收款码
- 支付宝收款码
- 交互细节：
- 点击空白区域自动收起关于面板。
- 移动端点击“关于”后自动收起顶部折叠菜单，避免重叠。
- 深色模式与移动端样式同步适配。
- 顶部导航统一：
- 简洁页顶部导航结构与主页
index.php对齐（同一套布局与分组），仅保留页面跳转行为差异。 - “关于”入口改为右侧导航项，点击后在页面下方展开面板。
- 资源版本更新：
quick-page.css：20260214-quick-page-v14quick-page.js：20260214-quick-page-v18
v1.0.5 (2026-02-13 21:30:00)
后台界面与移动端适配
- 该小节更新时间：2026-02-13 21:30:00
- 后台壳层统一与移动端交互补齐：
admin/mail.php、admin/cache.php、admin/nodes.php切换为统一后台布局（侧栏/顶部/移动端侧栏交互）。- 多后台页面补齐移动端侧栏展开/收起脚本，修复“菜单不可用/布局错位”。
- 后台移动端显示修复：
- 修复窄屏下内容裁切、右侧被截断、按钮空白、表格不可读等问题。
- 图表与表格容器统一支持横向滚动查看。
- 后台可用性增强：
- 顶部新增字号调节（小字/标准/大字）并本地持久化。
- 新增“返回首页”入口（壳层页面顶部 + 独立页面快捷区）。
- 仪表盘增强：
- 节点统计改为“启用节点数”，并按当前启用配置实时计算。
- 新增更多统计项：用户总数、今日新增、链接总数、评论与审核、公告与邮件等。
节点管理与巡检
- 该小节更新时间：2026-02-13 21:30:00
- 节点管理新增备注字段（新增/编辑/复制/模板/导入全链路支持）。
- 节点筛选增强：状态、角色（主/备）、备注（有/无）组合筛选。
- 批量识别导入：支持从文本/Markdown 自动提取 URL，按前缀去重导入。
- “立即执行一次巡检”改为异步触发 + 快速参数，降低页面卡顿。
- 节点上限提升到
256，支持更大节点池。
前台首页与结果展示
- 该小节更新时间：2026-02-13 21:30:00
- 首页结果区支持同时展示“站内代理链接”和“节点直连链接”。
- 结果表增加实际命中节点信息，便于核对节点选择是否生效。
v1.0.4 (2026-02-13 19:45:00)
缓存管理增强
- 该小节更新时间：2026-02-13 19:45:00
- 新增缓存条目列表（哈希、大小、状态码、资源类型、节点、更新时间）。
- 支持哈希过滤、分页浏览、单条/批量删除。
- 缓存操作改为 PRG（POST-Redirect-GET），避免重复提交。
品牌与导航修正
- 该小节更新时间：2026-02-13 19:45:00
- 后台 Logo/品牌区增加尺寸与布局兜底，降低缓存样式导致的错位概率。
- 默认关闭 iframe 内嵌后台导航，避免后台“套娃”。
- 后台菜单文案统一为完整名称并补齐入口。
v1.0.3 (2026-02-13 18:10:00)
缓存清理安全修复
- 该小节更新时间：2026-02-13 18:10:00
clear_cache_files()/clear_expired_cache_files()仅清理代理缓存产物（*.bin、*.json、up_*）。- 保留
cache/install.lock与cache/runtime-config.php，修复“清空缓存后误回到安装向导”的问题。
v1.0.2 (2026-02-13 16:35:00)
品牌配置能力
- 该小节更新时间：2026-02-13 16:35:00
- 后台新增站点品牌配置：
- 站点名称：
site.brand_name - 浏览器标题：
site.browser_title - 前台 Logo：
site.logo_url - 后台 Logo：
site.admin_logo_url - Favicon：
site.favicon_url - 前后台页面接入统一品牌渲染与 favicon 输出。
- 新增品牌工具库：
lib/site_branding.php。
已知问题
- 该小节更新时间：2026-02-13 16:35:00
- Logo/Favicon 使用外链时依赖源站可用性。
- 触发条件：外部图片源不可达或限流。
- 临时处理：优先使用本地静态路径（如
/assets/logo.png、/assets/favicon.ico）。
v1.0.1 (2026-02-13 15:05:00)
基础优化
- 该小节更新时间：2026-02-13 15:05:00
- 重构
README.md，补齐部署、维护、配置与 API 文档。 - 运行时配置写入与检查优化：
lib/install.php增强runtime-config.php可读性检查。cache/runtime-config.php与cache/install.lock默认权限从0600调整为0640。- 维护任务流程确认：
scripts/process_maintenance.php（邮件队列 + 节点巡检）建议每分钟执行。
已知问题
- 该小节更新时间：2026-02-13 15:05:00
- 定时任务偶发数据库登录失败（
SQLSTATE[HY000] [1045] ... using password: NO）。
- 触发条件：CLI 环境未读取到正确的
db.password。 - 临时处理：检查
cache/runtime-config.php中db.password，并确保 cron 与站点使用同一运行用户。
- 历史部署可能遗留运行时配置不可读（
Permission denied）。
- 触发条件：旧版本
cache/runtime-config.php权限为0600且执行用户不一致。 - 临时处理：修正
cache/目录 owner/group 与权限（目录建议750，文件建议640）。
- 部署后改动
config.php的数据库配置不一定即时生效。
- 原因：系统优先读取
cache/runtime-config.php。 - 临时处理：通过
setup/index.php重新写入运行时配置，或手动更新cache/runtime-config.php。
问题反馈 (2026-03-24 12:47:46)
问题反馈
如需提交问题，请附带以下信息：
- 报错完整栈
- 执行用户（Web/cron）
cache/runtime-config.php权限与属主- 数据库连接配置来源（环境变量或运行时配置）
评论区