| # 落地路线图（Implementation Roadmap） | |
| ## 总原则 | |
| - 先改“布局与信息架构”，再逐步精炼组件与数据结构 | |
| - 尽量保持现有业务逻辑不变（SSE、历史、导出、分享） | |
| - 以“小步快跑”的里程碑交付 | |
| ## Phase 0：现状校准（0.5 天） | |
| - 统一确认“报告”的数据结构来源： | |
| - 当前状态（内存 state） | |
| - localStorage history | |
| - 登录后 server history | |
| - 明确分享 URL 语义： | |
| - 现在分享基本是当前页面 URL | |
| - 若要真正“可复现报告”，需要 `/reports/:id` + 后端存储 | |
| ## Phase 1：三栏 AppShell + 主页信息流（2-4 天） | |
| 交付： | |
| - 桌面三栏布局（LeftNav/Main/RightSidebar） | |
| - `/` 主页改为：Tabs + Composer + Feed | |
| - 右侧栏上线：CTA/登录点数/Trending/社群 | |
| 验收点： | |
| - 新用户能在 10 秒内找到并开始生成 | |
| - 生成完成后在 feed 中出现 ReportCard，可点击打开详情 | |
| ## Phase 2：Report Viewer Drawer + 动作条统一（2-3 天） | |
| 交付： | |
| - ReportViewer 支持 Drawer 打开 | |
| - ActionBar 固定：分享/导出/保存/打印/重新生成 | |
| - 权益 gating 统一（AuthGate） | |
| 验收点： | |
| - 游客点击锁定能力时才弹登录（减少打断） | |
| ## Phase 3：内容页融入统一布局（2-3 天） | |
| 交付： | |
| - `/knowledge` `/cases` 迁移到 AppShell 下 | |
| - 右侧栏在内容页也生效（推荐/CTA） | |
| 验收点： | |
| - 全站导航体验一致 | |
| ## Phase 4：报告可分享/可复访（后端协作，3-7 天） | |
| 交付： | |
| - `/reports/:id`（或 share token） | |
| - 分享链接打开后能复现报告 | |
| - SEO：Report 的 meta（title/description/open graph） | |
| 验收点： | |
| - 从 x.com 分享链接进入时，落地页直接展示报告摘要与查看详情 | |
| ## Phase 5：增长与数据（持续） | |
| 建议埋点： | |
| - `generate_start` | |
| - `generate_complete` | |
| - `share_click`（按渠道：x/tg/qr/copy/image） | |
| - `export_html` | |
| - `print_pdf` | |
| - `auth_open` / `auth_success` | |
| ## 技术注意事项 | |
| - SSE 进度与取消：建议提供取消按钮（abort controller） | |
| - 分享组件一致性：当前 `SharePanel` props 在不同调用处存在不一致风险，落地时需统一 | |
| - 性能：主栏信息流需要虚拟列表可选（后续再做） | |