diff --git a/.gitignore b/.gitignore
index 6e5335f..bfeaeff 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,4 @@
 unpackage/
 node_modules/
 .DS_Store
+.playwright-mcp/
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..e5bdfbd
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,30 @@
+# CLAUDE.md
+
+## 项目概览
+
+怀化人社 H5（hhrs）—— 基于 uni-app 构建的移动端 H5 前端，入口 `pages/`，UI 依赖 `uview-ui`。属于 12301-dscp 项目群中的「怀化人社」H5 端。
+
+## Git 规范
+
+- 独立 git 仓库，远程：`https://git.hn12301.net/xuchao/hhrs.git`，主分支 `master`
+- 提交信息使用中文
+- `.gitignore` 已忽略 `unpackage/`、`node_modules/`、`.DS_Store`；**不要**提交构建产物（unpackage 目录）
+
+## 部署信息
+
+线上为纯静态站点，位于 121.43.239.220（阿里云 ECS / CentOS 7，宿主机 Nginx 直接伺服）：
+
+| 项目 | 内容 |
+| --- | --- |
+| 站点 | https://hh.hn12301.net/ |
+| 网站目录 | `/home/hh/html`（uni-app 构建产物，入口 index.html） |
+| Nginx 配置 | `/etc/nginx/conf.d/h5-site-https.conf`（80 catch-all → 301 跳 HTTPS） |
+| 证书 | Let's Encrypt ec-256，acme.sh 每月 1/7/13/19 日 01:01 自动续期，手动续期见运维手册 |
+
+**发布流程**：本地 HBuilderX 构建 → 覆盖上传产物到 `/home/hh/html/` → 静态文件即时生效，**无需重启 Nginx**。改过 Nginx 配置才需要 `nginx -t && nginx -s reload`。
+
+**关键注意**：
+- 前端 API 基地址指向 `https://dscp-dev.hn12301.net`（= 120.26.254.65，数字化测试环境），**后端不在部署机上**。出现"页面能打开但数据不通"时优先排查 120.26.254.65 的接口
+- 页面图片走 OSS：`aliyunoss.hn12301.net/hhrs/`
+- SSH 凭据及全部运维细节见 Obsidian 工作资料《121.43.239.220(H5站点服务器)运维手册_2026-08-04.md》
+- 数据录入（商铺/资源/中奖等）操作指南见仓库根 docs 的 `hhrs-ops-guide.md`（运营向）
\ No newline at end of file