[dev_docs]开发者文档中心热

插件质量报告

插件：dev_docs

颜色说明：黄色表示有数据读写，红色表示 Hook 在系统循环中执行，浅蓝色表示有文件写入。“列表跳过”表示回调在列表路径会提前返回，“回调内”表示操作位于回调自身或其帮助函数的循环体内。“文件批处理”表示逐个处理用户一次提交的文件，属于必要操作，不标记修正。只有操作实际处于需要优化的循环路径时，才会标记“修正❗️”。

数据字典

未检测到插件数据表声明。

版本 1.0.0 更新：
新增：开发者文档中心。顶部导航「开发者」入口，集中展示界面规范（CSS 变量字号/颜色表）、SVG 图标统一方案、AI 插件开发规范（渲染循环零读库/预加载/回调签名/写入防重/SQLite 兼容/事务）、核心 API 与 Hooks 速查、发布流程与两轮自查清单。

这个我的意思是，bbs1org官方写个开发者中心。统一发布管理。你咋写出来了😀

版本 1.0.14 更新：
增加安装链接

Issue

• 移动端无入口
• 风格不统一。仅本插件所添加的「开发者」菜单项有图标

版本 1.0.15 更新：
1.0.15 修复 @banming 反馈：移动端抽屉新增「开发者」入口（桌面顶栏在小屏隐藏的问题）；顶栏入口维持图标与激活态，风格与版块导航一致。

@banming 移动端入口已修复并发布 1.0.15（待审核）：移动端抽屉菜单顶部新增「开发者」分区（含图标），与桌面顶栏入口一致；顶栏入口位于版块导航内、保持激活态与代码图标（@bbs1org 已说明图标用于突出研发入口）。@123456789 文档中心保持共享发布，官方与任何站点都能一键安装维护，官网无精力单独维护时大家可共同更新。

版本 1.0.16 更新：
插件展示位置文档更新

版本 1.0.17 更新：
改用标准 top.menu_links，不再通过 page.header 注入和 JavaScript 移动入口

版本 1.0.18 更新：
新增 notification.after_create 通知创建后 Hook。

版本 1.0.19 更新：
新增hook topic.content_after
用于在主题查看页的主楼正文末尾追加内容。

版本 1.0.19 更新：
调整顺序

版本 1.0.20 更新：
优化顺序

版本 1.0.21 更新：
补齐 --font-size-xxs: 10px

🔍 插件审查报告（对照《AI 开发规则》与开发者文档）

🔒 安全问题

未发现明显问题。

⚡ 性能问题

• 页面渲染路径同步拉取远程规则文件：dev_docs_page 调用 dev_docs_ai_rules_source()（plugin.php:389），内部 remote_http_request(..., 5, ...)（plugin.php:82）同步请求。虽有 1 小时缓存、5 秒超时与 100KB 上限，但缓存过期后的首次访问仍会阻塞渲染最长 5 秒。建议改由计划任务或后台定时刷新缓存，页面只读本地缓存。

🐛 功能/规范缺陷

• 固定 CSS 未走 manifest assets，而是通过 page.head 钩子注入 <style>（plugin.php:419 调用 dev_docs_css()，:424 返回 <style>）。这违反“固定 CSS/JS 只能通过 assets 声明、资源函数不含 <style>/<script> 标签”。建议新增 'assets' => ['css' => 'dev_docs_css']，让资源函数只返回纯 CSS，并移除 page.head 中的注入。

✅ 修复优先级

1. CSS 改走 assets 声明；2. 远程拉取改为后台/cron 刷新，避免渲染阻塞。

版本 1.0.24 更新：
优化界面

版本 1.0.25 更新：
调整字体大小规范

版本 1.0.26 更新：
CSS 改走 assets 声明

版本 1.0.26 更新：
优化小细节

版本 1.0.26 更新：
字体大小规范

🔍 插件审查报告（AI 自动审查，对照《AI 开发规则》与开发者文档；本插件未被 8/18 楼上 350 的报告覆盖，属独立首次审查）

插件：开发者文档中心（dev_docs）v1.0.26

结论：已完成命名规范、生命周期（install/uninstall 幂等）、数据库跨库兼容、红区 Hook 零 DB 读、Hook 真实性（含核心与跨插件依赖核对）、SQL 注入风险、CSRF/权限校验、CSS 变量规范等项审查，未发现安全、性能或功能性问题。

版本 1.0.27 更新：
使用新的hook，并增加位置选项

版本 1.0.28 更新：
优化细节

版本 1.0.29 更新：
完善规范，禁止循环数据库操作

版本 1.0.29 更新：
增加插件专辑

版本 1.0.29 更新：
优化规范

版本 1.0.31 更新：
内容与代码对齐

版本 1.0.32 更新：
修正错误

https://bbs1.org/dev_docs 404 了

版本 1.0.32 更新：
修正问题

版本 1.0.35 更新：
将“开始前步骤”和不可违反的红线放在最前面，AI 可先建立正确执行顺序。
合并重复内容：- UI 与 SVG 合并为“界面规范”

• Hooks 与展示位置合并为“Hooks 与展示位置”
• 发布检查改为验收清单，不重复实现规则

将规则改为可执行判断：- 单文件插件结构

• 命名和 manifest
• 生命周期与配置兼容
• 数据库与跨数据库规范
• N+1 性能约束
• Hook、权限、CSRF、输出转义
• CSS/JS 隔离
• 文件安全、外部请求、计划任务
• 版本、让位、发布和验证

增强 AI 协作流程，要求 AI 先读规范、检查现有代码、分步实现、复核 diff、进行本地验证。
修正文档自身的类名前缀示例，避免规范示例违反命名规则。

版本 1.1.0 更新：
使用统一文档

版本 1.2.2 更新：
优化布局