PROJECT / 004
西楚量化交易系统
XichuQuant · Quantitative Trading & Risk Management
开源量化研究、持仓风险与内部模拟交易系统。在线演示使用虚构账户与合成行情,提供源码、安装文档和教学提示词。
项目简介
XichuQuant 是用 AI 辅助开发的量化研究、交易风险控制与内部模拟交易系统。Web、API、Quant Engine、Broker Connector 与 SQL Server 分工运行。当前公开版本固定源码提交 a27fae080c0d8b4a328499bcb78d96b77d0087ba;在线 Demo 只读,适合浏览软件界面与虚构业务案例。
实际截图
以下为当前公共 Demo 的真实浏览器截图,全部使用虚构演示数据。点击可查看完整画面。
核心能力
- 账户与持仓:查看虚构演示账户、现金、仓位和风险总览。
- 风险纪律:杠杆 ETF 仓位、风险主题有效敞口、浮亏和告警。
- 策略与回测中心:浏览策略和现有记录;本地独立 Demo 可按指南执行合成回测。
- 内部 Paper 与事故复盘:展示独立模拟账户、策略部署和种子事故案例。
- 访客认证:独立 Session、CSRF 和退出隔离,公开业务写入均被禁止。
项目架构
- Next.js / React
- NestJS / Prisma API
- Python / FastAPI Quant
- SQL Server · Broker OFFLINE
从源码到上线
- 获取固定提交源码并核对环境
- 创建自己的隔离 Demo 数据库
- 按指南导入虚构 Seed 并验证真实数据
- 在本地练习回测与内部 Paper,保留来源与恢复证据
部署说明
公开 Demo 使用独立 Docker 项目、数据库、卷和私有网络,只有专用 Nginx 接入现有 HTTPS 网关。原生 SQL 备份、加密 R2 异地备份和真实隔离恢复已验证;自行安装请使用仓库指南。
公共 Demo 部署指南 ↗当前范围与限制
- 公共 Demo 是只读展示;原始种子没有已执行回测记录,不伪造收益或成交。回测与写入练习需要自己的隔离环境。
- 内部 Paper 与 IBKR Paper 是不同账本;当前公开环境的全部券商下单能力关闭。
- 合成数据不构成真实历史盈利证据,页面用于软件学习,不保证收益。
- 当前源码的浏览器请求超时较短,弱网络可能暂时无法加载;会话到期后重新进入演示。
COPY & BUILD
视频配套提示词
以下根据固定源码提交与安装、Demo 和部署文档整理,为重建的教学示例,不是原始历史会话或 Episode 007 成片。逐组复制,先阅读现有代码,再在自己的隔离环境练习。
将工作目录设为自己的学习仓库,固定源码提交 a27fae080c0d8b4a328499bcb78d96b77d0087ba。公开 Demo 仅供只读浏览;需要写入、回测执行或内部 Paper 练习时,使用自己的独立 Demo 数据库。
推荐顺序 P01 → P02 → P03 → P04 → P05。P06 只用于准备自己服务器的部署计划。
P01核对现有源码与系统边界
从真实仓库确认服务、数据来源和已实现功能,避免重新生成已有系统。
请先检查当前 XichuQuant 学习仓库的 Git 提交与工作树,固定 a27fae080c0d8b4a328499bcb78d96b77d0087ba,阅读 README 与 docs/LOCAL_INSTALLATION_GUIDE.md。不要自动切换有未提交修改的工作树。 列出 Next.js Web、NestJS/Prisma API、Python Quant Engine、TypeScript Broker Connector 与 SQL Server 的实际关系;定位 Dashboard、持仓、风险、回测与内部 Paper 的页面、接口和数据表。已有源码先检查,不重新生成;空目录先给出最小学习路线,等待选择来源。 区分 DEMO、SYNTHETIC、HISTORICAL、INTERNAL_PAPER 与外部 IBKR Paper。保持 Broker OFFLINE/DISABLED、TWS read-only,不输入券商密码、不执行外部订单,不把合成回测说成历史盈利。 验收输出实际源码身份、服务和模块映射、只读公共体验与本地写入练习的区别,以及仍需实际验证的项目。不要沿用文档里的旧验收数量。
P02运行自己的隔离 Demo 数据库
核对环境、独立库和虚构 Seed,再用真实页面与接口证明数据已加载。
请按 docs/LOCAL_INSTALLATION_GUIDE.md 在我的隔离学习环境运行 XichuQuant。先核对 Node、pnpm、Python、SQL Server 与 sqlcmd 的实际版本和监听地址,不擅自改全局环境。 只使用全新的 XichuQuantDemo_local 数据库和独立私有环境文件。确认库名、目标身份和空库条件后才初始化、迁移和导入虚构 Seed;已有库不能 reset、清空、删卷或覆盖。秘密使用本地受保护配置,不放进 Git、截图或命令参数。 配置 DEMO 数据、明确 CREATE_FICTIONAL_DEMO,Broker OFFLINE/DISABLED、TWS read-only,外部账号、白名单和地址留空。按文档先 CheckOnly,再显式初始化,随后启动生产入口和健康检查。 实际登录后核对 Dashboard 非空、虚构账户、DLA2/DLB2 持仓与 SYNTHETIC 行情;比较接口与页面,不能用前端 Mock 掩盖 API 失败。验收记录独立库名、健康、真实账户/持仓数量及重复 Seed 是否保留已有数据;不输出密码或 Cookie。
P03验证持仓与风险统计
用虚构案例检查仓位、风险主题与告警,不放宽保护规则来制造通过。
在自己的隔离 XichuQuant Demo 中检查账户风险总览、持仓与风险纪律模块。先定位实际 Risk Engine 与测试,沿数据库 → API → 页面核对金额和来源。 用虚构 DLA2/DLB2 案例检查杠杆 ETF 仓位、现金占比、风险主题有效敞口、浮亏与已实现盈利的关系;核对告警、阈值和建议动作是否来自相同快照。没有可信账户数据时应明确不可用,不能显示正常或把零值当真实账户。 只在本地专用库验证边界与拒绝场景,公开 Demo 仅浏览。不能修改真实账户、引入外部行情、关闭风控或制造虚假的真实盈利。 验收输出实际输入、计算结果、接口来源标记、页面一致性和相关测试通过/失败/跳过数。发现问题先复现,修复范围限定到具体缺陷,不重构全站。
P04练习合成回测与内部 Paper
在自己的可写 Demo 学习回测与账本,公开只读站不执行任务。
请阅读 docs/DEMO_MODE.md,检查自己的隔离 Demo 环境具备真实 Quant Engine、独立数据库与 Broker OFFLINE。公开站只读,不能用公开站进行以下写入练习。 按现有文档使用 BUY_AND_HOLD_AAPL、AAPL、2025-01-02 至 2025-06-30、SEED_V1_3 的合成行情,执行现有回测流程。核对参数、数据来源、实际任务状态与结果,不手工填写曲线或盈利数。 内部 Paper 使用独立虚构账户、审批、资金分配、Stop 和退出条件,验证风险门禁、实际内部 Fill、重复任务幂等与账本隔离;拒绝时报告具体原因,不放宽规则。禁止连接 IBKR Gateway 或提交外部订单。 验收记录真实回测与内部账本输出,并说明 SYNTHETIC 结果不是历史盈利证据。原始 Seed 没有已运行回测时如实显示空列表,不伪造结果。
P05验证只读访客、会话与真实界面
用两个独立访客检查登录、退出、来源标记和写请求拒绝。
请按 docs/PUBLIC_DEMO_DEPLOYMENT_PLAN.md 检查我已授权的隔离公共 Demo 候选环境。记录固定源码、独立库和部署配置,保持 PUBLIC_DEMO_READ_ONLY=true、DEMO/SYNTHETIC、Broker OFFLINE/DISABLED 与 TWS read-only。 实际打开两个独立浏览器会话:A 登录后 B 登录,A 仍可读取;B 退出后 A 不受影响。检查 Secure/HttpOnly/SameSite、Origin、Session 与 CSRF,不输出 Cookie。测试无会话或失效会话访问应回到明确入口,不能展示虚假的空账户。 只在已授权的候选 Demo 验证上传、交易、同步、回测执行及其他业务写请求被拒绝。保持 SQL/API/内部服务无公网端口,校验受信 HTTPS 和真实代理 IP。 在 1440px 与 390px 检查 Dashboard、持仓、风险、策略、回测中心、内部 Paper 和事故复盘;核对实际 API 数据与来源、图片/导航及横向溢出。输出本轮真实测试数量、截图和未解决问题,不用健康检查替代页面验收。
P06准备自己的 Docker 发布与恢复计划
固定版本、资源、私网、备份和回滚,在写服务器前先形成可审查方案。
我准备把本地验收的 XichuQuant Demo 部署到自己的 Linux x86-64 服务器。先阅读 docs/DOCKER_LOCAL_DEPLOYMENT.md 和 docs/PUBLIC_DEMO_DEPLOYMENT_PLAN.md,本组只授权环境检查与计划,不自动执行服务器写入。 固定干净 SHA,检查现有容器、RAM、磁盘、网络和域名。使用独立 Compose project、独立 XichuQuantDemo_* 数据库/卷/internal 网络;数据库和内部服务不开放公网,仅专用反代接 HTTPS 网关。明确 CPU/RAM 与 10 MiB × 3 日志上限,顺序构建并限制构建器资源,先等 SQL healthy 再启动 API。 使用私有强凭据,Broker OFFLINE/DISABLED、TWS read-only,不配置真实账号或 Gateway。发布前核验原生 SQL COPY_ONLY/CHECKSUM 备份、配置与镜像/源码身份,准备实际异地下载和新库隔离恢复,禁止覆盖现有数据库。 计划包含只读与双访客检查、公开 HTTPS、桌面/手机、重启持久化及受保护旧服务对比。失败仅撤销新路由并停止本项目,保留卷;不执行全局 down/prune。输出具体步骤、恢复与回滚入口、已验证事实和待执行项,待我批准实际目标后再发布。
所有练习只用 DEMO / SYNTHETIC 数据,Broker OFFLINE、TWS read-only。合成行情不构成真实历史收益证据,不接入真实账户,不提交外部订单。
对应视频
Coming Soon · 视频尚未发布。



