diff --git a/README.md b/README.md index 4e01c86..83638fc 100644 --- a/README.md +++ b/README.md @@ -22,7 +22,7 @@ | 加密群聊 | 创建群组、邀请联系人和管理成员。每个账号选一台已核验设备参与 MLS 加密文字聊天。 | | 加密附件 | 两端可在私聊和群聊发送、下载最多 8 MiB 的文件,并在本机预览图片和视频。 | | 加密语音 | 两端可在私聊和群聊录制、取消或发送最长 60 秒的语音消息,接收方在本机解密播放。 | -| 消息管理 | 支持会话查找、可选加密已读回执、引用回复、编辑、撤回、转发、本机搜索和收藏。 | +| 消息管理 | 私聊和群聊支持引用回复、编辑文字和撤回。私聊还支持可选加密已读回执、转发、本机搜索和收藏。 | | Chromium 浏览器 | Windows 端支持独立窗口、多标签、导航、搜索、书签、历史、下载和隐私窗口,网页运行在独立会话中。 | 当前为开发预览。大文件分片、音视频和多设备历史同步仍在开发,Windows 安装包尚未发布。 [开发进度与验收记录](docs/progress.md) diff --git a/docs/encryption.md b/docs/encryption.md index a039c41..61be1ed 100644 --- a/docs/encryption.md +++ b/docs/encryption.md @@ -15,3 +15,5 @@ OpenMLS 0.9.2 兼容性用例已在 Linux 原生和 Windows Chrome WebAssembly 预览版群聊的每个投递世代使用独立的 OpenMLS 会话,最多 32 个账号,每个账号选一台设备。参与设备各自在可信渠道核验其他设备安全码,并核对 Welcome 的签名创建者、完整 MLS 叶节点名单和群标识。加密消息绑定群、世代、消息 ID 和发送设备。成员加入、离开或绑定设备撤销后,群主为有效设备重新建立会话。服务端拒绝旧世代新消息,已离开的设备拿不到新会话的 Welcome。旧会话的已解密消息保存在本机。正式版仍需同一 MLS 群中的密钥更新、入侵后恢复、多设备授权和群历史同步。 群附件复用整文件 AES-256-GCM。群、世代和附件标识用于服务端授权,文件名和解密材料由群 MLS 消息保护。收件设备校验 MLS 描述与投递附件 ID 一致,并验证文件认证标签后才读取字节。成员离开后失去服务器下载权限,已下载的副本仍由成员保有。 + +群编辑和撤回通过 MLS 应用消息传递。接收端按已认证的发送设备、群世代和目标消息 ID 匹配本机记录。引用是加密发送的文本快照,原消息编辑或撤回后,引用仍显示发送时的片段。 diff --git a/docs/progress.md b/docs/progress.md index f5a4b7b..d5a37be 100644 --- a/docs/progress.md +++ b/docs/progress.md @@ -19,7 +19,7 @@ Web 和 Electron 共用 Vue 客户端,独立接入同一 Go API。真实 Postg ## 尚待实现 - 阶段一还需邮箱和手机号注册、验证码服务、找回密码和双重验证。真实联调需要 SMTP 与短信供应商配置。 -- 阶段二与三还需分片附件、群聊消息操作、多设备可信授权、加密备份与跨设备历史同步。群聊和私聊的文字及小附件已进入开发预览。 +- 阶段二与三还需分片附件、群聊转发与收藏、多设备可信授权、加密备份与跨设备历史同步。群聊和私聊的文字及小附件已进入开发预览。 - 阶段四还需 WebRTC 音视频、TURN、SFU、屏幕共享及媒体 E2EE。 - 阶段五还需反钓鱼及聊天联动。 - 阶段六到八还需社交、扩展生态、独立管理后台、推送、生产部署与备份演练、压力测试、安全评估、签名安装包和发布流程。 @@ -120,3 +120,9 @@ Windows 和 Web 可发送和下载最多 8 MiB 的群附件,并在本机预览 双端在群聊录制最长 60 秒的 Opus 语音。取消录音即释放麦克风,不产生上传。语音按群附件加密,群世代变更会取消当前录音或拒绝发送上一个世代的录音。接收设备下载并验证密文后,通过本机播放器播放、暂停或拖动进度。语音转写及未听提醒待实现。 Windows Electron 与 Edge 集成测试使用虚拟麦克风验证双向播放和暂停、取消录音与世代切换均不上传,以及群成员移除和设备撤销后拒绝下载。私聊语音和桌面浏览器隔离回归通过。 + +## 加密群消息操作 + +Windows 与 Web 可在当前加密会话引用消息、编辑自己发送的文字及撤回自己发送的消息。客户端按原消息 ID、MLS 会话及发送设备校验编辑和撤回。引用片段、更新类型及目标标识留在 MLS 密文中。此前缓存且未记录会话标识的消息,以及旧会话中的消息仍可查看。撤回更新聊天显示,成员已经下载或复制的内容仍可能保留。 + +Windows Electron 与 Edge 验证引用渲染、编辑补收、文字与图片撤回、其他成员不可操作及旧会话的操作限制。私聊和服务端密文投递回归通过。 diff --git a/tests/group-chat.test.mjs b/tests/group-chat.test.mjs index 1c09864..7cdd1be 100644 --- a/tests/group-chat.test.mjs +++ b/tests/group-chat.test.mjs @@ -55,10 +55,10 @@ async function publish(owner, pages) { await Promise.all(pages.map((page) => chat(page).getByText('群加密已建立', { exact: true }).waitFor())) } -async function send(sender, text) { +async function send(sender, text, action = '发送群消息') { await chat(sender).getByRole('textbox', { name: '群消息' }).fill(text) const response = sender.waitForResponse((item) => /\/groups\/[^/]+\/messages$/.test(item.url()) && item.request().method() === 'POST') - await chat(sender).getByRole('button', { name: '发送群消息' }).click() + await chat(sender).getByRole('button', { name: action, exact: true }).click() const sent = await response assert.equal(sent.status(), 200, await sent.text()) const packet = sent.request().postDataJSON() @@ -114,7 +114,7 @@ async function playVoice(page, sender, downloadPath) { assert.equal(await player.evaluate((element) => element.paused), true) } -test('Windows 与 Web 群聊加密投递文字、附件和语音,成员变更后隔离访问', { timeout: 120_000 }, async () => { +test('Windows 与 Web 加密群聊支持消息操作、附件、语音和成员隔离', { timeout: 120_000 }, async () => { const browser = await chromium.launch({ channel: process.env.XHCHAT_TEST_BROWSER ?? 'msedge', args: ['--use-fake-device-for-media-stream'] }) const profile = await mkdtemp(join(tmpdir(), 'xhchat-group-test-')) let desktop @@ -170,6 +170,37 @@ test('Windows 与 Web 群聊加密投递文字、附件和语音,成员变更 await chat(removed).getByRole('button', { name: '启用本机群聊' }).click() await chat(removed).getByText(first, { exact: true }).waitFor() + const original = chat(owner).getByRole('listitem').filter({ hasText: first }) + assert.equal(await original.getByRole('button', { name: '编辑', exact: true }).count(), 0) + assert.equal(await original.getByRole('button', { name: '撤回', exact: true }).count(), 0) + await original.getByRole('button', { name: '引用', exact: true }).click() + const reply = '加密引用回复 ' + id() + assert.equal(await send(owner, reply), epoch) + const receivedReply = chat(windows).getByRole('listitem').filter({ hasText: reply }) + await receivedReply.locator('blockquote').getByText(first, { exact: true }).waitFor() + await work(removed).getByRole('link', { name: '联系人' }).click() + const own = chat(windows).getByRole('listitem').filter({ has: windows.getByText(first, { exact: true }) }).first() + await own.getByRole('button', { name: '编辑', exact: true }).click() + const edited = '已修改群消息 ' + id() + assert.equal(await send(windows, edited, '保存编辑'), epoch) + const incomingEdit = chat(owner).getByRole('listitem').filter({ has: owner.getByText(edited, { exact: true }) }) + await incomingEdit.getByText('已编辑', { exact: true }).waitFor() + await work(removed).getByRole('link', { name: '群组' }).click() + await removed.getByRole('link', { name: new RegExp(group) }).click() + await chat(removed).getByRole('button', { name: '启用本机群聊' }).click() + await chat(removed).getByText(edited, { exact: true }).waitFor() + + const temporary = '待撤回群消息 ' + id() + assert.equal(await send(windows, temporary), epoch) + const outgoing = chat(windows).getByRole('listitem').filter({ hasText: temporary }) + await chat(owner).getByText(temporary, { exact: true }).waitFor() + await outgoing.getByRole('button', { name: '撤回', exact: true }).click() + await chat(windows).getByRole('button', { name: '确认撤回' }).click() + for (const page of pages) { + await chat(page).getByText('消息已撤回', { exact: true }).waitFor() + assert.equal(await chat(page).getByText(temporary, { exact: true }).count(), 0) + } + const contents = Buffer.from('Windows 群文件内容 ' + id() + '\n'.repeat(9000)) const filename = '群附件-' + id() + '.txt' await sendFile(windows, filename, 'text/plain', contents) @@ -202,6 +233,11 @@ test('Windows 与 Web 群聊加密投递文字、附件和语音,成员变更 assert.equal(await image.evaluate((element) => element.naturalWidth), 1) await chat(windows).getByRole('button', { name: '关闭预览' }).click() await image.waitFor({ state: 'detached' }) + const photoLine = chat(owner).getByRole('listitem').filter({ hasText: photo }) + assert.equal(await photoLine.getByRole('button', { name: '编辑', exact: true }).count(), 0) + await photoLine.getByRole('button', { name: '撤回', exact: true }).click() + await chat(owner).getByRole('button', { name: '确认撤回' }).click() + await chat(windows).getByRole('button', { name: '预览 ' + photo }).waitFor({ state: 'detached' }) const voiceUploads = [] windows.on('request', (request) => { @@ -237,7 +273,9 @@ test('Windows 与 Web 群聊加密投递文字、附件和语音,成员变更 assert.notEqual(await send(owner, second), epoch) await chat(windows).getByText(second, { exact: true }).waitFor() assert.equal(await removed.getByText(second, { exact: true }).count(), 0) - assert.equal(await chat(windows).getByText(first, { exact: true }).count(), 1) + const history = chat(windows).getByRole('listitem').filter({ hasText: edited }) + assert.equal(await history.count(), 1) + assert.equal(await history.getByRole('button', { name: '编辑', exact: true }).count(), 0) } catch (error) { const status = await Promise.all(pages.map((page) => page.locator('[role=alert], .group-chat [role=status]').allTextContents())) throw new Error(JSON.stringify(status), { cause: error }) diff --git a/web/src/chat/GroupChat.vue b/web/src/chat/GroupChat.vue index 915c01c..c07305e 100644 --- a/web/src/chat/GroupChat.vue +++ b/web/src/chat/GroupChat.vue @@ -7,8 +7,8 @@ import MediaPreview from './MediaPreview.vue' import VoiceMessage from './VoiceMessage.vue' import VoiceRecorder from './VoiceRecorder.vue' import { enableChat, trust } from './chat' -import { discardPendingGroupMessage, groupAttachmentPath, publishGroup, sendGroupMessage, synchronizeGroup } from './group-chat' -import type { GroupDetail, GroupDevice } from './group-chat' +import { discardPendingGroupMessage, groupAttachmentPath, groupQuote, publishGroup, sendGroupMessage, synchronizeGroup } from './group-chat' +import type { GroupDetail, GroupDevice, GroupLine } from './group-chat' const props = defineProps<{ group: GroupDetail }>() const session = useSession() @@ -17,12 +17,15 @@ const code = ref('') const codes = ref>({}) const selected = ref>({}) const draft = ref('') +const replying = ref() +const editing = ref() +const recalling = ref() const file = ref() const pendingVoice = ref<{ file: File; epoch: string }>() const busy = ref(false) const error = ref('') const ready = computed(() => view.value?.ready && view.value.current?.membershipVersion === props.group.membershipVersion) -const recordingEpoch = computed(() => ready.value ? view.value?.current?.id : undefined) +const currentEpoch = computed(() => ready.value ? view.value?.current?.id : undefined) const members = computed(() => props.group.members.filter((member) => member.state === 'active' && member.id !== session.identity?.user.id)) const canPublish = computed(() => Boolean(view.value && !view.value.current && members.value.every((member) => view.value?.devices.some((device) => device.user === member.id && device.id === selected.value[member.id] && pinned(device))))) @@ -86,8 +89,31 @@ function send() { const identity = session.identity if (identity) void run(async () => { const text = draft.value - await sendGroupMessage(identity, props.group, text, session.authorized) + if (editing.value?.epoch) { + await sendGroupMessage(identity, props.group, { action: 'edit', id: editing.value.id, epoch: editing.value.epoch, text }, session.authorized) + } else { + await sendGroupMessage(identity, props.group, replying.value ? { text, reply: replying.value } : text, session.authorized) + } if (draft.value === text) draft.value = '' + editing.value = undefined + replying.value = undefined + await refresh() + }) +} + +function edit(line: GroupLine) { + editing.value = line + replying.value = undefined + draft.value = line.text +} + +function recall() { + const identity = session.identity + const { id, epoch } = recalling.value ?? {} + if (!identity || !id || !epoch) return + void run(async () => { + await sendGroupMessage(identity, props.group, { action: 'recall', id, epoch }, session.authorized) + recalling.value = undefined await refresh() }) } @@ -125,7 +151,14 @@ function discard() { } watch(() => props.group.membershipVersion, () => void run(refresh)) -watch([pendingVoice, busy, recordingEpoch, () => view.value?.hasPending], ([voice, inProgress, epoch, hasPending]) => { +watch(currentEpoch, (epoch, previous) => { + if (!previous || epoch === previous) return + if (editing.value || replying.value) draft.value = '' + editing.value = undefined + replying.value = undefined + recalling.value = undefined +}) +watch([pendingVoice, busy, currentEpoch, () => view.value?.hasPending], ([voice, inProgress, epoch, hasPending]) => { const identity = session.identity if (!voice || !identity) return if (voice.epoch !== epoch) { @@ -180,27 +213,50 @@ onBeforeUnmount(() => clearInterval(timer))
    -
  • +
  • {{ line.name }} · {{ new Date(line.time).toLocaleString() }} - +
    {{ line.quote }}
    +

    消息已撤回

    +

    {{ line.text }}

    + 已编辑 +
    + + +
+
+

撤回后,群成员的聊天界面会更新。成员可能已保存副本。

+ + +

{{ view.stalePending ? '待发消息属于旧会话。' : '消息待投递,将自动重试。' }}

+
+ 编辑消息 + +
+
+ 引用 {{ groupQuote(replying) }} + +