docs(AGENTS): 共享库迁 /common/wx-auth.md 说明同步 —— 手拉旧目录流程废止，改去 box_app 仓 common/

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`** 加载 ——
+⚠️ ~~例外：`js/wx-auth.js` 手拉旧目录~~ **2026-10-10 已废止**：共享库迁到 **`/common/wx-auth.js`**（box_app 仓 `common/`，nginx 托管），
-改了它必须同时更新旧目录：`cd /opt/app/mama-box && git fetch && git checkout origin/main -- js/wx-auth.js`（只拉这一个文件）。
+旧路径 `/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、