🔐 登录与认证¶
Popup / 主面板登录 / cookie 自动登录 / stale token
⚙️ 本文件由
pnpm docs:rebuild自动生成 — 修改无效。
涉及文档(38 个)¶
🧭 产品使用文档(4)¶
- 数据外发清单 · stable
- 扩展会把哪些数据发往哪些服务器,以及每一项的用途与开关
- Google Maps 商家采集 · stable
- 从创建地图任务到查看、管理和导出商家数据的当前操作说明
- 下一个大版本的六个方向(梳理稿,先不做) · stable
- 社区共享 / AI / 邮箱 / WhatsApp / 知识库 / MCP —— 六份方案的关系与先后
- 这一批更新你会看到什么(v0.10.180 → 194) · stable
- 设置页重排、两个会误导你的提示被修掉、两个安全问题、导入导出
📐 架构 / 知识沉淀(2)¶
- 登录系统架构与演进分析
- 扩展登录全链路拆解 + 与最原始 v0.8.37 的逐层对比 — 地基未变,三层兜底叠加
- Popup 认证状态机
- 浏览器扩展 popup 的登录态机制 — 4 态状态机 + 2 秒超时兜底 + 多重登录入口
🎯 功能规格(7)¶
- 文档治理自动化(docs:check + docs:rebuild + _overview) · done
- 用脚本 enforcement 解决"INDEX 脱节 / 断链 / 重复信息"持续累积的问题
- SPEC-004 Phase 3 — 云端 API 契约(客户端先就绪 / 服务端待实现) · approved
- 云端同步身份模型与契约实现差距 · draft
- 两套并存云端通道、契约与实现的差距清单、身份绑定移交开发说明
- 社区共享接口并入来发信主 API —— 给服务端的实现清单 · draft
- 服务端实现 8 个端点(含 health),砍匿名身份 —— 客户端 ensureAuth 必须同批改
- 集成 WhatsApp —— 扫码登录与凭据迁移的真实代价 · draft
- 三条技术路径、凭据迁移为什么最危险、封的是用户的号不是你的服务
- 跨渠道知识库 —— 把采集、邮件、WhatsApp、官网正文喂给 AI · draft
- 这是前面所有功能的归宿,也是唯一越用越值钱的那部分
- Contact 数据池重做 —— 让它讲得清、省得出、上得了线 · draft
- 不改存储模型,改「用户看得见什么」;补淘汰与首同步分批
🔧 已知问题 + 修复(21)¶
- 主面板「立即登录」按钮点击无反应 · fixed
- 点击登录也没有弹窗。我希望出现过的问题,以及改进方案都要做记录。
- Popup 启动后 loading 骨架屏永久卡住 · fixed
- 一直卡在这(截图:popup 顶部骨架屏一直转),如何登录呢?
- 长时间运行后浏览器卡死 / 累积孤儿 Tab · fixed
- 插件运行时间长,会导致电脑卡死,页面没正常关闭,是不是要加上定期的检查?确保浏览器正常关闭,而不是打开一堆?
- 拖动表格列宽后被自动重置 · fixed
- 字段拖动宽度会被自动重置
- 列宽 / 列序 storage key 未按账号隔离 · fixed
- 列宽 / 列序 storage key 漏 uid 前缀,多账号污染
- Watchdog 鲁棒性三连:并发触发 / nuke 不真关 tab / 计数残留 · fixed
- watchdog 鲁棒性三连:并发 / nuke 不真关 tab / 计数残留
- Popup 2s timeout 与 uid 到达的竞态 · fixed
- Popup 2s timeout 与 uid 到达的竞态(观察项)
- DataView 浪费 IndexedDB taskId 索引 + onMessage listener 无 cleanup · fixed
- 每 5s 拉全表再 JS filter(应 where 走索引)+ unmount 后 listener 残留 stale closure
- TypeError: Failed to fetch 冒到 chrome://extensions 错误日志 · fixed
- 业务已 handle 的网络瞬断,仍显示在 Chrome 扩展错误页误导用户以为扩展坏了
- ext-context-guard 应在 import-time 装 listener(早期 fetch reject 漏过) · fixed
- 旧版 main.tsx line 8 才 installContextGuard(),line 1-3 import 期间的 fetch reject 漏过冒到 chrome 错误日志
- 长期改进 3 连击:task scan limit + optimistic delete + keyword 一致性 · fixed
- 解决之前留作"下轮再做"的 3 个低风险改进(不含 useDataSource hook 大重构)
- auth/context/utils.ts JWT session 死代码(母模板残留) · fixed
- isValidToken/setSession/tokenExpired 全仓零引用,本扩展不走 JWT,已删整文件
- manifest host_permissions 域名拼写错误(lafaxin.com 少一个 i) · fixed
- wxt.config.ts 写成 lafaxin.com,被
掩盖;一旦收紧权限 API 全挂 - 两条快路径写回 MapTaskData 时漏重置 sync:0,补写的联系方式永不上云 · fixed
- 社媒分支与同网址复用分支缺 sync:0,旧云通道已标记已同步的行不会再上传
- Chrome 错误面板出现无栈的「Error: No SW」—— 全仓搜不到这个字符串 · fixed
- SW 未捕获 rejection 既不可定位也不留痕;补 13 类裸 promise 的 catch + 记 sysLog
- 云端 API 地址框把 Bearer 凭据发往用户填的任意 https 域名 · fixed
- https 判据挡得住 http、挡不住 https://任意域名;Tony 实测填 test.com token 照发
- 登录窗关不掉 —— 关窗搭在一个 5 分钟轮询上 · fixed
- 主窗口没开就永远不关;外加 SW 竞态与模块级常量被就地污染
- 登录流程没有可见落点 —— 窗口不置前、登完是空屏 · fixed
- tabs.create 只选中不置前;关掉登录页之后没有任何成功反馈
- 模型行只判 testOk 两态——「已失效」被显示成绿勾 · fixed
- modelHealth 写了四态且「stale 压过 testOk」,而模型行没用它;账号行四态、模型行两态,同一语义两套实现
- main.html 喷 Uncaught (in promise) —— 4 处 sendMessage 发完不管 · fixed
- SW 休眠竞态让 fire-and-forget 的消息 reject,没人 catch
- 去 AI 味第二刀:字号档位失控与色彩语义降级 · fixed
- 统计条六档字号同屏、任务格孤紫、结束按钮黄字语义降级 —— 视觉预算失守的集中清理
📋 工作流规则(2)¶
- Cloudflare Pages 部署指引 · stable
- MkDocs site 发布到 Cloudflare Pages 的一次性配置 + 后续 push 自动部署
- 注释里别写可 grep 的代码字面量 · stable
- 本仓大量判据靠 grep 计数,注释里写代码串会让判据数错
🗒️ 原始素材(2)¶
- 反馈 — toast 提醒位置 + 网络状态位置 · processed
- 登录成功 toast 太靠下;网络状态点放侧栏底部不显眼,建议移到顶部标题旁
- 数据量增长存储架构方向——云边采边传 vs 纯本地优化 · reviewed
- Tony 三问:数据多了会不会卡 / 边采边传本地只留一部分是否更好 / 纯本地有什么更好方案——基于 42w 定案与三条云通道现状的对抗分析(glm-flash 对抗审修订版)
给 AI / 新协作者的建议阅读顺序¶
- 先看 product(核对当前用户路径和限制)
- 再读 wiki(了解架构)
- 再读 specs(了解需求 / 设计决策)
- 遇到 bug 查 issues(避免重蹈覆辙)
- 追溯起源看 raw(用户原话)