使用说明
AI交易员
自主期权交易平台，用于纸面交易信号评估、风险审查、合约选择、经纪商执行、头寸监控和运营商监督。
版本1是第一个经过验证的自主交易基线。它成功执行、监控和关闭了羊驼纸交易期权头寸，同时保留了持久的自动化记录和驾驶舱可见性。
当前版本
- 基线标记：
v1.0-autonomous-trading - 硬化释放标签：
v1.0.1-production-hardened - 环境验证：羊驼纸交易
- 当前开发部门：
feature/trading-intelligence-engine - 当前发布候选：AI Trader Enterprise RC1/PR#59（标签
v2.0.0-enterprise) - 企业发布报告：
docs/release/AI_TRADER_ENTERPRISE_RC1.md
RC1是一个纸质交易发布候选。它不适合实时货币部署。
核心工作区
- 交易：图表第一手动交易工作区和订单。
- 扫描器：市场和期权发现工作流程。
- 投资组合：账户级头寸、余额、订单、购买力、历史和自动化指挥中心。
- 驾驶舱：一个主动的自动化拥有的期权交易、实时报价状态、退出策略、执行状态和人工智能持有原理。
- 实验室：战略研究和回溯测试工作流程。
- 自动化指挥中心：会话控制、观察列表状态、风险状态、操作恢复和自动化健康状况。
- 交易智能：第2版报告、分析和研究层。
V1功能
- 自主信号评估。
- 在经纪商提交之前进行确定性风险审查。
- 期权合约选择与选择/拒绝归因。
- 羊驼纸经纪商通过自动化执行边界提交订单。
- 持久的订单意图和经纪商订单持久性。
- 计划和监控租约以保护重复执行。
- 通过经纪人对账进行头寸监控。
- 自动退出处理、超时取消和夜间恢复。
- 驾驶舱活跃的贸易展示，共享报价所有权和诚实的不可用状态。
- 项目组合同步和自动化指挥中心操作。
- 结构化日志记录和请求边界编辑。
安全边界
版本1刻意保留了这些边界：
- 自动化条目需要市场/时段门、干净对账和非活动紧急停止。
- 在已验证的自动化路径中，实时代理配置被拒绝。
- 驾驶舱或操作员控制装置不会绕过经纪人对账。
- 执行、风险、代理、GPT提示、交易评估和Mongo模式行为在V1版本中被冻结。
- 计划用于版本2的AI Coach仅供参考，不得自动更改生产交易规则。
本地验证
从存储库根运行V1版本检查：
npm --prefix client test
npm --prefix client run build
npm --prefix server run build
npm --prefix server run test
npm --prefix server run test:automation
npm run test:dev
npm audit --omit=dev
git diff --check
一些服务器自动化和开发平台测试绑定本地端口。在受限的沙盒中，它们可能需要在沙盒外运行。
文档地图
- 架构概述：
docs/architecture/v1-system-overview.md - 首个自主贸易里程碑：
docs/milestones/2026-07-16-first-autonomous-trade.md - 生产硬化报告：
docs/hardening/2026-07-17-v1-production-hardening.md - V1.0.1发布准备检查表：
docs/releases/v1.0.1-production-hardened.md - 产品/Figma交接：
docs/product/figma/README.md - 自动化生命周期文档：
docs/automation/ - 版本历史：
docs/VERSION_HISTORY.md - 路线图：
docs/ROADMAP.md - 交易情报计划：
docs/plans/trading-intelligence-engine.md - 交易时段捕捉：
docs/features/trading-session-capture.md - 贸易情报报告：
docs/features/trade-intelligence-reports.md - 每日情报报告：
docs/features/daily-intelligence-reports.md - 决策日志：
docs/features/decision-journal.md - 决策智能引擎：
docs/decision-engine/README.md - 事件智能引擎：
docs/event-intelligence/README.md - 战略协调人：
docs/strategy-orchestrator/README.md - 企业风险智能引擎：
docs/risk-engine/README.md - 企业贸易生命周期经理：
docs/trade-lifecycle/README.md - 自主交易集成：
docs/autonomous-trading/README.md - 企业学习智能：
docs/learning/README.md - Vercel前端可观察性：
docs/vercel/README.md - 战略分析：
docs/features/strategy-analytics.md
本地开发
根据需要在每个包内安装依赖项：
npm --prefix client install
npm --prefix server install
npm install
启动完整的开发平台：
npm run dev
共同关注的开始：
npm run dev:frontend
npm run dev:backend
npm run dev:trading
每一层都读取自己的环境文件。永远不要提交真正的API密钥、代理凭据、数据库凭据、身份验证令牌或本地机密。
部署
此项目使用本机构建包进行部署：
- 后端：从渲染节点服务
server/ - 前端：Vercel Vite应用程序
client/
渲染后端：
Build command: npm install && npm run build
Start command: npm start
Health check: /health
按名称列出的必需渲染环境变量：
NODE_ENV=productionPORTCORS_ORIGINSFRONTEND_ORIGINMONGO_URI或MONGODB_URIMASSIVE_API_KEYMASSIVE_BASE_URLMASSIVE_SUBSCRIPTION_PROFILEMASSIVE_OPTIONS_WS_URLMASSIVE_OPTIONS_WS_ENABLEDMASSIVE_STOCKS_WS_ENABLEDAPCA_API_KEY_IDAPCA_API_SECRET_KEYAPCA_API_BASE_URLAPCA_DATA_BASE_URLALPACA_PAPERALPACA_DATA_FEEDALPACA_OPTION_FEEDOPENAI_API_KEYOPENAI_MODELAUTH_JWT_SECRET
Vercel前端：
Build command: cd client && npm install && npm run build
Output directory: client/dist
按名称列出的必需Vercel环境变量：
VITE_API_BASE_URL仅适用于无法使用的非标准托管环境 Vercel重写了相同的起源VITE_AUTH_TOKEN仅当使用本地/dev令牌流时VITE_AUTH_ROLE仅当使用本地/dev令牌流时
对于标准的Vercel部署，生产捆绑包使用相同的源代码
/api/*, /health，以及 /socket.io/* 重写。不嵌入渲染后端
或者前端包中的本地主机URL。后端 CORS_ORIGINS 和
FRONTEND_ORIGIN 值必须包括Vercel前端原点。
大规模权利状态
当前验证的Massive配置文件为 options-advanced:
- 需要实时选项REST和选项WebSocket。
- 实时股票WebSocket不包括在内，默认情况下是禁用的。
- 根据此配置文件，当日股票日内汇总不被授权。
- 通过选项快照显示的基础数据必须标记为延迟。
- 应用程序不得显示
LIVE对于来自延迟快照的数据， 过时的缓存、断开连接的套接字或未经授权的端点。
发布状态
建议：RC1仅针对自主票据交易验证。
实时货币交易前的已知限制：
- 生产认证和授权。
- 暴露端点的速率限制和安全标头。
- 实时经纪人运营审批和控制。
- 任何历史秘密泄露的凭证轮换确认。
- 报价套接字、自动化可见性和代理恢复的负载/浸泡测试。
- 交换假期和提前关闭的日历测试语料库。
免责声明
AI Trader是用于研究和纸质交易自动化的软件。它不提供财务、投资、法律、税务或交易建议。纸面交易结果不是实时货币表现。在依赖任何输出之前，您有责任验证数据、系统行为、代理配置、监管义务和运营风险。
