C12.0: ElyMail backend moves to Rust crates; iCloud by app password

async-imap, async-pop, mail-send, mail-parser and mail-builder replace
MailCore 2. The MailCore 2 and libetpan fetch, build and probe scripts
go. HTML bodies render as a sanitized block subset in GPUI; compose uses
the Markdown document component. OAuth client IDs come from oauth.env
(ignored) or CI secrets. The task list for C12 is rewritten in order.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
ZacharyZhang-NYandClaude Opus 5.5 committed 2026-10-19 16:02:34 -04:00
1 parent 0d991e1c71
commit d7de5619a7
11 files changed
+52 -150

No files matched your search

+26 -8
View File
@@ -131,14 +131,32 @@
第二批发布(用户定,2026-10-08):首版不发布 ElyMail,首版的完整测试与打包不等它。
- [ ] C12.1 MailCore 2 构建、C 垫片、Rust 绑定,三类协议连通与 MIME 解析
- [ ] C12.2 本地存储:SQLite 索引、内容目录、消息身份(账号、邮箱、UIDVALIDITY、UID)、容量(§12.3、§18.1)
- [ ] C12.3 账号、TLS、OAuth 流程、应用密码(MAIL-01、02)
- [ ] C12.4 同步:头与 90 天正文、按需附件、队列、POP3、同步控制(MAIL-14,§12.3)
- [ ] C12.5 邮箱视图、阅读、会话线程(MAIL-03、04)
- [ ] C12.6 写信、草稿、发送队列与发送状态机(MAIL-05、06、07,§12.4,QA-17)
- [ ] C12.7 组织、搜索、附件(MAIL-08、09、10)
- [ ] C12.8 规则、联系人、迁移、通知(MAIL-11、12、13、15,QA-16、18)
用户 2026-10-19 定:后端改为 Rust crate(async-imap、async-pop、mail-send、mail-parser、mail-builder),取代 MailCore 2;Gmail 与 Microsoft 走 OAuth,iCloud 走应用专用密码;正文按块的子集由 GPUI 绘制,写信用 Markdown 文档组件;OAuth 客户端 ID 构建时注入(`oauth.env` 与 CI 机密,注册由用户做)。协议测试一律对本机的替身服务器(测试里按脚本应答的 IMAP、POP3、SMTP 与 OAuth 端点),不靠真网络;真服务器只在用户给出账号或 ID 后另验。界面 120 fps:界面线程不等网络与数据库,长列表只画可见行。
- [x] C12.0 选型修订:PRD §1.1、§12.1、§17.3、§21.2、§23 与 `agents.md` 改为上述选型;删去 MailCore 2 与 libetpan 的取码、构建与探测脚本;`oauth.env` 不入库;`references.sh` 随之(并修上游钉与工作区不一致的组件库钉) — R1 ok
- [ ] C12.1 `crates/ely-mail-engine` 与连通(MAIL-01 前半):IMAP、POP3、SMTP 经 TLS(rustls,系统根证书)或 STARTTLS 连接,密码与 XOAUTH2 认证,失败带服务器原话;替身服务器测三协议的登录、拒绝、列邮箱、取信、发信
- [ ] C12.2 MIME(MAIL-04、05 的基础):mail-parser 读出头、纯文本、HTML、cid 内嵌图片、附件与原始头;mail-builder 写出多部分邮件、附件、Message-ID、In-Reply-To 与 References;样本 EML 往返测试
- [ ] C12.3 本地存储(§12.3、§18.1、§18.3):SQLite 索引(账号、邮箱、消息身份为账号加邮箱加 UIDVALIDITY 加 UID、标记、头字段)、原文按内容存进内容目录、FTS5 全文索引(可重建)、结构版本与升级前备份、升级失败只读;各类大小可查
- [ ] C12.4 凭据与 OAuth(MAIL-02,§18.2):密码与刷新令牌只进系统凭据库(不可用即只留到本次退出并写明);Gmail 与 Microsoft 的授权码加 PKCE、本机回环、换令牌与刷新;客户端 ID 编进构建,缺 ID 即写明不可用;刷新被拒转为“需重新登录”;替身授权端点测试
- [ ] C12.5 账号(MAIL-01、02):ElyMail 主窗口与添加账号对话框:Gmail、Microsoft、iCloud(应用专用密码向导)、其他 IMAP/SMTP、POP3/SMTP;服务器、端口、TLS 方式、认证方式;连通性检查逐项报结果;多账号;删除账号先写明删去的本地缓存、草稿与凭据,不动服务端
- [ ] C12.6 IMAP 同步(MAIL-14,§12.3,QA-18):文件夹列表与特殊用途;邮件头全部、正文只取 90 天内;UIDVALIDITY 变化即重建该邮箱;服务端删除与标记变化随之;后台任务执行,界面显示最后同步时间、下载范围、未缓存的数量与失败原因
- [ ] C12.7 POP3 收取(MAIL-01,§12.3):按 UIDL 去重下载到本地收件箱,“保留服务端副本”默认开,不做伪文件夹同步
- [ ] C12.8 同步控制(MAIL-14):手动刷新、运行期间定时同步、暂停、按文件夹完整离线下载
- [ ] C12.9 邮箱视图(MAIL-03):账号与文件夹、邮件列表、阅读区三栏;统一收件箱与账号视图;未读、标记、带附件筛选;列表只画可见行,10 万封滚动不掉帧
- [ ] C12.10 阅读(MAIL-04,§12.4):纯文本;HTML 经 html5ever 解析、净化后按块绘制;远程图片与跟踪资源默认拦截,可对当前邮件或发件人放行;cid 内嵌图片;附件列表;原始邮件头
- [ ] C12.11 会话线程(MAIL-04,§12.3):按 Message-ID、In-Reply-To、References 组织,不按主题合并
- [ ] C12.12 写信(MAIL-05):收件人、抄送、密送;回复、回复全部、转发;签名;附件;纯文本或 Markdown(发出纯文本与 HTML);可在独立窗口打开
- [ ] C12.13 草稿(MAIL-06):编辑中存本地草稿,离线可恢复;可选同步到服务端草稿箱
- [ ] C12.14 发送(MAIL-07,§12.4,QA-17):持久发件队列;草稿、排队、正在发送、服务器已接受、失败、结果未知、已取消七态;重试与取消;附件大小提示;“已发送”副本失败只重存副本;结果未知不自动重发,重启后亦然;离线发送与关闭应用时写明队列行为
- [ ] C12.15 组织与待同步队列(MAIL-08,§12.3):已读未读、标记、移动、归档、删除与恢复,按服务端能力(MOVE、Gmail 标签、垃圾箱)映射;离线操作入待同步队列,服务端已变即核对,不无限重试
- [ ] C12.16 搜索(MAIL-09,PERF-06):发件人、收件人、主题、正文、日期、附件文件名,结果注明只覆盖本地缓存;10 万封首屏 1 秒内
- [ ] C12.17 附件(MAIL-10,§16):下载、离线保留、另存、预览;用 Ely 应用打开时先复制为工作副本;显示缓存状态;文件作为附件交给 ElyMail 即开新草稿(不自动发送)
- [ ] C12.18 规则(MAIL-11):按发件人、收件人、主题的本地规则,执行移动、标记或归档
- [ ] C12.19 联系人(MAIL-12):本地地址补全与联系人,vCard 导入导出
- [ ] C12.20 迁移(MAIL-13):EML 查看与导出、MBOX 导入导出,导入不写远程邮箱
- [ ] C12.21 通知(MAIL-15):新邮件通知与静音,锁屏通知默认不显示正文
- [ ] C12.22 设置与数据管理(§18.3):缓存容量与清理、邮件导出、账号删除;诊断不含正文与令牌
- [ ] C12.23 验收(QA-16、17、18,PERF-06,120 fps):离线、发送故障、同步变化的整窗测试;滚动与键入的帧时间实测;三端构建与打包(`apps.tsv` 第二批)
## R1 首版:六个应用的打包(§2.2、§21,用户 2026-10-08 定)
+1
View File
@@ -0,0 +1 @@
PASS