指定封面标题文字的语言。
参数类型: 语言代码 (可选)
可选值: en (英文), zh (中文), ja (日文) 等标准语言代码
默认行为:
- 如果文章语言与对话语言一致, 自动使用该语言
- 如果不一致, 会在生成前询问用户选择
使用示例:
/pw-cover-image article.md --lang en
/pw-cover-image article.md --lang zh
最佳实践:
- 目标读者是中文用户: 使用 zh
- 国际化内容: 使用 en
- 通常不需要手动指定, 系统会智能判断
--no-title
生成不含标题文字的纯视觉封面。
参数类型: 布尔标志 (可选)
默认行为: 包含标题文字
使用场景:
- 需要后期添加自定义文字
- 纯视觉背景图
- 需要在不同场合使用不同标题
使用示例:
/pw-cover-image article.md --no-title
/pw-cover-image article.md --style minimal --no-title
注意事项:
- 使用此选项后, 封面将只包含视觉元素和装饰
- 适合需要灵活性的场景
风格画廊
| 风格 | 说明 |
|---|
elegant (默认) | 精致、优雅、低调 |
blueprint | 技术图纸、工程精度 |
bold-editorial | 杂志封面冲击力、戏剧性排版 |
chalkboard | 黑色黑板、彩色粉笔绘画 |
dark-atmospheric | 电影感暗色模式、发光点缀 |
editorial-infographic | 杂志解说、视觉叙事 |
fantasy-animation | 吉卜力/迪士尼风格、奇幻魅力 |
intuition-machine | 技术简报、双语标签 |
minimal | 超简洁、禅意、专注 |
nature | 有机、平静、自然 |
notion | 简洁 SaaS 仪表板、生产力风格 |
pixel-art | 复古 8 位、怀旧游戏美学 |
playful | 有趣、创意、异想天开 |
retro | 半色调点、复古徽章、经典 |
sketch-notes | 手绘、教育性、温暖 |
vector-illustration | 扁平矢量、黑色轮廓、复古色彩 |
vintage | 陈旧纸张、历史感、探险风格 |
warm | 友好、亲切、以人为本 |
watercolor | 柔和手绘、自然温暖 |
详细风格定义: references/styles/<style>.md
自动风格选择
当未指定 --style 时, 系统会分析内容选择最佳风格:
| 内容特征 | 选择的风格 |
|---|
| 架构、系统设计、工程 | blueprint |
| 产品发布、主题演讲、营销、品牌 | bold-editorial |
| 教育、课堂、教程、教学 | chalkboard |
| 娱乐、创意、高端、电影感 | dark-atmospheric |
| 技术解说、科学、研究 | editorial-infographic |
| 故事讲述、儿童、奇幻、魔法 | fantasy-animation |
| 技术文档、学术、双语 | intuition-machine |
| 个人故事、情感、成长、生活 | warm |
| 简单、禅意、专注、本质 | minimal |
| 有趣、简单、初学者、休闲 | playful |
| 自然、环保、健康、有机 | nature |
| 流行文化、80/90 年代怀旧、徽章 | retro |
| 产品、SaaS、仪表板、生产力 | notion |
| 游戏、复古科技、开发者、8 位 | pixel-art |
| 教育、教程、知识分享 | sketch-notes |
| 创意提案、品牌、玩具风格 | vector-illustration |
| 历史、探索、遗产、传记 | vintage |
| 生活方式、旅行、美食、个人 | watercolor |
| 商业、专业、策略、分析 | elegant |
文件管理
输出目录
每个会话创建一个以内容主题命名的独立目录:
cover-image/{topic-slug}/
├── source-{slug}.{ext} # 源文件 (文本、图片等)
├── prompts/
│ └── cover.md
└── cover.png
主题命名规则:
- 从内容中提取主题 (2-4 个词, kebab-case)
- 示例: "AI 的未来" →
ai-future
冲突解决
如果 cover-image/{topic-slug}/ 已存在:
- 追加时间戳:
{topic-slug}-YYYYMMDD-HHMMSS
- 示例:
ai-future 已存在 → ai-future-20260118-143052
源文件
使用 source-{slug}.{ext} 命名复制所有源文件:
source-article.md (主要文本内容)source-logo.png (对话中的图片)
支持多个源文件: 文本、图片、对话中的文件。
工作流程
流程概览:
- 分析内容 → 提取主题、语气、关键词
- 确定选项 → 自动选择或使用指定的风格、宽高比
- 确认选项 → 一次性确认所有参数 (风格、宽高比、语言)
- 生成概念 → 创建标题和视觉元素
- 创建提示词 → 保存到 prompts/cover.md
- 生成图片 → 调用图片生成服务
- 输出摘要 → 显示结果和文件位置
用户交互点:
- 仅在步骤 3 需要用户确认 (一次性确认所有选项)
- 如果有多个图片生成服务, 在步骤 6 询问选择
步骤 1: 分析内容
-
保存源内容 (如果还不是文件):
- 如果用户提供文件路径: 直接使用
- 如果用户粘贴内容: 保存到目标目录的
source.md
-
提取关键信息:
- 主题: 文章讲什么?
- 核心信息: 关键要点是什么?
- 语气: 严肃、有趣、鼓舞人心、教育性?
- 关键词: 识别风格信号词
-
语言检测:
- 检测内容的源语言
- 检测对话上下文的用户语言
- 注意源语言 ≠ 用户语言 (将在步骤 3 询问)
步骤 2: 确定选项
-
风格选择:
- 如果指定了
--style, 使用该风格
- 否则, 扫描内容的风格信号并自动选择 3 个候选
- 如果没有明确信号, 默认使用
elegant
-
宽高比:
- 如果指定了
--aspect, 使用该比例
- 否则, 准备选项: 2.35:1 (电影感), 16:9 (宽屏), 1:1 (社交媒体)
步骤 3: 确认选项
目的: 让用户在生成前一次性确认所有选项。
重要: 使用 AskUserQuestion 在单个确认步骤中呈现所有选项。不要用多个单独的确认打断工作流程。
确定要询问的问题:
| 问题 | 何时询问 |
|---|
| 风格 | 总是 (必需) |
| 宽高比 | 总是 (提供常用选项) |
| 语言 | 仅当 源语言 ≠ 用户语言 |
呈现选项 (使用 AskUserQuestion 包含所有适用问题):
问题 1 (风格) - 总是:
- 风格 A (推荐): [风格名称] - [简要说明]
- 风格 B: [风格名称] - [简要说明]
- 风格 C: [风格名称] - [简要说明]
- 自定义: 提供自定义风格参考
问题 2 (宽高比) - 总是:
- 2.35:1 电影感 (推荐) - 超宽、戏剧性
- 16:9 宽屏 - 标准视频/演示
- 1:1 方形 - 社交媒体优化
问题 3 (语言) - 仅当源语言 ≠ 用户语言:
- [源语言] (匹配内容)
- [用户语言] (你的偏好)
语言处理:
- 如果源语言 = 用户语言: 只需告知用户 (例如 "标题将使用中文")
- 如果不同: 询问标题文字使用哪种语言
步骤 4: 生成封面概念
根据选定的风格创建封面图概念:
标题 (如果包含, 最多 8 个字符):
- 将核心信息提炼为有力的标题
- 使用钩子: 数字、问题、对比、痛点
- 如果使用
--no-title 标志则跳过
视觉元素:
- 符合风格的图像和图标
- 1-2 个代表主题的象征性元素
- 符合风格的隐喻或类比
步骤 5: 创建提示词文件
使用确认的选项将提示词保存到 prompts/cover.md。
所有提示词都使用用户确认的语言偏好编写。
提示词格式:
封面主题: [2-3 个词的主题]
风格: [选定的风格名称]
宽高比: [确认的宽高比]
[如果包含标题:]
标题文字: [8 个字符或更少, 使用确认的语言]
副标题: [可选, 使用确认的语言]
视觉构图:
- 主视觉: [匹配风格的描述]
- 布局: [基于标题包含和宽高比的定位]
- 装饰元素: [符合风格的元素]
配色方案:
- 主色: [风格主色]
- 背景: [风格背景色]
- 点缀: [风格点缀色]
风格注释: [要强调的特定风格特征]
[如果无标题:]
注意: 无标题文字, 仅纯视觉插图。
步骤 6: 生成图片
图片生成技能选择:
- 检查可用的图片生成技能
- 如果有多个技能可用, 询问用户选择
生成:
使用提示词文件、输出路径和确认的宽高比调用选定的图片生成技能。
步骤 7: 输出摘要
封面图已生成!
主题: [主题]
风格: [风格名称]
宽高比: [宽高比]
标题: [封面标题] (或 "无标题 - 仅视觉")
语言: [确认的语言]
位置: [输出路径]
预览图片以验证是否符合你的期望。
注意事项
- 封面应在小预览尺寸下立即可理解
- 标题 (如果包含) 必须可读且有冲击力
- 视觉隐喻比字面表现效果更好
- 在整个封面中保持风格一致性
- 图片生成通常需要 10-30 秒
- 标题文字使用用户确认的语言偏好
- 宽高比: 2.35:1 用于电影感/戏剧性, 16:9 用于宽屏, 1:1 用于社交媒体
常见问题与错误处理
文件路径问题
问题: 找不到指定的文章文件
原因: 文件路径不正确或文件不存在
解决方案:
- 确保使用绝对路径或相对于当前工作目录的正确路径
- 检查文件扩展名是否正确 (.md, .txt 等)
- 使用
ls 命令验证文件是否存在
示例:
/pw-cover-image article.md
/pw-cover-image /path/to/article.md
/pw-cover-image ./docs/article.md
内容分析失败
问题: 无法从文章中提取有效主题
原因: 文章内容过短、格式不规范或语言不支持
解决方案:
- 确保文章至少包含 100 字以上的有效内容
- 检查文章是否包含标题、段落等基本结构
- 对于非标准格式, 可以手动指定风格参数
最佳实践:
- 提供完整的文章内容, 而非片段
- 包含标题和主要段落
- 避免纯代码或纯数据内容
风格选择不理想
问题: 自动选择的风格不符合预期
原因: 文章内容特征不明显或包含多种主题
解决方案:
- 使用
--style 参数手动指定风格
- 参考 "自动风格选择" 表格了解匹配规则
- 尝试不同风格并比较效果
示例:
/pw-cover-image article.md --style blueprint
图片生成超时
问题: 图片生成时间过长或失败
原因: 网络问题、图片生成服务繁忙或提示词过于复杂
解决方案:
- 等待 30-60 秒后重试
- 检查网络连接
- 简化内容或使用更简单的风格 (如 minimal)
- 使用
--no-title 减少生成复杂度
标题文字显示问题
问题: 标题文字过长或显示不完整
原因: 自动提取的标题超过 8 个字符限制
解决方案:
- 系统会自动精简标题到 8 个字符以内
- 如果仍不满意, 使用
--no-title 后期手动添加
- 在文章开头明确核心主题, 帮助系统提取更好的标题
语言识别错误
问题: 标题语言与预期不符
原因: 文章包含多种语言或语言检测不准确
解决方案:
- 使用
--lang 参数明确指定语言
- 在确认步骤中选择正确的语言选项
示例:
/pw-cover-image article.md --lang zh
目录冲突
问题: 输出目录已存在, 担心覆盖之前的文件
原因: 相同主题的封面已生成过
解决方案:
- 系统会自动添加时间戳避免冲突
- 格式:
{topic-slug}-YYYYMMDD-HHMMSS
- 不会覆盖现有文件, 可以安全重新生成
示例:
cover-image/ai-future/ # 第一次生成
cover-image/ai-future-20260123-143052/ # 第二次生成
使用建议与最佳实践
内容准备
提供完整文章:
- 包含标题、引言、主体段落
- 至少 200-500 字的有效内容
- 清晰的主题和核心观点
优化文章结构:
- 在开头明确核心主题
- 使用清晰的段落划分
- 包含关键词和主题词
风格选择策略
让系统自动选择 (推荐):
- 适用于大多数场景
- 系统会分析内容特征并推荐 3 个候选风格
- 在确认步骤中可以调整
手动指定风格:
- 品牌一致性要求高的场景
- 已知目标风格的情况
- 需要批量生成统一风格的封面
风格测试:
- 不确定时可以生成多个版本对比
- 使用
--no-title 生成纯视觉版本便于复用
宽高比选择
根据发布平台选择:
- 博客/网站头图: 2.35:1 (默认)
- 视频平台 (YouTube, B站): 16:9
- 社交媒体 (微信, 微博, Instagram): 1:1
多平台发布:
示例工作流:
/pw-cover-image article.md --aspect 2.35:1
/pw-cover-image article.md --aspect 16:9
/pw-cover-image article.md --aspect 1:1
批量生成
系列文章:
- 使用相同的
--style 保持视觉一致性
- 让标题自动生成以体现差异
- 建立品牌识别度
示例:
/pw-cover-image article-1.md --style blueprint
/pw-cover-image article-2.md --style blueprint
/pw-cover-image article-3.md --style blueprint
质量优化
提高封面质量:
- 提供高质量的文章内容
- 明确核心主题和关键信息
- 选择与内容匹配的风格
标题优化:
- 在文章开头使用有力的标题
- 包含数字、问题或对比
- 避免过长或过于抽象的标题
视觉效果:
- 预览生成的封面
- 在目标尺寸下检查可读性
- 必要时重新生成或调整参数
工作流集成
与其他工具配合:
- 先完成文章写作
- 使用本工具生成封面
- 使用图片编辑工具进行微调 (如需要)
文件管理:
- 输出目录自动按主题组织
- 保留源文件和提示词便于追溯
- 定期清理不需要的版本
性能优化
减少生成时间:
- 使用简单风格 (minimal, elegant)
- 使用
--no-title 减少复杂度
- 避免在网络繁忙时段生成
提高成功率:
- 确保网络连接稳定
- 提供清晰的文章内容
- 使用推荐的参数组合
高级用法
自定义风格
通过 EXTEND.md 文件添加自定义风格配置。
配置路径 (优先级顺序):
.pw-skills/pw-cover-image/EXTEND.md (项目级)~/.pw-skills/pw-cover-image/EXTEND.md (用户级)
使用场景:
- 企业品牌风格
- 特定主题的定制风格
- 覆盖默认风格定义
提示词调试
查看生成的提示词文件了解系统如何理解内容。
位置: cover-image/{topic-slug}/prompts/cover.md
用途:
多图片生成服务
如果配置了多个图片生成服务, 系统会询问选择。
选择建议:
- 根据服务质量和速度选择
- 不同服务可能产生不同风格
- 可以尝试多个服务对比效果
