 置顶 [程序发布] FlintHub 1.3.0 完整安装包发布（附：V1.2.0 → V1.3.0变动说明）

时间跨度：2026-10-20 ~ 2026-10-30 说明：本汇总按发版顺序整理，每条只保留「改了什么、对站长和用户有什么影响」。V1.2.18 为内部构建号，正式对外发版为 V1.3.0（签名包）。

总览

逐版说明

V1.2.0（2026-10-20）— 回到顶部

• 首页、论坛页与版块页、帖子详情页、博客页与博客分类页、博客详情页，右下角浮动按钮区新增「回到顶部」箭头按钮。
• 页面向下滚动超过 300 像素后按钮才出现，点击平滑回到页首；未达阈值时按钮既不可见也不占位，不会出现「点了没反应」。
• 帖子详情页原有的「发新帖」浮动按钮让位，「回到顶部 / 返回版块 / 回复」三个按钮保持不拥挤。
• 文案随语言切换（简 / 繁 / 英），并尊重访客系统的「减少动态效果」设置。纯前端改动，升级无需额外操作。

V1.2.1（2026-10-20）— 表单扩展点

• 注册页、登录页、帖子回复框的表单内各新增一个插件挂载点，位置在提交按钮上方。
• 只对插件生效：没装相关插件时页面不产生任何多余元素，站长与访客完全无感。
• 插件作者可据此把验证组件（人机验证、协议勾选等）直接挂进表单，隐藏字段随表单一起提交。纯扩展点改动，不动布局与交互。

V1.2.2（2026-10-20）— 表情尺寸修复

• 修复：装上 vditor / cherry 等编辑器插件后，帖子详情页（含主帖、回帖、楼中楼）的站内表情被显示成 96×96 大图；不装插件时本应是 28×28 小图标，楼中楼里对比最刺眼。
• 同版渲染白名单补上 mark 标签，配合编辑器的「高亮」按钮正常显示。

V1.2.3（2026-10-20）— 表单排版微调

• 发帖页：分类下拉框与标题所在行补齐下边距，「内容」标签不再贴在输入框底边。
• 发博客页：分类调整到标题之前，与发帖页布局保持一致。
• 只涉及 2 个视图，无数据库结构变更、无业务数据变更、无新增配置项。

V1.2.4（2026-10-21）— 编辑器事件总线

• 修复：块级格式命令可能摧毁整个编辑区；内容编码失败导致正文丢失；Markdown 与可视化切换后格式、颜色、表情丢失；Markdown 模式粘贴网页内容只剩纯文本。
• 新增：对外开放「就绪 / 选区变化 / 提交前」三个事件与「读选区 / 替换选区」两个方法，插件可做划词气泡、AI 改写、语法检查，无需改核心。
• 插件拿到的选区内容会保留加粗、颜色、链接等格式；点气泡按钮不再插错位置。
• 站长可一键熔断：模板里加一行 window.FLINT_EDITOR_HOOKS = false 即可关掉所有编辑器钩子，无需回滚核心。

V1.2.5（2026-10-21）— 快捷键按钮空白

• 修复编辑器工具栏最后一个按钮（「快捷键」）显示为空白方块的问题。按钮功能本身正常，只是图标缺失。
• 根因：手写的 FontAwesome 类清单里没有 fa-keyboard-o 这一条，补齐后正常显示。

V1.2.6（2026-10-25）— 右栏语义分流

• 详情页右栏用户卡片按钮按页面语义分流：发帖页给「发帖」，帖子详情页给「回帖 / 评论」，不再全局一个「发帖」跳错地方。
• 显隐门禁与详情页回复框同源（可回复 + 归档 + 删除预览 + 登录态），归档帖对普通用户不渲染按钮。
• 新增核心兜底用户主页 /u/{id}；详情页右栏的插件面板下线（改由新钩子接管），博客详情页右栏同步收敛。

V1.2.7（2026-10-25）— 密钥告警加固

• 修复后台控制台黄色告警文案在「（内容为」处被截断：原因是示例代码里的 <?php 未做 HTML 转义，被浏览器当成伪注释吞掉。
• 修复「设置了密钥，告警还在」：只设一条关不掉、四种写法静默无效、mail_key.php 带 BOM 会降级 session 安全配置。
• 修复新装站点（1.2.6 及以前）的告警误报；三条文案三语同步改写。

V1.2.8（2026-10-25）— PC 端界面优化

• 左侧栏可收起为 56px 窄条，把宽度让给内容区；登录用户与游客的选择都会被记住。
• 帖子页的淘贴 / 分享 / 收藏 / 举报等操作自动收纳进「更多」菜单，窄屏下每项带文字说明。
• 顶部齿轮面板集中放置语言切换、外观设置与右栏显示开关；通知中心支持「清空通知」（二次确认，清空不可恢复）。
• 页面内联脚本改为外链加载，首页源码减少约 150 行，首屏解析更快。

V1.2.9（2026-10-26）— 主题顶栏统一

• 烈焰红霞、琥珀暖橙、翡翠绿、紫罗兰四个主题的顶部导航栏由深色改为浅色，与暖沙米金一致。
• 四个主题同步加入页面底色渐变、主按钮渐变与移动端发帖按钮渐变；琥珀暖橙底色向暖橙微调，与暖沙米金一眼可区分。
• 导航文字对比度全部提升到 WCAG AA 以上（5.7 ~ 6.6 : 1）。

V1.2.10（2026-10-26）— 顶部 logo 精简

• 顶部导航左侧 logo 由两行改一行：去掉第二行站点描述，改挂到 logo 链接的 title 属性上，鼠标悬停由浏览器提示。
• 宽屏（≥1024px）下同步放大站名与图标；窄屏本来就不显示描述行，这次直接省掉一行高度。

V1.2.11（2026-10-26）— 「我的主题」

• 发帖页（/post/new）右栏的「发新帖」按钮改为「我的主题」，指向自己的用户主页。
• 原因：该按钮指向的正是当前页，点一下等于重新 GET，编辑器归零、?category_id= 预选丢失，且外观与页底「发布」键几乎一样，容易误点。
• 只在发帖页生效，首页 / 论坛列表 / 版块页 / 标签页的右栏按钮一行未动。

V1.2.12（2026-10-26）— 标题与副标题

• 首页浏览器标题增加副标题（后台可配置），例如「FlintHub - 轻量级 PHP 论坛、博客系统」。
• 帖子详情页与用户主页补回站名，标签页标题不再只剩内容标题。

V1.2.13（2026-10-26）— 图片插入光标

• 修复可视化编辑器上传 / 粘贴图片成功后，光标停在图片前面、接着打字会跑到图上的问题；插入后光标落在图片之后，直接继续写作即可。
• 根因是移除占位节点时未同步调整 Range 边界点，已按 DOM 规范修正。

V1.2.14（2026-10-26）— 包体清理

• 删除核心包内的 app/LifeBuilder.php（0 字节空文件，全站无任何引用），每个版本都白带，这次清掉。

V1.2.15（2026-10-27）— PoW 设置

• 后台「系统设置」新增「PoW 设置」Tab：PoW 人机验证总开关 + 难度设置。
• 关闭后同时发生三件事：前台不再下发 PoW 脚本（少一个请求）、后端校验直接放行、核心自带图片验证码同步停用——人机验证可完全交给第三方插件。

V1.2.16（2026-10-27）— 回灌工具修正

• 本版只含一个文件 cli/user_level_rebuild.php（「信任等级」插件的历史流水回灌工具），修复该工具回灌异常；无功能新增、无结构变更、无配置项变更。

V1.2.17（2026-10-28）— blob Worker 被拒

• 修复启用 Cap 人机验证等基于 blob Worker 的组件时，浏览器控制台报 CSP 拒绝创建 Worker 的错误。
• 改动：CSP 补充 worker-src 'self' blob:；其余指令不变，不影响既有页面。

V1.2.18（2026-10-30）— 伪静态双模式（内部构建号）

• 完整实现伪静态（URL Rewrite）双模式，内容与 V1.3.0 一致；此号仅用于内部构建，未对外发布。

V1.3.0（2026-10-30）— 伪静态双模式（正式发版）

一、开箱可用：不开伪静态也正常

• 路由层同时识别 /thread/1（伪静态）与 /index.php/thread/1（PATH_INFO）；开关只决定生成哪种链接，不影响哪种链接能访问。
• 新增统一 URL 出口 app/Helpers/Url.php；存量站缺 rewrite_enabled 键时按「开启」回落，升级后链接形态不变，只有新装站点默认写「关闭」。

二、后台「系统设置 → 伪静态」

• 总开关 + 服务器类型（Nginx / Apache / IIS）+ 可复制规则代码块 + 一键检测；切换开关自动清前台页面缓存，游客不会拿到旧形态链接。
• 第三方规则（Discuz! X / WordPress / ThinkPHP）只读对照，红字提示「仅作对照，直接套用会与本程序冲突」，不提供复制按钮。
• 规则模板集中管理，并开放插件扩展钩子 rewrite_rules_collect（以 # --- 插件扩展规则 --- 分隔并入）。

三、探针与防锁死

• 新增 GET /__rewrite_probe（零数据库、维护模式白名单）与 POST /admin/settings/test-rewrite（CSRF + 5 次 / 60 秒限流 + 5 秒超时自测）。
• 开关「关 → 开」时服务端强制探针，不通就拒绝保存并回显错误码；「开 → 关」不校验。
• 目标主机只允许站点自身，拒绝任意 URL 输入，防止被当成 SSRF 探针。

四、308 规范化（仅 GET / HEAD）

• 伪静态开启时，GET /index.php/thread/1 永久跳转到 /thread/1（保留查询串）；POST 等写操作不拦截。
• 设置缓存不可读时不跳转，避免配置异常时误把整站跳进 404。

五、插件侧链接收口

• 插件视图与钩子的路由链接统一改用 $this->url() / Url::to() / Url::webBase()，静态资源才继续走根路径；15 处只剥根路径、漏剥 /index.php 的旧逻辑统一收口，修复直接访问模式下插件功能静默失效。
• 插件 JS 统一 window.FH_WEB || window.BASE_PATH 回落。

六、文档

• 《插件开发规范》新增「双模式 URL 口径」一节，并修订红线与常见坑清单。

升级提示

• 覆盖式升级，保留 data/、protected/、assets/uploads/ 与 plugins/ 不动。
• 升级后到后台「维护 → 清理缓存」跑一次，确保新配置键与页面缓存刷新。
• 曾启用 OIDC / MCP / mobile_api 等对外登记地址的功能，切换伪静态开关后需同步更新已登记地址。