From 10ac3b393f509c198671ec887fd9532b0f5ebcf8 Mon Sep 17 00:00:00 2001
From: shy3130 <shy3130@users.noreply.github.com>
Date: Sun, 28 Jun 2026 16:01:54 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20README=20=E5=A2=9E=E5=8A=A0=E3=80=8C?=
 =?UTF-8?q?=E6=9B=B4=E6=96=B0=E4=BB=A3=E7=A0=81=E3=80=8D=E8=AF=B4=E6=98=8E?=
 =?UTF-8?q?,=20=E6=8F=90=E9=86=92=E5=8B=BF=E7=94=A8=E7=A0=B4=E5=9D=8F?=
 =?UTF-8?q?=E6=80=A7=20git=20=E5=91=BD=E4=BB=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

说明整个 data/ 不纳入 git, 概念/行业改为首次启动远程拉取;
警告切勿使用 git clean -fdx / git reset --hard (会删本地数据)。
---
 README.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/README.md b/README.md
index 55d8dbd..5a9b98e 100644
--- a/README.md
+++ b/README.md
@@ -128,6 +128,23 @@ cd frontend && pnpm install && pnpm dev   # http://localhost:3011
 
 </details>
 
+### 🔄 更新代码(已部署用户必读)
+
+拉取新版本只需一条命令:
+
+```bash
+git pull
+```
+
+**整个 `data/` 目录都不纳入 git**——行情 K线、财务、自选、回测、监控记录,乃至概念/行业扩展数据,全部是程序运行时生成/拉取的用户数据,`git pull` 物理上无法影响它们。新用户首次启动时,概念/行业两份扩展数据会自动从远程接口拉取,无需任何手动操作。
+
+> ⚠️ **切勿使用以下命令"解决冲突"或"清理",它们会一次性删光 `data/` 下所有未被 git 跟踪的数据:**
+> - `git clean -fdx`(最危险,会删掉所有 `.gitignore` 忽略的文件)
+> - `git reset --hard`
+> - 直接删除整个项目文件夹重新 `git clone`
+>
+> 若 `git pull` 报冲突,通常是本地误改了被跟踪的文件,请先 `git stash` 暂存再 pull,或单独联系作者,不要直接执行上面的命令。
+
 ### 🧭 跑起来后的第一次使用
 
 1. **设置 → 凭据与能力** → 点 **重新检测**,确认档位标签