自动识别排查指南
本页用于排查在插件「新增/编辑账号」中点击 自动识别 时出现的:识别耗时过长、无限等待、识别失败(401/403/格式错误等),以及无法提交等问题。
识别耗时过长(一直在“识别中...”)
自动识别需要打开临时页面并读取站点信息,遇到以下情况会明显变慢:
- 站点启用了 Cloudflare / 防火墙验证:请留意是否弹出了临时窗口;如果需要人工点选验证,请在超时前完成验证。
- 网络/站点响应慢:建议稍等片刻,或切换网络/代理后重试。
- 权限不足:确认扩展可访问目标站点,并按所选认证方式授予必要权限。可选权限的用途与说明见 权限管理。
识别失败:先确认真的已登录
自动识别依赖你在同一浏览器中已经登录目标站点:
- 先在浏览器打开目标站点后台(控制台)页面。
- 确认没有被重定向回登录页(刷新页面验证一次)。
- 再回到插件执行自动识别。
识别失败:尝试切换认证方式
不同站点/魔改版本对接口与登录态处理不同,识别失败时优先尝试切换认证方式:
- 访问令牌认证失败:切换到 Cookie 认证 后再次自动识别。
- AnyRouter:必须使用 Cookie 认证,并且 Cookie 必须来自当前已登录的账号;Cookie 认证不支持同站点多账号同时使用。
识别出的站点类型不对
自动识别按固定顺序取信号:先看域名,再看部署对外声明的站点名称(/api/status 返回的 system_name),最后才看页面标题。因此“页面外壳标题是 New API、背后实际跑的是某个魔改版本”的部署,也能按它自己声明的品牌识别出类型。
如果识别结果仍与实际不符:
- 在「编辑账号」里手动把 站点类型 改成正确的类型并保存。站点类型决定扩展调用哪一套接口,比品牌名称更重要。
- 不确定该改成哪个时,先跑一次签到(例如账号的「快速签到」),或在编辑账号里点一次「重新检测签到方式」:扩展会依站点自身的信号推断它对应的类型,并把推断结果写进编辑弹窗的提示、“自动签到 → 执行结果”、密钥管理的失败提示,以及「总览 → 需要处理」列表。
- 改好类型后重新识别一次,确认能找到可用的签到方式。
这条提示只在账号仍保持“记录时的站点类型”时出现;一旦你改过站点类型,旧记录立即失效,不会再用过期的类型名误导你。扩展后来读到站点与保存的类型一致时,旧记录同样失效。
无法提交 / 无法保存:逐项检查必填项
当必填项未满足时,提交按钮会被禁用或保存失败。不同站点需要的字段不同,请先确认站点类型,再按对应要求检查:
- New API 及兼容站点:检查站点名称、用户名、用户 ID、访问令牌,以及大于 0 的充值金额比例;改用 Cookie 认证时,需要导入或填写会话 Cookie(Header 值)。
- Sub2API:检查站点名称、用户 ID、JWT 访问令牌和充值金额比例;不支持 Cookie 认证。开启“插件托管会话(多账号)”时,还必须导入或填写 Refresh Token。
- OpenRouter:检查站点名称、OpenRouter Management Key 和充值金额比例;无需填写用户 ID,也不支持 Cookie 认证。
- 其他站点:以表单当前显示的必填标记为准,并参考 手动添加账号指南 中对应站点的说明。
最后的手段:手动添加账号
如果自动识别始终无法完成,可切换到 手动添加,补齐信息,再保存账号。
详见 手动添加账号指南。
