AI股票分析师daily_stock_analysis与GitHub Actions自动化工作流

每天手动盯盘、翻新闻、看指标,是不是感觉像在打一份没有工资的苦力工?我猜很多朋友都有过这种体验:早上起来第一件事不是喝咖啡,而是打开几个股票APP,在红红绿绿的K线图里找感觉,在各种财经新闻里找线索,最后脑子一团乱麻,决策全凭直觉。

其实,这种重复性的信息收集和初步分析工作,完全可以交给机器。今天我就来聊聊,怎么把一个叫 daily_stock_analysis 的AI股票分析工具,和GitHub Actions这个免费的自动化平台结合起来,打造一个完全不用你操心的“24小时AI投研助理”。你不用买服务器,也不用一直开着电脑,它就能在云端自动运行,每天把分析报告准时推送到你的微信或者邮箱里。

听起来有点神奇?其实原理很简单,就是让代码在正确的时间自动执行。下面,我就手把手带你走一遍这个“解放双手”的流程。

1. 准备工作:认识你的新“助理”

在开始自动化之前,我们得先了解一下这位“AI助理”能干什么。daily_stock_analysis 是一个开源项目,它的核心思路是让AI大模型(比如Google的Gemini或者DeepSeek)来扮演分析师的角色。

它不像传统软件只给你冷冰冰的数字和图表。相反,它会做这几件事:

  • 综合研判:自动获取你关注股票的行情数据、技术指标,并结合全网搜索到的相关新闻。
  • 生成“人话”报告:用AI把上面那些信息消化一遍,生成像“缩量回踩支撑,建议观望”这样你能直接看懂的核心结论,而不是一堆MACD、RSI的代码。
  • 给出具体建议:它会模拟分析师的思路,给出“买入”、“观望”或“卖出”的信号,甚至附上参考的买入价、止损价。
  • 复盘大盘:顺便把当天市场整体情况,比如哪个板块涨得好,也给你总结出来。

而我们的目标,就是利用GitHub Actions,让这个过程每天自动发生,并把结果推给你。整个方案是零成本的,依赖的是GitHub提供的免费计算资源。

2. 第一步:把项目“搬”到你的仓库

我们不可能直接去改动别人的项目,所以第一步是“复制”一份到你自己名下。这叫做“Fork”。

  1. 打开 daily_stock_analysis 的项目页面(地址在相关的开源社区可以找到)。
  2. 找到页面右上角那个大大的 “Fork” 按钮,点击它。
  3. 稍等片刻,GitHub就会在你的账号下创建一个一模一样的副本。这样,你就能自由配置,而不会影响原项目了。

这一步就像你去书店买了一本参考书,现在这本书是你的了,你可以在上面写写画画。

3. 第二步:配置“助理”的工作指令

你的AI助理需要知道一些关键信息才能工作,比如分析哪几只股票、用哪个AI模型、把报告发到哪里。这些敏感信息(如API密钥)不能直接写在代码里,GitHub提供了一个叫 “Secrets” 的安全地方来存储它们。

在你的仓库页面,按照这个路径点击:“Settings” -> “Secrets and variables” -> “Actions”。

然后点击 “New repository secret” 来创建新的密钥。下面这几项是最核心的,你需要根据实际情况来配置:

3.1 告诉它分析谁 (STOCK_LIST)

这是必填项。你需要创建一个名为 STOCK_LIST 的Secret。 在值(Value)那一栏,填入你关注的股票代码,用英文逗号隔开。比如:

  • 600519 (贵州茅台)
  • hk00700 (腾讯控股,港股代码前加hk)
  • AAPL,TSLA (苹果和特斯拉,美股)

示例:STOCK_LIST 的值可以设为 600519,hk00700,AAPL,TSLA

3.2 为它选择一个“大脑” (AI模型)

AI助理需要一个“大脑”来思考,这里至少需要配置一组API密钥。

  • 方案A(推荐,免费):使用Google Gemini

    1. 去 Google AI Studio 申请一个免费的API密钥。
    2. 在Secrets里创建一个名为 GEMINI_API_KEY 的项,把申请到的密钥粘贴进去。
  • 方案B(备用):使用其他兼容OpenAI的模型(如DeepSeek、通义千问)

    1. 创建 OPENAI_API_KEY,填入对应平台的API密钥。
    2. (可选)创建 OPENAI_BASE_URL,填入API地址,例如DeepSeek的是 https://api.deepseek.com/v1。
    3. (可选)创建 OPENAI_MODEL,填入模型名,例如 deepseek-chat。

注意:GEMINI_API_KEY 和 OPENAI_API_KEY 至少提供一个。

3.3 告诉它把报告发到哪里 (通知渠道)

至少需要配置一个通知渠道,不然报告生成了你也不知道。

  • 企业微信:创建一个名为 WECHAT_WEBHOOK_URL 的Secret,值就是你从企业微信群机器人那里获取的Webhook地址。
  • 邮箱:比较通用。需要配置三个Secret:
    • EMAIL_SENDER: 你的发件邮箱(如 xxx@qq.com)。
    • EMAIL_PASSWORD: 邮箱的授权码(不是登录密码,需要在邮箱设置里申请)。
    • EMAIL_RECEIVERS: 收件邮箱,多个用逗号隔开(如 aaa@qq.com,bbb@163.com),不填默认发给自己。

其他如飞书(FEISHU_WEBHOOK_URL)、Telegram等配置方式类似,可以参考项目更详细的文档。

3.4 为它配备“资料员” (新闻搜索API - 可选但推荐)

为了让分析更有深度,助理需要能搜索最新新闻。Tavily是一个专门为AI优化的搜索API,有免费额度。

  1. 去Tavily官网注册并获取API密钥。
  2. 创建一个名为 TAVILY_API_KEYS 的Secret,把密钥填进去。

配置完这些Secrets,你的仓库看起来应该像下图这样,有了好几个秘密配置项,这就好比给AI助理配齐了工作证、大脑芯片和通讯设备。 (此处可想象一个示意图:GitHub仓库的Secrets设置页面,列表中有 STOCK_LIST, GEMINI_API_KEY, WECHAT_WEBHOOK_URL, TAVILY_API_KEYS 等项)

4. 第三步:启动自动化流水线

现在“助理”和“指令”都准备好了,我们需要启动自动化生产线——GitHub Actions工作流。

  1. 点击你仓库顶部的 “Actions” 标签页。
  2. 如果是第一次进入,GitHub可能会提示你需要启用工作流。点击绿色的按钮,同意启用Actions。
  3. 启用后,你就能看到一个名为 “每日股票分析” 的工作流。这就是项目作者已经写好的自动化脚本,它定义了何时运行、运行哪些步骤。

5. 第四步:第一次试运行

在正式让它每天自动干活之前,我们先手动触发一次,看看整个流程是否畅通。

  1. 在“Actions”页面,点击左侧的 “每日股票分析” 工作流。
  2. 点击右边蓝色的 “Run workflow” 按钮。
  3. 在下拉菜单中再次点击 “Run workflow”。

然后,GitHub就会开始执行这个任务。你可以点击正在运行的任务,查看实时日志。整个过程大概会持续几分钟,它会依次进行:安装Python环境、安装项目依赖、运行分析脚本、发送通知。

如果一切顺利,几分钟后,你的微信或者邮箱就会收到第一份AI生成的股票分析报告了!报告大概长这样:

** 决策仪表盘** 贵州茅台(600519) | 🟢 买入 缩量回踩MA5支撑,乖离率处于安全区间。 💰 参考:买入价 1800 | 止损价 1750 | 目标价 1900 多头排列 量能配合

** 大盘复盘** 上证指数 +0.85%,互联网服务板块领涨...

看到这个,是不是感觉有点意思了?这可不是简单的数据罗列,而是经过AI整合和解读的结论。

6. 第五步:理解与定制自动化规则

试运行成功,意味着自动化流水线已经通了。默认情况下,这个工作流被设置在每个工作日(周一到周五)的北京时间18:00自动触发。这个时间点选在A股收盘后,很适合做当日复盘。

如果你想修改这个时间,或者调整其他行为,需要去修改工作流定义文件。

  1. 在你仓库的代码根目录下,找到 .github/workflows/ 这个文件夹。
  2. 里面会有一个 daily_analysis.yml 或类似名字的文件,点击它。
  3. 找到 schedule 这一部分,它看起来像这样:
    schedule:
      - cron: '0 10 * * 1-5' # 北京时间 18:00 (UTC 10:00),周一到周五
    
  4. 你可以修改cron表达式来改变触发时间。比如改成 ‘0 2 * * 1-5’ 就是UTC时间凌晨2点,即北京时间上午10点运行。修改后提交文件,新的定时规则就会生效。

除了定时,这个工作流文件还定义了整个任务的运行环境、步骤顺序等。对于初学者,我不建议做太多修改,理解其存在即可。它的核心就是确保在一个干净的环境里,自动执行 python main.py 这个命令。

7. 可能遇到的问题与小技巧

第一次搭建,难免会遇到一些小坎儿。这里分享几个常见问题和解决办法:

  • 收不到通知:这是最常见的问题。99%的原因是你的Secrets没配对。

    • 检查步骤:务必回到Settings下的Secrets页面,逐项核对名称是否完全正确(注意大小写),值是否粘贴完整(前后没有多余空格)。
    • 企业微信/飞书:确保Webhook地址是从正确的群机器人那里复制的。
    • 邮箱:确保 EMAIL_PASSWORD 用的是“授权码”,而不是邮箱登录密码。QQ邮箱需要在设置里“生成授权码”。
  • 运行失败,日志报错:去Actions里点开失败的任务,仔细看红色错误信息。

    • 依赖安装失败:可能是网络问题,重跑一次试试。
    • API限额不足:如果你用的免费API(如Gemini),可能有调用频率限制。可以在Secrets里设置 ANALYSIS_DELAY 为 10,让它在分析每只股票之间等待10秒,避免触发限流。
  • 想分析更多股票或调整分析逻辑:

    • 修改 STOCK_LIST 这个Secret的值即可增减股票。
    • 如果想深度定制分析规则(比如修改技术指标参数),那就需要你具备一定的Python能力,去修改项目源码了。这就是Fork带来的另一个好处——完全的控制权。

8. 总结

走完上面这些步骤,你就拥有了一个完全自动化、零成本的AI股票分析助手。它最大的价值不是替你做出投资决策,而是把你从枯燥、重复、容易情绪化的信息苦力中解放出来。

它像一个不知疲倦的初级研究员,每天帮你完成扫描、整理、初筛的工作,把一份结构清晰、语言直白的简报放在你面前。你可以把节省下来的时间和精力,用于更深度的思考、策略验证,或者干脆好好享受生活。

技术服务于人,而不是让人成为技术的奴隶。daily_stock_analysis 加 GitHub Actions 这个组合,就是一个很好的例子。它用现有的、免费的工具,搭建了一个实用的自动化解决方案。如果你也对股票投资感兴趣,同时又受困于信息过载,不妨花上半小时,亲手搭建一个试试。当第一份报告自动推送到你手机上的那一刻,你会感受到那种“科技让生活更简单”的愉悦感。


获取更多AI镜像

想探索更多AI镜像和应用场景?访问 CSDN星图镜像广场,提供丰富的预置镜像,覆盖大模型推理、图像生成、视频生成、模型微调等多个领域,支持一键部署。

Logo

北京人形旗下天工造物具身智能开源社区,聚焦具身天工与慧思开物两大平台

更多推荐