ai-finance

AI Finance 是一个基于 GitHub Actions、7×24 小时自动运行的市场分析与监控系统。README 明确说明其仅用于模拟与分析，禁止自动交易，实际投资决策需由用户自行判断。产出通过 GitHub Pages 仪表盘和 Telegram 实时通知交付。 核心功能分为多个领域。市场分析每4小时从 HMM 市场状态、情绪和投资组合角度，分析 7 个板块的 22 只以上股票。紧急新闻每小时监控 7 个 RSS 源和 6 类关键词。海外市场在 KOSPI 休市时段每小时追踪 13 个全球指数与期货。日本危机监控于每日 09:30、22:00 追踪日元套利交易平仓压力与 BOJ 加息。比特币本位监控于每日 09:00、22:00 处理 ETF 资金流、挖矿和 ARMA 法案相关动态。 价值分析系列也包含在内。低估值筛选器每日 06:00 计算 KOSPI 47 只股票的价值评分与 WATCHLIST，并采用相对 KOSPI 平均值的相对估值。价值受损监控关注的不是股价，而是基本面（EPS、BPS、盈利能力）受损。DCF 合理价格评估 15 只大盘股的现金流，季度财报回顾基于 DART API 开展盈利分析。AutoResearch 每日和每月进行价值权重演进与 Forward Test 评估。 安装与运行按以下顺序说明：克隆仓库、安装 requirements.txt、配置 Telegram Bot Token 和 Chat ID 以及 DART API 密钥、运行本地测试脚本、通过 GitHub push 自动执行工作流。项目结构由 core 工具（环境变量加载器、Telegram、yfinance 封装、状态存储）、docs（GitHub Pages 输出）、config（板块定义）、.github/workflows（11 个工作流）、tests 以及各类监控与分析脚本组成。 自动化由 11 个工作流运行：Daily Finance Analysis（4小时）、Breaking News Monitor（1小时）、Overseas Market Monitor（KOSPI 休市时每小时）、Japan Crisis Monitor、Bitcoin Standard Monitor、Value Screener（每日06:00）、Auto-Research Value（07:00）、Auto-Research Portfolio（03:00）、DCF Valuator（07:30）、Earnings Reviewer（09:00）、Forward Test Eval（每月1日08:00）。 安全方面说明包括：将 API 密钥存储在 GitHub Secrets 中，禁止提交 config/.env；使用 defusedxml 防御 XXE 攻击；外部调用使用 HTTPS；通过工作流并发控制防止竞态条件；调用 subprocess 时使用 list args。还提供威胁模型文档和回归测试。许可与免责声明强调其仅用于个人学习与分析。