11 · 从理解到实战场景

请分诊「网站做快一点」这个需求，不要改文件。

请输出：
- 这句话的可能含义有哪些（首屏快 / 加载快 / 交互快 / SEO 快…）
- 每种含义需要查什么证据
- 推荐先确认哪个含义

可能含义：
1. 首屏 LCP（Largest Contentful Paint）慢
2. 加载所有资源慢（带宽 / CDN）
3. 路由切换交互卡顿
4. API 响应慢
5. 搜索引擎抓取慢

建议先打开 Chrome DevTools Performance 录一段，看到底慢在哪。

请围绕首屏 LCP 慢收集证据，不要改文件。

请查找：
- next.config.js 配置
- _app.tsx 全局加载
- 首屏组件（Home / Hero / 主图）
- 图片大小 / 格式
- 第三方脚本（analytics / chat widget）

基于证据，拆成最小修复任务：

任务 A: 把首屏图片转 WebP + 加 priority loading
任务 B: 把 analytics 脚本延后 (lazy)
任务 C: 把第三方 chat widget 延后到用户交互后再加载

每个任务独立，先做 A，看效果再决定 B/C。

任务 A · 首屏图片优化

🎯 目标：
首屏 LCP 从 3.2s 降到 < 1.8s

📁 范围：
- 只改 components/Hero.tsx 和 public/images/hero.*
- 不改其他页面、不改路由

🚧 边界：
- 不新增图片处理库（用 next/image）
- 不动 next.config.js 全局配置

✅ 验证：
- Chrome DevTools Lighthouse Performance ≥ 90
- 首屏 LCP < 1.8s
- 视觉效果一致（前后截图对比）

请先给计划，确认后再改。

请分诊：

报错截图描述：用户说「点保存按钮没反应」

请问我以下信息（不要改文件）：
- 哪个页面 / 哪个按钮
- 浏览器 + 系统 + 版本
- 控制台报错全文
- 最近改了什么
- 能稳定复现还是偶发

基于现有信息（控制台报错 Cannot read properties of undefined）：

可能原因（按概率排序）：
1. 🔴 数据返回结构变了（API 少字段）
2. 🟡 状态管理初始值缺失
3. 🟢 异步竞态（先点先 race）

建议先验证 1：用 curl 调当前 API 看返回结构。

任务：修复保存按钮 undefined 错误

🎯 目标：
profile API 返回 email 缺失时不崩溃

📁 范围：
- 只改 components/ProfileForm.tsx
- 加可选链 + 默认值

🚧 边界：
- 不改 API（那是后端的事，单独 issue）
- 不改其他页面

✅ 验证：
- email 缺失时显示 placeholder 而不是 crash
- 补一个测试用例覆盖 email = undefined
- pnpm test ProfileForm 通过

请先给计划。

我刚加入这个项目。请帮我建立项目地图，不要修改文件。

请阅读：
- README / CONTRIBUTING / AGENTS.md
- package.json / pyproject.toml
- 主要源码目录（src/ 或 packages/）
- 路由 / 入口文件
- 测试目录

请输出：
1. 项目用途（一句话）
2. 技术栈（语言 / 框架 / 包管理器）
3. 主要目录职责（每个 ≤ 1 行）
4. 启动 / 测试 / 构建命令
5. 最重要的 5 个文件 + 为什么
6. 「我作为新人下一步该读什么 / 做什么」
7. 你不确定的地方明确标出

任务：修 {bug 描述}

🎯 目标：{用户角度的现象消失}
📁 范围：只改 {目录}
🚧 边界：
- 不改无关文件
- 不新增依赖
- 不改 db / .env / 部署配置
✅ 验证：
- {真实验证命令，如 pnpm test X}
- {人工验收步骤}
📦 交付：
- 修改文件清单
- 验证结果
- 剩余风险

请先给计划，等我确认。

任务：给 {组件 / 函数} 补单测

🎯 覆盖点：
- 正常路径
- {边界 1}（如空数组）
- {边界 2}（如 null）
- {边界 3}（如错误状态）

🚧 边界：
- 不改源文件，只加测试
- 用项目已有 testing-library / vitest

✅ 验证：
- pnpm test 通过
- 覆盖率 ≥ {目标}

📦 交付：测试文件 + 覆盖率说明

任务：重构 {文件 / 模块}

🎯 目标：
- {可衡量目标，如「把 200 行 handler 拆成 ≤ 50 行的 N 个 helper」}
- 行为不变（regression test 通过）

🚧 边界：
- 只改 {文件}
- 不改其他文件的导入
- 不动签名（API 不变）

✅ 验证：
- 所有相关测试通过
- 类型检查通过
- 行为对比（diff 不该有功能变化）

任务：把 {API} 从 v1 升级到 v2

🎯 目标：
- 替换调用点
- 适配新返回结构

📁 范围：
- 只改 lib/api/{module}.ts
- 调用此 API 的页面只改类型，不改逻辑

🚧 边界：
- 不改其他 API
- 不改 UI 行为（除非 v2 字段缺失要兜底）

✅ 验证：
- 类型检查通过
- 集成测试通过
- 手工跑一次主流程