📊 API 接口文档 - AI 投研助手

功能：获取股票基本信息

参数：code (必填) - 股票代码，如 000001.SZ

响应：{ code, name, industry, market, area, listDate, pe, pb, marketCap }

{
  "code": 1000,
  "data": {
    "code": "000001.SZ",
    "name": "平安银行",
    "industry": "银行",
    "pe": 5.23,
    "pb": 0.56
  }
}

功能：获取日K线数据

参数：code(必填), startDate(YYYY-MM-DD), endDate(YYYY-MM-DD), period(可选: day/week/month)

响应：K线数据数组 [ { tradeDate, open, close, high, low, volume, amount, pctChg } ]

功能：获取分时数据

参数：code(必填), date(必填，YYYY-MM-DD)

响应：[ { tickTime, price, volume, avgPrice } ]

功能：手动触发日K同步

参数：{ code?: string, date?: string } - 不传则同步全部自选股当日数据

响应：{ syncCount: number }

功能：手动触发分时同步

参数：{ code: string, date: string }

响应：{ syncCount: number }

功能：新闻分页列表

参数：{ page, size, keyword?, sourceId?, sentiment?, startDate?, endDate?, relatedCode? }

响应：分页列表，含 id, title, content, pubTime, sentiment, relatedCodes, sourceId, url

sentiment 字段：1=利好, 2=利空, 3=中性

功能：新闻来源列表

响应：[ { id, name, type, url, fetchInterval, isEnabled, lastFetchTime } ]

功能：新增新闻来源

参数：{ name: string, type: 'rss'|'api'|'crawler', url: string, fetchInterval?: number, isEnabled?: number }

功能：更新新闻来源

参数：{ id: number, name?, type?, url?, fetchInterval?, isEnabled? }

功能：删除新闻来源

参数：{ id: number }

功能：手动触发新闻抓取

参数：{ sourceId?: number } - 不传则抓取全部启用来源

响应：{ fetchedCount: number, sourceCount: number }

功能：手动触发情感分析

参数：{ limit?: number } - 默认20条

响应：{ analyzedCount: number }

功能：获取新闻详情

参数：id: number

功能：研报分页列表

参数：{ page, size, keyword?, institution?, relatedCode?, parseStatus? }

parseStatus：0=待解析, 1=解析中, 2=已完成, 3=失败

功能：上传研报 PDF

Content-Type：multipart/form-data

参数：file(必填), title?, relatedCode?, institution?

说明：上传后自动触发异步解析任务，前端可轮询 info 接口获取解析进度

功能：获取研报详情

参数：id: number

响应：{ id, title, institution, relatedCode, fileUrl, parseStatus, parseProgress, aiSummary, keyPoints, chunkCount }

功能：删除研报

参数：{ id: number }

说明：同时删除 PDF 文件和 PostgreSQL 中的向量分块

功能：RAG 知识库检索

参数：{ query: string(必填), topK?: number(默认5), relatedCode?: string }

响应：[ { content, similarity, reportId, chunkIndex, reportTitle } ]

说明：基于 pgvector 余弦相似度检索研报分块

{
  "code": 1000,
  "data": [
    {
      "content": "基于DCF模型，我们给予平安银行目标价15.8元...",
      "similarity": 0.85,
      "reportId": 12,
      "reportTitle": "平安银行2026年深度研究报告"
    }
  ]
}

功能：重建研报索引

参数：{ id: number }

说明：清除现有分块，重新触发解析任务

功能：获取队列状态

响应：{ waiting, active, completed, failed }