DesignCraft 深度教學：用 designcraft-cli 做排版與出版

如果 OfficeCLI 解決的是「Office 檔自動化」，DesignCraft 解決的則是版式——多欄、出血、奇偶頁、字體配對、頁面組成。它用 .designcraft 原生格式，也吃 IDML（Adobe InDesign 交換格式），即係可以同傳統出版流程互通。命令列介面 designcraft-cli（實測 v0.5.0）可以完全由 agent 驅動。

定位：版式自動化的命令列

排版是「七成規格、三成手感」。CLI 化之後，規格可以驗證、可以重播——這正是 agent 需要的能力。本文所有命令都以本機 designcraft-cli 0.5.0 實測為準，渲染圖亦由 CLI headless 產生。

安裝與版本

designcraft-cli --version

--version 應印出 0.5.0。下載與桌面 App 見官網（getartcraft.com 的 DesignCraft 頁），本文聚焦 CLI。

九個子命令

designcraft-cli run    [--in FILE | --sample] [--cmd ID[=JSON]]... [--page N] [--scale S] [--export OUT] [--all-pages DIR]
designcraft-cli commands [FILTER]
designcraft-cli describe COMMAND
designcraft-cli script [FILE|-] [--in FILE | --sample] [--connect PORT] [--save OUT] [--export OUT] [--keep-going]
designcraft-cli app    [--port PORT] COMMAND [JSON] | --method METHOD [JSON]
designcraft-cli mcp    [--connect PORT] [--sample]
designcraft-cli perf   [--pages N] [--runs N] [--strict]
designcraft-cli bench  FILE [--runs N]
designcraft-cli links

子命令	做咩
`run`	headless 跑單／多個動作，可出 PDF、逐頁 PNG、改縮放
`commands`	列出所有可用指令（共 444 個），可過濾
`describe`	睇單一指令嘅參數 schema
`script`	多步流程（檔案或 stdin），可 `--connect` 連 App
`app`	控制正在運行的 App（經控制埠）
`mcp`	掛成 MCP server，俾 AI agent 直接呼叫
`perf`	壓力測試（頁數／次數／嚴格模式）
`bench`	單檔基準測試
`links`	官方 Discord／網站／GitHub／Issues

文件模型：file.new

{
  "preset": "A4",
  "pages": 1,
  "facingPages": true,
  "columns": 3,
  "gutter": 4,
  "margins": { "top": 12, "bottom": 12, "inside": 14, "outside": 14 },
  "bleed": 3
}

幾個好用嘅入口：

指令 ID	作用
`file.open`	開 `.designcraft` 或 `.idml`；旁放 `Document Fonts` 夾會優先載入字體
`file.openBytes`	直接餵 base64（唔經臨時檔）
`file.newSample`	內建多頁雜誌樣本，最啱驗證管線
`file.presets`	列出內建版面

由零到出版：實測渲染

用內建雜誌樣本一次出四頁 PNG：

designcraft-cli run --sample --cmd file.newSample='{}' --all-pages ./out

由檔案出 PDF、指定頁放大出圖：

designcraft-cli run --in my.designcraft --export out.pdf
designcraft-cli run --in my.designcraft --page 2 --scale 2 --export page2.png

雜誌樣本第 1 頁（封面）

雜誌樣本第 2 頁

雜誌樣本第 3 頁

雜誌樣本第 4 頁

以上四頁全部由 designcraft-cli headless 渲染（630×810），無需開 GUI。

自動化三式

6.1 腳本流程（多步）

designcraft-cli script steps.json --in my.designcraft \
  --save out.designcraft --export out.pdf --keep-going

--keep-going 令單步失敗都繼續，方便長流程；也可以由 stdin 餵 JSON 指令陣列。

6.2 連 App（GUI 與 CLI 互動）

designcraft-cli app --port 7979 file.new '{"preset":"A4"}'

未開 App／控制埠會 Connection refused —— 先在 App 側開控制埠（designcraft --control 7979），再讓 CLI 接上去。

6.3 掛 MCP（給 agent 用）

designcraft-cli mcp --connect 7979 --sample

成為 MCP server 後，AI agent 可以直接呼叫排版能力，全程唔需要人手開 GUI。

效能與基準

designcraft-cli perf --pages 50 --runs 3 --strict
designcraft-cli bench my.designcraft --runs 5

實測四頁樣本 headless 渲染每頁個位數到二十幾毫秒（首次較慢，之後穩定），完全可接受。

下一步

生成側素材：讀 ArtCraft 深度教學：AI 生成 App（macOS）與它的工具鏈定位看 ArtCraft 如何出圖、用檔案交接；
Office 檔自動化：讀 OfficeCLI 深度教學：用命令列讓 AI 直接操控 Word／Excel／PowerPoint 看三層模型與原子 batch；
IDML 互通記得先備字體（Document Fonts 夾），再上真實稿。