1实现原理 · 为什么它能做到
把“封面长什么样”拆成六个可确认的维度（Type/Palette/Rendering/Text/Mood/Font）+ 宽高比，每维都有取值枚举与默认值，最终拼成一份结构化 prompt。
skills/canghe-cover-image/SKILL.md
Generate elegant cover images for articles with 5-dimensional customization.
这里在做什么：Five Dimensions 表给出每维取值与默认（Text 默认 title-only、Mood 默认 balanced、Font 默认 clean、Aspect 默认 16:9）；Font 是第六个实际维度（描述里没数进去）。
维度缺省时有“内容信号 → 取值”的自动选择表。
skills/canghe-cover-image/SKILL.md
Auto-selection rules: [references/auto-selection.md](references/auto-selection.md)
这里在做什么：按关键词命中把内容类型、调色板、渲染手法、文字量、情绪、字体一一映射，自动选型是 --quick 模式的基础。
确认是软门禁：--quick 或全部指定才跳过，宽高比除非显式 --aspect 否则仍要问。
skills/canghe-cover-image/SKILL.md
| `--quick` or `quick_mode: true` | 6 dimensions | Aspect ratio (unless `--aspect`) |
这里在做什么：Step 2 用条件表决定跳过哪些维度，宽高比是唯一在 --quick 下仍可能被追问的项。
生成前把 prompt 落盘成 prompts/cover.md（含 references frontmatter）。
skills/canghe-cover-image/SKILL.md
**CRITICAL - References in Frontmatter**:
这里在做什么：Step 3 要求参考图落盘 refs/ 时写进 frontmatter references，仅口头抽取风格则省略；写入前先用 test -f 自检。
参考图按用途分流：direct 直传 --ref，style/palette 抽取特征追加进 prompt。
skills/canghe-cover-image/SKILL.md
- `direct` usage → pass via `--ref` (use ref-capable backend)
这里在做什么：Step 4 第 3 条按 frontmatter 的 references 用途分别处理，避免把所有参考图都当直传素材。
输出目录与产物结构固定，默认 independent 落到 cover-image/{topic-slug}/。
skills/canghe-cover-image/SKILL.md
- `independent` (default): `cover-image/{topic-slug}/`
这里在做什么：目录内含 source、refs/、prompts/cover.md、cover.png；另有 same-dir / imgs-subdir 两种偏好可选。
构图与文字纪律写死：留白 40-60%、人物只做简化剪影、标题必须用用户/原文的准确标题。
skills/canghe-cover-image/SKILL.md
- **Whitespace**: 40-60% breathing room
这里在做什么：Composition Principles 段还写明 Visual anchor 居中或偏左、Characters 用 simplified silhouettes；Title 用精确原文、never invent。
重生成前先备份，且必须先更新 prompt 文件再重新生成。
skills/canghe-cover-image/SKILL.md
| **Regenerate** | Backup → Update prompt file FIRST → Regenerate |
这里在做什么：Image Modification 表把“备份→改 prompt→重生成”写成固定步骤，保证变更可追溯。
2核心能力
01六维封面定制 + preset 快捷（--style 一次给全）
02内容信号自动选型（9 调色板 / 6 渲染 / 6 类型 / 文字量 / 情绪 / 字体）
03结构化 prompt 模板（分段 + frontmatter references）
04参考图处理：direct 直传 --ref，style/palette 抽取特征写进 prompt
05生成前后置校验与备份（test -f 参考图、备份 cover.png、失败重试一次）
06宽高比多档支持（16:9 / 2.35:1 / 4:3 / 3:2 / 1:1 / 3:4）
07文字/构图纪律（标题必须原文、人物仅剪影、留白 40-60%）
08偏好持久化（EXTEND.md：watermark / preferred_* / default_aspect / quick_mode / language）
3外部依赖
| Kind | Dependency / Endpoint |
|---|---|
| api | 图像生成 skill（Step 4 在宿主可用 skill 中挑选；多个时问用户偏好，SKILL.md 未点名具体后端） |
4管控建议与判定依据
建议配套管控措施
面向 Agent
分级或逐次授权，建议在沙箱运行
面向管理者
审批流程、可回滚、全程审计
判定依据（文件路径与关键语句摘要）
- 本地工作目录: 文件读写与工件输出: 由 SKILL.md 指令驱动 agent 写盘：cover-image/{topic-slug}/ 下的 source-{slug}、refs/（参
- SKILL.md: 声明调用宿主 CLI 解释器或外部运行环境
审计说明： 。(a) skill 的声明用途就是从文章内容生成封面：Step 4 让 agent 'Check image generation skills' 并把 prompt 文件、输出路径与宽高比交给所选图像生成 skill/后端，照做后文章标题/摘要/关键词与参考图会出网到第三方图像模型并消耗账号额度。(b) 本地写盘明确：cover-image/{topic-slug}/ 的 source、refs/、prompts/cover.md、cover.png，以及 EXTEND.md。(c) 自身目录零脚本、零自带网络端点、零凭证读取，出网与凭证面全在被点名的生图后端，故不判 red。本文档未点名具体后端（只说 'Check image generation skills'），但流程按设计必然把素材送入外部生成服务。对照先例：baoyu-cover-image / ai-image-generation 等“素材送生成后端”一律 orange。
5第二遍独立确认
- [ok] 自身目录无任何脚本或可执行文件 — 文件清单只有 .md；扫描“执行外部程序/写盘/网络请求”均为 0 命中，脚本执行面为空。
- [discrepancy] 外部生成后端名称 — SKILL.md 仅写 'Check image generation skills; if multiple, ask preference'，未点名具体后端；出网事实由 skill 的声明用途（生成封面）推出，档位仍为 orange。
- [ok] EXTEND.md 查找只探测存在性 — $HOME 命中仅是 test -f 的存在性判断，未读取文件内容之外的凭证或环境变量。
- [ok] 维度取值集合一致 — SKILL.md Five Dimensions 表与尺寸/palette 目录文件数对齐；prompt 模板与确认流程均存在。
- [ok] 参考图分流与自检 — Step 3/4 要求 frontmatter 列 references、写入前 test -f、direct 走 --ref、style/palette 抽取特征，规则闭环。
- [ok] meta 元数据 — commit dd0bf355…、path skills/canghe-cover-image、license MIT 与 bundle §0 核定值一致。
6结论
适合： 适合为文章/博客生成风格化封面、且需要 palette/rendering/文字量等维度可控、可复现 prompt 的写作者或内容团队。
不适合： 不适合严格离线或禁止内容外发的环境；不适合想批量配多张内文插图（应用 canghe-article-illustrator）；不适合完全不要确认、要一键出图的场景。
Install Agent-Ready
① Verified Mirror 2026-10-10
Option A · Direct DownloadDownload canghe-cover-image.tar.gz
sha256:
Option B · Copy Guide for Agent92d75c156ff10b20…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit dd0bf35595.