English | 中文
A股智能决策系统
基于 LangGraph 的多Agent辩论式量化交易决策框架,15位AI分析师协作,输出结构化投资评级与可视化分析报告。
: 本工具仅供研究和辅助决策参考,不构成投资建议。投资有风险,入市需谨慎。
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDo publicador
English | 中文
基于 LangGraph 的多Agent辩论式量化交易决策框架,15位AI分析师协作,输出结构化投资评级与可视化分析报告。
: 本工具仅供研究和辅助决策参考,不构成投资建议。投资有风险,入市需谨慎。
A股多Agent量化交易决策框架 — LangGraph 15位AI分析师辩论式分析,反思闭环+Token优化,支持DeepSeek/Qwen/GLM,附零依赖MCP server | Multi-agent A-share trading framework with reflection loop & MCP server
--date <历史日期> 运行时,记忆检索、向量检索、新闻窗口与反思结算全部按时间点门控——分析日之后才可知的信息不会进入 prompt。判据见 docs/前视偏差防护.mdastock-trader watch 轮询实时行情(腾讯主源 + 新浪兜底,免 Key),声明式规则引擎(8 类规则)触发事件后落台账再推送(企业微信/钉钉/飞书/Server酱/PushPlus/Bark/webhook/console),落盘先于推送故通知超时不会丢告警。设计见 docs/监控层与数据源扩展.mddocs/Agent接入指南.md
┌─────────────────────────────────────────────────────────────────┐
│ START │
└───────────────────────┬─────────────────────────────────────────┘
│
┌───────────────┼───────────────┬───────────────┐
▼ ▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Market │ │ Social │ │ News │ │ Fundamentals│
│ Analyst │ │ Analyst │ │ Analyst │ │ Analyst │
│ (技术面) │ │ (舆情) │ │ (新闻) │ │ (基本面) │
└──────┬───────┘ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘
│ │ │ │
│ [ReAct tool loop: 工具调用 → 数据获取 → 分析] │
│ │ │ │
└────────────────┴────────┬───────┴────────────────┘
▼
┌───────────────────────────────┐
│ Investment Debate │
│ ┌─────────┐ ┌──────────┐ │
│ │ Bull │◄─►│ Bear │ │
│ │Researcher│ │Researcher│ │
│ │ (看多) │ │ (看空) │ │
│ └─────────┘ └──────────┘ │
└───────────────┬───────────────┘
▼
┌───────────────────────────────┐
│ Research Manager │
│ 综合辩论 → 投资评级方案 │
└───────────────┬───────────────┘
▼
┌───────────────────────────────┐
│ Trader │
│ 投资方案 → 交易执行计划 │
└───────────────┬───────────────┘
▼
┌───────────────────────────────┐
│ Risk Debate │
│ ┌──────────┐ ┌──────────┐ │
│ │Aggressive│─►│Conservat.│ │
│ │ (激进) │ │ (保守) │ │
│ └──────────┘ └────┬─────┘ │
│ ▼ │
│ ┌──────────┐ │
│ │ Neutral │ │
│ │ (中性) │ │
│ └──────────┘ │
└───────────────┬───────────────┘
▼
┌───────────────────────────────┐
│ Portfolio Manager │
│ 风控讨论 → 最终投决评级 │
└───────────────┬───────────────┘
▼
┌───────────────────────────────┐
│ Report Generator │
│ 生成可交互 HTML 分析报告 │
└───────────────┬───────────────┘
▼
END
15位AI角色:
# 克隆仓库
git clone https://github.com/2033121/astock-trading-agents.git
cd astock-trading-agents
# 开发模式安装
pip install -e .
# OpenAI
export OPENAI_API_KEY=sk-your-key-here
# 或 DeepSeek
export OPENAI_API_KEY=sk-your-deepseek-key
export OPENAI_BASE_URL=https://api.deepseek.com
支持的 LLM 提供商:
Tushare 的 token 也可以写进用户级配置,省得每次开终端都设环境变量 (该文件在仓库之外,不要提交):
astock-trader config --set tushare_token --value <你的 token>
行情数据(日线 OHLCV)内置三源 fallback:东方财富 → 新浪 → 腾讯。
东方财富按出口 IP 做服务端限流,被拦时表现为连接被重置(UA / Referer /
TLS 指纹都无效,见 akshare issue #6100、#7098),此时自动切到新浪或腾讯,
报告里的 source: 一行会写明实际出数的源。三家的前复权基准略有差异,
所以同一条序列始终由同一个源提供,不做跨源拼接。
所有运行时产物都落在一个项目根下,无需逐个配置:
用 ASTOCK_HOME 可以整体搬到别处:
export ASTOCK_HOME=/path/to/astock_home
根目录下会生成:reports/(HTML 报告)、logs/(状态与结果 JSON)、
memory/、vector_memory/、checkpoints/、monitor/、
external_calibration/,以及 user_config.json。
HTML 报告默认就会生成到 <项目根>/reports/。要把报告单独放到别处时:
export ASTOCK_REPORT_DIR=/path/to/your/reports
# 基础用法 — 分析平安银行
astock-trader analyze 000001
# 指定日期和提供商
astock-trader analyze 600519 --date 2025-06-01 --provider deepseek
# 仅选择技术面和基本面分析
astock-trader analyze 300750 --analysts market,fundamentals
# 增加辩论轮数
astock-trader analyze 000001 --debate-rounds 2 --risk-rounds 2
# 指定深度思考模型
astock-trader analyze 600519 --deep-model deepseek-reasoner
# 安静模式(仅输出评级)
astock-trader analyze 000001 --quiet
# 输出到指定文件
astock-trader analyze 000001 --output result.json
# 查看所有历史
astock-trader history
# 查看特定标的历史
astock-trader history 000001
# 限制条数
astock-trader history 600519 --limit 5
# 显示所有记忆条目
astock-trader memory show
# 列出 pending 状态的条目
astock-trader memory resolve
# 清除所有记忆(需确认)
astock-trader memory clear
# 显示当前配置
astock-trader config --show
# 修改 LLM 提供商
astock-trader config --set llm_provider --value deepseek
# 修改深度思考模型
astock-trader config --set deep_think_llm --value deepseek-reasoner
# 修改快速思考模型
astock-trader config --set quick_think_llm --value deepseek-chat
# 启用检查点(崩溃恢复)
astock-trader config --set checkpoint_enabled --value true
# 重置为默认配置
astock-trader config --reset
analyze 选项memory 操作from astock_trader.graph import TradingAgentsGraph
# 创建分析图
graph = TradingAgentsGraph(
selected_analysts=["market", "news", "fundamentals"],
config={
"llm_provider": "deepseek",
"deep_think_llm": "deepseek-reasoner",
"quick_think_llm": "deepseek-chat",
"max_debate_rounds": 2,
"max_risk_discuss_rounds": 1,
"report_output_dir": "./reports", # HTML 报告保存目录
},
)
# 运行分析
final_state, rating = graph.propagate("000001", "2025-06-10")
print(f"评级: {rating}")
print(f"最终决策: {final_state.get('final_trade_decision', '')}")
print(f"HTML 报告: {final_state.get('report_path', '')}")
from astock_trader.agents import (
create_market_analyst,
create_bull_researcher,
create_research_manager,
create_trader,
create_aggressive_debator,
)
from astock_trader.llm_clients import create_llm_client
# 创建 LLM
client = create_llm_client(provider="deepseek", model="deepseek-chat")
llm = client.get_llm()
# 创建各角色 Agent
market_node = create_market_analyst(llm)
bull_node = create_bull_researcher(llm)
manager_node = create_research_manager(llm, deep_think_llm=llm)
import functools
trader_node = functools.partial(create_trader(llm), company_name="贵州茅台")
from astock_trader.agents.utils.memory import TradingMemoryLog
mem = TradingMemoryLog(memory_dir="~/.astock_trader")
# 存储决策
mem.store_decision(
"000001",
"2025-06-10",
{
"rating": "买入",
"action": "买入",
"reasoning": "技术面突破",
},
)
# 获取历史上下文
context = mem.get_past_context("000001")
# 批量更新反思
mem.batch_update_with_outcomes(
[
{
"ticker": "000001",
"trade_date": "2025-06-10",
"reflection": {"outcome": "盈利5%", "lesson": "技术分析有效"},
"new_rating": "增持",
},
]
)
astock-trader analyze 600519 --provider deepseek # 自动写 <…>_progress.jsonl(可关)
python3 scripts/agent_panel.py <results_dir>/600519_20260911_progress.jsonl
生成的 agent_panel.html 每 2 秒自刷新,按阶段显示 12 位智能体的 运行中/完成/失败、
耗时与最终评级。DSH 会话用 sidebar_open 打开即可实时观察;其他宿主在浏览器打开
(详见 integrations/README.md)。
skills/ 一次性注册到多种 Agent 宿主(幂等安装器,沙箱实测):
./integrations/install.sh # 自动探测并注册全部
./integrations/install.sh dsh codex --dry-run
细节见 integrations/README.md。任何以 AGENTS.md 为约定的宿主(Codex/zCode)
自带技能触发词表;DSH/Claude 装完重启即加载。
仓库根目录提供零依赖的 MCP stdio 服务器(mcp_server.py),可在任意 MCP 主机
(Claude Desktop / Claude Code / Cline / Continue / Zed…)中把本框架作为工具集调用。
只用标准库,不需要 pip install 本项目即可启动:
后四个是纯文件读取,毫秒级、零 token,可以放心让 agent 频繁调用。
客户端配置示例(JSON):
{
"mcpServers": {
"astock-trading-agents": {
"command": "python",
"args": ["/绝对路径/astock-trading-agents/mcp_server.py"]
}
}
}
Claude Code 用户也可以一条命令注册:
claude mcp add astock-trading-agents -- python /绝对路径/astock-trading-agents/mcp_server.py
环境变量:ASTOCK_SNAPSHOT_LOG_PATH(快照日志路径,默认 scripts/save_snapshot.py 内置路径)、
ASTOCK_MEMORY_LOG_PATH(决策记忆 markdown)、ASTOCK_MCP_CLI_TIMEOUT(analyze 工具超时秒数,默认 1200)。
analyze_stock 内部用 astock-trader analyze --quiet --output - 取结构化结果,
stdout 上就是一份 UTF-8 的 JSON —— 想在自己的脚本里复用同样的输出,照这个调用即可。
各宿主(Claude Code / Codex / Trae / Qoder / Cline…)的完整接入步骤见 Agent 接入指南。
本系统可作为 QoderWork 插件使用,在 QoderWork 中直接调用分析能力:
astock-trader 命令/智能分析 000001 等命令触发分析也可以通过 QoderWork 的定时任务(Cron)功能设置定期自动分析:
每天 15:30 分析自选股列表并生成报告
插件包含 7 个 Skill:
v0.5 围绕 Token 优化 + 对外能力 + 公平性收口 三条主线(详见 CHANGELOG 与 docs/改进路线图.md):
v0.4 实现了完整的反馈注入回路——从回测跟踪到质量校验再到 prompt 注入,形成闭环:
v0.3 基于 webnovel-studio v0.2 的生产工程经验横向迁移,6 项核心改进全部实施:
所有配置项均可通过 astock-trader config --set 或 default_config.py 调整。 astock-trader config --set 或 default_config.py 调整。
本框架可以被任何 AI 编程助手 / Agent 宿主使用。三条接入姿势互相独立、可以叠加:
完整步骤见 docs/Agent接入指南.md —— 含每个宿主的注册方式、 可触发技能清单、MCP 配置、凭证与目录约定、已知限制。
这些文件都随仓库提供,开箱即用、无需额外配置。
./integrations/install.sh # 自动探测并注册到全部可用宿主
./integrations/install.sh claude codex # 只装指定宿主
./integrations/install.sh codex --dry-run # 预览,不落盘
Claude Code / zCode / DSH 用软链技能目录;Codex CLI 用复制成 slash 命令
(~/.codex/prompts/astock-<slug>.md)。细节见 integrations/README.md。
# 运行所有测试(共 799 个,15 个按环境跳过)
pytest tests/
# 详细输出
pytest tests/ -v
# 运行特定测试文件
pytest tests/test_schemas.py
pytest tests/test_conditional_logic.py
pytest tests/test_signal_processing.py
pytest tests/test_memory.py
pytest tests/test_dataflows.py
pytest tests/test_agents.py
pytest tests/test_prompt_prefix.py # v0.5: 提示词前缀接线护栏
pytest tests/test_semantic_cache.py # v0.5: 语义响应缓存
pytest tests/test_pm_matrix.py # v0.5: 基金经理决策矩阵
pytest tests/test_context_digest.py # v0.5: 研究员报告摘要
pytest tests/test_mcp_server.py # v0.5: MCP server(含 stdio 端到端 + UTF-8 字节断言)
pytest tests/test_backtest_consumer.py # v0.4: 反馈消费 + 衰减测试
# 回归护栏(这几条守的是「静默失效」类缺陷,改动数据层/工具封装时必跑)
pytest tests/test_tool_signatures.py # 工具封装 vs vendor 参数名逐项比对
pytest tests/test_debate_state_merge.py # 辩论历史不被嵌套状态覆盖
pytest tests/test_dataflows_config_wiring.py # 配置真的推到了数据层
pytest tests/test_ohlcv_fallback.py # 日线三源 fallback 与单位归一化
pytest tests/test_rating_action.py # 评级/操作字段的否定句识别
pytest tests/test_paths.py # 落盘路径解析与派生
pytest tests/test_report_stages.py # 报告面板去重与耗时回填
pytest tests/test_block_trades.py # 大宗交易时点门控
# 带覆盖率报告
pytest tests/ --cov=astock_trader --cov-report=term-missing
astock-trading-agents/
├── pyproject.toml # 项目配置与依赖
├── README.md # 本文件
├── README.en.md # 英文精简版 (v0.5)
├── mcp_server.py # 零依赖 MCP stdio 服务器 (v0.5)
├── mkdocs.yml # 文档站配置 (v0.5)
├── LICENSE # MIT 许可证
├── skills/ # QoderWork 插件 Skills
│ ├── 智能分析/ # 多Agent分析
│ ├── 分析历史/ # 历史记录查看
│ ├── 决策记忆/ # 记忆管理
│ ├── 交易配置/ # 配置管理
│ ├── 快照跟踪对比/ # 多期快照跟踪对比
│ ├── 龙虎榜解读/ # 龙虎榜席位归因资金信号 (akshare 实测接口)
│ └── 行业对比解读/ # 相对估值横截面(PE/PB 分位定位)
├── src/
│ └── astock_trader/
│ ├── __init__.py
│ ├── default_config.py # 默认配置
│ ├── cli/ # CLI 命令行接口
│ │ ├── __init__.py
│ │ └── main.py # Typer CLI (analyze/history/memory/config)
│ ├── agents/ # Agent 定义
│ │ ├── __init__.py # 顶层导出
│ │ ├── schemas.py # Pydantic 结构化输出模型
│ │ ├── analysts/ # 分析师 (4位)
│ │ │ ├── market_analyst.py
│ │ │ ├── news_analyst.py
│ │ │ ├── social_media_analyst.py
│ │ │ └── fundamentals_analyst.py
│ │ ├── researchers/ # 研究员 (看多/看空)
│ │ │ ├── bull_researcher.py
│ │ │ └── bear_researcher.py
│ │ ├── managers/ # 经理 (研究/组合)
│ │ │ ├── research_manager.py
│ │ │ └── portfolio_manager.py
│ │ ├── trader/ # 交易员
│ │ │ └── trader.py
│ │ ├── risk_mgmt/ # 风控分析师 (激进/保守/中性)
│ │ │ ├── aggressive_debator.py
│ │ │ ├── conservative_debator.py
│ │ │ └── neutral_debator.py
│ │ └── utils/ # Agent 工具与状态
│ │ ├── prompt_prefix.py # 共享系统提示词前缀 (v0.5)
│ │ ├── agent_states.py
│ │ ├── agent_utils.py
│ │ ├── core_stock_tools.py
│ │ ├── technical_indicators_tools.py
│ │ ├── fundamental_data_tools.py
│ │ ├── news_data_tools.py
│ │ ├── mx_data_tools.py # 东方财富妙想数据工具
│ │ ├── tushare_data_tools.py # Tushare 数据工具
│ │ ├── memory.py # 交易记忆系统
│ │ ├── backtest_consumer.py # 回测反馈消费 (v0.4)
│ │ ├── rating.py # 评级解析器
│ │ └── structured.py # 结构化输出工具
│ ├── dataflows/ # 数据层
│ │ ├── __init__.py
│ │ ├── config.py # 全局配置
│ │ ├── interface.py # Vendor 路由系统(三级 fallback)
│ │ ├── akshare_data.py # akshare 数据源(行情/技术指标)
│ │ ├── tushare_data.py # Tushare 数据源(财务/资金流向)
│ │ ├── mx_data.py # 东方财富妙想数据源(新闻/实时)
│ │ └── eastmoney_news.py # 东方财富新闻源
│ ├── graph/ # LangGraph 编排层
│ │ ├── __init__.py
│ │ ├── setup.py # 图构建与编译
│ │ ├── trading_graph.py # 主编排器
│ │ ├── conditional_logic.py # 条件路由
│ │ ├── propagation.py # 状态传播
│ │ ├── reflection.py # 反思机制
│ │ ├── signal_processing.py # 信号提取
│ │ ├── report_generator.py # HTML 报告生成器
│ │ ├── context_slimmer.py # 智能上下文瘦身
│ │ └── checkpointer.py # SQLite 检查点
│ ├── llm_clients/ # LLM 客户端
│ │ ├── __init__.py
│ │ ├── base_client.py # 基类
│ │ ├── openai_client.py # OpenAI 兼容客户端
│ │ ├── factory.py # 客户端工厂
│ │ ├── resilience.py # LLM 容错层(重试 + 熔断 + Headroom)
│ │ └── semantic_cache.py # 节点级语义响应缓存 (v0.5)
│ └── memory/ # 向量记忆系统
│ ├── __init__.py
│ └── market_memory.py # TF-IDF bigram 语义检索 + 持久化
└── tests/ # 测试
├── conftest.py
├── test_schemas.py # Pydantic 模型测试
├── test_conditional_logic.py # 条件路由测试
├── test_signal_processing.py # 信号提取测试
├── test_memory.py # 记忆系统测试
├── test_dataflows.py # 数据层路由测试
├── test_agents.py # Agent 工厂测试
└── test_backtest_consumer.py # v0.4: 反馈消费 + 衰减测试
系统输出五级投资评级:
本项目灵感来自 TradingAgents 框架,针对A股市场进行了全面适配和增强。
MIT
A股多Agent量化交易决策框架 — LangGraph 15位AI分析师辩论式分析,反思闭环+Token优化,支持DeepSeek/Qwen/GLM,附零依赖MCP server | Multi-agent A-share trading framework with reflection loop & MCP server
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Astock Trading Agents roda localmente via stdio.
Última verificação: 2026-10-26. A股多Agent量化交易决策框架 — LangGraph 15位AI分析师辩论式分析,反思闭环+Token优化,支持DeepSeek/Qwen/GLM,附零依赖MCP server | Multi-agent A-share trading framework with reflection loop & MCP server