登录流程没有可见落点¶
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 次, 少一次就说明又有分支漏了。
② 登录成功后是空屏¶
链路走完是这样的:
用户只能自己再点一次扩展图标去确认。
修法:两级降级链(不是二选一)
action.openPopup()—— 直接把插件弹窗弹回来,这是 Tony 要的形态- 通知兜底 —— ① 不可用或抛错时
⚠️ 为什么必须有第 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 名、把候选表补上,下一个「身份从第三条路写进来」的场景还会复发。
「用户登上了」是一个事实;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 链(重复,弹两次) | ✅ 红 |
🔴 Tony 的实测查出了根本原因: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()对这三个名字全部返回 falsecookies.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那条第一次打的时候没红 —— 查出来是我的断言在量别的东西: 那条用例没 mocktabsGet,于是hasExtensionOpenedLoginTab()返回 false 是因为「tab 根本不存在」,而不是因为「没授权」。恒假断言。 补上 mock 后才真红。这正是变异测试存在的意义。
待定:cookie 那套还留着吗¶
现在它在生产环境是完全的死代码(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 的硬约束(都是文档层面的推断,写下时未经实测):
- popup 失焦即关。 ① 里的
windows.update({focused:true})会抢走焦点, 所以弹窗就算出来了也可能只闪一下。 action.openPopup()挂在工具栏图标上弹,而主窗口是type:'popup'的扩展窗口 —— 它没有工具栏。Chrome 可能直接拒绝,也可能弹到另一个普通浏览器窗口上 (用户未必看得见)。
⇒ 但这条线上我已经因为「我以为」栽了四次,所以不凭判断否掉,做出来让实测说话。
策略从「降级链」改成「都尝试 + 兜底」¶
| # | 落点 | 语义 |
|---|---|---|
| ① | 主窗口 | 必做 |
| ② | 插件弹窗 | 尽力,失败是预期内的,只记 info 日志、不降级、不报错 |
| ③ | 通知 | 只有 ①② 都失败时才发 —— 否则就是三重打扰 |
返回值从单个字符串改成 { main, popup, notification },如实说明哪几级成功了,
并打一行日志便于按实测调策略:
变异验证(四个全红)¶
| 构造 | 结果 |
|---|---|
| 主窗口成功就不试弹窗(退回 v0.11.5 的降级语义) | ✅ 红 |
| 弹窗失败就发通知(三重打扰) | ✅ 红(2 条) |
| 两级都失败也不发通知(用户全无反馈) | ✅ 红(2 条) |
| 弹窗失败把主窗口也带挂(异常没隔离) | ✅ 红 |
✅ 实测结论(2026-09-18)¶
主窗口正常弹出,插件弹窗确实弹不出来 —— 上面两条 Chrome 约束成立,判断被证实。
⇒ 代码注释已从「多半弹不出来(未经实测)」改成实测结论。 ② 保留但不抱期待:它在别的窗口构型下可能成功(代价只是一次 info 日志), 删掉等于把这条路永久关死。不为一次实测结果删掉一条无害的兜底。
⇒ 「小窗口也一起弹」这个需求技术上做不到。若 popup 里有主窗口没有的信息, 正确解法是把那部分挪进主窗口,而不是强行弹两个窗口。