canghe-comic

用途

canghe-comic 是一个知识漫画创作工具，用于生成原创教育类漫画。它支持灵活的画风与基调组合，适合将文章、教程或知识内容转化为带分镜的漫画作品。

主要能力

视觉维度选项

--art：画风/渲染技法，可选 ligne-claire（清线，默认）、manga（日漫）、realistic（写实）、ink-brush（水墨）、chalk（粉笔）。
--tone：情绪/氛围，可选 neutral（中性，默认）、warm（温馨）、dramatic（戏剧）、romantic（浪漫）、energetic（活力）、vintage（复古）、action（动作）。
--layout：分镜排列，可选 standard（默认）、cinematic、dense、splash、mixed、webtoon。
--aspect：页面比例，可选 3:4（默认，竖版）、4:3（横版）、16:9（宽屏）。
--lang：输出语言，可选 auto（默认）、zh、en、ja 等。

分阶段工作流选项

--storyboard-only：仅生成分镜，跳过提示词和图像。
--prompts-only：生成分镜和提示词，跳过图像。
--images-only：从已有提示词目录生成图像。
--regenerate N：仅重新生成指定页（如 3 或 2,5,8）。

预设快捷方式

--style ohmsha：等价于 --art manga --tone neutral，含视觉隐喻、无对话头像、装置揭示等特殊规则。
--style wuxia：等价于 --art ink-brush --tone action，含气效、战斗视觉、氛围元素。
--style shoujo：等价于 --art manga --tone romantic，含装饰元素、眼部细节、浪漫桥段。

自动选择

工具会根据内容信号推荐默认的画风、基调和布局（或预设）。例如：教程、编程、教育类内容推荐 ohmsha 预设；1950 年前、古典、古代内容推荐 realistic + vintage；个人故事、导师推荐 ligne-claire + warm；武侠推荐 wuxia 预设；恋爱、校园生活推荐 shoujo 预设；传记、均衡内容推荐 ligne-claire + neutral。当推荐预设时，会加载对应预设文件并应用全部特殊规则。

使用方式

命令行调用示例：

/canghe-comic posts/turing-story/source.md
/canghe-comic article.md --art manga --tone warm
/canghe-comic  # 然后粘贴内容

工作流步骤

设置与分析：加载 EXTEND.md 偏好设置（若未找到则为阻塞项，必须先完成首次设置），分析内容，检查已有目录。
确认：确认风格、焦点、受众、评审选项（必需）。
生成分镜和角色。
评审大纲（条件性，仅当用户要求时）。
生成提示词。
评审提示词（条件性）。
生成图像：先生成角色设定图（characters/characters.png），再逐页生成图像并引用角色设定图以保证一致性。
合并为 PDF。
完成报告。

图像生成

角色参考图是保证视觉一致性的强制要求。先生成角色设定图，再为每一页生成图像时引用该图。若技能支持 --ref，则每页都传入角色设定图；若不支持，则在每个提示词文件中前置角色描述。

示例命令：

npx -y bun ${SKILL_DIR}/../canghe-image-gen/scripts/main.ts \
  --promptfiles characters/characters.md \
  --image characters/characters.png --ar 4:3

npx -y bun ${SKILL_DIR}/../canghe-image-gen/scripts/main.ts \
  --promptfiles prompts/01-page-xxx.md \
  --image 01-page-xxx.png --ar 3:4 \
  --ref characters/characters.png

输出目录结构

输出目录为 comic/{topic-slug}/，slug 为 2-4 个单词的 kebab-case 主题名。若冲突则追加时间戳。目录内容包含：源文件、内容分析（analysis.md）、分镜脚本（storyboard.md）、角色定义（characters/characters.md）、角色参考图（characters/characters.png）、生成提示词（prompts/NN-{cover|page}-[slug].md）、生成图像（NN-{cover|page}-[slug].png）、最终合并 PDF（{topic-slug}.pdf）。

语言处理

检测优先级：--lang 标志、EXTEND.md 语言设置、用户对话语言、源内容语言。规则：所有交互使用用户输入语言或保存的语言偏好，包括分镜大纲、场景描述、图像生成提示词、用户选择选项、进度更新、问题、错误和摘要。技术术语保留英文。

页面修改

编辑：先更新提示词文件，再 --regenerate N，然后重新生成 PDF。
添加：在指定位置创建提示词，用角色参考图生成，重新编号后续页面，更新分镜，重新生成 PDF。
删除：移除文件，重新编号后续页面，更新分镜，重新生成 PDF。

重要：更新页面时，务必先更新提示词文件再重新生成。

适用场景

将教程、编程、教育类内容转化为漫画。
将古典、历史内容以写实复古风格呈现。
将个人故事、导师经历以温馨清线风格呈现。
将武侠、动作内容以水墨动作风格呈现。
将恋爱、校园生活以少女漫画风格呈现。
将传记、均衡内容以中性清线风格呈现。

限制

图像生成每页约需 10-30 秒。
生成失败时自动重试一次。
对敏感公众人物使用风格化替代形象。
通过会话 ID 保持风格一致性。
第 2 步确认必需，不可跳过。
第 4/6 步为条件性，仅当用户在第 2 步要求时执行。
第 7.1 步角色设定图必须在页面生成前完成。
第 7.2 步每页必须引用角色，使用 --ref 或嵌入描述。
水印/语言在 EXTEND.md 中一次性配置。
EXTEND.md 未找到时为阻塞项，必须先完成首次设置。

配置

EXTEND.md 路径：项目目录 .canghe-skills/canghe-comic/EXTEND.md 或用户主目录 $HOME/.canghe-skills/canghe-comic/EXTEND.md。支持水印、首选画风/基调/布局、自定义风格定义、角色预设、语言偏好。