前言¶

在 DeepSeek Harness（DSH）里，模型很容易把 Markdown 内容写完整，但落到 PDF 时常见结果是白底黑字、版式随意、公式和图片各管各的。若你希望「内容交给模型，视觉和版式交给工具」，且配色、字体、封面能跟着文档主题走，社区插件 dsh-pdf-atelier（维护者 FelixJiashengFu，GitHub 分类为工作流）就是面向这条路径的：扩展 Markdown 经插件排版后，由本机浏览器打印成完整设计的 PDF。

下面按定位、能力、安装与用法说明，事实均来自插件仓库 README 与 package.json（当前版本 0.1.0，MIT 许可证）。

这是什么¶

dsh-pdf-atelier（PDF 工坊）是 DSH 插件：把带扩展语法的 Markdown 转成版式完整的 PDF。插件根据标题、简介和正文在 13 套设计方向里选主题，负责配色、字体、间距、封面、章节页、目录和页眉；模型主要写内容与调用工具。生成后插件还会读回 PDF，收紧版式并给出评审意见，便于模型改稿再交付。

插件内嵌 @jaxzhou/dsh-mathmatic-symbol 的能力（MIT，作依赖），工具改名后与同名插件同时启用不冲突。

核心功能¶

主题与版式¶

• 主题跟着内容走：化学、数学、古典文学、天文、财报等场景对应不同配色与纹样（例如试剂青、欧几里得三原色、宣纸朱砂、夜航深色、账簿墨绿等）。
• 每份文档有独立封面：封面与章节页矢量插图由标题生成，同文档稳定、不同文档不同；也可传入自有图片。
• 版式按出版习惯：真实页码目录、章节页、带章名页眉、分部页、自动编号图表、图注不跨页；中文排版含中西文留白、全角引号、标点挤压。

工具一览¶

正文语法（节选）¶

除普通 Markdown（表格、代码高亮）外，支持行内/行间公式、chart / figure 代码块、表注行、:::key 等组件（如 note、theorem、stats、timeline 等）。一级标题对应一章并生成章节页。

可用 theme 指定设计方向 id，用 palette 覆盖颜色，用 motif 换插图；对比度不足时插件会自动修正。

生成后的反馈¶

插件读回 PDF，自动消除「只剩几行的尾页」，并把例如「某一章连续 1500 字没有任何图」等评审意见返回模型。

安装与启用¶

插件以当前 DSH 进程权限运行，安装前请自行查看仓库源码与 MIT 许可证。运行环境要求 Node >=22.19.0（见 package.json），且本机需有 Chrome、Edge 或 Chromium（Windows 自带 Edge 即可）；找不到浏览器时工具会直接报错，不会降级成简陋 PDF。

在 DeepSeek Harness 中打开「插件 → 添加插件」，填写：

github:FelixJiashengFu/dsh-pdf-atelier

命令行（桌面版 profile 需先完全退出应用）：

dsh plugin --profile desktop add github:FelixJiashengFu/dsh-pdf-atelier

浏览器装在非默认路径时，在 profile 的 cordis.patch.yml 中配置：

- id: pdf-atelier
  config:
    chromePath: 'C:\path\to\chrome.exe'
    outputDir: atelier-assets   # 公式和图形工具的产物目录

典型用法¶

装上插件后，对模型说明「把这些做成 PDF」即可；模型会调用 atelier_pdf 编写扩展 Markdown，插件负责排版与打印。

文档片段示例（语法来自 README）：

# 一级标题是一章，有专门的章节页

行内公式 $E=mc^2$，行间公式 $$\int_0^1 x\,dx$$

![图注会自动编号](photo.jpg "wide")
```chart
{"type":"bar","x":["甲","乙"],"series":[{"name":"","values":[3,5]}],"caption":"图表的颜色来自主题"}
```

:::key 三个结论
读者必须记住的那件事。
:::

需要固定视觉风格时，在生成流程中指定 theme（如 ledger 账簿、graphite 石墨等）；可用 atelier_themes 查看 13 套设计方向及适用场景。

适用场景与注意¶

适合：技术报告、课程讲义、实验/年报类文档、含公式与图表的长文，且希望 PDF 视觉与主题一致、而非通用模板。

限制（README 已说明）：

• 打印依赖本机浏览器，无浏览器则失败。
• 可变字体以 Type 3 嵌入，Acrobat 中小字号可能略虚，屏幕与打印正常，文字可搜可选。
• 公式与 atelier_figure 图为矢量轮廓，内部文字不可选；chart 文字可选。
• 不抓取远程图片、不联网；图片须先放在工作区。
• 主题靠关键词匹配，冷门主题可能退回通用方向，建议显式传 theme。

DSH 生态是「一切皆插件」；SkillHub 目录页 为社区站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-pdf-atelier 把「写内容」和「做一本有主题的 PDF」拆开：模型专注 Markdown 与工具调用，插件负责 13 套设计方向、封面、目录与中文版式，并在生成后读回 PDF 给出可执行的修改建议。

• 目录页：https://www.skillhub.cn/plugins/FelixJiashengFu/dsh-pdf-atelier
• 仓库：https://github.com/FelixJiashengFu/dsh-pdf-atelier