From 270076cf4ec0bf454886200b72e2a2044ed36502 Mon Sep 17 00:00:00 2001
From: hblu <hblu1985@163.com>
Date: Thu, 8 Jan 2026 21:20:47 +0800
Subject: [PATCH] 1

---
 README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/README.md b/README.md
index c9d5c16..3d9629c 100644
--- a/README.md
+++ b/README.md
@@ -771,6 +771,22 @@ load_dotenv() # 加载 .env
 api_key = os.getenv("DEEPSEEK_API_KEY")
 ```
 
+> [!IMPORTANT]
+> **安全最佳实践**：
+> 1. **添加 `.env` 到 `.gitignore`**：确保 `.gitignore` 文件中包含 `.env`，防止 API Key 被误上传到 Git 仓库。
+> 2. **创建 `.env-example` 模板文件**：在项目中提供一个 `.env-example` 文件，列出所需的环境变量 (但**不包含真实的 Key**)，方便其他开发者或组员快速配置。
+>
+> ```bash
+> # .env-example 文件内容 (提交到 Git)
+> DEEPSEEK_API_KEY=your_api_key_here
+> ```
+>
+> 组员克隆项目后，只需：
+> ```bash
+> cp .env-example .env  # 复制模板
+> # 然后编辑 .env 填入自己的 API Key
+> ```
+
 
 ### 4. Git 简明操作手册 (Cheatsheet)