diff --git a/.env.example b/.env.example
index 99bb550..ece2a33 100644
--- a/.env.example
+++ b/.env.example
@@ -5,5 +5,7 @@ DATABASE_URL_SYNC=postgresql+psycopg://writer:writer@localhost:5432/writer
 # 应用
 APP_ENV=dev
 LOG_JSON=false
-# 凭据加密密钥（Fernet, base64 32B）— 原型占位
-CREDENTIAL_ENC_KEY=
+# 凭据加密密钥（Fernet, urlsafe-base64 32B）— **必填**：API 启动即校验，缺失/非法则拒绝启动。
+# 下方为开发占位 key（可直接用于本地）；生产请换新值：
+#   uv run python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
+CREDENTIAL_ENC_KEY=cnMpG6QQxJejuDLHTe_S-nq2snoKgXCqWFfsctEHB-4=