测试套件正在重建中（详见
codex.md修订记录与apps/backend/tests/test_v252_regression.py）。 在 CI 接入 pytest + mypy + 前端 build 之前，请勿据 README 徽章判断当前发布状态。
定位：聚焦 A 股中短期（5~22 交易日） 的个人量化研究与实盘决策辅助系统。 关键边界：系统不接入券商交易接口，所有"实盘"建议均为离线参考，由用户人工下单执行（系统决策、人工拍板）。 技术栈：Vue 3 + FastAPI + 多源行情（腾讯/新浪/东财/Baostock/efinance/AKShare） + SQLite WAL（Redis 可选） + 8 家 LLM 提供商。
一个完整的「数据 → 因子 → 回测 → 实盘建议 → 模拟跟踪 → 复盘」决策闭环：
数据采集(6源冗余) → 因子工作台(150+因子) → 回测验证(T+1/成本/OOS)
↑ ↓
复盘分析(D+1回填) ← 实盘交易桌(限价/调仓/出价) ← 风险评估(VaR/压测)
↓
【人工实盘下单】
完整的功能说明、模块剖析、API 参考、数据流与部署细节，见详细技术文档：
| 文档 | 说明 |
|---|---|
| docs/TECHNICAL_DOCUMENTATION.zh-CN.md | 详细技术文档（中文）—— 架构、模块、数据流、因子、回测、API、部署、检视发现 |
| docs/TECHNICAL_DOCUMENTATION.en.md | Detailed technical documentation (English) |
| CHANGELOG.md | 版本演进历史 |
| 依赖 | 版本 | 安装 |
|---|---|---|
| Python | 3.9+（开发实测 3.9.6） | brew install python |
| Node.js | 18+ | brew install node |
cd /path/to/quant
./start.sh start # 自动建虚拟环境、装依赖、启动前后端并打开浏览器
./start.sh stop # 停止全部服务
./start.sh restart # 重启
./start.sh status # 运行状态
./start.sh logs # 日志启动后访问：
- 前端界面：http://localhost:3001
- 后端 API 文档（Swagger）：http://localhost:8002/docs
- 健康检查：http://localhost:8002/health
docker compose up -d # backend + frontend + redis
docker compose --profile observability up -d # 额外启动 loki/promtail/grafana 日志聚合复制 apps/backend/.env.example 为 apps/backend/.env，按需填写 LLM API Key、飞书推送、认证 Token 等。
也可在前端「系统设置」页面直接配置 LLM Key，无需重启。详见技术文档「配置与部署」章节。
侧边栏按量化研究员的日常工作流分组（apps/frontend/src/utils/constants.ts）：
| 分组 | 页面 |
|---|---|
| 今日概览 | 市场行情、市场情报 |
| 因子工坊 | 因子工作台、选股策略、因子库、因子实验室、Alpha101 |
| 策略验证 | 回测系统、多策略对比 |
| 复盘分析 | 策略复盘 |
| 行情监控 | 自选股、个股详情 |
| 实盘决策 | 实盘交易桌、交易面板、模拟交易、资产配置 |
| 系统 | 告警中心、系统状态、设置 |
- 不接入券商：所有建议都是离线参考，用户手动下单，对每笔交易完全掌控。
- 成本透明：佣金（万 1.5）+ 过户费（万 1）+ 印花税（万 5，仅卖出）+ 按流通市值分档滑点。
- 数据可信：6 源冗余 + CircuitBreaker 熔断 + 新鲜度检查 + 存活偏差过滤。
- 决策可复现：随机种子 + 运行时版本记录 + 因子方案版本管理。
模拟交易仅供学习研究，不构成真实投资建议。A 股配色：红涨绿跌。
MIT License