前言¶
社區運營、基層宣教或商會活動裏，健康科普往往要反覆出圖：主題要換、落款要統一、還要帶當天日期。純手寫提示詞調文生圖，版式和內容結構每次都要重新對齊；用通用設計工具批量做，又難和「主題庫 + 隨機選題」綁在一起。下面介紹 SkillHub 社區 Skill「健康知識海報」（@user_9f5d3b0a/health-poster），把內置健康主題、文案結構與火山引擎 Seedream 出圖串成一條可腳本化的流程。
這是什麼¶
「健康知識海報」是 SkillHub 上分類爲 design-media 的社區 Skill（來源 community，發佈者 user_9f5d3b0a，頁面版本 v1.0.1）。包內說明文檔將其定位爲「健康科普海報生成器（專業版）」：基於既有海報生成能力改造，去掉安裝後自動創建的定時任務和固定通信通道，左上角組織/商會文案改爲可配置（默認爲空）。
在 Agent 側，它遵循通用 SKILL.md 約定：安裝後由模型讀取說明，在需要生成健康科普海報時引導你配置依賴、運行腳本並查看輸出目錄。
核心功能¶
以下能力均來自該 Skill 的 SKILL.md 與隨包腳本說明，可與本地安裝目錄對照。
- 文生圖海報：通過火山引擎 Seedream API（經
seedream-image-generation技能提供的generate_image）生成健康科普海報；腳本中使用的模型標識爲doubao-seedream-4-5-251128。 - 可配置落款與路徑：組織名稱（左上角）、輸出根目錄、自定義知識庫文件路徑均可配置；默認配置寫在
~/.config/health-poster/config.json。 - 內置主題庫：自帶
references/health_knowledge_enhanced_fixed.json，文檔寫明涵蓋 120+ 健康主題，並按呼吸、心血管、消化等類別組織 JSON 結構（標題、副標題、描述、要點、配色描述等字段）。 - 運行模式：支持隨機主題或
--theme指定主題；可在圖片底部自動帶上當天日期與星期。 - 產物落盤：按日期分子目錄，輸出 JPEG 海報，並附帶
content.json與poster.txt。 - 合規取向（相對舊版）：文檔 changelog 說明專業版移除了定時任務與固定通道推送，避免用戶安裝後被隱式拉起後臺任務。
SkillHub 元數據標籤含 requires_api_key=true：實際使用的是火山引擎 API Key，需在依賴的 seedream 技能中配置。
安裝與啓用¶
1. 安裝 SkillHub CLI 與本 Skill¶
若尚未安裝 CLI，可先按 SkillHub 官方安裝說明檢查環境：
command -v skillhub && skillhub --version
未安裝時可執行（完整安裝，含默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝「健康知識海報」時，必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別。Cursor 常用路徑爲 ~/.cursor/skills/：
skillhub install health-poster --namespace user_9f5d3b0a --dir ~/.cursor/skills/
也可將下面提示交給支持 Skill 安裝的 Agent（與 SkillHub 頁面一致）：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_9f5d3b0a/health-poster`。
安裝完成後，按你所用客戶端要求重啓或重新加載 skills 目錄。
2. 安裝圖像生成依賴¶
SKILL.md 要求先安裝 seedream-image-generation 技能，並在其中配置火山引擎 Access Key / Secret Key（控制台路徑：人工智能 → 智能創作 → Seedream）。文檔給出的安裝示例爲：
clawhub install seedream-image-generation
若你全程使用 SkillHub，可在商店內搜索名稱相近的 Seedream 圖片生成 Skill，再對照本包 manifest.json 中的依賴名 seedream-image-generation 確認模塊能否被主腳本導入。
3. 默認配置文件¶
首次可通過腳本進入配置，或手動編輯：
# 進入技能目錄後
python3 scripts/generate_health_poster_pro.py --configure
默認配置結構如下：
{
"organization_name": "",
"output_base": "~/health_posters",
"knowledge_file": null
}
典型用法¶
進入已安裝的 @user_9f5d3b0a/health-poster 目錄後，用包內 scripts/generate_health_poster_pro.py 驅動生成。
隨機主題快速出圖：
python3 scripts/generate_health_poster_pro.py
指定主題（文檔示例）：
python3 scripts/generate_health_poster_pro.py --theme "口腔健康"
查看全部主題：
python3 scripts/generate_health_poster_pro.py --list-themes
組合組織名與輸出目錄：
python3 scripts/generate_health_poster_pro.py \
--theme "感冒預防" \
--org-name "廣東省江西青原商會" \
--output-dir "~/health_posters"
成功後在 輸出目錄/YYYYMMDD/ 下可看到 image_<timestamp>_0.jpeg、content.json、poster.txt。包內 example_usage.py 對上述命令做了分場景羅列，可作爲本地速查。
在 Python 中集成時，文檔示例爲從 scripts.generate_health_poster_pro 導入 generate_poster 並讀取返回的 image_path、content_file 等字段。
適用場景與注意¶
更適合誰
- 需要週期性更換健康宣教主題、又不想每次手寫文生圖提示詞的運營或社區志願者。
- 已有火山引擎 Seedream 額度，並願意維護 API Key 的團隊。
- 使用 OpenClaw 或兼容 skills 目錄結構的 Agent 環境，且能安裝
seedream-image-generation依賴。
限制與坑
- API 與費用：依賴火山引擎 Seedream；餘額不足時腳本會報錯，需在控制台充值。Key 只應放在 seedream 技能配置中，勿提交到倉庫。
- 依賴路徑：主腳本在檢查依賴時寫死了路徑
/root/.openclaw/workspace/skills/seedream-image-generation。若你在 Cursor 或非該路徑下安裝依賴，可能需要調整安裝位置或修改腳本中的路徑，否則即使用 SkillHub 裝好了 seedream 相關 Skill，也可能仍提示未安裝。 - 醫療合規：
SKILL.md免責聲明寫明生成內容僅供參考，不能替代診療建議；對外發布前仍需人工審覈。 - 平臺數據：SkillHub 頁面顯示評分 100000、下載 1311、安裝 14（以頁面/索引抓取爲準）；包內
package.json的skillhub字段與 manifest 版本爲 1.0.0，與商店標註 1.0.1 並存時，以商店座標@user_9f5d3b0a/health-poster爲準做升級覈對。
結尾¶
「健康知識海報」把主題知識庫、可配置組織落款和 Seedream 出圖封裝成一條腳本化流水線，適合在 Agent 對話裏用自然語言觸發「列主題 → 選題 → 出圖 → 拿 JSON/文本副產物」。官方入口：
- API 座標頁：https://api.skillhub.cn/user_9f5d3b0a/health-poster
- SkillHub 展示頁：https://www.skillhub.cn/skills/user_9f5d3b0a/health-poster
安裝與目錄規範以 https://skillhub.cn/install/skillhub.md 爲準；功能細節以安裝包內 SKILL.md 爲準。
