混元生图 · 知识库配图编排
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 将 @user_47785077/hunyuan-ima-imggen 安装到你的 AI 助手中。
技能介绍
要解决的问题
知识库写作场景里,给一段内容配图通常是两支工具、两次切换:先用检索工具翻 ima 知识库找上下文,再把主题描述带到另一个生图入口,最后手动把图片塞进公众号或课件目录。最烦的是提示词要自己拼——prompt、size、文案语气全靠手工对齐,生图结果和知识库内容经常对不上。
这个技能把这条链路收成一个对话动作。用户说「给这段配封面」并给出主题描述,剩下的事由技能内部流水线完成。
核心能力与流程
意图判定先于一切。 输入里含生图动词(配图/生图/封面/插图)且提供了可成图的主题描述,判为生图请求,走完整流水线;只是问「知识库里有没有…」的请求只检索不配图;普通闲聊保持纯对话。描述过短时先回问一句确认主题,再继续。
生图请求的执行顺序:
- 抽取描述与检索词——从用户消息提取生图主题作为
--desc,同时提取 1–3 个关键词用于知识库检索 - 检索 ima 知识库——调用
mcp__ima-mcp__search_knowledge,原始结果存为kb_raw.json;无结果或用户明确要求忽略知识库时直接跳过 - 组装提示词——内部完成知识库上下文融合与提示词构建,
--ratio默认 16:9(公众号封面),课件配图可用 4:3 - 解析生图后端——返回
backend / tool / args:默认走 native 的ImageGen;配置了混元 MCP 则改走mcp__hunyuan__generate_image - 生成并落地——拿到本地图片路径,构建带
wenyanfrontmatter 的 Markdown,复制到课件目录并记录清单;带--wechat时推送到公众号草稿箱 - 回传——图片直接嵌入对话,附一句说明和插入位置提示
后端切换成本很低: 拿到混元端点和 Key 后,改 ~/.workbuddy/mcp.json 里的 url/Authorization 并启用 hunyuan,再把技能 config.json 的 image_provider 改为 hunyuan-mcp。同一句描述后续自动改走混元,流水线代码不用动。
适用边界与注意点
- 知识库检索目前稳定路径是已连接的 ima-mcp 连接器;REST 直连端点等官方确认后才算可用
- 公众号发布依赖外部
wenyan-cli和微信凭据(WECHAT_APP_ID/SECRET),缺失时自动跳过并提示,不影响生图与课件落地 - 生图消耗额度,演示或批量操作前先和用户确认
- 切换到混元后端前,确认 MCP 工具名与
hunyuan_mcp_tool配置一致,避免静默失败
使用场景
- 公众号运营为新文章生成 16:9 封面图,需要参考知识库里的产品背景
- 课程编辑为课件章节配 4:3 插图,希望先检索 ima 知识库再出图
- 写作者在对话中说“给这段配图”,需要一次动作完成检索、生图与 Markdown 落地
- 团队想把生图后端切到混元 MCP,并保持现有工作站行为不变
适合人员
- 需要给公众号文章配封面的内容运营
- 要为在线课件和培训材料生成插图的课程编辑
- 希望把 ima 知识库查询和文生图合并到对话流程的技术写作者
- 需要配置混元生图后端并维护 MCP 设置的工程团队