HeyBox Up
面向小黑盒 Web 端的用户脚本（UserScript）：网页收藏列表不显示“插眼”（CY）条目，但主页收藏总数会把它们算进去。本脚本单独拉取插眼收藏，在收藏页把插眼条目补到收藏列表下方，按帖子去重。社区首页（/app/bbs/home）移除右栏热门社区等冗余模块，改为定宽卡片信息流，并支持在右侧预览帖子评论；帖子详情页（/app/bbs/link/*）默认进入全屏沉浸阅读，封面与标题上下分栏、正文连续滚动，原生评论收进侧栏，保留原生回复与点赞，并在评论区补充默认/时间/点赞/作者排序。右侧互动栏可直接点赞、收藏与发布 CY，评论区仍可按 is_cy 过滤插眼评论。顶部导航收敛为首页、社区、收藏、文章四个「SVG + 文本」入口；帖子页纵轴中心左右两侧提供 SVG 上一篇/下一篇箭头，切换走站内路由，不整页刷新。社区页（/app/topic/link/*）提供只在该社区内生效的帖子搜索；宽屏社区首页改为左频道、中信息流、右热度三栏工作台。
- 版本：0.4.36
- 许可：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。写请求与站点自身 axios 配置一致，使用 application/x-www-form-urlencoded;charset=UTF-8 请求体，query 携带同一套签名参数、评论创建专用的 _rnd 与 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 三个签名参数；评论创建接口 /bbs/app/comment/create 另要求 _rnd。脚本内独立实现：
time = floor(Date.now() / 1000)。nonce = md5(time + Math.random()).toUpperCase()，32 位十六进制。hkey 的签名输入为 time + 1、归一化路径与 nonce：路径归一化为 /a/b/c/，三部分分别按 35 字符字母表 AB45STUVWZEFGJ6CH01D237IXYPQRKLMN89 映射后交织，截取前 20 个字符作为种子。- 种子取 MD5 后，前 5 位映射为 5 字符主体；末 6 位的字符码经列混合与求和后
% 100 得到 2 位校验，组合成 hkey。
两个容易写错的细节：
xtime 左移结果不能对 255 取模，服务端算法保留高位；截断会算出不同的校验位。- 列混合只改写前 4 个字节，但求和必须包含原数组全部 6 个字节，否则校验位偏移。
MD5 覆盖 UTF-8 字节，md5Hex 与 Node crypto 结果一致。hkey 的签名输入包含时间、归一化路径与 nonce，不包含 link_id、page 等其他查询参数；评论创建的 _rnd 则使用本次请求查询参数中的 nonce 与 _time。
评论创建的 _rnd 复用同一次请求的 nonce 与 _time。站点当前使用 15 作为版本前缀，并以 Z7mFG4tQp9Ws2LxB8H 作为 HMAC 密钥；签名为小写十六进制：
message = secret + nonce + _time + ":" + nonce
_rnd = "15:" + lowercaseHex(HMAC-SHA256(secret, message))
_rnd 只加在评论创建请求上，点赞与收藏沿用原有查询参数。
四、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 黑底低圆角）、浅色（站点原色）、纸页（暖纸底、衬线标题、细边扁平卡片）、雾青（冷雾底、大圆角、柔和阴影）；齿轮菜单放“首页评论预览”“动态导航图标”“沉浸阅读”三个开关（后两者默认开启）、“正文行距”数字输入框（1.4–2.2 倍，步进 0.05，默认 1.7），以及“中栏宽度（占屏幕宽度）”的 40% / 48% / 56% / 64% / 72% 分段按钮和可自行输入 40–76 整数的百分比输入框：留空或填非法值恢复已存宽度，超出范围自动夹到上下限；菜单内容高于视口时自身滚动。两个菜单各自开关，打开一个会收起另一个，支持 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 浅色分隔线改为主题描边；工具栏图标、更多组件菜单文字与分隔线同步提亮，避免深底深字和接近隐形的图标。
- 用户主页与作者浮层：用户主页（
#page-user-profile，路径 /app/user/profile/*）的投稿卡片去掉站点用伪元素画的 4px 近白分隔带，标题改用主题文字色，时间、评论数与标签页改用次级色；右栏只放小黑盒 APP 下载二维码、加速器、语音与备案信息，整栏隐藏并让主列表撑满内容区。鼠标停在作者行弹出的 .name-box .detail-info 作者信息浮层改用主题底色、描边与阴影，箭头同步取主题底色，里面的等级、IP 与简介文字跟随主题，浮层尺寸与层级不变。
- 版式重做：窗口宽度 ≥1200px 时外层容器为 1360px、居中，两侧留白 24px。社区信息流按屏幕宽度的固定比例居中（默认 56%，可在齿轮设置菜单里调整），帖子之间改成 14px 圆角卡片，卡片内边距 20px、间距 12px，用细边与轻阴影区分条目，悬停只抬升边框与阴影。搜索栏跟随信息流同宽居中，不再比信息流每侧多出一截。
- 信息流排版：卡片标题 17px/1.5、600 字重，正文 15px/1.72，作者行压到 13px；底部互动条用 1px 细线分隔。图片圆角 10px，整体层级靠字号、颜色与留白拉开。
- 帖子沉浸阅读：桌面正文 18px、行距默认 1.7 倍、限宽 34em，舞台 732px，右缘另留 80px 互动栏轨道，整组居中；移动端占满视口、正文 17px。首屏封面占据标题以上空间，图片用
contain 完整露出，背后是同一张图的模糊底色，不再裁切两侧；标题、标签与作者行移到封面下方的独立区块，使用主题底色，不再以玻璃卡压住图片。正文改为连续滚动，段落、图片与富文本块自然衔接，长图和长文按原始高度展开，大图仍可点开遮罩。右侧互动栏离正文 36px，移动端收进舞台右缘并隐藏栏内头像；封面多图可横向切换或点分页条，左右滑动只切封面，滑到末图再左滑进入正文。顶部左侧为返回、社区首页、作者与关注，右侧为分享与关闭；结尾操作区同样提供“社区首页”按钮。右侧竖排点赞、收藏、评论、CY 发布、分享、行距设置，底部显示阅读百分比与进度。行距设置按钮打开右侧深色小面板，可输入 1.4–2.2 倍并一键恢复默认 1.7 倍，点外部或按 Esc 收起，与收藏夹菜单互斥。阅读器开启时站点原有的左右翻页箭头隐藏。
- 阅读键盘：
↑ / ↓、PageUp / PageDown、j / k 与空格按约 0.82 屏滚动，Home / End 跳首尾，← / → 只在封面切图，C 开关评论，H 返回社区首页，R 或 Esc 关闭当前文章的沉浸阅读。点在输入框、文本域或可编辑区域内时不拦截滚动键与 H，但 Esc 仍先关评论。阅读器开启时 [ 与 ] 不触发外部翻页。
- 评论抽屉：评论优先使用站点原生
.link-comment，桌面从右侧滑出 440px，移动端占满宽度；打开时把站点 #page-bbs-link 层抬到舞台之上，同时清空主题背景与指针拦截，避免整页底色盖住阅读舞台；背景加半透明遮罩，焦点移到关闭按钮，阅读区 inert，关闭后焦点回到评论按钮，Tab 在抽屉内循环。排序、屏蔽 CY、回复、点赞与展开楼中楼全部沿用原生逻辑。原生节点未挂载时等待约 1.4 秒，仍无节点则打开只读回退抽屉，显示头像、昵称、时间、正文、图片、表情与引用回复，并支持分页加载。回复编辑器固定在抽屉底部，不遮住正文。
- 阅读互动：点赞与收藏直接调用站点写接口，按钮状态与计数来自评论树
result.link；未收藏时弹出收藏夹列表，已收藏时再次点击直接取消；CY 按钮打开 520px 输入卡，提交后以 is_cy=1 发布并更新评论数；关注按钮转发站点原生关注按钮，请求结束后重新同步状态，已关注时再点一次走站点的取消关注确认对话框；确认框改用主题底色并抬到阅读舞台之上，Esc 先关确认框再关阅读器；未登录统一提示「请先登录小黑盒」。
- 分享：顶部与右侧分享按钮先调用系统分享面板，不可用时复制
https://www.xiaoheihe.cn/app/bbs/link/<id> 并显示“链接已复制”，不再代理隐藏的原生分享按钮。
- 抽屉加载提示：打开时若评论楼层尚未渲染，先显示“正在加载评论…”，约 3 秒后仍为空则改为可点击重试；评论出现后提示自动移除，避免打开后面对空白面板。
- 退出与记忆：顶部关闭按钮、
R 与 Esc 只关闭当前文章的阅读器，并提示已退出；齿轮菜单的“沉浸阅读”开关才修改持久偏好。两种关闭都立即恢复站点原生双栏与外部翻页器，进入其他帖子仍按全局偏好自动开启。阅读位置按帖子写入 sessionStorage，返回同一帖时回到原页。
- 加载占位：帖子数据尚未渲染时先显示“正在加载文章…”，拿到正文后再替换，不会先露出被隐藏的原生页面空白。
- 关闭沉浸阅读后的排版：正文与评论各成一张卡片，中间留 24px。正文卡内边距 28px 32px，标题 25px/1.42/700，正文 16px、行距跟随“正文行距”偏好（默认 1.7 倍），段落限宽 46em、下间距 .72em；引用块用 3px 左边线并保持 1.8 行高，标题、段落与图片间距单独收紧。右栏评论 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、reading-line-height、radius-card、gap、card-pad、shadow-1、shadow-2。纸页主题把卡片圆角收到 4px、去掉一级阴影并改用 Georgia 衬线标题；雾青用 18px 圆角与更柔的投影；纯黑用 8px 圆角与深投影。
- 响应式：视口 ≤1100px 时信息流宽度回到
min(960px, 100%)，卡片内边距收到 16px；≤900px 时沉浸阅读的互动栏收进舞台右缘，≤760px 时舞台占满宽度、正文 17px，≤520px 隐藏作者名与“继续阅读”，结尾卡保留作者、统计、标签、社区首页与翻页。顶栏的社区首页按钮在 ≤520px 收为 38×38 圆形图标。视口高 ≤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 定位，并跳过浏览记录里已访问的帖子。信息流没有未访问的后续条目时，“下一篇”改取页面“相关推荐”中第一个未访问项；仍没有候选时按钮禁用并显示“没有下一篇”。结尾“继续阅读”同样过滤当前文章与已访问帖子，最多显示 4 条。“上一篇”仍由本次会话的浏览记录提供。
- 评论区留在站点原有 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–76 的整数百分比，默认 56；齿轮设置菜单里的分段按钮（40 / 48 / 56 / 64 / 72）与自定义输入框共用这一键，只改 CSS 变量 --heybox-up-feed-pct，不重排 DOM。
- 正文行距键
heybox-up.readerLineHeight.v1，取值为 1.4–2.2 的倍数（保留两位小数），默认 1.7；齿轮设置菜单与阅读页右侧行距面板共用，写入根级 CSS 变量 --heybox-up-reading-line-height，只作用于正文文本，标题、代码块、引用与站点卡片保持各自行高。
- 连读顺序键
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；帖子数据未渲染时出现“正在加载文章…”占位（实测于响应较慢的帖子页）。
v0.4.30 在 1440×900 与 390×844 复核写请求与回退抽屉：mock 点赞捕获 link_id=194343256&award_type=1，mock 收藏捕获 favour_type=1&link_id=194343256&userid=12345&folder_id=123，mock CY 捕获 is_cy=1&link_id=194343256&reply_id=-1&root_id=-1&text=hello+CY+test，三者请求头均为 application/x-www-form-urlencoded;charset=UTF-8，成功后分别提示“已点赞”“已收藏”“CY 已发布”，按钮状态与评论数同步更新；无登录态的真实 CY 请求返回“请先登录小黑盒”，不再出现 link_id 缺失。把 .link-comment 临时改名模拟原生节点缺席后，评论按钮在约 1.4 秒后打开回退抽屉，1440 下 440px 宽、读取 24 条评论、scrollWidth=439 与 clientWidth=439，390 下抽屉占满 390px、无横向溢出；回退抽屉内头像、昵称、时间、正文、表情与引用回复均可见，关闭后 inert 恢复为 false，再次点击可重新打开。分享按钮在 1440 与 390 下均复制 https://www.xiaoheihe.cn/app/bbs/link/194343256 并显示“链接已复制”，不再触发隐藏的原生分享按钮。
社区频道页用 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)；扫描编辑器根节点未再发现近白背景或近白描边。
文章编辑器用 1440×900 复核纸页与雾青：.editor-article__main-content、.hb-editor 与 .ProseMirror 的底色分别为 rgb(255, 253, 247) 与 rgb(251, 253, 254)，和标题栏、工具栏共用编辑器卡片的 surface，不再出现更深的 --heybox-up-subtle 色块。图文与视频编辑器在雾青、夜航下，.editor-image-text__main-content、.editor-video__main-content 与上传框均使用主题 surface，描边分别为 rgb(211, 224, 229) 与 rgb(45, 56, 69)；主画布不再残留 rgb(250, 251, 252) 近白底，深色主题下浅色文字保持可读。
性能回归用无头 Edge、1440×900 与 4 倍 CPU 降速验证：社区首页注入脚本并稳定后，连续触发 150 帧与前版相同的合成 DOM 变更，优化前两轮 ScriptDuration 为 1.08 / 1.12 秒，优化后为 0.34 / 0.29 秒，降幅约 71%；同组 TaskDuration 由 1.83 / 1.89 秒降至 0.54 / 0.78 秒，RecalcStyleDuration 由约 0.10 秒降至 0.03 / 0.06 秒。正常滚动 180 帧时脚本耗时与前版持平，页面交互不受节流影响；编辑器输入区与脚本自身面板产生的 DOM 变化不触发全站同步。
v0.4.33 用同一套无头 Edge / 1440×900 / 4 倍 CPU 降速用例连续复测两轮：150 帧合成变更下，页面同步任务从 PR #69 基线的 102 / 103 次、67.6 / 43.4ms 降至 10 / 10 次、10.6 / 16.4ms，任务次数均值下降约 90%，总任务耗时均值下降约 76%。同一轮整页 ScriptDuration 为基线 0.455 / 0.339 秒、当前 0.285 / 0.331 秒，受站点渲染与 GC 噪声影响，只作为辅助参考；任务级计数才是本次调度的稳定指标。文章直读用例中，基线产生 85 次页面同步任务、约 38.0ms，当前为 0 次；阅读器 101 帧滚动只写入 5 次阅读比例（每 400ms 合并）。390×844 复测 #app 为 375.2px、页面横向溢出为 0，阅读器容器宽 390px、scrollWidth 与 clientWidth 均为 390px。
首页默认预览验证（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”。
v0.4.34 用本地无头 Edge（CDP）与合成文章 DOM 复核，控制台错误为 0：阅读器开启后站点外部翻页器实算 display: none，顶部与结尾各有一个“社区首页”按钮；从 order=1001,1002、浏览记录 1001,1002、相关推荐 1001,1003 进入 1002 时，下一篇指向未访问的 1003，结尾推荐只剩 1003；order=1001,1002,1003 且浏览记录 1001,1002 时下一篇为 1003，候选耗尽时按钮禁用并显示“没有下一篇”，结尾不出现“继续阅读”。点顶部关闭后阅读器移除、外部翻页器恢复 display: block、localStorage["heybox-up.reader.v1"] 仍为 "1"，提示“已退出当前文章的沉浸阅读”在 1.2 秒内未自动重开；READER_EVENT 可重新开启，Esc 同样只关闭当前文章。阅读器开启时 [ 与 ] 不改变地址，关闭后分别进入 1001 与 1003 并重新开启阅读器。H 与两处首页按钮都跳到 /app/bbs/home，焦点在输入框时 H 不触发。320 / 390 / 520 / 820 / 1440px 下页面与顶栏横向溢出均为 0，标题栏在 1440 下宽 812px；320–520px 首页按钮为 38×38 圆形，820px 与 1440px 为 96px 宽的图标加文字；320px 结尾卡与操作区位于 24–256px，首页按钮宽 103px。以上为本地 DOM 级验证，真实登录态页面仍受图片验证码影响。
七、运行时架构
- 单一页面运行时：脚本仍以单个
scripts/heybox-up.js 分发，但内部按签名、存储、请求、样式、页面调度、主题、评论预览、沉浸阅读与路由工具分区；不引入框架，也不在运行时加载外部模块。
- 路由感知调度：所有页面同步任务共用一个
MutationObserver，每个任务声明适用路由与 DOM 区域。路由切换时强制执行一轮清理，平时只有相关区域变化才唤醒对应任务，避免文章页的观察器为首页或收藏页重复工作。
- 显式请求生命周期：所有 JSON 请求共用 15 秒超时封装；评论预览、阅读器评论、链接状态、社区搜索与收藏夹列表分别持有
AbortController。切换帖子、社区、预览或离开路由时取消旧请求，并把过期响应丢弃。
- 有界缓存：评论预览按
link + page 缓存，最多 24 页、2 分钟失效；CY 发布后只清除对应帖子的缓存。收藏列表仍按用户隔离并使用 10 分钟缓存。
- 共享基础能力：
localStorage / sessionStorage 经同一访问器提供内存降级与 JSON 读写；样式优先写入构造样式表，不支持时回退到 <style>；状态样式表与内容样式表分别按 ID 持有。
- 阅读器热路径：进度节点、正文源节点、原生互动按钮和阅读状态均缓存；滚动进度只更新文本与进度条，阅读比例每 400ms 合并一次，并在渲染、退出、
pagehide 与页面隐藏时强制落盘。正文分页先写入 DocumentFragment，再一次性挂载。
- 主题扫描分级：主题变量负责主体表面，DOM 兜底扫描只处理站点写死的近白底色与暗字；扫描复用单次计算样式与祖先底色缓存，并在浏览器空闲时执行。
- 可回退渲染：原生评论、Vue 路由、站点分页与写接口任一不可用时，优先保留站点原生路径；只有确认原生节点缺席才使用脚本回退 UI，并给出可见错误，不伪造成功状态。
八、限制与解决方案
下表按根因合并重复项，逐项记录当前版本仍存在的限制、最优可行方案与落地状态。固有约束 表示不能在不伪造数据或绕过站点权限的前提下消除；部分缓解 表示已有降级路径，但仍依赖站点结构。
8.1 限制与方案登记
| 限制 |
最优可行方案 |
状态 |
| 站点 DOM、类名与路由会无通知改版 |
集中选择器注册表、主备选择器、可见失败态与真实页面回归 |
部分缓解 |
| 接口签名、风控、验证码与登录要求由站点控制 |
共用签名请求层、超时、取消、签名回退与明确的登录/验证提示 |
部分缓解 |
| 收藏总数由服务端计算，插眼条目不计入网页收藏列表 |
只解释数量差异，不伪造或改写服务端计数 |
固有约束 |
| 插眼列表单用户最多 200 条，搜索只覆盖已加载缓存 |
增加游标分页与“加载更多”，有索引时再走服务端搜索 |
未实施 |
| 评论预览只读，不能直接回复、点赞或展开楼中楼 |
保留“打开帖子”与原生评论抽屉，只读边界保持清晰 |
设计取舍 |
| 评论树按楼层分页，楼中楼只取前两条，单帖最多读取 200 条 |
用游标继续分页；楼中楼展开交给原生评论区 |
部分缓解 |
| 悬停预览过去每次切换都会发新请求 |
600ms 悬停延迟、切换取消、24 页有界缓存与 pointerout 取消 |
已实施 |
| 自动预览依赖信息流首个帖子链接 |
保持评论数字手动入口；容器缺失时明确回退到原生跳转 |
部分缓解 |
| 沉浸阅读只支持图文帖与文本帖，视频帖、投票帖走原布局 |
按帖子类型增加通用块解析器，无法解析时明确回退 |
部分缓解 |
| 克隆正文里的 iframe、视频、画布与纯图标组件不保证可交互 |
语义块渲染、事件代理、受支持组件转发；其余标明“打开原帖” |
部分缓解 |
评论抽屉只接管首个 .link-comment，页面若拆分多个浮层会遗漏 |
枚举并合并多个评论根节点，保持同一焦点与关闭协议 |
未实施 |
| 深色、纸页、雾青仍依赖站点类名；新增卡片和伪元素可能漏白 |
主题令牌桥接、空闲兜底扫描、伪元素清单与新增卡片登记 |
部分缓解 |
站点全局 * 重置会覆盖 Shadow DOM 的普通声明 |
Shadow 组件关键样式继续使用 !important，新增组件沿用约束 |
固有约束 |
| 宽屏三栏、右栏隐藏与全站搜索撑满依赖站点容器结构 |
选择器注册表、逐模块隐藏与结构缺失时的原生回退 |
部分缓解 |
| 桌面右栏整栏隐藏，热门排行只统计已渲染卡片 |
改成模块级开关；排名只对已加载数据标注范围，后续接服务端排序 |
未实施 |
| 顶部导航按地址判断激活项，纯前端状态切换时可能滞后 |
监听站点路由状态并以 MutationObserver 校正，保留路径兜底 |
部分缓解 |
| 连读顺序只来自已渲染信息流，Vue router 不可用时退化为整页跳转 |
预取相邻列表页；router 缺失时继续使用站内原生链接 |
部分缓解 |
社区搜索依赖 .topic-link__main 与筛选行结构 |
优先插到筛选行父节点，缺失时回退 .topic-link__main；名称多级回退 |
已实施 |
社区搜索不支持 filter_tag、不持久化关键词，重复页不会自动继续翻页 |
对齐站点筛选参数，使用 URL 会话状态，并设置有限次自动翻页 |
未实施 |
| 阅读位置只存当前标签页；作者排序按用户名，同名用户会并列 |
阅读位置改存带版本与过期的本机记录；作者排序改用用户 ID |
未实施 |
| 单文件约 8500 行，样式、请求与存储曾重复实现 |
保持单文件分发，先抽内部纯函数与生命周期；后续再引入确定性构建 |
部分缓解 |
| 页面级同步曾按全局 DOM 变化广播到所有任务 |
单观察器、路由过滤、六类区域版本号与延迟任务重排 |
已实施 |
| 导航或切换预览后旧请求仍可能回写 UI |
15 秒超时、按任务取消、响应代际校验、有界评论缓存 |
已实施 |
阅读器滚动每帧查节点并写 sessionStorage |
缓存进度与源节点，400ms 合并写入，退出时刷新 |
已实施 |
站点 CSP 若禁止内联样式，旧 <style> 注入会失效 |
优先 adoptedStyleSheets，不支持或构造失败时回退 <style> |
已实施 |
| 仓库没有 CI，也没有完整登录态端到端自动化 |
增加 node --check 工作流，再用隔离配置补 Playwright/CDP 冒烟 |
未实施 |
移动端、低高度视口与旧版 100dvh 兼容需要逐项回归 |
响应式夹取、100vh 回退与 390×844 / 844×390 冒烟 |
已实施 |
8.2 现行细则
- 不改站点收藏总数；该数字由服务端
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 条）；超过上限的楼层保持原样，不误隐藏。
- 帖子页首次识别会额外请求评论接口；未登录或触发风控时请求失败，评论保持可见，需打开帖子或稍后重试。
- 回复编辑器仍由站点原生逻辑管理；开启沉浸阅读且打开评论抽屉时，它固定到抽屉底部，点楼层回复会按站点默认行为聚焦该编辑器。
- 社区首页隐藏整个右栏；若后续需要保留右栏中的其他模块，需要改为按模块隐藏。
- 社区首页没有找到可确认的未读筛选路由或接口参数：
H 与“社区首页”按钮只返回 /app/bbs/home，是否仅展示未读内容仍由站点信息流决定，待登录真实页面复核。
- 纸页与雾青预设依赖站点现有类名着色，站点改版后可能出现未着色的新容器；深色预设同样按类名覆盖，登录表单始终保留浅色。
- 站点全局
* { 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 中，站点自己的路由与统计不受影响。
- 导航按地址判断激活项；站点若改用纯前端状态切换而地址不变，激活项可能停在上一页，直到下一次地址变化或导航重建。
- 连读顺序来自进入帖子前已渲染的信息流条目，不额外请求列表接口；未滚动到的后续条目不会进入连读顺序。已访问集合来自本次会话的浏览记录，跨标签页或清空
sessionStorage 后不再生效。直接打开帖子或刷新后，顺序记录可能已失效，此时“下一篇”使用页面相关推荐。
- 连读切换优先调用站点 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.36
- 阅读栏“关注”按钮改为转发站点原生关注按钮，并在请求结束后重新同步状态，已关注时再点一次可正常取消关注；站点确认框套用主题底色，层级抬到阅读舞台之上，Esc 先关确认框。
- 用户主页补齐主题：投稿卡片去掉 4px 近白分隔带，标题、时间、评论数与标签页文字改用主题色；右栏二维码、推广与备案整栏隐藏，主列表撑满；作者信息浮层改为主题底色、描边与阴影。
- 修复部分文章正文仍是深色字的问题：原生正文与阅读器内克隆的段落、列表行统一改用主题文字色，引用块保持次级色。
- 段落下间距从 .9em 收到 .72em；新增正文行距偏好（1.4–2.2 倍，默认 1.7，步进 0.05），齿轮设置菜单与阅读页右侧行距面板都能调，标题、代码块、引用与站点卡片保持各自行高。
- 中栏宽度在 40% / 48% / 56% / 64% / 72% 预设之外新增自定义百分比输入（40–76 之间的整数），与预设共用同一偏好并双向同步；齿轮菜单内容超出视口时自身滚动。
v0.4.35
- 发布 CY 的评论创建请求补上站点当前要求的
_rnd 签名，使用本次请求的 nonce 与 _time 计算 HMAC-SHA256，修复输入内容后提示缺少参数的问题。
- 点赞与收藏请求保持原有参数，评论创建的五个表单字段与请求体编码不变。
v0.4.34
- 沉浸阅读顶栏与结尾卡新增“社区首页”按钮，快捷键
H 也可返回 /app/bbs/home。
- 顶部关闭、
R 与 Esc 改为只关闭当前文章的阅读器，不再改写全局沉浸阅读偏好；进入其他帖子仍自动开启。
- 阅读器开启时隐藏站点自带左右翻页箭头，
[ 与 ] 不再触发外部翻页。
- 连续阅读跳过本次会话已访问的帖子；信息流与相关推荐都没有未访问候选时禁用“下一篇”，结尾推荐同步去重。
- 窄屏首页入口收为 38×38 圆形图标，结尾卡按钮在 320px 下不产生横向溢出。
v0.4.33
- 页面同步改为按路由与 DOM 区域调度：文章、收藏、社区、信息流与全局界面不再互相唤醒；路由切换仍执行完整清理。
- 所有 JSON 请求增加 15 秒超时；评论预览、阅读器评论、链接状态、社区搜索与收藏夹列表在切换或离开路由时取消旧请求，过期响应不再回写界面。
- 评论预览使用最多 24 页、2 分钟的共享缓存，切换预览不再重复拉取同一页；CY 发布后只失效对应帖子。
- 阅读器缓存进度、正文与原生按钮节点，正文通过
DocumentFragment 一次挂载；滚动比例改为 400ms 合并写入，并在退出或页面隐藏时刷新。
- 样式优先使用构造样式表；存储访问统一带内存降级；深色兜底扫描复用计算样式并放到空闲时段执行。
- 离开文章或信息流时卸载分页器与评论预览宿主；收藏夹请求、社区搜索与阅读器写操作增加代际校验，避免旧页面状态污染新页面。
- 小于 800px 时解除站点写死的
#app 宽度下限；桌面左右工作栏只在 1200px 以上挂载，并在跨断点缩放时即时清理。
- 新增限制与解决方案登记表，区分站点/API 固有约束、已缓解项与明确的后续工作。
v0.4.32
- 将九个页面级
MutationObserver 合并为一个共享调度器：所有同步任务按 120ms 窗口合并，站点连续渲染时不再为每个观察器、每一帧重复启动回调。
- 主题、导航、评论排序、收藏、评论预览、连读、沉浸阅读、社区搜索与桌面工作栏分别按 200–400ms 节流；编辑输入区与脚本自身面板产生的变化直接忽略。
- 注入样式只比较一次样式表内容；连读信息流顺序最多每秒重记一次，桌面工作栏最多每 500ms 重扫一次，深色兜底扫描只在相关页面执行且间隔至少 1.2 秒。
- 沉浸阅读复用结构签名，只有文章结构、标题长度或图片/标签/推荐数量变化时才重建正文；互动状态降为每秒刷新一次，操作完成后仍立即同步。
v0.4.31
- 纸页与雾青主题的文章编辑正文改用编辑器卡片的主题底色，不再把整块编辑区铺成更深的
--heybox-up-subtle 色块，标题、正文与底部工具栏重新连成一张纸面。
- 图文与视频编辑器的正文画布、上传框改用主题 surface 与 border；修复深色主题下画布仍显示
rgb(250, 251, 252) 近白底、浅色文字落在白底上的问题。
- 图文与视频正文画布的内描边同步改用主题描边，避免浅色阴影在纸页和雾青里形成额外的灰边。
v0.4.30
- 写请求改用站点 axios 默认的
application/x-www-form-urlencoded;charset=UTF-8 编码；点赞、收藏与 CY 发布不再发送服务端无法解析的 JSON，CY 不再报 link_id 缺失。
- 分享按钮不再点击隐藏的原生
.page-header__share-btn，改为系统分享或复制帖子链接，并提供可见的成功/失败提示。
- 评论按钮增加约 1.4 秒的挂载等待，并在原生评论节点缺席时使用评论树接口渲染只读回退抽屉，避免点击后没有任何反馈。
- 回退抽屉沿用主题变量，支持正文、图片、表情、引用回复、CY 过滤与分页，桌面 440px 侧栏、移动端满宽。
v0.4.29
- 全站搜索“用户”标签页的提示条改用当前主题的 surface 底色，提示文字改用 muted 色，深色主题下不再出现白色横条。
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，评论创建另要求 _rnd。脚本在本地自行计算，不下载、不执行任何外部代码；规则见「三、接口签名」。
- 数据流向：插眼结果只写入本机
localStorage（键 heybox-up.cy.v1:<userid>），主题与功能开关写入 heybox-up.theme.v1、heybox-up.commentPreview.v1、heybox-up.navMotion.v1；连读顺序只写入当前标签页的 sessionStorage。评论内容与排序由站点自己管理，脚本不保存。不向任何第三方服务器发送数据，无统计、无埋点、无追踪。
- 账号影响：仅在用户主动点击阅读栏的点赞、收藏或 CY 发布时，以当前登录态提交对应操作；浏览、收藏补全、评论预览与排序不改站点数据，也不改写站点收藏总数。
- 必须登录：写操作未登录时只提示「请先登录小黑盒」，不发起写请求。
- 与站点功能的关系：小黑盒 Web 端没有插眼列表入口（官方插眼记录在 App 的「我 → 动态 → 评论」）。脚本只呈现既有接口数据，不绕过登录、权限或付费。
@antifeature：无返佣链接、无广告、无付费、无挖矿、无会员限制、无用户追踪，故未声明。- 代码来源：独立实现，未复制第三方脚本代码；MIT 许可，见「十、许可证」。
