Initial TrueGrowth source import

docs/POSTHOG_PPT_PROMPT_ANALYTICS.md

@@ -0,0 +1,74 @@
+# PostHog PPT 与提示词能力报表
+
+本文档记录 PPT、提示词库、提示词优化与提示词工具的 PostHog 埋点口径和看板。事件通过 `analytics.track()` 异步脱敏上报，不上传原始 prompt、PPT 文本、图片 URL 或文件名。
+
+当前看板：
+
+- 名称：`PPT 与提示词能力分析`
+- 地址：`https://us.posthog.com/project/263621/dashboard/1511704`
+- 创建日期：2026-04-26
+- 图表数量：13
+
+## 事件口径
+
+### `ppt_action`
+
+用于分析 PPT 大纲、页面编辑、批量生图、素材替换、导出播放等动作。
+
+核心字段：
+
+- `action`: `generate_outline`、`mindmap_to_ppt`、`generate_outline_slides`、`export_all`、`open_slideshow`
+- `source`: `mcp_generate_ppt`、`project_drawer_outline`、`popup_toolbar`
+- `status`: `start` / `success` / `failed` / `cancelled`
+- `pageCount`、`frameCount`、`selectedCount`、`successCount`、`failedCount`
+- `durationMs`、`serialMode`、`model`
+- `prompt_length_bucket`、`prompt_line_count`、`has_prompt`
+
+### `prompt_action`
+
+用于分析提示词历史、预设、优化、工具打开、搜索筛选、选择回用等动作。
+
+核心字段：
+
+- `action`: `open_tool`、`open_panel`、`select`、`select_record`、`unselect_record`、`pin`、`delete`、`preview_example`、`optimize`、`apply`、`search`、`filter_category`、`filter_skill`、`refresh`、`load_more`
+- `surface`: `ai_input_bar`、`inspiration_board`、`ai_input_prompt_popover`、`prompt_history_tool`、`prompt_list`、`prompt_optimize_dialog`、`ppt_common_prompt`
+- `promptType`: `image`、`video`、`audio`、`text`、`agent`、`ppt-common`、`ppt-slide`
+- `mode`: `polish` / `structured`
+- `status`、`model`、`durationMs`、`itemCount`
+- `prompt_length_bucket`、`requirements_length_bucket`
+
+## 看板图表
+
+当前 PostHog 看板包含 13 张图表：
+
+- PPT 功能动作总览（14d）
+- PPT 日趋势按动作（14d）
+- PPT 大纲到导出转化节点（14d）
+- PPT 生图成功率与失败页数（14d）
+- PPT 提示词编辑与优化采用（14d）
+- 提示词功能动作总览（14d）
+- 提示词日趋势按动作（14d）
+- 提示词优化转化与失败（14d）
+- 提示词长度与补充要求分布（14d）
+- 提示词工具入口与采用路径（14d）
+- 提示词历史工具搜索筛选（14d）
+- 提示词历史选择与回用信号（14d）
+- 提示词工具来源与类型分布（14d）
+
+## 优化判断
+
+- `open_tool` 少：提示词工具入口弱，优先优化 AI 输入栏与灵感区入口可见性。
+- `open_panel` 高但 `select` 低：提示词列表可读性、分类或预览吸引力不足。
+- `search` / `filter_*` 高：用户有明确查找意图，可补更强的标签、排序和收藏能力。
+- `select_record` 高但后续生成低：历史提示词被翻找但未形成回用，优先优化回填/复用动作。
+- `optimize.success` 高但 `apply` 低：优化结果质量或回填路径需要继续打磨。
+- `requirements_length_bucket = 0` 高：补充要求入口可能未被理解，可优化占位文案。
+
+## 版本观察建议
+
+上线后先观察 24 小时：
+
+1. 看 `ppt_action` 与 `prompt_action` 是否都有真实流量，确认埋点链路通。
+2. 看 `generate_outline_slides` 的 `failedCount / selectedCount`，定位 PPT 生图失败压力。
+3. 看 `prompt_action.apply / prompt_action.optimize.success`，衡量提示词优化是否真正被采用。
+4. 看 `select / open_panel` 与 `select_record / open_tool`，判断提示词工具是否带来真实回用。