From 2a60d47b2d3e25320a5e81c3f0dc7032e3c9bb3b Mon Sep 17 00:00:00 2001
From: dekun <dekun@local>
Date: Tue, 21 Jul 2026 10:52:35 +0800
Subject: [PATCH] Document git snapshot tags including snapshot/20260721.

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 docs/快照备份.md | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)
 create mode 100644 docs/快照备份.md

diff --git a/docs/快照备份.md b/docs/快照备份.md
new file mode 100644
index 0000000..c1fe571
--- /dev/null
+++ b/docs/快照备份.md
@@ -0,0 +1,34 @@
+# Git 快照标签
+
+代码级快照用 annotated tag 打在 `main` 上，便于回看某日仓库状态（不含 `.env` / 数据库）。
+
+## 当前快照
+
+| 标签 | 指向提交 | 说明 |
+|------|----------|------|
+| `snapshot/20260721` | `64b24fd` | 2026-07-21：仓库代码统计文档、期权复盘亮色主题、对冲腿盈亏时区修复等 |
+
+## 历史标签（节选）
+
+| 标签 | 说明 |
+|------|------|
+| `snapshot/pre-strategy-mindmap-20260718` | 策略脑图相关改动前 |
+| `snapshot/pre-hub-order-popup` | 中控下单弹窗相关改动前 |
+| `snapshot/pre-hub-market-20260528` | 中控行情相关改动前 |
+| `pre-lib-modularization` | lib 模块化前 |
+| `pre-remove-gate-bot` | 移除 gate_bot 前 |
+
+## 用法
+
+```bash
+# 查看标签
+git tag -l 'snapshot/*'
+
+# 检出快照（只读查看，勿在此分支直接开发）
+git checkout snapshot/20260721
+
+# 回到主线
+git checkout main
+```
+
+数据备份（SQLite / 中控 JSON）走中控备份或各所 `scripts/backup_data.sh`，**不要**把含密钥的 `.env` 与库文件提交进 Git。