diff --git a/AGENTS.md b/AGENTS.md index 45976c7..9595321 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -25,7 +25,7 @@ | --- | --- | | `index.html` | 单页多屏的全部结构 + 样式引用/脚本引用(1550+ 行) | | `js/app.js` | **全部业务逻辑**(3000+ 行):屏切换、远程数据、宫格、授权、跳转、last_app | -| `js/wx-auth.js` | **共享助手,别的 H5 应用也引用它**:环境判定 / 读授权结果 / `requestProfile` / `goMall` / `reportLocation`。改动等于改所有接入方,务必保守 | +| `js/wx-auth.js` | ⚠️ **2026-10-10 起已迁出本仓**:共享助手(环境判定 / 读授权结果 / `requestProfile` / `goMall` / `reportLocation` / `goHome`)唯一来源是 **box_app 仓 `common/wx-auth.js`**,各应用从 **`/common/wx-auth.js?v=…`** 引用;nginx 对旧路径 `/mama-box(/-v2)/js/wx-auth.js` 做了精确匹配永久兼容。改它去 box_app 仓改,别在本仓重建副本(会再次分叉) | | `mama-box.css` | 样式 | | `assets/` | 图片/资源。⚠️ `assets/img/` 下**文件名 = 文件内容 md5 的前 12 位**(`md5sum 新图` 取前 12 位),内容寻址:换图即换 URL,天然不会被上一版图缓存顶住。别起描述性名字 —— 全目录 35 张都按这个规则(2026-09-22 换顾问二维码时实测确认) | | `js/core.js` | ⚠️ **本仓库内已无任何引用**(MPA 原型带过来的遗留)。新代码不要基于它,改前先确认没有隐藏引用 | @@ -41,8 +41,9 @@ 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`(只拉这一个文件)。 +⚠️ ~~例外:`js/wx-auth.js` 手拉旧目录~~ **2026-10-10 已废止**:共享库迁到 **`/common/wx-auth.js`**(box_app 仓 `common/`,nginx 托管), +旧路径 `/mama-box(/-v2)/js/wx-auth.js` 由 nginx 精确匹配**永久兼容**,第三方无需改标签、旧目录无需再手拉文件。 +改共享库的流程:改 **box_app 仓 `common/wx-auth.js`** → push → `cd /opt/app/box_app && git reset --hard origin/main`(静态,无需重启)。 nginx:`root /opt/app` + `Cache-Control: no-cache` + `etag on` —— 缓存靠 ETag,所以**改完必须 bump 版本号**。 @@ -122,7 +123,7 @@ nginx:`root /opt/app` + `Cache-Control: no-cache` + `etag on` —— 缓存靠 - 写法:`if (window.wxAuth && typeof wxAuth.goHome === 'function') { wxAuth.goHome(); return; }`, 原来拼身份的写死地址只允许留作 **wxAuth 没加载时的兜底**。 ⚠️ `goHome()` 的身份只认 URL + sessionStorage(`identity()`)。应用若把身份从 URL 抹掉、存在 localStorage 等别处, - 站内跳几次后回首页会带空身份 → 调 `goHome()` 前先 `wxAuth.rememberIdentity(openid, unionid)`(数胎动 2026-10-10 首个这么做)。`wx-auth.js` 用绝对地址 `https://mp.yizhezhe.com/mama-box/js/wx-auth.js` 引入。 + 站内跳几次后回首页会带空身份 → 调 `goHome()` 前先 `wxAuth.rememberIdentity(openid, unionid)`(数胎动 2026-10-10 首个这么做)。共享库引入地址 2026-10-10 起为 **`/common/wx-auth.js?v=…`**(旧绝对地址由 nginx 兼容层继续可用,已接入应用不必急改)。 - 首页带 `return_url` 跳过去的应用(档案 / 婴儿房 / 商城)返回时回 `return_url` 即可(它就是当时的首页地址);**没带 `return_url` 时的兜底也要走 `goHome()`**,别 `history.back()`。 - 本仓库自己:首页内部不要用 `goHome()`(那是给别的应用回来用的);`wx-auth.js` 里 `DEFAULT_HOME` 是唯一允许写死首页的地方。 - 2026-10-09 普查(48 个目录):主返回写死 `/mama-box/`、已通知各自会话改的有 数胎动 taidong(预览版已改,正式待批)、孕检日历 chanjian-rili(10-10 已上线,复扫通过)、待产清单 daichan-qingdan、