把你的交易人生，变成一座看得见的花园。
每天 5 分钟浇水（修行打卡），每周收一篮果实（因子实验），每季度修剪一次（策略体检）——
用游戏化守护纪律，用真实市场检验成长。
Trader-growing 是一个把"交易者修行"游戏化的本地工具。
你大概也经历过：明知道要止损，手却停在半空；明知道该空仓，还是忍不住加了一手。然后懊恼、自责、再犯。问题不在知识，在于纪律没有反馈——而游戏，是给反馈最强的机器。
我们把交易心性拆成 RPG 的四维属性，用等级、经验值、连击、徽章给你即时反馈：
📐 数学 —— 你理性评估概率与赔率了吗？
💰 金融 —— 你遵守规则与风控了吗？
🧠 心理 —— 你控制住情绪与冲动了吗？
🔮 哲学 —— 你接纳不确定与失败了吗？
每日 20 题客观测试（每题 0-4 分自动算分，拒绝拍脑袋），难度随等级解锁：
| 难度 | 解锁 | 题目类型 |
|---|---|---|
| 🐣 小白 | 新手即可 | 行为事实："今天守止损了吗？" |
| 🌱 进阶 | XP ≥ 300 | 认知理解："信号经过回测验证吗？" |
| 🎓 专业 | XP ≥ 600 | 专业深化："能用凯利公式定仓位吗？" |
🎮 不是赌场式游戏化（抽卡/排行榜/焦虑），而是修行式游戏化： 亏损不被惩罚，被重新框架为经验值；每日 5 分钟上限，超时系统会说——"今天的修行够了，去生活吧"。
🎮 学习关卡（把《人人都是量化交易员》变成闯关游戏）：
🌍 9 个世界（每章一个）→ 每关 = 知识卡 + 实战任务 + 测验
🧪 实战任务用「今天」的真实行情取材判分——答案每天不同
✅ 首通：+15~30 XP + 维度 +5 + 图鉴点亮 | 每日复习：+5 XP
已上线：第 1 章「新手村」4 关（定投播种→基准对决→均线信号→BOSS 过拟合挑战）、 第 2 章「选什么」4 关（个股vsETF→中美锚定→相关性探秘→BOSS 标的池挑战）、 第 3 章「分多少」4 关（等权分钱→风险平价→动量排名→BOSS 盈亏比之战）、 第 4 章「何时动」4 关（再平衡→止损→止盈→BOSS 锯齿效应）、 第 5 章「体检台」4 关（基准对比→逐年拆解→回撤深度→BOSS 参数敏感性）、 第 6 章「陷阱迷宫」4 关（样本内外→Walk-forward→交叉验证→BOSS 规则负担）、 第 7 章「现实世界」4 关（整手订单→滑点→成本层叠→BOSS 执行落差）、 第 8 章「守护者」4 关（监控仪表盘→诊断三问→假设对照→BOSS 归因总账）、 第 9 章「研究者」4 关（因子初识→IC 初测→因子失效点→BOSS 因子评估总账）。
📊 现状：9 世界 × 4 关 = 36 关全部上线（V3.2）
| 维度 | 说明 |
|---|---|
| 🌍 世界锁 | 通关一章解锁下一章世界 |
| 🧪 真实数据任务 | 30+ 种题型：定投份数 / 波动对比 / 相关性 / 风险平价 / 动量 / 盈亏比 / 止损止盈价 / 回撤 / 超额 / 样本内外 / Walk-forward / 整手 / 滑点 / 成本层叠 / 归因 / 条件分析 / 因子 IC……答案随今日行情每天变化 |
| ✅ 首通奖励 | +15~30 XP + 维度 +5 + 图鉴点亮 |
| 🔄 每日复习 | 已通关关卡每天可再战（+5 XP/关/天），逼你真正看数据 |
| 🏅 关卡成就 | 初出茅庐 / 新手村毕业 / 选品大师 / 章节行者 / 闯关学霸 / 世界征服者 |
通关一章解锁下一章世界，与修行日记/知识测试/同行榜数据互通。
⚡ 今日一题：每天 30 秒——用「今天的真实行情」出一道量化题（定投份数/均线方向/相关性/风险平价/止损价……8 种题型按日轮换，答案每天不同）。答对 +3 XP，可下载分享卡片 PNG 发微信群。
🧪 实验场：真实数据回测沙盒——15 种策略模板（每张都配「策略课」知识卡：是什么/怎么调参/何时失效）（定投 / 均线择时 / 等权组合 / 风险平价 / 动量轮动 + 经典指标：MACD 金叉 / RSI 超买超卖 / 布林带均值回归 / 双推力突破），选资产、拖参数（默认值即经典配置）、一键出净值曲线 + 夏普 + 最大回撤 + 水下曲线，结果可存档并完成周任务「回测复现」（+30 XP）。指标策略移植自 je-suis-tm/quant-trading（MIT）。
🎯 今日操作台：看天气（四资产看板）→ 定计划（中庸策略 plan）→ 对账（30 秒三问：计划外交易/移动止损/未执行）——纪律核心在 Web 端闭环。数据一键更新（akshare，免费免注册）。
💡 数据源：python scripts/update_data.py --source akshare（免费、无需注册，个股/ETF 全覆盖）；安装 Wind skill 后自动切换 Wind。
| 🏠 今日（今日一题 + 分享卡片） | 🧪 实验场（真实数据回测） | 🎮 学习关卡（9 世界 36 关） |
|---|---|---|
 |
 |
 |
"Growing"既是成长（等级提升），也是种植（培育花园）。你的花园里有四棵植物，对应四个维度，每天浇水（打卡）它们才会长大：
Trader-growing · 成长花园
========================================
-@| 数学 [ 65/100] 小树
-@@ 金融 [ 78/100] 大树
--| 心理 [ 52/100] 幼苗
-@| 哲学 [ 70/100] 小树
========================================
提示：每天浇水（打卡），四维才会开花
| 游戏阶段 | 花园 | 交易者阶段 |
|---|---|---|
| 🌱 种子 | 投资想法 | 提出假设 |
| 🌿 发芽 | 回测验证 | spec → 回测 |
| 🌳 小树 | 模拟盘 | 执行交易 |
| 🌲 大树 | 小实盘 | 监控迭代 |
| 🍎 果实 | 因子研究 | 持续收获 |
| ✂️ 修剪 | 策略迭代 | 砍掉过拟合的枝条 |
| 机制 | 规则 | 哲学 |
|---|---|---|
| XP / 等级 | 菜鸟 → 学徒 → 熟练 → 专家 → 大师 | 成长看得见 |
| 连击奖励 | 连续打卡 ≥3 天，XP ×1.5 | 坚持有回报 |
| 温和惩罚 | 有纪律偏差的日子 XP 减半（不归零） | 失败也是经验 |
| 成就徽章 | 零冲动 / 割肉勇士 / 空仓大师 / 四维开花 / 世界征服者…… | 把"认错"也变成荣誉 |
| 每日 5 分钟 | 超时提醒"今天的修行够了" | 节制是最高级的自律 |
已内置 13 枚徽章（7 枚修行 + 6 枚学习关卡），例如：
- 🏅 割肉勇士：严格执行止损 10 次——把最难的"认错"变成值得炫耀的成就
- 🏅 空仓大师：遵守"空仓也是持仓"哲学 30 天——什么都不做，也是一种修为
- 🏅 四维开花：四个维度同时 ≥ 70——不允许偏科
- 🏅 新手村毕业：通关第 1 章世界全部关卡——量化入门第一步
- 🏅 世界征服者：通关全部 9 个世界 36 关——这本书，你真的学完了
https://trader-growing.streamlit.app —— 浏览器直接打开即用。 云端首次打开点首页「📥 更新行情数据」按钮（约 1 分钟），之后 36 关/实验场/今日一题全部可用。 云端为演示环境（数据会话级）；自己长期使用推荐本地版（数据全在本地）。
# 1. 克隆并进入
git clone https://github.com/Justinjchen-Cornell/Trader-growing.git
cd Trader-growing
# 2. 一键环境准备（依赖 + Wind 数据源 + API Key + 首批数据）
python scripts/setup.py
# 3. 跑全流程演示（3 天模拟：打卡 → 对账 → 成长）
python scripts/demo.py
# 4. 更新行情数据（学习关卡/看板依赖真实数据）
python scripts/update_data.py --source akshare # 免费免注册；有 Wind skill 时自动用 Wind
# 5. 开始你的修行
streamlit run app.py # 🌐 Web 界面（推荐！7 个 tab：🏠今日 → 🎮学习 → 📝测试 → 🎯操作台 → 🧪实验场 → 📊我的 → 👥同行榜）
python scripts/tg.py check # 每日打卡（输入四维分数）
python scripts/tg.py status # 角色 / 花园 / 层级
python scripts/tg.py dashboard # 四资产看板（金/油/沪深300/纳指）
python scripts/tg.py plan # 今日策略计划（中庸策略）
python scripts/tg.py reconcile # 纪律对账（计划 vs 日记）
python scripts/tg.py quests # 任务清单（每日 + 每周，+XP）
python scripts/tg.py stats # 偏差趋势统计（纪律分 vs 红牌）Demo 输出示例（有纪律偏差的那一天）：
【2026-08-08】打卡 +5 XP | 连击 2 | 偏差 4 条
🔴 计划外交易：策略建议「持有不动」，但今天发生了交易
🔴 冲动交易：有计划外开仓/加仓（违反数学维度纪律）
🔴 手动移动止损线（违反金融维度纪律）
🔴 交易未严格按计划执行
Trader-growing/
├── app.py # 🌐 Web 界面（Streamlit，7 个 tab）
├── trader_growing/ # 核心包
│ ├── character.py # 等级 / XP / 连击 / 四维属性
│ ├── achievements.py # 成就徽章系统（13 枚）
│ ├── models.py # 数据模型（日记 / 计划 / 对账）
│ ├── reconcile.py # 纪律对账核心（计划 vs 实际）
│ ├── garden.py # ASCII 成长花园
│ ├── dashboard.py # 四资产看板 + 数据助手（波动/相关性/回撤/年度收益）
│ ├── levels.py # 🎮 学习关卡：9 世界 36 关 + 真实数据任务引擎
│ ├── questions.py # 每日修行测试题库（分级）
│ ├── knowledge.py # 客观知识测试题库
│ ├── bestiary.py # 📜 知识图鉴（39 条）
│ ├── quests.py # 每日/每周任务
│ ├── tiers.py # 真钱分级解锁（L0-L3）
│ ├── stats.py # 偏差趋势统计
│ ├── peerboard.py # 匿名同行榜（本地优先）
│ ├── journal_bridge.py # 修行日记 Skill 对接
│ ├── strategy_bridge.py # 中庸策略 plan 对接
│ └── scoring_guide.py # 四维打分参考标准
│ └── weekly.py # 📅 修行周报（每周汇总 + 建议）
├── scripts/
│ ├── setup.py # 一键环境准备
│ ├── update_data.py # 更新行情数据（关卡/看板依赖）
│ ├── demo.py # 全流程演示
│ ├── daily_flow.py # 每日流程 CLI
│ └── tg.py # 主 CLI（check/status/dashboard/plan/reconcile/quests/stats）
├── assets/
│ └── assets.yaml # 四资产配置（金 / 油 / 沪深300 / 纳指）
├── data/ # 运行时数据（gitignore，个人隐私）
├── docs/
│ ├── ROADMAP.md # 路线图
│ ├── DAILY_RITUAL.md # 每日修行流程
│ └── WIND_SETUP.md # Wind 数据源安装
├── README.md # 本文件（中文）
├── README.en.md # English
└── requirements.txt
最终目标：让花园生长在真实的市场里。
| 资产 | 代码 | 一句话 |
|---|---|---|
| 🟥 沪深300ETF | 510300.SS | 中国核心资产 |
| 🟦 纳指100ETF | 513100.SS | 美股科技龙头（A股QDII，人民币可买） |
| 🟨 黄金ETF | 518880.SS | 与股市涨跌不同步的"定海神针" |
| 🟫 原油LOF | 501018.SS | 高波动的大宗商品 |
真钱分级解锁（把风控游戏化——不是"能不能赚钱"，而是"纪律配不配拿真钱"）：
L0 旁观者 观察信号，不交易 （解锁：完成 7 天打卡）
L1 模拟者 模拟盘 + 每日对账 （解锁：纪律分均值 ≥ 70）
L2 小实盘 每资产小资金 （解锁：纪律 ≥ 80 且对账零红牌）
L3 组合者 四资产风险平价 + 波动率过滤 （解锁：L2 连续 60 天无重大偏差）
| 组件 | 作用 |
|---|---|
| 📚 《人人都是量化交易员》（开源书） | 方法论：spec / 四阶段 / 做看疑 |
| ⚙️ 中庸策略（多周期 MACD） | 硬系统：生成交易计划（plan.py） |
| 📓 交易修行日记 Skill | 软能力：每日打分记录（diary JSON） |
数据模型与上述组件 JSON 格式兼容，可直接对接。
- V0.5：角色 / 徽章 / 对账 / 花园 / Demo ✅
- V1.0：四资产看板 + 真钱分级解锁 + 对接策略计划 ✅
- V1.5：图鉴系统（书中知识条目）+ 每周因子实验任务 ✅
- V2.0：Web 界面 + 可选匿名同行榜 ✅
- V2.5：学习关卡系统（第 1/2 章共 8 关）+ 每日复习 + 关卡成就 ✅
- V2.6：第 3 章 4 关（等权 / 风险平价 / 动量排名 / 盈亏比 BOSS），共 12 关 ✅
- V2.7：第 4 章 4 关（再平衡 / 止损 / 止盈 / 锯齿 BOSS），共 16 关 ✅
- V2.8：第 5 章 4 关（基准 / 逐年拆解 / 回撤 / 参数敏感性 BOSS），共 20 关 ✅
- V2.9：第 6 章 4 关（样本内外 / Walk-forward / 交叉验证 / 规则负担 BOSS），共 24 关 ✅
- V3.0：第 7 章 4 关（整手 / 滑点 / 成本层叠 / 执行落差 BOSS），共 28 关 ✅
- V3.1：第 8 章 4 关（监控 / 诊断 / 假设对照 / 归因 BOSS），共 32 关 ✅
- V3.2：第 9 章 4 关（因子 / IC / 失效点 / 评估 BOSS），9 世界 36 关全部通关 ✅
- V4.0-V5.0：BOSS 复战 / 修行周报 / 同行榜关卡对比 / 体验大修（选项均衡、解锁钩子、akshare 回退、知识卡配图、新手引导） ✅
- V5.5：⚡ 今日一题 + 分享卡片 / 🧪 实验场回测沙盒 / 🎯 今日操作台（对账闭环）/ 新手 7 天双倍 XP ✅
详见 docs/ROADMAP.md。
欢迎提 Issue、PR、或分享你的"花园截图"。详见 [CONTRIBUTING.md]（规划中）。
本项目仅供教育与研究，不构成投资建议。历史表现不代表未来收益，任何策略都可能亏损。先种花，再结果；先修行，再交易。
本项目源代码采用 MIT 开源协议（个人 / 教育 / 研究用途永久免费，包括个人学习、学术研究、非商业项目）。
但以下情形不属于 MIT 免费范围，需另行商业授权：
- 将本项目（或其中核心逻辑）用于商业产品化：SaaS / 云托管服务 / 企业级部署
- 将本项目作为收费产品/服务的一部分对外销售
- 企业（含团队）内部用于生产环境的商用系统
如需商业授权、定制开发或合作，请通过 GitHub Issue 联系我们，或在 README 开头扫码赞助（可选，支持项目持续维护）。
商业授权洽谈流程：① Issue 说明使用场景 → ② 确认授权范围与费用（一次性 / 年费 / 收入分成）→ ③ 签署授权协议。个人与教育用途永远免费，请放心使用。
- 代码：MIT License（个人/教育/研究免费，商业产品化需另行授权）
- 文档与设计：CC BY-NC-SA 4.0（署名-非商业-相同方式共享）