wenqu-imagelisted

# 内容配图与生图 Skill > 📦 项目仓库与源码：<https://github.com/gogoingai/wenqu-skills> ## 与调用方的接口约定 其他写作技能（如 wenqu-write）在正文里为图片预留位置时，用两种标记之一： | 标记 | 含义 | 谁来写 | | --- | --- | --- | | `> 🖼️ 待配图：[一句话描述这张图要表达的核心内容]` | 占位标记，只知道这里需要一张图，还没想好具体画法 | 调用方（写作阶段） | | \`\`\`（代码块）第一行 `# 画图提示：[描述]` | 完整画图提示，规范已写全，可以直接生成 | 本技能，或调用方已自行写好 | 本技能被调用时，**先把占位标记转换成完整画图提示，再进入生成流程**——两步不能合并，写法未确认前不要直接生成。 **完整画图提示必须带风格 YAML frontmatter**，格式是 `# 画图提示` 代码块内、提示正文之前加一段 YAML，风格、参考图路径、版本记录都写进提示本身，不能只存在对话记忆里——不然下次改图或复现时，所用风格、参考图与版本记录都无从解析： ``` ``` --- style: 单色马克笔 # 对应风格库表里的风格名；无风格关键词时写"默认极简PPT" ref: mono-marker/mono-marker-02-branch-decision.png # 实际用过的参考图：styles/ 下的相对路径（不含域名），由 wenqu image fetch-ref 解析为受管缓存路径；临时本地路径不得写入；本轮没用 --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`**，同时把本次实际 provider/model 写入同编号 `generation`；正文的 `![]()` 只指向当前采用的那一版，其余版本仅留存在 `versions` 里供回看对比，具体写入规则见 `references/gen-