项目鸟瞰¶
⚙️ 本文件由
pnpm docs:rebuild自动生成,手改无效。
当前版本:v0.16.86¶
最近 5 次版本改动¶
- 2026-10-02 v0.16.77 → v0.16.78 ISSUE-0226 AI 配置同步挱云端 tab + 开关形态重做(Tony 拍板)
- 2026-10-02 v0.16.76 → v0.16.77 ISSUE-0225 AI 账号弹窗 label 常驻骑缝(Tony 指认改向)+ 掩码越界证伪存档
- 2026-10-02 v0.16.75 → v0.16.76 ISSUE-0224 设置页 tab CJK 逐字断行错位
- 2026-10-02 v0.16.74 → v0.16.75 商家列表头像美化 + 界面一致性保守梳理
- 2026-09-17 v0.11.0 → v0.11.1
本次改动¶
产品文档 + 五层研发知识漏斗¶
| 层 | 入口 | 写入门槛 | 用途 |
|---|---|---|---|
| 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 看门狗的兜底机制
- jsstore 给已有表加列的真实机理 —— 三条路与 taskId 事故的真相 — 不写 alter 就永远没索引;同版本加列可行;升级安装用缓存 schema
- 云端同步架构(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 失效 + 双轨恢复机制全流程
- 整页 Markdown 管线 —— 从 HTML 到 PageMarkdown 表 — offscreen 转换 + 入库 + 淘汰 + 级联删的架构与三条硬约束
🚀 进行中的 specs (17)¶
- — SPEC-007 — 抓取响应快照(FetchSnapshots)云端共享协议
- SPEC-008 文档与功能同步治理升级
- SPEC-010 当前缺陷止损清单(SPEC-009 的实施前置)
- — 云端同步身份模型与契约实现差距
- — 电话三阶段管线 —— 识别 / 格式规范化 / 固话手机分类
- — ContactPool 云端合并契约 —— 给后端开发的接口需求
- — 整页 Markdown 本地存储与上传契约 —— 给后端开发的接口需求
- — 社区共享接口并入来发信主 API —— 给服务端的实现清单
- — 插件内置 AI —— 关键词分析 + 商家匹配度
- — 插件内收发邮件 —— 走 IMAP/SMTP 中转(Tony 定案)
- — 集成 WhatsApp —— 扫码登录与凭据迁移的真实代价
- — 跨渠道知识库 —— 把采集、邮件、WhatsApp、官网正文喂给 AI
- — 把插件的数据做成 MCP —— 让 Claude / Codex 直接查
- — Contact 数据池重做 —— 让它讲得清、省得出、上得了线
- — SPEC-025 组合表 —— 把「关键词 × 地区」提升为一等实体
- — SPEC-027 「采到多少」的唯一事实源与物化投影
- SPEC-004-Phase3-API SPEC-004 Phase 3 — 云端 API 契约(客户端先就绪 / 服务端待实现)
⚠️ 未解决 issues (3)¶
- observing 0093-unreachable-results-and-settings-windows.md — results / settings 两个独立窗口入口不可达,仍打包进扩展
- observing 0148-source-inferred-flag-order-dependent.md — sourceInferred 随来源处理顺序变化 —— 行级布尔压不住 per-source 的语义
- observing 0223-large-db-full-mode-dual-scrollbar-and-pagination-unpinned.md — 大库完整模式双滚动条回归 + 数据页分页不钉底 — 0069 翻档条款首触发
给 AI 的快速指引¶
- 用户提需求/反馈 → 先存
docs/raw/,再评估转docs/specs/ - 修 bug → 落档
docs/issues/ - 用户可见行为变化 → 更新
docs/product/ - 架构变化 → 更新
docs/wiki/ - 首次描述工具 → 建
docs/rules/(按需建档元规则) - 产品影响提交 → 按
Docs-Impact规则声明同步文档或具体无影响理由 - 提交前 → 跑
pnpm docs:check校验文档健康