变更摘要(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 承载
主楼