ElyMark goes native: task list, markion and markdown-rs references, reviews at effort high

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-11 23:02:18 -04:00
1 parent 60d82d0c5e
commit ef6dd7e06b
29 files changed
+345 -535

No files matched your search

+19 -8
View File
@@ -95,14 +95,25 @@
## C14 ElyMark(§14)
- [~] C14.0 本地 Web 内容宿主 `ely-web-content`:CEF 离屏接入 GPUI,输入、焦点、缩放、主题 token(§17.3;ElyMark 先用,ElyMail 后用)。已验证(macOS arm64,CEF 154.0.32):开发构建与 `.app` 包(五个辅助应用)里页面画出、随应用深色;点选、中英文键入、回车、退格、方向、拷贝粘贴;输入法组字与提交、焦点、主题变量、缩放 1.25、`elyQuery` 往返、页面跳不出所在文件夹(`tests/scripts/webview.sh`);连续五次启动都画出。未验证:Windows 与 Linux;辅助技术读页面文字(缺口) — R1 FAIL 七项已修:资源请求不过门(每个请求都判定,外面的脚本与 HTTP 被取消);符号链接可出门(按真实路径);浏览器与表面互相持有,关闭后不释放(关闭时断开,20 个都释放);载入失败当作载入完成且显示 Chromium 的错误页(报失败,显示组件错误视图与重新载入);文件名里的 `#` 当作 URL 语法(逐字节转义);渲染进程退出与 CEF 起不来只写日志(视图内显示故障并可重新载入);测试不量像素(截窗口量标记色,去掉绘制即失败)。另修:在 GPUI 更新里同步调 CEF 偶发中止(全部经主线程队列在更新之外执行)。R2 FAIL 两项已修:WebSocket 不经资源回调可达本机(每个 CEF 进程把一切网络送往不通的代理,含回环);崩溃测试不看故障视图(截窗口须不见旧画面,经辅助功能按下 Reload 才恢复)。R3 FAIL 两项已修(不再送审):WebRTC 经 UDP 绕过代理(只许经代理,且页面里删去 WebRTC 构造;本机 UDP 收不到 STUN,去掉时测试失败);恢复只看载入事件(重新载入后截窗口须见页面标记,保留故障时测试失败)
- [~] C14.1 内容包:Milkdown、CodeMirror 6、Mermaid、数学公式,本地构建、随包、无 CDN。已验证(macOS):`tests/scripts/mark-content.sh` 构建后在真窗口里三种模式渲染标题、任务、表格、脚注、公式、代码块、Mermaid 与两种错误(带原文与位置),每个代码块滚入视口后读出、要求可见(不透明、未被遮挡),图不小于 100×80,预览只读,切换深浅色后图的颜色随之变(含首次绘制途中切换,且首次落下的就是新颜色),绘制途中把代码块改成 Rust 后旧图不落入,连续两次显示只留后一次且只报后一次,截窗口时背景色占比须低于 0.97(隐藏正文时为 0.999),KaTeX 字体载入,无越界请求;`.app` 包内页面显示。未验证:Windows 与 Linux;树莓派载入时间 — R1 FAIL 四项已修:按钮图标的尺寸规则也压扁了 Mermaid 图(限于工具栏与语言列表);主题变化后已显示的图不变色(图带编号,令牌一变即经代码块的回调重画,只取每块最新的一次);连续两次显示会留下两个编辑器(每次显示一个容器与序号,过期的创建即销毁、不报告);测试不看是否真的可见(逐块可见性、图的尺寸、换主题、竞争与截窗口,各以变异核对会失败) R2 FAIL 五项已修:Milkdown 每次预览给的回调都是新的函数,按回调认定的记录对不上,改语言后旧图仍落入(预览先返回带编号的占位,结果只在占位仍在页面上时落下;改语言、改文字、卸载都会换掉占位);首次绘制途中换主题时记录被当作已离开而删去(占位在页上即保留,换主题时连同待画的一并重画);记录由全局持有、编辑器销毁不释放(每个编辑器拥有自己的记录,销毁即释放;占位离开页面的记录在下一次绘制或换主题时清掉;实测 20 次显示与切回源码后为 0);测试的退出钩子在探针已回收后返回 1(只停仍在运行的探针,清理总执行);块公式只查节点存在(滚入视口查可见,隐藏公式的变异会失败)。重载页面使两项竞争发生在 Mermaid 包载入与绘制途中,去掉各项修复的变异都会失败 R3 FAIL 两项已修(不再送审):主题重画复用同一记录,旧主题的首次结果仍会先落下约一秒(每次绘制带代次,重画即作废此前的结果);编辑器销毁后队列里排着的绘制仍逐个执行(每个绘制在调用 Mermaid 前与落下前都核对属主、占位与代次,失效即跳过;测试在三张约 3 秒的图排队时切回源码,之后的主线程长停顿须不超过一次,去掉核对时为两到三次)
- [x] C14.2 文件会话与原文保留:BOM、换行、front matter、未知语法(§14.3,QA-21)。已验证(macOS):`tests/scripts/mark-session.sh` 在真窗口打开 BOM、CRLF、front matter、Setext 标题、`1)` 列表、HTML 块、`~`删除线、硬换行、链接定义与 `[[...]]` 的文件,不改保存逐字节相同,首段键入一字保存只改该段(整篇序列化与去掉 BOM 的变异都失败),不能对应的文档以源码模式打开并可保存;`text.rs` 单测(BOM、换行、混用、非 UTF-8)。未验证:Windows 与 Linux;混用换行的文件编辑后统一为多数的换行(已知限制) — R1 FAIL 六项已修:改动段落时其中的 `[[...]]` 被转义、引用与列表内的局部改动重写整个容器(Milkdown 不能逐字写回的顶层块一律以原文块显示与编辑,序列化照文档自己的写法);块间隐藏的链接定义被移动与修剪(块间原文也成原文块,无隐藏原文);页面重载后新编辑被当作旧版本丢弃(每次载入一代,回报带代数,计数归零);无读权限的文件被当作加密文件问密码(权限错误照原话报出);注释超过十词 — R2 FAIL 两项已修:保存写出的文字与随后读的修订标记取自两次快照,导出与读标记之间的编辑被记为已保存(写出时记下所写文字的标记,读修订时先交它;单测在两者之间改文字);链接定义的测试用多行 grep 恒真(改为逐字节比较)
- [~] C14.3 编辑模式、Markdown 与扩展语法(MARK-01、02、03、04)。已验证(macOS):`tests/scripts/mark-modes.sh` 真窗口里文档旁图片画出,可视、源码、预览往返不改文件,预览不收键入,经预览往返后撤销仍有效,源码改动回到可视并保存,重命名拒绝已有名称、改到新名后继续保存,新建为空可视文档;`mark-content.sh`、`mark-session.sh` 照过;`rename_new` 单测。未验证:Windows 与 Linux(改名的平台实现未构建);“直接打开文件夹”随文件树在 C14.4 — R1 FAIL 七项已修:另一模式改过文字后回来,原编辑器连同撤销历史被销毁(旧编辑器留在新编辑器之后,撤销用尽即回到它,重做用尽回到较新的);改名完成时标签已关仍去登记(须仍开着且仍是原路径);Windows 路径的 file URL 无效(驱动器与 UNC 分别处理,围栏反向转换,单测);构建中再要的模式被丢(记下,构建完显示最后一个);新建的测试不看内容(读外壳写下的文件须为空);`handlers.rs` 超过 500 行(请求处理移入 `fence.rs`);`Renaming` 只有一个使用者(移回 ElyMark) — R2 FAIL 四项已修:跨模式撤销被当作新编辑、丢了重做(跳转只报新文字,不截时间线);按模式分开的历史使撤销次序不对(改为本文件一条时间线,以当前模式重建);改名间隙里打开新名字得到第二个可写标签(登记记下文件身份,原路径不在而身份相同即同一文件,改名后迁移登记;单测);构建完成的回报回来后旧请求覆盖新的(请求按序号,只认最新) R3 FAIL 三项已修(不再送审):编辑器内撤销后切换模式,重做丢失(离开时把全部重做后的文字记在时间线前方);原子保存换了文件身份,保存后改名的间隙仍得到第二个会话(外壳每次保存成功后以 `Sessions::track` 更新登记的路径与身份;单测在原子替换后改名);旧回报清掉了较新构建排队的模式(代次不符即退出,不碰排队请求;探针按住两个回报复现)
- [~] C14.4 导航与搜索:文件树、大纲、多标签、最近文件、文件夹搜索(MARK-05、10)。已验证(macOS):`tests/scripts/mark-places.sh` 真窗口打开文件夹与文件,树只列 Markdown、回车打开,大纲跳转后键入落在标题,文件夹搜索找到两文件的行、不搜 .txt、结果打开到该行,最近列表重启后保留并可打开文件夹;`folder.rs` 与 `ely_files::recent` 单测;其他三个 ElyMark 门照过。未验证:Windows 与 Linux;大纲项的无障碍(组件库待办) — R1 FAIL 六项已修:搜索定位只到块首(带上查询,落在块内该行那一处);可视与预览的行号未计 front matter(按 front matter 行数换算,落在其中即滚到它);以原文块显示的标题不进大纲(原文块记下标题级别,大纲取其首行文字,跳转落在标题文字上);本文件的搜索结果不随标签切换(切换即重搜,迟到的结果按次序作废);读不出的文件只记日志(以“某文件未能搜索”的行列在结果里,带原因);改名后最近列表仍是旧名(最近列表按真实路径,改名即迁移,旧路径不在即移出)。各项去掉时 `mark-places.sh` 或 `mark-modes.sh` 失败 R2 FAIL 三项已修:块内命中按源码计数,链接地址里的词打乱次序(此前行先经 Milkdown 解析,按编辑器所见的文字计数;原文块照源码);引用、列表里的标题成了原文块后不进大纲(原文块的源码以 remark 读出其中全部标题与位置,不再只记顶层标题的级别);改名后文件树与文件夹搜索仍是旧名(改名即重列文件夹,列表变了即重搜文件夹)。各项去掉时 `mark-places.sh` 失败 R3 FAIL 两项已修(不再送审):此前命中的计数与块内查找的重叠规则不一(都按不重叠,`ana` 在 `banana` 里只算一次);命中只在链接地址里时落到下一处可见的命中(该行所见文字没有查询词即落在该行开头)。另修:已打开的文件因路径写法不同(`/var` 与 `/private/var`)不被认出,跳转落空(文件夹以真实路径列出,标签按真实路径认);块内位置把软换行算进与不算进两边不一(编辑器一侧也算入换行)。去掉各项时 `mark-places.sh` 失败
- [~] C14.5 编辑工具与附件(MARK-06、07)。已验证(macOS):`tests/scripts/mark-tools.sh` 真窗口可视全部替换、源码正则替换、Tab 与 Shift-Tab、列表续写、Cmd+Down 后插入表格与行列操作、拖放图片落到 assets,`ELY_CLIPBOARD_TEST=1` 时粘贴图片;`edit.rs`、`attach.rs`、`import_attachment` 单测;其他 ElyMark 门与 `webview.sh` 照过。未验证:Windows 与 Linux — R1 FAIL 五项已修:查找框整窗一个,替换用了该标签页面里旧的查询(下一处与替换带上框里的查询,换标签即重查);键入替换文字使命中后移(查询变化从命中起点找);源码里替代文字的方括号未转义(加转义);复制期间另存到别处,链接指向新文件夹里不存在的图片(完成时核对文件夹,变了即不写链接并说明);四处注释超过十词(缩短,`comments.py` 另查 Swift 与页面 JS)。去掉各项时 `mark-tools.sh` 失败 R2 FAIL 三项已修:空查询仍调 CodeMirror 的查找命令,打开它自带的面板(各命令先核对查询有效);正则校验未带编辑器所用的 `u` 标志,`a{`、`\a` 报成无结果(按 `gmu` 校验);`comments.py` 漏过 JS 的跨行块注释(一并检查,`comments-rules.sh` 核对)。`mark-content.sh` 的 find 步核对两种模式都无 CodeMirror 面板、四个错误;去掉守卫或 `u` 时失败 R3 FAIL 两项已修(不再送审):可视模式零宽正则在表情字符处只进一个 UTF-16 单元,落在代理对中间时同一命中反复收集,页面进程耗尽内存崩溃(零宽命中按码点前进,命中不再往前即停);`comments.py` 漏过代码之后开始的跨行块注释(任意位置未闭合的 `/*` 都算)。`mark-content.sh` 在两种模式下对 `😀 alpha` 找 `(?=.)` 得 7 处(只进一个单元时页面崩溃、测试失败),`comments-rules.sh` 核对行内起头的跨行注释
- [~] C14.6 外部变更与会话恢复(MARK-08、12,§14.4,QA-22)。已验证(macOS):`tests/scripts/mark-outside.sh` 真窗口原子替换后重载并保持位置、键入后 1 秒自动保存;未保存时外部写入不被覆盖,三方比较、保留你的、合并;外部改名跟随、删除后不自动保存不重建、读不出时提示并可再查;退出后恢复标签、模式与行;崩溃后恢复未命名文档的未保存内容并标为未保存,显式不保存后不回来;`Sessions::renamed_in`、`alive` 单测;其他 ElyMark 门与 `webview.sh` 照过。未验证:Windows 与 Linux;网络目录;导出(C14.7) — R1 FAIL 六项已修:比较期间磁盘再改,合并与保留按旧的磁盘指纹写入、覆盖新改动(比较记下所读内容的指纹,选定前核对,不符即重读重比;重载与比较都以所读字节的指纹为准,`Session::reload_at`);有路径文件的崩溃恢复内容直接进了原文件、下一次编辑自动保存覆盖原件(恢复内容一律开成未命名副本,原件照磁盘打开);原件已不在时恢复内容随标签被丢(照样开成副本,并提示哪个文件没能打开);取消退出后会话清单一直不更新(外壳的“未保存”询问取消时调 `Host::close_cancelled`,清单恢复跟随;已关闭或放弃的标签的恢复点随即删去);只恢复行、不恢复行内位置(记下并恢复列);“保留你的”之后自动保存一直停着(选定后重新开始)。另:启动参数给了文件时只开它(及崩溃恢复的副本),不再连带上次的标签(否则加载先后决定哪个标签在前,键入落到别的文件)。去掉各项时 `mark-outside.sh` 失败 R2 FAIL 五项已修:“保留你的”仍走无条件覆盖(改为以所比较的指纹为基线 `Session::rebase` 后走普通保存,之后的外部改动照样冲突);一个标签连续消费多份恢复文本(每个标签只在首次显示时恢复一次);询问里点保存、随后取消保存面板(或保存失败)时清单仍冻结(外壳在这些出口也调 `close_cancelled`,冲突询问取消同);放弃的标签要等下一次定时才删恢复点与清单(外壳关闭标签时调 `Host::tab_closed`,即刻删去其恢复点、在途的恢复点写完即删,并更新清单);旧会话文件缺列即启动失败(缺列读作 0)。另:自动保存撞上外部改动时不弹外壳的冲突框,交给比较(`Host::conflicted`);组件库 f756043:脏标签与非当前标签的关闭按钮原为隐藏(`invisible`),辅助技术按不动、无法关闭,改为透明仍可按;`ax-press` 另找应用的各窗口并可限定角色。去掉各项时 `mark-outside.sh` 或单测失败 R3 FAIL 三项已修(不再送审):外壳冲突询问的“保留我的”仍以 `save_overwrite` 无条件覆盖,导出期间的新外部写入被盖掉(改以此刻磁盘的指纹为基线 `rebase` 后走普通保存,之后的变化照样冲突;文件已不在时才直接写;ely-files 单测核对其后的写入不被覆盖,ElyDoc 的保留我的测试照过);退出时冲突询问的“从磁盘重新载入”丢了挂起的关闭、清单冻结(先调 `close_cancelled` 再重载);退出途中首次保存的未命名标签在清单里仍无路径,重启不恢复(关闭钩子按恢复槽把新路径与名称写回冻结的清单)。`mark-outside.sh` 覆盖退出时冲突→重新载入→新文档进清单、退出时首次保存→重启恢复该文件;去掉各项时失败
- [~] C14.7 书写视图、输出、Git 配合、大文件(MARK-09、11、13、14)。已验证(macOS):`tests/scripts/mark-output.sh` 真窗口专注模式与外观持久、HTML/资源文件夹/PDF/纯文本导出全文、打印出 PDF、Git 状态随保存变化并打开 ElyTree、3.3 MB 文件只用源码且全文保存与导出、富文本复制带 HTML;`mark-content.sh` 的 look 步;`paper`、`look` 单测;PERF-07 release 1 MB 1.4 秒(冷启动 2.0 秒);其他 ElyMark 门与 `webview.sh` 照过。未验证:Windows 与 Linux R3 FAIL 两项已修(不再送审):导出只收 `img[src]`,`srcset` 与 `picture > source` 的资源留着相对路径(导出时每张图定为一个 `src`:去掉 `srcset`、`sizes` 与 `picture` 的 `source`,无 `src` 时取 `srcset` 的首个地址,随后照常内嵌或拷入资源文件夹);KaTeX 的语法错误被吞,导出照报完整(保留渲染的 VFile,公式错误带行号与 KaTeX 的说明进提示,日志只记行号)。另:组件库 28a6bba 的 `Toaster` 原把每条提示的标题写进日志(提示可引用正文与图片名),改为只记编号与级别;外壳加 `toast_unlogged`,ElyMark 的缺失提示用它。`mark-output.sh` 加响应式图片三种、错误公式、图片名与公式文字不进日志;去掉各项时失败
用户 2026-10-11 定:ElyMark 不用 CEF,不用 Electron。界面用 Ely-GPUI-Components 的 Markdown 组件(`documents::MarkdownEditor` 一族,缺的在组件库补并推到 Gitea),解析用 markdown-rs,公式用 RaTeX,Mermaid 用 mermaid-rs-renderer,PDF 用 MuPDF Story。删去 CEF 与网页内容,ElyMail 也不用 CEF 与 Electron。旧 C14.0 至 C14.7(CEF 实现)作废,记录在 git 历史。
- [x] C14.0 前置:`reference/` 加 markion 与 markdown-rs 并钉提交;`scripts/review.sh` 照用户新定(gpt-6.1-sol,effort high,fast,每条最多三轮) — R2 ok
- [ ] C14.1 组件库:`MarkdownRenderer`、`MarkdownEditor`、Markdown 着色、块范围、大纲与链接查找改用 markdown-rs(`documents` 的 `tree`、`markdown`、`render`);`BlockEditor` 的导入导出不属 ElyMark,仍用 pulldown-cmark;原有测试照过,改了语义的测试写明 markdown-rs 的读法;推送,ElyOffice 钉新提交
- [ ] C14.2 组件库:公式与 Mermaid(MARK-04)。`typography::Latex` 改由 RaTeX 排出;Mermaid 由 mermaid-rs-renderer 画成图;画不出即显示错误与原文;`MarkdownRenderer` 用二者,本地图片按属主给的文件夹读,网络图片不自动载入
- [ ] C14.3 组件库:文件级 Markdown 文档组件。一个 `CodeEditor` 持全文与撤销;可视(变高虚拟列表,逐块渲染,按下的块开成源码,写回为一步撤销)、源码(`CodeEditor` 加 Markdown 着色)、预览(只读);属主可读写文本、模式、插入点行列、滚动,可跳到行;改动发事件
- [ ] C14.4 ElyMark 文件会话改为原生(MARK-01,§14.3,QA-21):视图换成 C14.3 的组件,文本即文件原文,无序列化;BOM、CRLF 照旧;新建、打开、保存、另存、重命名照旧;应用不再依赖 `ely-web-content`
- [ ] C14.5 删去 CEF:`crates/ely-web-content`、`scripts/fetch-cef.sh`、`scripts/build-mark-content.sh`、`apps/ely-mark/web`、打包里的 CEF 辅助应用与许可、CEF 的测试脚本;PRD 与 `agents.md` 写明新路线,ElyMail 正文不用 CEF 与 Electron
- [ ] C14.6 编辑模式与大文件(MARK-02、14,PERF-07):可视、源码、预览按标签切换,切换不改文件,撤销跨模式;超过阈值的文件只开源码并说明;1 MB 文档 2 秒内可编辑,实测记录
- [ ] C14.7 Markdown 与扩展语法(MARK-03、04):CommonMark 与 GFM、脚注、公式、Mermaid、front matter(不进可视,原样在上方);文档旁图片;链接照 M-05(可视 Cmd/Ctrl 单击、预览单击交应用)
- [ ] C14.8 导航(MARK-05):大纲取 markdown-rs 的标题与位置,按标题跳转;文件树、多标签、最近文件照旧
- [ ] C14.9 编辑工具(MARK-06):查找替换(大小写、全词、正则),缩进,列表续写,表格插入与行列操作,代码高亮
- [ ] C14.10 附件(MARK-07):拖放与粘贴图片复制到文档旁 `assets/`,在插入点写相对链接
- [ ] C14.11 外部修改(MARK-08,§14.4,QA-22):干净即重载并保持位置,有改动即比较,合并结果为一步撤销;改名、删除、读错照旧
- [ ] C14.12 书写视图(MARK-09):专注模式、打字机滚动、正文宽度、字体、字号,存 `look.json`,不改 Markdown
- [ ] C14.13 搜索(MARK-10):本文件与文件夹,结果跳到该行该处
- [ ] C14.14 输出(MARK-11):自包含 HTML、带资源文件夹的 HTML、纯文本(markdown-rs)、PDF(MuPDF Story,经 `ely-pdf-worker`)、打印、富文本复制;缺图、错公式、画不出的图随导出提示
- [ ] C14.15 会话恢复(MARK-12):标签、未保存内容、模式、插入点、滚动、视图设置
- [ ] C14.16 Git 配合与验收(MARK-13):状态栏 Git 状态与打开 ElyTree 照旧;三端构建,ElyMark 冒烟;逐条核对 MARK-01 至 14、QA-21、QA-22、PERF-07
## C15 ElyAgent(§15)