当前位置：首页 > news >正文

FinAgent 本周进度记录｜本机 LLM 联调、任务中心/历史、按用户隔离与单股日期约束

news 2026/6/2 7:47:49

日期：2026-04-12
项目：FinAgent（FastAPI 后端 + React/Vite 前端）

1. 摘要

今日工作集中在本机 Ollama 与 LangChain 调用出现 502 的根因修复、单股分析异步入队与任务中心/报告中心历史接口闭环、历史列表按用户隔离与真实删除落盘、任务状态中文展示，以及单股分析日期默认当天且禁止选择未来日的前端约束。配套补充了GET /api/history按当前用户过滤、DELETE /api/analysis/tasks/{task_id}删除状态与报告文件、以及若干 pytest 用例。

2. 背景与目标

本机已启动 Ollama 且已拉取模型时，分析师子图仍报「LLM 调度失败…502」：需区分误走公网 OpenAI与httpx 走系统代理导致本机 11434 异常。
单股分析创建后应进入任务中心，未完成显示进行中，结束后已完成/失败；任务中心与报告中心依赖/api/history，且每次进入页面重新拉取。
报告列表删除应删除磁盘上的 state/report，刷新后不再出现；历史任务仅展示当前登录用户创建的分析。
界面状态展示使用中文（如「进行中」「已完成」），与后端英文枚举并存。
单股分析分析日期默认当天，且不可选当天之后的日期。

3. 交付物与变更清单

3.1 后端：LLM 工厂与本机 Ollama

文件/模块	说明
`backend/app/core/config.py`	`explicit_llm_base_url_from_env()`、`auto_local_ollama_when_no_base()`（`FINAGENT_AUTO_LOCAL_OLLAMA`，默认开启）；`llm_base_url()`语义保持
`backend/app/core/llm.py`	未显式配置 base URL 时优先探测本机 Ollama，避免仅因环境变量存在`OPENAI_API_KEY`就固定请求`api.openai.com`；`11434`路径自动补`/v1`；对 Ollama 使用`httpx.Client/AsyncClient(trust_env=False)`，规避 Windows 系统代理把`127.0.0.1`流量导向代理导致502

3.2 后端：异步任务、历史、鉴权与删除

文件/模块	说明
`backend/app/api/routes/analysis.py`	`POST /api/analysis/tasks`：先落盘 running + user_id，`BackgroundTasks`异步执行`execute_analysis_langgraph_task(..., preseeded=True)`；`GET`报告/状态/结果前`_assert_task_owned`；`DELETE /api/analysis/tasks/{task_id}`：校验归属后`delete_task_files`；`POST /api/analysis`传入`owner_user_id`
`backend/app/workflows/langgraph/runner.py`	`execute_analysis_langgraph_task`支持preseeded、owner_user_id；成功/失败落盘均携带user_id；异常路径failed不写报告文件
`backend/app/workflows/analysis_workflow.py`	`run_analysis_workflow(..., owner_user_id=...)`透传
`backend/app/repositories/history_repository.py`	`list_analysis_history(user_id=...)`：仅`payload.user_id`与当前用户一致的任务；无`user_id`的旧文件不入列表
`backend/app/api/routes/history.py`	`GET /api/history`传入`user.id`
`backend/app/services/storage.py`	`delete_task_artifacts(task_id)`：删除`mvp_tasks`与`langgraph_states`下同 id 文件
`backend/app/repositories/task_repository.py`	`delete_task_files`封装
`backend/app/models/schemas.py`	`AnalysisTaskState.user_id`；`TaskHistoryItem`等保持与前端契约一致

3.3 前端：任务流、历史、展示与日期

文件	说明
`frontend/src/services/tasksApi.ts`	`getTaskState`、`waitForTerminalTaskStatus`（含`onStatus`回调）供单股页轮询
`frontend/src/pages/SingleStockAnalysisPage.tsx`	创建任务后轮询至终态再取结果；状态 pill 使用`taskStatusToLabel`；`localTodayISO`/`localDateISO`默认当天、`max`与 onChange 钳位禁止未来日
`frontend/src/App.tsx`	任务中心/分析报告页条件挂载，每次进入重新请求历史
`frontend/src/pages/ReportPage.tsx`	进入时`loadReports`；`deleteTask`调后端删除；列表状态中文；仅succeeded可查看/下载/批量导出
`frontend/src/pages/TaskCenterPage.tsx`	状态中文；筛选下拉的展示文案中文化（value 仍为英文）
`frontend/src/services/historyApi.ts`	`deleteTask`→`DELETE /api/analysis/tasks/...`
`frontend/src/utils/taskStatus.ts`	`taskStatusToLabel`、`TASK_STATUS_FILTER_OPTIONS`

3.4 测试

文件	说明
`backend/tests/test_mvp_api.py`	异步任务返回running后后台 mock 成功、failed 无报告结果、`GET /api/history`mock、`DELETE`调用删除封装；各 mock state 补充`user_id: 1`与鉴权路径一致

4. 踩坑与结论（简表）

现象	原因	处理
Ollama 可用仍502（urllib 探测正常）	全局`OPENAI_API_KEY`存在且未配 base URL 时请求打到公网；或httpx`trust_env=True`走系统代理，本机流量经代理返回 502	未显式 base 时优先本机 Ollama；Ollama 端口使用`trust_env=False`的 httpx 客户端
任务中心刷新后删除项仍在	前端仅本地`filter`，未删落盘	实现`DELETE /api/analysis/tasks/{task_id}`并删除state + report两个 JSON
用户 A 看到用户 B 的历史	历史扫描全目录	state 写入`user_id`，`list_analysis_history`按用户过滤；读接口`_assert_task_owned`
无`user_id`的旧任务出现在列表	历史无法归因	跳过无`user_id`的落盘（需重新跑分析或手工补字段才能纳入本人历史）
分析日期需约束为「不晚于今天」	硬编码演示日期易误导	`input type="date"`的`max`+ onChange/`payload`钳位，默认`localTodayISO()`

5. 涉及路径速查

FinAgent/ ├─ backend/app/core/llm.py ├─ backend/app/core/config.py ├─ backend/app/api/routes/analysis.py ├─ backend/app/api/routes/history.py ├─ backend/app/repositories/history_repository.py ├─ backend/app/repositories/task_repository.py ├─ backend/app/services/storage.py ├─ backend/app/workflows/langgraph/runner.py ├─ backend/app/workflows/analysis_workflow.py ├─ backend/app/models/schemas.py ├─ backend/tests/test_mvp_api.py ├─ frontend/src/pages/SingleStockAnalysisPage.tsx ├─ frontend/src/pages/TaskCenterPage.tsx ├─ frontend/src/pages/ReportPage.tsx ├─ frontend/src/App.tsx ├─ frontend/src/services/tasksApi.ts ├─ frontend/src/services/historyApi.ts ├─ frontend/src/utils/taskStatus.ts └─ docs/weekly-cjw/report2.md # 本文

6. 验证建议（可复现）

本机 LLM：不设FINAGENT_OPENAI_BASE_URL、仅本机 Ollama 时启动单股分析，确认不再稳定出现502；若需强制公网，设FINAGENT_AUTO_LOCAL_OLLAMA=0并显式配置 base URL。
任务流：登录后发起单股分析 → 任务中心可见进行中→ 完成后为已完成；切换侧栏「任务中心/分析报告」应重新请求/api/history。
删除：报告列表点删除 → 刷新页面，该项应不再出现；对应data/processed/langgraph_states/{task_id}.json与mvp_tasks/{task_id}.json应已删除。
用户隔离：换账号登录，应看不到上一账号任务（新创建任务均带user_id）。
分析日期：打开单股分析，日期默认为当天；日期控件无法选择未来日。