# wenqu-image

Adopt this skill: https://proskills.md/skills/other/gogoingai-wenqu-skills-wenqu-image

Page: https://proskills.md/skills/other/gogoingai-wenqu-skills-wenqu-image
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: wenqu-image/SKILL.md
size: 13064
sha: f2060e0e56cddaa46743673657025e63cc0dd98a
upstream: https://github.com/gogoingai/wenqu-skills/blob/master/wenqu-image/SKILL.md

````text
---
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 提供的存储路径）时，若找不到调用方上下文，询问用户"这次的画图偏好要记到哪篇文章的存储目录"，或按当前工作目录和输出文件名推断。
````

## File: wenqu-image/references/core-principles.md
size: 4886
sha: 8c91b965e87a9d3eeaedff89958e09ad509bb191
upstream: https://github.com/gogoingai/wenqu-skills/blob/master/wenqu-image/references/core-principles.md

```text
# 核心画图原则

### ⚡ 第一原则：描述视觉物体，不指定显示文字

模型在「画什么」和「写什么」之间有隐含的选择权——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`） | **删除**，生图工具自行决定 |

---
```

## File: wenqu-image/references/design-principles.md
size: 5624
sha: 9a96b6d2956021537d91223de0256e692f6f3bf5
upstream: https://github.com/gogoingai/wenqu-skills/blob/master/wenqu-image/references/design-principles.md

```text
# 设计四大原则与配色审美

来源：《写给大家看的设计书》的亲密性、对齐、对比、重复四原则、色轮配色法、黄金分割构图。以下是转化为 **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『竖向串行流程图（含判断分支）』 四条规则显式声明连线）

---
```

## File: wenqu-image/references/diagram-examples.md
size: 9774
sha: f1379b84ce98cf52c793b568827c9420961af3a6
upstream: https://github.com/gogoingai/wenqu-skills/blob/master/wenqu-image/references/diagram-examples.md

````text
# 画图完整示例（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 配图，极简专业，文字标注全部用中文。
```
````

## File: wenqu-image/references/diagram-type-selector.md
size: 5471
sha: 169249c5e5641e7916c72cb3c5bdfd18e7126165
upstream: https://github.com/gogoingai/wenqu-skills/blob/master/wenqu-image/references/diagram-type-selector.md

```text
# 该画哪类图

## 图类型快速选表

| 场景 | 图类型 | 参考节 | 参考图 |
| --- | --- | --- | --- |
| 多层系统架构总览 | 横向多层架构图 | 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，不用代码块解释原理」该规则针对公式/权重，纯代码结构仍用代码块）。

### 何时画

- 复杂系统的技术文章开篇必须有一张系统级总览图——没有总览图，读者会在细节里迷路。
- 不要等文章写完再补图：写到"这一段该配图了"的判断，应该在列大纲阶段就做，而不是写完文字后回头看哪里空了塞一张图。
```

## File: wenqu-image/references/gen-workflow.md
size: 21780
sha: c6a2927a8a8dd8901810e9cea928ef69c79e050c
upstream: https://github.com/gogoingai/wenqu-skills/blob/master/wenqu-image/references/gen-workflow.md

````text
# 图片生成工作流

> 本文件是 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 写入文章 |
````

## File: wenqu-image/references/pitfalls.md
size: 7763
sha: f80a1e6f701b2e9070f9bbbaacd0f283ebec334f
upstream: https://github.com/gogoingai/wenqu-skills/blob/master/wenqu-image/references/pitfalls.md

````text
# 常见踩坑教训

> 以下为跨风格通用踩坑。某个风格特有的踩坑记录在该风格自己的 `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`），本条经验对所有风格统一生效，不再区分"新风格"和"已验证的旧风格"。

---
````

## File: wenqu-image/references/styles/cream-outline.md
size: 5324
sha: 847bd0e3c46effac018202da994e0ed2e191908b
upstream: https://github.com/gogoingai/wenqu-skills/blob/master/wenqu-image/references/styles/cream-outline.md

````text
# 奶油描边风格参考库（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`：
```
参考图风格，竖版构图。判断分支流程：[起始节点] → [条件]？菱形判断，是→[是分支后续]→[终点]，否→[否分支结果]。两个分支不要互相连接，分支间保持足够宽的间距。所有文字用中文，拼写清晰，标题字号适中不要太大。
```
````

## File: wenqu-image/references/styles/doodle-watercolor.md
size: 7075
sha: b43ad38502d3a5631610dfb5bf23e03c32080cbe
upstream: https://github.com/gogoingai/wenqu-skills/blob/master/wenqu-image/references/styles/doodle-watercolor.md

````text
# 水彩涂鸦风格参考库（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，禁止横版**。顶部「[起始节点]」（[图标]）→波浪箭头向下→判断菱形「[条件]？」（[图标]）。菱形左侧波浪箭头标注文字「否」，指向分支「[否分支结果]」（[图标]）。菱形正下方波浪箭头标注文字「是」，指向「[是分支后续]」（[图标]）→波浪箭头向下→「[终点]」（[图标]）。
**全图所有箭头必须是同一种风格：手绘波浪曲线箭头，粗细一致，颜色统一用一到两种色系，不要每根箭头单独配色**。两个分支路径不要互相连接，分支之间保持足够宽的间距。
```
````

## File: wenqu-image/references/styles/excalidraw.md
size: 6572
sha: 00f4b4487821d146d4996bd2949db47dbf3fa7b4
upstream: https://github.com/gogoingai/wenqu-skills/blob/master/wenqu-image/references/styles/excalidraw.md

````text
# 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]「[一句话说明]」→…（最新版本可突出强调）。所有文字用中文，拼写清晰。
```
````

## File: wenqu-image/references/styles/handdrawn.md
size: 4376
sha: 993b5aa0cb4967be343f3f638b36856c2061c268
upstream: https://github.com/gogoingai/wenqu-skills/blob/master/wenqu-image/references/styles/handdrawn.md

````text
# 手绘插画风格参考库（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]」。底部一句话总结「[总结]」。所有文字用中文，拼写清晰。
```
````

## File: wenqu-image/references/styles/mono-marker.md
size: 4285
sha: ae2977c457edc3a94a5c5a725230658e62f00a94
upstream: https://github.com/gogoingai/wenqu-skills/blob/master/wenqu-image/references/styles/mono-marker.md

````text
# 单色马克笔风格参考库（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]」…所有文字用中文，拼写清晰。
```
````

## File: wenqu-image/references/styles/pencil-sketch.md
size: 4859
sha: e4ac3dd786b9b99b0dfcecf028b36cc487e07762
upstream: https://github.com/gogoingai/wenqu-skills/blob/master/wenqu-image/references/styles/pencil-sketch.md

````text
# 彩色铅笔质感风格参考库（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]（[子节点]），层间箭头连接，每层配一个编号徽章。所有文字用中文，拼写清晰，标题字号适中不要太大。
```
````

## File: wenqu-image/references/styles/techppt.md
size: 3363
sha: d9219445b25226a4a17698226863a8ed9d3e9507
upstream: https://github.com/gogoingai/wenqu-skills/blob/master/wenqu-image/references/styles/techppt.md

````text
# 技术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。补充说明「[注释]」。所有文字用中文，拼写清晰。
```
````

## File: wenqu-image/references/templates/architecture.md
size: 4741
sha: 55e504bc10df72f27c35203c19c2a3ffa4b05e93
upstream: https://github.com/gogoingai/wenqu-skills/blob/master/wenqu-image/references/templates/architecture.md

````text
# 架构类图型模板

## 横向多层架构图

适用：展示系统分层结构、各层组件和整体数据流。  
参考图：`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 配图，极简专业，文字标注全部用中文。
```

---
````

## File: wenqu-image/references/templates/comparison.md
size: 4669
sha: 843587fc5daea5543535ec8b6ef98a8fb3a150d6
upstream: https://github.com/gogoingai/wenqu-skills/blob/master/wenqu-image/references/templates/comparison.md

````text
# 对比/并行类图型模板

## 并排方案对比图

适用：两个方案/版本的流程对比，突出差异点。

```
# 画图提示：左右并排对比图，展示[方案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 配图，极简专业，文字标注全部用中文。
```

---
````

## File: wenqu-image/references/templates/data-viz.md
size: 4799
sha: f02323dc764ce2da09d9593e73ecf2ceca5e76af
upstream: https://github.com/gogoingai/wenqu-skills/blob/master/wenqu-image/references/templates/data-viz.md

````text
# 数据可视化类图型模板

## 横向条形图 + 说明卡片

适用：多维度权重或评分分布，每个维度附带机制说明。  
参考图：`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 配图，极简专业，文字标注全部用中文。
```

---
````

## File: wenqu-image/references/templates/flow.md
size: 9019
sha: e625750ed44d62c05c539deee9d6d5269e1a61ae
upstream: https://github.com/gogoingai/wenqu-skills/blob/master/wenqu-image/references/templates/flow.md

````text
# 流程/阶段类图型模板

## 竖向三阶段串行流程图

适用：有清晰阶段划分的处理流程，替代泳道图。

**标题栏位置：顶部横条（不是左侧竖条）**

每个阶段框的标题栏必须是**顶部横贯全宽的横条**，不要用左侧竖条。原因：左侧竖条挤占水平空间，步骤节点区域变窄，图整体显得拥挤。

```
# ✅ 正确：顶部横条
#   顶部深蓝横条标题栏（横贯矩形全宽），白色文字「[名称] · [副标题]」，左侧有图标；
#   标题条下方主体区域：…

# ❌ 错误：左侧竖条
#   左侧深蓝色竖条标题栏，白色文字「[名称] · [副标题]」；
```

**异步阶段标准表示**：

当某个阶段是**异步执行**（不阻塞主流程），需同时给出三个视觉提示：
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]」，小字「[支撑数据]」
#   ……
#
# 所有文字必须是简体中文，禁止繁体字，不加节点编号
```

---
````

## File: README.md
upstream: https://github.com/gogoingai/wenqu-skills/blob/master/README.md

````text
# 文曲（Wenqu Skills）

[English](README.en.md) | [简体中文](README.md)

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

![文曲 Logo](assets/logo.png)

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

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

## 创作流程

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

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

## 技能组成

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

## 设计理念

中国传统文章创作讲究：

> 博观而约取，厚积而薄发。

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

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

## 安装完整工作流

> 推荐：通过 [WorkBuddy](#workbuddy) 体验文曲。WorkBuddy 的 hy3 模型免费，每天可领 100 积分。

文曲按完整工作流设计，使用 [`npx skills`](https://github.com/vercel-labs/skills) 一次安装全部六个技能：

```bash
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）不受影响，照常安装成功。

更新已安装的技能：

```bash
npx skills update -g
```

### WorkBuddy

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

<!-- 文曲套件（wenqu-skills 插件包）的整包安装方式暂时隐藏；如需恢复，取消本注释即可，并把上面的开头描述改回“两条安装路径”。
#### 市场（GitHub 源）

要直接从本仓库安装完整工作流，请使用下面的“市场”流程。

1. 打开“专家·技能·连接器”，选择“技能”，切到“市场”页签后点击 **+**。

   ![打开 WorkBuddy 市场](assets/workbuddy/marketplace-01-open.png)

2. 输入仓库来源并提交：

   ```text
   gogoingai/wenqu-skills
   ```

   ![添加 Wenqu Skills 市场源](assets/workbuddy/marketplace-02-add-source.png)

3. 选择新增的 `wenqu-skills` 市场，在 **Wenqu Skills** 卡片上点击 **+**，开始安装。

   ![在 WorkBuddy 市场选择 Wenqu Skills](assets/workbuddy/marketplace-03-install.png)

4. 等待插件出现在“我安装的”中，再重载或重启 WorkBuddy，让技能出现在列表中。
-->

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

![在 WorkBuddy SkillHub 搜索文曲技能](assets/workbuddy/skillhub-01-search-wenqu.png)

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

### 千问 Work（Qwen Work）

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

```text
请从 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 中运行提示词后的安装结果](assets/qwen-work/install-01-result.png)

### Claude Code 插件市场

先添加文曲市场，再安装唯一的 `wenqu-skills` 插件；它包含全部六个技能：

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

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

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

### Codex 插件市场

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

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

   ![在 Codex 中打开添加插件市场](assets/codex/plugin-marketplace-01-add.png)

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

   ```text
   gogoingai/wenqu-skills
   ```

3. 切到“个人”页签，找到 **Wenqu Skills**，点击“安装”。

   ![从 Codex 个人市场安装 Wenqu Skills](assets/codex/plugin-marketplace-02-install.png)

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

### SkillHub 网站或 agent 安装

[SkillHub](https://skillhub.cn) 也支持通过 agent 安装全部技能，可发送：

> 请根据 [https://skillhub.cn/install/skillhub.md](https://skillhub.cn/install/skillhub.md)，安装 wenqu-library、wenqu-write、wenqu-review、wenqu-image、wenqu-translate、wenqu-publish。

### ClawHub（OpenClaw）

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

```bash
openclaw plugins install clawhub:@gogoingai/wenqu-skills
```

也可以逐个安装技能：

```bash
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`](https://github.com/gogoingai/wenqu-cli)：为 `wenqu-image` 和 `wenqu-library` 提供运行时。

### `wenqu-image`

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

```bash
wenqu image doctor --json
```

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

```bash
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`](wenqu-library/references/wenqu-cli.md)。

## 维护与发布

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

维护者请先阅读 [开发手册](DEVELOPMENT.md)；涉及版本和平台发布时，再按 [发布手册](RELEASE.md) 在 PR 合入后执行。
````
