Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
c480138
build(deps): gpui-kit 0.8 → 0.10(gpui-pre 0.3.12,markdown-editor 走自有 …
spartajet Nov 16, 2026
cee1025
build(deps): 接入 gpui-base mailview-ext 补丁分支(html_block_parser/renderer)
spartajet Nov 16, 2026
667d129
feat(mailview): S1——TextView 宿主接管正文渲染(标记序列化 + 块认领 + 渐进回落)
spartajet Nov 16, 2026
ce2500d
feat(mailview): S2/S3——引用折叠与表格全量迁入宿主路径(路由放开,e2e 裁决)
spartajet Nov 16, 2026
3ee68b5
docs(plans): MailTextView 可行性文档追加实施结论章(混合自定义块架构落地)
spartajet Nov 16, 2026
b3c62c1
docs(ui): 修正 html_body 路由注释——S2/S3 后全量走 MailView,旧路径仅 e2e 保留
spartajet Nov 17, 2026
73444f5
feat(mailview): 正文右键菜单——文本(复制/全选)、链接(打开/复制链接地址)、图片(复制图片/另存为)
spartajet Nov 17, 2026
485636d
feat(ui): 浏览器语义多击选择 + 头部字段(主题/发件人/收件人/抄送)可选中可复制
spartajet Nov 17, 2026
1423b1c
fix(ui): 头部字段选中高亮 + 游离抬起守卫——拖选可见、选区跨菜单复制存活
spartajet Nov 17, 2026
5f7af85
fix(log): 压制 html5ever RcDom foster parenting 告警(无害噪音,线上反馈④)
spartajet Nov 17, 2026
45d45fe
feat(tray): 关闭主窗口行为——托盘驻留/退出/首次询问弹窗 + 设置项(线上反馈⑤)
spartajet Nov 17, 2026
bd0b361
feat(ui): 启动预载首屏数据——主窗口打开即有内容(线上反馈⑥)
spartajet Nov 17, 2026
9bfcd26
build(oauth): 凭据支持进程环境变量注入——CI 经 GitHub secrets 编译期可达(线上反馈⑦)
spartajet Nov 17, 2026
4b40b83
build(oauth): 凭据缺失告警改 cargo:warning——CI 日志可观测注入状态
spartajet Nov 17, 2026
ea73709
fix(ci): 标记快照 .txt 锁定 LF——Windows runner autocrlf 转换致字节级比对误报(PR #13 实测)
spartajet Nov 17, 2026
4bc6886
fix(sync): INBOX 大小写变体双写——同一封邮件列表出现两条(线上反馈⑧)
spartajet Nov 17, 2026
5a53090
fix(log): 压制窗口移除后的平台激活回调噪音(window not found,线上反馈⑨)
spartajet Nov 17, 2026
dfc2f9d
fix(tray): 图标进程级持有——主窗口销毁不再连带移除托盘图标(线上反馈⑨续)
spartajet Nov 18, 2026
a73ea61
fix(windows): release 构建无控制台窗口 + 日志落盘(线上反馈⑩)
spartajet Nov 18, 2026
98516e2
feat(app): 单实例——第二实例唤醒既有实例后退出(线上反馈⑪)
spartajet Nov 18, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
Expand Up @@ -3,3 +3,6 @@
crates/postium-html/tests/fixtures/snapshots/*.json text eol=lf
# fixture 语料同样固定 LF,保证管线输入跨平台一致(空白折叠语义不受影响,双保险)
crates/postium-html/tests/fixtures/*.html text eol=lf
# 标记序列化快照(markers.rs 逐字节比对):Windows runner checkout 转 CRLF
# 会与 '\n' join 的序列化产物不一致(PR #13 CI 实测踩中)
crates/postium-html/tests/fixtures/markers/*.txt text eol=lf
6 changes: 6 additions & 0 deletions .github/workflows/nightly.yml
Original file line number Diff line number Diff line change
Expand Up @@ -120,6 +120,12 @@ jobs:

- name: Build release binary
run: cargo build --release --target ${{ matrix.target }} -p postium-ui
env:
GOOGLE_CLIENT_ID: ${{ secrets.GOOGLE_CLIENT_ID }}
GOOGLE_CLIENT_SECRET: ${{ secrets.GOOGLE_CLIENT_SECRET }}
MICROSOFT_CLIENT_ID: ${{ secrets.MICROSOFT_CLIENT_ID }}
MICROSOFT_CLIENT_SECRET: ${{ secrets.MICROSOFT_CLIENT_SECRET }}


# ── 打包为原生安装包(版本号取自 workspace Cargo.toml)──
- name: Resolve version
Expand Down
6 changes: 6 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -118,6 +118,12 @@ jobs:

- name: Build release binary
run: cargo build --release --target ${{ matrix.target }} -p postium-ui
env:
GOOGLE_CLIENT_ID: ${{ secrets.GOOGLE_CLIENT_ID }}
GOOGLE_CLIENT_SECRET: ${{ secrets.GOOGLE_CLIENT_SECRET }}
MICROSOFT_CLIENT_ID: ${{ secrets.MICROSOFT_CLIENT_ID }}
MICROSOFT_CLIENT_SECRET: ${{ secrets.MICROSOFT_CLIENT_SECRET }}


# ── 打包为原生安装包(版本号取自 workspace Cargo.toml)──
- name: Resolve version
Expand Down
12 changes: 12 additions & 0 deletions .github/workflows/test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -37,10 +37,22 @@ jobs:
- name: Cache Rust
uses: Swatinem/rust-cache@v2

# OAuth2 凭据经 secrets 注入构建期(线上反馈⑦:build.rs 进程 env
# 回退——无 .env 文件的 CI 也能编译出带凭据的二进制)
- name: Build workspace
run: cargo build --workspace
env:
GOOGLE_CLIENT_ID: ${{ secrets.GOOGLE_CLIENT_ID }}
GOOGLE_CLIENT_SECRET: ${{ secrets.GOOGLE_CLIENT_SECRET }}
MICROSOFT_CLIENT_ID: ${{ secrets.MICROSOFT_CLIENT_ID }}
MICROSOFT_CLIENT_SECRET: ${{ secrets.MICROSOFT_CLIENT_SECRET }}

# 单独跑应用二进制构建产物检查(可选发布前置)
# 全部测试(含 postium-ui 的 GPUI E2E,headless 无需显示服务器)
- name: Run all tests
run: cargo test --workspace
env:
GOOGLE_CLIENT_ID: ${{ secrets.GOOGLE_CLIENT_ID }}
GOOGLE_CLIENT_SECRET: ${{ secrets.GOOGLE_CLIENT_SECRET }}
MICROSOFT_CLIENT_ID: ${{ secrets.MICROSOFT_CLIENT_ID }}
MICROSOFT_CLIENT_SECRET: ${{ secrets.MICROSOFT_CLIENT_SECRET }}
58 changes: 58 additions & 0 deletions .zcode/plans/plan-sess_9c64d9b8-6f37-4f93-a431-49fa2190b517.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
# MailView 右键菜单:文本 / 链接 / 图片

## Context

MailView(TextView 宿主 + 自有渲染内核)已接管正文渲染。本任务落地可行性文档 §5 的 P0 项:正文内右键上下文菜单——**文本**(复制/全选)、**链接**(打开/复制链接地址)、**图片**(复制图片/另存为)。当前正文右键无任何响应;列表行已有右键菜单先例(email_list.rs → gpui-kit `ContextMenuExt`),本任务复用同一基础设施与交互语言。

## 架构决策(基于侦察证据)

1. **菜单 UI**:复用 `ContextMenuExt::context_menu(builder)`(gpui-component 0.10 `menu/context_menu.rs`)——右键/触屏长按检测、anchored+deferred 定位、焦点恢复、点外消失全自动。builder 无命中参数 → 命中上下文须**预先捕获**。
2. **命中上下文跨帧载体**:builder 在 `window.defer` 的下一帧执行,`RenderCtx` 每帧重建不能承载 → 写入 **HtmlSelection**(每邮件交互状态,EmailDetailView 持有、全链路穿透、生命周期正确):`SelState.right_hit: Option<SafeUrl>`——右键按下时由 SelectableText 写入(None=纯文本命中),左键按下时清除(浏览器语义:右键不破坏现有选区,左键开始新选区时失效)。
3. **文本组挂菜单**:`flush_text_group` 产出的 div 直接 `.context_menu(...)` 包裹(email_list 同款无 id 模式,同调用点共享状态 + hovered 守卫只让被按压的组弹菜单)。SelectableText 现有 MouseDown 监听加 **Right 分支**:`index_for_position` → `ranges.position(contains(ix))` 命中链接则 `selection.set_right_hit(Some(url))`,否则 `set_right_hit(None)`——即游标样式切换(email_html.rs:925)的既有判定式复用。
4. **图片挂菜单**:`render_loaded_image` 的 `img()` 包一层 `div().child(img).context_menu(builder)`——闭包在元素构造期直接捕获该图数据(无需命中检测),一处包裹覆盖块级/行内/表格内全部图片路径(共用此函数)。被拦截的远程图**占位框不挂菜单**(已有「加载图片」条,避免双入口)。
5. **图片字节三源归一**(新 helper `image_payload`):
- `ImageRef::DataUri { mime, bytes }` → 原始字节 + 按 mime 映射 `ImageFormat`(零重编码)
- Cid / Remote → 手头只有 `Arc<RenderImage>`(BGRA,`as_bytes(0)`,gpui-pre assets.rs:72)→ BGRA→RGBA 交换 → `image` crate PNG 编码(png feature 已启用)
- 产出 `(ImageFormat, Vec<u8>)`:剪贴板走 `ClipboardItem::new_image(&Image::from_bytes(fmt, bytes))`(platform.rs:3180/3447);另存为直接写字节(DataUri 按 mime 定扩展名,重编码路径恒 .png,文件名 = alt 文本净化 || "image")
6. **另存为流程**:沿用 attachments 先例(email_detail.rs:270-287)——`std::thread::spawn` 里 `rfd::FileDialog::set_file_name().save_file()` → 结果经 channel 回 `cx.spawn` → 后台线程写文件 → toast 成功/失败。

## 菜单项(沿用已批准的可行性文档 §4 规格)

| 目标 | 菜单项 | 行为 |
|---|---|---|
| 文本 | 复制(选中存在时可用,否则禁用) | `selection.selected_text()` → `write_to_clipboard(new_string)` + toast(复用 `email.selectionCopied` 流程) |
| 文本 | 全选 | 新 `HtmlSelection::select_all()`(anchor=(0,0) → head=(末组,末长))+ `window.refresh()` |
| 链接 | 打开链接 | 命中 URL → 复用 `on_link` 回调(=open_safe_url) |
| 链接 | 复制链接地址 | `SafeUrl` 内串 → 剪贴板 + toast |
| 图片 | 复制图片 | `image_payload` → `ClipboardItem::new_image` + toast |
| 图片 | 另存为… | rfd 流程(上文 6) |

链接命中时优先链接菜单(不吃文本菜单);图标用 IconName 既有项(ExternalLink/Link/Copy/Image/Save)。

## 修改清单

| 文件 | 改动 |
|---|---|
| `crates/postium-ui/src/views/html_selection.rs` | `SelState.right_hit: Option<SafeUrl>` + `set_right_hit` / `right_click_link()` 读写口;`select_all()`(组注册表末组末偏移为 head);左键 `on_down` 清除 right_hit |
| `crates/postium-ui/src/views/email_html.rs` | ① SelectableText MouseDown 加 Right 分支(命中解析 + set_right_hit,不清选区、不 stop_propagation——放行给 ContextMenu 包裹层开菜单);② `flush_text_group` 文本 div `.context_menu(文本菜单 builder)`(闭包捕获 selection/on_link,读 `right_click_link()` 分流链接/文本菜单);③ `render_loaded_image` 包裹 div + 图片菜单 builder(捕获 image_payload 输入 + alt);④ helpers:`image_payload() -> Option<(ImageFormat, Vec<u8>)>`、`save_image_to_file()`(rfd+写盘+toast)、`SafeUrl` 显示串 helper |
| `crates/postium-ui/src/i18n_tables.rs` | 新键(ZH+EN 成对,i18n 测试强制同键集):mailMenu.{openLink, copyLink, copyImage, saveImageAs, copy, selectAll, linkCopied, imageCopied, imageSaved, imageSaveFailed} |
| `crates/postium-ui/src/e2e_tests.rs`(或新文件) | 见验证 |

约 350–450 行。旧路径 `render_html_document`(e2e 探针直驱)经同一 flush_text_group/render_loaded_image 自动获得同款菜单——两路径行为一致。

## 验证

1. **单元**:`safeurl` 显示串;`image_payload` 对合成 RenderImage(synthetic_render_image 已有)产出非空 PNG 字节且可被 `image::load_from_memory` 解回。
2. **e2e**(沿 email_list 先例:PopupMenu 弹出属渲染层,动作走直测):
- `mail_menu_copy_link_writes_clipboard`:构造含链接文档 → 直调复制动作 helper → `cx.read_from_clipboard` 断言 URL 文本;
- `mail_menu_select_all_selects_across_groups`:多组文档 → `select_all()` + 刷新 → `selected_text()` 含全部组文本、Ctrl+C 动作后剪贴板一致;
- `mail_menu_builders_content`:右键命中链接态 vs 文本态分别构建菜单 → `PopupMenu::is_empty() == false`(菜单构建路径绿)。
- 右键交互冒烟:`simulate_event(MouseDownEvent{button: Right, ..})` 打在链接文本 bounds 上不 panic、选区不被破坏(回归护栏)。
3. **全量**:`cargo test --workspace`(CI 同款门禁)。
4. **手工**:真机打开邮件——右键纯文本/链接/图片各出对应菜单;复制项落剪贴板可粘贴验证;另存为对话框出正确默认文件名;Esc/点外关菜单;右键不破坏既有划选。

## 明确不做(记录在案)

- 占位框(被拦截远程图)不挂菜单——「加载图片」条已是唯一入口
- 词级"复制光标处单词"(HtmlSelection 无词边界 API,浏览器亦无此默认项)
- 触屏长按菜单——ContextMenuExt 自带,但不在本任务测试矩阵
Loading
Loading