历史报告详情会优先展示 AI 返回的原始「狙击点位」文本,避免区间价、条件说明等复杂内容在历史回看时被压缩成单个数字。

回测页现支持"次日验证 / 1 日窗口"视图,可按股票代码和分析日期范围查看当时 AI 预测、次日实际涨跌以及区间准确率;该视图基于历史分析记录与 1 日回测结果,不代表真实成交流水。

Web 工作台已完成一轮 UI 升级:新增完整浅色主题,并支持浅色 / 深色主题一键切换;首页、问股、回测、持仓、设置页改为共享同一套设计 token、输入表面、状态反馈和抽屉/滚动语义,日常使用与移动端浏览更连贯。

问股页进一步补强了消息复制、会话导出、通知发送、历史删除和追问上下文保护;首页与报告抽屉的复制反馈、空态和错误态也已按面板独立收口,减少误触和状态串扰。

Web 管理认证支持运行时开关;如果系统中已保留管理员密码,重新开启认证时必须提供当前密码,避免在认证关闭窗口内直接获取新的管理员会话。 多进程/多 worker 部署时,认证开关仅在当前进程即时生效;需重启或滚动重启全部 worker 以统一状态。

持仓管理补充说明:卖出录入现在会在写入前校验可用持仓,超售会直接拒绝;如果历史里误录了交易 / 资金流水 / 公司行为,可在 Web /portfolio 页的事件列表中直接删除后恢复快照。高并发写入场景下,直接持仓写接口可能返回 409 portfolio_busy,提示账本正在处理另一笔变更;CSV 导入仍保持逐条提交与部分成功语义。

长桥优先策略(仅美/港股):在配置 LONGBRIDGE_APP_KEY / LONGBRIDGE_APP_SECRET / LONGBRIDGE_ACCESS_TOKEN 的前提下,美股与港股的 日线 K 线 与 实时行情 由 Longbridge 优先拉取;若长桥失败或部分字段缺失,再由 YFinance(美股)/ AkShare(港股) 兜底或合并补全字段。未配置长桥凭据时不会调用 Longbridge,美股/港股仍以 YFinance / AkShare 为主数据源(与未集成长桥前的行为一致)。美股大盘指数(如 SPX)始终以 YFinance 优先(长桥不提供指数行情)。A 股路由不变,仍为 Efinance → AkShare → Tushare → Pytdx → Baostock。详见 .env.example 与 完整指南 中长桥说明。

5 分钟完成部署,零成本,无需服务器。

点击右上角 Fork 按钮(顺便点个 Star⭐ 支持一下)

Settings → Secrets and variables → Actions → New repository secret

AI 模型配置(至少配置一个)

详细配置说明见 LLM 配置指南(极简接入、渠道模式、高级 YAML 路由、Vision、Agent、排错)。默认推荐先选服务商并填写 API Key;需要多模型时再启用渠道模式;只有高级用户才需要 YAML 路由配置。

现在推荐把多模型配置统一写成 LLM_CHANNELS + LLM_<NAME>_PROTOCOL/BASE_URL/API_KEY/MODELS/ENABLED。如需显式指定主模型或备选模型,再额外配置 LITELLM_MODEL / LITELLM_FALLBACK_MODELS。Web 设置页和 .env 使用同一套字段,便于相互切换。

💡 推荐 AIHubMix :一个 Key 即可使用 Gemini、GPT、Claude、DeepSeek 等全球主流模型,无需科学上网,含免费模型(glm-5、gpt-4o-free 等),付费模型高稳定性无限并发。本项目可享 10% 充值优惠。

注:AI 优先级 Gemini > Anthropic > OpenAI(含 AIHubmix)> Ollama,至少配置一个。AIHUBMIX_KEY 无需配置 OPENAI_BASE_URL,系统自动适配。图片识别需 Vision 能力模型。DeepSeek 思考模式(deepseek-reasoner、deepseek-r1、qwq、deepseek-chat)按模型名自动识别,无需额外配置。Ollama 本地模型(无需 API Key)必须使用 OLLAMA_API_BASE,误用 OPENAI_BASE_URL 会导致 404。

其他配置

基本面超时语义(P0):

• 当前采用 best-effort 软超时(fail-open),超时会立即降级并继续主流程;
• 不承诺严格硬中断第三方调用线程,因此 P95 <= 1.5s 是阶段目标而非硬 SLA;
• 若业务需要硬 SLA,可在后续阶段升级为"子进程隔离 + kill"的硬超时方案。
• 字段契约:
  • fundamental_context.boards.data = sector_rankings(板块涨跌榜,结构 {top, bottom});
  • fundamental_context.earnings.data.financial_report = 财报摘要(报告期、营收、归母净利润、经营现金流、ROE);
  • fundamental_context.earnings.data.dividend = 分红指标(仅现金分红税前口径,含 events、ttm_cash_dividend_per_share、ttm_dividend_yield_pct);
  • get_stock_info.belong_boards = 个股所属板块列表;
  • get_stock_info.boards 为兼容别名,值与 belong_boards 相同(未来仅在大版本考虑移除);
  • get_stock_info.sector_rankings 与 fundamental_context.boards.data 保持一致。
• 配置 TICKFLOW_API_KEY 后,A 股大盘复盘的主要指数行情会优先尝试 TickFlow;若当前套餐支持标的池查询,市场涨跌统计也会优先尝试 TickFlow。失败或权限不足时会回退到现有数据源。
• 该行为按能力分层而非仅按"是否有 Key"判断:有限权限套餐仍可获得 TickFlow 指数增强;支持 CN_Equity_A 标的池查询的套餐会额外获得 TickFlow 市场统计增强。
• TickFlow 官方 quickstart 展示了 quotes.get(universes=["CN_Equity_A"]) 的正式用法,但真实线上验证确认:不同套餐权限不同,且 quotes.get(symbols=[...]) 单次有标的数量限制。
• TickFlow 返回的 change_pct / amplitude 在实际接口中为比例值,本项目已统一转换为内部使用的百分比口径,保证与 AkShare / Tushare / efinance 一致。
• 板块涨跌榜采用固定回退顺序:AkShare(EM->Sina) -> Tushare -> efinance。

Actions 标签 → I understand my workflows, go ahead and enable them

Actions → 每日股票分析 → Run workflow → Run workflow

默认每个**工作日 18:00(北京时间)**自动执行,也可手动触发。默认非交易日(含 A/H/US 节假日)不执行。

💡 关于跳过交易日检查的两种机制:

机制	配置方式	生效范围	适用场景
TRADING_DAY_CHECK_ENABLED=false	环境变量/Secrets	全局、长期有效	测试环境、长期关闭检查
force_run (UI 勾选)	Actions 手动触发时选择	单次运行	临时在非交易日执行一次

• 环境变量方式:在 .env 或 GitHub Secrets 中设置,影响所有运行方式(定时触发、手动触发、本地运行)
• UI 勾选方式:仅在 GitHub Actions 手动触发时可见,不影响定时任务,适合临时需求
• 断点续传与 --dry-run 的数据存在性判断:会按股票所属市场的本地时区和交易日历解析"最新可复用交易日";周末/节假日复用最近交易日,交易日盘中复用上一已完成交易日,盘后若当日数据已落库则可直接跳过。详细规则见 完整指南。

# 克隆项目
git clone https://github.com/ZhuLinsen/daily_stock_analysis.git && cd daily_stock_analysis
# 安装依赖
pip install -r requirements.txt
# 配置环境变量
cp .env.example .env && vim .env
# 运行分析
python main.py

如果你不用 Web,推荐直接在 .env 里按条写模型渠道:

LLM_CHANNELS=primary
LLM_PRIMARY_PROTOCOL=openai
LLM_PRIMARY_BASE_URL=https://api.deepseek.com/v1
LLM_PRIMARY_API_KEY=sk-xxxxxxxx
LLM_PRIMARY_MODELS=deepseek-chat
LITELLM_MODEL=openai/deepseek-chat

保存后也可以在 Web 设置页继续编辑同一组字段;不会要求额外配置文件。

如果同时启用了高级模型路由 YAML(LITELLM_CONFIG),YAML 主要用于定义可用模型和路由规则(model_list);运行时主模型 / 备选模型 / Vision / Temperature 仍由 LITELLM_MODEL、LITELLM_FALLBACK_MODELS、VISION_MODEL、LLM_TEMPERATURE 等字段决定。渠道编辑器只保存渠道条目,不会覆盖这些运行时字段的选择。

Docker 部署、定时任务配置请参考 完整指南 桌面客户端打包请参考 桌面端打包说明

🎯 2026年02月08日 决策仪表盘
共分析3只股票 | 🟢买入:0 🟡观望:2 🔴卖出:1
📊 分析结果摘要
⚪ 中钨高新(000657): 观望 | 评分 65 | 看多
⚪ 永鼎股份(600105): 观望 | 评分 48 | 震荡
🟡 新莱应材(300260): 卖出 | 评分 35 | 看空
⚪ 中钨高新 (000657)
📰 重要信息速览
💭 舆情情绪: 市场关注其AI属性与业绩高增长,情绪偏积极,但需消化短期获利盘和主力流出压力。
📊 业绩预期: 基于舆情信息,公司2025年前三季度业绩同比大幅增长,基本面强劲,为股价提供支撑。
🚨 风险警报:
风险点1:2月5日主力资金大幅净卖出3.63亿元,需警惕短期抛压。
风险点2:筹码集中度高达35.15%,表明筹码分散,拉升阻力可能较大。
风险点3:舆情中提及公司历史违规记录及重组相关风险提示,需保持关注。
✨ 利好催化:
利好1:公司被市场定位为AI服务器HDI核心供应商,受益于AI产业发展。
利好2:2025年前三季度扣非净利润同比暴涨407.52%,业绩表现强劲。
📢 最新动态: 【最新消息】舆情显示公司是AI PCB微钻领域龙头,深度绑定全球头部PCB/载板厂。2月5日主力资金净卖出3.63亿元,需关注后续资金流向。
---
生成时间: 18:00

🎯 2026年01月10日 大盘复盘
📊 主要指数
- 上证指数: 3250.12 (🟢+0.85%)
- 深证成指: 10521.36 (🟢+1.02%)
- 创业板指: 2156.78 (🟢+1.35%)
📈 市场概况
上涨: 3920 | 下跌: 1349 | 涨停: 155 | 跌停: 3
🔥 板块表现
领涨: 互联网服务、文化传媒、小金属
领跌: 保险、航空机场、光伏设备

📖 完整环境变量、定时任务配置请参考 完整配置指南 邮件通知当前基于 SMTP 授权码/基础认证;若 Outlook / Exchange 账号或租户强制 OAuth2,当前版本暂不支持。

img.png

包含完整的配置管理、任务监控和手动分析功能。

本轮界面升级亮点:

• 全新浅色主题:不再只是深色工作台,浅色模式针对输入框、卡片层级、边界对比、状态提示做了成套重绘。
• 主题切换可持久化:侧边栏内可随时切换浅色 / 深色主题,页面刷新后仍保留用户选择。
• 核心页面统一收口:首页、问股、回测、持仓、设置共用同一套视觉 token、状态原语和表面组件,减少"每页一个风格"的割裂感。
• 移动端与触屏体验增强:抽屉遮罩、滚动契约、消息操作可达性和关键按钮语义同步补强,小屏设备上更稳定。

可选密码保护:在 .env 中设置 ADMIN_AUTH_ENABLED=true 可启用 Web 登录,首次访问在网页设置初始密码,保护 Settings 中的 API 密钥等敏感配置。系统设置现支持运行时开启或关闭认证;关闭认证不会删除已保存密码,后续可直接重新启用。认证开启时,POST /api/v1/auth/logout 也需要有效会话;如果会话已经过期,前端会直接回到登录页。详见 完整指南。

在 设置 → 基础设置 中找到「智能导入」区块,支持三种方式添加自选股:

1. 图片:拖拽或选择自选股截图(如 APP 持仓页、行情列表),Vision AI 自动识别代码+名称,并给出置信度
2. 文件:上传 CSV 或 Excel (.xlsx),自动解析代码/名称列
3. 粘贴:从 Excel 或表格复制后粘贴,点击「解析」即可

预览与合并:高置信度默认勾选,中/低置信度需手动勾选;支持按代码去重、清空、全选;仅合并已勾选且解析成功的项。

配置与限制:

• 图片需配置 Vision API(GEMINI_API_KEY、ANTHROPIC_API_KEY 或 OPENAI_API_KEY 至少一个)
• 图片:JPG/PNG/WebP/GIF,≤5MB;文件:≤2MB;粘贴文本:≤100KB

API:POST /api/v1/stocks/extract-from-image(图片)、POST /api/v1/stocks/parse-import(文件/粘贴)。详见 完整指南。

首页分析输入框已升级为"类搜索引擎"补全框,显著降低记忆负担:

• 多维匹配:支持输入股票代码、中文名、拼音缩写或别名(如 gzmt -> 贵州茅台、tencent -> 腾讯控股、aapl -> Apple Inc.)。
• 多市场覆盖:本地索引已覆盖 A股、港股、美股 三个市场;通过 Tushare 或 AkShare 数据源生成,支持按需更新索引。
• 自动降级逻辑:
  • 新股/异常:若索引未及时更新或加载失败,系统将无缝退回普通输入模式,确保分析链路 100% 可用。
  • 未命中:搜索未命中时,用户直接按回车即可走原有手动输入流程,完全不影响分析。

💡 索引更新提示:如需更新索引数据,可通过 scripts/fetch_tushare_stock_list.py 获取最新股票列表,再运行 scripts/generate_index_from_csv.py 重新生成索引文件。详见 Tushare 股票列表获取工具使用说明。

LLM 用量查询:GET /api/v1/usage/summary?period=today|month|all,返回按调用类型和模型分组的 token 消耗汇总(total_calls、total_tokens、by_call_type、by_model)。

分析 API 说明:POST /api/v1/analysis/analyze 在 async_mode=false 时仅支持单只股票;批量 stock_codes 需要 async_mode=true。异步 202 响应对单股返回 task_id,对批量返回 accepted / duplicates 汇总结构;空白股票代码会在服务端过滤,若过滤后为空则返回 400。未知 /api 路径(含 /api 本身)返回 JSON 404,不再回退到前端页面。详见 API 规范。

在首页历史记录中选择一条分析记录后,点击「完整分析报告」按钮可在右侧抽屉中查看与推送通知格式一致的完整 Markdown 分析报告,包含舆情情报、核心结论、数据透视、作战计划等完整内容。

报告头部提供两种复制方式:

• 「复制 Markdown 源码」:保留原始 Markdown 结构,适合二次编辑、技术社区分享和笔记归档。
• 「复制纯文本」:去除常见 Markdown 格式符号,适合微信、群聊等纯文本分享场景。

在 .env 中设置 AGENT_MODE=true 后启动服务,访问 /chat 页面即可开始多轮策略问答。

对用户侧文案,本项目仍以"策略"为主称呼;代码、配置和 API 主字段统一使用 skill,可理解为"可复用的策略能力包"。

• 选择策略:均线金叉、缠论、波浪理论、多头趋势等 11 种内置策略
• 自然语言提问:如「用缠论分析 600519」,Agent 自动调用实时行情、K线、技术指标、新闻等工具
• 流式进度反馈:实时展示 AI 思考路径(行情获取 → 技术分析 → 新闻搜索 → 生成结论)
• 多轮对话:支持追问上下文,会话历史持久化保存
• 导出与发送:可将会话导出为 .md 文件,或发送到已配置的通知渠道,并提供明确的成功/失败反馈
• 后台执行:切换页面不中断分析,完成时 Dock 问股图标显示角标
• Bot 命令:/ask 技能分析(支持多股对比)、/chat 自由对话、/history 会话历史、/strategies 策略/技能列表、/research 深度研究
• 自定义策略(Skill):在 strategies/ 目录下新建 YAML 文件或在自定义 skill 目录中放入 SKILL.md bundle,即可添加新的交易策略,无需写代码
• 多 Agent 架构(实验性):设置 AGENT_ARCH=multi 启用 Technical → Intel → Risk → Specialist → Decision 多 Agent 级联编排,通过 AGENT_ORCHESTRATOR_MODE 控制深度(quick/standard/full/specialist)。其中 strategy / skill 仍作为旧值兼容并会自动归一化到 specialist。超时或中间阶段 JSON 解析失败时,系统会优先保留已完成阶段结果并降级生成最小可用仪表盘,避免整份报告直接退回默认占位。详见 完整配置指南
• Intel 增强字段兼容说明:capital_flow_signal 为新增扩展字段(inflow/outflow/neutral/not_available),用于描述 A 股资金流方向,未返回时不会影响后续阶段;下游解析建议以 risk_alerts 与 positive_catalysts 为主,新增字段可忽略,兼容历史客户端。

注意:配置了任意 AI API Key 后,Agent 对话功能自动可用,无需手动设置 AGENT_MODE=true。如需显式关闭可设置 AGENT_MODE=false。每次对话会产生 LLM API 调用费用。若你手动修改了 .env 中的主模型 / Agent 主模型 / 备选模型 / 模型渠道配置(如 LITELLM_MODEL / AGENT_LITELLM_MODEL / LITELLM_FALLBACK_MODELS / LLM_CHANNELS),需要重启服务或触发配置重载后,新进程才会按新模型生效。

1. 启动服务(默认会自动编译前端)

   python main.py --webui # 启动 Web 界面 + 执行定时分析
   python main.py --webui-only # 仅启动 Web 界面

   启动时会在 apps/dsa-web 自动执行 npm install && npm run build。 如需关闭自动构建,设置 WEBUI_AUTO_BUILD=false,并改为手动执行:

   cd ./apps/dsa-web
   npm install && npm run build
   cd ../..

访问 http://127.0.0.1:8000 即可使用。

在云服务器上部署后,不知道浏览器该输入什么地址?请看 云服务器 Web 界面访问指南。

也可以使用 python main.py --serve (等效命令)

查看已支持的功能和未来规划:更新日志

有建议?欢迎 提交 Issue

⚠️ UI 调整提示:项目当前正在持续进行 Web UI 调整与升级,部分页面在过渡阶段可能仍存在样式、交互或兼容性问题。欢迎通过 Issue 反馈问题,或直接提交 Pull Request 一起完善。

如果本项目对你有帮助,欢迎支持项目的持续维护与迭代,感谢支持 🙏
赞赏可备注联系方式,祝股市长虹

欢迎提交 Issue 和 Pull Request!

详见 贡献指南

pip install -r requirements.txt
pip install flake8 pytest
./scripts/ci_gate.sh

如修改前端(apps/dsa-web):

cd apps/dsa-web
npm ci
npm run lint
npm run build

MIT License © 2026 ZhuLinsen

如果你在项目中使用或基于本项目进行二次开发, 非常欢迎在 README 或文档中注明来源并附上本仓库链接。 这将有助于项目的持续维护和社区发展。

• GitHub Issues:提交 Issue
• 合作邮箱:zhuls345@gmail.com

如果觉得有用,请给个 ⭐ Star 支持一下!

本项目仅供学习和研究使用,不构成任何投资建议。股市有风险,投资需谨慎。作者不对使用本项目产生的任何损失负责。