diff --git a/.env.example b/.env.example
index 1d2937d..687a081 100644
--- a/.env.example
+++ b/.env.example
@@ -1,12 +1,12 @@
-CREATORHUB_PORT=8082
+# 复制为 .env 后填写。不要把真实 .env 提交到仓库。
+# 控制面
+CREATORHUB_PORT=8080
+CONTROL_PLANE_USERNAME=admin
+CONTROL_PLANE_PASSWORD=change-me
+CREATORHUB_CREDENTIAL_MASTER_KEY=  # openssl rand -base64 32
+
+# 数据库
 CREATORHUB_POSTGRES_PORT=15433
-DATABASE_URL=postgres://creatorhub@127.0.0.1:15433/creatorhub?sslmode=disable
-NATIVE_GATEWAY_ENDPOINT=http://127.0.0.1:28187
-GATEWAY_TOKEN=dev-creatorhub-gateway-token
-BROWSER_STATE_DIR=~/.local/state/creatorhub/browser-gateway
-BROWSER_PROFILE_ROOT=~/.local/share/creatorhub/browser-profiles
-BROWSER_PATH=~/.local/share/creatorhub/browsers/fingerprint-chromium/148.0.7778.215/chrome
-NODE_NAME=
-CONTROL_PLANE_USERNAME=
-CONTROL_PLANE_PASSWORD=
-CREATORHUB_CREDENTIAL_MASTER_KEY=
+
+# native browser gateway
+GATEWAY_TOKEN=change-me-at-least-16-random-characters
diff --git a/.gitignore b/.gitignore
index c355fcb..4fd661b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,10 +1,36 @@
-web/dist/
+# 依赖与构建产物
+node_modules/
 web/node_modules/
+web/dist/
 web/.umi/
 web/.umi-production/
+web/.umi-test/
+web/.src/
+dist/
+build/
+
+# 日志与临时文件
+*.log
+tmp/
+.cache/
+
+# Python
 __pycache__/
 *.py[cod]
+.venv/
+
+# 环境与密钥（本地凭据绝不入库）
 .env
+.env.*
+!.env.example
 .dev-credentials/
+
+# 工具缓存与本机数据
 .codegraph/
-tmp/
+.pi/
+
+# 编辑器与系统
+.idea/
+.vscode/
+.DS_Store
+*.swp