常见问题

高亮效果不显示、正文被挡、首字下沉、底图气泡、主题绑定、规则优先级、替换为、动画、点击效果和 AI 规则导入异常时，按现象快速查找处理办法。

这页按现象排查高亮效果异常。从零创建规则见创建高亮规则。

高亮背景图、气泡、字色、字号突然不显示

常见说法：「更新后对话高亮全部失效了」「气泡预览正常，退出去看不见」「高亮字号改不了」「背景色的高亮能改色，不带背景的改不了」。

高亮规则是你自己加的样式，不受「书籍样式」里的开关影响：关掉「保留书籍原排版」或其中某一项，高亮的背景、字号、首字下沉等照样显示，TXT 也一样。高亮不显示时按下面检查：

高亮规则页右上角「⋯」→「高亮设置」里的「启用高亮规则」是不是关着
高亮规则是高级会员功能，会员失效期间规则不显示，重新激活后恢复。见高级会员权益
标题上的高亮不显示：多半是开着标题样式，见下文标题上的高亮不生效
规则都在，但就是被别的规则挡住：见规则生效顺序
正则写得太慢：阅读时会提示「高亮规则「规则名」匹配太慢，本次阅读已暂停生效」，这条规则在这次阅读里不再生效。把正则改简单些（见写法速查），重新打开书

正文被挡、标题上飘：检查负数边距

常见说法：「每章第一页文字都往上移」「标题飞了」「下一章的背景挡住了上一章的文字」「偶尔翻页正文顶到最上面」。

标题样式和排版里的边距可以填负数，高亮规则里整段（块级）、行内块的上边距和分块样式（.名字 { }）里的边距也可以。负数会如实生效，把内容往上或往旁边拉，大的负数（比如 -100、-200）就会让正文叠到页眉或上一段上。导入的主题、规则里带的负数也一样会生效。普通行内高亮的负边距不生效。

按这个顺序排查：

到高亮规则页右上角「⋯」→「高亮设置」关掉「启用高亮规则」。恢复正常，说明是某条高亮规则，逐条找，首字高亮、标题高亮最常见，把外边距改回 0 或正数
打开「标题样式」，把样式切成「不使用标题样式」。恢复正常，就进这个标题样式的编辑页改「边距」
还不行，检查「排版」里的正文、页眉、页脚边距有没有负数，见阅读排版常见问题

滚动翻页时，上一章末尾被下一章开头挡住，也可以把「更多设置」→「滚动翻页」→「章节间距」调大一些。

标题上的高亮不生效

两个常见原因：

开着「标题样式」：标题样式生效时，所有高亮规则在标题上的命中都不显示，包括作用内容选了「标题」的规则。想用标题高亮，把标题样式切成「不使用标题样式」
同时开了多条作用于标题的规则：只有排在最前面的一条生效，其余的整条不用

详细说明见标题样式。

首字下沉跑到下一段

如果首字下沉有时命中第一段，有时跑到第二段，优先检查规则是不是靠正则定位标题或段首。

书籍里的标题、空行、标点和正文开头格式并不统一，一条正则很难稳定覆盖所有章节。遇到章节结构稍微变化，匹配位置就可能偏移。

更稳定的处理方式是把规则限制在标题范围内：

阅读页右上角「⋯」→「高亮规则」
点规则页右上角「+」→「新建」
在「作用内容」里选「标题」
保存后回到阅读页查看效果

这样规则跟随应用识别到的标题范围，不需要用复杂正则硬匹配。

背景图被拉长或压扁

高亮底图并不是按原图比例完整贴上去，而是铺在命中内容形成的区域里。文字变多时，区域会变高或变宽，图片也会随之拉伸。

如果想让变形不明显，可以从这几个方向处理：

给底图设置 9-Slice 拉伸，让边角尽量保持原样
为短句、长段落、对话等不同内容准备不同底图
缩小规则命中范围，避免一张图同时包住过长内容

复杂花纹、人物、明显图案更容易看出拉伸痕迹。做高亮底图时，边缘简单、中心可延展的图片通常更稳。

关闭规则后阅读页仍然显示高亮

这种情况通常不是规则列表里的开关没关，而是当前阅读主题绑定了高亮规则。

高亮有两种来源：

高亮规则列表里打开的规则：对所有书、所有阅读主题都生效，切换主题也不会变
阅读主题绑定的规则：只在使用这个主题时生效，而且不看列表里的开关，规则关着也照样显示，也不会改动它的启用状态

导入别人分享的主题时，如果主题里带了绑定高亮，就可能出现「规则列表里关了，阅读页还是有」「切了主题高亮就变了」的现象。

处理步骤：

打开阅读页「阅读主题」
把主题设置拉到底
进入「绑定高亮」
选择重置，解除所有绑定
再回到高亮规则列表确认启用状态

也可以在高亮规则页右上角的筛选里选「仅主题启用」，看哪些规则是靠主题绑定显示的；打开规则编辑，在「绑定阅读主题」里把当前主题去掉。

只想临时停掉主题带的规则、保留绑定关系，到高亮规则页右上角「⋯」→「高亮设置」关掉「应用主题绑定的规则」，阅读时就只认列表里手动打开的规则。

想一次关掉所有高亮，在同一个「高亮设置」里关掉「启用高亮规则」。这是总开关，关掉后列表里的规则和主题绑定的规则都不显示；标题样式不受它影响。

底图有时按段显示，有时按行重复

给规则明确指定 display，可以减少自动判断带来的差异。

想让高亮更像随文字流动，可以使用：

display: inline;

想让命中内容更像整段气泡，可以使用：

display: block;

两种写法选一种即可，不要同时写。需要注意的是，EPUB 自带 CSS 也会参与排版，如果原书样式很复杂，即使写了 display，最终效果也可能受原书影响。

气泡边缘包不住文字

气泡超出、贴边或留白不对时，优先调边距。

不同底图的透明区域、圆角、阴影和装饰边框都不一样，不能直接套用别人的参数。可以从这些项开始微调：

内边距：调整文字到气泡边缘的距离
外边距：调整气泡和上下文的间隔
左右边距：处理气泡横向包裹范围
上下边距：处理顶部和底部留白

建议先把气泡调到能完整包住文字，再根据底图装饰留出余量。每次只改少量参数，预览会更容易判断。

开启高亮后原书排版乱了

这类问题多见于本身带复杂样式的 EPUB 或 HTML 书籍。

原因通常是原书 CSS 和高亮 CSS 同时控制同一段内容。字体、字号、颜色、间距、对齐、背景、浮动等属性发生冲突时，页面就可能和原书差很多。

可以按目标选择处理方式：

想优先保留原书样式：关闭对应高亮
只想轻微标记：改用文字颜色、下划线等低影响样式
只想标记特定内容：缩小规则范围，避免整段或整页被套样式

如果关闭高亮后排版恢复，就基本可以判断问题来自样式冲突。

多条规则命中同一段文字时，哪条生效

常见说法：设了主角高亮，对话气泡没了；开着上面几条规则时下面的规则不显示，关掉才显示。

先这样排查：在高亮规则页右上角筛选「已启用」，把排在上面的规则（包括标着「主题启用」的）逐条临时关掉，看是哪条挡住的。多数情况把整句、整段的规则（气泡、卡片）拖到单字规则上面，再去掉单字规则的背景色就能一起显示。

为什么会这样、怎么排，见规则生效顺序。规则页右上角的「?」里也有图解。

点高亮时误触编辑，影响翻页

如果阅读时经常点到高亮文本，导致翻页被打断，可以关闭「高亮文本可点击编辑」。

路径：

阅读页右上角「⋯」→「高亮规则」
规则页右上角「⋯」→「高亮设置」
关闭「高亮文本可点击编辑」

关闭后，高亮仍会正常显示，只是不再优先响应点击编辑，更适合纯阅读场景。

用了 span、img、ruby、rt 以外的标签
写了 style 属性。样式要写在规则的 CSS 里，用 .名字 { … } 对应 class
属性值没加引号，或者 <span>、<ruby> 没写结束标签
<img> 的 size 写了 text、original、line 以外的值

想写 <、>、& 字符本身时，写成 <、>、&。

旋转、宽高、动画不生效

逐项检查：

变换（transform）、宽高、vertical-align 只对行内块和块级生效。命中的是几个字时，先加 display: inline-block
用到变换的动画（震动、漂浮、弹一下、旋转）同样要配 display: inline-block
墨水屏不播放动画
关键帧里的宽高、边距不会播放，动画只变化透明度、文字颜色、背景色和变换

写法见高亮规则样式。

点高亮文字时没有打开编辑，而是揭开、折叠或弹出了卡片

这条规则在「点击」页签设了点击效果，或者开了「显示命中位置」。这样的规则点到时总是按自己的设置响应，不看「高亮文本可点击编辑」开关。

想恢复点击编辑，打开这条规则，把「点击时」改回「默认」，并关掉「显示命中位置」。见点击效果。

AI 写的规则导入不了

提示「剪贴板里没有找到规则」：复制的不是 AI 的完整回复。把整段回复（包括 JSON 代码块）一起复制
某条规则不能勾选：它写错了，弹窗里会写原因（正则写错、关键词为空等）。把原因告诉 AI 让它改，或者先导入其他几条
导入后字体不对：AI 写的字体名用不上，到编辑页的「字体」里重新选
提示「这些规则已经有了」：列表里已经有一模一样的规则

完整流程见用 AI 写规则。

折叠、揭开的内容导出 EPUB 后看不到

导出时折叠和揭开写成了弹注：正文里是摘要或遮住的样子，点一下弹出全文。用多看这类支持弹注的阅读器打开，点摘要就能看到；不支持弹注的阅读器，点链接会跳到章末的注文。

弹出卡片和命中位置在 EPUB 里没有对应写法，导出后只保留样式。