Competitor Sentiment Hunter MVP

竞品舆情猎手是一个面向出海产品团队的评论舆情分析后台。MVP 实现了“监控任务创建 -> 评论浏览 -> 根因归因 -> 竞品对比 -> 迭代建议 -> 周报/告警/设置”的演示闭环。

技术栈

层	技术
Frontend	React + Vite + TypeScript + Tailwind CSS
Charts	Recharts
Icons	lucide-react
Backend	Python FastAPI
Database	SQLite + SQLAlchemy
AI Adapter	Rule analyzer + mock provider + GMI Cloud adapter placeholder

目录结构

backend/
  app/
    main.py              # FastAPI API entry
    models.py            # SQLAlchemy entities
    schemas.py           # Request schemas
    seed.py              # Demo seed data
    services/
      analysis.py        # Sentiment/root-cause/insight rules
      gmi_cloud.py       # GMI Cloud adapter placeholder
frontend/
  src/
    App.tsx              # App shell, navigation, data loading
    api.ts               # API client
    pages.tsx            # 10 MVP pages
    ui.tsx               # Shared UI components
    types.ts             # Shared frontend types

环境变量

后端复制 backend/.env.example 为 backend/.env：

DATABASE_URL=sqlite:///./reviewhunter.db
GMI_API_KEY=
GMI_BASE_URL=https://api.gmi-cloud.example/v1
GMI_MODEL=gmi-chat-mock

前端复制 frontend/.env.example 为 frontend/.env：

VITE_API_BASE_URL=http://127.0.0.1:8000

没有 GMI_API_KEY 时，系统自动使用稳定 mock AI provider。

安装依赖

后端：

cd "E:\dy\ReviewHunter Agent"
python -m venv backend\.venv
backend\.venv\Scripts\python -m pip install -r backend\requirements.txt

前端：

cd "E:\dy\ReviewHunter Agent\frontend"
npm install

启动

后端：

cd "E:\dy\ReviewHunter Agent\backend"
.\.venv\Scripts\python -m uvicorn app.main:app --host 127.0.0.1 --port 8000

前端：

cd "E:\dy\ReviewHunter Agent\frontend"
npm run dev -- --host 127.0.0.1 --port 5173

浏览器打开：

http://127.0.0.1:5173

构建与验证

cd "E:\dy\ReviewHunter Agent\frontend"
npm run build

后端启动后可验证：

Invoke-RestMethod http://127.0.0.1:8000/api/health
Invoke-RestMethod http://127.0.0.1:8000/api/dashboard

MVP 已实现页面

• Global Review Intelligence Dashboard
• Create Hunter Task
• Hunter Task Run Monitor
• Negative Review Explorer
• Root Cause Analysis Studio
• Competitor Complaint Benchmark
• AI-Generated Iteration Backlog
• Weekly Competitive Insight Report
• Issue Alert Detail
• Team Settings & Integrations

当前限制

• 评论采集与 AI 推理默认使用 seed data、规则分析和 mock provider。
• SQLite 适合本地演示，生产环境建议迁移 PostgreSQL 并补充迁移工具。
• 登录鉴权、租户隔离、权限审计尚未接入。
• 报告导出 MVP 阶段支持 JSON/Markdown，PDF/Slides 仅保留按钮入口。 ReviewHunter Agent 项目提交测试内容 ReviewHunter Agent 项目提交说明