Skip to content

BRIEF.md

Latest commit

 

History

History
48 lines (34 loc) · 2.26 KB

BRIEF.md

File metadata and controls

48 lines (34 loc) · 2.26 KB
Raw

MarketPulse（超短同事版）

这是一个“选标的 + 看K线 + AI投研摘要 + ML涨跌概率”的本地小应用。

你需要知道的三件事

  1. 它是三段式结构

    • frontend/：网页界面（你在浏览器里看到的一切）
    • backend/market_service/：行情与K线接口（给前端的图表用）
    • backend/llm_service/：联网检索 + LLM流式分析（给前端的“AI分析”用）

  2. 启动后会占用 3 个端口

    • 前端：http://localhost:5173/
    • 行情服务：http://localhost:8002/（FastAPI）
    • LLM服务：http://localhost:8001/（FastAPI）

  3. 数据是怎么流动的（最重要）

    • 你在前端选“资产/周期” → 前端请求 market_service → 返回K线 → 前端画图。
    • 你在前端选“资产” → 前端请求 llm_service 的流式接口 → llm_service 先联网搜索/抓取摘要，再把“联网信息”塞进提示词 → 调用 LLM → 把结果一段段推回前端。

一键启动（推荐）

在项目根目录双击：restart.bat

它会做两件事：

  • 先杀掉占用 5173/8001/8002 的进程（相当于“彻底重启”）
  • 再依次拉起前端 + 两个后端服务，并把日志写到 logs/

关键配置在哪里

  • backend/llm_service/.env
    • LLM_PROVIDER=dmx
    • DMX_BASE_URL=https://www.dmxapi.cn/v1
    • LLM_MODEL=gpt-5.2
    • OPENAI_API_KEY=...
  • backend/market_service/.env：行情/数据源相关配置（一般不用动）

你想找功能对应的代码（按“用户看到的功能”）

  • K线图（含 1500 根K线拉取/分页）：backend/market_service/app/providers/ + frontend/src/components/Chart.tsx
  • AI投研分析（流式输出）：backend/llm_service/app/api/v1/endpoints/llm.py + backend/llm_service/app/services/llm_service.py + frontend/src/components/Prediction.tsx
  • 联网检索（关键词/筛选/去官网入口页）：backend/llm_service/app/services/search_service.py

常见问题（非技术也能用）

  • 页面没反应：先双击 restart.bat 再打开 http://localhost:5173/
  • AI分析一直“searching/analyzing”：说明联网/目标站点慢或被拦；等一会儿或重启再试。
  • AI报 OPENAI_API_KEY 未配置：检查 backend/llm_service/.env。