# InsightReply 开发任务分解版

基于 PRD（v1.0）与产品功能路线图，我们将开发任务划分为以下核心模块与阶段，适合在 Notion/Jira 等任务管理系统中作为 Epic/Story 录入。

> 📌 功能完善度的详细分析与竞品对比见 → [`PRODUCT_ROADMAP.md`](./PRODUCT_ROADMAP.md)

> **状态标签说明**：🟢 已完成 | 🟡 进行中 | ⚪ 未开始

---

## 🏁 第一阶段：核心 MVP（预计耗时 2-4 周）
**核心目标**：跑通"获取推文 -> 生成多策略评论 -> 一键复制"的核心业务流。

### Epic 1: 项目基础设施搭建
- [x] 🟢 **前端框架初始化**：搭建浏览器插件（Chrome Extension）基础模版，使用 Vue 3 + Tailwind CSS v4，配置 Vite + CRXJS 打包工具。
- [x] 🟢 **后端架构选型与初始化**：创建 Go (Golang) 后端服务基础框架（chi 路由 + GORM + Clean Architecture 分层）。
- [x] 🟢 **数据库初始化**：设计并创建基础表结构（Users, MonitoredKeywords, Tweets, GeneratedReplies）。
- [x] 🟢 **LLM API 接入**：联通 OpenAI GPT-4o Mini API，建立接口通信链路。
- [x] 🟢 **CI/CD 流水线**：搭建 Gitea Actions 自动部署（后端 Docker + 前端打包发布）。

### Epic 2: 浏览器插件核心开发
- [x] 🟢 **UI 侧边栏实现**：在 X（Twitter）页面注入前端组件（Shadow DOM 隔离），展示 InsightReply 面板。
- [x] 🟢 **推文内容提取**：Content Script 使用 MutationObserver 监听 DOM，提取推文文本、作者、互动数据。
- [x] 🟢 **手动生成交互**：用户点击"Insight"按钮 → Background → Go API → LLM → 返回结果。
- [x] 🟢 **结果呈现与复制**：展示备选评论，支持一键复制操作。

### Epic 3: 评论生成引擎（基础版）
- [x] 🟢 **基础 Prompt 工程**：实现单条评论生成（支持策略与身份参数传入）。
- [ ] ⚪ **多策略批量生成**：一次生成 5 种策略（认知升级型、反向观点型、数据补充型、共鸣型、创始人经验型）× 2 条备选。
- [ ] ⚪ **Prompt 深度优化**：引入 Hook+Position+Insight+Brevity 结构公式、Few-shot 示例、语言控制、Token 消耗追踪。
- [ ] ⚪ **Prompt 模板化管理**：建立 `prompts/` 目录，每个策略独立模板文件。

### Epic 4: 高可用后台监控系统 (Nitter Scraping)
- [x] ✅ **监控规则配置**：提供 API 允许用户录入核心监控关键词与目标账号。
- [x] ✅ **高可用采集引擎 (Scraper)**：基于 `goquery` 解析自建 Nitter (`https://x.beenglish.eu.org/`) 的 DOM 获取数据。
- [x] ✅ **防封禁反风控 (Anti-Ban)**：实现请求抖动 (Jitter)、User-Agent 轮换与隔离会话 (Session Isolation)。
- [x] ✅ **熔断降级机制 (Circuit Breaker)**：在 Nitter 被限流报 429/503 时自动暂停抓取，触发指数退避 (Exponential Backoff)。

### Epic 11: 工程基础设施加固 *(新增)*
- [x] ✅ **JWT 认证中间件**：为 `/api/v1` 路由添加 Bearer Token 认证，绑定用户身份。
- [x] ✅ **Rate Limiting**：按用户 subscription_tier 分级限流（Free: 10次/天, Pro: 无限）。
- [x] ✅ **CORS 配置**：添加 `go-chi/cors` 中间件，白名单 Chrome 扩展 Origin。
- [x] ✅ **Multi-LLM 路由与韧性设计**：支持 OpenAI / Anthropic / DeepSeek / Gemini 多模型动态路由，为调用添加 Timeout（30s）、Circuit Breaker（`sony/gobreaker`）、指数退避重试。
- [x] ✅ **Graceful Shutdown**：使用 `signal.NotifyContext` 实现平滑关停。
- [x] ✅ **健康检查**：添加 `/health` 端点 + Docker healthcheck。
- [x] ✅ **DB Migration 机制**：引入 `golang-migrate/migrate`，建立 `migrations/` 目录。
- [x] ✅ **单元测试骨架**：覆盖 Handler/Service 层核心路径 + CI 自动运行测试。
- [x] ✅ **环境变量规范化**：API 地址、LLM Provider 等全部走环境变量或配置文件。

### Epic 12: 用户体验与功能完善 *(新增 — 来自产品评审)*
- [x] ✅ **多条备选评论 (P0)**：单次返回 3 种策略 × 1 条 = 3 条备选，Sidebar 改为卡片列表式展示；记录用户策略偏好。
- [x] ✅ **用户 Onboarding 流程 (P0)**：首次使用 3 步引导 → 身份标签 / 偏好语言 / 风格倾向 → 存入 `chrome.storage.sync` + 后端用户表。
- [x] ✅ **前端热度标签 (P1)**：Content Script 基于 DOM 互动数注入 🔥 Trending / ⚡ Rising 徽章，帮用户判断评论时机。
- [x] ✅ **评论历史 Tab (P1)**：扩展 Popup 新增 History Tab，本地存储最近 50 条记录，支持搜索和策略筛选。
- [x] ✅ **Quote Tweet 生成 (P1)**：新增第 6 种策略「引用评论型」，生成可独立发帖的引用转发内容。
- [x] ✅ **错误边界与离线处理**：API 失败时显示重试按钮 + 明确错误提示，后端不可达时给出离线提示。

### Epic 15: 用户可配置系统 *(新增 — 可扩展性设计)*
> 所有与用户场景相关的能力均通过用户自定义设置实现，系统不硬编码任何特定产品/领域/策略，确保可扩展性。
- [x] ✅ **产品档案 (Product Profile)**：用户可配置产品名、领域、功能、竞品、相关关键词等；系统自动注入 Prompt 上下文。
- [x] ✅ **自定义策略模板 (Custom Strategies)**：除内置 5 种策略外，用户可创建私有策略（含 Prompt 模板 + Few-shot 示例）；前端 Sidebar 动态合并展示。
- [x] ✅ **竞品监控 (Competitor Monitoring)**：用户添加竞品品牌名/X 账号，雷达自动监控竞品讨论推文。
- [x] ✅ **推文相关性评分 (Relevance Scoring)**：Content Script 基于产品档案中的 `relevance_keywords` 做前端轻量匹配，高相关推文旁标注 🎯 标签。
- [x] ✅ **Profile 优化提醒**：用户复制评论后弹出 Tip，提醒确保 X Bio 和 Pin Tweet 包含产品信息。

---

## 🚀 第二阶段：自动化与雷达引擎（进阶版）
**核心目标**：实现对账号的定点监控、推文的热度初步计算，并让评论策略更完善。

### Epic 5: 账号与组合监控
- [x] ✅ **账号监控功能**：实现对重点账号的定点监控配置（支持实时抓取）。
- [x] ✅ **多规则组合过滤**：支持指定账号 + 关键词、AND/OR 多条件的交叉过滤搜索 API。

### Epic 6: 数据飞轮与快照引擎 (Data Flywheel)
- [x] ✅ **快照入库 (UPSERT 逻辑)**：抓取的推文以 `x_tweet_id` 为唯一键存入 `tweets` 表，更新转评赞数据。
- [x] ✅ **动态热度算法 (Heat Score)**：计算两次抓取的增量（Delta Likes/Retweets/Replies），运用公式计算当前热度分 `heat_score`。
- [x] ✅ **动态智能抓取频率 (Smart Crawling)**：热度飙升的推文升至 `high` 队列，长时间沉默推文降级至 `low` 队列。
- [x] ✅ **高潜商机面板 (Hot Opportunities)**：提供 `GET /tweets/hot` 并在插件内实现商机大赏面板。

### Epic 7: 独立 Web 管理控制台 (SaaS 面板)
- [x] ✅ **基础设施 (P2)**：使用 Vue 3 (或 React) + Vite 搭建独立的管理页面，支持账号密码与 JWT 独立登录体系。
- [x] ✅ **Web 界面开发**：Vite / Vue 3 前端框架搭建完整数据看板，暗黑玻璃态美学 UI (Dashboard / Radar / History)。
- [x] ✅ **策略与历史接入**：实现了 /api/v1/replies 分析回溯接口，与监控拦截热点推文分发墙 (Pinterest Layout)。

### Epic 13: 性能数据追踪与个人风格学习 (AI Style Engine)
- [x] ✅ **动作埋点与入库**：前端点击“Copy”时，POST `/api/v1/replies/record` 存入 `generated_replies`。若为野生帖子，则静默补全伪造的关联 `Tweet` 防止外键错误。
- [x] ✅ **性能回查 Worker**：新增 `PerformanceWorker`，独立线程每 30 分钟轮询 24 小时前已拷贝但未检验成效的回复。通过 Nitter `/i/status/id` 结构爬取目标原帖楼层并使用字符串相似度算法寻找目标回复并采集点赞量。
- [x] ✅ **自动 AI 风格反推**：点赞突增 > 10 的神级评论，将会独立喂入 OpenAI / Anthropic，提取指令（Tone/Structure/Jargon），固化至 `user_style_profiles.tone_preference` 供给日后的推文任务强制学习。注入风格画像。
- [ ] ⚪ **评论时机智能提醒 (P3)**：后端监控到高潜推文时，通过 Chrome Notification 推送 → 点击跳转 → Sidebar 预加载备选评论。

---

## 💎 第三阶段：商业化闭环与数据优化（完全体）
**核心目标**：验证效果以形成数据反馈，推出付费订阅，强化护城河。

### Epic 8: 商业化支付与权限系统
- [ ] ⚪ **支付系统接入**：集成 Stripe 等主流订阅支付平台。
- [ ] ⚪ **多级版本控制**：根据 Free/Pro/Premium 版本，对"生成次数限制""监控关键词上限""账号数量"进行鉴权与隔离。

### Epic 9: 评论效果数据反馈（V2）
- [ ] ⚪ **社交数据回拨检测**：定期查询用户发布评论后的真实点赞、回复数据。
- [ ] ⚪ **用户表现看板**：在 Web 后台提供"最有效互动风格""最佳发帖时间"的数据可视化分析图表。

### Epic 10: AI 模型个性化学习
- [ ] ⚪ **风格反馈微调**：针对高频点赞的回复风格，优化该用户的专属 Prompt。
- [ ] ⚪ **长期资产构建**：落地行业趋势资料包与垂直知识库，辅以 RAG 技术提高生成内容的深度。

### Epic 14: 增长与传播引擎 *(新增)*
- [ ] ⚪ **效果排行 & 成就系统**：每周评论表现报告 + 成就徽章（Viral Reply、Growth Streak 等）。
- [ ] ⚪ **社交裂变入口**：Free 版评论卡片底部 "Generated by InsightReply" 水印（Pro 可去除）+ 评论表现分享图。
