对比 开发者文档中心 与当前代码(v8.8.0)实现,发现以下不一致(以代码为准):
# 差异点 文档位置 代码实际 原因分析 1 速查表写 upsert()、insert_ignore()文档 L86(核心 API 速查·数据库行) 全局函数不存在,实际为 app_db_upsert()(index.php L170)、app_db_insert_ignore()(L174);文档自身后文(L369-373)写法正确速查表简写未同步;属文档滞后 2 user_points_change($uid, $delta, $reason, $rel_id)文档 L89 实际签名 (int $user_id, int $delta, string $reason = '系统调整', bool $notify = false, array $context = [])(index.php L933),第 4 参是布尔$notify,不存在$rel_id代码签名已变更,文档未更新;按文档传关联 ID 会被当作通知开关 3 plugin_registry()列为插件全局 API文档 L84 全局函数不存在,实际为静态方法 \app\optional\Plugin::plugin_registry()(Plugin.php L63)架构重构(迁移到 Plugin 类)后文档未更新 4 svg_icon()图标表列 9 个文档 L61-73 代码实际 10 个,漏列 'id'图标(index.php L1718)核心新增图标后文档未补录 5 Hooks 速查表约 34 项 文档 L97-129 代码实测约 69 个具名钩子,速查表仍漏列约 35 个,包括: mainpanel_extra、forum_group_allowed、user.can_speak、site.closed_allow、user.username_reserved、user.before_save、user.after_save、security.rate_allow、security.rate_hit、login.before_submit、auth.password_verified、login.form_extra、login.after_form、profile.after_form、avatar.url、avatar.picker、markdown.render、markdown.after、topic.create_author、reply.create_author、topic.can_manage、topic.index_data.load/loaded、topic.replies_data.load/loaded、topic.content_after、page.seo、page.footer、search.condition、search.index_available、search.rebuild、search.topic_sync/topic_delete/reply_sync/reply_delete、admin.plugins.view、admin.plugins.tabs、admin.plugin.actions、user.profile_tab_data、user.profile_tab_footer等速查表只收录常用子集(已含 top.bar.actions、page.before_render、request.csrf_exempt,并细化notification.after_createctx),其余缺口仍在;完整清单以本文 2.2 为准6 界面规范颜色变量表未收录全部 文档 L33-46 代码实测 37 个 CSS 变量(index.css :root),文档表漏列 --success、--success-soft、--radius-sm、--focus-ring、--inverse-*、--shadow-*等;且文档表数值与代码有漂移(文档--bg#f5f5f5/--text#222/--text-muted#666,代码实测--bg#f4f4f4/--text#000/--text-muted#555);文档正文规范(L387)已正确引用--success、--focus-ring、--inverse-text等变量表未随核心调色板扩充同步 7 data-slot 插槽机制仅一句使用规范 文档 L384 核心已在 23 处 HTML 元素落地 data-slot属性(完整清单见本文 2.5 节),包括移动端菜单三插槽共用、顶栏操作区 4 插槽、工具栏/发帖表单两插槽共用等复合场景新机制刚落地,文档尚未提供插槽清单;插件 JS 定位需依赖实测清单 主楼点赞与点评1bbs1org投币2026-08-31
ai左右脑互博😅