@allbluecn/web-app 0.18.2 → 0.19.0

package/src/components/collab/__tests__/activity-attribution.test.tsx

@@ -0,0 +1,211 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+// CollabActivityAttribution 组件测试（任务 18）：
+//   ① perAuthor 多人 → 「A、B 等 N 人更新了文档」+ 主作者与参与者头像
+//   ② 单人退化 → 「{name} 更新了文档」
+//   ③ 无 metadata 降级 → 主作者 + 动作标签；无主作者且无 metadata → null
+//   ④ parseCollabAttribution fail-closed：畸形 metadata / 畸形 perAuthor 条目
+// metadata 形态 = collab 导出器写入口径（apps/collab exporters/knowledge.ts）。
+
+import { describe, expect, it } from 'vitest'
+import { render, screen } from '@testing-library/react'
+import { m } from '@/paraglide/messages.js'
+import {
+  CollabActivityAttribution,
+  parseCollabAttribution,
+} from '../activity-attribution'
+
+const USERS = [
+  { id: 'u1', username: 'Alice', avatarConfig: null, bgShape: 'circle', bgColor: '#111' },
+  { id: 'u2', username: 'Bob', avatarConfig: null, bgShape: 'circle', bgColor: '#222' },
+  { id: 'u3', username: 'Carol', avatarConfig: null, bgShape: 'circle', bgColor: '#333' },
+]
+
+/** collab 导出器 AuditLog.metadata 同构（§10.2 / exporters knowledge.ts） */
+function collabMetadata(perAuthor: unknown[], totalBytes = 100) {
+  return {
+    source: 'collab',
+    summary: '更新了文档',
+    perAuthor,
+    totalBytes,
+  }
+}
+
+describe('parseCollabAttribution', () => {
+  it('合法 metadata 解析出 source/perAuthor/totalBytes', () => {
+    const parsed = parseCollabAttribution(
+      collabMetadata([
+        { authorId: 'u1', updates: 3, bytes: 60, share: 0.6 },
+        { authorId: 'u2', updates: 1, bytes: 40, share: 0.4 },
+      ]),
+    )
+    expect(parsed).not.toBeNull()
+    expect(parsed!.source).toBe('collab')
+    expect(parsed!.totalBytes).toBe(100)
+    expect(parsed!.perAuthor).toHaveLength(2)
+    expect(parsed!.perAuthor[0]).toEqual({ authorId: 'u1', updates: 3, bytes: 60, share: 0.6 })
+  })
+
+  it('非对象 metadata → null', () => {
+    expect(parseCollabAttribution(null)).toBeNull()
+    expect(parseCollabAttribution('x')).toBeNull()
+    expect(parseCollabAttribution(42)).toBeNull()
+  })
+
+  it('畸形 perAuthor 条目逐条丢弃（authorId 缺失/字段类型不符）', () => {
+    const parsed = parseCollabAttribution(
+      collabMetadata([
+        { authorId: 'u1', updates: 3, bytes: 60, share: 0.6 },
+        { authorId: 42, updates: 1, bytes: 10, share: 0.1 }, // authorId 非字符串
+        { updates: 1, bytes: 10, share: 0.1 }, // 缺 authorId（null 也非法）
+        'bad',
+      ]),
+    )
+    expect(parsed!.perAuthor).toHaveLength(1)
+    expect(parsed!.perAuthor[0]!.authorId).toBe('u1')
+  })
+})
+
+describe('CollabActivityAttribution', () => {
+  it('perAuthor 多人 → 「A、B 等 N 人更新了文档」+ 头像组', () => {
+    render(
+      <CollabActivityAttribution
+        userId="u1"
+        action="document.collab_update"
+        metadata={collabMetadata([
+          { authorId: 'u1', updates: 3, bytes: 60, share: 0.6 },
+          { authorId: 'u2', updates: 1, bytes: 25, share: 0.25 },
+          { authorId: 'u3', updates: 2, bytes: 15, share: 0.15 },
+        ])}
+        users={USERS}
+      />,
+    )
+    expect(screen.getByTestId('collab-activity-attribution')).toBeInTheDocument()
+    expect(
+      screen.getByText(m.collab_activityMany({ names: 'Alice、Bob', count: 3 })),
+    ).toBeInTheDocument()
+    // 主作者（share 最高）排在首位
+    expect(screen.getByText('A')).toBeInTheDocument()
+    expect(screen.getByText('B')).toBeInTheDocument()
+    expect(screen.getByText('C')).toBeInTheDocument()
+  })
+
+  it('perAuthor 多人但仅部分可解析 → 未解析者计入「等 N 人」总数不渲染头像', () => {
+    render(
+      <CollabActivityAttribution
+        userId="u1"
+        action="document.collab_update"
+        metadata={collabMetadata([
+          { authorId: 'u1', updates: 3, bytes: 60, share: 0.6 },
+          { authorId: 'ghost-9', updates: 1, bytes: 40, share: 0.4 },
+        ])}
+        users={USERS}
+      />,
+    )
+    expect(
+      screen.getByText(m.collab_activityMany({ names: 'Alice', count: 2 })),
+    ).toBeInTheDocument()
+    expect(screen.getByText('A')).toBeInTheDocument()
+    expect(screen.queryByText('Ghost-9')).not.toBeInTheDocument()
+  })
+
+  it('perAuthor 多人但全部不可解析 → 「N 人更新了文档」变体（空名不拼接）', () => {
+    render(
+      <CollabActivityAttribution
+        userId={null}
+        action="document.collab_update"
+        metadata={collabMetadata([
+          { authorId: 'ghost-1', updates: 3, bytes: 60, share: 0.6 },
+          { authorId: 'ghost-2', updates: 1, bytes: 40, share: 0.4 },
+        ])}
+        users={USERS}
+      />,
+    )
+    expect(
+      screen.getByText(m.collab_activityCountOnly({ count: 2 })),
+    ).toBeInTheDocument()
+    expect(screen.queryByText('、')).not.toBeInTheDocument()
+  })
+
+  it('单人退化 → 「{name} 更新了文档」', () => {
+    render(
+      <CollabActivityAttribution
+        userId="u1"
+        action="document.collab_update"
+        metadata={collabMetadata([{ authorId: 'u1', updates: 3, bytes: 100, share: 1 }])}
+        users={USERS}
+      />,
+    )
+    expect(
+      screen.getByText(m.collab_activitySingle({ name: 'Alice' })),
+    ).toBeInTheDocument()
+  })
+
+  it('无 metadata → 降级渲染主作者 + 动作标签', () => {
+    render(
+      <CollabActivityAttribution userId="u1" action="document.collab_update" metadata={null} users={USERS} />,
+    )
+    expect(
+      screen.getByText(m.collab_activitySingle({ name: 'Alice' })),
+    ).toBeInTheDocument()
+  })
+
+  it('无 metadata 且无主作者 → 渲染 null', () => {
+    const { container } = render(
+      <CollabActivityAttribution userId={null} action="document.collab_update" metadata={null} users={USERS} />,
+    )
+    expect(container.querySelector('[data-testid="collab-activity-attribution"]')).toBeNull()
+  })
+
+  it('主作者 id 无法解析 → 用未知用户占位名渲染', () => {
+    render(
+      <CollabActivityAttribution
+        userId="ghost-9"
+        action="document.collab_update"
+        metadata={collabMetadata([{ authorId: 'ghost-9', updates: 1, bytes: 100, share: 1 }])}
+        users={USERS}
+      />,
+    )
+    expect(
+      screen.getByText(m.collab_activitySingle({ name: m.collab_activityUnknownUser() })),
+    ).toBeInTheDocument()
+  })
+
+  it('参与者头像 tooltip 含字节占比（title 属性承载）', () => {
+    render(
+      <CollabActivityAttribution
+        userId="u1"
+        action="document.collab_update"
+        metadata={collabMetadata([
+          { authorId: 'u1', updates: 3, bytes: 60, share: 0.6 },
+          { authorId: 'u2', updates: 1, bytes: 40, share: 0.4 },
+        ])}
+        users={USERS}
+      />,
+    )
+    const primary = screen.getByTestId('collab-activity-user-u1')
+    expect(primary).toHaveAttribute(
+      'title',
+      m.collab_activityShare({ name: 'Alice', percent: 60 }),
+    )
+    expect(screen.getByTestId('collab-activity-user-u2')).toHaveAttribute(
+      'title',
+      m.collab_activityShare({ name: 'Bob', percent: 40 }),
+    )
+  })
+})

package/src/components/collab/__tests__/canvas-collab-panel.test.tsx

@@ -0,0 +1,118 @@
+// @vitest-environment jsdom
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+
+// 画布协作者面板测试（任务 30）：presentational 组件——remotes 由
+// presence-layer 注入（同 T25 viewer badge 数据源），doc 由画布快照注入。
+// 覆盖：头像组渲染 / 元素级「X 正在编辑」提示 / 空名降级 / 空场不渲染。
+
+import { cleanup, render } from '@testing-library/react'
+import { afterEach, describe, expect, it } from 'vitest'
+import { BOARD_NODE_ID, createEmptyDoc, type SceneDocument } from '@/components/design/canvas/document/types'
+import type { RemoteCanvasPresence } from '@/lib/collab/bindings/canvas-presence'
+import { CanvasCollabPanel } from '../canvas-collab-panel'
+
+function makeDoc(): SceneDocument {
+  const doc = createEmptyDoc()
+  doc.nodes.push({
+    id: 'rect-1',
+    kind: 'shape',
+    type: 'rect',
+    parentId: BOARD_NODE_ID,
+    x: 0,
+    y: 0,
+    width: 10,
+    height: 10,
+    name: '登录按钮',
+  })
+  return doc
+}
+
+function makeRemote(overrides: Partial<RemoteCanvasPresence>): RemoteCanvasPresence {
+  return {
+    clientId: 1,
+    userId: 'u-1',
+    name: '阿蓝',
+    selection: [],
+    viewport: { x: 0, y: 0, zoom: 1 },
+    ts: 1,
+    ...overrides,
+  }
+}
+
+afterEach(cleanup)
+
+describe('CanvasCollabPanel（画布协作者面板）', () => {
+  it('无远端在场渲染 null（零侵入）', () => {
+    const { container } = render(<CanvasCollabPanel remotes={[]} doc={makeDoc()} />)
+    expect(container.querySelector('[data-testid="canvas-collab-panel"]')).toBeNull()
+  })
+
+  it('有远端渲染头像点（每人一枚色点）', () => {
+    const remotes = [
+      makeRemote({}),
+      makeRemote({ clientId: 2, userId: 'u-2', name: '小蓝' }),
+    ]
+    const { container } = render(<CanvasCollabPanel remotes={remotes} doc={makeDoc()} />)
+    expect(container.querySelectorAll('[data-collab-avatar]')).toHaveLength(2)
+  })
+
+  it('远端选中元素 → 「X 正在编辑「元素名」」提示（元素名取本地 doc 同 id 节点）', () => {
+    const { container } = render(
+      <CanvasCollabPanel
+        remotes={[makeRemote({ selection: ['rect-1'] })]}
+        doc={makeDoc()}
+      />,
+    )
+    const hint = container.querySelector('[data-collab-editing-hint]')
+    expect(hint?.textContent).toContain('阿蓝')
+    expect(hint?.textContent).toContain('登录按钮')
+  })
+
+  it('多人编辑 → 「X 等 N 人正在编辑」汇总提示', () => {
+    const remotes = [
+      makeRemote({ selection: ['rect-1'] }),
+      makeRemote({ clientId: 2, userId: 'u-2', name: '小蓝', selection: ['rect-1'] }),
+    ]
+    const { container } = render(<CanvasCollabPanel remotes={remotes} doc={makeDoc()} />)
+    const hint = container.querySelector('[data-collab-editing-hint]')
+    expect(hint?.textContent).toContain('阿蓝')
+    expect(hint?.textContent).toContain('2')
+  })
+
+  it('元素名不可解析（已删/无 doc）→ 提示退化为「正在编辑」（不带元素名）', () => {
+    const { container } = render(
+      <CanvasCollabPanel remotes={[makeRemote({ selection: ['ghost'] })]} doc={null} />,
+    )
+    const hint = container.querySelector('[data-collab-editing-hint]')
+    expect(hint?.textContent).toContain('阿蓝')
+    expect(hint?.textContent).not.toContain('登录按钮')
+  })
+
+  it('空名降级「未知用户」（同 viewer badge 口径）', () => {
+    const { container } = render(
+      <CanvasCollabPanel remotes={[makeRemote({ name: '', selection: ['rect-1'] })]} doc={makeDoc()} />,
+    )
+    expect(container.querySelector('[data-collab-editing-hint]')?.textContent).toContain('未知用户')
+  })
+
+  it('全部旁观（无选中无拖拽）→ 「N 人正在查看」', () => {
+    const { container } = render(
+      <CanvasCollabPanel remotes={[makeRemote({}), makeRemote({ clientId: 2, userId: 'u-2', name: '小蓝' })]} doc={makeDoc()} />,
+    )
+    const hint = container.querySelector('[data-collab-editing-hint]')
+    expect(hint?.textContent).toContain('2')
+    expect(hint?.textContent).toContain('正在查看')
+  })
+
+  it('远端拖拽中（drag 子字段）视同编辑态', () => {
+    const { container } = render(
+      <CanvasCollabPanel
+        remotes={[makeRemote({ drag: { items: [{ id: 'rect-1', x: 0, y: 0 }], ts: 1 } })]}
+        doc={makeDoc()}
+      />,
+    )
+    expect(container.querySelector('[data-collab-editing-hint]')?.textContent).toContain('登录按钮')
+  })
+})

package/src/components/collab/__tests__/collab-presence-header.test.tsx

@@ -0,0 +1,335 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+// CollabPresenceHeader 组件测试（任务 18）：
+//   ① 有协作者 → 头像组 + 「N 人正在编辑」计数文案
+//   ② awareness 空 / null（noop 降级）→ 渲染 null
+//   ③ excludeSelf：profile.id 命中 selfId 与 caret 名字命中 selfName 均排除
+//   ④ 动态加入（awareness update 事件）→ 计数响应式更新
+//   ⑤ 自身 profile 广播：getPresenceRoomFn 返回 USER_BRIEF 后写 awareness
+//      localStateField 'profile'（email 不入 awareness）
+// 真依赖：UserAvatar / AvatarGroup（magicui）/ 真 paraglide 消息（vitest
+// 专属编译产物）；FakeAwareness 内存实现同 use-share-presence.test.ts 口径。
+
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import { act, render, screen } from '@testing-library/react'
+import * as Y from 'yjs'
+import { m } from '@/paraglide/messages.js'
+import type { CollabConnectionStatus, CollabProviderHandle } from '@/lib/collab/provider'
+
+const mocks = vi.hoisted(() => ({
+  getPresenceRoomFn: vi.fn(),
+}))
+
+vi.mock('@/server/serverFns/collab-presence', () => ({
+  getPresenceRoomFn: mocks.getPresenceRoomFn,
+}))
+
+import { CollabPresenceHeader } from '../collab-presence-header'
+
+// ---------------------------------------------------------------------------
+// FakeAwareness / FakeHandle（内存实现，接口面与组件消费一致）
+// ---------------------------------------------------------------------------
+
+type UpdateHandler = (update: unknown) => void
+
+class FakeAwareness {
+  clientID = 1
+  localState: Record<string, unknown> | null = null
+  remotes = new Map<number, Record<string, unknown>>()
+  private listeners = new Set<UpdateHandler>()
+  fieldWrites: Array<{ field: string; value: unknown }> = []
+
+  setLocalStateField(field: string, value: unknown): void {
+    const next = { ...(this.localState ?? {}), [field]: value }
+    this.localState = next
+    this.fieldWrites.push({ field, value })
+    this.emit()
+  }
+
+  getStates(): Map<number, Record<string, unknown>> {
+    const all = new Map(this.remotes)
+    if (this.localState) all.set(this.clientID, this.localState)
+    return all
+  }
+
+  on(_event: string, handler: UpdateHandler): void {
+    this.listeners.add(handler)
+  }
+
+  off(_event: string, handler: UpdateHandler): void {
+    this.listeners.delete(handler)
+  }
+
+  emit(): void {
+    for (const handler of [...this.listeners]) {
+      handler({ added: [], updated: [], removed: [] })
+    }
+  }
+
+  addRemote(clientId: number, state: Record<string, unknown>): void {
+    this.remotes.set(clientId, state)
+    this.emit()
+  }
+
+  removeRemote(clientId: number): void {
+    this.remotes.delete(clientId)
+    this.emit()
+  }
+}
+
+function makeHandle(
+  awareness: FakeAwareness | null,
+): CollabProviderHandle & {
+  statusListener: ((status: CollabConnectionStatus) => void) | null
+} {
+  const handle = {
+    roomName: 'doc:knowledge:d1',
+    doc: new Y.Doc(),
+    awareness: awareness as unknown as CollabProviderHandle['awareness'],
+    getStatus: () => 'connecting' as const,
+    on: () => () => {},
+    off: () => {},
+    // 对齐 provider 语义：订阅时捕获 listener（测试手动触发状态迁移）
+    onStatusChange(listener: (status: CollabConnectionStatus) => void) {
+      handle.statusListener = listener
+      return () => {
+        handle.statusListener = null
+      }
+    },
+    destroy: () => {},
+    statusListener: null as ((status: CollabConnectionStatus) => void) | null,
+  }
+  return handle
+}
+
+/** 远端 profile 形态 state（USER_BRIEF 口径，即本组件广播的 'profile' 字段） */
+function remoteProfile(
+  id: string,
+  username: string,
+  extra: Record<string, unknown> = {},
+): Record<string, unknown> {
+  return { profile: { id, username, ...extra } }
+}
+
+/** Caret 形态 state（CollaborationCaret 写入的 user 字段，仅 name/color） */
+function remoteCaret(name: string, color = '#f00'): Record<string, unknown> {
+  return { user: { name, color } }
+}
+
+describe('CollabPresenceHeader', () => {
+  beforeEach(() => {
+    vi.clearAllMocks()
+    mocks.getPresenceRoomFn.mockResolvedValue({
+      roomName: 'presence:team:owner1',
+      user: {
+        id: 'self-1',
+        username: '本人',
+        email: 'self@test.dev',
+        avatarConfig: { face: 1 },
+        bgShape: 'circle',
+        bgColor: '#123456',
+      },
+    })
+  })
+
+  it('有协作者 → 渲染头像组与「N 人正在编辑」计数', () => {
+    const awareness = new FakeAwareness()
+    awareness.addRemote(2, remoteProfile('u2', 'Alice'))
+    awareness.addRemote(3, remoteProfile('u3', 'Bob'))
+    render(<CollabPresenceHeader handle={makeHandle(awareness)} selfId="self-1" />)
+
+    expect(screen.getByTestId('collab-presence-header')).toBeInTheDocument()
+    expect(
+      screen.getByText(m.collab_presenceEditingCount({ count: 2 })),
+    ).toBeInTheDocument()
+    // 首字母 fallback 头像（无 avatarConfig 时）
+    expect(screen.getByText('A')).toBeInTheDocument()
+    expect(screen.getByText('B')).toBeInTheDocument()
+  })
+
+  it('无远端协作者 → 渲染 null', () => {
+    const awareness = new FakeAwareness()
+    const { container } = render(
+      <CollabPresenceHeader handle={makeHandle(awareness)} selfId="self-1" />,
+    )
+    expect(container.querySelector('[data-testid="collab-presence-header"]')).toBeNull()
+  })
+
+  it('awareness 为 null（noop 降级）→ 渲染 null', () => {
+    const { container } = render(
+      <CollabPresenceHeader handle={makeHandle(null)} selfId="self-1" />,
+    )
+    expect(container.querySelector('[data-testid="collab-presence-header"]')).toBeNull()
+  })
+
+  it('handle 为 null（非协同分支）→ 渲染 null', () => {
+    const { container } = render(
+      <CollabPresenceHeader handle={null} selfId="self-1" />,
+    )
+    expect(container.querySelector('[data-testid="collab-presence-header"]')).toBeNull()
+  })
+
+  it('excludeSelf：profile.id 命中 selfId 的远端被排除', () => {
+    const awareness = new FakeAwareness()
+    awareness.addRemote(2, remoteProfile('self-1', '本人'))
+    awareness.addRemote(3, remoteProfile('u3', 'Alice'))
+    render(<CollabPresenceHeader handle={makeHandle(awareness)} selfId="self-1" />)
+
+    expect(
+      screen.getByText(m.collab_presenceEditingCount({ count: 1 })),
+    ).toBeInTheDocument()
+    expect(screen.queryByText('本')).not.toBeInTheDocument()
+    expect(screen.getByText('A')).toBeInTheDocument()
+  })
+
+  it('excludeSelf：profile 未落地时 caret 名字命中 selfName 的远端被排除', () => {
+    const awareness = new FakeAwareness()
+    // 本机 clientID=1 的 local state（caret 已写入、profile 尚未广播的瞬态）
+    awareness.localState = remoteCaret('本人显示名')
+    awareness.addRemote(2, remoteCaret('本人显示名'))
+    awareness.addRemote(3, remoteProfile('u3', 'Alice'))
+    render(
+      <CollabPresenceHeader
+        handle={makeHandle(awareness)}
+        selfId="self-1"
+        selfName="本人显示名"
+      />,
+    )
+
+    expect(
+      screen.getByText(m.collab_presenceEditingCount({ count: 1 })),
+    ).toBeInTheDocument()
+    expect(screen.getByText('A')).toBeInTheDocument()
+  })
+
+  it('profile 缺失的远端降级 caret user.name 渲染（畸形 state 丢弃）', () => {
+    const awareness = new FakeAwareness()
+    awareness.addRemote(2, remoteCaret('CaretUser'))
+    awareness.addRemote(3, { garbage: true })
+    render(<CollabPresenceHeader handle={makeHandle(awareness)} selfId="self-1" />)
+
+    expect(
+      screen.getByText(m.collab_presenceEditingCount({ count: 1 })),
+    ).toBeInTheDocument()
+    expect(screen.getByText('C')).toBeInTheDocument()
+  })
+
+  it('动态加入：awareness update 事件后计数响应式更新', () => {
+    const awareness = new FakeAwareness()
+    const { rerender } = render(
+      <CollabPresenceHeader handle={makeHandle(awareness)} selfId="self-1" />,
+    )
+    expect(screen.queryByTestId('collab-presence-header')).toBeNull()
+
+    act(() => {
+      awareness.addRemote(2, remoteProfile('u2', 'Alice'))
+    })
+    expect(
+      screen.getByText(m.collab_presenceEditingCount({ count: 1 })),
+    ).toBeInTheDocument()
+
+    act(() => {
+      awareness.removeRemote(2)
+    })
+    expect(screen.queryByTestId('collab-presence-header')).toBeNull()
+    rerender(
+      <CollabPresenceHeader handle={makeHandle(awareness)} selfId="self-1" />,
+    )
+  })
+
+  it('同用户多 tab（同 profile.id）按 id 去重为一人', () => {
+    const awareness = new FakeAwareness()
+    awareness.addRemote(2, remoteProfile('u2', 'Alice'))
+    awareness.addRemote(3, remoteProfile('u2', 'Alice'))
+    render(<CollabPresenceHeader handle={makeHandle(awareness)} selfId="self-1" />)
+
+    expect(
+      screen.getByText(m.collab_presenceEditingCount({ count: 1 })),
+    ).toBeInTheDocument()
+  })
+
+  it('自身 profile 广播：写 awareness localStateField profile 且 email 不入 awareness', async () => {
+    const awareness = new FakeAwareness()
+    render(<CollabPresenceHeader handle={makeHandle(awareness)} selfId="self-1" />)
+
+    // 等待 getPresenceRoomFn promise 链
+    await vi.waitFor(() => {
+      expect(awareness.fieldWrites).toHaveLength(1)
+    })
+    const write = awareness.fieldWrites[0]!
+    expect(write.field).toBe('profile')
+    expect(write.value).toMatchObject({ id: 'self-1', username: '本人' })
+    expect(JSON.stringify(write.value)).not.toContain('self@test.dev')
+    expect(JSON.stringify(write.value)).not.toContain('email')
+  })
+
+  it('getPresenceRoomFn 失败 → 静默降级（不写 profile、不抛错）', async () => {
+    mocks.getPresenceRoomFn.mockRejectedValue(new Error('network'))
+    const awareness = new FakeAwareness()
+    awareness.addRemote(2, remoteProfile('u2', 'Alice'))
+    render(<CollabPresenceHeader handle={makeHandle(awareness)} selfId="self-1" />)
+    await new Promise((r) => setTimeout(r, 0))
+    expect(awareness.fieldWrites).toHaveLength(0)
+    // 组件仍正常渲染（远端 caret/既有 profile 不受影响）
+    expect(screen.getByTestId('collab-presence-header')).toBeInTheDocument()
+  })
+
+  it('首次拉取失败 → synced 触发重拉 → 成功后广播 profile（长会话自愈）', async () => {
+    mocks.getPresenceRoomFn.mockRejectedValueOnce(new Error('network'))
+    const awareness = new FakeAwareness()
+    const handle = makeHandle(awareness)
+    render(<CollabPresenceHeader handle={handle} selfId="self-1" />)
+    await new Promise((r) => setTimeout(r, 0))
+    // 首拉失败：未广播
+    expect(awareness.fieldWrites).toHaveLength(0)
+
+    // 重连进入 synced：brief 仍为 null → 重新拉取（非 no-op 重放）
+    mocks.getPresenceRoomFn.mockResolvedValue({
+      roomName: 'presence:team:owner1',
+      user: { id: 'self-1', username: '本人', email: 'self@test.dev' },
+    })
+    act(() => {
+      handle.statusListener?.('synced')
+    })
+    await vi.waitFor(() => {
+      expect(awareness.fieldWrites).toHaveLength(1)
+    })
+    expect(awareness.fieldWrites[0]!.field).toBe('profile')
+    expect(awareness.fieldWrites[0]!.value).toMatchObject({ id: 'self-1', username: '本人' })
+    expect(mocks.getPresenceRoomFn).toHaveBeenCalledTimes(2)
+  })
+
+  it('已有 brief 时 synced 重放（不重拉）， detach/attach 后补广播', async () => {
+    const awareness = new FakeAwareness()
+    const handle = makeHandle(awareness)
+    render(<CollabPresenceHeader handle={handle} selfId="self-1" />)
+    await vi.waitFor(() => {
+      expect(awareness.fieldWrites).toHaveLength(1)
+    })
+
+    // 模拟 detach/attach 丢 local state：brief 已有 → synced 直接重放、不再拉取
+    awareness.localState = null
+    const callsBefore = mocks.getPresenceRoomFn.mock.calls.length
+    act(() => {
+      handle.statusListener?.('synced')
+    })
+    await new Promise((r) => setTimeout(r, 0))
+    expect(awareness.fieldWrites).toHaveLength(2)
+    expect(mocks.getPresenceRoomFn.mock.calls.length).toBe(callsBefore)
+  })
+})