本文由 FlintHub 开发文档归档发布。原始文档日期见标题前缀，来源：7月5日复制的资料/会话归档_20260703.md。

SoSite 完整修复会话归档

会话日期：2026-07-03

涉及文件：约 30+ 个文件

修复类型：安全漏洞 / 逻辑缺陷 / 代码冗余 / 架构清理 / 移动端适配 / UI 细节

一、审查验证

对照《全面代码审查报告_20260703.md》逐条验证 21 项问题：

报告准确率约 90%。

二、修复清单

第1天 — 安全修复

第2天 — 逻辑修复

第3天 — 架构清理

补充修复

三、扫描修复（全项目安全遍历）

四、移动端导航菜单适配（耗时最长）

4.1 初始问题

点击汉堡菜单，导航项浮动在内容上方，不推内容。

4.2 修改过程

4.3 最终状态

• 点汉堡展开/收起，点外面不关
• 导航栏随页面滚动（position:static）
• 插件靠左、用户栏居中，同一行
• 博客橙色 hover 线在移动端隐藏
• border-bottom 保留作为分隔线

五、帖子详情页 UI 修复

六、核心 Bug 修复

搜索功能崩溃（F5 引入）

• 原因：searchMySQLFulltext 和 searchLIKE 的 COUNT 查询用 FROM threads（无别名），但 $catFilter 用了 t.category_id
• 修复：COUNT 查询加别名 FROM threads t

在线人数刷新就涨

• 原因：online_users 表缺少 PRIMARY KEY，REPLACE INTO 变成每次都 INSERT
• 修复：REPLACE INTO → DELETE + INSERT

孤儿文件清理误删内容图

• 原因：编辑器上传的图片不进 attachments 表，也不记入 cover_image，清理时被当孤儿删掉
• 修复：扫描 threads/posts/blogs 内容中的 <img> 引用加入保护白名单

七、涉及文件汇总

app/Helpers/

• RememberMe.php
• Points.php
• Search.php
• Settings.php

app/Controllers/

• AuthController.php
• SearchController.php
• TagsController.php

app/Controllers/Admin/

• BaseController.php
• BlogController.php
• CategoryController.php
• DatabaseController.php
• GroupController.php
• LevelController.php
• MaintenanceController.php
• SettingsController.php
• ThemeController.php
• ThreadController.php
• TrashedController.php
• UserController.php

app/Core/

• Autoloader.php
• Database.php
• Router.php
• TemplateCompiler.php
• ~~View.php~~（删除）

app/Views/

• layouts/main.php
• thread/show.php
• admin/permissions.php
• admin/settings.php
• admin/mail_settings.php
• admin/groups.php
• admin/levels.php
• admin/database.php
• admin/threads.php
• admin/blog_manage.php

assets/css/

• layout.css
• forum.css

plugins/

• daily_checkin/hook/nav_main_links.php
• daily_checkin/hook/nav_plugin_links.php

根目录

• index.php

八、备份

移动端导航布局修改前备份在 _backup_layout/：

• layout.css（原始版本）
• main.php（原始版本）

恢复命令：

copy _backup_layout\layout.css assets\css\layout.css
copy _backup_layout\main.php app\Views\layouts\main.php