[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-72422":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":14,"forks30d":14,"starsTrendScore":18,"compositeScore":19,"rankGlobal":8,"rankLanguage":8,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":21,"hasPages":21,"topics":23,"createdAt":8,"pushedAt":8,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":14,"starSnapshotCount":14,"syncStatus":27,"lastSyncTime":28,"discoverSource":29},72422,"FinGenius","HuaYaoAI\u002FFinGenius","HuaYaoAI",null,"Python",2700,768,66,40,0,6,13,41,18,30.66,"GNU General Public License v3.0",false,"main",[],"2026-06-12 02:03:03","\u003Ch1 align=\"center\">FinGenius - 首个A股博弈多智能体应用\u003C\u002Fh1>\n\n\u003Cdiv align=\"center\">\n\u003Cimg src=\"docs\u002Flogo.png\" alt=\"logo\" width=\"200\">\n\u003C\u002Fdiv>\n\n\u003Cp align=\"center\">\n\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-GPL%20v3-blue.svg?style=flat-square\" alt=\"License\">\n\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-3.12%2B-blue.svg?style=flat-square&logo=python\" alt=\"Python\">\n\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fhuayaoyuanjin\u002FFinGenius\" alt=\"Stars\">\n\u003Ca href=\"https:\u002F\u002Ffingenius.cn\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FWebsite-fingenius.cn-purple.svg?style=flat-square\" alt=\"Website\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n## 项目简介\n\n**FinGenius 是全球首个A股AI金融未来博弈多智能体应用**，不是技术工程师一拍脑袋的产物，而是**扎根A股1700多天的市场真实观察，不断推翻100多个app版本**，打造出的一个完全颠覆于传统，极简体现agent独有特色的产品。\n\n目前开源了一个AI金融分析平台，采用 **Research–Battle 双子星环境多智能体架构**，在大语言模型与专业金融工具（基于 MCP 协议）的基础上，共训练构建了16 个超级智能体分工协作，目前开源出6个 （舆情、游资、风控、技术、筹码、大单异动等Agents）\n- 舆情agent算因子\n- **游资**agent帮你读龙虎榜\n- 风控agent扒政策\n- 技术agent盯持仓红线\n- 筹码agent识别主力行为\n- **大单异动**agent监控实时市场动向\n\n几分钟就汇总成报告通过6位专业AI分析师的协作研究与结构化**多轮辩论博弈的HTML报告**。\n\n常见通用大模型，和**不完全立足于A股研究的项目**，回答**很容易 “说胡话”**，A股专业领域的 **“幻觉” 能坑哭散户**；\n记不住 “老熟人”，每次打开都像初见，你上周问过的政策解读、持仓记录，它早忘到脑后；\n尤其对 A 股用户，现在市面的AI金融项目要么**照搬美股逻辑水土不服**，要么让用户无法享受AI智能的便捷。\n \n但 Figenius 是带着 “AI 脑子” 来的：\n**它像个 “A股金融老中医”**：\n- 会”对症使巧劲“下药\n- 会”抽丝剥茧“捋病因\n- 会记你的 “病史”\n\n自主研发的 “年轮记忆规则算法”（app内嵌有，欢迎体验），不是简单存记录 —— 而是像树的年轮一样，记下你的投资习惯。\n\n\n\n> 本项目仅供学习和研究，输出结果为AI推演，不构成任何投资建议。投资有风险，入市需谨慎。\n\n\n\n这是FinGenius的核心创新：​\n\n![architecture](docs%2Farchitecture.png)\n\n系统引入了博弈论的思想来优化决策过程。\n如同经典的\"囚徒困境\"模型（两个囚犯被分别关押，警方劝说他们揭发对方——如果都选择沉默，都能轻判；只要有一人背叛，背叛者轻判，另一人重判），在信息不对称的环境中，各方参与者需要预测他人的行动来做出最优决策，就像复杂多变的A股市场。\n\n\n![囚徒困境](docs\u002Fboyi.png)\n\n\n## APP体验(目前开放8000位免费早鸟体验名额)\n\n我们诚挚邀请您体验，团队6年的心血，FinGenius移动应用：\n\n- 特色功能：史上第一款极简agentAI金融app，数学博弈魔法，直接给你最想看到的东西。革新A股体验场景。\n- 移动应用：目前已上架荣耀、小米、Vivo应用市场（华为、Apple上架流程较长，正在审核中）\n- 免费早鸟体验名额：扫码关注FinGenius服务号，限量前8000位。\n  \n\n![微信公众号二维码](docs\u002Fwechat.JPG)\n\n**FinGenius俱乐部**\n\n欢迎对AI金融极致热爱的你\n\n携手完善FinGenius，共同探索金融智能分析的技术前沿边界！🌟\n\n\n## 安装指南\n\n我们提供两种安装方式。推荐使用方式二（uv），因为它能提供更快的安装速度和更好的依赖管理。\n\n### 方式一：使用 conda\n\n1. 创建新的 conda 环境：\n\n   ```bash\n   conda create -n fingenius python=3.12\n   conda activate fingenius\n   ```\n\n2. 克隆仓库：\n\n   ```bash\n   git clone https:\u002F\u002Fgithub.com\u002FHuaYaoAI\u002FFinGenius.git\n   cd FinGenius\n   ```\n\n3. 安装依赖：\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n### 方式二：使用 uv（推荐）\n\n1. 安装 uv（一个快速的 Python 包管理器）：\n\n   ```bash\n   curl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n   ```\n\n2. 克隆仓库：\n\n   ```bash\n   git clone https:\u002F\u002Fgithub.com\u002FHuaYaoAI\u002FFinGenius.git\n   cd FinGenius\n   ```\n\n3. 创建并激活虚拟环境：\n\n   ```bash\n   uv venv --python 3.12\n   source .venv\u002Fbin\u002Factivate  # Unix\u002FmacOS 系统\n   # Windows 系统使用：\n   # .venv\\Scripts\\activate\n   ```\n\n4. 安装依赖：\n\n   ```bash\n   uv pip install -r requirements.txt\n   ```\n\n## 配置说明\n\nFinGenius 需要配置使用的 LLM API，请按以下步骤设置：\n\n1. 在 `config` 目录创建 `config.toml` 文件（可从示例复制）：\n\n   ```bash\n   cp config\u002Fconfig.example.toml config\u002Fconfig.toml\n   ```\n\n2. 编辑 `config\u002Fconfig.toml` 添加 API 密钥和自定义设置：\n\n   ```toml\n   # 全局 LLM 配置\n   [llm]\n   model = \"gpt-4o\"\n   base_url = \"https:\u002F\u002Fapi.openai.com\u002Fv1\"\n   api_key = \"sk-...\"  # 替换为真实 API 密钥\n   max_tokens = 4096\n   temperature = 0.0\n\n   # 可选特定 LLM 模型配置\n   [llm.vision]\n   model = \"gpt-4o\"\n   base_url = \"https:\u002F\u002Fapi.openai.com\u002Fv1\"\n   api_key = \"sk-...\"  # 替换为真实 API 密钥\n   ```\n\n## 使用方法\n\n一行命令运行 FinGenius：\n\n```bash\npython main.py 股票代码\n```\n\n### 使用示例\n\n```bash\n# 基础分析\npython main.py 000001\n\n# 启用文本转语音\npython main.py 000001 --tts\n\n# 设置3轮辩论\npython main.py 000001 --debate-rounds 3\n\n# 自定义输出格式并保存到文件\npython main.py 000001 --format json --output analysis_report.json\n```\n\n### 可选参数\n\n- `-f, --format` - 输出格式（text 或 json）\n- `-o, --output` - 将结果保存到文件\n- `--tts` - 启用文本转语音播报最终结果\n- `--max-steps` - 每个智能体的最大步数（默认: 3）\n- `--debate-rounds` - Battle环境辩论轮数（默认: 2）\n\n## 项目结构\n\nFinGenius 的系统架构以分层解耦与模块化协同为核心，通过明确的接口规范，构建了一个既健壮稳定又易于扩展的智能分析平台。\n\n**核心特性：**\n- **Research环境**：多智能体协作深度分析，6位专业AI分析师并行\u002F顺序分析（可配置）\n- **Battle环境**：结构化多轮辩论系统，支持可配置轮数的顺序发言和投票决策\n- **完整上下文传递**：Research所有分析结果完整传递给Battle环境的每位专家\n- **累积辩论机制**：每位发言者都能获得前面所有专家的观点，形成递进式深度讨论\n- **状态保持**：确保分析链路的完整性和上下文连贯性\n\n为更直观地展示其内部结构与运作逻辑，以下类图和流程图分别从静态类组织和动态执行流程两个维度进行呈现。\n\n### 类图\n\n```mermaid\nclassDiagram\n    %%==========================\n    %% 1. Agent 层次结构\n    %%==========================\n    class BaseAgent {\n        \u003C\u003Cabstract>>\n        - name: str\n        - description: Optional[str]\n        - system_prompt: Optional[str]\n        - next_step_prompt: Optional[str]\n        - llm: LLM\n        - memory: Memory\n        - state: AgentState\n        - max_steps: int\n        - current_step: int\n        + run(request: Optional[str]) str\n        + step() str \u003C\u003Cabstract>>\n        + update_memory(role, content, **kwargs) None\n        + reset_execution_state() None\n    }\n    class ReActAgent {\n        \u003C\u003Cabstract>>\n        + think() bool \u003C\u003Cabstract>>\n        + act() str \u003C\u003Cabstract>>\n        + step() str\n    }\n    class ToolCallAgent {\n        - available_tools: ToolCollection\n        - tool_choices: ToolChoice\n        - tool_calls: List~ToolCall~\n        + think() bool\n        + act() str\n        + execute_tool(command: ToolCall) str\n        + cleanup() None\n    }\n    class MCPAgent {\n        - mcp_clients: MCPClients\n        - tool_schemas: Dict~str, dict~\n        - connected_servers: Dict~str, str~\n        - initialized: bool\n        + create(...) MCPAgent\n        + initialize_mcp_servers() None\n        + connect_mcp_server(url, server_id) None\n        + initialize(...) None\n        + _refresh_tools() Tuple~List~str~,List~str~~\n        + cleanup() None\n    }\n    class SentimentAgent {\n        \u003C\u003Cextends MCPAgent>>\n    }\n    class RiskControlAgent {\n        \u003C\u003Cextends MCPAgent>>\n    }\n    class HotMoneyAgent {\n        \u003C\u003Cextends MCPAgent>>\n    }\n    class TechnicalAnalysisAgent {\n        \u003C\u003Cextends MCPAgent>>\n    }\n    class ReportAgent {\n        \u003C\u003Cextends MCPAgent>>\n    }\n\n    %% 继承关系\n    BaseAgent \u003C|-- ReActAgent\n    ReActAgent \u003C|-- ToolCallAgent\n    ToolCallAgent \u003C|-- MCPAgent\n    MCPAgent \u003C|-- SentimentAgent\n    MCPAgent \u003C|-- RiskControlAgent\n    MCPAgent \u003C|-- HotMoneyAgent\n    MCPAgent \u003C|-- TechnicalAnalysisAgent\n    MCPAgent \u003C|-- ReportAgent\n\n    %% 组合关系\n    BaseAgent *-- LLM               : llm\n    BaseAgent *-- Memory            : memory\n    MCPAgent *-- MCPClients         : mcp_clients\n\n    %%==========================\n    %% 2. 环境（Environment）架构\n    %%==========================\n    class BaseEnvironment {\n        \u003C\u003Cabstract>>\n        - name: str\n        - description: str\n        - agents: Dict~str, BaseAgent~\n        - max_steps: int\n        + create(...) BaseEnvironment\n        + register_agent(agent: BaseAgent) None\n        + run(...) Dict~str,Any~ \u003C\u003Cabstract>>\n        + cleanup() None\n    }\n    class ResearchEnvironment {\n        - analysis_mapping: Dict~str,str~\n        - results: Dict~str,Any~\n        + initialize() None\n        + run(stock_code: str) Dict~str,Any~\n        + cleanup() None\n    }\n    class BattleState {\n        - active_agents: Dict~str,str~\n        - voted_agents: Dict~str,str~\n        - terminated_agents: Dict~str,bool~\n        - battle_history: List~Dict~str,Any~~\n        - vote_results: Dict~str,int~\n        - battle_highlights: List~Dict~str,Any~~\n        - battle_over: bool\n        - agent_order: List~str~\n        - debate_history: List~Dict~str,Any~~\n        - current_round: int\n        - current_speaker_index: int\n        + add_event(type, agent_id, ...) Dict~str,Any~\n        + record_vote(agent_id,vote) None\n        + mark_terminated(agent_id,reason) None\n    }\n    class BattleEnvironment {\n        - state: BattleState\n        - debate_rounds: int\n        - tools: Dict~str,BaseTool~\n        + initialize() None\n        + register_agent(agent: BaseAgent) None\n        + run(report: Dict~str,Any~) Dict~str,Any~\n        + handle_speak(agent_id, content) ToolResult\n        + handle_vote(agent_id, vote) ToolResult\n        + _run_structured_debate() None\n        + _build_debate_context(agent_id) str\n        + _broadcast_speech(agent_id, content) None\n        + _run_final_voting() None\n        + cleanup() None\n    }\n    class EnvironmentFactory {\n        + create_environment(env_type: EnvironmentType, agents, ...) BaseEnvironment\n    }\n\n    %% 继承与工厂\n    BaseEnvironment \u003C|-- ResearchEnvironment\n    BaseEnvironment \u003C|-- BattleEnvironment\n    EnvironmentFactory ..> BaseEnvironment : creates\n    %% 环境中包含 Agents 和 BattleState\n    BaseEnvironment o-- BaseAgent      : agents\n    BattleEnvironment *-- BattleState  : state\n\n    %%==========================\n    %% 3. 工具（Tool）抽象\n    %%==========================\n    class MCPClients {\n        - sessions: Dict~str,ClientSession~\n        - exit_stacks: Dict~str,AsyncExitStack~\n        + connect_sse(url, server_id) None\n        + connect_stdio(cmd, args, server_id) None\n        + list_tools() ListToolsResult\n        + disconnect(server_id) None\n    }\n\n    %%==========================\n    %% 4. 支持类\n    %%==========================\n    class Memory {\n        - messages: List~Message~\n        + add_message(msg: Message) None\n        + clear() None\n    }\n    class LLM {\n        - model: str\n        - max_tokens: int\n        - temperature: float\n        + ask(messages, system_msgs, ...) str\n        + ask_tool(messages, tools, tool_choice, ...) Message\n    }\n```\n\n### 流程图\n```mermaid\nsequenceDiagram\n    %% FinGenius 双环境执行流程（Research-Battle）\n    participant User\n    participant Main\n    participant Env as Environment\n    participant Agents as Agent Team\n    participant Tool\n\n    %% 用户发起股票研究\n    User->>Main: run(stock_code)\n    Main->>Env: create Research & run(stock_code)\n\n    %% 研究阶段：Agent Team 循环分析并调用工具\n    Env->>Agents: analyze(stock_code)\n    loop 分析循环\n        Agents->>Agents: step()\u002Fthink()\u002Fact()\n        Agents->>Tool: call tool\n        Tool-->>Agents: 返回结果\n    end\n    Agents-->>Env: analysis result\n    Env-->>Main: research results\n\n    %% 博弈阶段：Agent Team 保持研究状态进行结构化辩论\n    Main->>Env: run battle with research results\n    Env->>Agents: 传递完整研究分析结果（所有6位专家的详细分析）\n    loop 多轮辩论循环 (默认2轮)\n        loop 单轮发言 (按顺序)\n            Note over Env,Agents: 累积上下文传递：当前发言者获得\u003Cbr\u002F>研究结果+前面所有发言者观点\n            Env->>Agents: 发送累积辩论上下文\n            Agents->>Agents: step()\u002Fthink()\u002Fact()\n            Agents->>Tool: call battle tool\n            Tool-->>Agents: 返回结果\n            Agents-->>Env: 发言内容\n            Env->>Agents: 广播发言给其他智能体\n        end\n    end\n    Env->>Agents: 进行最终投票\n    Agents-->>Env: 投票结果\n    Env-->>Main: 辩论结果和最终决策\n\n    %% 输出最终结果\n    Main-->>User: 显示研究报告和辩论结果\n```\n\n## 许可证\n\nFinGenius 使用 [GPL v3 许可证](LICENSE)。\n\n## 致谢\n\n本项目基于 OpenManus 多智能体框架开发，继承了其\"工具即能力\"的核心理念，并将其扩展到金融分析领域，打造出专业化的金融智能体团队。\n\n感谢 [OpenManus](https:\u002F\u002Fgithub.com\u002Fmannaandpoem\u002FOpenManus) 项目的启发与支持。\n\n特别感谢 [JayTing511](https:\u002F\u002Fgithub.com\u002FJayTing511) 对本项目的支持与帮助。\n\n项目顾问：[mannaandpoem](https:\u002F\u002Fgithub.com\u002Fmannaandpoem)\n\n我们诚邀所有AI和金融领域的开发者与研究者加入FinGenius开源社区！\n\n> ⚠️ 免责声明：本项目仅用于教育和研究目的，专注于金融分析技术的探索，不提供投资预测或决策建议。\n\n> ⚠️ 追责声明：本项目基于GPLv3协议开发，禁止项目代码及框架闭源商用，协议存在法律效力，保留追责权利。\n","FinGenius 是一个专注于A股市场的AI金融分析平台，采用多智能体架构，结合大语言模型和专业金融工具，通过16个超级智能体的分工协作，提供舆情分析、游资解读、风控政策解析、技术指标监控、主力行为识别及市场动向监测等功能。该项目特别适合对A股市场有深入研究需求的投资者或机构使用，其独特的“年轮记忆规则算法”能够更好地理解和适应用户的投资习惯，避免了通用大模型在处理A股特定问题时可能出现的信息偏差。此外，FinGenius还引入了博弈论来优化决策过程，在信息不对称的情况下帮助用户做出更合理的判断。",2,"2026-06-11 03:41:58","high_star"]