技能介绍

先解决什么

技术文章里的配图常卡在两个环节：一是正文里只留下 > 🖼️ 待配图：一句话描述 这类占位标记，写图的人只知道“这里需要一张图”，却不知道具体怎么画；二是风格、参考图、版本记录散落在对话里，等下次改图或复现时，这些信息已经无从解析。文曲·配图要解决的就是从“知道需要图”到“能稳定生成并追踪版本”的这段断层。

技能如何工作

调用该技能后，它会先把文章里的占位标记转换成完整的 # 画图提示 代码块。这个提示不是一段普通文本，而是在代码块开头附带 YAML frontmatter，记录本次使用的风格名、实际生效的参考图路径（由 wenqu image fetch-ref 解析的受管缓存地址）、以及历次生成的版本列表和渲染后端。这样即使换人接手或隔月重画，也能从提示本身还原当时的决策依据。

动笔前，技能会先读取本篇偏好库 references/preferences.md，看有没有已记录的默认风格或配色规则，避免每次都重复询问。接着根据内容类型进入对应的图型模板：架构图走 references/templates/architecture.md，流程图走 references/templates/flow.md，对比类走 comparison.md，数据可视化走 data-viz.md。风格则从风格库中选取，支持手绘插画、Excalidraw、单色马克笔、水彩涂鸦、奶油描边、彩色铅笔质感、技术 PPT 等，不混用。

生成阶段逐张进行，不批量处理，每张都经过质检和用户确认后才会写入文章。Codex 路径受 session 输出提取限制，必须串行执行，其他后端也保持相同的确认节奏。单张图只承担一到两个关键关系，图中文字、节点、箭头需与正文术语保持一致，最终采用的 URL 必须是版本记录里已上传成功的 HTTPS 地址。

适用边界

讨论不触发生图。用户说“看看图”“评价图片”“先给画图方案”时，技能只做分析或给出增量修改建议，不会直接生成、上传或写入文章。只有明确说出“生成”“画”“重画”“插入”“上传并替换”时，才会进入实际流程。

配置方面，技能不会硬编码任何 API 密钥。它先检查全局配置 ~/.gogoingai/wenqu-skills/image/config.json，再检查文章级配置，两者都没有时才询问默认 provider、模型和画幅，并引导用户运行 wenqu image doctor 查看凭证文件路径。

风格参考图库托管在远程，首次使用需要联网下载到受管缓存。如果文章没有提供存储路径，技能会询问偏好记录要存到哪里，避免信息丢失。

来源：https://www.skillhub.cn/skills/user_32690bcc/wenqu-image