Initial TrueGrowth source import

docs/PPT_OUTLINE_IMAGE_ACTION_LESSONS.md

@@ -0,0 +1,27 @@
+# PPT 大纲图片入口经验
+
+## 背景
+
+PPT 大纲视图每页只有提示词和优化入口。用户在编辑提示词时，无法快速判断这一页是否已经生成过图片，也不能直接从大纲页预览当前生效的 PPT 图片。
+
+## 经验
+
+- 大纲视图应复用画布里的当前生效图片状态，不额外维护一份图片实体。
+- 当前生效图以 `findPPTSlideImage(board, frame.id)` 为准，优先使用 `pptMeta.slideImageElementId`，再回退到标记过的 PPT 图片或 `pptMeta.slideImageUrl`。
+- 缩略图只展示 URL，不读取原图数据；小图通过 `useThumbnailUrl` 延迟获取，避免在列表渲染时做大图解码。
+- hover 大图适合复用 `HoverCard`，比在列表中常驻大图 DOM 更轻，也能保持大纲列表滚动性能。
+- icon、缩略图和提示词优化按钮属于同一页的快捷操作，应放在页面标题行右侧，避免挤占提示词编辑区。
+
+## 实现要点
+
+- 无图时显示 AI 图片生成 icon，点击沿用 `handleRegenerateSlide` 打开图片生成弹窗。
+- 有图时显示当前生效图片的小缩略图，hover 后展示大图预览。
+- 图片生成中、失败、禁用状态只通过轻量 class 表达，不引入新状态源。
+- 大图预览使用 `loading="lazy"` 和 `decoding="async"`，减少主线程压力。
+
+## 注意事项
+
+- 不要把 base64 或 Blob 内容复制到 React state 中，列表态只传 URL。
+- 不要新增 PPT 图片状态表，避免和 `pptMeta` / 画布元素产生双写不一致。
+- 不要让原生 `title` 和自定义 hover 预览同时出现，避免浮层干扰。
+- 批量生成时按钮禁用即可，底层任务流仍由现有 PPT 生图队列控制。