Agent Skills
返回列表
🎨

混元生图 · 知识库配图编排

设计多媒体 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md 将 @user_47785077/hunyuan-ima-imggen 安装到你的 AI 助手中。

技能介绍

要解决的问题

知识库写作场景里,给一段内容配图通常是两支工具、两次切换:先用检索工具翻 ima 知识库找上下文,再把主题描述带到另一个生图入口,最后手动把图片塞进公众号或课件目录。最烦的是提示词要自己拼——prompt、size、文案语气全靠手工对齐,生图结果和知识库内容经常对不上。

这个技能把这条链路收成一个对话动作。用户说「给这段配封面」并给出主题描述,剩下的事由技能内部流水线完成。

核心能力与流程

意图判定先于一切。 输入里含生图动词(配图/生图/封面/插图)且提供了可成图的主题描述,判为生图请求,走完整流水线;只是问「知识库里有没有…」的请求只检索不配图;普通闲聊保持纯对话。描述过短时先回问一句确认主题,再继续。

生图请求的执行顺序:

  1. 抽取描述与检索词——从用户消息提取生图主题作为 --desc,同时提取 1–3 个关键词用于知识库检索
  2. 检索 ima 知识库——调用 mcp__ima-mcp__search_knowledge,原始结果存为 kb_raw.json;无结果或用户明确要求忽略知识库时直接跳过
  3. 组装提示词——内部完成知识库上下文融合与提示词构建,--ratio 默认 16:9(公众号封面),课件配图可用 4:3
  4. 解析生图后端——返回 backend / tool / args:默认走 native 的 ImageGen;配置了混元 MCP 则改走 mcp__hunyuan__generate_image
  5. 生成并落地——拿到本地图片路径,构建带 wenyan frontmatter 的 Markdown,复制到课件目录并记录清单;带 --wechat 时推送到公众号草稿箱
  6. 回传——图片直接嵌入对话,附一句说明和插入位置提示

后端切换成本很低: 拿到混元端点和 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 设置的工程团队