[topic_read_groups]主题阅读权限热

插件质量报告

插件：topic_read_groups

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

数据字典

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

存在命令执行：exec 为什么这么危险的函数

更新新的功能。懂的都懂：

@one 那就再丰富下，加上只有指定用户名单可看。参考微信朋友圈权限

已测试OK，但你这是要准备干嘛？

版本 1.5.6 更新：
1.5.6修正：

1、权限控制增强
2、用户名前缀模糊查询
3、其他细节打磨

版本 1.5.8 更新：
修正一个没给AI说清楚的逻辑：
贴主不能修改白名单开关应保留原白名单不变（提交时服务端跳过白名单写入，而非清空 - 现在的行为）
新行为：开关关闭 + 纯贴主编辑 → 跳过白名单重写，保留原白名单，保存正常完成。
开关关闭 + 贴主编辑态时，不报错、不清除，保留原白名单。即跳过白名单的 DELETE/重插，让原TOPIC_READ_GROUPS_USERS 记录不变。

版本 1.5.9 更新：
分页 total 精确化。

1，visible_total() 用单条 COUNT 精确统计可见总数，逻辑严密（隐藏/白名单/楼主/白名单命中/用户组命中全覆盖）。
2，短路优化：全站无限制主题时返回 -1，index_data.loaded 跳过，零额外开销常态。
3，WHERE 1=1 起头修复上次标记的中危（空 WHERE 误挂 ON 子句），SQL 拼接安全。
4，细节打磨。

版本 1.6.0 更新：
对通知 content 中的用户名与标题做 h() 转义，防御存储型 XSS。

给 .trg-field>.trg-summary 加 flex-wrap:wrap，并给 .trg-badge 在窄屏防止溢出。同时给 .trg-group-checkbox 已 wrap（移动端 flex-wrap 适配）。

针对徽标在窄屏的适配（徽标与标题同行，长标题时徽标不应被挤压消失），并在 @media (max-width:480px) 中补充 .trg-badge 与 .trg-wl-tags 的安全间距。

发帖/编辑需"保存两次"才生效的问题

• 原提交拦截采用「preventDefault → 异步 Promise 校验 → form.requestSubmit() 二次派发」链路，在 Edge/Chrome 内核下会消耗第一次点击的提交意图，导致必须补点一次。
• 重构为同步拦截策略：未勾选白名单或名单为空时直接放行原生提交，零干预；仅当已填白名单且含不存在用户时才同步 preventDefault 并提示。彻底消除异步二次提交竞态。

版本 1.6.1 更新：
1、细节优化
2、再次按 .ai-rules.md AI开发规则对代码做最严格的全量审查，并做修复。@350 再次帮检查

版本 1.7.0 更新：

• Fixed（严重）核心迭代适配：恢复列表隐私过滤与分页修正：核心 topic_index_data() 此前直接丢弃 topic.index_data.loaded 钩子的返回值，导致本插件对该钩子的全部产出失效——白名单"部分可见"与"完全隐藏"主题对无权用户在列表中泄露标题，分页 total 修正也随之失效（隐藏主题多时出现末页空页）。修复分两层：
• 核心侧：index.php 的 topic_index_data() 现以防御模式接收该钩子返回值（is_array 校验后替换 $data），恢复"列表数据加载后加工"语义；
• 插件侧（双保险）：topic.before_render 由"极端兜底"升级为渲染链主路径——按 user_should_hide 语义（含白名单）对无权行标记 __topic_read_groups_hidden，topic.after_render 返回空串整行移除。即使未来 loaded 过滤通道再次失效，隐私也不泄露。红区安全：判断全部命中 index_data.loaded 预热的请求级缓存，管理员短路，渲染循环零 DB 读。
• Fixed 白名单校验前移，消除"主题已公开落库"窗口：原实现在 topic.after_save 中校验白名单，失败时调 err() 拒绝——但主题此时已被核心保存，以公开状态落库。新增 topic.before_save 钩子：范围门控（版块未开放）与无效名单（用户名/ID 不存在）校验前移至落库之前，err() 直接中断 save_topic；after_save 不再重复校验，白名单解析抽取为公共函数 topic_read_groups_parse_whitelist_input() 复用。管理操作（置顶/高亮/删除等 action）自动跳过校验。
• Changed 命名规范合规化（按当前开发者文档 AI 全量规则）：自定义 CSS 类 / data-\* 属性统一改用完整插件 ID 的连字符前缀——.trg-* → .topic-read-groups-*、data-trg-* → data-topic-read-groups-*、徽标 tooltip data-tip → data-topic-read-groups-tip；POST 表单字段与 AJAX 路由 action 同步前缀化（trg_group_ids → topic_read_groups_group_ids、trg_hidden → topic_read_groups_hidden、trg_whitelist → topic_read_groups_whitelist、trg_users → topic_read_groups_users、trg_force → topic_read_groups_force、trg_verify_users/trg_search_users → topic_read_groups_*_users）；行内标记键 __trg_* → __topic_read_groups_*。按全新插件对待，无旧名兼容。
• Changed UI 规范合规化：CSS 圆角 15 处硬编码像素值（4/5/6/7/8/9/10px）收敛至官方变量 var(--radius) / var(--radius-sm)；漏网的硬编码字号 font-size:14px → var(--font-size-sm)。
• Changed JS 规范合规化：匿名 IIFE → 具名 topic_read_groups_boot；校验/联想路由地址仅经服务端渲染的 data-* 属性传递（确保伪静态/子目录路径正确），地址缺失时跳过前端校验与联想（doVerify/runSuggest 空守卫），由服务端 before_save 兜底。
• Removed：JS 死代码全局 fallback window.__trgVerifyUrl / window.__trgSearchUrl（从未赋值，且命名不符合插件 ID 前缀规范）。

版本 1.8.0 更新：

• Changed 规范 API 化：两条 AJAX 路由输出改用核心 json_response()（统一 JSON 头/编码选项）；异常分支经 debug_log_write() 记日志，verify 异常返回 ok:0 且不携带 invalid/map（前端保持既有标记，避免空 invalid 被误判为"全部有效"），search 异常返回 ok:0 空结果。
• Changed 钩子链健壮性：form_extra / index_data_loaded / after_render / title_suffix 回调首参去强类型声明，异型值（含 null）归一/放行，避免链上其他插件返回异型值时 TypeError。
• Removed 死代码/死表：
• plugin_topic_read_groups_cats 死表（建表/索引/卸载清理全套维护但运行时零读写，配置实际走 plugin_config）——常量、install、uninstall 三处整体移除；
• my_group_ids() 附属组解析分支（核心 app_users 无 group_ids 字段，恒不可达），简化为主组单值返回；相关注释（can_set / can_use_whitelist / can_view / visible_total）同步修正；
• form_extra 的 $_POST['forum_id'] 回显分支（核心保存失败即 err() 终止，不存在 POST 回显重渲染场景，不可达）。

版本 1.8.1 更新：

• Changed 徽标 tooltip 复用官方面板样式：列表徽标（"仅部分用户可阅读"小人 / "您所在的用户组无阅读权限"小锁）的悬停提示由反色面板（var(--inverse) 深底白字）改为官方面板样式：var(--panel) 底色 + var(--line) 边框 + var(--shadow-medium) 阴影 + var(--transition-normal) 过渡，昼夜模式经 CSS 变量自动适配；定位保留上方居中（列表行密集，下方会覆盖相邻行内容）。aria-label / hover / focus-visible 显隐行为不变。

版本 1.8.2 更新：
修复一个SQL 拼接 bug。

list_where() 返回的筛选片段自带 WHERE 关键字，而 visible_total() 内部已以 WHERE 1=1 起头并用 AND $where 追加该片段，版块页/搜索页/用户主页拼出 WHERE 1=1 AND WHERE ... 非法 SQL，SQLite 报 near "WHERE": syntax error；异常经 plugin_call() 捕获后触发插件自动停用。修复：list_where() 改为返回裸条件（不含 WHERE 关键字），与消费方拼接契约对齐。

建议可以增加一个，发布主题的时候默认勾选，对游客默认隐藏回帖内容，需要登入才能查看回帖。主题内容如果不做限制可以对游客开放。