SkyJourney
f5a46f79f1
- 新增可复用的 markdown-echarts 工作区，支持安全的 YAML 围栏、默认值、语义校验、错误占位和 SVG 渲染 - 将 ECharts 接入统一 Markdown、快速预览、精确预览与 PDF 链路，并复用 Mermaid 的不可跨页和超高图单页适配策略 - 默认示例加入 ECharts，增加源文本折叠、顶部文档状态、页码输入跳转与滚动同步 - 快速预览改用外层容器滚动，使滚动条与精确预览统一贴在预览区域右侧，并兼容显示缩放 - 完善 Docker 工作区复制、可配置 Compose 镜像、测试覆盖和进度文档
AIO 容器部署
本目录提供单容器部署：Nginx 在 8080 端口提供前端，并将
/api/ 代理到同容器内的 Fastify；Fastify 复用固定版本
Playwright Chromium 生成 PDF。
启动
要求已经安装并启动 Docker Desktop。
docker compose -f deploy\compose.yaml up --build -d
docker compose -f deploy\compose.yaml ps
打开：
http://localhost:8080
健康检查：
Invoke-RestMethod -Uri 'http://localhost:8080/api/health'
查看日志和停止：
docker compose -f deploy\compose.yaml logs -f
docker compose -f deploy\compose.yaml down
构建发布标签
本地验证完成后，可以为镜像增加发布标签：
docker tag md-to-pdf:local yixiong/md-to-pdf:v0.1.0
该命令只创建本地标签，不会自动推送到镜像仓库。
主题挂载
Compose 默认将项目的 .local/themes 只读挂载到容器中的
/app/.local/themes。可以通过环境变量指定其他目录：
$env:MD_TO_PDF_THEME_DIR = 'D:\md-to-pdf-themes'
docker compose -f deploy\compose.yaml up -d
目录下每套主题都应包含 theme.json。主题规范详见
docs/THEMES.md。
本机通过导入工具生成的 Typora 主题不会复制进镜像；只有显式挂载后， 容器才会读取这些本机文件。
运行参数
| 环境变量 | 默认值 | 说明 |
|---|---|---|
MD_TO_PDF_PORT |
8080 |
宿主机监听端口 |
MD_TO_PDF_THEME_DIR |
../.local/themes |
宿主机主题目录 |
PDF_CONCURRENCY |
1 |
同时执行的 PDF 任务数 |
PDF_MAX_QUEUE |
4 |
等待队列上限 |
PDF_TIMEOUT_MS |
120000 |
单次 PDF 生成超时 |
增加 PDF 并发会显著增加 Chromium 内存占用。单机部署建议先保持默认值， 再根据文档复杂度和可用内存调整。
容器为 Chromium 提供 1 GiB 共享内存，并以非 root pwuser 运行。
构建阶段使用项目锁定的 Playwright 1.62.0 安装精确匹配的 Chromium
及系统依赖，不依赖版本可能滞后的预制浏览器镜像标签。