1 数据贯通、五段编排与可演示联调闭环

1 数据贯通、五段编排与可演示联调闭环阶段时间约 2026-03-262026-04-05项目FinAgentFastAPI 后端 React / Vite 前端A 股金融分析摘要本阶段我们把 FinAgent 从「能跑的分析原型」推进到可重复验证的数据链路、与投研流程对齐的五阶段编排骨架以及带登录鉴权的前后端联调体验数据侧统一接入 AkShare补齐 OHLCV、新闻、基本面与内幕交易等能力并配套真实拉取的 smoke 验证工程侧固定 venv 与启动路径、完成演示级 JWT 多用户与 Windows 一键启动产品侧完成首页品牌化改版并与单股分析、任务中心、报告等页面导航打通。整体上本阶段目标是把「数据 → 分析 → 报告 → 前端展示」跑通并便于验收与迭代而非一次性做完 LLM 多智能体全栈。一、阶段目标与主线叙事FinAgent 面向单股研究场景从行情与资讯出发输出结构化技术指标、新闻与情绪判断、可解释风险与可读报告。本阶段在任务书层面将主链路固定为五个阶段并借鉴开源框架TradingAgents的分层思想与常见投研顺序对齐analyst分析师收集材料并计算指标、抽取事件与情绪research_debate研究辩论多空观点对抗当前版本以规则/占位为主后续可接 LLM 多轮trader交易员形成交易意图与理由结构risk_review风险评审规则化风险等级与依据portfolio_manager组合经理汇总结论与报告落盘编排层在 analyst 阶段顺序拉取行情、新闻与扩展数据驱动技术指标与报告各章节研究辩论与交易等阶段在本阶段以可扩展骨架形式存在为后续智能化留接口。二、数据层AkShare 接入与工程化封装数据是本阶段的重心之一。团队以AkShare作为主路径A 股场景、接口丰富在data/providers中做统一封装避免「直接调一行 API」导致的列名差异、限流和版本变更问题。交付要点包括行情stock_provider标准化 OHLCVdate/open/high/low/close/volume供技术指标计算与报告使用多源兜底与重试缓解网络抖动。新闻news_provider东方财富个股新闻等来源的归一化、去重与日期过滤支持strict_mode等策略使输出更可控、可解释。扩展数据akshare_extras_provider财务基本面 / 报表与内幕交易、增减持返回值带status等减轻编排层分支负担。编排与契约orchestrator在 analyst 阶段纳入基本面与内幕交易report_generator与schemas.AnalysisReportJson增加fundamental_section、insider_section技术指标侧补充ATR(14)等使报告维度更完整。验证方式团队明确采用真实拉取的 smoke / 集成验证而非仅 mock提供可重复执行的脚本校验「能拉到数据 结构完整 可序列化为标准 JSON」。典型踩坑与修复内幕交易接口参数误用导致连接被重置按 AkShare 约定使用合法symbol再在本地按股票代码过滤。date/Timestamp/NaN导致 JSON 失败统一转为 ISO 字符串与null。「最新事件」取错按公告日等字段排序后再取latest并避免与列表首条重复展示。三、后端工程环境、启动路径与演示级鉴权在数据能力增长的同时本阶段同步夯实谁都能在本机跑起来的工程基础环境与文档统一使用项目内venv避免系统旧 Python 与numpy1.26不匹配、或 conda / 解释器混用README 强调cd backend后使用python -m uvicorn、python -m pip安装依赖。鉴权分析类接口在引入JWT后提供register/login/me用户落盘SQLitedata/auth/users.db。密码存储采用bcrypt配合摘要规避与旧版 passlib 的兼容问题。测试侧通过conftest覆盖get_current_user保证 pytest 无需真实 token。代码卫生修复包内错误导入如indicators中不应在backend/下引用backend.app保证在标准启动方式下无No module named app/backend。Windows 体验start-dev.bat使用cmd /k、pushd与稳妥的 echo / 引号处理避免编码与括号解析导致闪退实现「后端 前端 打开浏览器」的一键开发入口。四、前端联调契约与首页改版API 与页面分工前端采用React TypeScript Vite开发态通过代理将/api转发到后端与 FastAPI 的/api前缀一致。主要页面包括首页、单股分析、分析报告、任务中心analysisApi、tasksApi、historyApi等与后端路由逐一对齐——其中部分接口如历史列表仍为预留文档与实现差异已在组内标明避免联调时误判为「前端 bug」。首页本阶段 UI 亮点从简单文字卡片升级为Hero品牌 渐变遮罩背景、核心能力三卡、与后端思路一致的分析流水线说明、底部 CTA通过onNavigate与App的setActive统一导航避免双套路由状态。样式以home*前缀集中管理内联 SVG 控制体积并兼顾基础无障碍属性。已知限制包括 Hero 背景图依赖外网可后续改为public/静态资源以及首页仍可增强为「仪表盘」式实时摘要——留待下阶段。表单体验单股分析等处将分析日期改为input typedate状态仍为YYYY-MM-DD字符串与后端dateJSON 契约一致。界面截图本地开发环境127.0.0.1:5173登录 / 注册首页Hero、核心能力、分析流水线入口单股分析股票代码、分析日期、结果区与风险提示分析报告搜索、批量导出选项、报告列表历史列表依赖后端预留接口任务中心状态汇总与任务列表列表类接口未就绪时可能出现空数据或Not Found五、阶段成果与如何复现成果可概括为维度本阶段产出数据AkShare 多源封装 报告/schema 扩展 smoke 验证脚本编排五阶段任务书级链路 analyst 阶段数据与报告贯通工程venv/启动文档、JWT、批处理一键启动、测试依赖注入产品登录闭环、首页改版、分析与任务页与后端对齐复现路径根目录用 venv 安装requirements.txt。cd backend后启动uvicorn另开终端frontend下npm run dev或使用根目录start-dev.bat。六、小结与下阶段展望本阶段 FinAgent 在数据覆盖面、报告结构化、本机可演示联调三条线上同时推进数据层用 provider 封装消化 AkShare 的不确定性编排层用五阶段框架对齐投研叙事并为智能化留白工程与前端则保证验收与迭代成本可控。下一步可自然延伸到研究辩论与交易阶段的 LLM / LangGraph 深化、smoke 与 CI 退出码标准化、历史接口与首页「仪表盘」数据、以及部署环境下静态资源与无外网场景的适配。七、组员个人博客参考https://blog.csdn.net/2301_80139500https://blog.csdn.net/2301_80431247https://blog.csdn.net/2301_80202012https://blog.csdn.net/2301_81374824