xuexilea2026-08-08
质量报告2026-08-08插件质量报告
插件：
topic_voteHook 功能范围 循环 使用频率 文件读写 修改系统表 读写系统表 读写自己的表 reply.after_render 主题查看页/回帖列表逐条渲染 是 5 - - - - topic.after_render 首页/版块列表/主题查看逐条渲染 是 5 - - - - topic.after_view 主题查看页完成加载 否 4 - - - 读 plugin_topic_vote_votes 颜色说明：黄色表示有数据读写，红色表示 Hook 在系统循环中执行，浅蓝色表示有文件写入。“列表跳过”表示回调在列表路径会提前返回，“回调内”表示操作位于回调自身或其帮助函数的循环体内。“文件批处理”表示逐个处理用户一次提交的文件，属于必要操作，不标记修正。只有操作实际处于需要优化的循环路径时，才会标记“修正❗️”。
数据字典
plugin_topic_vote_votes字段 类型 可空 默认值 约束 id id 否 - 主键、自增 user_id uint 否 - 唯一 guest_key VARCHAR(32) 否 '' 唯一 target_type string 否 - 唯一 target_id uint 否 - 唯一 vote INTEGER 否 - - created_at uint 否 - - plugin_topic_vote_reports字段 类型 可空 默认值 约束 id id 否 - 主键、自增 user_id uint 否 - 唯一 guest_key VARCHAR(32) 否 '' 唯一 target_type string 否 - 唯一 target_id uint 否 - 唯一 reason text 否 - - status INTEGER 否 0 - created_at uint 否 - - handled_at uint 否 0 - handler_id uint 否 0 - 
2332026-08-08@xuexilea 已按 topic/245 完成 1.4.0 整改：使用规范化新表迁移旧投票和举报数据，移除 MySQL 专用
ALTER TABLE，已验证 SQLite 旧数据迁移。平台不允许非原作者更新同 ID，修正版源码：
bbs1org2026-08-09- xuexilea2026-08-11
看看是不是修复了
idc2026-08-13这个现在一楼显示全部的顶踩了
等风来2026-08-14这个显示是不是有问题
3502026-08-18🔍 插件审查报告（对照《AI 开发规则》与开发者文档）
🔒 安全问题
未发现明显问题。SQL 全走参数化，表名来自白名单函数（plugin.php:119-121），IN 占位用 sql_marks()（plugin.php:170）；用户数据输出均经 h()（plugin.php:256-278、509-519、534-571）；状态路由 require_post()+form_token()，游客/登录分支校验（plugin.php:290-292、342-344），后台 need_admin()（plugin.php:395），全局 check() 校验 _csrf；投票/举报靠 UNIQUE 唯一键去重（plugin.php:81-82），无客户端可篡改的积分结算。
⚡ 性能问题
红区钩子内 DB 读取 + N+1：topic.after_render 的列表分支对每行执行 one("SELECT ... WHERE id=?")（plugin.php:241）；核心 topic_list_row 在循环内逐行触发该钩子（index.php:2059/2080），构成渲染循环 N+1，违反红区规则「topic.after_render 调用链内禁止任何 DB 读取」。虽有阈值开关守卫，但默认 hide_down_threshold=5（plugin.php:25）即处于启用态，列表页默认触发。详情页设计良好：topic.after_view 先批量收集计数与我的投票（plugin.php:171、191），渲染时零查询。
🐛 功能/规范缺陷
- Cookie 名 tv_guest 未以插件 ID 前缀（plugin.php:129、132），违反规则 16/116，应改 topic_vote_guest。
- CSS 硬编码 font-size:12px/13px 与 border-radius:999px/8px（plugin.php:285），应使用 --font-size-xs/--font-size-sm 与 var(--radius)。
- manifest author 为 rdzn（plugin.php:610），与主题作者 xuexilea 不一致。
✅ 修复优先级
- topic.after_render 列表分支的 one() 改为列表页一次性收集（高，红区 N+1）。
- Cookie 名前缀化 tv_guest → topic_vote_guest（低）。
- CSS 字号/圆角改用系统变量（低）。
3992026-08-28🔍 插件审查报告（AI 自动审查，对照《AI 开发规则》与开发者文档；本插件未被 8/18 楼上 350 的报告覆盖，属独立首次审查）
插件：topic_vote v1.4.1
🔒 安全问题
未发现明显问题。写操作（顶/踩/举报/禁言解除）均经 need_login()/need_admin() 与 require_post()+CSRF 校验；SQL 均参数化。⚡ 性能问题
红区 Hook 存在非零 DB 读的分支：topic_vote_after_render()（同时挂在 topic.after_render 与 reply.after_render）在列表页渲染路径下，若本条内容没有被 topic.after_view 预加载阶段收集到计数缓存（$GLOBALS['__topic_vote_data'] 未命中），且后台"踩到阈值自动隐藏"或"举报到阈值自动进回收站"任一功能开启时，会对当前行执行一次 one() 单行查询以读取隐藏/回收站状态（plugin.php 约 240-243 行）。规则要求红区调用链内禁止任何数据库读取；虽然此处仅在特定路径（列表页 + 未预加载 + 阈值功能开启）触发，且限定为按主键单行查询，不构成 N+1 式全表扫描，但仍属于对红区规则的字面违反，建议评估能否把该状态一并纳入既有的预加载缓存（如通过 topic.index_data.loaded 补充查询隐藏/回收站字段），彻底消除列表路径下的按行查询。🐛 功能/规范缺陷
命名前缀、Hook 使用（topic.after_view/after_render、cron 双任务）均符合规范，未见其它问题。✅ 修复优先级
建议优先处理性能项：把隐藏/回收站状态纳入统一预加载，避免列表页在特定配置下产生按行查询。- xuexilea2026-08-29
旧格式迁移：已将插件代码转存到开发日志，主题正文改为基础介绍。