@allbluecn/web-app 0.23.1 → 0.23.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allbluecn/web-app",
-  "version": "0.23.1",
+  "version": "0.23.3",
   "license": "AGPL-3.0-or-later",
   "type": "module",
   "files": [
@@ -60,9 +60,9 @@
   "dependencies": {
     "@ag-ui/core": "1.0.0",
     "@allbluecn/collab-core": "0.2.0",
-    "@allbluecn/database": "0.12.1",
+    "@allbluecn/database": "0.12.2",
     "@allbluecn/kernel": "0.12.0",
-    "@allbluecn/sync-core": "0.5.4",
+    "@allbluecn/sync-core": "0.6.0",
     "@ariakit/react": "^0.4.28",
     "@auth/core": "^0.41.2",
     "@auth/prisma-adapter": "^2.11.2",

package/src/components/desktop/__tests__/desktop-state-listener.test.tsx

@@ -0,0 +1,183 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+//
+// DesktopStateListener 身份切换三件套（桌面本地优先 A11，设计 D1；审查修复轮 1）：
+// 只喂状态机真实迁移序列（身份切换必经 transferring——直接相邻 guest↔cloud 推送
+// 对在状态机里不可能产生，初版测试喂非法直达序列是假阳性）。断言语义：
+//   - bind 全程 guest→transferring→cloud：transferring 过境不触发、完成时触发一次
+//   - 登出全程 cloud→transferring→guest：触发一次
+//   - bind 失败 guest→transferring→guest / 登出失败 cloud→transferring→cloud /
+//     rebind 成功 cloud→transferring→cloud：首尾同态，全程不触发
+//   - rebind 失败回 guest cloud→transferring→guest：触发（属主确已翻转）
+//   - 基线竞态：晚到的查询响应不得把推送已建立的基线回退成旧值
+//   - 基线为 transferring：不记录，首个非转移态只建立基线
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { act, cleanup, render } from '@testing-library/react'
+
+type Kind = 'guest' | 'transferring' | 'cloud'
+type StatePayload = { kind: Kind; updatedAt: string }
+
+const resetAuthProfileCacheFn = vi.hoisted(() => vi.fn(async () => ({ success: true })))
+const queryClear = vi.hoisted(() => vi.fn())
+
+vi.mock('@/server/serverFns/auth/session', () => ({ resetAuthProfileCacheFn }))
+vi.mock('@/lib/query-client-seam', () => ({ getQueryClient: () => ({ clear: queryClear }) }))
+
+let stateListener: ((p: StatePayload) => void) | null = null
+// null = 桥无 desktopState 查询方法；'deferred' = 挂起的手工 resolve 查询
+let desktopStateImpl: (() => Promise<StatePayload>) | null = null
+let noBridge = false
+
+vi.mock('@/lib/desktop-bridge-types', () => ({
+  getDesktopBridge: () => {
+    if (noBridge) return null
+    // desktopStateImpl = null 模拟「旧壳无查询方法」（onDesktopState 仍在）；
+    // noBridge 才是无桥（浏览器）
+    const bridge: Record<string, unknown> = {
+      onDesktopState: (cb: (p: StatePayload) => void) => {
+        stateListener = cb
+        return () => {
+          stateListener = null
+        }
+      },
+    }
+    if (desktopStateImpl) bridge.desktopState = desktopStateImpl
+    return bridge
+  },
+}))
+
+import { DesktopStateListener } from '../desktop-state-listener'
+
+const payload = (kind: Kind): StatePayload => ({ kind, updatedAt: '2026-11-01T00:00:00Z' })
+
+// jsdom 的 location.reload 是 [Unforgeable]（不可 spy），整对象替换为带 mock 的
+// 桩（同仓首例；jsdom 实测 defineProperty 可行）
+const reload = vi.hoisted(() => vi.fn())
+
+beforeEach(() => {
+  stateListener = null
+  desktopStateImpl = async () => payload('guest')
+  resetAuthProfileCacheFn.mockClear()
+  queryClear.mockClear()
+  reload.mockClear()
+  Object.defineProperty(window, 'location', { value: { ...window.location, reload }, writable: true })
+})
+
+afterEach(() => {
+  desktopStateImpl = null
+  noBridge = false
+  cleanup()
+  vi.restoreAllMocks()
+  // reload 桩经 defineProperty 替换的是 location 对象本身，无需恢复（每文件独立 jsdom 实例）
+})
+
+async function renderListener(): Promise<void> {
+  render(<DesktopStateListener />)
+  // 初始查询建立基线（异步 then）——微任务排空后再收推送
+  await act(async () => {
+    await Promise.resolve()
+    await Promise.resolve()
+  })
+}
+
+/** 推送一条状态并排空微任务（fireIdentityInvalidation 的 await 链） */
+async function push(kind: Kind): Promise<void> {
+  await act(async () => {
+    stateListener?.(payload(kind))
+    await Promise.resolve()
+  })
+}
+
+const expectNoFire = (): void => {
+  expect(resetAuthProfileCacheFn).not.toHaveBeenCalled()
+  expect(queryClear).not.toHaveBeenCalled()
+  expect(reload).not.toHaveBeenCalled()
+}
+
+describe('DesktopStateListener 真实迁移序列（审查修复轮 1）', () => {
+  it('bind 全程 guest→transferring→cloud：过境不触发、完成触发一次三件套', async () => {
+    await renderListener()
+    await push('transferring')
+    expectNoFire()
+    await push('cloud')
+    expect(resetAuthProfileCacheFn).toHaveBeenCalledTimes(1)
+    expect(queryClear).toHaveBeenCalledTimes(1)
+    expect(reload).toHaveBeenCalledTimes(1)
+  })
+
+  it('登出全程 cloud→transferring→guest：触发一次', async () => {
+    desktopStateImpl = async () => payload('cloud')
+    await renderListener()
+    await push('transferring')
+    expectNoFire()
+    await push('guest')
+    expect(queryClear).toHaveBeenCalledTimes(1)
+    expect(reload).toHaveBeenCalledTimes(1)
+  })
+
+  it('bind 失败 guest→transferring→guest：首尾同态全程不触发', async () => {
+    await renderListener()
+    await push('transferring')
+    await push('guest')
+    expectNoFire()
+  })
+
+  it('登出失败 cloud→transferring→cloud：首尾同态全程不触发', async () => {
+    desktopStateImpl = async () => payload('cloud')
+    await renderListener()
+    await push('transferring')
+    await push('cloud')
+    expectNoFire()
+  })
+
+  it('rebind 成功 cloud→transferring→cloud：首尾同态全程不触发', async () => {
+    desktopStateImpl = async () => payload('cloud')
+    await renderListener()
+    await push('transferring')
+    await push('cloud')
+    expectNoFire()
+  })
+
+  it('rebind 失败回 guest cloud→transferring→guest：触发（属主确已翻转）', async () => {
+    desktopStateImpl = async () => payload('cloud')
+    await renderListener()
+    await push('transferring')
+    await push('guest')
+    expect(queryClear).toHaveBeenCalledTimes(1)
+    expect(reload).toHaveBeenCalledTimes(1)
+  })
+
+  it('基线竞态守卫：晚到查询响应不回退推送已建立的基线', async () => {
+    // 查询挂起期间推送 cloud 先到建立基线；查询随后以旧值 guest 晚到——
+    // 守卫下 last 保持 cloud，此后 guest 推送判异触发（无守卫则会 guest==guest 不触发）
+    let resolveQuery!: (p: StatePayload) => void
+    desktopStateImpl = () => new Promise<StatePayload>((res) => { resolveQuery = res })
+    render(<DesktopStateListener />)
+    await push('cloud')
+    await act(async () => {
+      resolveQuery(payload('guest'))
+      await Promise.resolve()
+      await Promise.resolve()
+    })
+    expectNoFire() // 晚到基线被守卫忽略，也未误触发
+    await push('guest')
+    expect(queryClear).toHaveBeenCalledTimes(1)
+    expect(reload).toHaveBeenCalledTimes(1)
+  })
+
+  it('基线查询返回 transferring：不记录，首个非转移态只建立基线不触发', async () => {
+    desktopStateImpl = async () => payload('transferring')
+    await renderListener()
+    await push('cloud')
+    expectNoFire() // cloud 是基线建立（transferring 过境后首个非转移态）
+    await push('guest')
+    expect(queryClear).toHaveBeenCalledTimes(1)
+    expect(reload).toHaveBeenCalledTimes(1)
+  })
+
+  it('无 desktopBridge：零订阅零行为（浏览器/云端部署零成本）', async () => {
+    noBridge = true
+    const render1 = render(<DesktopStateListener />)
+    render1.unmount()
+    expect(stateListener).toBeNull()
+  })
+})

package/src/components/desktop/__tests__/sync-indicator.test.tsx

@@ -0,0 +1,130 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+//
+// DesktopSyncIndicator 三态徽标（桌面本地优先 A11）：desktopState 查询建立初始
+// 徽标 + onDesktopState 推送更新；三态文案走 i18n（desktop_state_*）；旧壳
+// （无 desktopState/onDesktopState）与无桥（浏览器）优雅降级；同步相位行回归。
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { act, cleanup, render, screen, waitFor } from '@testing-library/react'
+import { m } from '@/paraglide/messages.js'
+
+type Kind = 'guest' | 'transferring' | 'cloud'
+type StatePayload = { kind: Kind; updatedAt: string }
+
+// 可控 fake bridge（组件仅消费 getDesktopBridge 值导入，类型导入被擦除不受 mock 影响）
+let syncListener: ((s: unknown) => void) | null = null
+let stateListener: ((p: StatePayload) => void) | null = null
+let desktopStateImpl: (() => Promise<StatePayload>) | undefined
+let onDesktopStateImpl: ((cb: (p: StatePayload) => void) => () => void) | undefined
+
+vi.mock('@/lib/desktop-bridge-types', () => ({
+  getDesktopBridge: () => bridgeRef.current,
+}))
+
+const bridgeRef = {
+  current: {
+    onSyncState: (cb: (s: unknown) => void) => {
+      syncListener = cb
+      return () => {
+        syncListener = null
+      }
+    },
+  } as unknown as NonNullable<ReturnType<typeof import('@/lib/desktop-bridge-types').getDesktopBridge>>,
+}
+
+function makeBridge(overrides: Partial<Record<'desktopState' | 'onDesktopState', undefined>> = {}) {
+  return {
+    onSyncState: (cb: (s: unknown) => void) => {
+      syncListener = cb
+      return () => {
+        syncListener = null
+      }
+    },
+    desktopState: overrides.desktopState === undefined ? desktopStateImpl : undefined,
+    onDesktopState: overrides.onDesktopState === undefined ? onDesktopStateImpl : undefined,
+  } as unknown as NonNullable<ReturnType<typeof import('@/lib/desktop-bridge-types').getDesktopBridge>>
+}
+
+import { DesktopSyncIndicator } from '../sync-indicator'
+
+beforeEach(() => {
+  syncListener = null
+  stateListener = null
+  desktopStateImpl = async () => ({ kind: 'guest', updatedAt: '2026-11-01T00:00:00Z' })
+  onDesktopStateImpl = (cb: (p: StatePayload) => void) => {
+    stateListener = cb
+    return () => {
+      stateListener = null
+    }
+  }
+})
+
+afterEach(() => {
+  bridgeRef.current = undefined as never
+  cleanup()
+  vi.clearAllMocks()
+})
+
+describe('DesktopSyncIndicator 三态徽标（A11）', () => {
+  it('初始查询建立基线：guest 徽标 + i18n 文案', async () => {
+    bridgeRef.current = makeBridge()
+    render(<DesktopSyncIndicator />)
+    const badge = await screen.findByTestId('desktop-state-badge')
+    expect(badge.getAttribute('data-desktop-state')).toBe('guest')
+    expect(badge.textContent).toContain(m.desktop_state_guest())
+  })
+
+  it('事件推送 transferring：徽标随推送更新（过境态）', async () => {
+    bridgeRef.current = makeBridge()
+    render(<DesktopSyncIndicator />)
+    await screen.findByTestId('desktop-state-badge')
+    await act(async () => {
+      stateListener?.({ kind: 'transferring', updatedAt: '2026-11-01T00:00:01Z' })
+    })
+    const badge = screen.getByTestId('desktop-state-badge')
+    expect(badge.getAttribute('data-desktop-state')).toBe('transferring')
+    expect(badge.textContent).toContain(m.desktop_state_transferring())
+  })
+
+  it('事件推送 cloud：徽标迁云态（身份切换终态）', async () => {
+    bridgeRef.current = makeBridge()
+    render(<DesktopSyncIndicator />)
+    await screen.findByTestId('desktop-state-badge')
+    await act(async () => {
+      stateListener?.({ kind: 'cloud', updatedAt: '2026-11-01T00:00:02Z' })
+    })
+    const badge = screen.getByTestId('desktop-state-badge')
+    expect(badge.getAttribute('data-desktop-state')).toBe('cloud')
+    expect(badge.textContent).toContain(m.desktop_state_cloud())
+  })
+
+  it('旧壳降级：无 desktopState/onDesktopState 时不渲染徽标、同步行不受影响', async () => {
+    bridgeRef.current = makeBridge({ desktopState: undefined, onDesktopState: undefined })
+    render(<DesktopSyncIndicator />)
+    await waitFor(() => {
+      expect(screen.queryByTestId('desktop-state-badge')).toBeNull()
+    })
+    // 同步相位行仍工作（既有行为回归哨兵）
+    await act(async () => {
+      syncListener?.({ phase: 'pushing', pending: 3, lastError: null, lastSyncedAt: null })
+    })
+    expect(screen.getByTestId('desktop-sync-indicator').textContent).toContain('推送中')
+  })
+
+  it('无 desktopBridge（浏览器/云端部署）：组件整体返回 null', () => {
+    bridgeRef.current = undefined as never
+    const { container } = render(<DesktopSyncIndicator />)
+    expect(container.textContent).toBe('')
+  })
+
+  it('三态齐备时同步相位行与徽标共存（双行）', async () => {
+    bridgeRef.current = makeBridge()
+    render(<DesktopSyncIndicator />)
+    await screen.findByTestId('desktop-state-badge')
+    await act(async () => {
+      syncListener?.({ phase: 'idle', pending: 0, lastError: null, lastSyncedAt: '2026-11-01' })
+    })
+    const wrapper = screen.getByTestId('desktop-sync-indicator')
+    expect(wrapper.textContent).toContain(m.desktop_state_guest())
+    expect(wrapper.textContent).toContain('已同步')
+  })
+})

package/src/components/desktop/cloud-login.tsx

@@ -5,20 +5,38 @@
 // 桌面云端登录桥（迁移设计 §3.6）：表单调用 desktopBridge.cloudLogin
 // （main 侧 desktopLogin 走云端 credentials），成功后引擎自动拾取会话
 // （makeFetchApi 每次同步重读 cloud-session.json）。
+// P2 A10 轻量云身份激活：登录成功回调链追加 exchangeCloudSession（main 从
+// cloud-session.json 解纯 token）→ exchangeRemoteTokenFn（serverFn 换权益并
+// 写 remote-auth，getCurrentSession 桌面回落由此得云身份）→ queryClient.clear
+// （规格 D1：identity 变化缓存失效）→ 整页 reload 重载 session。exchange 阶段
+// 失败 toast 提示重试、不 reload（登录 cookie 已落盘，同步引擎可用）。
+// P2 A8b 归属转移串联：exchange 成功后 claim 探测（probeCloudAccountStatusFn
+// 代持云会话 token 问 SaaS 账号是否空账号）——空账号进入 bind 流程（bindBegin
+// 停写快照 → transferOwnershipFn 单事务翻转 guest→cloud（身份字段省略，server
+// 侧自取 SaaS profile）→ bindDone 清快照触发 push → reload）；非空账号一期不
+// 支持转移（提示后仍 reload，云身份生效、本地数据保留 guest 属主）；转移失败
+// bindFail 恢复快照回 guest 态（toast 提示，不 reload）。
 // 独立于 web 登录页——web 表单走本地 serverFn authjs，二者不混用。
 import { useEffect, useState } from "react"
+import { useQueryClient } from "@tanstack/react-query"
 import { getDesktopBridge } from "@/lib/desktop-bridge-types"
+import { exchangeRemoteTokenFn, logoutRemoteFn } from "@/server/serverFns/auth/session"
+import { probeCloudAccountStatusFn, transferOwnershipFn } from "@/server/serverFns/sync/transfer"
 import { Button } from "@/components/ui/button"
 import { Input } from "@/components/ui/input"
 import { Label } from "@/components/ui/label"
+import { toast } from "@/components/ui/toast"
+import { m } from "@/paraglide/messages.js"
 
 export function DesktopCloudLogin() {
   const [email, setEmail] = useState("")
   const [password, setPassword] = useState("")
   const [busy, setBusy] = useState(false)
+  const [binding, setBinding] = useState(false)
   const [error, setError] = useState<string | null>(null)
   const [ok, setOk] = useState(false)
   const [mounted, setMounted] = useState(false)
+  const queryClient = useQueryClient()
 
   // 环境自判（与 sync-indicator/conflict-center 同构，mounted 模式保证 SSR/客户端
   // 首帧一致）：仅桌面壳（存在 desktopBridge）时渲染。web/云端部署下本组件由
@@ -30,20 +48,104 @@ export function DesktopCloudLogin() {
 
   const submit = async () => {
     const bridge = getDesktopBridge()
-    if (!bridge || !email || !password || busy) return
+    if (!bridge || !email || !password || busy || binding) return
     setBusy(true)
     setError(null)
     try {
       const res = await bridge.cloudLogin(email, password)
-      if (res.ok) {
-        setOk(true)
-      } else {
+      if (!res.ok) {
         setError(res.error ?? "登录失败")
+        return
+      }
+      // 激活阶段（token 交换）失败：toast 提示重试，不 reload——登录 cookie
+      // 已落盘（同步引擎可用），仅云身份未激活，留在登录表单可重试
+      let cloudUserId: string | undefined
+      try {
+        const ex = await bridge.exchangeCloudSession()
+        if (!ex.ok || !ex.token) throw new Error(ex.error ?? "exchange 无 token")
+        const activated = await exchangeRemoteTokenFn({ data: { token: ex.token } })
+        cloudUserId = activated.userId ?? res.userId
+      } catch {
+        toast.error(m.desktop_cloud_exchange_failed())
+        return
+      }
+      if (!cloudUserId) {
+        // 防御：exchange 与 cloudLogin 均未回 userId（不应发生）——按激活失败处理
+        toast.error(m.desktop_cloud_exchange_failed())
+        return
+      }
+
+      // claim 探测（A8b）：探测异常按非空处理（宁可不转不可错转）。旧壳无
+      // bind 三方法时同样只激活云身份不转移（优雅降级，A10 行为）。
+      const { bindBegin, bindDone, bindFail } = bridge
+      let probe: { empty: boolean; unreachable?: boolean } = { empty: false, unreachable: true }
+      if (bindBegin && bindDone && bindFail) {
+        try {
+          probe = await probeCloudAccountStatusFn()
+        } catch {
+          probe = { empty: false, unreachable: true }
+        }
+      }
+
+      if (!(bindBegin && bindDone && bindFail)) {
+        // 旧壳降级（无 bind 三 IPC）：只激活云身份不转移（A10 行为），提示后
+        // 仍 reload 生效（本地数据保留 guest 属主）。与探测不可达分路如实提示。
+        toast.info(m.sync_bind_shell_unsupported())
+        setOk(true)
+        queryClient.clear()
+        window.location.reload()
+        return
+      }
+      if (!probe.empty) {
+        // 非空账号：一期不支持转移——云身份已激活，仍 reload 生效（本地数据
+        // 保留 guest 属主，二期做云端 bootstrap 下载）。探测不可达与「确认
+        // 非空」分路提示（不可达 ≠ 账号有数据，勿误导）。
+        toast.info(probe.unreachable ? m.sync_bind_probe_unreachable() : m.sync_bind_nonempty())
+        setOk(true)
+        queryClient.clear()
+        window.location.reload()
+        return
+      }
+
+      // 空账号 → 归属转移 bind 流程：main 侧停写快照（bindBegin）→ renderer 调
+      // 转移 serverFn（localhost cookie 过鉴权；身份字段省略，server 自取
+      // profile）→ 成功 bindDone（清快照 + 触发 push）；失败 bindFail（停
+      // backend 还原快照重启，回 guest 态）。
+      setBinding(true)
+      const begin = await bindBegin()
+      if (!begin.ok) {
+        // 快照失败未进转移面（begin 已自行解锁）：提示后留在表单可重试
+        toast.error(m.sync_bind_failed())
+        return
+      }
+      try {
+        await transferOwnershipFn({ data: { cloudUserId } })
+      } catch {
+        // 转移失败（单事务已回滚）：main 侧恢复快照回 guest 态 + 回滚云身份激活
+        // （修复轮 1 发现 2：exchange 已写 remote-auth，不清则 reload/重启后
+        // getSessionFn 桌面回落返回云身份，guest 数据全部不可见＝「假丢数据」；
+        // logoutRemoteFn 桌面守卫内清 remote-auth，cloud-session.json 保留——
+        // A11 三态统一治理，不在本轮）。提示后不 reload（本机会话仍是 guest，
+        // 表单可重试）。
+        await bindFail?.().catch(() => null)
+        await logoutRemoteFn({ data: {} }).catch(() => null)
+        toast.error(m.sync_bind_failed())
+        return
       }
+      // bindDone 失败不回滚：转移已成功 + 云身份已激活，残留快照由下次
+      // bindBegin 清理；push 由 bindDone 失败时的下一 60s tick 兜底
+      await bindDone?.().catch(() => null)
+      // 身份已切换 + 本地属主已翻转：清 react-query 缓存（规格 D1）+ 整页刷新
+      // （reload 后 getSessionFn 桌面回落即得云身份）
+      setOk(true)
+      queryClient.clear()
+      window.location.reload()
+      return
     } catch (e) {
       setError(e instanceof Error ? e.message : String(e))
     } finally {
       setBusy(false)
+      setBinding(false)
     }
   }
 
@@ -83,8 +185,8 @@ export function DesktopCloudLogin() {
         />
       </div>
       {error && <p className="text-xs text-destructive">{error}</p>}
-      <Button size="sm" className="w-full" disabled={busy || !email || !password} onClick={() => void submit()}>
-        {busy ? "登录中…" : "登录云端"}
+      <Button size="sm" className="w-full" disabled={busy || binding || !email || !password} onClick={() => void submit()}>
+        {binding ? m.sync_bind_in_progress() : busy ? "登录中…" : "登录云端"}
       </Button>
     </div>
   )

package/src/components/desktop/desktop-state-listener.tsx

@@ -0,0 +1,76 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+
+// desktop-state 身份切换监听（桌面本地优先 A11，缓存三件套兜底面）：订阅
+// desktopBridge.onDesktopState，身份切换（guest↔cloud）完成时执行设计 D1 三件套
+// ——① resetAuthProfileCacheFn（服务端 auth.config profileCache 模块缓存，renderer
+// 无法直清、serverFn 是唯一载体）② queryClient.clear() ③ window.location.reload()。
+// 分工（幂等共存）：A8b/A9 流内 inline 失效（cloud-login / user-menu）是 UX 时序
+// 主路径（紧跟用户操作、先于 toast/reload）；本监听是兜底面——覆盖流外身份变化
+// （token 过期回落、未来其他切换路径）。两者都做完整三件套，重复执行无副作用
+// （clear/reload 幂等）。
+// 触发判定（审查修复轮 1 Critical）：状态机迁移表钉死身份切换必经 transferring
+// （guest/cloud 态仅 begin 类事件合法），故 transferring 过境透明——last 只记
+// 最近非转移态，新的非转移态到达时与 last 比较判异。七条真实序列的语义：
+//   bind 全程  guest→transferring→cloud           → 触发（guest≠cloud）
+//   登出全程  cloud→transferring→guest            → 触发（cloud≠guest）
+//   登出后重绑 guest→transferring→cloud           → 触发（同 bind 全程）
+//   rebind 失败回 guest cloud→transferring→guest   → 触发（属主确已翻转）
+//   bind 失败  guest→transferring→guest           → 不触发（首尾同态）
+//   登出失败  cloud→transferring→cloud            → 不触发（首尾同态）
+//   rebind 成功 cloud→transferring→cloud          → 不触发（首尾同态）
+// （直接相邻 guest↔cloud 推送对在状态机里不可能产生——初版 isIdentitySwitch
+// 正是因此不可达，见 task-A11-report.md 修复轮 1。）
+// 基线建立（reload 后首条非转移态查询/推送）只记录不触发——防 reload 循环。
+// 挂载点：shell-widgets（Providers 全页挂载，桌面壳外零成本——无 desktopBridge
+// 即不订阅）。
+import { useEffect } from "react"
+import { getDesktopBridge } from "@/lib/desktop-bridge-types"
+import type { DesktopStateKind } from "@/lib/desktop-bridge-types"
+import { getQueryClient } from "@/lib/query-client-seam"
+import { resetAuthProfileCacheFn } from "@/server/serverFns/auth/session"
+
+/**
+ * 三件套（顺序即依赖：先清服务端缓存再 reload——reload 后 session 链会回源
+ * profile；serverFn 失败不阻断 ②③，profileCache 30s TTL 自愈，缓存卫生尽力
+ * 而为、会话切换硬保证）。非导出模块函数：本文件唯一导出是组件（Fast Refresh）。
+ */
+async function fireIdentityInvalidation(): Promise<void> {
+  try {
+    await resetAuthProfileCacheFn({ data: {} })
+  } catch {
+    // 尽力而为：backend 不可达/非桌面部署时静默——TTL 30s 内自愈
+  }
+  getQueryClient().clear()
+  window.location.reload()
+}
+
+export function DesktopStateListener() {
+  useEffect(() => {
+    const bridge = getDesktopBridge()
+    if (!bridge?.onDesktopState) return
+    // 基线：null = 未建立（本会话尚无已知非转移态）
+    let last: DesktopStateKind | null = null
+    // 基线查询（reload 后推送事件已错过，查询补当前态）：仅 last===null 且非
+    // transferring 时写入——Electron invoke 响应与 push 事件到达顺序无保证，
+    // 晚到的查询响应不得把推送已建立的基线回退成旧值（竞态守卫）
+    void bridge.desktopState
+      ?.()
+      .then((p) => {
+        if (last === null && p.kind !== "transferring") last = p.kind
+      })
+      .catch(() => null)
+    const off = bridge.onDesktopState((payload) => {
+      // transferring 过境透明：不更新 last（prev 恒取最近非转移态）
+      if (payload.kind === "transferring") return
+      const prev = last
+      last = payload.kind
+      if (!prev) return // 首个非转移态 = 基线建立，不触发（防 reload 循环）
+      if (prev !== payload.kind) void fireIdentityInvalidation()
+    })
+    return off
+  }, [])
+
+  return null
+}

package/src/components/desktop/shell-widgets.tsx

@@ -3,17 +3,24 @@
 // Copyright (C) 2026 AllBlue Contributors
 
 // 桌面壳挂载组件（迁移设计 §3.7）：DEPLOY_TARGET=desktop 时挂载同步状态
-// 指示器 + 冲突中心。云端部署零成本（组件内部自判返回 null）。
+// 指示器 + 冲突中心 + desktop-state 身份切换监听。云端部署零成本（组件内部
+// 自判返回 null）。
 // 云登录入口在侧边栏用户菜单（isLocalGuest → /login）与 /settings/sync
 // 设置页卡片，不在壳层悬浮表单（2026-10-31 用户裁决移除右下角表单）。
 import { DesktopSyncIndicator } from "@/components/desktop/sync-indicator"
 import { DesktopConflictCenter } from "@/components/desktop/conflict-center"
+import { DesktopStateListener } from "@/components/desktop/desktop-state-listener"
 
 export function DesktopShellWidgets() {
   return (
-    <div className="fixed right-4 bottom-4 z-50 w-80 space-y-3">
-      <DesktopSyncIndicator />
-      <DesktopConflictCenter />
-    </div>
+    <>
+      {/* 监听器无 UI（订阅身份切换 → 缓存三件套失效），置于悬浮容器外防其
+          占位/参与布局 */}
+      <DesktopStateListener />
+      <div className="fixed right-4 bottom-4 z-50 w-80 space-y-3">
+        <DesktopSyncIndicator />
+        <DesktopConflictCenter />
+      </div>
+    </>
   )
 }