前言¶
社区运营、基层宣教或商会活动里，健康科普往往要反复出图：主题要换、落款要统一、还要带当天日期。纯手写提示词调文生图，版式和内容结构每次都要重新对齐；用通用设计工具批量做，又难和「主题库 + 随机选题」绑在一起。下面介绍 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 为准。
