• one

    对比 开发者文档中心 与当前代码(v8.8.0)实现,发现以下不一致(以代码为准):

    #差异点文档位置代码实际原因分析
    1速查表写 upsert()、insert_ignore()文档 L86(核心 API 速查·数据库行)全局函数不存在,实际为 app_db_upsert()(index.php L170)、app_db_insert_ignore()(L174);文档自身后文(L369-373)写法正确速查表简写未同步;属文档滞后
    2user_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 会被当作通知开关
    3plugin_registry() 列为插件全局 API文档 L84全局函数不存在,实际为静态方法 \app\optional\Plugin::plugin_registry()(Plugin.php L63)架构重构(迁移到 Plugin 类)后文档未更新
    4svg_icon() 图标表列 9 个文档 L61-73代码实际 10 个,漏列 'id' 图标(index.php L1718)核心新增图标后文档未补录
    5Hooks 速查表约 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_create ctx),其余缺口仍在;完整清单以本文 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 等变量表未随核心调色板扩充同步
    7data-slot 插槽机制仅一句使用规范文档 L384核心已在 23 处 HTML 元素落地 data-slot 属性(完整清单见本文 2.5 节),包括移动端菜单三插槽共用、顶栏操作区 4 插槽、工具栏/发帖表单两插槽共用等复合场景新机制刚落地,文档尚未提供插槽清单;插件 JS 定位需依赖实测清单
    主楼
  • one

    @bbs1org,再完善一下。AI都干冒烟了

    #1
  • bbs1org

    OK

    #2
  • one

    GLM5.3,GPT5.5 都读晕了。问我以哪个为准(推荐以代码为准),我也不知道啊。

    #3
  • 123456789

    还不如,把所有开发者文档。集中在一块。你现在分了好几个地方。不便维护。😀

    #6
  • one

    是的,我建议好几次了

    #7
  • bbs1org

    OK

    #9
  • 蓝太阳

    AI都干冒烟了没事。电脑好的就行😂

    #4
  • one

    😃

    #8
  • 123456789

    ai左右脑互博😅

    #5

发表回复

登录后回复