HeyBox Up
面向小黑盒 Web 端的用户脚本（UserScript）：网页收藏列表不显示“插眼”（CY）条目，但主页收藏总数会把它们算进去。本脚本单独拉取插眼收藏，在收藏页把插眼条目补到收藏列表下方，按帖子去重。社区首页（/app/bbs/home）移除右栏热门社区等冗余模块，改为定宽卡片信息流，并支持在右侧预览帖子评论；帖子详情页（/app/bbs/link/*）默认进入全屏沉浸阅读，封面与标题上下分栏、正文连续滚动，原生评论收进侧栏，保留原生回复与点赞，并在评论区补充默认/时间/点赞/作者排序。右侧互动栏可直接点赞、收藏与发布 CY，评论区仍可按 is_cy 过滤插眼评论。顶部导航收敛为首页、社区、收藏、文章四个「SVG + 文本」入口；帖子页纵轴中心左右两侧提供 SVG 上一篇/下一篇箭头，切换走站内路由，不整页刷新。社区页（/app/topic/link/*）提供只在该社区内生效的帖子搜索；宽屏社区首页改为左频道、中信息流、右热度三栏工作台。
- 版本：0.4.28
- 许可：MIT
- 运行环境：ScriptCat / Tampermonkey / Violentmonkey 等 UserScript 管理器
- 适用页面：
https://www.xiaoheihe.cn/*、https://xiaoheihe.cn/*
一、设计目标
- 只补网页端缺失的插眼列表，不伪造、不改写站点自己的收藏总数。
- 不复刻第三方插件的代码：签名算法在本脚本内独立实现，避免引入额外依赖或许可问题。
- 默认只读：浏览、收藏补全、评论预览与排序不修改站点数据；只有用户主动点击阅读栏的点赞、收藏或 CY 发布时，才以当前登录态调用站点自己的写接口。
- 一个帖子只出现一次：接口按评论维度返回，同一帖子的多条插眼按
link.id 去重。
- 复用站点原生评论：帖子详情页不重写评论组件，只把站点自己的
.link-comment 节点停靠到右栏，排序、回复、点赞、展开楼中楼都由站点处理。
- 沉浸阅读优先：帖子详情默认把阅读区放到全屏舞台，封面与标题分层排列，段落、图片与富文本按自然高度连续衔接；右侧互动栏调用站点接口完成点赞、收藏与 CY 发布，评论按需滑出，读完前不让评论区持续分走宽度。
- 可逆与可退出：沉浸阅读只是叠加类名与派生 DOM，原生正文、评论和回复编辑器原地保留；关闭后立即回到双栏，不改站点数据与路由。
- 输入方式齐全：滚轮、触控板、触摸滑动、方向键、翻页键与快捷键都能前进后退；所有按钮有标签与可见焦点，最小点击区 36px。
- 信息流评论预览：在社区首页不打开帖子也能读评论，默认收起为右缘竖向标签，点信息流里的评论数字才展开；预览只读，回复与点赞通过“打开帖子”回到原生评论区。
- 统一 CY 过滤：帖子页评论工具栏与信息流评论预览共用一个偏好，按接口返回的
is_cy 标记隐藏插眼评论；默认不隐藏，用户点“屏蔽 CY”后才生效。阅读栏的 CY 按钮不参与过滤，只负责发布新的插眼。
- 连续阅读：帖子页纵轴中心左右两侧常驻 SVG 上一篇/下一篇箭头，优先按信息流里的帖子顺序切换，找不到顺序时回退到页面相关推荐与会话内的浏览记录。
- 社区内搜索：社区页（
/app/topic/link/<topic_id>）的搜索只在该社区内请求，结果与全站搜索分开，不离开当前页面。
- 桌面工作台：宽屏社区首页不再把单列信息流放大居中，而是复用同一份数据排成左频道、中信息流、右热度三栏；窄屏逐步收起右栏和左栏，保留站点原有信息流。
二、数据来源
插眼收藏走评论列表接口，路径 /bbs/app/profile/bbs/comment/list，关键参数：
| 参数 |
值 |
说明 |
only_cy |
1 |
只要插眼记录 |
filter_type |
0 |
不过滤类型 |
enable_new_style_collect |
1 |
新版收藏结构 |
userid / heybox_id |
Cookie heybox_id（回退 user_heybox_id） |
当前登录用户 |
limit / offset |
20 / 递增 |
分页 |
no_more |
false |
首页固定值 |
其余基础参数（os_type=web、app=heybox、client_type=web、version=999.0.4、web_version=2.5、x_client_type=web、x_app=heybox_website、x_os_type=Windows、device_info=Chrome）与站点网页端保持一致。
响应判定：status === "ok" 时读取 result 数组；no_more === true 或本页为空即停止翻页。单条记录取以下字段：
link.id：帖子 ID，同时用于去重与跳转 /app/bbs/link/<id>。link.title：标题，空值回退“无标题帖子”。link.thumbs[0]：缩略图，可缺省。text：插眼时附带的评论内容。create_at：时间，按秒处理，兼容毫秒值。comment_type：1 记为“回复”，其余记为“评论”。
请求使用页面内 fetch，credentials: include 携带登录态。接口对 https://www.xiaoheihe.cn 返回 Access-Control-Allow-Origin 与 Access-Control-Allow-Credentials（实测），因此无需 GM_xmlhttpRequest，脚本保持 @grant none。
信息流评论预览走帖子评论树接口 /bbs/app/link/tree，除同一套基础参数外传 heybox_id（Cookie）、link_id、is_first（首页为 1）、page（从 1 起）、index=1、limit=20、owner_only=0。站点网页端还会带一个空的 h_src 参数，脚本在 link_id 前补齐，缺省时更容易触发风控。响应 status === "ok" 时读 result.comments（按楼层分组的数组，每组 comment[0] 为楼，后续为楼中楼）、result.link.title 与 result.link.comment_num。单条评论取 user.username、user.avatar（兼容拼写 avartar）、text（去标签后截断 400 字）、create_at、support_num（兼容 support_count）、reply_count（兼容 sub_comment_num）、is_cy（1、"1" 或 true 视为插眼）。
沉浸阅读的点赞、收藏与 CY 发布走站点写接口，全部由用户点击触发：POST /bbs/app/profile/award/link 传 link_id 与 award_type（点赞 1、取消 0）；POST /bbs/app/link/favour 传 favour_type（收藏 1、取消 2）、link_id、userid 与 folder_id；POST /bbs/app/comment/create 传 is_cy: 1、link_id、reply_id: "-1"、root_id: "-1" 与 text。收藏夹列表走 GET /bbs/app/profile/fav/folders。写请求使用 JSON 请求体，query 携带同一套签名参数与 target=heybox_app；status === "login" 时统一提示「请先登录小黑盒」。
社区内搜索走通用搜索接口 /bbs/app/api/general/search/v1，除同一套基础参数外传 q、search_type=link、topic_id（当前社区 ID）、offset、limit=30、is_pull_down=0；时间筛选非空时追加 time_range。响应 status === "ok" 时读 result.items 与 result.time_range_list；result.items 里的 space 条目只用于占位，offset 按 link 条数推进，空页或没有新增帖子时停止翻页。空结果提示优先取顶层 search_not_result_tips，其次取 result.search_not_result_tips。脚本先带 hkey、_time、nonce 请求，失败后回退不带签名的请求，两条都失败才显示错误。
三、接口签名
接口要求 hkey、_time、nonce 三个签名参数。脚本内独立实现，全部为纯函数：
time = floor(Date.now() / 1000)。nonce = md5(time + Math.random()).toUpperCase()，32 位十六进制。- 路径归一化为
/a/b/c/，与 35 字符字母表 AB45STUVWZEFGJ6CH01D237IXYPQRKLMN89 一起映射，生成 20 字符种子。
- 种子取 MD5 后，前 5 位映射为 5 字符主体；末 6 位的字符码经列混合与求和后
% 100 得到 2 位校验，组合成 hkey。
两个容易写错的细节：
xtime 左移结果不能对 255 取模，服务端算法保留高位；截断会算出不同的校验位。- 列混合只改写前 4 个字节，但求和必须包含原数组全部 6 个字节，否则校验位偏移。
MD5 覆盖 UTF-8 字节，md5Hex 与 Node crypto 结果一致。签名只覆盖路径与时间，不覆盖查询参数。
四、UI 与交互
- 收藏页 https://xiaoheihe.cn/app/user/favour/content ：脚本把插眼条目挂在收藏列表（.user-favour__list）下方，并跳过页面已渲染的同 ID 帖子。区块使用 Shadow DOM，样式与页面隔离。
- 收藏与文章页右栏：收藏页、文章管理页及文章详情页的右侧只保留二维码、小黑盒加速器、黑盒语音、黑盒工坊与备案信息等推广模块；脚本将这些右栏整体隐藏，并让主列表占满内容区。
- 顶部导航：脚本接管
.nav-links，隐藏站点原有的七个文字按钮，改为首页、社区、收藏、文章四个入口，每项为内联 SVG 图标加文本。图标默认在悬停、键盘聚焦与激活时播放轻量动效（房子轻晃、气泡上浮、书签落位、纸张翻角），齿轮设置菜单里的“动态导航图标”可切回静态；系统开启“减少动态效果”时同样保持静态。
- 导航状态：按
location.pathname 标记当前入口，社区包含 /app/bbs/home 与帖子详情；收藏页同时承载插眼收藏区块。视口 ≤940px 时只显示图标，保留 aria-label 与悬停提示。
- 全站主题：导航栏右侧新增主题按钮和齿轮设置按钮。主题菜单只放六套预设：跟随系统、夜航（冷灰深色）、纯黑（OLED 黑底低圆角）、浅色（站点原色）、纸页（暖纸底、衬线标题、细边扁平卡片）、雾青（冷雾底、大圆角、柔和阴影）；齿轮菜单放“首页评论预览”“动态导航图标”“沉浸阅读”三个开关（后两者默认开启），以及“中栏宽度（占屏幕宽度）”的 40% / 48% / 56% / 64% / 72% 分段按钮。两个菜单各自开关，打开一个会收起另一个，支持 Esc 与点击外部关闭；选中项立即生效并写入本机，当前项用强调色描边标出。
- 深色覆盖：夜航与纯黑共用同一套深色规则，覆盖帖子页正文、原生评论区（排序标签、作者赞、时间、IP、楼中楼展开、嵌套回复块）、回复编辑器、加载动画、个人主页列表底色、消息提示，以及 Element Plus 对话框、抽屉、表格、分页、图片查看器与下拉浮层。站点用伪元素绘制页面底色与帖子分隔条（
html 根元素、#app > main > section、.hb-bbs-home__feed-splitline、.hb-bbs-home__splitline、main.list、.hb-cpt__moment-list-content），这些颜色不随 CSS 变量走，需单独覆盖。登录表单保持浅色，避免第三方登录控件失去可读性。
- 文章编辑器细节：深色主题下把“发布设置”上方 4px 浅色分隔带改为页面底色，标题栏、发布栏与工具栏的 1px 浅色分隔线改为主题描边；工具栏图标、更多组件菜单文字与分隔线同步提亮，避免深底深字和接近隐形的图标。
- 版式重做：窗口宽度 ≥1200px 时外层容器为 1360px、居中，两侧留白 24px。社区信息流按屏幕宽度的固定比例居中（默认 56%，可在齿轮设置菜单里调整），帖子之间改成 14px 圆角卡片，卡片内边距 20px、间距 12px，用细边与轻阴影区分条目，悬停只抬升边框与阴影。搜索栏跟随信息流同宽居中，不再比信息流每侧多出一截。
- 信息流排版：卡片标题 17px/1.5、600 字重，正文 15px/1.72，作者行压到 13px；底部互动条用 1px 细线分隔。图片圆角 10px，整体层级靠字号、颜色与留白拉开。
- 帖子沉浸阅读：桌面正文 18px/1.86、限宽 34em，舞台 732px，右缘另留 80px 互动栏轨道，整组居中；移动端占满视口、正文 17px。首屏封面占据标题以上空间，图片用
contain 完整露出，背后是同一张图的模糊底色，不再裁切两侧；标题、标签与作者行移到封面下方的独立区块，使用主题底色，不再以玻璃卡压住图片。正文改为连续滚动，段落、图片与富文本块自然衔接，长图和长文按原始高度展开，大图仍可点开遮罩。右侧互动栏离正文 36px，移动端收进舞台右缘并隐藏栏内头像；封面多图可横向切换或点分页条，左右滑动只切封面，滑到末图再左滑进入正文。顶部只保留返回、作者与关注，右侧竖排点赞、收藏、评论、CY 发布、分享，底部显示阅读百分比与进度。
- 阅读键盘：
↑ / ↓、PageUp / PageDown、j / k 与空格按约 0.82 屏滚动，Home / End 跳首尾，← / → 只在封面切图，C 开关评论，R 或 Esc 退出沉浸阅读。点在输入框、文本域或可编辑区域内时不拦截滚动键，但 Esc 仍先关评论。
- 评论抽屉：评论仍是站点原生
.link-comment，桌面从右侧滑出 440px，移动端占满宽度；打开时把站点 #page-bbs-link 层抬到舞台之上，同时清空主题背景与指针拦截，避免整页底色盖住阅读舞台；背景加半透明遮罩，焦点移到关闭按钮，阅读区 inert，关闭后焦点回到评论按钮，Tab 在抽屉内循环。排序、屏蔽 CY、回复、点赞与展开楼中楼全部沿用原生逻辑。回复编辑器固定在抽屉底部，不遮住正文。
- 阅读互动：点赞与收藏直接调用站点写接口，按钮状态与计数来自评论树
result.link；未收藏时弹出收藏夹列表，已收藏时再次点击直接取消；CY 按钮打开 520px 输入卡，提交后以 is_cy=1 发布并更新评论数；未登录统一提示「请先登录小黑盒」。
- 抽屉加载提示：打开时若评论楼层尚未渲染，先显示“正在加载评论…”，约 3 秒后仍为空则改为可点击重试；评论出现后提示自动移除，避免打开后面对空白面板。
- 退出与记忆：顶部关闭按钮、
R、Esc 或齿轮菜单的“沉浸阅读”开关都可退出，关闭后立即恢复站点原生双栏；阅读位置按帖子写入 sessionStorage，返回同一帖时回到原页。
- 加载占位：帖子数据尚未渲染时先显示“正在加载文章…”，拿到正文后再替换，不会先露出被隐藏的原生页面空白。
- 关闭沉浸阅读后的排版：正文与评论各成一张卡片，中间留 24px。正文卡内边距 28px 32px，标题 25px/1.42/700，正文 16px/1.85，段落限宽 46em；引用块用 3px 左边线，标题、段落与图片间距单独收紧。右栏评论 424px，sticky 吸顶，最大高度
calc(100vh - 112px)，楼层内边距 14px 16px、正文 14px/1.7。
- 设计令牌：根级定义
--heybox-up-bg、surface、subtle、raised、border、text、text-2、muted、on-accent 与 --heybox-up-page-w、feed-w、feed-pct、radius-card、gap、card-pad、shadow-1、shadow-2。纸页主题把卡片圆角收到 4px、去掉一级阴影并改用 Georgia 衬线标题；雾青用 18px 圆角与更柔的投影；纯黑用 8px 圆角与深投影。
- 响应式：视口 ≤1100px 时信息流宽度回到
min(960px, 100%)，卡片内边距收到 16px；≤900px 时沉浸阅读的互动栏收进舞台右缘，≤760px 时舞台占满宽度、正文 17px，≤520px 隐藏作者名与“继续阅读”，结尾卡只保留作者、统计、标签与翻页。视口高 ≤820px 时结尾页隐藏“继续阅读”，≤520px 时再隐藏统计并收小头像，结尾卡保留 min-height: 100dvh，内容超出时按自然高度展开。
- 区块标题为“插眼收藏”，右侧是刷新按钮；说明行显示当前可补全条数。
- 搜索框按帖子标题与插眼内容即时过滤，清空输入即恢复全部条目。
- 卡片显示缩略图、标题、插眼内容、类型与时间，点击在新标签页打开帖子；插眼内容前带蓝灰色（#6f8db3）CY 眼睛图标，字号 14px，最多显示 3 行，悬停可看全文。
- 加载中显示已拉取条数；失败时显示原因与“重试”按钮，已有结果会保留并标注为上次结果；空结果显示对应文案。
- 页面收藏列表的 ID 集合变化时重新比对去重结果，分页或增量渲染后不会残留已出现的帖子。
- 未读到
heybox_id 时提示未登录，不发起请求。
- 社区首页 https://xiaoheihe.cn/app/bbs/home ：隐藏整个右栏（
.cpt-right-side.right），热门社区、二维码、App 链接与页脚一并移除；信息流收成 960px 居中阅读栏，话题条也改成同风格卡片。
- 全站搜索页 https://xiaoheihe.cn/app/search/list ：隐藏右侧热搜、二维码、App 链接与备案栏，结果列表占满内容区；深色主题补齐页面与列表的上下固定色条、结果间 4px 分隔条，以及横向结果列表右侧的箭头遮罩渐变。
- 全站搜索页搜索建议：深色主题下历史搜索胶囊改用主题底色与浅色文字，搜索发现标题、黑盒热榜标签与榜单条目分别使用次要/主文字色；榜单行悬停底色同步换成主题色，避免浅底浅字和深底深字。
- 帖子详情
https://xiaoheihe.cn/app/bbs/link/<id>：默认显示沉浸阅读，原生正文与回复编辑器留在 DOM 中不搬动；关闭阅读模式后回到左栏正文、右栏 424px 原生评论区的双栏布局，右栏原有的相关推荐与二维码模块隐藏。
- 社区内搜索：社区页
.topic-link__main 的筛选行上方插入搜索栏，左侧固定显示当前社区名，输入关键词后只请求该社区的帖子。筛选行位于 .topic-link__panel 时，搜索栏与筛选行插在同一父节点并保持前后相邻。结果面板替换原生信息流，顶部显示社区与关键词，并提供“全站搜索”和“返回社区”；时间筛选来自接口 time_range_list，切换后重置分页；“加载更多”按接口返回的 link 条数递增 offset。Esc 或“返回社区”恢复原生列表，切换到别的社区或离开页面时自动收起。窄屏隐藏社区胶囊并缩小缩略图。
- 社区搜索结果为只读列表：标题、两行摘要、作者、时间、赞数与评论数，点击走站内路由进入帖子，组合键与中键保留新标签页打开。
- 桌面工作台：视口 ≥1200px 时社区首页的
.content 改为 1fr | 中栏 | 1fr 三栏栅格：中栏宽度取自 --heybox-up-feed-pct（默认 56vw，上限 1180px，并至少给两侧留 560px），左右两列等分剩余宽度，中栏因此始终落在视口正中；左栏 208px 贴住中栏左缘，≥1500px 时右栏 288px 贴住中栏右缘。1200–1499px 只保留左栏与信息流，<1200px 回到站点单列。左栏是浏览入口与站点话题频道，中栏是原信息流，右栏是当前信息流按“评论数 × 2 + 点赞数”生成的热门排行与快捷入口。桌面隐藏站点顶部 sticky 搜索条，把它为搜索条铺的 146px 固定顶部遮罩压缩到导航 64px 加页面顶部留白 16px 的 80px 区域，搜索入口收进左栏“浏览”，右栏“快捷入口”不再重复全站搜索；左右栏 sticky 吸顶改为 top: 80px、最大高度 calc(100vh - 100px)，首屏不再留下搜索条高度造成的空白，滚动时正文也不会从导航下方的留白处露出。左栏已有频道列表，站点原生的横向频道条（.bbs-home__topic-list-wrapper）在 ≥1200px 时隐藏。
- 桌面工作台只重排现有 DOM：频道来自
.bbs-home__topic-item，点击时转发给站点原按钮；热门排行读取已渲染卡片，点击滚动到对应帖子并临时描边，不请求新接口、不伪造榜单。评论预览展开时右栏自动让位给预览侧栏。
- 原生回到顶部：站点把
.scroll-list__button-group 的右偏移绑在内容列上，窄视口会把它推到屏幕外，宽屏又会压到自定义右栏或评论预览下方。首页、频道页与帖子页因此隐藏原生按钮；其余页面把按钮固定到距右边 20px、距底部 24px，保证 800–1159px 下完整可见。
- 文章连读：帖子页在纵轴中心左右两侧显示纯 SVG 箭头，不再夹带文字、页码或底部浮动条。按钮贴近页面外侧留白，宽屏不遮挡正文；窄于 1200px 时缩小并降低不透明度，1080px 以下隐藏以让出单列阅读空间。切换优先调用站点 Vue 路由（
router.push），地址与内容由 SPA 更新，不整页刷新；切换后滚动回顶部。键盘 [ 与 ] 分别切上一篇、下一篇，输入框、文本域与可编辑区域内不拦截。
- 连读顺序：进入帖子前，脚本把社区信息流中已渲染的帖子 ID 按顺序写入
sessionStorage；帖子页按当前 ID 定位前后项。当前帖子不在记录中或已到列表末尾时，“下一篇”回退到页面“相关推荐”的第一条；没有可用顺序时用本次会话的浏览记录提供“上一篇”。
- 评论区留在站点原有 DOM 位置：关闭沉浸阅读时脚本用 CSS Grid 把帖子内容与
.link-comment 排成左右两列；开启时只把 .link-comment 固定到抽屉，两种模式都不搬动节点，站点祖先选择器与原生样式继续生效。
- 回复、点赞、展开楼中楼、加载更多仍由站点原生逻辑处理；脚本不克隆、不改写评论数据。
- 评论区顶部新增“排序”工具栏：默认、时间、点赞、作者。排序只写
style.order，不改 DOM 顺序；站点重渲染后自动重建工具栏并恢复上次模式。
- 排序工具栏右侧新增“屏蔽 CY”按钮：开启后按
[data-comment-id] 匹配接口返回的 is_cy 评论，给对应楼层加 data-heybox-up-cy="1" 并由 body.heybox-up-hide-cy 统一隐藏；按钮显示已屏蔽条数，关闭后立即恢复。
- 关闭沉浸阅读后，视口宽度 ≥1200px 才启用左右双栏；窄屏改为上下布局，评论区排在正文下方，不隐藏评论。沉浸阅读本身在任意宽度都保留评论按钮和抽屉。
- 信息流评论预览：社区首页右侧常驻一个 Shadow DOM 浮层。开启时直接展开信息流首条帖子的评论，不必先点开帖子，也不发生跳转；面板宽 320px（视口 <1400px 为 288px），离窗口右缘 20px、离顶部 80px、底部留 80px，圆角跟随卡片令牌，投影用
--heybox-up-shadow-2。展开时页面使用全宽，桌面栅格只在右侧为面板预留与其实宽相同的轨道，不再额外叠加右内边距；中栏按可用空间收缩并保持居中，面板与信息流之间只保留 24px 级间距。首条帖子只自动打开一次：手动收起后不会再次弹出，点右缘的“评论预览”标签才会重新展开。
- 切换预览对象：点信息流卡片里的评论数字（
.bbs-new-style-bottom__comment、.content-list__comment）即可切换到该帖，页面不跳转。
- 预览取数与重试：评论树请求按 700ms 间隔节流，同一帖首屏结果缓存 5 分钟，悬停切换等待 900ms，避免连续请求触发站点验证码；签名请求被拒时自动改用无签名参数重试一次。仍失败时面板显示原因与“打开帖子”入口，点提示文字可再试。
- 预览开关：齿轮设置菜单里的“首页评论预览”关闭后，浮层
display: none、页面右缘不留标签，信息流恢复正常宽度，评论数字恢复站点原生行为（进入帖子）；偏好写入 localStorage，刷新后保持。重新开启会立刻带出首条帖子的评论。
- 面板顶部显示帖子标题、评论总数与“已加载 N 条”，正文按楼层列出头像、昵称、相对时间、评论内容、点赞数、回复数与最多两条楼中楼；底部“加载更多”按 20 条翻页，切换帖子会重置分页。
- 面板顶部工具区新增“CY”开关，与帖子页共用同一偏好；开启后过滤已加载的 CY 楼层和楼中楼引用，说明行显示“已屏蔽 N 条 CY”，切换时直接重渲染，不重复请求。
- 收起方式为面板右上角按钮或 Esc，收起后页面右缘保留“评论预览”标签，已加载内容不丢弃，重新展开不重复请求；离开首页或进入
/app/bbs/link/* 时浮层隐藏，视口窄于 1200px 时同样不显示。
- 预览只读：不提供回复、点赞与展开楼中楼，需要这些操作时点“打开帖子”进入原生评论区；接口失败时面板显示原因与“打开帖子”入口，不伪造评论。
五、存储与缓存
- 缓存键
heybox-up.cy.v1:<userid>，值为 { savedAt, items }。
- 有效期 10 分钟；命中缓存直接渲染，过期后重新拉取。
- 点击刷新会跳过缓存重新请求，成功后覆盖缓存；请求失败时保留当前已显示的结果。
- 单次最多 200 条（10 页），达到上限即停止，避免长列表拖慢页面。
- 缓存按用户隔离，切换账号不会读到他人数据；
localStorage 不可用时仅本次会话生效。
- 主题偏好键
heybox-up.theme.v1，取值为 system、dark、oled、light、paper、mist，仅存本机；旧值 dark、light 继续有效。
- 屏蔽 CY 偏好键
heybox-up.hideCy.v1，取值 1 或 0，默认 0（不隐藏）；仅存本机，帖子页与评论预览共用。
- 首页评论预览偏好键
heybox-up.commentPreview.v1，取值 1 或 0，默认 1（开启）；仅存本机，由齿轮设置菜单里的开关写入。
- 导航图标偏好键
heybox-up.navMotion.v1，取值 1 或 0，默认 1（动态）；仅存本机，由齿轮设置菜单里的“动态导航图标”开关写入。
- 中栏宽度键
heybox-up.feedWidth.v1，取值 40、48、56、64、72（百分比），默认 56；仅存本机，由齿轮设置菜单里的宽度分段按钮写入，只改 CSS 变量 --heybox-up-feed-pct，不重排 DOM。
- 连读顺序键
heybox-up.feedOrder.v1 与浏览记录键 heybox-up.postTrail.v1，只写 sessionStorage，关闭标签页即清除；插眼区块只响应收藏页 URL 的 #heybox-up-cy 锚点。
- 评论区由站点组件自行请求与缓存；脚本不保存评论内容与排序。
- 社区内搜索不写
localStorage：关键词、时间筛选与已加载结果只保存在当前页面的内存里，刷新或离开页面即清空。
- 桌面工作台不写存储：频道列表与热门排行每次按当前 DOM 重新计算，不缓存到本机，也不跨页面保留。
六、回归验证
验证以语法检查和真实登录态页面上的无头 Edge（CDP）DOM 断言为主，不依赖仓库内的辅助脚本：
node --check scripts/heybox-up.js
签名用真实被服务端接受的样本 (time=1792587363, nonce=2B3C207C9CF9AF2779DEE63C509DA4E8, path=/bbs/app/profile/bbs/comment/list) 复核，得到 hkey=VX2Y254；服务端接受该签名，时间错误时返回 系统时间不正确。
社区内搜索用无头 Edge（CDP）验证：1440×900、900×800 与 390×844（内容宽 390px）下，面板均挂在 .topic-link__main 内筛选行的实际父节点 .topic-link__panel，且紧挨筛选行之前；390px 下社区胶囊实算为 display: none。提交“显卡”后请求带 topic_id=18745、q、search_type=link、limit=30 与 hkey，渲染 10 条结果，原生筛选行与信息流同时隐藏；焦点在站点导航时按 Esc 不关闭面板，焦点回到输入框后按 Esc 关闭并把焦点交还输入框。接口每页再夹 10 条 space 占位时，“加载更多”仍以 offset=10、offset=20 正常追加，结果从 10 条增至 30 条。夜航下搜索栏底色 rgb(23, 29, 36)、结果标题 rgb(220, 229, 239)；浅色下分别为 rgb(255, 255, 255) 与 rgb(20, 25, 30)。
桌面工作台用 jsdom 用例验证：社区页启用 heybox-up-desktop，左栏插到 .content 最前、右栏插到最后；两个话题按钮生成两个频道项；热门排行按“评论数 × 2 + 点赞数”排出三帖顺序，1.2万 正确换算为 12000；点排行项滚动到对应卡片，点频道项后高亮且转发给站点原按钮。
实时验证：用同一实现生成当前时间的 URL 请求接口，返回 {"status":"failed","msg":"该用户已注销"}。这是用户级错误，说明签名与时间被接受；签名错误时返回 系统时间不正确。
布局用无头 Edge（CDP，1600×1000、1280×900、800×900）做 DOM 级验证：评论预览展开时，1280 下内容栅格为 288 / 592.8 / 288px，信息流 x=336、宽 592.8，搜索条已隐藏，左栏 x=104、宽 208，评论浮层 x=956.8、宽 288；1600 下栅格为 320 / 848.8 / 320px，信息流 x=368、宽 848.8，搜索条已隐藏，评论浮层 x=1244.8、宽 320。两种视口均无横向溢出，浮层与信息流之间仅余 28px 间距，不再出现“侧栏宽度 + 48px”额外内边距造成的空白区。帖子页正文卡 832×868，评论卡 424，排序栏 407×48，首条评论内边距 14px 16px，正文标题 25px/35.5px。800 下正文与评论纵向堆叠、宽 744，无横向溢出。夜航全页扫描未发现白色大底块；帖子页与社区首页的伪元素底色（卡片底部 4px 色带、楼层分隔线、相关推荐分隔线）与浅色边框扫描结果均为 0。
沉浸阅读用 1440×900、1024×768、800×700、390×844 与 844×390 验证：1440 下整组宽 812（x=314），舞台 732（x=354）、正文 612（x=414，右缘 1026）、互动栏 x=1062，左右留白 314 / 330；1024 下整组 x=106、舞台 x=146、正文右缘 818、互动栏 x=854、间隔 36；800 下舞台占满 800、正文宽 612 居中、互动栏 x=738、间隔 32；390 下正文宽 302、互动栏 x=338、栏内头像隐藏、按钮 42px；320 下正文宽 232；各视口 .hbu-reader-scroll 的 scrollWidth 均等于视口宽。封面 object-fit: contain 完整显示，背后铺同一张图的模糊底色；标题移到封面下方独立区块，1440 与 390 下封面与标题的矩形均无重叠，封面分页条 36×36，左右滑动只切封面，末图再左滑进入正文。正文段落、图片与富文本按自然高度连续衔接，长文与长图不再被一屏截断，也不在页内二次滚动；插入 30 段长文与长图后，文本页高度为 399、700、198，图片页 1514，容器 scrollHeight 8811。进度显示阅读百分比，方向键与空格每次滚动 0.82 屏（390 高下实测 320px），关闭重开按比例恢复（0.55 恢复到 621/1131）。结尾卡按内容自然增高，视口高 ≤820px 时收起“继续阅读”，≤520px 再隐藏统计并收小头像。844×390 横屏下评论抽屉 440×390，回复编辑器完整落在抽屉内；1440 下评论抽屉 440×900，关闭时 visibility: hidden，打开后 x=1000、焦点落在关闭按钮，阅读区 inert，背景 opacity: 1；打开时 #page-bbs-link 实算 z-index: 4010、background-color: rgba(0, 0, 0, 0)，抽屉中心命中的是评论楼层、舞台中心命中的是遮罩，回复编辑器固定在 y=823、高 61px 且列表预留 74px 底部内边距；点遮罩后焦点回到评论按钮。互动栏点赞与收藏在 mock 写接口下分别发出 award_type=1 与 favour_type=1、folder_id 正确，再次点击发出取消参数并更新计数；CY 按钮打开 520px 输入卡，提交体含 is_cy:1、reply_id:"-1"、root_id:"-1"，成功后评论数 +1；未登录点赞、收藏与 CY 均提示「请先登录小黑盒」。夜航正文 18px/33.48px、rgb(230, 237, 245)，纯黑舞台 rgb(9, 9, 9)、正文 rgb(230, 237, 245)，纸页舞台 rgb(250, 245, 234)、正文 rgb(51, 43, 33)；六套主题中除浅色关注按钮外无近白大底块。全部阅读控件不小于 36px；帖子数据未渲染时出现“正在加载文章…”占位（实测于响应较慢的帖子页）。
社区频道页用 1200×900 夜航主题验证：.topic-link__main::after 的 8px sticky 底条实算为 rgb(23, 29, 36)，.topic-link__splitline::after 的 4px 分隔线实算为 rgb(30, 38, 48)，与 --heybox-up-surface / --heybox-up-subtle 一致；截图不再出现白色横带。
全站搜索页用 1440×900 夜航主题验证：#page-bbs-list、.list 与 .hb-search-result 实宽同为 1032px，与 .search-wrapper 对齐；右侧 .cpt-right-side.right 为 display: none；页面上下固定条与列表 sticky 条实算为 rgb(15, 20, 25)，4px 结果分隔条为透明，横向列表右侧遮罩不再带白色渐变；近白底色扫描仅剩 4×4 加载点。
原生回到顶部按钮用 800×900、1000×900、1100×900 与 1440×900 验证：社区首页、频道页与帖子页的按钮组始终 display: none，1000×900 下不再只露出 1.2px；全站搜索页的按钮组保持 56×56，右偏移统一为 20px、底偏移 24px，1000×900 下完整可见且右侧留白 20px。
搜索建议面板用 1440×900 夜航主题验证：历史搜索胶囊底色 rgb(30, 38, 48)、文字 rgb(220, 229, 239)，悬停底色为 rgb(23, 29, 36)；搜索发现标题与热榜标签为 rgb(180, 192, 206)，热榜条目为 rgb(220, 229, 239)，条目悬停底色为 rgb(30, 38, 48)。
排序用合成用例验证：改写点赞数 1/9/4 与相对时间 3天前/5分钟前/1小时前 后，点赞与时间两种模式都按期望重排（order 为 2/0/1，纵坐标随之变化），切回默认清空 order；删除工具栏后 MutationObserver 在下一帧重建，选中模式与顺序保持。
评论预览用同一组视口验证：注入脚本后首页出现 #heybox-up-comment-rail，默认 data-state="open" 且 body 带 heybox-up-rail-open；点收起按钮回到 collapsed，点标签重新展开，Esc 同样收起；打开 /app/bbs/link/<id> 后浮层 data-state="hidden"、display: none。夜航主题下面板底色为 rgb(23, 29, 36)、文字 rgb(220, 229, 239)，无浅色残留。主题令牌实测：夜航 #0f1419 / #171d24 / #dce5ef / #8593a3 / #8fb0cf；纸页 #f4efe4 / #fffdf7、圆角 4、无阴影、标题 Georgia；浅色 #fff / #14191e；纯黑 #000 / #08090b、圆角 8。接口受限时面板显示“评论需要验证，请稍后重试，或打开帖子查看。”并附“打开帖子”链接，点提示可重试；换用新会话后首条帖子恢复 16 条评论。
文章编辑器验证（1440×900，夜航 / 纸页 / 雾青）：html 背景分别为 #0f1419 / #f4efe4 / #eef3f5；#page-creator-editor 与右侧预览内除开关滑块外无 rgb(255, 255, 255) 大底块，正文与预览正文的对比度分别为 12 / 11.7 / 12；发布与关注按钮不再保留站点写死的深色渐变。
文章编辑器细节用 1440×900 夜航主题验证：.creator-editor__form-wrapper::before 的 4px 分隔带由 rgb(250, 251, 252) 改为 rgb(15, 20, 25)；.cpt-editor__publish::after、.hb-cpt__editor-title::after 与 .editor-menu__item-splitline 的 1px 浅线由 rgb(243, 244, 245) 改为 rgb(45, 56, 69)；工具栏图标由 rgb(140, 145, 150) / 0.4 透明度改为 rgb(180, 192, 206) / 0.8 透明度；更多组件菜单文字由 rgb(100, 105, 110) 改为 rgb(180, 192, 206)；扫描编辑器根节点未再发现近白背景或近白描边。
首页默认预览验证（1600×1000，夜航）：注入后首页浮层直接 data-state="open"，body 带 heybox-up-hide-cy heybox-up-rail-open，无需点击即显示首条帖子的标题与 6 条楼层；点第二张卡片的评论数字后浮层标题切换为该帖，地址仍是 /app/bbs/home。齿轮设置菜单里的开关点击后 heybox-up.commentPreview.v1=0、浮层 data-state="hidden"、display: none、body 类移除，此时点评论数字走站点原生跳转；再点一次开关恢复 open 并重新带出首条帖子的评论，刷新后开关状态与偏好一致。收起按钮回到 collapsed 并移除 body 类，点右缘“评论预览”标签可重新展开；视口窄于 1200px 时浮层不显示。
CY 屏蔽用合成 DOM 与假接口在无头 Edge 中验证。帖子页：三条评论中 1001 与 1003 的 is_cy 分别为 1 和 "1"，注入脚本后两节点均带 data-heybox-up-cy="1"；点“屏蔽 CY”后 body.heybox-up-hide-cy 生效，两条 CY 楼层 display: none，普通楼层仍为 block，按钮显示“屏蔽 CY (2)”，偏好写入 heybox-up.hideCy.v1=1；再点一次恢复显示并写回 0。评论预览：两条楼层组中一条根评论为 CY、另一组含一条 CY 楼中楼，开启后列表只剩普通楼层，楼中楼引用中的 CY 也被过滤，说明行显示“已屏蔽 1 条 CY”。
七、已知限制
- 不改站点收藏总数；该数字由服务端
bbs_info.favour_num 计算，脚本只能解释差异，不能修正。
- 收藏页的插眼条目由脚本另插节点，不是站点返回的数据；节点挂在列表容器外，站点分页、排序与计数不受影响。站点改版换容器或类名时插入会失效。
- 单用户上限 200 条；更多插眼需要分页按钮，当前未实现。
- 搜索只覆盖已拉取并缓存的条目，不会额外请求服务端；200 条上限同样作用于搜索范围。
- 接口字段与签名规则由站点控制，改版后可能失效；失效时以“加载失败”提示，不会显示假数据。
- 评论预览只读，不能回复、点赞或展开楼中楼；这些交互只在帖子页的原生评论区提供。
- 预览依赖登录态与
link/tree 接口的风控策略：未登录或触发验证码时返回 show_captcha 等状态，面板显示失败原因，需要打开帖子查看。
- 预览按楼层分页，楼中楼只取前两条；评论触发入口依赖
.bbs-new-style-bottom__comment 与 .content-list__comment 类名，站点改版后需同步选择器。
- 悬停切换只在面板展开时生效，鼠标需在卡片上停留 600 毫秒以上；每次切换都会请求一次评论接口，长时间来回划过信息流会累积请求，触发风控时面板显示失败原因。
- 自动预览依赖
#page-bbs-community .bbs-home__content-list 容器与其中首个 a[href*='/app/bbs/link/'] 链接；容器或链接结构变化时不会自动带出评论，需点评论数字手动切换。关闭开关后脚本不拦截评论数字，恢复站点原生跳转。
- 脚本未在真实登录态页面内做过端到端点击验证；DOM 逻辑依赖 Shadow DOM 与
fetch 的常规行为。
- 站点 CSP 目前允许内联样式；若收紧到禁止
style-src 内联，收藏区块的样式需要改为构造样式表。
- 深色模式基于站点现有类名覆盖，站点改版后可能出现未覆盖的浅色块或正文；反馈时请附页面地址与截图。
- 帖子页与收藏页的部分内容需要登录才能渲染，深色样式按站点样式表选择器覆盖，未在登录态逐页点击验证。
- 宽屏布局只在 ≥1200px 生效，依赖站点
#app > main、section、.layout-normal 与 #page-bbs-community main.list 结构；站点改版换容器后需要同步选择器。
- 沉浸阅读只覆盖图文帖（
.hb-bbs-image-text）与文本帖（.hb-bbs-post），视频帖、纯投票帖仍走站点原布局。正文分块依赖 .image-text__content、.post__content 的块级结构；站点改版换容器后需要同步选择器，否则只会显示封面与结尾。
- 正文分块会克隆静态 HTML，链接可直接点击；内嵌组件里的按钮按“类名 + 文本”转发给原生按钮，组件若使用纯图标按钮或画布交互，克隆页上的表现可能与原页不同。iframe、视频与画布仍可显示，但不保证自动播放。
- 评论抽屉固定
.link-comment 并接管焦点顺序；关闭抽屉后恢复原双栏，DOM 不搬动。站点若把评论拆成多个浮动层，抽屉只接管首次找到的 .link-comment。
- 正文是连续滚动，没有页高上限；
100dvh 不可用的旧浏览器退回 100vh。
- 阅读位置按帖子保存在
sessionStorage，关闭标签页即失效；页面结构变化导致页数减少时，恢复位置会夹到最后一页。
- 排序工具栏挂在
.link-comment 内，站点清空该节点时会被移除；MutationObserver 在下一帧重建并恢复选中模式。
- 排序读取已渲染的点赞数、相对时间与用户名；“作者”模式按用户名与帖子作者比对，同名用户会一并排到前面。
- CY 屏蔽依赖
link/tree 返回的 is_cy 字段与楼层的 data-comment-id；站点改版去掉字段或属性后，开关仍可点，但不会命中评论。
- 帖子页只为已渲染但未识别的楼层补拉接口，最多 10 页（200 条）；超过上限的楼层保持原样，不误隐藏。
- 帖子页首次识别会额外请求评论接口；未登录或触发风控时请求失败，评论保持可见，需打开帖子或稍后重试。
- 回复编辑器仍由站点原生逻辑管理；开启沉浸阅读且打开评论抽屉时，它固定到抽屉底部，点楼层回复会按站点默认行为聚焦该编辑器。
- 社区首页隐藏整个右栏；若后续需要保留右栏中的其他模块，需要改为按模块隐藏。
- 纸页与雾青预设依赖站点现有类名着色，站点改版后可能出现未着色的新容器；深色预设同样按类名覆盖，登录表单始终保留浅色。
- 站点全局
* { padding: 0; margin: 0; font: ... } 会覆盖 Shadow DOM 的 :host 普通声明，排序栏的 host 样式因此全部加 !important；新增 Shadow 组件时需沿用同样写法。
- 站点用
::before / ::after 画卡片底部色带与 1px 分隔线，颜色写死为浅灰；底部色带在所有主题下隐藏，其余分隔线在深色主题逐个覆盖。站点改版新增同类伪元素时需同步补充，否则会再次出现白条。
- 正文内嵌卡片（
com-game-card、com-album-card、com-award-table-card、com-chatroom-card、com-league-card、com-match-card、com-mod-card、com-sku-card、com-wiki-card）的底色、描边、文字、药丸底与按钮在站点样式表里写死为浅色，深色主题按这 9 类容器逐组覆盖；站点新增卡片类型时同样会出现未覆盖的浅色块。
- 顶部导航依赖
.nav .nav-links 与 .nav-link 类名：脚本隐藏原生按钮并插入自己的入口，站点改版换容器后需要同步选择器。隐藏的原生按钮仍留在 DOM 中，站点自己的路由与统计不受影响。
- 导航按地址判断激活项；站点若改用纯前端状态切换而地址不变，激活项可能停在上一页，直到下一次地址变化或导航重建。
- 连读顺序来自进入帖子前已渲染的信息流条目，不额外请求列表接口；未滚动到的后续条目不会进入连读顺序。直接打开帖子或刷新后，顺序记录可能已失效，此时“下一篇”使用页面相关推荐。
- 连读切换优先调用站点 Vue 路由（
#app.__vue_app__.config.globalProperties.$router）；取不到 router 时退回站点 <a> 点击，会退化为整页跳转，功能仍可用但会刷新。
- 社区内搜索依赖
/app/topic/link/<topic_id> 路由与 .topic-link__main、.topic-link__filter-row 结构；筛选行存在时优先插在它的实际父节点 .topic-link__panel 内，筛选行缺失时退回 .topic-link__main。站点改版换容器后搜索栏可能不会挂载或位置改变。
- 社区名优先读右栏社区卡
.topic-aside__topic-indicator，读不到再退回页头标题与 document.title；右栏尚未渲染时占位文案会短暂使用页头名称。
- 社区搜索接口受站点风控影响：未登录或触发验证码时返回非 JSON 或失败状态，面板显示错误，不回退到全站结果；回退请求不带签名，若风控要求签名则仍会失败。
- 社区搜索按
link 条数推进 offset，并对单页内已显示的帖子 ID 去重；返回 0 条 link 时停止翻页。若后续整页都是重复 ID，列表不会增长，但需用户再次点“加载更多”，脚本不会自动循环请求。
- 社区搜索不持久化关键词、时间筛选与结果，也不实现站点搜索的
filter_tag 分类筛选；刷新后回到社区原生信息流。
- 桌面工作台依赖
#page-bbs-community .content、main.list、.bbs-home__topic-item 与 .bbs-home__content-item 结构；站点改版换容器后左右栏不会挂载。频道点击是转发站点原按钮，站点若改成非按钮容器需要同步选择器。
- 热门排行只统计已渲染到 DOM 的信息流卡片，未滚动到视口外的帖子不在榜内；评论数与点赞数按页面显示文本解析，站点改成隐藏数字或换单位后排序会失真。右栏不提供折扣与活动挂件，因为脚本没有对应数据接口，不生成占位内容。
- 全站搜索页整栏隐藏右栏；隐藏与撑满规则依赖
#page-bbs-list、.content > .list 与 .cpt-right-side.right 结构，站点改版换容器后需同步选择器。
八、版本历史
v0.4.28
- 封面与标题改为上下分栏：标题、标签与作者行移到封面下方，使用主题底色，不再用玻璃卡遮住封面图片；桌面、窄屏与低高度视口分别调整内边距。
- 点赞与收藏改走站点写接口：读取
result.link 的真实状态与计数，收藏支持收藏夹列表与再次点击取消，未登录统一提示；不再依赖隐藏的原生按钮。
- 互动栏 CY 从“屏蔽 CY”改为发布 CY：点击打开输入卡，提交
is_cy=1 的评论，成功后更新评论数并提示；Esc、遮罩与取消按钮均可关闭。
- 修复评论抽屉层级：打开时让
#page-bbs-link、.content 与 .list 透明并停止拦截指针，主题背景不再盖住阅读舞台；收起后可再次打开，inert、焦点与抽屉状态正常恢复。
- 评论抽屉关闭按钮移到“全部评论”标题行并提高层级，顶部排序与“屏蔽 CY”按钮不再被遮挡。
v0.4.27
- 沉浸阅读从逐页吸附改为连续滚动：段落、图片和富文本按自然高度衔接，长文与长图不再被一屏截断。
- 封面改用
contain 完整显示，背后铺同一张图的模糊底色；左右滑动只切封面，末图再左滑进入正文。
- 进度改为阅读百分比，方向键与空格按约 0.82 屏滚动，位置按滚动比例恢复；正文段落合并为最多 4 行一块，减少碎片感。
v0.4.26
- 评论预览请求加 700ms 节流、同帖首屏 5 分钟缓存、悬停等待 900ms 与无签名回退，降低触发站点验证码的概率；失败时显示原因、可点重试并给出“打开帖子”入口。
- 评论预览标签在空状态点击时会自动取信息流首条帖子，不再停在没有对象的空面板。
- 沉浸阅读的评论抽屉增加楼层加载提示与重试，评论出现后自动收起提示。
v0.4.25
- 超过一屏的富文本页与长图页改为一屏高、页内滚动，长图不再顶掉吸附或压住进度条；长图仍可点开大图。
- 左右滑动统一处理：封面逐图切换，到末图再左滑进入下一页；评论抽屉内
Tab 循环，Esc 在回复框里也能先关抽屉。
- 正文未就绪时显示加载占位；移除
helper 目录，验证改为语法检查加真实页面断言。
v0.4.24
- 修正沉浸阅读的横向构图：正文限宽 34em、舞台 732px，另留 80px 互动栏轨道并整组居中，桌面正文与互动栏只隔 36px；移动端隐藏栏内头像，避免互动栏压到顶栏。
- 点赞改为从非评论操作区取原生按钮，收藏改为弹出收藏夹面板并代理原生列表项，登录提示保留；互动栏新增 CY 开关，与评论抽屉里的原生屏蔽共用偏好。
- 修正评论抽屉层级：打开时抬高站点
.layout-normal 到舞台之上，遮罩位于舞台与抽屉之间，点遮罩可关闭；评论未加载时给出提示，不再把阅读区卡在 inert。
v0.4.23
- 帖子详情页新增沉浸阅读并默认开启：760px 舞台居中，封面、段落、图片与结尾卡按屏吸附，移动端占满视口；右侧竖排原生点赞、收藏、评论与分享，底部显示页数与进度，图片可点开大图。
- 原生评论收进右滑抽屉，保留排序、屏蔽 CY、回复与楼中楼；阅读区在抽屉打开时
inert，关闭后焦点回到评论按钮，回复编辑器固定在抽屉底部。滚轮、↑ / ↓、j / k、空格、Home / End、C 与 R 均可操作，阅读位置按帖子记忆。
- 齿轮菜单新增“沉浸阅读”开关，关闭后立即恢复原双栏；同时补齐卡片作者行、更多按钮、图片计数与频道排序的最小点击区，主题令牌覆盖夜航、纯黑、浅色、纸页与雾青。
v0.4.22
- 修复社区页改版后社区内搜索不再挂载：筛选行迁入
.topic-link__panel 后，旧代码仍向 .topic-link__main 插入，insertBefore 因目标不是直接子节点而抛错。现在按筛选行的实际父节点挂载并校验相邻位置；页头不再提供社区名时改读右栏社区卡，恢复具体社区名占位。
- 修复搜索翻页：接口每页夹带与帖子等量的
space 占位条目，旧逻辑用原始条数推进 offset 并判尾页，首屏就显示“已到最后一页”且跳过后一页；现按 link 条数推进，单页重复 ID 去重，返回 0 条 link 时停止。
- 补齐搜索面板可访问性与焦点：结果计数和加载状态使用
role="status" 与 aria-live="polite" 播报；关闭面板时焦点回到搜索框，“加载更多”加载中或隐藏时也不再把焦点留在按钮上；Esc 只在焦点位于面板或页面空白处时生效，避免误关站点的图片查看器或对话框。
v0.4.21
- 首页、频道页与帖子页隐藏站点原生右下角悬浮回到顶部按钮，避免它被自定义右栏或评论预览遮挡；其余页面把按钮收进固定的 20px 右留白，修复 800–1100px 下按钮被推到屏幕外只露出边缘的问题。
v0.4.20
- 文章编辑器补齐深色细节：移除“发布设置”上方 4px 浅色分隔带，标题栏、发布栏与工具栏的 1px 浅线改用主题描边，工具栏图标与更多组件菜单文字改用主题文字色。
v0.4.19
- 全站搜索页搜索建议面板补齐夜航等深色主题配色：历史搜索胶囊由浅底浅字改为主题底色浅色文字，搜索发现标题与黑盒热榜条目改用主题文字色，热榜标签与条目悬停态同步修正，避免浅底浅字或深底深字。
v0.4.18
- 全站搜索页（
/app/search/list）桌面隐藏右侧热搜、二维码、App 链接与备案栏，结果列表占满内容区；夜航主题补齐页面与列表上下固定色条、结果间 4px 分隔条与横向结果列表右侧箭头遮罩，消除顶部、底部与列表中的浅色横带。
v0.4.17
- 修复社区频道页（
/app/topic/link/*）夜航主题下残留的浅色分割线：站点 8px sticky 底条与 4px 帖子分隔线原来放在 :is() 内与伪元素组合，选择器无效，主题规则未生效；改为独立伪元素选择器，并分别使用当前主题的 surface / subtle 色。
v0.4.16
- 社区桌面隐藏顶部 sticky 搜索长条，并把它的固定顶部背景遮罩从 146px 压缩到导航 64px 加顶部留白 16px 的 80px 区域，搜索入口移到左栏“浏览”，右栏“快捷入口”不再重复全站搜索；左右栏吸顶从 136px 改为 80px，左栏顶部与首屏内容不再被横条或空白遮罩覆盖，滚动时正文也不会从导航下方留白处露出，信息流顶部 8px 吸顶伪元素也不再横切正文或截获点击。
v0.4.15
- 社区桌面左栏“浏览”与右栏“快捷入口”移除“插眼收藏”入口；该入口引用了不存在的
NAV_ICONS.cy，会显示成“undefined 插眼收藏”。插眼补全仍在收藏页内，并保留 #heybox-up-cy 锚点直达。
v0.4.14
- 主题切换与设置拆成两个入口：主题按钮只负责六套预设，旁边新增齿轮 SVG 设置按钮，集中放首页评论预览、动态导航图标与中栏宽度；两个菜单互斥，Esc 与点击外部都能关闭。
- 评论预览浮层的层级从 2147483000 降到 1500：低于站点导航（5000）与全屏 loading（2002），高于正文和编辑器控件；主题、设置菜单及站内其他导航浮层不再被评论预览压住。
- 文章编辑器（
#page-creator-editor）补齐主题覆盖：外层列表、标题栏、正文区、底部工具栏、社区与话题、权限选择、发布栏、右侧预览和帮助面板统一改用主题令牌，深色主题下正文、链接与预览正文恢复可读对比。
- 纸页与雾青不再在编辑器内留下纯白正文块、预览框和按钮底色；
html 背景与 data-mask 边缘同步跟随主题，消除页面缝隙处的浅色细线。
- 发布与关注按钮去掉站点写死的深色渐变，统一使用当前预设的强调色；编辑器开关的选中态与未选中态分别使用强调色和主题描边。
v0.4.13
- 修复社区页搜索建议加载时，空的
.search__pull-list 留下约 26px 浮层并截获首张帖子卡片点击的问题；仅在建议数据为空时收起浮层，正常搜索发现、热榜与建议列表仍按原样显示。
v0.4.12
- 收藏页、文章管理页与文章详情页隐藏右侧二维码、小黑盒加速器、黑盒语音、黑盒工坊及备案信息等冗余模块，主列表同步铺满内容区。
v0.4.11
- 帖子连读去掉底部“上一篇 / 下一篇”文字胶囊，改为纵轴中心左右两侧的 SVG 箭头；保留原有点击、标题提示、禁用态、键盘
[ / ] 与站内路由切换行为。
- 箭头贴近正文两侧留白并在窄屏缩小、1080px 以下隐藏；背景、描边、悬停与禁用态复用当前主题令牌。
v0.4.10
- 修复帖子详情页悬停评论时内容被整块遮住的问题：站点把
.link-comment__comment-item::before 同时用于楼层分隔线和悬停高亮，深色规则误把悬停层涂成了不透明边框色。
- 分隔线规则限定为相邻且未悬停的楼层（
.link-comment__comment-item + .link-comment__comment-item:not(:hover)::before），悬停层恢复站点原有的半透明色，评论文字保持可读。
v0.4.9
- 修复首页评论预览展开后被额外预留一大片横向空间的问题：删除“侧栏宽度 + 48px”的右内边距，改由桌面栅格为预览面板保留与实宽一致的右列。
- 展开预览时页面改用全宽，中栏不再被推向左半边；右列在 1280px 下为 288px、在 1600px 下为 320px，信息流与面板之间只保留 24px 级间距，中栏同时按可用空间收缩并保持居中。
- 修复首次安装时中栏宽度被误夹到下限 40% 的问题：
localStorage 无值时不再把 null 当作 0，默认宽度回到 56%。
- 展开预览时搜索条与中栏同宽同起点，不再横跨左栏上方。
v0.4.8
- 修复评论预览仍不显示 cube 表情的根因：评论接口返回的是
[cube_表情名] 文本，旧解析只接受数字编号，导致所有具名表情都被当成普通文本。
- 内置站点当前 108 个 cube 表情的名称与编号映射，同时继续兼容数字编号和原生
data-emoji 节点；未知表情保留原文，不再吞掉内容。
- 修正精灵图裁切坐标：站点原生样式借助
background-repeat 回卷正坐标，预览层改为无重复背景后必须使用行列为 十位 − 1 / 个位 − 1 的负坐标，表情不再透明。
v0.4.7
- 修复社区右侧评论预览只识别 11–66 号 cube 表情、7x–18x 号表情退化为空白或原始标记的问题；现在支持精灵图内的 11–186 号表情。
- 精灵图按 6 列 × 18 行回卷坐标，修复列 6 与行 18 在
no-repeat 下落到图片边界外而显示空白的问题。
v0.4.6
- “我的文章”与频道页在深色主题下增加兜底扫描：页面渲染完成后检查根容器内元素的实算样式，把近白底色、近白描边与落在暗底上的深色文字分别挂上
heybox-up-dark-flat、-flat-subtle、-edge、-ink 类，再用主题令牌覆盖，站点新增白色块时无需逐条补选择器。
- 扫描只在暗色主题且根容器存在时执行，单次最多检查 3000 个元素，跟随 DOM 变更做 350ms 防抖；切回浅色主题会移除全部兜底类。
v0.4.5
- 顶部导航去掉 CY 入口，只保留首页、社区、收藏、文章四项；插眼收藏本来就在收藏页里，不再单列一个入口。
- 社区工作台中栏改为居中：
.content 用 1fr | 中栏 | 1fr 三栏栅格，左右两列等分，中栏默认占屏幕 56%，可在主题菜单里选 40% / 48% / 56% / 64% / 72%，偏好写入 heybox-up.feedWidth.v1；中栏上限 1180px，并保证两侧至少留 560px，避免侧栏压到正文。
- 社区左栏（含“浏览”入口与频道列表）下移到 136px，不再被站点 sticky 搜索条遮住；≥1200px 时隐藏原生横向频道条，避免与左栏重复。
- “我的文章”创作者页（
#page-creator-content-management 与 -detail）补齐深色：页头、标签栏、条目悬停底色、分隔线、数据指标卡（.creator__data-indicator）、图表区、草稿页与预览框都改用主题令牌。
- 频道页（
#page-topic-link）补齐深色：整页底色、上下两条固定色条、面板/页头/筛选行、底部渐隐条、分屏线，以及右栏的社区指标与小程序卡片。
v0.4.4
- 帖子详情页（≥1200px）正文与评论各自滚动：正文列吸顶、限高到视口并单独出滚动条，评论列改为同高的独立滚动区，滚到边界不再带动整页。
v0.4.3
- 评论预览支持站点表情：正文按片段解析，
data-emoji 的 cube 表情与 [cube_NN] 文本标记都渲染成 17px 精灵图，位置按站点 CSS 的 (7-N%10, 19-floor(N/10)) 换算，不再被当标签剥掉后变成空白。
- 预览正文里的图片按原样惰性加载；只有纯图片或无文字评论才显示“（图片或表情评论）”占位。表情与图片都用 DOM 节点创建，不注入站点返回的 HTML。
v0.4.2
- 修复评论预览只对首条帖子可用：评论按钮不再要求位于帖子锚点内，视频/图集等卡片模板缺少外层链接时回退到整张卡片查找
link/<id>。
- 面板展开后悬停信息流卡片 600ms 即切换预览，无需精确点中评论数字；收起状态不跟随悬停，滚动与按下鼠标会取消待触发的切换。
v0.4.1
- 补齐帖子正文内嵌
com-* 卡片族的深色适配：9 类卡片容器与 .is-editor-mode、占位卡、::after 描边、奖项表行边框、主次文字、药丸与表头底色、深色实心按钮、图片占位底统一改用主题令牌。
- 评论区的
.comment-item__writer-like span 药丸底、.children-item__comment-creator 蓝色作者名与 .scroll-list__no-more-desc::before 浅色分隔线一并覆盖。
v0.4.0
- 宽屏社区首页改为桌面工作台：≥1500px 三栏（左频道、中信息流、右热度），1200–1499px 双栏，窄屏回到单列。
- 左栏复用站点话题按钮生成频道列表，点击转发给原生按钮；右栏按当前信息流生成热门排行与快捷入口，不请求新接口。
- 评论预览展开时右栏自动隐藏，避免与预览侧栏争抢空间；左右栏 sticky 吸顶并复用主题令牌。
v0.3.5
- 社区页新增社区内搜索：只在当前
topic_id 内请求帖子，支持时间筛选、加载更多、全站搜索入口与返回社区。
- 搜索结果使用站点主题令牌与冷灰蓝强调色，结果面板打开时隐藏原生信息流，避免两套列表叠加；窄屏隐藏社区胶囊并缩小缩略图。
- 搜索请求先带签名，失败后回退无签名；关键词、筛选与结果只保存在页面内存，不写入
localStorage。
v0.3.4
- 顶部导航重做为首页、社区、收藏、CY、文章五个「SVG + 文本」入口，隐藏站点原有的七个文字按钮；图标默认播放轻量动效，主题菜单新增“动态导航图标”开关，偏好写入
heybox-up.navMotion.v1。
- 收藏与 CY 共用收藏页地址，CY 入口带
#heybox-up-cy 锚点并滚动到“插眼收藏”区块；从其他页面进入时用 sessionStorage 标记，等区块挂载后再定位。
- 帖子页新增上一篇/下一篇切换，按信息流顺序切换，支持
[ 与 ] 快捷键；切换走站内路由，不整页刷新，并滚动回顶部。
v0.3.3
- 首页评论预览改为默认开启：进入社区首页直接展开首条帖子的评论，不必先点开帖子，也不发生跳转；首条帖子只自动打开一次，手动收起后不再弹出。
- 主题菜单底部新增“首页评论预览”开关（分隔线与主题列表隔开），关闭后浮层完全隐藏、页面右缘不留标签，评论数字恢复站点原生行为；偏好写入
heybox-up.commentPreview.v1，刷新后保持。
- 收起态右缘标签文案改为“评论预览”，空态提示说明会自动显示首条帖子的评论。
v0.3.2
- 卡片底部 4px 色带的隐藏改为所有主题生效：纸页与雾青底色偏暖、偏冷，近白色带同样显眼；浅色主题下隐藏不改变视觉。
- 主题样式节点复用前比较内容，脚本热更新后不再残留旧 CSS，避免必须整页刷新才生效。
v0.3.1
- 深色主题移除帖子卡片底部的 4px 浅色色带（
.hb-bbs-image-text、.hb-bbs-post、.hb-bbs__video 的 ::after），卡片改用边框与间距分隔。
- 楼层分隔线、楼中楼展开线、回复区顶线、标签下划线、相关推荐分隔线与回复输入框伪边框统一改为主题边框色，消除深色下的亮白细线。
v0.3.0
- 社区信息流改为 960px 居中阅读栏与卡片列表：14px 圆角、20px 内边距、12px 间距、细边与轻阴影，标题 17px/1.5、正文 15px/1.72，话题条同步卡片化。
- 帖子页改为 1360px 两栏：正文纸张卡内边距 28px 32px，标题 25px/1.42，正文 16px/1.85、段落限宽 46em；评论卡 424px、sticky 吸顶，楼层 14px/1.7。
- 新增根级设计令牌与主题差异化圆角、阴影；搜索栏与信息流同宽对齐，侧栏展开时整体左对齐。
- 修复帖子标题选择器漏掉
.section-title__content，补齐排序栏被站点全局通配规则覆盖的问题。
- 补齐浅色主题基础变量，避免新卡片规则回退到透明底。
v0.2.1
- 帖子页评论区新增“屏蔽 CY”开关，按
link/tree 返回的 is_cy 标记楼层并隐藏；按钮显示已屏蔽条数，站点重渲染后由 MutationObserver 重新标记。
- 信息流评论预览新增 CY 开关，过滤 CY 楼层与楼中楼引用，说明行显示屏蔽数量；与帖子页共用
heybox-up.hideCy.v1 偏好。
v0.2.0
- 社区首页新增评论预览浮层：默认收起为右缘竖向标签，点信息流里的评论数字展开悬浮面板（288px，宽屏 320px），与信息流之间留 96px 空白，读取
/bbs/app/link/tree，按 20 条翻页，支持收起按钮与 Esc，进入帖子页或窄屏时隐藏。
- 收起状态保留已加载内容，重新展开不重复请求；接口失败时提示原因并提供“打开帖子”入口。
v0.1.12
- 深色主题补齐站点伪元素底色：论坛首页帖子之间的白色分隔条、搜索框所在
section 与 main.list 的浅色伪元素、个人主页动态分隔条。
html 根元素同步改为深色，消除页面边缘与滚动区域的浅色露底。
v0.1.11
- 帖子页评论区改回站点原生 DOM 位置，用 CSS Grid 排成右栏，修复标题栏 sticky top 覆盖首条评论头像的问题。
- 新增评论区排序工具栏（默认/时间/点赞/作者），只改 style.order，站点重渲染后自动恢复。
- 补齐嵌套回复块与个人主页列表的深色底色，深色扫描不再发现浅色残留（登录表单除外）。
v0.1.10
- 移除社区首页自定义评论面板与帖子阅读视图，首页右栏热门社区、二维码等模块整体隐藏，信息流占满宽度。
- 帖子详情改为左右双栏：正文保留在左栏，站点原生
.link-comment 停靠右栏，排序、回复、点赞与展开楼中楼全部复用站点逻辑。
- 删除评论 API 拉取、签名请求、五种排序与 CY 屏蔽开关，减少重复数据源与维护面。
- 补充夜航主题对原生评论区、回复编辑器、加载动画与消息浮层的覆盖。
v0.1.9
- 主题从三态循环改为六预设菜单，新增纯黑、纸页、雾青；纸页改用衬线标题与细边扁平卡片，雾青使用大圆角与柔和阴影，纯黑使用纯黑底、低圆角与无阴影。
- 深色规则改用
data-heybox-up-dark 布尔标记，夜航与纯黑共享全部深色覆盖，避免新增预设漏掉深色样式。
- 补齐帖子页列表、返回按钮、头图占位、分页标签，搜索页筛选、价格、小程序、工具栏、热搜，以及 Element Plus 表格与浮层的深色残留。
v0.1.8
- 社区首页右栏改为评论面板：隐藏热门社区等冗余模块，左栏读帖子正文，右栏看该帖评论。
- 新增五种评论排序（默认、时间、最近回复、点赞、作者优先）与“屏蔽 CY 评论”开关，偏好写入本机
localStorage。
- 评论按楼中楼渲染，标注作者与 CY，支持分页加载、失败重试与未登录提示；正文支持段落、HTML 文本与图片。
- 视口 ≤1080px 自动退出增强并恢复站点原右栏。
v0.1.7
- 新增宽屏布局：≥1200px 时放宽站点容器上限并压缩两侧留白，社区、收藏与帖子页列表获得更多横向空间。
v0.1.6
- 新增跟随系统、深色、浅色三态主题，导航栏图标按钮循环切换，偏好仅写入本机
localStorage。
- 深色模式覆盖站点背景、导航、社区信息流、帖子容器、输入框、弹层与 Element Plus 变量，并统一正文颜色；登录表单保持浅色。
- 补全社区信息流标签与话题名的深色样式，修复浅色块残留。
v0.1.5
- 新增专用图标：深蓝灰底、盒形边框与眼睛图形；源文件
docs/assets/heybox-up.svg，脚本 @icon 使用内联 data URI。
- 插眼内容图标从红色改为蓝灰色
#6f8db3，与整体冷色图标一致。
- 收藏区块新增条数统计、标题/插眼内容搜索、手动刷新与失败重试。
- 去重判断从“页面 ID 数量”改为“页面 ID 集合签名”，分页替换条目后能正确重新渲染。
v0.1.4
- 插眼内容前加 CY 眼睛图标，14px 字号，最多 3 行，悬停显示全文。
- 无文字内容的卡片弱化为灰色提示，避免与真实插眼文字混淆。
v0.1.3
- 移除右下角“插眼收藏”胶囊按钮与浮层，只保留收藏页的插眼补全。
- 同步删除浮层专用样式与渲染逻辑；
createCard 供收藏页区块继续使用。
- 功能入口收敛到收藏页，不再向其他页面注入常驻 UI。
v0.1.2
- 收藏页补全：在 /app/user/favour/content 的收藏列表下方追加插眼条目，解决「收藏数算入插眼、点进去却看不到」的落差。
- 抽出 createCard 供浮层与收藏页共用；按页面已渲染帖子 ID 去重。
- 站点 SPA 路由切换时自动挂载或移除区块。
v0.1.1
- 审核整改：
@description 补全功能、权限与影响披露（以登录态读取本站插眼、本地自算签名、仅写本机缓存、需登录）。
- 新增
@homepageURL、@supportURL 与内联 SVG @icon。
- 浮层说明行补「仅存本机，不上传」，不改接口、UI 结构与交互行为。
- 文档新增「十、合规披露」，按平台协议逐条说明数据访问、数据流向与账号影响。
v0.1.0
- 首个版本：插眼收藏浮层、自算接口签名、按帖子去重、搜索、10 分钟缓存、加载与错误状态。
- 新增签名回归测试与实时签名验证。
九、许可证
MIT License
十、合规披露
按平台协议「脚本描述须准确反映功能、权限及可能的影响」逐条说明：
- 权限：
@grant none，无特权 API，无 GM_xmlhttpRequest，无跨域提权。
- 数据访问：读取当前登录账号的
heybox_id Cookie，并以该登录态请求小黑盒自身接口 /bbs/app/profile/bbs/comment/list（本账号的插眼记录）。信息流评论预览、抽屉分页与 CY 标记会按需请求站点评论树接口 /bbs/app/link/tree。点赞、收藏、收藏夹列表与 CY 发布仅在用户点击对应按钮时调用站点写接口或收藏夹接口。
- 请求签名：接口要求
hkey、_time、nonce。脚本在本地自行计算，不下载、不执行任何外部代码；规则见「三、接口签名」。
- 数据流向：插眼结果只写入本机
localStorage（键 heybox-up.cy.v1:<userid>），主题与功能开关写入 heybox-up.theme.v1、heybox-up.commentPreview.v1、heybox-up.navMotion.v1；连读顺序只写入当前标签页的 sessionStorage。评论内容与排序由站点自己管理，脚本不保存。不向任何第三方服务器发送数据，无统计、无埋点、无追踪。
- 账号影响：仅在用户主动点击阅读栏的点赞、收藏或 CY 发布时，以当前登录态提交对应操作；浏览、收藏补全、评论预览与排序不改站点数据，也不改写站点收藏总数。
- 必须登录：写操作未登录时只提示「请先登录小黑盒」，不发起写请求。
- 与站点功能的关系：小黑盒 Web 端没有插眼列表入口（官方插眼记录在 App 的「我 → 动态 → 评论」）。脚本只呈现既有接口数据，不绕过登录、权限或付费。
@antifeature：无返佣链接、无广告、无付费、无挖矿、无会员限制、无用户追踪，故未声明。- 代码来源：独立实现，未复制第三方脚本代码；MIT 许可，见「九、许可证」。
