Skip to content

feat(mailview): TextView 宿主接管正文渲染 + 右键菜单/多击选择/头部可选中 + 关闭行为/启动预载/CI 凭据 - #13

Merged
spartajet merged 20 commits into
mainfrom
feat/mailview-renderer
Nov 18, 2026
Merged

spartajet merged 20 commits into
mainfrom
feat/mailview-renderer

Conversation

@spartajet

Copy link
Copy Markdown
Owner

概要(18 commits)

MailView 渲染架构(核心)

交互

  • 正文右键菜单:文本(复制/全选)/链接(打开/复制地址)/图片(复制/另存为,三源字节归一+后台保存流)
  • 双击词选/三击段选(四类词模型,浏览器语义);头部四字段(主题/发件人/收件人/抄送)可选中可复制(独立选择实例+选中高亮)

应用体验

  • 关闭主窗口行为:托盘驻留/退出/首次询问弹窗(记住选择)+ 设置项;QuitMode::Explicit 修复托盘驻留根因;托盘左键重建修复
  • 启动预载:主窗口打开前取首屏数据,首帧即有内容(免两秒空白)
  • html5ever foster-parenting 告警降噪;OAuth2 凭据支持环境变量注入(CI 经 secrets,本 PR 的 CI 构建日志无凭据警告即为验证)

验证

  • 80 项 UI e2e(含 GPUI headless)× 2 并发模式 + 工作区 23 套件全绿
  • build.rs 凭据三态本地验证(.env/env/两者皆无)

…fork 适配分支)

wabzqem/gpui-kit-markdown-editor 上游仅到 0.9——fork 至 spartajet/gpui-kit-markdown-editor gpui-kit-0.10 分支(基于原 pin 31608fa:BlockNode 增 task_marker 字段、Modifiers::secondary 需 &App、KeyBinding::new 收紧 &'static str 改 Box::leak)。工作区零编译错误,全量测试通过(含 65 项 UI e2e)。
[patch.crates-io] 指向 spartajet/gpui-kit mailview-ext(基于 v0.10.0 单 commit:HTML 格式自定义块扩展点,对称复制 markdown 模式;上游 1735 测试零扰动 + 端到端认领测试)。工作区全量测试通过。上游 PR 合入后删此段回归官方版。
postium-html:serialize_marker_html 索引占位序列化 + 10 fixture 快照锁定(内容零泄漏不变式)。
postium-ui:mail_view.rs 编排层——TextViewState 经补丁 html_with_extensions 构造(认领解析器参与首次解析,无二次重解析/首帧闪),DetailStore 内容键缓存(容量 8,深浅通道共用);每帧重注册同形闭包零重解析(长度比较)。
email_detail html_body 路由:全部块类型已迁移(段落/标题/列表/容器/图片/HR)→ MailView;含 Table/Quote(S2/S3 迁入)→ 旧路径整篇,行为零变。
渲染内核开放:RenderCtx/on_link 收紧 Send+Sync(跨线程渲染闭包口径),mail_frame_ctx/mail_render_block 供宿主路径复用;探针体系两路径共用。
e2e:mail_view_renders_blocks_inside_text_view_host 验证标记→认领→渲染→探针全链路;66 测试全绿。
渲染内核(render_block 递归全类型)本就与旧路径共用——S1 的 Table/Quote 排除只是保守路由。本轮放开后 e2e 全绿裁决:smoke(引用折叠)、table_and_link(colspan 宽度比例断言)、html_email_display_keeps_status_bar(aliyun 真实模板:嵌套表格+图片门控+导航布局)均经 TextView 宿主路径通过。66 测试 × 3 并发模式全绿。

预计算组表(虚拟化下跨块选择)与 link_tooltip(悬停反钓鱼)为 v2 增量项,随虚拟滚动启用一并实施。
P0 落地(可行性文档 §4/§5):菜单 UI 复用 ContextMenuExt(email_list 同款,右键/长按/定位/消失全自动);命中上下文经 HtmlSelection.right_hit 跨帧传递(右键按下由 SelectableText Right 分支写入,hover 即写防陈旧命中,左键按下失效,右键不破坏选区——浏览器语义);新增全选(select_all 跨组锚点语义)。

图片字节三源归一:DataUri 原始字节直通(mime→格式/扩展名);Cid/Remote 经 RenderImage BGRA→RGBA→PNG 重编码(image crate png feature 已带);另存为全流程后台线程(rfd 对话框+编码+写盘,toast 全局 channel 线程安全),文件名 alt 净化(Windows 保留字符+限长)。

e2e 五项:剪贴板写入/跨组全选/三态菜单构建(PopupMenu::build 直构)/右键不破坏选区+链接命中记录/PNG 编码往返与文件名净化。73 测试×2 并发模式全绿,工作区 23 套件全绿。
双击词选/三击段选:四类词模型(ASCII 词/CJK 词/空白/标点)——混合文本双击只选 ASCII 词或 CJK 连串(浏览器同款),词字符含 @._-+#(邮箱/域名整体一词),标点与空白不相邻合并;多击不设 down_index(抬起不触发链接打开);不进拖选态(词级拖选扩展不在本期)。

头部可选中:selectable_header_text helper(注册组 + SelectableText + 右键菜单,与正文选择实例隔离——正文每帧 begin_frame 会清共享组表);EmailDetailView 新增 header_selection,主题(14.5 semibold)/发件人/收件人/抄送四处替换,划选+双击+三击+右键复制全交互。

测试:词选单元 9 例(ASCII/CJK/邮箱/标点/混合/越界);e2e 双击选词不触发链接、三击整组、头部主题双击/三击。77 测试×2 并发模式 + 23 套件全绿。
两处根因:①selectable_header_text 未切分选中区间 run——选区逻辑存在但不可见,用户无法感知拖选/词选结果,其间任何点击清选区也无感知(体感'复制一次后菜单变灰');现按 range_for_group 切 run 施加主题 selection 底色(与正文同语义)。②MouseUp 无条件 on_up——浮层元素(右键菜单项)上的点击若泄漏为抬起会终止/干扰选区;加配对守卫(本组无按下且无拖选 → 游离抬起不处理;跨组拖选的止组抬起经 is_dragging 分支仍生效)。

真实应用路径 e2e(AppShell→详情视图):拖选主题产生选区、游离抬起不清选区、右键后选区存活且命中为纯文本。78×2 并发 + 23 套件全绿。
Outlook 系邮件常见 <table> 内直接夹文本——HTML 规范要求 foster parenting(错位内容移到表格外),html5ever 的 RcDom 参考实现未实现、每次解析打一条 WARN(dev 的 html5ever=warn 阈值放行 WARN,release 默认 warn 同样放行)。树仍完整构建,错位内容由 builder 防御性兜底(表格行只认 td/th)——降噪到 error:dev/release 两分支同步,过滤器测试补 WARN 级压制断言。
根因:gpui-pre 非 macOS 的 QuitMode::Default 在最后一个窗口关闭时直接退出进程——X 按钮的 remove_window 连带托盘整体退出,'关闭到托盘'的既有设计从未真正生效。

修复与功能:①启动置 QuitMode::Explicit(无窗口应用驻留,仅显式 cx.quit 退出)。②标题栏 X 经 AppShell::request_close 三分流:最小化到托盘(销毁窗口驻留,托盘「显示窗口」重建)/ 退出程序(存窗口态后退出)/ 每次询问(弹窗:全屏遮罩 + 居中卡片,「最小化到托盘/退出程序/取消」+「记住我的选择」勾选,勾选后按选择持久化不再询问)。③设置-外观分区新增「关闭窗口时」三段选择(每次询问/最小化到托盘/退出程序),点击即持久化 ui-state.json(close_behavior 字段)。④托盘左键单击与「显示窗口」菜单共享重建逻辑(此前主窗口销毁后左键无响应)。

e2e:设置页三段切换持久化断言(ui-state 串行域内往返)。79 测试×2 并发模式全绿;工作区 23 套件全绿(contact_sync 曾现一次并行偶发,重跑稳定,与本次无关)。
根因:首屏数据(账号列表 + 每账号文件夹统计/标签 + 收件箱首页,1+2N+1 条查询)全部经单条 tokio_rusqlite 连接 FIFO 排队——窗口先渲染空白,查询回填后才出数据(启动期与迁移/写入竞争时约两秒)。

修复:open_main_window 在开窗前 block_on 预载(此时尚无窗口,不冻结任何 UI),PreloadedHome 注入 store 种子——AccountsStore::with_preloaded / EmailsStore::seeded_inbox(版本号从 1 起,宿主首帧即构建列表视图),首帧即有侧栏与收件箱内容。空预载(无账号/查询失败)回退懒加载原路径(e2e 全部同路径不受影响);托盘重建主窗口同受益(重建即带新数据)。预载耗时入日志(后续性能观察锚点)。

e2e:preloaded_shell_first_frame_has_data——只 draw 不 park(懒加载任务未执行)断言首帧数据来自种子注入。80×2 并发 + 23 套件全绿。
build.rs 原仅读 .env 文件:无该文件的构建环境(CI runner)OAuth2 凭据缺失。新增进程 env 回退(文件值优先,GOOGLE/MICROSOFT _CLIENT_ID/_CLIENT_SECRET 四键);.env 缺失不再提前返回(空内容继续走回退);缺失告警改查注入结果集合(原实现查进程 env,本地 .env 注入成功也误报)。

凭据已设入 spartajet/postium-mail 的 Actions secrets(四键);test.yml 构建/测试两步与 nightly/release 的发布构建步骤注入对应 secrets。已本地三态验证:无 .env 无 env → 降级告警不阻断;无 .env 带 env → rustc-env 注入成功;.env 存在 → 文件注入优先。
eprintln 不进 cargo 常规输出,CI 上无法判断凭据是否注入;改 cargo:warning 后:CI 构建日志出现该警告=未注入,无警告=secrets 注入成功(值不回显)。移除遗留的 exit 压制写法。
根因:IMAP 服务器 LIST 返回的收件箱名形态不一(163/Outlook 实测小写 inbox),全量 SyncNow 按 LIST 原名落库;IDLE 定向同步按保留名 INBOX 落库——(account_id, folder, uid) 唯一键大小写敏感,同一封新邮件双行,AllInbox 聚合两种形态都命中 → 列表每封两次。用户库实测:inbox 7486 行 + INBOX 575 行,576 组真重复。

修复三层:①normalize_imap_folder(RFC 3501 §5.1 INBOX 大小写不敏感保留名,规范形态大写)——引擎 discover_folders/sync_one_folder(写入+sync_state 键)、service resolve 出口与 list_emails 原名入口(查询)双侧统一。②幂等迁移 merge_inbox_folder_case_variants:emails/sync_state 每 (account,uid) 组保留最小 id 行(浏览历史/附件缓存多挂先行),变体删除+改名(attachments 级联兜底);库副本演练:删 576 改名 6910,残留 2 组为已发送+收件箱的合法多文件夹存在。③迁移单测(双形态合并/独行改名/幂等重跑)。工作区 23 套件全绿。
实机复现验证:关闭到托盘(remove_window)后 ERROR 'handling active status change ... window not found' 为 gpui-pre 平台回调在窗口已移除后仍到达的日志噪音——QuitMode::Explicit 下进程持续驻留(自动化探针 50s+ 存活),不导致退出。按文件判定压制(log 桥接同 directx_devices 先例)。
根因:TrayIcon 挂在 AppShell._tray 字段,而 AppShell 是主窗口根视图——「最小化到托盘」remove_window 销毁窗口即 drop 实体,TrayIcon::Drop 触发 Shell_NotifyIcon(NIM_DELETE),图标消失(进程与 App 级轮询任务存活——所以后台在跑但托盘空了)。旧版因 QuitMode bug 从未真正驻留,该缺陷从未暴露。

修复:图标移入 tray 模块 thread_local 进程级持有(Windows TrayIcon 含裸 HWND 非 Send/Sync,须与消息泵同线程——static 不可用,thread_local 恰合且随主线程终结析构);setup_tray 幂等(主窗口重建复用图标);事件轮询任务 CAS 保证只 spawn 一次;AppShell._tray 字段退役,TRAY_ALIVE 语义不变。清理 TrayActions/ACTIONS_ID 死代码。80 e2e + 23 套件全绿。
GUI 应用默认 console 子系统,启动即弹黑窗。修复:main.rs 顶部 #![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]——release 无控制台(PE 头 subsystem=2 已验证),debug 保留控制台供开发看 stderr。

无控制台后日志不可见 → 新增文件日志:setup_logging(logs_dir) 写 ~/.postium/logs/postium.log(tracing-appender 非阻塞 writer 不拖慢 UI 线程;WorkerGuard 返回调用方全程持有——此前 mem::forget 导致缓冲不 flush 实测 0 字节)。文件无 ANSI 色彩、debug 双写控制台+文件;release 过滤器放宽到 INFO(文件无刷屏负担,启动迁移/预载耗时等运维日志可查)。

release 实机验证:PE subsystem=2 + postium.log 912 字节完整落盘(含启动预载耗时 634ms——旧版两秒空白的量化锚点)。23 套件全绿。
通道:本机回环 TCP 握手(跨平台、零新依赖、无 win32 unsafe,避开 OAuth 端口 36279)。首个实例 bind 端口成为 Primary;后续实例 bind 失败 → 连接发送魔串,Primary 回 ACK 并经事件循环 show_main_window(存活激活置前 / 关闭到托盘则重建)——第二实例在重量级装配(CoreApi::init/数据库/引擎)之前退出,不碰库。握手带确认与 800ms 超时(端口被无关占用不误伤对方也绝不挂死);show_main_window 迁至 app.rs 供托盘/单实例双路共享;握手 ACK 不 shutdown(Both)(立即 RST 会吞掉客户端未读 ACK)。

实机双实例验证:第二实例「唤醒握手成功,本实例退出」exit=0,Primary 持续运行。23 套件全绿。
@spartajet
spartajet merged commit 5543242 into main Nov 18, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant