来发信谷歌地图采集 · 开发文档

Chrome MV3 浏览器扩展。WXT + React + MUI + TypeScript + jsstore。

文档结构（五层漏斗）

借鉴卡帕西的 raw + wiki 二分法 + 工程化扩展。写入门槛由低到高：

raw（垃圾桶，立即捕获）
  ↓ 评估 / 加工
specs（工程契约：要做什么）─→ done/（已落地）
  ↓ 实施
wiki（知识沉淀：是什么样）
  ↑
issues（修过的 bug：怎么坏过怎么修）
  ↑
rules（操作手册：遇到 X 怎么做）

层	用途	入口
Wiki	架构 / 字段语义 / 组件用法	实现完毕后沉淀
SPEC	PRD / 数据模型 / API / 任务拆分	新功能立项
ISSUE	病灶 / 修法 / 元教训	修完 bug 立即归档
Rule	遇到 X 怎么做	首次描述某工具/工作流时建档
Raw	用户原话 / 半成品想法	评估前暂存

快速入口

• 📋 当前进度 → 待办聚合 / 概览
• 📊 版本变更 → CHANGELOG — 按版本聚合，含 ISSUE/SPEC 链接
• 📝 每版细节 → 开发日志 — 当前活跃版本（v0.10.85+）
• 🔍 主题视角 → 主题 hub — 跨层按主题（watchdog/scheduling/auth/...）聚合

关键架构（点开看详情）

抓取链路

• 多阶段抓取 pipeline — SPEC-004 Phase 1（HEAD → GET → regex → tab fallback）
• 域名状态机 — Phase 2（6 状态 + TTL + 自动转换）
• 云端同步架构 — Phase 3（4 个 jsstore store + sync orchestrator）

调度核心

• 共享队列架构 — 同共享窗口 / 多 worker / pump pattern
• Tab 生命周期与看门狗 — 健康巡检 + 自动恢复

元规则

• scrape-pipeline 决策表 — mstage 标签完整速查
• UI 改动前置自查 — 改 UI 前的 4 步清单

提交流程

1. 用户提需求 / 反馈 → raw/{inbox,feedback,...}/ 立即粘贴
2. 评估为 bug → issues/ / 评估为需求 → specs/active/
3. 实施完成 → 移 specs/done/ + 更新 wiki/ + 写 issues/（途中 bug）
4. bump 版本 + build + commit + push（详见 版本发布流程）
5. CHANGELOG 自动重生成（pnpm docs:changelog）

给 AI 的入口

完整指引见 repo 根的 CLAUDE.md。新会话开始按顺序：

1. 看 _todo.md — 检查未完结项
2. 看 rules/00-meta-rule.md — 永远记得
3. 用户反馈 bug → 先查 issues/INDEX.md
4. 用户提新需求 → 查 specs/INDEX.md
5. 改某模块前 → 查 wiki/INDEX.md 对应条目

部署

本文档站发布到 Cloudflare Pages（push 自动 build + 上线），配置见 CF-Pages-部署。