Files
XHChat/docs/progress.md
T

195 lines
19 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 开发与验收记录
## 2026-11-13 · 阶段一基础交付
Web 和 Electron 共用 Vue 客户端,独立接入同一 Go API。真实 PostgreSQL 迁移创建账号、设备和会话表。Redis 用于限流、单次设备验证挑战和 WebSocket 票据。Windows 使用 Electron safeStorage 持久化设备私钥。Web 使用 IndexedDB 中的不可导出 Ed25519 CryptoKey。会话令牌只保存在客户端进程内存中,刷新网页或重启应用需要重新登录。
| 验收项 | 结果 |
|---|---|
| Go 单元测试 | 覆盖 Ed25519 签名、挑战绑定、Argon2id 密码验证与盐值 |
| Web、Electron 构建 | Vue 与 TypeScript 构建通过 |
| Compose 启动 | Nginx、Go API、PostgreSQL、Redis 健康检查通过 |
| 真实 API 集成 | 覆盖注册、重复用户名、错误密码、登录、设备状态、跨账号撤销拒绝、来源校验、挑战与票据重放拒绝、退出和撤销 |
| Edge 与 Electron 交叉测试 | Web 注册后用 Windows 登录,从 Web 撤销 Windows 设备,实时会话结束并返回登录页 |
| 端侧检查 | Web 私钥不可导出,Electron 渲染层没有 Node require,390px Web 设备页无横向溢出 |
| 依赖扫描 | Go 1.27.1 升级至 1.27.4 后,govulncheck 未报告漏洞。npm audit 未报告漏洞 |
两套集成测试使用随机账号和随机密码。测试账号留在本机开发数据库中,复跑时使用新账号。
## 尚待实现
- 阶段一还需邮箱和手机号注册、验证码服务、找回密码和双重验证。真实联调需要 SMTP 与短信供应商配置。
- 阶段二与三还需分片附件、多设备可信授权、加密备份与跨设备历史同步。群聊和私聊的文字及小附件已进入开发预览。
- 阶段四还需 WebRTC 音视频、TURN、SFU、屏幕共享及媒体 E2EE。
- 阶段五还需反钓鱼及聊天联动。
- 阶段六到八还需社交、扩展生态、独立管理后台、推送、生产部署与备份演练、压力测试、安全评估、签名安装包和发布流程。
## 联系人和 Chromium 浏览器
- 双端支持用户名查找、申请、接受、拒绝、撤回申请、备注、分组、删除、拉黑和解除拉黑。测试以 Web 与 Electron 两个账号验证申请和变更实时同步。
- 桌面端提供隔离浏览器窗口,支持地址栏、搜索、标签、导航、缩放、全屏、复制链接、普通窗口下载、隐私窗口和清除站点数据。集成测试确认远程网页位于独立 Session,Sandbox 生效,网页无 IPC 桥和 Node require,UA 保留真实 Chromium 版本并追加 XHChat 标识。测试同时验证地址栏拒绝本地文件协议。
## OpenMLS 兼容性
锁定 OpenMLS 0.9.2。Linux 原生 Rust 与 Windows Chrome WebAssembly 用例验证三台设备加入、消息加解密、重放拒绝和成员移除后新世代保密。应用消息接口、端侧持久化、可信设备绑定及 Electron 中的聊天互通仍待实现。
## 设备密文投递
服务端已实现联系人设备之间的 MLS 封包队列、幂等提交、离线游标补拉、实时同步提示和保留期。集成测试覆盖跨账号收件箱隔离、设备撤销及非封包请求拒绝。客户端会话与可操作的聊天界面尚待接入。
## 设备目录与密钥包
服务端已实现联系人设备目录、设备签名校验和一次性 MLS KeyPackage 领取。Compose 集成测试验证陌生人隔离、错误签名拒绝、并发只能领取一次、重复上传不会重新开放领取和撤销后目录隐藏。接下来需在双端接入可信公钥验证及 MLS 会话持久化。
## 两设备 MLS 引擎
OpenMLS WASM 提供两设备会话创建、加入、消息加解密和端侧状态快照。原生 Rust 和 Windows Chrome WebAssembly 各通过两项测试,覆盖错误公钥、错误消息关联数据、恢复后的正常收发和重放拒绝。界面、设备身份验证、快照加密保存和发送队列仍在接入。
## Windows 与 Web 加密文字预览
互为好友后,双方在聊天页分别启用本机加密,并通过其他可信渠道核验对方设备安全码。设备认证密钥签署 MLS 公钥和密钥包,OpenMLS 处理会话与加解密。服务端投递 MLS 封包。浏览器使用不可导出的 Web Crypto AES-GCM 密钥,Windows 使用 DPAPI 封装本地加密密钥。协议状态、历史、待发送封包和收件游标持久化在端侧加密记录中。
Edge 与 Electron 集成测试覆盖错误安全码、双向文字、网络封包无测试正文、重新登录后离线接收和 Windows 本地密文存储。当前预览按设备建立会话,支持最多 1000 条本机消息。账号级密钥认证、跨设备同步、定期 MLS 更新、可信设备授权与安全评估待后续交付。
## 端到端加密附件预览
Windows 与 Web 支持发送和下载最多 8 MiB 的附件。文件名、长度、密钥和 IV 位于 MLS 消息中,附件服务只存密文。下载先验证认证标签,再提供本地保存。跨端用例覆盖上传密文、篡改拒绝和下载字节一致性。对象存储、分片断点续传和媒体专用界面仍待完成。
## 消息管理
Windows 与 Web 可发送带引用摘要的 MLS 文字消息。两端支持按正文、引用和文件名搜索本机历史,以及收藏和本机删除。收藏标记与历史保存在加密本地记录中。集成测试覆盖引用跨端显示、收藏筛选、搜索及删除后另一端仍可读取原消息。
原发送设备可编辑文字及撤回文字或附件消息。更新作为 MLS 应用消息传递,由客户端核对原发送设备与消息 ID。撤回会更新对方客户端显示,先前保存的附件、截图和其他独立副本仍可能存在。文字与附件可转发给已核验设备。转发附件会在本机校验并用新的密钥和附件 ID 加密。跨设备收藏同步待后续交付。
## 浏览器书签和历史
Windows 浏览器新增可跨窗口保留的本地书签和历史,每类最多 250 条。书签支持添加、打开和移除。清除站点数据会同时清除历史。隐私窗口不读写书签或历史,隔离测试验证其访问不会出现在普通窗口。
## 浏览器下载管理
普通窗口下载支持保存对话框、进度、暂停、可恢复时继续、取消和完成后定位文件。最多保存 150 条记录,清除记录不删除已下载文件。Electron 集成测试确认真实文件写入、状态记录和清除。
## 浏览器逐站权限
普通窗口可按当前网站的协议、主机与端口单独授权或撤销摄像头、麦克风、位置、通知和剪贴板权限。默认拒绝,授权只用于可见的顶级网页。隐私窗口不继承授权。Electron 集成测试通过 Chromium 权限查询验证通知权限默认拒绝、显式授权和撤销。
## 聊天中的链接
加密文字消息中的 HTTPS 链接在端侧识别。Windows 从链接启动隔离 Chromium,Web 在独立标签页打开并隔离 opener。开发环境支持本机 HTTP。真实双端测试验证消息链接点击与 Chromium 地址显示。网页卡片与从浏览器分享给联系人仍待实现。
## 会话导航和已读回执
「消息」页支持按用户名或备注查找已接受的联系人,按本机最近消息时间排序。用户可按设备开启已读回执,默认关闭。开启后,仅在窗口聚焦且消息显示于可见区域时,通过 MLS 发送已读消息 ID。发送端根据对方设备身份和原消息 ID 更新状态。偏好、状态与待发回执保存在端侧加密记录中。
## 加密语音消息
Windows 和 Web 使用 MediaRecorder 录制 Opus,支持取消、计时和最长 60 秒录音。录音经附件加密链路发送,收件方验证密文后本地播放、暂停或拖动进度。Windows 的通讯渲染层只在主动录音时获得短期麦克风请求权限,第三方浏览器仍使用独立的逐站权限。集成测试使用 Chromium 虚拟麦克风完成 Windows 录音到 Web 播放。语音转写、按住录音和未听提醒尚待实现。
## 加密图片和视频预览
两端支持在聊天内预览 JPEG、PNG、WebP、GIF、MP4 和 WebM 附件。预览需主动打开,先在本机验证完整性,再使用临时 Blob URL 加载。关闭预览或离开聊天会释放 URL。自动化验收覆盖 Web 发送 PNG 到 Windows 端实际解码和关闭预览。视频预览已构建,仍需独立验证不同编码格式。
## 一次性密钥包补充
客户端启用加密聊天时补足四个可领取密钥包。聊天同步期间定时检查,接收新的 Welcome 后立即补充。私钥先落入本机加密记录,公网部分再上传。API 和双端测试验证密钥包领取后的计数变化,以及客户端收到 Welcome 后重新发布。
## 群组成员管理
Web 和 Windows 可创建群组、邀请已接受的联系人、接受或拒绝邀请、管理群名称及管理员、移除成员、退出与解散。未接受邀请的账号无法查看成员名单。成员加入和离开在事务内递增成员版本,MLS 投递以此拒绝过期名单。
## 群组密文投递
服务端已接入群世代登记、设备定向 Welcome、群密文写入、游标补拉与保留期。集成测试覆盖名单外设备拒绝、成员移除后拒绝旧世代、重新加入后的历史隔离和绑定设备撤销。
## MLS 群会话引擎
OpenMLS WASM 新增批量设备入组。创建端校验每个 KeyPackage 和预期设备签名公钥,接收端校验 Welcome 发送者、MLS 群标识与完整设备名单。三设备测试验证替换名单公钥会被拒绝,创建排除已移除设备的新会话后,该设备无法解密新密文。
## 双端加密群聊预览
Windows 和 Web 已接入群设备核验、MLS Welcome 校验、文字加解密和本机历史。群主为每名有效成员选定一台已核验设备,成员加入或离开后由群主重建加密会话。预览可补拉本机已加入会话的消息。跨世代补拉尚未在本机加入的旧会话、群成员多设备和自动世代更新待实现。
验收使用 Windows Electron 和两个独立 Edge 会话,覆盖安全码校验、Windows 发消息给 Web、Web 离开群页面后补收消息、移除成员、新世代 Windows 接收和移除成员无法继续访问。服务端集成测试验证群设备目录授权和密钥包只能领取一次,Rust 验证错误的 MLS 群标识与移除设备不能解密。
## 群附件
Windows 和 Web 可发送和下载最多 8 MiB 的群附件,并在本机预览常见图片和视频。接口验收覆盖大小限制、上传幂等、未发布附件隔离、发送设备绑定、移除和重新入群后的历史下载隔离。双端验收覆盖 Windows 发送文件到 Edge、逐字节核对下载、拒绝篡改的密文,以及 Edge 发送 PNG 到 Windows 预览。群附件分片和断点续传仍待实现。
## 群文件、图片和视频视图
两端可在群聊切换到群文件、群图片或群视频,按文件名搜索,或只显示本机收藏。分类从本机已同步并解密的群消息中读取,优先显示较新的附件,每次展示 24 条,可继续加载本机记录。打开预览或下载时才向服务端请求附件密文。撤回附件会将它移出分类视图。
Windows Electron 和 Edge 验证进入文件视图与搜索时未请求附件密文、下载字节一致、篡改拒绝、PNG 预览、WebM 解码播放、切换视图关闭预览以及图片撤回后从分类移除。
## 加密群语音
双端在群聊录制最长 60 秒的 Opus 语音。取消录音即释放麦克风,不产生上传。语音按群附件加密,群世代变更会取消当前录音或拒绝发送上一个世代的录音。接收设备下载并验证密文后,通过本机播放器播放、暂停或拖动进度。语音转写及未听提醒待实现。
Windows Electron 与 Edge 集成测试使用虚拟麦克风验证双向播放和暂停、取消录音与世代切换均不上传,以及群成员移除和设备撤销后拒绝下载。私聊语音和桌面浏览器隔离回归通过。
## 加密群消息操作
Windows 与 Web 可在当前加密会话引用消息、编辑自己发送的文字及撤回自己发送的消息。客户端按原消息 ID、MLS 会话及发送设备校验编辑和撤回。引用片段、更新类型及目标标识留在 MLS 密文中。此前缓存且未记录会话标识的消息,以及旧会话中的消息仍可查看。撤回更新聊天显示,成员已经下载或复制的内容仍可能保留。
Windows Electron 与 Edge 验证引用渲染、编辑补收、文字与图片撤回、其他成员不可操作及旧会话的操作限制。私聊和服务端密文投递回归通过。
## 群消息本机搜索和收藏
在群聊中可组合使用关键词和「只看收藏」,搜索本机已解密的消息文本、引用与附件名。收藏状态保存在设备的加密存储中,保留超过最近 1,000 条的收藏记录,撤回会取消收藏。附件仍受原会话权限和服务端保留期限制。跨设备收藏同步待实现。
Windows Electron 与 Edge 集成测试覆盖搜索引用和附件名、离开群页后恢复收藏、设备间收藏独立、撤回取消收藏和会话变更后的历史搜索。私聊和服务端投递回归通过。
## 群消息转发
双端可将群消息转发到其他已加入且已核验的群加密会话,或转发到已核验的联系人设备。转发携带文字正文或附件。图片、视频和语音保留原有媒体类型。附件经本机完整性校验和解密,再以新的附件标识、文件密钥与随机数加密上传。待投递的群转发可在目标群继续重试。原消息的引用片段和发送人信息不随转发发送。
Windows Electron 与 Edge 验证向尚无加密会话的群转发会被拒绝、转发群文件后附件标识和密文不同且下载内容逐字节相同,以及群文字转发到联系人私聊。私聊附件转发回归通过。
## 私聊转发至群聊
Windows 和 Web 的私聊与群聊共用转发目标选择。私聊支持把文字正文和附件转发给已核验的联系人设备,或转发到本机已加入并核验的群加密会话。客户端先核对目标群会话,再读取本机消息或下载附件密文。附件通过认证后使用新的标识和密钥二次加密,目标群世代变更会阻断转发。
集成测试验证 Web 转发私聊文字后 Windows 在群内接收,Windows 转发私聊文件后 Web 下载逐字节一致且密文及附件标识变化。未建立加密会话的目标群拒绝转发,测试确认没有群文件上传或群消息提交。原有私聊及群聊转发回归通过。
## 群消息实时同步
群密文和新加密会话提交后,WebSocket 向群会话的设备发送仅含群标识的同步提示。正在查看该群的 Windows 和 Web 客户端合并密集提示,并按本机游标补拉。重新连接时立即补拉,另保留 15 秒兜底轮询。
服务端集成测试验证名单内设备收到提示、无关账号收不到提示。Windows Electron 和 Edge 测试验证在线收取及主动断开 WebSocket 后重连补收,私聊和群附件回归通过。
## 群成员和邀请实时同步
群成员、邀请与群资料更新事务提交后,受影响账号的在线设备收到刷新提示。提示只含事件类型。群组页合并提示,通过现有授权接口刷新列表和当前群详情,重连时也会刷新,并保留 15 秒兜底轮询。群成员权限仍取决于服务端的实时授权结果。
Windows Electron 和 Edge 验证了群组页在兜底轮询前显示邀请、成员接受和成员移除。服务端测试验证普通成员收不到其他人的待处理邀请提示,未加入账号收不到群事件,解散会通知仍待接受邀请的账号。
## 群置顶和免打扰
两端可按账号设置群置顶和免打扰,置顶群排在群列表前面。离开群页面时,未静音的新群投递可显示通用的应用内提醒,点击返回群组。免打扰保留 WebSocket 补拉提示,省略应用内提醒标记。原生系统通知和 Web Push 仍待实现。
测试覆盖迁移 010、邀请者和外部账号不可修改群设置、不同账号的设置隔离、双端静音收取和提醒入口,以及同一账号的两台设备实时同步偏好。
## 群聊未读角标
Windows 和 Web 的群列表按当前设备显示未读投递数量,免打扰群使用低强调角标。打开可见的群聊并同步后,客户端提交本机游标。统计排除本机发送的消息,页面后台时保留角标。游标由服务端按设备保存,其他成员看不到逐条已读状态。编辑和撤回也是群密文投递,会计入尚未同步的数量。
接口测试覆盖发送设备排除、游标单调递增、越权及重新入群隔离。Windows Electron 与 Edge 验证免打扰时显示未读、启用群安全会话后同步并清除角标,以及群消息和私聊附件回归。私聊文件选择在同步繁忙时也会排队提交。
## 群公告和群主转让
群主可用当前群会话设备发布、编辑和清除公告,公告正文通过 MLS 群密文传递。已经同步的公告保存在本机,新加入的设备从其加入后的会话获取公告,群主可以重新发布。群主可以把管理权转让给已接受邀请的成员,原群主成为普通成员,可以主动退出。转让更新群版本,新群主建立新会话前旧会话停止发送。
Windows 和 Edge 验证加密发布与清除公告、群主转让、原群主退出和新群主建立会话。服务端测试覆盖普通成员、管理员、外部账号、受邀未入群成员及向自己转让的拒绝路径。
## 群附件拖拽和批量发送
群附件发送区支持文件多选、拖拽、移除单项与清空待发列表。每批最多 8 个,单文件上限 8 MiB。客户端逐个加密和发送,展示批次进度。中断时未进入加密发件箱的文件留在当前页面,可再次提交,已进入发件箱的密文沿用现有重试机制。群会话变更会停止当前批次,剩余文件由用户在新会话中确认发送。
Windows Electron 与 Edge 验证多选发送、拖拽和移除待发文件。模拟第二个文件上传失败后只重试剩余文件,已送达的文件未重复出现。群聊、私聊与服务端投递回归共 7 项通过。
## 群邀请链接与二维码
群主可生成或撤销有效 24 小时的一次性邀请链接,客户端在本机绘制二维码。Web 可以直接打开链接,Windows 群组页可以粘贴链接或邀请码。服务端只存邀请码摘要,生成新链接或转让群主会撤销旧链接。领取成功会生成待接受邀请,成员确认后才加入现有群权限流程。
接口测试验证并发领取仅一次成功、链接轮换、撤销、群主转让后失效及领取后权限隔离。Windows 与 Edge 验证二维码绘制、桌面端粘贴领取、Web 登录后领取和接受或拒绝流程。