Baoyu Article Illustrator（寶玉文章配圖）

文章配圖：類型 × 風格 × 調色板一致性。

技能元數據

來源	可選 — 使用 hermes skills install official/creative/baoyu-article-illustrator 安裝
路徑	optional-skills/creative/baoyu-article-illustrator
版本	1.57.0
作者	寶玉 (JimLiu)
許可證	MIT
平臺	linux, macos, windows
標籤	article-illustration, creative, image-generation

參考：完整 SKILL.md

信息

以下是 Hermes 在觸發此技能時加載的完整技能定義。這是技能激活時代理看到的指令。

Article Illustrator（文章配圖）

改編自 baoyu-article-illustrator，適用於 Hermes Agent 的工具生態系統。

分析文章，識別插圖位置，生成具有 類型 × 風格 × 調色板 一致性的圖像。

何時使用

當用戶要求為文章配圖、向文章添加圖片、為內容生成插圖，或使用“為文章配圖”、“illustrate article”或“add images”等短語時，觸發此技能。用戶提供一篇文章（文件路徑或粘貼的內容），並可選擇指定類型、風格、調色板或密度。

三個維度

維度	控制內容	示例
類型	信息結構	infographic（信息圖）, scene（場景）, flowchart（流程圖）, comparison（對比）, framework（框架）, timeline（時間線）
風格	渲染方式	notion, warm（溫暖）, minimal（極簡）, blueprint（藍圖）, watercolor（水彩）, elegant（優雅）
調色板	配色方案（可選）	macaron（馬卡龍）, warm（溫暖）, neon（霓虹）— 覆蓋風格的默認顏色

自由組合：type=infographic, style=vector-illustration, palette=macaron。

或使用預設：edu-visual → 一次性包含類型 + 風格 + 調色板。參見 style-presets.md。

類型

類型	最佳適用場景
infographic	數據、指標、技術內容
scene	敘事、情感內容
flowchart	流程、工作流
comparison	並列對比、選項
framework	模型、架構
timeline	歷史、演變

風格

參見 references/styles.md 瞭解核心風格、完整圖庫以及類型 × 風格的兼容性。

輸出結構

{output-dir}/
├── source-{slug}.{ext}    # Only for pasted content
├── outline.md
├── prompts/
│   └── NN-{type}-{slug}.md
└── NN-{type}-{slug}.png

默認輸出目錄：

輸入	輸出目錄	Markdown 插入路徑
文章文件路徑	{article-dir}/imgs/	imgs/NN-{type}-{slug}.png
粘貼的內容	illustrations/{topic-slug}/（當前工作目錄）	illustrations/{topic-slug}/NN-{type}-{slug}.png

如果用戶要求不同的佈局（例如，圖片與文章並排，或使用 illustrations/ 子目錄），請遵從該要求。

Slug：2-4 個單詞，kebab-case（短橫線分隔）。衝突處理：追加 -YYYYMMDD-HHMMSS。

核心原則

• 可視化概念，而非隱喻 — 如果文章使用隱喻（例如，“電鋸切西瓜”），請闡述 underlying concept（基礎概念），而非字面圖像。
• 標籤使用文章數據 — 使用文章中的實際數字、術語和引用，而非通用佔位符。
• 提示詞文件是可復現性記錄 — 在生成任何圖像之前，必須在 prompts/ 下保存每個插圖的提示詞文件。
• 清除機密信息 — 在將任何內容寫入磁盤之前，掃描源內容中是否包含 API 密鑰、令牌或憑證。

工作流

- [ ] Step 1: Detect reference images (if provided)
- [ ] Step 2: Analyze content
- [ ] Step 3: Confirm settings (clarify tool, one question at a time)
- [ ] Step 4: Generate outline
- [ ] Step 5: Generate prompts
- [ ] Step 6: Generate images (image_generate)
- [ ] Step 7: Finalize

步驟 1：檢測參考圖像

如果用戶提供參考圖像（內聯粘貼的路徑、附件或 URL）：

1. 對於每個參考，調用 vision_analyze，傳入路徑/URL 以及詢問風格、調色板、構圖和主體的問題。通過 write_file 將返回的描述記錄在 {output-dir}/references/NN-ref-{slug}.md 中。
2. 不要 嘗試通過 write_file / read_file 複製二進制文件 — 這些僅支持文本。如果你想要本地副本以備記錄，請使用 terminal（cp "$src" "{output-dir}/references/NN-ref-{slug}.{ext}"）。技能本身無需讀取二進制文件；它基於視覺描述進行操作。
3. 由於 image_generate 不接受圖像輸入，視覺描述將在步驟 5 中嵌入到提示詞中。

完整流程：references/workflow.md。

步驟 2：分析

分析項	輸出
內容類型	Technical（技術）/ Tutorial（教程）/ Methodology（方法論）/ Narrative（敘事）
目的	information（信息）/ visualization（可視化）/ imagination（想象）
核心論點	2-5 個主要觀點
位置	插圖能增加價值的地方

讀取源內容（文件路徑 → read_file，或粘貼的文本），並使用 write_file 將分析寫入 {output-dir}/analysis.md。

完整流程：references/workflow.md。

步驟 3：確認設置

使用 clarify 工具。由於 clarify 一次只處理一個問題，請先詢問最重要的問題。跳過用戶請求中已包含答案的任何問題。

順序	問題	選項
Q1	預設或類型	[推薦預設]、[備選預設]，或手動：信息圖 (infographic)、場景 (scene)、流程圖 (flowchart)、對比 (comparison)、框架 (framework)、時間線 (timeline)、混合 (mixed)
Q2	密度	極簡 (minimal, 1-2)、平衡 (balanced, 3-5)、每節一張 (per-section, 推薦)、豐富 (rich, 6+)
Q3	風格 (如果在 Q1 中選擇了預設則跳過)	[推薦]、極簡扁平 (minimal-flat)、科幻 (sci-fi)、手繪 (hand-drawn)、編輯風 (editorial)、場景 (scene)、海報 (poster)
Q4	調色板 (可選)	默認 (風格顏色)、馬卡龍 (macaron)、暖色 (warm)、霓虹 (neon)
Q5	語言 (僅在文章語言不明確時)	文章語言 / 用戶語言

不要連續提出超過 2-3 個 clarify 問題。如果用戶已在請求中指定了這些內容，請完全跳過。

完整流程：references/workflow.md。

步驟 4：生成大綱 → outline.md

使用 write_file 保存 {output-dir}/outline.md，包含 frontmatter（type, density, style, palette, image_count）以及每個插圖的一個條目：

## Illustration 1
**Position**: [section/paragraph]
**Purpose**: [why]
**Visual Content**: [what to show]
**Filename**: 01-infographic-concept-name.png

完整模板：references/workflow.md。

步驟 5：生成提示詞

阻塞條件：在生成任何圖像之前，每個插圖必須有一個已保存的提示詞文件——提示詞文件是可復現性記錄。

對於每個插圖：

1. 根據 references/prompt-construction.md 創建提示詞文件。
2. 使用 write_file 將其保存到 {output-dir}/prompts/NN-{type}-{slug}.md，幷包含 YAML frontmatter。
3. 提示詞必須使用特定類型的模板，幷包含結構化部分（ZONES / LABELS / COLORS / STYLE / ASPECT）。
4. LABELS 必須包含文章特定數據：實際數字、術語、指標、引文。
5. 根據提示詞 frontmatter 處理參考資料（direct/style/palette）——對於 direct 用法，請在提示詞中嵌入參考資料的文本描述（因為 image_generate 不接受參考圖像輸入）。

步驟 6：生成圖像

對於每個提示詞文件：

1. 調用 image_generate(prompt=..., aspect_ratio=...)。image_generate 返回包含圖像 URL 的 JSON 結果；它不寫入磁盤，也不接受輸出路徑。
2. 將提示詞的 ASPECT 映射到 image_generate 的枚舉值：16:9 → landscape，9:16 → portrait，1:1 → square。自定義比例 → 最接近的命名比例。
3. 通過 terminal 將返回的 URL 下載到 {output-dir}/NN-{type}-{slug}.png（例如：curl -sSL -o "{output-dir}/NN-{type}-{slug}.png" "{url}"）。
4. 如果生成失敗，自動重試一次。

注意：底層圖像生成後端由用戶配置（默認：FAL FLUX 2 Klein 9B），且不能通過 image_generate 由代理選擇。不要在提示詞中寫入模型名稱以期望它們進行路由。

步驟 7：收尾

在相應段落之後插入 ![description](https://github.com/NousResearch/hermes-agent/blob/main/optional-skills/creative/baoyu-article-illustrator/{relative-path}/NN-{type}-{slug}.png)。Alt 文本：使用文章語言的簡潔描述。

報告：

Article Illustration Complete!
Article: [path] | Type: [type] | Density: [level] | Style: [style] | Palette: [palette or default]
Images: X/N generated

修改

操作	步驟
編輯	更新提示詞 → 重新生成 → 更新引用
添加	確定位置 → 編寫提示詞 → 生成 → 更新大綱 → 插入
刪除	刪除文件 → 移除引用 → 更新大綱

參考資料

文件	內容
references/workflow.md	詳細流程
references/usage.md	調用示例
references/styles.md	風格畫廊 + 調色板畫廊
references/style-presets.md	預設快捷方式（類型 + 風格 + 調色板）
references/prompt-construction.md	提示詞模板

常見陷阱

1. 數據完整性至關重要 — 切勿總結、轉述或更改源統計數據。“73% increase” 保持為 “73% increase”。
2. 清除機密信息 — 在將任何內容包含到輸出文件之前，掃描源內容中是否含有 API 密鑰、令牌或憑證。
3. 不要字面化地呈現隱喻 — 可視化其底層概念。
4. 提示詞文件是必需的 — 沒有保存的提示詞文件，不得生成圖像。該文件使您能夠在以後重新生成或切換後端。
5. image_generate 縱橫比 — 該工具支持 landscape（橫向）、portrait（縱向）和 square（方形）。自定義縱橫比會映射到最接近的選項。
6. image_generate 返回的是 URL，而非本地文件 — 在將本地圖片路徑插入文章之前，務必通過 terminal（curl）下載。
7. 代理不選擇後端 — image_generate 使用用戶配置的任何模型（默認：FAL FLUX 2 Klein 9B）。不要在提示詞中寫入 "use <model> to generate this" 以期望其進行路由。