拓冰网站定制 
一图看懂AI Market Maker项目代码结构与模块职责全梳理【免费下载链接】ai-market-makerAgentic AI Hedge Fund OS (AIMM)项目地址: https://gitcode.com/gh_mirrors/ai/ai-market-makerAI Market MakerAIMM是一个开源的 AI 多智能体交易系统让一群AI 交易台像对冲基金一样协作完成行情扫描、信号合成、组合管理与风控否决。本文带你一图看懂它的代码结构与模块职责帮你 10 分钟建立完整的项目地图 ️。为什么先读懂 AI Market Maker 的代码结构AIMM 的设计目标不是一个交易机器人而是一家小型专业交易公司多个专职 AI Agent交易台并行分析市场LangGraph 编排层把它们串成完整工作流Risk Guard风控守卫拥有最终一票否决权量化级纪律中心化策略配置、买入持有基准、全链路可追溯理解了谁负责什么你就能快速定位任何功能在代码里的位置。顶层目录结构一览 项目根目录由 Python 核心 两个前端 配置文档组成各目录职责如下目录 / 文件职责关键词src/核心 Python 逻辑Agent、回测、API、OMS大脑web/Next.js 仪表盘Nexus 控制台、回测、拓扑图展示层 v1web-v2/Vite React 新版门户 UI展示层 v2config/JSON 策略与默认配置策略、权重、运行设置单一事实源docs/工作流、配置、策略 schema、各角色人设文档官方文档openclaw/OpenClaw 技能包SKILL.md 运行脚本技能封装tests/pytest 测试套件单元 E2E质量保障alembic/数据库迁移脚本数据层scripts/平台 worker、榜单发布、筛选器等运维脚本工具配置哲学策略与交易参数放在config/下的 JSON 文件如 config/policy.default.json密钥只放.env详见 docs/configuration.md。src/agents/9 个 AI 交易台核心看点⭐这是 AIMM 最有特色的部分。每个 Agent 都是一个专职研究员统一遵循 src/agents/base_agent.py 定义的输入 → 处理 → 输出 → 反馈契约Agent 文件角色分析什么market_scan.py市场扫描新币、动量、标的池覆盖monetary_sentinel.py宏观哨兵1.1宏观周期 流动性评分news_narrative_miner.py新闻叙事1.2事件影响 叙事新鲜度pattern_recognition_bot.py形态识别2.1图表几何 形态质量statistical_alpha_engine.py统计 Alpha2.2横截面 z-score 信号technical_ta_engine.py技术分析2.3RSI、MACD、ATR 等 TA-Lib 指标retail_hype_tracker.py散户情绪3.1FOMO 指数 背离预警pro_bias_analyst.py机构偏好3.2ETF 流向 资金费率 OI 变化whale_behavior_analyst.py巨鲸行为4.1砸盘概率 筹码集中度默认关闭liquidity_order_flow.py流动性订单流4.2滑点风险 盘口失衡治理与执行类 Agent 单独放在 src/agents/governance/ 下Policy Orchestrator— 策略编排可按权重开关各 AgentRisk Guard— 硬性风控层任何交易执行前都可一票否决Portfolio Management— 多资产配置与提案生成每个 Agent 的详细人设说明书见 docs/personas/ 下的 15 篇角色文档如 14_risk_guard.md。src/workflow/LangGraph 编排层如何串联全流程 ️docs/langgraph-workflow.md 定义了完整的状态机主流程如下policy_orchestrator → market_scan → [9 个 Tier-0 Agent 并行] → risk → desk_debate → signal_arbitrator → portfolio_proposal → risk_guard → portfolio_execute → auditdocs/personas/README.md 用一张表总结了各节点职责与默认权重例如 2.3 技术分析权重 0.30 最高1.1 宏观仅 0.05。src/workflow/ 目录中的关键模块模块职责weight_assigner.py把 9 个 Agent 的因子信号归一化到 [0,1]加权合成全局得分weighted_arbitrator.py默认仲裁引擎确定性数学零 LLM 成本desk_debate.py多空证据线辩论环节routing.py条件路由所有路径都必须汇聚到 Risk Guardexecution_intent.py从仲裁结果派生交易意图决策阈值BUY / SELL / HOLD与对齐门控逻辑详见 docs/weighted-arbitrator.md。src/backtest/量化回测引擎 ⏱️README 强调单次盈利回测不等于有优势每个回测自动附带买入持有基准对比、超额收益、完整交易账本与强制风控离场记录。src/backtest/ 目录结构清晰分层子模块 / 文件职责engine.py / driver.py回测核心引擎与驱动循环loaders/数据加载器CCXT、YFinance、Futu、注册表engines/perp.py永续合约回测引擎metrics.py / benchmark.py绩效指标Sharpe 等与买入持有基准trade_book.py交易账本 JSONL 落盘run_demo.py多币种 Demo 回测入口无需 API keylanggraph_adapter.py让回测复用与实盘相同的 LangGraph 工作流运行入口 src/main.py 是整条 LangGraph 工作流的组装点Agent 注册、状态图构建、路由与执行全部在此编排。src/api/ 与 web/API 层与仪表盘 ️README 提到现代 Web 仪表盘用于遥测与追踪其实现分两层后端— src/api/ 是 FastAPI 路由集合按领域拆分路由文件领域main.py / flow_stream_server.py应用入口与 WebSocket 流式推送backtest_routes.py / signal_routes.py回测任务与信号发布leadpage_routes.py / provider_admin_routes.py公开榜单页与 Provider 管理auth_routes.py / wallet_auth.py账号登录与钱包认证futu 相关路由富途行情/模拟下单/futu 页面前端— web/ 是 Next.js 仪表盘核心页面包括/console— Nexus 控制台实时 Agent 思考流、拓扑图、提示词编辑/backtests— 回测结果资金曲线 交易明细/leaderboard— 榜单与信号/futu— 港股/美股 K 线与模拟盘web-v2/ 为 Vite 版新门户含 MIGRATION_TODO.md 记录迁移进度支撑模块速查表 目录一句话职责src/oms/订单管理系统OMS订单状态机、幂等去重、可选 SQLite 持久化账本src/adapters/交易所适配器纸面交易 Nexus、Hyperliquiddry-run、Futusrc/llm/LLM 客户端、结构化输出解析、决策缓存、工具注册表src/schemas/数据契约Tier-0 JSON 契约、交易意图、Agent 追踪结构src/nexus_data/Nexus 数据源客户端新闻、KOL、OI、资金费率src/tier1/Tier-1 信号参数解析与指标目录组合桥接层src/tools/通用工具技术指标计算、情绪分析工具、API 封装src/memory/ / src/harness/策略记忆与运行记忆src/telemetry/ / src/flow_log.py日志发布与事件流水账本src/storage/榜单结果本地数据库src/config/运行时配置加载策略、运行模式、LLM 模式、OMS 参数三种运行模式同一套工作流 ⚙️docs/run-modes.md 说明backtest/paper/live三种模式共用同一 LangGraph 工作流仅由MODE环境变量切换模式执行方式安全机制backtest纯模拟成交无需真实密钥paper默认Binance 测试网或模拟开发测试推荐live真实下单双闸门AI_MARKET_MAKER_ALLOW_LIVE1才能启动执行层还叠加了多层保险OMS 幂等键、dry-run 守卫、fail-closed不支持的路径在启动时直接报错而非下单时出错。3 步上手阅读代码的路线 从图开始读 docs/langgraph-workflow.md docs/personas/README.md掌握节点顺序与权重表走一遍主干打开 src/main.py跟随 import 顺序看 StateGraph 如何把各节点连起来深入一个交易台任选 src/agents/ 下的一个 Agent对照 docs/personas/ 里对应的人设文档看它如何产出标准 Tier-0 契约本地获取代码git clone https://gitcode.com/gh_mirrors/ai/ai-market-maker cd ai-market-maker uv sync --extra dev 更多资料docs/weight-assigner.md权重合成数学细节、docs/policy-schema.md策略字段全表、openclaw/SKILL.mdOpenClaw 技能集成、PRODUCTION.md生产部署。总结 AI Market Maker 的代码结构可以浓缩为一张公司组织图研究员src/agents/9 个专职感知 Agent 并行输出标准化契约决策会src/workflow/加权合成 桌面辩论全部路径必经风控风控官Risk Guard拥有真实的一票否决权交易员src/oms/src/adapters/多层保险下的订单执行审计室src/telemetry/ 榜单存储全链路追踪可回放这种分层职责 硬性风控的架构是它区别于普通交易机器人的核心也是阅读这个项目最值得借鉴的设计思路 ✅【免费下载链接】ai-market-makerAgentic AI Hedge Fund OS (AIMM)项目地址: https://gitcode.com/gh_mirrors/ai/ai-market-maker创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 一图看懂AI Market Maker：项目代码结构与模块职责全梳理
一图看懂AI Market Maker项目代码结构与模块职责全梳理【免费下载链接】ai-market-makerAgentic AI Hedge Fund OS (AIMM)项目地址: https://gitcode.com/gh_mirrors/ai/ai-market-makerAI Market MakerAIMM是一个开源的 AI 多智能体交易系统让一群AI 交易台像对冲基金一样协作完成行情扫描、信号合成、组合管理与风控否决。本文带你一图看懂它的代码结构与模块职责帮你 10 分钟建立完整的项目地图 ️。为什么先读懂 AI Market Maker 的代码结构AIMM 的设计目标不是一个交易机器人而是一家小型专业交易公司多个专职 AI Agent交易台并行分析市场LangGraph 编排层把它们串成完整工作流Risk Guard风控守卫拥有最终一票否决权量化级纪律中心化策略配置、买入持有基准、全链路可追溯理解了谁负责什么你就能快速定位任何功能在代码里的位置。顶层目录结构一览 项目根目录由 Python 核心 两个前端 配置文档组成各目录职责如下目录 / 文件职责关键词src/核心 Python 逻辑Agent、回测、API、OMS大脑web/Next.js 仪表盘Nexus 控制台、回测、拓扑图展示层 v1web-v2/Vite React 新版门户 UI展示层 v2config/JSON 策略与默认配置策略、权重、运行设置单一事实源docs/工作流、配置、策略 schema、各角色人设文档官方文档openclaw/OpenClaw 技能包SKILL.md 运行脚本技能封装tests/pytest 测试套件单元 E2E质量保障alembic/数据库迁移脚本数据层scripts/平台 worker、榜单发布、筛选器等运维脚本工具配置哲学策略与交易参数放在config/下的 JSON 文件如 config/policy.default.json密钥只放.env详见 docs/configuration.md。src/agents/9 个 AI 交易台核心看点⭐这是 AIMM 最有特色的部分。每个 Agent 都是一个专职研究员统一遵循 src/agents/base_agent.py 定义的输入 → 处理 → 输出 → 反馈契约Agent 文件角色分析什么market_scan.py市场扫描新币、动量、标的池覆盖monetary_sentinel.py宏观哨兵1.1宏观周期 流动性评分news_narrative_miner.py新闻叙事1.2事件影响 叙事新鲜度pattern_recognition_bot.py形态识别2.1图表几何 形态质量statistical_alpha_engine.py统计 Alpha2.2横截面 z-score 信号technical_ta_engine.py技术分析2.3RSI、MACD、ATR 等 TA-Lib 指标retail_hype_tracker.py散户情绪3.1FOMO 指数 背离预警pro_bias_analyst.py机构偏好3.2ETF 流向 资金费率 OI 变化whale_behavior_analyst.py巨鲸行为4.1砸盘概率 筹码集中度默认关闭liquidity_order_flow.py流动性订单流4.2滑点风险 盘口失衡治理与执行类 Agent 单独放在 src/agents/governance/ 下Policy Orchestrator— 策略编排可按权重开关各 AgentRisk Guard— 硬性风控层任何交易执行前都可一票否决Portfolio Management— 多资产配置与提案生成每个 Agent 的详细人设说明书见 docs/personas/ 下的 15 篇角色文档如 14_risk_guard.md。src/workflow/LangGraph 编排层如何串联全流程 ️docs/langgraph-workflow.md 定义了完整的状态机主流程如下policy_orchestrator → market_scan → [9 个 Tier-0 Agent 并行] → risk → desk_debate → signal_arbitrator → portfolio_proposal → risk_guard → portfolio_execute → auditdocs/personas/README.md 用一张表总结了各节点职责与默认权重例如 2.3 技术分析权重 0.30 最高1.1 宏观仅 0.05。src/workflow/ 目录中的关键模块模块职责weight_assigner.py把 9 个 Agent 的因子信号归一化到 [0,1]加权合成全局得分weighted_arbitrator.py默认仲裁引擎确定性数学零 LLM 成本desk_debate.py多空证据线辩论环节routing.py条件路由所有路径都必须汇聚到 Risk Guardexecution_intent.py从仲裁结果派生交易意图决策阈值BUY / SELL / HOLD与对齐门控逻辑详见 docs/weighted-arbitrator.md。src/backtest/量化回测引擎 ⏱️README 强调单次盈利回测不等于有优势每个回测自动附带买入持有基准对比、超额收益、完整交易账本与强制风控离场记录。src/backtest/ 目录结构清晰分层子模块 / 文件职责engine.py / driver.py回测核心引擎与驱动循环loaders/数据加载器CCXT、YFinance、Futu、注册表engines/perp.py永续合约回测引擎metrics.py / benchmark.py绩效指标Sharpe 等与买入持有基准trade_book.py交易账本 JSONL 落盘run_demo.py多币种 Demo 回测入口无需 API keylanggraph_adapter.py让回测复用与实盘相同的 LangGraph 工作流运行入口 src/main.py 是整条 LangGraph 工作流的组装点Agent 注册、状态图构建、路由与执行全部在此编排。src/api/ 与 web/API 层与仪表盘 ️README 提到现代 Web 仪表盘用于遥测与追踪其实现分两层后端— src/api/ 是 FastAPI 路由集合按领域拆分路由文件领域main.py / flow_stream_server.py应用入口与 WebSocket 流式推送backtest_routes.py / signal_routes.py回测任务与信号发布leadpage_routes.py / provider_admin_routes.py公开榜单页与 Provider 管理auth_routes.py / wallet_auth.py账号登录与钱包认证futu 相关路由富途行情/模拟下单/futu 页面前端— web/ 是 Next.js 仪表盘核心页面包括/console— Nexus 控制台实时 Agent 思考流、拓扑图、提示词编辑/backtests— 回测结果资金曲线 交易明细/leaderboard— 榜单与信号/futu— 港股/美股 K 线与模拟盘web-v2/ 为 Vite 版新门户含 MIGRATION_TODO.md 记录迁移进度支撑模块速查表 目录一句话职责src/oms/订单管理系统OMS订单状态机、幂等去重、可选 SQLite 持久化账本src/adapters/交易所适配器纸面交易 Nexus、Hyperliquiddry-run、Futusrc/llm/LLM 客户端、结构化输出解析、决策缓存、工具注册表src/schemas/数据契约Tier-0 JSON 契约、交易意图、Agent 追踪结构src/nexus_data/Nexus 数据源客户端新闻、KOL、OI、资金费率src/tier1/Tier-1 信号参数解析与指标目录组合桥接层src/tools/通用工具技术指标计算、情绪分析工具、API 封装src/memory/ / src/harness/策略记忆与运行记忆src/telemetry/ / src/flow_log.py日志发布与事件流水账本src/storage/榜单结果本地数据库src/config/运行时配置加载策略、运行模式、LLM 模式、OMS 参数三种运行模式同一套工作流 ⚙️docs/run-modes.md 说明backtest/paper/live三种模式共用同一 LangGraph 工作流仅由MODE环境变量切换模式执行方式安全机制backtest纯模拟成交无需真实密钥paper默认Binance 测试网或模拟开发测试推荐live真实下单双闸门AI_MARKET_MAKER_ALLOW_LIVE1才能启动执行层还叠加了多层保险OMS 幂等键、dry-run 守卫、fail-closed不支持的路径在启动时直接报错而非下单时出错。3 步上手阅读代码的路线 从图开始读 docs/langgraph-workflow.md docs/personas/README.md掌握节点顺序与权重表走一遍主干打开 src/main.py跟随 import 顺序看 StateGraph 如何把各节点连起来深入一个交易台任选 src/agents/ 下的一个 Agent对照 docs/personas/ 里对应的人设文档看它如何产出标准 Tier-0 契约本地获取代码git clone https://gitcode.com/gh_mirrors/ai/ai-market-maker cd ai-market-maker uv sync --extra dev 更多资料docs/weight-assigner.md权重合成数学细节、docs/policy-schema.md策略字段全表、openclaw/SKILL.mdOpenClaw 技能集成、PRODUCTION.md生产部署。总结 AI Market Maker 的代码结构可以浓缩为一张公司组织图研究员src/agents/9 个专职感知 Agent 并行输出标准化契约决策会src/workflow/加权合成 桌面辩论全部路径必经风控风控官Risk Guard拥有真实的一票否决权交易员src/oms/src/adapters/多层保险下的订单执行审计室src/telemetry/ 榜单存储全链路追踪可回放这种分层职责 硬性风控的架构是它区别于普通交易机器人的核心也是阅读这个项目最值得借鉴的设计思路 ✅【免费下载链接】ai-market-makerAgentic AI Hedge Fund OS (AIMM)项目地址: https://gitcode.com/gh_mirrors/ai/ai-market-maker创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考