⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

v0.1.19

wenqu-image

gogoingai@gogoingai⭐ 7 stars· last commit 3mo ago· 1 open issues

>-

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐ 7 on GitHubGitHub ↗

New / niche

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

文曲(Wenqu Skills)

English | 简体中文

一套面向 AI Agent 的完整文章创作工作流。

文曲 Logo

文曲取意于文曲星,遵循中国传统文章创作路径,从博观积累、谋篇布局,到属文成篇、推敲润色,最终完成文章发布。

文曲将传统文章创作方法与现代 Agent 能力结合,由多个专业化技能协同,覆盖从素材积累、文章撰写、质量优化到发布输出的完整流程。

创作流程

博观积累 -> 谋篇布局 -> 属文成篇 -> 推敲润色 -> 校勘审定 -> 丹青绘意 -> 译笔传意 -> 刊行成章

不同技能各覆盖其中若干阶段,彼此衔接成完整创作链路。

技能组成

技能创作阶段作用
wenqu-library博观积累素材收集与整理:按“规划、搜索、下载、整理”四步收集素材,以 agent 原生搜索为主、wenqu library 补充候选并抓取网页(含微信公众号),为文章、报告与教程整理出可复用素材。
wenqu-write谋篇布局、属文成篇中文内容创作主流程:完成需求理解、规划与结构设计、逐节写作与内容完善,并协调其他技能完成翻译、配图与审查。
wenqu-review推敲润色、校勘审定内容质量优化:检查事实依据与逻辑结构、表达方式与英文术语、翻译腔与 AI 写作痕迹,并提供修改建议。
wenqu-image丹青绘意内容视觉设计:规划配图需求,生成图片提示词,完成 AI 生图、质量检查和上传流程。
wenqu-translate译笔传意跨语言内容转换:将英文材料转换为符合中文表达习惯的内容。
wenqu-publish刊行成章发布版本整理:清理创作痕迹,生成标题、简介、封面等发布素材,输出最终发布版本。

设计理念

中国传统文章创作讲究:

博观而约取,厚积而薄发。

文章并非一次生成,而是在长期积累、反复推敲和持续完善中形成。

文曲希望将这一创作过程融入 AI Agent,使文章创作不再是一次性生成,而是可积累、可持续演进的创作体系。

安装完整工作流

推荐:通过 WorkBuddy 体验文曲。WorkBuddy 的 hy3 模型免费,每天可领 100 积分。

文曲按完整工作流设计,使用 npx skills 一次安装全部六个技能:

npx skills add gogoingai/wenqu-skills --all -g
  • --all:安装全部技能,并安装到检测到的 Agent。
  • -g:安装到用户全局目录。

如果安装时看到 eve/promptscript does not support global skill installation 报错,可以忽略--npx skills 工具内置的 agent 中,只有这两个不支持全局安装(工具自身的限制,与本仓库无关),其余 agent(包括 Claude Code)不受影响,照常安装成功。

更新已安装的技能:

npx skills update -g

WorkBuddy

WorkBuddy 内置 SkillHub 目录,可逐个安装文曲技能。WorkBuddy 当前 hy3 模型免费,每天可领 100 积分,适合免费体验文曲全流程。

打开“专家·技能·连接器”,切到 SkillHub 页签,搜索 wenqu,在想安装的技能卡片上点击 +。WorkBuddy 会显示六个独立的文曲技能:文库、写作、审查、配图、翻译与发布。

在 WorkBuddy SkillHub 搜索文曲技能

SkillHub 中的每个技能都有各自的目录版本和审核状态;它们不是 GitHub 市场里的整包插件。

千问 Work(Qwen Work)

千问 Work 已上线文曲技能支持,技能目录位于 ~/.qwenworkcn/skills/。在千问 Work 中发送下面的提示词,即可自动下载仓库并安装全部六个文曲技能:

请从 https://github.com/gogoingai/wenqu-skills 下载仓库,将仓库根目录下的以下六个 Skill 分别安装到 ~/.qwenworkcn/skills/:wenqu-library、wenqu-write、wenqu-review、wenqu-image、wenqu-translate、wenqu-publish。请保留每个 Skill 目录中的 SKILL.md、references 及其他辅助文件。安装完成后,列出已经成功识别的全部文曲 Skill。

在千问 Work 中运行提示词后的安装结果

Claude Code 插件市场

先添加文曲市场,再安装唯一的 wenqu-skills 插件;它包含全部六个技能:

/plugin marketplace add gogoingai/wenqu-skills
/plugin install wenqu-skills@wenqu-skills
/reload-plugins

/reload-plugins 用于让当前 Claude Code 会话立即加载刚安装的技能;新开会话时无需重复执行。市场或插件有新版本时,依次更新:

/plugin marketplace update wenqu-skills
/plugin update wenqu-skills@wenqu-skills
/reload-plugins

Codex 插件市场

Codex 可直接识别本仓库的插件市场,并安装包含全部六个技能的完整 wenqu-skills 插件包。

  1. 在左侧边栏打开“插件”,选择“创建”->“添加插件市场”。

    在 Codex 中打开添加插件市场

  2. 输入下面的仓库来源,Git 引用和稀疏路径保持为空,然后添加市场:

    gogoingai/wenqu-skills
    
  3. 切到“个人”页签,找到 Wenqu Skills,点击“安装”。

    从 Codex 个人市场安装 Wenqu Skills

安装后新开一个 Codex task,让新会话加载插件中的技能。

SkillHub 网站或 agent 安装

SkillHub 也支持通过 agent 安装全部技能,可发送:

请根据 https://skillhub.cn/install/skillhub.md,安装 wenqu-library、wenqu-write、wenqu-review、wenqu-image、wenqu-translate、wenqu-publish。

ClawHub(OpenClaw)

ClawHub 是 OpenClaw 生态的技能与插件市场,文曲主页:https://clawhub.ai/gogoingai。推荐安装 wenqu-skills 插件包,一次获取全部六个技能:

openclaw plugins install clawhub:@gogoingai/wenqu-skills

也可以逐个安装技能:

openclaw skills install @gogoingai/wenqu-library
openclaw skills install @gogoingai/wenqu-write
openclaw skills install @gogoingai/wenqu-review
openclaw skills install @gogoingai/wenqu-image
openclaw skills install @gogoingai/wenqu-translate
openclaw skills install @gogoingai/wenqu-publish

更新:插件包用 openclaw plugins update --all,逐个安装的技能用 openclaw skills update。

依赖

  • wenqu-cli:为 wenqu-image 和 wenqu-library 提供运行时。

wenqu-image

wenqu-image 支持五条生图路径:已登录的 Codex、OpenAI GPT Image、OpenRouter、通义万相和豆包 Seedream。安装后可先检查本机环境:

wenqu image doctor --json

Codex 路径需要 codex login;其他 API 密钥仅写入本机 ~/.gogoingai/wenqu-skills/image/credentials.env,默认模型、画幅与可选 API 地址写入同目录 config.json。文章可在 wenqu-skills/{文章文件名}/config/image.json 覆盖模型选择,不能保存密钥或地址。

wenqu image generate \
  --provider dashscope --model qwen-image-2.0-pro --ar 16:9 \
  --prompt "一张中文技术架构示意图" --out /tmp/diagram --timeout-sec 300 --upload

--upload 由 CLI 自己调用已配置的 PicGo。

wenqu-library

wenqu-library 每次都先运行 agent 自带的联网搜索;受管的 wenqu library 命令只负责补充多引擎候选和增强下载。它内置 Crawl4AI 适配:百度、必应、Brave 与搜狗直连失败时可做一次浏览器回退;下载支持动态网页、受限同源抓取和已确认的微信公众号 URL,失败时自动回退 agent 自带能力。

完整的引擎选择、CLI 参数和站点抓取策略见 wenqu-library/references/wenqu-cli.md。

维护与发布

技能、清单、版本、图片资源和发布配置的任何改动都必须通过 PR 合入 master,不得直接推送。每个 PR 会自动运行 Skills Eval,并在 PR 评论中展示格式、安全以及 Claude Code、WorkBuddy、ClawHub 的原生校验报告。

维护者请先阅读 开发手册;涉及版本和平台发布时,再按 发布手册 在 PR 合入后执行。

// HOW IT'S BUILT

// FILES

19 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • wenqu-image/SKILL.md13 KBf2060e0e56cdupstream ↗
    ---
    name: wenqu-image
    description: >-
      为内容设计并生成、质检、上传、嵌入架构图、流程图、信息图和示意图,覆盖提示词设计到
      最终出图。当用户要求“画个架构图”“画流程图”“生成配图”“生成图片”“把图画出来”
      “渲染一下”或“帮我生图”,或使用 "draw an architecture diagram", "generate an image",
      "create a flowchart" 等英文表达时使用。
    slug: wenqu-image
    displayName: 文曲·配图
    version: 0.1.19
    summary: 为内容生成 AI 配图(架构图/流程图/信息图/示意图):提示词、生图、质检、上传全流程。
    license: MIT
    homepage: https://github.com/gogoingai/wenqu-skills
    metadata:
      openclaw:
        homepage: https://github.com/gogoingai/wenqu-skills/tree/master/wenqu-image
    ---
    
    # 内容配图与生图 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-workflow.md` 第四步。
    
    ## 用户输入工具
    
    当本技能需要用户确认选择、补充必要信息或授权有副作用的操作时:
    
    1. 优先使用当前运行时提供的原生用户输入工具,例如 `AskUserQuestion`、`request_user_input`、`clarify`、`ask_user` 或等价能力。
    2. 若没有此类工具,使用带编号或字母选项的文本问答。
    3. 同一决策阶段中彼此独立的问题可合并提问;后一个问题依赖前一回答时,按优先级逐个问。
    4. 已由用户当前指令、调用方或文章偏好提供的信息,不重复询问。
    5. 文中出现的具体工具名均为示例;应替换为当前运行时的等价能力。
    
    ### 模型配置提问规则
    
    先检查全局配置 `~/.gogoingai/wenqu-skills/image/config.json`,再检查本篇
    `{项目根目录}/wenqu-skills/{文件名}/config/image.json`:
    
    1. 两者都没有时,用原生输入工具一次询问默认 provider、模型与画幅;**不要索要密钥**,仅告知用户运行 `wenqu image doctor` 查看本机凭证文件路径,然后创建全局非敏感配置。
    2. 有全局配置、本篇没有配置时,在首次为本篇实际生成前询问是否沿用全局选择;拒绝后询问本篇选择并写入文章级配置。
    3. 有本篇配置、或用户已在当前指令/命令中指定 provider/model 时,不重复询问。
    4. 直接生图(非文章场景)只读取全局配置;运行时命令由 `wenqu image` 提供。
    
    ## 工具等价说明(非 Claude Code 环境)
    
    文中 `Skill` 工具是 Claude Code 的跨技能调用机制名。其他 agent 没有对应机制时,调用方直接读取本技能的 `SKILL.md` 和 `references/` 文件就地执行。
    
    ---
    
    ## 触发识别
    
    **讨论不触发生图:** 用户说“看看图”“讨论怎么画”“评价图片”“先给画图方案”或“这张图哪里不对”时,只分析现图或给出增量修改方案,不生成、上传或写入文章。只有用户明确说“生成”、“画”、“重画”、“插入”、“上传并替换”时,才进入实际流程;增量调整只改用户点名的内容,需要整体重画时先说明原因。
    
    | 场景 | 入口 |
    |------|------|
    | 用户直接说"画个XX图"、"生成配图",给出内容描述 | 直接进入「写画图提示」 |
    | 文章里已有 `> 🖼️ 待配图` 占位标记 | 先转换成完整画图提示,见 `references/gen-workflow.md` 第二步 |
    | 用户说"生成图片"、"渲染一下"、"把图画出来" | → 查 `references/gen-workflow.md`,完整生成流程 |
    | 用户提到"手绘风格""Excalidraw""马克笔风格""水彩涂鸦""奶油描边""思维导图风""彩色铅笔""排线阴影""技术PPT风格"等风格关键词 | → 直接跳对应的 `references/styles/*.md`(见下方风格库表) |
    
    ---
    
    ## 写画图提示
    
    核心原则(4 条,展开说明见 `references/core-principles.md`):
    1. 描述视觉物体,不指定显示文字——prompt 触发元素,不指定渲染细节
    2. 不写 px/尺寸/颜色值/字号——生图模型自行决定渲染细节
    3. 图类型、节点标签、箭头语义、关键数据、视觉层次是该写的内容
    4. 禁止任何画图 DSL(Mermaid、draw.io、Graphviz、PlantUML)——只输出 `# 画图提示` 代码块
    
    **动笔前先查本篇偏好库**(`references/preferences.md`「配图偏好」表,路径与读取方式见下方「用户反馈与偏好持久化」)——有没有已记录的默认风格、配色规则等,有则直接应用,不重复问用户。
    
    先判断该画哪类图 → `references/diagram-type-selector.md`(图类型快速选表与该画哪类架构图),再去对应的图型模板文件取 prompt 骨架:
    
    | 图型模板文件 | 覆盖的图类型 |
    | --- | --- |
    | `references/templates/architecture.md` | 横向多层架构图、树形层次检索路径图 |
    | `references/templates/flow.md` | 竖向三阶段流程、竖向分支流程、横向阶段列流程、两层流程(主流程+展开细节) |
    | `references/templates/comparison.md` | 并排方案对比、并行双路流程、左右结果对比 |
    | `references/templates/data-viz.md` | 横向条形图、公式+分级卡片、时间演化折线图、金字塔分层图 |
    
    风格库(见下表,不混用):
    
    | 风格 | 文档 | 参考图目录 |
    | --- | --- | --- |
    | 手绘插画 | `references/styles/handdrawn.md` | `wenqu-image-assets/styles/handdrawn/` |
    | Excalidraw(白板斜线填充) | `references/styles/excalidraw.md` | `wenqu-image-assets/styles/excalidraw/` |
    | 单色马克笔(波浪线注释) | `references/styles/mono-marker.md` | `wenqu-image-assets/styles/mono-marker/` |
    | 水彩涂鸦(星星火花装饰) | `references/styles/doodle-watercolor.md` | `wenqu-image-assets/styles/doodle-watercolor/` |
    | 奶油描边(黑色粗描边思维导图) | `references/styles/cream-outline.md` | `wenqu-image-assets/styles/cream-outline/` |
    | 彩色铅笔质感(编号徽章与排线阴影) | `references/styles/pencil-sketch.md` | `wenqu-image-assets/styles/pencil-sketch/` |
    | 技术PPT(机器人吉祥物) | `references/styles/techppt.md` | `wenqu-image-assets/styles/techppt/` |
    | (无风格关键词/默认) | 默认极简 PPT,直接在图型模板结尾加「风格:白色背景,高级技术 PPT 配图,极简专业,文字标注全部用中文。」 | — |
    
    其他参考文档:
    
    | 文档 | 内容 |
    | --- | --- |
    | `references/pitfalls.md` | 常见踩坑教训(跨风格通用) |
    | `references/design-principles.md` | 设计四大原则与配色审美 |
    | `references/diagram-examples.md` | 完整示例 |
    
    ---
    
    ## 生成图片
    
    → 查 `references/gen-workflow.md`(环境检测 → 列出画图点并补全占位标记 → 逐张生成/质检/确认 → 写入文章 → 联动提醒)。
    
    逐张生成、逐张确认,不批量、不跳过用户;Codex 路径受 session 输出提取限制,必须串行,其他后端也按同一确认节奏逐张处理。
    
    **单图采用标准:** 一张图只承担 1~2 个关键关系;图中文字、节点、箭头与正文术语一致,最终采用的 URL 是 `versions` 中的 HTTPS 版本。满足这些条件后才可标记为“已采用”;若调用方文章存在 `references/status.md`,同步图片状态与待复查原因。
    
    ---
    
    ## 运行时要求
    
    - 运行器:`wenqu image` CLI(`doctor`、`config-init`、`generate`、`fetch-ref`)。该 CLI 独立于 skill 安装;每次调用前先获授权更新 `wenqu-cli`,再运行 `wenqu image doctor --json` 确认。它会随包安装所需 Python 依赖;Crawl4AI 与浏览器只属于 `wenqu library`,不是 image 的前置条件。
    - 后端:`codex`(复用已登录订阅)、OpenAI GPT Image(`OPENAI_API_KEY`)、OpenRouter(`OPENROUTER_API_KEY`)、通义万相(`DASHSCOPE_API_KEY`)或豆包 Seedream(`ARK_API_KEY`);密钥由 `wenqu image` CLI 从本机凭证文件读取(运行 `wenqu image doctor` 查看路径);不要在技能里硬编码密钥值。
    - 图床:`picgo`(可选,上传时需已配置 uploader)。
    - 风格参考图库:`styles/` 下分目录(`handdrawn/` 手绘插画、`excalidraw/` 白板斜线填充、`mono-marker/` 单色马克笔、`doodle-watercolor/` 水彩涂鸦、`cream-outline/` 奶油描边思维导图、`pencil-sketch/` 彩色铅笔质感、`techppt/` 技术PPT风格,配合 `--ref` 使用,对应文档见 `references/styles/`)。图片不随技能分发,托管地址由 `wenqu image fetch-ref`(环境变量 `WENQU_IMAGE_ASSETS_BASE`)解析,首次使用下载到受管缓存,需要联网。
    
    ---
    
    ## 用户反馈与偏好持久化
    
    不再向用户提议修改本技能仓库的文档(`references/pitfalls.md`、`references/styles/*.md`、`references/templates/*.md` 等),遇到新画图踩坑或用户给出的持久化偏好,改为记进**调用方文章自己的**存储目录:`{项目根目录}/wenqu-skills/{文件名}/references/preferences.md`「配图偏好」表(表结构见 wenqu-write 的 `references/planning/questionnaire.md`「写入 preferences.md」一节)。provider、模型和画幅例外:它们只写入同级的 `config/image.json`,避免和写作偏好混在一起。
    
    **判定标准**:这条反馈下次给这篇文章画图还用得上吗?
    - 是(默认风格、配色规则、某类结构反复踩坑的修法、用户明确要求"以后都这样画")→ 当场追加一行进 `references/preferences.md`「配图偏好」表,格式:`| ID | 内容 | 来源 | 状态 |`
    - 否(这次改这张图的临时要求,比如"这条箭头改成红色")→ 不持久化,正常执行即可
    
    **每次画图前先查这份文件**:有已记录的默认风格/配色/常见修法,直接应用,不重复问用户;生成结果反复触发同一个踩坑时,把修复策略当场写成一条偏好记录,而不是只在当次会话里口头记住。
    
    被独立文章调用(无 wenqu-write 提供的存储路径)时,若找不到调用方上下文,询问用户"这次的画图偏好要记到哪篇文章的存储目录",或按当前工作目录和输出文件名推断。
    
  • wenqu-image/references/core-principles.md4.8 KB8c91b965e87aupstream ↗
    # 核心画图原则
    
    ### ⚡ 第一原则:描述视觉物体,不指定显示文字
    
    模型在「画什么」和「写什么」之间有隐含的选择权——prompt 的写法决定它把预算花在哪里。
    
    | 低效(指定文字) | 高效(触发元素) |
    |---|---|
    | 「三张卡片,分别写:快速响应、精准定位、低延迟」 | 「三张卡片,每张左侧带彩色图标,主题依次是闪电、靶心、时钟」 |
    | 「右侧补充说明:该步骤负责过滤低质量输入,阈值 0.6」 | 「右侧灰色小注卡片,带盾牌图标,一句话质量门描述」 |
    | 「底部备注区,文字说明 A、B、C 三种情况」 | 「底部图例区,三个色块与三个短标签,横向排开」 |
    
    描述**视觉物体**(图标、色块、卡片、箭头)→ 模型画元素;描述**文字内容**(说明、注释、备注)→ 模型显示文字。
    
    ---
    
    ### 视觉效果描述优先于文字内容
    
    | 多写 | 少写 |
    |------|------|
    | 整体氛围(「明亮通透」「色彩饱和但不杂乱」) | 节点副标签的详细文字 |
    | 色彩对比(「图标是全图最鲜艳的元素,和浅色底色形成反差」) | 每张卡片的具体说明文字 |
    | 视觉层次(「卡片是主角,箭头细而克制」「标题条比底色深一档」) | 过度精确的文字标注 |
    | 空间感(「留白充裕」「两侧色块等高对齐」) | 渲染参数(颜色值、尺寸) |
    
    ---
    
    ### 带 `--ref` 时,prompt 先写"轻描述",别把参考图翻译成文字
    
    用 `--ref` 锚定风格时,prompt 只需要**轻微描述风格是什么与说清楚内容**,不要把参考图里能看到的视觉细节(图标怎么画、线条怎么处理、颜色怎么搭配……)逐条翻译成文字再描述。写得越详细,文字描述对模型的影响权重越大,参考图的权重反而被稀释——实测对比详细版与轻描述版(同一张参考图、同一个内容),轻描述版更接近参考图的实际观感,详细版反而容易跑偏。
    
    **做法**:先用「参考图风格,[构图方向]。[内容/标签描述]。所有文字用中文,拼写清晰。」这种最小化 prompt 生成一版,检查是否符合预期;只有某个具体细节跑偏了(比如标题字号太大、箭头颜色不对),才追加一两句简短修正,不要一次性把整套风格重新用文字描述一遍。
    
    详见 `pitfalls.md` 踩坑 9。
    
    ---
    
    ### 绝对禁止
    
    | 禁止 | 原因 |
    | --- | --- |
    | CSS 颜色值(`#3B82F6`) | 过度限制模型发挥,结果反而变差 |
    | 像素/尺寸(`800px`、`14pt`) | 生图模型不接受绝对尺寸 |
    | 字号/字重(`bold`、`font-size: 16`) | 渲染细节由模型决定 |
    | SVG/HTML/CSS 代码片段 | 不是代码生成任务 |
    | 箭头粗细、边框样式等渲染细节 | 描述内容和结构,不描述样式参数 |
    
    ### 应该写的内容
    
    - **图类型**:横向多层架构图、竖向三阶段流程图、条形图与卡片……
    - **节点标签**:全部用中文,描述语义(「同步决策」而非 `SyncDecision`)
    - **箭头语义**:说明关系(「降级路由」「触发迁移」),不描述方向
    - **关键数据**:阈值、比例、数字直接写进来(「得分 0.62」「权重 30%」)
    - **视觉层次**:「重点突出」「虚线框表示可选」「深色背景强调」
    
    ---
    
    
    ---
    
    ## 【禁用】泳道图
    
    **不要使用纵向泳道图(Vertical Swimlane)。**
    
    gpt-image-1 实践验证:纵向泳道图 prompt 生成结果极差——泳道线混乱、节点溢出、文字截断,整体像线框图而非正式图表。
    
    **替代方案**:
    
    | 原泳道图场景 | 替换为 |
    | --- | --- |
    | 跨模块的完整流程(跨角色) | 竖向三阶段流程图(templates/flow.md『竖向三阶段串行流程图』) |
    | 数据在多层/多组件间流转 | 横向多层架构图(templates/architecture.md『横向多层架构图』)或横向阶段列流程图(templates/flow.md『横向阶段列流程图』) |
    | 强调「谁做什么」的分工 | 横向阶段列流程图(templates/flow.md『横向阶段列流程图』),顶部加阶段标签 |
    
    ---
    
    
    ---
    
    ## 节点标签规则
    
    | 禁止 | 替换为 |
    | --- | --- |
    | 函数名(`add_memory()`) | 中文功能描述(「写入对话」) |
    | 类名(`ShortTermMemory`) | 中文层名(「短期记忆」) |
    | 字段名(`N_visit`) | 中文含义(「命中次数」) |
    | 英文缩写(`FAISS`、`LFU`) | 中文描述(「向量索引」、「最少使用淘汰」) |
    | 纯 `True / False` | 「连续 ✓」「不连续 ✗」 |
    | `embedding`、`vector` | 「语义向量」 |
    | CSS 颜色值(`#3B82F6`) | 描述性颜色名(「深蓝」「浅灰」) |
    | 像素/尺寸值(`800px`、`14pt`) | **删除**,生图工具自行决定 |
    
    ---
    
  • wenqu-image/references/design-principles.md5.5 KB9a96b6d29560upstream ↗
    # 设计四大原则与配色审美
    
    来源:《写给大家看的设计书》的亲密性、对齐、对比、重复四原则、色轮配色法、黄金分割构图。以下是转化为 **AI 生图 prompt 写法**的对应规则(不是让模型"理解设计理论",而是把原则拆成可执行的 prompt 描述)。
    
    ### 亲密性——同类归组,异类拉开
    
    同一语义组的节点必须挨在一起、间距一致;不同组之间用更大间距或背景色块分开。
    
    | 已有体现 | 位置 |
    | --- | --- |
    | 三区布局(层名徽章、节点组、角色描述)左中右各自成组 | templates/architecture.md『横向多层架构图』 |
    | 两路并行图左右各自独立背景色包裹 | templates/comparison.md『并行双路流程图』 |
    | 手绘图各步骤用不同浅色底色区分 | [styles/handdrawn.md](styles/handdrawn.md) |
    
    **写 prompt 时补一句**:「同组元素间距小而一致,组与组之间间距明显更大」。
    
    ### 对齐——看不见的网格线
    
    同一层级的节点必须等宽、等高,顶对齐或居中,不能随意错落摆放。
    
    **已有强制规则**:templates/flow.md『竖向三阶段串行流程图』「步骤节点必须等宽均匀分布」、templates/flow.md『竖向串行流程图(含判断分支)』「所有箭头居中进出」、templates/data-viz.md『金字塔分层图』「所有层共用同一条斜边」。
    
    **通用补充句**:多节点横排或纵排时,prompt 里加「同一行/列的节点顶部对齐,宽度一致」——不要只描述节点内容,不描述对齐关系。
    
    ### 对比——让重点跳出来
    
    一张图只能有一个视觉焦点;次要信息必须在颜色饱和度、字号、边框粗细上明显降级,不能和主角平起平坐。
    
    | 场景 | 对比手法 |
    | --- | --- |
    | 强调"待展开"的卡片(templates/flow.md『两层流程图:主流程 + 展开细节』) | 颜色加深突出,其余卡片保持浅色 |
    | 强调"异步阶段"(templates/flow.md『竖向三阶段串行流程图』) | 虚线橙框与浅黄底,与同步阶段的实线蓝/绿框区分 |
    | 强调图标(手绘风格,[styles/handdrawn.md](styles/handdrawn.md)) | 图标是全图最鲜艳的元素,与浅色底色形成反差 |
    
    **反向提醒**:对比不是"把每个节点都做鲜艳"——多个强调点互相抵消,等于没有重点(参考 pitfalls.md 踩坑 4 的反向陷阱)。
    
    ### 重复——同类元素同一套样式
    
    同一层级/同一类型的节点必须共享同一套视觉语言(配色体系、图标风格、圆角半径),不能方形圆形混用、深浅不一。
    
    **已有强制规则**:templates/flow.md『竖向串行流程图(含判断分支)』「所有节点配色保持同一色调体系」、templates/data-viz.md『金字塔分层图』「各层配色由模型自行决定但三层需协调」。
    
    **通用补充句**:「同类型节点复用同一种卡片样式(同圆角、同图标风格、同色系按明度区分)」。
    
    ### 配色场景对照表
    
    按画面里出现的颜色种类数选配色策略,不要凭感觉挑颜色:
    
    | 场景 | 策略 | 写法示例 |
    | --- | --- | --- |
    | 2 种颜色对比(如 templates/comparison.md『并排方案对比图』、templates/comparison.md『左右结果对比图』) | 互补色,一主一强调 | 「左侧红色系(劣势方案),右侧绿色系(优势方案),互为对比色」 |
    | 3 种颜色并列(如 templates/data-viz.md『金字塔分层图』三层、templates/comparison.md『并行双路流程图』 双路与汇合) | 等距三色组,愉悦不杂乱 | 「三层分别用蓝/橙/红渐变色系」(已在 templates/data-viz.md『金字塔分层图』采用) |
    | 多层/多组(4 种以上,如 templates/architecture.md『横向多层架构图』) | 同色系不同明度,不要彩虹跳色 | 「各层背景色统一为蓝色系,明度从上到下递减」而非「一层蓝一层绿一层紫一层黄」 |
    
    **绝对避免**:任意堆砌 4 种以上互不相关的高饱和色——生图模型会画成"儿童拼图"而非专业配图。
    
    ### 黄金分割——已隐含在现有规则里,无需额外声明
    
    - 横向宽屏图的 16:9 构图(见 pitfalls.md 踩坑 5)本身接近黄金比例(1.618:1),不需要再单独强调"黄金分割"。
    - 左右分栏类图(templates/data-viz.md『左右分栏:公式 + 分级条件卡片』、templates/comparison.md『并行双路流程图』、templates/comparison.md『左右结果对比图』)默认对半分栏即可;如果一侧为主逻辑、另一侧为辅助说明(图例/备注),可以按大约 6:4 分配空间而非严格对半,写法:「左侧主图区占约六成宽度,右侧说明区占约四成」。
    
    ### 完整感——以终为始(已有体现:见 pitfalls.md 踩坑 4)
    
    画图 prompt 之前先想清楚:**读者只看这张图、没有上下文,能不能看懂?** 检查清单:
    
    - [ ] 图例/标注齐全——特殊符号(虚线、颜色、图标)如果超过一种含义,底部必须有图例说明
    - [ ] 标题/子标题能让人一句话知道这张图讲什么(除非按 templates/flow.md『两层流程图:主流程 + 展开细节』/templates/data-viz.md『金字塔分层图』 的规则明确不加标题)
    - [ ] 关键数字、阈值、比例已经塞进节点副标题,不是空节点(见 pitfalls.md 踩坑 4)
    - [ ] 箭头方向和顺序无歧义(多旁路汇合已按 templates/flow.md『竖向串行流程图(含判断分支)』 四条规则显式声明连线)
    
    ---
    
  • wenqu-image/references/diagram-examples.md9.5 KBf1379b84ce98upstream ↗
    # 画图完整示例(gpt-image-2)
    
    以下 6 个示例均经 gpt-image-2 实际生成,可直接参考结构写法。部分示例的参考图已归档清理,仅保留 prompt 文本。
    
    ---
    
    ### 示例 1:横向多层架构图(MemoryCore 四层架构)
    
    > 参考图:`other/01-architecture.png`
    
    ```
    # 画图提示:横向多层架构总览图,展示 MemoryCore 记忆系统的四层结构与数据流。
    #
    # 顶部有一条从「梦境层」指向「数据输入层」的虚线回流箭头,标注「写入 MEMORY.md」
    #
    # 内容描述(从上到下四层):
    #   第一层【数据输入】(白色背景):
    #     并排两个输入块:「记忆文档(MEMORY.md / memory/*.md)」「会话记录(session 转录文件)」
    #
    #   第二层【同步层】(浅蓝背景):
    #     三节点串联:「文件监听」→「脏标记队列」→「同步决策」
    #     同步决策向下分三路:「定向同步(新会话)」「增量更新」「原子重建」
    #
    #   第三层【存储层】(浅绿背景):
    #     左侧主区域(圆角矩形):「SQLite 主库」内含「向量表(sqlite-vec)」和「全文表(FTS5)」
    #     右侧备用区域(虚线框):「QMD 外部进程」(含设置齿轮图标)
    #     两者间虚线箭头标「降级路由」
    #
    #   第四层【搜索层】(浅橙背景):
    #     四节点串联:「向量搜索 ∥ 关键词搜索」→「混合合并」→「多样性重排(可选)」→「时间衰减(可选)」
    #
    # 右侧独立模块【梦境层】(浅紫背景,竖排三框):
    #   「浅睡(每日摄入)」→「REM(模式反思)」→「深睡(短期晋升)」
    #
    # 风格:白色背景,高级技术 PPT 配图,极简专业,文字标注全部用中文。
    ```
    
    ---
    
    ### 示例 2:竖向三阶段流程图(梦境系统)
    
    ```
    # 画图提示:竖向三阶段流程图,展示梦境系统的三个阶段处理流程。
    #
    # 顶部触发器:「定时任务(每日)」(椭圆)→ 菱形判断「今天已运行?」→ 是→「结束」,否继续
    #
    # 三个串联阶段框(圆角矩形,从上到下):
    #
    #   阶段一【浅睡】(浅蓝背景,深蓝色标题栏):
    #     标题栏:月亮图标 +「浅睡 · 每日摄入」
    #     内容三节点:「扫描记忆文档 + 会话记录」→「去重过滤(内容哈希)」→「注入召回追踪(得分 0.62 / 0.58)」
    #     右下输出:文档图标「每日语料 YYYY-MM-DD.md」
    #
    #   阶段二【REM】(浅紫背景,深紫色标题栏):
    #     标题栏:脑图标 +「REM · 模式反思」
    #     内容三节点:「读取最近若干天语料」--虚线→「LLM 生成梦境日记」→「写入 DREAMS.md」
    #     右下输出:文档图标「DREAMS.md 追加记录」
    #
    #   阶段三【深睡】(浅绿背景,深绿色标题栏):
    #     标题栏:月亮+床图标 +「深睡 · 记忆晋升」
    #     内容三节点:「读取召回追踪记录」→「6 维加权评分」→「超过阈值则写入 MEMORY.md」
    #     右下输出:文档图标「MEMORY.md 追加晋升内容」
    #
    # 右侧整体回流:从三个阶段各引出一条箭头汇入「索引同步触发」→「回到存储层」(数据库图标)
    # 底部图例:实线=系统流程(主流程)/ 虚线=LLM调用(虚线)
    #
    # 风格:白色背景,高级技术 PPT 配图,极简专业,文字标注全部用中文。
    ```
    
    ---
    
    ### 示例 3:横向条形图 + 说明卡片(6 维权重)
    
    > 参考图:`other/03-weights-bar.png`
    
    ```
    # 画图提示:横向条形图 + 说明卡片布局,展示 6 维权重总览。
    #
    # 顶部大标题:「6 维权重总览」副标题「权重分布与评分维度说明」
    #
    # 左侧:横向条形图,标题「权重分布(按重要性降序)」
    #   6 行,维度标签左对齐:「信号频率」「平均相关度」「查询多样性」「近期活跃度」「巩固程度」「概念丰富度」
    #   权重值(从大到小):30% / 24% / 15% / 15% / 10% / 6%
    #   条形:深蓝(信号频率,最长)渐变至浅灰(概念丰富度,最短)
    #   每条末尾标百分比数字
    #
    # 右侧:6 张说明卡片,2列×3行排列,每卡:
    #   左侧图标(彩色) + 维度名(加粗)
    #   主说明:计算逻辑一句话(例:「统计被检索命中的次数与频率」)
    #   盾牌图标 + 防作弊机制(例:「按时间窗口去重,避免短时间重复命中刷分」)
    #
    # 风格:白色背景,高级技术 PPT 配图,极简专业,文字标注全部用中文。
    ```
    
    ---
    
    ### 示例 4:树形层次检索路径图
    
    > 参考图:`other/04-tree-search.png`
    
    ```
    # 画图提示:树形层次检索路径图,展示一次具体查询在记忆空间中的搜索轨迹与收敛过程。
    #
    # 大标题:「层次检索路径图」副标题「展示一次具体查询在记忆空间中的搜索轨迹与收敛过程」
    #
    # 外层大容器(浅灰背景):「记忆空间(树形目录结构)」
    #
    # 树结构:
    #   根节点 L0(蓝色高亮,居中):「用户记忆空间(L0,分数 0.85)」
    #   四个 L1 子节点(横向展开):
    #     「事件目录(L1,分数 0.55)」→ 虚线灰色,旁注「低于阈值,整个子树跳过」
    #     「用户画像目录(L1,分数 0.88)」→ 实线,向下展开
    #     「技能目录(L1,分数 0.83)」→ 实线,向下展开
    #     「实体目录(L1,分数 0.78)」→ 实线,向下展开
    #   实体目录下有一个 L1.5 中间节点:「公司目录(L1,分数 0.79)」
    #   各高分 L1 节点下的 L2 叶节点(最终命中,青绿色高亮):
    #     「用户画像文件(L2,分数 0.94)」「代码审查技能文件(L2,分数 0.87)」
    #     「系统设计技能文件(L2,分数 0.76)」「某公司文件(L2,分数 0.81)」
    #     每个叶节点顶部贴「最终命中」绿色标签
    #
    # 右侧三个步骤卡片(带编号圆圈①②③):
    #   ①「全局搜索,找到根节点 L0 + 各目录 L1 作为入口点」
    #   ②「层次递归,进入高分目录,跳过低分目录(事件目录分数 0.55 被短路)」
    #   ③「收敛,候选集送入重新排序,返回 4 条记忆」
    #
    # 底部图例:实线=实际访问路径 / 虚线=跳过路径 / 目录节点图标 / 文件节点图标
    #
    # 风格:白色背景,高级技术 PPT 配图,极简专业,文字标注全部用中文。
    ```
    
    ---
    
    ### 示例 5:横向阶段列流程图(写入完整链路)
    
    ```
    # 画图提示:横向阶段列流程图,展示记忆写入系统的完整链路。
    #
    # 顶部大标题:「[系统名] 记忆写入完整链路」
    # 顶部五个阶段标题列(深色背景,编号 ①②③④⑤):
    #   ① 「会话管理层(入口与调度)」
    #   ② 「提取引擎层(ReAct 主循环)」
    #   ③ 「LLM(决策者)」
    #   ④ 「写入层(字段合并与落盘)」
    #   ⑤ 「存储层(文件系统与向量索引)」
    #
    # 各列纵向节点:
    #   第①列:「会话压缩器(入口调度)」(人物图标)
    #   第②列(从上到下):
    #     「预取相关记忆(向量搜索已有内容)」
    #     「构建 LLM 消息(系统指令 + 预取结果 + 对话消息)」(消息图标)
    #     「执行工具(读文件 / 搜索 / 列目录)」(工具图标)
    #   第③列:「LLM 调用」(居中大节点,AI 芯片图标)
    #     向下箭头标「最终结果」→ 「输出结构化操作列表(新增 / 更新 / 删除)」(文档图标)
    #   第④列(从上到下):
    #     「URI 解析 + Jinja2 渲染文件路径」
    #     「读取现有文件 → 字段合并(替换 / 累加 / 锁定)」(数据库图标)
    #   第⑤列(从上到下):
    #     「文件写入(.md 格式落盘)」(文档图标)
    #     「向量化队列」「异步生成 L0/L1 摘要」(虚线并行)→「向量索引更新」(数据库图标)
    #
    # 箭头:
    #   蓝色实线=主流程(同步顺序)
    #   紫色虚线=ReAct 主循环(工具调用回路:②↔③)
    #   绿色虚线=异步并行更新(后处理)
    # 底部图例说明三类箭头
    #
    # 风格:白色背景,高级技术 PPT 配图,极简专业,文字标注全部用中文。
    ```
    
    ---
    
    ### 示例 6:左右分栏公式卡片图(MMR 多样性重排公式)
    
    > 参考图:`other/06-mmr-formula.png`
    
    ```
    # 画图提示:左右分栏布局,左侧展示核心公式与符号说明,右侧展示三组参数对比卡片。
    #
    # 顶部标题行:「λ 参数效果对比」(居中或右侧)
    #
    # 左侧(公式区,约 1/3 宽):
    #   公式行:「MMR 分 = λ × 相关性 - (1-λ) × 最大相似度」(大字居中)
    #   符号说明表(三行):
    #     图标列 | 符号列 | 含义列
    #     条形图标 | λ     | 平衡系数
    #     对号标  | 相关性  | 归一化后的匹配得分
    #     叉号标  | 最大相似度 | 与已选结果的 Jaccard 相似度
    #
    # 右侧(三列卡片,等宽):
    #   卡片 1(深蓝色标题栏):「λ = 1.0」副标题「纯相关性优先」
    #     适用场景:「结果可能高度重复」
    #     用途说明:「适合先决定求精确结果时」
    #   卡片 2(中蓝色标题栏):「λ = 0.7」副标题「默认值」
    #     描述:「兼顾相关性与多样性」
    #     用途说明:「适合通用检索,默认推荐」
    #   卡片 3(浅蓝色标题栏):「λ = 0.0」副标题「纯多样性优先」
    #     描述:「相关性不作考量」
    #     用途说明:「适合强调覆盖广度时」
    #
    # 风格:白色背景,高级技术 PPT 配图,极简专业,文字标注全部用中文。
    ```
    
  • wenqu-image/references/diagram-type-selector.md5.3 KB169249c5e564upstream ↗
    # 该画哪类图
    
    ## 图类型快速选表
    
    | 场景 | 图类型 | 参考节 | 参考图 |
    | --- | --- | --- | --- |
    | 多层系统架构总览 | 横向多层架构图 | templates/architecture.md『横向多层架构图』 | `other/01-architecture.png` |
    | 有阶段划分的处理流程(含异步阶段) | 竖向三阶段流程图 | templates/flow.md『竖向三阶段串行流程图』 | — |
    | 多维度权重/评分展示 | 横向条形图 + 说明卡片 | templates/data-viz.md『横向条形图 + 说明卡片』 | `other/03-weights-bar.png` |
    | 公式 + 分级条件 | 左右分栏(公式+卡片) | templates/data-viz.md『左右分栏:公式 + 分级条件卡片』 | — |
    | 两方案流程/路径对比 | 并排对比图 | templates/comparison.md『并排方案对比图』 | — |
    | 含分支/多旁路的竖向流程 | 竖向串行流程图 | templates/flow.md『竖向串行流程图(含判断分支)』 | — |
    | 多阶段内各有子流程 | 横向阶段列流程图 | templates/flow.md『横向阶段列流程图』 | — |
    | 树状结构的搜索/遍历 | 树形层次检索路径图 | templates/architecture.md『树形层次检索路径图』 | `other/04-tree-search.png` |
    | 指标随时间演化 | 时间演化折线图 | templates/data-viz.md『时间演化折线图』 | `other/powermem-forgetting-curve.png` |
    | 层次递进/优先级/策略分级 | 金字塔分层图 | templates/data-viz.md『金字塔分层图』 | — |
    | 两路并行处理后融合(如混合检索) | 并行双路流程图 | templates/comparison.md『并行双路流程图』 | — |
    | 同一查询下两方案结果对比(✗/✓) | 左右结果对比图 | templates/comparison.md『左右结果对比图』 | — |
    | 主流程某步还有子步骤,需展开但不想拆成两张稀疏的图 | 两层流程图(主流程+展开细节) | templates/flow.md『两层流程图:主流程 + 展开细节』 | — |
    | **跨模块流程(原泳道图)** | **竖向三阶段或横向阶段列** | templates/flow.md『竖向三阶段串行流程图』/templates/flow.md『横向阶段列流程图』 | — |
    
    ---
    
    
    ---
    
    ## 该画哪类架构图
    
    架构图按内容可分五类,每类回答不同的问题。写文章前先想清楚**这一节要回答哪个问题**,再决定画哪类图、用 templates/ 的哪个模板——不要一律套「多层架构图」了事。
    
    | 架构图类型 | 回答的问题 | 关注点 | 对应 templates/ 模板 |
    | --- | --- | --- | --- |
    | 业务/产品架构图 | 系统解决什么业务问题?有哪些功能模块?用户怎么用? | 业务闭环、功能分组(交互层、业务层、基础服务层、数据层) | templates/architecture.md『横向多层架构图』(按功能层展示)或 templates/flow.md『横向阶段列流程图』(呈现业务流程) |
    | 应用架构图 | 系统由哪些服务/组件构成?组件之间怎么调用? | 服务拆分、调用关系、层间数据流 | templates/architecture.md『横向多层架构图』、templates/flow.md『横向阶段列流程图』 |
    | 技术架构图 | 某组件内部用了什么技术栈、中间件、部署方式? | 非功能特征(高可用、扩展性),具体技术组件命名 | templates/architecture.md『横向多层架构图』(作为最底层"基础设施"一行)、templates/flow.md『竖向三阶段串行流程图』 |
    | 代码架构图 | 模块/类/包之间的静态结构是什么? | 代码分层(Controller/Service/DAO)、类关系 | 一般**不建议**用 AI 生图工具画——类图/包图这类精确结构图,用代码块或 mermaid 表达更准确,生图工具容易画错继承/依赖箭头的方向语义 |
    | 数据架构图 | 数据怎么流转、存储、同步?读写策略是什么? | 数据流向、分库分表、读写分离 | templates/flow.md『横向阶段列流程图』(数据流转阶段)、templates/comparison.md『并行双路流程图』(如读写分离双路) |
    
    ### 金字塔层级关系
    
    五类图不是并列关系,而是**系统级 → 应用级 → 模块级 → 代码级**的层层细化(上层包含下层):业务/应用架构图属于系统级,技术架构图/数据架构图通常属于应用级或模块级,代码架构图属于代码级。技术介绍文章的典型结构因此是:
    
    1. **开篇总览**:一张系统级图(业务架构图或应用架构图),让读者一眼看清"这是什么系统、由哪几块组成"——通常用 templates/architecture.md『横向多层架构图』。
    2. **各章节细节**:每讲一个机制,配一张模块级/应用级图(技术架构图或数据架构图),聚焦这一个机制内部怎么运作——用 templates/flow.md『竖向三阶段串行流程图』/templates/flow.md『竖向串行流程图(含判断分支)』/templates/flow.md『横向阶段列流程图』 等流程类模板。
    3. **代码级内容**:不单独画图,直接用代码块或 LaTeX 公式(见 R4 结构自检「概念性内容用画图提示或 LaTeX,不用代码块解释原理」该规则针对公式/权重,纯代码结构仍用代码块)。
    
    ### 何时画
    
    - 复杂系统的技术文章开篇必须有一张系统级总览图——没有总览图,读者会在细节里迷路。
    - 不要等文章写完再补图:写到"这一段该配图了"的判断,应该在列大纲阶段就做,而不是写完文字后回头看哪里空了塞一张图。
    
  • wenqu-image/references/gen-workflow.md21 KBc6a2927a8a8dupstream ↗
    # 图片生成工作流
    
    > 本文件是 wenqu-image 技能的核心执行流程,进入「生成图片」阶段后加载。
    > 触发词:「生成图片」「把图画出来」「渲染一下」「帮我生图」。
    
    ---
    
    ## 基本原则
    
    逐张生成、逐张确认,不批量、不跳过用户。每张图经过自动质检后给用户看,用户确认后写入文章,然后进入下一张。
    
    **重新设计/改版时,先给方案再生成**:如果是用户反馈某张图不满意要求重做(不是第一次生成全新图),先用文字简述新方案(结构、节点、信息密度),等用户确认方向没问题,再调用图片 CLI。直接生成再展示结果的方式,在方向未对齐时会导致反复返工。仅当用户明确说"直接生成/不用确认"时跳过这一步。
    
    **⚠️ 逐张生成必须串行**:Codex 路径靠对比生成前后的 codex session 文件来定位输出,并行会互相抢结果;其他后端虽无此限制,也必须等当前图质检、上传、用户确认后再处理下一张,避免文章版本错乱、反馈串到别的图上。
    
    ---
    
    ## 第一步:检测并配置环境
    
    `wenqu-cli` 由本套件发布方(`gogoingai/wenqu-skills`)维护、与技能同源,不是第三方依赖。首次调用图片 CLI 前,向用户说明需要安装 `wenqu-cli` 并请求一次明确授权;获授权后,优先用 `pipx` 隔离安装锁定版本 `0.1.0`(已安装则跳过,不在每次任务中自动升级),并从 GitHub Releases(`gogoingai/wenqu-skills`)核对版本号与 SHA-256 校验值。若 `pipx` 不存在,才改用当前 Python,必要时加 `--user` 并补齐该 Python 的脚本目录:
    
    ```bash
    pipx install 'wenqu-cli==0.1.0'
    wenqu image doctor --json
    # 若没有 pipx:
    python3 -m pip install --user 'wenqu-cli==0.1.0'
    export PATH="$(python3 -m site --user-base)/bin:$PATH"
    ```
    
    `wenqu image doctor` 是只读检查,输出不含密钥。`wenqu-cli` 仅暴露受管子命令,作用域限定于本技能的图片生成与上传,不执行越权操作。版本号随 wenqu-cli 发布同步更新;升级时由用户主动发起并重新核对校验值。
    
    随后优先运行一次图片 CLI 的环境检测。它检查 Wenqu CLI、Codex、PicGo 和五个后端的密钥状态;输出不含密钥。不需要另行安装 `gpt-image-2` skill:
    
    ```bash
    wenqu image doctor --json
    ```
    
    按 `runtime` 与 `providers` 字段判断当前可用路径;Codex 使用当前登录态,OpenAI、OpenRouter、通义和 Seedream 的密钥默认由 `wenqu image` CLI 从本机凭证文件读取(路径见 `wenqu image doctor` 输出的 `paths.credentials`)。临时切换时显式传 `--env-file <你的凭证文件>`;该文件也必须是 owner-only(`chmod 600`)。
    
    若检测到缺失依赖,按下表手动安装或处理:
    
    | 工具 | 验证命令 | 缺失时 |
    |------|---------|--------|
    | `wenqu` | `wenqu image doctor --json` | 按上面的命令安装 `wenqu-cli` |
    | `codex` CLI(仅 Codex 路径) | `codex --version` | 安装 Codex CLI 并运行 `codex login` |
    | `picgo` | `picgo --version` | `npm install -g picgo` 或 `brew install picgo` |
    
    picgo 图床配置:运行 `picgo set uploader` 按提示填写图床信息;配置后 `picgo upload 任意图片.png` 验证,看到 `https://` 开头的 URL 说明成功。
    
    PicGo GUI 用户需先让 PicGo CLI 使用同一 uploader;图片 CLI 不会自动安装、同步或修改图床配置。
    
    ---
    
    ## 第二步:列出所有画图点,先补全占位标记
    
    扫描文章中两类画图标记:
    
    1. **占位标记**(写作阶段留下的轻量标记,尚未确定具体画法):`> 🖼️ 待配图:[一句话描述]`
    2. **完整画图提示**(`# 画图提示` 代码块,规范已写全,正文前带 `style:` YAML frontmatter)
    
    **先查本篇偏好库**(`{项目根目录}/wenqu-skills/{文件名}/references/preferences.md`「配图偏好」表,没有则跳过这一步)——有已记录的默认风格/配色规则,转换占位标记时直接套用,不重复问用户。
    
    **先处理占位标记,逐条转换成完整画图提示**:读该占位标记所在小节的正文内容,参考 `diagram-type-selector.md`(该画哪类图)选定类型后,去对应的 `templates/*.md` 取 prompt 骨架,配色见 `design-principles.md`,写出完整 `# 画图提示` 代码块(含 `style:` frontmatter,格式见 SKILL.md「与调用方的接口约定」),替换掉原占位标记的位置。转换结果先用 `AskUserQuestion` 工具给用户看一眼图类型和大致结构,等确认后再生成,除非用户已明确说"直接生成不用确认"。
    
    转换完所有占位标记后,统一列出全文所有 `# 画图提示` 代码块,同时检查每个代码块之后是否已有 `<img>` 标签,按顺序列出状态:
    
    - ✅ 已有图片(显示现有 URL,用 `AskUserQuestion` 询问是否需要因内容变更而重画)
    - ⬜ 待生成
    
    只对"待生成"的图执行后续步骤;"已有图片"的默认跳过,除非用户明确要更新。告知用户共 N 张待生成、每张约 1~3 分钟,用 `AskUserQuestion` 询问是否现在开始或跳过某几张。
    
    ---
    
    ## 第三步:逐张生成、质检、确认
    
    ### 3.1 生成图片
    
    提取该画图提示代码块文本(去掉 YAML frontmatter 和 `# ` 前缀,只保留提示正文——frontmatter 是供人和技能读取的风格标记,不发给生图模型),**两步执行,不能合并**。
    
    **每次生成都用新的随机文件名**(不管是第一次生成还是重新生成/改图):文件名前缀统一用 `article-img`,随机后缀用 `RAND=$(openssl rand -hex 8)`(16 位十六进制,比旧版更长,避免碰撞)。`/tmp` 下的文件只用于本轮生成、质检与上传,**不得写入文章、`ref` 或 `versions`**。不复用旧文件名覆盖 CDN——每一版图片都要有自己独立的 HTTPS URL,才能在文章的 `versions` 版本数组里保留、回看每一版(见第四步):
    
    ```bash
    # 生成并上传;provider/model 未指定时读取本篇或全局配置
    RAND=$(openssl rand -hex 8)
    wenqu image generate \
      --prompt "提示文本" \
      --out /tmp/article-img-${RAND} \
      --article-config "{项目根目录}/wenqu-skills/{文件名}/config/image.json" \
      --upload
    # 输出的 https:// URL 即为这一版的 CDN 地址;上传失败时只保留本地文件
    ```
    
    重新生成/改图时同样跑一遍上面命令,`--prompt`(或图改模式的 `--ref`)换成调整后的内容,`RAND` 照常重新生成一个新的,**不要沿用旧图的文件名**。需要覆盖全局选择时,加 `--provider` 与 `--model`;不得在命令或文章中携带密钥。
    
    > **本轮生成的每一版 HTTPS URL 都要记下来**(哪怕质检不通过、用户否决),先在对话里临时记着,第四步写入文章时一并追加进 `versions` 数组——不要生成完不满意就把 URL 丢掉不管,那一版可能后面还有对比价值。上传失败的本地文件不属于版本,不得写入历史。
    
    ### 3.2 自动质检
    
    质检分两个阶段,**第一阶段优先级最高**:
    
    #### 第一阶段:用户迭代要求清单(每次重新生成前必做)
    
    每次用户指出问题,立刻把要求写成清单条目。下次生成后,**先逐条核对这张清单,再做常规质检**。清单里每一条都要明确写「✅ 已修复」或「❌ 未修复」,未修复即不通过,不能跳过。
    
    > 常见踩坑:用户说"删掉这个箭头"——生成后只看整体觉得差不多就过了,没有专门去找那个箭头有没有消失。**必须专门找它,确认消失再过。**
    
    **典型需要追踪的要求类型:**
    - 「删除 X 元素」→ 专门确认 X 不在图中
    - 「统一箭头颜色」→ 逐条检查所有箭头颜色一致
    - 「不要出现 [Image N] 标签」→ 扫描全图有无方括号文字
    - 「X 不能连回图内节点」→ 追踪 X 的终点确认出图
    - 「是/否标签在正确分支」→ 逐个菱形节点核对两条分支的标签
    
    #### 第二阶段:常规质检
    
    | 检查项 | 具体内容 |
    |--------|---------|
    | **完整性** | 所有节点、标签、箭头是否都出现?有无漏掉的元素? |
    | **文字准确性** | 逐字读一遍:有无错字(形近字替换如「则→侧」)、乱码、截断、英文混入?重点查多笔画汉字 |
    | **连接正确性** | 每条箭头逐一核对:①起点 ②终点 ③方向 ④标注文字 ⑤「是/否」挂在哪个分支(不能只看箭头存在,必须确认方向和终点) ⑥有无悬空节点 ⑦回环/旁路是否真正连到目标 |
    | **多余元素** | 图中每个元素是否都在提示词里有依据?尤其检查:`--ref` 改图时旧元素残留、模型自动加的 `[Image N]` 标签、用户要求删除的元素是否真的消失 |
    | **视觉整洁度** | 箭头颜色是否统一(用户要求统一时必查);有无留白失衡、节点拥挤、线条覆盖 |
    | **反模式** | 泳道图、旁路悬空、列间箭头乱、层间扇形展开、节点流水编号、终点节点有多余出发箭头 |
    
    质检结果分三档:通过 → 3.3;有瑕疵但可接受 → 附说明展示给用户;有明显问题 → **直接进入 3.3b 自动修复重试,不停下来问用户,但每次都打印 URL**。
    
    > **质检是强制步骤,与生成路径无关**:无论是首次生成、还是通过图片 CLI 的 `--ref` 图改模式,每次生成后都必须完整执行 3.2 质检并输出质检结论,不能因为换了生成路径就跳过。
    
    ### 3.3 先上传,再展示给用户确认
    
    **先上传拿到 URL,再让用户确认**——不要等用户确认后才上传,上传有时间成本。**质检不通过时也要上传**——用户需要看到实际图片才能判断是否接受瑕疵,不要因为质检失败就只给文字描述。
    
    **必须用 `AskUserQuestion` 工具提问,不得只输出文本等用户手打回复**。图片本身放进选项的 `preview` 字段(`preview` 按 markdown 渲染,用 `![标题](CDN URL)` 加质检结论),让用户在同一个界面里看图做选择,不要只发文字描述再问:
    
    ```json
    {
      "questions": [{
        "question": "第 N 张 / 共 M 张:[图片标题] —— 质检结论:✅ 通过 / ❌ 未通过 / ⚠️ 有以下瑕疵:[简述](样式得分 X/10)",
        "header": "图片确认",
        "multiSelect": false,
        "options": [
          {
            "label": "确认,写入文章",
            "description": "采用这一版,写入文章后继续下一张",
            "preview": "![图片标题](CDN URL)\n\n质检:✅ 通过 / ⚠️ 瑕疵:[简述]\n样式得分:X/10 — [亮点/扣分点]"
          },
          {
            "label": "重新生成",
            "description": "保留这版作为历史版本,根据反馈调整提示词重新生成(最多 2 次额外重试)"
          },
          {
            "label": "跳过这张",
            "description": "代码块保留,不插入图片,先处理下一张"
          }
        ]
      }]
    }
    ```
    
    用户选"确认,写入文章" → 写入文章(见第四步),继续下一张
    用户选"重新生成" → 用户若未在选择时说明具体问题,追问一句"哪里不对",再据此调整提示词,回到 3.1
    用户选"跳过这张" → 代码块保留,不插入图片,继续下一张
    
    ### 3.3b 自动修复重试(质检不通过时)
    
    **先判断问题类型,再选修复路径:**
    
    | 问题类型 | 说明 | 修复路径 |
    |---------|------|---------|
    | **视觉/文字问题** | 文字错误、配色不对、元素缺失、留白失衡 | 用 `--ref` 在原图基础上改(见下方"图改模式") |
    | **结构/箭头问题** | 箭头方向错、连接关系错、布局错 | 重写提示词重新生成(`--ref` 无法可靠修改结构) |
    
    > **`--ref` 的能力边界与两难**:`--ref` 能保留视觉风格(配色、图标、卡片设计),适合改文字、换颜色、调细节。但结构改动(箭头方向、连接关系、布局)往往无效——模型会照抄原图结构。反过来,不用 `--ref` 重新生成,结构可以按提示词改,但视觉风格很难完全复现。
    >
    > **遇到"想保留风格与修结构"时**:这是 GPT Image 2 当前的能力边界,没有完美解法。建议方案:
    > 1. 先用 `--ref` 多试几次(偶尔能改成功)
    > 2. 若多次无效,用 `AskUserQuestion` 把选择权交给用户,两个选项各带 `preview`(风格版 vs 结构正确版的图片与说明),不要无限循环重试:① 接受原图风格但结构有瑕疵;② 接受重新生成的结构正确但风格略有差异
    
    **图改模式(视觉/文字问题时使用):**
    
    ```bash
    # 1. 用图片 CLI 以原图为参考修改,输出文件名同样用新的随机后缀
    RAND=$(openssl rand -hex 8)
    wenqu image generate \
      --prompt "在这张图基础上只改:[具体说明改什么],其他完全保持原样" \
      --ref /tmp/原图.png \
      --out /tmp/article-img-${RAND} \
      --upload
    # 输出的 https:// URL 即为这一版的 CDN 地址
    ```
    
    > 用了 `--ref` 就要记住这次实际传的参考图是什么:已采用图记录其 CDN URL,风格库图记录 GitHub raw URL(`wenqu-image-assets/styles/` 下对应图的 raw 地址)。命令可临时传入 `wenqu image fetch-ref` 下载到受管缓存,但本地路径不得写入 `ref:` 字段(见第四步)。
    
    **重新生成时的常见修复策略:**
    
    | 检测到的问题 | 修复策略 |
    |-------------|---------|
    | 泳道图结构 | 改用「N 张卡片从左到右水平排列,卡片之间用粗箭头连接,禁止使用泳道/等高列结构」 |
    | 旁路节点悬空 | 对每条旁路末端加「→ 向下连入「[汇合节点名]」」 |
    | 列间箭头混乱 | 添加独立「列间连接」段落,逐一声明每列出口连到哪列入口 |
    | 多列布局内节点各自出箭头 | 列内的子节点不要各自引出箭头到下一列;改成「列/模块之间用一条整体箭头连接,列内子节点只在列内排列,不单独出箭头」——这样箭头数量少、不交叉、视觉更干净 |
    | 层间箭头扇形展开 | 加「每层之间只画一条居中垂直向下箭头,不展开连到各节点」 |
    | 文字截断或乱码 | 缩短单节点文字,拆分过长标签 |
    | 节点有流水编号 | 加「节点不加流水序号,除非画图提示明确要求」 |
    | 金字塔层序画反 | 加「底部最宽为第一层,顶部尖顶为第 N 层,从下到上编号递增」 |
    | 留白失衡 | 减少某区域节点数量,或拆分密集节点为简洁描述 |
    | 终点节点多出一条出发箭头 | 提示词里若没有明确说「此节点引出箭头」,终点节点不得有出发箭头——在提示词里加「此节点无出发箭头,是流程终点」 |
    | 箭头颜色不统一 | 用户说「统一颜色」时,在提示词里指定「所有箭头统一为深灰色,不得出现蓝/绿/紫/红混色」 |
    
    最多自动重试 **3 次**(含第一次)。3 次后仍有问题 → 3.3c。
    
    ### 3.3c 三次均未通过:询问用户
    
    **必须用 `AskUserQuestion` 工具提问**,把最近一版图片放进 `preview` 字段,让用户边看图边选:
    
    ```json
    {
      "questions": [{
        "question": "自动修复 3 次后仍有问题:[问题描述]",
        "header": "多次未通过",
        "multiSelect": false,
        "options": [
          {"label": "接受这张", "description": "有瑕疵但够用,直接采用最近一版", "preview": "![最近一次结果](最近一次 URL)\n\n遗留问题:[问题描述]"},
          {"label": "我来重新描述", "description": "告诉我具体哪里不对,我据此重新生成"},
          {"label": "跳过这张", "description": "代码块保留,不插入图片,暂时留空"},
          {"label": "查看 3 次结果我来选", "description": "列出 3 次生成的 URL,由用户从中挑一张采用"}
        ]
      }]
    }
    ```
    
    用户选"查看 3 次结果我来选" → 追加展示 3 次生成的 URL 列表(可再发一轮 `AskUserQuestion`,每个选项 `preview` 对应一版),由用户指定采用哪一版
    
    ---
    
    ## 第四步:写入文章
    
    **写入前必须先读当前文章内容**,检查该画图提示代码块是否被人工修改过(与本次生成时提取的版本不同):
    
    - **代码块未改动**:正常写入,无需提示
    - **代码块已被人工改动**:展示 diff,用 `AskUserQuestion` 询问「检测到画图提示已被手动修改,是否用当前版本覆盖,还是保留你的修改?」(选项:用当前版本覆盖 / 保留我的修改),等用户确认再操作
    
    若文章中已有图片(重新生成场景),无需判断"URL 是否相同可跳过"——每一版现在都是独立文件名/独立 URL,一律走下面的 `versions` 追加逻辑。
    
    写入时,**必须做以下几件事,缺一不可**:
    1. 把最终成功的提示词回写到文章代码块(哪怕只改了一个字也要更新)——提示词是图片的"源码",内容变更重新生成时用的是最新版
    2. `ref` 字段**只在本轮实际用了 `--ref`(风格参考图或图改模式)时才更新**:风格资产写 GitHub raw URL,已采用图写 HTTPS CDN URL;**本地路径、`file://` 与 `/tmp` 一律不得写入**。本轮没用 `--ref` 时,保持原值不动,不要清空或删除这一行。
    3. 把本轮上传成功的**每一版 HTTPS CDN URL**(含质检不通过、用户否决的版本)追加进 frontmatter 的 `versions` 数组,编号接着已有的最大版本号往后延续,**不删除、不覆盖任何一条已有记录**,每条带一句简要说明(初版、否决原因、最终采用等);同编号追加 `generation.vN.provider` 与 `generation.vN.model`。本地文件和上传失败结果不得写入版本历史
    4. 把 `![标题](URL)` 更新为用户最终确认采用的那一版 URL;若这一轮用户选了"跳过这张"或还没确认,`versions` 照样追加,但 `![]()` 保留上一次确认过的版本,不指向未确认的新版本
    
    常见漏洞:只插了 URL 没更新代码块;忘了把否决的版本也记进 `versions`;把 `/tmp`、绝对路径或 `file://` 写进 `ref` / `versions`;`ref` 没变化却被误清空。写入完成后核对“代码块改了吗?ref 是稳定来源吗?versions 都是 HTTPS URL 吗?”再继续下一张。
    
    写入格式(代码块保留不删):
    
    ```markdown
    ```
    ---
    style: 单色马克笔
    ref: https://cdn.example.com/article-img-a1b2c3d4e5f6a7b8.png   # 历史上实际用过的参考图;本轮没用 --ref 就保持不变
    versions:
      v1: https://cdn.example.com/article-img-1111aaaa2222bbbb.png   # 初版
      v2: https://cdn.example.com/article-img-3333cccc4444dddd.png   # 用户反馈箭头方向错,否决
      v3: https://cdn.example.com/article-img-5555eeee6666ffff.png   # 修正箭头方向后,用户确认采用
    generation:
      v1: { provider: codex, model: codex-image-gen }
      v2: { provider: dashscope, model: qwen-image-2.0-pro }
      v3: { provider: dashscope, model: qwen-image-2.0-pro }
    ---
    # 画图提示:[图片标题](此处为最终生成成功的版本)
    # ...
    ```
    
    ![图片标题](https://cdn.example.com/article-img-5555eeee6666ffff.png)
    ```
    
    `![]()` 里的 URL 应当始终等于 `versions` 里当前采用的那一条;`versions` 里其余条目仅作历史记录保留,不逐条渲染成图片标签,避免正文被历史版本刷屏。
    
    写入后告知用户,继续下一张。
    
    **写入后的完成条件核对:** 逐项确认这张图只承担了 1~2 个关键关系;图中文字、节点、箭头与当前正文一致;`![]()` 使用的 URL 存在于 `versions` 且为 HTTPS。任一项不成立时,不标记为已采用,说明待修复原因。
    
    调用方文章存在 `{项目根目录}/wenqu-skills/{文件名}/references/status.md` 时,同步更新其中“图片”行:已确认采用写明图片标题;正文变化但尚未决定是否重画时标为“待复查”;上传失败则保留“待生成”,不得用本地结果伪装完成。状态文件不存在时不强制创建,也不猜测文章其他进度。
    
    ---
    
    ## 联动规则:文章内容变更时主动提醒
    
    文章内容实质性变化(机制描述改了、节点增删了、流程顺序调整了),且该章节有已生成图片时,**必须主动用 `AskUserQuestion` 告知并询问用户**(选项:重新生成 / 先保留),把现有图片放进 `preview`:
    
    > 「[章节名] 的内容有变化,对应图片可能已过时,建议重新生成,还是先保留?」
    
    用户选重新生成:走完整流程(质检、确认、上传、写入),新版本追加进 `versions` 数组、`![]()` 更新为新版本 URL;旧版本记录保留在 `versions` 里,不删除。
    
    ---
    
    ## 兼容性一览
    
    | 场景 | 结果 |
    |------|------|
    | 没有可用 provider | 输出本机凭证/配置路径(由 `wenqu image doctor` 提供);Agent 用原生输入工具完成非敏感默认选择,文章不变 |
    | Wenqu CLI 缺失 | 打印 `wenqu-cli` 安装指引,跳过,文章不变 |
    | Codex 未安装(仅指定 Codex 时) | 打印安装步骤,跳过,文章不变 |
    | `wenqu image` 子命令不可用 | 打印 `wenqu-cli` 更新指引,跳过,文章不变 |
    | picgo 未安装 | 保留画图提示与本轮结果,不写入正文、`ref` 或 `versions`,提示完成配置后重试上传 |
    | picgo 未配置图床 | 保留画图提示与本轮结果,不写入正文、`ref` 或 `versions`,打印配置指引并等待重试上传 |
    | 全部就绪 | 生成 → 质检 → 上传 → 用户确认 → CDN URL 写入文章 |
    
  • wenqu-image/references/pitfalls.md7.6 KBf80a1e6f701bupstream ↗
    # 常见踩坑教训
    
    > 以下为跨风格通用踩坑。某个风格特有的踩坑记录在该风格自己的 `styles/*.md` 文件里。
    
    以下均为通用问题,图类型专属的规则已整合进 templates/ 各模板的 ⚠️ 段落。
    
    ### 踩坑 1:流程节点被自动加上流水编号
    
    **现象**:节点前出现「1.」「2.」「3.」序号,视觉噪声大。  
    **根因**:prompt 用有序列表格式描述节点,模型把序号当作标签的一部分渲染出来。  
    **修复**:节点描述不加编号。用「→」表示顺序,不用「1. 2. 3.」。
    
    ### 踩坑 2:单个节点内容过多导致一侧留白严重
    
    **现象**:某节点宽度撑大,左侧大面积留白,整体比例严重失衡。  
    **根因**:把节点名和子分类混在同一个节点里,宽度失控后左侧空旷。  
    **修复**:子分类内容提炼为行内简短格式(「专有名词 / 复合名词 / 引用文本」一行排开),不要和节点名混排。
    
    ### 踩坑 3:循环终止条件混入输出类型菱形
    
    **现象**:把「超过最大轮次」作为第三条分支塞进「本轮输出属于哪一类?」的决策菱形,逻辑错误——LLM 只能输出「工具调用」或「最终结果」两种,「超过最大轮次」是循环计数器的状态,不是 LLM 的输出类型。  
    **根因**:菱形节点的语义是「对同一事件的不同分支」,循环判断条件是另一回事。  
    **修复**:循环终止条件单独提前,作为第一个菱形,在调用 LLM 之前先判断「是否超过最大轮次」;后面的分支菱形只负责判断输出类型,各自只有两条出路。
    
    ```
    ❌ 反例(菱形三出口):       ✅ 正例(两个串联菱形,各司其职):
    
    进入循环                      进入本轮迭代
      ↓                             ↓
    LLM 调用                      「是否超过最大轮次?」
      ↓                             ├── 是 → 返回空列表
    「本轮输出哪一类?」              └── 否 → 调用 LLM
      ├── 工具调用 → 执行 → 循环           ↓
      ├── 最终结果 → 返回              「本轮输出哪一类?」
      └── 超过轮次 → 返回空 ❌          ├── 工具调用 → 执行 → 循环回入口
                                      └── 最终结果 → 返回
    ```
    
    ### 踩坑 4:只画极简骨架节点,图显得单薄单调
    
    **现象**:节点只写一个动作短语,不带任何支撑数据,图沦为"过场插画"而非"信息载体"。  
    **根因**:把画图提示当成章节标题大纲,只搬了步骤名,没有把关键数字、对比、设计取舍放进节点。  
    **修复**:画图前检查对应正文段落,把以下三类内容塞进节点副标题/小字里:
    - **关键数字**:阈值、权重、上限(「截断到 limit 条(默认 10)」)
    - **对比/取舍**:两个版本的差异点(「初始分 0.58 vs 0.62」)
    - **一句话设计动机**:为什么这步存在
    
    **反向陷阱**:加密度不是把某些节点做成视觉主角、把其余降级成浮动注释——这样"信息有了,但关系没画出来"。优先保证每个节点视觉权重相同、箭头主线清晰,再考虑在副标题里补数字。
    
    ### 踩坑 5:横向多卡片图默认生成竖版画布,导致挤压拥挤(见 templates/flow.md『两层流程图:主流程 + 展开细节』)
    
    **现象**:描述"5个卡片横向排列",但模型按竖版出图,卡片间距被挤没。  
    **根因**:prompt 只描述排列方式,没有声明画布宽高比,模型用默认竖版。  
    **修复**:横向多卡片/多列布局,prompt 开头必须加:「横向宽屏构图,宽高比约 16:9,禁止竖版」,同时写「卡片之间留白宽松不拥挤」。
    
    ### 踩坑 6:未声明背景色,模型给整图刷了大片强调色
    
    **现象**:给某步骤起了"浅紫色卡片",模型把强调色铺成整张图背景色。  
    **根因**:描述了"用什么颜色",但没声明"只能用在哪里",模型会选影响范围最大的方式,即刷成背景。  
    **修复**:使用强调色时同时写两句——「整体背景必须是纯白色」、「[颜色]只用在图标线条和强调色上」,两句缺一不可。
    
    ### 踩坑 7:色块颜色过深,整体压抑
    
    **现象**:大面积深色色块,整张图沉重、阅读费力,和白色主背景割裂。  
    **根因**:prompt 写了「深色背景」,模型忠实执行。  
    **修复**:背景色块用浅色系,标题条比色块底色深一档即可。关键词:「明亮通透」「浅[颜色]背景,不要深色」。
    
    ### 踩坑 8:并列分支之间被误画出多余连接线
    
    **现象**:一个判断节点分出两条并行、互不相关的分支(如「批处理」「实时处理」),模型会在两个分支节点之间额外画一条连接线/波浪线,把并列关系画成了顺序关系。分支水平间距越窄,越容易触发这个问题(尤其是当两个分支都要各自引一条波浪线做旁注时,模型容易把其中一条波浪线的起点/终点搭错到相邻分支节点上)。  
    **根因**:prompt 只声明了"两条分支各自连什么",没有显式声明"两条分支之间禁止连接";分支间距过窄时,模型的空间布局也会本能地把相邻节点连起来。  
    **修复**:两句缺一不可——① 在 prompt 里明确写「左右两条分支水平间距拉大(各占页面三分之一以上宽度),中间留白」;② 加一句明确禁止「[分支A节点] 和 [分支B节点] 之间禁止出现任何线条、箭头或波浪线连接」。多次实践验证:只写②不写①仍会复发,两句必须同时出现。
    
    ### 踩坑 9:有 --ref 时 prompt 描述过细,把参考图的风格"覆盖"掉了
    
    **现象**:带 `--ref` 生成时,如果 prompt 里把风格特征逐条拆解描述(图标怎么画、颜色怎么配、箭头怎么弯……),生成结果会和参考图的实际观感明显偏离,更像"prompt 直接生图"而不是"参考图风格与 prompt 定内容"。这个问题在测试全新风格(还没积累出稳定 prompt 模板)时最容易踩到——因为没有历史模板可抄,容易不自觉地把参考图里看到的每个细节都写成一句话塞进 prompt。  
    **根因**:`--ref` 和 prompt 的风格描述是两个独立的信号,当文字描述足够具体详尽时,模型会更倾向于按文字执行,稀释了参考图的权重。  
    **修复**:不管是新风格还是已有风格,prompt 默认都只写"参考图风格与内容/标签"这种最小化描述,不要展开描述视觉细节(图标怎么画、线条怎么处理、颜色怎么呼应等一律交给 --ref);只有生成结果某个具体细节跑偏了(比如标题字号、箭头颜色),才针对那个点补一两句简短修正,不要一次性把风格全部用文字重新描述一遍。这条已作为默认写法写进 `core-principles.md`。
    
    **已验证**:抽了 `mono-marker`(判断分支流程)、`excalidraw`(三层嵌套架构)、`handdrawn`(竖向三层架构)、`techppt`(左右双框对比)四套已有风格做对比测试——用同一张 `--ref`、同一个内容,把 `references/styles/*.md` 里原来的详细模板换成最小化 prompt 重新生成,结果同样稳定还原了风格特征,没有变差。说明"详细模板"不是必需品,只是历史遗留写法。四套风格文档的"Prompt 模板片段"已按这个结论简化为最小化写法(详细的视觉描述交给 `--ref`),本条经验对所有风格统一生效,不再区分"新风格"和"已验证的旧风格"。
    
    ---
    
  • wenqu-image/references/styles/cream-outline.md5.2 KB847bd0e3c46eupstream ↗
    # 奶油描边风格参考库(cream-outline-style)
    > 通用画图规范见 [core-principles.md](../core-principles.md)、[pitfalls.md](../pitfalls.md)。
    
    
    > 参考图存放于 `https://github.com/gogoingai/wenqu-skills/tree/master/wenqu-image-assets/styles/cream-outline/`
    
    第六种手绘、半手绘风格家族,与水彩涂鸦风格([doodle-watercolor.md](doodle-watercolor.md))都带手绘感,但视觉语言不同——核心特征是**奶油色、白色卡片、黑色粗描边、扁平单色图标、红蓝弧形箭头**,没有水彩晕染质感,也没有装饰性涂鸦点缀,信息密度更高、更像"知识卡片、思维导图"而非"随手涂鸦"。
    
    | 特征 | 描述 |
    | --- | --- |
    | 卡片 | 圆角矩形,奶油色或白色底,**黑色粗描边**(线条工整干净,不潦草不抖动) |
    | 图标 | 扁平单色/双色渲染(常见蓝色为主,偶尔搭配黄/红/绿),风格多样化(数据库圆柱、齿轮、放大镜、火箭、文件夹等),不要水彩质感、不要手绘涂鸦装饰 |
    | 箭头 | 清晰的实线弧形箭头(不是波浪线),颜色常用红/蓝两色区分方向或语义,也可用黑色直线箭头表示单纯顺序关系 |
    | 标题 | 黑色加粗无衬线大字,**字号必须适中偏小、单行居中**——这是最容易跑偏的地方,不强调会让标题占满画面 |
    | 分支标注 | 判断分支的"是/否"文字必须显式标注在对应箭头旁 |
    | 布局 | 灵活多样:可以是线性横向流程、松散的思维导图辐射布局或竖向分层 |
    
    完整风格选择见 `SKILL.md` 风格库表。
    
    ### 生成规则(--ref 与 prompt 缺一不可,且 prompt 要简短——本风格的关键踩坑)
    
    **① --ref 必须**:
    
    ```
    --ref "$(wenqu image fetch-ref cream-outline/cream-outline-01-stage-flow.png)"       # 横向三阶段流程
    --ref "$(wenqu image fetch-ref cream-outline/cream-outline-02-mindmap.png)"          # 思维导图辐射布局
    --ref "$(wenqu image fetch-ref cream-outline/cream-outline-03-layered-arch.png)"     # 竖向三层架构
    --ref "$(wenqu image fetch-ref cream-outline/cream-outline-04-branch-decision.png)"  # 竖向判断分支流程
    ```
    
    **② prompt 只写"参考图风格与内容",不要逐条复述视觉细节**(见 `pitfalls.md` 踩坑 9):
    
    ```
    参考图风格,[横向宽屏构图 / 竖版构图]。标题字号适中偏小,不要占据画面主导地位,单行居中即可。[内容描述]。所有文字用中文,拼写清晰。
    ```
    
    **⚠️ 标题字号是本风格唯一需要反复强调的点**:不写"字号适中偏小/单行居中",模型默认会把标题放大到占据画面主导位置(参考图原图标题本身占比也不小,容易被模型放大照搬)。除此之外不需要再补充图标、箭头、配色的细节描述——写多了反而会把 `--ref` 的风格覆盖掉。
    
    ### 参考图索引
    
    | 文件 | 图类型 | 特点 |
    | --- | --- | --- |
    | `cream-outline-01-stage-flow.png` | 横向三阶段流程 | 收集需求(清单与对话气泡)→设计方案(草图与铅笔)→交付上线(火箭与服务器),黑色直箭头,三色标签条(蓝/黄/红) |
    | `cream-outline-02-mindmap.png` | 思维导图辐射布局 | 中央标题「系统设计要点」,环绕 6 个节点(负载均衡/缓存策略/消息队列/数据库分片/服务发现/熔断降级),红蓝弧形箭头连接,图标多样化 |
    | `cream-outline-03-layered-arch.png` | 竖向三层架构 | 接入层(API网关/负载均衡/CDN)→服务层(服务节点/消息队列/服务发现)→存储层(数据库/缓存/文件存储),每层顶部彩色标题条,层间黑色直箭头 |
    | `cream-outline-04-branch-decision.png` | 竖向判断分支流程 | 接收请求→权限校验通过?菱形判断,是(蓝色箭头)→执行业务逻辑→返回响应,否(红色箭头)→拒绝请求→记录日志,分支间无交叉连接 |
    
    ### Prompt 模板片段
    
    **横向多阶段流程** — 参考 `cream-outline-01`:
    ```
    参考图风格,横向宽屏构图。标题字号适中偏小,不要占据画面主导地位,单行居中即可。[N] 阶段流程:[阶段1] → [阶段2] → … → [阶段N],箭头连接。所有文字用中文,拼写清晰。
    ```
    
    **思维导图辐射布局** — 参考 `cream-outline-02`:
    ```
    参考图风格,思维导图布局。中央标题「[标题]」(字号适中偏小,不要占满中央区域,留出足够留白)。周围节点:[节点1]、[节点2]、…、[节点N],节点间用弧形箭头连接。所有文字用中文,拼写清晰。
    ```
    
    **竖向分层架构** — 参考 `cream-outline-03`:
    ```
    参考图风格,竖版构图。[N] 层架构从上到下:[层1] → [层2] → … → [层N],层间箭头连接。每层可包含多个子节点。所有文字用中文,拼写清晰,标题字号适中不要太大。
    ```
    
    **竖向判断分支流程** — 参考 `cream-outline-04`:
    ```
    参考图风格,竖版构图。判断分支流程:[起始节点] → [条件]?菱形判断,是→[是分支后续]→[终点],否→[否分支结果]。两个分支不要互相连接,分支间保持足够宽的间距。所有文字用中文,拼写清晰,标题字号适中不要太大。
    ```
    
  • wenqu-image/references/styles/doodle-watercolor.md6.9 KBb43ad38502d3upstream ↗
    # 水彩涂鸦风格参考库(doodle-watercolor-style)
    > 通用画图规范见 [core-principles.md](../core-principles.md)、[pitfalls.md](../pitfalls.md)。
    
    
    > 参考图存放于 `https://github.com/gogoingai/wenqu-skills/tree/master/wenqu-image-assets/styles/doodle-watercolor/`
    
    第五种手绘风格家族,与手绘插画风格([handdrawn.md](handdrawn.md))、Excalidraw 风格([excalidraw.md](excalidraw.md))、单色马克笔风格([mono-marker.md](mono-marker.md))都不同——核心特征是**水彩晕染质感图标、装饰性涂鸦点缀(星星、螺旋线、火花)、彩色波浪箭头**,视觉上像用水彩笔与马克笔混合手绘的概念解说图,比手绘插画风格更"随性涂鸦"、比单色马克笔风格色彩更丰富。
    
    | 特征 | 描述 |
    | --- | --- |
    | 背景 | 纯白(不要米黄色、不要纸张纹理——这是和 mono-marker 风格的关键区别) |
    | 图标 | 水彩晕染质感,线条松散随性,非精细工笔 |
    | 装饰元素 | **标志性特征**:图标周围点缀星星、螺旋线、火花、小圆点等涂鸦元素,营造随手涂画的氛围 |
    | 箭头 | 手绘波浪曲线箭头,**全图粗细/画法必须统一**,禁止直线箭头和波浪箭头混用;颜色不要每根都换一种,同一张图里最多一到两种色系即可,不要为了"配合目标图标"而每根箭头单独配色(踩坑,见下方) |
    | 标题 | 粗体手写字体,下方配一条彩色手绘下划线装饰 |
    | 标签 | 图标下方或右侧居中黑色手写体文字 |
    | 分支标注 | 判断分支的"是/否"文字必须显式标注在对应箭头旁,容易被生成遗漏,需要在 prompt 里强调 |
    | 构图 | 横向流程用 16:9 宽屏;竖向流程/分层架构用 9:16 竖版——生成前先确定好方向,别让模型自己选 |
    
    完整风格选择见 `SKILL.md` 风格库表。
    
    ### 生成规则(--ref 与 prompt 缺一不可,--ref 更关键)
    
    **① --ref 必须**:水彩晕染质感和装饰涂鸦元素仅靠文字描述很难稳定复现,务必传参考图:
    
    ```
    --ref "$(wenqu image fetch-ref doodle-watercolor/doodle-watercolor-01-ai-learning-flow.png)"   # 横向多阶段流程(锚点图,白底翻译版)
    --ref "$(wenqu image fetch-ref doodle-watercolor/doodle-watercolor-02-stage-flow.png)"         # 横向三阶段流程
    --ref "$(wenqu image fetch-ref doodle-watercolor/doodle-watercolor-03-layered-arch.png)"       # 竖向三层架构
    --ref "$(wenqu image fetch-ref doodle-watercolor/doodle-watercolor-04-branch-decision.png)"    # 竖向判断分支流程
    ```
    
    **② prompt 风格描述**,开头必须加:
    
    ```
    手绘涂鸦风格:水彩晕染质感的手绘图标,线条松散随性,图标周围点缀星星、螺旋线、火花等装饰性涂鸦元素。背景纯白(不要米黄色、不要纸张纹理)。标题用粗体手写字体,下方配一条彩色手绘下划线装饰。全图所有箭头必须是同一种风格:手绘波浪曲线箭头,粗细一致,颜色统一用一到两种色系,不要每根箭头单独换色。
    ```
    
    ### 参考图索引
    
    | 文件 | 图类型 | 特点 |
    | --- | --- | --- |
    | `doodle-watercolor-01-ai-learning-flow.png` | 横向四阶段流程(锚点图) | 用户提供原图的中文翻译与白底版本,训练数据→神经网络→学习模式→做出预测,橙/蓝/黄多色波浪箭头 |
    | `doodle-watercolor-02-stage-flow.png` | 横向三阶段流程 | 收集需求→设计方案→交付上线,橙到蓝渐变波浪箭头 |
    | `doodle-watercolor-03-layered-arch.png` | 竖向三层架构 | 接入层(路由器图标)→服务层(多图标网格)→存储层(数据库图标),每层浅色底框区分,蓝/绿/黄波浪箭头纵向串联 |
    | `doodle-watercolor-04-branch-decision.png` | 竖向判断分支流程 | 接收请求→权限校验判断菱形→是/否两路分支(拒绝记录日志 / 执行业务逻辑)→返回响应,箭头统一蓝色系,是否标签清晰标注,分支间无交叉连接 |
    
    ### 踩坑记录
    
    生成判断分支类图时容易出现两个问题(已在 `doodle-watercolor-04` 定稿前反复出现):
    
    1. **箭头风格不统一**:同一张图里出现波浪箭头和直线箭头混用,或箭头颜色乱跳(每根配一种色)。修复方法:prompt 里必须显式声明"全图箭头必须是同一种风格,粗细一致,颜色统一用一到两种色系",只写"波浪箭头"不够,还要明确禁止直线箭头混入、禁止每根箭头单独配色。
    2. **"是/否"分支标签被遗漏**:修复后箭头统一了,但分支判断的文字标签容易在同一轮修改里被模型省略。需要在 prompt 里同时保留"箭头旁标注文字「是」/「否」"的显式要求,不能只强调箭头风格而漏了标签要求。
    
    ### Prompt 模板片段
    
    **横向多阶段流程** — 参考 `doodle-watercolor-01`/`02`:
    ```
    手绘涂鸦风格:水彩晕染质感的手绘图标,线条松散随性,图标周围点缀星星、螺旋线、火花等装饰性涂鸦元素。背景纯白。标题用粗体手写字体,下方配一条彩色手绘下划线装饰。
    横向宽屏构图,宽高比约 16:9。标题「[标题]」。从左到右 [N] 个阶段,波浪箭头串联(箭头颜色统一用一到两种色系):阶段一「[名称]」([图标]+[图标]);阶段二「[名称]」([图标]);…
    每个阶段下方居中黑色手写体标签文字。
    ```
    
    **竖向分层架构** — 参考 `doodle-watercolor-03`:
    ```
    手绘涂鸦风格:水彩晕染质感的手绘图标,线条松散随性,图标周围点缀星星、螺旋线、火花等装饰性涂鸦元素。背景纯白。标题用粗体手写字体,下方配一条彩色手绘下划线装饰。
    **竖版构图,宽高比约 9:16,禁止横版**。从上到下 [N] 层,波浪箭头纵向连接(颜色统一用一到两种色系):第一层「[层名]」([图标],浅色圆角底框);第二层「[层名]」([图标]);…
    每层右侧居中黑色手写体层名标签。
    ```
    
    **竖向判断分支流程** — 参考 `doodle-watercolor-04`:
    ```
    手绘涂鸦风格:水彩晕染质感的手绘图标,线条松散随性,图标周围点缀星星、螺旋线、火花等装饰性涂鸦元素。背景纯白。标题用粗体手写字体,下方配一条彩色手绘下划线装饰。
    **竖版构图,宽高比约 9:16,禁止横版**。顶部「[起始节点]」([图标])→波浪箭头向下→判断菱形「[条件]?」([图标])。菱形左侧波浪箭头标注文字「否」,指向分支「[否分支结果]」([图标])。菱形正下方波浪箭头标注文字「是」,指向「[是分支后续]」([图标])→波浪箭头向下→「[终点]」([图标])。
    **全图所有箭头必须是同一种风格:手绘波浪曲线箭头,粗细一致,颜色统一用一到两种色系,不要每根箭头单独配色**。两个分支路径不要互相连接,分支之间保持足够宽的间距。
    ```
    
  • wenqu-image/references/styles/excalidraw.md6.4 KB00f4b4487821upstream ↗
    # Excalidraw 风格参考库(excalidraw-style)
    > 通用画图规范见 [core-principles.md](../core-principles.md)、[pitfalls.md](../pitfalls.md)。
    
    
    > 参考图存放于 `https://github.com/gogoingai/wenqu-skills/tree/master/wenqu-image-assets/styles/excalidraw/`
    
    与手绘插画风格([handdrawn.md](handdrawn.md))容易混淆,但视觉语言完全不同——Excalidraw 风格更像工程师在白板上随手画的技术草图,没有插画图标,核心是"斜线排线填充、潦草描边、手写字体"。
    
    | 特征 | 描述 |
    | --- | --- |
    | 线条 | 潦草粗糙描边(rough.js 风格),线条略微抖动不规整,非精确几何线,黑色为主 |
    | 填充 | 斜线交叉排线(hachure fill),**不是**纯色实心填充——这是与手绘插画风格最大的区别 |
    | 字体 | 手写体风格(类似 Excalidraw 默认 Virgil 字体),不用印刷体 |
    | 图标 | **禁止**任何插画图标或卡通元素,只用最简单的几何形状(圆角矩形、菱形、圆形)与箭头 |
    | 配色 | 柔和粉彩色,各区块/分组用不同颜色的排线区分,背景纯白 |
    | 分组 | 大圆角矩形外框(细边框)套小节点,外框顶部或左上角标区块名 |
    | 密度 | 工程草图感,信息密度高,多用嵌套分组表达系统分层,不留大片空白 |
    
    完整风格选择见 `SKILL.md` 风格库表。
    
    ### 生成规则(--ref 必须,prompt 只写轻描述——见 pitfalls.md 踩坑 9)
    
    **--ref 必须**,推荐参考图(按目标图类型选最接近的):
    
    ```
    --ref "$(wenqu image fetch-ref excalidraw/excalidraw-03-dense-layered-arch.png)"       # 多层嵌套架构,信息密度高
    --ref "$(wenqu image fetch-ref excalidraw/excalidraw-02-nested-groups.png)"            # 简单嵌套分组
    --ref "$(wenqu image fetch-ref excalidraw/excalidraw-01-linear-flow.png)"              # 横向线性流程
    --ref "$(wenqu image fetch-ref excalidraw/excalidraw-04-sequence-race-condition.png)"  # 时序图/生命线
    --ref "$(wenqu image fetch-ref excalidraw/excalidraw-05-branch-decision-flow.png)"     # 竖向分支决策流程
    --ref "$(wenqu image fetch-ref excalidraw/excalidraw-06-side-by-side-comparison.png)"  # 左右对比图
    --ref "$(wenqu image fetch-ref excalidraw/excalidraw-07-timeline-evolution.png)"       # 时间演化/版本迭代图
    ```
    
    **prompt 只写"参考图风格与内容",不要逐条复述视觉细节**(斜线排线、潦草描边、手写字体等一律交给 `--ref`):
    
    ```
    参考图风格,[横向宽屏构图 / 竖版构图]。[内容描述]。所有文字用中文,拼写清晰。
    ```
    
    **⚠️ 内容密度提醒**:这套风格的线条本身很简洁,如果画图提示内容单薄(只有 2~3 个孤立节点),生成结果会显得空洞、不像正式架构图。参考 `excalidraw-03-dense-layered-arch.png` 的写法——用多层嵌套分组(外框内套子节点/子分组),每个分组标区块名,比单层平铺的节点信息密度更高、更接近真实架构图。这条是内容组织建议,不是要在 prompt 里加视觉细节描述。
    
    ### 参考图索引
    
    | 文件 | 图类型 | 特点 |
    | --- | --- | --- |
    | `excalidraw-01-linear-flow.png` | 横向三节点线性流程 | 客户端→网关→数据库,简单直箭头,验证基础风格复现 |
    | `excalidraw-02-nested-groups.png` | 双分组嵌套架构 | 左侧集群(3节点纵向排列)与右侧服务层(2子区域),验证嵌套分组表达力 |
    | `excalidraw-03-dense-layered-arch.png` | 三层嵌套架构(高密度) | 客户端接口层、服务处理层、存储层,每层内含多个子节点与子流程,接近真实系统架构图密度 |
    | `excalidraw-04-sequence-race-condition.png` | 时序图/生命线 | 三个参与者、纵向生命线、编号箭头,红色高亮标注异常交互(数据竞争) |
    | `excalidraw-05-branch-decision-flow.png` | 竖向分支决策流程 | 菱形判断、两条旁路分支、汇合节点,验证多分支布局与颜色区分 |
    | `excalidraw-06-side-by-side-comparison.png` | 左右对比图 | 顶部共用横幅、垂直虚线分隔、左右各自纵向流程、底部结论卡片 |
    | `excalidraw-07-timeline-evolution.png` | 时间演化/版本迭代图 | 水平时间轴与之字形交替排列的说明卡片,适合展示架构演进历史 |
    
    ### Prompt 模板片段
    
    **多层嵌套架构(高密度)** — 参考 `excalidraw-03`:
    ```
    参考图风格,横向宽屏构图,信息密度要高。从左到右 [N] 个纵向区块,每块是一个大分组框,内部有若干子节点:
    【[区块1名]】([节点1]、[节点2]…)→【[区块2名]】([节点1]、[节点2]…)→【[区块3名]】…
    区块间箭头标注「[操作语义]」。所有文字用中文,拼写清晰。
    ```
    
    **简单线性流程** — 参考 `excalidraw-01`:
    ```
    参考图风格。横向 [N] 节点线性流程:[节点1] → [节点2] → … → [节点N],箭头标注「[操作语义]」。所有文字用中文,拼写清晰。
    ```
    
    **时序图/生命线** — 参考 `excalidraw-04`:
    ```
    参考图风格,横向宽屏构图。时序图,参与者:[参与者A]、[参与者B]、…,按时间顺序编号交互:
    (1) [参与者A] → [参与者B]:[操作]
    (2) [参与者B] → [参与者A]:[响应]
    …
    (需要高亮异常交互时说明是哪一条)。所有文字用中文,拼写清晰。
    ```
    
    **竖向分支决策流程** — 参考 `excalidraw-05`:
    ```
    参考图风格,竖版构图,信息密度要高。竖向决策流程:[入口节点] → 判断「[条件A]?」,是→[分支A结果]→汇合到[汇合节点],否→继续 → [主干节点] → 判断「[条件B]?」,是→[分支B结果]→汇合到[汇合节点],否→继续 → [汇合节点]。所有文字用中文,拼写清晰。
    ```
    
    **左右对比图** — 参考 `excalidraw-06`:
    ```
    参考图风格,横向宽屏构图,信息密度要高。左右对比,顶部横幅「[对比主题]」。左侧「[方案A]」:[步骤1]→[步骤2]→…,结论「[风险/结论]」。右侧「[方案B]」:[步骤1]→[步骤2]→…,结论「[优势/结论]」。所有文字用中文,拼写清晰。
    ```
    
    **时间演化图** — 参考 `excalidraw-07`:
    ```
    参考图风格,横向宽屏构图。时间演化图,时间轴上 [N] 个节点,之字形排列说明卡片:[版本1]「[一句话说明]」→[版本2]「[一句话说明]」→…(最新版本可突出强调)。所有文字用中文,拼写清晰。
    ```
    
  • wenqu-image/references/styles/handdrawn.md4.3 KB993b5aa0cb49upstream ↗
    # 手绘插画风格参考库(handdrawn-style)
    > 通用画图规范见 [core-principles.md](../core-principles.md)、[pitfalls.md](../pitfalls.md)。
    
    
    > 参考图存放于 `https://github.com/gogoingai/wenqu-skills/tree/master/wenqu-image-assets/styles/handdrawn/`
    
    这套风格适合技术文章配图、社交媒体传播图、流程说明图。核心特征:
    
    | 特征 | 描述 |
    | --- | --- |
    | 线条感 | 圆角矩形有轻微手绘线条感,非完全机械规整 |
    | 字体 | 略带手写质感,中文圆润、标题加粗 |
    | 背景 | 纯白或暖白,整体明亮通透 |
    | 图标 | 鲜明活泼,是全图最鲜艳的元素,与浅色底色形成反差 |
    | 配色 | 各步骤用不同浅色底色(浅蓝、浅黄、浅橙、浅绿、浅紫),标题或数字圆圈用深色 |
    | 标题栏 | 圆角矩形横幅,两侧带「——」装饰横线 |
    | 步骤编号 | 填色圆圈(①②③…),左上角或正上方,颜色比卡片底色深一档 |
    
    ### 生成规则(--ref 必须,prompt 只写轻描述——见 pitfalls.md 踩坑 9)
    
    **`--ref` 必须**:传入参考图锚定视觉风格(自然线条、水彩填色感),仅靠 prompt 描述无法稳定复现。推荐参考图:
    
    ```
    --ref "$(wenqu image fetch-ref handdrawn/handdrawn-01-skill-creation-loop.png)"
    ```
    
    (也可换 `handdrawn-02` 至 `handdrawn-07`,选和目标图类型最接近的,见下方索引)
    
    **prompt 只写"参考图风格与内容",不要逐条复述视觉细节**(图标怎么画、线条怎么处理等一律交给 `--ref`):
    
    ```
    参考图风格,[横向宽屏构图 / 竖版构图]。[内容描述]。所有文字用中文,拼写清晰。
    ```
    
    **完整调用示例:**
    
    ```bash
    RAND=$(openssl rand -hex 8)
    wenqu image generate --provider codex \
      --prompt "参考图风格。[图内容描述...]。所有文字用中文。" \
      --ref "$(wenqu image fetch-ref handdrawn/handdrawn-01-skill-creation-loop.png)" \
      --out /tmp/article-img-${RAND} \
      --timeout-sec 300
    ```
    
    ### 参考图索引
    
    | 文件 | 图类型 | 特点 |
    | --- | --- | --- |
    | `handdrawn-01-skill-creation-loop.png` | 横向线性流程、决策菱形、反馈弧线 | 步骤卡片与下方"否"路径循环框 |
    | `handdrawn-02-circular-flow.png` | 环形流程与放射状原始证据区 | 圆形箭头串联 5 步,底部输入汇集区 |
    | `handdrawn-03-risk-freedom-table.png` | 横向分行对比表 | 每行带仪表盘图标,列标题与要点清单 |
    | `handdrawn-04-layered-arch.png` | 竖向三层架构与右侧指标卡 | 每层圆角大框内有图标和副标,层间带箭头标注 |
    | `handdrawn-05-mindmap.png` | 中心辐射思维导图 | 中央大节点、四角分支卡片、底部总结横幅 |
    | `handdrawn-06-retro-agent-flow.png` | 竖向多层流程与内嵌循环大框 | 顶部触发→扫描信号→Agent 循环区块,循环内含分支列表,左侧回环箭头 |
    | `handdrawn-07-curator-flow.png` | 左右双列流程与顶部汇合底部 | 共同触发节点分叉为左右两列,各列独立逻辑,底部再汇合 |
    
    ### 各图类型对应的 prompt 模板片段
    
    **横向线性流程(含判断菱形)** — 参考 `handdrawn-01`:
    ```
    参考图风格,横向宽屏构图。主流程从左到右:[步骤1] → [步骤2] → …;判断「[条件]?」,是→[结果分支],否→继续主流程;末尾弧形箭头回到起点,标注「[注释]」。所有文字用中文,拼写清晰。
    ```
    
    **竖向三层架构** — 参考 `handdrawn-04`:
    ```
    参考图风格,竖版构图。三层架构从上到下:[层1名]([功能标签])→ [层2名]([功能标签])→ [层3名]([功能标签]),层间箭头带标注文字。底部一句话总结「[总结]」。所有文字用中文,拼写清晰。
    ```
    
    **环形流程** — 参考 `handdrawn-02`:
    ```
    参考图风格。环形流程:[步骤1] → [步骤2] → … → [步骤N] → 弧形箭头回到步骤1(顺时针)。底部标注输入来源「[来源]」,箭头引向对应环形步骤。所有文字用中文,拼写清晰。
    ```
    
    **中心辐射思维导图** — 参考 `handdrawn-05`:
    ```
    参考图风格。中央核心词「[核心词]」,四角延伸分支:「[分支A]」「[分支B]」「[分支C]」「[分支D]」。底部一句话总结「[总结]」。所有文字用中文,拼写清晰。
    ```
    
  • wenqu-image/references/styles/mono-marker.md4.2 KBae2977c457edupstream ↗
    # 单色马克笔风格参考库(mono-marker-style)
    > 通用画图规范见 [core-principles.md](../core-principles.md)、[pitfalls.md](../pitfalls.md)。
    
    
    > 参考图存放于 `https://github.com/gogoingai/wenqu-skills/tree/master/wenqu-image-assets/styles/mono-marker/`
    
    第三种手绘风格家族,与手绘插画风格([handdrawn.md](handdrawn.md))、Excalidraw 风格([excalidraw.md](excalidraw.md))都不同——核心特征是**全图单一主色调、奶油色背景、波浪线引出注释**,视觉上更像用马克笔在米色笔记本上手绘的图解。
    
    | 特征 | 描述 |
    | --- | --- |
    | 背景 | 米白色/奶油色(非纯白),带轻微纸张质感 |
    | 配色 | **全图只用一种主色**(如绿色/蓝色):节点描边、节点填充、连接箭头、分组外框全部同色系,只有极少数"类别标签"节点例外用灰色 |
    | 节点 | 圆角胶囊/椭圆形,同色系描边与填充(填充可以是浅色调,不强制饱和实心) |
    | 分组框 | 粗描边圆角矩形/胶囊形状,内部无填充(透明),把一组节点框在一起 |
    | 线条 | 手绘感圆润流畅,不是锯齿状潦草描边(区别于 Excalidraw 的 rough.js 感) |
    | 注释连接 | **标志性特征**:节点向右侧引出一条卷曲波浪线(形似手绘的 `~`),末端带箭头,连接到黑色手写说明文字;左侧/其他方向的说明用直线小箭头即可 |
    | 字体 | 手写体,笔画偏粗饱满 |
    
    完整风格选择见 `SKILL.md` 风格库表。
    
    ### 生成规则(--ref 必须,prompt 只写轻描述——见 pitfalls.md 踩坑 9)
    
    **--ref 必须**:这套风格的"波浪线注释"、"同色系分组框"等细节仅靠文字描述很难稳定复现,务必传参考图:
    
    ```
    --ref "$(wenqu image fetch-ref mono-marker/mono-marker-01-gateway-flow.png)"          # 竖向分组流程
    --ref "$(wenqu image fetch-ref mono-marker/mono-marker-02-branch-decision.png)"       # 含判断菱形的分支合并
    --ref "$(wenqu image fetch-ref mono-marker/mono-marker-03-layered-arch.png)"          # 多层横向分层架构
    --ref "$(wenqu image fetch-ref mono-marker/mono-marker-04-sync-async-comparison.png)" # 左右并排对比
    ```
    
    **prompt 只写"参考图风格与内容",不要逐条复述视觉细节**(单色调、波浪线注释、分组框等一律交给 `--ref`):
    
    ```
    参考图风格,[颜色]单色调。[内容描述]。所有文字用中文,拼写清晰。
    ```
    
    **⚠️ 配色可替换**:主色可以换成蓝、橙、紫等任意单一颜色,只要保证全图同一色系——一旦引入第二种高饱和度颜色(灰色类别标签除外),就偏离了这套风格的识别特征。指定颜色时在 prompt 里点出"[颜色]单色调"即可,不需要展开描述"节点、描边、箭头都用这个颜色",--ref 已经锚定了这个规则。
    
    ### 参考图索引
    
    | 文件 | 图类型 | 特点 |
    | --- | --- | --- |
    | `mono-marker-01-gateway-flow.png` | 竖向分组流程图 | 顶部入口→网关层分组框(三步骤串联)→底部三路分发,右侧波浪线引出每步说明,蓝色单色调 |
    | `mono-marker-02-branch-decision.png` | 含判断菱形的分支流程 | 判断菱形分两路,左右间距拉大、分支间无任何连线,各分支独立两步串联与波浪线注释,最终向下汇合,橙色单色调 |
    | `mono-marker-03-layered-arch.png` | 三层横向分层架构 | 接入层、应用层、数据层三个分组框纵向堆叠,层内节点横向排列,层间箭头相连,紫色单色调 |
    | `mono-marker-04-sync-async-comparison.png` | 左右并排对比 | 同步调用 vs 异步调用两个分组框并排,异步侧用虚线箭头表示延迟,底部波浪线引出结论,红色单色调 |
    
    ### Prompt 模板片段
    
    **竖向分组流程(含波浪线注释)** — 参考 `mono-marker-01`:
    ```
    参考图风格,[颜色]单色调。顶部「[入口节点]」,箭头向下进入分组框「[分组名]」,框内纵向串联 [N] 个节点:「[步骤1]」→「[步骤2]」→…,每个节点引出说明文字:「[说明1]」「[说明2]」…分组框下方指向底部横向排列的 [N] 个节点:「[分支1]」「[分支2]」…所有文字用中文,拼写清晰。
    ```
    
  • wenqu-image/references/styles/pencil-sketch.md4.7 KBe4ac3dd786b9upstream ↗
    # 彩色铅笔质感风格参考库(pencil-sketch-style)
    > 通用画图规范见 [core-principles.md](../core-principles.md)、[pitfalls.md](../pitfalls.md)。
    
    
    > 参考图存放于 `https://github.com/gogoingai/wenqu-skills/tree/master/wenqu-image-assets/styles/pencil-sketch/`
    
    第七种手绘风格家族,与奶油描边风格([cream-outline.md](cream-outline.md))都用奶油色背景,但视觉语言不同——核心特征是**彩色铅笔、蜡笔晕染质感、图标边缘斜线排线阴影、圆形编号徽章、虚线分隔、可爱吉祥物点缀**,比奶油描边风格线条更软、更有"手绘笔触感",比水彩涂鸦风格([doodle-watercolor.md](doodle-watercolor.md))更克制、没有装饰性涂鸦星星火花。
    
    | 特征 | 描述 |
    | --- | --- |
    | 背景 | 奶油色/米白色,带轻微纸张质感 |
    | 卡片配色 | 每个卡片/步骤用不同的浅色系(浅紫、浅绿、浅蓝、浅橙轮换),卡片内图标同色系 |
    | 图标质感 | 彩色铅笔/蜡笔晕染,图标底部或边缘带斜线排线阴影(hachure),不是纯色扁平填充,也不是水彩晕染 |
    | 编号 | 圆形编号徽章(①②③…),卡片左上角外侧,颜色和卡片同色系 |
    | 分隔线 | 卡片内图标区和文字标签之间用一条同色系虚线分隔 |
    | 标题 | 黑色手写体大字,下方配一条同色系手绘下划线,字号适中不要占满画面 |
    | 吉祥物 | 微笑的星星/羊驼等可爱小元素,点缀在标题角落或底部横幅里 |
    | 箭头 | 简单黑色直线箭头表示顺序,判断分支用"是/否"文字加对应颜色(绿/红)标注 |
    
    完整风格选择见 `SKILL.md` 风格库表。
    
    ### 生成规则(--ref 与 prompt 缺一不可,且 prompt 要简短——参考 pitfalls.md 踩坑 9)
    
    **① --ref 必须**:
    
    ```
    --ref "$(wenqu image fetch-ref pencil-sketch/pencil-sketch-01-stage-flow.png)"       # 横向四步编号流程
    --ref "$(wenqu image fetch-ref pencil-sketch/pencil-sketch-02-breakdown.png)"        # 长条拆解+编号卡片
    --ref "$(wenqu image fetch-ref pencil-sketch/pencil-sketch-03-branch-decision.png)"  # 竖向判断分支流程
    --ref "$(wenqu image fetch-ref pencil-sketch/pencil-sketch-04-layered-arch.png)"     # 竖向分层架构
    ```
    
    **② prompt 只写"参考图风格与内容",不要逐条复述视觉细节**:
    
    ```
    参考图风格,[横向宽屏构图 / 竖版构图]。[内容描述]。所有文字用中文,拼写清晰,标题字号适中不要太大。
    ```
    
    ### 参考图索引
    
    | 文件 | 图类型 | 特点 |
    | --- | --- | --- |
    | `pencil-sketch-01-stage-flow.png` | 横向四步编号流程 | 构建→下载→运行→验证,四色编号卡片,顶部小标题与下划线,底部星星吉祥物横幅总结一句话 |
    | `pencil-sketch-02-breakdown.png` | 长条拆解与编号卡片 | 顶部长条框按分段配色显示完整字符串,向下箭头引到多个编号小卡片逐段解释,底部横幅公式化总结 |
    | `pencil-sketch-03-branch-decision.png` | 竖向判断分支流程 | 接收请求→权限校验菱形判断,是(绿字)/否(红字)两路分支,无交叉连接 |
    | `pencil-sketch-04-layered-arch.png` | 竖向三层架构 | 接入层、服务层、存储层,每层编号徽章、色条标题、多图标、虚线分隔、文字标签,层间黑色箭头 |
    
    ### Prompt 模板片段
    
    **横向多步编号流程** — 参考 `pencil-sketch-01`:
    ```
    参考图风格,横向宽屏构图。顶部小标题「[步骤1] → [步骤2] → … → [步骤N]」。[N] 个编号卡片:① [卡片1名]([图标],说明「[一句话]」)② [卡片2名]…底部横幅总结一句话「[总结]」。所有文字用中文,拼写清晰。
    ```
    
    **长条拆解与编号卡片** — 参考 `pencil-sketch-02`:
    ```
    参考图风格。标题「[标题]」。顶部一个长条框,按分段配色显示「[完整字符串]」。下方 [N] 个编号卡片,箭头从长条框对应段落指下来:① [含义1] ② [含义2] …底部横幅公式化总结「[部分1] + [部分2] + …」。所有文字用中文,拼写清晰。
    ```
    
    **竖向判断分支流程** — 参考 `pencil-sketch-03`:
    ```
    参考图风格,竖版构图。判断分支流程:[起始节点] → [条件]?菱形判断,是→[是分支后续]→[终点],否→[否分支结果]。两个分支不要互相连接,分支间保持足够宽的间距。所有文字用中文,拼写清晰,标题字号适中不要太大。
    ```
    
    **竖向分层架构** — 参考 `pencil-sketch-04`:
    ```
    参考图风格,竖版构图。[N] 层架构从上到下:[层1]([子节点])→[层2]([子节点])→…→[层N]([子节点]),层间箭头连接,每层配一个编号徽章。所有文字用中文,拼写清晰,标题字号适中不要太大。
    ```
    
  • wenqu-image/references/styles/techppt.md3.3 KBd9219445b252upstream ↗
    # 技术PPT风格参考库(techppt-style)
    > 通用画图规范见 [core-principles.md](../core-principles.md)、[pitfalls.md](../pitfalls.md)。
    
    
    > 参考图存放于 `https://github.com/gogoingai/wenqu-skills/tree/master/wenqu-image-assets/styles/techppt/`
    
    与[手绘插画风格](handdrawn.md)不同,这套风格更接近演讲幻灯片,线条干净,有固定机器人吉祥物,信息密度更高。
    
    | 特征 | 描述 |
    | --- | --- |
    | 标题 | 粗体大字,无横幅边框,直接写在顶部居中 |
    | 背景 | 纯白,无纸质感 |
    | 边框 | 圆角矩形,颜色鲜明(蓝/橙为主),线条干净利落 |
    | 图标 | 配色统一的线性图标,非手绘感 |
    | 吉祥物 | 卡通机器人,固定出现在角落起点缀作用 |
    | 内容密度 | 每个框内可放多行结构化内容(指标、工具、失败模式) |
    | 布局 | 左右双列对比、公式拆解、环形循环、建筑分层均有对应参考图 |
    
    ### 生成规则(--ref 必须,prompt 只写轻描述——见 pitfalls.md 踩坑 9)
    
    **--ref 必须**,推荐参考图(按目标图类型选最接近的):
    
    ```
    --ref "$(wenqu image fetch-ref techppt/techppt-03-building.png)"   # 两列对比、分层
    --ref "$(wenqu image fetch-ref techppt/techppt-04-circular.png)"   # 环形循环
    --ref "$(wenqu image fetch-ref techppt/techppt-01-formula.png)"    # 公式拆解
    --ref "$(wenqu image fetch-ref techppt/techppt-02-two-column.png)" # 双框对比
    ```
    
    **prompt 只写"参考图风格与内容",不要逐条复述视觉细节**(边框配色、机器人吉祥物等一律交给 `--ref`):
    
    ```
    参考图风格。[内容描述]。所有文字用中文,拼写清晰。
    ```
    
    ### 参考图索引
    
    | 文件 | 图类型 | 特点 |
    | --- | --- | --- |
    | `techppt-01-formula.png` | 公式拆解与侧边示意图 | 中央大公式框,彩色箭头向下分解三个概念,右侧漏斗示意 |
    | `techppt-02-two-column.png` | 左右双框对比 | 两个大圆角矩形并排,中间双向箭头,各框内多行结构化内容,机器人在角落 |
    | `techppt-03-building.png` | 竖向分层(建筑比喻) | 大框内分两层,每层有标题色条与三行「图标与内容」,右侧便签卡片 |
    | `techppt-04-circular.png` | 中心环形循环 | 中央圆圈内放核心概念,外圈多个步骤沿弧线排列,弧形箭头串联 |
    
    ### 各图类型 prompt 模板片段
    
    **左右双框对比** — 参考 `techppt-02` / `techppt-03`:
    ```
    参考图风格。标题「[标题]」。左侧「[左侧名称]」:[N]行内容,每行「[内容]」。右侧「[右侧名称]」:[N]行内容,每行「[内容]」。两框中间标注关系「[关系说明]」。底部总结一句话「[总结]」。所有文字用中文,拼写清晰。
    ```
    
    **竖向分层** — 参考 `techppt-03`:
    ```
    参考图风格。标题「[标题]」。分[N]层:第一层「[层名]」([N]行内容);第二层「[层名]」([N]行内容);…右侧补充说明「[补充说明]」。所有文字用中文,拼写清晰。
    ```
    
    **中心环形循环** — 参考 `techppt-04`:
    ```
    参考图风格。标题「[标题]」。中央核心词「[核心词]」,外圈顺时针排列[N]个步骤:「[步骤1]」→「[步骤2]」→…→回到步骤1。补充说明「[注释]」。所有文字用中文,拼写清晰。
    ```
    
  • wenqu-image/references/templates/architecture.md4.6 KB55e504bc10dfupstream ↗
    # 架构类图型模板
    
    ## 横向多层架构图
    
    适用:展示系统分层结构、各层组件和整体数据流。  
    参考图:`other/01-architecture.png`(MemoryCore 四层架构,重点参考:左侧彩色层名徽章、节点图标与副标题、层间单箭头标语义)
    
    **三区布局规范**(每行一层,左中右三区):
    
    | 区域 | 内容 | 视觉要求 |
    | --- | --- | --- |
    | 左区(层名徽章) | 层名文字 | 带颜色背景的圆角矩形,颜色比该行浅色背景深一档 |
    | 中区(节点组) | 横向并排节点,每节点:小图标、加粗名称、灰色副标(1~2行) | 圆角矩形,浅色背景行 |
    | 右区(角色描述) | 一句话说这层"是什么角色" | 灰色小字,垂直居中 |
    
    **属性卡片 vs 流程节点**(最容易混淆,必须看清楚再写):
    
    | 情形 | 节点含义 | 写法 | 箭头 |
    | --- | --- | --- | --- |
    | 展示该层的**特征/属性** | 并排的属性描述(如:原始消息、顺序读取、会话级) | 「横向并排三张属性卡片,**卡片之间不用箭头连接**」 | ❌ 无 |
    | 展示该层内部的**处理步骤** | 有先后顺序的操作(如:解析→提炼→落库) | 「三个步骤节点,箭头相连」 | ✅ 有 |
    
    错误写法「内容三个节点串联」容易让生图工具在属性列表之间画出箭头,整层变成流程图而非存储架构图。
    
    **层外数据流规范**:
    
    架构图中层与层之间的数据流箭头(如「实时写入」「异步提炼」「混合检索」)必须明确声明在色带**外侧**,不能穿插在层内卡片之间。格式:
    
    ```
    # 色带外部的数据流(均在色带轮廓外侧,不穿插在节点之间):
    #   顶部:「[来源]」→ 上方色带,标注「[操作]」
    #   两层之间:居中垂直箭头,标注「[操作]」
    #   右侧:[侧边线说明]
    ```
    
    **层间箭头规范**:
    - 每两层之间只画**一条**居中向下箭头,**不要扇形展开**连到每个节点
    - 箭头标注具体操作语义(「调用」「读取 & 写入」「策略查询」),不写"数据流"这类泛称
    - 箭头标签下方加白色矩形衬底,防止与背景混淆
    
    ```
    # 画图提示:横向多层架构总览图,展示[系统名]的[N]层结构与数据流。
    #
    # 整体布局:[N] 行(每行一层)从上到下排列,每行分三区:
    #   左区:层名徽章,带颜色背景的圆角矩形,颜色比该行背景深一档,层名居中
    #   中区:节点横向并排,每节点由小图标 + 加粗名称 + 灰色副标组成
    #   右区:一句角色定位描述,灰色小字
    #
    # 行 1【[层名]】([浅色]背景行,左徽章[深色]):
    #   [N] 个节点,各带图标:
    #     「[节点A]」  [副标题]
    #     「[节点B]」  [副标题]
    #   右区:[一句角色描述]
    #
    # 行 2【[层名]】([浅色]背景行,左徽章[深色]):
    #   [N] 个节点,副标题为串联步骤:
    #     「[节点C]」  [步骤1] → [步骤2] → [步骤3]
    #   右区:[一句角色描述]
    #
    # 层间箭头(每层之间一条,垂直向下居中,不展开连到各节点,标签有白色衬底):
    #   [层名A] → [层名B]:「[操作语义]」
    #   [层名B] → [层名C]:「[操作语义]」
    #
    # 风格:白色背景,高级技术 PPT 配图,极简专业,文字标注全部用中文。
    ```
    
    ---
    
    
    ---
    
    ## 树形层次检索路径图
    
    适用:展示树状结构的遍历/搜索路径,标注每个节点的分数或状态。  
    参考图:`other/04-tree-search.png`(层次检索路径图)
    
    ```
    # 画图提示:树形层次检索路径图,展示[查询/搜索]在[树状结构]中的遍历路径与收敛过程。
    #
    # 外层大框:「[空间名称]([结构描述])」
    # 树结构(从上到下):
    #   根节点(L0,蓝色高亮):「[根节点名](L0,分数 [X])」
    #   L1 子节点(横向排列,4个):
    #     「[目录A](L1,分数 [低])」→ 虚线框标「低于阈值,整个子树跳过」
    #     「[目录B](L1,分数 [高])」→ 继续向下
    #     「[目录C](L1,分数 [高])」→ 继续向下
    #     「[目录D](L1,分数 [高])」→ 继续向下
    #   L2 叶节点(各高分目录下展开):
    #     各叶节点标注「[文件名](L2,分数 [X])」,顶部贴「最终命中」标签
    #
    # 右侧步骤卡片(3个,从上到下):
    #   步骤1:「[步骤说明]」
    #   步骤2:「[步骤说明]」
    #   步骤3:「[步骤说明]」
    #
    # 箭头:实线=实际访问路径,虚线=跳过路径
    # 底部图例:各类节点图标含义
    #
    # 风格:白色背景,高级技术 PPT 配图,极简专业,文字标注全部用中文。
    ```
    
    ---
    
  • wenqu-image/references/templates/comparison.md4.6 KB843587fc5daeupstream ↗
    # 对比/并行类图型模板
    
    ## 并排方案对比图
    
    适用:两个方案/版本的流程对比,突出差异点。
    
    ```
    # 画图提示:左右并排对比图,展示[方案A]与[方案B]的差异。
    #
    # 顶部各贴对比标签(深色背景标题框):
    #   左侧:「[方案A特征,如「无Agent·直连检索」]」
    #   右侧:「[方案B特征,如「有Agent·智能路由」]」
    # 各自按编号排列步骤:
    #   左侧:① → ② → ③(步骤少,流程简单)
    #   右侧:① → ② → 三路分支(各分支含关键数字)→ 汇合 → ③ → ④
    # 底部横跨两侧对比框:「核心差异:[关键指标对比,如「准确率 +X%(A% vs B%)」]」
    #
    # 风格:白色背景,高级技术 PPT 配图,极简专业,文字标注全部用中文。
    ```
    
    ---
    
    
    ---
    
    ## 并行双路流程图
    
    适用:两条独立路径并行处理同一输入,最终汇合为一个结果(如混合检索、双路校验)。
    
    **核心规范**:
    - 两路必须用**不同背景色**区分(如浅蓝 vs 浅橙),顶部各有**深色标题栏**
    - 每路的注释/标注文字贴近**该路外侧边缘**,不要放在两路中间
    - 底部汇合区用**横跨全宽**的色块(浅绿)表示融合,两路各引一条斜箭头汇入
    - 路间没有水平箭头连接,只在底部汇合
    
    ```
    # 画图提示:并行双路流程图,展示[输入]经两条路径并行处理后汇合的流程。
    #
    # 顶部:椭圆节点「[输入]」,向下分叉为左右两条路径。
    #
    # 左路【[路径名A]】(浅蓝背景,圆角矩形,纵向步骤):
    #   顶部深蓝标题栏「[路径名A]」;
    #   步骤节点从上到下:「[步骤1]」→「[步骤2]」→「[输出节点A]」(箭头相连);
    #   左侧灰色竖排注释(贴近左边缘):上行「擅长:[描述]」,下行「盲区:[描述]」。
    #
    # 右路【[路径名B]】(浅橙背景,圆角矩形,纵向步骤,与左路并排):
    #   顶部深橙标题栏「[路径名B]」;
    #   步骤节点从上到下:「[步骤1]」→「[步骤2]」→「[输出节点B]」(箭头相连);
    #   右侧灰色竖排注释(贴近右边缘):上行「擅长:[描述]」,下行「盲区:[描述]」。
    #
    # 底部汇合区(浅绿背景,圆角矩形,横跨左右全宽):
    #   左路底端一条斜箭头、右路底端一条斜箭头,同时汇入此区域;
    #   区域内:「[融合步骤]」→「[最终输出]」(箭头相连)。
    #
    # 风格:白色背景,高级技术 PPT 配图,极简专业,文字标注全部用中文。
    ```
    
    ---
    
    
    ---
    
    ## 左右结果对比图
    
    适用:同一查询/输入在两种方案下的结果对比,重点突出命中 ✓ 与漏掉 ✗ 的差异(如关键词 vs 语义向量检索效果对比)。
    
    与上面的『并排方案对比图』的区别:并排方案对比图比较的是**流程路径**;本节的『左右结果对比图』比较的是**结果列表**,每行结果带 ✗/✓ 图标和右侧小注。
    
    **核心规范**:
    - 顶部必须有**共用横幅**作为公共输入,横跨全宽
    - 每行结果固定三段式:`图标(✗/✓)+ 内容 + 右侧灰色小注`
    - 中央用**垂直灰色虚线**隔开两侧
    - 底部各有**颜色标签**总结结论
    
    ```
    # 画图提示:左右结果对比图,展示[方案A]与[方案B]在同一查询下的结果差异。
    #
    # 顶部:灰色圆角横幅贯穿全宽,中央文字「查询:[查询内容]」
    #
    # 左侧面板【[方案A]】([浅红]背景,圆角矩形):
    #   顶部[红色]标题栏(白色字):「[方案A名称]」;
    #   中间步骤区:小圆角框「[处理步骤]」,向下箭头;
    #   结果区(白色背景):
    #     第一行:[红色]叉号 + 「[结果1]」+ 右侧灰色小注「[原因] → [结论]」
    #     第二行:[红色]叉号 + 「[结果2]」+ 右侧灰色小注「[原因] → [结论]」
    #   底部[红色]圆角标签:「[总结短语]」
    #
    # 中央:垂直灰色虚线将两个面板隔开
    #
    # 右侧面板【[方案B]】([浅绿]背景,圆角矩形):
    #   顶部[绿色]标题栏(白色字):「[方案B名称]」;
    #   中间步骤区:「[步骤1]」→「[步骤2]」(箭头相连),向下箭头;
    #   结果区(白色背景):
    #     第一行:[绿色]对号 + 「[结果1]」+ 右侧灰色小注「[原因] → [结论]」
    #     第二行:[绿色]对号 + 「[结果2]」+ 右侧灰色小注「[原因] → [结论]」
    #   底部[绿色]圆角标签:「[总结短语]」
    #
    # 风格:白色背景,高级技术 PPT 配图,极简专业,文字标注全部用中文。
    ```
    
    ---
    
  • wenqu-image/references/templates/data-viz.md4.7 KBf02323dc764cupstream ↗
    # 数据可视化类图型模板
    
    ## 横向条形图 + 说明卡片
    
    适用:多维度权重或评分分布,每个维度附带机制说明。  
    参考图:`other/03-weights-bar.png`(6维权重总览)
    
    ```
    # 画图提示:横向条形图 + 说明卡片布局,展示[N]个维度的权重分布
    #
    # 左侧:横向条形图,[N]行,每行对应一个维度
    #   维度标签(左对齐):「[维度1]」「[维度2]」…「[维度N]」
    #   条形宽度对应权重(从大到小):[w1] / [w2] / … / [wN]
    #   条形颜色:深蓝(最高)渐变到浅灰(最低)
    #   每条末尾标注百分比数字
    #   左上方标题:「[图表标题]」副标题「[副标题]」
    #
    # 右侧:[N]张说明卡片,2列排列
    #   每卡含:图标 + 维度名(加粗)+ 计算逻辑一句话 + 防作弊机制说明(盾牌图标)
    #
    # 风格:白色背景,高级技术 PPT 配图,极简专业,文字标注全部用中文。
    ```
    
    ---
    
    
    ---
    
    ## 左右分栏:公式 + 分级条件卡片
    
    适用:展示公式的分级/分支行为,配折线图直观呈现。
    
    ```
    # 画图提示:左右分栏布局,左侧展示公式与折线图,右侧展示分级条件卡片。
    #
    # 左侧:
    #   大号公式框:[公式,用中文描述变量]
    #   变量说明表:[变量名(中文)] 对应 [含义]
    #   折线图(可选):X轴「[含义]」,Y轴「[含义,范围]」
    #   [N]条曲线,标注各自场景名
    #
    # 右侧:[N]张条件卡片并排
    #   每卡:条件标题(「[参数] [≥/</=] [阈值]」)+ 场景名 + 关键参数值
    #   卡片颜色与左侧折线一一对应
    # 底部说明框:「[一句话总结]」
    #
    # 风格:白色背景,高级技术 PPT 配图,极简专业,文字标注全部用中文。
    ```
    
    ---
    
    
    ---
    
    ## 时间演化折线图
    
    适用:某个指标随时间变化的趋势,含触发阈值线。
    
    ```
    # 画图提示:折线图,展示[指标名]随时间的演化过程与关键事件节点。
    #
    # X轴「时间」,Y轴「[指标名](范围 0~[最大值])」
    # 一条折线,[N]个关键转折点,每点旁标注中文事件:
    #   「[事件名]」→ 值=[数值](超阈值处标「触发[动作]」)
    # 水平虚线标注阈值 [M],旁边标「[阈值含义]」
    # 图例:[折线含义] / [虚线含义]
    #
    # 风格:白色背景,高级技术 PPT 配图,极简专业,文字标注全部用中文。
    ```
    
    ---
    
    
    ---
    
    ## 金字塔分层图
    
    适用:展示层次递进关系,底层最基础/最宽,顶层最高级/最窄(如优先级金字塔、处理链路分层)。
    
    **⚠️ 金字塔的四条强制规则**(经实践验证,违反任一条都会导致图形扭曲或层次混乱):
    
    1. **层序方向**:底层 = 第一层(最基础)= 最宽;顶层 = 最高层(最高级)= 最窄的塔尖。**编号从下到上递增**。模型默认容易画反,必须在 prompt 中明确标注「底部最宽为第一层,顶部尖顶为最高层」。
    2. **角度必须一致**:三条规则:左侧斜边从底层左角到顶点是一条连续直线;右侧斜边从底层右角到顶点是一条连续直线;所有层的左右两侧均共用同一条斜边,不单独画。违反此规则会导致各层角度不一致,视觉上很难看。
    3. **必须有塔尖**:顶层要收成三角形的真实尖顶(apex),不是梯形。
    4. **不加标题**:金字塔本身不加图表标题,除非用户明确要求。
    
    ```
    # 画图提示:金字塔分层图,展示[N]层[主题]结构。
    #
    # 整体形状:等腰三角形,顶部收成尖顶(apex),无图表标题。
    # 三角形两侧斜边从底层两角延伸至顶点,是贯通全图的连续直线,各层共用同一斜边。
    #
    # 从下到上共 [N] 层(底部最宽为第一层,顶部尖顶处为第[N]层):
    #
    #   第一层(底部,最宽):
    #     层名标题(加粗):「[名称]」
    #     属性行(带小图标):
    #       📋 处理:[处理描述]
    #       ⚙️ 操作:[操作描述]
    #       ⏱️ 时间成本:低([说明])
    #
    #   第二层(中部):
    #     层名标题(加粗):「[名称]」
    #     属性行(带小图标):
    #       📋 处理:[处理描述]
    #       ⚙️ 操作:[操作描述]
    #       ⏱️ 时间成本:中([说明])
    #
    #   第三层(顶部,最窄,含塔尖):
    #     层名标题(加粗):「[名称]」
    #     属性行(带小图标):
    #       📋 处理:[处理描述]
    #       ⚙️ 操作:[操作描述]
    #       ⏱️ 时间成本:高([说明])
    #
    # 各层配色:三层分别用三种协调色(如蓝/橙/红渐变色系),颜色由模型自行决定。
    #
    # 风格:白色背景,高级技术 PPT 配图,极简专业,文字标注全部用中文。
    ```
    
    ---
    
  • wenqu-image/references/templates/flow.md8.8 KBe625750ed44dupstream ↗
    # 流程/阶段类图型模板
    
    ## 竖向三阶段串行流程图
    
    适用:有清晰阶段划分的处理流程,替代泳道图。
    
    **标题栏位置:顶部横条(不是左侧竖条)**
    
    每个阶段框的标题栏必须是**顶部横贯全宽的横条**,不要用左侧竖条。原因:左侧竖条挤占水平空间,步骤节点区域变窄,图整体显得拥挤。
    
    ```
    # ✅ 正确:顶部横条
    #   顶部深蓝横条标题栏(横贯矩形全宽),白色文字「[名称] · [副标题]」,左侧有图标;
    #   标题条下方主体区域:…
    
    # ❌ 错误:左侧竖条
    #   左侧深蓝色竖条标题栏,白色文字「[名称] · [副标题]」;
    ```
    
    **异步阶段标准表示**:
    
    当某个阶段是**异步执行**(不阻塞主流程),需同时给出三个视觉提示:
    1. 阶段框外轮廓改为**虚线**(橙色虚线)
    2. 背景色选**浅黄**(与同步阶段的蓝/绿色系形成区分)
    3. 标题栏**右端**加「**异步**」白色小胶囊标签
    
    ```
    #   阶段二【[名称]】(浅黄背景,整行宽圆角矩形,整体外框为橙色虚线):
    #     顶部深橙横条标题栏(横贯矩形全宽)「[名称] · [副标题]」,标题栏右端有「异步」白色小胶囊标签;
    #     标题条下方主体区域:…
    #     主体最右侧有一行灰色小字「不阻塞主流程」
    ```
    
    **步骤节点布局**:同一阶段内的多个步骤节点必须等宽、均匀分布,不要挤在一侧留大片空白。
    
    ```
    # 画图提示:竖向三阶段流程图,展示[流程名]
    #
    # 顶部触发器:「[触发条件]」→ 判断菱形「[已完成检查]?」→ 是则结束,否则继续
    #
    # 三个串联阶段框(圆角矩形,从上到下):
    #   阶段一【[名称]】(浅蓝背景,整行宽):
    #     顶部深蓝横条标题栏(横贯全宽),左侧图标,白色文字「[名称] · [副标题]」
    #     标题条下方:横向排列 N 个白色圆角步骤节点,等宽均匀分布,箭头相连:
    #       「[步骤1]」→「[步骤2]」→「[步骤3]」
    #   阶段二【[名称]】(浅黄背景,整行宽,整体外框橙色虚线):
    #     顶部深橙横条标题栏(横贯全宽)「[名称] · [副标题]」,右端「异步」白色小胶囊标签
    #     标题条下方:横向排列 N 个步骤节点,等宽均匀分布,箭头相连
    #     主体最右侧灰色小字:「不阻塞主流程」
    #   阶段三【[名称]】(浅绿背景,整行宽):
    #     顶部深绿横条标题栏(横贯全宽),左侧图标,白色文字「[名称] · [副标题]」
    #     标题条下方:左侧菱形「[判断节点]」,右侧引出 N 条等间距纵向分布的水平箭头,
    #       各指向 N 张等高圆角卡片(纵向均匀排列)
    # 阶段间:每两个阶段之间一条居中实线向下箭头
    #
    # 风格:白色背景,高级技术 PPT 配图,极简专业,文字标注全部用中文。
    ```
    
    ---
    
    
    ---
    
    ## 竖向串行流程图(含判断分支)
    
    适用:单一路径的处理步骤,含条件判断分支。
    
    **⚠️ 多旁路汇合时的四条强制规则**(经实践验证,缺失任一条都会出现连线错误):
    
    1. **旁路终点必须显式连入汇合节点**:每条旁路的最后一个节点,必须在 prompt 中明确写「→ 向下连入「[汇合节点名]」」,不能依赖模型自行推断。
    2. **所有箭头居中进出**:在 prompt 中加一句「所有箭头从节点中央水平或垂直引出,进入目标节点中央」。
    3. **多旁路纵向空间均匀分配**:有 N 条旁路时,在 prompt 中说明「N 条路径在图中纵向空间均匀分配,不要相互紧贴」。
    4. **颜色一致性**:在 prompt 中加「所有节点配色保持同一色调体系,由模型自行决定,不要有的节点深色调有的浅色调」。
    
    **⚠️ 禁止自动编号**:流程节点不加流水序号(①②③),除非明确要求。
    
    ```
    # 画图提示:竖向流程图,展示[流程名]的处理步骤与分支逻辑。
    #
    # 从上到下:
    #   「[入口节点]」(椭圆)
    #     ↓
    #   「[判断条件A]」(菱形)
    #     是 →→ 右侧旁路:「[旁路A节点1]」→「[旁路A节点2]」→ 向下连入「[汇合节点]」
    #     否 ↓
    #   「[判断条件B]」(菱形)
    #     是 →→ 右侧旁路:「[旁路B节点1]」→「[旁路B节点2]」→ 向下连入「[汇合节点]」
    #     否 ↓
    #   「[主路径节点组]」(主路径向下)→ 向下连入「[汇合节点]」
    #     ↓
    #   「[汇合节点]」(三条路径在此汇合)
    #
    # 布局要求:
    #   · 三条路径(旁路A / 旁路B / 主路径)纵向空间均匀分配,不要相互紧贴
    #   · 所有箭头从节点中央引出、进入目标节点中央
    #   · 所有节点配色保持同一色调体系,由模型自行决定
    #
    # 风格:白色背景,高级技术 PPT 配图,极简专业,文字标注全部用中文。
    ```
    
    ---
    
    
    ---
    
    ## 横向阶段列流程图
    
    适用:多个处理阶段,每个阶段内有纵向子流程,阶段间横向推进。
    
    **⚠️ 列间连接是最容易混乱的地方**,必须在 prompt 中逐一声明列间连线,不能只描述列内节点。  
    核心规则:
    - **每列的出口节点必须明确点名**连接到下一列的哪个入口节点。
    - **列内分支终止时**(如某条件判断为"跳过"的终止路径),必须标注「此路径止于本列,不跨列」。
    - **箭头颜色不要多于两种**,颜色多了模型会把线画乱;如需区分异步/同步,只用实线/虚线区分即可,不加颜色。
    
    ```
    # 画图提示:横向阶段列流程图,展示[系统名]的完整[流程名]。
    #
    # 顶部:[N]个阶段标题列,编号 ①②③④,每列一个深色背景标题:
    #   ① 「[阶段1名]」
    #   ② 「[阶段2名]」
    #   … 依此类推
    #
    # 各列纵向节点(圆角矩形,从上到下):
    #   第①列(从上到下):
    #     「[节点A]」
    #     菱形「[判断条件]?」
    #       是 → 「[终止节点]」(此路径止于第①列,不跨列)
    #       否 ↓ 继续
    #   第②列(从上到下):
    #     「[节点B]」
    #     「[节点C]」
    #   第③列(从上到下):
    #     「[节点D]」
    #     「[节点E]」
    #   第④列(从上到下):
    #     「[节点F]」
    #     「[节点G]」
    #
    # 列间连接(必须逐一声明):
    #   第①列底部「[节点名]」 → 第②列顶部「[节点名]」(水平箭头)
    #   第②列底部「[节点名]」 → 第③列顶部「[节点名]」(水平箭头)
    #   第③列底部「[节点名]」 → 第④列顶部「[节点名]」(水平箭头)
    #
    # 箭头:统一使用实线箭头,异步流程用虚线,不超过两种线型
    # 底部说明框(可选):「[整体策略总结一句话]」(重点标注)
    #
    # 风格:白色背景,高级技术 PPT 配图,极简专业,文字标注全部用中文。
    ```
    
    ---
    
    
    ---
    
    ## 两层流程图:主流程 + 展开细节
    
    适用:一个步骤本身有几个子步骤,单独画一张图太单薄,但全塞进主流程一行又太挤——典型场景是"5步主流程,其中第4步还能再拆成4个子步骤"。比单独画两张稀疏的图信息密度更高,比硬塞成一行8张卡片更宽松。
    
    **核心规范**:
    - 上层是主流程,横向卡片,其中一张"被展开"的卡片用更深的颜色/边框突出,小字写「展开见下方」
    - 该卡片正下方引一条竖直箭头连到下层
    - 下层是子步骤展开,用浅灰虚线边框的矩形框整体框住,左上角标小字说明这是哪一步的细节,框内卡片可以比上层卡片略小、颜色用同色系浅一档
    - 整张图依然要显式声明「横向宽屏构图,宽高比约16:9」(见踩坑5),否则上下两层会被压成竖版导致两层都拥挤
    
    ```
    # 画图提示:横向宽屏构图,宽高比约16:9,禁止竖版,不要任何大标题文字,背景纯白。纵向两层流程图,风格为高级技术PPT配图,留白宽松不拥挤。
    #
    # 上层主流程:[N]个带图标的[颜色]圆角卡片从左到右水平排列,卡片间距宽松,用实线箭头连接。
    #   卡片1([图标])「[步骤1]」,小字「[支撑数据]」
    #   ……
    #   卡片[k]([图标],颜色加深突出)「[待展开步骤]」,小字「展开见下方[M]步」
    #   ……
    #   卡片[N]([图标])「[末步]」,小字「[支撑数据]」
    # 卡片[k]正下方引出一条竖直箭头,连到下层。
    #
    # 下层展开细节:[M]个带图标的[同色系浅一档]圆角卡片从左到右水平排列,间距宽松,卡片间用实线箭头连接,整体用一个浅灰色虚线边框的矩形框住,左上角标注小字「[待展开步骤名]细节」。
    #   下层卡片1([图标])「[子步骤1]」,小字「[支撑数据]」
    #   ……
    #
    # 所有文字必须是简体中文,禁止繁体字,不加节点编号
    ```
    
    ---
    
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/gogoingai-wenqu-skills-wenqu-image.md

// REPO STATS

7 stars
1 open issues
Last commit: 3mo ago