Skip to content

feat(markdown): macOS 离线 PlantUML 预览与被动 SVG 安全边界 - #1637

Merged
xiaoyumuxi merged 1 commit into
previewfrom
codex/macos-markdown-plantuml
Nov 1, 2026
Merged

feat(markdown): macOS 离线 PlantUML 预览与被动 SVG 安全边界#1637
xiaoyumuxi merged 1 commit into
previewfrom
codex/macos-markdown-plantuml

Conversation

@xiaoyumuxi

@xiaoyumuxi xiaoyumuxi commented Nov 1, 2026

Copy link
Copy Markdown
Collaborator

功能

Refs #706。按用户要求只做 macOS，不修改 Windows 产品；基础数学/化学增强在独立 PR #1636，本 PR 不夹带它。

  • plantuml fenced block 现在可以离线显示时序图与类图。复用官方 MIT @plantuml/core 1.2026.9 和内置 Smetana 布局，不要求安装 Java，也不接在线服务器。
  • 约 3.36MB 上游引擎保持原始字节，固定 npm SHA-512、脚本 SHA-256 和来源 revision，保留 MIT/上游声明。没有打包 Graphviz/Viz.js、WASM、编码器、可选标准库、主题或 emoji。
  • 通过原生桥接运行独立非持久 WebView：固定资源协议只提供三个已打包文件，CSP 拒绝网络、frame 和外部图片，上游文件/标准库加载钩子拒绝请求。预览页面只接收被动 SVG 图片 URL，不把生成 SVG 赋给正文 innerHTML；图片支持原有点击放大。
  • 串行渲染限制内存；源码 256KiB、SVG 4MiB、尺寸 4096px、原生八秒期限。完成、失败、取消、替换和关闭预览都停止加载/断开委托/释放请求，迟到回调和旧文档结果被拒绝。
  • 加载失败、资源拒绝等情况保留源码，显示共享中英 i18n 提示；语法无效时也可能由上游输出诊断图片，保持上游语义。
  • 普通图片在图表异步执行前即安装点击放大事件，不因等待图表而不可用；保留 HTML 徽章同行/居中修复。
  • 更新 WebView 摄像头/麦克风默认拒绝覆盖、资源清单及校验/跨工作树拒绝测试、独立工作树编译说明、中文 Agent Note 和能力矩阵。

验证

  • ./.agents/skills/write-stable-tests/scripts/test-stability-macos.sh --stall-timeout-seconds 300 --suite-timeout-seconds 900 --report .artifacts/test-stability/markdown-plantuml-swift.json -- --build-system native --filter 'MarkdownPlantUMLTests|markdownPreviewResourcesAreBundledAndOffline|MarkdownPreviewHTMLTests|WebMediaCaptureCoverageTests'：7 项通过，包括深浅主题的时序/类图与资源哈希不变、取消/超大输入拒绝、正文被动图片、include 拒绝后的源码和本地化回退、旧文档结果隔离、HTML 徽章回归和 WebView 权限覆盖。
  • 最慢原生测试为深浅主题共四次引擎渲染，3.063 秒，出现 1 秒软警告但未超过 15 秒硬预算；无挂起和残留 Lithe 进程。
  • node --test --test-timeout=60000 scripts/resources/test-reuse-worktree-resources.mjs：29 项通过，新增引擎 SHA-256 和资源拒绝验证；有 JUnit 输出。
  • node --test --test-timeout=60000 scripts/macos/test/test-markdown-preview.mjs：3 项目录状态测试通过。
  • node --test --test-timeout=60000 scripts/i18n/test-i18n.mjs：35 项通过。
  • i18n 检查/生成一致性、Services 边界、bundle 不可变、测试稳定性、Agent Notes、功能矩阵检查通过。

边界与限制

  • 无外部 include、可选主题/标准库；部分复杂图类型由本版本上游的 Smetana 能力决定，不承诺覆盖全部 PlantUML 方言。
  • WebView 独立上下文不等于独立 OS 进程，WKProcessPool 在新 WebKit 不再隔离进程。原生期限负责释放宿主请求和 WebView，不宣称可以强杀 WebKit 内任意死循环；没有借隐藏 iframe 冒充 Worker 隔离。
  • 运行时只读 Git 打包资源，无新增持久缓存/下载，不改变签名与 Sparkle delta 字节；资源哈希在真实渲染前后比较。
  • 本机 Xcode 27.2 SDK 与 Swift 6.3.3 的 SwiftTerm manifest 参数不兼容，实际运行验证为系统 Swift 6.4.2 + native build system。标准 Swift 6.3.3 编译交由 CI，不能把本机通过冒充标准工具链通过。
  • 原生回归不替代完整应用手工视觉验收，矩阵整体保持 pending。

@ghfind-review ghfind-review Bot added the review: high ghfind author score; see https://ghfind.com label Nov 1, 2026
@xiaoyumuxi
xiaoyumuxi marked this pull request as ready for review November 1, 2026 11:25
@xiaoyumuxi
xiaoyumuxi merged commit 8a58999 into preview Nov 1, 2026
21 of 26 checks passed
1lck added a commit that referenced this pull request Nov 1, 2026
@lin-coco @xiaoyumuxi
@ZJUSCODE ZJUSCODE @claude @icefery @1lck @FxRayHughes
feat(workspace): 支持目录索引排除并统一 Git 设置入口 (#1597)
50b4ebe 
* feat(workspace): enforce directory indexing exclusions (#958)

* fix(workspace): honor indexing ownership across Windows roots

Fix attached-root LSP gates and reevaluate documents when workspace roots change. Carry request-local ownership through inventory, search, replacement and incremental index caches; preserve scoped search when unrelated roots are unavailable.

Disable unsupported remote indexing settings, localize settings failures, normalize both Java exclusion test expectations, and register regressions in Windows CI.

* fix(workspace): 修复索引租约生命周期与跨窗口同步

* docs(workspace): 记录复审修复与 macOS 原生验收证据

* fix(lsp): 保留 Windows 冷启动索引策略的原生路径身份

* fix(macos): 保持打开身份并修复索引回归验证

将会话打开代次与资源投影代次分开，保留立即 Run 的等待意图及同根重开隔离。
避免无待确认 Java 决策时重复发布空值，并使设置与混合规则夹具等待真实生命周期边界。
为 Git 观察 CI 补齐逐项报告，按原始输出活性检测 Swift 停顿，保留既有断言与预算。
记录通过的 126 条受影响 Swift 及 116 条身份消费者验证。

* feat(plugins): 独立编辑器高亮与动作 API，复用普通函数调用 (#1617)

* feat(plugins): 声明式语法高亮与运行标记（API-25/27/29）

- languages 2：插件语言可带 Monarch 语法和编辑器配置，Core 校验，纯语法插件免重启
- runMarkers 1：backend 2 插件函数回答可运行行，编辑器画运行按钮，点击经 commands/didRun 带 runMarker
- 契约、fixture、Agent Note、计划文档与功能矩阵同步更新；Windows 暂不支持

Refs #570

* feat(plugins): 独立编辑器高亮与动作扩展

- languages 2 提供静态语法和独立编辑配置，插件正则在可终止 worker 中运行\n- editor/registerActions 运行期注册文本动作，点击复用普通函数调用，不扩张 Run/LSP/Build/Debug 领域契约\n- 补齐文档版本、动作租约、取消与清理、独立工具后端启用及安全模式边界\n- 更新 Skill、审查规则与决策笔记，总结 #1581/#1558 的架构边界\n- 同步契约、fixtures、中英词条、功能矩阵与资源复用说明\n\nRefs #570\nReworks #1617

* docs(plugins): 明确 API-25 JSON 贡献的支持范围与局限

区分包内静态 JSON 贡献与尚未开放的运行期 Provider 注册、替换和释放；说明独立语义 Provider、新引擎适配及平台、SDK 和验收限制。同步计划、架构笔记、正式契约与功能矩阵。

* fix(plugins): 修复编辑器扩展审查中的生命周期与高亮问题

动作刷新立即确认调度并隔离非致命失败，整批收集共享八秒期限并在撤销时清理计时任务。

Core 保留校验后的 grammar 原始文本，worker 按源顺序解析 cases 并显式默认 root；配置-only 别名借用既有 tokenizer，重映射 token 语言身份以保留独立注释配置。

模块状态观察弱引用 runtime，补齐有界、确定性的 Swift/Rust/WebKit 回归与测试文档模型清理，同步契约、Agent Note 和功能矩阵。

验证：57 项 Swift、1459 项 Rust、39 项编辑器和 119 项真实 WebKit 测试通过；静态边界、i18n、只读 bundle、资源复用与矩阵门禁通过。未执行 Windows 原生构建或打包安装验收。

Refs #1617, #570

* fix(indexing): preserve scan ownership and snapshot publication

Retry current-workspace indexing cancellation without retiring another owner, publish only the latest complete inventory, and restore saved sessions once per workspace. Apply scoped search before caps and cursors, preserve dotted provider configuration siblings, and normalize Windows mark identity and localized read failures.

* docs(indexing): record final macOS native acceptance evidence

* fix(search): localize indexing failures and synchronize deferred Run tests

* test(macos): synchronize every initial Run inventory release

* fix: preserve excluded history and validate indexing marks

* fix(macos): 修复分支列表悬停长分支名时触控板无法滚动 (#1621) (#1625)

* fix(macos): 修复分支列表悬停长分支名时触控板无法滚动 (#1621)

触控板手势绑定在开始时的窗口上。悬停扩展面板收到首个滚动事件就关闭，
导致同一手势的后续事件全部丢失。手势期间改为隐藏面板并继续转发给列表，
手势结束后再关闭。鼠标滚轮行为不变。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(matrix): 记录分支列表触控板滚动的验证要求 (#1621)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(macos): 手指停顿时保留滚动手势，点击立即回收隐藏面板 (#1621)

手势进行中的回收超时从 1 秒放宽到 10 秒，避免停顿后继续滚动时丢失手势。
隐藏面板收到点击时立即回收，并在功能矩阵补充对应验收步骤。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(macos): remove push dialog file request ordering race

---------

Co-authored-by: ZJUSCODE <ZengJun326@outlook.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: Yao Jingxi <23722032@bjtu.edu.cn>

* fix(macos): forward hidden branch expansion clicks and clean up on close (#1629)

* fix(workspace): preserve directory roles and indexing watcher ownership

* test(windows): use canonical roots in indexing lifecycle fixtures

* test(windows): identify the owned Run fixture descendant explicitly

* feat(macos): 状态栏内存只显示图标，帧率去掉图标并收紧间距 (#1630)

- 内存指示器只保留内存芯片图标，不再常驻显示“总计 / Lithe”数值；
  悬停提示仍给出总计、Lithe、LSP、服务内存，点击打开原有的托管内存详情，
  VoiceOver 读出“托管内存”和当前总计。
- 帧率只显示“60 FPS”文字，去掉速度表图标。
- 新增 18pt 的状态栏紧凑图标按钮样式，只读锁和内存图标改用它，
  不再沿用 28pt 工具窗口按钮留出的大块空白。
- 删除不再使用的 "Total %@" 词条并重新生成本地化资源。
- 更新 memory-monitor 功能矩阵的 macOS 证据与验收说明。

* fix(macos): 虚拟化后台服务退出列表并补充滚动性能规范 (#1627) (#1633)

* fix(macos): virtualize background service exit selection (#1627)

* fix(macos): keep background service accessibility selection live

* fix(agent): 修复 Codex 会话启动与历史漏查，新增供应商筛选 (#1632)

* fix(agent): restore Codex history and add provider filtering

* fix(agent): honor manual archive collapse under provider filters

* feat(macos): 彩色 LSP 状态菜单与普通日志标签页 (#1631)

* feat(macos): 增加彩色 LSP 状态菜单与普通日志标签页

* fix(macos): LSP 入口常驻并仅由启用插件注入服务器

* fix(lsp): 等待重启关闭完成并保留局部索引重置状态

* fix(markdown): preserve inline HTML image layout and alignment (#1623) (#1635)

* feat(markdown): render PlantUML diagrams offline on macOS (#1637)

* feat(markdown): add offline chemistry formulas and subscripts on macOS (#1636)

* feat(macos): 终端标签任意拖拽分屏并保留 PTY (#1638)

* feat(macos): 终端标签任意拖拽分屏并保留 PTY

- 终端标签改用 AppKit 拖拽会话与私有 pasteboard，避免 Monaco 接收文本拖放
- 工具窗终端可拖入编辑器边缘或空编辑器，编辑器终端可拖回工具窗
- 抽出 EditorGroupLayout.splitting 复用分屏几何，补充模型、拖拽与 PTY 测试

Refs #1622

* fix(macos): preserve terminal drop order and deduplicate split previews

- Limit the native tool-window drop overlay to the canvas so tab-strip
  before/after insertion remains available for terminals dragged from editors.
- Publish editor-group preview targets only when they change, including
  repeated clearing and drag lifecycle cleanup.
- Add focused native overlay geometry and preview publication regressions.
- Update the docking Agent Note and terminal capability matrix evidence and
  verification steps without claiming unperformed runtime verification.

Validation: six focused Swift tests passed on Swift 6.3.3 with macOS 26.5 SDK;
runtime bundle, architecture, i18n, Agent Notes and matrix static gates passed.
The exact PR-based push tree also passed the static gates.

Refs #1638

---------

Co-authored-by: Yao Jingxi <23722032@bjtu.edu.cn>

* fix: align project JDK, isolate application sessions, and improve search (#1642) [skip ci]

Use the selected project JDK in JDT configuration on both platforms. Give Windows applications independent cancellable sessions across Run, IDE API and Debug, with isolated failure output. Avoid blocking cold file/text search on content index warmup and improve macOS search sizing and result layout. Include shared fixtures, regression coverage and architecture notes.

* feat(plugins): 插件注入的工具链框架与 macOS 只读环境设置页 (#1581)

* feat(plugins): 插件注入的工具链框架与 macOS 只读环境设置页 (#1581)

按 #1581 评审后的改写计划重做：宿主不认识任何工具，工具定义、版本管理器
（提供方）全部由插件声明；Core 只做校验和四层解析，不解析 mise 等管理器
的私有格式。

- 契约：新增 toolDefinitions 1、toolchainProviders 1，executableResolution
  增加 v2（只用于工具定义候选）；同步 schema、README、toolchains.md、
  fixture 和 rust-core-api.md；proposals/toolchains/ 放完整方案草案
- Rust Core：新领域模块 rust/lithe-core/src/toolchain/（定义注册表、
  提供方答复校验、目录固定、固定/项目文件/全局/自动四层解析、版本匹配、
  扫描计划）和六个 toolchains.* 命令，全部只处理宿主快照，不启动进程、
  不扫描、不写文件
- macOS：设置 › 构建新增「运行环境」「环境来源」两页，内容来自已启用
  插件的声明和磁盘上的真实文件；未实现的添加、切换、保存、查询入口不显示
- 登录 Shell：新增只读 inspect，来源页显示读取状态、变量数、耗时和
  PATH 各目录来源；重新读取不改变本进程 PATH
- Debug 预览入口 --toolchain-settings-demo / --toolchain-sources-demo
- Agent Note、设置层级 Note、功能矩阵和中英词条同步

Refs #1514

* feat(plugins): 工具链安装同时支持声明式扫描与提供方查询 (#1581)

工具的已安装版本有两条途径，可以只用其一或同时使用：
- 声明式扫描：工具定义的 discovery/homeLayouts/version 由宿主展开，不运行
  插件代码；可用的根和通配写法固定，新的安装形态交给提供方回答。
- 提供方查询：toolchainProviders 通过 toolchains/query 返回安装和要求。

- watchFiles 改为可选：不声明的提供方只报告安装，答复里带版本要求会被拒绝；
  定义工具的插件也可以作为自己工具的提供方。
- 自动层把两条途径合成一个候选集合：同一规范化目录只算一次，来源标注优先
  提供方、其次 host:system，只用于显示；不同目录同版本仍报冲突。
- discoveryPlan 对每个工具同时列出 scans 和 providers。
- macOS 环境来源页对只报告安装的提供方显示「只报告已安装的版本」。

同时修复评审的两个 P2：
- 符号链接安装在解码时已规范化，解析时却按原始路径查证据而误判 unsafePath；
  现在文件证据同时证明其规范化目标，证据互相矛盾时拒绝快照。
- 环境变量候选声明的 path 布局被忽略、总取第一个布局；现在按声明的布局选择。

* feat(plugins): macOS 设置页接入声明式扫描与版本探测 (#1581)

- Core 新增 toolchains.candidates：列出一个工具的登录 Shell home 变量、扫描到的安装、跳过原因和自动层的选择；和 resolve 共用事实校验，宿主分两轮调用完成版本探测，工作区内的目录在探测前拒绝
- toolchains.discoveryPlan 增加 pathPrepend 模板和各平台适用的 home 变量
- 新增 MacToolchainDiscovery：按插件声明展开扫描，只探测 Core 返回的可执行文件；扫描根、条目、文件事实、安装数、探测数、并发和总时长都有上限，超出时给出诊断
- 运行环境页：全局卡片显示 home 变量和探测到的版本，PATH 命令标为版本未验证；自动卡片列出真实安装、选中项、同版本冲突和跳过数，路径显示扫描到的条目名
- 加载器只把登记在官方目录、并经内置或插件市场安装的插件标为官方来源
- 预览改用完整的样例清单，扫描本机真实安装
- 更新契约 toolchains.md、rust-core-api.md、Agent Note、功能矩阵和中英词条

* test(macos): 设置页声明顺序与构建分组保持一致 (#1581)

运行环境、环境来源两页插在项目页和运行配置之间，使 SettingsCategory
声明顺序（搜索结果顺序）与侧栏构建分组顺序不一致，
settingsCategoryPlacesProjectAndRunBetweenKeymapAndTerminal 在 CI 失败。
把两页的 case 移到项目页之前，测试改为断言 Keymap 与 Terminal 之间
恰好是构建分组，且分组以项目页、运行配置结尾。

* feat(plugins): macOS 设置页接入工具链提供方查询 (#1581)

- Core: lsp.toolchainRequest 与 litheToolchains 协商，原样回传回复交 toolchains.decodeReply
- Core: candidates 接受 providerInstallations 并保留提供方归属
- 修复别名链接 home 只有链接路径事实时被判 unsafePath（机器人 P2）
- macOS: 启动或复用插件后端查询，全局+逐目录独立 operationID/代次，超时与取消
- macOS: watchFiles 与回复 watch 变化整份重查，短时间事件合并
- 设置页显示提供方要求、版本与查询结果；文案走 shared/i18n
- 更新契约、功能矩阵与 Agent Note

* feat(plugins): 运行环境页每行生效来源改由 Core toolchains.resolve 决定 (#1581)

- 每个查询过的目录、每个工具调用一次 toolchains.resolve，摘要、徽标和
  “第几层生效”都读它的结果，视图不再自己按固定 → 项目 → 全局 → 自动排序
- 解析与提供方查询共用同一份文件事实；同一轮查询的提供方共享代次，
  每次查询仍有独立 operationID
- 固定值交给 Core 校验：只有固定值的目录只解析它固定的工具（每次加载
  最多 256 个），固定的 home 经 toolchains.candidates 检查后探测，
  不会出现在自动检测列表；不可用时终止失败，不回落
- 未安装的项目要求记为 unmet 并退到下一层；Core 无法给出结果时给出诊断
- 已知限制写入提案 Note 并建 Issue：冲突选择与写入 #1639、
  项目 wrapper #1640、PATH 命令 commandHomes #1641
- 新增文案走 shared/i18n 并重新生成

* fix(plugins): 加载途中 context 变化的回复不再显示项目要求 (#1581)

- 同一目录一轮查询里，context 与本轮不一致的提供方回复不会进入 toolchains.resolve，
  但它的项目要求仍被写进页面的 requirements，导致页面显示的要求和 Core 的生效结果来自
  两个不同的 context；现在只记录进入本轮的回复的项目要求，全局要求和安装列表不变。
- 新增 aReplyUnderAChangedContextIsLeftOutOfItsDirectory 测试：两个提供方在加载途中拿到
  不同代次的 context，断言只有进入本轮的提供方要求被显示、Core 用它解析；修复前该测试失败。
- 测试夹具 providerSource 支持声明多个提供方，原有用例行为不变。
- Agent Note 更正“每个路径只读一次”的说法：查询阶段和解析阶段分两次读取事实，单次解析
  内部一致；并补充 context 变化时回复不进本轮的取舍。

* feat(plugins): 提供方超时或不可用交给 Core 记为 providerUnavailable，工具行区分未响应与不可用 (#1581)

- Core 新增 toolchains.failureReply：查询超过 15 秒没有回复，或后端起不来、断开、没有协商这个提供方时，宿主用它生成标准错误回复（plugin.toolchain.timeout / plugin.toolchain.providerUnavailable），再交给 decodeReply，错误码映射只在 Core 维护一份
- toolchains.resolve 只为问过这个工具的查询记 providerUnavailable，并带上 cause 区分超时和不可用；修复一个提供方失败时把它没被问到的工具也记为缺失的问题
- macOS 接线层把 Core 的 requestTimeout 转成 MacToolchainDiscovery.QueryTimeout；取消不生成回复
- 这类回复照常进入目录轮次，下一层来源继续决定；提供方状态显示“15 秒内未响应”或后端原因
- 运行环境页工具行在结果旁写出“mise 未响应 / mise 不可用”，第 2 步在版本文件存在但提供方没回答时显示同样原因，不再显示“版本未查询”；固定值失效时不显示
- 新增中英词条三条；契约 toolchains.md、rust-core-api.md、Agent Note 与功能矩阵同步更新
- 测试：Rust 覆盖两种原因的回复往返、下一层决定、只记被问到的工具、非法输入拒绝；Swift 覆盖超时与后端停止两种提供方并存时的结果与状态

---------

Co-authored-by: Yao Jingxi <23722032@bjtu.edu.cn>
Co-authored-by: FxRayHughes <25192142+FxRayHughes@users.noreply.github.com>

---------

Co-authored-by: Xiaoyumuxi <23722032@bjtu.edu.cn>
Co-authored-by: ZJUSCODE <152275506+ZJUSCODE@users.noreply.github.com>
Co-authored-by: ZJUSCODE <ZengJun326@outlook.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: 十二翼堕落天使 <61737634+icefery@users.noreply.github.com>
Co-authored-by: Lichenkang <2188718831@qq.com>
Co-authored-by: 枫溪 <bushuaichen@yeah.net>
Co-authored-by: FxRayHughes <25192142+FxRayHughes@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@1lck 1lck Awaiting requested review from 1lck 1lck is a code owner
@Mucheen Mucheen Awaiting requested review from Mucheen Mucheen is a code owner

Assignees

No one assigned

Labels

review: high ghfind author score; see https://ghfind.com

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@xiaoyumuxi