本项目将「标的代码 + 交易日」转化为一篇分阶段、可追溯的多智能体研究报告链路：专业分析师分工产出观点 → 多空研究员辩论砥砺结论 → 研究总监形成纪要式综合判断 → 交易员给出策略草案 → 风控多方合议与情景推演 → 终审输出。适用于中文语境下的学习、研究与内部原型验证。
技术栈为 TypeScript（运行于 Node.js），工作流由 LangGraph 编排；模型调用采用 OpenAI 兼容接口，可对接官方接口、聚合网关或国产兼容底座，降低供应商绑定。
**边界声明：**本项目用于教育、研究与流程验证，不是证券公司服务，不提供实盘下单指令，不承诺收益。
| 维度 | 说明 |
|---|---|
| 编排能力 | 状态图驱动：分析师链路 → 多空辩论 → 综合结论 → 交易草案 → 风控循环 → 终审 |
| 运维友好 | 提供 HTTP 接口与命令行示例；支持 Docker Compose 一键拉起接口服务与可选前端镜像 |
| 模型可调 | 通过环境变量或请求体中的 config 切换模型与网关地址 |
| 输出透明 | 各阶段均为结构化文本，便于记录、比对或接入自有报表 / 评估流水线 |
git clone https://github.com/TQ-trade-agent/trading-agent.git
cd trading-agent
cp .env.example .env # 填写 OPENAI_API_KEY，按需填写 OPENAI_BASE_URL
npm install
npm run dev # 默认监听 http://0.0.0.0:8000生产形态启动（先编译）：
npm run build
npm start容器编排（后端接口 + 前端镜像）：
cp .env.example .env
docker compose up --build| 场景 | 命令 |
|---|---|
| 本地开发（热重载） | npm run dev |
| 命令行单次演示 | npm run example -- 600519 2026-05-06 |
| 静态类型检查 | npm run typecheck |
默认 HTTP 端口：8000；可通过环境变量 API_HOST、API_PORT 调整。
健康检查，返回服务存活状态（JSON）。
对单一标的与日期执行完整智能体流水线。
请求体（JSON）
| 字段 | 必填 | 说明 |
|---|---|---|
ticker |
✓ | 标的代码或简称（如沪深代码、AAPL 等） |
trade_date |
✓ | 交易日字符串（建议 YYYY-MM-DD） |
analysts |
否 | 分析师子集：market、social、news、fundamentals |
config |
否 | 运行时局部配置（模型名、backend_url、辩论轮次等） |
请求示例
{
"ticker": "600519",
"trade_date": "2026-05-06",
"analysts": ["market", "news", "fundamentals"],
"config": {
"quick_think_llm": "gpt-4o-mini",
"deep_think_llm": "gpt-4o-mini",
"backend_url": "https://api.openai.com/v1"
}
}**响应概要：**包含各分析师报告、综合研究结论、交易员草案与风控终审文本，可直接对接看板、导出文档或大模型评测脚本。
src/ # 编排核心、节点实现、配置与 HTTP 服务入口 server.ts
examples/ # 命令行示例
frontend/ # 可选 Vue 3 前端（需自行配置后端地址）
docs/ # 历史或补充文档（若与当前栈不一致，请以代码为准）
工作流创意受益于开源社区中的多智能体金融研究范式（例如 TradingAgents）。本仓库侧重 轻量 TypeScript 运行时、清晰的 HTTP 契约与部署路径，便于中文开发者二次集成。
服务端与核心库默认遵循 Apache 2.0，详见仓库根目录 LICENSE。若 frontend/ 目录内附有单独许可证文件，则该目录内资源以其声明为准。
模型输出具有生成性与不确定性，可能存在遗漏、过时或错误；证券投资有风险。请勿将生成内容等同于投资、法务或税务意见；决策前请咨询具备资质的专业人士。
若本项目对您的研究与教学有帮助，欢迎在 GitHub 上收藏本仓库以便跟进更新。