@tbox.cn/app-template-agent 0.10.1 → 0.10.2

package/apps/server/src/dev.ts

@@ -41,17 +41,32 @@ const vite = await createViteServer({
   appType: 'custom',
 });
 
-// 升级委托：与 vite hmrServerWsListener 同条件（协议整串匹配 + pathname === 认领路径）。
-// viteHmrPath 与 vite 同一 resolved config、同式 posix.join 派生——恒等无漂移（字面比较
-// 在未来设 base 时有悬挂方向：delegate 认领转发而 vite 不接，socket 无人销毁）。协议轴
-// 必须保留：hub 是纯事件载体无 destroy，仅匹配 path 的非 vite 协议升级会转发后无人认领。
+// 升级委托：pathname === 认领路径（与 vite 同一 resolved config 同式 posix.join 派生——
+// 恒等无漂移，字面比较在未来设 base 时有悬挂方向：delegate 认领转发而 vite 不接，socket
+// 无人销毁）；协议轴 = 子协议补写 + 白名单（见下）。
+// 子协议补写（2026-09-21，详见 .agents/notes/implemented/bug-fix/
+// 2026-09-21-spanner-ws-subprotocol-strip-reload-loop.md）：Spanner 网关（*.coding.tboxpro.cn
+// 车道）把 WS 升级的 Sec-WebSocket-Protocol 视为 hop-by-hop 在下游拨号时剥除（2026-09-09
+// Terminal Note 同源实证：Authorization/Cookie/子协议均剥、query 唯一存活）。剥除后的拨号
+// 无协议头——原逻辑不认领 → 回落 app upgrade destroy → 网关报 "unexpected EOF"；WebKit
+// （Safari/iOS 支付宝·微信）宽松接受网关乐观 101（无协议回显），hmr WS open 即断 → vite
+// client vite:ws:disconnect → vite-ping 探测又被乐观 101 放行（成功判据 = open 事件，先于
+// 下游拨号结果）→ location.reload() 无限循环（Chrome/Blink 严格校验协议回显恒不 open，
+// 走静默分支免疫）。补写让下游握手成立：vite 101 带协议回显 + connected → 连接保持 →
+// 无 disconnect/ping/reload，WebKit 下 HMR 恢复可用。补写在网关透传修复（agtchannel spec
+// 2026-09-21 close/握手头透传，1b）落地后自动退化为死分支——长留不移除（sync 覆盖 + DRM
+// 回滚场景防回归载体）。其余非 vite 协议值仍不认领（smoke ⑤⑥ 语义不变）。
 // 未认领的升级回落 app 路由（业务 /ws、根路径归还业务、fail-fast 语义不变）。
 const viteHmrPath = path.posix.join(vite.config.base, HMR_WS_PATH);
 registerUpgradeDelegate((request, socket, head) => {
-  const protocol = request.headers['sec-websocket-protocol'];
-  if (protocol !== 'vite-hmr' && protocol !== 'vite-ping') return false;
   const { pathname } = new URL(request.url || '/', 'http://localhost');
   if (pathname !== viteHmrPath) return false;
+  const protocol = request.headers['sec-websocket-protocol'];
+  if (!protocol) {
+    request.headers['sec-websocket-protocol'] = 'vite-hmr';
+  } else if (protocol !== 'vite-hmr' && protocol !== 'vite-ping') {
+    return false;
+  }
   hmrHub.emit('upgrade', request, socket, head);
   return true;
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tbox.cn/app-template-agent",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "description": "tbox AI Agent 全栈模板（多包 pnpm workspace）：apps/client + apps/server。唯一模板（W4 单一模板统一化：缺省空装配 chat 形态；mall 能力经 profiles/mall 加装），能力经 tbox-app module add 模块扩展（shopping-guide/member 等）。",
   "engines": {
     "node": ">=24.0.0 <25.0.0"