Repository navigation
v0.1.0 首个正式版本
Paper Trading v0.1.0
首个正式版本:A 股本地模拟盘(纸盘)交易系统,事件驱动 + LLM Agent 辅助决策,全部成交本地模拟,不连接任何券商。
核心能力
- 投资方案三分法:母价值 / 通用 / 自定义,永远只有三种;
custom方案支持自然语言交易指令,长期保存并注入决策 prompt。 - LLM Agent 决策环:
python -m paper_trading.cli agent run,支持--dry-run;决策、计划、执行三段分离,计划执行有前置校验。 - 盘中实时行情:腾讯行情源,60s 缓存;NAV 全口径计价。
- Web 面板(
python -m paper_trading.cli dashboard):方案切换(凭 API Key 接管)、持仓/委托/流水、选股范围、LLM 配置;设计语言与 Stock Dashboard 一致,界面无英文系统词。 - Stock Dashboard 只读集成:
--pool-from config|watchlist|screening|all,只读连接母库,缺席时静默回退独立模式,永不写母库。
工程质量
- 44 个单测,全量离线可跑(禁网、hermetic),双端 + CI 全绿
- GitHub Actions CI:每次 push 自动跑全量单测
- MIT
LICENSE、SECURITY.md、README 安全说明与免责声明 - 与 Stock Dashboard 的合并契约见
MERGE_GUIDE.md(subtree vendoring,按 tag 取用)
安装
pip install -r requirements.txt
python -m pytest tests/ -q # 44 passed
python -m paper_trading.cli scheme list已知边界
- 面板无登录鉴权,仅限局域网使用,禁止暴露公网
- LLM Key 只存本机
secrets.local.json(已 gitignore) - 模拟盘工具,不构成投资建议,盈亏自负
升级指引:作为首个 release,无升级步骤;下游(Stock Dashboard subtree)请 vendor 此 tag,勿跟 main。