🔐 登录与认证

Popup / 主面板登录 / cookie 自动登录 / stale token

⚙️ 本文件由 pnpm docs:rebuild 自动生成 — 修改无效。

涉及文档（21 个）

🧭 产品使用文档（1）

• Google Maps 商家采集 · stable
• 从创建地图任务到查看、管理和导出商家数据的当前操作说明

📐 架构 / 知识沉淀（2）

• 登录系统架构与演进分析
• 扩展登录全链路拆解 + 与最原始 v0.8.37 的逐层对比 — 地基未变，三层兜底叠加
• Popup 认证状态机
• 浏览器扩展 popup 的登录态机制 — 4 态状态机 + 2 秒超时兜底 + 多重登录入口

🎯 功能规格（2）

• 文档治理自动化（docs:check + docs:rebuild + _overview） · done
• 用脚本 enforcement 解决"INDEX 脱节 / 断链 / 重复信息"持续累积的问题
• SPEC-004 Phase 3 — 云端 API 契约（客户端先就绪 / 服务端待实现） · approved

🔧 已知问题 + 修复（14）

• 主面板「立即登录」按钮点击无反应 · 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） · in-progress
• wxt.config.ts 写成 lafaxin.com，被 掩盖；一旦收紧权限 API 全挂
• 两条快路径写回 MapTaskData 时漏重置 sync:0，补写的联系方式永不上云 · in-progress
• 社媒分支与同网址复用分支缺 sync:0，旧云通道已标记已同步的行不会再上传

📋 工作流规则（1）

• Cloudflare Pages 部署指引 · stable
• MkDocs site 发布到 Cloudflare Pages 的一次性配置 + 后续 push 自动部署

🗒️ 原始素材（1）

• 反馈 — toast 提醒位置 + 网络状态位置 · processed
• 登录成功 toast 太靠下；网络状态点放侧栏底部不显眼，建议移到顶部标题旁

给 AI / 新协作者的建议阅读顺序

1. 先看 product（核对当前用户路径和限制）
2. 再读 wiki（了解架构）
3. 再读 specs（了解需求 / 设计决策）
4. 遇到 bug 查 issues（避免重蹈覆辙）
5. 追溯起源看 raw（用户原话）