sanguo/sanguo_vnpy_v2
2
0
Fork 0
Code Issues 5 Pull Requests Actions Packages Projects Releases Wiki Activity
203 Commits 4 Branches 1 Tag
ee273136449164bd5d48a80fc8fa9bd51fdbcfb0
Commit Graph

40 Commits

Author SHA1 Message Date
claude_dev 37c850d0c5 docs(deploy): VPS统一部署权威文档(取代vps-native-brain,覆盖07-17全统一架构) 2026-07-17 08:10:04 +08:00
claude_dev 3ef8c617f0 feat(deploy): VPS原生大脑部署—env覆盖配置+部署文档(Option B落地) 
- sanguo_data/config.py: load_config 加 env 覆盖(SANGUO_DATA_ROOT 重映射
  daily/raw/qfq/15min/vnpy_db;SANGUO_LIVE_ENABLED/SANGUO_BRIDGE_URL 覆盖 live 段),
  三机共用一份 git config 零漂移
- sanguo_api/main.py: build_app 加 SANGUO_DB_PATH/SANGUO_FILE_PATH env 覆盖
- docs/deployment/vps-native-brain.md: VPS原生部署全记录(安装/配置/服务/验证/
  数据staging/Phase2暂缓理由)

实证:VPS vnpy4.4.0+vnpy_qmt0.3.3 连真实miniQMT读真实账户/持仓;
live_step全链路+影子transport(本机bridge)通过。详见文档。
 2026-07-15 12:55:58 +08:00
claude_dev c66f7cb14e chore(deps): 锁三机统一依赖基线(Python3.10+pandas2.3/numpy2.2新稳定版, requirements-lock.txt) 
依据：
- vnpy 4.4.0 pyproject: numpy>=2.2.3 / pandas>=2.2.3（均无上限，不钉<3）
- pandas 目标=2.3.3（2.x 稳定线顶端，3.0 破坏性变更未回归，按稳定优先不采用）
- numpy 目标=2.2.6（与 TA-Lib 0.6.8 在 NAS 生产容器实证兼容）
- 其余依赖==钉到 NAS 容器已验证可跑版本（fastapi 0.139/uvicorn 0.49/polars 1.42 等）
- Python 3.10 三机统一基线（xtquant 限 3.6-3.12，VPS 锁 3.10）
- 不含 vnpy（源码引用）/ xtquant（VPS Windows only）/ CUDA（torch 传递依赖）
- 矩阵文档新增「锁定决策(2026-07-15)」小节：依据+迁移步骤+验证前置
- 验证前置：落生产前须全套 pytest 0 回归 + 一个 CTA 回测冒烟
 2026-07-15 08:12:40 +08:00
claude_dev 54f9ab4c4f docs(deploy): VPS生产runbook+三机环境矩阵+NAS ops脚本+修rsync危险命令 
vps-production-runbook(VPS运维一站式,已验证状态+拓扑+发布流水线+人类闸口+排障); env-version-matrix(三机Python/deps矩阵+Lock建议); scripts/ops(NAS bridge探针-容器无curl-+VPS→NAS备份脚本); nas-deploy-plan§3(修rsync --exclude语法,原会删万级staging parquet+破坏entrypoint启动).
 2026-07-15 07:12:46 +08:00
claude_dev 8d55e414fa fix(backtest): A股适配层—定寸/做空拦截/真实费用/口径统一(Phase1+2) 
审计发现包装层系统性失真(2 CRITICAL+7 HIGH)，vnpy底座可信但A股场景未适配：
- C1 定寸: engine.size=N(满仓手数)，策略volume=1手=N股，开平对称(pos归零)
- C2 做空拦截: SHORT+OPEN拒单，long-only，SHORT+CLOSE平多允许
- H3 A股费用: AShareDailyResult重算(佣金保底5元/印花税卖方/过户费沪市)
- H4 收益口径: simple return从balance算(不再用vnpy log return喂empyrical)
- H5+口径: benchmark ffill对齐不缩样本; sizing_shares_per_lot暴露
- H7 退化检测: 零成交/空数据标degenerate不静默done
- H8 task_id: optimize/factor用uuid4(原id()内存地址)
- 静默except改warning

验证: 容器内真实vnpy DoubleMa 600000 2022-2024, total_return 1e-6→42.3%,
end_balance 100万→142万, SHORT+OPEN成交0笔, N=7800股/手.
22 backtest测试全绿(含集成测试), API健康200.
 2026-07-12 23:39:45 +08:00
claude_dev cf4b3a2cb0 feat(data): 15min数据补全—路径参数化+cron入口+回填+设计文档 
- download_minute.py: STOCK_ROOT环境变量参数化(Mac/NAS兼容); 修tencent备源amount聚合 last→sum
- refresh_15min_daily.py: 新建cron入口(交易日判断baostock/直连pop代理/日志)
- 回填470缺口(170 SH/SZ成功, 300 BSE源不支持)
- docs/data/15min-data-design.md: 15min数据层设计文档(源/覆盖/脚本/刷新/约束/路径映射)
 2026-07-12 08:26:30 +08:00
claude_dev e1b8c4ac68 docs(plan): 富回测结果页实施计划—8任务TDD(metrics→数据→引擎→API→前端→部署) 2026-07-11 13:20:30 +08:00
claude_dev 6c461d4d9c docs(spec): 富回测结果页设计(v1)—聚宽级10指标+5图+4tab, empyrical后端算相对基准指标 2026-07-11 13:16:49 +08:00
claude_dev 928a52b96f docs(live): D期§8更新—D-2含bridge完善+半自动更新, D-4b加120141诊断, 运维发现(120141/行情关/重连/token分离) 2026-07-11 08:33:51 +08:00
claude_dev aef46124b6 docs(deploy): Windows clone改sparse checkout只拉sanguo_qmt_bridge(不全量) 2026-07-11 08:07:32 +08:00
claude_dev 8f51b026fa docs(deploy): Windows bridge部署+半自动更新一站式md(git clone+update.bat, 照着做) 2026-07-11 07:48:41 +08:00
claude_dev a93d5ed8d8 docs(live): D期§8状态更新—D-1/D-2/D-3/D-4a/D-4c验证通过, 仅D-4b等周一 2026-07-11 06:31:53 +08:00
claude_dev 379836d34e docs(live): D期任务状态更新(D-1/D-3完成)+Windows部署联调清单 
- 设计文档§8: D-1/D-3标✅代码完成+commit号, D-2/D-4待Windows, 附代码层验证说明
- d-phase-windows-deploy.md(新): Windows端一站式清单(D-1实测/D-2自启/D-4a联调/故障排查)
 2026-07-11 00:07:18 +08:00
claude_dev ff84b3d4b0 feat(live): D-3 sanguo实盘分支(影子下单)+D期设计文档 
D-3 模式A影子下单(spec §5):
- bridge_client.py: QMT bridge HTTP客户端(urllib, X-Bridge-Token, 失败不抛返回None)
- live_orchestrator: _shadow_trades_to_bridge 当日成交POST bridge(默认enabled=false)
- persistence: paper_shadow_orders幂等表+save_shadow_order/is_trade_shadowed
- config: data_platform.yaml加live段, token走env(BRIDGE_TOKEN)
- to_bridge_code symbol转换与guess_exchange一致(2位前缀)
安全: enabled=false默认关+token走env+幂等防重复+影子失败不阻断live_step

docs: phase3d-live-trading-design.md(D期完整设计)
 2026-07-11 00:03:46 +08:00
claude_dev 7c7976221b docs(spec): phase3c-design §295分期项标记完成(分红送股+占用成本落地) 2026-07-10 08:46:14 +08:00
claude_dev 86a7f8ef2d docs+fix(data): run_daily_update重写raw+qfq增量 + daily-update-design v3双源 
- run_daily_update.sh: 重写raw+qfq增量(跳daily_all_update新浪坏接口KeyError:date,
  持久路径data_cache/daily_update不进tmp, set -uo pipefail不-e); C-S3每日raw(撮合)+qfq(warmup)
- daily-update-design.md: v3.0变更记录+十六节(双源raw/qfq架构/脚本更新清单/launchd15:30部署/准确性验证/与v2关系)
- config/data_platform.yaml: minute_15_qfq_dir/minute_15_raw_dir(15min双源目录)
 2026-07-10 08:16:41 +08:00
claude_dev 1ed7b72aca feat(data): raw真实价数据源(task#79)—raw_dir+dir_key路由+新浪源重下 
根因: daily_dir mixed-adjust(hfq bulk+akshare raw tail)致3-30 -94%假跌。
方案(Linus三问简化单raw, 除权留分期项#3):
- datareader read_parquet_daily/15min 加 dir_key 参数
- data_source iter_bars/fetch_day: adjust=raw→raw_dir(缺配置报错防混源), qfq→daily_dir
- engine PaperEngine 默认 adjust=raw
- config 加 raw_dir; scripts/raw_redownload.py 新浪源adjust='' 直连+单线程限速
- 验证: 浦发606行close 6.5/14.6 mean10.08 0跳变, 撮合成交价9.71-10.25真实
- 测试9/9+trader全量108/108通过
 2026-07-07 22:19:11 +08:00
claude_dev fc39b549cf docs(data): 补齐数据脚本文档(v1调研5文档复制+11脚本清单表) 2026-07-07 20:00:50 +08:00
claude_dev 1a88954126 feat(data): v2 数据下载(SSH模式 STOCK_MOUNT+rsync) + launchd定时 + 文档 
- v1 data_platform 脚本复制到 v2/scripts/data_platform/ 维护
- daily_all_update.py: 路径用 STOCK_MOUNT env(SSH模式) + STOCK_LIMIT(验证)
- run_daily_update.sh: rsync拉NAS→本地 + v1增量 + 推NAS(SSH key免密,不挂载)
- launchd com.sanguo.data-update 每日15:30(替代crontab,macOS FDA限制)
- 验证: STOCK_LIMIT=2 updated=2 records=24 拉到当天
- 文档 docs/deployment/data-download.md
 2026-07-07 19:41:07 +08:00
claude_dev 1b87d3f7c0 docs(plan): Phase 3c 模拟盘实现计划（C-S0~S3，19 任务） 
C-S0 引擎核心 TDD 完整代码（models/limit/position_ledger/matcher）；
C-S1 回放端到端接口+验收（适配器/引擎/双源/持久化/API/前端）；
C-S2 分户归因；C-S3 实走。含 self-review。
 2026-07-07 09:34:41 +08:00
claude_dev 6c0acd2374 docs(spec): Phase 3c 模拟盘设计 v2（吸收架构+业务双 review） 
架构 + A 股业务双 sub-review 后修正 6 项 CRITICAL + 4 项 HIGH：
- 复权双数据源（qfq 信号 / raw 撮合），解涨跌停系统性失真
- 涨跌停板块表（主板±10/ST±5/创业科创±20/北交所±30）+ 封板判据收紧（T字板保守拒单）
- match_session 多撮合时点（next_open/current_close），支持尾盘抓涨停类策略
- 资金 T+0、印花税 0.05%（2023.8.28 新规）+ 过户费 + 最低佣金 5 元
- StrategyRunner 明确为 CtaTemplate 适配器（PaperCtaEngine 拦截 send_order）
- 任务模型：回放走共享 DB 进度+checkpoint 续跑；实走 APScheduler 启动恢复
- owner_id/checkpoint_date/scheduler_job_id 字段补齐
- 分红送股/归因软限额/科创200股/集合竞价 标注分期（C-S3 后）
 2026-07-07 09:28:58 +08:00
claude_dev 3ee64ae7bb docs(deploy): NAS 访问改 key 免密（ssh sanguo-nas），清除 sshpass + 明文 SSH 密码 2026-07-07 07:53:10 +08:00
claude_dev 8ab2acc992 docs(deploy): rsync 排除 config/（部署态含真实密码，防覆盖） 2026-07-07 07:23:14 +08:00
claude_dev 1862d813d9 docs(deploy): nas-deploy-plan 更新 Phase 3b（sanguo_api + 单 worker + SPA） 2026-07-07 06:36:52 +08:00
claude_dev 759acf2f6c docs(phase3b): Phase 3b Vue 前端实施计划（S0-S3，含 result_id bug 修复） 2026-07-07 00:33:28 +08:00
claude_dev f0f08d32c3 docs(phase3b): 投研+回测 Web 控制台（Vue 前端）设计文档 
- 4 期愿景：投研→回测→模拟→实盘（国金QMT），本期 B=投研+回测
- 对齐 vnpy client 回测模块 + 投研自有
- 技术栈 Vue3+Vite+TS+ElementPlus+ECharts+Pinia
- 部署：8000 切 sanguo_api，Vue 静态挂 FastAPI，不动端口/反代
- 含后端补 5 类接口（资金曲线/每日盈亏/成交/K线/报告）
- 4 切片 S0→S1→S2→S3
 2026-07-07 00:25:31 +08:00
claude_dev b2c2a1305b docs(phase3a): Web API 完整化完成报告（8 task, 44+74 passed, NAS smoke 6/6, 已合并 master） 2026-07-06 20:22:54 +08:00
claude_dev b3cb6fd7cf docs(phase3a): Web API 完整化实现计划（8 task，TDD） 2026-07-06 17:36:12 +08:00
claude_dev 3369ea2433 docs(phase3a): Web API 完整化 design（异步 pool + WS 阶段 + JWT 单用户 + tears 完整化） 2026-07-06 17:22:45 +08:00
claude_dev d9c4f15bc9 docs(phase2): 因子/回测层完成报告（13 task, 54+4 passed, 覆盖率 81%, 端到端冒烟通过） 2026-07-06 11:47:50 +08:00
claude_dev a480fd389f docs(phase2): 因子/回测层实现计划（13 task：3 spike + 10 实现，spike 先行） 2026-07-06 07:25:53 +08:00
claude_dev 83ca15b57b docs(phase2): 因子/回测层 design（brainstorming 3 轮确认，待 review） 2026-07-05 23:47:07 +08:00
claude_dev 6da8a55b5e docs(phase1): 数据层完成报告 + 端到端冒烟脚本 2026-07-05 23:47:07 +08:00
claude_dev 9595879655 docs: 新增 Plan 1 数据层实施计划 
8 个 TDD task：脚手架+配置 / validator / DataReader(parquet+SQLite) /
DataFeed(多源fallback+BaoStock超时) / DataWriter(原子写) /
UpdateScheduler(增量+断点续传+熔断) / vnpy 4.4.0 spike + 端到端冒烟
含 self-review 与执行指引
 2026-07-05 11:31:20 +08:00
claude_dev f255e5062e docs: 新增 vnpy 量化平台第一阶段架构设计 
基于 PRD 落地分层架构：
- 数据层（继承 v1，双存储 parquet+SQLite，cron+Web 更新）
- 因子/回测层（vnpy.alpha 可插拔扩展 + BacktestingEngine 多进程优化）
- Web API 层（FastAPI 自建 + JWT + 回测任务 pool）
- 前端（Vue 3 + Vite + Naive UI，替换原生）
- 部署（NAS Docker，uvicorn 单进程避 fork 坑）
含早期 spike 与 ADR 对应表
 2026-07-05 11:08:59 +08:00
claude_dev 3d20489761 docs: 新增 vnpy 量化平台第一阶段 PRD 
沉淀 superpowers brainstorming 多轮讨论：
- 项目初衷、核心原则（不改 vnpy/面向未来/复用 v1 数据）
- 第一阶段范围（A 股回测+策略开发闭环）与后续 spec 规划
- 8 条架构决策（ADR）：不引 Qlib/不用 Celery/vnpy 零改造/
  复用 v1 数据丢弃 v1 回测/国金模拟独立/弃内嵌架构/
  webtrader 按需启用/因子层可插拔
- v1 数据资产继承清单 + 数据源踩坑黑名单
- 风险与待决策项
 2026-07-05 10:54:15 +08:00
claude_dev 1803610f23 docs: 新增 NAS Docker 迭代部署方案 
新增 docs/deployment/nas-deploy-plan.md，固化应用层/镜像层分离的部署流程（rsync + docker restart）。CLAUDE.md 参考文档段加入索引。
 2026-07-04 20:13:03 +08:00
claude_dev 918bbed0fc fix: 修复登录500错误和移除明文密码提示 
- 修复 deps.py 中 get_vn_service 的引用错误 (vn_service.vn_service -> vn_service)
- 移除登录页面上的明文密码提示
- 改进前端错误处理，避免数据加载失败导致登录显示错误
 2026-07-02 12:23:55 +08:00
claude_dev a37c43f691 docs: 建立完整的项目文档体系 
- 创建6大文档分类：需求/设计/API/用户指南/运维/研究
- 添加各目录的 README 和模板说明
- 定义文档命名规范和编写规范
- 建立文档与代码的对应关系

文档目录结构:
├── requirements/  - 业务需求、功能需求、非功能需求
├── design/        - 架构设计、数据库设计、UI设计、集成设计
├── api/           - REST API、事件定义、内部接口
├── user_guide/    - 快速开始、教程、FAQ
├── operations/    - 部署、监控、故障排查
└── research/      - 因子研究、策略研究、回测报告

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-07-01 21:13:44 +08:00
claude_dev 8dd1cf326d feat: 初始化 Sanguo VeighNa 量化交易平台项目 
- 基于 VeighNa 4.4.0 的二次开发基础
- 建立项目目录结构（sanguo_trader/sanguo_research/sanguo_data/sanguo_common）
- 配置开发工作流文档和 Git 模板
- 设置 GitHub Flow 分支策略
- 添加依赖管理文件

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-25 18:51:39 +08:00