前言¶

在 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