按交叉评审对齐文档与代码口径，并挡住 reference 下的密钥文件

表名、配额种子和字段名以产品方案与架构为准；文档仓库补 .gitignore，避免 git add -A 把 API Key 推进远端。

Co-authored-by: Cursor <cursoragent@cursor.com>

.gitignore

@@ -0,0 +1,14 @@
+# 密钥与本地环境。文档仓库没有 detect-secrets，只能靠忽略规则兜底。
+# `git add -A` 不得把 reference 下的 txt / key 推进远端。
+reference/*.txt
+reference/*.key
+reference/*.pem
+.env
+.env.*
+!.env.example
+
+# 本地草稿与工具缓存
+.scratch/
+.DS_Store
+Thumbs.db
+*.swp