跳转至

登录流程没有可见落点

Tony 的问题(实测)

「1. 点登录 打开网页,不应该把浏览器直接显示在最前边?然后登录了 不应该是吧插件弹窗弹出来???」

两条都成立,而且是同一个病的两头:ISSUE-0170 只解决了「窗口关不掉」, 没解决「打开时用户看不看得见」和「关掉之后呢」。

① 打开登录页时浏览器窗口不置前

tabs.create({ url, active: true }) 只保证这个 tab 在它所在窗口里被选中。 Chrome 当时若在后台(用户正看着别的 app,或扩展窗口盖在前面), 登录页就开在了一个看不见的地方 —— 用户的体感是「点了没反应」, 和 ISSUE-0001 一模一样。

🔴 而且这条本来就该有:同一个函数上面那条「聚焦已有 tab」的分支 一直有 windows.update({ focused: true }),只有新建分支漏了。

又一次「一个文件两套行为」—— 与本 issue 的前身 ISSUE-0170 那个 P0 (findExistingLoginTab 两条分支一条校验 url 一条不校验)同源。 判据因此加了一条:windows.update(focused:true) 必须出现 ≥2 次, 少一次就说明又有分支漏了。

② 登录成功后是空屏

链路走完是这样的:

点登录 → popup 自己关掉 → 跳出登录页 → 登完 → 登录页也自己关掉
      → 回到原来的页面,屏幕上没有任何东西说「你登上了」

用户只能自己再点一次扩展图标去确认。

修法:两级降级链(不是二选一)

  1. action.openPopup() —— 直接把插件弹窗弹回来,这是 Tony 要的形态
  2. 通知兜底 —— ① 不可用或抛错时

⚠️ 为什么必须有第 2 级:MV3 的 action.openPopup() 长期只在 dev channel 可用, 稳定版是后来才开放的,且要求当前有一个 focused 窗口。 不能假设它一定成功 ⇒ 特性检测 + try/catch + 降级。

两级都失败时只留日志:反馈失败不该影响「已经登录成功」这个事实。

两条入口都要接

  • cookies.onChanged 那条(用户在登录页登完)
  • open-login 里「cookie 直接就能登上」那条 —— 这条路上 popup 已经 window.close() 了,只把结果返回给一个已关闭的页面等于没反馈

变异验证(全部真红)

变异 结果
窗口置前被删(回到 Tony 报的症状) ✅ 红(2 条)
登录成功后不给反馈(回到空屏) ✅ 红
openPopup 失败时静默返回、不降级 ✅ 红

v0.11.3:修完还是不灵 —— 病根是「把登录成功绑在了某一条信号上」

Tony 加载 unpacked 实测 v0.11.2:

「登录页没关 插件是登录了 但是没弹出来」

两件事一起哑火,而「插件登上了」说明登录本身是成功的。 这个组合就是证据:

  • 关窗与反馈当时都挂在 cookie 事件链的 r.ok 分支上
  • 两件都没发生 ⇒ 那个分支根本没走到
  • 而身份确实写进去了 ⇒ 它是从别的路写的 —— headerListener (监听 {ggdt,m}.laifaxin.com/api/account/* 的 POST,抓请求头里的 uid/accesstoken)

⇒ 生产环境的 laifaxin cookie 里很可能压根没有 uid/token, auto-login.ts 头注那句「后端 cookie 命名约定我不确定」是个从未验证过的假设, 而我把整条关窗链建在了这个假设上。

就算查出 cookie 名、把候选表补上,下一个「身份从第三条路写进来」的场景还会复发。

「用户登上了」是一个事实;cookie 变化只是这个事实的一种信号。 把下游动作挂在信号上,信号不成立就整条断。

修法:挂在事实上

identity-store 在真的把空身份写成有效身份时(first-login)发事件, background 顶层订阅一次,做关窗 + 反馈。

身份来源 会触发吗
cookie 事件 ✅
headerListener 抓请求头 ✅ ← Tony 实际走的路
将来任何新入口 ✅

不发的情况(都有行为测试守):

  • same-account(同账号刷新 token)—— 天天发生,发了就是每次轮换弹一次
  • switched(换号)—— 用户正在扩展 UI 里操作,不需要再弹
  • refused-switch / incomplete —— 根本没写进去

判据也跟着换层

三条旧判据在量「cookie 链里有没有关窗/反馈」。它们守的语义(ISSUE-0170 的 「关窗不许等 5 分钟轮询」)没变,承载点变了 ⇒ 判据搬家,并加反向闸: 不许再把关窗/反馈挂回 cookie 链(那是「同一个事实处理两处」,cookie 路上会弹两次)。

「什么时候发事件」改用行为测试守 —— 中途有一条源码切片判据当场被窗口越界打脸 (两个分支挨得近,400 字符窗口吃到了隔壁分支的 emitFirstLogin)。 该跑真实函数的就别切源码,这个坑本轮已经栽过多次。

变异验证(五个全红,恢复后 1749 条全绿)

变异 结果
first-login 不发事件(回到 Tony 报的症状) ✅ 红(4 条)
background 不订阅(关窗与反馈整体哑火) ✅ 红(2 条)
订阅了但不关窗 ✅ 红
同账号刷新也发(每次轮换弹一次) ✅ 红
把关窗又挂回 cookie 链(重复,弹两次) ✅ 红

在扩展页面控制台跑:

(await chrome.cookies.getAll({domain:'laifaxin.com'})).map(x=>x.name)
// → ['locale', '_c_WBKFRo', 'locale']

laifaxin.com 全域只有三个 cookie:两个 locale + 一个随机名的 _c_WBKFRo。 没有 uid,没有 accesstoken,没有任何 token 类 cookie。

于是:

  • looksLikeAuthCookieName() 对这三个名字全部返回 false
  • cookies.onChanged 监听里那道名字过滤把所有变化都挡掉
  • ⇒ cookie 链从来没有触发过,一次都没有

不是「有时不触发」,是结构上永远不触发。 v0.11.0 的第一步「cookie 事件驱动关窗」,从落地那天起就是死代码。 扩展一直是靠 headerListener(抓 /api/account/* 请求头里的 uid/accesstoken)登上的。

auto-login.ts 头注那句「后端 cookie 命名约定我不确定,所以做模糊匹配」—— 那个「不确定」从来没有人去验证,而整条关窗链建在了它上面。

教训:当你为一个不确定的假设写「容错兜底」时,先去验证那个假设。 六个候选名的模糊匹配看起来很稳妥,实际命中率是 0。 而且因为它静默失败(找不到就返回 no-uid-cookie),没有任何人会发现。

第二个原因:登录成功后站点跳走了,严判据认不出来

实测地址栏:ggdt.laifaxin.com/welcome —— 登录成功后站点把同一个 tab 跳走了。

而 closeLoginTab 复用的 findExistingLoginTab() 判据是「同域 + 路径以 /login 开头」 ⇒ 两条分支都认不出它 ⇒ 直接 return ⇒ 永远关不掉。

返工一修 P0 时我把判据收严,并在注释里写了取舍:

「严格判据的代价是该关的可能关不掉(用户看到一个多余标签页)」

我当时以为那是理论代价。实际上它 100% 发生 —— 站点登录后必然跳走。

修法:关窗与授权用两套判据,宽严各归各位

判据 认错的代价
换号授权 扩展开的 + 授了权 + 未过期 + 仍在 /login 身份被静默换成另一个账号
关窗 扩展开的 + 同站即可 + 未过期 多关/少关一个标签页

「跳到 /welcome」满足关窗三条 ⇒ 关得掉; 「用户自己开的 laifaxin 页面」不在记录里 ⇒ 不受影响; 「扩展开的 tab 但用户后来导航去了 google」⇒ 不同站 ⇒ 不关。

记录形态也跟着拆:at(打开时刻,永远记,关窗要用)与 grantsAuth(是否授权) 分成两个字段 —— 上一版把它们挤在 at 里(at = grantsAuth ? now : 0), 结果不授权时连「什么时候开的」也丢了。

变异验证(六个构造全红)

构造 结果
关窗退回严判据(回到实测的「关不掉」) ✅ 红(2 条)
关窗判据放太宽(连别的站都关) ✅ 红
关窗不判时间窗口(几天前的也关) ✅ 红
grantsAuth 被忽略(授权又回来了) ✅ 红
孤儿兜底被删(SW 竞态后留孤儿) ✅ 红(2 条)
first-login 不发事件 ✅ 红(4 条)

⚠️ grantsAuth 那条第一次打的时候没红 —— 查出来是我的断言在量别的东西: 那条用例没 mock tabsGet,于是 hasExtensionOpenedLoginTab() 返回 false 是因为「tab 根本不存在」,而不是因为「没授权」。恒假断言。 补上 mock 后才真红。这正是变异测试存在的意义。

现在它在生产环境是完全的死代码(peekCookieIdentity / resolveCookieSource / cookies.onChanged 监听 / autoLoginViaCookies 的候选表匹配)。

暂不删,理由:① 后端将来可能加 cookie ② 删它要动很多测试,风险大于收益。 但必须标注它当前不生效,否则下一个人会以为关窗是靠它工作的。

_c_WBKFRo 这个名字看起来是随机生成的,不应该加进候选表 —— 它可能每次部署都变,而且我们也不知道它是不是身份凭据。


v0.11.4:还是没反馈 —— 因为「本来就登着」

Tony 实测 v0.11.3:「通知也没 弹窗也没」。

两级降级链一条都没出 ⇒ showLoginSuccessFeedback 根本没被调用, 不是 openPopup 不可用的问题。

病灶:我把事件限制在了 first-login

v0.11.3 的 onFirstLogin 只在「从未登录 → 登录」时发。理由写得也像模像样:

同账号刷新 token(same-account)天天发生,不是「刚登上」

但它漏掉了最常见的那个场景:

  • 刷新 unpacked 不清 storage ⇒ 扩展本来就登着
  • 用户主动点登录、走完整个流程 → 写入的是 same-account
  • ⇒ 不发事件 ⇒ 登录页不关、反馈也没有

而他主动点了登录,正在等一个结果。

修法:模块报告事实,订阅者决定策略

identity-store 改为报告所有成功写入(onIdentityWritten,带 reason)—— 它只负责说「发生了什么」,不替调用方决定「要不要打扰用户」。

策略移到 background,判据是一个它自己拿得到的硬证据:

const closed = await closeLoginTab();          // 关掉了吗?
const shouldNotify = closed || reason === 'first-login';

「刚才关掉了一个扩展自己开的登录页」本身就是「用户在走登录流程」的证据 —— 比任何自报字段都硬(这正是返工四学到的:provenance 不能靠自报)。

场景 closed reason 弹吗
本来就登着,走完登录流程 ✅ same-account ✅ ← Tony 的场景
从未登录 → 登上 ✅/❌ first-login ✅
纯后台 token 轮换 ❌ same-account ❌ 不打扰
扩展 UI 里切组织 ❌ switched ❌ 用户正看着屏幕

为此 closeLoginTab() 的返回值从 void 改成 boolean。

变异验证(四个构造全红)

构造 结果
退回 v0.11.3(same-account 不报告)—— 实测症状本身 ✅ 红
反馈条件退回只认 first-login ✅ 红
反馈条件放宽成无条件(每次轮换都弹) ✅ 红
closeLoginTab 不返回证据(永远 false) ✅ 红

⚠️ 最后一条第一次打的时候没红 —— 没有任何判据守 closeLoginTab 的返回值, 只守了「有没有调用 tabs.remove」。补上三条返回值断言后才真红。 这是本轮第二次被变异测试抓出「判据在量别的东西」。

一条连带:audit_grep 钉着旧事件名

pnpm verify 直接红了 —— ISSUE-0172 的 audit_grep 还写着 onFirstLogin\(。 这道闸起作用了(它的职责正是「防关键 guard 意外消失」),改名时必须同步它。


v0.11.5:落点从 popup 改成主窗口

Tony 实测 v0.11.4:「现在弹出了 但是是右上角的那个小窗口,主窗口能弹出吗?」

反馈链通了,但落点选错了:用户点登录是为了进去干活,不是看一眼登录状态。 popup 只有巴掌大,看完还得再点一次才能进主界面。

三级降级链

# 落点 为什么
① 主窗口(openWindow('main')) 用户的真实目的地
② 插件弹窗(action.openPopup()) 主窗口开不出来时
③ 通知 前两级都不行时,至少告诉他登上了

openWindow('main') 本来就处理好了三种情形,直接复用:

  • 已经开着 ⇒ windows.update({focused:true}) 聚焦,不会开出第二个
  • storage 记录丢了但窗口还在(SW 竞态)⇒ 按 url 回收孤儿
  • 都没有 ⇒ 新建

变异验证(三个全红)

构造 结果
退回 popup 优先(实测报的形态) ✅ 红
主窗口返回 null 也当成功(不降级) ✅ 红
主窗口开出来了还弹 popup(重复打扰) ✅ 红

这条线的完整轨迹(五次实测推出来的)

版本 Tony 的实测反馈 病根
v0.11.1 「点登录打开网页,不应该把浏览器显示在最前边?」 tabs.create 只选中不置前,且同一函数另一分支一直有
v0.11.2 「登录页没关 插件是登录了 但是没弹出来」 下游动作绑在 cookie 信号上,而生产 cookie 里根本没有 uid/token
v0.11.3 「通知也没 弹窗也没」 事件只在 first-login 发,而用户本来就登着
v0.11.4 「弹出了 但是是右上角的那个小窗口」 落点选错
v0.11.5 — —

五次里有四次是我的判断错误,没有一次是环境问题。 每一次的共同形态都是:我基于一个没验证过的假设做了设计, 而那个假设在真实环境里不成立 —— cookie 里有 token(没有)、 刷新扩展会清 storage(不会)、用户要的是确认登录状态(他要进去干活)。

对抗审五轮没能发现其中任何一条 —— 它们只能读源码, 读不出「生产环境实际有哪些 cookie」「用户实际想去哪」。 加载 unpacked 点一次,胜过五轮双路审。


v0.11.6:主窗口 + 弹窗都尝试

Tony:「主窗口弹出来了,我希望小窗口也一起,你认为呢?」

我的判断:多半弹不出来,但值得试

两条 Chrome 的硬约束(都是文档层面的推断,写下时未经实测):

  1. popup 失焦即关。 ① 里的 windows.update({focused:true}) 会抢走焦点, 所以弹窗就算出来了也可能只闪一下。
  2. action.openPopup() 挂在工具栏图标上弹,而主窗口是 type:'popup' 的扩展窗口 —— 它没有工具栏。Chrome 可能直接拒绝,也可能弹到另一个普通浏览器窗口上 (用户未必看得见)。

⇒ 但这条线上我已经因为「我以为」栽了四次,所以不凭判断否掉,做出来让实测说话。

策略从「降级链」改成「都尝试 + 兜底」

# 落点 语义
① 主窗口 必做
② 插件弹窗 尽力,失败是预期内的,只记 info 日志、不降级、不报错
③ 通知 只有 ①② 都失败时才发 —— 否则就是三重打扰

返回值从单个字符串改成 { main, popup, notification },如实说明哪几级成功了, 并打一行日志便于按实测调策略:

[login-feedback] 落点结果 · 主窗口=true · 弹窗=false · 通知=false

变异验证(四个全红)

构造 结果
主窗口成功就不试弹窗(退回 v0.11.5 的降级语义) ✅ 红
弹窗失败就发通知(三重打扰) ✅ 红(2 条)
两级都失败也不发通知(用户全无反馈) ✅ 红(2 条)
弹窗失败把主窗口也带挂(异常没隔离) ✅ 红

✅ 实测结论(2026-09-18)

[login-feedback] 落点结果 · 主窗口=true · 弹窗=false · 通知=false

主窗口正常弹出,插件弹窗确实弹不出来 —— 上面两条 Chrome 约束成立,判断被证实。

⇒ 代码注释已从「多半弹不出来(未经实测)」改成实测结论。 ② 保留但不抱期待:它在别的窗口构型下可能成功(代价只是一次 info 日志), 删掉等于把这条路永久关死。不为一次实测结果删掉一条无害的兜底。

⇒ 「小窗口也一起弹」这个需求技术上做不到。若 popup 里有主窗口没有的信息, 正确解法是把那部分挪进主窗口,而不是强行弹两个窗口。