feat: unified gravity system - VIP members consume gravity instead of unlimited; add monthly gravity top-up cron

AGENTS.md

@@ -105,6 +105,10 @@ zhiyin/
 
 ## 三、开发命令
 
+> ⚠️ **构建铁律：必须始终使用 `npm run build:*` 命令，禁止直接调用 `npx uni build` 或 `npx nest build`。**
+> 前端 `npm run build:mp-weixin` 和 `npm run build:h5` 脚本包含头像文件（`avatar-*.png`）复制步骤，
+> 后端 `npm run build` 是 `nest build` 的别名。直接使用 `npx` 会遗漏这些关键步骤，导致线上数字人头像不显示等问题。
+
 ### 后端
 ```bash
 # 路径: backend/
@@ -130,12 +134,12 @@ npm test                   # 前端单元测试（vitest，7 个）
 ### 构建检查
 ```bash
 # 后端构建（注意 OOM：需 NODE_OPTIONS="--max-old-space-size=2048"）
-cd backend && NODE_OPTIONS="--max-old-space-size=2048" npx nest build
+cd backend && npm run build
 ```
 
 ### 部署后端
 ```bash
-cd backend && npx nest build
+cd backend && npm run build
 cp -rf dist/* /www/wwwroot/server/zhiyin/backend/dist/
 cp -r certs /www/wwwroot/server/zhiyin/backend/dist/src/certs
 pm2 restart yhl-backend
@@ -144,7 +148,7 @@ sleep 3 && curl -s http://localhost:3006/api/user/wx-login -X POST -H "Content-T
 
 ### 部署前端 H5
 ```bash
-cd zhiyin-app && npx uni build
+cd zhiyin-app && npm run build:h5
 rm -rf /www/wwwroot/zhiyin.yzrcloud.cn/assets
 cp -r dist/build/h5/index.html /www/wwwroot/zhiyin.yzrcloud.cn/
 cp -r dist/build/h5/assets /www/wwwroot/zhiyin.yzrcloud.cn/
@@ -153,9 +157,11 @@ chown -R www:www /www/wwwroot/zhiyin.yzrcloud.cn/index.html /www/wwwroot/zhiyin.
 grep -oP '["'"'"']([a-zA-Z0-9_-]+\.[a-z]+(\.js|\.css|\.png|\.svg))["'"'"']' /www/wwwroot/zhiyin.yzrcloud.cn/assets/index-*.js | sort -u
 ```
 
-### 小程序上传
+### 小程序上传（先 build 后 upload，两步分开更安全）
 ```bash
 cd zhiyin-app && npm run build:mp-weixin && node scripts/upload-mp.js
+# 注意：build:mp-weixin 已自动复制 avatar-*.png 到 dist/build/mp-weixin/static/
+# 如遇数字人头像不显示，检查是否漏了 cp 步骤，重新用 npm run build:mp-weixin 构建
 ```
 
 ---