# AlphaCouncil

**Repository Path**: lm_vn/AlphaCouncil

## Basic Information

- **Project Name**: AlphaCouncil
- **Description**: 多智能体股票分析决策系统，需Gemini、DeepSeek、聚合数据这三个平台的API来获取数据后进行分析决策和参考意见。
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-01-08
- **Last Updated**: 2026-01-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AlphaCouncil AI - 多智能体股票分析决策系统

![License](https://img.shields.io/badge/license-MIT-blue.svg) ![React](https://img.shields.io/badge/React-19.0-blue) ![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue) ![Tailwind](https://img.shields.io/badge/Tailwind-3.0-38bdf8)

**AlphaCouncil AI** 是一个基于前沿大语言模型（LLM）技术的专业级 A 股市场分析系统。它模拟了一家顶级基金公司的完整投资委员会决策流程，由 **10 个不同角色的 AI 智能体** 组成，通过四阶段的严谨工作流，将实时行情数据转化为专业的投资决策。

## 核心特性

*   **👥 拟人化专家团队**：包含宏观、行业、技术、资金、基本面等 5 个维度的分析师，以及总监、风控和总经理角色。
*   **🚀 多模型协同 (Model Agnostic)**：支持混合调度 **Google Gemini 2.5/3.0**、**DeepSeek-R1 (Reasoner)** 和 **通义千问 (Qwen)** 模型。
*   **📈 实时数据驱动**：接入聚合数据 API，实时获取沪深 A 股的五档盘口、成交量及价格异动，确保分析基于实盘数据而非幻觉。
*   **⚡ 并行与串行工作流**：实现了复杂的异步工作流，既保证了基础分析的效率（并行），又确保了决策逻辑的连贯性（串行整合）。
*   **🎨 沉浸式 UI 体验**：采用赛博朋克风格的深色界面，配备打字机动画与机械键盘音效，提供极客般的交互体验。

---

## 🏛️ 智能体架构 (Agent Architecture)

系统共包含 10 位 AI 专家，分为四个层级：

### 第一阶段：专业分析师团队 (并行执行)
| 角色 | 职责 | 侧重点 |
| :--- | :--- | :--- |
| **🌐 宏观政策分析师** | 分析宏观经济数据与政策导向 | GDP, CPI, 货币政策, 系统性风险 |
| **📊 行业轮动专家** | 跟踪行业景气度与板块轮动 | 产业链上下游, 行业指数, 热点切换 |
| **📈 技术分析专家** | 基于 K 线与形态判断趋势 | 支撑/压力位, 趋势强度, 买卖点 |
| **💰 资金流向分析师** | 监控主力与散户资金博弈 | 北向资金, 融资融券, 盘口买卖单分析 |
| **📑 基本面估值分析师** | 深度挖掘财报与估值逻辑 | PE/PB, 财务健康度, 盈利预测 |

### 第二阶段：总监管理团队 (整合层)
| 角色 | 职责 |
| :--- | :--- |
| **👥 基本面研究总监** | 整合宏观、行业、个股基本面报告，消除分歧，形成价值判断。 |
| **⚡ 市场动能总监** | 结合技术面与资金面报告，判断市场情绪与短期爆发力。 |

### 第三阶段：风险控制团队 (审核层)
| 角色 | 职责 |
| :--- | :--- |
| **🛡️ 系统性风险总监** | 极度风险厌恶型。专注于寻找市场崩盘、流动性枯竭等黑天鹅风险。 |
| **⚖️ 组合风险总监** | 关注具体交易层面的风险，制定止损位、仓位上限和波动率控制。 |

### 第四阶段：最高决策层
| 角色 | 职责 |
| :--- | :--- |
| **⚖️ 投资决策总经理** | 拥有最终拍板权。权衡收益（总监报告）与风险（风控报告），给出最终操作指令（买入/卖出/观望）及仓位建议。 |

---

## ⚙️ 技术实现细节

### 1. 数据获取层 (Data Layer)
*   **实时行情**：使用Vercel Serverless Functions代理聚合数据 (Juhe Data) API。
*   **CORS 处理**：通过 `/api/stock` 后端函数解决跨域问题。
*   **上下文注入**：获取到的 JSON 数据（如买一卖一、涨跌幅）会被格式化为 Prompt Context，强制注入到每个智能体的系统提示词中。

### 2. 模型服务层 (Service Layer)
*   **Gemini**：通过 `@google/genai` SDK 调用，支持 Google Search Grounding（联网搜索）。
*   **DeepSeek / Qwen**：通过标准 REST API (`fetch`) 调用，支持 OpenAI 兼容格式。
*   **Fallback 机制**：如果用户配置的 DeepSeek/Qwen Key 无效或请求失败，系统会自动降级使用 Gemini 模型完成分析，确保流程不中断。

### 3. 前端交互层 (UI Layer)
*   **React 19**：利用最新的 Hooks 管理复杂的状态流转。
*   **Tailwind CSS**：构建响应式布局，完美适配桌面与移动端。
*   **Audio Context**：使用 Web Audio API 生成动态的机械键盘敲击音效。

---

# 🚀 快速开始 - Vercel 部署

### 部署到 Vercel

[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=YOUR_GITHUB_REPO_URL)

#### 快速部署步骤

1. **Fork 本仓库到你的 GitHub 账户**

2. **在 Vercel 导入项目**
   - 访问 [Vercel](https://vercel.com)
   - 点击 "New Project"
   - 选择你 fork 的仓库
   - Vercel 会自动检测 Vite 框架

3. **配置环境变量（强烈推荐）**
   
   在 Vercel 项目设置中，添加以下环境变量：
   
   ```
   GEMINI_API_KEY=你的_Gemini_API_密钥
   DEEPSEEK_API_KEY=你的_DeepSeek_API_密钥
   JUHE_API_KEY=你的_聚合数据_API_密钥
   QWEN_API_KEY=你的_通义千问_API_密钥（可选）
   ```
   
   > ⚠️ **重要**：系统会优先使用 Vercel 环境变量中配置的 API Key，前端输入仅作为备用方案。建议在 Vercel 配置所有必需的 API Key 以获得最佳体验。

4. **点击 Deploy**
   - Vercel 会自动构建并部署你的应用
   - 部署完成后即可访问
   - 每次 Git 推送都会自动触发新部署

#### Vercel 环境变量配置位置

1. 进入你的 Vercel 项目
2. 点击 **Settings** 标签
3. 选择 **Environment Variables**
4. 添加上述环境变量
5. 选择应用环境（Production / Preview / Development）
6. 点击 **Save**

### 使用说明

部署完成后：
- 访问您的 Vercel 部署链接
- 输入股票代码（如 `600519` 或 `sz000001`）
- （可选）在前端配置面板输入临时 API 密钥
- 点击"启动分析"开始智能体协作分析

---

## ⚠️ 免责声明

本系统生成的所有分析报告、投资建议及决策结果均由人工智能模型自动生成，**仅供技术研究与辅助参考，不构成任何实质性的投资建议**。

*   股市有风险，投资需谨慎。
*   AI 模型可能会产生“幻觉”或基于过时信息进行推理。
*   请务必结合个人独立判断进行投资操作。

---

## 🔑 API 密钥获取指南

### 1. Google Gemini API Key
- **获取地址**: [https://aistudio.google.com/app/apikey](https://aistudio.google.com/app/apikey)
- **用途**: 用于宏观、行业、资金流向分析（支持联网搜索）
- **费用**: 有免费额度

### 2. DeepSeek API Key
- **获取地址**: [https://platform.deepseek.com/api_keys](https://platform.deepseek.com/api_keys)
- **用途**: 用于技术分析、基本面估值、总监整合、风控评估、总经理决策
- **费用**: 按使用量付费，价格低廉

### 3. 聚合数据 API Key
- **获取地址**: [https://www.juhe.cn/](https://www.juhe.cn/)
- **用途**: 获取沪深股市实时行情数据（五档盘口、成交量等）
- **申请接口**: 需要在聚合数据平台申请"沪深股票-基本数据"接口
- **费用**: 有免费额度

### 4. 通义千问 API Key（可选）
- **获取地址**: [https://dashscope.console.aliyun.com/apiKey](https://dashscope.console.aliyun.com/apiKey)
- **用途**: 备用 AI 模型（当前版本未强制使用）
- **费用**: 有免费额度

---

## 💡 前端手动输入 API 密钥（可选）

如果未在 Vercel 配置环境变量，或想使用临时 API 密钥，可以：

1. 在首页点击 **"API 密钥配置（可选）"** 按钮展开配置面板
2. 输入您的 API 密钥（未填写的将使用 Vercel 环境变量配置）
3. 点击"启动系统"进行分析

> **安全提示**：前端输入的 API 密钥仅在当前会话中有效，不会被存储到服务器。

---

Developed with ❤️ by 张一依有把越女剑.