[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-2299":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":5,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":12,"contributorsCount":13,"subscribersCount":13,"size":13,"stars1d":13,"stars7d":13,"stars30d":13,"stars90d":13,"forks30d":13,"starsTrendScore":13,"compositeScore":14,"rankGlobal":8,"rankLanguage":8,"license":15,"archived":16,"fork":16,"defaultBranch":17,"hasWiki":18,"hasPages":16,"topics":19,"createdAt":8,"pushedAt":8,"updatedAt":20,"readmeContent":21,"aiSummary":22,"trendingCount":13,"starSnapshotCount":13,"syncStatus":23,"lastSyncTime":24,"discoverSource":25},2299,"FinAgent","helloJamest\u002FFinAgent","helloJamest",null,"Python",101,11,1,0,3.24,"MIT License",false,"main",true,[],"2026-06-12 02:00:40","\u003Cdiv align=\"center\">\n\n# 📈 FinAgent\n\n[![CI](https:\u002F\u002Fgithub.com\u002FhelloJamest\u002FFinAgent\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002FhelloJamest\u002FFinAgent\u002Factions\u002Fworkflows\u002Fci.yml)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n[![Python 3.10+](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fpython-3.10+-blue.svg)](https:\u002F\u002Fwww.python.org\u002Fdownloads\u002F)\n[![GitHub Actions](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FGitHub%20Actions-Ready-2088FF?logo=github-actions&logoColor=white)](https:\u002F\u002Fgithub.com\u002Ffeatures\u002Factions)\n[![Docker](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDocker-Ready-2496ED?logo=docker&logoColor=white)](https:\u002F\u002Fhub.docker.com\u002F)\n\n\n**面向 A 股 \u002F 港股 \u002F 美股的智能决策系统**\n\n多智能体博弈 · 情节记忆 · 自我反思 · 领域增强工具链\n\n[**快速开始**](#-快速开始) · [**核心能力**](#-核心能力) · [**WebUI**](#-webui--桌面端) · [**完整文档**](.\u002Fdocs\u002Ffull-guide.md) · [**FAQ**](.\u002Fdocs\u002FFAQ.md) · [**贡献指南**](.\u002Fdocs\u002FCONTRIBUTING.md)\n\n[English](docs\u002FREADME_EN.md) · 简体中文 · [繁體中文](docs\u002FREADME_CHT.md)\n\n\u003C\u002Fdiv>\n\n## 🧠 项目概述\n\n**FinAgent** 是一个专为股票高频决策设计的 **Agentic AI 系统**。系统突破了静态的多智能体投票范式，引入**结构化辩论流水线**与**反思式记忆循环**，使系统能够从历史交易片段中持续**自我进化**。\n\n> **范式跃迁**：\n> ❌ *「多智能体投票」* → ✅ *「多智能体辩论 + 反思驱动自改进」*\n\n系统融合：\n- 🧠 Agent Planning（任务拆解）\n- ⚔️ Multi-Agent Debate（多空博弈）\n- 🧩 Tool-augmented Execution（工具调用）\n- 🧠 Memory + Reflection（复盘与长期记忆）\n- 📊 A股特色数据（龙虎榜 \u002F 游资行为）\n\n## ✨ 核心能力\n\n| 模块 | 功能 | 说明 |\n|------|------|------|\n| AI | 决策仪表盘 | 一句话结论 + 精确买卖点位 + 行动清单 |\n| 分析 | 多维度分析 | 技术面 + 筹码分布 + 情绪面 + 实时行情 |\n| 市场 | 全球市场 | A股、港股、美股 |\n| 搜索 | 智能 autocomplete | 支持代码\u002F名称\u002F拼音\u002F别名匹配，覆盖 A股\u002F港股\u002F美股 |\n| 复盘 | 市场综述 | 每日大盘、板块分析、北向资金 |\n| 情报 | 公告与资金流 | 上市公司公告 + A股主力资金流向信号 |\n| 回测 | AI 回测验证 | 自动评估历史分析准确率，对比 AI 预测与实际走势 |\n| 智能体 | 策略对话 | 支持多轮策略问答，内置 11 种交易策略 |\n| 通知 | 多渠道推送 | Telegram、Discord、Slack、邮件、企业微信、飞书等 |\n| 自动化 | 定时运行 | GitHub Actions 定时执行，零成本 |\n\n### 技术栈 & 数据源\n\n| 类型 | 支持项 |\n|------|--------|\n| LLM | Gemini、OpenAI 兼容、DeepSeek、通义千问、Claude、Ollama |\n| 行情数据 | AkShare、Tushare、Pytdx、Baostock、YFinance、[Longbridge](https:\u002F\u002Fopen.longbridge.com\u002F) |\n| 新闻搜索 | Tavily、Anspire、SerpAPI、博查、Brave、MiniMax |\n\n## ⚔️ 智能体核心组件\n\n| 组件 | 职能 | 实现细节 |\n|-----------|------|-----------------------|\n| **Planner Agent** | 任务拆解 | `ReAct` 循环 + 思维链规划 |\n| **Executor Agent** | 工具编排 | 面向 AkShare 及自定义接口的函数调用网关 |\n| **Bull & Bear Agents** | 对抗分析 | 具有对立提示框架的 LLM 角色 |\n| **Judge Agent** | 辩论仲裁 | 多准则评分与收敛检测 |\n| **Reflection Module** | 情节学习 | 误差分析 → 向量记忆更新 |\n\n### 1️⃣ 决策机制：从投票到辩论\n\nBull 🐂 vs Bear 🐻 → 多轮博弈 → Judge ⚖️ 裁决 → 收敛决策\n\n- **结构化对抗**：多轮反驳 + 决策收敛\n- **证据驱动**：基于技术面、资金面、情绪面的多维度论证\n\n### 2️⃣ Planner-Executor 架构\n\n```\nUser Query\n    ↓\nPlanner（任务拆解）\n    ↓\nExecutor（工具调用）\n    ↓\nAnalysis Agents（分析）\n    ↓\nDebate System（博弈）\n```\n\n### 3️⃣ A股增强模块\n\n- **📊 龙虎榜分析**：游资席位识别、资金流向分析、捕捉短期主力动向\n- **🚀 打板策略**：连板识别、情绪周期判断、龙头股识别\n\n### 4️⃣ 复盘进化系统\n\n```\n真实市场走势\n    ↓\nAgent 预测 vs 实际结果\n    ↓\n误差分析 → 写入长期记忆 → 相似案例检索\n```\n\n## 🚀 快速开始\n\n### 方式一：GitHub Actions（推荐，零成本）\n\n**无需服务器，自动每日运行！**\n\n#### 1. Fork 本仓库\n\n点击右上角 `Fork` 按钮\n\n#### 2. 配置 Secrets\n\n进入 `Settings` → `Secrets and variables` → `Actions` → `New repository secret`\n\n**AI 模型配置（任选其一）**\n\n| Secret 名称 | 说明 | 必需 |\n|------------|------|:----:|\n| `GEMINI_API_KEY` | 从 [Google AI Studio](https:\u002F\u002Faistudio.google.com\u002F) 获取 | ✅* |\n| `OPENAI_API_KEY` | OpenAI 兼容 API Key（支持 DeepSeek、通义等） | 可选 |\n| `OPENAI_BASE_URL` | OpenAI 兼容 API 地址 | 可选 |\n| `OPENAI_MODEL` | 模型名称 | 可选 |\n\n> *配置 `GEMINI_API_KEY`、`OPENAI_API_KEY` 或 Ollama 本地服务之一即可\n\n**股票列表配置**\n\n| Secret 名称 | 说明 | 必需 |\n|------------|------|:----:|\n| `STOCK_LIST` | 自选股代码，如 `600519,AAPL,hk00700` | ✅ |\n\n> **代码格式**：A股 `600519` | 港股 `hk00700` | 美股 `AAPL`\n\n**通知渠道（至少配置一个）**\n\n| Secret 名称 | 说明 |\n|------------|------|\n| `TELEGRAM_BOT_TOKEN` | Telegram 机器人 Token |\n| `TELEGRAM_CHAT_ID` | Telegram 聊天 ID |\n| `DISCORD_WEBHOOK_URL` | Discord Webhook URL |\n| `WECHAT_WEBHOOK_URL` | 企业微信 Webhook |\n| `FEISHU_WEBHOOK_URL` | 飞书 Webhook |\n| `EMAIL_SENDER` \u002F `EMAIL_PASSWORD` | 邮件推送 |\n\n完整通知渠道列表见 [完整指南](docs\u002Ffull-guide.md)\n\n#### 3. 启用 Actions\n\n进入 `Actions` 标签 → 点击 `I understand my workflows, go ahead and enable them`\n\n#### 4. 手动测试\n\n`Actions` → `Daily Stock Analysis` → `Run workflow`\n\n### 方式二：本地运行\n\n```bash\n# 1. 克隆仓库\ngit clone https:\u002F\u002Fgithub.com\u002FhelloJamest\u002FFinAgent.git\ncd FinAgent\n\n# 2. 安装依赖\npython -m venv venv\nsource venv\u002Fbin\u002Factivate  # Windows: venv\\Scripts\\activate\npip install -r requirements.txt\n\n# 3. 配置环境变量\ncp .env.example .env\n# 编辑 .env 填入 API Key 和股票代码\n\n# 4. 运行\npython main.py                    # 单次分析\npython main.py --schedule         # 定时模式（每日 18:00）\npython main.py --stocks 600519    # 指定股票\npython main.py --serve-only       # 启动 WebUI + API\n```\n\n## 🖥️ WebUI \u002F 桌面端\n\n### Web 管理界面\n\n启动 `python main.py --serve-only` 后访问 `http:\u002F\u002Flocalhost:8000`\n\n- 📝 **配置管理** — 在线编辑 watchlist、AI 模型、通知渠道\n- 🚀 **一键分析** — 触发单股\u002F批量分析，实时查看进度\n- 📊 **回测验证** — 评估历史分析准确率\n- 🤖 **策略对话** — 多轮 Agent 聊天，内置 11 种策略\n- 🌗 **深色\u002F浅色主题** — 自动适配系统偏好\n- 🔐 **认证保护** — 可选 Web 管理端密码\n\n### 桌面应用\n\n项目支持 Electron 桌面端打包，适用于 Windows\u002FmacOS：\n\n```bash\ncd apps\u002Ffinagent-web && npm ci && npm run build\ncd ..\u002Ffinagent-desktop && npm install && npm run build\n```\n\n## 📖 项目结构\n\n```\nFinAgent\u002F\n├── main.py              # 主程序入口\n├── server.py            # FastAPI 服务入口\n├── src\u002F                 # 核心业务逻辑\n│   ├── analyzer.py      # AI 分析器\n│   ├── config.py        # 配置管理\n│   ├── notification.py  # 消息推送\n│   ├── market_analyzer.py  # 市场分析\n│   └── agent\u002F           # 智能体模块\n├── data_provider\u002F       # 多数据源适配器\n├── bot\u002F                 # 机器人交互模块\n├── api\u002F                 # FastAPI API 服务\n├── apps\u002F\n│   ├── finagent-web\u002F    # React 前端\n│   └── finagent-desktop\u002F# Electron 桌面端\n├── strategies\u002F          # 内置交易策略\n├── docker\u002F              # Docker 配置\n├── docs\u002F                # 文档\n└── .github\u002Fworkflows\u002F   # GitHub Actions\n```\n\n## 📖 文档\n\n- [完整配置与部署指南](docs\u002Ffull-guide.md)\n- [常见问题 FAQ](docs\u002FFAQ.md)\n- [Docker 部署指南](docs\u002FDEPLOY.md)\n- [WebUI 云端部署](docs\u002Fdeploy-webui-cloud.md)\n- [桌面端打包指南](docs\u002Fdesktop-package.md)\n- [LLM 模型配置指南](docs\u002FLLM_CONFIG_GUIDE.md)\n- [贡献指南](docs\u002FCONTRIBUTING.md)\n\n## 🤝 参与贡献\n\n欢迎各种形式的贡献！详见 [贡献指南](docs\u002FCONTRIBUTING.md)\n\n## 📄 许可证\n\n本项目基于 [MIT License](LICENSE) 开源\n\n## ⭐ Star 历史\n\n**如果觉得有用，请给个 ⭐ Star 支持一下！**\n\n## ⚠️ 免责声明\n\n本项目仅供学习和研究使用，不构成任何投资建议。股市有风险，投资需谨慎。\n作者不对使用本项目产生的任何损失负责。\n\n## 🙏 致谢\n\n- [DSA](https:\u002F\u002Fgithub.com\u002FZhuLinsen\u002Fdaily_stock_analysis) - daily_stock_analysis項目\n- [AkShare](https:\u002F\u002Fgithub.com\u002Fakfamily\u002Fakshare) - 股票数据源\n- [Google Gemini](https:\u002F\u002Fai.google.dev\u002F) - AI 分析引擎\n- [Tavily](https:\u002F\u002Ftavily.com\u002F) - 新闻搜索 API\n- 所有为项目做出贡献的开发者\n\n## 📞 联系方式\n\n- GitHub Issues: [报告 Bug 或提出建议](https:\u002F\u002Fgithub.com\u002FhelloJamest\u002FFinAgent\u002Fissues)\n- Discussions: [参与讨论](https:\u002F\u002Fgithub.com\u002FhelloJamest\u002FFinAgent\u002Fdiscussions)\n","FinAgent 是一个面向A股、港股和美股的智能决策系统，旨在通过多智能体博弈、情节记忆与自我反思等技术提供高频股票交易建议。其核心功能包括基于结构化辩论流水线和反思式记忆循环的多智能体决策机制，以及针对A股市场的特色数据分析（如龙虎榜分析）。此外，FinAgent 还支持全球市场行情查询、智能搜索、回测验证及多渠道通知等功能，并且能够通过GitHub Actions实现零成本定时运行。此项目适用于需要进行高频股票交易决策或希望利用AI技术优化投资策略的专业投资者和个人投资者。",2,"2026-06-11 02:49:20","CREATED_QUERY"]