# 自主交易控制中心交付说明

生成日期：2026-08-02

## 展示入口

- 公网入口：`https://seekingquant.netlify.app/execution`
- 门户一级导航：`自主交易`
- 页面权限：公开只读，任何公网访客都不能提交或撤销订单。

## 本次完成的组件

1. **控制中心页面**：把实盘行情、V2 信号、风险闸门、订单状态机、Alpaca Paper 账户、成交对账和未来实盘网关放在一张控制台中。
2. **Paper Trading 只读连接**：从 Alpaca Paper Trading API 读取账户权益、现金、购买力、市场时钟、持仓和最近 20 个订单；缓存 5 秒，网页每 2 秒刷新状态。
3. **订单状态机**：将券商订单状态归并为 `WORKING`、`PARTIAL`、`TERMINAL` 和 `ATTENTION`，为部分成交、撤单、拒单和异常对账提供统一入口。
4. **Paper 自动下单适配器**：源代码已完成，仅支持 SPY、QQQ、GLD 的常规时段 `day` 限价单，单笔名义金额不超过 5,000 美元，并要求云端武装开关和私有确认值同时成立。
5. **实盘网关展示**：既有实盘适配器接入前置检查面板；真实券商密钥、运行时武装和动作确认均未配置，因此保持 `LIVE LOCKED`。
6. **审计档案**：控制中心源码、Paper 券商适配器、订单状态机和本说明均同步到成果档案。

## 当前运行模式

| 层级 | 当前状态 | 是否下单 |
|---|---|---:|
| V2 影子策略 | 使用 Alpaca IEX 实盘分钟行情运行 | 仅内部模拟撮合 |
| Alpaca Paper | 账户、持仓和订单只读同步 | 否 |
| Alpaca 实盘 | 硬锁定 | 否 |

公开接口 `/api/execution/status` 只接受 `GET`；其他方法返回 `405`。当前公开写入接口数量为 0，门户提交的 Paper 和实盘订单数量都固定报告为 0。

## 为什么暂不直接开启真实资金

自主交易程序能自动发送订单，不代表策略已经达到适合真实资金的证据门槛。启用前还需要完成 Paper 自动下单的拒单、部分成交、撤单、重试、幂等和断线恢复验证，随后至少连续观察 20 个交易日，并完成更长样本外验证。真实资金还必须使用与 Paper 完全分离的密钥、极小资金和人工可见的总开关。

## 官方参考

- Alpaca Trading API 入门：https://docs.alpaca.markets/us/docs/getting-started-with-trading-api
- Paper Trading 限制：https://docs.alpaca.markets/us/docs/paper-trading
- 订单生命周期：https://docs.alpaca.markets/us/docs/orders-at-alpaca
- Trade Updates WebSocket：https://docs.alpaca.markets/us/docs/websocket-streaming