v9.3 → v10.0变更摘要热

变更摘要（v9.3 → v10.0 增量修正）

核对范围：index.php（3194 行）、Plugin.php（1455 行）、Setup.php（1586 行）、Cron.php（220 行）、Admin.php（200 行）、Search.php（61 行）、index.js（803 行）、新版 PLUGIN.md（463 行），文档→源码与源码→文档双向核对。

新增内容

• 7 个新钩子：整体模板钩子 6 个（page.template.before/page.template、topic.index_template.before/topic.index_template、topic.template.before/topic.template，.before 返回字符串即完全接管模板）+ 首页统计钩子 site_stats.data，核心钩子总数 83→90，已录入 2.2 各分表
• 新增列表行批量预载：attach_topic_list_users()（L391）登记 → topic_list_preload_flush()（L1953）首渲染前合并派发 topic.index_data.loaded → hook()（L673）自动批次闸门 → topic_list_preload()（L1975）助手
• 6.3 API 速查新增：sql_query_count()、sql_marks()、app_db_identifier()、user_points_set()、admin_list_head() 及「列表渲染」分组（5 个函数）
• 1.1/1.3 节：app/optional/ 由 3 类扩为 5 类（新增 Admin/Search 条目），admin/search/opcache_refresh 路由改由二者承接，补 __route_not_found 404 判定

行号刷新（不改写语义）

• 全文件行号随 index.php 3529→3194 行刷新：2.2 全部钩子表（含 Plugin.php 侧 3 处）、2.4 entries 定义、2.5 data-slot 全表 27 行、第三章插件流程 9 处、第四章数据库层 9 处、6.4 svg_icon()（L1582-1598）

事实修正

• 常量表：移除 SQL_DEBUG_MODE（24→23 个），q() 无条件记录 SQL
• 补 q() v10.0 记录机制说明
• --line-soft 值 #f3f3f3 → #f0f0f0（总数仍 37）
• 补「db_driver() 所有分支显式覆盖 pgsql（禁 LIMIT m,n）」
• 补注：整体模板钩子在核心默认 HTML 中无 data-slot 承载