项目鸟瞰¶
⚙️ 本文件由
pnpm docs:rebuild自动生成,手改无效。
当前版本:v0.10.124¶
最近 5 次版本改动¶
- 2026-05-31 v0.10.123 → v0.10.124 jsstore insertOne 死函数修复(ISSUE-0086)
- 2026-05-30 v0.10.122 → v0.10.123 Fix-Regression 反模式沉淀
- 2026-05-30 v0.10.121 → v0.10.122 HTTP 列 tooltip 诚实化 — ISSUE-0085
- 2026-05-30 v0.10.120 → v0.10.121 FetchSnapshots — 响应快照本地分析(ISSUE-0084 / SPEC-007)
- 2026-05-30 v0.10.119 → v0.10.120 UI 3 处修复 — 分页器/电话列/HTTP 列空降级
产品文档 + 五层研发知识漏斗¶
| 层 | 入口 | 写入门槛 | 用途 |
|---|---|---|---|
| product | product/INDEX.md | 高 | 用户入口 / 步骤 / 状态 / 错误 / 限制 |
| raw | raw/INDEX.md | 极低 | 用户反馈/对话/想法粘贴 |
| specs | specs/INDEX.md | 中 | PRD / 数据模型 / API |
| wiki | wiki/INDEX.md | 高 | 架构 / 字段 / 组件 |
| issues | issues/INDEX.md | 中 | Bug 修复归档 |
| rules | rules/INDEX.md | 高 | 工作流 / 工具使用 |
核心 wiki(架构必读)¶
- Popup 认证状态机 — 浏览器扩展 popup 的登录态机制 — 4 态状态机 + 2 秒超时兜底 + 多重登录入口
- Tab 生命周期与看门狗 — 抓取 Tab 的创建/销毁完整流程 + v0.10.15 看门狗的兜底机制
- 云端同步架构(SPEC-004 Phase 3 准备) — 为什么所有 sync-related 数据用 jsstore;4 类同步数据的 store 设计预览
- 共享队列架构 — v0.10.0 后的核心调度模型 — 多任务共用一个调度器、Tab/worker 是全局资源
- 内页跟随策略 — 网站抓取深度 ≥ 2 时,从首页找哪些站内链接进入再抓的规则
- 域名状态机(SPEC-004 Phase 2 核心概念) — 网站采集中每个域名的状态分类、转换规则、TTL 设计
- 多阶段抓取 pipeline(SPEC-004 Phase 1) — 客户端 HEAD → GET → regex → tab fallback 四层决策,跳过死站/反爬/无 contact 站,省 tab 开销
- 扩展 reload 生命周期(MV3) — SW 重启 + chrome-extension tab 失效 + 双轨恢复机制全流程
- 正则演示组件(RegexTester) — 让用户即改即看的正则测试折叠组件,避免抽象正则改完不知道效果
- 登录系统架构与演进分析 — 扩展登录全链路拆解 + 与最原始 v0.8.37 的逐层对比 — 地基未变,三层兜底叠加
🚀 进行中的 specs (4)¶
- — SPEC-007 — 抓取响应快照(FetchSnapshots)云端共享协议
- SPEC-008 文档与功能同步治理升级
- SPEC-010 当前缺陷止损清单(SPEC-009 的实施前置)
- SPEC-004-Phase3-API SPEC-004 Phase 3 — 云端 API 契约(客户端先就绪 / 服务端待实现)
⚠️ 未解决 issues (7)¶
- recurring 0042-round8-agent-scan-blindspot-4-bugs.md — 第 8 轮 agent — scan 工具盲区暴露 4 个新 bug + 扩 3 类新规则
- in-progress 0069-data-view-http-col-mstage-nested-scroll.md — data-view HTTP 列 mstage 漏改 + 嵌套滚动条(部分修)
- recurring 0080-phone-regex-captures-gps-coordinates.md — phone 正则把 GPS 坐标当电话号码抓 — ContactPool 共享池被污染
- in-progress 0089-dot-separated-phone-destroyed.md — 点分隔电话被坐标过滤器误杀并不可逆删除存量
- in-progress 0090-manifest-host-permission-domain-typo.md — manifest host_permissions 域名拼写错误(lafaxin.com 少一个 i)
- in-progress 0091-sync-flag-not-reset-on-fast-paths.md — 两条快路径写回 MapTaskData 时漏重置 sync:0,补写的联系方式永不上云
- observing 0093-unreachable-results-and-settings-windows.md — results / settings 两个独立窗口入口不可达,仍打包进扩展
给 AI 的快速指引¶
- 用户提需求/反馈 → 先存
docs/raw/,再评估转docs/specs/ - 修 bug → 落档
docs/issues/ - 用户可见行为变化 → 更新
docs/product/ - 架构变化 → 更新
docs/wiki/ - 首次描述工具 → 建
docs/rules/(按需建档元规则) - 产品影响提交 → 按
Docs-Impact规则声明同步文档或具体无影响理由 - 提交前 → 跑
pnpm docs:check校验文档健康