wenqu-image

# 内容配图与生图 Skill > 📦 项目仓库与源码：<https://github.com/gogoingai/wenqu-skills> ## 与调用方的接口约定 其他写作技能（如 wenqu-write）在正文里为图片预留位置时，用两种标记之一： | 标记 | 含义 | 谁来写 | | --- | --- | --- | | `> 🖼️ 待配图：[一句话描述这张图要表达的核心内容]` | 占位标记，只知道这里需要一张图，还没想好具体画法 | 调用方（写作阶段） | | \`\`\`（代码块）第一行 `# 画图提示：[描述]` | 完整画图提示，规范已写全，可以直接生成 | 本技能，或调用方已自行写好 | 本技能被调用时，**先把占位标记转换成完整画图提示，再进入生成流程**——两步不能合并，写法未确认前不要直接生成。 **完整画图提示必须带风格 YAML frontmatter**，格式是 `# 画图提示` 代码块内、提示正文之前加一段 YAML，风格信息、实际用过的参考图路径、历次生成的版本记录都写进提示本身，不能只存在对话记忆里——不然下次改图/复现时既解析不出用的是哪个风格，也找不到当初参考的是哪张图，更看不到之前生成过哪些版本： ``` ​``` --- style: 单色马克笔 # 对应风格库表里的风格名；无风格关键词时写"默认极简PPT" ref: https://raw.githubusercontent.com/gogoingai/wenqu-skills/master/wenqu-image-assets/styles/mono-marker/mono-marker-02-branch-decision.png # 实际用过的参考图；只允许 HTTPS URL（风格图托管在 GitHub，本地经 fetch-ref.sh 取）；临时本地路径不得写入；本轮没用 --ref 时保持原值不动，从未用过才省略 versions: # 历次生成的版本记录；每项必须是 HTTPS CDN URL，含质检不通过/用户否决版本，编号递增，不删除、不覆盖 v1: https://cdn.example.com/article-img-1111aaaa2222bbbb.png # 简要说明 generation: # 与 versions 同编号，记录实际渲染后端；不存密钥或 API 地址 v1: provider: codex model: codex-image-gen --- # 画图提示：[图片标题] # ...（提示正文，四条核心原则见下方） ​``` ``` 转换占位标记、或用户直接给风格关键词时，都按这个格式写；`references/styles/*.md` 里该风格追加的专属描述句，直接拼进提示正文，不要另起一段脱离 YAML 之外的"风格说明"，避免以后只读提示正文时丢失风格上下文。**每次实际传入 `--ref` 后**，把这次真正生效的稳定参考来源回填进 `ref:` 字段：风格资产用 GitHub raw URL，已采用图片用 HTTPS CDN URL；命令中临时使用的 `/tmp` 文件不得回填。`ref` 记的是“这次生成实际参考了什么”，不是“这个风格理论上可以参考什么”；**没用 `--ref` 的这一轮，不要动 `ref:` 字段**，保留上一次的记录。**只有上传成功、拿到 HTTPS CDN URL 的版本才可写入 `versions`**...