[xiaoyumuxi]

关联

桌面端 Markdown 预览改用 web view（1lck/Lithe-IDEA#1903）。web 页面点链接、加载图片时，要由 Core 决定目标是什么、能不能读，页面自己不能碰工作区文件。#32 已合入内嵌 SVG 的过滤；这个提交当时在 #32 的分支上但没赶上合并，这里基于最新 main 单独提交。

改动

• 新增命令 markdown.resolveReference，判定渲染后文档里的一个链接目标或图片 src 指向什么。请求带 documentPath、可选的 workspaceRoot、原样的 reference 和 purpose（link 是点击，resource 是页面要加载的图片）。返回按 kind 区分：
  • external：http、https、mailto 链接，交给系统浏览器或邮件客户端。
  • remote：带主机名的 http、https 图片，由前端按自己的代理策略下载。
  • anchor：文档内的 #锚点，去掉 # 并做百分号解码。
  • file：本机文件；图片还带 mime。
  • none：不跟随、不加载。
• 判定规则：
  • 文档在 workspaceRoot 里时范围是工作区，否则是文档所在目录。/path 从范围根开始，其他相对路径从文档目录开始；去掉查询串和片段，百分号解码，按字面解析 . 和 ..。
  • 链接的 file 是按字面算出的路径，不要求文件存在。
  • 图片的 file 必须按字面和解析符号链接后都在范围内，是已存在的普通文件，扩展名是 apng、avif、bmp、gif、ico、jpeg、jpg、png、svg、webp 之一；返回规范路径。不满足就是 none。
  • file:、data:、javascript:、单字母的 Windows 盘符等其他 scheme 一律 none；//host 补成 https:。
• 实现放在 rust/crates/project/src/markdown_reference.rs，分发器、命令表和请求追踪同步登记。
• 契约 rust/contracts/rust-core-api.md：命令表新增一行；“Markdown rendering”一节写明请求、返回的 kind 和判定规则，并把已过时的“Windows 异步请求”描述改成对所有前端成立的说法。顺手修正命令表里 markdown.render 的语法错误（Render → Renders）。

验证

• cargo test -p lithe-project --lib markdown：12 个测试通过，含 links_follow_addresses_anchors_and_files、resources_are_images_inside_the_workspace、resources_do_not_leave_the_workspace_through_a_link、a_document_outside_the_workspace_reaches_only_its_folder。
• cargo test -p lithe-core --lib project：72 个测试通过，含分发器对新命令的往返测试。
• cargo fmt --all -- --check、cargo clippy -p lithe-project -p lithe-core --all-targets -- -D warnings：通过。
• 桌面端用这个提交跑完 ./internal/webpreview 和 ./internal/workbench 的全部测试。

不涉及插件契约、能力版本或插件函数协议，所以不需要更新协议记录。