release: 发布 v0.5.0

新增共享 Preview Engine，统一 Web 连续预览、快速分页、Playwright PDF 与 Electron PDF；实现稳定前缀复用和修改位置后的增量分页，保留媒体块按文档顺序串行回填与单次重排。

完善跨端链接与桌面文档工作流：Web 受控处理锚点和 HTTP/HTTPS 外链；Desktop 支持本地路径、file URI、系统协议、多窗口、同文件单例、Markdown 当前或新窗口打开，以及聚焦时外部文件变化提示。

统一四套内置主题名称并默认使用 Typora Github；修复连续预览双滚动条、ECharts 尺寸、PDF 本地链接、围栏代码块 Typora DOM 与重复行内样式；桌面发行链强制完整重建内嵌 Web，避免安装包携带陈旧资源。

发布 Web/Compose 与 Windows NSIS/ZIP：镜像 yixiong/md-to-pdf:v0.5.0 已健康部署；NSIS SHA-256 为 60992D1FDCA513F46346C78478537EB4159D8C0E76B41ECF3CDC25BE77707D92，ZIP SHA-256 为 D74F82293FB67126E583546CBA894569EFC9A0B1B6343FAC648CCC95F1D188D8，本机安装版已升级至 v0.5.0。

验证：全项目 238 项测试通过，类型检查、生产构建和 git diff --check 通过；Web 快速/连续/精确预览、Compose、Desktop 多窗口、窗口状态、文件关联、链接与代码块均完成真实环境验收。

docs/PROGRESS.md

@@ -49,6 +49,12 @@ Web/Compose 发布仍保持 `v0.4.1`。
 本地素材目录。图片、Mermaid 与 ECharts 的分页算法统一为按文档顺序
 串行计算的媒体块回填，每个媒体元素至多重排一次，标题保持原尺寸。
 
+`v0.5.0` 完成渲染架构和桌面文档工作流升级：分页与连续预览抽取为共享
+`packages/preview-engine`，快速预览支持从修改位置复用稳定前缀；Web
+增加连续预览和受控外链，Desktop 支持多窗口、同文件单例、本地链接及
+聚焦时外部文件变化提示。四套主题统一命名，并修复围栏代码块的 Typora
+DOM 兼容和桌面发行包复用陈旧 Web 产物的问题。
+
 ## 2. 已完成
 
 ### 2.1 项目骨架
@@ -470,6 +476,37 @@ Web/Compose 发布仍保持 `v0.4.1`。
 - 根 README、Desktop README、四个工作区包 README、进度文档和发布
   规范随版本同步更新。
 
+### 3.19 v0.5.0 共享预览引擎与桌面多窗口
+
+- 新增 `packages/preview-engine`，从 `apps/web` 抽取 Paged.js 运行时、
+  Mermaid、ECharts、图片尺寸适配、媒体回填、跨页表格和共享页面 CSS。
+- Web 快速预览、服务端 Playwright PDF 与 Electron PDF 直接使用同一个
+  Preview Engine；Markdown 解析仍由 `packages/renderer` 的 markdown-it
+  管线负责，应用服务继续统一主题与图片资源。
+- 新增“连续”预览模式，不创建纸张和分页节点，适合高频编辑；快速预览
+  保留分页反馈，精确预览与最终 PDF 继续作为权威结果。
+- 增量分页根据源块稳定身份识别最早修改位置，复用此前稳定分页前缀，并
+  串行重算受影响后缀；最终 PDF 不依赖客户端缓存。
+- Web 只处理当前文档锚点和 HTTP/HTTPS 外链，外链使用浏览器新窗口；
+  本地路径及不支持协议不会替换预览 iframe。
+- Desktop 支持 HTTP/HTTPS、系统协议、相对或绝对本地路径及 `file:`
+  URI；Markdown 链接提示在当前窗口或新窗口打开。
+- Desktop 改为多窗口，并按规范化文件路径保持同一文件单例；窗口聚焦时
+  比较磁盘修改时间，检测到外部变化后提示是否重新加载。
+- 主窗口关闭后会选取仍存活的最新窗口作为状态持久化主窗口；窗口位置、
+  尺寸和最大化状态仍按约 2 秒防抖写入并在启动时修正到可见工作区。
+- Core 新增跨端文档链接分类与 PDF 本地链接编码协议；精确 PDF 使用
+  `mdpdf.local.invalid` 暂存本地链接，PDF.js 注释层解码后交给平台。
+- 内置主题名称统一为 Typora Github、Typora Pixyll、Typora whitey 和
+  Typora Clean，默认主题为 Typora Github；删除强制覆盖主题链接样式的
+  `!important`，保留主题自身设计。
+- markdown-it 普通围栏输出 `pre.md-fences` 和可选 `lang`；Preview
+  Engine 仅重置内部语义 `code` 的重复行内盒模型，代码块与行内代码均
+  保持主题预期，Mermaid/ECharts 专用围栏不受影响。
+- 根级 `build:web-runtime` 统一内嵌 Web 的六个工作区构建顺序；Desktop
+  `package` 和 `make` 强制先调用该脚本，防止安装包复制陈旧
+  `apps/web/dist`。
+
 ## 4. 已执行验证
 
 2026-07-28 在当前完整工作区成功执行：
@@ -484,17 +521,44 @@ git diff --check
 结果：
 
 - ECharts 围栏测试：36 项通过；
-- 共享配置测试：9 项通过；
-- 渲染器测试：12 项通过；
-- 应用服务测试：9 项通过；
-- 前端测试：87 项通过；
+- Core 共享协议测试：15 项通过；
+- 渲染器测试：14 项通过；
+- 应用服务测试：11 项通过；
+- Preview Engine 测试：53 项通过；
+- 前端测试：54 项通过；
 - 后端测试：29 项通过；
-- 桌面端测试：20 项通过；
-- 全项目共 202 项测试通过；
+- 桌面端测试：26 项通过；
+- 全项目共 238 项测试通过；
 - 全项目类型检查通过；
 - 生产构建通过；
 - `git diff --check` 通过。
 
+`v0.5.0` 双端与发行验收结果：
+
+- 正式镜像 `yixiong/md-to-pdf:v0.5.0` 内容 ID 为
+  `sha256:13a0955f3629e4e96d7af9d38230ead5ff6b8b70be2b35d5f8da9fdeb1f66474`，
+  大小 640,294,504 字节；Compose 使用该内容 ID 健康运行在
+  `http://localhost:8080`。
+- Web 快速、连续和精确预览完成真实浏览器验证：连续模式只有外层滚动，
+  ECharts 使用完整内容宽度和配置高度；快速预览后缀编辑保留稳定前缀。
+- Web 外链样式、受控新窗口和本地链接禁用通过；精确 PDF 注释层保留
+  HTTP/HTTPS 与锚点，并能将 `.invalid` 地址解码为原始本地路径。
+- Desktop 多窗口、同一文件单例、主窗口关闭后的状态接管、最大化防抖
+  写入和重启恢复通过；本机安装版已升级至 v0.5.0。
+- 围栏代码块在 Typora Github 中显示完整外框且内部不再逐行出现行内
+  代码方框；Web 与最终 Desktop 安装版均由用户确认，ECharts 围栏未受
+  普通代码块兼容样式影响。
+- 正式 NSIS 为 `md-to-pdf-0.5.0-x86_64-Setup.exe`，95,004,759
+  字节，SHA-256 为
+  `60992D1FDCA513F46346C78478537EB4159D8C0E76B41ECF3CDC25BE77707D92`。
+- 正式 ZIP 为 `md-to-pdf-0.5.0-x86_64.zip`，132,485,574 字节，
+  SHA-256 为
+  `D74F82293FB67126E583546CBA894569EFC9A0B1B6343FAC648CCC95F1D188D8`。
+- 安装版内嵌 `paged-preview` Bundle 与本地最新 Web Bundle 的
+  SHA-256 均为
+  `BD29762A2E3CF1A2AAC4DD055D623B42C754DF46A3E773DD99B01CDFDAE36CE5`；
+  `.md`、`.markdown` OpenWithProgids 注册正常。
+
 `v0.4.5` 双端与媒体分页验收结果：
 
 - 正式镜像 `yixiong/md-to-pdf:v0.4.5` 已完成多阶段构建，镜像内容 ID
@@ -740,21 +804,22 @@ ECharts 第二阶段浏览器与 PDF 验证结果：
 ## 5. 当前注意事项
 
 - `output/` 可能包含本地 PDF 验证产物，已被 Git 忽略，不得提交。
-- 已确认分页预览 iframe 内点击超链接会在 iframe 内执行导航，可能将当前
-  预览替换为空白页。该问题不阻塞 `v0.4.5`，计划在 `v0.4.6` 统一处理：
-  区分文档内锚点与外部链接、阻止危险协议，并为外部链接使用受控的新窗口
-  或系统浏览器打开策略。
 - `apps/web/src/App.tsx` 负责分页 iframe 生命周期和父页面消息处理。
 - `apps/web/src/use-markdown-render.ts` 负责 Markdown 防抖请求、取消和
   渲染错误状态。
 - `apps/web/src/use-theme-resources.ts` 负责主题清单、主题 CSS 和请求取消。
-- `apps/web/src/paged-document-runtime.ts` 是快速预览和 PDF 共用的 Mermaid、资源等待和 Paged.js 分页运行时。
 - `apps/web/src/paged-preview-frame.ts` 负责 iframe 消息协议和运行目标选择。
-- `apps/web/src/paged-preview.ts` 负责分页协议、共享文档 CSS、页眉和页码 CSS。
-- `apps/web/src/mermaid-page-fit.ts` 负责超高 Mermaid 的单页等比例适配。
-- `apps/web/src/mermaid-static-image.ts` 负责锁定 Mermaid 盒模型并转换为静态矢量 SVG 图片。
-- `apps/web/src/paged-table-handler.ts` 负责跨页表格表头处理。
+- `packages/preview-engine/src/paged-document-runtime.ts` 是连续预览、
+  快速预览和 PDF 共用的媒体渲染、资源等待和 Paged.js 运行时。
+- `packages/preview-engine/src/continuous-preview.ts` 与
+  `incremental-pagination.ts` 分别负责无分页 DOM 更新和后缀分页缓存。
+- `packages/preview-engine/src/paged-preview.ts` 负责分页协议、共享文档
+  CSS、页眉页码和 Typora 代码围栏结构兼容。
+- Mermaid、ECharts、图片适配、媒体回填及跨页表格实现均位于
+  `packages/preview-engine/src/`，不得在 Web 或 Desktop 复制第二套。
 - `apps/web/src/PrecisePdfPreview.tsx` 和 `pdf-render-queue.ts` 负责 PDF.js 精确预览和 Canvas 生命周期。
+- `apps/web/src/document-link.ts` 与 `pdf-annotation-links.ts` 负责 Web
+  链接动作和精确 PDF 注释层适配。
 - `apps/web/src/PreviewPageControl.tsx` 和 `preview-page.ts` 负责当前页输入、
   页码边界、滚动页识别和快速跳转。
 - `apps/web/src/preview-zoom.ts` 和 `PreviewZoomControl.tsx` 负责预览缩放缓存、边界和控制界面。
@@ -769,15 +834,17 @@ ECharts 第二阶段浏览器与 PDF 验证结果：
 - `apps/server/src/app.ts` 是新增的可测试 Fastify 应用。
 - `packages/application` 负责共享 Markdown 渲染和主题应用服务；
   `apps/server` 与 `apps/desktop` 分别提供 HTTP 和 IPC 适配。
-- `apps/desktop/src/main.ts` 负责 Electron 生命周期、自定义应用协议、
-  应用窗口、IPC 校验和原生 PDF 保存。
+- `apps/desktop/src/desktop-application-controller.ts` 负责 Electron
+  多窗口、同文件单例、文件变化检测和平台链接动作；`main.ts` 负责启动
+  组装、协议和生命周期。
+- `apps/desktop/src/desktop-document-link.ts` 负责本地链接解析和
+  Markdown 目标识别。
 - `apps/desktop/src/electron-pdf-generator.ts` 负责隐藏 PDF 窗口、分页
   调度、网络限制、打印和窗口复用。
 - `apps/desktop/src/app-preload.ts` 与 `pdf-preload.ts` 分别定义应用
   窗口和 PDF 运行窗口的最小 IPC 能力。
-- `.local/themes/typora-*` 仍可作为用户本机副本；v0.4.0 的三套发布版本
-  已复制到 `themes/` 并标记为内置主题。
-- `.local/theme-backups` 中保留 GitHub、Pixyll 和 Whitey 的可恢复备份；Newsprint 和 Night 的当前副本及备份已按用户要求删除。
+- `.local/themes/` 只用于外挂自定义主题；四套发布主题已经内置，无需
+  重复挂载。历史副本保存在 `.local/theme-backups`，均被 Git 忽略。
 - Typora 复制主题按公司内部私有项目决策内置，不面向外部公开或商用；
   未来改变分发范围前必须重新完成许可证审查。
 - 快速预览会受到客户端 Windows 显示缩放、浏览器缩放和设备像素比影响；
@@ -786,20 +853,19 @@ ECharts 第二阶段浏览器与 PDF 验证结果：
   目录读取；远程图片仅保留有界内存缓存。
 - 桌面端已通过进程内共享服务实现离线 Markdown 渲染、主题读取和 PDF
   导出，不依赖 Fastify 或本地 HTTP Server。
-- `v0.4.5` AIO 正式镜像已经通过 Docker Desktop 构建、PDF 冒烟和
+- `v0.5.0` AIO 正式镜像已经通过 Docker Desktop 构建、PDF 冒烟和
   Compose 健康检查，当前 Compose 容器保持运行。
+- Desktop `package` 和 `make` 必须经过 `build:embedded-web`；禁止直接
+  调用 electron-builder 复制未经本轮编译的 `apps/web/dist`。
 
 ## 6. 推荐接手顺序
 
-### 阶段一：v0.4.6 超链接导航
+### 阶段一：v0.5.x 稳定性与性能观测
 
-- 在快速预览 iframe 中统一拦截链接点击，避免外部页面替换分页预览；
-- 文档内 `#anchor` 保持在当前预览中定位，并兼容分页后的标题锚点；
-- `http:`、`https:`、`mailto:` 等允许协议通过受控新窗口或桌面系统
-  浏览器打开；
-- 拒绝 `javascript:`、`file:`、未知协议及未授权本地资源；
-- Web 与 Desktop 共用链接分类规则，各平台只实现打开动作适配；
-- 增加快速预览、精确预览和 Desktop 的链接行为测试。
+- 为增量分页补充超长文档性能基线，记录稳定前缀页数和后缀重算耗时；
+- 覆盖 Windows 100%、125% 和 150% 显示缩放的快速/精确分页差异；
+- 扩展 Desktop 多窗口、文件外部变化和链接打开的真实端到端回归；
+- 持续检查连续预览中媒体宽高、单滚动容器和资源释放。
 
 ### 阶段二：导出配置扩展