AGENTS.md:正式版改为 /mama-box-v2/,更新发布流程与三目录说明

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-09 17:26:08 +00:00
parent 48773baa42
commit c39391e669

View File

@@ -9,7 +9,11 @@
微信小程序里的**首页 H5**:小程序首页壳(`crmeb/pages/index/index.vue`)用 web-view 加载本站。
⚠️ 2026-10-09 起首页地址**由 box_app 后台动态配置**(`GET /api/mp/public/home/config` → `result.url`),
不再硬编码;当前指向 `https://mp.yizhezhe.com/mama-box-preview/`(用户确认),默认/兜底仍是 `/mama-box/`。它同时是 **H5 应用宫格**入口(30+ 第三方应用的门面)。
不再硬编码,默认/兜底仍是 `/mama-box/`。
⚠️ 2026-10-10 用户定:**正式版改名 `/mama-box-v2/`**(main 分支 → 服务器 `/opt/app/mama-box-v2`),后台把小程序首页 url 配到这里,
避免拿 `/mama-box-preview/` 当正式用的歧义。三个目录:`/mama-box-v2/` 正式(main)、`/mama-box-preview/` 预览(preview)、
`/mama-box/` 旧正式(停在 v26092219,只作 goHome 兜底,别再往里发)。正式/预览的行为差异全靠 `location.pathname` 判
`/mama-box-preview/`(不恢复上次应用、允许 demo=1 / fpdemo=1),v2 走正式逻辑。它同时是 **H5 应用宫格**入口(30+ 第三方应用的门面)。
- 纯静态站点:**无框架、无构建、无测试**,`index.html` 一个页面用 `.screen` 切换多个屏。
- 仓库 `jone/mama-box`;本地 `/home/jone/workspace/mama-box`;生产 `/opt/app/mama-box`(nginx alias 托管,非 box_app 挂载)。
@@ -29,9 +33,16 @@
## 3. 发布
```bash
git push origin main # 完成后在服务器:
cd /opt/app/mama-box && git fetch && git reset --hard origin/main # 静态站,无需重启
# 先预览:改动推 preview → 服务器预览目录更新,用户确认后再上正式
git push origin preview
cd /opt/app/mama-box-preview && git fetch && git reset --hard origin/preview
# 正式(2026-10-10 起是 /mama-box-v2/):preview 合进 main 后
git push origin main
cd /opt/app/mama-box-v2 && git fetch && git reset --hard origin/main # 静态站,无需重启
# /opt/app/mama-box(旧正式)不再发布,只作 wx-auth.js goHome 的兜底落点
```
⚠️ 例外:`js/wx-auth.js` 是全生态共用脚本,各应用都从 **`/mama-box/js/wx-auth.js`** 加载 ——
改了它必须同时更新旧目录:`cd /opt/app/mama-box && git fetch && git checkout origin/main -- js/wx-auth.js`(只拉这一个文件)。
nginx:`root /opt/app` + `Cache-Control: no-cache` + `etag on` —— 缓存靠 ETag,所以**改完必须 bump 版本号**。