feat(storage): integrate Alibaba Cloud OSS for file persistence - Add OSSAdapter and LocalAdapter with StorageFactory pattern - Integrate PKB module with OSS upload - Rename difyDocumentId to storageKey - Create 4 OSS buckets and development specification

docs/04-开发规范/06-Git提交规范.md

@@ -1,8 +1,8 @@
 # Git 提交规范
 
-> **版本：** v1.2  
+> **版本：** v1.3  
 > **创建日期：** 2025-11-16  
-> **更新日期：** 2026-01-16  
+> **更新日期：** 2026-01-22  
 > **适用范围：** 全项目（前端 + 后端 + 文档）  
 > **优先级：** ⭐⭐⭐⭐⭐ P0 必须遵守
 
@@ -1280,8 +1280,20 @@ git rebase -i HEAD~3  # 修改最近 3 次提交
 **提交内容：**
 - ✅ 只提交相关的更改
 - ✅ 使用 `.gitignore` 排除无关文件
-- ❌ 不要提交生成的文件（`node_modules/`, `dist/`, `.env`）
-- ❌ 不要提交敏感信息（密码、密钥）
+- ✅ **提交 `backend/.env` 环境变量文件**（私有仓库，防止配置丢失）
+- ❌ 不要提交生成的文件（`node_modules/`, `dist/`）
+
+> ⚠️ **关于 `.env` 文件的特殊说明（2026-01-22 更新）**
+> 
+> **背景**：2026-01-22 发生环境变量文件被意外覆盖事件，导致大量配置丢失。
+> 
+> **决策**：鉴于本项目为私有仓库，且团队规模小（2人），为防止配置丢失，
+> 决定将 `backend/.env` 文件纳入 Git 版本管理。
+> 
+> **注意事项**：
+> - 🔴 如果仓库将来变为公开，必须立即从 Git 历史中删除 `.env`
+> - 🔴 定期轮换 API 密钥（建议每 90 天）
+> - 🔴 不要将 `.env` 文件分享给非团队成员
 
 **分支管理：**
 - ✅ 从最新的 `develop` 创建功能分支