SkyJourney
925b0d1485
新增能力：Web 与 Desktop 支持新建和保存 Markdown；桌面端注册 .md/.markdown 打开程序，支持单实例文件转交、自定义主题目录以及窗口位置、尺寸和最大化状态的延迟原子持久化与屏幕越界修正。 界面与兼容性：保留打开 Markdown 为独立主操作，将新建、保存和主题目录收纳到更多菜单；Web 移除本地素材目录入口并明确默认不支持本地素材；新文档默认使用一级标题或首行合法化生成文件名，可不保存直接导出 PDF。 渲染修复：图片、Mermaid 和 ECharts 按文档顺序串行执行媒体分页回填，每个媒体元素至多重排一次；图片以限宽后的高度作为缩放基准，只缩放媒体主体并保持标题尺寸；ECharts 冻结为 SVG 图片后参与统一分页。 示例与文档：默认示例仅保留一张网络图片，增加有效 Base64 横图、竖图、边界图片及多尺寸 Mermaid/ECharts；更新根 README、Desktop README、部署文档、四个 packages README、PROGRESS 和 AGENTS 发布规范；登记 v0.4.6 超链接导航问题。 部署与验证：构建并运行 yixiong/md-to-pdf:v0.4.5 正式镜像，Compose 健康且 PDF 冒烟无 Mermaid/ECharts 错误；生成 NSIS 安装包和免安装 ZIP，本机已升级到 NSIS v0.4.5 并清理旧 Squirrel 安装；202 项测试、类型检查、生产构建和 git diff --check 全部通过。 发布产物：Setup.exe SHA-256 9CBD6362E15AA745185805E753D5A7749434E0E142E6CE0F66463E6A19468F1D；ZIP SHA-256 97B2D44E72F626A3396E5AB5B330FFB7F9BECAF945A1707808C876940A82E850；当前 Windows 产物未配置代码签名。
47 lines
1.3 KiB
Markdown
47 lines
1.3 KiB
Markdown
# @md-to-pdf/application
|
|
|
|
Web Server 与 Electron Desktop 共用的应用服务层，组合
|
|
`@md-to-pdf/core` 和 `@md-to-pdf/renderer`，统一处理 Markdown 渲染、
|
|
主题发现、主题资源和图片资源。Fastify 与 Electron IPC 只负责传输和
|
|
平台能力适配。
|
|
|
|
## 目录结构
|
|
|
|
```text
|
|
src/
|
|
application-service.ts 渲染、主题和资源用例入口
|
|
image-resources.ts 本地、Base64 与受限远程图片处理
|
|
theme-registry.ts 内置及自定义主题扫描、校验与缓存
|
|
index.ts 公共导出入口
|
|
tests/
|
|
application-service.test.ts
|
|
image-resources.test.ts
|
|
```
|
|
|
|
## 使用
|
|
|
|
```ts
|
|
import { createApplicationService } from "@md-to-pdf/application";
|
|
|
|
const service = createApplicationService({
|
|
bundledRoot,
|
|
localRoot
|
|
});
|
|
|
|
const themes = await service.listThemes();
|
|
const document = await service.render(request);
|
|
```
|
|
|
|
Web 端通过 `apps/server` 的 HTTP API 调用；桌面端在主进程中创建同一
|
|
服务，并通过受限 IPC 暴露给渲染进程。Web 默认不接收本地素材目录，
|
|
Desktop 才会以 Markdown 所在目录为边界解析相对资源。
|
|
|
|
## 开发与验证
|
|
|
|
```powershell
|
|
npm run dev -w @md-to-pdf/application
|
|
npm run test -w @md-to-pdf/application
|
|
npm run typecheck -w @md-to-pdf/application
|
|
npm run build -w @md-to-pdf/application
|
|
```
|