README.md

April 19, 2026 · View on GitHub

中文 | English

构建资本市场可信、可控、可回溯的量化投研开放架构 A Trustworthy, Controllable, and Traceable Platform for Financial Intelligence.

📖 Background & Lineage (背景与渊源)

AlphaTeam 是基于我们前期学术开源项目 AlphaFin 的工业级进阶版本。

AlphaFin (前身): 侧重于金融高质量数据集的构建、大模型微调、检索增强以及初步的单体逻辑链推理探索，旨在解决金融数据时效性与计算复杂性的基础问题。
AlphaTeam : 在 AlphaFin 积累工作经验和技术基础上，全面升级为多智能体协作 与系统化工程治理架构。完成了从“启发式的单体问答” 向 “具备可信，可控，可进化的量化投研框架”的跨越。

💡 核心理念

在充满噪声的资本市场，我们不追求单一模型的 “猜测”，而追求投研过程的 “确定性”。

AlphaTeam 旨在解决传统 AI 投研中“流程黑盒、责任不清、不可审计”的痛点，将投研逻辑从“只看结果”转向 “过程可解释、动作可约束、状态可追踪”。

AlphaTeam Architecture and Core Philosophy

🚀 核心特性

特性	描述
🛡️ 可信	设置 “因果假设链” 推理模式，强制要求 “证据-结论” 一一对应，从底层逻辑拒绝 AI 幻觉。
🎮;可控	引入反方审计与风险复核机制，确保每一项投资建议都经过严苛的逻辑挑战。
🔍 可回溯	全链路流程与记忆中心，每一秒的决策依据、工具调用和原始数据均可审计还原。
🧬 可进化	深度适配中国资本市场A股场景，支持多智能体在复杂实战反馈中实现自我进化与迭代。

🎬 可视化展示

以下为 AlphaTeam 的实际运行界面示意（含可视化协作与分析工作台）：

AlphaTeam Demo

🛠️ 系统架构

AlphaTeam 并非简单的问答机器人，而是一套面向投研的工业级底座：

1. 多智能体协作层 (Multi-Agent Collaboration)

研究、情报、风控、审计职责分离，深度模拟现实金融机构的投研流水线，实现真正的专业化分工。

2. 工具治理中心 (Tool Governance)

对 API 调用与数据检索进行严格审计，确保数据源合规、调用链透明，且研究结果具备 100% 可重现性。

3. 可视化工作流 (Visual Workflow)

通过直观的决策链路展示，将量化分析的逻辑完全“白盒化”，让每一个策略细节都清晰可见。

AlphaTeam 🆚 传统金融框架

维度	传统金融 / AI 投研框架	AlphaTeam
执行范式	单体模型或固定规则链，流程弹性弱	多智能体协作 + 编排器驱动
可控性（流程与策略治理）	控制面分散，难统一时限、审批、中断策略	支持工作流配置、超时治理、全局中止与角色边界约束
可回溯性	常见“结果可见、过程不可见”	Activity Stream + Trace + 报告归档全链路回溯
合规与审计证据	缺乏统一审计入口，证据链割裂	工具目录、源码审查、审计接口统一沉淀证据链
记忆透明度	上下文记忆常不可见	提供 `memory_center` 可视化记忆中心
可视化程度	多为文本与静态图表	3D 工作流场景 + 实时状态面板
架构演进能力	扩展成本高，角色复用差	角色、工具、技能模块化，可持续迭代

Mission: AlphaTeam 不替代人类的投资判断，我们致力于为全球投研团队提供一套 “可扩展、可验证、可推理、可回溯、具备金融直觉” 的数字基础设施。

Role Taxonomy

Runtime ID	Runtime Name	Academic Role
`director`	决策总监	Coordinator
`analyst`	投资分析师	Fundamental Researcher
`intel`	市场情报员	Market Intelligence Researcher
`quant`	量化策略师	Quantitative Researcher
`risk`	风控官	Risk Reviewer
`auditor`	反思审计员	Audit Reviewer
`restructuring`	资产重组专家	Special Situations Researcher

Architecture Spec

完整规格文档见 docs/ARCHITECTURE.md。以下为摘要：

Orchestration Layer: orchestrator 与 portfolio_scheduler 驱动研究与组合周期。
Agent Runtime Layer: agent_registry 管理角色模型路由、状态与停止控制。
Tool and Data Layer: tool_registry 约束工具调用入口与参数模式。
Memory and Governance Layer: 记忆系统、活动总线、Trace、工具审计共同构成治理闭环。
Interface Layer: /team 统一交互与可视化入口，支持 3D 协作场景。

Core Modules

App Entry: AlphaFin/app.py
Team API and Routes: AlphaFin/ai_team/routes.py
Orchestrator: AlphaFin/ai_team/core/orchestrator.py
Portfolio Scheduler: AlphaFin/ai_team/core/portfolio_scheduler.py
Agent Registry: AlphaFin/ai_team/core/agent_registry.py
Tool Registry: AlphaFin/ai_team/core/tool_registry.py
Memory System: AlphaFin/ai_team/core/memory.py
Team Frontend: AlphaFin/ai_team/templates/ai_team.html
Team 3D Scene: AlphaFin/ai_team/static/js/three_scene.js
DB Build Script: AlphaFin/scripts/build_db.py

📊 指标与策略生态（简述）

当前开源版本包含 25 个可运行指标/策略模块，按四大分组组织：资金面指标(7)、宏观与估值指标(7)、市场结构指标(7)、策略模型(4)。
策略模型 当前覆盖：理想行业轮动策略、优质股票筛选、智能体协同策略、大师选股策略。
全部指标采用统一注册与加载机制：indicator_registry 自动发现，前端通过 /indicator/<indicator_id> 统一访问与渲染。
设计目标是让每个指标既可独立使用，也可在 AlphaTeam 协作链路中被审计、被复核、被复现。

Quick Start

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

配置环境变量（参考 .env.example），至少设置：

SECRET_KEY
TUSHARE_TOKEN
QWEN_API_KEY
MOONSHOT_API_KEY

启动服务：

python3 AlphaFin/app.py

访问入口：

Team Workspace: http://127.0.0.1:5002/team

Data Bootstrap

默认数据库目录为 data/db（可通过 ALPHAFIN_DB_ROOT 覆盖）。

# 快速模式（推荐，近 1 年）
python3 -m AlphaFin.scripts.build_db --mode quick

# 全量模式
python3 -m AlphaFin.scripts.build_db --mode full

# 全量 + 财务指标
python3 -m AlphaFin.scripts.build_db --mode full --include-fina

当前版本优先服务 A 股投研语境：

中国市场时钟语义与交易时段约束。
本地数据链路可控、可重建。
风控与复核环节默认前置。

项目可扩展至其他市场，但需要新增数据适配、时钟规则与交易语义层。

Observability and Governance APIs

能力	API
活动流（SSE）	`/api/team/activity`
运行链路 Trace	`/api/team/trace/runs`, `/api/team/trace/<run_id>`
记忆中心	`/api/team/memory_center`
工具目录与源码审查	`/api/team/tools_audit/catalog`, `/api/team/tools_audit/source`, `/api/team/tools_audit/review`
生命周期控制	`/api/team/module/start`, `/api/team/module/stop`, `/api/team/stop_all_work`
超时治理	`/api/team/session/<session_id>/overtime`

Non-goals

本项目不保证投资收益或胜率。
本项目不是自动实盘交易系统。
本项目输出内容不构成投资建议。

Citation

若你在研究或工程工作中使用 AlphaTeam，建议按软件仓库方式引用：

@software{alphateam2026,
  title   = {AlphaTeam: Trustworthy, Controllable, and Traceable Quantitative Trading PlatForm},
  author  = {AlphaTeam Contributors},
  year    = {2026},
  url     = {https://github.com/jackyideal/AlphaTeam}
}