七夏（牛马）

应用数
48
安装量
327

应用圈

最后在线：: 2026-09-28
客服时间：: 工作日 9时~20时

其他应用

热门应用

楼层预览卡片尝鲜版

收藏分享投诉

还剩促销结束

¥99.00

~~¥198.00~~|5 折|节省 ¥99|请抓紧时间抢购

统　　计:共 1 次下载
更新日期:2026-09-07
适配编码:UTF8SC
兼容版本:X3.4 X3.5 X5.0 X5.1
PHP版本:7.2 ~ 7.4 8.0 ~ 8.2
标签分类:看帖增强
移动属性:该版本未适配手机版（触屏版）
开发方式:作者申明该应用少量使用 AI 辅助开发

购买应用 免责声明

# 楼层预览卡片

长帖阅读的楼层导航方案：帖侧悬浮刻度条 + 楼层目录面板，点哪层到哪层。
适配 Discuz! X3.4 / X3.5 / X5.0 / X5.1，不建表、卸载无残留。

演示地址（需登录查看）：
https://www.niumabbs.com/t-1011-1-1.html

---

## 一、它解决什么问题

长帖（活动帖、盖楼帖、技术讨论帖）翻到几十层之后，读者普遍遇到三件事：

1. 不知道整帖有多长、自己读到哪了；
2. 想回看前面某一层，只能一页页点翻页；
3. 想直接跳到结尾楼层看结果，也得连续翻页。

楼层预览卡片把这三件事压缩成右侧一条细刻度：整帖结构一目了然，当前阅读位置实时高亮，鼠标点一下就能直达目标楼层——全程不离开帖子页。

---

## 二、功能明细

### 2.1 悬浮楼层导航条（触发条）

- 贴屏幕边缘的细竖条，由当页楼层刻度组成，无背景色、不遮挡正文；
- 当前阅读楼层刻度加深加长，跟随页面滚动实时联动（requestAnimationFrame 节流，滚动顺滑不闪跳）；
- 鼠标悬停出现“聚焦”动效：以所指楼层为中心，刻度逐级变短变淡，指哪看哪；
- 刻度数量按屏幕高度自适应采样，百层长帖也不会挤成一团；
- 支持点击刻度直接跳到对应楼层；
- 距离屏幕边缘的留白（0–80px）后台可调，左右两侧停靠可切换。

### 2.2 楼层目录面板

- 悬停触发条展开（延迟可设 0–2000ms），也可设为“点击打开”模式；
- 面板显示帖子标题、总层数徽标、楼层列表、页码与翻页按钮；
- 每层一行：楼层号 + 正文摘要（长度可设 20–300 字）+ 作者头像（可关）；
- 焦点楼层用主题色标出，其余楼层以焦点为中心上下逐级淡化，视觉重心即阅读位置；
- 面板打开时页面继续滚动，焦点行与触发条刻度同步跟随，不重建 DOM、不闪烁；
- 骨架屏占位，数据往返期间列表不空窗。

### 2.3 楼层直达

- 本页楼层：平滑滚动定位，自动预留顶部高度；
- 跨页楼层：走 Discuz 原生 findpost 路由，服务端按楼层号换算页码后精准落地，不丢锚点；
- 楼层元素定位同时兼容 `post_PID` 容器与原生 `pidPID` 锚点表格，大多数模板、任何注入时序都能命中。

### 2.4 楼层摘要的权限与内容合规

面板摘要由服务端接口下发，逐层对齐原生 viewthread 的可见性规则，未购买、被隐藏的内容一个字都不会外泄：

| 内容状态 | 面板表现 |
|---|---|
| 帖子设置了阅读权限（readperm） | 权限不足的访客整帖拒绝，接口返回无权限 |
| 版块设置了访问权限（viewperm） | 同上，优先调用系统 forumperm 判定 |
| 付费主题未购买 | 楼主贴摘要仅下发作者设置的免费预览内容（[free] 标签部分），无预览时显示购买提示；回复楼层照常下发，口径与原生页面一致 |
| 发帖勾选“回帖仅作者可见” | 非作者/楼主/版主看到“此帖仅作者可见” |
| 单帖被管理员屏蔽 | 显示“该帖被管理员或版主屏蔽” |
| 作者被禁言或注销 | 显示“作者被禁止或删除 内容自动屏蔽”（判定口径对齐原生移动端接口） |
| 匿名发帖 | 作者显示匿名，不下发头像与 uid |
| 回收站、待审核帖子 | 整帖拦截 |

两点值得展开说明：

- **界面隐藏与接口判定同源**。不少同类插件只在模板层藏内容，接口层却照常查库返回，懂得拼 URL 就能绕过。本插件的触发条显隐与楼层接口走同一套判定函数，藏了就是真藏了。
- **软依赖友好**。站点装有“[回复登陆可见](https://https://addon.dismall.com/plugins/nm_reply_hide.html)”插件时，自动读取其函数和配置镜像判定，判定顺序逐行对齐；未安装则按不限制处理，不会因此报错。

### 2.5 外观与体验

- 六套配色主题：石墨蓝、黛紫、松绿、秋褐、豆沙、青灰，均为低饱和配色，不与常见站点主色打架；
- 深色模式双通道自适应：跟随浏览器 prefers-color-scheme，同时识别站点自身夜间模式（body.night 等）；
- 动效遵循 prefers-reduced-motion 系统设置，开启“减弱动态效果”的用户自动关闭动画；
- 窗口宽度不大于 640px（手机竖屏）时自动隐藏，不占移动端版面。

---

## 三、后台设置项（9 项）

| 设置项 | 说明 | 建议值 |
|---|---|---|
| 总开关 | 一键停用前台功能 | 开 |
| 目录每页楼层数 | 面板每页显示层数（5–100） | 10–20 |
| 摘要长度 | 每层摘要截取字数（20–300） | 60–100 |
| 悬停延迟 | 悬停多久展开面板，填 0 改为点击打开 | 150–300 |
| 显示头像 | 楼层行是否带作者头像 | 按站点风格 |
| 面板位置 | 左侧 / 右侧 | 右侧 |
| 配色主题 | 六套低饱和配色 | 石墨蓝 |
| 触发条距边缘距离 | 0 为贴边，可调至 80px | 0–30 |
| 显示所需楼层数 | 帖子总层数低于该值不显示，避免短帖干扰 | 5–10 |

---

## 四、注意事项

1. **游客可见性**：站点开启“[回复登陆可见](https://addon.dismall.com/plugins/nm_reply_hide.html)”插件时，触发条对游客自动隐藏（判定链一致，属预期行为）。
2. **移动端**：本插件面向 PC 主题，640px 以下窗口自动隐藏；触屏版模板不注入。
3. **起步楼层阈值**：楼层较少的短帖默认不显示触发条（可调），这是有意设计，避免悬浮元素干扰普通阅读。
4. **模板兼容**：已适配默认模板与常见第三方模板（含 comiis 系）；如站点模板对帖子列表结构改动较大，插件按原生楼层锚点定位，仍具备兜底能力。
6. **缓存**：更新插件后如未见变化，强刷一次浏览器即可，资源版本戳会自动处理常规缓存。

---

## 五、适用场景

- 活动帖、抽奖帖、盖楼帖：参与者快速定位自己的楼层与开奖层；
- 教程帖、长评测：读者按层跳读，配合总层数感知内容体量；
- 高回复讨论帖：回看指定楼层不再反复翻页；
- 资源帖：楼主说明在首层、更新在末层，一键直达。

---

## 六、环境要求

- Discuz! X3.4 / X3.5 / X5.0 / X5.1；
- PHP 7.2 及以上（兼容 PHP 8.x）；
- 桌面端浏览器（Chrome / Firefox / Edge 及内核近似的浏览器）；
- 无数据库版本要求，不建表、不改表。