常见问题
本页汇总当前版本最常见的问题，优先按“现在真实界面怎么操作、真实功能边界是什么”来回答。
如果你只是想尽快判断“这是配置问题、站点变动、外部服务异常，还是值得提 issue 的 bug”，建议直接先看文末的 提 issue 前先确认什么。
安装与加载
Q: 扩展安装后没有反应？
A：按下面顺序检查：
- 确认浏览器扩展页已开启“开发者模式”
- 确认扩展开关已启用
- 刷新目标站点页面，而不是只刷新扩展页
- 点击扩展图标，确认弹窗是否能正常打开
- 如果是刚更新版本，尝试关闭再重新启用扩展一次
- 如果仍无反应，再查看浏览器控制台错误
很多“安装后没反应”其实不是扩展完全失效，而是：
- 页面没有刷新
- 当前页面不是扩展支持的页面
- 某些入口被你在设置里关掉了
- 其他扩展改写了页面结构，导致注入位置异常
Q: 为什么不能在 Chrome 应用商店直接安装？
A：因为项目内容性质不适合上架 Chrome Web Store，所以当前以 GitHub Releases 手动安装为主。参考：
Q: 支持哪些浏览器？
A：当前以 Chromium 内核浏览器为主，例如：
- Chrome
- Edge
- Brave
- Opera
如果你使用的是非常老的内核版本、魔改浏览器，或限制较多的便携版浏览器，出现兼容问题并不奇怪。
Q: 更新后原来的配置和数据会自动保留吗？
A：正常更新同一个扩展时，通常会保留本地数据和设置；但这不等于绝对安全。
仍然可能丢失数据的情况包括：
- 你手动删除了浏览器扩展数据
- 卸载扩展时选择了清除相关数据
- 浏览器配置目录损坏
- 你切换了浏览器用户目录或新设备
如果数据已经比较多，建议尽快配置 WebDAV 同步 或做本地导出。升级到 2.0.0 时，请按 升级与数据迁移 操作。
Q: 安装成功了，但扩展图标点开是空白或异常？
A：先排查这几类问题：
- 浏览器是否拦截了扩展页面脚本
- 是否有残留旧版本文件、手动覆盖安装不完整
- 是否在更新后没有重新刷新站点页面
- 是否浏览器本身的扩展页缓存异常
如果弹窗本身都打不开，这类问题通常比“某个单独功能失效”更偏向安装、构建或浏览器环境问题。
页面和标记
Q: 标记按钮没有显示？
A：先检查：
- 你访问的是不是支持的目标站点页面
- 相关页面增强/显示设置是否关闭了对应入口
- 刷新页面后是否恢复
- 是否有其他扩展影响页面注入
- 当前站点页面结构是否发生了改版
尤其要注意：不是所有页面、所有列表、所有站点状态下都保证有完全一致的注入入口。
Q: 我在详情页能看到按钮，但列表页没有，这是 bug 吗？
A：不一定。
详情页和列表页本来就是两类不同入口：
- 详情页更适合做单条作品操作
- 列表页更适合快速浏览、筛选和批量感知状态
如果你只是在“某一类页面没有某个入口”，先确认这个入口本来是不是只设计给详情页使用，而不是默认把它理解成缺失。
Q: 标记后页面没有马上变化？
A：当前建议这样排查：
- 先回到 番号库 看记录是否已写入
- 再刷新当前页面确认视觉状态
- 如果是与 115 联动的自动标记，确认推送是否真的成功
有些场景是“数据已经写入，但当前页面视觉状态还没即时重绘”，这类情况和“根本没保存成功”不是一回事。
Q: 如何取消或修改状态？
A：通常有两条路：
- 在详情页重新操作状态按钮
- 在番号库里直接找到记录再修改或删除
如果你是想做集中整理，优先用 数据管理 会更稳定。
Q: 我明明删掉了记录，页面上怎么还像没删？
A：先不要直接判断为删除失败。
更常见的原因是：
- 当前页面还没刷新
- 列表页缓存了旧的 DOM 状态
- 视觉标记已经注入，但当前页没有重新计算
建议顺序：
- 去
番号库确认记录是否真的已删除 - 刷新当前页面
- 再重新查看状态是否恢复
Q: 已浏览、已看、想看之间是什么关系？
A：它们不是同一个概念。
已浏览：更偏页面访问或浏览痕迹已看：更偏明确完成观看或已处理状态想看：更偏待处理、待回看、待后续操作
不要把“浏览过页面”“推送过任务”“收藏过资源”自动等同于“已看”。具体建议看：
Q: 推送 115 成功了，为什么状态也变了？
A：这通常不是异常，而是你开启了“115 推送成功后自动标记已看”之类的联动能力。
要注意：
- 115 推送和观看状态是两个概念
- 但当前版本支持它们在成功条件下联动
- 这个联动开关不在
设置 → 115网盘，而属于视频增强相关设置
Q: 页面显示和番号库里的记录不一致，是不是数据库坏了？
A：先不要直接下这个结论。
更常见的情况是：
- 页面视觉状态没刷新
- 页面增强入口被关闭或改位置了
- 某一类页面读取的是不同的展示逻辑
- 站点本身页面改版，导致注入失准
应先确认“数据是否写入成功”，再确认“当前页面是否正确展示了这份数据”。
数据管理
Q: 数据会不会丢？
A：本地数据并不等于永久安全。
常见风险包括：
- 清除浏览器数据
- 卸载扩展
- 浏览器配置损坏
- 系统重装
- 切换设备但没有做同步或导出
建议至少做一件事：
- 配置 WebDAV 同步
- 或定期做本地导出
Q: 我应该去哪里管理数据？
A：按目的区分：
Q: 数据太多后怎么整理？
A：当前更推荐这样做：
- 在
番号库中搜索和筛选 - 用
清单进一步组织 - 用批量操作处理重复工作
- 再通过同步或导出保护结果
Q: 清空浏览器缓存后，扩展数据一定还在吗？
A：不一定。
“缓存”和“站点缓存”不是一回事，“浏览器清理数据”时也不一定只清网页缓存。
如果你执行了比较激进的清理动作，例如：
- 清除扩展相关存储
- 重置浏览器配置
- 删除用户数据目录
那本地数据确实可能一起丢失。
Q: 导入/导出是迁移方案，还是只是备份？
A：更准确地说，它首先是备份能力，其次才是迁移辅助。
如果你经常跨设备使用，长期还是建议：
- 平时靠 WebDAV 同步 保持一致
- 关键节点再做本地导出
Q: 批量操作以后数据不符合预期怎么办？
A：先停下来，不要继续做更多覆盖操作。
建议：
- 先确认本次批量操作改了什么范围
- 如果有同步，先暂停继续同步
- 先做一次导出备份当前状态
- 再决定是手动修正，还是从更可信的数据恢复
连续做多次覆盖、同步、删除，往往比第一次误操作更难恢复。
WebDAV 同步
Q: WebDAV 连接测试失败？
A：先检查最基础的四项：
- 服务器地址是否正确
- 用户名是否正确
- 密码或应用密码是否正确
- 远程路径是否可写
然后再看是否是网络或服务端问题。
Q: 多设备数据不一致怎么办？
A：先不要急着覆盖。
建议顺序：
- 先判断哪台设备的数据更可信
- 先做一次备份
- 再决定以上传本地为准，还是以云端恢复为准
Q: 推荐什么时候配置 WebDAV？
A：只要你符合任意一种情况，就建议尽快配置：
- 跨设备使用扩展
- 已经积累了很多记录
- 经常调整演员订阅、新作品和设置
Q: WebDAV 同步是不是实时双向同步？
A：不要把它理解成“云文档式实时协作”。
当前更合理的理解是：
- 它是云端备份、恢复和多设备一致性方案
- 它可以帮助你同步数据
- 但不是所有设备改动都会像聊天软件一样瞬间无冲突合并
如果你两台设备长期各自改数据，却不及时同步，最后出现冲突并不奇怪。
Q: 两台设备都在用，为什么会出现冲突或覆盖？
A：因为“多设备”不等于“自动理解你的意图”。
常见问题场景是：
- 设备 A 改了一批记录但没同步
- 设备 B 又改了另一批记录
- 两边都认为自己是最新状态
这时应该先决定哪边更可信，而不是反复上传、下载、恢复来回覆盖。
Q: 哪些数据适合同步，哪些不一定要同步？
A：业务数据通常比日志数据更值得优先同步。
例如：
- 作品记录
- 演员数据
- 新作品相关数据
- 部分配置数据
而日志类数据更适合谨慎开启，因为它更偏排查用途，不一定值得长期跨设备同步。
Q: WebDAV 测试成功，为什么日常同步还是失败？
A：连接测试成功只能说明“基础连通性可能没问题”，不等于后续所有同步场景都一定正常。
后续失败还可能涉及：
- 路径权限
- 数据写入冲突
- 某类数据本身异常
- 网络间歇性波动
- 服务端限速或策略变化
这种情况建议结合：
115 网盘
Q: 115 推送失败？
A：当前版本优先检查这些：
- 是否已在
设置 → 115网盘启用功能 refresh_token/access_token是否有效- 授权方式是否配置正确
- 接口域名、网络或 115 服务是否异常
- 磁力链接本身是否可用
Q: 我明明已经登录 115，为什么还是不能推送？
A：因为当前版本主要依赖 115 v2 token 授权链路，不是“浏览器里登录了 115 就一定可用”的老思路。
也就是说：
- 浏览器登录态存在，不等于扩展已完成当前版本需要的授权
- 如果 token 状态异常，优先重新授权
- 不要先把问题归因到磁力链接本身
Q: 推送成功但任务页里没有？
A：建议按这个顺序看：
- 打开顶部标签
115任务 - 点击刷新列表
- 搜索任务名称
- 检查默认目录 ID 是否正确
- 再查看 115 日志和测试搜索结果
Q: 默认目录为什么要填目录 ID，不是目录路径？
A：因为当前版本实际提交任务时使用的是 115 侧目录对应的 ID，不是你肉眼看到的路径文本。
所以：
- 路径写得像对的，不代表接口就能识别
- 填错目录 ID 时，最常见表现不是“完全报错”，而是任务落点不符合预期
Q: 自动标记“已看”为什么没生效？
A：要注意两点：
- 115 推送必须先成功
- 自动标记开关不是在
设置 → 115网盘，而是属于视频增强相关设置联动
参考：
Q: 为什么任务提交成功了，却没有出现在预期目录？
A：优先怀疑目录 ID 配错，而不是先怀疑扩展乱写目录。
另外还要确认：
- 当前使用的是否就是你配置的那个账号
- 目录 ID 对应目录是否仍然存在
- 任务页查看范围是否正确
Q: 115 设置页里的测试搜索有什么用？
A：它更适合拿来判断授权链路和接口可用性，而不是单纯当搜索功能使用。
如果测试搜索都失败，先解决授权、网络或接口问题，再谈推送和自动联动。
演员与新作品
Q: 演员过滤不生效？
A：先确认：
- 对应过滤开关是否开启
- 当前页面是否支持这类过滤
- 演员状态（订阅/拉黑）是否真的已经保存
- 刷新页面后是否恢复正常
Q: 新作品看起来不准？
A：当前更建议从这几个方向排查：
- 你是否真的订阅了目标演员
- 新作品页是否只是“发现入口”，后续需要进详情页继续处理
- 是否把“自动发现”和“自动完成所有操作”混为一谈了
Q: 为什么我订阅了演员，却没立刻看到新作品？
A：先确认你期待的是“发现入口”还是“实时推送提醒”。
当前的新作品页更适合被理解成：
- 汇总和发现
- 后续再进入详情页继续操作
而不是“只要订阅就保证立刻、完整、无遗漏地自动推到你眼前”。
Q: 演员黑名单、订阅、收藏这些状态会互相覆盖吗？
A：不要想当然认为所有状态都会自动互斥。
更稳妥的做法是：
- 先去 演员管理 确认当前保存状态
- 再回页面观察展示效果
- 如果展示与数据不一致，再判断是页面显示问题还是数据问题
AI、网络与外部服务
Q: AI 翻译失败，是不是扩展坏了？
A：不一定。
AI 功能通常依赖外部提供商、模型配置和网络条件，所以失败原因往往包括：
- 提供商配置错误
- API Key 无效或额度不足
- 模型名填写错误
- 网络不可达
- 外部服务限流
这类问题不应先默认归类为“扩展核心功能完全损坏”。
Q: 磁力搜索没有结果，是不是搜索模块挂了？
A：先区分“没有结果”和“模块异常”。
更常见的情况是：
- 当前搜索源可用性下降
- 关键词本身匹配不到
- 网络或站点访问异常
- 某些源返回慢或限流
如果所有搜索源都持续为空，再结合日志判断是否是模块层面的问题。
Q: 网络配置里的线路测试成功，为什么某个功能还是不正常？
A：线路测试成功只说明部分网络链路可达，不等于所有外部服务都一定可用。
因为不同功能依赖的外部接口并不完全相同，例如：
- 同步接口
- 115 接口
- AI 提供商接口
- 搜索源接口
所以“某个连通性测试成功”不能直接推出“所有依赖都没问题”。
性能与异常
Q: 页面变慢了怎么办？
A：优先从这些方向收缩功能：
- 减少不必要的页面增强
- 降低自动预览和额外请求
- 检查是否开启了过多增强能力
- 查看日志页确认是不是某个模块反复报错
Q: 浏览器卡顿怎么办？
A：可以尝试：
- 关闭不需要的增强能力
- 降低页面预览相关设置
- 清理不必要的数据或缓存
- 排除与其他扩展的冲突
Q: 为什么我感觉扩展“突然变慢了”？
A：先不要直接归因到最近一次版本更新。
同样常见的原因还有：
- 站点页面本身加载变慢
- 某个外部接口响应异常
- 你最近开启了更多增强能力
- 浏览器同时加载了更多扩展
- 日志里某个模块在反复失败重试
Q: 日志很多是不是说明一定有 bug？
A：不一定。
日志多只说明“有较多事件被记录”，不等于“核心逻辑有严重故障”。
更关键的是看：
- 是否持续出现同一类错误
- 是否影响你实际使用
- 是否能稳定复现
Q: 清理日志会不会把业务数据一起删掉？
A：通常不应该把“清理日志”和“清空业务记录”混为一谈。
日志页更偏向排查用途；如果你打算做大范围清理，先看清楚当前按钮作用的是：
- 日志
- 缓存
- 某类记录
- 全局导入导出数据
不确定时，先做导出备份再操作。
遇到问题先看哪里
如果你不确定问题属于哪一类，建议按这个顺序：
Q: 我应该优先看哪些文档？
A：按问题类型看：
提 issue 前先确认什么
Q: 什么情况更像配置问题，不建议上来就提 bug？
A：下面这些场景，优先自查配置和文档：
- 没刷新页面就判断“扩展没生效”
- 把 115 登录态当成当前版本授权已完成
- 把 WebDAV 当成实时无冲突双向同步
- 把“页面显示没变化”当成“数据一定没写入”
- 不区分详情页入口和列表页入口
- 不区分业务数据、日志、缓存、导出文件
Q: 什么情况更值得提 issue？
A：更值得提 issue 的通常是：
- 同一问题可以稳定复现
- 你已经确认过开关、入口和配置
- 日志里有明确报错或异常行为
- 站点同类页面普遍失效，而不是偶发单页异常
- 新版本更新后出现了可重复的新问题
Q: 提 issue 时最好附带什么信息？
A：至少建议附上这些：
- 浏览器名称和版本
- 扩展版本
- 具体页面地址或页面类型
- 复现步骤
- 预期结果和实际结果
- 相关截图
- 能脱敏就脱敏后的日志片段
如果只有一句“不能用”“没反应”“有 bug”，通常很难判断是页面改版、配置问题，还是外部服务异常。
Q: 哪些信息如果没有，issue 基本很难判断？
A：最常见的就是这几项缺失：
- 不知道你在哪个页面出的问题
- 不知道你点了什么按钮
- 不知道你配置了哪些开关
- 没有日志或错误提示
- 无法复现，且没有时间点、截图或步骤
Q: 遇到外部服务异常，应该怎么描述才更有用？
A：不要只写“115 挂了”“WebDAV 不行了”“AI 失效了”。
更有用的描述方式是：
- 哪个入口触发的
- 当时配置是什么
- 测试搜索/连接测试/同步动作哪个失败
- 报错信息是什么
- 是持续失败还是偶发失败
这样才能更快判断：
- 是扩展逻辑问题
- 是外部接口问题
- 还是账号、网络、授权、路径这类环境问题