feat: 部署初版测试

docs/PRODUCT_ROADMAP.md

@@ -0,0 +1,348 @@
+# InsightReply 产品功能路线图 (Product Roadmap)
+
+> 本文档从**用户为什么会用 → 为什么会留 → 为什么会付费 → 为什么会推荐**四个维度，规划功能完善方向。
+> 与 `DEVELOPMENT_PLAN.md`（任务分解）配合使用，本文档侧重**产品策略与竞争力分析**。
+
+---
+
+## 一、核心链路断裂点修复 — 🔴 P0（直接影响用户留存）
+
+### 1.1 多条备选评论（选择感）
+
+**现状问题**：当前 API 一次只返回 1 条评论。用户看到一条不满意的结果，大概率会觉得"AI 不靠谱"然后关掉。
+
+**目标体验**：每次生成至少 **3 种策略 × 1 条 = 3 条备选**，用户可以对比、选择、微调。
+
+**实现方案**：
+*   后端单次 LLM 调用要求 JSON 数组输出（方案 A，节省 API 开销）
+*   前端 Sidebar 改为**卡片列表式展示**，每张卡显示策略标签 + 评论文本 + 复制按钮
+*   用户选中某条后记录 `strategy_type` 偏好，为后续个性化打基础
+
+**产品指标影响**：预期将评论复制率（Copy Rate）提升 **2-3 倍**
+
+---
+
+### 1.2 用户 Onboarding 流程（个性化基石）
+
+**现状问题**：身份标签硬编码为 `Independent Developer / Founder`，所有人生成的评论语气完全一样，"个人定位系统"形同虚设。
+
+**目标体验**：安装后首次打开时，3 步引导完成个性化设置。
+
+**Onboarding 流程设计**：
+
+```
+Step 1: 你的身份是？
+┌────────────────────────────────────┐
+│  🧑‍💻 AI 创始人                      │
+│  🚀 SaaS Builder                   │
+│  💰 投资人                          │
+│  🔧 独立开发者                      │
+│  📊 技术分析者                      │
+└────────────────────────────────────┘
+
+Step 2: 偏好语言？
+┌────────────────────────────────────┐
+│  🇺🇸 English                        │
+│  🇨🇳 中文                           │
+│  🌐 跟随原推文语言 (Auto)             │
+└────────────────────────────────────┘
+
+Step 3: 默认风格倾向？
+┌────────────────────────────────────┐
+│  ⚖️ 专业严谨                        │
+│  😄 轻松幽默                        │
+│  🔥 犀利锐评                        │
+└────────────────────────────────────┘
+```
+
+**数据存储**：`chrome.storage.sync`（跨设备同步） + 后端 `users` 表的 `identity_label` / `language_preference`
+
+---
+
+### 1.3 Prompt 工程深度优化
+
+**现状问题**：当前 System Prompt + User Prompt 总共不到 100 个 token, 缺乏策略差异化指令、结构公式、Few-shot 示例、语言控制。
+
+**目标 Prompt 结构**：
+
+```
+[System Prompt]
+角色：你是 X (Twitter) 高影响力评论撰写专家。
+结构公式：每条评论必须遵循 Hook(抓注意力) + Position(表明立场) + Insight(独特洞察) + Brevity(简洁有力)。
+约束：不超过 {max_length} 字符，使用 {language} 语言，语气匹配 {identity} 身份。
+
+[User Prompt]
+身份: {identity} (例: 连续创业者, AI SaaS 方向)
+原推文: "{tweet_content}"
+策略: {strategy_name}
+策略详细定义: {strategy_instruction}
+
+参考高互动评论 (Few-shot):
+1. "Most people miss this — the real moat isn't the model, it's the data flywheel..."
+2. "We faced this exact problem building [product]. Here's what actually worked..."
+
+输出 3 种策略各 1 条, JSON 格式:
+[{"strategy": "...", "content": "...", "hook_type": "..."}]
+```
+
+**关键改进对照表**：
+
+| 维度 | 改进前 | 改进后 |
+|------|-------|-------|
+| 策略区分 | 只传名称 | 每种策略含 5-10 行详细定义 |
+| 结构公式 | 无 | Hook+Position+Insight+Brevity |
+| Few-shot | 无 | 每种策略附 2-3 条真实高赞示例 |
+| 语言控制 | 未指定 | 支持 en / zh / auto |
+| 输出格式 | 纯文本 | JSON 结构化，可解析 |
+| 字数约束 | "under 280" | 精确 `max_length` 参数 |
+
+---
+
+## 二、体验增强功能 — 🟠 P1（提升产品吸引力）
+
+### 2.1 前端热度标签
+
+**场景**：用户在 Timeline 浏览时，不知道哪条推文适合去评论。
+
+**方案**：Content Script 基于 DOM 中可读取的互动数据，在 Insight 按钮旁注入热度标签：
+
+| 标签 | 条件 | 视觉 |
+|------|------|------|
+| 🔥 `Trending` | Likes > 1000 且发帖 < 2h | 红色渐变 Badge |
+| ⚡ `Rising` | Likes > 100 且发帖 < 1h | 黄色渐变 Badge |
+| 无标签 | 不符合上述条件 | 仅显示 Insight 按钮 |
+
+**核心价值**：帮用户**快速判断评论时机**，降低决策成本。纯前端实现，不需要后端支持。
+
+---
+
+### 2.2 评论历史 Tab
+
+**场景**：用户想回看之前生成/使用过的评论，总结什么风格效果好。
+
+**方案**：在扩展 Popup 中新增 `History` Tab：
+*   本地存储最近 50 条生成记录（`chrome.storage.local`）
+*   每条显示：原推文摘要（截断 60 字）、策略标签、生成时间、已复制 / 已跳过状态
+*   如果有效果数据（V2），还可标注 ❤️ 互动数
+*   支持搜索和策略筛选
+
+---
+
+### 2.3 Quote Tweet（引用评论）生成
+
+**场景**：很多创始人的高互动内容来自 Quote Tweet ——对别人的推文加上自己的分析后转发发出。
+
+**方案**：策略列表新增第 6 种策略类型：
+
+| 策略 | 说明 | 典型格式 |
+|------|------|---------|
+| `quote_thread` | 引用评论型 | [引用原推文] + 2-3 句独立观点 + 可选 takeaway |
+
+*   Prompt 中明确要求生成"可独立发帖"的长度（≤ 280 字）
+*   前端复制按钮改为"Copy as Quote"，提示用户在 X 中使用引用转发
+
+---
+
+## 三、核心护城河功能 — 🟡 P2（从"可用"到"不可替代"）
+
+> [!IMPORTANT]
+> P2 阶段的两个功能（效果追踪 + 风格学习）是 InsightReply 与所有竞品拉开差距的**核心壁垒**。
+> 竞品只做"生成"，InsightReply 做"生成 → 追踪 → 学习 → 越来越像你"的数据飞轮。
+
+### 3.1 评论效果追踪闭环
+
+**用户故事**：作为用户，我想知道我用 InsightReply 生成的评论发出后效果如何，这样我能知道哪种策略最有效。
+
+**实现路径**：
+
+```
+用户复制评论
+    │
+    ▼
+Toast 提示:"评论发出后, InsightReply 将在 24h 后追踪互动数据"
+    │
+    ▼
+Content Script 延迟检测 (24h 后)
+    │ 通过用户 Timeline DOM 回查
+    ▼
+匹配到已发评论 → 提取 Likes / Replies 数
+    │
+    ▼
+写入 reply_performance 表
+    │
+    ▼
+"我的评论表现" 数据面板
+```
+
+**技术关键点**：
+*   用户复制评论时，将评论文本哈希存入 `chrome.storage.local` 作为追踪 Key
+*   Content Script 在用户访问自己 Profile 页时，扫描近期评论，匹配已存 Key
+*   匹配成功后提取互动数据，通过 Background → API 写入数据库
+*   无需爬虫，**完全基于用户自身浏览行为**触发
+
+### 3.2 个人风格学习飞轮（核心差异化）
+
+**数据飞轮模型**：
+
+```
+用得越多 → 评论数据越多
+    │
+    ▼
+高互动评论 → LLM 总结风格特征
+    │  "这条评论之所以表现好，是因为:
+    │   1. 用了反问句开头
+    │   2. 引用了数据
+    │   3. 语气简洁有力"
+    ▼
+更新 user_style_profiles
+    │  top_strategies: ["contrarian", "data_supplement"]
+    │  tone_preference: "provocative"
+    │  high_engagement_keywords: ["moat", "flywheel", "most people miss"]
+    ▼
+下次生成 → Prompt 注入个人风格
+    │  "你的高互动风格倾向: 善用反问句, 喜欢引用数据..."
+    ▼
+生成质量提升 → 互动率提升 → 更多数据 → 更懂你 (🔄 Flywheel)
+```
+
+**Prompt 注入示例**：
+```
+[附加上下文 - 个人风格画像]
+基于你过去 30 天的高互动评论分析:
+- 最有效的策略: 反向观点型 (平均互动率 4.2%)
+- 你的特征: 善用反问句开头, 喜欢引用具体数据, 语气简洁有力
+- 高频出现的高互动关键词: "most people miss", "here's the counterpoint", "data shows"
+- 平均最佳评论长度: 180 字符
+
+请参考以上风格特征生成评论。
+```
+
+**为什么这是护城河**：
+*   用户用得越久，AI 越懂自己 → **迁移成本极高**
+*   竞品无法复制**你的用户的数据**
+*   这不是技术壁垒，是**数据网络效应**
+
+---
+
+## 四、增长与传播功能 — 🔵 P3（让产品"被看到"）
+
+### 4.1 评论时机智能提醒
+
+**场景**：一条推文在发出后 30 分钟内评论的曝光量是 2 小时后的 5-10 倍。但用户不可能 24 小时盯着 Twitter。
+
+**方案**（需要后端雷达+Push）：
+*   后端监控到高潜推文时（heat_score 突破阈值）
+*   通过 Chrome Notification 推送："@sama 刚发了一条关于 AI Agents 的推文，热度飙升中⚡"
+*   用户点击通知 → 直接跳转到该推文 → Sidebar **已预加载好备选评论**
+*   极速评论窗口：监控 → 通知 → 跳转 → 评论 < 60 秒
+
+### 4.2 评论效果排行 & 成就系统
+
+**场景**：给用户正反馈循环，激励持续使用。
+
+**方案**：
+*   每周邮件/插件内报告："本周你的评论共获得 XX Likes，最佳评论是___"
+*   成就徽章：
+    *   🌟 "First Insight" — 首次生成评论
+    *   🔥 "Viral Reply" — 单条评论 > 100 Likes
+    *   📈 "Growth Streak" — 连续 7 天使用
+    *   🧠 "Style Master" — 风格画像达到 30 条数据
+
+### 4.3 社交裂变入口
+
+*   评论卡片底部低调加入 "Generated by InsightReply" 小字水印（Free 版）
+*   Pro 用户可去除水印
+*   分享功能："查看我本月的评论表现报告" → 生成分享图 → 发推
+
+---
+
+## 五、用户可配置系统 — 可扩展性设计 *(新增)*
+
+> [!IMPORTANT]
+> **设计原则：零硬编码 (Zero Hardcoding)**。系统不预设任何特定产品/领域/策略。
+> 所有与用户使用场景相关的能力，均通过用户自定义设置实现，确保产品适用于**任何行业、任何创始人**。
+
+### 5.1 用户可配置的产品档案 (Product Profile)
+
+用户在设置中自由配置自己正在推广的产品信息，系统自动将其注入 Prompt 上下文：
+
+| 配置项 | 说明 | 示例 |
+|-------|------|------|
+| 产品名称 | 用户自填 | "SwiftBiu" |
+| 一句话介绍 | 用户自填 | "AI-powered short video creation tool" |
+| 所属领域 | 用户自填 | "AI Video Creation" |
+| 核心功能 | 列表，用户增删 | ["视频生成", "多语言配音"] |
+| 竞品列表 | 列表，用户增删 | ["CapCut", "Descript"] |
+| 相关关键词 | 用于推文相关性评分 | ["short video", "content creation"] |
+| 自定义上下文 | 任意文本，原样注入 Prompt | "We focus on multi-language..." |
+
+**效果**：有了产品档案，LLM 生成的评论会自然地从用户产品领域出发，既专业又有关联性。
+
+### 5.2 用户自定义评论策略
+
+系统内置 5 种通用策略（认知升级/反向观点/数据补充/共鸣/创始人经验），但用户可以创建**无限私有策略**：
+
+*   **策略名称 + 描述**：告诉 LLM 这种策略的写法
+*   **Prompt 模板**：支持 `{product_name}` `{domain}` `{tweet_content}` 等变量
+*   **Few-shot 示例**：用户提供自己写过的高质量评论作为参考
+*   **排序权重**：控制显示顺序
+
+**示例用户策略**：
+| 策略 | Prompt 核心指令 | 适用场景 |
+|------|---------------|---------|
+| 🚀 Builder Story | "以 {product_name} 的开发经验为论据..." | 竞品/痛点讨论 |
+| 🎓 Domain Expert | "从 {domain} 领域专家角度分析..." | 行业趋势讨论 |
+| 🤝 Community Helper | "以用户角度推荐解决方案..." | 用户求助推文 |
+
+### 5.3 推文相关性评分 (Relevance Scoring)
+
+Content Script 基于用户配置的 `relevance_keywords` 对 Timeline 推文做实时相关性判断，在高相关推文旁显示 **🎯 High Relevance** 标签。
+
+纯前端实现，用户只需维护关键词列表即可自动生效。
+
+### 5.4 竞品讨论捕捉
+
+用户添加竞品品牌名（如 "CapCut"、"Descript"），系统两种途径识别竞品推文：
+*   **前端**：Content Script 在 Timeline 中实时检测包含竞品关键词的推文 → 🎯 标签
+*   **后端**（雷达系统就绪后）：定时抓取竞品讨论 → 推送通知
+
+---
+
+## 六、竞品差异化定位
+
+### 当前赛道竞品分析（2026）
+
+| 竞品 | 核心功能 | 定价 | InsightReply 差异化 |
+|------|---------|------|-------------------|
+| Reply Guy | 自动生成回复 | $39/mo | ❌ 偏自动化灰产，我们定位"写作增强" |
+| TweetPik AI | AI 回复 + 截图 | $19/mo | ❌ 无个性化学习，不可配置 |
+| XReply | 批量回复 | $29/mo | ❌ 无效果追踪，无产品档案 |
+| Postwise | AI 写推文 | $49/mo | ❌ 不专注评论场景 |
+| Hypefury | 排程 + AI | $29/mo | ❌ 重排程轻评论 |
+| **InsightReply** | **可配置评论引擎 + 风格学习 + 效果闭环** | **$9-29/mo** | ✅ **唯一：产品档案 + 自定义策略 + 数据飞轮** |
+
+### InsightReply 的核心叙事
+
+> **不只是帮你写评论的 AI，而是一个理解你的产品、学习你的风格、越用越懂你的社交表达引擎。**
+
+---
+
+## 七、功能优先级总览
+
+| 优先级 | 功能 | 预估工时 | 留存影响 | 所在阶段 |
+|-------|------|---------|---------|---------|
+| 🔴 P0 | 多条备选评论（3策略×1条） | 3h | ⭐⭐⭐⭐⭐ | Phase 1 |
+| 🔴 P0 | Onboarding 设置流程 | 4h | ⭐⭐⭐⭐⭐ | Phase 1 |
+| 🔴 P0 | Prompt 深度优化 | 4h | ⭐⭐⭐⭐⭐ | Phase 1 |
+| 🟠 P1 | 前端热度标签（🔥/⚡） | 2h | ⭐⭐⭐⭐ | Phase 1 |
+| 🟠 P1 | 评论历史 Tab | 4h | ⭐⭐⭐⭐ | Phase 1 |
+| 🟠 P1 | Quote Tweet 生成 | 3h | ⭐⭐⭐ | Phase 1 |
+| 🟠 P1 | 产品档案 (Product Profile) | 3h | ⭐⭐⭐⭐⭐ | Phase 1 |
+| 🟠 P1 | 自定义策略模板 | 4h | ⭐⭐⭐⭐ | Phase 1 |
+| 🟠 P1 | 推文相关性评分 (🎯) | 4h | ⭐⭐⭐⭐ | Phase 1 |
+| 🟡 P2 | 评论效果追踪闭环 | 1-2w | ⭐⭐⭐⭐⭐ | Phase 2 |
+| 🟡 P2 | 个人风格学习飞轮 | 1-2w | ⭐⭐⭐⭐⭐ | Phase 2 |
+| 🟡 P2 | 竞品监控 + 推送 | 依赖雷达 | ⭐⭐⭐⭐ | Phase 2 |
+| 🔵 P3 | 评论时机智能提醒 | 1w | ⭐⭐⭐⭐ | Phase 2 |
+| 🔵 P3 | 效果排行 & 成就系统 | 1w | ⭐⭐⭐ | Phase 3 |
+| 🔵 P3 | 社交裂变入口 | 3h | ⭐⭐⭐ | Phase 3 |