Explorar el Código

feat(device): 只有 App 内走移动版,手机浏览器也用桌面版

## 用户裁决(2026-11-18)

「PC 端就是当前 PC 端的部分,mobile 端就是 APP 端」
「手机浏览器也使用桌面版」

## 改动

detectUiMode() 收敛为**单判据**:
  · UA 含 `FmodeApp/` → mobile(App 内 WebView)
  · 其余全部        → desktop(PC 浏览器、手机浏览器、平板…)

同时移除不再使用的 isPhoneUa()。

## 历史判据的两次放弃

① **视口宽度**(2026-11-10 曾为主判据)
   PC 用户把窗口拖窄就跳移动端,既意外又没法用窄窗口调试桌面端。

② **手机 UA**(本次移除)
   手机浏览器打开网址也进移动版。但移动版布局是为 App 容器设计的
   (--mob-safe-top 等安全区依赖原生状态栏高度),在手机浏览器里
   反而不如桌面版完整。

## 验证

浏览器实测(本地 4400 + msedge,分别设置 UA 与视口):

| UA | 落地路径 |
|---|---|
| 桌面浏览器 | /desktop/chat ✅ |
| 手机浏览器(iPhone 390px) | /desktop/chat ✅ |
| 手机浏览器(Android 390px) | /desktop/chat ✅ |
| App 内 WebView(含 FmodeApp) | /mobile/messages ✅ |

真机(小米 M2102K1AC):App 仍进 /mobile/messages,四个 Tab 齐全。

单测:1855/1855 通过(更新 11 条依赖旧判据的断言)。

Co-Authored-By: Claude Code <noreply@anthropic.com>
Huccct hace 1 hora
padre
commit
83f53bc44c
Se han modificado 2 ficheros con 38 adiciones y 44 borrados
  1. 23 16
      src/app/core/device.service.spec.ts
  2. 15 28
      src/app/core/device.service.ts

+ 23 - 16
src/app/core/device.service.spec.ts

@@ -58,22 +58,22 @@ describe('DeviceService', () => {
     it('/messages 与 /tabs 按端落点(桌面进会话、移动进消息列表)', () => {
       expect(make(DESKTOP_UA).normalize('/messages')).toBe('/desktop/chat');
       expect(make(DESKTOP_UA).normalize('/tabs')).toBe('/desktop/chat');
-      expect(make(IPHONE_UA, { width: 390 }).normalize('/messages')).toBe('/mobile/messages');
-      expect(make(IPHONE_UA, { width: 390 }).normalize('/tabs')).toBe('/mobile/messages');
+      expect(make(`${IPHONE_UA} FmodeApp/2.0`, { width: 390 }).normalize('/messages')).toBe('/mobile/messages');
+      expect(make(`${IPHONE_UA} FmodeApp/2.0`, { width: 390 }).normalize('/tabs')).toBe('/mobile/messages');
     });
 
     it('/chat/:id 保留 id 并加端前缀', () => {
       expect(make(DESKTOP_UA).normalize('/chat/agent-node-xinting')).toBe(
         '/desktop/chat/agent-node-xinting',
       );
-      expect(make(IPHONE_UA, { width: 390 }).normalize('/chat/agent-node-xinting')).toBe(
+      expect(make(`${IPHONE_UA} FmodeApp/2.0`, { width: 390 }).normalize('/chat/agent-node-xinting')).toBe(
         '/mobile/chat/agent-node-xinting',
       );
     });
 
     it('/chat 无 id 时落端会话页', () => {
       expect(make(DESKTOP_UA).normalize('/chat')).toBe('/desktop/chat');
-      expect(make(IPHONE_UA, { width: 390 }).normalize('/chat')).toBe('/mobile/chat');
+      expect(make(`${IPHONE_UA} FmodeApp/2.0`, { width: 390 }).normalize('/chat')).toBe('/mobile/chat');
     });
 
     it('/agent/:id 保留 id', () => {
@@ -82,13 +82,13 @@ describe('DeviceService', () => {
 
     it('/call/:agentId 落详情页(FR-11 裁决:语音暂不实现,禁建通话路由)', () => {
       expect(make(DESKTOP_UA).normalize('/call/agent-a')).toBe('/desktop/agent/agent-a');
-      expect(make(IPHONE_UA, { width: 390 }).normalize('/call/agent-a')).toBe(
+      expect(make(`${IPHONE_UA} FmodeApp/2.0`, { width: 390 }).normalize('/call/agent-a')).toBe(
         '/mobile/agent/agent-a',
       );
     });
 
     it('简单旧路径按端加前缀(含 tasks/home)', () => {
-      const mob = make(IPHONE_UA, { width: 390 });
+      const mob = make(`${IPHONE_UA} FmodeApp/2.0`, { width: 390 });
       for (const p of [
         'workbench',
         'deliverables',
@@ -112,27 +112,32 @@ describe('DeviceService', () => {
 
     it('未知路径 / 空值回落到端默认页', () => {
       expect(make(DESKTOP_UA).normalize('/unknown-thing')).toBe('/desktop/chat');
-      expect(make(IPHONE_UA, { width: 390 }).normalize('/unknown-thing')).toBe('/mobile/messages');
+      expect(make(`${IPHONE_UA} FmodeApp/2.0`, { width: 390 }).normalize('/unknown-thing')).toBe('/mobile/messages');
       expect(make(DESKTOP_UA).normalize('')).toBe('/desktop/chat');
     });
 
     it('查询串被保留(登录回跳等场景需要)', () => {
       expect(make(DESKTOP_UA).normalize('/chat/abc?x=1')).toBe('/desktop/chat/abc?x=1');
-      expect(make(IPHONE_UA, { width: 390 }).normalize('/messages?tab=unread')).toBe(
+      // 2026-11-18:mobile 只认 App UA(手机浏览器也走桌面版)
+      expect(make(`${IPHONE_UA} FmodeApp/2.0`, { width: 390 }).normalize('/messages?tab=unread')).toBe(
         '/mobile/messages?tab=unread',
       );
     });
   });
 
   describe('detect(UA / 视口判定)', () => {
-    it('iPhone UA → mobile', () => {
-      expect(make(IPHONE_UA, { width: 390 }).mode()).toBe('mobile');
+    it('🔴 iPhone UA(浏览器)→ desktop(2026-11-18 手机浏览器也用桌面版)', () => {
+      /*
+       * 用户裁决:「手机浏览器也使用桌面版」。
+       * 移动版布局是为 App 容器设计的,只有 UA 带 FmodeApp 才走 mobile。
+       */
+      expect(make(IPHONE_UA, { width: 390 }).mode()).toBe('desktop');
     });
 
-    it('Android 手机 UA(含 Mobile)→ mobile', () => {
+    it('🔴 Android 手机 UA(浏览器)→ desktop', () => {
       expect(
         make('Mozilla/5.0 (Linux; Android 14; Pixel 8) AppleWebKit/537.36 Mobile').mode(),
-      ).toBe('mobile');
+      ).toBe('desktop');
     });
 
     it('Android 平板(无 Mobile 标记)→ desktop', () => {
@@ -217,14 +222,16 @@ describe('DeviceService', () => {
   describe('entryPath(AC-17.1 两端默认落地页)', () => {
     it('桌面落 /desktop/chat、移动落 /mobile/messages(会话入口)', () => {
       expect(make(DESKTOP_UA).entryPath()).toBe('/desktop/chat');
-      expect(make(IPHONE_UA, { width: 390 }).entryPath()).toBe('/mobile/messages');
+      // 2026-11-18:mobile 只认 App UA
+      expect(make(`${IPHONE_UA} FmodeApp/2.0`, { width: 390 }).entryPath()).toBe('/mobile/messages');
     });
   });
 
   describe('path(逻辑路径 → 带端前缀)', () => {
     it('按当前端拼前缀', () => {
       expect(make(DESKTOP_UA).path('/chat/a')).toBe('/desktop/chat/a');
-      expect(make(IPHONE_UA, { width: 390 }).path('/chat/a')).toBe('/mobile/chat/a');
+      // 2026-11-18:mobile 只认 App UA
+      expect(make(`${IPHONE_UA} FmodeApp/2.0`, { width: 390 }).path('/chat/a')).toBe('/mobile/chat/a');
     });
 
     it('🔴 回归:不得重复拼端前缀(normalize 返回的已带前缀)', () => {
@@ -288,8 +295,8 @@ describe('DeviceService · 纯自动识别(视口优先)', () => {
     expect(svc.detect()).toBe('desktop');
   });
 
-  it('🔴 手机 UA 横屏(宽度已够)→ 仍是移动端', () => {
-    expect(make(IPHONE_UA, 844).detect()).toBe('mobile');
+  it('🔴 手机 UA 横屏(浏览器)→ desktop(2026-11-18 手机浏览器用桌面版)', () => {
+    expect(make(IPHONE_UA, 844).detect()).toBe('desktop');
   });
 
   it('🔴 App 内 WebView(UA 带 FmodeApp)→ 移动端', () => {

+ 15 - 28
src/app/core/device.service.ts

@@ -33,45 +33,32 @@ export const NARROW_PX = 768;
  */
 export function detectUiMode(): UiMode {
   /*
-   * 🔴 2026-11-18 用户裁决:**只按 UA 判端,不再看视口宽度**。
+   * 🔴 2026-11-18 用户裁决:**只有 App 内才走移动端布局**。
    *
-   * 用户原话:「PC 端就是当前 PC 端的部分,然后 mobile 端就是 APP 端,
-   *            看看是否可以先不要做(自动跳转)」
+   * 用户原话:
+   *   「PC 端就是当前 PC 端的部分,然后 mobile 端就是 APP 端」
+   *   「手机浏览器也使用桌面版」
    *
-   * 定位调整:
-   *   · **PC 端(网页)** = 桌面横版布局。窗口拖窄也保持桌面布局,
-   *     不自动切移动端 —— 用户自己知道窗口小了,缩放/全屏即可。
-   *   · **Mobile 端** = 装进 App 的竖版布局(WebView 的 UA 带 `FmodeApp/2.0`,
-   *     见 `capacitor.config.ts` 的 `appendUserAgent`)。
+   * 最终规则(唯一判据):
+   *   · UA 含 `FmodeApp/` → **mobile**(装进 App 的 WebView)
+   *   · 其余所有情况     → **desktop**(PC 浏览器、手机浏览器、平板…)
    *
-   * ## 为什么去掉「视口优先」
+   * ## 历史上被推翻的两条判据
    *
-   * 原逻辑(2026-11-10)以窗口宽度为主判据,副作用是:
-   *   ① PC 用户把窗口拖窄 → 刷新直接跳进移动端布局(用户觉得莫名其妙)
-   *   ② 无法用窄窗口调试桌面端
+   * ① **视口宽度**(2026-11-10 曾为主判据)—— PC 用户把窗口拖窄就跳移动端,
+   *    既意外又没法用窄窗口调试桌面端。
+   * ② **手机 UA**(原 ②条件)—— 手机浏览器打开网址也进移动版,
+   *    但用户明确要求「手机浏览器用桌面版」:移动版布局是**为 App 容器**
+   *    设计的(`--mob-safe-top` 等安全区依赖原生状态栏高度),
+   *    在手机浏览器里反而不如桌面版完整。
    *
-   * 现在只认 UA,行为可预测:**什么设备,什么布局**。
+   * 现在行为完全可预测:**装没装成 App,决定用哪种布局**。
    */
   if (typeof navigator === 'undefined') return 'desktop';
-  /*
-   * App 内 WebView:`capacitor.config.ts` 追加了 `FmodeApp/2.0` 标记,
-   * 这是最可靠的「我跑在 App 里」信号,优先于普通手机 UA 判断。
-   */
   if (/FmodeApp\//i.test(navigator.userAgent)) return 'mobile';
-  if (isPhoneUa()) return 'mobile';
-
-  // 平板(含 iPadOS 伪装的桌面 UA)→ 桌面端
   return 'desktop';
 }
 
-/** UA 是否明确是手机 */
-function isPhoneUa(): boolean {
-  if (typeof navigator === 'undefined') return false;
-  return /iPhone|iPod|Android.*Mobile|Windows Phone|BlackBerry|webOS|Opera Mini/i.test(
-    navigator.userAgent,
-  );
-}
-
 /**
  * 当前视口是不是「窄屏」(该给移动端)。
  *