来发信谷歌地图采集 · 产品与开发文档¶
Chrome MV3 浏览器扩展。WXT + React + MUI + TypeScript + jsstore。
先选入口¶
| 你要做什么 | 入口 |
|---|---|
| 按步骤使用产品、理解状态/错误/当前限制 | 产品使用文档 |
| 了解需求、架构、历史问题或研发规则 | 研发知识库概览 |
| 查看当前未完结项 | 待办聚合 |
产品使用文档¶
- Google Maps 采集 — 创建地图任务、查看状态、导出数据、处理常见错误。
- 产品文档索引 — 当前已覆盖的用户流程与文档边界。
产品文档描述的是当前实现，不是未来承诺。用户可见行为变化时，必须按 Docs-Impact 规则与代码同批同步。
五层研发知识漏斗¶
raw（原始素材，立即捕获）
↓ 评估 / 加工
specs（工程契约：要做什么） ─→ done/（已落地）
↓ 实施
wiki（知识沉淀：是什么样）
↑
issues（修过的 bug：怎么坏过、怎么修）
↑
rules（操作手册：遇到 X 怎么做）
| 层 | 用途 | 入口 |
|---|---|---|
| SPEC | PRD、数据模型、API、任务拆分 | 新功能立项 |
| Wiki | 架构、字段语义、组件用法 | 实现完毕后沉淀 |
| ISSUE | 病灶、修法、元教训 | 修完 bug 立即归档 |
| Rule | 遇到 X 怎么做 | 工具或工作流标准化 |
| Raw | 用户原话、半成品想法 | 评估前暂存 |
快速入口¶
- 版本变更 → CHANGELOG — 按版本聚合，含 ISSUE / SPEC 链接。
- 每版细节 → 开发日志 — 当前活跃开发日志。
- 主题视角 → 主题 hub — 跨层按主题聚合。
- 文档目录规范 → 什么在根、什么在 docs。
关键架构¶
抓取链路¶
调度核心¶
变更流程¶
- 需求或反馈进入
raw/，评估后进入specs/active/或issues/。 - 实现功能并验证。
- 用户可见行为变化时更新
product/；架构事实变化时更新wiki/。 src/**或wxt.config.ts进入提交时写Docs-Impact，关联文档必须在同一 staged 变更中。- 发布步骤按 版本发布流程执行；CHANGELOG 仍由现有命令生成。
给 AI 的入口¶
完整指引见 repo 根的 CLAUDE.md。开始工作时先看 _todo.md，再按任务类型查 product / issue / spec / rule / wiki / raw 对应 INDEX。
部署¶
本文档站可按 CF-Pages-部署 指引发布到 Cloudflare Pages；是否已上线以当前 Pages 项目和部署记录为准。